@duyquangnvx/agent-cli 0.23.0 → 0.24.0

package/docs/guides/doctor.md

@@ -42,11 +42,10 @@ The Runtime's `secrets` row checks every Secret the CLI and its Commands declare
 
 The `install` and `registry` rows follow `defineCli({ install })`, and are `skipped` without it. Both are advisory: a project may stay on an older release on purpose.
 
-- **Global install:** `install` checks that the CLI runs from npm's global folder, else gives the global install line; `registry` compares the build with the registry's latest and gives `<cli> update`.
+- **Global install:** `install` checks that the CLI runs from npm's global folder, else gives the `setup` line; `registry` compares the build with the registry's latest and gives `<cli> update`.
 - **Dependency install:** `install` checks that the copy that runs is the one the project at the working directory installed. It is `skipped` with `registry` when the CLI runs from source or the project links the package from its workspace, which decides its version. Otherwise another copy than the project's gets `<run-as> doctor`, which runs the project's copy; a project that has not installed the package gets its install line (`pnpm install`, `npm install`) when a `package.json` at or above the working directory lists it, else its add line, and a copy whose `package.json` is unreadable gets the install line too; yarn and bun get no line. With no copy installed, npx refuses before the CLI starts, so these fixes reach only a CLI run from another copy. `registry` compares the build with the latest release npm finds from the project root and gives `pnpm up --latest …` or `npm install …@latest`, naming the `lockstep` packages; for yarn and bun it names the version to move to instead.
 
 The `skill` row follows `defineCli({ skill })` ([`shipping.md`](shipping.md)):
 
-- **Skill Hub, `{ source }`:** the row is always ok and names every installed copy against the running CLI; its fix installs the skill from the hub. Without `skill` it gives `skills update` for an older copy and nothing to install a missing one.
-- **Skill Hub, `{ add }`:** as for `{ source }`, but the fix gives the declared line verbatim; what each copy gets is in the `skill` JSDoc of `defineCli`.
-- **Packaged skill, `{ packaged }`:** the row is advisory, and the Runtime also gives a Notice of its problem and, when it declares `agents`, an `agents` row; what each reports is in the `skill` JSDoc of `defineCli`. Do not check the Skill copy or the Agents section in your own rows or Notices.
+- **No `skill`:** the row is skipped.
+- **Declared:** the row is advisory, and looks for the copy where the Install puts it; a CLI that declares `agents` also has an `agents` row. What each reports is in the `skill` JSDoc of `defineCli`. Do not check the Skill copy or the Agents section in your own rows or Notices.

package/docs/guides/errors.md

@@ -41,6 +41,8 @@ throw ctx.fail(
 
 The exit code is the failure's Exit class: 1 the caller, 2 the operator, 3 someone at the source, 75 nobody but time (wait, then run again), 70 a bug, 130 or 143 an interrupt by SIGINT or SIGTERM. A `UsageError` exits 1, for input your schemas could not reject: give it the code `INVALID_INPUT`.
 
+When only the person can act, such as opening an approval link, say in the hint that they see only the agent's reply, not command output, so the agent writes the link or code in its reply first, then runs the Next step that waits. Told only to relay it, weaker models ran the wait without writing the link.
+
 A code missing from the table, and anything else thrown, is a bug, exit 70, unless it wraps a missed deadline (Wrapping a failure in [`long-runs.md`](long-runs.md)). Its hint says to rerun under `<NAME>_DEBUG=1` for the stack trace and its `cause` chain, and to report it at package.json's `bugs` when declared.
 
 Every Runtime code is on the exported `runtimeCodes`, such as `runtimeCodes.OUTPUT_EXISTS` or `runtimeCodes.TOOL_FAILED`: catch, return and assert codes through it. A Command throws a Runtime code only where it means what the Runtime means by it: `INVALID_INPUT`, a file code from `ctx.fileError`, `TOOL_MISSING` or `TOOL_FAILED`. The others, such as `UNKNOWN_COMMAND` or `DOCTOR_PROBLEMS`, name the Runtime's own checks, so a Command only catches or asserts them.

package/docs/guides/shipping.md

@@ -1,35 +1,41 @@
 # Shipping: install, the skill beside the CLI, release
 
-The Scaffolder writes the release setup: `install` in `defineCli`, `publishConfig.registry` in `package.json`, `CHANGELOG.md` with its format in its first paragraph, `scripts/release.ts`, and the CLI skill at `skills/<name>/SKILL.md` with its setup reference. These are the decisions it leaves to you.
+The Scaffolder writes the release setup: `install` in `defineCli`, `publishConfig.registry` in `package.json`, `CHANGELOG.md` with its format in its first paragraph, `scripts/release.ts`, the CLI skill at `skills/<name>/SKILL.md`, and the CLI docs in `docs/cli/`, starting with `README.md` and `setup.md`. These are the decisions it leaves to you.
 
 ## How a user installs it
 
-`defineCli({ skill })` names where the CLI's skill comes from, and with it the `skill` row's fix:
+Every CLI ships one kind of skill: a trigger that holds what stays true across releases, its description, the install line, and the injected `--version`, whose `docs <path>` line names the CLI docs. So updating the CLI needs no skill update. `defineCli({ docs: "docs/cli" })` declares that folder, which `package.json` `files` lists, so a repo's developer docs under `docs/` stay out of the package.
 
-- `{ source: "<git URL>" }`, a git Skill Hub: the skill arrives apart from the CLI and lives in the user's home, one copy for every project. The Scaffolder's `--skill-hub-git` sets it.
-- `{ add: "<command line>" }`, a Skill Hub whose install line the Runtime cannot build, such as an API Skill Hub that gives each user their own install URL: as for `{ source }`, but `doctor` gives that line verbatim. The Scaffolder's `--skill-hub-api` with `--skill-add` sets it.
-- `{ packaged: "skills/<name>" }`, a Packaged skill: the skill ships inside the CLI's package, so the copy always matches the CLI that installed it. It needs a CLI with several Commands, and leaves the name `skill` to the Runtime. The Scaffolder's `--dependency` sets it.
+`defineCli({ skill: { folder: "skills/<name>" } })` declares that skill, which ships in the package, so list `skills` in `package.json` `files`: publishing the package publishes it. It needs a CLI with several Commands, since only those have Built-in Commands. The Install decides where its Skill copy goes.
 
-### From a Skill Hub
+### With a Global install
 
-The CLI comes from the registry and its skill from a Skill Hub, so they arrive apart; the skill names the version it describes in `metadata.version`, which each release stamps, and `doctor`'s `skill` row compares every installed copy with the running CLI. The README gives both lines, the skill first, since the agent that loads it can then install the CLI: the skill's `references/setup.md` walks it through installing, checking and updating. The install line is the one fact the skill holds as text, since nothing runs before the CLI is installed. The Scaffolder writes it into the setup reference and the README, and the new CLI's `test/cli.test.ts` fails when either differs from what `doctor` gives as the `install` row's fix, or the README's skill line from the `skill` row's fix. Add to the setup reference what only your CLI needs before its first run, such as a sign-in, a key or a trial run.
+Hand users one sentence to paste to their Coding agent, holding the line and their task, which the Scaffolder writes first in the README:
 
-- Each release puts the skill on the Skill Hub named as `skillHub` in `scripts/release.ts`: `{ git }`, the same git URL as `skill.source`, which it commits to, or `{ api }`, which it publishes to with the token in `SKILL_HUB_TOKEN`. `main` of the CLI's own repo may describe what is still unreleased.
-- `{ add }` is declared beside `skillHub: { api }`, never derived from it: a hub's install routes are its own.
-- A Coding agent's sandbox denies writes to the skills folders and to the global npm prefix, so the user types both lines, with `!` in Claude Code. `-y` is npx's own: with no terminal to answer on, npx cancels its download question.
-- Nothing prints at install or first run: package managers block install scripts, and a first-run line is noise on an agent's stderr.
+> Run `npx -y <package>@latest setup`, then use `<name>` to `<task>`.
 
-### A Packaged skill
+The task is what carries the agent past the install; without it, the agent stops there ([ADR 0016](https://github.com/duyquangnvx/cli-for-agent/blob/main/docs/adr/0016-a-cli-installs-itself-and-its-skill-from-one-setup.md)). The Built-in `setup` runs from npx's copy, installs the latest release, copies the skill to `~/.claude/skills/<name>` and `~/.agents/skills/<name>`, and names the CLI docs, so the session goes on even when the new skill has not loaded. It takes no sign-in: the first Command that needs one asks for it.
 
-Choose it when projects pin different versions of the CLI, as with a Dependency install: each project then loads the skill of the version it pins, where one Skill Hub copy in home serves every project, which suits a Global install's one copy per machine.
+- The line is what `setupLineOf` builds, with the registry's flag when the Install registry is not npmjs. The scaffolded `test/cli.test.ts` fails when the skill, the README or `docs/cli/setup.md` lack it, which it reads from `doctor`'s `install` row.
+- `setup` is safe to run again. A Next step on its failure is the same line, since the CLI's own name may not run yet. A Coding agent's sandbox denies writes to the skills folders and the global npm prefix, so its user types that line, with `!` in Claude Code. `-y` is npx's own: with no terminal to answer on, npx cancels its download question.
+- `setup` fails with `NOT_ON_PATH` when the global bin folder is off this shell's `PATH`, once the CLI and the skill are in place. It refuses an `npm link` at the global location.
+- `update` makes the copies match the release it leaves installed, so a release that changes the skill asks nothing of its users.
+- A Global install declares no `agents`: it has no repo to write to.
+- `skill` and `skillHub` in `scripts/release.ts` stay optional: a Skill Hub helps people find the skill, and no install needs one. `{ git }` commits to a repo and `{ api }` publishes with the token in `SKILL_HUB_TOKEN`. A skill the Hub already holds skips the Hub, and a skill stating `metadata.version` is refused.
 
-The CLI comes first, then its Built-in `skill install` copies the skill into the project, so the README gives the CLI's install line, then `<run-as> skill install`, the `skill` row's fix, which the user types with `!` in Claude Code. List `skills` in `package.json` `files`: publishing the package publishes the skill, and each release stamps its `metadata.version` as for a hub. What `skill install` copies, refreshes and writes is in the `skill` JSDoc of `defineCli`.
+### With a Dependency install
+
+The project carries the skill, so the repo's sessions load it without anyone installing it elsewhere. The CLI comes first, then its Built-in `skill install` copies the skill into the project, so the README gives the CLI's install line, then `<run-as> skill install`, the `skill` row's fix, which the user types with `!` in Claude Code. A release that changes the skill lists `<run-as> skill install` under `### Upgrade from`. What `skill install` copies and writes is in the `skill` JSDoc of `defineCli`.
+
+### Reading the CLI docs
+
+The skill's `allowed-tools`, `Read(//**/node_modules/<package>/docs/cli/**)`, covers the turn that loads it. After that a read outside the working directory depends on the Coding agent: Claude Code asks in its default mode, and passes it in auto mode. No CLI writes settings.
 
 ## Global or Dependency install
 
-The Scaffolder declares a Global install, `install: "global"`: one copy per machine, which the Built-in `update` replaces with the latest release. Choose a Dependency install, `install: "dependency"`, or `{ mode: "dependency", lockstep }` with lockstep packages, when each project pins the CLI's version as a devDependency, as a CLI does when it shapes the project's own files. Either way the package is `manifest.name`, from the `package.json` given to `defineCli` as `manifest`, and a Global install's Install registry is its `publishConfig.registry`, without which `defineCli` throws. When users install from a mirror of the registry releases publish to, such as a public proxy of one behind a VPN, declare `{ mode: "global", registry }` with the mirror's URL; `publishConfig.registry` then serves only the release. The Scaffolder's `--dependency` starts one: `install: "dependency"` with a Packaged skill, every line it writes starting with the run-as, and `publishConfig` and `scripts/release.ts` as for a Global install, since publishing is the same.
+The Scaffolder declares a Global install, `install: "global"`: one copy per machine, which the Built-in `setup` puts there and `update` replaces with the latest release. Choose a Dependency install, `install: "dependency"`, or `{ mode: "dependency", lockstep }` with lockstep packages, when each project pins the CLI's version as a devDependency, as a CLI does when it shapes the project's own files. Either way the package is `manifest.name`, from the `package.json` given to `defineCli` as `manifest`, and a Global install's Install registry is its `publishConfig.registry`, without which `defineCli` throws. When users install from a mirror of the registry releases publish to, such as a public proxy of one behind a VPN, declare `{ mode: "global", registry }` with the mirror's URL; `publishConfig.registry` then serves only the release. The Scaffolder's `--dependency` starts one: `install: "dependency"`, every line it writes starting with the run-as, and `publishConfig` and `scripts/release.ts` as for a Global install, since publishing is the same.
 
-A Global install of a CLI with several Commands runs a Release check: at most once a day, a run starts a detached `npm view` against the Install registry, and a later run gives a Notice such as ``tool 1.1.0 is out, this is 1.0.0; run `tool update` `` until `update` brings the CLI level. It only tells: an install it ran on its own would skip the release's Upgrade steps and leave the agent's loaded skill describing the old version. No run waits on the registry, and a failed check is retried the next day; `<NAME>_DEBUG=1` shows why it failed. It is off when `CI` is set, and for one CLI when the operator sets `<NAME>_NO_RELEASE_CHECK=1`; it writes its time and answer to `$XDG_CACHE_HOME/<name>/release-check.json`, by default under `~/.cache`.
+A Global install of a CLI with several Commands runs a Release check: at most once a day, a run starts a detached `npm view` against the Install registry, and a later run gives a Notice such as ``tool 1.1.0 is out, this is 1.0.0; run `tool update` `` until `update` brings the CLI level. It only tells: an install it ran on its own would skip the release's Upgrade steps. No run waits on the registry, and a failed check is retried the next day; `<NAME>_DEBUG=1` shows why it failed. It is off when `CI` is set, and for one CLI when the operator sets `<NAME>_NO_RELEASE_CHECK=1`; it writes its time and answer to `$XDG_CACHE_HOME/<name>/release-check.json`, by default under `~/.cache`.
 
 A Dependency install:
 
@@ -37,9 +43,9 @@ A Dependency install:
 - The Runtime adds no `update`: the project's package manager moves the version, so the name stays free for a Command of the CLI's own.
 - It declares no registry: `doctor` runs npm at the project root, the nearest folder with a lockfile, so the project's `.npmrc` names the registry and its token.
 - List under `lockstep` the packages released at the CLI's version, such as a kit its Commands write code against, so `doctor`'s fix moves them together.
-- Declare a Packaged skill, so the skill a project loads matches the version it pins.
-- The README and the setup reference give the project's add line, `pnpm add -D <package> <lockstep…>`, then `<run-as> skill install`. The scaffolded test compares the add line with `doctor`'s `install` fix, which that row gives only in a project that neither installs nor lists the CLI, so the test runs `doctor` from a temporary one.
-- With no copy installed, npx refuses before the CLI starts, so `doctor` cannot guide a fresh checkout: the setup reference says to run the project's install when a `package.json` lists the package, else the add line.
+- Declare a skill, so the repo carries a copy; the CLI docs match the version it pins, since they ship in the package.
+- The README and the skill give the project's add line, `pnpm add -D <package> <lockstep…>`, then `<run-as> skill install`. The scaffolded test compares the add line with `doctor`'s `install` fix, which that row gives only in a project that neither installs nor lists the CLI, so the test runs `doctor` from a temporary one.
+- With no copy installed, npx refuses before the CLI starts, so `doctor` cannot guide a fresh checkout: the skill says to run the project's install when a `package.json` lists the package, else the add line.
 
 ## Release
 
@@ -47,20 +53,22 @@ Log each change a caller would notice under `## Unreleased` in `CHANGELOG.md` as
 
 `update` shows the user each release between the version they leave and the one installed, oldest first. A CLI with local state, a daemon or an extension has releases that ask something of the user, such as a fetch after a store rebuild, and those steps get lost among the other entries. So a release that lists them under the `### Upgrade from` heading the CHANGELOG's first paragraph asks for shows only those steps, and nothing when they read `Nothing to do.`; a release without the heading shows its whole section.
 
-## The CLI's own skill
+## The CLI docs
+
+The skill's description says when to use the CLI and the nearby tasks it is not for, since the agent always sees it. Everything else about the work goes in the CLI docs, which have no required shape: an agent given the folder finds its way, so `README.md` is a help the Scaffolder starts, and each release checks only that the folder holds files.
 
-- **`--help` describes the tool; the skill describes the agent's work around it:** workflows naming Commands in order, and what to do for each error code that needs judgement beyond its hint. It names a flag only when a workflow needs one. When to use the CLI, and the nearby tasks it is not for, go in the description, which the agent always sees.
+- **`--help` describes the tool; the CLI docs describe the agent's work around it:** workflows naming Commands in order, and what to do for each error code that needs judgement beyond its hint. They name a flag only when a workflow needs one.
 - **A line earns its place only when nothing the agent will see says it**: not `--help`, a Command's output, an error's hint, or a `doctor` row. The Runtime's conventions, such as `--json`, `--dry-run`, the error format and the exit codes, show themselves on first use. Keep what costs the agent turns to work out: a convention of the source, the reason behind a step, a trap, a step that needs the user's consent.
 - **A guardrail on a flag goes in the workflow step that passes it**, read before the run rather than after it fails.
-- **Its Recovering from errors table holds only the codes whose right move goes beyond the hint**; the exit codes are in `--help`. The Runtime's own hints already cover a Coding agent's sandbox refusing the registry with a 403, the `<NAME>_DEBUG` variable of an `INTERNAL` error, and a Skill copy of another version naming input the CLI does not know, so those need no row. It stays in `SKILL.md`, not under `references/`: it matters when the agent believes the hint is enough, which is when a pointer to it would not fire.
-- **Check it with a fresh subagent** given only the skill's path and a real task. Cut a sentence for a failure whose hint already says what to do.
+- **List in a Recovering from errors table only the codes whose right move goes beyond the hint**; the exit codes are in `--help`. The Runtime's own hints already cover a Coding agent's sandbox refusing the registry with a 403 and the `<NAME>_DEBUG` variable of an `INTERNAL` error, so those need no row.
+- **Check them with a fresh subagent** given only the skill's path and a real task. Cut a sentence for a failure whose hint already says what to do.
 
 ## An Agents section
 
 A CLI owns one Agents section in the repo's `AGENTS.md`, between `<!-- BEGIN:<name> -->` and `<!-- END:<name> -->`, rewritten between its markers and leaving the rest as it was. Claude Code reads `AGENTS.md` only through an `@AGENTS.md` line in `CLAUDE.md`, so whatever writes the section names that line as a hand edit; no CLI edits `CLAUDE.md`.
 
 - The section holds what every session in the repo needs even when it never calls the CLI, such as how to name what the CLI later finds by name, plus a line saying when to load the CLI's skill; how to use the CLI is the skill's. Every session reads it, so keep it short.
-- A Packaged skill declares its text as `skill: { packaged, agents }`, and `skill install` writes it verbatim between the markers; without `agents` it writes no section. Otherwise a Command of the CLI's own writes the section.
+- A Dependency install's skill declares its text as `skill: { folder, agents }`, and `skill install` writes it verbatim between the markers; without `agents` it writes no section. Otherwise a Command of the CLI's own writes the section.
 
 ## What to build next
 

package/docs/principles.md

@@ -36,4 +36,4 @@ Files, programs, the environment, Secrets, the clock and remote services all rea
 
 ## The CLI keeps its own house
 
-`doctor` checks the build, the install, the registry, the tools, the Secrets and the skill, and gives the line that fixes each problem. `update` moves a Global install to the latest release. The CLI's skill describes the agent's work around the CLI, not its flags, and each release ships it beside the CLI ([`guides/shipping.md`](guides/shipping.md), [`guides/doctor.md`](guides/doctor.md)).
+`doctor` checks the build, the install, the registry, the tools, the Secrets and the skill, and gives the line that fixes each problem. `setup` puts a Global install and its skill on a machine, and `update` moves both to the latest release. The CLI's skill describes the agent's work around the CLI, not its flags, and each release ships it inside the package ([`guides/shipping.md`](guides/shipping.md), [`guides/doctor.md`](guides/doctor.md)).

package/docs/reference.md

@@ -19,6 +19,7 @@ The JSDoc in the package's `.d.ts` files is the API reference: every export and
 | `paginate`, `page`, `Page` | [`dist/list.d.ts`](../dist/list.d.ts) |
 | `NextStep`, `Rerun` | [`dist/next-step.d.ts`](../dist/next-step.d.ts) |
 | `runAsOf` | [`dist/built-ins/install/run-as.d.ts`](../dist/built-ins/install/run-as.d.ts) |
+| `setupLineOf` | [`dist/built-ins/install/global-npm.d.ts`](../dist/built-ins/install/global-npm.d.ts) |
 | `runCli`, `RunOptions`, `RunResult` | [`dist/run-cli.d.ts`](../dist/run-cli.d.ts), [`dist/run-options.d.ts`](../dist/run-options.d.ts) |
 | `runProcess`, the bin's entry | [`dist/run-process.d.ts`](../dist/run-process.d.ts) |
 | `Style`, for `render` | [`dist/style.d.ts`](../dist/style.d.ts) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duyquangnvx/agent-cli",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Runtime for agent-first command-line tools: owns parsing, output, errors and exit codes.",
   "type": "module",
   "engines": {

package/dist/built-ins/skill/hub.d.ts

@@ -1,8 +0,0 @@
-import type { Env } from "../../context.js";
-import type { HubSkillSource } from "../../define.js";
-import type { Skill, SkillCli } from "./skill.js";
-/** The version a SKILL.md's frontmatter `metadata.version` states. */
-export declare function skillVersionIn(skill: string): string | undefined;
-export declare function homeOf(env: Env): string;
-/** A skill on a Skill Hub, which `from` says how to install; without it, no line adds it. */
-export declare function hubSkill(cli: SkillCli, from: HubSkillSource | undefined): Skill;

package/dist/built-ins/skill/hub.js

@@ -1,114 +0,0 @@
-import { readFile, realpath } from "node:fs/promises";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { isMissingFile } from "../../errors.js";
-import { isVersion, standingOf } from "../semver.js";
-// Everything here mirrors how the skills@1.7.2 installer (`npx skills`) behaves.
-const SKILL_DIRS = [
-    [".claude", "skills"],
-    [".agents", "skills"],
-];
-const FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---/;
-const METADATA_VERSION = /^metadata:[ \t]*\r?\n(?:[ \t]+.*\r?\n)*?[ \t]+version:[ \t]*["']?([^"'\s]+)["']?[ \t]*$/m;
-/** The version a SKILL.md's frontmatter `metadata.version` states. */
-export function skillVersionIn(skill) {
-    const frontmatter = FRONTMATTER.exec(skill)?.[1];
-    return frontmatter === undefined ? undefined : METADATA_VERSION.exec(`${frontmatter}\n`)?.[1];
-}
-export function homeOf(env) {
-    return env.HOME ?? env.USERPROFILE ?? homedir();
-}
-async function copyAt(path, version) {
-    let skill;
-    try {
-        skill = await readFile(join(path, "SKILL.md"), "utf8");
-    }
-    catch (error) {
-        if (isMissingFile(error)) {
-            return undefined;
-        }
-        return { path, version: undefined, state: "unreadable" };
-    }
-    const stated = skillVersionIn(skill);
-    if (stated === undefined || !isVersion(stated) || !isVersion(version)) {
-        return { path, version: stated, state: "unversioned" };
-    }
-    return { path, version: stated, state: standingOf(stated, version) };
-}
-async function skillCopies(cliName, version, { cwd, env }) {
-    const roots = [cwd, homeOf(env)];
-    const paths = roots.flatMap((root) => SKILL_DIRS.map((dir) => join(root, ...dir, cliName)));
-    const seen = new Set();
-    const copies = [];
-    for (const path of paths) {
-        const copy = await copyAt(path, version);
-        // The project may be home itself, or one skill dir a link to the other.
-        const real = copy === undefined ? undefined : await realpath(path);
-        if (copy !== undefined && real !== undefined && !seen.has(real)) {
-            seen.add(real);
-            copies.push(copy);
-        }
-    }
-    return copies;
-}
-const has = (copies, wanted) => copies.some(({ state }) => state === wanted);
-// `--skill` installs only this CLI's skill from a repo that holds several.
-function addLineOf(cliName, from) {
-    return "add" in from ? from.add : `npx -y skills add ${from.source} --skill ${cliName} -g`;
-}
-// `skills update` skips a copy it did not install, which is how most unversioned copies got there.
-// A copy ahead gets no fix: doctor's registry row already says when the CLI itself is behind.
-function fixFor(cliName, copies, from) {
-    const update = `npx -y skills update ${cliName}`;
-    const add = from === undefined ? undefined : addLineOf(cliName, from);
-    if (copies.length === 0) {
-        return add;
-    }
-    if (has(copies, "unversioned") && add !== undefined) {
-        return has(copies, "behind") ? `${update} && ${add}` : add;
-    }
-    return has(copies, "behind") || has(copies, "unversioned") ? update : undefined;
-}
-const SKILL_STATE_NOTES = {
-    current: "the same as this build",
-    behind: "older than this build",
-    ahead: "newer than this build",
-    unversioned: "states no metadata.version",
-    unreadable: "could not be read",
-};
-function describeCopy({ path, version, state }) {
-    return `${path}${version === undefined ? "" : ` ${version}`} (${SKILL_STATE_NOTES[state]})`;
-}
-/** A skill on a Skill Hub, which `from` says how to install; without it, no line adds it. */
-export function hubSkill(cli, from) {
-    const findingOf = (copies) => {
-        const fix = fixFor(cli.name, copies, from);
-        const message = copies.length === 0
-            ? `no copy of the ${cli.name} skill is installed`
-            : copies.map(describeCopy).join("; ");
-        return fix === undefined ? { state: "ok", message } : { state: "ok", message, fix };
-    };
-    return {
-        kind: "hub",
-        builtIns: {},
-        rows: [
-            {
-                name: "skill",
-                advisory: true,
-                run: async (ctx) => findingOf(await skillCopies(cli.name, cli.version, ctx)),
-            },
-        ],
-        notice: async () => { },
-        differing: async (place) => (await skillCopies(cli.name, cli.version, place))
-            .filter(({ state }) => state !== "current" && state !== "unreadable")
-            .map(describeCopy),
-        // `update` compares the copies with the latest release even when it installed nothing: the
-        // installer gives that release's skill.
-        nextAt: async (version, ctx) => {
-            const copies = await skillCopies(cli.name, version, ctx);
-            const fix = fixFor(cli.name, copies, from);
-            return fix === undefined ? [] : [fix];
-        },
-    };
-}
-//# sourceMappingURL=hub.js.map

package/dist/built-ins/skill/hub.js.map

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

package/dist/built-ins/skill/packaged.d.ts

@@ -1,13 +0,0 @@
-import * as z from "zod";
-import type { PackagedSkillSource } from "../../define.js";
-import type { Install } from "../install/install.js";
-import type { Skill, SkillCli } from "./skill.js";
-/** What the `skill` row of a Packaged skill carries under `--json` beside its message. */
-export declare const packagedSkillDetailsSchema: z.ZodObject<{
-    copy: z.ZodString;
-    copyVersion: z.ZodNullable<z.ZodString>;
-    packageVersion: z.ZodNullable<z.ZodString>;
-    home: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-/** A skill shipped in the package at `packaged`, which `skill install` copies to the project root. */
-export declare function packagedSkill(cli: SkillCli, { packaged: folder, agents: text }: PackagedSkillSource, install: Install): Skill;

package/dist/built-ins/skill/packaged.js

@@ -1,97 +0,0 @@
-import { realpath } from "node:fs/promises";
-import { join } from "node:path";
-import * as z from "zod";
-import { errnoOf, messageOf, orMissing } from "../../errors.js";
-import { agentsRow } from "../agents-md.js";
-import { homeOf } from "./hub.js";
-import { skillCopyOf, skillInstallCommand, skillVersionsOf } from "./install-command.js";
-// A project that is home itself has its copy under home, which shadows nothing.
-async function personalCopyOf(name, copy, ctx) {
-    const home = join(homeOf(ctx.env), ".claude", "skills", name);
-    const real = await orMissing(realpath(home));
-    return real === undefined || real === (await orMissing(realpath(copy))) ? undefined : home;
-}
-/** What the `skill` row of a Packaged skill carries under `--json` beside its message. */
-export const packagedSkillDetailsSchema = z.object({
-    copy: z.string(),
-    copyVersion: z.string().nullable(),
-    packageVersion: z.string().nullable(),
-    /** A personal copy, which Claude Code prefers over the project's. */
-    home: z.string().optional(),
-});
-function versionLabel(version) {
-    return version ?? "(no metadata.version)";
-}
-function compared(name, { copy, copyVersion, packageVersion }, same) {
-    const stated = `${copy} ${versionLabel(copyVersion)}`;
-    return same
-        ? `${stated}, the version ${name} ships`
-        : `${stated} differs from the ${versionLabel(packageVersion)} that ${name} ships`;
-}
-/** The project root's copy against the package's, and any under home. */
-async function findingOf(cli, folder, install, ctx) {
-    const { copy } = await skillCopyOf(cli, ctx.cwd);
-    const versions = await skillVersionsOf(join(ctx.packageRoot, folder), copy);
-    const { packageVersion } = versions;
-    const copyVersion = versions.copyVersion ?? null;
-    const home = await personalCopyOf(cli.name, copy, ctx);
-    const skill = { copy, copyVersion, packageVersion, ...(home === undefined ? {} : { home }) };
-    const head = versions.copyVersion === undefined
-        ? `no copy of the ${cli.name} skill at ${copy}`
-        : compared(cli.name, skill, versions.same);
-    // Other projects may use the personal copy, so the row names it and gives no line removing it.
-    const message = home === undefined
-        ? head
-        : `${head}; remove ${home}: Claude Code prefers a personal skill over the project's`;
-    if (!versions.same) {
-        return { state: "problem", message, fix: `${install.runAs} skill install`, skill };
-    }
-    return home === undefined
-        ? { state: "ok", message, skill }
-        : { state: "problem", message, skill };
-}
-async function notice(cli, folder, install, { builtIn, bin }, ctx) {
-    // `doctor` and `skill install` report the copy themselves, and a one-Command CLI has no `skill install`. A run from source is the CLI's own repo, whose agent reads the source.
-    if (builtIn || bin === undefined || cli.commands === undefined)
-        return;
-    let finding;
-    try {
-        finding = await findingOf(cli, folder, install, ctx);
-    }
-    catch (error) {
-        // A file the Runtime cannot read must not stop the Command the Notice rides on; a bug still does.
-        if (errnoOf(error) === undefined)
-            throw error;
-        ctx.notice(`could not check the ${cli.name} skill: ${messageOf(error)}`);
-        return;
-    }
-    if (finding.state !== "problem")
-        return;
-    ctx.notice(finding.fix === undefined ? finding.message : `${finding.message}; run \`${finding.fix}\``);
-}
-/** A skill shipped in the package at `packaged`, which `skill install` copies to the project root. */
-export function packagedSkill(cli, { packaged: folder, agents: text }, install) {
-    const agents = text === undefined ? undefined : { name: cli.name, text };
-    return {
-        kind: "packaged",
-        builtIns: { skill: { install: skillInstallCommand(cli, folder, agents) } },
-        rows: [
-            { name: "skill", advisory: true, run: (ctx) => findingOf(cli, folder, install, ctx) },
-            ...(agents === undefined ? [] : [agentsRow(agents, install)]),
-        ],
-        notice: (launch, ctx) => notice(cli, folder, install, launch, ctx),
-        differing: async ({ cwd, packageRoot }) => {
-            const { copy } = await skillCopyOf(cli, cwd);
-            const { copyVersion, packageVersion, same } = await skillVersionsOf(join(packageRoot, folder), copy);
-            return copyVersion === undefined || same
-                ? []
-                : [compared(cli.name, { copy, copyVersion, packageVersion }, false)];
-        },
-        // The copy is compared with the package on disk, whatever the version asked about.
-        nextAt: async (_version, ctx) => {
-            const { fix } = await findingOf(cli, folder, install, ctx);
-            return fix === undefined ? [] : [fix];
-        },
-    };
-}
-//# sourceMappingURL=packaged.js.map

package/dist/built-ins/skill/packaged.js.map

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

package/dist/built-ins/skill/usage-hint.d.ts

@@ -1,4 +0,0 @@
-import type { Cli } from "../../define.js";
-import { type SkillPlace } from "./skill.js";
-/** A usage error whose hint names each Skill copy that differs from this build, since one may have named the input. */
-export declare function withDifferingSkill(error: unknown, cli: Cli, place: SkillPlace, runAs: string): Promise<unknown>;

package/dist/built-ins/skill/usage-hint.js

@@ -1,28 +0,0 @@
-import { INVALID_INPUT, UNKNOWN_COMMAND, UNKNOWN_OPTION } from "../../command-line/usage.js";
-import { errnoOf, UsageError } from "../../errors.js";
-import { installOf } from "../install/install.js";
-import { skillOf } from "./skill.js";
-const SKILL_USAGE_CODES = new Set([UNKNOWN_OPTION, UNKNOWN_COMMAND, INVALID_INPUT]);
-/** A usage error whose hint names each Skill copy that differs from this build, since one may have named the input. */
-export async function withDifferingSkill(error, cli, place, runAs) {
-    if (!(error instanceof UsageError) || !SKILL_USAGE_CODES.has(error.code))
-        return error;
-    let differing;
-    try {
-        differing = await skillOf(cli, installOf(cli)).differing(place);
-    }
-    catch (lookup) {
-        // A skill the Runtime cannot read leaves the usage error as it was; a bug still surfaces.
-        if (errnoOf(lookup) === undefined)
-            throw lookup;
-        return error;
-    }
-    if (differing.length === 0)
-        return error;
-    return new UsageError({
-        code: error.code,
-        message: error.message,
-        hint: `${error.hint}; the ${cli.name} skill may name what this build does not know: ${differing.join("; ")}; run \`${runAs} doctor\` to see how to update it`,
-    });
-}
-//# sourceMappingURL=usage-hint.js.map

package/dist/built-ins/skill/usage-hint.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"usage-hint.js","sourceRoot":"","sources":["../../../src/built-ins/skill/usage-hint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7F,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAmB,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC;AAEpF,uHAAuH;AACvH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAc,EACd,GAAQ,EACR,KAAiB,EACjB,KAAa;IAEb,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvF,IAAI,SAAmB,CAAC;IACxB,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,0FAA0F;QAC1F,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,SAAS;YAAE,MAAM,MAAM,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,IAAI,UAAU,CAAC;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,kDAAkD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,mCAAmC;KAC9J,CAAC,CAAC;AACL,CAAC"}