kanbango 2.1.0 → 2.5.0

package/.ai/retro/close.json

@@ -0,0 +1 @@
+{"goal":"push do npm","done":["session had mutations"],"next":[],"block":[],"lessons":[],"files":["/Users/mkorbas/projects/personal/markdown-kanban/mcp-server.js","/Users/mkorbas/projects/personal/markdown-kanban/kanban.js","/Users/mkorbas/projects/personal/markdown-kanban/tests/mcp-server.test.js","/Users/mkorbas/projects/personal/markdown-kanban/plan.js","/Users/mkorbas/projects/personal/markdown-kanban/CHANGELOG.md","/Users/mkorbas/projects/personal/markdown-kanban/bin/kanban.js","/Users/mkorbas/projects/personal/markdown-kanban/tests/update-tasks.test.js"],"verify":""}

package/.ai/retro/last-run.json

@@ -0,0 +1 @@
+{"ts":"2026-07-29T09:29:19.070Z","sessionID":"ses_05beb2173ffe1rCJQhZBUHuLgs","added":[],"bumped":[],"error":"llm-parse-fallback"}

package/AGENTS.md

@@ -6,7 +6,7 @@ This document provides build commands, testing procedures, and code style guidel
 
 ### Available Scripts
 ```bash
-# Start web GUI (opens http://localhost:5500)
+# Start web GUI (stable project port in 5510-5999, or KANBANGO_GUI_PORT)
 npm start
 # or
 node bin/kanban.js serve
@@ -14,7 +14,7 @@ node bin/kanban.js serve
 # Start web GUI on custom port
 node bin/kanban.js serve 8080
 
-# Run MCP server
+# Run MCP server (optional auto-GUI: KANBANGO_AUTO_GUI=1)
 npm run mcp
 # or
 node mcp-server.js
@@ -143,7 +143,7 @@ async function parseEpic(filePath, column) {
 
 // Callbacks
 function shortId(epicId) {
-  const match = epicId.match(/^(PI-\d+[\w.]*|BUG-\d+|CHORE-\d+)/);
+  const match = epicId.match(/^(?:[A-Z]+-)?(\d+)/);
   return match ? match[1] : epicId;
 }
 ```
@@ -387,9 +387,9 @@ const args = process.argv.slice(2);  // Skip node and script path
 const cmd = args[0];
 const param1 = args[1];
 
-// Example: node bin/kanban.js move PI-001 done
+// Example: node bin/kanban.js move 001 done
 // args[0] = "move"
-// args[1] = "PI-001"
+// args[1] = "001"
 // args[2] = "done"
 ```
 
@@ -560,7 +560,7 @@ After making changes, verify:
 1. CLI works: `node bin/kanban.js list --json`
 2. Web GUI starts: `node bin/kanban.js serve` (Ctrl+C to stop)
 3. MCP server tools: `echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node mcp-server.js`
-4. All three tools work: kanban_read, kanban_create, kanban_update
+4. All three tools work: kanban_read, kanban_manage, kanban_gui
 
 ## Common Patterns to Avoid
 
@@ -603,4 +603,4 @@ return { content: [{ text: JSON.stringify({ error: error.message }) }], isError:
 - README.md: https://github.com/k0r81/kanbango#readme
 - LLM Agents Guide: LLM_AGENTS.md
 - MCP Server Guide: LLM_AGENTS.md
-- Issues: https://github.com/k0r81/kanbango/issues
+- Issues: https://github.com/k0r81/kanbango/issues

package/API.md

@@ -42,7 +42,7 @@ Documentation for interacting with local Kanban system (kanban.py).
     "properties": {
       "task_id": {
         "type": "string",
-        "description": "Task ID (e.g. 'PI-014-google-calendar')"
+        "description": "Numeric task ID (e.g. '014')"
       }
     },
     "required": ["task_id"],
@@ -108,8 +108,8 @@ Documentation for interacting with local Kanban system (kanban.py).
 ```json
 {
   "type": "function",
-  "name": "kanban_toggle",
-  "description": "Toggle checkbox state for subtask (done/not done).",
+  "name": "kanban_update",
+  "description": "Update task fields, including the full subtasks list.",
   "parameters": {
     "type": "object",
     "properties": {
@@ -117,12 +117,20 @@ Documentation for interacting with local Kanban system (kanban.py).
         "type": "string",
         "description": "Parent task ID"
       },
-      "idx": {
-        "type": "integer",
-        "description": "Subtask index (starting from 0)"
+      "subtasks": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "id": { "type": "string" },
+            "text": { "type": "string" },
+            "done": { "type": "boolean" },
+            "description": { "type": "string" }
+          }
+        }
       }
     },
-    "required": ["task_id", "idx"],
+    "required": ["task_id", "subtasks"],
     "additionalProperties": false
   }
 }
@@ -138,16 +146,16 @@ python kanban.py list --json
 python kanban.py list --col active --json
 
 # Show task details
-python kanban.py show PI-014-google-calendar
+python kanban.py show 014
 
 # Add new task
 python kanban.py add "New function" --col planned --epic "Faza 6"
 
 # Move task to different column
-python kanban.py move PI-014-google-calendar active
+python kanban.py move 014 active
 
-# Toggle subtask
-python kanban.py toggle PI-014-google-calendar 0
+# Update subtasks
+python kanban.py update 014 '{"subtasks":[{"done":true,"text":"Research"},{"done":false,"text":"Implementation"}]}'
 ```
 
 ## Kanban Columns
@@ -167,7 +175,7 @@ python kanban.py toggle PI-014-google-calendar 0
   "column": "active|planned|icebox|done",
   "epic_group": "string",
   "created": "string",
-  "tasks": [
+  "subtasks": [
     {
       "done": "boolean",
       "text": "string"

package/CHANGELOG.md

@@ -5,6 +5,45 @@ All notable changes to kanbango will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.5.0] - 2026-07-27
+
+### Changed
+- Create field policy: only `title` is hard-required; `description`, `specs`, `in_scope`, `out_of_scope`, and `acceptance_criteria` are strongly recommended
+- MCP `kanban_manage` create/plan_create returns `warnings` + `missing_recommended` when recommended fields are omitted (still succeeds)
+- MCP tool descriptions and LLM agent docs push agents to always fill planning boundaries
+
+## [2.4.0] - 2026-07-27
+
+### Added
+- Opt-in GUI auto-start with MCP via `KANBANGO_AUTO_GUI=1`
+- Stable per-project GUI port (hash of cwd in `5510–5999`), overridable with `KANBANGO_GUI_PORT` or `kanban serve [PORT]`
+- `backlog/.kanbango-gui.json` port file so the real URL is always discoverable
+- `kanban_gui status` discovers a running GUI even outside the MCP child-process tracker
+
+### Changed
+- `kanban serve` default port is no longer hard-coded `5500`; uses preferred/stable port resolution
+- `kanban_gui start` waits for the server to publish its actual listen port before returning
+
+## [2.3.0] - 2026-07-27
+
+### Added
+- `in_scope` and `out_of_scope` fields (arrays of strings) for task boundaries in planning/execution/full views
+- MCP `kanban_manage` create/update support for `in_scope` and `out_of_scope`
+- Web GUI edit/view sections for In Scope and Out of Scope (muted styling for exclusions)
+- Markdown migrate support for `## In Scope` / `## Out of Scope` (and PL headings)
+
+### Fixed
+- HTTP API now forwards `test_cases` on create and update (GUI saves were previously dropped)
+
+## [2.2.0] - 2026-07-09
+
+### Changed
+- MCP tools consolidated from 6 to 3:
+  - `kanban_create` + `kanban_update` merged into `kanban_manage` with `action` parameter (`create` | `move` | `update`)
+  - `kanban_gui_start` + `kanban_gui_stop` + `kanban_gui_status` merged into `kanban_gui` with `action` parameter (`start` | `stop` | `status`)
+  - `kanban_read` unchanged
+- `kanban_manage` subtask edits now use full list updates via `update`; `toggle` action removed
+
 ## [2.1.0] - 2026-07-09
 
 ### Added