kanbango 3.6.2 → 5.1.0

package/agent-playbook.js

@@ -8,56 +8,40 @@ const DROP_IN_RULE = [
   'Kanbango MCP — token rules:',
   '- hierarchy: epic (context) → task (work+plan) → subtasks (steps)',
   '- list: col filter, view=summary; keep task_ids; no full-board re-list after writes',
-  '- 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',
+  '- context: omit operation = context (wake compass: unblocked active, failed/blocked gate, manual testing/review, else next unblocked planned, else idle); optional epic=E001; prefer over list+show',
+  '- after context: one show view=planning (SPEC) or view=execution (coding); do not re-list the board',
+  '- context next_action: advance|evidence|move_testing|move_review|move_done|fix_gate|start|idle; evidence/gates need diff|summary|test_command',
+  '- PARSE_ERROR: corrupt JSON on list/context/all is an error with file path; never a partial board or idle',
+  '- list_epics default = live only (hides done + archived); include_archived / include_done / status to widen',
+  '- list default hides column=done and tasks under done/archived epics; include_done/include_archived or col=done to widen; show/show_epic by id always works',
+  '- show: view=planning for SPEC; view=execution while coding; full only if needed',
+  '- show planning/full task views may return epic_goals (parent compass); empty fields are omitted — 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',
+  '- move/update/delete/plan_*: return=none (no full card / subtasks / evidence echo); return=summary|full only when needed',
   '- cleanup: delete (task), epic_delete (cascade tasks), epic_archive / epic_unarchive',
-  '- non-trivial: plan_create → plan_advance → plan_evidence (real tests, truncated logs) → plan_done',
-  '- plan_done completes into testing gate (not done); after implement move testing (return=none)',
+  '- steps on create/plan_create become subtasks (no forced TDD steps); test runner optional (null if none)',
+  '- optional plan_*: plan_create → plan_advance → plan_evidence (diff|summary|test_command) → plan_done',
+  '- plan_done completes into first enabled gate (testing|review) or done; after implement move testing when that column is enabled',
+  '- depends_on: task ids that must be done before active/gates; blocked move → TASK_BLOCKED; cycle → CIRCULAR_DEPENDENCY',
+  '- list/show: blocked + unmet_dependencies + blocks; move to done returns unblocked_tasks',
+  '- files: touched paths on create/update/plan_evidence (scope for QA/review)',
   '- move validates transitions; illegal move → INVALID_TRANSITION + allowed_columns',
-  '- allowed: icebox→planned; planned→active|icebox|testing; active→planned|testing|icebox; testing→active|review; review→active|done; done→active',
-  '- do not skip gates: active→done is illegal; testing/review spawn async agents when enabled',
-  '- gui: status before start; stop only owned; external_running = do not kill'
+  '- default allowed: icebox→planned; planned→active|icebox|testing; active→planned|testing|icebox; testing→active|review; review→active|done; done→active',
+  '- backlog/kanbango.json may disable testing/review columns (labels + migrate cards to planned) and/or disable QA/Temida spawn (manual gate)',
+  '- do not skip enabled gates: active→done illegal when testing|review on; gates spawn agents only when workflow+agent enabled',
+  '- enter testing|review (and done when gates on) only with evidence[] having diff|summary|test_command; fail/blocked cannot skip forward — EVIDENCE_REQUIRED',
+  '- gui: status before start; stop only owned; external_running = do not kill',
+  '- errors: next_tool_call only when repair is unique (TASK_NOT_FOUND, INVALID_TRANSITION); omit otherwise'
 ].join('\n');
 
 const TOOL_DESCRIPTIONS = {
-  kanban_read: [
-    '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.',
-    'Do not re-list the whole board after every write — keep task_id from create/move.',
-    'Task IDs numeric ("014"); epic IDs "E001". views: summary|planning|execution|full; fields[] overrides view.',
-    'operation=help returns this playbook as short text (no board I/O).'
-  ].join(' '),
+  kanban_read:
+    'Read board. TOKEN RULES: omit operation=context on wake; list view=summary; operation=help for the playbook.',
 
-  kanban_manage: [
-    'Write board / plan. TOKEN RULES: one create with all planning fields beats many updates;',
-    'after write use return=none (or summary). Do not dump full task unless needed.',
-    '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; plan_done → testing gate).',
-    'After implement: move testing (return=none). Illegal move → INVALID_TRANSITION with allowed_columns.',
-    'Transitions: icebox→planned; planned→active|icebox|testing; active→planned|testing|icebox;',
-    'testing→active|review; review→active|done; done→active. active→done is illegal.',
-    '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',
-    '(missing → warnings, not failure). move: task_id+column. update: task_id + fields or subtasks[] full list',
-    '(no toggle). plan_evidence needs real test run: diff,test_command,stdout,stderr,exit_code — truncate logs.',
-    'Example create: {"action":"create","title":"Ship image","epic":"E001","description":"...","specs":"...",',
-    '"in_scope":["CLI"],"out_of_scope":["GUI"],"acceptance_criteria":["npm test passes"],"col":"planned"}'
-  ].join(' '),
+  kanban_manage:
+    'Write board / plan. TOKEN RULES: one create beats many updates; after write return=none; kanban_read operation=help for the playbook.',
 
   kanban_gui: [
     'Web GUI control. Prefer status before start. stop only kills GUI this MCP spawned;',
@@ -70,14 +54,8 @@ const MUST_CONTAIN = [
   'TOKEN RULES',
   'view=summary',
   'return=none',
-  'plan_create',
-  'external_running',
-  'subtasks',
-  'epic_create',
-  'epic_archive',
-  'epic_delete',
-  'epic_goals',
-  'adr'
+  'help',
+  'external_running'
 ];
 
 function playbookHelpPayload() {