@canonical/pragma-cli 0.34.0 → 0.36.0

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

@@ -0,0 +1,387 @@
+/**
+ * The `setup` verbs — the run-all self-verb plus the five CLI-only sub-verbs
+ * (`config`/`completions`/`lsp`/`mcp`/`skills`), every one of them derived from
+ * the target table.
+ *
+ * `setup` is the ONE covenant noun that is BOTH directly runnable and has
+ * sub-verbs. All of them are storeless, interactive mutations. The sub-verbs are
+ * `mcp: false` (`buildServer` skips them, `buildProgram` still registers them);
+ * only the self-verb is an MCP tool. `destructive: false` keeps MCP from
+ * advertising the tool as destructive.
+ *
+ * THE SCOPE DEFAULT IS GLOBAL. `--scope` used to default to `both`, and `both`
+ * runs each harness's own default scope — which is `project` for most of the
+ * registry — so a bare `setup` scattered `.mcp.json`, `.gemini/settings.json`
+ * and `opencode.json` into whatever directory you happened to be standing in.
+ * The user scope is what a machine-level installer configures; the project scope
+ * is a deliberate, checked-in, team-shared choice, and is now chosen with
+ * `--local` rather than assumed.
+ *
+ * Every sub-verb registers the scope flags UNIFORMLY. That is what lets the scope
+ * answer come from the table instead of per-verb flag wiring — previously
+ * `setup completions --local` died as an unknown option, while `setup mcp
+ * --local` worked, for no reason a user could see. Asking a target for a scope it
+ * cannot honour is a usage error (exit 2) with the corrected command; asking the
+ * RUN-ALL for such a band merely filters, and the out-of-band target still shows
+ * as a named row.
+ *
+ * summon-core + the generator ops stay behind a LAZY dynamic import (mirroring
+ * `create`'s `loadCreateRuntime`), so building the command tree / `--help` /
+ * `__complete` — and `setup --yes` — load no React/Ink.
+ */
+import { $, gen, pure } from "@canonical/task";
+import { BIN_NAME } from "../../constants.js";
+import { PragmaError } from "../../kernel/error/index.js";
+import { asVerb } from "../../kernel/spec/asVerb.js";
+import { resolveSetupMode, setupModeInput } from "./mode.js";
+import { isActionable, planExitFailed, planTally, TARGET_IDS, } from "./plan.js";
+import { renderDetectionSummary, renderProgressLine, renderRecap, } from "./plan.render.js";
+import { renderDryRun, setupFormatters } from "./setup.render.js";
+/**
+ * The `--scope` flag + its `--global`/`--local` boolean sugars. Registered by
+ * EVERY setup verb, including the single-scope ones: a flag that exists on some
+ * sub-verbs and not others is a grammar the user has to memorise, and the scope
+ * a single-scope target can honour is a question the target table answers.
+ *
+ * `--global` is a synonym of the default; it stays for scripts and for symmetry
+ * with `--local`.
+ */
+const SCOPE_PARAMS = [
+    {
+        kind: "enum",
+        name: "scope",
+        doc: "Where to configure: global (your home directory, the default), project (this repository), or both.",
+        values: ["project", "global", "both"],
+        default: "global",
+    },
+    {
+        kind: "boolean",
+        name: "global",
+        doc: "Shorthand for --scope global — configure your home directory.",
+    },
+    {
+        kind: "boolean",
+        name: "local",
+        doc: "Shorthand for --scope project — configure this project only.",
+    },
+];
+/**
+ * Resolve the `--scope`/`--global`/`--local` params into a single selection.
+ * The boolean sugars win over `--scope`; `--global` wins over `--local`.
+ *
+ * @param params - The coerced param bag.
+ * @returns The resolved scope selection (defaults to `global`).
+ */
+function resolveScope(params) {
+    if (params.global === true)
+        return "global";
+    if (params.local === true)
+        return "project";
+    const scope = params.scope;
+    return scope === "project" || scope === "both" ? scope : "global";
+}
+/**
+ * Reject a sub-verb asked for a scope its target cannot hold.
+ *
+ * This is a usage error, not a skip: the user typed a contradiction, and
+ * correcting it is exactly what exit 2 means. The message names the scope the
+ * target DOES have and prints the command that works, so the correction is one
+ * paste rather than one manual page.
+ *
+ * @param mode - The sub-verb's target, or `all`.
+ * @param scope - The resolved selection.
+ * @throws PragmaError INVALID_INPUT when the target has no such scope.
+ */
+async function assertScopeIsPossible(mode, scope) {
+    if (mode === "all" || scope === "both")
+        return;
+    const { findTarget } = await import("./targets.js");
+    const target = findTarget(mode);
+    if (target === undefined || target.scopes.includes(scope))
+        return;
+    const only = target.scopes[0];
+    const level = only === "global" ? "global only" : "per-project only";
+    const asked = scope === "global" ? "globally" : "per project";
+    const corrected = only === "global"
+        ? `${BIN_NAME} setup ${mode}`
+        : `${BIN_NAME} setup ${mode} --local`;
+    throw new PragmaError({
+        code: "INVALID_INPUT",
+        message: `${mode} is ${level} — it cannot be configured ${asked}.`,
+        recovery: { message: `Run: ${corrected}` },
+    });
+}
+/** The exposed-to-MCP capability the run-all self-verb declares. */
+const SELF_CAPABILITY = {
+    needsStore: false,
+    mutates: true,
+    interactive: true,
+    destructive: false,
+    mcp: {
+        expose: true,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+    },
+};
+/** The CLI-only capability every sub-verb declares (not an MCP tool). */
+const SUB_CAPABILITY = {
+    needsStore: false,
+    mutates: true,
+    interactive: true,
+    destructive: false,
+    mcp: {
+        expose: false,
+        reason: "CLI-only environment installer",
+    },
+};
+/**
+ * The one summon↔pragma seam per setup invocation: lazily load summon-core + the
+ * generator ops, detect and plan, resolve the interaction mode, wire `rt.exec`,
+ * and return the plan with its outcomes filled in.
+ *
+ * NOTE: `rt.exec` carries NO per-call `cwd`. Unlike `create` (whose generator
+ * emits RELATIVE paths jailed to `rt.cwd`), setup's targets build ABSOLUTE
+ * effect paths themselves; the interpreter leaves absolute paths unchanged, so
+ * no per-call write root is threaded. No stamping either — setup writes
+ * symlinks, config and scripts, not generated source.
+ *
+ * @param mode - Which entry point (`all` or one target).
+ * @param rt - The per-invocation runtime (mutated: `rt.exec` and `rt.planData`).
+ * @param scope - The resolved scope selection.
+ * @returns The `Task<SetupPlan>` the dispatcher/MCP handler interprets.
+ * @note Impure — runs every target's real detection before returning a Task.
+ */
+async function runSetup(mode, rt, scope) {
+    await assertScopeIsPossible(mode, scope);
+    // Lazy dynamic imports (lazy-React discipline): summon-core's barrel is
+    // React-free, and the non-TTY branch picks autoPrompt/mcpPrompt (never mounts
+    // Ink), so `setup --yes` loads no React — the guard test enforces this.
+    const [summon, projection, ops] = await Promise.all([
+        import("@canonical/summon-core"),
+        import("@canonical/summon-core/projection"),
+        import("./operations/setupGenerator.js"),
+    ]);
+    const input = setupModeInput(rt);
+    const run = await ops.buildSetupRun(rt, mode, scope, input.undo);
+    const interactionMode = resolveSetupMode(input, projection.decideInteraction);
+    // The dry-run seam: the kernel's `--dry-run` branch renders THIS instead of
+    // the raw effect dump, while its honest preview still runs underneath and
+    // still fails exactly when the real run would.
+    rt.planData = { ...run.plan, preview: true };
+    // Whether this invocation only PREVIEWS. The task below is driven either way
+    // — that is what makes the preview honest — so anything it says out loud has
+    // to know which of the two it is.
+    const previewing = interactionMode === "batch-dry-run";
+    // A CONVERGED machine has no question to ask. Every row is `none` or `skip`,
+    // so nothing composes an effect — and the wizard's confirm gate then mounted
+    // Ink to render summon-core's "No operations planned." above a "Proceed?"
+    // over an empty tally. For a sub-verb, whose prompt list is empty, that
+    // contentless gate was the FIRST AND ONLY thing the user ever saw. The
+    // explanation existed the whole time (each row's `none` detail, one child row
+    // per file/editor marked `unchanged`) and was dropped at the render seam.
+    //
+    // So: report the plan instead of asking a question with no content. There is
+    // no `preview: true` here — the run really did complete. `applied({})` marks
+    // each `none` row `{status:"noop", note:"unchanged"}`, `wasApplied` is then
+    // true, and `setupFormatters.plain` renders the recap. That also retires a
+    // second defect: a non-interactive converged run used to print the misleading
+    // "Nothing was applied. Run again with --yes to apply." over an all-`none`
+    // plan. A run whose every DETECTION threw is not converged in this sense —
+    // its rows are skips that report `failed` — so it falls through to the normal
+    // path, which is the one that raises.
+    if (!previewing && run.plan.rows.every((row) => !isActionable(row.action))) {
+        const converged = run.applied({});
+        if (!planExitFailed(converged))
+            return pure(converged);
+    }
+    // Adaptation (b): a non-interactive run without `--yes` previews rather than
+    // mutating. It is the same plan the dry-run prints, plus one hint line, at
+    // exit 0 — the invocation completed a real read-only unit of work.
+    if (interactionMode === "refuse") {
+        return pure({ ...run.plan, preview: true });
+    }
+    // Say what was DETECTED before asking anything about it. The data has been
+    // sitting in `run.plan` since before the prompt list was built — `inkPrompt`
+    // mounts no React until the first Prompt effect — so this is a rendering gap,
+    // not an ordering one, and closing it is nearly free.
+    //
+    // It MUST be emitted here, before `execute` is driven: the summary and the
+    // Ink frame both write to stderr, and only a line written first lands in
+    // scrollback ABOVE the frame. `rt.report` is the non-Ink seam — `--quiet`
+    // silences it and it is a no-op over MCP — so no React is loaded to print it.
+    // A preview says nothing here: the plan table IS its output.
+    if (!previewing) {
+        const summary = renderDetectionSummary(run.plan, {
+            verbose: rt.globalFlags.verbose,
+        });
+        if (summary !== undefined)
+            rt.report?.(summary);
+    }
+    const { transport, yes, signal, abort } = rt.interaction ?? {
+        isTTY: false,
+        transport: "cli",
+        yes: true,
+    };
+    // TTY without --yes → the Ink wizard (recap + live progress). Its callbacks
+    // ride rt.exec; `onCancel` threads the run's abort in so an in-Ink Ctrl-C
+    // during execution actually stops the writes.
+    let task;
+    const wizard = interactionMode === "wizard";
+    if (wizard) {
+        const session = summon.inkPrompt(run.generator, {
+            signal,
+            onCancel: abort,
+        });
+        // Live progress in the PLAN's units, not the interpreter's: the wizard's
+        // default execution view is the per-effect transcript — right for `create`,
+        // whose unit of work IS the file, and wrong here, where one unit is one
+        // configured target and the transcript renders eighteen symlink rows for
+        // the row the plan called `skills  link  9 skills → 2 folders`. Each row
+        // event carries the SAME sentence `renderProgressLine` prints, so the
+        // watcher and the recap reader see one dialect. `--verbose` withholds the
+        // listener, which falls the wizard back to the full effect transcript —
+        // the same detected-only-unless-verbose rule the detection summary and
+        // doctor already follow.
+        if (rt.globalFlags.verbose !== true) {
+            run.setRowListener((event) => session.reportStep(event));
+        }
+        rt.exec = {
+            promptHandler: session.promptHandler,
+            onEffectStart: session.onEffectStart,
+            onEffectComplete: session.onEffectComplete,
+            onLog: session.onLog,
+            dispose: session.dispose,
+            signal,
+        };
+        task = summon.execute(run.generator, {
+            prompt: session.promptHandler,
+            params: {},
+            signal,
+        });
+    }
+    else {
+        // Non-interactive: MCP → params-or-error; CLI/--yes/CI → defaults.
+        const prompt = transport === "mcp" ? summon.mcpPrompt({}) : summon.autoPrompt({});
+        rt.exec = {
+            promptHandler: prompt,
+            onLog: (_level, message) => process.stderr.write(`${message}\n`),
+            signal,
+        };
+        task = summon.execute(run.generator, { prompt, params: {}, signal });
+    }
+    return gen(function* () {
+        const result = yield* $(task);
+        const applied = run.applied(result.answers);
+        // Progress: one line per row on stderr for an unattended run (the Ink
+        // session already draws them for the wizard). stdout stays the data stream.
+        //
+        // A dry run reports NOTHING here. Its honest preview drives this very task
+        // with writes recorded, so the progress lines ran for real and announced
+        // "✓ config — installed" above a plan that had installed nothing.
+        if (!previewing && (!wizard || yes)) {
+            const width = Math.max(...applied.rows.map((row) => row.target.length));
+            for (const row of applied.rows) {
+                if (row.outcome === undefined)
+                    continue;
+                rt.report?.(renderProgressLine(row, width));
+            }
+        }
+        // A failed row exits 1, and the recap is still shown — partial success is
+        // first class, so the run reports every row before naming the ones that did
+        // not happen. The recap goes to stderr here because the error renderer owns
+        // stdout on a failing run.
+        if (planExitFailed(applied)) {
+            rt.report?.(renderRecap(applied));
+            const failed = applied.rows.filter((row) => row.outcome?.status === "failed");
+            // ONE failure reports itself. The row already carries the cause it was
+            // given ("`bun` is not found on your PATH") and a remedy that runs on
+            // this machine; replacing them with a count would throw away the only
+            // two sentences that say what is wrong and what to do about it.
+            const only = failed.length === 1 ? failed[0] : undefined;
+            if (only?.outcome !== undefined) {
+                throw new PragmaError({
+                    code: "UNSUPPORTED",
+                    message: `${only.target}: ${only.outcome.note ?? "the step did not complete"}`,
+                    ...(only.outcome.remedy === undefined
+                        ? {}
+                        : { recovery: { message: only.outcome.remedy } }),
+                });
+            }
+            // Several failures: name every one with its own cause, then point at the
+            // recap above. A bare list of target names would make the reader re-run
+            // each one to find out why it failed.
+            const named = failed
+                .map((row) => `${row.target} (${row.outcome?.note ?? "no cause recorded"})`)
+                .join("; ");
+            throw new PragmaError({
+                code: "UNSUPPORTED",
+                message: `${failed.length} of ${planTally(applied).accountable} targets did not complete: ${named}.`,
+                recovery: {
+                    message: `The other targets are configured. Re-run the ones that did not complete: ${failed
+                        .map((row) => `\`${BIN_NAME} setup ${row.target}\``)
+                        .join(", ")}.`,
+                },
+            });
+        }
+        return applied;
+    });
+}
+/** Build a setup verb bound to its {@link SetupMode}. */
+function setupVerb(path, summary, mode, capability, extras = {}) {
+    return {
+        path,
+        summary,
+        params: SCOPE_PARAMS,
+        output: {
+            formatters: setupFormatters,
+            // The kernel's dry-run branch renders the plan through this seam instead
+            // of dumping raw effects. Absent on every other verb, so nothing else
+            // changes shape.
+            formatPlan: (planData) => renderDryRun(planData),
+        },
+        capability,
+        ...extras,
+        run: (params, rt) => runSetup(mode, rt, resolveScope(params)),
+    };
+}
+const setupAllVerb = setupVerb(["setup"], "Set up your config file, TAB completion, the editor extension, MCP, and skills.", "all", SELF_CAPABILITY, {
+    doc: "Shows what each target needs, then applies the ones you keep. Everything is configured in your home directory by default; the scope option moves the run to this project alone, or covers both. Without an attended terminal the plan is printed and nothing is written unless the run is explicitly confirmed.",
+    examples: [
+        { cmd: `${BIN_NAME} setup` },
+        {
+            cmd: `${BIN_NAME} setup --dry-run`,
+            note: "show the plan, write nothing",
+        },
+        {
+            cmd: `${BIN_NAME} setup --local`,
+            note: "configure this project instead of your home directory",
+        },
+        {
+            cmd: `${BIN_NAME} setup mcp`,
+            note: "only register the MCP server",
+        },
+    ],
+});
+const configVerb = setupVerb(["setup", "config"], "Create your global config file, filled in with the defaults.", "config", SUB_CAPABILITY);
+const mcpVerb = setupVerb(["setup", "mcp"], `Register the ${BIN_NAME} MCP server with the AI harnesses on this machine.`, "mcp", SUB_CAPABILITY);
+const completionsVerb = setupVerb(["setup", "completions"], "Install TAB completion for the shell you are running.", "completions", SUB_CAPABILITY);
+const skillsVerb = setupVerb(["setup", "skills"], "Link the skills you have installed into every AI harness that reads them.", "skills", SUB_CAPABILITY);
+const lspVerb = setupVerb(["setup", "lsp"], "Install the Terrazzo design-token extension into your VS Code-family editors.", "lsp", SUB_CAPABILITY);
+/** The `setup` capability module (run-all self-verb + five CLI-only sub-verbs). */
+export const setupModule = {
+    name: "setup",
+    verbs: [
+        asVerb(setupAllVerb),
+        asVerb(configVerb),
+        asVerb(completionsVerb),
+        asVerb(lspVerb),
+        asVerb(mcpVerb),
+        asVerb(skillsVerb),
+    ],
+};
+/** Re-exported so the covenant emitter and tests can name the target set. */
+export { TARGET_IDS };
+//# sourceMappingURL=setup.verb.js.map

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

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

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

@@ -0,0 +1,196 @@
+/**
+ * Shell detection + completion-script install paths.
+ *
+ * Shell selection is detection-only, and detection means the shell the user is
+ * RUNNING — read from the process tree — not the login shell `$SHELL` records.
+ * The two differ constantly and the difference is invisible until TAB fails.
+ * `$HOME` is read at call time so tests can isolate it.
+ */
+import { execFileSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { BIN_NAME } from "../../constants.js";
+const SHELL_MAP = {
+    zsh: "zsh",
+    bash: "bash",
+    fish: "fish",
+};
+/** How far up the process tree to look before giving up. */
+const MAX_ANCESTRY = 8;
+/**
+ * The command name and parent of a pid, read from `/proc` (Linux).
+ *
+ * `/proc/<pid>/stat` is `pid (comm) state ppid …`, and `comm` may itself
+ * contain spaces and parentheses — so the fields are taken after the LAST
+ * `)`, never by splitting the whole line.
+ *
+ * @param pid - The process to inspect.
+ * @returns Its command name and parent pid, or undefined when unreadable.
+ * @note Impure — reads /proc.
+ */
+function procEntry(pid) {
+    try {
+        const stat = readFileSync(`/proc/${pid}/stat`, "utf8");
+        const close = stat.lastIndexOf(")");
+        const open = stat.indexOf("(");
+        if (close < 0 || open < 0)
+            return undefined;
+        const name = stat.slice(open + 1, close);
+        const rest = stat.slice(close + 2).split(" ");
+        const ppid = Number.parseInt(rest[1] ?? "", 10);
+        return Number.isFinite(ppid) ? { name, ppid } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The same lookup for platforms without `/proc`, via one `ps` call.
+ *
+ * @param pid - The process to inspect.
+ * @returns Its command name and parent pid, or undefined.
+ * @note Impure — spawns `ps`.
+ */
+function psEntry(pid) {
+    try {
+        const out = execFileSync("ps", ["-o", "ppid=,comm=", "-p", String(pid)], {
+            encoding: "utf8",
+            timeout: 2000,
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        const match = /^(\d+)\s+(.*)$/.exec(out);
+        if (match === null)
+            return undefined;
+        return { name: match[2] ?? "", ppid: Number.parseInt(match[1] ?? "", 10) };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Normalize a process name to a shell id: `-zsh`, `/bin/bash`, `zsh` all map. */
+function asShell(name) {
+    const base = (name.split("/").pop() ?? "").replace(/^-/, "");
+    return SHELL_MAP[base];
+}
+/**
+ * Walk the process ancestry looking for the shell this invocation is running
+ * inside.
+ *
+ * The walk matters: a CLI reached through `npm run`, `bunx`, or a wrapper
+ * script has `node` or `sh` as its immediate parent, and the user's actual
+ * shell is a level or two further up.
+ *
+ * @returns The shell found, or undefined.
+ * @note Impure — reads the process table.
+ */
+function runningShell(read) {
+    const entryOf = read ?? (existsSync("/proc") ? procEntry : psEntry);
+    let pid = process.ppid;
+    for (let step = 0; step < MAX_ANCESTRY && pid > 1; step += 1) {
+        const entry = entryOf(pid);
+        if (entry === undefined)
+            return undefined;
+        const shell = asShell(entry.name);
+        if (shell !== undefined)
+            return shell;
+        pid = entry.ppid;
+    }
+    return undefined;
+}
+/**
+ * Detect the shell the user is actually running in.
+ *
+ * This reads the PROCESS TREE, not `$SHELL`. `$SHELL` is the login shell
+ * recorded in `/etc/passwd`; it is not changed by starting a different shell,
+ * so a user whose account says `bash` but who lives in `zsh` was silently
+ * given a bash script — and `doctor` then reported `✓ Shell completions: bash
+ * up to date and resolving`, a green check for a shell they never open, while
+ * the shell they do use had nothing.
+ *
+ * `$SHELL` survives only as a CONTRADICTION detector. When the process tree
+ * gives no answer (a CI runner, an editor task, a daemon), a `$SHELL` value is
+ * a guess about a session that may not exist, so the answer is `ambiguous` and
+ * the caller is expected to say so rather than pick.
+ *
+ * @param read - Injected process-table reader; defaults to the real one.
+ * @returns What could be established about the running shell.
+ * @note Impure — reads the process table and `$SHELL`.
+ */
+export function detectShell(read) {
+    const running = runningShell(read);
+    if (running !== undefined)
+        return { kind: "detected", shell: running };
+    const login = SHELL_MAP[(process.env.SHELL ?? "").split("/").pop() ?? ""];
+    return login === undefined
+        ? { kind: "unknown" }
+        : { kind: "ambiguous", login };
+}
+/**
+ * The standard install path for a shell's completion script.
+ *
+ * The BASENAME is {@link BIN_NAME}, never a literal, because `emitScripts`
+ * derives the script's own `#compdef` / `complete -F` / `complete -c` from that
+ * same name, and for two of the three shells the basename decides whether the
+ * file is ever loaded. Measured against real shells with the distribution
+ * renamed to `widget9`:
+ *
+ * - **fish** autoloads `completions/<cmd>.fish` BY NAME. A correct `widget9`
+ *   script in a file called `pragma.fish` is never loaded — TAB silently falls
+ *   back to filenames. Verified: renaming that one file is the entire
+ *   difference between candidates and no candidates.
+ * - **bash-completion** looks up `completions/<cmd>` by the command name the
+ *   same way. Verified against bash-completion 2.11's `__load_completion`:
+ *   with the file named `widget9`, `complete -p widget9` reports
+ *   `complete -F _widget9 widget9`; with the identical file named `pragma`,
+ *   `_widget9` is never defined and bash falls back to `_minimal`.
+ * - **zsh** does NOT work that way: `compinit` binds by the `#compdef` tag
+ *   inside the file, so `~/.zfunc/_pragma` holding `#compdef widget9` does
+ *   complete `widget9` (verified — `_comps[widget9]` resolves to `_pragma`).
+ *   The basename still matters, for a different reason: it names the function
+ *   zsh autoloads, and two distributions both writing `_pragma` would silently
+ *   overwrite each other's completions.
+ *
+ * Either way `setup completions` and `doctor` report success, so nothing else
+ * would tell the user.
+ *
+ * @param shell - The target shell.
+ * @returns The absolute path the completion script is written to.
+ * @note Impure — reads the home directory.
+ */
+export function completionScriptPath(shell) {
+    const home = homedir();
+    switch (shell) {
+        case "zsh":
+            return join(home, ".zfunc", `_${BIN_NAME}`);
+        case "bash":
+            return join(home, ".local", "share", "bash-completion", "completions", BIN_NAME);
+        case "fish":
+            return join(home, ".config", "fish", "completions", `${BIN_NAME}.fish`);
+    }
+}
+/**
+ * The post-install activation hint for a shell.
+ *
+ * bash and fish install into directories their completion systems auto-load, so
+ * the only step left is a fresh shell. zsh's `~/.zfunc` is NOT auto-loaded: the
+ * script never loads unless `~/.zfunc` is on `$fpath` BEFORE `compinit` runs —
+ * the single trap every zsh user hits, so we spell out the exact `.zshrc` lines.
+ *
+ * @param shell - The shell the script was installed for.
+ * @returns A one-or-more-line activation instruction.
+ */
+export function activationHint(shell) {
+    switch (shell) {
+        case "zsh":
+            return ("To activate, ensure ~/.zfunc is on your fpath BEFORE compinit. Add to ~/.zshrc:\n" +
+                "    fpath=(~/.zfunc $fpath)\n" +
+                "    autoload -Uz compinit && compinit\n" +
+                "Then restart your shell (or run `exec zsh`).");
+        case "bash":
+            return "To activate, restart your shell (bash-completion auto-loads the script).";
+        case "fish":
+            return "To activate, restart your shell (fish auto-loads the script).";
+    }
+}
+//# sourceMappingURL=shell.js.map

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

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