@canonical/pragma-cli 0.34.0 → 0.35.0

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

@@ -0,0 +1,53 @@
+/**
+ * Setup's interaction decision — the SAME `decideInteraction` `create`'s mount
+ * calls, against the same TTY gate, with two declared adaptations.
+ *
+ * (a) `explicitComplete` is constantly `false`. Setup's prompts are
+ * PLAN-SHAPING (which rows, which files), not data-bearing; none has or should
+ * grow a flag form, so no invocation can be "explicitly complete" in `create`'s
+ * sense. Feeding the prompts honestly would be worse than the constant:
+ * `explicitAnswersComplete([], {})` is vacuously true, so the promptless
+ * sub-verbs would silently MUTATE on a bare piped invocation — which is the
+ * exact trap this design closes. The constant degenerates the table to
+ * `dry-run > undo > yes > wizard > preview`.
+ *
+ * (b) The `refuse` mode renders the preview. `create` refuses because
+ * scaffolding from defaults without complete input is dangerous AND it can name
+ * the missing flags. Setup has no missing flags to name — the refusal body would
+ * be empty advice — and the genuinely useful artifact is the plan itself. So
+ * setup's refusal IS the dry-run plan plus one hint line, at exit 0: the
+ * invocation completed a meaningful read-only unit of work, and a script author
+ * who forgot `--yes` reads the hint on the very output they are capturing.
+ *
+ * An MCP tool call is programmatic consent: `transport === "mcp"` resolves as if
+ * `--yes` were passed. The band default applies there too — the tool writes the
+ * global band unless told otherwise.
+ */
+/**
+ * Lift the decision inputs off a runtime. A tool call over MCP counts as `yes`.
+ *
+ * @param rt - The per-invocation runtime.
+ * @returns The four inputs.
+ */
+export function setupModeInput(rt) {
+    const interaction = rt.interaction;
+    return {
+        dryRun: rt.mutation?.preview === true,
+        undo: rt.mutation?.undo === true,
+        yes: interaction?.yes === true || interaction?.transport === "mcp",
+        isTTY: interaction?.isTTY === true,
+    };
+}
+/**
+ * Resolve the interaction mode, mirroring `create`'s `resolveCreateMode` so the
+ * cross-CLI test style can pin both against the one shared decision.
+ *
+ * @param input - The four inputs.
+ * @param decide - The shared decision, injected so this module needs no value
+ *   import of summon-core (it stays behind the verb's lazy import).
+ * @returns The resolved mode.
+ */
+export function resolveSetupMode(input, decide) {
+    return decide({ ...input, explicitComplete: false }).mode;
+}
+//# sourceMappingURL=mode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../../../../src/capabilities/setup/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAaH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAiB;IAC9C,MAAM,WAAW,GAAG,EAAE,CAAC,WAAW,CAAC;IACnC,OAAO;QACL,MAAM,EAAE,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI;QACrC,IAAI,EAAE,EAAE,CAAC,QAAQ,EAAE,IAAI,KAAK,IAAI;QAChC,GAAG,EAAE,WAAW,EAAE,GAAG,KAAK,IAAI,IAAI,WAAW,EAAE,SAAS,KAAK,KAAK;QAClE,KAAK,EAAE,WAAW,EAAE,KAAK,KAAK,IAAI;KACnC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAqB,EACrB,MAM+B;IAE/B,OAAO,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC;AAC5D,CAAC"}

package/dist/src/capabilities/setup/operations/index.js

@@ -0,0 +1,39 @@
+/**
+ * The setup operations — one module per installable target, each answering the
+ * same three questions about it.
+ *
+ * `setup` and `doctor` are two projections of ONE target table, and this is
+ * where that table's cells live. Every target module exports the same trio: a
+ * `detect*` that reads the machine and returns that target's detection record,
+ * a `compose*` that turns a detection into the Task which installs it, and a
+ * `compose*Removal` that turns the same detection into the Task which undoes
+ * it. Nothing here decides WHICH targets run or in what order — `targets.ts`
+ * owns that — so a new target is a new module plus a row, and neither surface
+ * has to learn about it twice.
+ *
+ * The detection types are part of the surface, not an implementation leak: a
+ * detection is the value passed from the read half to the compose half and on
+ * to the plan rows, so `doctor`'s banded checks name the same records `setup`
+ * acts on. The presentation helpers travel with them for the same reason — a
+ * skip reason or an uninstall remedy is derived from one detection, and
+ * deriving it twice is how the two surfaces start disagreeing about the same
+ * machine.
+ *
+ * `buildSetupRun` sits apart: it is the run assembler that drives every
+ * selected target's detection and projects the result into a plan and a summon
+ * generator. It is reached through a DYNAMIC import from `setup.verb.ts` so
+ * the wizard's React/Ink dependency stays off the `--help`/`__complete` fast
+ * path — a consumer that routes it through this barrel statically would undo
+ * that, and the setup guard test would say so.
+ *
+ * Deliberately internal: the config seed literal, the per-target message
+ * builders, and the MCP entry writer. They are inputs to the composers above,
+ * not operations a caller performs.
+ */
+export { composeCompletions, composeCompletionsRemoval, detectCompletions, } from "./setupCompletions.js";
+export { composeConfigFile, composeConfigRemoval, detectConfigFile, } from "./setupConfig.js";
+export { buildSetupRun } from "./setupGenerator.js";
+export { composeLsp, composeLspRemoval, detectLsp, LSP_SKIP_REMEDY, lspEditorNames, lspSkipReason, lspUninstallRemedy, } from "./setupLsp.js";
+export { composeMcp, composeMcpRemoval, detectMcp, mcpGroupState, ownedMcpGroups, selectedGroups, } from "./setupMcp.js";
+export { composeSkills, composeSkillsRemoval, detectSkills, ownedSkillLinks, skillsSkipReason, } from "./setupSkills.js";
+//# sourceMappingURL=index.js.map

package/dist/src/capabilities/setup/operations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/capabilities/setup/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,cAAc,EACd,aAAa,EACb,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/src/capabilities/setup/operations/setupCompletions.js

@@ -0,0 +1,160 @@
+/**
+ * `setup completions` — install the static shell-completion script.
+ *
+ * Split into a `detect` phase (a REAL read of the shell, the `completion` config,
+ * and the grammar-driven `emitScripts(capabilities)` body — with the config's
+ * `minChars` gate and per-family opt-out baked in at emit time — done up front so
+ * the wizard's recap/preview and a `--dry-run` are accurate) and a pure `compose`
+ * phase (the file write the dry-run interpreter mocks). The script body is the
+ * static tier the covenant names ("shell script tier emitted by
+ * `setup completions`").
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { deleteFile, mkdir, sequence_, writeFile, } from "@canonical/task";
+import { BIN_NAME } from "../../../constants.js";
+import { completionScriptPath, detectShell, } from "../shell.js";
+/**
+ * Whether the host would resolve a bare command name — the same probe the `mcp`
+ * row uses for its entry's command, asked here of the binary the installed
+ * completion script spawns.
+ *
+ * The candidate paths come from `@canonical/harnesses`' `executableCandidates`,
+ * which owns the PATH split and the win32 `PATHEXT` rules in one place. Joining
+ * the bare name onto each PATH directory found NOTHING on Windows, where npm
+ * installs this CLI as a `.cmd` shim: `setup completions` skipped with "not on
+ * PATH" on a machine where typing the command works.
+ *
+ * @param command - The bare binary name.
+ * @param platform - The captured host (injected by the tests).
+ * @returns Whether the host holds an executable under that name.
+ * @note Impure — tests each candidate path on the filesystem.
+ */
+async function binaryOnPath(command, platform) {
+    const { executableCandidates, readPlatformEnv } = await import("@canonical/harnesses");
+    return executableCandidates(command, platform ?? readPlatformEnv()).some((candidate) => existsSync(candidate));
+}
+/**
+ * Classify the completion script already at `path` against the body we would
+ * write: `installed` when byte-identical (a re-run skips it), `stale` when a
+ * different script is present, `absent` when no file exists.
+ *
+ * @param path - The install path.
+ * @param script - The body a write would emit.
+ * @returns The prior {@link CompletionsState}.
+ * @note Impure — reads the install path.
+ */
+function classifyCompletions(path, script) {
+    if (!existsSync(path))
+        return "absent";
+    try {
+        return readFileSync(path, "utf8") === script ? "installed" : "stale";
+    }
+    catch {
+        return "stale";
+    }
+}
+/**
+ * Detect the shell and pre-render its completion script, baking in the
+ * `completion` config (read from `cwd`): `minChars` gates the `__complete` exec
+ * in the emitted scripts, and a family mapped to `false` drops its name
+ * completion. Read here at emit time — never on the storeless `__complete` fast
+ * path.
+ *
+ * @param cwd - Directory the `completion` config layers are resolved from.
+ * @param injected - A detection to use instead of probing (tests).
+ * @param platform - A captured host to use instead of reading this one (tests).
+ * @returns The install target, or an all-`null` shape when `$SHELL` is unset.
+ * @note Impure — reads `$SHELL`, the capability registry, and the config layers.
+ */
+export async function detectCompletions(cwd, injected, platform) {
+    const detection = injected ?? detectShell();
+    const binOnPath = await binaryOnPath(BIN_NAME, platform);
+    if (detection.kind !== "detected") {
+        return {
+            shell: null,
+            path: null,
+            script: null,
+            state: "absent",
+            detection,
+            binOnPath,
+        };
+    }
+    const shell = detection.shell;
+    const [{ capabilities }, { emitScripts }, { readConfig }] = await Promise.all([
+        import("../../index.js"),
+        import("../../../kernel/completion/emitScripts.js"),
+        import("../../../kernel/config/readConfig.js"),
+    ]);
+    const { config } = await readConfig(cwd);
+    const completion = config.completion;
+    const disabledFamilies = completion?.families
+        ? Object.entries(completion.families)
+            .filter(([, enabled]) => enabled === false)
+            .map(([family]) => family)
+        : undefined;
+    const path = completionScriptPath(shell);
+    const script = emitScripts(capabilities, {
+        ...(completion?.minChars !== undefined
+            ? { minChars: completion.minChars }
+            : {}),
+        ...(disabledFamilies && disabledFamilies.length > 0
+            ? { disabledFamilies }
+            : {}),
+    })[shell];
+    return {
+        shell,
+        path,
+        script,
+        state: classifyCompletions(path, script),
+        detection,
+        binOnPath,
+    };
+}
+/**
+ * Compose the completion-script write from a detection.
+ *
+ * Built from re-runnable combinators (NOT a single-use `gen`): `execute`
+ * interprets a generator's task TWICE — once for the confirm-gate preview and
+ * once to perform it — so the composed task must survive a second drive.
+ *
+ * An `installed` (byte-identical) script composes NOTHING. The write used to
+ * happen anyway so that `--undo` had a reversible effect to find; removal is
+ * now composed from detection instead ({@link composeCompletionsRemoval}), so
+ * the forward path is free to be quiet: a converged re-run leaves the file's
+ * mtime alone.
+ *
+ * The task carries no log effects. What a run says about this target is the
+ * plan row's business — one structure, rendered the same way in the preview,
+ * the progress line and the recap.
+ *
+ * @param d - The detection gathered up front.
+ * @returns A Task that installs the script, or an empty Task when it is current.
+ */
+export function composeCompletions(d) {
+    if (d.shell === null || d.path === null || d.script === null) {
+        return sequence_([]);
+    }
+    if (d.state === "installed")
+        return sequence_([]);
+    return sequence_([
+        mkdir(dirname(d.path), true),
+        writeFile(d.path, d.script, { undo: deleteFile(d.path) }),
+    ]);
+}
+/**
+ * Compose the removal of an installed script: the forward effect re-asserts the
+ * script (idempotent) and carries its deletion as `undo`, which is what the undo
+ * interpreter executes. An absent script composes nothing, so `--undo` on a
+ * machine that never installed one reverses zero steps and says so.
+ *
+ * @param d - The detection gathered up front.
+ * @returns A Task whose undo deletes the installed script.
+ */
+export function composeCompletionsRemoval(d) {
+    if (d.path === null || d.script === null || d.state === "absent") {
+        return sequence_([]);
+    }
+    return sequence_([writeFile(d.path, d.script, { undo: deleteFile(d.path) })]);
+}
+//# sourceMappingURL=setupCompletions.js.map

package/dist/src/capabilities/setup/operations/setupCompletions.js.map

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

package/dist/src/capabilities/setup/operations/setupConfig.js

@@ -0,0 +1,101 @@
+/**
+ * `setup config` — seed the global config file with `{}`.
+ *
+ * This target exists because the seed used to happen BEFORE consent: a
+ * first-run pipeline step wrote `$XDG_CONFIG_HOME/<bin>/config.json` on every
+ * non-help invocation, so a read-only command mutated the machine and a banner
+ * interleaved itself into mutating runs. The config layers already treat the
+ * missing file as "every field at its built-in default", so nothing needed the
+ * write except honesty about provenance — which is exactly the kind of thing a
+ * consented setup run is for.
+ *
+ * Split into `detectConfigFile` (a real read of the file and its contents) and
+ * the pure compose/removal bodies, like every other target.
+ *
+ * Removal is ownership-checked: the seeded file is deleted ONLY while it still
+ * parses to `{}`. A config the user has edited is theirs, and `--undo` reports
+ * that it kept it rather than quietly taking a machine's settings with it.
+ */
+import { readFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { deleteFile, info, mkdir, sequence_, writeFile, } from "@canonical/task";
+// DIRECT LEAF IMPORT, not `config/index.js`. The barrel re-exports
+// `readConfig`, which reaches `defaults.ts` → `schema.ts` → `zod`. This
+// module is on the setup/doctor target table, so routing one path constant
+// through the barrel would make both commands pay for the config parser
+// just to compute a filename.
+import { globalConfigPath } from "../../../kernel/config/paths.js";
+/** Seed content: an empty object, so nothing is pinned the user did not choose. */
+export const SEED_CONFIG = "{}\n";
+/** Whether a config body is the untouched seed: valid JSON with no keys. */
+function isSeedBody(body) {
+    try {
+        const parsed = JSON.parse(body);
+        return (typeof parsed === "object" &&
+            parsed !== null &&
+            !Array.isArray(parsed) &&
+            Object.keys(parsed).length === 0);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read the global config file's state up front.
+ *
+ * @returns The detected {@link ConfigDetection}.
+ * @note Impure — reads the global config path.
+ */
+export async function detectConfigFile() {
+    const path = globalConfigPath();
+    let body;
+    try {
+        body = readFileSync(path, "utf-8");
+    }
+    catch {
+        return { path, exists: false, parses: false, isSeed: false };
+    }
+    let parses = true;
+    try {
+        JSON.parse(body);
+    }
+    catch {
+        parses = false;
+    }
+    return { path, exists: true, parses, isSeed: isSeedBody(body) };
+}
+/**
+ * Compose the seed write. An existing file composes NOTHING — quiet
+ * convergence: a re-run must not rewrite bytes it would only replace with
+ * themselves, because a byte-identical rewrite still moves the mtime and still
+ * risks clobbering a concurrent edit for no gain.
+ *
+ * @param d - The detection gathered up front.
+ * @returns A Task that seeds the config, or an empty Task when it is present.
+ */
+export function composeConfigFile(d) {
+    if (d.exists)
+        return sequence_([]);
+    return sequence_([
+        mkdir(dirname(d.path), true),
+        writeFile(d.path, SEED_CONFIG, { undo: deleteFile(d.path) }),
+    ]);
+}
+/**
+ * Compose the removal: delete the file only while it is still the untouched
+ * seed. The forward effect re-asserts the seed (idempotent) and carries the
+ * delete as its `undo`, which is what the undo interpreter executes.
+ *
+ * @param d - The detection gathered up front.
+ * @returns A Task whose undo removes a seed-only config, or an empty Task.
+ */
+export function composeConfigRemoval(d) {
+    if (!d.exists || !d.isSeed)
+        return sequence_([]);
+    return sequence_([
+        writeFile(d.path, SEED_CONFIG, { undo: deleteFile(d.path) }),
+    ]);
+}
+/** The line a removal prints when the file carries the user's own settings. */
+export const configKeptMessage = (path) => info(`Kept ${path} — it holds your settings.`);
+//# sourceMappingURL=setupConfig.js.map

package/dist/src/capabilities/setup/operations/setupConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupConfig.js","sourceRoot":"","sources":["../../../../../src/capabilities/setup/operations/setupConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,UAAU,EACV,IAAI,EACJ,KAAK,EACL,SAAS,EAET,SAAS,GACV,MAAM,iBAAiB,CAAC;AACzB,mEAAmE;AACnE,wEAAwE;AACxE,2EAA2E;AAC3E,wEAAwE;AACxE,8BAA8B;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,mFAAmF;AACnF,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAclC,4EAA4E;AAC5E,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CACjC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC/D,CAAC;IACD,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;AAClE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAkB;IAClD,IAAI,CAAC,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC;IACnC,OAAO,SAAS,CAAC;QACf,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;QAC5B,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;KAC7D,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,CAAkB;IACrD,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC;QACf,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;KAC7D,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAc,EAAE,CAC5D,IAAI,CAAC,QAAQ,IAAI,4BAA4B,CAAC,CAAC"}