@vitrinka/cli 3.10.0 → 4.0.0

package/CHANGELOG.md

@@ -3,6 +3,91 @@
 `vitrinka update` prints the sections newer than your previous version after
 updating — keep entries short and user-facing.
 
+## 4.0.0
+
+One `--json` shape for ordinary commands, including help, version and doctor.
+An agent reads `ok`, then `data` or `diagnostics`, then `next`.
+
+### Changed (breaking)
+- **`--json` is an envelope**: ordinary commands print
+  `{v: 1, ok, verb, data, diagnostics, next}` on stdout, success and failure
+  alike. What a command printed before is now its `data`; a failure carries
+  one or more `diagnostics` (`code` · `severity` · `detail` · `why` · `fix`
+  · `http_status`) plus `exit_code`, and `next` lists `{do, cmd}` steps.
+  Scripts reading a top-level field (`.url`, `.slug`, `.error`) read
+  `.data.url` / `.diagnostics[0].detail` now.
+- **Misuse is a coded diagnostic, exit 2** — an unknown command, a wrong
+  argument count or a bad flag value answers `unknown_command` /
+  `bad_argument` with the corrected invocation in `fix`. An unknown
+  subcommand no longer prints the group's help page and exits 0.
+- **Every failure carries a `code`** from one closed vocabulary shared with
+  the server (`not_signed_in`, `unreachable`, `not_found`,
+  `gateway_unavailable`, …); an error with no better class is `failed`.
+  A raw library error never reaches you as styled prose under `--json`.
+
+### Added
+- A bare group under `--json` (`vitrinka task --json`) lists its commands
+  as `data.commands` instead of printing help.
+- The server's own error `code`, `detail` and `fix` are read into the
+  diagnostic when the reply carries them.
+- REST errors, including authentication and routing failures, carry a code
+  and recovery instructions. MCP exposes the same object in `structuredContent`.
+- `doctor --json` emits one failure with check results. Permission failures
+  do not suggest repeated login; malformed JSON bodies cannot silently mutate data.
+- Protocol/stream exceptions retain their output: MCP, extension host,
+  child commands via `run`, `listen`, continuous `work watch`, raw `auth token`,
+  completion scripts and interactive UI.
+- Go source builds use module `github.com/henderson-tech/vitrinka`; update
+  custom import paths and `-ldflags -X` references when building from source.
+
+## 3.11.0
+
+The task is the handoff: a session picks a task up from one bounded view,
+files what it spots the moment it sees it, and hands back through one door
+whose printed block is the hand-back. Every AI coding harness can listen.
+
+### Added
+- **`vitrinka task pickup [id|url]`** — the server-composed pickup: what the
+  task is about, the last hand-back, the branch (and whether it exists on
+  origin), what to read first, who is on it, the open children in rank order
+  and what was deliberately not loaded. MCP: `get_task {view: "pickup"}`.
+- **`vitrinka task handback [id]`** — one atomic door: next steps and
+  omissions become ranked children, the summary becomes the next version of
+  the task's `handoff` attachment, PR/board refs and status land, the parent
+  epic's `next_action` moves, and the printed block is the hand-back to paste
+  verbatim. `-` reads the exact REST body from stdin. MCP: `hand_back`.
+- **`vitrinka task spot <title>`** — file a defect or follow-up under the
+  bound task (else the project's rolling *Found during implementation* epic)
+  the moment you see it; `--production` adds the might-affect-production
+  label. MCP: `spot`.
+- **`vitrinka task start`** with no id binds the checkout's `vt-<id>` branch.
+- **Hooks**: `vitrinka project setup` offers the three Claude Code hooks
+  interactively and shows the exact `settings.json` entries — SessionStart
+  prints the pickup, SessionEnd writes the git residue into the run, and a
+  Stop gate asks for `hand_back` on a hand-back turn. `vitrinka install`
+  keeps registering them.
+- Two built-in rules move status by themselves: a run starting marks the
+  task in progress, an opened PR marks it in review (`merged-pr-completes`
+  stays).
+- **`vitrinka listen --harness <name>`** — host any harness (Codex, Gemini,
+  OpenCode, Cursor, …) over the Agent Client Protocol and feed it the scope's
+  board work; **`work watch --exec <harness>`** is the headless resume rung.
+  `install` provisions the adapters behind consent; `doctor` prints the
+  `listen·` and `acp·` rows.
+- **`vitrinka search <text>`** — the ⌘K palette from the terminal: tasks,
+  pages, boards, tags, cards, sessions and shots in one call; **`vitrinka
+  resolve <url>`** names what a pasted app URL points at, in any workspace.
+- **`vitrinka project fold <name> --into <home>`** (`fold-plan` for the dry
+  run) folds a stray project name into its real home and leaves an alias;
+  `project transfer` retires the source name.
+- Skills: `pickup`, `spot` and `handoff` (module `pm`); `listen` carries the
+  ONE listening ladder every finishing skill points at.
+
+### Changed
+- A task or epic URL in a prompt means "pickup first" for every MCP client;
+  the full tree is never loaded up front.
+- Task deep links are `/p/<project>/t/<id>`; the `/t/<id>` short form is gone.
+
 ## 3.10.0
 
 One verb per testing lane: run your suite, or explore by hand, and vitrinka

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitrinka/cli",
-  "version": "3.10.0",
+  "version": "4.0.0",
   "description": "vitrinka CLI — capture and publish artifact sets, drive the annotation-board work queue. Thin npm launcher for the single-binary Go CLI.",
   "bin": {
     "vitrinka": "bin/vitrinka.js"
@@ -15,12 +15,12 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@vitrinka/cli-darwin-arm64": "3.10.0",
-    "@vitrinka/cli-darwin-x64": "3.10.0",
-    "@vitrinka/cli-linux-arm64": "3.10.0",
-    "@vitrinka/cli-linux-x64": "3.10.0",
-    "@vitrinka/cli-win32-arm64": "3.10.0",
-    "@vitrinka/cli-win32-x64": "3.10.0"
+    "@vitrinka/cli-darwin-arm64": "4.0.0",
+    "@vitrinka/cli-darwin-x64": "4.0.0",
+    "@vitrinka/cli-linux-arm64": "4.0.0",
+    "@vitrinka/cli-linux-x64": "4.0.0",
+    "@vitrinka/cli-win32-arm64": "4.0.0",
+    "@vitrinka/cli-win32-x64": "4.0.0"
   },
   "keywords": [
     "vitrinka",