@canonical/pragma-cli 0.35.0 → 0.36.0

package/dist/src/capabilities/shared/packageManager.js

@@ -1,30 +1,60 @@
 /**
- * Storeless install-source heuristic, shared by `info`, `upgrade`, and
+ * Storeless install-source detector, shared by `info`, `upgrade`, and
  * `doctor`'s `pragma version` check.
  *
- * Promotes the detector that lived inline in `info/collectInfo.ts`: the package
- * manager comes from npm's `npm_config_user_agent` (set by npm/pnpm/yarn/bun
- * when they run a script), the scope from whether the installed entry sits
- * under the CURRENT PROJECT. With no agent we report the honest runtime rather
- * than guessing. The old shell's full package.json walk (`#package-manager`) is
- * dropped — only this heuristic and the update-command map survive.
- */
-import { isAbsolute, relative, resolve, sep } from "node:path";
-import { fileURLToPath } from "node:url";
-/** The package manager from npm's user-agent, else the honest runtime. */
-function packageManager() {
-    const agent = process.env.npm_config_user_agent;
-    const name = agent?.split("/")[0];
-    if (name)
-        return name;
-    return process.versions.bun ? "bun" : "node";
-}
-/**
- * Detect how the binary was installed — package manager and scope.
+ * Detection is driven by the FILESYSTEM — the resolved entry path, the invoked
+ * bin path, and the symlinks between them — not by environment variables. The
+ * previous heuristic read `npm_config_user_agent`, which npm/pnpm/yarn/bun set
+ * only when THEY run a script; a user typing the bin name in a shell never has
+ * it, so on the path that mattered the detector always fell through to the
+ * honest runtime and reported `node` for every install. The agent survives
+ * only as a last-resort corroboration for a workspace install whose tree
+ * carries no other marker.
  *
- * @returns The install source (pm, label).
- * @note Impure — reads `import.meta.url`, the working directory, and `process.env`.
+ * The two paths that matter, and why both are needed:
+ *
+ * - `import.meta.url` is REALPATH-RESOLVED by the module loader. For a normal
+ *   install it sits inside `node_modules/<pkg>`; for a linked development
+ *   install (`npm link` / `bun link`) it has already escaped to the source
+ *   checkout and contains no `node_modules` at all — which is precisely why an
+ *   entry-only detector cannot see a link.
+ * - `process.argv[1]` preserves the path the user actually invoked, symlinks
+ *   intact. Walking its link chain finds the `node_modules/<pkg>` entry the
+ *   bin points through, and whether THAT directory is itself a symlink
+ *   pointing outside the install root — the linked-install signal. The chain
+ *   is only trusted when the package directory it names really contains the
+ *   running module (`realPath` identity check), so a foreign bin on argv[1]
+ *   (vitest, a wrapper script) never misattributes the install.
+ *
+ * The manager is identified by path SHAPE (`.bun/`, `.pnpm`/`pnpm`, `.volta`,
+ * `.asdf`, yarn's global dir), ephemeral runners by their cache shapes
+ * (`_npx`, `bunx-*`, pnpm's `dlx`), and a workspace's manager by the lockfile
+ * beside the install root. When no signal is conclusive the detector answers
+ * `unknown` — a state with NO update command, because a confidently wrong
+ * `npm i -g` is worse than none (against a linked checkout it would overwrite
+ * the link to the tree being developed). `pmUpdateCommand` accepts only the
+ * {@link GlobalInstall} arm, so offering a command to any other state is a
+ * type error, not a convention.
+ *
+ * Read-only and storeless: a handful of `lstat`/`readlink`/`realpath`/`exists`
+ * probes, bounded by the link-chain cap — nothing is ever written. The module
+ * sits on the fast-path static graph (via the shared barrel), so all probing
+ * happens at call time; module load stays inert.
+ *
+ * Windows note: segment matching splits on both separators, so the SHAPE
+ * checks (`managerFromPath`, `ephemeralRunner`) are exercised against
+ * win32-style fixtures — but scope containment goes through the host's
+ * `node:path` and, like `platformPaths.ts`, the win32 arm is a conventional
+ * best guess that has NOT been validated on a real Windows machine.
  */
+import { existsSync, readlinkSync, realpathSync } from "node:fs";
+import { dirname, isAbsolute, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { INSTALL_UPDATE_GUIDANCE, installSourceLabel, } from "../../kernel/render/vocabulary.js";
+/** Split on both separators, so shape checks read win32 paths too. */
+const splitPath = (path) => path.split(/[\\/]/);
+/** The separator the input path itself uses (win32 fixtures keep theirs). */
+const sepOf = (path) => (path.includes("\\") ? "\\" : "/");
 /**
  * The directory a package was installed INTO — the parent of the `node_modules`
  * holding it, so `/proj/node_modules/@scope/x/dist/bin.js` yields `/proj`.
@@ -38,9 +68,9 @@ function packageManager() {
  * @remarks Exported for its unit test; not part of the package's public surface.
  */
 export function findInstallRoot(entry) {
-    const segments = entry.split(sep);
+    const segments = splitPath(entry);
     const index = segments.lastIndexOf("node_modules");
-    return index === -1 ? undefined : segments.slice(0, index).join(sep);
+    return index === -1 ? undefined : segments.slice(0, index).join(sepOf(entry));
 }
 /**
  * Whether `directory` contains `candidate`, or is it.
@@ -58,46 +88,262 @@ export function containsPath(directory, candidate) {
     const offset = relative(directory, candidate);
     return offset === "" || (!offset.startsWith("..") && !isAbsolute(offset));
 }
-export function detectInstallSource() {
-    // The entry's own location, NOT `process.argv[1]`. Under the compiled binary
-    // argv[1] was the user's FIRST ARGUMENT (the executable was argv[0]), so the
-    // old `includes("node_modules")` test read a command word and answered
-    // "global" for almost everything. Shipping `node dist/src/bin.js` moves the
-    // entry path INTO argv[1], where it always contains `node_modules` — which
-    // would answer "local" for everything, the same bug facing the other way.
-    // `import.meta.url` is the honest source either way.
-    const entry = fileURLToPath(import.meta.url);
-    // LOCAL means the working directory sits inside the project this package was
-    // installed into — not merely that the entry sits under the cwd. Asking the
-    // narrower question called a perfectly ordinary local install "global" the
-    // moment the user ran it from a subdirectory, which in a monorepo is the
-    // usual case. Going the other way, deriving the install root also settles the
-    // $HOME-nested global prefixes (nvm, `~/.npm-global`): their root is the
-    // prefix, which contains no user project.
-    const root = findInstallRoot(entry);
-    const scope = root !== undefined && containsPath(root, resolve(process.cwd()))
-        ? "local"
-        : "global";
-    const pm = packageManager();
-    return { pm, label: `${pm} (${scope})` };
+/**
+ * Locate the `node_modules` package a path sits inside — root and package
+ * directory, scope-aware. `node_modules/.bin/...` is NOT a package (the shim
+ * there is a symlink the chain walk should follow instead).
+ */
+function locatePackage(path) {
+    const segments = splitPath(path);
+    const index = segments.lastIndexOf("node_modules");
+    if (index === -1)
+        return undefined;
+    const first = segments[index + 1];
+    if (first === undefined || first === ".bin")
+        return undefined;
+    const span = first.startsWith("@") ? 2 : 1;
+    if (span === 2 && segments[index + 2] === undefined)
+        return undefined;
+    const sep = sepOf(path);
+    return {
+        root: segments.slice(0, index).join(sep),
+        pkgDir: segments.slice(0, index + 1 + span).join(sep),
+    };
+}
+/** The manager a path's shape names, or `undefined` when it names none. */
+export function managerFromPath(path) {
+    const segments = splitPath(path).map((s) => s.toLowerCase());
+    const has = (name) => segments.includes(name);
+    if (has(".bun"))
+        return "bun";
+    if (has(".pnpm") || has("pnpm"))
+        return "pnpm";
+    if (has(".volta") ||
+        segments.some((s, i) => s === "volta" && segments[i + 1] === "tools")) {
+        return "volta";
+    }
+    // asdf/nvm host an ordinary npm global tree inside a versioned node install.
+    if (has(".asdf") || has(".nvm"))
+        return "npm";
+    const yarn = segments.findIndex((s) => s === "yarn" || s === ".yarn");
+    if (yarn !== -1 && segments.indexOf("global", yarn) !== -1)
+        return "yarn";
+    return undefined;
+}
+/**
+ * The ephemeral runner a path's cache shape names, if any.
+ *
+ * Each pattern is anchored to the runner's ACTUAL cache layout, not to a bare
+ * directory name appearing anywhere in the path. A loose match reclassifies an
+ * ordinary project — `/work/dlx/app`, or anything under a directory someone
+ * named `_npx` — as ephemeral, and because that verdict is reached BEFORE the
+ * workspace containment check it wins even when a lockfile sits beside the
+ * root. The failure is quiet rather than loud: an ephemeral install correctly
+ * offers no upgrade command, so the user simply never learns how to update.
+ */
+export function ephemeralRunner(path) {
+    const segments = splitPath(path);
+    // npx caches at `<npm cache>/_npx/<hash>/…` — `~/.npm` on unix,
+    // `%LOCALAPPDATA%\npm-cache` on Windows.
+    const npx = segments.indexOf("_npx");
+    const npxParent = npx > 0 ? segments[npx - 1] : undefined;
+    if (npxParent === ".npm" || npxParent === "npm-cache")
+        return "npx";
+    // bunx materialises `$TMPDIR/bunx-<uid>-<pkg>@<ver>/…`; requiring the uid
+    // keeps a hand-made `bunx-tools` directory from matching.
+    if (segments.some((s) => /^bunx-\d+-/.test(s)))
+        return "bunx";
+    // pnpm caches at `<pnpm cache>/dlx/<hash>/…`.
+    const dlx = segments.indexOf("dlx");
+    if (dlx > 0 && segments[dlx - 1] === "pnpm")
+        return "pnpm dlx";
+    return undefined;
+}
+/** The lockfile beside an install root, mapped to its manager. */
+function lockfileManager(root, exists, sep) {
+    const beside = (name) => exists(`${root}${sep}${name}`);
+    if (beside("bun.lock") || beside("bun.lockb"))
+        return "bun";
+    if (beside("pnpm-lock.yaml"))
+        return "pnpm";
+    if (beside("yarn.lock"))
+        return "yarn";
+    if (beside("package-lock.json"))
+        return "npm";
+    return undefined;
+}
+/** The manager `npm_config_user_agent` names, when present and recognized. */
+function agentManager(agent) {
+    const name = agent?.split("/")[0];
+    return name === "npm" || name === "pnpm" || name === "yarn" || name === "bun"
+        ? name
+        : undefined;
+}
+/** The link-chain hop cap — a symlink cycle must not spin the detector. */
+const MAX_LINK_HOPS = 10;
+/**
+ * Walk `argv[1]`'s symlink chain to the `node_modules` entry it points
+ * through, and trust it only when that package directory really contains the
+ * running module. Returns the FIRST chain path inside a package — before the
+ * package-level symlink is resolved away, which is where the linked-install
+ * signal lives.
+ */
+function resolveInvokedEntry(probe) {
+    if (probe.invoked === undefined)
+        return undefined;
+    let path = resolve(probe.cwd, probe.invoked);
+    for (let hop = 0; hop < MAX_LINK_HOPS; hop++) {
+        const located = locatePackage(path);
+        if (located !== undefined) {
+            // Identity check: only OUR package's bin may classify this process.
+            const real = probe.realPath(located.pkgDir);
+            return real !== undefined && containsPath(real, probe.entry)
+                ? path
+                : undefined;
+        }
+        const target = probe.readLink(path);
+        if (target === undefined)
+            return undefined;
+        path = resolve(dirname(path), target);
+    }
+    return undefined;
+}
+const unknownInstall = (runtime) => ({
+    kind: "unknown",
+    runtime,
+    label: installSourceLabel("unknown", runtime),
+});
+/**
+ * Classify an install from a captured probe — the PURE core of
+ * {@link detectInstallSource}, exercised by the fixture matrix in its test.
+ *
+ * @param probe - The captured paths, environment, and filesystem readers.
+ * @returns The classified install source.
+ */
+export function classifyInstall(probe) {
+    const invokedEntry = resolveInvokedEntry(probe);
+    const installed = invokedEntry ??
+        (locatePackage(probe.entry) !== undefined ? probe.entry : undefined);
+    if (installed === undefined)
+        return unknownInstall(probe.runtime);
+    const located = locatePackage(installed);
+    /* v8 ignore next -- `installed` is only set when locatePackage succeeded */
+    if (located === undefined)
+        return unknownInstall(probe.runtime);
+    const { root, pkgDir } = located;
+    // A package dir that is a symlink pointing OUTSIDE its install root is a
+    // linked development install (`npm link`/`bun link`). Inside the root it is
+    // a store or workspace layout (pnpm's `.pnpm`, a monorepo package) — normal.
+    const rawTarget = probe.readLink(pkgDir);
+    if (rawTarget !== undefined) {
+        const target = resolve(dirname(pkgDir), rawTarget);
+        if (!containsPath(root, target)) {
+            const pm = managerFromPath(installed);
+            return {
+                kind: "linked",
+                ...(pm !== undefined ? { pm } : {}),
+                target,
+                label: installSourceLabel("linked", pm),
+            };
+        }
+    }
+    const runner = ephemeralRunner(installed);
+    if (runner !== undefined) {
+        return {
+            kind: "ephemeral",
+            runner,
+            label: installSourceLabel("ephemeral", runner),
+        };
+    }
+    const shaped = managerFromPath(installed);
+    if (containsPath(root, resolve(probe.cwd))) {
+        // A workspace tree can belong to any manager; the lockfile beside its
+        // root is the marker, the user-agent (when a script runner set it) the
+        // corroboration of last resort.
+        const pm = shaped ??
+            lockfileManager(root, probe.exists, sepOf(installed)) ??
+            agentManager(probe.userAgent);
+        return {
+            kind: "workspace",
+            ...(pm !== undefined ? { pm } : {}),
+            root,
+            label: installSourceLabel("workspace", pm),
+        };
+    }
+    // A global tree with none of the distinctive shapes is npm's: bun, pnpm,
+    // volta and yarn all mark their global roots, npm (and nvm/asdf node
+    // installs, which npm serves) do not. The user-agent is NOT consulted here —
+    // it names whoever ran the script (`bun run …`), not who installed the bin.
+    const pm = shaped ?? "npm";
+    return { kind: "global", pm, label: installSourceLabel("global", pm) };
+}
+/** Capture the live process into a probe (the only impure code here). */
+function liveProbe() {
+    return {
+        entry: fileURLToPath(import.meta.url),
+        invoked: process.argv[1],
+        cwd: process.cwd(),
+        userAgent: process.env.npm_config_user_agent,
+        runtime: process.versions.bun ? "bun" : "node",
+        readLink: (path) => {
+            try {
+                return readlinkSync(path);
+            }
+            catch {
+                return undefined;
+            }
+        },
+        realPath: (path) => {
+            try {
+                return realpathSync(path);
+            }
+            catch {
+                return undefined;
+            }
+        },
+        exists: (path) => existsSync(path),
+    };
+}
+/**
+ * Detect how the binary was installed.
+ *
+ * @param probe - Injected probe (tests); defaults to the live process.
+ * @returns The classified install source.
+ * @note Impure by default — reads `import.meta.url`, `process`, and a bounded
+ *   handful of symlink/realpath/exists probes. Never writes.
+ */
+export function detectInstallSource(probe = liveProbe()) {
+    return classifyInstall(probe);
 }
-/** The npm global-update command — also the fallback for an unknown manager. */
-const npmUpdateCommand = (pkg) => `npm i -g ${pkg}`;
 /** The global-update command per package manager (install-style). */
 const PM_UPDATE_COMMAND = {
     bun: (pkg) => `bun add -g ${pkg}`,
-    npm: npmUpdateCommand,
+    npm: (pkg) => `npm i -g ${pkg}`,
     pnpm: (pkg) => `pnpm add -g ${pkg}`,
     yarn: (pkg) => `yarn global add ${pkg}`,
+    volta: (pkg) => `volta install ${pkg}`,
 };
 /**
- * The command that updates `pkg` globally for a package manager.
+ * The command that updates a GLOBAL install of `pkg`. Accepting only the
+ * {@link GlobalInstall} arm is the point: a linked, ephemeral, workspace, or
+ * unknown install has no sanctioned command, and asking for one is a type
+ * error — {@link updateGuidance} is what those states say instead.
  *
- * @param pm - The package-manager name (`bun`/`npm`/`pnpm`/`yarn`).
+ * @param install - The detected global install.
  * @param pkg - The package to update.
- * @returns The shell command; falls back to npm for an unknown manager.
+ * @returns The shell command.
+ */
+export function pmUpdateCommand(install, pkg) {
+    return PM_UPDATE_COMMAND[install.pm](pkg);
+}
+/**
+ * The honest sentence a command-less install state shows when a newer release
+ * exists — see {@link INSTALL_UPDATE_GUIDANCE} for the words.
+ *
+ * @param install - Any non-global install.
+ * @returns The guidance sentence for its state.
  */
-export function pmUpdateCommand(pm, pkg) {
-    return (PM_UPDATE_COMMAND[pm] ?? npmUpdateCommand)(pkg);
+export function updateGuidance(install) {
+    return INSTALL_UPDATE_GUIDANCE[install.kind];
 }
 //# sourceMappingURL=packageManager.js.map

package/dist/src/capabilities/shared/packageManager.js.map

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

package/dist/src/capabilities/skill/discover.js

@@ -4,14 +4,16 @@
  * A skill is a folder with a `SKILL.md` carrying YAML frontmatter (`name`,
  * `description`, and the #856 `prompt` flag among others). Skills are discovered
  * from conventional roots — project skills under `<cwd>/.pragma/skills`, which
- * take precedence, then installed skills under `$XDG_DATA_HOME/pragma/skills` —
- * with missing files and invalid frontmatter skipped gracefully. Reads only the
+ * take precedence, then installed skills under `$XDG_DATA_HOME/pragma/skills`,
+ * then the BUNDLED snapshot this package ships (`bundled-skills/`) — with
+ * missing files and invalid frontmatter skipped gracefully. Reads only the
  * filesystem, never the graph store, so `skill list`/`lookup` are storeless
  * (needsStore: false).
  */
-import { readdirSync, readFileSync, statSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
-import { basename, join } from "node:path";
+import { basename, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { BIN_NAME } from "../../constants.js";
 const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/;
 /** Parse one YAML scalar (string, boolean, number, or inline array). */
@@ -105,8 +107,8 @@ export function installedSkillsDir() {
 /**
  * The project skills root: `<cwd>/.<bin>/skills` — skills that belong to THIS
  * repository and travel with it. Named separately from {@link skillRoots}
- * because the two roots are also the two setup BANDS: `setup skills --local`
- * links this root into the project's harness directories, while the global band
+ * because the two roots are also the two setup SCOPES: `setup skills --local`
+ * links this root into the project's harness directories, while the global scope
  * links {@link installedSkillsDir} into the user-level ones. Mixing them leaks
  * machine state into a repository's directories, or applies one repository's
  * skills machine-wide.
@@ -114,15 +116,99 @@ export function installedSkillsDir() {
 export function projectSkillsDir(cwd) {
     return join(cwd, `.${BIN_NAME}`, "skills");
 }
+/**
+ * The directory name of the SNAPSHOT of pack skills this package ships, at its
+ * own root. Written by `scripts/bundle.ts` and COMMITTED, exactly as
+ * `src/kernel/runtime/graphpack/embedded/pack.generated.ts` is — see
+ * {@link bundledSkillsDir}.
+ */
+const BUNDLED_SKILLS_DIRNAME = "bundled-skills";
+/**
+ * How far above this module the package root can be. `src/capabilities/skill`
+ * is three levels up; the emitted `dist/src/capabilities/skill` is four. The
+ * bound exists so a tree that is MISSING the artifact stops at the package
+ * instead of walking to `/` and adopting an unrelated directory.
+ */
+const BUNDLED_SEARCH_DEPTH = 6;
+/**
+ * The BUNDLED-skills root: `<package root>/bundled-skills`, the snapshot of the
+ * declared packs' `skills/<name>/` that `scripts/bundle.ts` commits alongside
+ * the embedded graph — `undefined` when this build ships none.
+ *
+ * WHY IT EXISTS. The embedded pack (`pack.generated.ts`) is what lets a fresh
+ * install answer `block lookup` offline. The skills came out of the very same
+ * `resolvePackage` calls and were left on the build machine's disk, so the same
+ * fresh install listed ZERO skills and told the user to run `sources update`
+ * first — a network round trip and two commands for something already resolved
+ * at release time. This is the skills half of the snapshot the graph has had
+ * all along.
+ *
+ * WHY IT IS FOUND BY WALKING UP rather than by a fixed relative path. `files`
+ * ships BOTH `src` and `dist`, and `tsconfig.build.json` sets `rootDir: "."`,
+ * so this module runs from `src/capabilities/skill/` in a source or test run
+ * and from `dist/src/capabilities/skill/` in the shipped one — the package root
+ * is three levels up in one and four in the other, and no single
+ * `new URL("../../..")` is right for both. The walk anchors on the artifact's
+ * own name sitting NEXT TO a `package.json`, which is true only at the package
+ * root: `dist/` carries a `package.json` too (`resolveJsonModule` copies it)
+ * but never the snapshot.
+ *
+ * @returns The bundled root, or `undefined` when no ancestor holds one.
+ * @note Impure — stats up to {@link BUNDLED_SEARCH_DEPTH} ancestor directories.
+ *   Reached from the `__complete` fast path, so it stays `node:fs` /
+ *   `node:path` / `node:url` only and costs a handful of `stat`s.
+ */
+export function bundledSkillsDir() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let up = 0; up < BUNDLED_SEARCH_DEPTH; up += 1) {
+        const candidate = join(dir, BUNDLED_SKILLS_DIRNAME);
+        if (existsSync(join(dir, "package.json")) && existsSync(candidate)) {
+            return candidate;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return undefined;
+}
 /**
  * The conventional roots skills are discovered from, in PRECEDENCE order: the
  * project root (`<cwd>/.<bin>/skills`) FIRST so a project-local skill overrides
  * an installed skill of the same name (`discoverSkills` dedups first-seen-wins),
  * then installed skills under `$XDG_DATA_HOME/<bin>/skills` (where package
- * skills land on `sources update`).
+ * skills land on `sources update`), then the BUNDLED snapshot
+ * ({@link bundledSkillsDir}).
+ *
+ * BUNDLED IS LAST, and that order is the whole contract. The snapshot is as old
+ * as the release; an installed skill came from a `sources update` the user ran
+ * deliberately, and a project skill is the repository's own. So someone who
+ * updates gets the CURRENT skill and never the shipped copy, while a fresh
+ * install — which has neither of the first two roots — still gets the packs'
+ * skills instead of an empty list and a two-command recovery.
  */
 export function skillRoots(cwd) {
-    return [projectSkillsDir(cwd), installedSkillsDir()];
+    return [projectSkillsDir(cwd), ...globalSkillRoots()];
+}
+/**
+ * The GLOBAL scope's source roots, in precedence order: the INSTALLED root
+ * (`sources update`'s output) first, then the BUNDLED snapshot.
+ *
+ * Named separately from {@link skillRoots} for the reason
+ * {@link projectSkillsDir} is: these are the two roots `setup skills --global`
+ * links into the user-level harness directories, and `skillRoots` is discovery,
+ * which spans both scopes. Reading the project root for the global scope is
+ * exactly the cross-scope leak the scope split exists to prevent.
+ *
+ * A BAND CAN HOLD MORE THAN ONE ROOT, and this is where that became true. The
+ * global scope's ownership test and its stale-link sweep therefore range over
+ * the SET (see `setup/operations/setupSkills.ts`), never over one path.
+ */
+export function globalSkillRoots() {
+    const bundled = bundledSkillsDir();
+    return bundled === undefined
+        ? [installedSkillsDir()]
+        : [installedSkillsDir(), bundled];
 }
 /** Immediate subdirectories of `root` (each a candidate skill folder). */
 function subdirs(root) {
@@ -146,10 +232,10 @@ function subdirs(root) {
  * Discover every skill reachable from an EXPLICIT list of roots, in precedence
  * order (first-seen wins on a duplicate name).
  *
- * Split out of {@link discoverSkills} so a caller that owns one band can read
- * exactly that band's root: `setup skills` links the project root into project
+ * Split out of {@link discoverSkills} so a caller that owns one scope can read
+ * exactly that scope's root: `setup skills` links the project root into project
  * harness directories and the installed root into user-level ones, and reading
- * both roots for either band is what used to mix the two.
+ * both roots for either scope is what used to mix the two.
  *
  * @param roots - The roots to read, in precedence order.
  * @returns Discovered skills, sorted by name; malformed ones are skipped.

package/dist/src/capabilities/skill/discover.js.map

@@ -1 +1 @@
-{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../../../src/capabilities/skill/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAoB9C,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAErD,wEAAwE;AACxE,SAAS,cAAc,CAAC,GAAW;IACjC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,OAAO;aACX,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;aACZ,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;aAChD,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IACrD,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,uEAAuE;AACvE,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,MAAM,GAAmC,IAAI,CAAC;IAClD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACtD,IAAI,QAAQ,IAAI,UAAU,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9D,IAAI,CAAC,MAAM;gBAAE,MAAM,GAAG,EAAE,CAAC;YACzB,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAW,CAAC,GAAG,cAAc,CAC5C,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAC3B,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,EAAE,CAAC;YACpB,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC;gBAC5B,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;YACD,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAW,CAAC;YAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAChC,UAAU,GAAG,GAAG,CAAC;YACjB,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBACjB,MAAM,GAAG,EAAE,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;gBACpC,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,UAAU,IAAI,MAAM;QAAE,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACvE,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,KAAK,EAAE,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,GAAG,CAAC,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,0EAA0E;AAC1E,SAAS,OAAO,CAAC,IAAY;IAC3B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC;aACrB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;aAC/B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACf,IAAI,CAAC;gBACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC,CAAC,CAAC;IACP,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAwB;IAExB,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;YACzD,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC;gBAAE,SAAS;YACzD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,WAAW,EAAE,WAAW,CAAC,WAAW;gBACpC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC;gBACzB,UAAU,EAAE,GAAG;gBACf,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC1B,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../../../src/capabilities/skill/discover.ts"],"names":[],"mappings":"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"}

package/dist/src/capabilities/skill/render.js

@@ -6,12 +6,12 @@ import { BIN_NAME } from "../../constants.js";
 const EMPTY_PLAIN = `No skills found.\nSkills come from design-system packs — add one to your config's packs, run \`${BIN_NAME} sources update\`, then \`${BIN_NAME} setup skills\`.`;
 const EMPTY_LLM = `## Skills (0)\n\nNo skills found. Skills come from design-system packs — add one to the project config's packs, run \`${BIN_NAME} sources update\`, then \`${BIN_NAME} setup skills\`.`;
 export const skillListFormatters = {
-    // Zero skills: plain stdout stays empty — the guidance is `emptyNotice`,
+    // Zero skills: plain stdout stays empty — the guidance is `notice`,
     // which the dispatcher routes to stderr (exit 0) so a pipe reads no prose.
     plain: (skills) => skills
         .map((s) => `${s.name}${s.frontmatter.prompt ? " (prompt)" : ""}  ${s.description}`)
         .join("\n"),
-    emptyNotice: (skills) => (skills.length === 0 ? EMPTY_PLAIN : undefined),
+    notice: (skills) => (skills.length === 0 ? EMPTY_PLAIN : undefined),
     llm: (skills) => skills.length === 0
         ? EMPTY_LLM
         : [

package/dist/src/capabilities/skill/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../../src/capabilities/skill/render.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAK9C,mFAAmF;AACnF,MAAM,WAAW,GAAG,kGAAkG,QAAQ,6BAA6B,QAAQ,kBAAkB,CAAC;AACtL,MAAM,SAAS,GAAG,yHAAyH,QAAQ,6BAA6B,QAAQ,kBAAkB,CAAC;AAE3M,MAAM,CAAC,MAAM,mBAAmB,GAAkC;IAChE,yEAAyE;IACzE,2EAA2E;IAC3E,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAChB,MAAM;SACH,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAC1E;SACA,IAAI,CAAC,IAAI,CAAC;IACf,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CACd,MAAM,CAAC,MAAM,KAAK,CAAC;QACjB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC;YACE,cAAc,MAAM,CAAC,MAAM,GAAG;YAC9B,EAAE;YACF,GAAG,MAAM,CAAC,GAAG,CACX,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,WAAW,EAAE,CACjF;SACF,CAAC,IAAI,CAAC,IAAI,CAAC;IAClB,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAA4B;IAC5D,KAAK,CAAC,KAAK;QACT,MAAM,KAAK,GAAG;YACZ,KAAK,CAAC,IAAI;YACV,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC3C,EAAE;YACF,KAAK,KAAK,CAAC,WAAW,EAAE;SACzB,CAAC;QACF,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QACzE,IAAI,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,KAAK,CAAC,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,GAAG,CAAC,KAAK;QACP,MAAM,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC9D,IAAI,KAAK,CAAC,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACvD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;CAChD,CAAC"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../../src/capabilities/skill/render.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAK9C,mFAAmF;AACnF,MAAM,WAAW,GAAG,kGAAkG,QAAQ,6BAA6B,QAAQ,kBAAkB,CAAC;AACtL,MAAM,SAAS,GAAG,yHAAyH,QAAQ,6BAA6B,QAAQ,kBAAkB,CAAC;AAE3M,MAAM,CAAC,MAAM,mBAAmB,GAAkC;IAChE,oEAAoE;IACpE,2EAA2E;IAC3E,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAChB,MAAM;SACH,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAC1E;SACA,IAAI,CAAC,IAAI,CAAC;IACf,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CACd,MAAM,CAAC,MAAM,KAAK,CAAC;QACjB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC;YACE,cAAc,MAAM,CAAC,MAAM,GAAG;YAC9B,EAAE;YACF,GAAG,MAAM,CAAC,GAAG,CACX,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,WAAW,EAAE,CACjF;SACF,CAAC,IAAI,CAAC,IAAI,CAAC;IAClB,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAA4B;IAC5D,KAAK,CAAC,KAAK;QACT,MAAM,KAAK,GAAG;YACZ,KAAK,CAAC,IAAI;YACV,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC3C,EAAE;YACF,KAAK,KAAK,CAAC,WAAW,EAAE;SACzB,CAAC;QACF,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QACzE,IAAI,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,KAAK,CAAC,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,GAAG,CAAC,KAAK;QACP,MAAM,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC9D,IAAI,KAAK,CAAC,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACvD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;CAChD,CAAC"}