@wirecat/cli-template 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -3,7 +3,32 @@
 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.
 
-<!-- cspell:words katex smol -->
+<!-- cspell:words katex smol whatsapp -->
+
+## 0.3.0 — 26.10.2026
+
+### Changed — may break callers
+
+- **The skeleton runs on cli-core 0.439.0; cli-base stays at 0.59.0.** A run record now keeps the command line as
+  typed, so `runs show` tells what was run; a secret is still `[redacted]`. The new setting `record_input`
+  (`config set record_input false`) brings back the masking of every typed word. `config set` and `config unset` list
+  `record_input`, so a CLI's help snapshot changes once. A test or page of a CLI that says a run never holds what was
+  typed needs updating. An argument or option that carries a secret is marked with `secretInput()` from
+  `@wirecat/cli-core/cli`; the skeleton has none to mark.
+
+### Security
+
+- **A first word refused as a profile no longer reaches the run record** as the run's `profile`, and an error that
+  quotes `--token=…` or `password=…` no longer keeps the value (from cli-core 0.438.0 and 0.439.0).
+
+### Fixed
+
+- **`docs/dev/reference-clis.md` links the evidence for what it says about other repositories**, no longer calls
+  whatsapp-cli the handbook's worked example, points a mail CLI at cli-memo's mail import, and no longer says `config`
+  hides messenger settings when `messenger` is `false`.
+- **`pnpm release:check` also runs `security:no-leak` and `package:check`**, which only `bin/release --local` ran.
+  `package.json` is copied once, so a CLI adds both to its own `release:check` by hand.
+- **`SECURITY.md` asks never to send a session** beside a token, a password and private content.
 
 ## 0.2.0 — 26.10.2026
 

package/SECURITY.md

@@ -5,8 +5,8 @@ Please report a security problem privately — never in a public issue:
 - by email: [hello@wirecat.dev](mailto:hello@wirecat.dev);
 - or through [GitHub's private vulnerability reporting](https://github.com/WireCatLabs/cli-template/security/advisories/new).
 
-Say what you saw, how to repeat it, and the version (`clidev --version`). Never send a token, a password or anyone's
-private content.
+Say what you saw, how to repeat it, and the version (`clidev --version`). Never send a token, a password, a session or
+anyone's private content.
 
 What `clidev` keeps on your computer: the [shared security page](https://wirecat.dev/en/docs/security) and
 [docs/security.md](docs/security.md).

package/dist/version.d.ts

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

package/dist/version.js

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

package/docs/commands.md

@@ -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, 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>. |
+| `setting` | required | one of: limit, timeout_ms, color, record, record_input, 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, 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>. |
+| `setting` | required | one of: limit, timeout_ms, color, record, record_input, 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/configuration.md

@@ -16,3 +16,9 @@ clidev personal config unset limit
 `permissions` decides what a command may do for this profile: `allow`, `ask`, `readonly` or `deny`, per permission
 key. Over MCP there is no one to ask, so `ask` lets the command run. `CLIDEV_READ_ONLY=1` refuses every write, whatever
 the permissions say.
+
+## Run records
+
+A command that fails is kept as a run, for `clidev runs list` and `runs show`. `record_input` decides whether a run
+keeps the words you typed; it is `true` unless you set it to `false`. Secrets are masked either way; see
+[Security](security.md).

package/docs/dev/reference-clis.md

@@ -5,19 +5,20 @@ the first question of the [design interview](skills/design-interview/SKILL.md):
 
 | Category | Learn from |
 | --- | --- |
-| messenger | [whatsapp-cli](https://github.com/WireCatLabs/whatsapp-cli), the handbook's worked example; then [tg-cli](https://github.com/WireCatLabs/tg-cli) and [max-cli](https://github.com/WireCatLabs/max-cli) |
+| messenger | [whatsapp-cli](https://github.com/WireCatLabs/whatsapp-cli), then [tg-cli](https://github.com/WireCatLabs/tg-cli) and [max-cli](https://github.com/WireCatLabs/max-cli) |
 | files and documents | [drive-cli](https://github.com/WireCatLabs/drive-cli) |
 | meetings | [zoom-cli](https://github.com/WireCatLabs/zoom-cli) |
 | notes | [cli-memo](https://github.com/WireCatLabs/cli-memo) |
-| mail, calendar, other | none yet: pick the nearest one with the owner |
+| mail, calendar, other | none of its own yet: pick the nearest one with the owner. cli-memo [imports mail](https://github.com/WireCatLabs/cli-memo/blob/c2d21254ab360aed7149a3250d17e879283aa603/docs/mail.md) |
 
 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.
+category keeps the template's `messenger: false`, so the shared help and `commands` do not speak of chats, messages
+and senders. `config` still lists cli-core's messenger settings, such as `sends_per_hour` and `read_other_bots`.
 
 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.
+do not show this call: cli-core already knows their providers, from its [seed list](https://github.com/WireCatLabs/cli-core/blob/6d8f415a6ba3124679741f57d3c22ee0f236e8bf/src/domain/providers.ts#L17-L29) and, for Drive, its
+[document providers](https://github.com/WireCatLabs/cli-core/blob/6d8f415a6ba3124679741f57d3c22ee0f236e8bf/src/domain/providers.ts#L50) (cli-core 0.439.0). `grep -rl registerProvider` over a clone of each of the six finds no call. 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/skills/design-interview/SKILL.md

@@ -21,7 +21,9 @@ go to the further questions.
 5. **How do people filter what they find?** by time · by person · by container (chat, folder, calendar) · by words in
    the text · by status or label · other; several allowed.
 6. **What must never reach the store, a log or the output?** tokens and passwords · one-time codes and passcodes ·
-   links that carry a secret · the full content, keep only metadata · other; several allowed.
+   links that carry a secret · the full content, keep only metadata · other; several allowed. A run record keeps
+   the words typed on the command line: an argument or option that carries such a value is marked with
+   `secretInput()` from `@wirecat/cli-core/cli`.
 7. **What untrusted input arrives?** messages from other people · files and attachments · links · names and titles set
    by others · none · other; several allowed.
 

package/docs/security.md

@@ -6,6 +6,10 @@ What WireCat CLIs share — the keyring, permissions, MCP and what never reaches
 `clidev` keeps its settings in `config.json` and its state in the folders `clidev doctor` shows. It sends nothing
 to any service yet.
 
+A run record keeps the command line as you typed it, so `clidev runs show` tells you what was run. A secret is still
+stored as `[redacted]`: an option named like a token or password, a password in a link, a long opaque string. To
+keep none of the words you type, run `clidev personal config set record_input false`.
+
 `config.json` is saved readable by you only (`0600`), and its folder is created for you only (`0700`). A file or
 folder made by an older version may be open to other users of the computer: `clidev doctor` lists each under
 `files.problems` and prints the `chmod` that fixes it. Windows is not checked. Report a vulnerability as [SECURITY.md](https://github.com/WireCatLabs/cli-template/blob/main/SECURITY.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-template",
-  "version": "0.2.0",
+  "version": "0.3.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",
@@ -73,7 +73,7 @@
     "lint:commands": "pnpm build && cli-dev lint --cli dist/bin/clidev.js",
     "audit:commands": "pnpm build && bash scripts/audit.sh",
     "ci:quick": "pnpm typecheck && pnpm build && pnpm lint:commands",
-    "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",
+    "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 && pnpm security:no-leak && pnpm package:check",
     "prepare": "lefthook install || true",
     "prepack": "pnpm build",
     "docs:spell": "cspell lint --config cspell.json --no-progress --no-summary README.md SECURITY.md CHANGELOG.md 'docs/*.md'",
@@ -85,7 +85,7 @@
   "dependencies": {
     "@modelcontextprotocol/server": "2.4.0",
     "@wirecat/cli-base": "0.59.0",
-    "@wirecat/cli-core": "0.437.0",
+    "@wirecat/cli-core": "0.439.0",
     "commander": "15.0.0"
   },
   "devDependencies": {

package/src/program.test.ts

@@ -142,3 +142,17 @@ it("keeps a failed command as a run, and runs list, show and path read it back",
   expect(path.code).toBe(0)
   expect(path.out).toContain(id)
 })
+
+it("a failed run keeps the words typed, and record_input false masks them", async () => {
+  const keptArgv = async (words: string) => {
+    expect((await ran(["personal", "skill", "show", words])).code).toBe(2)
+    const { out } = await ran(["runs", "list", "--limit", "50", "--json"])
+    return JSON.parse(out).items.map((run: { argv: string[] }) => run.argv)
+  }
+  expect(await keptArgv("weekly report")).toContainEqual(["personal", "skill", "show", "weekly report"])
+  expect((await ran(["personal", "config", "set", "record_input", "false"])).code).toBe(0)
+  const masked = await keptArgv("monthly report")
+  expect(JSON.stringify(masked)).not.toContain("monthly report")
+  expect(masked).toContainEqual(["personal", "skill", "show", "[redacted]"])
+  expect((await ran(["personal", "config", "unset", "record_input"])).code).toBe(0)
+})

package/src/version.ts

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