Hermes Kanban Orchestrator
Kanban Orchestrator — creates kanban tasks via hermes kanban create and
records each task as a swamp data resource with its ID, type, assignee, and
status. This is the single entry point for creating kanban tasks from swamp
workflows, cron, and automation.
Methods
- new_task — Create a kanban task. Supports idempotency-key dedup for daily-journal tasks (keyed on date).
- list_recent — List recent kanban tasks.
2026.09.15.1
Changed: Bump zod 4.4.3 → 4.6.5
2026.08.28.1
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| board | string | Kanban board slug to create tasks on |
| hermesBin | string | Path to the hermes binary |
| repoDir | string | Path to the swamp repo directory |
| Argument | Type | Description |
|---|---|---|
| title | string | Task title |
| assignee | string | Hermes profile to assign the task to |
| body? | string | Optional body/content for the task |
| tags? | array | Optional tags for categorization |
| priority? | number | Priority tiebreaker (higher = more important) |
| idempotencyKey? | string | Dedup key — if set, a matching non-archived task won't be duplicated |
| Argument | Type | Description |
|---|---|---|
| limit | number | Max results to return |
Resources
2026.08.28.1
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.26.1
Fixed: Added missing description field to upgrade entry for version
2026.08.24.2. The omission caused swamp extension pull to fail with a catalog
validation error ("upgrades.N.description: Invalid input: expected string,
received undefined").
2026.08.24.3
Added: Output metadata attributes for observability.
durationMs: Method execution duration in milliseconds.collectedBy: Extension name that produced the data.fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).
2026.08.24.2
Added Troubleshooting section documenting the silent list_recent degrade, unresolved kanbanId fallback, idempotency key collision behavior, hermesBin default mismatch, and the 30-second CLI timeout.
2026.08.21.2
Changed:
new_tasknow rejects an emptytitlewith a clear validation error before callinghermes kanban create, instead of letting hermes reject it (or silently accept it) deep inside the CLI call.- Failures from
hermes kanban createandhermes kanban listnow name the operation, board, and (fornew_task) the task type/title in the error or log message, instead of surfacing only the raw CLI output. - If the
hermesbinary itself fails to spawn or run (e.g. not found onPATH, permission denied), the error now names the binary, board, and arguments involved instead of an unqualified low-level exception.
2026.08.21.1
Changed: Added .describe() documentation to the previously undocumented KanbanTaskSchema
fields (kanbanId, type, title, assignee, status, priority, tags, bodyPreview,
createdAt). No behavioral change — a no-op upgrades entry was added to keep the model's
typeVersion tracking in sync with the version bump.
2026.07.18.1
Added: An upgrades array entry (no-op) to hermes_kanban_orch.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.
2026.07.18.1
Added: An upgrades array entry (no-op) to hermes_kanban_orch.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned