@canonical/pragma-cli 0.34.0 → 0.36.0

package/dist/src/capabilities/resources/provider.js

@@ -0,0 +1,423 @@
+/**
+ * The MCP resource browser — a `pragma:{+uri}` template over the pack index.
+ *
+ * Listing and autocomplete are STORELESS: they read the enriched `index.json`
+ * (readPackIndex) off disk, so the resource surface costs nothing until an agent
+ * reads one. They read it for the pack the BOOT DECISION names, so the listing
+ * can never advertise entities whose reads then fail STORE_UNAVAILABLE. A read
+ * is STORE-BACKED through the SHARED {@link readEntity} — the same reader
+ * `graph inspect` uses — so a resource read and a `graph inspect` of the same
+ * URI return identical content (the mirror contract).
+ *
+ * The listing is CURATED, not paged. MCP has a `cursor`/`nextCursor` contract
+ * for `resources/list`, but the SDK's high-level `McpServer` list handler
+ * ignores `request.params.cursor` and never returns a `nextCursor` (verified on
+ * the wire against 1.27.1), so "list everything, the client will page it" means
+ * "send everything, every connect". Listing all 712 indexed entities cost an
+ * agent ~155 KB of context before it had asked a single question. So a module
+ * DECLARES the slices of the index it contributes ({@link McpListable}) and the
+ * listing is their union: the collections, plus the schema that describes them.
+ * The individuals stay fully reachable — by the `{+uri}` template, whose
+ * autocomplete still offers every one of them.
+ *
+ * Degradation (Risk4): on a missing or legacy (pre-v2) index the listing returns
+ * a single "run `pragma sources update`" hint — never a live re-index of the
+ * store on the resource path. That hint is itself READABLE (it is the only
+ * resource a cold server advertises, and an advertised resource that refuses to
+ * be read is worse than no resource at all).
+ *
+ * The MCP SDK's `ResourceTemplate` is dynamic-imported inside `register` so this
+ * module — reachable on the capabilities import graph — never pulls the SDK onto
+ * the `--help`/`__complete` fast path.
+ */
+import { BIN_NAME } from "../../constants.js";
+import { matchesType, readPackIndex, } from "../../kernel/completion/entitySource.js";
+import { asPragmaError } from "../../kernel/error/fromTaskError.js";
+import { PragmaError } from "../../kernel/error/index.js";
+import { mcpErrorFrom } from "../../kernel/project/mcp/mcpError.js";
+import { toTurtle } from "../../kernel/render/turtle.js";
+import { readEntity } from "../../kernel/runtime/readEntity.js";
+import { resolveSources } from "../../kernel/runtime/resolveSources.js";
+/**
+ * The weight an unweighted slice carries — "as important as any other".
+ *
+ * The ONLY editorial number left in this module. The judgements that used to
+ * live here as `CLASS_PRIORITY = 0.9` / `INDIVIDUAL_PRIORITY = 0.3` are now
+ * declared data (`McpListableRef.weight`, derived from `PackLookup.weights`):
+ * which of a distribution's classes deserves an agent's attention first is a
+ * fact about that distribution's graph, not about the kernel that serves it.
+ */
+const DEFAULT_WEIGHT = 1;
+/** The reserved listing entry that explains an unusable store. */
+const SOURCES_URI = "pragma:sources";
+/** The `{+uri}` variable value that addresses {@link SOURCES_URI}. */
+const SOURCES_VARIABLE = "sources";
+/**
+ * The media type an entity read RETURNS — and therefore the one the listing
+ * ADVERTISES for every entry it mints.
+ *
+ * One constant, three readers (the template registration, the read body, and
+ * each listed entry). The listing promising `application/json` while the read
+ * answers Turtle is the same shape of failure as the `recipes:{+uri}` template
+ * over `pragma:` URIs: a surface describing content it does not serve.
+ */
+const ENTITY_MIME_TYPE = "text/turtle";
+/** The recovery hint is prose about a broken store, not graph content. */
+const RECOVERY_MIME_TYPE = "text/plain";
+/**
+ * The `pragma:` URI scheme + the single reserved-expansion template variable.
+ *
+ * A LITERAL, and it must stay one until the wire identifiers move together.
+ * `surface/surface.v2.json` freezes `pragma:{+uri}` as protocol identity, and
+ * `buildResourceList` mints `pragma:<prefixed>` for every entry it lists —
+ * three writings of one decision. Deriving only this one made a fork advertise
+ * `recipes:{+uri}` over a list of 653 `pragma:` URIs: every resource the server
+ * offered became unreadable, and the readable form was never advertised.
+ * `resources.test.ts` pins the pair through {@link resourceProvider}'s declared
+ * surface; `identity.test.ts` masks this template out of its leak scan for the
+ * same reason.
+ */
+const URI_TEMPLATE = "pragma:{+uri}";
+const TEMPLATE_DESCRIPTION = "Knowledge-graph entities from the local pack, as Turtle. Read any entry by " +
+    "its prefixed URI (e.g. pragma:ds:global.component.button); autocomplete " +
+    "matches URI or label substrings. A read returns the entity's neighbourhood — " +
+    "its own triples, the edges pointing AT it, and its blank nodes inlined. " +
+    `Content mirrors \`${BIN_NAME} graph inspect <uri> --format llm\`.`;
+/**
+ * The audience every listed resource carries.
+ *
+ * BOTH roles. `["assistant"]` tells a client that honours the field to hide the
+ * resource from its human picker, and browsing a design system in a picker is
+ * exactly a human use case — the same entries serve an agent orienting itself
+ * and a person looking for the button spec.
+ */
+const LISTING_AUDIENCE = ["user", "assistant"];
+/**
+ * The human name for an entity, best-available-first.
+ *
+ * `altNames` is the distribution's declared alternative-name property — the
+ * name a bespoke lookup MATCHES on ("Button", "FileTree"). 383 of the embedded
+ * pack's 714 entities carry one and no `rdfs:label`, so before this the listing
+ * showed them as a bare URI with no description while the readable name sat
+ * unused in the index one field away.
+ */
+function humanName(entity) {
+    return entity.label ?? entity.altNames?.[0] ?? undefined;
+}
+/** Render one index entity as a listed resource at a given weight. */
+function listEntity(entity, weight, instanceCount) {
+    const title = humanName(entity);
+    // `pragma/box` + `pragma/instanceCount` are FROZEN protocol identity (see
+    // `surface.v2.json` and docs/mcp-integration.md). `pragma/type` is an
+    // ADDITION: all 714 entities carry a type, and publishing it lets an agent
+    // narrow the listing to a family without spending a read to find out what
+    // each entry is.
+    const meta = {
+        "pragma/box": entity.box ?? "abox",
+        "pragma/type": entity.type,
+    };
+    if (typeof instanceCount === "number") {
+        meta["pragma/instanceCount"] = instanceCount;
+    }
+    return {
+        uri: `pragma:${entity.prefixed ?? entity.name}`,
+        name: entity.prefixed ?? entity.name,
+        ...(title ? { title } : {}),
+        ...(entity.description ? { description: entity.description } : {}),
+        mimeType: ENTITY_MIME_TYPE,
+        annotations: { audience: LISTING_AUDIENCE, priority: weight },
+        _meta: meta,
+    };
+}
+/** The recovery entry a missing/legacy index degrades to (and its read body). */
+const SOURCES_RECOVERY = `No enriched entity index. Run \`${BIN_NAME} sources update\` to build it.`;
+/** The single entry a server with no usable index advertises. */
+function sourcesEntry() {
+    return {
+        uri: SOURCES_URI,
+        name: SOURCES_VARIABLE,
+        title: "Store not indexed",
+        description: SOURCES_RECOVERY,
+        mimeType: RECOVERY_MIME_TYPE,
+    };
+}
+/**
+ * Resolve one declared slice into listed resources.
+ *
+ * `as: "collection"` yields at most ONE entry — the class entry for the slice's
+ * type, carrying `pragma/instanceCount`. A type the index does not know
+ * contributes NOTHING rather than an empty collection: `ds:Token` is declared by
+ * a read story but SPARQL-served, never indexed, and advertising an empty
+ * collection for it would promise a browse that has nothing to show.
+ */
+function listSlice(index, byPrefixed, ref) {
+    const weight = ref.weight ?? DEFAULT_WEIGHT;
+    if (ref.as === "collection") {
+        const type = ref.type;
+        if (!type)
+            return [];
+        const entity = byPrefixed.get(type);
+        if (!entity)
+            return [];
+        // A class with no instances has NO key in `instanceCountByType`, so reading
+        // it straight through reports `undefined` — and an empty collection then
+        // looks identical to an entry that is not a collection at all. A declared
+        // collection whose class the index knows always states a count, and for an
+        // empty one that count is zero.
+        const count = entity.uri ? (index.instanceCountByType[entity.uri] ?? 0) : 0;
+        return [listEntity(entity, weight, count)];
+    }
+    const listed = [];
+    for (const entity of index.entities) {
+        if (ref.box && (entity.box ?? "abox") !== ref.box)
+            continue;
+        if (!matchesType(entity, ref.type ?? ""))
+            continue;
+        const count = entity.box === "tbox" && entity.uri
+            ? index.instanceCountByType[entity.uri]
+            : undefined;
+        listed.push(listEntity(entity, weight, count));
+    }
+    return listed;
+}
+/**
+ * Build the resource listing from the storeless pack index.
+ *
+ * @param index - The active pack index, or `undefined` when none is reachable.
+ * @param listing - The union of the modules' declared slices.
+ * @returns One resource per contributed entry, heaviest slice first; a single
+ *   recovery entry when the index is missing or pre-v2 (no enrichment).
+ */
+export function buildResourceList(index, listing) {
+    // readPackIndex returns raw JSON.parse output (no zod), so guard structurally:
+    // a malformed index missing `version` must degrade to the recovery hint, not
+    // fall through to `[...index.entities]` (a TypeError inside the MCP handler).
+    if (!index || index.version !== 2 || !Array.isArray(index.entities)) {
+        return [sourcesEntry()];
+    }
+    const byPrefixed = new Map();
+    for (const entity of index.entities) {
+        const key = entity.prefixed ?? entity.name;
+        // A punned subject is indexed as two facets sharing one key; the schema
+        // facet is the one a collection entry means.
+        if (!byPrefixed.has(key) || entity.box === "tbox")
+            byPrefixed.set(key, entity);
+    }
+    const candidates = listing.sources.flatMap((ref) => listSlice(index, byPrefixed, ref));
+    candidates.sort((a, b) => {
+        const priority = (r) => r.annotations?.priority ?? 0;
+        const boxRank = (r) => r._meta?.["pragma/box"] === "tbox" ? 0 : 1;
+        return (priority(b) - priority(a) ||
+            boxRank(a) - boxRank(b) ||
+            a.uri.localeCompare(b.uri));
+    });
+    // Dedup by resource URI. Two slices may contribute the same entry (a story's
+    // collection IS one of the ontology's schema entries), and an OWL-punned
+    // subject (a class/property IRI ALSO asserted as a domain individual) is
+    // indexed as TWO entities — a tbox and an abox facet — that compact to the
+    // SAME `pragma:<uri>` (A8). The sort above puts the heavier slice, then the
+    // tbox facet, first, so keeping the first occurrence per URI surfaces the
+    // richer entry (its instance count and higher priority) and drops the rest.
+    const seen = new Set();
+    const resources = [];
+    for (const candidate of candidates) {
+        if (seen.has(candidate.uri))
+            continue;
+        seen.add(candidate.uri);
+        resources.push(candidate);
+    }
+    return resources;
+}
+/**
+ * The per-type ranking weights a declared listing implies.
+ *
+ * A slice that names a `type` is an opinion about that type's importance, and
+ * the SAME opinion should decide both what the listing surfaces first and what
+ * autocomplete offers first — one declaration, two readers. A slice that names
+ * only a `box` carries no opinion about a candidate URI, so it contributes none.
+ *
+ * @param listing - The union of the modules' declared slices.
+ * @returns Prefixed type → weight (heaviest declaration wins on a repeat).
+ */
+export function completionWeights(listing) {
+    const weights = {};
+    for (const ref of listing.sources) {
+        if (!ref.type)
+            continue;
+        const weight = ref.weight ?? DEFAULT_WEIGHT;
+        weights[ref.type] = Math.max(weights[ref.type] ?? 0, weight);
+    }
+    return weights;
+}
+/**
+ * Rank URI autocomplete candidates against a partial query (case-insensitive
+ * over both the prefixed URI and the label; exact > prefix > substring).
+ *
+ * UNCAPPED on purpose. The SDK derives the wire's `total`/`hasMore` from the
+ * array this returns — it slices to 100, reports `total: values.length` and
+ * `hasMore: values.length > 100` — so pre-truncating here made a truncated
+ * result describe itself as complete: `ds:` answered
+ * `{ values: 50, total: 50, hasMore: false }` while 499 entities matched.
+ * Completion keeps offering EVERY entity: it is the discovery path for the
+ * individuals the curated listing no longer enumerates.
+ *
+ * @param entities - The index entities to rank.
+ * @param query - The partial the agent typed.
+ * @param weights - Prefixed type → weight, breaking ties between equal matches.
+ * @returns Every matching prefixed URI, best first.
+ */
+/**
+ * The weight of an entity across EVERY type it is declared under.
+ *
+ * `PackIndexEntity.type` is one lexically chosen primary among `types`, and the
+ * listing's own `matchesType` already honours both. Weighing only the primary
+ * therefore ignored a weight declared for a secondary type, and let ranking
+ * shift when an unrelated, lexically earlier type was added to an entity.
+ *
+ * The LOWEST declared weight wins: a weight below the default is a demotion, and
+ * a demotion that any membership asks for should not be cancelled by another
+ * membership that simply never asked for anything. Types with no declared weight
+ * do not vote, so an entity nobody weighted keeps the default.
+ */
+function effectiveWeight(entity, weights) {
+    const memberships = entity.types ?? [entity.type];
+    const declared = memberships
+        .map((type) => weights[type])
+        .filter((weight) => weight !== undefined);
+    return declared.length > 0 ? Math.min(...declared) : DEFAULT_WEIGHT;
+}
+export function rankUriCompletions(entities, query, weights = {}) {
+    const needle = query.toLowerCase();
+    const score = (field) => field === needle
+        ? 3
+        : field.startsWith(needle)
+            ? 2
+            : field.includes(needle)
+                ? 1
+                : 0;
+    const scored = [];
+    for (const entity of entities) {
+        const prefixed = entity.prefixed ?? entity.name;
+        const uriScore = score(prefixed.toLowerCase());
+        const labelScore = entity.label ? score(entity.label.toLowerCase()) : 0;
+        const best = Math.max(uriScore, labelScore);
+        if (best > 0) {
+            scored.push({
+                prefixed,
+                score: best,
+                weight: effectiveWeight(entity, weights),
+            });
+        }
+    }
+    // Match quality first, then the DECLARED weight, then the alphabet. The
+    // weight step is what stops 86 `…-close_button` subcomponents from burying
+    // `ds:global.component.button` on the strength of their spelling alone.
+    scored.sort((a, b) => b.score - a.score ||
+        b.weight - a.weight ||
+        a.prefixed.localeCompare(b.prefixed));
+    const seen = new Set();
+    const ranked = [];
+    for (const { prefixed } of scored) {
+        if (seen.has(prefixed))
+            continue;
+        seen.add(prefixed);
+        ranked.push(prefixed);
+    }
+    return ranked;
+}
+/**
+ * The union of every module's declared listing.
+ *
+ * @param modules - The effective capability modules.
+ * @returns One listing holding every declared slice, in module order.
+ */
+export function collectListable(modules) {
+    return {
+        sources: modules.flatMap((module) => module.mcpListable?.sources ?? []),
+    };
+}
+/** Read the single `uri` template variable, tolerating array expansion. */
+function readUriVariable(value) {
+    const uri = Array.isArray(value) ? value.at(0) : value;
+    if (uri === undefined) {
+        throw PragmaError.invalidInput("uri", String(value), {
+            recovery: { message: "Provide a prefixed or full entity URI." },
+        });
+    }
+    return uri;
+}
+/** The graph-entity resource provider (registered by buildServer). */
+export const resourceProvider = {
+    // The single authoring point for the template id — the surface emitter reads
+    // this so `mcpSurface.resources` cannot drift from what `register` installs.
+    surface: { templates: [URI_TEMPLATE] },
+    async register(server, runtime, modules) {
+        const { ResourceTemplate } = await import("@modelcontextprotocol/sdk/server/mcp.js");
+        const { McpError, ErrorCode } = await import("@modelcontextprotocol/sdk/types.js");
+        // The index of the pack the boot decision names — `undefined` when the
+        // store is unavailable, which `buildResourceList` renders as the recovery
+        // entry rather than a catalogue of unreadable URIs.
+        const activeIndex = async () => readPackIndex(resolveSources(await runtime.loadConfig(), runtime.cwd));
+        // What the SERVER lists is the union of what its modules declare — not what
+        // this one module knows. Collected once, at registration.
+        const listing = collectListable(modules);
+        const weights = completionWeights(listing);
+        const template = new ResourceTemplate(URI_TEMPLATE, {
+            list: async () => ({
+                resources: buildResourceList(await activeIndex(), listing),
+            }),
+            complete: {
+                // Uncapped: the SDK slices to 100 and derives `total`/`hasMore` from
+                // the full array, so returning it is what makes those numbers honest.
+                uri: async (value) => rankUriCompletions((await activeIndex())?.entities ?? [], value, weights),
+            },
+        });
+        server.registerResource("graph-entity", template, 
+        // `text/turtle` because that is what the body IS. The surface used to
+        // claim `application/json` for a graph, and paid ~95 bytes of wrapper per
+        // named node to do it — one button read carried ~6.1 KB of pure structure.
+        // Turtle spends the prefixes once, writes each term as itself, and says
+        // IRI-versus-literal in syntax rather than in a `termType` field.
+        { description: TEMPLATE_DESCRIPTION, mimeType: ENTITY_MIME_TYPE }, async (url, variables) => {
+            try {
+                const uri = readUriVariable(variables.uri);
+                // The recovery entry is a real resource, not a label. It is the ONLY
+                // thing a server with no usable index advertises, and reading it used
+                // to fail `INVALID_INPUT — Invalid uri "sources"`: the one resource on
+                // offer refused to be read, so the hint that explains the cold store
+                // was unreachable from the surface that showed it.
+                if (uri === SOURCES_VARIABLE) {
+                    return {
+                        contents: [
+                            {
+                                uri: url.href,
+                                mimeType: RECOVERY_MIME_TYPE,
+                                text: SOURCES_RECOVERY,
+                            },
+                        ],
+                    };
+                }
+                const entity = await readEntity(runtime, uri);
+                const { prefixes } = await runtime.store.get();
+                return {
+                    contents: [
+                        {
+                            uri: url.href,
+                            mimeType: ENTITY_MIME_TYPE,
+                            text: toTurtle(entity, prefixes),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                // Surface the failure as a JSON-RPC error (the resource-read analogue
+                // of a tool result's `isError`), preserving the machine code AND the
+                // recovery in `data` — never swallow it into `text/plain` content an
+                // agent reads as a successful entity (which dropped the recovery and
+                // masked a cold store as though the entity itself were malformed).
+                throw mcpErrorFrom(asPragmaError(error), { McpError, ErrorCode });
+            }
+        });
+    },
+};
+//# sourceMappingURL=provider.js.map

package/dist/src/capabilities/resources/provider.js.map

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

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

@@ -0,0 +1,172 @@
+/**
+ * Build the plan: run the target table's detections, then project them into
+ * {@link SetupPlan} rows.
+ *
+ * This is the ONE place a plan comes from. The dry-run, the wizard, the apply
+ * phase, the recap and `--format json` all read what this produces, so a row
+ * that is missing here is missing everywhere — which is the point: the run-all
+ * used to build its choices only from DETECTABLE steps, so a target that could
+ * not be offered vanished from the recap and "Setup complete" papered over it.
+ * Every selected target is a visible row here, including the ones that skip.
+ */
+import { defaultSelected, } from "./plan.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 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.
+ *
+ * @param rt - The per-invocation runtime.
+ * @returns The roots every row path renders relative to.
+ * @note Impure — reads the platform environment.
+ */
+export async function resolveRoots(rt) {
+    const { readPlatformEnv, userHome } = await import("@canonical/harnesses");
+    return { global: userHome(readPlatformEnv()), project: rt.cwd };
+}
+/** 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 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
+ * it on every invocation.
+ *
+ * Independence is the whole premise, so one detection that throws — an
+ * 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 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 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 = scopesForSelection(scope).flatMap((scope) => wanted
+        .filter((target) => supportsScope(target, scope))
+        .map((target) => ({
+        target,
+        scope,
+    })));
+    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, scope, detection: outcome.value };
+        }
+        return {
+            target,
+            scope,
+            detection: undefined,
+            failure: messageOf(outcome.reason),
+        };
+    });
+}
+/**
+ * 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 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 outOfScopeRow = (target, scope) => ({
+    target: target.id,
+    scope,
+    action: "skip",
+    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,
+});
+/**
+ * The row a target gets when its own detection threw. It is a `skip` in the
+ * PLAN — nothing can be composed from a detection that does not exist — but it
+ * is not a quiet one: the reason is the cause, and the apply phase turns it
+ * 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, scope, failure) => ({
+    target: target.id,
+    scope,
+    action: "skip",
+    detail: "detection did not complete",
+    reason: failure,
+    selected: false,
+});
+/**
+ * The draft a detected row produces — the forward plan, or the removal plan.
+ * Re-derivable from the detection at any time, which is why the plan row itself
+ * stores no remedy: a remedy belongs to an OUTCOME, and the apply phase reads it
+ * back from here when it fills one in.
+ *
+ * @param hit - The detected row.
+ * @param roots - The two named roots.
+ * @param removal - Whether this invocation removes rather than installs.
+ * @returns The target's draft.
+ */
+export function draftFor(hit, roots, removal) {
+    return removal
+        ? hit.target.removalPlan(hit.detection, hit.scope, roots)
+        : hit.target.plan(hit.detection, hit.scope, roots);
+}
+/**
+ * Project detections into plan rows.
+ *
+ * @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 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(selection, roots, detected, ids, removal = false) {
+    const rows = [];
+    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.scope === scope);
+            if (hit === undefined) {
+                // 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(outOfScopeRow(target, scope));
+                continue;
+            }
+            const failure = detectionFailure(hit);
+            if (failure !== undefined) {
+                rows.push(failedDetectionRow(target, scope, failure));
+                continue;
+            }
+            const draft = draftFor(hit, roots, removal);
+            rows.push({
+                target: target.id,
+                scope,
+                action: draft.action,
+                detail: draft.detail,
+                ...(draft.reason === undefined ? {} : { reason: draft.reason }),
+                ...(draft.children === undefined ? {} : { children: draft.children }),
+                selected: defaultSelected(draft.action),
+            });
+        }
+    }
+    return { scope: selection, roots, rows };
+}
+//# sourceMappingURL=buildPlan.js.map

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

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

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

@@ -0,0 +1,5 @@
+/**
+ * The `setup` capability barrel.
+ */
+export { setupModule } from "./setup.verb.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/capabilities/setup/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}