kanbango 2.0.0

package/API.md

@@ -0,0 +1,177 @@
+# Kanban API for AI Agents
+
+Documentation for interacting with local Kanban system (kanban.py).
+
+## Available Functions
+
+```json
+{
+  "type": "function",
+  "name": "kanban_list",
+  "description": "Get list of all tasks from kanban. Optionally filter by column or epic group.",
+  "parameters": {
+    "type": "object",
+    "properties": {
+      "col": {
+        "type": "string",
+        "enum": ["active", "planned", "icebox", "done"],
+        "description": "Optionally filter by column"
+      },
+      "epic": {
+        "type": "string",
+        "description": "Optionally filter by epic group"
+      },
+      "as_json": {
+        "type": "boolean",
+        "default": true,
+        "description": "Return result as JSON"
+      }
+    },
+    "additionalProperties": false
+  }
+}
+```
+
+```json
+{
+  "type": "function",
+  "name": "kanban_show",
+  "description": "Get detailed information about a specific task, including subtask list.",
+  "parameters": {
+    "type": "object",
+    "properties": {
+      "task_id": {
+        "type": "string",
+        "description": "Task ID (e.g. 'PI-014-google-calendar')"
+      }
+    },
+    "required": ["task_id"],
+    "additionalProperties": false
+  }
+}
+```
+
+```json
+{
+  "type": "function",
+  "name": "kanban_add",
+  "description": "Create new task in kanban in specified column and optional epic group.",
+  "parameters": {
+    "type": "object",
+    "properties": {
+      "title": {
+        "type": "string",
+        "description": "Title of new task"
+      },
+      "col": {
+        "type": "string",
+        "enum": ["active", "planned", "icebox", "done"],
+        "default": "planned",
+        "description": "Column to place task in"
+      },
+      "epic": {
+        "type": "string",
+        "default": "—",
+        "description": "Epic group (optional)"
+      }
+    },
+    "required": ["title"],
+    "additionalProperties": false
+  }
+}
+```
+
+```json
+{
+  "type": "function",
+  "name": "kanban_move",
+  "description": "Move existing task to different column.",
+  "parameters": {
+    "type": "object",
+    "properties": {
+      "task_id": {
+        "type": "string",
+        "description": "Task ID to move"
+      },
+      "column": {
+        "type": "string",
+        "enum": ["active", "planned", "icebox", "done"],
+        "description": "New column"
+      }
+    },
+    "required": ["task_id", "column"],
+    "additionalProperties": false
+  }
+}
+```
+
+```json
+{
+  "type": "function",
+  "name": "kanban_toggle",
+  "description": "Toggle checkbox state for subtask (done/not done).",
+  "parameters": {
+    "type": "object",
+    "properties": {
+      "task_id": {
+        "type": "string",
+        "description": "Parent task ID"
+      },
+      "idx": {
+        "type": "integer",
+        "description": "Subtask index (starting from 0)"
+      }
+    },
+    "required": ["task_id", "idx"],
+    "additionalProperties": false
+  }
+}
+```
+
+## Usage Examples
+
+```bash
+# List all tasks (JSON)
+python kanban.py list --json
+
+# List only active tasks
+python kanban.py list --col active --json
+
+# Show task details
+python kanban.py show PI-014-google-calendar
+
+# 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
+
+# Toggle subtask
+python kanban.py toggle PI-014-google-calendar 0
+```
+
+## Kanban Columns
+
+- `active` - in progress (max 1-2 tasks)
+- `planned` - planned for implementation
+- `icebox` - frozen / nice-to-have
+- `done` - completed
+
+## Data Models
+
+### Task
+```json
+{
+  "id": "string",
+  "title": "string",
+  "column": "active|planned|icebox|done",
+  "epic_group": "string",
+  "created": "string",
+  "tasks": [
+    {
+      "done": "boolean",
+      "text": "string"
+    }
+  ]
+}
+```

package/CHANGELOG.md

@@ -0,0 +1,122 @@
+# Changelog
+
+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.0.0] - 2026-07-07
+
+### Added
+- `kanban migrate` CLI command to convert `.md` task files to `.json`
+- `migrateAll()` exported function in the core module
+
+### Changed
+- **Breaking rename:** package renamed from `markdown-kanban` to `kanbango`
+- All npm/npx references updated to `kanbango`
+- MCP server name updated to `kanbango`
+- Repository URLs updated to `k0r81/kanbango`
+
+## [1.4.1] - 2026-03-17
+
+### Added
+- `npm test` now runs a simple test runner that includes regression tests
+- Regression test for updating task lists
+
+### Fixed
+- `doUpdate` now replaces the `## Taski` section instead of appending duplicates
+
+## [1.5.0] - 2026-07-07
+
+### Added
+- JSON-first task storage with rich task fields: `description`, `specs`, `acceptance_criteria`, `notes`
+- Rich subtask descriptions in storage, MCP responses, and the web GUI
+- MCP read shaping via `view` presets and explicit `fields`
+- Structured MCP error responses with `code`, `message`, `hint`, `details`, and `retryable`
+- Regression tests for read shaping, Markdown migration, and MCP responses
+
+### Changed
+- New tasks are now written as `.json` files in `backlog/<column>/`
+- `kanban_update` supports patch-style updates and compact `return` payloads
+- Web GUI editor now supports rich task planning fields and subtask descriptions
+
+### Fixed
+- Existing Markdown task files remain readable during transition and are migrated to JSON on write
+
+## [1.3.1] - 2026-03-16
+
+### Added
+- `kanban mcp-init` command to generate project MCP configs for Claude Code and OpenCode
+- Documentation for MCP per-project automation in README and LLM_AGENTS.md
+- MCP GUI control tools: `kanban_gui_start`, `kanban_gui_stop`, `kanban_gui_status`
+- README + LLM_AGENTS updates for GUI tools and npm package details
+
+## [1.2.0] - 2026-03-16
+
+### Added
+- **LLM Agents documentation**: New `LLM_AGENTS.md` with complete guide for AI assistants
+- Comprehensive tool examples with request/response patterns
+- Usage patterns for common workflows (discovery, creation, progression, epic management)
+- Best practices guide for LLM agents
+- Error handling documentation
+- **AGENTS.md**: Complete guide for AI coding agents with build/lint/test commands
+
+### Improved
+- Enhanced README reference to LLM agent documentation
+- Better integration instructions for different MCP clients
+
+### Note
+- **npm publish requires 2FA**: Publishing to npm requires two-factor authentication enabled
+- Use `npm publish --auth-token YOUR_TOKEN` with an automation token for CI/CD
+- Or use OTP (one-time password) with `npm login --auth-type=legacy`
+
+## [1.1.0] - 2026-03-16
+
+### Changed
+- **Major rewrite**: Migrated from Python to pure JavaScript
+- Removed Python dependency - now requires only Node.js 16+
+- All functionality now works natively in JavaScript
+- **Consolidated MCP tools**: Reduced from 5 to 3 universal tools (read, create, update)
+- Easier to implement across different MCP clients
+
+### Added
+- **MCP server integration**: Full Model Context Protocol support
+- 3 unified MCP tools with operation-based approach:
+  - `kanban_read` - list tasks, filter, or get details (replaces list+show)
+  - `kanban_create` - create new tasks
+  - `kanban_update` - move, toggle, or edit tasks (replaces move+toggle)
+- Enhanced tool descriptions with more context
+- GitHub repository links in package.json
+
+### Improved
+- **Better UX**: 3 tools instead of 5, easier to understand at first glance
+- Operation-based design allows for future extensibility
+- Clearer purpose for each MCP tool
+- Updated documentation with MCP configuration examples
+
+### Removed
+- Python runtime requirement
+- `kanban.py` and `kanban-cmd.py` files (replaced by pure JS)
+
+## [1.0.0] - 2026-03-15
+
+### Added
+- Initial release
+- Markdown-based Kanban board
+- Web GUI with swimlanes
+- Full CLI support
+- JSON output for AI agents
+- Epic grouping
+- Subtask progress tracking
+- Cross-platform support (Windows, macOS, Linux)
+- NPM package support
+- `kanban` and `kanban-cmd` commands
+
+### Features
+- Four columns: active, planned, icebox, done
+- Drag-and-drop interface
+- Inline editing
+- Real-time checkbox toggling
+- Progress bars
+- Toast notifications
+- Responsive design

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.