kanbo-cli 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -4,6 +4,51 @@ All notable changes to kanbo are documented here. The format follows [Keep a Cha
 
 ## [Unreleased]
 
+## [0.8.0] — 2026-11-07
+
+kanbo 0.8 gives the board page Modular's look, puts sub-tasks inside their parent card, and adds an Analytics view and a List view. No board migration.
+
+### Added
+
+- An **Analytics** view on the board page (`?view=analytics`): a range of 4, 12 or 26 weeks or a sprint, figure cards, finished per week, cumulative flow and time in column drawn in SVG, aging work, agents and people tables. It reads the same numbers as `kanbo stats` and fetches nothing while another view or a hidden tab is showing.
+- `GET /issues/metrics` on `kanbo serve` (`from`, `to` in unix seconds, or `sprint=<id>`; the last 12 ISO weeks to now by default), the metrics `kanbo stats` prints. A read; additive.
+- The board page: a **List view** (Board / List switch, `?view=list`), **column badges** (a count, `n/limit` against a WIP limit in amber at the limit, and a lock whose tooltip lists a column's rules), **keys** (`j`/`k`, arrows, Enter, Space, `x`, `/`, Esc) and **selecting several cards** (a box, `x`, shift- and cmd-click) with a floating bar that sets their column or priority in one `PATCH /issues/bulk`.
+- The board page ships **Geist** (variable woff2 in latin, latin-ext and cyrillic, SIL OFL 1.1) under `/assets/fonts/`; the page's content security policy gains `font-src 'self'`.
+
+### Changed
+
+- The board page takes Modular's look: Geist type, a near-white neutral palette in light and dark, white cards with a hairline ring on quiet column bays, a 28 px toolbar with **Filter** and **Display** menus, status-category and priority icons, and toned label chips. It replaces the strip-board design.
+- **Sub-tasks** (a card with a parent) now live inside the parent's card as rows with a progress bar (`1/3 done`), and a waiting or running sub-task is never hidden (the parent shows a **Sub-task waiting for you** pill). **Display → Show sub-tasks as cards** (`?subtasks=cards`) draws them as cards of their own, marked **Sub-task of …**. The card dialog gets a breadcrumb to the parent, a sibling switcher, a **Sub-tasks** section and a property grid. "Sub-card" is now "sub-task" on the page.
+- The `kanbo init` wizard no longer asks "Add a first card?" or "Write these changes?": it asks where the board lives, the card key, the columns and which agents to connect, then writes and prints what it did. `--first-card <title>` still adds a first card.
+- In a folder with no board of its own, when only `KANBO_DB_PATH` names an app's database that is older than this kanbo or has no project for the folder, kanbo answers "This folder has no kanbo board of its own … run kanbo init here" instead of blaming the app's database. A binding or `--db` naming that database keeps the old sentence.
+
+## [0.7.0] — 2026-11-07
+
+kanbo 0.7 gives agents one way onto the board: the MCP server. The terminal keeps the person's commands. No board migration.
+
+### Removed
+
+- **Breaking:** the commands `kanbo claim`, `ready`, `prime`, `run` (all subcommands), `card` (all subcommands), `capabilities` and `instructions`. Agents use the MCP server's tools; people use the board page (`kanbo serve`) and the commands that stay (`init`, `connect`, `doctor`, `uninstall`, `board`, `columns`, `approve`, `return`, `sprint`, `stats`, `serve`, `mcp`, `migrate`, `roles`).
+- **Breaking:** `kanbo init --instructions`, `--mcp` and `--global`, and `kanbo connect --no-instructions` and `--no-mcp`. kanbo writes no instruction block anywhere any more. `kanbo init --json` no longer has the `instructions` and `mcp` fields; `kanbo connect --check --json` rows lose `instructions` and gain `oldSections`.
+- **Breaking:** the library exports `KANBO_TOOL_CLI_EQUIVALENTS` and `KanboToolCliEquivalent`, and the `cli` field of each tool in the capabilities manifest (manifest version 4). The 17 tool names, their inputs, `buildKanboTools`, `createHttpTransport` and `includeRunTools` are unchanged.
+
+### Changed
+
+- `kanbo connect` registers only the MCP server, in your own configuration by default (so one registration serves every project; `--project` writes the project's files), and removes the kanbo section older versions wrote into `CLAUDE.md`, `AGENTS.md` and `GEMINI.md`. A section you edited is kept, with a note.
+- `kanbo init` writes no agent file, and asks about agents only when one found here has no kanbo MCP registration; with `--connect` it registers the MCP server as `kanbo connect` does.
+- `kanbo doctor` warns about old kanbo sections (and `--fix` removes them) and about a machine where no agent has the MCP server registered, instead of warning that no section exists.
+- The MCP instructions tell an agent to finish the run it claimed with `kanbo_run_finish`, and to leave the board alone in a folder that has none.
+- A plain `kanbo init` makes the project's own board even when `KANBO_DB_PATH` is set; `kanbo init --db <path>` binds a project to an app's database.
+
+### Fixed
+
+- `kanbo connect --check` called kanbo's own Claude Code registration "yours": Claude Code adds an empty `env` to the entry it writes, which now counts as kanbo's own (an `env` with a variable is still yours).
+- `kanbo mcp` stopped at startup when `KANBO_DB_PATH` named a database it could not use (older than this kanbo, or with no project for the folder). It now starts, and each tool says why.
+
+### Upgrading
+
+Run `kanbo connect <agent>` or `kanbo doctor --fix` once to take the old kanbo section out of `CLAUDE.md`, `AGENTS.md` and `GEMINI.md`. Agents that used `kanbo prime`, `kanbo claim` or `kanbo card …` in a shell use the MCP tools instead; register the server with `kanbo connect`.
+
 ## [0.6.0] — 2026-11-06
 
 kanbo 0.6 measures how work flows on a board. No board migration: 0.5.0's index is all the metrics need.
@@ -220,6 +265,8 @@ First public release.
 - `kanbo serve`: the `/issues` HTTP API and a board page, loopback by default, bearer token, CORS allow-list, 1 MB body limit.
 - Library entry points `kanbo`, `kanbo/sqlite`, `kanbo/sqlite/schema`, `kanbo/postgres` and `kanbo/mcp` (ESM and CJS with types).
 
+[0.8.0]: https://github.com/Krowli/kanbo/releases/tag/v0.8.0
+[0.7.0]: https://github.com/Krowli/kanbo/releases/tag/v0.7.0
 [0.6.0]: https://github.com/Krowli/kanbo/releases/tag/v0.6.0
 [0.5.0]: https://github.com/Krowli/kanbo/releases/tag/v0.5.0
 [0.4.0]: https://github.com/Krowli/kanbo/releases/tag/v0.4.0

package/README.md

@@ -13,30 +13,31 @@
 
 ```bash
 npm install -g kanbo-cli
-cd your-project && kanbo
+kanbo connect claude              # once: registers kanbo's MCP server for every project
+cd your-project && kanbo init     # a board for this project
 ```
 
-Then tell your agent: **"take the next card from kanbo."**
+Then tell your agent: **"take the next card from kanbo."** Watch the board and approve cards with `kanbo serve`.
 
 `kanbo` with no board here starts a short setup wizard; run it again any time for the home screen. See [Getting started](docs/getting-started.md) for the walkthrough — every question it asks, what your agent does, and how to approve a card.
 
 ## What you get
 
 - **A board in a file, or a shared Postgres database.** `.kanbo/board.db` next to your code for one project on one machine, or an external Postgres (Supabase works) for a team of people and agents. See [storage](docs/storage.md).
-- **Agents work it over MCP or the CLI.** Sixteen `kanbo_*` MCP tools, and a `kanbo` command for every one of them — an agent with or without MCP works the same board. See [MCP reference](docs/mcp.md) and [CLI reference](docs/cli.md).
+- **Agents work it over MCP.** Seventeen `kanbo_*` tools, and the server explains the rules itself when the client connects — nothing is written into your project's `CLAUDE.md` or `AGENTS.md`. See [MCP reference](docs/mcp.md); the [CLI reference](docs/cli.md) covers the commands you run.
 - **You approve. kanbo enforces it, not just asks.** `approve`, `return` and column changes are a person's; an agent's shell is refused with exit code `4`, and on Postgres the database roles refuse it too. See [agents](docs/agents.md#agents-and-people).
-- **Watch it in a terminal, or in your browser.** `kanbo board` and the interactive home screen, or `kanbo serve` for a board page over HTTP. See [HTTP API](docs/http-api.md).
+- **Watch it in a terminal, or in your browser.** `kanbo board` and the interactive home screen, or `kanbo serve` for a board page over HTTP (sub-tasks inside their parent card, a List view, keys, bulk changes). See [HTTP API](docs/http-api.md).
 
 ## Works with
 
-Claude Code, Codex, Cursor, Gemini CLI — and anything else that can run a shell command or speak MCP over stdio. See [using kanbo with agents](docs/agents.md).
+Claude Code, Codex, Cursor, Gemini CLI — and anything else that speaks MCP over stdio. See [using kanbo with agents](docs/agents.md).
 
 ## Documentation
 
 - [Getting started](docs/getting-started.md) — the wizard, the home screen, connecting an agent, approving a card
 - [Installation](docs/installation.md) — npm, npx, from source, native module notes, upgrading
-- [Using kanbo with agents](docs/agents.md) — global setup, per project, per agent; the agent-vs-person rules
-- [Orchestrator examples](docs/orchestrator.md) — instruction files, Claude Code subagents, Codex, a shell loop, a worked session
+- [Using kanbo with agents](docs/agents.md) — `kanbo connect`, what the MCP server tells an agent; the agent-vs-person rules
+- [Orchestrator examples](docs/orchestrator.md) — an instruction text to paste, Claude Code subagents, Codex, a worked session
 - [CLI reference](docs/cli.md) — every command and flag
 - [MCP reference](docs/mcp.md) — every `kanbo_*` tool and its inputs
 - [HTTP API](docs/http-api.md) — `kanbo serve`, routes, security model, the board page