@canonical/pragma-cli 0.35.0 → 0.37.0

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

@@ -10,11 +10,11 @@
  * Every selected target is a visible row here, including the ones that skip.
  */
 import { defaultSelected, } from "./plan.js";
-import { supportsBand, TARGETS, } from "./targets.js";
+import { supportsScope, TARGETS, } from "./targets.js";
 /** The failure a row's detection ended in, or `undefined` when it settled. */
 export const detectionFailure = (row) => row.failure;
-/** The bands a `--scope` selection runs, global before project. */
-export const bandsForScope = (scope) => scope === "both" ? ["global", "project"] : [scope];
+/** The scopes a `--scope` selection runs, global before project. */
+export const scopesForSelection = (scope) => scope === "both" ? ["global", "project"] : [scope];
 /**
  * The two named roots. The global root is the user's home directory (rendered
  * `~`), the project root is the directory the invocation resolves against.
@@ -30,7 +30,7 @@ export async function resolveRoots(rt) {
 /** The cause a rejected detection carries, as one line of copy. */
 const messageOf = (reason) => reason instanceof Error ? reason.message : String(reason);
 /**
- * Detect every requested target in every band the scope runs.
+ * Detect every requested target in every scope the scope runs.
  *
  * Detections are started together and SETTLED INDEPENDENTLY: they are
  * independent reads, and a run-all that probed five targets serially paid for
@@ -40,53 +40,57 @@ const messageOf = (reason) => reason instanceof Error ? reason.message : String(
  * unreadable config, a permission-denied directory — takes only its own row
  * down. Awaiting them as one `Promise.all` meant the first rejection prevented
  * a run from being built at all: none of the other targets ran, and doctor
- * rendered no banded rows whatsoever. The failed row carries its cause and is
+ * rendered no scoped rows whatsoever. The failed row carries its cause and is
  * reported as a row, which is the same shape a failed COMPOSE already has.
  *
  * @param rt - The per-invocation runtime.
  * @param ids - The targets to plan (all five for the run-all).
- * @param scope - The resolved band selection.
- * @returns One entry per (target, band) the scope actually runs.
+ * @param scope - The resolved scope selection.
+ * @returns One entry per (target, scope) the scope actually runs.
  * @note Impure — every target's `detect` reads the real filesystem.
  */
 export async function detectTargets(rt, ids, scope) {
     const wanted = TARGETS.filter((target) => ids.includes(target.id));
-    const pairs = bandsForScope(scope).flatMap((band) => wanted
-        .filter((target) => supportsBand(target, band))
+    const pairs = scopesForSelection(scope).flatMap((scope) => wanted
+        .filter((target) => supportsScope(target, scope))
         .map((target) => ({
         target,
-        band,
+        scope,
     })));
-    const settled = await Promise.allSettled(pairs.map(({ target, band }) => target.detect(rt, band)));
-    return pairs.map(({ target, band }, index) => {
+    const settled = await Promise.allSettled(pairs.map(({ target, scope }) => target.detect(rt, scope)));
+    return pairs.map(({ target, scope }, index) => {
         const outcome = settled[index];
         if (outcome.status === "fulfilled") {
-            return { target, band, detection: outcome.value };
+            return { target, scope, detection: outcome.value };
         }
         return {
             target,
-            band,
+            scope,
             detection: undefined,
             failure: messageOf(outcome.reason),
         };
     });
 }
 /**
- * The dim row a target gets when the SELECTED band cannot hold it — `setup
- * --local` still shows `completions`, saying why it is not in this run. A band
- * merely filters the run-all: the user asked for a band, not for that target, so
+ * The dim row a target gets when the SELECTED scope cannot hold it — `setup
+ * --local` still shows `completions`, saying why it is not in this run. A scope
+ * merely filters the run-all: the user asked for a scope, not for that target, so
  * nothing errors, but nothing is silently absent either. (Asking for the
- * impossible band on the SUB-VERB is a different thing entirely — a typed
+ * impossible scope on the SUB-VERB is a different thing entirely — a typed
  * contradiction, and a usage error.)
+ *
+ * The reason names the flag that WOULD reach the target, so the row is not a
+ * dead end: a reader who wanted `completions` under `--local` is told in the
+ * same line that `--global` is where it lives.
  */
-const outOfBandRow = (target, band) => ({
+const outOfScopeRow = (target, scope) => ({
     target: target.id,
-    band,
+    scope,
     action: "skip",
-    detail: "not in this band",
-    reason: band === "project"
-        ? "user-level only — it has no project band"
-        : "project-level only — it has no global band",
+    detail: "not part of this scope",
+    reason: scope === "project"
+        ? "this one is global only — run it with `--global`"
+        : "this one is per-project only — run it with `--local`",
     selected: false,
 });
 /**
@@ -96,9 +100,9 @@ const outOfBandRow = (target, band) => ({
  * into a `failed` outcome, so the run exits non-zero naming this target rather
  * than reporting a clean sweep over the targets that did settle.
  */
-const failedDetectionRow = (target, band, failure) => ({
+const failedDetectionRow = (target, scope, failure) => ({
     target: target.id,
-    band,
+    scope,
     action: "skip",
     detail: "detection did not complete",
     reason: failure,
@@ -117,44 +121,44 @@ const failedDetectionRow = (target, band, failure) => ({
  */
 export function draftFor(hit, roots, removal) {
     return removal
-        ? hit.target.removalPlan(hit.detection, hit.band, roots)
-        : hit.target.plan(hit.detection, hit.band, roots);
+        ? hit.target.removalPlan(hit.detection, hit.scope, roots)
+        : hit.target.plan(hit.detection, hit.scope, roots);
 }
 /**
  * Project detections into plan rows.
  *
- * @param scope - The resolved band selection (named in the header).
+ * @param selection - The resolved scope selection (named in the header).
  * @param roots - The two named roots every path renders relative to.
- * @param detected - The detections, in table order per band.
- * @param ids - The targets that were REQUESTED, so an out-of-band one still
+ * @param detected - The detections, in table order per scope.
+ * @param ids - The targets that were REQUESTED, so an out-of-scope one still
  *   gets a visible row.
  * @param removal - Build the removal plan (`--undo`) instead of the forward one.
  * @returns The plan.
  */
-export function buildPlan(scope, roots, detected, ids, removal = false) {
+export function buildPlan(selection, roots, detected, ids, removal = false) {
     const rows = [];
-    for (const band of bandsForScope(scope)) {
+    for (const scope of scopesForSelection(selection)) {
         for (const target of TARGETS) {
             if (!ids.includes(target.id))
                 continue;
-            const hit = detected.find((d) => d.target.id === target.id && d.band === band);
+            const hit = detected.find((d) => d.target.id === target.id && d.scope === scope);
             if (hit === undefined) {
-                // Only worth a line when the target has no row in ANY selected band —
+                // Only worth a line when the target has no row in ANY selected scope —
                 // under `--scope both` a global-only target already appears above.
                 const elsewhere = detected.some((d) => d.target.id === target.id);
                 if (!elsewhere)
-                    rows.push(outOfBandRow(target, band));
+                    rows.push(outOfScopeRow(target, scope));
                 continue;
             }
             const failure = detectionFailure(hit);
             if (failure !== undefined) {
-                rows.push(failedDetectionRow(target, band, failure));
+                rows.push(failedDetectionRow(target, scope, failure));
                 continue;
             }
             const draft = draftFor(hit, roots, removal);
             rows.push({
                 target: target.id,
-                band,
+                scope,
                 action: draft.action,
                 detail: draft.detail,
                 ...(draft.reason === undefined ? {} : { reason: draft.reason }),
@@ -163,6 +167,6 @@ export function buildPlan(scope, roots, detected, ids, removal = false) {
             });
         }
     }
-    return { scope, roots, rows };
+    return { scope: selection, roots, rows };
 }
 //# sourceMappingURL=buildPlan.js.map

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

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

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

@@ -20,8 +20,8 @@
  * 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.
+ * `--yes` were passed. The scope default applies there too — the tool writes the
+ * global scope unless told otherwise.
  */
 /**
  * Lift the decision inputs off a runtime. A tool call over MCP counts as `yes`.

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

@@ -13,7 +13,7 @@
  *
  * 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`
+ * to the plan rows, so `doctor`'s scoped 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
@@ -33,7 +33,7 @@
 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";
+export { composeLsp, composeLspRemoval, detectLsp, LSP_SKIP_REMEDY, lspEditorNames, lspSkipReason, lspUninstallRemedy, ownedLspEditors, } from "./setupLsp.js";
+export { composeMcp, composeMcpRemoval, detectMcp, mcpGroupState, mcpWriteState, ownedMcpGroups, selectedGroups, } from "./setupMcp.js";
+export { composeSkills, composeSkillsRemoval, detectSkills, ownedSkillLinks, skillsSkipReason, skillsSkipRemedy, staleSkillLinks, withinRoot, } from "./setupSkills.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +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"}
+{"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,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,UAAU,GACX,MAAM,kBAAkB,CAAC"}

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

@@ -149,12 +149,16 @@ export function composeCompletions(d) {
  * machine that never installed one reverses zero steps and says so.
  *
  * @param d - The detection gathered up front.
+ * @param undoKey - Correlation key stamped on the reversal(s), echoed on
+ *   their undo outcomes so the caller can read results back per row.
  * @returns A Task whose undo deletes the installed script.
  */
-export function composeCompletionsRemoval(d) {
+export function composeCompletionsRemoval(d, undoKey) {
     if (d.path === null || d.script === null || d.state === "absent") {
         return sequence_([]);
     }
-    return sequence_([writeFile(d.path, d.script, { undo: deleteFile(d.path) })]);
+    return sequence_([
+        writeFile(d.path, d.script, { undo: deleteFile(d.path), undoKey }),
+    ]);
 }
 //# sourceMappingURL=setupCompletions.js.map

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

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

@@ -87,13 +87,15 @@ export function composeConfigFile(d) {
  * delete as its `undo`, which is what the undo interpreter executes.
  *
  * @param d - The detection gathered up front.
+ * @param undoKey - Correlation key stamped on the reversal(s), echoed on
+ *   their undo outcomes so the caller can read results back per row.
  * @returns A Task whose undo removes a seed-only config, or an empty Task.
  */
-export function composeConfigRemoval(d) {
+export function composeConfigRemoval(d, undoKey) {
     if (!d.exists || !d.isSeed)
         return sequence_([]);
     return sequence_([
-        writeFile(d.path, SEED_CONFIG, { undo: deleteFile(d.path) }),
+        writeFile(d.path, SEED_CONFIG, { undo: deleteFile(d.path), undoKey }),
     ]);
 }
 /** The line a removal prints when the file carries the user's own settings. */

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

@@ -1 +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"}
+{"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;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,CAAkB,EAClB,OAAgB;IAEhB,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,OAAO,EAAE,CAAC;KACtE,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"}

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

@@ -5,7 +5,7 @@
  * gate, live progress, colours, and the shared cancel fixes by construction.
  *
  * The shape mirrors `create`: detection runs FOR REAL up front (once per
- * target/band, in `detectTargets`), then a PURE `generate` composes only the
+ * target/scope, in `detectTargets`), then a PURE `generate` composes only the
  * effects for the SELECTED rows. `generate` must stay re-interpretable —
  * `execute` invokes it more than once (the confirm-gate preview and the build) —
  * so it is composed from combinators and does no reads of its own.
@@ -36,8 +36,8 @@ const CHILD_ANSWER = {
     mcp: MCP_FILES_ANSWER,
     lsp: LSP_EDITORS_ANSWER,
 };
-/** A row's identity in an answer bag: band-qualified, so `both` stays unambiguous. */
-const rowKey = (band, target) => `${band}:${target}`;
+/** A row's identity in an answer bag: scope-qualified, so `both` stays unambiguous. */
+const rowKey = (scope, target) => `${scope}:${target}`;
 /**
  * Where a failed row's error lands during interpretation.
  *
@@ -87,11 +87,28 @@ const rowPragmaError = (error) => error.cause instanceof PragmaError
  * throw bypasses the trampoline's recovery frames — which is why the row bodies
  * raise via `checkExecOk`/`failPragma`, never a bare throw. Interruption bypasses
  * recovery by interpreter invariant, so Ctrl-C still stops the whole run.
+ *
+ * Each row is also BRACKETED with {@link RowEvent}s — `start` as its body is
+ * entered, `done`/`failed` as it settles — emitted from the continuations,
+ * which run at interpretation time. Like the sink writes beside them, the
+ * emits capture nothing IN the task: the composition stays pure and
+ * re-interpretable, and each drive simply narrates itself as it runs.
  */
-const runRowsIsolated = (sink, rows) => flatMap(pure(undefined), () => {
+const runRowsIsolated = (sink, rows, emit) => flatMap(pure(undefined), () => {
     sink.clear();
-    return sequence_(rows.map(({ key, task }) => recover(task, (error) => flatMap(warn(`The ${key.split(":")[1]} step did not complete — continuing with the remaining targets.`), () => {
+    return sequence_(rows.map(({ key, label, doneLabel, task }) => recover(flatMap(pure(undefined), () => {
+        emit({ key, label, status: "start" });
+        return flatMap(task, () => {
+            emit({ key, label: doneLabel, status: "done" });
+            return pure(undefined);
+        });
+    }), (error) => flatMap(warn(`The ${key.split(":")[1]} step did not complete — continuing with the remaining targets.`), () => {
         sink.record(key, error);
+        emit({
+            key,
+            label: `${label} — ${rowPragmaError(error).message}`,
+            status: "failed",
+        });
         return pure(undefined);
     }))));
 });
@@ -116,7 +133,7 @@ const buildRowsPrompt = (plan) => {
         .filter((row) => row.action !== "skip")
         .map((row) => ({
         label: `${row.target} — ${row.detail}${row.action === "none" ? " (already configured)" : ""}`,
-        value: rowKey(row.band, row.target),
+        value: rowKey(row.scope, row.target),
     }));
     return {
         name: ROWS_ANSWER,
@@ -125,23 +142,26 @@ const buildRowsPrompt = (plan) => {
         choices,
         default: plan.rows
             .filter((row) => row.selected)
-            .map((row) => rowKey(row.band, row.target)),
+            .map((row) => rowKey(row.scope, row.target)),
     };
 };
-/** The opt-in "customize which files" gate — defaults to false. */
-const buildCustomizePrompt = (when) => ({
-    name: "customize",
-    type: "confirm",
-    message: `Customize which files ${BIN_NAME} configures?`,
-    default: false,
-    when,
-});
 /**
  * The per-file MCP multiselect — one row per deduplicated config file, across
- * every band the run covers. An already-current file is DEFAULT-DESELECTED; a
- * file that is absent or drifted stays selected. Retained unchanged from the
- * landed opt-in narrowing: it is row-level CHILD selection, which is exactly
- * what the plan's child rows are.
+ * every scope the run covers. An already-current file is DEFAULT-DESELECTED; a
+ * file that is absent or drifted stays selected. It is row-level CHILD
+ * selection, which is exactly what the plan's child rows are.
+ *
+ * It used to sit behind a meta-question — "Customize which files pragma
+ * configures?", answered no by default. That gate was read in exactly ONE place
+ * in the repo (this prompt's `when`) and nowhere else: not by `generate`, not by
+ * `applied`, not by any plan, recap, renderer or JSON projection. Answering no
+ * meant the child prompt was never asked, its key was absent from the answer
+ * bag, `readList` returned `undefined`, and the compose bodies read that as
+ * "all" — so everything detected was configured anyway. A meta-question in front
+ * of a direct question is one more thing to answer and no more control; the
+ * choices below already carry the detected state per child (`— unchanged`,
+ * `— add`, `— update`), which is the answer the meta-question was standing in
+ * front of.
  */
 const buildChildPrompt = (plan, target, message, when) => {
     const children = childrenOf(plan, target);
@@ -159,7 +179,7 @@ const buildChildPrompt = (plan, target, message, when) => {
             .map((child) => child.key),
     };
 };
-/** Every child row a target contributes, across the bands in the plan. */
+/** Every child row a target contributes, across the scopes in the plan. */
 const childrenOf = (plan, target) => plan.rows
     .filter((row) => row.target === target)
     .flatMap((row) => row.children ?? []);
@@ -167,7 +187,7 @@ const childrenOf = (plan, target) => plan.rows
 const isChosen = (row, chosen) => row.action !== "skip" &&
     (chosen === undefined
         ? row.selected
-        : chosen.includes(rowKey(row.band, row.target)));
+        : chosen.includes(rowKey(row.scope, row.target)));
 /**
  * What a row DID, as a past-tense word. The row's detail says what and where;
  * the note says what happened to it, so a progress line and a recap line read
@@ -211,7 +231,7 @@ function childNote(row, kept) {
  *
  * @param rt - The per-invocation runtime.
  * @param mode - The entry point: the run-all, or one target.
- * @param scope - The resolved band selection.
+ * @param scope - The resolved scope selection.
  * @param removal - Compose the removal (`--undo`) instead of the install.
  * @returns The plan, the generator, and the answers-to-plan projection.
  * @note Impure — runs every selected target's real detection.
@@ -233,22 +253,41 @@ export async function buildSetupRun(rt, mode, scope, removal = false) {
         ["mcp", "Configure MCP for which files?"],
         ["lsp", "Install the extension into which editors?"],
     ].filter(([target]) => !removal && childrenOf(plan, target).length > 1);
-    if (narrowable.length > 0) {
-        const anyChosen = (answers) => {
+    for (const [target, message] of narrowable) {
+        // Asked whenever the row it narrows is in the run — one direct question,
+        // no meta-question in front of it. Removing a prompt cannot break the
+        // non-interactive paths: `autoPrompt`/`mcpPrompt` return each question's
+        // default, so a smaller prompt list means a smaller answer bag, and the
+        // compose bodies already read an absent child answer as "all". (The
+        // asymmetry is the reason this direction is safe: ADDING a defaultless
+        // prompt would hard-fail with MISSING_REQUIRED_ANSWER.)
+        const rowChosen = (answers) => {
             const chosen = readList(answers, ROWS_ANSWER);
-            return narrowable.some(([target]) => plan.rows.some((row) => row.target === target && isChosen(row, chosen)));
+            return plan.rows.some((row) => row.target === target && isChosen(row, chosen));
         };
-        prompts.push(buildCustomizePrompt(anyChosen));
-        for (const [target, message] of narrowable) {
-            const rowChosen = (answers) => {
-                const chosen = readList(answers, ROWS_ANSWER);
-                return plan.rows.some((row) => row.target === target && isChosen(row, chosen));
-            };
-            prompts.push(buildChildPrompt(plan, target, message, (answers) => answers.customize === true && rowChosen(answers)));
-        }
+        prompts.push(buildChildPrompt(plan, target, message, rowChosen));
     }
     /** The detection behind a row, for composing and for re-reading its draft. */
-    const detectionFor = (row) => detected.find((d) => d.target.id === row.target && d.band === row.band);
+    const detectionFor = (row) => detected.find((d) => d.target.id === row.target && d.scope === row.scope);
+    /**
+     * The success note a row's completion carries — ONE derivation for the
+     * recap's outcome and the live row event's `done` label, so the sentence a
+     * watcher saw land is the sentence the recap repeats. A removal never
+     * borrows the forward child summary: its children are the files the entry is
+     * being taken OUT of, and counting them as `1 updated` described the
+     * opposite of what the run had just done.
+     */
+    const noteFor = (row, answers) => {
+        if (removal)
+            return ACTION_NOTES[row.action];
+        const childKey = CHILD_ANSWER[row.target];
+        const kept = childKey === undefined ? undefined : readList(answers, childKey);
+        return childNote(row, kept) ?? ACTION_NOTES[row.action];
+    };
+    /** The live row listener, when a wizard is watching. See {@link SetupRun}. */
+    let rowListener;
+    /** The id column width — the recap's own rule, so the columns agree. */
+    const idWidth = Math.max(...plan.rows.map((row) => row.target.length));
     const generator = {
         meta: buildMeta(rt, mode === "all" ? `${BIN_NAME} setup` : `${BIN_NAME} setup ${mode}`),
         prompts,
@@ -264,12 +303,28 @@ export async function buildSetupRun(rt, mode, scope, removal = false) {
                 // MCP file paths to every other target's compose.
                 const key = CHILD_ANSWER[row.target];
                 const children = key === undefined ? undefined : readList(answers, key);
+                // A removal stamps the row's identity on every reversal it composes:
+                // `--undo` executes those reversals in a LATER phase (the undo
+                // interpreter's), whose outcomes come back correlated by this key —
+                // see `appliedUndo`.
                 const task = removal
-                    ? hit.target.composeRemoval(hit.detection)
+                    ? hit.target.composeRemoval(hit.detection, rowKey(row.scope, row.target))
                     : hit.target.compose(hit.detection, children);
-                return [{ key: rowKey(row.band, row.target), task }];
+                // The row's progress sentence — the `target  detail — note` shape
+                // `renderProgressLine` prints — so the live view and the recap say the
+                // same thing about the same row.
+                const label = `${row.target.padEnd(idWidth)}  ${row.detail}`;
+                const note = noteFor(row, answers);
+                return [
+                    {
+                        key: rowKey(row.scope, row.target),
+                        label,
+                        doneLabel: note === undefined ? label : `${label} — ${note}`,
+                        task,
+                    },
+                ];
             });
-            return runRowsIsolated(sink, tasks);
+            return runRowsIsolated(sink, tasks, (event) => rowListener?.(event));
         },
     };
     /** The outcome one row ended in, read off the sink and its own draft. */
@@ -294,11 +349,20 @@ export async function buildSetupRun(rt, mode, scope, removal = false) {
         // outcome at all left a converged re-run with a plan-shaped output that
         // claimed nothing had run — while the row still rendered a bare green ✓.
         // Convergence is a real result: one quiet line per row, zero writes.
-        if (row.action === "none")
-            return { status: "noop", note: "unchanged" };
+        //
+        // On a REMOVAL the same state is `kept`, not `noop`: the run owned
+        // nothing here and deliberately left the machine's state standing (the
+        // config the user edited, the editor with no extension copy). That is
+        // standing aside, which the vocabulary marks inert (○), where `noop`'s
+        // green ✓ would claim removal work that never existed.
+        if (row.action === "none") {
+            return removal
+                ? { status: "kept" }
+                : { status: "noop", note: "unchanged" };
+        }
         if (!isChosen(row, chosen))
             return undefined;
-        const error = sink.get(rowKey(row.band, row.target));
+        const error = sink.get(rowKey(row.scope, row.target));
         if (error !== undefined) {
             const pragma = rowPragmaError(error);
             return {
@@ -311,32 +375,66 @@ export async function buildSetupRun(rt, mode, scope, removal = false) {
         }
         if (!isActionable(row.action))
             return { status: "noop" };
-        // A removal never borrows the forward child summary: its children are the
-        // files the entry is being taken OUT of, and counting them as "1 updated"
-        // described the opposite of what the run had just done.
-        const childKey = CHILD_ANSWER[row.target];
-        const kept = childKey === undefined ? undefined : readList(answers, childKey);
-        const note = removal
-            ? ACTION_NOTES[row.action]
-            : (childNote(row, kept) ?? ACTION_NOTES[row.action]);
+        const note = noteFor(row, answers);
         return {
             status: removal ? "removed" : "done",
             ...(note === undefined ? {} : { note }),
         };
     };
+    /** The one answers→plan projection both `applied` faces share. */
+    const project = (answers) => {
+        const chosen = readList(answers, ROWS_ANSWER);
+        return withRows(plan, plan.rows.map((row) => {
+            const outcome = outcomeFor(row, chosen, answers);
+            return {
+                ...row,
+                selected: isChosen(row, chosen),
+                ...(outcome === undefined ? {} : { outcome }),
+            };
+        }));
+    };
     return {
         plan,
         generator,
-        applied: (answers) => {
-            const chosen = readList(answers, ROWS_ANSWER);
-            return withRows(plan, plan.rows.map((row) => {
-                const outcome = outcomeFor(row, chosen, answers);
-                return {
-                    ...row,
-                    selected: isChosen(row, chosen),
-                    ...(outcome === undefined ? {} : { outcome }),
-                };
-            }));
+        setRowListener: (listener) => {
+            rowListener = listener;
+        },
+        applied: project,
+        appliedUndo: (outcomes) => {
+            // The undo path's sink fill. The forward run's recover frames write the
+            // sink WHILE the task is interpreted; a real `--undo` interprets the
+            // task only as the mocked collection walk, so the executed reversals'
+            // outcomes land here instead — same sink, same reader (`outcomeFor`),
+            // other direction. The first failure per row wins: it is the earliest
+            // cause, and the row's note should name it, not the knock-on.
+            sink.clear();
+            for (const outcome of outcomes) {
+                if (outcome.status !== "failed" || outcome.key === undefined)
+                    continue;
+                if (sink.get(outcome.key) !== undefined)
+                    continue;
+                sink.record(outcome.key, outcome.error);
+            }
+            // A row that owed reversals and heard back from NONE of them cannot
+            // report `removed` — nothing proved anything happened. Structurally
+            // every actionable removal row composes at least one keyed reversal,
+            // so this is a guard against a future target breaking that invariant,
+            // not a path any current target takes.
+            const reported = new Set(outcomes.flatMap((o) => (o.key === undefined ? [] : [o.key])));
+            for (const row of plan.rows) {
+                const id = rowKey(row.scope, row.target);
+                if (!isActionable(row.action) || !row.selected)
+                    continue;
+                if (reported.has(id) || sink.get(id) !== undefined)
+                    continue;
+                sink.record(id, {
+                    code: "UNSUPPORTED",
+                    message: "no reversal was executed for this target",
+                });
+            }
+            // No answers: `--undo` asks nothing, so every row falls back to its
+            // own default selection — exactly the set `generate` composed from.
+            return project({});
         },
     };
 }