@pi-unipi/unipi 3.0.0-alpha.11 → 3.0.0-alpha.12

package/CHANGELOG.md

@@ -6,6 +6,20 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.0.0-alpha.12] — 2026-09-29
+
+### Added
+- `kanboard`: **agent `start` / `finish`** — an agent working board tasks by hand ("do UNI-5 and UNI-8") now moves them itself: `start <ID>` (todo → in_progress, self-claimed for the session; deps satisfied, not already claimed, per-project session cap) and `finish <ID> --comment "<summary>"` (in_progress → in_review; only a task this session `start`ed — another session's or a runner claim is refused; summary required). Both are free (no write credit) and need no `/unipi:kanboard-do`. A session may have several tasks started. Agent claims carry `run.owner: agent` (runner claims are unchanged on disk) and belong to the pi process (`UNIPI_KANBOARD_PID`), so the stale-claim reaper releases them to Todo when the session dies. `move` as an agent points at `start`/`finish` for those two transitions.
+- `kanboard`: **progress reminders** (setting `kanboard.reminders`, default on; no LLM, never blocking) — R1: on the first file-changing tool call of a turn, while a task named in the prompt (or `show`n) is still Todo and nothing is started, a steer is appended to that tool result; R2: at the end of a turn with a started task still In Progress, a follow-up asks to `finish` it or say what remains / block it (at most 2 per task each). Silent in runner-owned runs.
+
+### Changed
+- `kanboard`: transition table — `todo → in_progress` and `in_progress → in_review` allow the agent actor (via `start`/`finish`) besides the runner; in_review → done/todo stays user-only. The kanboard skill and the `/unipi:kanboard-do` prompt now say "`start` a task before working on it, `finish` it with a summary when done".
+- `kanboard` web UI: claimed cards distinguish an agent claim (`start`ed by a session) from a runner claim.
+- `footer`: the glance input frame is open-sided — `GlanceEditor` body rows drop the `│` rails; only the rounded corners on the top/bottom borders frame the prompt (content keeps its column via a one-space indent, rows are truncated to the inner width).
+
+### Fixed
+- `utility`: the Response formatting → Style description no longer claims the change applies "in a new session" — tool renderers are registered once at extension load, so only a restart or `/reload` applies it. The setting now reads "applies after /reload" (utility README updated to match).
+
 ## [3.0.0-alpha.11] — 2026-09-29
 
 ### Removed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.12",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -82,26 +82,26 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "3.0.0-alpha.11",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.11",
-    "@pi-unipi/btw": "3.0.0-alpha.11",
-    "@pi-unipi/command-enchantment": "3.0.0-alpha.11",
-    "@pi-unipi/compactor": "3.0.0-alpha.11",
-    "@pi-unipi/core": "3.0.0-alpha.11",
-    "@pi-unipi/footer": "3.0.0-alpha.11",
-    "@pi-unipi/fusion": "3.0.0-alpha.11",
-    "@pi-unipi/info-screen": "3.0.0-alpha.11",
-    "@pi-unipi/input-shortcuts": "3.0.0-alpha.11",
-    "@pi-unipi/kanboard": "3.0.0-alpha.11",
-    "@pi-unipi/mcp": "3.0.0-alpha.11",
-    "@pi-unipi/memory": "3.0.0-alpha.11",
-    "@pi-unipi/notify": "3.0.0-alpha.11",
-    "@pi-unipi/skill-registry": "3.0.0-alpha.11",
-    "@pi-unipi/subagents": "3.0.0-alpha.11",
-    "@pi-unipi/updater": "3.0.0-alpha.11",
-    "@pi-unipi/utility": "3.0.0-alpha.11",
-    "@pi-unipi/web-api": "3.0.0-alpha.11",
-    "@pi-unipi/workflow": "3.0.0-alpha.11"
+    "@pi-unipi/ask-user": "3.0.0-alpha.12",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.12",
+    "@pi-unipi/btw": "3.0.0-alpha.12",
+    "@pi-unipi/command-enchantment": "3.0.0-alpha.12",
+    "@pi-unipi/compactor": "3.0.0-alpha.12",
+    "@pi-unipi/core": "3.0.0-alpha.12",
+    "@pi-unipi/footer": "3.0.0-alpha.12",
+    "@pi-unipi/fusion": "3.0.0-alpha.12",
+    "@pi-unipi/info-screen": "3.0.0-alpha.12",
+    "@pi-unipi/input-shortcuts": "3.0.0-alpha.12",
+    "@pi-unipi/kanboard": "3.0.0-alpha.12",
+    "@pi-unipi/mcp": "3.0.0-alpha.12",
+    "@pi-unipi/memory": "3.0.0-alpha.12",
+    "@pi-unipi/notify": "3.0.0-alpha.12",
+    "@pi-unipi/skill-registry": "3.0.0-alpha.12",
+    "@pi-unipi/subagents": "3.0.0-alpha.12",
+    "@pi-unipi/updater": "3.0.0-alpha.12",
+    "@pi-unipi/utility": "3.0.0-alpha.12",
+    "@pi-unipi/web-api": "3.0.0-alpha.12",
+    "@pi-unipi/workflow": "3.0.0-alpha.12"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.87.1",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.12",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.11"
+    "@pi-unipi/core": "3.0.0-alpha.12"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.12",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.12",
   "description": "Background tasks for UniPi — durable shell jobs and delegated background agents with a footer dock",
   "type": "module",
   "main": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.87.1",
-    "@pi-unipi/core": "3.0.0-alpha.11",
+    "@pi-unipi/core": "3.0.0-alpha.12",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.12",
   "description": "A pi extension for parallel side conversations with /unipi:btw — part of the Unipi suite",
   "type": "module",
   "main": "extensions/btw.ts",
@@ -37,7 +37,7 @@
     "@earendil-works/pi-tui": "^0.87.1"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.11"
+    "@pi-unipi/core": "3.0.0-alpha.12"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.12",
   "description": "Compaction for Pi — lossless zero-LLM or model summaries, rebuilt from full history, with session recall",
   "type": "module",
   "main": "src/index.ts",
@@ -33,8 +33,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.11",
-    "@pi-unipi/info-screen": "3.0.0-alpha.11",
+    "@pi-unipi/core": "3.0.0-alpha.12",
+    "@pi-unipi/info-screen": "3.0.0-alpha.12",
     "@earendil-works/pi-agent-core": "^0.87.1"
   },
   "peerDependencies": {

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.12",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",

package/packages/footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.12",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.11",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.11"
+    "@pi-unipi/core": "3.0.0-alpha.12",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.12"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/footer/src/glance-editor.ts

@@ -5,12 +5,14 @@
  * subclass CustomEditor, use super.render() ONLY to obtain editor content
  * lines, then compose our own rounded frame. Layout per the v3 design:
  *
- *   ╭─UNIPI │ feat/footer-default-v2 │ ─────────────────────╮
- *   │ Type your prompt here...                              │
+ *   ╭─UNIPI │ feat/footer-default-v2 ─────────────────────╮
+ *     Type your prompt here...
  *   ╰─ unipi ────────── 42%/1.0M │ Claude Opus 4.5 │ thinking:high ╯
  *
  * Top border carries the UNIPI brand + git branch. Bottom border right side
  * carries workspace · context%/window · model · thinking level; left filler.
+ * The body is open-sided: no vertical rails — the rounded corners are the
+ * only frame marks (content keeps its column via a one-space indent).
  * All keybindings/autocomplete/history/paste behavior inherited.
  */
 
@@ -296,10 +298,10 @@ export class GlanceEditor extends CustomEditor {
 			topCluster +
 			border(BORDER.topRight);
 
-		// ── Body rows: │ content │ ──
-		const bodyRows = contentLines.map(row =>
-			border(BORDER.vertical) + padLine(row, inner) + border(BORDER.vertical),
-		);
+		// ── Body rows: open sides — the corner curves are the only frame marks.
+		// One-space indent keeps content in the column it had between the old
+		// rails; no trailing padding (rows may end short of the frame width).
+		const bodyRows = contentLines.map(row => " " + truncateToWidth(row, inner, ""));
 
 		// ── Bottom frame: ╰─ unipi ─────── [RIGHT CLUSTER] ─╯ ──
 		// Right cluster: workspace · pct%/window │ model │ thinking:level

package/packages/fusion/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/fusion",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.12",
   "description": "Devin-style model picker, fusion presets (lead + sidekick), and Local Fusion runtime for UniPi",
   "type": "module",
   "main": "src/index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.11",
-    "@pi-unipi/subagents": "3.0.0-alpha.11"
+    "@pi-unipi/core": "3.0.0-alpha.12",
+    "@pi-unipi/subagents": "3.0.0-alpha.12"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.87.1",

package/packages/info-screen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.12",
   "description": "Dashboard and module registry for Unipi — configurable info overlay with tabbed groups",
   "type": "module",
   "main": "index.ts",
@@ -32,7 +32,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.11"
+    "@pi-unipi/core": "3.0.0-alpha.12"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/input-shortcuts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.12",
   "description": "Keyboard shortcuts for stash/restore, undo/redo, clipboard, and thinking toggle — chord-based overlay system",
   "type": "module",
   "main": "src/index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.11"
+    "@pi-unipi/core": "3.0.0-alpha.12"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/kanboard/README.md

@@ -91,6 +91,7 @@ resume it or releases it to Todo.
 | `queueMax` | `10` | Tasks a session may queue (0 = unlimited); passed to the CLI as `UNIPI_KANBOARD_QUEUE_MAX` |
 | `maxSessions` | `2` | Distinct sessions running tasks per project (`UNIPI_KANBOARD_MAX_SESSIONS`) |
 | `turnAddLimit` | `20` | `add` calls allowed per -do turn or runner task (0 = unlimited) |
+| `reminders` | `true` | Progress reminders for hand-worked tasks: a steer on the first file-changing call while a mentioned task is still Todo (R1), and a follow-up at turn end while a started task is still In Progress (R2, max 2 per task). Text only, silent in runner runs |
 | *actions* | | `Open board…`, `Stop daemon`, `Summary agent command…`, `Rotate access token` |
 
 `Summary agent command…` writes through `settings set agent-command` and

package/packages/kanboard/index.ts

@@ -5,7 +5,9 @@
  * status/doctor — bare lists the commands), `/unipi:kanboard-add`,
  * `/unipi:kanboard-do` (opens the board-write window for one turn),
  * `/unipi:kanboard-autowork` (the runner loop: queue first, then claim-next).
- * The runner owns claim → In Progress and run-end → In Review. The board itself
+ * The runner owns claim → In Progress and run-end → In Review for queued work;
+ * an agent working a task by hand uses `start`/`finish` (free), nudged by the
+ * progress reminders (src/reminders.ts). The board itself
  * is written by the Rust binary (`crates/kanboard`); this extension never edits
  * task files. Bash calls into the binary are gated by the write window
  * (src/guard.ts): reads always pass, writes need a -do turn or a running task.
@@ -38,6 +40,8 @@ import {
   type CommandDeps,
 } from "./src/commands.js";
 import { createDebugLog, createRunner, registerPlanEventListener, type Runner } from "./src/runner.js";
+import { createProgressTracker, registerProgressReminders, sendReminder } from "./src/reminders.js";
+import { asTaskList } from "./src/shapes.js";
 import {
   ACTION_OPEN,
   ACTION_STOP_DAEMON,
@@ -56,6 +60,9 @@ export const KANBOARD_SKILL = "kanboard";
 export default function (pi: ExtensionAPI) {
   // One session id shared by the runner and the agent's bash calls.
   process.env.UNIPI_KANBOARD_SESSION ??= `pi-${process.pid}`;
+  // `start` claims belong to this pi process: the stale-claim reaper releases
+  // them to Todo when it dies (the agent's bash inherits the env).
+  process.env.UNIPI_KANBOARD_PID ??= String(process.pid);
   // Limits travel through the environment; refresh on load and before every
   // tool_call (see the guard registration in commands.ts).
   applyLimitEnv(readKanboardSettings());
@@ -140,6 +147,26 @@ export default function (pi: ExtensionAPI) {
   registerProgressRenderer(pi);
   registerKanboardCommands(pi, buildDeps());
 
+  // R1/R2 progress reminders for hand-worked tasks (silent in runner runs).
+  const reminders = registerProgressReminders(
+    pi,
+    createProgressTracker({
+      enabled: () => readKanboardSettings().reminders,
+      runnerOwned: () => (runner?.status().phase ?? "idle") !== "idle",
+      session: sessionId,
+      list: async () => {
+        const slug = projectSlug();
+        if (!cli || !slug) return [];
+        return asTaskList(await cli.run<unknown>(["list"], { extraEnv: { UNIPI_KANBOARD_PROJECT: slug } })).tasks;
+      },
+      cliPrefix: () => {
+        const slug = projectSlug();
+        return cli && slug ? `${cli.binary.path} --actor agent --project ${slug}` : null;
+      },
+      debug,
+    }),
+  );
+
   registerCommandRunner(ACTION_OPEN, async (ctx) => {
     const context = ctx as ExtensionContext | undefined;
     if (!context?.ui) return;
@@ -211,9 +238,13 @@ export default function (pi: ExtensionAPI) {
   });
 
   pi.on("agent_settled", async (_event, ctx) => {
-    if (!drainPending) return;
-    drainPending = false;
-    await drainQueueAfterDo(buildDeps(), ctx as unknown as ExtensionContext);
+    const reminder = reminders.takePending();
+    if (drainPending) {
+      drainPending = false;
+      await drainQueueAfterDo(buildDeps(), ctx as unknown as ExtensionContext);
+    }
+    // A drained queue hands the session to the runner: the reminder is moot.
+    if (reminder && (runner?.status().phase ?? "idle") === "idle") sendReminder(pi, reminder);
   });
 
   pi.on("session_shutdown", async (_event, ctx) => {

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.12",
   "description": "Kanboard v3 — deferred-work board: CLI/daemon bridge, task runner and skill",
   "type": "module",
   "main": "index.ts",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.11"
+    "@pi-unipi/core": "3.0.0-alpha.12"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",
@@ -48,10 +48,10 @@
     "themes": []
   },
   "optionalDependencies": {
-    "@pi-unipi/kanboard-linux-x64": "3.0.0-alpha.11",
-    "@pi-unipi/kanboard-linux-arm64": "3.0.0-alpha.11",
-    "@pi-unipi/kanboard-darwin-x64": "3.0.0-alpha.11",
-    "@pi-unipi/kanboard-darwin-arm64": "3.0.0-alpha.11",
-    "@pi-unipi/kanboard-win32-x64": "3.0.0-alpha.11"
+    "@pi-unipi/kanboard-linux-x64": "3.0.0-alpha.12",
+    "@pi-unipi/kanboard-linux-arm64": "3.0.0-alpha.12",
+    "@pi-unipi/kanboard-darwin-x64": "3.0.0-alpha.12",
+    "@pi-unipi/kanboard-darwin-arm64": "3.0.0-alpha.12",
+    "@pi-unipi/kanboard-win32-x64": "3.0.0-alpha.12"
   }
 }

package/packages/kanboard/skills/kanboard/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: kanboard
-description: "Kanboard — the project's deferred-work board. Use when the user asks to note a task for later, to see what is on the board, or while working a board task: read it with `unipi-kanboard show`, add notes, block with a question, or file follow-up work."
+description: "Kanboard — the project's deferred-work board. Use when the user asks to note a task for later, to see what is on the board, or to work board tasks (e.g. do UNI-5): `start` a task before working on it and `finish` it with a summary when done; while working a board task: read it with `unipi-kanboard show`, add notes, block with a question, or file follow-up work."
 ---
 
 # Kanboard
@@ -28,6 +28,8 @@ be on `PATH`):
 <binary> --actor agent --project <slug> edit <ID> --title|--body|--labels …   # only tasks you created, while in backlog/todo
 <binary> --actor agent --project <slug> edit <ID> --strategy none|goal|ralph|swarm|graph|auto  # how the runner works it (auto/unset = jev decides)
 <binary> --actor agent --project <slug> edit <ID> --plan yes|no|auto        # plan+approve first (auto/unset = jev decides)
+<binary> --actor agent --project <slug> start <ID>                          # todo → in progress, claimed for your session (free)
+<binary> --actor agent --project <slug> finish <ID> --comment "<summary>"   # in progress → in review, only a task you started (free)
 <binary> --actor agent --project <slug> move <ID> blocked --comment "<what you need>"
 <binary> --actor agent --project <slug> link <ID> --after <DEP>
 <binary> --actor agent --project <slug> unlink <ID> --after <DEP>
@@ -50,9 +52,9 @@ and `rotate-token` are user-only — the agent is refused.
 | Move | Who |
 |---|---|
 | backlog ↔ todo | user, agent |
-| todo → in progress | **the runner only** (`claim-next`) |
+| todo → in progress | the runner (`claim-next`), or the agent with `start <ID>` (claims it for its session) |
 | edit a task | agent — only tasks it created, and only in backlog/todo |
-| in progress → in review | **the runner only** (when your turn ends) |
+| in progress → in review | the runner (when a runner task's turn ends), or the agent with `finish <ID> --comment` — only a task its own session `start`ed |
 | in progress → blocked | agent, system — **comment required** (what you need) |
 | blocked → todo | user only — comment required (the answer) |
 | in review → done | user only |
@@ -70,8 +72,15 @@ lists them — read the files there directly if you need one.
 
 1. **Never pass `--actor user`.** That is an honour system: pretending to be the
    user to cancel a task or mark it done breaks the board's whole contract.
-2. **Never move a task to `in_review` or `done`.** The runner writes those when
-   your turn ends; claiming them yourself loses the summary and the review step.
+2. **Working a task by hand** (the user says "do UNI-5"): **`start` a task
+   before working on it, `finish` it with a summary when done** —
+   `start <ID>` before your first edit, `finish <ID> --comment "<what you did>"`
+   before your turn ends (or `move <ID> blocked --comment "<what you need>"` if
+   you cannot). Both are free and need no `/unipi:kanboard-do`. In Review means
+   "the agent did the work, a human reviews" — never leave a task you worked in
+   Todo or In Progress. You may have several tasks started. **Never move a task
+   to `done`**, and never `finish` a task the runner gave you: the runner writes
+   in_review for its own tasks when your turn ends (`finish` refuses them).
 3. **Never cancel.** If a task should be dropped, block it with
    `move <ID> blocked --comment "suggest cancel: <why>"` and let the user decide.
 4. **Follow the blocking rule in your task prompt**: by default work
@@ -85,9 +94,10 @@ lists them — read the files there directly if you need one.
    why. You may
    block only the task your own session is running (`move <ID> blocked` checks
    `--session`/`UNIPI_KANBOARD_SESSION` against the claim).
-6. **To have tasks worked during a `/unipi:kanboard-do` turn, queue them** with
-   `queue <IDs>` (Todo tasks, up to the queue limit — setting `queueMax`, default 10) — the runner starts them one by one
-   after the turn ends. Never claim or start them yourself.
+6. **To have tasks worked by the runner after a `/unipi:kanboard-do` turn, queue
+   them** with `queue <IDs>` (Todo tasks, up to the queue limit — setting
+   `queueMax`, default 10) — the runner starts them one by one after the turn
+   ends. Never `claim-next` yourself, and don't `start` a task you queued.
 7. Use `note <ID> "<text>"` for progress worth remembering (decisions, what you
    verified, what you left undone) — it is the activity log the next reader sees.
 8. Dependencies form a DAG: a task is ready only when every dep reached the chain
@@ -98,8 +108,9 @@ lists them — read the files there directly if you need one.
 ## Terminal-only execution
 
 The web UI can create, edit, reorder, link and move tasks, but it **never runs a
-task** — there is no run button. Work starts only from a terminal with
-`/unipi:kanboard-autowork start` (or the queue after a `/unipi:kanboard-do`). (The Done column's "Summarize & archive" does call the
+task** — there is no run button. Work starts only from a terminal: the runner
+(`/unipi:kanboard-autowork start`, or the queue after a `/unipi:kanboard-do`), or
+an agent that `start`s a task the user asked it to do. (The Done column's "Summarize & archive" does call the
 agent command set in the board's Settings, but only to write a summary.)
 
 ## Attachments

package/packages/kanboard/src/commands.ts

@@ -42,7 +42,7 @@ Priority -p: 1 none · 2 low · 3 medium · 4 high · 5 urgent`;
 
 export function doText(slug: string, cli: string, request: string, queueMax = 10, credits = 0): string {
   const limit = queueMax === 0 ? "Todo tasks" : `Todo tasks, at most ${queueMax}`;
-  return `[kanboard] For this request you may use the kanboard skill on project ${slug} (CLI: \`${cli} --actor agent --project ${slug} …\`). You have ${credits} write credit${credits === 1 ? "" : "s"} remaining this session — each board write (add, move, edit, note, link, order, queue) costs 1, reads are free; /unipi:kanboard-do tops the credits back up. You can add tasks, move them between backlog and todo, link, order, note, and edit tasks you created. To have tasks worked, queue them in order with \`queue <IDs>\` (${limit}); the runner starts them one by one after this turn, so do not start the work yourself. Read a task with \`show <ID>\` before editing, linking or queueing it — \`list\` only shows titles and a one-line excerpt. To choose how a task is worked, label it with \`edit <ID> --strategy none|goal|ralph|swarm|graph\` and \`--plan yes|no\`; leave it unset to let the runner decide. If the request is unclear, ask me instead of guessing.
+  return `[kanboard] For this request you may use the kanboard skill on project ${slug} (CLI: \`${cli} --actor agent --project ${slug} …\`). You have ${credits} write credit${credits === 1 ? "" : "s"} remaining this session — each board write (add, move, edit, note, link, order, queue) costs 1, reads are free; /unipi:kanboard-do tops the credits back up. You can add tasks, move them between backlog and todo, link, order, note, and edit tasks you created. To have tasks worked by the runner, queue them in order with \`queue <IDs>\` (${limit}); the runner starts them one by one after this turn. If you work a task yourself in this turn instead, \`start <ID>\` it before working on it and \`finish <ID> --comment "<summary>"\` it when done (both free) — never leave a task you worked in Todo or In Progress. Read a task with \`show <ID>\` before editing, linking or queueing it — \`list\` only shows titles and a one-line excerpt. To choose how a task is worked, label it with \`edit <ID> --strategy none|goal|ralph|swarm|graph\` and \`--plan yes|no\`; leave it unset to let the runner decide. If the request is unclear, ask me instead of guessing.
 
 Request: ${request}`;
 }

package/packages/kanboard/src/guard.ts

@@ -19,6 +19,13 @@ export const ADD_CAP_REASON = addCapReason(ADD_CAP);
 /** Subcommands that never write to the board. */
 const READONLY = new Set(["list", "show", "attachments", "next", "chain", "search", "status"]);
 
+/**
+ * Writes that cost nothing and need no -do window: `start`/`finish` only touch
+ * tasks the session claims itself (the binary enforces ownership), and the
+ * board should always show what is being worked.
+ */
+const FREE_WRITES = new Set(["start", "finish"]);
+
 /** Global flags that take a value; `--json` is the only valueless one. */
 const GLOBAL_VALUE_FLAGS = new Set(["--actor", "--project", "--gate", "--session"]);
 
@@ -60,6 +67,11 @@ export function kanboardInvocations(command: string): KanboardInvocation[] {
   return out;
 }
 
+/** A write that is free and allowed without a -do window (`start`, `finish`). */
+export function isFreeWrite(invocation: KanboardInvocation): boolean {
+  return FREE_WRITES.has(invocation.sub);
+}
+
 /** Read-only means: no writes, and the board does not change. */
 export function isReadonly(invocation: KanboardInvocation): boolean {
   if (READONLY.has(invocation.sub)) return true;
@@ -96,7 +108,7 @@ export interface WriteGuard {
 
 /**
  * Writes cost session credits (one per write subcommand in the command line);
- * reads are free and never blocked. A runner task keeps unlimited access
+ * reads and `start`/`finish` are free and never blocked. A runner task keeps unlimited access
  * (still add-capped). Credits persist across turns and follow-up questions
  * until spent; /unipi:kanboard-do tops up to N without stacking past N.
  */
@@ -149,7 +161,7 @@ export function createWriteGuard(
         lastTask = task;
       }
       for (const invocation of invocations) {
-        if (isReadonly(invocation)) continue;
+        if (isReadonly(invocation) || isFreeWrite(invocation)) continue;
         if (task !== null) {
           const cap = countAdd(invocation);
           if (cap) return cap;