@wirecat/cli-template 0.1.8 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,40 @@ Notable changes to `@wirecat/cli-template`. One section per version, newest firs
 
 <!-- cspell:words katex smol -->
 
+## 0.2.0 — 26.10.2026
+
+### Added
+
+- **`skill install --for hermes` gives Hermes Agent the skill, and `skill status` reports the copy Hermes reads.**
+  A bare `skill install` still writes only Claude Code's folder and `~/.agents/skills`, which OpenClaw reads too.
+- **`search_reranker` is a new setting in `config set`.** Only a CLI that adds cli-core's message search uses it.
+
+### Changed — may break callers
+
+- **The skeleton runs on cli-core 0.437.0 and cli-base 0.59.0.** cli-core 0.437 accepts only cli-base 0.59.x, so a
+  CLI that pins cli-base moves both. `--help-all` now gives `clidev personal mcp` as the profile example, not
+  `clidev personal doctor`, since `doctor` takes no profile; a CLI that keeps help snapshots refreshes them once.
+  `skill status --json` gains a `hermes` entry beside `targets`. A run started by OpenClaw has `agent: openclaw`,
+  and one started from an OpenClaw chat adds `agent.from_chat: true`: a reader of `run.json` that refuses unknown
+  keys must accept it.
+- **`bin/release` runs `changelog restore` from the installed cli-base**, through `pnpm exec cli-dev` like the fold,
+  not from `npx -p @wirecat/cli-base@0.55.1` outside the lockfile. A CLI that takes this file with `upgrade` needs
+  cli-base 0.55.1 or later, which has `changelog restore`.
+- **`pnpm version:check` refuses a release whose number is raised less than its changelog needs.** Before `1.0.0`, a
+  section with `Changed — may break callers`, `Removed` or `Added` raises the minor; only fixes, security and docs
+  raise the patch. The release skill says the same. `scripts/` and `package.json` are copied once, so a CLI started
+  from an older template copies `scripts/version-level.ts` and the `version:check` script to get the check.
+- **A new CLI starts with coverage floors just under what the skeleton's tests reach**: lines 95, statements 92,
+  functions 85, branches 75, and still 50% lines per file. The template's kit has its own floor, which `new` leaves
+  out of the CLI's `vitest.config.ts`.
+
+### Fixed
+
+- **`new` drops a `kit/` key from a config,** not only a `kit/` entry in a list, so the CLI's `vitest.config.ts` has
+  no coverage floor for a folder it does not have.
+- **`docs/installation.md` gives the Node.js versions `engines` allows:** 22.16 or a later 22.x, or 24 or later. It
+  read as if Node 23 worked.
+
 ## 0.1.8 — 26.10.2026
 
 ### Changed — may break callers

package/README.md

@@ -32,7 +32,7 @@ such as `personal` in `clidev personal config show`; none is ever assumed. `CLID
 | `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 |
+| `clidev skill install` | Installs the agent skill for Claude Code, Codex, Gemini CLI and OpenClaw; `--for hermes` for Hermes Agent |
 | `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 |

package/bin/release

@@ -83,7 +83,7 @@ land() {
 
 # A pull request checked before the last release and merged after it put its entry in that release's section;
 # restore moves it to Unreleased, so the fold below brings it into this version.
-restored=$(npx -y -p @wirecat/cli-base@0.55.1 cli-dev changelog restore --land)
+restored=$(pnpm exec cli-dev changelog restore --land)
 [ -z "$restored" ] || echo "$restored"
 rerun_if_changed "$@"
 

package/dist/version.d.ts

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

package/dist/version.js

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

package/docs/commands.md

@@ -90,7 +90,7 @@ clidev skill show [name] [options]
 
 ### `clidev skill install`
 
-write SKILL.md to \~/.claude/skills/clidev-cli/ (Claude Code) and \~/.agents/skills/clidev-cli/ (Codex, Gemini CLI)
+write SKILL.md to \~/.claude/skills/clidev-cli/ (Claude Code) and \~/.agents/skills/clidev-cli/ (Codex, Gemini CLI, OpenClaw); --for hermes also has Hermes read \~/.agents/skills, which changes Hermes's own settings, so all leaves it out
 
 **Changes something on this computer only.**
 
@@ -100,7 +100,7 @@ clidev skill install [options]
 
 | Option | What it does |
 |---|---|
-| `--for <agents>` | which agents to install for. One of: `claude`, `agents`, `all`. Default: `all`. |
+| `--for <agents>` | which agents to install for. One of: `claude`, `agents`, `hermes`, `all`. Default: `all`. |
 
 **Returns:** install the tool's instructions for AI agents
 
@@ -108,7 +108,7 @@ clidev skill install [options]
 
 ### `clidev skill status`
 
-for each place `clidev skill install` writes to: the path, the version installed there, and whether it is current, stale, missing or unversioned
+for each place `clidev skill install` writes to, and for the copy Hermes reads: the path, the version installed there, and whether it is current, stale, missing or unversioned
 
 ```sh
 clidev skill status
@@ -182,7 +182,7 @@ clidev config set <setting> <value> [options]
 
 | Argument | | What it is |
 |---|---|---|
-| `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>. |
+| `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, search_reranker, 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 |
@@ -207,7 +207,7 @@ clidev config unset <setting> [options]
 
 | Argument | | What it is |
 |---|---|---|
-| `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>. |
+| `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, search_reranker, 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 |
 |---|---|

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

@@ -20,9 +20,13 @@ and runs `bin/release`.
 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 version.** `npm view @wirecat/clidev-cli version` is what is published. The changelog picks the level, and
+   before `1.0.0` this narrows `WC-REL-7`: a section with `Changed — may break callers` or `Removed` raises the minor
+   (`0.1.8` to `0.2.0`), and so does one with `Added`; only a section of `Fixed`, `Security` or docs raises the patch.
+   From `1.0.0`, a breaking change raises the major. `pnpm version:check` refuses a dated section whose number is
+   raised less than its headings need. 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>`.
 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 `NPM_TOKEN`, the npm token in the keyring, or the owner's own npm login.
    The keyring is read only when `NPM_KEYRING_ACCOUNT` names the account the token is stored under (service `npm`);

package/docs/installation.md

@@ -1,6 +1,6 @@
 # Install
 
-Install `clidev` once on each computer where you or an agent use it. You need Node.js 22.16 or later, or 24.
+Install `clidev` once on each computer where you or an agent use it. You need Node.js 22.16 or a later 22.x, or 24 or later; Node 23 is not supported.
 
 ```sh
 npm install -g @wirecat/clidev-cli

package/docs/usage.md

@@ -20,8 +20,9 @@ on. The [command reference](commands.md) lists the codes.
 
 ## Agents
 
-`clidev skill install` puts the tool's skill where Claude Code, Codex and Gemini CLI look for it. `clidev personal mcp`
-serves the profile's commands over MCP, on stdin and stdout:
+`clidev skill install` puts the tool's skill where Claude Code, Codex, Gemini CLI and OpenClaw look for it.
+`clidev skill install --for hermes` also adds that folder to Hermes Agent's own settings, so a bare `skill install`
+leaves Hermes out. `clidev personal mcp` serves the profile's commands over MCP, on stdin and stdout:
 
 ```sh
 claude mcp add clidev -- clidev personal mcp

package/kit/dist/rename.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-template",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "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",
@@ -67,7 +67,7 @@
     "docs:lint": "markdownlint-cli2",
     "contracts:check": "cli-contract contracts/plan.json",
     "security:no-leak": "cli-testing security no-leak . contracts/no-leak.json",
-    "version:check": "cli-dev version",
+    "version:check": "cli-dev version && node --experimental-strip-types scripts/version-level.ts",
     "version:sync": "cli-dev version --sync",
     "standards:check": "node config/wirecat/check.mjs",
     "lint:commands": "pnpm build && cli-dev lint --cli dist/bin/clidev.js",
@@ -84,8 +84,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/server": "2.4.0",
-    "@wirecat/cli-base": "0.57.1",
-    "@wirecat/cli-core": "0.434.0",
+    "@wirecat/cli-base": "0.59.0",
+    "@wirecat/cli-core": "0.437.0",
     "commander": "15.0.0"
   },
   "devDependencies": {

package/scripts/version-level.test.ts

@@ -0,0 +1,30 @@
+import { expect, it } from "vitest"
+import { versionLevelProblem } from "./version-level.js"
+
+const changelog = (version: string, headings: string[], previous = "0.1.8") =>
+  [`## ${version} — 26.10.2026`, ...headings.flatMap((h) => [`### ${h}`, "- x"]), `## ${previous} — 25.10.2026`].join(
+    "\n",
+  )
+
+it("refuses 0.1.8 as it shipped: a patch release with changes that may break callers", () => {
+  expect(versionLevelProblem(changelog("0.1.8", ["Changed — may break callers", "Fixed"], "0.1.7"))).toBe(
+    "0.1.8 raises the patch version over 0.1.7, but its changelog needs a minor release",
+  )
+})
+
+it.each([
+  ["0.1.9", ["Fixed", "Security"]],
+  ["0.2.0", ["Added", "Changed — may break callers"]],
+  ["0.2.0", ["Removed"]],
+  ["1.0.0", ["Changed — may break callers"]],
+])("accepts %s with %j", (version, headings) => {
+  expect(versionLevelProblem(changelog(version, headings))).toBeUndefined()
+})
+
+it("refuses a patch release that adds something", () => {
+  expect(versionLevelProblem(changelog("0.1.9", ["Added"]))).toMatch(/needs a minor release/)
+})
+
+it("checks nothing while the top section is Unreleased", () => {
+  expect(versionLevelProblem("## Unreleased\n\n### Removed\n\n- x\n\n## 0.1.8 — 25.10.2026\n")).toBeUndefined()
+})

package/scripts/version-level.ts

@@ -0,0 +1,43 @@
+import { readFileSync } from "node:fs"
+import { resolve } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const LEVELS = ["patch", "minor", "major"] as const
+type Level = (typeof LEVELS)[number]
+
+const parse = (version: string) => version.split(".").map(Number)
+
+const raised = (from: string, to: string): Level => {
+  const [a = 0, b = 0] = parse(from)
+  const [x = 0, y = 0] = parse(to)
+  if (x !== a) return "major"
+  return y !== b ? "minor" : "patch"
+}
+
+// Before 1.0.0 the minor carries what a major would; a fix-only release is the only patch.
+const needed = (version: string, section: string): Level => {
+  const breaks = /^### (Changed — may break callers|Removed)$/m.test(section)
+  if (breaks) return (parse(version)[0] ?? 0) >= 1 ? "major" : "minor"
+  return /^### Added$/m.test(section) ? "minor" : "patch"
+}
+
+export const versionLevelProblem = (changelog: string): string | undefined => {
+  const headings = [...changelog.matchAll(/^## (\S+).*$/gm)]
+  const [top, below] = headings
+  const version = top?.[1]
+  const previous = below?.[1]
+  if (!top || !below || !version || !previous || !/^\d+\.\d+\.\d+$/.test(version)) return undefined
+  const section = changelog.slice(top.index, below.index)
+  const want = needed(version, section)
+  const got = raised(previous, version)
+  if (LEVELS.indexOf(got) >= LEVELS.indexOf(want)) return undefined
+  return `${version} raises the ${got} version over ${previous}, but its changelog needs a ${want} release`
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  const problem = versionLevelProblem(readFileSync(resolve(import.meta.dirname, "../CHANGELOG.md"), "utf8"))
+  if (problem) {
+    console.error(`${problem} (docs/dev/skills/release/SKILL.md, step 6)`)
+    process.exit(1)
+  }
+}

package/src/mcp.test.ts

@@ -29,7 +29,13 @@ const connect = async () => {
   return client
 }
 
-const structured = (result: unknown) => (result as { structuredContent: Record<string, unknown> }).structuredContent
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === "object" && value !== null && !Array.isArray(value)
+const structured = (result: unknown) => {
+  if (!isRecord(result) || !isRecord(result.structuredContent))
+    throw new Error("the tool answered without structured content")
+  return result.structuredContent
+}
 
 it("offers search, read and write", async () => {
   const client = await connect()
@@ -40,9 +46,8 @@ it("offers search, read and write", async () => {
 it("finds writes as well as reads", async () => {
   const client = await connect()
   const found = structured(await client.callTool({ name: "clidev_tools_search", arguments: {} }))
-  const items = found.items as { command: string; writes: boolean }[]
-  expect(items.some((item) => item.writes)).toBe(true)
-  expect(items.map((item) => item.command)).not.toContain("mcp")
+  expect(found.items).toContainEqual(expect.objectContaining({ writes: true }))
+  expect(found.items).not.toContainEqual(expect.objectContaining({ command: "mcp" }))
 })
 
 it("runs a command through the CLI and answers with its result", async () => {

package/src/program.test.ts

@@ -14,13 +14,21 @@ const ran = async (argv: string[]) => {
   })
   return { code, out: out.join("\n"), err: err.join("\n") }
 }
-const json = (text: string) => JSON.parse(text) as { item: Record<string, unknown> }
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === "object" && value !== null && !Array.isArray(value)
+const json = (text: string) => {
+  const parsed: unknown = JSON.parse(text)
+  if (!isRecord(parsed) || !isRecord(parsed.item)) throw new Error(`not an answer with one item: ${text}`)
+  return { item: parsed.item }
+}
 
 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", "runs"]))
+  const required = ["commands", "doctor", "skill", "mcp", "upgrade", "config", "runs"]
+  expect(JSON.parse(out).commands).toEqual(
+    expect.arrayContaining(required.map((name) => expect.objectContaining({ name }))),
+  )
 })
 
 it("doctor answers without a config file", async () => {
@@ -123,11 +131,9 @@ it("keeps a failed command as a run, and runs list, show and path read it back",
   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 failed: unknown = JSON.parse(listed.out).items.find((run: { status: string }) => run.status === "failed")
+  if (!isRecord(failed) || typeof failed.run_id !== "string") throw new Error(`no failed run in ${listed.out}`)
+  const id = failed.run_id
   const shown = await ran(["runs", "show", id, "--json"])
   expect(shown.code).toBe(0)
   expect(shown.out).toContain(id)

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = "0.1.8"
+export const VERSION = "0.2.0"

package/vitest.config.ts

@@ -21,7 +21,11 @@ export default defineConfig({
         "kit/src/main.ts",
       ],
       reporter: ["text-summary", "json-summary"],
-      thresholds: { lines: 90, statements: 90, functions: 80, branches: 70, perFile: { lines: 50 } },
+      thresholds: {
+        "src/**": { lines: 95, statements: 92, functions: 85, branches: 75, perFile: { lines: 50 } },
+        // The kit is a separate program, copied by npx, so it keeps its own floor.
+        "kit/src/**": { lines: 95, statements: 91, functions: 90, branches: 78, perFile: { lines: 50 } },
+      },
     },
   },
 })