0.10.0: code quality, Trust/updater on OpenCode 2, removals announced in 0.9

.gitignore

@@ -28,3 +28,6 @@ media/social/
 
 # OpenCode project-local config and plugins (created by OpenCode in a session here)
 /.opencode/
+
+# preview snapshots for refactors (scripts/golden.ts)
+/.golden/

CHANGELOG.md

@@ -6,6 +6,40 @@ All notable changes to this project are documented here. The format follows
 
 ## [Unreleased]
 
+### Changed
+
+- **Cockpit has a home: [cockpit.codestz.dev](https://cockpit.codestz.dev).** The docs are restyled
+  to match a new landing page, and every window on both is drawn live by the bays' own renderers
+  instead of a recording. The README is short and visitor-first, each package's README shows its bay
+  in a GIF made from that window, and every npm page links to its docs.
+- **A name Cockpit does not read is said the same way, whatever its age.** 0.9 kept recognising the
+  names from before it for one release; they are now unknown names like a typo. A top-level one is
+  `! settings: "statusline" is not a setting: did you mean "status"?` in Status's column and in
+  doctor; one inside a bay's section (`review.sidebarOrder`) is named by `/cockpit-setup`, like any
+  key the bay does not read. Their values were not read in 0.9 and still are not. The site's
+  configuration page keeps the table of old names and new ones, for anyone moving an old file.
+
+### Fixed
+
+- **Trust and the updater load on OpenCode 2 when installed on their own.** OpenCode 2 sets up a
+  plugin's interface only once its agent half has loaded, and these two had none — so
+  `opencode plugin add @opencode-cockpit/trust` (or `/updater`), as the install docs say, loaded
+  nothing at all. Each now has an agent half with nothing of its own; with it, `/cockpit-setup`
+  works from either alone, too. The bundle was never affected.
+- **Doctor checks Status's agent half too.** Status has had one since 0.9 (its `/status-setup`
+  command and skill), and doctor's list of bays with two halves did not know it; a test now fails
+  when a bay with an agent half is missing from it.
+
+### Removed
+
+- **`/statusline`.** Its name until 0.9, kept for one release; `/status-setup` is the command.
+- **The `statusline-design` skill folder.** Kept in 0.9 for anyone who had copied it;
+  `skills/status-setup/` carries the same design rules, in `references/design.md`.
+- **Six entry points nothing imported:** `@opencode-cockpit/review/frame` (broken since it was
+  added: it pointed at a file that was never built there), `trail/core`, `trust/core`,
+  `updater/core`, `status/fixtures` and `client/elements`. Cockpit's own packages never used them;
+  `status/segment`, for your own segments, stays.
+
 ## [0.9.0] - 2026-10-04
 
 ### Added

CONTRIBUTING.md

@@ -137,7 +137,10 @@ The router refuses methods missing from the contract, and handler params are typ
 Files are grouped by role, not by type, and entry points stay thin:
 
 - `core/` — pure logic with no I/O and no JSX, imported by both halves (finding, classifying,
-  formatting).
+  formatting). It never touches the filesystem, git, the network or another process; the clock or an
+  environment variable is fine as a parameter's default, which a test passes instead.
+- `io/` — what a bay reads and writes outside itself: its files, git, processes it spawns. Both halves
+  use it; it may import `core/`, never the other way round.
 - `core/config.ts` — one loader for every setting: global file → project `.cockpit.json` → plugin
   options, merged section-wise. Both halves call `loadConfig()` at startup and read from the result;
   nothing else parses config, and a broken file resolves to `{}` instead of throwing.
@@ -156,7 +159,7 @@ must carry explicit types or stay module-private, or `tsc` cannot name them in d
 1. `packages/<feature>` named `@opencode-cockpit/<feature>`, exporting `./server` and/or `./tui`
    whose default export is a plugin built from factories (`create<Feature>Server`,
    `create<Feature>Tui`) that accept a `source` label and start with `claimFeature`.
-2. Add it to `BAYS` in `packages/client/src/settings.ts` — the bundle's `FEATURES`, the settings
+2. Add it to `BAYS` in `packages/client/src/settings/index.ts` — the bundle's `FEATURES`, the settings
    file and doctor all read that one list — and call its factories in the bundle's `server.ts` /
    `tui.ts`.
 3. Add the directory to `PACKAGES` in `scripts/pack-check.ts` and to the publish loop in

biome.json

@@ -1,5 +1,6 @@
 {
   "$schema": "https://biomejs.dev/schemas/2.5.13/schema.json",
+  "vcs": { "enabled": true, "clientKind": "git", "useIgnoreFile": true },
   "files": {
     "includes": ["**", "!**/node_modules", "!**/dist", "!**/types", "!**/*.tsbuildinfo", "!site", "!media"]
   },

bunfig.toml

@@ -1,4 +1,7 @@
 [test]
+# Tests live in packages/; a worktree under .claude/ (an agent's) holds a second copy of them, and
+# running both at once collides on the real daemons and terminals they start.
+root = "packages"
 # Tests run real PTYs and a real daemon; shared CI runners can be slow to spawn processes.
 timeout = 20000
 preload = ["./scripts/test-env.ts"]

packages/client/package.json

@@ -29,64 +29,60 @@
       "default": "./dist/feature.js"
     },
     "./host": {
-      "types": "./types/host.d.ts",
-      "default": "./dist/host.js"
+      "types": "./types/opencode/host/index.d.ts",
+      "default": "./dist/opencode/host/index.js"
     },
     "./server": {
-      "types": "./types/server.d.ts",
-      "default": "./dist/server.js"
+      "types": "./types/opencode/server/index.d.ts",
+      "default": "./dist/opencode/server/index.js"
     },
     "./log": {
       "types": "./types/log.d.ts",
       "default": "./dist/log.js"
     },
     "./sidebar": {
-      "types": "./types/sidebar.d.ts",
-      "default": "./dist/sidebar.js"
+      "types": "./types/opencode/sidebar.d.ts",
+      "default": "./dist/opencode/sidebar.js"
     },
     "./design": {
       "types": "./types/design.d.ts",
       "default": "./dist/design.js"
     },
-    "./elements": {
-      "types": "./types/elements.d.ts",
-      "default": "./dist/elements.js"
-    },
     "./settings": {
-      "types": "./types/settings.d.ts",
-      "default": "./dist/settings.js"
+      "types": "./types/settings/index.d.ts",
+      "default": "./dist/settings/index.js"
     },
     "./catalog": {
-      "types": "./types/catalog.d.ts",
-      "default": "./dist/catalog.js"
+      "types": "./types/settings/catalog.d.ts",
+      "default": "./dist/settings/catalog.js"
     },
     "./setup": {
-      "types": "./types/setup.d.ts",
-      "default": "./dist/setup.js"
+      "types": "./types/setup/index.d.ts",
+      "default": "./dist/setup/index.js"
     },
     "./brief": {
-      "types": "./types/brief.d.ts",
-      "default": "./dist/brief.js"
+      "types": "./types/setup/brief.d.ts",
+      "default": "./dist/setup/brief.js"
     },
     "./jsonc": {
-      "types": "./types/jsonc.d.ts",
-      "default": "./dist/jsonc.js"
+      "types": "./types/settings/jsonc.d.ts",
+      "default": "./dist/settings/jsonc.js"
     },
     "./plugin-entries": {
-      "types": "./types/plugin-entries.d.ts",
-      "default": "./dist/plugin-entries.js"
+      "types": "./types/settings/plugin-entries.d.ts",
+      "default": "./dist/settings/plugin-entries.js"
     },
     "./opener": {
       "types": "./types/opener.d.ts",
       "default": "./dist/opener.js"
     },
     "./checks": {
-      "types": "./types/checks.d.ts",
-      "default": "./dist/checks.js"
+      "types": "./types/settings/checks.d.ts",
+      "default": "./dist/settings/checks.js"
     },
     "./service": {
-      "types": "./types/service.d.ts",
-      "default": "./dist/service.js"
+      "types": "./types/opencode/service.d.ts",
+      "default": "./dist/opencode/service.js"
     }
   },
   "files": [

packages/client/skills/cockpit-setup/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cockpit-setup
-description: Set up opencode-cockpit ("Cockpit") with the user — which of its bays run, which show a block in OpenCode's sidebar, in what order, how quiet they are when empty — fix settings from before 0.9, and, when they want it, tune Cockpit to how they work (a tour of its keys and the project's conventions (dev server, ticket keys) written to AGENTS.md). Use it whenever the user runs /cockpit-setup or asks to configure, tidy or change Cockpit or its sidebar, even in passing - "make my sidebar quieter", "hide the shells block when it's empty", "move trail above subagents", "turn subagents off", "show trust in the sidebar", "configure cockpit", "tell cockpit our dev server is bun dev", "our tickets are COM-…", or a question about ~/.config/opencode-cockpit/config.json or .cockpit.json. To design what the Status line itself shows, use the status-setup skill instead.
+description: Set up opencode-cockpit ("Cockpit") with the user — which of its bays run, which show a block in OpenCode's sidebar, in what order, how quiet they are when empty — fix settings it cannot read, and, when they want it, tune Cockpit to how they work (a tour of its keys and the project's conventions (dev server, ticket keys) written to AGENTS.md). Use it whenever the user runs /cockpit-setup or asks to configure, tidy or change Cockpit or its sidebar, even in passing - "make my sidebar quieter", "hide the shells block when it's empty", "move trail above subagents", "turn subagents off", "show trust in the sidebar", "configure cockpit", "tell cockpit our dev server is bun dev", "our tickets are COM-…", or a question about ~/.config/opencode-cockpit/config.json or .cockpit.json. To design what the Status line itself shows, use the status-setup skill instead.
 ---
 
 # Setting up Cockpit
@@ -25,11 +25,12 @@ If the tool is not there, Cockpit's agent side is not loaded: say so, and point
 
 ## 2. Fix the notices first
 
-If the tool lists notices, fix them before anything else, in the file each one names: move the value
-to the new name and remove the old key (an old order number is just removed — the order is the
-top-level `sidebar` list). These names are **not read**, so the value under each is doing nothing
-today. Tell the person what you changed in one line each, e.g. `"statusline" → "status"`. Keep their
-comments and every other key.
+If the tool lists notices, fix them before anything else, in the file each one names. A key that is
+not a setting is **not read**, so the value under it is doing nothing today: when the notice says
+what was meant (`did you mean "status"?`), move the value there; otherwise ask the person. A value of
+the wrong kind falls back to the default — write it in the kind the notice asks for. Tell the person
+what you changed in one line each, e.g. `"statusline" → "status"`. Keep their comments and every
+other key.
 
 ## 3. Offer a starting point
 

packages/client/skills/cockpit-setup/references/settings.md

@@ -1,4 +1,4 @@
-<!-- Written by `bun packages/client/src/cli/reference.ts` from packages/client/src/catalog.ts. Do not edit by hand: a test fails when this file and the code disagree. -->
+<!-- Written by `bun packages/client/src/cli/reference.ts` from packages/client/src/settings/catalog.ts. Do not edit by hand: a test fails when this file and the code disagree. -->
 
 # Cockpit settings reference
 
@@ -121,28 +121,3 @@ Settings are read when OpenCode starts: a change applies after a restart.
 | --- | --- | --- | --- |
 | `enabled` | boolean | `true` | the bay runs at all, both halves. `false` turns it off entirely: no block, no commands, no tools |
 | `updateCheck` | boolean | `true` | check for plugin updates once a day and say so |
-
-## Names from before 0.9
-
-Not read at all. Each one found is a notice in `cockpit_settings` and a `!` row in its bay. In the
-same file, move the value to the new name and remove the old one:
-
-| Old | New |
-| --- | --- |
-| `statusline` | `status` |
-| `status.maxRows` | `status.sidebarRows` |
-| `watch` | `shell.watch` |
-| `kinds` | `shell.kinds` |
-| `defaults` | `shell.defaults` |
-| `lifecycle` | `shell.lifecycle` |
-| `notify` | `shell.notify` |
-| `guidance` | `shell.guidance` |
-| `listRunningShells` | `shell.listRunningShells` |
-| `ui.<key>` | `shell.<key>` |
-| `ui.historyMinutes` | `shell.hideFinishedAfterMinutes` |
-| `ui.updateCheck` | `updater.updateCheck` |
-| `ui.sidebarOrder` | the top-level `sidebar` list (remove it) |
-| `<bay>.sidebarOrder` | the top-level `sidebar` list (remove it) |
-| `subagents.hideFinishedAfter` | `subagents.hideFinishedAfterMinutes` |
-| `subagents.hideNestedAfter` | `subagents.hideNestedAfterSeconds` |
-| Status keys at the file's root (`preset`, `segments`, `enabled`…) | the same keys under `status` |

packages/client/src/cli/preview.ts

@@ -12,8 +12,8 @@
 
 import { readFileSync } from "node:fs"
 import { emptyBlock, GLYPH, type ToneRun } from "../design.ts"
-import { loadSettings, noticeText, type SettingsNotice } from "../settings.ts"
-import { settingsReport, settingsText } from "../setup.ts"
+import { loadSettings, noticeText, type SettingsNotice } from "../settings/index.ts"
+import { settingsReport, settingsText } from "../setup/index.ts"
 
 const HEX: Record<string, string> = {
   text: "#eeeeee",
@@ -54,7 +54,7 @@ const widths = arg("--width") ? [Number(arg("--width"))] : [24, 36]
 const config = arg("--config")
 const sample = {
   statusline: { preset: "sidebar" },
-  shell: { sidebarOrder: 170 },
+  shell: { sidebar: [1] },
   sidebar: ["status", "shells", "trust"],
 }
 const settings = loadSettings({

packages/client/src/cli/reference.ts

@@ -9,8 +9,8 @@
 
 import { writeFileSync } from "node:fs"
 import { join } from "node:path"
-import { settingsReference } from "../catalog.ts"
-import { SETUP_SKILL_DIR } from "../setup.ts"
+import { settingsReference } from "../settings/catalog.ts"
+import { SETUP_SKILL_DIR } from "../setup/index.ts"
 
 const file = join(SETUP_SKILL_DIR, "references", "settings.md")
 writeFileSync(file, settingsReference())