# @kody/trello — agent notes Human setup and intent live in [`README.md`](./README.md). This file is for agents: imports, smoke/dryRun execute snippets, and edge cases. Secrets by **name** only — never paste key or token values. Do not disable or enable live jobs unless the operator asks — the bundled `account-health` job stays `enabled: false` unless they turn it on after a fork. ## Auth | Lane | Credential | | --- | --- | | API key + token | `trelloApiKey` + `trelloToken` (or `*-`) | | OAuth | integration `trello` / `trello-` | Host: `api.trello.com`. Multi-account: `account: 'work'` → `trello-work` / `trelloApiKey-work` + `trelloToken-work`, or pass `integrationName` / `secretName` / `apiKeySecretName` / `auth: 'keyToken'|'oauth'` explicitly. ## Import paths | Export | Import | | --- | --- | | root dispatcher (default `smoke-test`) | `kody:@kody/trello` | | accounts | `kody:@kody/trello/accounts` | | viewer | `kody:@kody/trello/viewer` | | boards | `kody:@kody/trello/boards` | | lists | `kody:@kody/trello/lists` | | cards | `kody:@kody/trello/cards` | | comments | `kody:@kody/trello/comments` | | request | `kody:@kody/trello/request` | | smoke-test | `kody:@kody/trello/smoke-test` | | scheduled-account-health | `kody:@kody/trello/scheduled-account-health` | | types | `kody:@kody/trello/types` | Prefer static `kody:@kody/trello/...` imports from `execute`. Do not lead with `packages.invoke`. ## Smoke test (read-only) ```js import smokeTest from 'kody:@kody/trello/smoke-test' export default async function main() { return await smokeTest() // Without credentials: dry-run self-check + setup URLs // With key/token or OAuth: live member + boards sample — no writes } ``` Equivalent via root dispatcher: ```js import trello from 'kody:@kody/trello' export default async function main() { return await trello({ action: 'smoke-test' }) } ``` ## dryRun / confirm Pass `dryRun: true` on writes to return `{ dryRun: true, method, path, body }` without contacting Trello. Live writes throw unless `confirm: true`. ```js import { createCard } from 'kody:@kody/trello/cards' export default async function main() { return await createCard({ listId: 'list-id-from-caller', name: 'Write the release notes', dryRun: true, }) } ``` ## Edge cases - Board ids, list ids, and card ids come from the call. This package has no default board. - Prefer Lane A (API key + token). Lane B OAuth 2 is not generally available from Atlassian yet; only use a saved `trello` integration when one already exists. - Do not enable the `account-health` job on the official listing; after a fork, enable only if the operator wants the weekly read. - Keep `LICENSE` (MIT), `## Intent`, and `community-icon.svg` for community listing.