@duyquangnvx/agent-cli 0.16.0 → 0.18.0

package/CHANGELOG.md

@@ -4,6 +4,82 @@ What changed in each release of `@duyquangnvx/agent-cli` (the Runtime) and `@duy
 
 ## Unreleased
 
+## v0.18.0 (2026-10-28)
+
+### Added
+
+- `render` and `renderPlan` are optional on every Command. Without `render`, text prints the data as [TOON](https://github.com/toon-format/toon), or nothing when there is none, and a List Command prints `page.items` that way before the page footer; without `renderPlan`, `--dry-run` prints `Would run <command line>:` and under it the Plan as TOON, indented two spaces, then `outputs` and `cost` as before. `--json` and `--fields` output are unchanged. The Scaffolder's `greet` declares no `render`, so it prints `greeting: "Hello, Ana!"`.
+- A `CliError` takes `next`, an ordered list of Next steps beside its `hint`: each is the words after the CLI's name, such as `["archive", "--yes"]`, or `ctx.rerun({ remove?, add? })`, the caller's own line with each flag in `remove` dropped along with its value and the words in `add` placed before any `--`, keeping its `< <name file>` redirect. The Runtime builds each into a shell-quoted line starting with the Run-as. Text prints each on its own `run:` line after the hint; `--json` adds `next: string[]` to the error, absent when there are none, and each `AggregateError` leaf keeps its own. Under `runCli`, a Next step that names no Command or an unknown flag fails the run as a bug (exit 70) naming it; the built CLI does not check. `NextStep`, `Rerun` and `CommandLineChange` are exported, and the docs' example `links` gives its lines as Next steps.
+- A second entry, `@duyquangnvx/agent-cli/testing`, exports `fakeClock({ busy?, onWake? })` to pass as `runCli`'s `clock`: its time moves only when every task waits on it, and waits for file reads and writes, so deadlines, `ctx.poll` and waits finish at once and in order. `busy` holds time while work Node cannot see is running; `onWake` runs as each sleep ends. The docs' example imports it.
+- A Command and a CLI with several Commands take `secrets: [{ name, get }]`, `get` saying where to obtain the key. After the `tools` check and before `plan`, `run` or `start`, `--dry-run` included, a run whose declared Secret is unset in the environment and in the CLI's `.env` fails with the new Runtime code `SECRET_MISSING` (exit 2), naming every missing one with its `get` and the `.env` path. `doctor` gains a `secrets` row over the CLI's and every Command's Secrets, naming where each came from and never its value, and failing `doctor` for a missing one. Help JSON gives each Command `secrets: { name, get }[]`. The type `SecretDeclaration` is exported. The docs' example `links check` declares `LINKS_TOKEN`, which replaces its `token` row.
+- `@duyquangnvx/agent-cli/testing` exports `checkExamples(cli)`. It checks every example of every Command, nested, single-command and Built-in alike: the line tokenizes as a POSIX shell would (a `< file` redirect allowed), starts with the CLI's name, routes to a Command, and passes that Command's schemas. It throws one error listing each example that does not, with the reason. The Scaffolder's test and the docs' example `links` test call it.
+- `defineCli({ skill })` takes `{ page: "<https URL>" }`, the page of a Skill Hub where each user copies their own install line. `doctor`'s `skill` row then gives no fix for a missing copy or one that states no version, and its message names the page; `update` names it as a Notice. A copy older than the CLI still gets `npx -y skills update <name>`. `defineCli` throws on a page that is not an `https` URL.
+- The Scaffolder's `--skill-hub-api` with `--skill-page` scaffolds a CLI on an API Skill Hub: `skillHub: { api }`, `skill: { page }`, and a README line naming the page. Either flag without the other is a usage error, `SKILL_PAGE_MISSING` or `SKILL_HUB_API_MISSING`, and passing both hub kinds is `SKILL_HOMES_CONFLICT`.
+- `@duyquangnvx/agent-cli` ships its docs in `docs/`: an index, principles, getting started, a guide per topic, a map from each export to the `.d.ts` file that documents it, and the example `links` with its tests. Beside them, `agents-section.md` is the Agents section that points a repo's `AGENTS.md` at those docs, between `<!-- BEGIN:@duyquangnvx/agent-cli -->` and `<!-- END:@duyquangnvx/agent-cli -->`.
+
+### Changed
+
+- **Breaking:** a Command that declares `output` must return the schema's input type from `run`, `apply` or `start`, and its `render` receives the schema's output. Before printing, the Runtime parses returned and delivered data with the schema: data it rejects fails the run as a bug (exit 70) and prints no data, even when the Command caught an error around `ctx.deliver`, and its defaults and transforms show in what prints, under `--json` and in text. A Command without `output`, and a List Command's `rows`, are unchanged.
+- **Breaking:** a Command no longer declares `name`, and declaring it fails type checking. The Runtime labels a Command by its path in `commands`: a declaration error names `voices list`, and a spilled file ends in `-voices-list`. A single-command CLI's Command takes the CLI's name. The checks that named a Command (a Standard flag name, `force`, an array arg, `orStdin`, a boolean array option) now throw from `defineCli` rather than `defineCommand`. The scaffolded template drops `name`.
+- **Breaking:** `agentCli({ ports?, project?, errors? })` takes the ports factory, the Project file and the Error table as values, and `defineCli` no longer accepts them. `ctx.ports` is the type the factory returns and `ctx.project.settings` the Project file schema's output, so `agentCli` takes no type parameters; without `ports`, `ctx.ports` is empty. `agentCli` returns `cliError(code, init, options?)`, typed by the table, and the package no longer exports `cliError(table, code, init)`. An Error table that redeclares a Runtime code makes `agentCli` throw rather than `defineCli`. The scaffolded template and the Runtime's docs use the new form.
+- **Breaking:** `ctx.timeout` is gone: `ctx.deadline(ms, { ignoreStop: true })` does what it did, aborting once `ms` have passed whether or not Ctrl-C or the run deadline stopped the run. The docs teach it for a billed call inside `runToEnd`.
+- **Breaking:** the Runtime codes are no longer exported as loose constants (`INTERRUPTED`, `DEADLINE_EXCEEDED`, `PERMISSION_DENIED` and the rest); each is on the exported `runtimeCodes` object, as `runtimeCodes.INTERRUPTED`. The docs and their example use it.
+- **Breaking:** `defineCli` takes `manifest`, the parsed `package.json`, in place of `name`, `version`, `description` and `engines`. The CLI's name is the manifest's `bin` key when it has exactly one, else the unscoped package name. `install` is `"global"`, `"dependency"` or `{ mode: "dependency", lockstep }`, its package being `manifest.name` and a Global install's registry `manifest.publishConfig.registry`; `defineCli` throws when a Global install's manifest lacks that registry. The new `CliManifest` and `InstallDeclaration` types are exported.
+- **Breaking:** `defineCli` no longer takes `build`. The Runtime reads the build stamp from the `__AGENT_CLI_BUILD__` global the bundler defines, and without it, as in an unbundled run, `--version` prints no stamp. The scaffolded template drops `src/build.ts`, and its `tsdown.config.ts` defines `__AGENT_CLI_BUILD__` in place of `__BUILD__`.
+- **Breaking:** `ctx.secret(name)` accepts only the names in the running Command's `secrets` and returns a `Secret`, never `undefined`; reading a name a Command does not declare, or reading any from a `doctor` row's `ctx`, fails type checking, and one reached past the type fails the run as a bug (exit 70), set or not. `PortsBase.secret` still takes any name and may return `undefined`.
+- **Breaking:** an example starts with the CLI's name, and help and `--help --json` print it with that name replaced by the Run-as, so under a Dependency install it reads `npx -q --no-install <bin> ...`. An example already written with the Run-as prints as written and fails `checkExamples`. The Built-in Commands' examples and the scaffolded template's start with the bare name.
+- **Breaking:** a Command declares the Error table codes it throws as `errors: [...]`, and help JSON gives each Command `errors: { code, class }[]`; a single-Command CLI's root `errors` keeps the Error table's shape but holds only the codes its Command declares. A run ending in a table code the running Command does not declare, directly or as an `AggregateError` leaf, fails as a bug (exit 70) naming the code and the Command, so a Command without `errors` may throw none of the table's codes; Runtime codes are never listed, and failures of `doctor` and its rows are not checked. `defineCli` throws on an `errors` entry the table lacks. The new `ctx.fail(code, init, options?)` returns a `CliError` for a declared code, typed by its `details`, for the Command to throw as `throw ctx.fail(...)`; `cliError` builds the same error for helpers outside a Command. The scaffolded template's `card` and the docs' example `links` declare their codes.
+- `Context` and `ServeContext` take a third type parameter, the Command's `Needs` (`{ secretName, errors }`), which types `ctx.secret` and `ctx.fail`; `Needs` is exported. A helper that takes a plain `Context<Ports>` gets a `ctx` whose `secret` and `fail` accept nothing.
+- **Breaking:** a Secret's name typed `string`, as one held in a plain `const` object is, fails type checking in `secrets`, since it would let `ctx.secret` take any name; a Command written inline in `defineCli` keeps its names literal.
+- **Breaking:** the Runtime's failures during a run give their lines as Next steps, and their hints say when to run them without naming a line: `INTERRUPTED`, `DEADLINE_EXCEEDED` (from `ctx.deadline` and from a Command's `deadline`), `OUTPUT_EXISTS` and a guarded output's `ALREADY_EXISTS` (adding `--force`), `NOT_CONFIRMED` (adding `--yes`), `CONFIRMATION_REQUIRED` and `CONFIRMATION_MISMATCH` (with the right `--confirm`), `TOOL_MISSING` (each missing tool's `install`, then the rerun), `SECRET_MISSING`, `PROJECT_INVALID`, `NEEDS_OPERATOR`, and `PERMISSION_DENIED` and `DISK_FULL` where they asked for a rerun. The hints of `INTERRUPTED` and of a billed call's deadline still warn against running it blindly. A Command's `deadline.resume(input, rerun)` takes `ctx.rerun` in place of `ctx.commandLine` and returns a Next step, which the run's `DEADLINE_EXCEEDED` gives under the hint `run the Next step to continue the work`; returning a string fails type checking.
+- **Breaking:** the Built-in Commands, `doctor` and List Command pages give their lines as Next steps. `update`'s `REGISTRY_UNREACHABLE`, `REGISTRY_AUTH`, `INSTALL_FAILED` and `NPM_FAILED` give the caller's line, their hints ending `then run it again`; `INSTALL_FAILED` then gives the `npm install --global` line, and `NOT_GLOBAL_INSTALL` gives it alone. A `doctor` problem with a fix gives the fix, then `doctor` as typed, under the hint `run the Next steps in order`. A rendered page ends `N shown; run the Next step for the next page` and a `run:` line in place of ``next page: `<line>` ``; the `--json` page's `next` is unchanged. The scaffolded template's `LANGUAGE_UNSUPPORTED` gives the English card as a Next step.
+- `runCli`'s `env` is optional: without it the run sees an empty env, never the shell's. `cwd` stays required.
+- The Runtime's docs and both READMEs teach Next steps, `secrets`, `errors`, `ctx.fail` and `checkExamples`, and the docs' "A Command is done when" checks them.
+- The Runtime's docs, the README and the scaffolded `AGENTS.md` teach `render` as optional, `defineCli({ manifest, install })` and `runCli` without `env`; the docs' example `links check` prints its data as TOON, and its tests and the scaffolded test drop `env: {}`.
+- **Breaking:** the Scaffolder's `--skill-hub` is now `--skill-hub-git`, which writes `skillHub: { git }` in `scripts/release.ts`. The scaffolded template is on `@duyquangnvx/release` 0.5.0 and awaits `release()`.
+- **Breaking:** the agent-cli skill is no longer published to the Skill Hub; the docs the Runtime ships replace it. The scaffolded `AGENTS.md` ends with the Runtime's Agents section, and its `## Coding standards` no longer restates how to declare Commands, which the docs cover.
+- `skill install`, `doctor`'s `agents` row and `skill install --help` call a Packaged skill's part of `AGENTS.md` its Agents section instead of its block.
+
+### Removed
+
+- **Breaking:** `ctx.commandLine` is gone; `ctx.rerun(change)` gives the caller's line, as a Next step.
+
+### Fixed
+
+- Under `--json`, a Command that returns no data prints `null`, which is valid JSON, rather than `undefined`.
+- A reader that closes stdout or stderr early, as `| head` does, no longer crashes the CLI with Node's `Unhandled 'error' event` stack and exit 1. The rest of that stream's output is dropped, the Command runs to its end, and the CLI exits with the run's own exit code.
+
+### Upgrade from v0.17.0
+
+Take these steps in order; `pnpm typecheck` finds every site the first eight leave behind.
+
+1. In the module that calls `agentCli`, move `ports`, `project` and `errors` out of `defineCli` into that call and delete its type parameters: `agentCli<Ports, Settings>()` becomes `agentCli({ ports, project, errors })`. Export the `cliError` it returns beside `defineCommand` and `defineCli`, as the template's `src/cli.ts` and the docs' `example/define.ts` do.
+2. Import `cliError` from that module wherever a Command throws, and drop its first argument: `cliError(errors, "CODE", init)` becomes `cliError("CODE", init)`.
+3. In `defineCli`, replace `name`, `version`, `description` and `engines` with `manifest` (`import manifest from "../package.json" with { type: "json" }`), and replace the install object with `install: "global"`, `install: "dependency"`, or `{ mode: "dependency", lockstep }` with lockstep packages. A Global install's `package.json` needs `publishConfig.registry`.
+4. Delete `src/build.ts` and the `build` line of `defineCli`, and in `tsdown.config.ts` rename the `define` key `__BUILD__` to `__AGENT_CLI_BUILD__`.
+5. Delete `name` from every Command.
+6. Replace each `ctx.timeout(ms)` with `ctx.deadline(ms, { ignoreStop: true })`.
+7. Import `runtimeCodes` in place of each Runtime code constant, and write `runtimeCodes.CODE` where `CODE` stood.
+8. Make each Command's `deadline.resume` return a Next step: `(_input, commandLine) => commandLine(change)` becomes `(_input, rerun) => rerun(change)`, and a line written by hand becomes the words after the CLI's name, such as `["archive", "--yes"]`.
+9. Correct each Command whose data does not match its `output` schema: `pnpm typecheck` names those it can see, and `pnpm test` the rest, which now exit 70. An object schema strips keys it does not declare, so declare every key the data should print, or make the schema `z.looseObject`.
+10. Under a Dependency install, start each Command's `examples` with the bare CLI name instead of `npx -q --no-install <bin>`, then call `checkExamples(cli)` from `@duyquangnvx/agent-cli/testing` in a test and fix each example it lists.
+11. For each Command that calls `ctx.secret(name)`, add `secrets: [{ name, get }]` with the name inline, or its object declared `as const`, and drop its `undefined` branch, since the Runtime now fails the run first. Move a `doctor` row that only reports a key into the CLI's `secrets`; the `secrets` row reports it.
+12. List in each Command's `errors` every code of the Error table it throws, those its helpers and ports throw included (a shared store's `CORRUPT_DATA` goes on every Command that reads the store), then run `pnpm test`: a code left out now exits 70 and names the Command. Inside a Command, `throw ctx.fail(code, init)` in place of `throw cliError(code, init)` makes an undeclared code a type error.
+13. Move each command line out of a hint into the error's `next`: a line naming a Command becomes the words after the CLI's name, such as `["archive", "--yes"]`, and `ctx.commandLine(change)` becomes `ctx.rerun(change)`. Reword the hint to say whether and when to run the Next steps rather than quote them.
+14. Update each test that asserts a line in a hint of the Runtime's, `doctor`'s or a Built-in Command's, or a rendered page's ``next page:`` line, to read the Next step instead: the error's `next` under `--json`, or its `run:` line in text.
+15. Remove the agent-cli skill: `npx skills remove agent-cli -g`. Then append `node_modules/@duyquangnvx/agent-cli/agents-section.md` to the CLI repo's `AGENTS.md`, markers included, so sessions there find the Runtime's docs.
+
+## v0.17.0 (2026-10-27)
+
+### Added
+
+- A fifth Effect, `act`, for a Command that changes the state of a program already running, such as a page in a browser tab, rather than files or remote services. It is declared as a read Command is, with `run` and the new `ActCommand` type, and cannot declare a Plan or `rows`. Its help says so and that running it again may act again, its `--help --json` gives `"effect": "act"`, and of the Standard flags it gets only `--json`. The agent-cli skill says when to pick `act` over `read` and `write`.
+- The Scaffolder's `AGENTS.md` names the `act` and `serve` Effects beside `read`, `write` and `destructive`.
+
+### Upgrade from v0.16.0
+
+- Nothing to do.
+
 ## v0.16.0 (2026-10-27)
 
 ### Changed

package/README.md

@@ -1,6 +1,6 @@
 # @duyquangnvx/agent-cli
 
-The Runtime for Agent CLIs: command-line tools whose main caller is an LLM coding agent. You declare Commands with Zod schemas. The Runtime does the parsing, help (as text and as `--help --json`), output, errors with hints, exit codes, `--dry-run` and `--confirm`, pagination, Ctrl-C and deadlines, and the built-in `doctor` and `update`.
+The Runtime for Agent CLIs: command-line tools whose main caller is an LLM coding agent. You declare Commands with Zod schemas. The Runtime does the parsing, help (as text and as `--help --json`), output, errors with hints and Next steps, per-Command error codes and Secrets, exit codes, `--dry-run` and `--confirm`, pagination, Ctrl-C and deadlines, and the built-in `doctor` and `update`.
 
 An Agent CLI bundles the Runtime, so install it as a devDependency next to `zod`. The fastest start is the Scaffolder:
 
@@ -8,4 +8,4 @@ An Agent CLI bundles the Runtime, so install it as a devDependency next to `zod`
 pnpm create @duyquangnvx/agent-cli <name> --description "One line saying what it does"
 ```
 
-See the [repository](https://github.com/duyquangnvx/cli-for-agent) for an overview and the [agent-cli skill](https://github.com/duyquangnvx/cli-for-agent/blob/main/skills/agent-cli/SKILL.md) for the full guide.
+The full guide ships in this package, under `docs/`: once the Runtime is installed, a Coding agent reads `node_modules/@duyquangnvx/agent-cli/docs/README.md`, which always describes the installed version. A scaffolded CLI's `AGENTS.md` already points there; in a repo created another way, append [`agents-section.md`](agents-section.md) to `AGENTS.md`. The [repository](https://github.com/duyquangnvx/cli-for-agent) has an overview.

package/agents-section.md

@@ -0,0 +1,5 @@
+<!-- BEGIN:@duyquangnvx/agent-cli -->
+## agent-cli
+
+This CLI is built on `@duyquangnvx/agent-cli`, the Runtime. Before you change a Command, a `doctor` row, a test or the release, read `node_modules/@duyquangnvx/agent-cli/docs/README.md` and the pages it names: they describe the installed version, which your training data likely predates.
+<!-- END:@duyquangnvx/agent-cli -->

package/dist/agent-cli.d.ts

@@ -1,17 +1,75 @@
-import { type Cli, type CommandTreeCli, type DefineCommand, type NoPorts, type SingleCommandCli } from "./define.js";
-type PortsFactory<Ports> = NoPorts extends Ports ? {
-    readonly ports?: CommandTreeCli<Ports>["ports"];
-} : {
-    readonly ports: NonNullable<CommandTreeCli<Ports>["ports"]>;
+import { type Cli, type CommandTreeCli, type NoPorts, type SingleCommandCli } from "./define.js";
+import { type DefineCommand } from "./define-command.js";
+import { type CliErrorInit, type ErrorTable } from "./error-table.js";
+import type { CliError } from "./errors.js";
+type BoundField = "ports" | "project" | "errors";
+type ManifestField = "name" | "version" | "description" | "engines" | "install";
+/** The fields of the CLI's `package.json` that `defineCli` reads. */
+export interface CliManifest {
+    readonly name: string;
+    readonly version: string;
+    /** One line saying what the CLI does, shown under the first line of its help and in help JSON. */
+    readonly description: string;
+    /** Its only key names the CLI; otherwise the unscoped package name does. */
+    readonly bin?: string | Readonly<Record<string, string>> | undefined;
+    /** `doctor` checks `node` when it is `>=X[.Y[.Z]]`. */
+    readonly engines?: {
+        readonly node?: string;
+    } | undefined;
+    readonly publishConfig?: {
+        readonly registry?: string;
+    } | undefined;
+}
+export type InstallDeclaration = "global" | "dependency" | {
+    readonly mode: "dependency";
+    readonly lockstep: readonly string[];
+};
+interface FromManifest {
+    /**
+     * The CLI's `package.json`, imported `with { type: "json" }`: it gives the CLI's name, version,
+     * description and, for a CLI with several Commands, the `engines` that `doctor` checks.
+     */
+    readonly manifest: CliManifest;
+}
+type Unbound = {
+    readonly [Field in BoundField]?: never;
 };
-type CliDeclaration<Ports, Settings> = (Omit<CommandTreeCli<Ports, Settings>, "ports"> & PortsFactory<Ports>) | (Omit<SingleCommandCli<Ports, Settings>, "ports"> & PortsFactory<Ports>);
-export interface AgentCli<Ports, Settings> {
-    readonly defineCommand: DefineCommand<Ports, Settings>;
+/** What `defineCli` takes for a CLI whose Commands are reached by name. */
+interface CommandTreeCliDeclaration<Ports, Settings> extends Omit<CommandTreeCli<Ports, Settings>, BoundField | ManifestField>, FromManifest, Unbound {
+    /**
+     * How the CLI is installed, its package being `manifest.name`: `"global"` once per machine from
+     * `manifest.publishConfig.registry`, `"dependency"` per project, with `lockstep` naming packages
+     * released at the same version. Absent for a CLI that is not published.
+     */
+    readonly install?: InstallDeclaration;
+}
+/** What `defineCli` takes for a CLI that is one Command. */
+interface SingleCommandCliDeclaration<Ports, Settings> extends Omit<SingleCommandCli<Ports, Settings>, BoundField | ManifestField>, FromManifest, Unbound {
+    readonly install?: never;
+}
+/**
+ * What `defineCli` takes: a Cli without what `agentCli` holds (`ports`, `project`, `errors`) or what
+ * the `manifest` gives.
+ */
+export type CliDeclaration<Ports, Settings> = CommandTreeCliDeclaration<Ports, Settings> | SingleCommandCliDeclaration<Ports, Settings>;
+/** What `agentCli` takes once, so that every Command and the CLI are typed by it. */
+export interface AgentCliValues<Ports, Settings, Table extends ErrorTable> extends Pick<CommandTreeCli<Ports, Settings>, BoundField> {
+    readonly errors?: Table;
+}
+export interface AgentCli<Ports, Settings, Table extends ErrorTable> {
+    readonly defineCommand: DefineCommand<Ports, Settings, Table>;
     defineCli(cli: CliDeclaration<Ports, Settings>): Cli<Ports, Settings>;
+    /**
+     * A `CliError` for a code of the Error table, whose `details` must match the code's schema.
+     * `next` lists the Next steps in order, each the words after the CLI's name or `ctx.rerun()`; the
+     * `hint` says whether and when to run them. `retryAt` (ISO 8601) is allowed only on a wait-class
+     * code.
+     */
+    cliError<Code extends keyof Table & string>(code: Code, init: CliErrorInit<Table[Code]>, options?: ErrorOptions): CliError;
 }
 /**
- * Declares the CLI's ports and its Project file's settings once; the `defineCommand` and
- * `defineCli` it returns type `ctx.ports` and `ctx.project`.
+ * Takes the CLI's ports factory, Project file and Error table once; the `defineCommand`,
+ * `defineCli` and `cliError` it returns are typed by them.
  */
-export declare function agentCli<Ports = NoPorts, Settings = unknown>(): AgentCli<Ports, Settings>;
+export declare function agentCli<Ports = NoPorts, Settings = unknown, const Table extends ErrorTable = Record<never, never>>(values?: AgentCliValues<Ports, Settings, Table>): AgentCli<Ports, Settings, Table>;
 export {};

package/dist/agent-cli.js

@@ -1,34 +1,93 @@
 import { builtInCommands } from "./built-ins/commands.js";
 import { installOf } from "./built-ins/install/install.js";
 import { skillOf } from "./built-ins/skill/skill.js";
-import { defineCommandFor, } from "./define.js";
+import { commandLabel } from "./command-spec.js";
+import { isCommand, } from "./define.js";
+import { checkCommand, defineCommandFor } from "./define-command.js";
+import { cliErrorOf, errorTableOf } from "./error-table.js";
 import { runtimeCodesIn } from "./exit-classes.js";
-function checkOwnCodes(cli) {
-    const redeclared = runtimeCodesIn(cli.errors ?? {});
+function checkOwnCodes(errors) {
+    const redeclared = runtimeCodesIn(errors);
     if (redeclared.length > 0) {
-        throw new Error(`${cli.name} declares ${redeclared.join(", ")}, an error code the Runtime already declares`);
+        throw new Error(`The Error table declares ${redeclared.join(", ")}, an error code the Runtime already declares`);
     }
 }
-function defineCli(cli) {
-    checkOwnCodes(cli);
+function checkTree(commands, path, table) {
+    for (const [key, node] of Object.entries(commands)) {
+        const at = [...path, key];
+        if (isCommand(node))
+            checkCommand(node, at.join(" "), table);
+        else
+            checkTree(node, at, table);
+    }
+}
+function checkSkillPage({ name, skill }) {
+    if (skill === undefined || !("page" in skill))
+        return;
+    if (!URL.canParse(skill.page) || new URL(skill.page).protocol !== "https:") {
+        throw new Error(`${name} declares skill.page ${skill.page}, which is not an https URL`);
+    }
+}
+function checkCli(cli) {
+    const table = errorTableOf(cli);
+    checkSkillPage(cli);
     if (cli.commands === undefined) {
+        checkCommand(cli.command, commandLabel([], cli.name).join(" "), table);
         if (skillOf(cli, installOf(cli)).kind === "packaged") {
             throw new Error(`${cli.name} declares a Packaged skill, which only a CLI with several Commands can install`);
         }
         return cli;
     }
     const { commands } = cli;
+    checkTree(commands, [], table);
     const taken = Object.keys(builtInCommands(cli, { bin: undefined, node: undefined })).filter((name) => commands[name] !== undefined);
     if (taken.length > 0) {
         throw new Error(`${cli.name} defines ${taken.join(", ")}, a built-in Command it cannot replace`);
     }
     return cli;
 }
+function nameOf({ name, bin }) {
+    const bins = typeof bin === "object" ? Object.keys(bin) : [];
+    const [only] = bins;
+    return bins.length === 1 && only !== undefined ? only : name.replace(/^@[^/]+\//, "");
+}
+function installFrom(name, manifest, install) {
+    if (install === "dependency")
+        return { mode: "dependency", package: manifest.name };
+    if (install !== "global") {
+        return { mode: "dependency", package: manifest.name, lockstep: install.lockstep };
+    }
+    const registry = manifest.publishConfig?.registry;
+    if (registry === undefined) {
+        throw new Error(`${name} declares a Global install, which needs publishConfig.registry in its package.json`);
+    }
+    return { mode: "global", package: manifest.name, registry };
+}
+function resolved(cli) {
+    const { manifest, ...declared } = cli;
+    const name = nameOf(manifest);
+    const about = { name, version: manifest.version, description: manifest.description };
+    if (declared.commands === undefined)
+        return { ...declared, ...about };
+    const { install, ...rest } = declared;
+    return {
+        ...rest,
+        ...about,
+        ...(manifest.engines === undefined ? {} : { engines: manifest.engines }),
+        ...(install === undefined ? {} : { install: installFrom(name, manifest, install) }),
+    };
+}
 /**
- * Declares the CLI's ports and its Project file's settings once; the `defineCommand` and
- * `defineCli` it returns type `ctx.ports` and `ctx.project`.
+ * Takes the CLI's ports factory, Project file and Error table once; the `defineCommand`,
+ * `defineCli` and `cliError` it returns are typed by them.
  */
-export function agentCli() {
-    return { defineCommand: defineCommandFor(), defineCli };
+export function agentCli(values = {}) {
+    checkOwnCodes(errorTableOf(values));
+    return {
+        defineCommand: defineCommandFor(),
+        // The declaration's type has no bound fields, so spreading the values completes a Cli.
+        defineCli: (cli) => checkCli({ ...resolved(cli), ...values }),
+        cliError: cliErrorOf,
+    };
 }
 //# sourceMappingURL=agent-cli.js.map

package/dist/agent-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-cli.js","sourceRoot":"","sources":["../src/agent-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAIL,gBAAgB,GAGjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAgBnD,SAAS,aAAa,CAAkB,GAAyB;IAC/D,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,CAAC,IAAI,aAAa,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,8CAA8C,CAC5F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAkB,GAAyB;IAC3D,aAAa,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,CAAC,IAAI,gFAAgF,CAC5F,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM,CACzF,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,SAAS,CACvC,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,CAAC,IAAI,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wCAAwC,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAmB,EAAE,SAAS,EAAE,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"agent-cli.js","sourceRoot":"","sources":["../src/agent-cli.ts"],"names":[],"mappings":"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"}

package/dist/built-ins/agents-md.d.ts

@@ -1,18 +1,18 @@
 import type { DoctorCheck } from "../define.js";
 import type { Install } from "./install/install.js";
-export interface AgentsBlock {
+export interface AgentsSection {
     readonly name: string;
     readonly text: string;
 }
-export type BlockChange = "create" | "add" | "rewrite";
-/** The CLI's block in the project root's AGENTS.md, and what `skill install` would do to it. */
+export type SectionChange = "create" | "add" | "rewrite";
+/** The CLI's Agents section in the project root's AGENTS.md, and what `skill install` would do to it. */
 export interface AgentsMd {
     readonly path: string;
-    readonly agents: AgentsBlock;
-    readonly change: BlockChange | null;
+    readonly agents: AgentsSection;
+    readonly change: SectionChange | null;
 }
-/** `text` with the CLI's block between its markers, appended when they are missing; nothing else changes. */
-export declare function withBlock({ name, text: block }: AgentsBlock, text: string): string;
-export declare function agentsMdAt(agents: AgentsBlock, root: string): Promise<AgentsMd>;
+/** `text` with the CLI's Agents section between its markers, appended when they are missing; nothing else changes. */
+export declare function withSection({ name, text: section }: AgentsSection, text: string): string;
+export declare function agentsMdAt(agents: AgentsSection, root: string): Promise<AgentsMd>;
 export declare function handEditsAt(root: string): Promise<string[]>;
-export declare function agentsRow(agents: AgentsBlock, install: Install): DoctorCheck;
+export declare function agentsRow(agents: AgentsSection, install: Install): DoctorCheck;

package/dist/built-ins/agents-md.js

@@ -1,14 +1,14 @@
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { orMissing } from "../errors.js";
-import { projectRootOf } from "../project-root.js";
+import { projectRootOf } from "./project-root.js";
 function markersOf(name) {
     return { begin: `<!-- BEGIN:${name} -->`, end: `<!-- END:${name} -->` };
 }
-/** `text` with the CLI's block between its markers, appended when they are missing; nothing else changes. */
-export function withBlock({ name, text: block }, text) {
+/** `text` with the CLI's Agents section between its markers, appended when they are missing; nothing else changes. */
+export function withSection({ name, text: section }, text) {
     const { begin, end } = markersOf(name);
-    const whole = `${begin}\n${block}\n${end}`;
+    const whole = `${begin}\n${section}\n${end}`;
     const start = text.indexOf(begin);
     const stop = start === -1 ? -1 : text.indexOf(end, start);
     if (stop !== -1)
@@ -22,7 +22,7 @@ export async function agentsMdAt(agents, root) {
     const existing = await orMissing(readFile(path, "utf8"));
     if (existing === undefined)
         return { path, agents, change: "create" };
-    if (withBlock(agents, existing) === existing)
+    if (withSection(agents, existing) === existing)
         return { path, agents, change: null };
     return {
         path,
@@ -52,18 +52,18 @@ export function agentsRow(agents, install) {
             if (change === "rewrite") {
                 return {
                     state: "problem",
-                    message: `${path} holds a ${name} block other than the one ${fix} writes`,
+                    message: `${path} holds a ${name} Agents section other than the one ${fix} writes`,
                     fix,
                 };
             }
             if (change !== null) {
                 return {
                     state: "problem",
-                    message: `${path} holds no ${name} block, so sessions in this repo do not know ${name}`,
+                    message: `${path} holds no ${name} Agents section, so sessions in this repo do not know ${name}`,
                     fix,
                 };
             }
-            const holds = `${path} holds the ${name} block`;
+            const holds = `${path} holds the ${name} Agents section`;
             const [edit] = await handEditsAt(root);
             return edit === undefined
                 ? { state: "ok", message: holds }

package/dist/built-ins/agents-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../../src/built-ins/agents-md.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../../src/built-ins/agents-md.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAqBlD,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,EAAE,KAAK,EAAE,cAAc,IAAI,MAAM,EAAE,GAAG,EAAE,YAAY,IAAI,MAAM,EAAE,CAAC;AAC1E,CAAC;AAED,sHAAsH;AACtH,MAAM,UAAU,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAiB,EAAE,IAAY;IAC9E,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,GAAG,KAAK,KAAK,OAAO,KAAK,GAAG,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1D,IAAI,IAAI,KAAK,CAAC,CAAC;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;IAC1F,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACrC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAqB,EAAE,IAAY;IAClE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACtE,IAAI,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACtF,OAAO;QACL,IAAI;QACJ,MAAM;QACN,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;KAC5E,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,YAAY,CAAC,EAAE,CAAC;QAC3F,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,gCAAgC,QAAQ,kCAAkC,CAAC,CAAC;AACtF,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,SAAS,CAAC,MAAqB,EAAE,OAAgB;IAC/D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACxB,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,KAAK,EAAE,GAAY,EAAE,EAAE;YAC1B,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACxD,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,KAAK,gBAAgB,CAAC;YAC7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO;oBACL,KAAK,EAAE,SAAS;oBAChB,OAAO,EAAE,GAAG,IAAI,YAAY,IAAI,sCAAsC,GAAG,SAAS;oBAClF,GAAG;iBACJ,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO;oBACL,KAAK,EAAE,SAAS;oBAChB,OAAO,EAAE,GAAG,IAAI,aAAa,IAAI,yDAAyD,IAAI,EAAE;oBAChG,GAAG;iBACJ,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,GAAG,IAAI,cAAc,IAAI,iBAAiB,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YACvC,OAAO,IAAI,KAAK,SAAS;gBACvB,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;gBACjC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK,KAAK,IAAI,EAAE,EAAE,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/built-ins/doctor-rows.js

@@ -1,7 +1,8 @@
 import { join } from "node:path";
+import { projectOf } from "../context/project.js";
+import { secretRows } from "../context/secrets.js";
+import { toolRows } from "../context/tools.js";
 import { CliError, messageOf } from "../errors.js";
-import { projectOf } from "../project.js";
-import { toolRows } from "../tools.js";
 import { versionLine } from "../version.js";
 import { installOf } from "./install/install.js";
 import { latestVersion } from "./npm.js";
@@ -57,7 +58,7 @@ export function readProject(projectFile, ctx) {
             ok: true,
             project: projectOf(projectFile, ctx.cwd, {
                 fileError: ctx.fileError,
-                callerLine: ctx.commandLine(),
+                rerun: ctx.rerun(),
             }),
         };
     }
@@ -114,6 +115,7 @@ export function doctorChecks(cli, launch, read) {
         ...(cli.project === undefined ? [] : [projectRow(cli.project, read)]),
         ...(cli.doctor ?? []),
         ...toolRows(cli.tools ?? [], cli.commands),
+        ...secretRows(cli.secrets ?? [], cli.commands),
         installRow(check),
         registryRow(cli, check),
         ...skillOf(cli, install).rows,

package/dist/built-ins/doctor-rows.js.map

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

package/dist/built-ins/doctor.d.ts

@@ -1,4 +1,4 @@
-import { type Command, type CommandTreeCli } from "../define.js";
+import type { Command, CommandTreeCli } from "../define.js";
 import type { Launch } from "./commands.js";
 export declare const DOCTOR_PROBLEMS = "DOCTOR_PROBLEMS";
 /** The built-in `doctor`: the fixed rows around the CLI's own, each under its own deadline. */

package/dist/built-ins/doctor.js

@@ -1,9 +1,9 @@
 import * as z from "zod";
 import { untilAborted } from "../abort.js";
-import { defineCommand, } from "../define.js";
-import { CliError } from "../errors.js";
+import { defineCommand } from "../define-command.js";
+import { runtimeError } from "../errors.js";
+import { wholeLine } from "../next-step.js";
 import { doctorChecks, problemOfError, readProject } from "./doctor-rows.js";
-import { runAsOf } from "./install/run-as.js";
 import { packagedSkillDetailsSchema } from "./skill/packaged.js";
 export const DOCTOR_PROBLEMS = "DOCTOR_PROBLEMS";
 const DEFAULT_DEADLINE_MS = 10_000;
@@ -79,27 +79,28 @@ function render({ rows, next }, style) {
     return [...lines, ...next.map((fix) => `${"next".padEnd(width)}${fix}`)].join("\n");
 }
 // One error per problem row, so the exit follows the class that must act first (ADR 0005).
-function failure(cliName, callerLine, problems) {
-    const errors = problems.map(({ check, message, fix, code }) => new CliError({
-        code: code ?? DOCTOR_PROBLEMS,
-        message: `${cliName} doctor found a problem in ${check}: ${message}`,
-        hint: fix === undefined
-            ? "the row says what is wrong"
-            : `run \`${fix}\`, then run \`${callerLine}\` again`,
-    }));
+function failure(cliName, rerun, problems) {
+    const errors = problems.map(({ check, message, fix, code }) => {
+        const head = {
+            code: code ?? DOCTOR_PROBLEMS,
+            message: `${cliName} doctor found a problem in ${check}: ${message}`,
+        };
+        return runtimeError(fix === undefined
+            ? { ...head, hint: "the row says what is wrong", next: [] }
+            : { ...head, hint: "run the Next steps in order", next: [wholeLine(fix), rerun] });
+    });
     return new AggregateError(errors);
 }
 /** The built-in `doctor`: the fixed rows around the CLI's own, each under its own deadline. */
 export function doctorCommand(cli, launch) {
     return defineCommand({
-        name: "doctor",
         description: "check the setup and say what fixes each problem",
         examples: [
             {
-                command: `${runAsOf(cli)} doctor`,
+                command: `${cli.name} doctor`,
                 note: "check the setup and list the commands that fix it",
             },
-            { command: `${runAsOf(cli)} doctor --json`, note: "get the rows and fixes as data" },
+            { command: `${cli.name} doctor --json`, note: "get the rows and fixes as data" },
         ],
         effect: "read",
         output: reportSchema,
@@ -118,7 +119,7 @@ export function doctorCommand(cli, launch) {
                 .map(({ row }) => row);
             if (problems.length > 0) {
                 ctx.deliver(report);
-                throw failure(cli.name, ctx.commandLine(), problems);
+                throw failure(cli.name, ctx.rerun(), problems);
             }
             return report;
         },

package/dist/built-ins/doctor.js.map

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

package/dist/built-ins/install/dependency.js

@@ -2,8 +2,8 @@ import { readFile, realpath } from "node:fs/promises";
 import { join, sep } from "node:path";
 import * as z from "zod";
 import { messageOf, orMissing } from "../../errors.js";
-import { ancestorsOf, exists, isInside, lockfileRootOf, manifestIn, } from "../../project-root.js";
 import { npmContext, scopeOf } from "../npm.js";
+import { ancestorsOf, exists, isInside, lockfileRootOf, manifestIn, } from "../project-root.js";
 import { runAsOf } from "./run-as.js";
 // Both upgrades keep a devDependency under devDependencies (npm 12.2, pnpm 12.14). pnpm keeps the pin's style; npm writes the range its save-exact config asks for.
 const LINES = {