@wirecat/cli-template 0.1.5 → 0.1.6

package/.github/workflows/ci.yml

@@ -29,7 +29,8 @@ jobs:
       platform-run: |
         node dist/bin/clidev.js commands --json >/dev/null
         node dist/bin/clidev.js doctor --json >/dev/null
-      # No version is on npm before the first release, so there is no earlier package to upgrade from.
+      # The skeleton has no store of its own; its config file and run records are cli-core's. A CLI that adds a store
+      # adds a contracts:upgrade script and removes this skip (WC-TEST-14).
       skip: |
         contracts:upgrade
       checks: |

package/.github/workflows/main.yml

@@ -5,9 +5,10 @@ on:
   push:
     branches: [main]
 
+# Each merge keeps its own validation: cancelling it would leave that commit unchecked (WC-CI-7).
 concurrency:
   group: main-validation-${{ github.ref }}
-  cancel-in-progress: true
+  cancel-in-progress: false
 
 permissions:
   contents: read

package/AGENTS.md

@@ -16,6 +16,8 @@ This CLI was made from [cli-template](https://github.com/WireCatLabs/cli-templat
    template has no sample code on purpose.
 3. Ask the further questions in the interview that the reference CLI does not answer. Build only after the owner
    has read `DESIGN.md`.
+4. When the first command reaches the service, rewrite `README.md`, `docs/index.md` and the description in
+   `skills/clidev-cli/SKILL.md` to say what the tool does and who it is for.
 
 <!-- cli-template:reference-cli:start -->
 The reference CLI is not chosen yet; see [Reference CLIs](docs/dev/reference-clis.md).

package/CHANGELOG.md

@@ -3,6 +3,29 @@
 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.6 — 25.10.2026
+
+### Changed — may break callers
+
+- **The skeleton runs on cli-core 0.426.0.** A `--dry-run` preview says `effects.service_contacted: false` and no
+  longer has `effects.messenger_contacted`. MCP no longer offers a command group that only prints its help, such as
+  `config`; `config show`, `set` and `unset` stay. The example in the MCP read and write tools is `runs list`, a
+  command that runs as written. The first screen says zm and drive are searchable with your other WireCat data.
+- **`doctor` takes no profile.** Its usage line and examples are `clidev doctor` and `clidev doctor --json`; a profile
+  typed before it still works. A CLI started from an older template copies `src/commands/doctor.ts` and
+  `src/mcp.ts`.
+
+### Added
+
+- **`bin/release --local` reads the npm token from the keyring** (`secret-tool`, service `npm`, account `leemour`), as
+  the other WireCat CLIs do, when `NPM_TOKEN` is not exported. Without either it uses your `npm login`. The token is
+  never printed. A CLI made from the template gets this with `upgrade`.
+
+### Fixed
+
+- **A merge to `main` no longer cancels the validation of the merge before it.** Each merged commit is now checked in
+  turn. A CLI made from the template gets this with `upgrade`.
+
 ## 0.1.5 — 25.10.2026
 
 ### Changed — may break callers

package/README.md

@@ -19,17 +19,17 @@ npx @wirecat/cli-template new cal-cli --command cal --package @wirecat/cal-cli -
 ```sh
 pnpm install
 pnpm build
-node dist/bin/clidev.js personal doctor
+node dist/bin/clidev.js doctor
 ```
 
-`personal` is the profile: a name you choose for one account. Every command that uses an account starts with it, and
-none is ever assumed. `CLIDEV_PROFILE=personal` does the same for a whole shell session.
+`doctor` needs no profile. Every command that uses an account starts with one, a name you choose for that account,
+such as `personal` in `clidev personal config show`; none is ever assumed. `CLIDEV_PROFILE=personal` does the same for a whole shell session.
 
 ## What you can do
 
 | Command | What it does |
 | --- | --- |
-| `clidev personal doctor` | Checks this installation: version, paths, settings and profiles, without the network |
+| `clidev doctor` | Checks this installation: version, paths, settings and profiles, without the network |
 | `clidev commands --json` | Prints every command as JSON, for agents and scripts |
 | `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 |
@@ -65,7 +65,7 @@ The skeleton connects to no service, keeps no messages and has no commands of it
 
 ## When it does not work
 
-Run `clidev personal doctor` first: it checks the installation without the network.
+Run `clidev doctor` first: it checks the installation without the network.
 [When something goes wrong](docs/troubleshooting.md) lists the usual symptoms.
 
 ## Documentation
@@ -80,5 +80,6 @@ Run `clidev personal doctor` first: it checks the installation without the netwo
 ## Development
 
 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
+before a release; its command audit installs the published WireCat CLIs from npm to compare with them.
+`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

@@ -4,7 +4,7 @@
 # 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`
+#   bin/release --local   # publishes from this computer: NPM_TOKEN if exported, else the keyring, else `npm login`
 #
 # A package that is not on npm yet is published the same way; its first version needs --local until npm trusts
 # release.yml. The npm token is never printed and never written to a file (WC-REL-14).
@@ -147,8 +147,13 @@ if [ "$mode" = ci ]; then
   exit 0
 fi
 
+# The same keyring entry as the other WireCat CLIs. Without NPM_TOKEN or the entry, npm reads your own login from
+# ~/.npmrc as usual.
+if [ -z "$publish_token" ] && command -v secret-tool >/dev/null 2>&1; then
+  publish_token=$(secret-tool lookup service npm account leemour 2>/dev/null) || publish_token=""
+fi
+
 # Our own npm config names the variable, not the value, so the token stays in the publish process's environment.
-# Without NPM_TOKEN, npm reads your own login from ~/.npmrc as usual.
 config=$(mktemp)
 trap 'rm -f "$config"' EXIT
 if [ -n "$publish_token" ]; then
@@ -156,7 +161,11 @@ if [ -n "$publish_token" ]; then
   printf '//registry.npmjs.org/:_authToken=${NPM_TOKEN}\n' > "$config"
   set -- --userconfig "$config"
 else
-  npm whoami >/dev/null 2>&1 || { echo "not logged in to npm: run npm login, or export NPM_TOKEN" >&2; exit 1; }
+  npm whoami >/dev/null 2>&1 || {
+    echo "no npm token: export NPM_TOKEN, store one with: secret-tool store --label=npm service npm account leemour," >&2
+    echo "or run npm login" >&2
+    exit 1
+  }
   set --
 fi
 

package/config/parity-groups.json

@@ -16,5 +16,11 @@
     "members": ["clidev", "tg", "max", "memo", "zm", "wa"],
     "covers": ["skill"],
     "differences": []
+  },
+  {
+    "name": "template-runs",
+    "members": ["clidev", "tg", "max", "wa", "memo", "drive", "zm"],
+    "covers": ["runs"],
+    "differences": []
   }
 ]

package/contracts/help.snap

@@ -7,8 +7,8 @@ Works with:
   tg                      Telegram in the same local store: search, review and tasks offline
   max                     MAX in the same local store: search, review and tasks offline
   wa                      WhatsApp in the same local store: search, review and tasks offline
-  zm                      Zoom meetings: transcripts and summaries, searchable with your messages
-  drive                   Google Drive and Docs as local text, searchable with your messages
+  zm                      Zoom meetings: transcripts and summaries, searchable with your other WireCat data
+  drive                   Google Drive and Docs as local text, searchable with your other WireCat data
   memo context <person>   one person across messengers, mail, notes and meetings
 
 Next:         clidev commands      every command, by section

package/contracts/mcp-tools.json

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

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,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"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAYA,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,OAW3B,CAAA"}

package/dist/commands/doctor.js

@@ -1,7 +1,7 @@
 import { existsSync } from "node:fs";
 import { CliError, configFilePath, resolvePaths } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
-import { environmentOf, itemOf, LOCAL_READ, outputFor, readOnlyLockOf, renderAnswer } from "@wirecat/cli-core/cli";
+import { environmentOf, itemOf, LOCAL_READ, outputFor, profileFree, readOnlyLockOf, renderAnswer, } from "@wirecat/cli-core/cli";
 import { Command } from "commander";
 import { configuration } from "../config.js";
 import { IDENTITY } from "../identity.js";
@@ -39,10 +39,10 @@ export const doctorReport = (env) => {
         };
     }
 };
-export const doctorCommand = () => annotate(new Command("doctor"), {
+export const doctorCommand = () => profileFree(annotate(new Command("doctor"), {
     effects: LOCAL_READ,
-    examples: [`${IDENTITY.command} doctor`, `${IDENTITY.command} personal doctor --json`],
-})
+    examples: [`${IDENTITY.command} doctor`, `${IDENTITY.command} doctor --json`],
+}))
     .description("check this installation: version, paths, config, profiles; no keyring or network")
     .action(function () {
     const env = environmentOf(this).env ?? process.env;

package/dist/commands/doctor.js.map

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

package/dist/mcp.js

@@ -38,7 +38,7 @@ export const createMcpServer = (options) => {
             },
         },
     ]));
-    registerCommands(server, IDENTITY.command, commands);
+    registerCommands(server, IDENTITY.command, commands, undefined, undefined, IDENTITY.messenger);
     return server;
 };
 /** Serves until the client closes the connection or the command is stopped. */

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/version.d.ts

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

package/dist/version.js

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

package/docs/commands.md

@@ -5,7 +5,7 @@
 Every command, option and exit code, generated from the program itself. For the same list as JSON, run
 `clidev commands --json`.
 
-**The first word is the profile**, a name you choose: `clidev personal doctor`. `CLIDEV_PROFILE`
+**The first word is the profile**, a name you choose: `clidev personal config show`. `CLIDEV_PROFILE`
 does the same for a whole shell session. No profile is assumed: a command that uses an account stops without one and
 lists the profiles on this computer.
 
@@ -62,7 +62,7 @@ clidev doctor
 
 **Returns:** check this installation: version, paths, config, profiles; no keyring or network
 
-**Example:** `clidev personal doctor`, `clidev personal doctor --json`
+**Example:** `clidev doctor`, `clidev doctor --json`
 
 ## `clidev skill`
 
@@ -224,7 +224,7 @@ clidev runs list [query] [options]
 | `--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
+**Returns:** run — run_id, command, started_at, status, cli_version, profile, completed_at, requests, and 20 more; every field: clidev commands info runs list
 
 **Example:** `clidev personal runs list --limit 10`
 
@@ -244,7 +244,7 @@ clidev runs show <run-id> [options]
 |---|---|
 | `--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
+**Returns:** run details — run_id, command, started_at, status, cli_version, directory, event_count, events, and 19 more; every field: clidev commands info runs show
 
 **Example:** `clidev personal runs show run-101`
 

package/docs/configuration.md

@@ -1,6 +1,6 @@
 # Settings
 
-Settings live in one file, `config.json`, in the folder `clidev personal doctor` shows. Each profile has its own part,
+Settings live in one file, `config.json`, in the folder `clidev doctor` shows. Each profile has its own part,
 and `defaults` apply to every profile. This page lists how to see and change them.
 
 ```sh

package/docs/dev/TESTING.md

@@ -12,5 +12,7 @@ How the tests run, and what they never touch. The rules are the handbook's
   `scripts/test-matrix-untested.ts`.
 - `pnpm contracts:check` runs the built CLI against `contracts/plan.json`: help, discovery, errors and the MCP tool
   list. `cli-contract contracts/plan.json --update` rewrites the snapshots; review the diff.
+- `pnpm contracts:upgrade` does not exist yet: the skeleton has no store of its own, and `.github/workflows/ci.yml`
+  skips the step. Add it with the first store, and remove the skip.
 - `pnpm smoke` installs the packed package into a temporary folder and runs it offline.
 - `pnpm audit:commands` audits the command tree beside the latest published WireCat CLIs.

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

@@ -24,4 +24,4 @@ and runs `bin/release`.
    `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>`.
 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`.
+   computer when GitHub Actions cannot, with `NPM_TOKEN`, the npm token in the keyring, or the owner's own npm login.

package/docs/index.md

@@ -1,7 +1,7 @@
 # clidev
 
-`clidev` brings a service to the terminal, to scripts and to AI agents. This page is where a reader starts: say what
-the tool does, who it is for, and the first command to run. It will say that once the tool connects to its service.
+`clidev` is a WireCat command-line tool for the terminal, for scripts and for AI agents. It does not connect to a
+service yet.
 
-Today it has the commands every WireCat CLI shares: `doctor`, `commands`, `config`, `skill`, `mcp` and `upgrade`.
+It has the commands every WireCat CLI shares: `doctor`, `commands`, `config`, `skill`, `mcp`, `runs` and `upgrade`.
 Start with [installation](installation.md), then [usage](usage.md).

package/docs/installation.md

@@ -10,7 +10,7 @@ clidev --version
 Check the installation, then pick a profile name for your account, such as `personal`:
 
 ```sh
-clidev personal doctor
+clidev doctor
 ```
 
 `doctor` needs no network and opens no keyring. It shows the version, where settings live and the profiles that

package/docs/security.md

@@ -3,6 +3,6 @@
 What WireCat CLIs share — the keyring, permissions, MCP and what never reaches a log — is on the
 [shared security page](https://wirecat.dev/en/docs/security). This page keeps only what is particular to `clidev`.
 
-`clidev` keeps its settings in `config.json` and its state in the folders `clidev personal doctor` shows. It sends nothing
+`clidev` keeps its settings in `config.json` and its state in the folders `clidev doctor` shows. It sends nothing
 to any service yet. Report a vulnerability as [SECURITY.md](https://github.com/WireCatLabs/clidev-cli/blob/main/SECURITY.md)
 says.

package/docs/troubleshooting.md

@@ -5,7 +5,7 @@ support request.
 
 | Symptom | What to do |
 | --- | --- |
-| Not sure what is set up | Run `clidev personal doctor`. It reads no keyring and uses no network. |
+| Not sure what is set up | Run `clidev 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` lists every problem in the file under `config.issues`. Run the `config unset` each one gives, or fix the file by hand. |

package/docs/usage.md

@@ -15,7 +15,7 @@ command without one stops with exit code 2 and lists the profiles on this comput
 
 ## Output for scripts
 
-Every command takes `--json`, and prints one JSON value on stdout. Errors are JSON on stderr, with a code to branch
+Every command except `mcp` takes `--json`, and prints one JSON value on stdout. Errors are JSON on stderr, with a code to branch
 on. The [command reference](commands.md) lists the codes.
 
 ## Agents

package/kit/dist/main.js

@@ -65,6 +65,6 @@ const io = {
 main(process.argv.slice(2), io).then((text) => {
     process.stdout.write(text.endsWith("\n") ? text : `${text}\n`);
 }, (error) => {
-    process.stderr.write(`cli-template: ${error.message}\n`);
+    process.stderr.write(`cli-template: ${error instanceof Error ? error.message : String(error)}\n`);
     process.exitCode = 1;
 });

package/kit/dist/manifest.js

@@ -19,7 +19,11 @@ const fail = (file, problem) => {
     throw new Error(`${file}: ${problem}`);
 };
 const isStringList = (value) => Array.isArray(value) && value.every((item) => typeof item === "string" && item.length > 0);
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+export const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isPlaceholder = (key) => key in DEFAULT_PLACEHOLDERS;
+const isNames = (value) => isRecord(value) && ["name", "command", "package", "owner"].every((key) => typeof value[key] === "string");
+const isHashes = (value) => isRecord(value) && Object.values(value).every((hash) => typeof hash === "string");
+const isPending = (value) => isRecord(value) && typeof value.version === "string" && isHashes(value.files) && isStringList(value.conflicts);
 const checkEntries = (file, key, entries) => {
     for (const entry of entries) {
         if (entry.startsWith("/") || entry.split("/").includes(".."))
@@ -35,20 +39,18 @@ export const parseTemplateManifest = (file, raw) => {
         return fail(file, `"seeds" must be a list of paths`);
     checkEntries(file, "files", raw.files);
     checkEntries(file, "seeds", raw.seeds);
-    const placeholders = raw.placeholders ?? {};
-    if (!isRecord(placeholders))
+    const given = raw.placeholders ?? {};
+    if (!isRecord(given))
         return fail(file, `"placeholders" must be an object`);
-    for (const [key, value] of Object.entries(placeholders)) {
-        if (!(key in DEFAULT_PLACEHOLDERS))
-            fail(file, `unknown placeholder "${key}"`);
+    const placeholders = { ...DEFAULT_PLACEHOLDERS };
+    for (const [key, value] of Object.entries(given)) {
+        if (!isPlaceholder(key))
+            return fail(file, `unknown placeholder "${key}"`);
         if (typeof value !== "string" || value.length === 0)
-            fail(file, `placeholder "${key}" must be a string`);
+            return fail(file, `placeholder "${key}" must be a string`);
+        placeholders[key] = value;
     }
-    return {
-        files: raw.files,
-        seeds: raw.seeds,
-        placeholders: { ...DEFAULT_PLACEHOLDERS, ...placeholders },
-    };
+    return { files: raw.files, seeds: raw.seeds, placeholders };
 };
 export const parseCliManifest = (file, raw) => {
     if (!isRecord(raw))
@@ -58,29 +60,15 @@ export const parseCliManifest = (file, raw) => {
         return fail(file, `"template" must be the template's package name`);
     if (typeof version !== "string")
         return fail(file, `"version" must be the template version this CLI is on`);
-    if (!isRecord(names) || !["name", "command", "package", "owner"].every((key) => typeof names[key] === "string")) {
+    if (!isNames(names))
         return fail(file, `"names" must hold name, command, package and owner`);
-    }
-    if (!isRecord(files) || !Object.values(files).every((hash) => typeof hash === "string")) {
+    if (!isHashes(files))
         return fail(file, `"files" must map each template-owned path to its sha256`);
-    }
     if (!isStringList(seeds))
         return fail(file, `"seeds" must be a list of paths`);
-    if (pending !== undefined &&
-        (!isRecord(pending) ||
-            typeof pending.version !== "string" ||
-            !isRecord(pending.files) ||
-            !isStringList(pending.conflicts))) {
+    if (pending !== undefined && !isPending(pending))
         return fail(file, `"pending" must hold version, files and conflicts`);
-    }
-    return {
-        template,
-        version,
-        names: names,
-        files: files,
-        seeds,
-        ...(pending ? { pending: pending } : {}),
-    };
+    return { template, version, names, files, seeds, ...(pending ? { pending } : {}) };
 };
 export const readJson = async (path) => {
     const text = await readFile(path, "utf8").catch(() => fail(path, "not found"));

package/kit/dist/new.js

@@ -4,7 +4,7 @@ import { dirname, join } from "node:path";
 import { createInterface } from "node:readline/promises";
 import { promisify } from "node:util";
 import { ask, choiceList, INTERVIEW, labelOf, NAME_QUESTIONS, parseAnswer } from "./interview.js";
-import { MANIFEST, sha256 } from "./manifest.js";
+import { isRecord, MANIFEST, sha256 } from "./manifest.js";
 import { PACKED_AS, renderTemplate } from "./source.js";
 const run = promisify(execFile);
 const REFERENCES = {
@@ -133,6 +133,8 @@ const removeKit = (command) => command
     .join(" && ");
 export const cliPackageJson = (text, names) => {
     const pkg = JSON.parse(text);
+    if (!isRecord(pkg))
+        throw new Error("package.json must be a JSON object");
     const isKit = (value) => typeof value === "string" && /^(\.\/)?kit(\/|$)/.test(value);
     const repoUrl = `git+https://github.com/${names.owner}/${names.name}.git`;
     const next = { ...pkg, name: names.package, version: "0.0.0" };
@@ -143,9 +145,9 @@ export const cliPackageJson = (text, names) => {
     };
     if (Array.isArray(pkg.files))
         next.files = pkg.files.filter((entry) => !isKit(entry) && !Object.values(PACKED_AS).includes(entry));
-    if (typeof pkg.scripts === "object" && pkg.scripts) {
+    if (isRecord(pkg.scripts)) {
         next.scripts = Object.fromEntries(Object.entries(pkg.scripts)
-            .filter(([key]) => !key.startsWith("kit:"))
+            .filter((entry) => typeof entry[1] === "string" && !entry[0].startsWith("kit:"))
             .map(([key, value]) => [key, removeKit(value)])
             .filter(([, value]) => value.length > 0));
     }
@@ -181,10 +183,10 @@ export const cliReadme = (names) => [
     "```sh",
     "pnpm install",
     "pnpm build",
-    `node dist/bin/${names.command}.js personal doctor`,
+    `node dist/bin/${names.command}.js doctor`,
     "```",
     "",
-    "`personal` is the profile: a name you choose for one account. Every command that uses an account starts with it.",
+    `\`doctor\` needs no profile. Every command that uses an account starts with one, a name you choose: \`${names.command} personal config show\`.`,
     "",
 ].join("\n");
 export const cliChangelog = (names, source) => [
@@ -264,7 +266,7 @@ export const runNew = async (cwd, source, args, io) => {
         "  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`,
+        `  then give the agent docs/dev/DESIGN.md; every account command passes a profile, e.g. ${names.command} personal config show`,
         "",
         "Four steps need a person:",
         ...manualSteps(names).map((step) => `  ${step}`),

package/kit/dist/rename.js

@@ -29,6 +29,7 @@ export const stripKit = (path, content) => {
         return content;
     const text = content.toString("utf8");
     const stripped = text
+        .replace(/^[ \t]*\/\/[^\n]*\n(?=[ \t]*"!?(\.\/)?kit\/)/gm, "")
         .replace(/\[\s*"!?(\.\/)?kit\/[^"]*"\s*\]/g, "[]")
         .replace(/,\s*"!?(\.\/)?kit\/[^"]*"/g, "")
         .replace(/"!?(\.\/)?kit\/[^"]*",\s*/g, "");

package/kit/dist/source.js

@@ -5,13 +5,13 @@ import { tmpdir } from "node:os";
 import { dirname, join, relative, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
-import { classify, MANIFEST, parseTemplateManifest, readJson, } from "./manifest.js";
+import { classify, isRecord, MANIFEST, parseTemplateManifest, readJson, } from "./manifest.js";
 import { renameContent, renamer, stripKit } from "./rename.js";
 const run = promisify(execFile);
 export const ownRoot = () => fileURLToPath(new URL("../../", import.meta.url));
 export const loadSource = async (root) => {
-    const pkg = (await readJson(join(root, "package.json")));
-    if (typeof pkg.name !== "string" || typeof pkg.version !== "string") {
+    const pkg = await readJson(join(root, "package.json"));
+    if (!isRecord(pkg) || typeof pkg.name !== "string" || typeof pkg.version !== "string") {
         throw new Error(`${join(root, "package.json")}: needs a name and a version`);
     }
     const manifestPath = join(root, MANIFEST);
@@ -82,7 +82,10 @@ export const npmCommand = (args) => {
 export const fetchPacked = async (spec) => {
     const dir = await mkdtemp(join(tmpdir(), "cli-template-"));
     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 why = error instanceof Error ? error.message : String(error);
+        throw new Error(`could not download ${spec} from npm, which upgrade needs as the merge base: ${why}`, {
+            cause: error,
+        });
     });
     const tarball = stdout.trim().split("\n").pop() ?? "";
     const dispose = () => rm(dir, { recursive: true, force: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-template",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "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",
@@ -84,7 +84,7 @@
   "dependencies": {
     "@modelcontextprotocol/server": "2.3.0",
     "@wirecat/cli-base": "0.53.0",
-    "@wirecat/cli-core": "0.424.0",
+    "@wirecat/cli-core": "0.426.0",
     "commander": "15.0.0"
   },
   "devDependencies": {

package/scripts/commands.ts

@@ -19,7 +19,7 @@ const page = commandsPage({
     intro: `Every command, option and exit code, generated from the program itself. For the same list as JSON, run
 \`${IDENTITY.command} commands --json\`.
 
-**The first word is the profile**, a name you choose: \`${IDENTITY.command} personal doctor\`. \`${IDENTITY.envPrefix}_PROFILE\`
+**The first word is the profile**, a name you choose: \`${IDENTITY.command} personal config show\`. \`${IDENTITY.envPrefix}_PROFILE\`
 does the same for a whole shell session. No profile is assumed: a command that uses an account stops without one and
 lists the profiles on this computer.`,
     globalHeading: "Options for every command",

package/scripts/smoke.ts

@@ -5,12 +5,20 @@ import { tmpdir } from "node:os"
 import { join, resolve } from "node:path"
 import { packContents } from "@wirecat/cli-base/release"
 
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === "object" && value !== null && !Array.isArray(value)
+
+const isPackage = (value: unknown): value is { name: string; version: string; files: string[] } =>
+  isRecord(value) &&
+  typeof value.name === "string" &&
+  typeof value.version === "string" &&
+  Array.isArray(value.files) &&
+  value.files.every((entry) => typeof entry === "string")
+
 const root = resolve(import.meta.dirname, "..")
-const { name, version, files } = JSON.parse(readFileSync(join(root, "package.json"), "utf8")) as {
-  name: string
-  version: string
-  files: string[]
-}
+const pkg: unknown = JSON.parse(readFileSync(join(root, "package.json"), "utf8"))
+assert.ok(isPackage(pkg), "package.json needs a name, a version and a files list")
+const { name, version, files } = pkg
 // 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(/^\//, ""))
@@ -52,12 +60,13 @@ try {
     execFileSync(process.execPath, [bin, ...args], { cwd: temp, env, encoding: "utf8", timeout: 20000 })
   assert.equal(run(["--version"]).trim(), version)
   assert.match(run(["--help"]), /Usage: clidev/)
-  const tree = JSON.parse(run(["commands", "--json"])) as { commands: { name: string }[] }
+  const tree: unknown = JSON.parse(run(["commands", "--json"]))
+  const names =
+    isRecord(tree) && Array.isArray(tree.commands)
+      ? tree.commands.map((command) => isRecord(command) && command.name)
+      : []
   for (const root of ["commands", "doctor", "skill", "mcp", "upgrade", "config"])
-    assert.ok(
-      tree.commands.some((command) => command.name === root),
-      `${root} is missing from the installed package`,
-    )
+    assert.ok(names.includes(root), `${root} is missing from the installed package`)
   assert.equal(JSON.parse(run(["doctor", "--json"])).item.version, version)
   assert.match(run(["skill", "show"]), /name: clidev-cli/)
   console.log(`installed ${name}@${version}: help, version, commands, doctor and skill answer offline`)

package/skills/clidev-cli/SKILL.md

@@ -1,18 +1,18 @@
 ---
 name: clidev-cli
-description: Use clidev, a WireCat CLI started from cli-template, from an agent — find a command, run it with the owner's profile, read JSON answers. Use when a task needs clidev; replace this description with what the tool does once it connects to its service.
+description: Use clidev, a WireCat CLI started from cli-template, from an agent — find a command, run it with the owner's profile, read JSON answers. Use when a task needs clidev. It does not connect to a service yet.
 ---
 
 # clidev
 
-Every account command starts with the owner's profile: `clidev personal doctor`. Never pick a profile yourself; if none
+Every account command starts with the owner's profile: `clidev personal config show`. Never pick a profile yourself; if none
 is given, run a command without one and read the profiles the error lists.
 
 Find your way with the tool itself, not this file:
 
 - `clidev commands --json` is the full command tree; `clidev commands config --json` one group.
 - `clidev help config set` is one command's help, with what it returns.
-- `clidev personal doctor --json` says what is set up on this computer.
+- `clidev doctor --json` says what is set up on this computer.
 
 ## Rules
 

package/src/commands/doctor.ts

@@ -1,7 +1,15 @@
 import { existsSync } from "node:fs"
 import { CliError, configFilePath, resolvePaths } from "@wirecat/cli-base"
 import { annotate } from "@wirecat/cli-base/commands"
-import { environmentOf, itemOf, LOCAL_READ, outputFor, readOnlyLockOf, renderAnswer } from "@wirecat/cli-core/cli"
+import {
+  environmentOf,
+  itemOf,
+  LOCAL_READ,
+  outputFor,
+  profileFree,
+  readOnlyLockOf,
+  renderAnswer,
+} from "@wirecat/cli-core/cli"
 import { Command } from "commander"
 import { configuration } from "../config.js"
 import { IDENTITY } from "../identity.js"
@@ -41,10 +49,12 @@ export const doctorReport = (env: NodeJS.ProcessEnv) => {
 }
 
 export const doctorCommand = (): Command =>
-  annotate(new Command("doctor"), {
-    effects: LOCAL_READ,
-    examples: [`${IDENTITY.command} doctor`, `${IDENTITY.command} personal doctor --json`],
-  })
+  profileFree(
+    annotate(new Command("doctor"), {
+      effects: LOCAL_READ,
+      examples: [`${IDENTITY.command} doctor`, `${IDENTITY.command} doctor --json`],
+    }),
+  )
     .description("check this installation: version, paths, config, profiles; no keyring or network")
     .action(function (this: Command) {
       const env = environmentOf(this).env ?? process.env

package/src/mcp.ts

@@ -61,7 +61,7 @@ export const createMcpServer = (options: McpOptions): McpServer => {
       },
     ]),
   )
-  registerCommands(server, IDENTITY.command, commands)
+  registerCommands(server, IDENTITY.command, commands, undefined, undefined, IDENTITY.messenger)
   return server
 }
 

package/src/version.ts

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

package/vitest.config.ts

@@ -10,13 +10,15 @@ export default defineConfig({
     globalSetup: ["src/testing/argv-log.ts"],
     coverage: {
       provider: "v8",
-      include: ["src/**/*.ts"],
+      include: ["src/**/*.ts", "kit/src/**/*.ts"],
       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/**",
+        // The kit's entry point runs only as a separate process, in kit/test/package.test.ts.
+        "kit/src/main.ts",
       ],
       reporter: ["text-summary", "json-summary"],
       thresholds: { lines: 90, statements: 90, functions: 80, branches: 70, perFile: { lines: 50 } },