@wirecat/cli-template 0.1.3 → 0.1.5

package/.github/workflows/monthly.yml

@@ -2,7 +2,7 @@ name: Monthly validation
 
 on:
   schedule:
-    - cron: "41 3 1 * *"
+    - cron: "2 3 1 * *"
   workflow_dispatch:
 
 concurrency:

package/CHANGELOG.md

@@ -3,6 +3,79 @@
 Notable changes to `@wirecat/cli-template`. One section per version, newest first; versions follow
 [semantic versioning](https://semver.org), so before `1.0.0` the skeleton may still change.
 
+## 0.1.5 — 25.10.2026
+
+### Changed — may break callers
+
+- **The skeleton runs on cli-core 0.424.0.** When no profile exists on the computer, the error shows the command
+  that was typed with a profile added, such as `clidev personal mcp`. It used to suggest a `setup` command, which the
+  skeleton does not have. A run made without a profile is now recorded with no profile instead of as `default`, so
+  `runs list` and `runs show` leave `profile` out for such a run.
+- **`doctor --json` reports the config file's problems as `config: { path, found, issues }`, the shape the shared
+  messenger doctor has (cli-core 0.423.0).** `config.exists` and `config.error` are gone. Each issue has a `kind`
+  (`invalid_json`, `unknown_setting`, `invalid_value`, …), the `file`, the `key`, `line` and `column` for invalid JSON,
+  a sentence that says what the value has to be, and `fix`, the `config unset` command that removes it. A profile lock
+  or an environment variable the settings refuse is reported in `settings.error`. A CLI started from an older template
+  copies `src/commands/doctor.ts`.
+- **The skeleton runs on cli-core 0.423.0.** `config set` and `unset` no longer list `default_profile`,
+  `analysis_provider`, `analysis_model` or `analysis_base_url`; analysis is set with `models.analysis.*`. A file that
+  still has one of them is refused with the `config unset` that removes it.
+- **`pnpm docs:check` checks the user pages for internal ids, correction marks and struck-out text.** It now loads
+  `scripts/docs-rules.ts`, which names `README.md`, `SECURITY.md` and `docs/*.md` as user pages. A page that carries
+  a journal id fails the check until the id is removed.
+- **The spell check covers `SECURITY.md` and imports only the shared word list.** `cspell.json` no longer imports the
+  British English and Russian dictionaries again, and skips the generated `docs/commands.md` as tg and max do.
+- **The coverage floor holds for each file too: every file in `src/` keeps at least half of its lines covered.**
+  Each excluded file now says why it is excluded.
+- **Only `src/mcp.ts` may import the MCP SDK.** `biome.json` refuses `@modelcontextprotocol/*` anywhere else in
+  `src/`, so commands and services do not learn the protocol.
+- **`bin/release` takes the next free version when npm already has the one in `package.json`, or a higher one.** It
+  used to stop and ask for a new pull request. Now it raises the number (after `x.y.0` the next minor, else the next
+  patch), lands that through its own pull request once the checks pass, and publishes it, as tg, max and memo do. A
+  pre-release version is still chosen by hand. A CLI made from the template gets this with `upgrade`.
+
+### Fixed
+
+- **`<profile> mcp` stops when the stop comes before its server is up.** A stop that arrived while the server was
+  still loading was lost, and the command served until it was killed. A command result that is not an object, such
+  as a list, now reaches the agent as `{ "result": … }`, because MCP accepts only an object as a tool's structured
+  result. A CLI made from an older template takes both from `src/mcp.ts`.
+- **The missing-profile contract tests the missing profile.** It ran `mcp --json`, which is refused for `--json`
+  before the profile is read. It now runs `mcp`. A CLI made from an older template changes the case's `args` in
+  `contracts/plan.json` the same way.
+- **The package no longer ships `kit/README.md` and the kit's `tsconfig` files.** npm reads a name in `files` with no
+  leading slash as a match in every folder; the three root files are now anchored with `/`. `pnpm package:check`
+  fails when `npm pack` would ship a path that `files` does not name.
+- **The monthly run starts at 03:02 UTC, inside the window the handbook gives.** The last step `new` prints asks for
+  a free minute in that window; it spoke of a day and of a placeholder CI rejects, and no check rejects one.
+- **The 0.1.4 notes cite a handbook rule and a lint rule that no published cli-base has.** The run-log rule and
+  cli-base's `missing-run-log` lint rule are only on cli-base's main branch. They are in no release up to 0.55.1, so
+  nothing reports a CLI without `runs` until a cli-base release ships them. The 0.1.4 section stays as it was released.
+- **The README introduces the skeleton in full:** profiles, settings and permissions, limits, security, and what to do
+  when it does not work.
+- **The Reference CLIs page says how a new CLI's records join search.** A CLI with a provider of its own registers it
+  with cli-core's `registerProvider`; until it does, search lists its accounts as skipped. The page said that cli-core
+  had no provider registry, and that search would read such records as messages.
+
+## 0.1.4 — 25.10.2026
+
+### Added
+
+- **The run log can be read: `runs list`, `runs show` and `runs path`** (WC-LIFE-15). A failed command was already
+  kept as a run by cli-core's `run`, but nothing in the CLI could show it. `src/program.ts` now registers cli-core's
+  `runsCommand`. A CLI started from an older template adds the same line; cli-base's `missing-run-log` lint rule
+  reports the CLIs that have not.
+- **`new --category messenger` writes `messenger: true` into the CLI's identity.** Every other category keeps the
+  template's `messenger: false`. The Reference CLIs page says which to set.
+
+### Changed — may break callers
+
+- **The skeleton runs on cli-core 0.422.0 and says `messenger: false` in `src/identity.ts`.** The shared help,
+  `commands`, `config` and the MCP tools no longer speak of chats and messages: `--help-all`'s profile example is
+  `clidev personal doctor`, `--brief` and `--full` describe found items and their author, and `config set` and
+  `unset` no longer list `sender_colors`. cli-base stays on 0.53, because cli-core 0.422.0 accepts only cli-base 0.53.
+  A CLI that upgrades sets the field in its own `src/identity.ts` and refreshes its contract snapshots once.
+
 ## 0.1.3 — 25.10.2026
 
 ### Added

package/README.md

@@ -34,6 +34,7 @@ none is ever assumed. `CLIDEV_PROFILE=personal` does the same for a whole shell
 | `clidev personal config show` | Shows each setting and where it came from |
 | `clidev skill install` | Installs the agent skill for Claude Code, Codex and Gemini CLI |
 | `clidev personal mcp` | Serves the profile's commands to an AI agent over MCP |
+| `clidev runs list` | Lists recorded runs, newest first: every command that failed is kept |
 | `clidev upgrade --check` | Says whether a newer version is on npm |
 
 ## For AI agents
@@ -41,6 +42,32 @@ none is ever assumed. `CLIDEV_PROFILE=personal` does the same for a whole shell
 `clidev skill show` prints the rules an agent follows with this tool. `clidev personal mcp` serves every command to an
 agent, writes included: the profile's permissions decide what runs. See [MCP and permissions](docs/usage.md#agents).
 
+## Profiles
+
+A profile is a name you choose for one account, such as `personal` or `work`. It is the first word of every command
+that uses an account. No profile is ever assumed: a command without one stops and lists the profiles on this
+computer. The skeleton has no sign-in yet; the CLI built from it adds one.
+
+## Settings and permissions
+
+`clidev personal config show` lists each setting and where it came from. A profile's `permissions` say what a command
+may do: `allow`, `ask`, `readonly` or `deny`. `CLIDEV_READ_ONLY=1` refuses every write. See
+[Settings](docs/configuration.md).
+
+## Limits
+
+The skeleton connects to no service, keeps no messages and has no commands of its own beyond the shared ones above.
+
+## Security
+
+`clidev` keeps its settings and state on this computer and sends nothing to any service yet. See
+[Security](docs/security.md), and report a vulnerability privately as [SECURITY.md](SECURITY.md) says.
+
+## When it does not work
+
+Run `clidev personal doctor` first: it checks the installation without the network.
+[When something goes wrong](docs/troubleshooting.md) lists the usual symptoms.
+
 ## Documentation
 
 - [Install](docs/installation.md)
@@ -52,5 +79,6 @@ agent, writes included: the profile's permissions decide what runs. See [MCP and
 
 ## Development
 
-The working rules for people and agents are in [AGENTS.md](AGENTS.md). `pnpm release:check` runs every check the
-standards ask for. The changes are in [CHANGELOG.md](CHANGELOG.md).
+The working rules for people and agents are in [AGENTS.md](AGENTS.md). `pnpm release:check` runs the checks
+that need no install from npm; `pnpm package:check` installs the packed package and checks what it ships, and
+`pnpm security:no-leak` checks that nothing private reaches the output. The changes are in [CHANGELOG.md](CHANGELOG.md).

package/bin/release

@@ -1,6 +1,7 @@
 #!/usr/bin/env sh
 # Publishes the version in package.json and tags it. Run on a clean `main` that matches origin/main; the owner runs
-# it, never an agent. Nothing is published until `pnpm release:check` passes.
+# it, never an agent. When npm already has that version, or a higher one, it raises it to the next free one through a
+# pull request and publishes that (WC-REL-5). Nothing is published until `pnpm release:check` passes.
 #
 #   bin/release           # publishes from GitHub Actions (.github/workflows/release.yml, npm trusted publishing)
 #   bin/release --local   # publishes from this computer: NPM_TOKEN if exported, else your own `npm login`
@@ -23,7 +24,8 @@ done
 
 cd "$(dirname "$0")/.."
 self=$(git hash-object bin/release)
-# The fold fast-forwards main, and sh reads this file as it goes: a newer bin/release would run half old, half new.
+# The fold and land() fast-forward main, and sh reads this file as it goes: a newer bin/release would run half old,
+# half new.
 rerun_if_changed() {
   [ "$(git hash-object bin/release)" != "$self" ] || return 0
   [ -z "${WIRECAT_RELEASE_RERUN:-}" ] || { echo "bin/release changed again while releasing — run it again" >&2; exit 1; }
@@ -50,19 +52,70 @@ published() {
   npm view "$package@$version" version --prefer-online >/dev/null 2>&1
 }
 
+# main takes changes only through a pull request (the repository's ruleset).
+land() {
+  branch=$1 title=$2 body=$3
+  git switch -q -c "$branch"
+  git commit -q -am "$title" -m "$body"
+  git push -q -u origin "$branch"
+  git switch -q main
+  pr=$(gh pr create --base main --head "$branch" --title "$title" --body "$body")
+  # Checks register a few seconds after the pull request; --watch with none exits at once.
+  for _ in $(seq 30); do
+    [ "$(gh pr checks "$pr" --json name --jq length 2>/dev/null || echo 0)" -gt 0 ] && break
+    sleep 2
+  done
+  gh pr checks "$pr" --watch --fail-fast >/dev/null ||
+    { echo "checks failed on $pr — nothing is published" >&2; exit 1; }
+  git fetch -q origin
+  [ "$(git rev-parse HEAD)" = "$(git rev-parse origin/main)" ] ||
+    { echo "main advanced while $pr was being prepared — stop and review the current version before merging" >&2; exit 1; }
+  gh pr merge "$pr" --squash --delete-branch --subject "$title (#${pr##*/})"
+  git fetch -q origin
+  git merge -q --ff-only origin/main
+  [ "$(git rev-parse HEAD)" = "$(git rev-parse origin/main)" ] ||
+    { echo "main is not origin/main after $pr" >&2; exit 1; }
+}
+
 # A merge after the version was dated, but before it was published, adds Unreleased above it; --land folds it on a
 # fresh main through its own pull request.
 folded=""
 published || folded=$(pnpm exec cli-dev changelog fold --land --version "$version")
 [ -z "$folded" ] || echo "$folded"
 rerun_if_changed "$@"
+
+# Two sessions preparing the same number is normal; the second takes the next free one.
+latest=$(npm view "$package" version --prefer-online 2>/dev/null || true)
+versions=$(npm view "$package" versions --json --prefer-online 2>/dev/null || true)
+next=$(pnpm exec cli-dev next-version "$version" "$latest" "$versions")
+if [ "$next" != "$version" ]; then
+  taken=""
+  if published; then taken=1; why="$version is already on npm"; else why="$version is not above npm's latest $latest"; fi
+  echo "$why — publishing $next instead"
+  # A version npm already has keeps its changelog section; the unreleased one becomes the new version.
+  node -e 'const fs = require("fs"); const [o, n, taken] = process.argv.slice(1)
+    const swap = (file, from, to) => {
+      const text = fs.readFileSync(file, "utf8")
+      if (!text.includes(from)) throw new Error(`${file} has no ${JSON.stringify(from.trim())} to raise ${o} to ${n}`)
+      fs.writeFileSync(file, text.replace(from, to))
+    }
+    swap("package.json", `"version": "${o}"`, `"version": "${n}"`)
+    swap("src/version.ts", `VERSION = "${o}"`, `VERSION = "${n}"`)
+    const today = new Date().toLocaleDateString("en-GB").replaceAll("/", ".")
+    if (taken) swap("CHANGELOG.md", "\n## Unreleased\n", `\n## ${n} — ${today}\n`)
+    else swap("CHANGELOG.md", `\n## ${o} — `, `\n## ${n} — `)' "$version" "$next" "$taken"
+  body="bin/release: $why. Only the number changes: package.json, src/version.ts, the CHANGELOG heading."
+  land "release/$next" "chore(release): $next" "$body"
+  rerun_if_changed "$@"
+  version=$next
+fi
 top=$(sed -n '/^## /{p;q;}' CHANGELOG.md)
 case "$top" in
   "## $version — "[0-9][0-9].[0-9][0-9].[0-9][0-9][0-9][0-9]) ;;
   *) echo "date the top changelog section as \"## $version — DD.MM.YYYY\" in a pull request before releasing" >&2; exit 1 ;;
 esac
 if published; then
-  echo "$package@$version is already on npm; raise the version in a pull request" >&2
+  echo "$package@$version is already on npm — raise the version first" >&2
   exit 1
 fi
 

package/biome.json

@@ -2,5 +2,27 @@
   "files": {
     "includes": ["**", "!**/node_modules", "!**/dist", "!.worktrees", "!pnpm-lock.yaml", "!config/wirecat"]
   },
-  "extends": ["./config/wirecat/biome.base.json"]
+  "extends": ["./config/wirecat/biome.base.json"],
+  "overrides": [
+    {
+      "includes": ["src/**", "!src/mcp.ts", "!**/*.test.ts"],
+      "linter": {
+        "rules": {
+          "style": {
+            "noRestrictedImports": {
+              "level": "error",
+              "options": {
+                "patterns": [
+                  {
+                    "group": ["@modelcontextprotocol/**"],
+                    "message": "only src/mcp.ts serves MCP; commands and services do not know the protocol"
+                  }
+                ]
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
 }

package/contracts/mcp-tools.json

@@ -18,7 +18,7 @@
           "type": "object"
         },
         "command": {
-          "description": "a command clidev_tools_search returned: \"messages list\"",
+          "description": "a command clidev_tools_search returned: \"commands\"",
           "minLength": 1,
           "type": "string"
         }
@@ -492,7 +492,7 @@
           "type": "object"
         },
         "command": {
-          "description": "a command clidev_tools_search returned: \"messages list\"",
+          "description": "a command clidev_tools_search returned: \"commands\"",
           "minLength": 1,
           "type": "string"
         }

package/contracts/plan.json

@@ -36,7 +36,7 @@
     },
     {
       "id": "missing-explicit-profile",
-      "args": ["mcp", "--json"],
+      "args": ["mcp"],
       "exit": 2,
       "stream": "stderr",
       "kind": "json",

package/cspell.json

@@ -1,10 +1,6 @@
 {
   "version": "0.2",
-  "import": [
-    "./config/wirecat/cspell.json",
-    "@cspell/dict-en-gb/cspell-ext.json",
-    "@cspell/dict-ru_ru/cspell-ext.json"
-  ],
-  "ignorePaths": ["docs/dev/**", "CHANGELOG.md"],
-  "words": ["clidev", "cyrillic", "latin", "wirecat"]
+  "import": ["./config/wirecat/cspell.json"],
+  "ignorePaths": ["docs/commands.md", "docs/dev/**", "CHANGELOG.md"],
+  "words": ["clidev"]
 }

package/dist/commands/doctor.d.ts

@@ -1,5 +1,5 @@
 import { Command } from "commander";
-/** It is run when everything else is broken, so an unreadable config is a field in the answer, never a throw. */
+/** It is run when everything else is broken, so a problem in the config file is a field in the answer, never a throw. */
 export declare const doctorReport: (env: NodeJS.ProcessEnv) => {
     version: string;
     runtime: {
@@ -13,10 +13,31 @@ export declare const doctorReport: (env: NodeJS.ProcessEnv) => {
     };
     config: {
         path: string;
-        exists: boolean;
-        error?: string;
+        found: boolean;
+        issues: import("@wirecat/cli-core/cli").ConfigIssue[];
     };
-    profiles: string[] | null;
+    profiles: string[];
+    read_only: string | null;
+} | {
+    version: string;
+    runtime: {
+        node: string;
+        platform: NodeJS.Platform;
+    };
+    paths: {
+        config: string;
+        state: string;
+        cache: string;
+    };
+    config: {
+        path: string;
+        found: boolean;
+        issues: never[];
+    };
+    settings: {
+        error: string;
+    };
+    profiles: null;
     read_only: string | null;
 };
 export declare const doctorCommand: () => Command;

package/dist/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AASnC,iHAAiH;AACjH,eAAO,MAAM,YAAY,QAAS,MAAM,CAAC,UAAU;;;QAapC,IAAI;QAAyB,QAAQ;;;QACvC,MAAM;QAAgB,KAAK;QAAe,KAAK;;;cAXtC,MAAM;gBAAU,OAAO;gBAAU,MAAM;;;;CAgB5D,CAAA;AAED,eAAO,MAAM,aAAa,QAAO,OAS3B,CAAA"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AASnC,yHAAyH;AACzH,eAAO,MAAM,YAAY,QAAS,MAAM,CAAC,UAAU;;;QAIpC,IAAI;QAAyB,QAAQ;;;QACvC,MAAM;QAAgB,KAAK;QAAe,KAAK;;;QAO5C,IAAI;QAAuB,KAAK;QAAwB,MAAM;;;;;;;QAR/D,IAAI;QAAyB,QAAQ;;;QACvC,MAAM;QAAgB,KAAK;QAAe,KAAK;;;QAe5C,IAAI;QAAQ,KAAK;QAAoB,MAAM;;;QACzC,KAAK;;;;CAKtB,CAAA;AAED,eAAO,MAAM,aAAa,QAAO,OAS3B,CAAA"}

package/dist/commands/doctor.js

@@ -10,27 +10,34 @@ const failure = (error) => {
         return error.message;
     throw error;
 };
-/** It is run when everything else is broken, so an unreadable config is a field in the answer, never a throw. */
+/** It is run when everything else is broken, so a problem in the config file is a field in the answer, never a throw. */
 export const doctorReport = (env) => {
     const paths = resolvePaths({ appName: IDENTITY.appName, prefix: IDENTITY.envPrefix, env });
-    const file = configFilePath(paths.config);
-    let config;
-    let profiles = null;
-    try {
-        profiles = configuration.configuredProfiles({ env, readOnly: true });
-        config = { path: file, exists: existsSync(file) };
-    }
-    catch (error) {
-        config = { path: file, exists: existsSync(file), error: failure(error) };
-    }
-    return {
+    const common = {
         version: IDENTITY.version,
         runtime: { node: process.versions.node, platform: process.platform },
         paths: { config: paths.config, state: paths.state, cache: paths.cache },
-        config,
-        profiles,
-        read_only: readOnlyLockOf(IDENTITY, env) ?? null,
     };
+    const readOnly = readOnlyLockOf(IDENTITY, env) ?? null;
+    try {
+        const settings = configuration.resolveSettings({}, { env, readOnly: true, needsProfile: false, withIssues: true });
+        return {
+            ...common,
+            config: { path: settings.configPath, found: settings.configFound, issues: settings.configIssues ?? [] },
+            profiles: settings.configuredProfiles,
+            read_only: readOnly,
+        };
+    }
+    catch (error) {
+        const file = configFilePath(paths.config);
+        return {
+            ...common,
+            config: { path: file, found: existsSync(file), issues: [] },
+            settings: { error: failure(error) },
+            profiles: null,
+            read_only: readOnly,
+        };
+    }
 };
 export const doctorCommand = () => annotate(new Command("doctor"), {
     effects: LOCAL_READ,

package/dist/commands/doctor.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAClH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE;IACjC,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,KAAK,CAAC,OAAO,CAAA;IACnD,MAAM,KAAK,CAAA;AACb,CAAC,CAAA;AAED,iHAAiH;AACjH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAsB,EAAE,EAAE;IACrD,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAA;IAC1F,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACzC,IAAI,MAAyD,CAAA;IAC7D,IAAI,QAAQ,GAAoB,IAAI,CAAA;IACpC,IAAI,CAAC;QACH,QAAQ,GAAG,aAAa,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QACpE,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAA;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAA;IAC1E,CAAC;IACD,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;QACpE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;QACvE,MAAM;QACN,QAAQ;QACR,SAAS,EAAE,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,IAAI;KACjD,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,GAAY,EAAE,CACzC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE;IAC9B,OAAO,EAAE,UAAU;IACnB,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,SAAS,EAAE,GAAG,QAAQ,CAAC,OAAO,yBAAyB,CAAC;CACvF,CAAC;KACC,WAAW,CAAC,kFAAkF,CAAC;KAC/F,MAAM,CAAC;IACN,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAA;IAClD,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAChE,CAAC,CAAC,CAAA"}
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,eAAO,MAAM,OAAO,wBAAwB,CAAA;AAE5C,eAAO,MAAM,QAAQ,EAAE,WAOtB,CAAA;AAED,eAAO,MAAM,KAAK,mBAA4D,CAAA"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,eAAO,MAAM,OAAO,wBAAwB,CAAA;AAE5C,eAAO,MAAM,QAAQ,EAAE,WAQtB,CAAA;AAED,eAAO,MAAM,KAAK,mBAA4D,CAAA"}

package/dist/identity.js

@@ -7,6 +7,7 @@ export const IDENTITY = {
     description: "a new WireCat CLI, started from cli-template",
     version: VERSION,
     issues: "https://github.com/WireCatLabs/clidev-cli/issues/new",
+    messenger: false,
 };
 export const SKILL = new URL("../skills/clidev-cli/SKILL.md", import.meta.url);
 //# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,OAAO,GAAG,qBAAqB,CAAA;AAE5C,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,YAAY;IACrB,SAAS,EAAE,QAAQ;IACnB,WAAW,EAAE,8CAA8C;IAC3D,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,sDAAsD;CAC/D,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,+BAA+B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA"}
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,OAAO,GAAG,qBAAqB,CAAA;AAE5C,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,YAAY;IACrB,SAAS,EAAE,QAAQ;IACnB,WAAW,EAAE,8CAA8C;IAC3D,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,sDAAsD;IAC9D,SAAS,EAAE,KAAK;CACjB,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,+BAA+B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA"}

package/dist/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAGxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAGpD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IAChC,gGAAgG;IAChG,MAAM,EAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IAC7C,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAA;IAC/C,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACjE,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,SAAS,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;CAChD;AAID,6GAA6G;AAC7G,eAAO,MAAM,eAAe,YAAa,UAAU,KAAG,SAuCrD,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,YAAmB,UAAU,KAAG,OAAO,CAAC,IAAI,CAgBhE,CAAA"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAGxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAGpD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IAChC,gGAAgG;IAChG,MAAM,EAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IAC7C,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAA;IAC/C,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACjE,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,SAAS,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;CAChD;AAOD,6GAA6G;AAC7G,eAAO,MAAM,eAAe,YAAa,UAAU,KAAG,SAuCrD,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,YAAmB,UAAU,KAAG,OAAO,CAAC,IAAI,CAkBhE,CAAA"}

package/dist/mcp.js

@@ -4,6 +4,7 @@ import { mcpErrorResult } from "@wirecat/cli-base";
 import { registerCommands, runCommandForAgent, toolsFromCommands } from "@wirecat/cli-core/mcp";
 import { IDENTITY } from "./identity.js";
 const EXCLUDED = [["mcp"]];
+const isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /** The shared three tools — search, read, write — over every command, writes included; the levels decide. */
 export const createMcpServer = (options) => {
     const server = new McpServer({ name: IDENTITY.command, version: IDENTITY.version }, {
@@ -32,7 +33,7 @@ export const createMcpServer = (options) => {
                 const answer = await runCommandForAgent(program, tool.path, input, context);
                 if ("error" in answer)
                     return mcpErrorResult(answer.error);
-                const value = (answer.result ?? {});
+                const value = isObject(answer.result) ? answer.result : { result: answer.result };
                 return { content: [{ type: "text", text: JSON.stringify(value) }], structuredContent: value };
             },
         },
@@ -51,6 +52,9 @@ export const serveMcp = async (options) => {
                 void server.close().then(resolve, reject);
             };
             options.signal?.addEventListener("abort", stop, { once: true });
+            // A stop that came while the server module was loading has already fired, and the listener never will.
+            if (options.signal?.aborted)
+                stop();
             void server.connect(options.transport ?? new StdioServerTransport()).catch(reject);
         });
     }

package/dist/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}

package/dist/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,EAIhB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAiBxC,eAAO,MAAM,UAAU,QAAO,iBAgB5B,CAAA;AAEF,eAAO,MAAM,aAAa,aAAc,cAAc,KAAG,OAAqD,CAAA;AAE9G,eAAO,MAAM,GAAG,SAAU,MAAM,EAAE,YAAY,UAAU,KAAG,OAAO,CAAC,MAAM,CAA2C,CAAA"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,EAKhB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAiBxC,eAAO,MAAM,UAAU,QAAO,iBAiB5B,CAAA;AAEF,eAAO,MAAM,aAAa,aAAc,cAAc,KAAG,OAAqD,CAAA;AAE9G,eAAO,MAAM,GAAG,SAAU,MAAM,EAAE,YAAY,UAAU,KAAG,OAAO,CAAC,MAAM,CAA2C,CAAA"}

package/dist/program.js

@@ -1,6 +1,6 @@
 import { join } from "node:path";
 import { resolvePaths } from "@wirecat/cli-base";
-import { commandsCommand, configCommand, createProgram as createSharedProgram, outputFor, run as runShared, skillCommand, upgradeCommand, } from "@wirecat/cli-core/cli";
+import { commandsCommand, configCommand, createProgram as createSharedProgram, outputFor, run as runShared, runsCommand, skillCommand, upgradeCommand, } from "@wirecat/cli-core/cli";
 import { appUpdate } from "@wirecat/cli-core/update";
 import { doctorCommand } from "./commands/doctor.js";
 import { mcpCommand } from "./commands/mcp.js";
@@ -30,6 +30,7 @@ export const definition = () => ({
             install: (argv) => update.runUpdate(argv, {}),
         })),
         configCommand(IDENTITY, configuration),
+        runsCommand(IDENTITY),
     ],
 });
 export const createProgram = (options) => createSharedProgram(definition(), options);

package/dist/program.js.map

@@ -1 +1 @@
-{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,IAAI,mBAAmB,EACpC,SAAS,EAIT,GAAG,IAAI,SAAS,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAExD,MAAM,MAAM,GAAG,SAAS,CAAC;IACvB,WAAW,EAAE,OAAO;IACpB,OAAO,EAAE,QAAQ,CAAC,OAAO;IACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;IACzB,KAAK,EAAE,OAAO,IAAI,CAAC,GAAG;IACtB,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CACjB,IAAI,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,mBAAmB,CAAC;IAC/G,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW;IAC7F,YAAY,EAAE,CAAC,GAAG,QAAQ,CAAC,SAAS,kBAAkB,CAAC;CACxD,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAsB,EAAE,CAAC,CAAC;IAClD,GAAG,EAAE,QAAQ;IACb,aAAa,EAAE,EAAE,eAAe,EAAE,aAAa,CAAC,eAAe,EAAE;IACjE,QAAQ,EAAE,GAAG,EAAE,CAAC;QACd,eAAe,CAAC,QAAQ,CAAC;QACzB,aAAa,EAAE;QACf,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC;QAC7B,UAAU,EAAE;QACZ,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC9C,GAAG,SAAS,CAAC,OAAO,CAAC;YACrB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;SAC9C,CAAC,CAAC;QACH,aAAa,CAAC,QAAQ,EAAE,aAAa,CAAC;KACvC;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAwB,EAAW,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAA;AAE9G,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,IAAc,EAAE,OAAoB,EAAmB,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAA"}
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,IAAI,mBAAmB,EACpC,SAAS,EAIT,GAAG,IAAI,SAAS,EAChB,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAExD,MAAM,MAAM,GAAG,SAAS,CAAC;IACvB,WAAW,EAAE,OAAO;IACpB,OAAO,EAAE,QAAQ,CAAC,OAAO;IACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;IACzB,KAAK,EAAE,OAAO,IAAI,CAAC,GAAG;IACtB,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CACjB,IAAI,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,mBAAmB,CAAC;IAC/G,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW;IAC7F,YAAY,EAAE,CAAC,GAAG,QAAQ,CAAC,SAAS,kBAAkB,CAAC;CACxD,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAsB,EAAE,CAAC,CAAC;IAClD,GAAG,EAAE,QAAQ;IACb,aAAa,EAAE,EAAE,eAAe,EAAE,aAAa,CAAC,eAAe,EAAE;IACjE,QAAQ,EAAE,GAAG,EAAE,CAAC;QACd,eAAe,CAAC,QAAQ,CAAC;QACzB,aAAa,EAAE;QACf,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC;QAC7B,UAAU,EAAE;QACZ,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC9C,GAAG,SAAS,CAAC,OAAO,CAAC;YACrB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;SAC9C,CAAC,CAAC;QACH,aAAa,CAAC,QAAQ,EAAE,aAAa,CAAC;QACtC,WAAW,CAAC,QAAQ,CAAC;KACtB;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAwB,EAAW,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAA;AAE9G,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,IAAc,EAAE,OAAoB,EAAmB,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAA"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.3";
+export declare const VERSION = "0.1.5";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "0.1.3";
+export const VERSION = "0.1.5";
 //# sourceMappingURL=version.js.map

package/docs/commands.md

@@ -18,18 +18,18 @@ lists the profiles on this computer.
 | `--json` | machine-readable output: one JSON value on stdout; --json=id,text keeps only those fields. |
 | `--jsonl` | machine-readable output: one JSON object per line, for streaming and jq. |
 | `--quiet` | diagnostics off; a failure is still said. |
-| `--trace` | the connection's own log lines on stderr — never message content. |
+| `--trace` | the connection's own log lines on stderr — never content. |
 | `--debug` | on a failure, its whole record — cause and stack — in place of the short line. |
 | `--timeout <duration>` | give up on the whole command after this — 30s, 2m, 500ms. |
 | `--offline` | answer from what was recorded and never connect; fails if nothing was. |
 | `--no-input` | never prompt or open interactive login; piped input remains available. |
 | `--max-input-bytes <bytes>` | maximum buffered input bytes (default: 16777216). |
 | `--max-output-bytes <bytes>` | maximum machine output bytes (default: 4194304; 0 disables). |
-| `--brief` | found messages as reference, title, time, sender and excerpt only. |
-| `--full` | found messages with their whole text and every provider field. |
+| `--brief` | found items as reference, title, time, author and excerpt only. |
+| `--full` | found items with their whole text and every provider field. |
 | `--dry-run` | preview parsed arguments and permissions before running the action. |
 | `--yes` | go ahead without the question an ask level puts before a write. |
-| `--record` | keep this run — ids and timings, never message content. |
+| `--record` | keep this run — ids and timings, never content. |
 | `--no-record` | do not keep it, whatever the configuration says. |
 
 ## `clidev commands`
@@ -50,7 +50,7 @@ clidev commands info [path]
 
 **Returns:** one command contract, or all schemas, error reasons and explicit overrides
 
-**Example:** `clidev commands info messages list`
+**Example:** `clidev commands info commands`
 
 ## `clidev doctor`
 
@@ -166,7 +166,7 @@ clidev config set <setting> <value> [options]
 
 | Argument | | What it is |
 |---|---|---|
-| `setting` | required | one of: limit, timeout_ms, color, sender_colors, record, keep_runs_for_days, permissions, sends_per_hour, requests_per_minute, transcribe_with, speech_model, search_catch_up, picture_search, embedding_provider, embedding_model, embedding_base_url, embedding_dims, analysis_provider, analysis_model, analysis_base_url, models, read_other_bots, update_check, skill_hint, search_stemmers.cyrillic, search_stemmers.latin, phone_countries, task_categories.<name>, task_agent_close, task_agent_close_min, task_first_pass_per_chat, account_groups.<name>. |
+| `setting` | required | one of: limit, timeout_ms, color, record, keep_runs_for_days, permissions, sends_per_hour, requests_per_minute, transcribe_with, speech_model, search_catch_up, picture_search, embedding_provider, embedding_model, embedding_base_url, embedding_dims, models, read_other_bots, update_check, skill_hint, search_stemmers.cyrillic, search_stemmers.latin, phone_countries, task_categories.<name>, task_agent_close, task_agent_close_min, task_first_pass_per_chat, account_groups.<name>. |
 | `value` | required | a number, true or false; for a group tg:work,max:Alice,email:me@x. |
 
 | Option | What it does |
@@ -191,7 +191,7 @@ clidev config unset <setting> [options]
 
 | Argument | | What it is |
 |---|---|---|
-| `setting` | required | one of: limit, timeout_ms, color, sender_colors, record, keep_runs_for_days, permissions, sends_per_hour, requests_per_minute, transcribe_with, speech_model, search_catch_up, picture_search, embedding_provider, embedding_model, embedding_base_url, embedding_dims, analysis_provider, analysis_model, analysis_base_url, models, read_other_bots, update_check, skill_hint, default_profile, search_stemmers.cyrillic, search_stemmers.latin, phone_countries, task_categories.<name>, task_agent_close, task_agent_close_min, task_first_pass_per_chat, account_groups.<name>. |
+| `setting` | required | one of: limit, timeout_ms, color, record, keep_runs_for_days, permissions, sends_per_hour, requests_per_minute, transcribe_with, speech_model, search_catch_up, picture_search, embedding_provider, embedding_model, embedding_base_url, embedding_dims, models, read_other_bots, update_check, skill_hint, search_stemmers.cyrillic, search_stemmers.latin, phone_countries, task_categories.<name>, task_agent_close, task_agent_close_min, task_first_pass_per_chat, account_groups.<name>. |
 
 | Option | What it does |
 |---|---|
@@ -203,6 +203,67 @@ clidev config unset <setting> [options]
 
 **Example:** `clidev personal config unset limit`
 
+## `clidev runs`
+
+recorded runs — what this tool did, and when
+
+### `clidev runs list`
+
+recorded runs, newest first
+
+```sh
+clidev runs list [query] [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `query` | optional | field:value terms that narrow the list — the fields are below. |
+
+| Option | What it does |
+|---|---|
+| `--limit <n>` | how many to show. Default: `20`. |
+| `--page <n>` | which page, starting at 1. Default: `1`. |
+
+**Returns:** run — run_id, command, started_at, status, cli_version, profile, completed_at, requests, and 15 more; every field: clidev commands info runs list
+
+**Example:** `clidev personal runs list --limit 10`
+
+### `clidev runs show`
+
+one run: what it was, how it ended, and every event it logged
+
+```sh
+clidev runs show <run-id> [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `run-id` | required | an id from `clidev runs list`. |
+
+| Option | What it does |
+|---|---|
+| `--problems` | only failed responses, warnings and crashes. |
+
+**Returns:** run details — run_id, command, started_at, status, cli_version, directory, event_count, events, and 14 more; every field: clidev commands info runs show
+
+**Example:** `clidev personal runs show run-101`
+
+### `clidev runs path`
+
+the directory holding one run
+
+```sh
+clidev runs path <run-id>
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `run-id` | required | an id from `clidev runs list`. |
+
+**Returns:** run location — path; every field: clidev commands info runs path
+
+**Example:** `clidev personal runs path run-101`
+
 ## Exit codes
 
 Branch on the code, not on the text: the text can change, the code does not.

package/docs/dev/reference-clis.md

@@ -11,5 +11,13 @@ the first question of the [design interview](skills/design-interview/SKILL.md):
 | notes | [cli-memo](https://github.com/WireCatLabs/cli-memo) |
 | mail, calendar, other | none yet: pick the nearest one with the owner |
 
-Until cli-core has a provider registry, a CLI made from this template is not listed as a provider of its own, and
-`search` finds its records as messages.
+A messenger CLI sets `messenger: true` in `src/identity.ts`, and `new --category messenger` writes it. Every other
+category keeps the template's `messenger: false`, so the shared help, `commands` and `config` do not speak of chats,
+messages and senders.
+
+cli-core keeps a provider registry (WC-ARCH-21). A CLI whose provider is not built into cli-core calls
+`registerProvider(store, { name, kind, aliases, command })` from `@wirecat/cli-core/store` on every run that opens
+the shared store. `kind` is one of `messages`, `mail`, `notes`, `documents`, `meetings` or `events`. Until the CLI
+has run once on a computer, `search` there leaves its accounts out and lists them under `skipped`. The reference CLIs
+do not show this call: their providers are built into cli-core. The skeleton opens no store and has no provider, so
+it registers nothing; the call comes with the CLI's first store code.

package/docs/dev/test-matrix.md

@@ -7,7 +7,7 @@ ran it · ⛔ not tested offline, with the reason and where it is checked instea
 Measured from the test run (`coverage/argv.jsonl`), not searched for — see
 [TESTING.md](TESTING.md) for how, and for the states and failures that cut across commands.
 
-**37 ✅ · 2 ⛔ · 0 ❌** — 11 commands, 28 options.
+**43 ✅ · 2 ⛔ · 0 ❌** — 14 commands, 31 options.
 
 | Command | Option | | Note |
 |---|---|---|---|
@@ -30,6 +30,12 @@ Measured from the test run (`coverage/argv.jsonl`), not searched for — see
 | `config unset` | `--defaults` | ✅ |  |
 | `config unset` | `--personal` | ✅ |  |
 | `config unset` | `--bot` | ✅ |  |
+| `runs list` |  | ✅ |  |
+| `runs list` | `--limit` | ✅ |  |
+| `runs list` | `--page` | ✅ |  |
+| `runs show` |  | ✅ |  |
+| `runs show` | `--problems` | ✅ |  |
+| `runs path` |  | ✅ |  |
 | `help` |  | ✅ |  |
 | *global* | `--version` | ⛔ | Commander answers before any command runs, so the trace never sees it; `pnpm version:check` checks it |
 | *global* | `--verbose` | ✅ |  |

package/docs/troubleshooting.md

@@ -8,7 +8,7 @@ support request.
 | Not sure what is set up | Run `clidev personal doctor`. It reads no keyring and uses no network. |
 | `clidev` is not found | Open a new terminal, and check that npm's global folder is on `PATH`. |
 | "name a profile" | Put the profile first, as in `clidev personal config show`, or set `CLIDEV_PROFILE`. |
-| The settings file does not read | `doctor` names the file and the error. Fix it, or move it away and set the values again. |
+| The settings file does not read | `doctor` lists every problem in the file under `config.issues`. Run the `config unset` each one gives, or fix the file by hand. |
 | A write is refused | The profile's permissions or `CLIDEV_READ_ONLY` stop it; see [settings](configuration.md#permissions). |
 
 Never paste a token, a password or private content into a support request.

package/kit/dist/new.js

@@ -167,6 +167,8 @@ export const withContentLanguages = (text, languages) => {
     const line = `  contentLanguages: [${languages.map((code) => JSON.stringify(code)).join(", ")}],\n`;
     return text.slice(0, end) + line + text.slice(end);
 };
+// cli-core treats an unset or true `messenger` as a messenger and speaks of chats; the template says false.
+export const withMessenger = (text, category) => category === "messenger" ? text.replace(/^ {2}messenger: false,$/m, "  messenger: true,") : text;
 export const cliReadme = (names) => [
     `# ${names.command}`,
     "",
@@ -212,7 +214,7 @@ export const markExecutable = async (cwd, paths) => {
 export const manualSteps = (names) => [
     `1. Create the repository ${names.owner}/${names.name} and its main ruleset (cli-base docs/standards/new-cli.md).`,
     `2. Set npm trusted publishing for ${names.package}, naming release.yml (WC-REL-11), and add any secrets.`,
-    "3. Pick a monthly cron day no other repository uses: .github/workflows/monthly.yml holds a placeholder CI rejects.",
+    "3. Give .github/workflows/monthly.yml a cron minute between 02:17 and 03:20 UTC that no other repository uses.",
     "4. WireCat CLIs only: a pull request to cli-base's PARITY_GROUPS, a line in cli-core's WIRECAT_TOOLS and in cli-docs' tools.json.",
 ];
 export const runNew = async (cwd, source, args, io) => {
@@ -227,7 +229,7 @@ export const runNew = async (cwd, source, args, io) => {
         "README.md": () => cliReadme(names),
         "CHANGELOG.md": () => cliChangelog(names, source),
         [VERSION_FILE]: (text) => text.replace(/VERSION = "[^"]*"/, 'VERSION = "0.0.0"'),
-        [IDENTITY_FILE]: (text) => withContentLanguages(text, answers.contentLang ?? []),
+        [IDENTITY_FILE]: (text) => withMessenger(withContentLanguages(text, answers.contentLang ?? []), category),
         "AGENTS.md": (text) => withReference(text, category),
     };
     const hashes = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-template",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Start a new WireCat CLI: a working skeleton on cli-base and cli-core, copied by new and kept current by upgrade",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",
@@ -32,7 +32,7 @@
     "CHANGELOG.md",
     "CLAUDE.md",
     "LICENSE",
-    "README.md",
+    "/README.md",
     "SECURITY.md",
     ".gitattributes",
     ".gitleaks.toml",
@@ -43,9 +43,9 @@
     "lefthook.yml",
     "pnpm-workspace.yaml",
     "template.json",
-    "tsconfig.json",
+    "/tsconfig.json",
     "tsconfig.scripts.json",
-    "tsconfig.test.json",
+    "/tsconfig.test.json",
     "vitest.config.ts",
     "gitignore"
   ],
@@ -63,7 +63,7 @@
     "smoke": "node --experimental-strip-types scripts/smoke.ts",
     "smoke:bun": "bun scripts/smoke.ts",
     "package:check": "pnpm smoke",
-    "docs:check": "cli-dev docs-check --pages && cspell --no-progress --no-summary README.md 'docs/*.md' && rumdl check --config config/wirecat/rumdl.toml README.md CLAUDE.md AGENTS.md docs/*.md docs/dev/*.md && pnpm docs:lint",
+    "docs:check": "cli-dev docs-check --rules scripts/docs-rules.ts --pages && pnpm docs:spell && rumdl check --config config/wirecat/rumdl.toml README.md SECURITY.md CLAUDE.md AGENTS.md docs/*.md docs/dev/*.md && pnpm docs:lint",
     "docs:lint": "markdownlint-cli2",
     "contracts:check": "cli-contract contracts/plan.json",
     "security:no-leak": "cli-testing security no-leak . contracts/no-leak.json",
@@ -76,7 +76,7 @@
     "release:check": "pnpm standards:check && pnpm lint && pnpm typecheck && pnpm test:coverage && pnpm lint:commands && pnpm audit:commands && pnpm contracts:check && pnpm test:matrix:check && pnpm docs:check && pnpm generate:check && pnpm version:check",
     "prepare": "lefthook install || true",
     "prepack": "pnpm build",
-    "docs:spell": "cspell lint --config cspell.json --no-progress README.md",
+    "docs:spell": "cspell lint --config cspell.json --no-progress --no-summary README.md SECURITY.md 'docs/*.md'",
     "kit:build": "tsc -p kit && node -e \"require('node:fs').copyFileSync('.gitignore', 'gitignore')\"",
     "kit:typecheck": "tsc -p kit/tsconfig.test.json",
     "kit:e2e": "bash kit/e2e.sh"
@@ -84,7 +84,7 @@
   "dependencies": {
     "@modelcontextprotocol/server": "2.3.0",
     "@wirecat/cli-base": "0.53.0",
-    "@wirecat/cli-core": "0.421.0",
+    "@wirecat/cli-core": "0.424.0",
     "commander": "15.0.0"
   },
   "devDependencies": {

package/scripts/docs-rules.ts

@@ -0,0 +1,15 @@
+import { type DocsRules, JOURNAL_IDS, markdownFiles } from "@wirecat/cli-base/release"
+
+export const CHANGELOG = {
+  headings: ["Added", "Changed — may break callers", "Fixed", "Security", "Removed"],
+  unreleased: "Unreleased",
+  ids: JOURNAL_IDS,
+}
+
+const USER_PAGES = /^(README|SECURITY)\.md$|^docs\/[^/]+\.md$/
+
+export const docsRules = (root: string): DocsRules => ({
+  files: markdownFiles(root, new Set(["node_modules", "dist", "coverage", ".git"])),
+  ids: JOURNAL_IDS,
+  userPage: (name) => USER_PAGES.test(name.replaceAll("\\", "/")),
+})

package/scripts/smoke.ts

@@ -1,11 +1,21 @@
 import assert from "node:assert/strict"
 import { execFileSync } from "node:child_process"
-import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs"
 import { tmpdir } from "node:os"
 import { join, resolve } from "node:path"
+import { packContents } from "@wirecat/cli-base/release"
 
 const root = resolve(import.meta.dirname, "..")
-const { name, version } = JSON.parse(readFileSync(join(root, "package.json"), "utf8"))
+const { name, version, files } = JSON.parse(readFileSync(join(root, "package.json"), "utf8")) as {
+  name: string
+  version: string
+  files: string[]
+}
+// npm reads `files` like .gitignore: a name with no leading slash also matches the same name in any folder.
+const shipped = files
+  .map((entry) => entry.replace(/^\//, ""))
+  .map((entry) => (statSync(join(root, entry), { throwIfNoEntry: false })?.isDirectory() ? `${entry}/` : entry))
+assert.deepEqual(packContents(root, ["package.json", ...shipped], "package.json and the paths in its files list")(), [])
 const temp = mkdtempSync(join(tmpdir(), "clidev-package-"))
 try {
   const userConfig = join(temp, "npm-user-config")

package/src/commands/doctor.ts

@@ -11,25 +11,32 @@ const failure = (error: unknown) => {
   throw error
 }
 
-/** It is run when everything else is broken, so an unreadable config is a field in the answer, never a throw. */
+/** It is run when everything else is broken, so a problem in the config file is a field in the answer, never a throw. */
 export const doctorReport = (env: NodeJS.ProcessEnv) => {
   const paths = resolvePaths({ appName: IDENTITY.appName, prefix: IDENTITY.envPrefix, env })
-  const file = configFilePath(paths.config)
-  let config: { path: string; exists: boolean; error?: string }
-  let profiles: string[] | null = null
-  try {
-    profiles = configuration.configuredProfiles({ env, readOnly: true })
-    config = { path: file, exists: existsSync(file) }
-  } catch (error) {
-    config = { path: file, exists: existsSync(file), error: failure(error) }
-  }
-  return {
+  const common = {
     version: IDENTITY.version,
     runtime: { node: process.versions.node, platform: process.platform },
     paths: { config: paths.config, state: paths.state, cache: paths.cache },
-    config,
-    profiles,
-    read_only: readOnlyLockOf(IDENTITY, env) ?? null,
+  }
+  const readOnly = readOnlyLockOf(IDENTITY, env) ?? null
+  try {
+    const settings = configuration.resolveSettings({}, { env, readOnly: true, needsProfile: false, withIssues: true })
+    return {
+      ...common,
+      config: { path: settings.configPath, found: settings.configFound, issues: settings.configIssues ?? [] },
+      profiles: settings.configuredProfiles,
+      read_only: readOnly,
+    }
+  } catch (error) {
+    const file = configFilePath(paths.config)
+    return {
+      ...common,
+      config: { path: file, found: existsSync(file), issues: [] },
+      settings: { error: failure(error) },
+      profiles: null,
+      read_only: readOnly,
+    }
   }
 }
 

package/src/identity.ts

@@ -10,6 +10,7 @@ export const IDENTITY: AppIdentity = {
   description: "a new WireCat CLI, started from cli-template",
   version: VERSION,
   issues: "https://github.com/WireCatLabs/clidev-cli/issues/new",
+  messenger: false,
 }
 
 export const SKILL = new URL("../skills/clidev-cli/SKILL.md", import.meta.url)

package/src/mcp.test.ts

@@ -78,7 +78,6 @@ it("clidev <profile> mcp starts the server and ends on a signal", async () => {
     tty: false,
     streams: { data: () => {}, diagnostic: () => {} },
   })
-  await new Promise((resolve) => setTimeout(resolve, 200))
   stop.abort()
   expect(await serving).toBe(0)
 })

package/src/mcp.ts

@@ -20,6 +20,9 @@ export interface McpOptions {
 
 const EXCLUDED = [["mcp"]]
 
+const isObject = (value: unknown): value is Record<string, unknown> =>
+  typeof value === "object" && value !== null && !Array.isArray(value)
+
 /** The shared three tools — search, read, write — over every command, writes included; the levels decide. */
 export const createMcpServer = (options: McpOptions): McpServer => {
   const server = new McpServer(
@@ -52,7 +55,7 @@ export const createMcpServer = (options: McpOptions): McpServer => {
         run: async (input) => {
           const answer = await runCommandForAgent(program, tool.path, input, context)
           if ("error" in answer) return mcpErrorResult(answer.error)
-          const value = (answer.result ?? {}) as Record<string, unknown>
+          const value = isObject(answer.result) ? answer.result : { result: answer.result }
           return { content: [{ type: "text" as const, text: JSON.stringify(value) }], structuredContent: value }
         },
       },
@@ -73,6 +76,8 @@ export const serveMcp = async (options: McpOptions): Promise<void> => {
         void server.close().then(resolve, reject)
       }
       options.signal?.addEventListener("abort", stop, { once: true })
+      // A stop that came while the server module was loading has already fired, and the listener never will.
+      if (options.signal?.aborted) stop()
       void server.connect(options.transport ?? new StdioServerTransport()).catch(reject)
     })
   } finally {

package/src/program.test.ts

@@ -1,6 +1,7 @@
 import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs"
 import { join } from "node:path"
 import { expect, it } from "vitest"
+import { doctorReport } from "./commands/doctor.js"
 import { IDENTITY } from "./identity.js"
 import { run } from "./program.js"
 
@@ -19,26 +20,46 @@ it("lists the required root commands and config", async () => {
   const { code, out } = await ran(["commands", "--json"])
   expect(code).toBe(0)
   const names = (JSON.parse(out) as { commands: { name: string }[] }).commands.map((command) => command.name)
-  expect(names).toEqual(expect.arrayContaining(["commands", "doctor", "skill", "mcp", "upgrade", "config"]))
+  expect(names).toEqual(expect.arrayContaining(["commands", "doctor", "skill", "mcp", "upgrade", "config", "runs"]))
 })
 
 it("doctor answers without a config file", async () => {
   const { code, out } = await ran(["doctor", "--json"])
   expect(code).toBe(0)
-  expect(json(out).item).toMatchObject({ config: { exists: false }, profiles: [], read_only: null })
+  expect(json(out).item).toMatchObject({ config: { found: false, issues: [] }, profiles: [], read_only: null })
 })
 
-it("doctor reports an unreadable config as a field", async () => {
+const withConfig = async (text: string, check: (config: unknown) => void) => {
   const dir = process.env.CLIDEV_CONFIG_DIR ?? ""
   mkdirSync(dir, { recursive: true })
-  writeFileSync(join(dir, "config.json"), "not json")
+  writeFileSync(join(dir, "config.json"), text)
   try {
     const { code, out } = await ran(["doctor", "--json"])
     expect(code).toBe(0)
-    expect(json(out).item.config).toMatchObject({ exists: true, error: expect.any(String) })
+    check(json(out).item.config)
   } finally {
     rmSync(join(dir, "config.json"))
   }
+}
+
+it("doctor reports invalid JSON as an issue", async () => {
+  await withConfig('{\n  "defaults": {\n', (config) =>
+    expect(config).toMatchObject({ found: true, issues: [{ kind: "invalid_json", line: 3 }] }),
+  )
+})
+
+it("doctor reports an unknown setting with the command that removes it", async () => {
+  await withConfig('{ "defaults": { "limt": 3 } }', (config) =>
+    expect(config).toMatchObject({
+      found: true,
+      issues: [{ kind: "unknown_setting", key: "limt", fix: "clidev config unset --defaults limt" }],
+    }),
+  )
+})
+
+it("doctor reports settings an environment variable breaks, and still answers", () => {
+  const report = doctorReport({ ...process.env, CLIDEV_EMBEDDING_DIMS: "many" })
+  expect(report).toMatchObject({ config: { issues: [] }, settings: { error: expect.any(String) }, profiles: null })
 })
 
 it("config show names the profile it was given", async () => {
@@ -64,3 +85,21 @@ it("upgrade --check installs nothing when npm cannot be reached", async () => {
   expect(code).toBe(0)
   expect(json(out).item).toMatchObject({ current: IDENTITY.version, latest: null, updated: false })
 })
+
+it("keeps a failed command as a run, and runs list, show and path read it back", async () => {
+  expect((await ran(["--no-such-flag"])).code).toBe(2)
+  const listed = await ran(["runs", "list", "--limit", "5", "--page", "1", "--json"])
+  expect(listed.code).toBe(0)
+  const failed = (JSON.parse(listed.out) as { items: { run_id: string; status: string }[] }).items.find(
+    (run) => run.status === "failed",
+  )
+  expect(failed).toBeDefined()
+  const id = failed?.run_id ?? ""
+  const shown = await ran(["runs", "show", id, "--json"])
+  expect(shown.code).toBe(0)
+  expect(shown.out).toContain(id)
+  expect((await ran(["runs", "show", id, "--problems", "--json"])).code).toBe(0)
+  const path = await ran(["runs", "path", id])
+  expect(path.code).toBe(0)
+  expect(path.out).toContain(id)
+})

package/src/program.ts

@@ -9,6 +9,7 @@ import {
   type ProgramOptions,
   type RunOptions,
   run as runShared,
+  runsCommand,
   skillCommand,
   upgradeCommand,
 } from "@wirecat/cli-core/cli"
@@ -45,6 +46,7 @@ export const definition = (): ProgramDefinition => ({
       install: (argv) => update.runUpdate(argv, {}),
     })),
     configCommand(IDENTITY, configuration),
+    runsCommand(IDENTITY),
   ],
 })
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = "0.1.3"
+export const VERSION = "0.1.5"

package/vitest.config.ts

@@ -11,9 +11,15 @@ export default defineConfig({
     coverage: {
       provider: "v8",
       include: ["src/**/*.ts"],
-      exclude: ["src/**/*.test.ts", "src/testing/**", "src/bin/**"],
+      exclude: [
+        "src/**/*.test.ts",
+        // Test setup: the sandbox and the argv log run only under vitest.
+        "src/testing/**",
+        // The entry point: one line handing argv to run(), which the suite drives directly.
+        "src/bin/**",
+      ],
       reporter: ["text-summary", "json-summary"],
-      thresholds: { lines: 90, statements: 90, functions: 80, branches: 70 },
+      thresholds: { lines: 90, statements: 90, functions: 80, branches: 70, perFile: { lines: 50 } },
     },
   },
 })

package/kit/README.md

@@ -1,136 +0,0 @@
-# kit — `new` and `upgrade`
-
-The copy tool behind `npx @wirecat/cli-template`. It is the package's `cli-template` bin
-(`kit/dist/main.js`, built from `kit/src` by `tsc -p kit`). It is never copied into a new CLI.
-
-```sh
-npx @wirecat/cli-template new cal-cli --command cal --package @wirecat/cal-cli --owner WireCatLabs \
-  --category notes --content-lang en,ru --sign-in token --api official-docs --filters time,person \
-  --never-store tokens --untrusted messages,links
-npx @wirecat/cli-template upgrade --dry-run
-```
-
-## `new <name>`
-
-`new` copies the files of its own package version into `./<name>`. It renames the placeholders, rewrites
-`package.json`, runs `git init` and writes `template.json`, `docs/dev/DESIGN.md` and the reference CLI into
-`AGENTS.md`. It then prints the four steps that need a person. It does not install packages, commit or push.
-
-In a terminal it asks for every missing answer. Without a terminal, a missing answer is an error that lists the
-choices. Nothing is guessed.
-
-| Flag | Answers (several are comma-separated) |
-|---|---|
-| `<name>` | the folder and repository name |
-| `--command` | the command word |
-| `--package` | the npm package name |
-| `--owner` | the GitHub owner |
-| `--category` | `messenger`, `mail`, `notes`, `files`, `calendar`, `meetings` |
-| `--content-lang` | language codes, several: `en,ru` |
-| `--sign-in` | `oauth`, `token`, `session`, `none` |
-| `--api` | `official-client`, `official-docs`, `unofficial` |
-| `--filters` | several of `time`, `person`, `container`, `text`, `status` |
-| `--never-store` | several of `tokens`, `codes`, `secret-links`, `content` |
-| `--untrusted` | several of `messages`, `files`, `links`, `names`, or `none` alone |
-
-Every question except the names and `--content-lang` also takes `other:<your answer>`.
-
-`new` writes the content languages into `contentLanguages` in `src/identity.ts`; on the first run, cli-core ticks them
-in advance in the search-language question, and the person confirms. `DESIGN.md` records them too, with the
-speech-model order a messenger definition should use and the warnings for languages that have no stemmer or speech
-model in cli-core. `new` writes no search or model setting.
-
-## `upgrade`
-
-Run it in a CLI made from the template, with a clean git working tree. For each template-owned file that the
-template changed since the recorded version, it asks one of four things:
-
-- **apply** merges the change with `git merge-file`. The base is the recorded version, downloaded with `npm pack`.
-  "Ours" is the CLI's file and "theirs" is this version. Both template versions are renamed first, so the command
-  word never conflicts.
-- **replace** takes the template's file as it is.
-- **skip** keeps the CLI's file. It is asked again only when the template changes that file again.
-- **diff** shows the template's change.
-
-Without a terminal, `--apply`, `--replace` or `--skip` sets the answer for every file. `--dry-run` lists what each
-file would get and writes nothing. Seeds and `package.json` are never touched.
-
-A conflict leaves git markers, and `template.json` keeps the new state under `pending`. Resolve the markers and run
-`upgrade` again: it checks that the markers are gone and then moves to the new version.
-
-## `template.json` in this repository
-
-```json
-{
-  "files": [".github/", "bin/release", "AGENTS.md", "docs/meta.json"],
-  "seeds": ["src/", "README.md", "docs/", "config/wirecat/"],
-  "placeholders": {
-    "command": "clidev", "name": "clidev-cli", "package": "@wirecat/clidev-cli", "repository": "WireCatLabs/clidev-cli"
-  }
-}
-```
-
-- `files` lists the template-owned files that `upgrade` replays. `seeds` lists the files copied once and never
-  touched again; `config/wirecat/` goes there, because community's installer owns it. An entry ending in `/` is a
-  folder. The most specific entry wins: an exact path beats a folder, a deeper folder beats a shallower one, and a
-  seed wins a tie. Only listed files are copied. A listed file missing from the package stops `new`.
-- `template.json` and `kit/` are never copied, whatever the lists say. The kit's tests run inside `pnpm test`, so
-  the configs name `kit/`: `new` and `upgrade` drop every `"kit/…"` entry from `vitest.config.ts`, `biome.json`,
-  `cspell.json`, `tsconfig*.json` and `.markdownlint-cli2.jsonc`. Do not add a kit-only workflow: `.github/` is
-  template-owned and would carry it into every new CLI.
-- `README.md` and `CHANGELOG.md` describe the template, so `new` writes short ones for the new CLI.
-- `config/parity-groups.json` puts the template in parity groups with the published CLIs, so `scripts/audit.sh`
-  compares its `commands`, `upgrade`, `config` and `skill` paths with theirs. It is in neither list, so a new CLI does
-  not get it: the file replaces cli-base's `PARITY_GROUPS`, and a new CLI joins those groups instead (step 4 of
-  `new`'s output).
-- `docs/dev/DESIGN.md` is always a seed: it holds the CLI's interview answers.
-- `package.json` is always a seed. `new` rewrites it: `name` becomes `--package`, `version` becomes `0.0.0`, and
-  `repository`, `homepage` and `bugs` point at `<owner>/<name>`. It also drops every `bin`, `files` entry and script
-  that points into `kit/`, and the `&& pnpm kit:…` parts of other scripts. `src/version.ts` gets `VERSION = "0.0.0"`.
-- `placeholders` names the words `new` and `upgrade` replace. The command word is replaced as a whole word, so
-  `clidev` changes but `clidevs` and cli-base's `cli-dev` do not. Its upper-case form changes too: `CLIDEV_HOME`
-  becomes `CAL_HOME`. Followed by a colon and a space it is a key and stays: `clidev: CLIDEV` becomes `clidev: CAL`.
-  `name` (`clidev-cli`) is the repository name: `skills/clidev-cli/` becomes `skills/cal-cli/`. The word `clidev`
-  cannot appear in prose for any other meaning. Paths are renamed the same way: `src/bin/clidev.ts` becomes
-  `src/bin/cal.ts`.
-- Each template version is renamed with its own `placeholders`, so `upgrade` from 0.1.0 or 0.1.1, which used `app`,
-  merges cleanly. A key missing from `placeholders` means its `app` value (`app`, `app-cli`, `@wirecat/app-cli`,
-  `WireCatLabs/app-cli`): those versions left `name` out.
-- The version is `package.json`'s, never a second copy.
-- `AGENTS.md` can hold the block that `new` fills with the reference CLI:
-
-  ```md
-  <!-- cli-template:reference-cli:start -->
-  <!-- cli-template:reference-cli:end -->
-  ```
-
-  Without the block, `new` appends one.
-
-## `template.json` in a CLI made from it
-
-`new` writes this shape and `upgrade` keeps it current:
-
-```json
-{
-  "template": "@wirecat/cli-template",
-  "version": "0.1.0",
-  "names": { "name": "cal-cli", "command": "cal", "package": "@wirecat/cal-cli", "owner": "WireCatLabs" },
-  "files": { ".github/workflows/ci.yml": "<sha256 of the renamed template file at this version>" },
-  "seeds": ["src/", "README.md", "docs/", "config/wirecat/"]
-}
-```
-
-## What the package needs from the repository
-
-- `"bin": { "cli-template": "kit/dist/main.js" }`, and `kit/dist` in `files`. No ignore file inside `kit/`: npm
-  applies it and drops `kit/dist` from the package. npm also never packs `pnpm-lock.yaml`, so it is not a seed; the
-  new CLI makes its own on `pnpm install`.
-- Every template-owned file and seed in `files`. npm drops a nested `.gitignore` and any `.npmrc` when it packs.
-  When it installs a package, it renames `.gitignore` to `.npmignore`. So the package ships the root `.gitignore` as
-  `gitignore`, and `new` and `upgrade` read it back as `.gitignore`. The test in `kit/test/package.test.ts` runs the
-  bin from a tarball installed with `npm install` to catch that.
-- `kit:build` (`tsc -p kit`, then the copy to `gitignore`) run by `build`, because `bin/release` and CI pack with
-  `--ignore-scripts`. Node does not strip types under `node_modules`, so the bin must be JavaScript.
-- `pnpm kit:e2e` packs this repository, installs the tarball with npm, runs `new` and then `pnpm install` and
-  `pnpm ci:quick` in the new CLI. It needs the network and takes a few minutes, so it is not part of `pnpm test`.
-- `kit/test/**/*.test.ts` in vitest's `include`; `kit/dist` is ignored by the root `**/dist` rules of Biome and git.

package/kit/tsconfig.json

@@ -1,17 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2023",
-    "lib": ["ES2023"],
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "types": ["node"],
-    "strict": true,
-    "noUncheckedIndexedAccess": true,
-    "verbatimModuleSyntax": true,
-    "isolatedModules": true,
-    "skipLibCheck": true,
-    "rootDir": "src",
-    "outDir": "dist"
-  },
-  "include": ["src/**/*.ts"]
-}

package/kit/tsconfig.test.json

@@ -1,5 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": { "noEmit": true, "rootDir": "." },
-  "include": ["src/**/*.ts", "test/**/*.ts"]
-}