kanbango 3.4.1 → 3.5.0

package/AGENTS.md

@@ -11,6 +11,8 @@ Source of truth: `agent-playbook.js` (also MCP tool descriptions + `kanban_read`
 - list_epics default = live only (hides done + archived); `include_archived` / `status` to widen
 - list tasks default hides tasks under done/archived epics; show/show_epic by id always works
 - show: `view=execution` while coding; `full` only if needed
+- show task returns `epic_goals` (parent compass; `""` if none) — check drift vs goal
+- log architecture decisions: `update` `adr={decision,why}` append; `show_epic` full rolls up `adrs`
 - epic_create with description/goals; create tasks with `epic=E001` (prefer id)
 - create once with `description`, `specs`, `in_scope`, `out_of_scope`, `acceptance_criteria`
 - move/update/delete: `return=none`; subtasks = full array replace (no toggle)

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.5.0] - 2026-08-24
+
+### Added
+- GUI cockpit layout: rail of initiatives, NOW panel for `active`, columns icebox/planned/done, paper document for task and epic
+- Paper shows spec, in/out scope, AC, steps; read-only `adr[]` and `evidence[]` when present
+- Task `show` injects parent `epic_goals` (empty string when none) as a compass
+- Task `adr[]` with append via `update adr={decision,why}`; `show_epic` full rolls up child `adrs`
+- Tests: `tests/gui-cockpit.test.js`, `tests/kanban-epic-goals-adr.test.js`
+
+### Changed
+- GUI no longer uses epic swimlanes; epics filter the board from the rail
+- Active is NOW, not a fourth board column
+
 ## [3.4.1] - 2026-08-20
 
 ### Fixed

package/agent-playbook.js

@@ -11,6 +11,8 @@ const DROP_IN_RULE = [
   '- list_epics default = live only (hides done + archived); include_archived / status to widen',
   '- list tasks default hides tasks under done/archived epics; show/show_epic by id always works',
   '- show: view=execution while coding; full only if needed',
+  '- show task returns epic_goals (parent compass); empty string if no epic/goals — check drift vs goal',
+  '- log architecture decisions: update adr={decision,why} append; show_epic full rolls up adrs',
   '- epic_create with description/goals; create tasks with epic=E001 (prefer id)',
   '- create once with description,specs,in_scope,out_of_scope,acceptance_criteria',
   '- move/update/delete: return=none; subtasks=full array replace',
@@ -24,6 +26,8 @@ const TOOL_DESCRIPTIONS = {
     'Read board. TOKEN RULES: list defaults to view=summary (id/title/col/progress only).',
     'Hierarchy: epic (container/context) → task (work) → subtasks (steps).',
     'Always pass col when possible. Prefer show+view=execution over full.',
+    'show task (planning/execution/full) includes epic_goals (parent epic goals; "" if none) — use as compass; check progress toward goal.',
+    'execution/full also include adr[]; show_epic full rolls up child adrs (not stored on epic file).',
     'list_epics default live only (empty|planned|active; hides done+archived).',
     'Pass include_archived=true or status=done|archived to see closed initiatives.',
     'list hides tasks under done/archived epics unless include_archived/include_done; show/show_epic by id always works.',
@@ -38,6 +42,7 @@ const TOOL_DESCRIPTIONS = {
     'Actions: create|move|update|delete (daily); epic_create|epic_update|epic_archive|epic_unarchive|epic_delete;',
     'plan_create→plan_advance→plan_evidence→plan_done (non-trivial only).',
     'epic_create: title + description/goals/in_scope/out_of_scope. Link tasks via epic=E001.',
+    'Log architecture decisions on the task: update with adr={decision,why} appends one entry (why this choice).',
     'delete: task_id (hard remove). epic_delete: epic_id, always cascades child tasks.',
     'epic_archive/epic_unarchive: epic_id — hide/restore initiative without deleting history.',
     'create/plan_create: title required; also send description,specs,in_scope,out_of_scope,acceptance_criteria',
@@ -63,7 +68,9 @@ const MUST_CONTAIN = [
   'subtasks',
   'epic_create',
   'epic_archive',
-  'epic_delete'
+  'epic_delete',
+  'epic_goals',
+  'adr'
 ];
 
 function playbookHelpPayload() {