@canonical/pragma-cli 0.34.0 → 0.36.0

package/dist/src/capabilities/setup/targets.js

@@ -0,0 +1,328 @@
+/**
+ * THE target table — the one list `setup` and `doctor` both read.
+ *
+ * Five rows, each with a scope column. This table drives the `setup <target>`
+ * sub-verbs, the wizard's choices, the `--dry-run` plan, the progress lines, the
+ * recap, the doctor rows, and each doctor row's `fix:` line. Adding a sixth
+ * target is one row here — not a new sub-verb, a new check, a new recap branch
+ * and a new fix string that four separate files have to agree about.
+ *
+ * A row owns: its identity (`id` is BOTH the sub-verb argument and the doctor
+ * row name, so `mcp` and `setup mcp` visibly share a token), which scopes it can
+ * be installed into, how to DETECT its current state, how to PLAN a run from
+ * that detection, and how to COMPOSE the forward and removal effects. Detection
+ * runs once per invocation and feeds every reader, so setup and doctor cannot
+ * disagree about what they looked at.
+ *
+ * What a row does NOT own is diagnosis. `doctor/runChecks.ts` maps a row's
+ * detection onto a check result itself: the completions check needs helpers that
+ * live under `doctor/`, and importing them here would make the two directories
+ * import each other. The bijection is unaffected — doctor enumerates THIS table
+ * and derives every row name and `fix:` line from it.
+ *
+ * This module is reached only through the verb's lazy dynamic import (and
+ * doctor's), so nothing here lands on the `--help`/`__complete` fast path.
+ */
+import { BIN_NAME } from "../../constants.js";
+import { composeCompletions, composeCompletionsRemoval, detectCompletions, } from "./operations/setupCompletions.js";
+import { composeConfigFile, composeConfigRemoval, detectConfigFile, } from "./operations/setupConfig.js";
+import { composeLsp, composeLspRemoval, detectLsp, LSP_SKIP_REMEDY, lspEditorNames, lspSkipReason, ownedLspEditors, } from "./operations/setupLsp.js";
+import { composeMcp, composeMcpRemoval, detectMcp, mcpGroupState, ownedMcpGroups, selectedGroups, } from "./operations/setupMcp.js";
+import { composeSkills, composeSkillsRemoval, detectSkills, ownedSkillLinks, skillsSkipReason, skillsSkipRemedy, staleSkillLinks, } from "./operations/setupSkills.js";
+import { shortenPath, } from "./plan.js";
+/** Erase a row's detection type so the five rows can share one array. */
+const defineTarget = (target) => target;
+// =============================================================================
+// The rows
+// =============================================================================
+const configTarget = defineTarget({
+    id: "config",
+    title: "Global configuration",
+    scopes: ["global"],
+    detect: () => detectConfigFile(),
+    plan: (d, _scope, roots) => {
+        const path = shortenPath(d.path, roots);
+        if (!d.exists)
+            return { action: "install", detail: path };
+        return { action: "none", detail: `${path} — present` };
+    },
+    removalPlan: (d, _scope, roots) => {
+        const path = shortenPath(d.path, roots);
+        if (!d.exists)
+            return { action: "none", detail: `${path} — absent` };
+        if (!d.isSeed) {
+            return {
+                action: "skip",
+                detail: path,
+                reason: `it holds your own settings, so ${path} stays`,
+            };
+        }
+        return { action: "remove", detail: path };
+    },
+    compose: (d) => composeConfigFile(d),
+    composeRemoval: (d) => composeConfigRemoval(d),
+});
+const completionsTarget = defineTarget({
+    id: "completions",
+    title: "Shell completions",
+    scopes: ["global"],
+    detect: (rt) => detectCompletions(rt.cwd),
+    plan: (d, _scope, roots) => {
+        // Never guess a shell. Installing for the wrong one is invisible until the
+        // user presses TAB and nothing happens, so an unresolved shell is a named
+        // skip whose remedy is the one action that DOES settle it.
+        if (d.detection.kind === "ambiguous") {
+            return {
+                action: "skip",
+                detail: "the running shell cannot be identified",
+                reason: `the running shell cannot be identified — SHELL names ${d.detection.login}, which is the login shell, not necessarily the one in use`,
+                remedy: `run \`${BIN_NAME} setup completions\` from the shell you want completions in`,
+            };
+        }
+        if (d.detection.kind === "unknown" || d.shell === null || d.path === null) {
+            return {
+                action: "skip",
+                detail: "no supported shell detected",
+                reason: "no bash, zsh, or fish was found in this process tree",
+                remedy: `run \`${BIN_NAME} setup completions\` from bash, zsh, or fish`,
+            };
+        }
+        // The script spawns the binary for every name context. Installing one that
+        // cannot reach it writes a file that silently does nothing.
+        if (!d.binOnPath) {
+            return {
+                action: "skip",
+                detail: `${BIN_NAME} is not on PATH`,
+                reason: `the completion script runs \`${BIN_NAME}\`, which this shell cannot find on PATH`,
+                remedy: `put \`${BIN_NAME}\` on your PATH, then run this again`,
+            };
+        }
+        const where = `${d.shell} → ${shortenPath(d.path, roots)}`;
+        // A no-op row says what it FOUND, not just where it looked: `no change`
+        // beside a bare path leaves the reader to guess whether the script is
+        // there and current or missing and unreachable.
+        if (d.state === "installed") {
+            return { action: "none", detail: `${where} — already up to date` };
+        }
+        return {
+            action: d.state === "stale" ? "update" : "install",
+            detail: where,
+        };
+    },
+    removalPlan: (d, _scope, roots) => {
+        if (d.path === null || d.state === "absent") {
+            return { action: "none", detail: "no script installed" };
+        }
+        return { action: "remove", detail: shortenPath(d.path, roots) };
+    },
+    compose: (d) => composeCompletions(d),
+    composeRemoval: (d) => composeCompletionsRemoval(d),
+});
+const lspTarget = defineTarget({
+    id: "lsp",
+    title: "Terrazzo LSP extension",
+    scopes: ["global"],
+    detect: (rt) => detectLsp(rt.cwd),
+    plan: (d) => {
+        if (d.state === "unknown") {
+            return {
+                action: "skip",
+                detail: lspSkipReason(d),
+                reason: lspSkipReason(d),
+                remedy: LSP_SKIP_REMEDY,
+            };
+        }
+        // One child per detected editor, exactly like the mcp row's files: a
+        // machine with several VS Code forks on PATH should not have the extension
+        // pushed into all of them because they happen to be installed.
+        const children = d.editors.map((e) => ({
+            key: e.editor.cli,
+            label: `${e.editor.cli} — ${e.editor.name}`,
+            action: e.installed ? "unchanged" : "add",
+        }));
+        // The detail names WHAT is being placed and WHERE — never the row's own
+        // state, which the action column already carries. `installed (VSCodium)`
+        // beside a child row reading `codium — VSCodium (unchanged)` said the
+        // editor's name twice and "nothing happens here" twice.
+        if (d.state === "installed") {
+            return {
+                action: "none",
+                detail: `Terrazzo extension in ${lspEditorNames(d).join(", ")}`,
+                children,
+            };
+        }
+        const pending = d.editors.filter((e) => !e.installed);
+        return {
+            action: "install",
+            detail: `Terrazzo extension → ${pending
+                .map((e) => e.editor.name)
+                .join(", ")}`,
+            children,
+        };
+    },
+    removalPlan: (d) => {
+        // No editor CLI on PATH is the SAME named skip the forward plan reports:
+        // there is nothing on this machine to run an uninstall with.
+        if (d.state === "unknown") {
+            return {
+                action: "skip",
+                detail: lspSkipReason(d),
+                reason: lspSkipReason(d),
+                remedy: LSP_SKIP_REMEDY,
+            };
+        }
+        // Removal is composed from what detection says we OWN — a copy that is
+        // present, whatever its version. The forward plan's version gate would let
+        // a dead pre-0.8.3 copy this command installed survive its own `--undo`.
+        const owned = ownedLspEditors(d);
+        if (owned.length === 0) {
+            return { action: "none", detail: "no editor carries the extension" };
+        }
+        return {
+            action: "remove",
+            detail: `Terrazzo extension from ${owned
+                .map((e) => e.editor.name)
+                .join(", ")}`,
+            children: owned.map((e) => ({
+                key: e.editor.cli,
+                label: `${e.editor.cli} — ${e.editor.name}`,
+                action: "update",
+            })),
+        };
+    },
+    compose: (d, chosen) => composeLsp(d, chosen),
+    composeRemoval: (d) => composeLspRemoval(d),
+});
+/**
+ * Why the `mcp` row has nothing to write in a scope — authored once, because
+ * `setup`'s row and `doctor`'s row are the same finding and must not word it
+ * differently. Neither sentence says "scope": the two scopes are `global` and
+ * `local project`, after the `--global` / `--local` flags that select them.
+ */
+export const MCP_NO_LOCATION = {
+    global: "no AI harness on this machine keeps a global config",
+    project: "no AI harness in this project keeps a per-project config",
+};
+/** One MCP file as a plan child: its path, the harnesses sharing it, its state. */
+const mcpChild = (d, group, roots) => {
+    const state = mcpGroupState(d, group.path);
+    return {
+        key: group.path,
+        label: shortenPath(group.path, roots),
+        action: state === "registered"
+            ? "unchanged"
+            : state === "drifted"
+                ? "update"
+                : "add",
+    };
+};
+const mcpTarget = defineTarget({
+    id: "mcp",
+    title: "MCP server registration",
+    scopes: ["global", "project"],
+    detect: (rt, scope) => detectMcp(rt, scope),
+    plan: (d, scope, roots) => {
+        if (d.groups.length === 0) {
+            return {
+                action: "skip",
+                detail: MCP_NO_LOCATION[scope],
+                reason: MCP_NO_LOCATION[scope],
+            };
+        }
+        const children = d.groups.map((group) => mcpChild(d, group, roots));
+        const pending = children.filter((c) => c.action !== "unchanged");
+        return {
+            action: pending.length === 0 ? "none" : "update",
+            detail: `${d.groups.length} ${d.groups.length === 1 ? "config file" : "config files"}`,
+            children,
+        };
+    },
+    removalPlan: (d, _scope, roots) => {
+        const owned = ownedMcpGroups(d);
+        if (owned.length === 0) {
+            return { action: "none", detail: "no entry to remove" };
+        }
+        return {
+            action: "remove",
+            detail: `${owned.length} ${owned.length === 1 ? "config file" : "config files"}`,
+            children: owned.map((group) => ({
+                key: group.path,
+                label: shortenPath(group.path, roots),
+                action: "update",
+            })),
+        };
+    },
+    compose: (d, chosen) => composeMcp(d, chosen ? selectedGroups(d, chosen) : d.groups),
+    composeRemoval: (d) => composeMcpRemoval(d),
+});
+const skillsTarget = defineTarget({
+    id: "skills",
+    title: "Skill symlinks",
+    scopes: ["global", "project"],
+    detect: (rt, scope) => detectSkills(rt, scope),
+    plan: (d, scope, roots) => {
+        // A forward run RECONCILES: stale links this scope owns are its work too, so
+        // an orphan-only tree is actionable rather than a row that plans `none` and
+        // is then deselected into doing nothing. `staleSkillLinks` carries the
+        // absent-root safety gate, so a machine whose source root does not exist
+        // contributes no sweep and the row falls back to the honest skip.
+        const stale = staleSkillLinks(d);
+        if (!d.available && stale.length === 0) {
+            const short = shortenPath(d.sourceRoot, roots);
+            const reason = skillsSkipReason(short, scope, d.rootExists);
+            // A skip with no remedy is a dead end — this one names the command that
+            // fills the scope's source root, exactly as the completions and lsp skips
+            // beside it name theirs.
+            return {
+                action: "skip",
+                detail: reason,
+                reason,
+                remedy: skillsSkipRemedy(short, scope),
+            };
+        }
+        const dirs = d.targets.map((t) => shortenPath(t.dir, roots)).join(", ");
+        const where = `${d.skillCount} ${d.skillCount === 1 ? "skill" : "skills"} → ${d.targets.length} ${d.targets.length === 1 ? "folder" : "folders"} (${dirs})`;
+        const detail = stale.length === 0
+            ? where
+            : `${where}, ${stale.length} stale ${stale.length === 1 ? "link" : "links"} to remove`;
+        const pending = d.actions.filter((a) => a.action !== "skipped");
+        if (pending.length > 0)
+            return { action: "link", detail };
+        // Nothing to link, but something to retire: `update` is the table's word
+        // for "this row has work that is not a fresh install".
+        if (stale.length > 0)
+            return { action: "update", detail };
+        return { action: "none", detail };
+    },
+    removalPlan: (d, _scope, roots) => {
+        const owned = ownedSkillLinks(d);
+        if (owned.length === 0) {
+            return { action: "none", detail: "no link to remove" };
+        }
+        const dirs = [...new Set(owned.map((a) => shortenPath(a.linkPath, roots)))];
+        return {
+            action: "remove",
+            detail: `${owned.length} ${owned.length === 1 ? "link" : "links"}`,
+            children: dirs.map((dir) => ({
+                key: dir,
+                label: dir,
+                action: "update",
+            })),
+        };
+    },
+    compose: (d) => composeSkills(d),
+    composeRemoval: (d) => composeSkillsRemoval(d),
+});
+/** THE table, in display order. */
+export const TARGETS = [
+    configTarget,
+    completionsTarget,
+    lspTarget,
+    mcpTarget,
+    skillsTarget,
+];
+/** Look a row up by id. */
+export const findTarget = (id) => TARGETS.find((target) => target.id === id);
+/** Whether a target can be installed into a scope. */
+export const supportsScope = (target, scope) => target.scopes.includes(scope);
+//# sourceMappingURL=targets.js.map

package/dist/src/capabilities/setup/targets.js.map

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

package/dist/src/capabilities/setup/types.js

@@ -0,0 +1,5 @@
+/**
+ * Data shapes for `pragma setup` and its sub-verbs.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/capabilities/setup/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/capabilities/setup/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,137 @@
+/**
+ * Guard an `exec`-composing Task against a silently-swallowed nonzero exit.
+ *
+ * The `@canonical/task` interpreter RESOLVES the `exec` effect on a nonzero exit
+ * code — it only REJECTS on a spawn error (e.g. ENOENT). A consumer that yields
+ * `exec` and ignores `ExecResult.exitCode` therefore reports a failed command
+ * (the common case being an EACCES-denied global `npm i -g`) as a silent
+ * success, discarding the subprocess's own stderr. Every `exec` consumer in
+ * `next/src` (`upgrade`, `setup lsp`) calls this immediately after its `exec`
+ * yield, so a failed subprocess surfaces as UNSUPPORTED (exit 1) carrying the
+ * command and the captured stderr instead of being reported as done.
+ *
+ * A denied `npm i -g` (EACCES), a registry/network failure, or any other
+ * nonzero exit is a fixable ENVIRONMENT condition — NOT a pragma bug — so it is
+ * classified UNSUPPORTED with an actionable recovery, never INTERNAL_ERROR's
+ * "report this issue". (A spawn error like ENOENT REJECTS the effect
+ * instead of resolving, so it never reaches here.)
+ */
+import { fail, pure, recover, } from "@canonical/task";
+import { PragmaError } from "../../kernel/error/index.js";
+/**
+ * Route a {@link PragmaError} through the Task FAILURE CHANNEL (a `Fail` node
+ * carrying the error as `cause`) instead of a synchronous throw.
+ *
+ * The distinction is load-bearing: a synchronous throw from a bind/recover
+ * continuation ESCAPES the interpreter's trampoline entirely — no enclosing
+ * `recover` can see it — whereas a `Fail` node unwinds to the nearest recovery
+ * frame. Setup's run-all isolates each step with `recover` so one failed step
+ * cannot abort the rest (S1-1); that only works if step failures travel the
+ * failure channel. The boundary (`asPragmaError`) unwraps the carried cause,
+ * so a failure that escapes un-recovered still renders with its own code,
+ * message, and recovery — never the INTERNAL_ERROR catch-all.
+ */
+export function failPragma(error) {
+    return fail({ code: error.code, message: error.message, cause: error });
+}
+/**
+ * The failure-channel sibling of {@link assertExecOk}: yield `pure(undefined)`
+ * on exit 0, otherwise fail with an UNSUPPORTED {@link PragmaError} carrying
+ * the command, exit code, trimmed stderr, and the CALLER'S recovery — the
+ * recovery must name an action that works on this machine now, not the generic
+ * "permissions or network" guess.
+ *
+ * @param command - Human-readable command, surfaced in the error message.
+ * @param result - The {@link ExecResult} the `exec` effect yielded.
+ * @param recovery - The actionable, site-specific recovery.
+ * @returns A Task that succeeds on exit 0 and fails (recoverably) otherwise.
+ */
+export function checkExecOk(command, result, recovery) {
+    if (result.exitCode === 0)
+        return pure(undefined);
+    const stderr = result.stderr.trim();
+    return failPragma(new PragmaError({
+        code: "UNSUPPORTED",
+        message: `\`${command}\` exited with code ${result.exitCode}.${stderr ? `\n${stderr}` : ""}`,
+        recovery,
+    }));
+}
+/**
+ * Raise UNSUPPORTED when an `exec` result carries a nonzero exit code.
+ *
+ * @param command - Human-readable command, surfaced in the error message.
+ * @param result - The {@link ExecResult} the `exec` effect yielded.
+ * @throws PragmaError UNSUPPORTED (exit 1) when `result.exitCode !== 0`,
+ *   including the trimmed stderr when the subprocess emitted any, plus an
+ *   actionable recovery (a permissions/network failure the user can retry).
+ */
+export function assertExecOk(command, result) {
+    if (result.exitCode === 0)
+        return;
+    const stderr = result.stderr.trim();
+    throw new PragmaError({
+        code: "UNSUPPORTED",
+        message: `\`${command}\` exited with code ${result.exitCode}.${stderr ? `\n${stderr}` : ""}`,
+        recovery: {
+            message: "Check the command's output above; a global install may need elevated privileges.",
+        },
+    });
+}
+/**
+ * True when a rejected/normalised `exec` error is a missing-binary spawn failure.
+ *
+ * A spawn `ENOENT` (the command is absent from PATH) REJECTS the `exec` effect —
+ * unlike a nonzero exit, which RESOLVES it (see {@link assertExecOk}). The task
+ * interpreter normalises that reject into a `FILE_NOT_FOUND` TaskError carrying
+ * the raw spawn error as `.cause`, so this unwraps one level to recognise both
+ * the raw and normalised shapes.
+ *
+ * @param error - The thrown/rejected value (raw spawn error or its TaskError).
+ * @returns Whether it denotes a binary missing from PATH.
+ */
+export function isMissingBinaryError(error) {
+    const codeOf = (value) => value && typeof value === "object" && "code" in value
+        ? value.code
+        : undefined;
+    if (codeOf(error) === "ENOENT")
+        return true;
+    const cause = error?.cause;
+    return codeOf(cause) === "ENOENT";
+}
+/**
+ * Wrap an `exec`-composing Task so a missing-binary spawn (ENOENT) surfaces as a
+ * named UNSUPPORTED "`<bin>` not found on PATH" error with actionable recovery,
+ * rather than the interpreter's raw reject collapsing to INTERNAL_ERROR ("please
+ * report this issue") at the CLI/MCP boundary. Every spawn site that may hit an
+ * absent binary (`upgrade`'s package manager, `setup lsp`'s `bunx`) wraps its
+ * Task with this so they never reach the catch-all.
+ *
+ * Only real execution can trip it: a dry-run/plan mocks `exec` (exit 0, no
+ * spawn), so the guard is transparent to the preview. A nonzero exit RESOLVES
+ * the effect and is still {@link assertExecOk}'s job (its throw is a synchronous
+ * generator-body throw, not an effect failure, so it bypasses this handler); any
+ * other effect failure re-raises unchanged.
+ *
+ * @param bin - The binary name surfaced in the error message.
+ * @param recovery - The install/PATH recovery hint.
+ * @param task - The Task whose `exec` effect may reject with ENOENT.
+ * @returns The Task, guarded against a missing-binary spawn.
+ */
+export function guardMissingBinary(bin, recovery, task) {
+    return recover(task, (error) => {
+        if (isMissingBinaryError(error)) {
+            // Failure CHANNEL, not a synchronous throw: an enclosing recover (the
+            // run-all's per-step isolation, S1-1) must be able to catch this, and
+            // the boundary unwraps the carried PragmaError when nothing does.
+            return failPragma(new PragmaError({
+                code: "UNSUPPORTED",
+                message: `\`${bin}\` was not found on your PATH.`,
+                recovery,
+            }));
+        }
+        // Not a missing binary — re-raise unchanged (the interpreter rethrows it as
+        // a TaskExecutionError, exactly as it would with no guard installed).
+        return fail(error);
+    });
+}
+//# sourceMappingURL=assertExecOk.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assertExecOk.js","sourceRoot":"","sources":["../../../../src/capabilities/shared/assertExecOk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAEL,IAAI,EACJ,IAAI,EACJ,OAAO,GAER,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,OAAO,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,MAAkB,EAClB,QAAkB;IAElB,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACpC,OAAO,UAAU,CACf,IAAI,WAAW,CAAC;QACd,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,KAAK,OAAO,uBAAuB,MAAM,CAAC,QAAQ,IACzD,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAC3B,EAAE;QACF,QAAQ;KACT,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,MAAkB;IAC9D,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,WAAW,CAAC;QACpB,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,KAAK,OAAO,uBAAuB,MAAM,CAAC,QAAQ,IACzD,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAC3B,EAAE;QACF,QAAQ,EAAE;YACR,OAAO,EACL,kFAAkF;SACrF;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,MAAM,GAAG,CAAC,KAAc,EAAW,EAAE,CACzC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK;QACnD,CAAC,CAAE,KAA2B,CAAC,IAAI;QACnC,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,KAAK,GAAI,KAAgD,EAAE,KAAK,CAAC;IACvE,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,QAAkB,EAClB,IAAa;IAEb,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;QAC7B,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,sEAAsE;YACtE,sEAAsE;YACtE,kEAAkE;YAClE,OAAO,UAAU,CACf,IAAI,WAAW,CAAC;gBACd,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,KAAK,GAAG,gCAAgC;gBACjD,QAAQ;aACT,CAAC,CACH,CAAC;QACJ,CAAC;QACD,4EAA4E;QAC5E,sEAAsE;QACtE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * The cross-capability shared surface — the few facts more than one capability
+ * needs and none of them owns.
+ *
+ * Everything here earned its place by being needed in two capabilities at
+ * once, and the cohesion principle is that shortness of the list. `shared/` is
+ * not a utility drawer: a helper used by exactly one capability belongs in
+ * that capability, and the moment something here has a single consumer again
+ * it should move back. What survives is the environment the CLI reports on but
+ * does not own — how it was installed, what the registry says about it,
+ * whether a subprocess it ran actually succeeded. (The scope labels that keep
+ * `setup` and `doctor` calling the two config scopes by the same names used
+ * to live here too; they are part of the rendering vocabulary now —
+ * `kernel/render/vocabulary.ts` — beside the statuses and glyphs they are
+ * printed with.)
+ *
+ * The exec guard is exported as the pair a caller needs together: `checkExecOk`
+ * to classify a result inside a Task and `assertExecOk` to throw on one
+ * outside, with `guardMissingBinary` wrapping the absent-binary case that
+ * neither should report as a pragma bug. The predicates they are built from
+ * stay internal — a caller reaching for the predicate instead of the guard is
+ * a caller about to reimplement the classification.
+ */
+export { assertExecOk, checkExecOk, guardMissingBinary, } from "./assertExecOk.js";
+export { detectInstallSource, pmUpdateCommand, updateGuidance, } from "./packageManager.js";
+export { checkRegistryVersion, PRAGMA_PACKAGE } from "./registry.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/capabilities/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,YAAY,EACZ,WAAW,EACX,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}