@wirecat/cli-template 0.1.2 → 0.1.4

package/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

package/.github/workflows/changelog-guard.yml

@@ -9,4 +9,4 @@ permissions:
 
 jobs:
   changelog:
-    uses: WireCatLabs/cli-base/.github/workflows/changelog-guard.yml@70449547973dd113806a6829f4591dce713b5b78 # v0.51.1
+    uses: WireCatLabs/cli-base/.github/workflows/changelog-guard.yml@b2d2418af0e23ecc816f3117ae2b0c627917fca5 # v0.55.0

package/.github/workflows/ci.yml

@@ -19,7 +19,7 @@ permissions:
 
 jobs:
   ci:
-    uses: WireCatLabs/cli-base/.github/workflows/node-ci.yml@70449547973dd113806a6829f4591dce713b5b78 # v0.51.1
+    uses: WireCatLabs/cli-base/.github/workflows/node-ci.yml@b2d2418af0e23ecc816f3117ae2b0c627917fca5 # v0.55.0
     with:
       pack: ${{ inputs.pack || false }}
       bun-run: pnpm build && pnpm smoke:bun

package/.github/workflows/monthly.yml

@@ -22,7 +22,7 @@ jobs:
       contents: read
       actions: read
       security-events: write
-    uses: WireCatLabs/cli-base/.github/workflows/release-checks.yml@70449547973dd113806a6829f4591dce713b5b78 # v0.51.1
+    uses: WireCatLabs/cli-base/.github/workflows/release-checks.yml@b2d2418af0e23ecc816f3117ae2b0c627917fca5 # v0.55.0
     with:
       dependencies: true
       languages: '["actions","javascript-typescript"]'

package/.github/workflows/release.yml

@@ -56,7 +56,7 @@ jobs:
       contents: read
       actions: read
       security-events: write
-    uses: WireCatLabs/cli-base/.github/workflows/release-checks.yml@70449547973dd113806a6829f4591dce713b5b78 # v0.51.1
+    uses: WireCatLabs/cli-base/.github/workflows/release-checks.yml@b2d2418af0e23ecc816f3117ae2b0c627917fca5 # v0.55.0
 
   build:
     needs: [checks, validation]

package/CHANGELOG.md

@@ -3,6 +3,56 @@
 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.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
+
+- **`new` writes the content languages into the CLI's identity.** The `--content-lang` codes go into
+  `contentLanguages` in `src/identity.ts`, so the CLI's first run ticks them in advance in the search-language question.
+  `docs/dev/DESIGN.md` still records them with the speech-model order.
+- **`scripts/audit.sh` reads `config/parity-groups.json` when the repository has one.** That file replaces
+  cli-base's parity groups for the audit. The template uses it to compare itself with the published CLIs.
+- **The release skill ends with a fresh-agent audit.** Before the version is raised, a new subagent audits the
+  repository against the handbook alone, with the prompt in `docs/dev/skills/release/fresh-audit.md`, and its report
+  goes into the release pull request.
+
+### Changed — may break callers
+
+- **The skeleton runs on cli-core 0.421.0 and cli-base 0.53.0.** A new CLI gets cli-core's changes since 0.412.0,
+  including the `contentLanguages` field on its identity. cli-base stays on 0.53, because cli-core 0.421.0 accepts
+  only cli-base 0.53.
+
+### Fixed
+
+- **`new`'s next steps run in Windows PowerShell 5.1.** It printed `cd <name> && pnpm install && pnpm ci:quick`, and
+  PowerShell 5.1 has no `&&`. Each step is now on its own line.
+- **A CLI's files keep LF line endings on Windows.** A new template-owned `.gitattributes` (`* text=auto eol=lf`)
+  stops git from checking files out with CRLF, which Biome's format check rejects.
+
+### Security
+
+- **markdownlint-cli2's markdown-it, katex and smol-toml move past their advisories.** `pnpm-workspace.yaml` raises
+  them to markdown-it 15.0.3, katex 0.18.2 and smol-toml 1.9.1 while markdownlint-cli2 stays at the shared version.
+
 ## 0.1.2 — 25.10.2026
 
 ### Changed — may break callers

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

package/config/parity-groups.json

@@ -0,0 +1,20 @@
+[
+  {
+    "name": "template",
+    "members": ["clidev", "tg", "max", "memo", "drive", "zm", "wa"],
+    "covers": ["commands", "upgrade"],
+    "differences": []
+  },
+  {
+    "name": "template-config",
+    "members": ["clidev", "tg", "max", "wa"],
+    "covers": ["config"],
+    "differences": []
+  },
+  {
+    "name": "template-skill",
+    "members": ["clidev", "tg", "max", "memo", "zm", "wa"],
+    "covers": ["skill"],
+    "differences": []
+  }
+]

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/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/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.2";
+export declare const VERSION = "0.1.4";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "0.1.2";
+export const VERSION = "0.1.4";
 //# 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,8 +166,8 @@ 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>. |
-| `value` | required | a number, true or false, or for allow a list like send,reaction; for a group tg:work,max:Alice,email:me@x. |
+| `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, 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>. |
+| `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, 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>. |
 
 | 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, profile, started_at, status, cli_version, 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, profile, started_at, status, cli_version, directory, event_count, 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,9 @@ 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 |
 
+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.
+
 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.

package/docs/dev/skills/release/SKILL.md

@@ -17,8 +17,11 @@ and runs `bin/release`.
    `Changed — may break callers`, `Fixed`, `Security`, `Removed` (`WC-DOC-14` to `WC-DOC-18`). No internal ids.
 4. **The docs.** `README.md`, `docs/*.md` and `skills/clidev-cli/SKILL.md` state what the code does now (`WC-DOC-3`).
    `pnpm generate` and `pnpm test:matrix` rewrite the generated pages (`WC-DOC-4`).
-5. **The version.** `npm view @wirecat/clidev-cli version` is what is published. Set the next version in
+5. **The fresh audit.** Start a new subagent that has none of your context, and give it the prompt in
+   [fresh-audit.md](fresh-audit.md) as written. Put its report in the release pull request. Fix each gap in this
+   repository there, or list it as a follow-up; take a gap in the handbook to cli-base.
+6. **The version.** `npm view @wirecat/clidev-cli version` is what is published. Set the next version in
    `package.json`, run `pnpm version:sync`, date the section as `## <version> — DD.MM.YYYY`, run
    `pnpm release:check` again, and open the pull request `chore(release): <version>`.
-6. **The owner** merges it and runs `bin/release` on a clean `main`. `bin/release --local` publishes from this
+7. **The owner** merges it and runs `bin/release` on a clean `main`. `bin/release --local` publishes from this
    computer when GitHub Actions cannot, with the owner's own npm login or `NPM_TOKEN`.

package/docs/dev/skills/release/fresh-audit.md

@@ -0,0 +1,17 @@
+# Fresh-agent audit
+
+Step 5 of the [release skill](SKILL.md) gives the prompt below to a new subagent that has none of the releasing
+agent's context. Give it as written.
+
+## Prompt
+
+You audit a WireCat CLI repository, in the current folder. Use only two sources: the handbook, starting at
+`node_modules/@wirecat/cli-base/docs/standards/README.md`, and the repository itself. Do not read plans, journals
+or earlier reviews. Run `pnpm install` first if `node_modules` is missing.
+
+Check the repository against every handbook page that applies to it: the code, the docs, the configs and the
+workflows. You may run the package scripts. Change nothing.
+
+Report each gap on one line: the rule id or handbook page, the file, what is wrong, and where the fix belongs: in
+this repository, or in the handbook, when a rule is unclear, missing or contradicts another. End with the number
+of gaps of each kind. If you find none, say so.

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/kit/README.md

@@ -35,9 +35,10 @@ choices. Nothing is guessed.
 
 Every question except the names and `--content-lang` also takes `other:<your answer>`.
 
-The content languages go only into `DESIGN.md`. The file also holds 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.
+`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`
 
@@ -78,6 +79,10 @@ A conflict leaves git markers, and `template.json` keeps the new state under `pe
   `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

package/kit/dist/new.js

@@ -158,6 +158,17 @@ export const cliPackageJson = (text, names) => {
     return `${JSON.stringify(next, null, 2)}\n`;
 };
 const VERSION_FILE = "src/version.ts";
+const IDENTITY_FILE = "src/identity.ts";
+export const withContentLanguages = (text, languages) => {
+    const match = /export const IDENTITY: AppIdentity = \{\n[\s\S]*?\n\}/.exec(text);
+    if (!match)
+        throw new Error(`${IDENTITY_FILE}: no IDENTITY object to add contentLanguages to`);
+    const end = match.index + match[0].length - 1;
+    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}`,
     "",
@@ -218,6 +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) => withMessenger(withContentLanguages(text, answers.contentLang ?? []), category),
         "AGENTS.md": (text) => withReference(text, category),
     };
     const hashes = {};
@@ -247,8 +259,11 @@ export const runNew = async (cwd, source, args, io) => {
         ...(warnings.length ? ["", "Content languages:", ...warnings.map((warning) => `  ${warning}`)] : []),
         "",
         "Next:",
-        `  cd ${names.name} && pnpm install && pnpm ci:quick`,
-        '  git add -A && git commit -m "chore: start from @wirecat/cli-template"',
+        `  cd ${names.name}`,
+        "  pnpm install",
+        "  pnpm ci:quick",
+        "  git add -A",
+        '  git commit -m "chore: start from @wirecat/cli-template"',
         `  then give the agent docs/dev/DESIGN.md; every example passes a profile, e.g. ${names.command} personal doctor`,
         "",
         "Four steps need a person:",

package/kit/dist/source.js

@@ -79,10 +79,10 @@ export const npmCommand = (args) => {
     ].find((path) => existsSync(path));
     return cli ? [process.execPath, [cli, ...args]] : ["npm", args];
 };
-export const fetchPublished = async (name, version) => {
+export const fetchPacked = async (spec) => {
     const dir = await mkdtemp(join(tmpdir(), "cli-template-"));
-    const { stdout } = await run(...npmCommand(["pack", `${name}@${version}`, "--silent", "--pack-destination", dir])).catch((error) => {
-        throw new Error(`could not download ${name}@${version} from npm, which upgrade needs as the merge base: ${error.message}`);
+    const { stdout } = await run(...npmCommand(["pack", spec, "--silent", "--pack-destination", dir])).catch((error) => {
+        throw new Error(`could not download ${spec} from npm, which upgrade needs as the merge base: ${error.message}`);
     });
     const tarball = stdout.trim().split("\n").pop() ?? "";
     const dispose = () => rm(dir, { recursive: true, force: true });
@@ -96,3 +96,4 @@ export const fetchPublished = async (name, version) => {
         throw error;
     }
 };
+export const fetchPublished = (name, version) => fetchPacked(`${name}@${version}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-template",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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",
@@ -34,6 +34,7 @@
     "LICENSE",
     "README.md",
     "SECURITY.md",
+    ".gitattributes",
     ".gitleaks.toml",
     ".markdownlint-cli2.jsonc",
     ".vale.ini",
@@ -82,8 +83,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/server": "2.3.0",
-    "@wirecat/cli-base": "0.51.1",
-    "@wirecat/cli-core": "0.412.0",
+    "@wirecat/cli-base": "0.53.0",
+    "@wirecat/cli-core": "0.422.0",
     "commander": "15.0.0"
   },
   "devDependencies": {
@@ -91,7 +92,7 @@
     "@cspell/dict-en-gb": "5.0.34",
     "@cspell/dict-es-es": "3.0.9",
     "@cspell/dict-ru_ru": "2.3.3",
-    "@modelcontextprotocol/client": "2.3.1",
+    "@modelcontextprotocol/client": "2.4.0",
     "@types/node": "22.20.5",
     "@vitest/coverage-v8": "5.0.5",
     "@wirecat/cli-testing": "0.5.3",

package/pnpm-workspace.yaml

@@ -4,3 +4,8 @@ allowBuilds:
   lefthook: true
 minimumReleaseAgeExclude:
   - '@wirecat/*'
+# markdownlint-cli2 is pinned to community's version, whose markdown-it, katex and smol-toml have advisories.
+overrides:
+  markdown-it: ^15.0.3
+  katex: ^0.18.2
+  smol-toml: ^1.9.1

package/scripts/audit.sh

@@ -14,6 +14,8 @@ npm install -g --prefix "$scratch/prefix" --ignore-scripts --no-audit --no-fund
   @wirecat/tg-cli @wirecat/max-cli @wirecat/whatsapp-cli @wirecat/cli-memo @wirecat/drive-cli @wirecat/zoom-cli
 bin="$scratch/prefix/bin"
 others=()
+# A groups file replaces cli-base's PARITY_GROUPS. The template keeps one because it is in no group of cli-base's.
+[ -f "$root/config/parity-groups.json" ] && others+=(--groups "$root/config/parity-groups.json")
 for cli in tg max wa memo drive zm; do
   [ "$cli" = "$command" ] || others+=(--cli "$bin/$cli")
 done

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/program.test.ts

@@ -19,7 +19,7 @@ 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 () => {
@@ -64,3 +64,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 (WC-LIFE-15)", 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.2"
+export const VERSION = "0.1.4"

package/template.json

@@ -1,6 +1,7 @@
 {
   "files": [
     ".github/",
+    ".gitattributes",
     ".gitignore",
     ".gitleaks.toml",
     ".vale.ini",