@canonical/pragma-cli 0.34.0 → 0.36.0

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

@@ -0,0 +1,128 @@
+/**
+ * The setup plan — ONE structure with four readers.
+ *
+ * `--dry-run` prints it, the wizard edits its `selected` flags, progress reports
+ * one line per row as its outcome lands, and the recap is the same rows with
+ * `outcome` filled. `--format json` emits `{ scope, roots, rows }` verbatim.
+ * Doctor reads the same target table (see {@link ./targets.js}) so the two
+ * surfaces cannot disagree about what they looked at.
+ *
+ * The shape is deliberately flat and JSON-ready: no class, no live handle, no
+ * task. A row is a fact about what a run WOULD do (or, once `outcome` is set,
+ * what it did), which is why the plan can be rendered before, during, and after
+ * the run without any reader having to know which phase produced it.
+ *
+ * This module is pure data + pure derivations. It carries no import of the
+ * operations, the harnesses runtime, or React — so the renderers, the doctor
+ * checks, and the verb can all reach it without dragging anything heavy along.
+ */
+import { isAbsolute, relative, sep } from "node:path";
+/** The five setup targets, in table (and therefore display) order. */
+export const TARGET_IDS = [
+    "config",
+    "completions",
+    "lsp",
+    "mcp",
+    "skills",
+];
+/**
+ * Whether a plan action would touch the filesystem. `none` and `skip` are the
+ * two quiet outcomes: a converged re-run composes no effects at all, so mtimes
+ * stay untouched and a second `--yes` writes nothing.
+ */
+export const isActionable = (action) => action === "install" ||
+    action === "update" ||
+    action === "link" ||
+    action === "remove";
+/**
+ * Default selection for a freshly built row: actionable rows are pre-selected,
+ * already-current rows are shown de-selected, and a skip is never selectable.
+ */
+export const defaultSelected = (action) => isActionable(action);
+/** The rows a run acts on: selected, and not a skip. */
+export const selectedRows = (plan) => plan.rows.filter((row) => row.selected && row.action !== "skip");
+/**
+ * THE exit rule (and the reason it is stated once, here): a run fails only when
+ * a selected row was attempted and did not happen. Every selected row ending
+ * `done`, `noop` or `skipped` exits 0 — including a headless box where nothing
+ * is installable, because a skip is "nothing to do here, honestly named", the
+ * same semantics doctor gives its skip glyph. Punishing a converged or benignly
+ * empty state with a non-zero exit makes a dotfiles script fail on a machine
+ * with an exotic shell, which teaches people to ignore the exit code.
+ *
+ * @param plan - The plan, with outcomes filled in.
+ * @returns Whether any selected row ended `failed`.
+ */
+export const planExitFailed = (plan) => plan.rows.some((row) => row.outcome?.status === "failed");
+/**
+ * `N of M targets` — the recap headline's counts.
+ *
+ * M is the rows this run took RESPONSIBILITY for: every row that reached an
+ * outcome other than `skipped`. That is deliberately not "rows with the checkbox
+ * ticked". An already-current row is offered de-selected because there is
+ * nothing to do to it, so counting ticks reported a fully converged machine as
+ * `0 of 0 configured` — a sentence that describes a machine where nothing
+ * worked exactly as it describes one where everything already did.
+ *
+ * Skips stay out of both counts: a target that cannot act on this machine is
+ * neither a success nor a shortfall, and it is already named on its own row.
+ * A row the user deselected has no outcome at all and is likewise absent.
+ *
+ * @param plan - The plan, with outcomes filled in.
+ * @returns The headline's numerator and denominator.
+ */
+export function planTally(plan) {
+    const accountable = plan.rows.filter((row) => row.outcome !== undefined && row.outcome.status !== "skipped");
+    const configured = accountable.filter((row) => row.outcome?.status === "done" ||
+        row.outcome?.status === "noop" ||
+        row.outcome?.status === "removed" ||
+        row.outcome?.status === "kept");
+    return { configured: configured.length, accountable: accountable.length };
+}
+/**
+ * Render one absolute path relative to whichever root contains it — the header
+ * names both roots once, so a row never repeats a 120-character prefix. The
+ * global root prints as `~`; the project root prints as `.`. A path under
+ * neither root stays absolute, because shortening it would be a guess — and a
+ * sibling directory whose name merely EXTENDS a root's is under neither.
+ *
+ * The project root is tried FIRST: a project checked out inside the home
+ * directory sits under both, and the more specific root is the informative one.
+ *
+ * @param path - An absolute path.
+ * @param roots - The plan's two named roots.
+ * @returns The root-relative rendering.
+ */
+export function shortenPath(path, roots) {
+    for (const [root, marker] of [
+        [roots.project, "."],
+        [roots.global, "~"],
+    ]) {
+        if (!root)
+            continue;
+        if (path === root)
+            return marker;
+        // Containment is a question about path SEGMENTS, and the separator is the
+        // host's. Testing `startsWith(root + "/")` answered no for every Windows
+        // path `node:path` produces, so the plan printed absolute paths where it
+        // had just named the root they sit under — and it answered YES for a
+        // sibling whose name merely extends the root's.
+        const rel = relative(root, path);
+        if (rel.length === 0 ||
+            rel === ".." ||
+            rel.startsWith(`..${sep}`) ||
+            isAbsolute(rel)) {
+            continue;
+        }
+        return `${marker}${sep}${rel}`;
+    }
+    return path;
+}
+/** Replace a row's outcome, leaving every other field untouched. */
+export const withOutcome = (row, outcome) => ({
+    ...row,
+    outcome,
+});
+/** Replace a plan's rows (the wizard's edit, and the apply phase's fill-in). */
+export const withRows = (plan, rows) => ({ ...plan, rows });
+//# sourceMappingURL=plan.js.map

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

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

package/dist/src/capabilities/setup/plan.render.js

@@ -0,0 +1,271 @@
+/**
+ * The plan's four renders: the preview table, one progress line per row, the
+ * recap, and the JSON projection.
+ *
+ * All four read the SAME {@link SetupPlan}. That is the whole design: a preview
+ * that shows one thing, a progress stream that shows another, and a recap that
+ * counts a third is how "Setup complete — ran: completions, lsp, mcp" came to
+ * be printed on a run that had silently dropped a target. Here the recap is the
+ * preview with outcomes filled in, so the two cannot describe different runs.
+ *
+ * Column widths are computed from the rows being rendered, so the block stays
+ * aligned whether it holds one row or seven. Colour rides the shared TTY seam —
+ * a piped run renders byte-for-byte plain.
+ */
+import { BIN_NAME } from "../../constants.js";
+import { defaultStyle } from "../../kernel/render/style.js";
+import { NOT_RUN_GLYPH, OUTCOME_GLYPHS, outcomeRemedyWord, SCOPE_LABELS, SCOPE_PHRASES, } from "../../kernel/render/vocabulary.js";
+import { planTally, shortenPath, } from "./plan.js";
+/** The header's scope phrase: `global`, `local project`, or both of them. */
+const scopePhrase = (scope) => SCOPE_PHRASES[scope];
+/**
+ * The header line. It names the scope and BOTH roots exactly once, which is what
+ * frees every row below to render its paths root-relative instead of repeating
+ * a 120-character prefix per line. The roots are LABELLED (`home:`, `project:`)
+ * because the `~` and `.` markers the rows use are only legible once something
+ * has said what they stand for.
+ */
+function header(plan, lead) {
+    const project = shortenPath(plan.roots.project, {
+        global: plan.roots.global,
+        project: "",
+    });
+    return `${lead} — ${scopePhrase(plan.scope)} (home: ~ · project: ${project})`;
+}
+/**
+ * The plain verb each action reads as. The middle column is a column of VERBS:
+ * what this row will do. It used to render the raw {@link PlanAction} token, so
+ * it read as a column of status codes — and `none` was the worst of them,
+ * standing equally for "already correct" and "nothing found here". The two are
+ * now told apart by the pair: the word says nothing will happen, the detail
+ * beside it says what was found.
+ *
+ * `none` and `skip` are worded direction-neutrally on purpose. The SAME renderer
+ * draws the `--undo` plan, where a target-specific negation ("nothing to create"
+ * on the `config` row) would be plainly false — there the row is not creating
+ * anything, it is declining to delete.
+ *
+ * The token itself is untouched: `action` is the machine field `--format json`
+ * publishes, and this is the display layer over it.
+ */
+const ACTION_WORDS = {
+    install: "install",
+    update: "update",
+    link: "link",
+    remove: "remove",
+    none: "no change",
+    skip: "nothing to do",
+};
+/** The distinct actions a row's children carry (empty when it has none). */
+const childActions = (row) => new Set((row.children ?? []).map((child) => child.action));
+/**
+ * The middle column.
+ *
+ * A row with children takes its word from THEM when they agree, because the
+ * row-level token can disagree with every one of its own files: registering the
+ * MCP server in three files that have never held it plans as `update` (the
+ * table's word for "this row has work that is not a fresh install"), and
+ * printing `update` over three `(add)` children described the opposite of what
+ * the run would do. Before this the cell held the row's DETAIL instead — `3
+ * files`, which is a count, not an action, and left the plan with no column
+ * that said what would happen.
+ */
+function actionCell(row) {
+    const kinds = childActions(row);
+    if (row.action === "update" && kinds.size === 1 && kinds.has("add")) {
+        return ACTION_WORDS.install;
+    }
+    return ACTION_WORDS[row.action];
+}
+/**
+ * One child rendered inline. The per-child action is printed only when the
+ * children DISAGREE — when they all do the same thing the row's own verb has
+ * just said it, and `lsp  no change  codium — VSCodium (unchanged)` said
+ * "nothing happens here" twice in two columns.
+ */
+const childCell = (row, child) => childActions(row).size === 1
+    ? child.label
+    : `${child.label} (${child.action})`;
+/** The right column: the children joined, or the row's own detail. */
+const detailCell = (row) => row.children && row.children.length > 0
+    ? row.children.map((child) => childCell(row, child)).join(" · ")
+    : row.action === "skip"
+        ? (row.reason ?? row.detail)
+        : row.detail;
+/** Pad every id to the widest, so the three columns line up. */
+const widthOf = (rows, pick) => Math.max(0, ...rows.map((row) => pick(row).length));
+/** Group rows by scope, in the plan's own scope order. */
+function byScope(plan) {
+    const scopes = ["global", "project"];
+    return scopes
+        .map((scope) => [
+        scope,
+        plan.rows.filter((row) => row.scope === scope),
+    ])
+        .filter(([, rows]) => rows.length > 0);
+}
+/**
+ * Render the plan as the preview table.
+ *
+ * @param plan - The plan to render.
+ * @param options - `lead` heads the block; `hint` is the trailing line (the
+ *   non-interactive preview's "nothing was applied", or the dry-run's own).
+ * @param style - Injected for tests; defaults to the shared TTY seam.
+ * @returns The rendered block.
+ */
+export function renderPlanTable(plan, options = { lead: "Setup plan" }, style = defaultStyle()) {
+    const idWidth = widthOf(plan.rows, (row) => row.target);
+    const actionWidth = widthOf(plan.rows, actionCell);
+    const lines = [style.bold(header(plan, options.lead)), ""];
+    const groups = byScope(plan);
+    for (const [scope, rows] of groups) {
+        if (plan.scope === "both")
+            lines.push(style.bold(SCOPE_LABELS[scope]));
+        for (const row of rows) {
+            lines.push(`  ${row.target.padEnd(idWidth)}  ${actionCell(row).padEnd(actionWidth)}  ${style.dim(detailCell(row))}`);
+        }
+    }
+    if (options.hint)
+        lines.push("", options.hint);
+    return lines.join("\n");
+}
+/**
+ * What was DETECTED, rendered before anything is asked.
+ *
+ * The gap this closes is a rendering one, not an ordering one: detection is
+ * complete before the prompt array is even constructed (`buildSetupRun` does
+ * resolveRoots → detectTargets → buildPlan, and only then builds `prompts`), and
+ * the Ink view mounts no React until the FIRST prompt effect. So the facts were
+ * sitting in `run.plan` the whole time with nothing rendering them — the wizard
+ * leaked detection only through prompt-label suffixes, and `renderPlanTable` is
+ * reached only by `--dry-run` or the non-interactive preview. A wizard run
+ * never rendered it at all, and the confirm gate shows an EFFECTS summary, not
+ * a detection one.
+ *
+ * It is a plain-string formatter on purpose. It rides `rt.report` — the non-Ink
+ * stderr seam, `--quiet`-aware and a no-op over MCP — because pragma contains no
+ * React and no Ink, and three PROTECTED tests exist to keep it that way.
+ *
+ * The default lists DETECTED rows only; `--verbose` lists everything. "Detected"
+ * is `action !== "skip"`, which is not a new partition: it is exactly the
+ * predicate the row multiselect already uses to build its choices, so the
+ * summary and the question that follows it describe the same set.
+ *
+ * @param plan - The plan as detected (no outcomes yet).
+ * @param options - `verbose` widens detected-only to the whole table.
+ * @param style - Injected for tests; defaults to the shared TTY seam.
+ * @returns The rendered block, or `undefined` when there is nothing to say.
+ */
+export function renderDetectionSummary(plan, options = {}, style = defaultStyle()) {
+    const shown = options.verbose
+        ? plan.rows
+        : plan.rows.filter((row) => row.action !== "skip");
+    if (shown.length === 0)
+        return undefined;
+    const hidden = plan.rows.length - shown.length;
+    const idWidth = widthOf(shown, (row) => row.target);
+    const actionWidth = widthOf(shown, actionCell);
+    const lines = [style.bold(header(plan, "Detected")), ""];
+    for (const [scope, rows] of byScope({ ...plan, rows: shown })) {
+        if (plan.scope === "both")
+            lines.push(style.bold(SCOPE_LABELS[scope]));
+        for (const row of rows) {
+            lines.push(`  ${row.target.padEnd(idWidth)}  ${actionCell(row).padEnd(actionWidth)}  ${style.dim(detailCell(row))}`);
+        }
+    }
+    if (hidden > 0) {
+        lines.push("", style.dim(`${hidden} target${hidden === 1 ? "" : "s"} not detected here — --verbose lists them`));
+    }
+    return lines.join("\n");
+}
+/**
+ * One progress line, emitted as a row's outcome lands. Same columns as the
+ * recap, so a reader watching the run and a reader reading the recap afterwards
+ * see the same sentence about the same row.
+ *
+ * @param row - The row, with its outcome filled in.
+ * @param idWidth - The shared id column width.
+ * @param style - Injected for tests.
+ * @returns The line.
+ */
+export function renderProgressLine(row, idWidth, style = defaultStyle()) {
+    const outcome = row.outcome;
+    // No outcome at all: the row was offered and left unselected. It is neither a
+    // success nor a skip-for-cause, and painting it green would claim work that
+    // never happened, so it gets a neutral marker and says plainly what it is.
+    if (outcome === undefined) {
+        return `${style.dim(NOT_RUN_GLYPH)} ${row.target.padEnd(idWidth)}  ${style.dim(`${row.detail} — not selected`)}`;
+    }
+    const glyph = OUTCOME_GLYPHS[outcome.status];
+    const tinted = outcome.status === "failed"
+        ? style.red(glyph)
+        : outcome.status === "skipped" || outcome.status === "kept"
+            ? style.yellow(glyph)
+            : style.green(glyph);
+    const note = outcome.note;
+    const body = outcome.status === "skipped"
+        ? // A colon, not a dash: the reasons carry their own em-dash clause
+            // ("no skills installed yet — pack skills arrive with …"), and two
+            // dashes in one line read as one run-on sentence rather than a label
+            // in front of a reason.
+            `skipped: ${row.reason ?? row.detail}`
+        : note
+            ? `${row.detail} — ${note}`
+            : row.detail;
+    return `${tinted} ${row.target.padEnd(idWidth)}  ${body}`;
+}
+/**
+ * The recap: the plan replayed with outcomes.
+ *
+ * The headline counts SELECTED rows, never "steps that ran", so a target that
+ * was selected and then skipped is visible in the denominator instead of
+ * vanishing from a sentence that claims completeness.
+ *
+ * @param plan - The plan, with outcomes filled in.
+ * @param lead - The headline's first word (`Setup` / `Removed`).
+ * @param style - Injected for tests.
+ * @returns The rendered recap.
+ */
+export function renderRecap(plan, lead = "Setup", style = defaultStyle()) {
+    const { configured, accountable } = planTally(plan);
+    const idWidth = widthOf(plan.rows, (row) => row.target);
+    const lines = [
+        style.bold(`${lead}: ${configured} of ${accountable} targets configured — ${scopePhrase(plan.scope)}`),
+    ];
+    for (const [scope, rows] of byScope(plan)) {
+        if (plan.scope === "both")
+            lines.push(style.bold(`  ${SCOPE_LABELS[scope]}`));
+        for (const row of rows) {
+            lines.push(`  ${renderProgressLine(row, idWidth, style)}`);
+            const remedy = row.outcome?.remedy;
+            if (remedy)
+                lines.push(`      ${style.dim(remedy)}`);
+        }
+    }
+    lines.push("", style.dim(`Check this again any time with \`${BIN_NAME} doctor\`.`));
+    return lines.join("\n");
+}
+/** The condensed Markdown form — the same rows, one bullet each. */
+export function renderPlanLlm(plan, lead = "Setup") {
+    const lines = [`## ${lead} — ${scopePhrase(plan.scope)}`, ""];
+    for (const row of plan.rows) {
+        const status = row.outcome?.status;
+        // Before a run there is no outcome to report, so the row shows its ACTION
+        // behind a neutral marker. Reusing the `noop` glyph here painted every row
+        // of an unapplied plan — skips included — with a green check.
+        const glyph = status === undefined ? NOT_RUN_GLYPH : OUTCOME_GLYPHS[status];
+        const state = status ?? row.action;
+        lines.push(`- ${glyph} **${row.target}** (${row.scope}): ${state} — ${detailCell(row)}`);
+        for (const child of row.children ?? []) {
+            lines.push(`  - ${childCell(row, child)}`);
+        }
+        // `fix:` for a row that failed, `next:` for one that skipped — a skip is
+        // not a fault, and labelling its instruction as a repair is what teaches a
+        // reader to treat skips as failures.
+        if (row.outcome?.remedy) {
+            lines.push(`  - _${outcomeRemedyWord(row.outcome.status)}:_ ${row.outcome.remedy}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=plan.render.js.map

package/dist/src/capabilities/setup/plan.render.js.map

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

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

@@ -0,0 +1,54 @@
+/**
+ * Formatters for `pragma setup` and its sub-verbs — one shared formatter over
+ * the {@link SetupPlan} (plain, llm, json).
+ *
+ * The plan REPLACED a tagged result union with one member per sub-verb, each
+ * rendering its own sentence in its own vocabulary. That union could not
+ * describe a run that touched several targets in two scopes, so the run-all
+ * reported a list of step names and nothing about what any of them did. One
+ * structure with one renderer is what makes the preview, the progress lines and
+ * the recap agree by construction rather than by review.
+ */
+import { renderPlanLlm, renderPlanTable, renderRecap } from "./plan.render.js";
+/** The trailing line a non-applied plan carries. */
+export const PREVIEW_HINT = "Nothing was applied. Run again with --yes to apply.";
+/** The trailing line an explicit dry run carries. */
+export const DRY_RUN_HINT = "Dry run — nothing applied.";
+/**
+ * Whether any row carries an outcome, i.e. whether a run actually happened.
+ *
+ * Selection is deliberately NOT part of this test. An all-current re-run selects
+ * nothing — every row is already converged — and gating on `selected` made that
+ * run render as an unapplied PLAN, so the one command that had just confirmed
+ * the machine was fully set up reported itself as a preview.
+ */
+const wasApplied = (plan) => plan.rows.some((row) => row.outcome !== undefined);
+/**
+ * The dry-run render. Reached ONLY through the verb's `formatPlan` seam, which
+ * the kernel calls on the `--dry-run` branch — so it can name that path
+ * outright. The identical body under {@link setupFormatters} serves the OTHER
+ * preview, the non-interactive run that was given no consent, whose useful last
+ * line is how to grant it.
+ *
+ * @param plan - The plan to render.
+ * @returns The plan table, ended with the dry-run's own line.
+ */
+export const renderDryRun = (plan) => renderPlanTable(plan, { lead: "Setup plan", hint: DRY_RUN_HINT });
+export const setupFormatters = {
+    plain(data) {
+        if (data.preview === true) {
+            return renderPlanTable(data, { lead: "Setup plan", hint: PREVIEW_HINT });
+        }
+        if (!wasApplied(data)) {
+            return renderPlanTable(data, { lead: "Setup plan" });
+        }
+        return renderRecap(data);
+    },
+    llm(data) {
+        return renderPlanLlm(data, data.preview === true ? "Setup plan" : "Setup");
+    },
+    json(data) {
+        return JSON.stringify(data);
+    },
+};
+//# sourceMappingURL=setup.render.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.render.js","sourceRoot":"","sources":["../../../../src/capabilities/setup/setup.render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/E,oDAAoD;AACpD,MAAM,CAAC,MAAM,YAAY,GACvB,qDAAqD,CAAC;AAExD,qDAAqD;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,UAAU,GAAG,CAAC,IAAe,EAAW,EAAE,CAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAe,EAAU,EAAE,CACtD,eAAe,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AAEpE,MAAM,CAAC,MAAM,eAAe,GAA0B;IACpD,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,eAAe,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,eAAe,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,GAAG,CAAC,IAAI;QACN,OAAO,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,IAAI;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF,CAAC"}