@canonical/pragma-cli 0.36.0 → 0.38.0

package/dist/src/kernel/packs/storyRules.js

@@ -0,0 +1,151 @@
+/**
+ * The declaration rules a list story must satisfy to be COMPILABLE, checked
+ * without zod so that every story is held to them — including the
+ * distribution's own.
+ *
+ * WHY NOT IN THE GRAMMAR. `schema.ts` is the zod gate, and it runs for config-
+ * and package-declared stories only: `capabilities/distribution.ts` compiles
+ * `pragma.conf.ts` statically and never revalidates it, deliberately, because
+ * zod on the `--help`/`__complete` fast path is latency every invocation pays.
+ * The consequence was that three rules whose violation is a CONFIG_ERROR — a
+ * query a page cannot wrap, a filtered variable the query does not project, a
+ * filter with nothing to admit a value against — were declaration-time refusals
+ * for a third-party author and FIRST-CALL failures for the distribution. The
+ * same rule reaching one tier and missing the other is the shape this domain
+ * keeps closing (see `compileStoryModule`), so the rules live here, in pure
+ * string work the fast path can afford, and the grammar delegates to them
+ * rather than restating them.
+ *
+ * These are the COMPILABILITY rules only. Everything about a definition's
+ * SHAPE — required fields, enums, mutual exclusions, reserved param names —
+ * stays in the zod schema, which is where a shape is best expressed and which
+ * a statically typed `pragma.conf.ts` already satisfies by construction.
+ */
+import { readAuthorQuery } from "./sparql/authorQuery.js";
+import { ENTITY_VARIABLE, RESERVED_VARIABLE_PREFIX, TIER_PARAM, } from "./types.js";
+/** The message a filter declaring neither `values` nor a `vocabulary` gets. */
+const FILTER_VOCABULARY_MESSAGE = 'a filter must declare "values" or a "vocabulary" query — a value-free filter with neither has nothing to check a caller\'s value against';
+/**
+ * Every compilability rule one list-shaped body breaks.
+ *
+ * @param shape - A `list` or an extra list-shaped verb.
+ * @param path - Where that body sits in the definition, for the issue paths.
+ * @returns The issues: each filter's own rule first, at its own `filters.N`
+ *   path, then the query's. A caller reporting only the first (zod, and
+ *   `compileStoryModule`) therefore names the most local fault it can, and the
+ *   query rules stop at the first one that makes the rest unjudgeable — a
+ *   projection cannot be checked against a query the reader could not read.
+ */
+export function listShapeIssues(shape, path) {
+    const issues = [];
+    for (const [index, filter] of (shape.filters ?? []).entries()) {
+        if (filter.values === undefined && filter.vocabulary === undefined) {
+            issues.push({
+                path: [...path, "filters", index],
+                message: FILTER_VOCABULARY_MESSAGE,
+            });
+        }
+    }
+    const constrained = [
+        ...(shape.filters ?? []).map((filter) => filter.variable),
+        ...(shape.search?.variables ?? []),
+    ];
+    const read = readAuthorQuery(shape.query);
+    if (!read.ok) {
+        issues.push({
+            path: [...path, "query"],
+            message: `a list query must be wrappable in a page, and ${read.reason} — every list answer is one page, and a page is a wrapping SELECT over the story's own query.`,
+        });
+        return issues;
+    }
+    if (constrained.length === 0)
+        return issues;
+    if (shape.query.includes(RESERVED_VARIABLE_PREFIX)) {
+        issues.push({
+            path: [...path, "query"],
+            message: `a filtered or searched list query may not use the reserved variable prefix "?${RESERVED_VARIABLE_PREFIX}", which the generated filter clauses bind a caller's values to. Rename it.`,
+        });
+    }
+    const projection = read.query.projection;
+    if (!projection) {
+        issues.push({
+            path: [...path, "query"],
+            message: "a list declaring filters or a search must project its SELECT variables by name — the page projects the same names in the same order, which `SELECT *` cannot promise.",
+        });
+        return issues;
+    }
+    for (const variable of constrained) {
+        if (!projection.includes(variable)) {
+            issues.push({
+                path: [...path, "query"],
+                message: `"${variable}" is filtered or searched but not projected by the query (it selects ${projection.join(", ")}).`,
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * Every compilability rule a whole definition breaks, `list` and extra verbs
+ * alike.
+ *
+ * @param definition - The definition about to be compiled.
+ * @returns The issues, empty when it compiles.
+ */
+export function storyIssues(definition) {
+    const issues = [];
+    if (definition.list) {
+        issues.push(...listShapeIssues(definition.list, ["list"]));
+        issues.push(...tierScopeIssues(definition.tierScope, definition.list, ["list"]));
+    }
+    for (const [index, verb] of (definition.verbs ?? []).entries()) {
+        issues.push(...listShapeIssues(verb, ["verbs", index]));
+        issues.push(...tierScopeIssues(definition.tierScope, verb, ["verbs", index]));
+    }
+    return issues;
+}
+/**
+ * The two rules a TIER-SCOPED noun's list-shaped body must satisfy.
+ *
+ * Both are the same kind of fault — a declaration that would compile and then
+ * scope nothing, silently:
+ *
+ * - It must PROJECT its entity variable. The scope clause constrains that
+ *   variable through the noun's declared `via` edge, so a body that publishes
+ *   rows without it (`standard categories` projects a name and a count) is a
+ *   body the scope cannot narrow. Refusing it here is the difference between a
+ *   declaration error an author reads once and a list that quietly answers
+ *   from every tier while its heading claims a scope.
+ * - Its own filters may not claim the `tier` param, which the kernel puts on
+ *   every tiered noun's reads. A story filter of that name would collide with
+ *   the flag Commander has already registered — the failure mode
+ *   {@link RESERVED_STORY_PARAMS} exists to prevent, conditional here because
+ *   an UNSCOPED noun's `tier` filter is legitimate (`variable list --tier`
+ *   filters the token graph's own `dt:tier`, which this scope does not touch).
+ */
+export function tierScopeIssues(tierScope, shape, path) {
+    if (!tierScope)
+        return [];
+    const issues = [];
+    for (const [index, filter] of (shape.filters ?? []).entries()) {
+        if (filter.param === TIER_PARAM) {
+            issues.push({
+                path: [...path, "filters", index],
+                message: `a tier-scoped story may not declare a "${TIER_PARAM}" filter — the kernel puts that parameter on every tiered noun's reads, and the two would collide`,
+            });
+        }
+    }
+    const read = readAuthorQuery(shape.query);
+    // An unreadable query is already reported by `listShapeIssues`, and the
+    // projection cannot be judged against a query nobody could read.
+    if (!read.ok)
+        return issues;
+    const projection = read.query.projection;
+    if (projection !== undefined && !projection.includes(ENTITY_VARIABLE)) {
+        issues.push({
+            path: [...path, "query"],
+            message: `a tier-scoped story must project ?${ENTITY_VARIABLE} — the tier scope is compiled in as a constraint on that variable (it selects ${projection.join(", ")}).`,
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=storyRules.js.map

package/dist/src/kernel/packs/storyRules.js.map

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

package/dist/src/kernel/packs/tierScope.js

@@ -0,0 +1,310 @@
+/**
+ * The tier scope: which tiers a read of a tiered noun answers from.
+ *
+ * WHAT IT IS FOR. The design system's tier hierarchy has two levels — five
+ * top-level tiers (`global`, `apps`, `sites`, `documentation`, `stores`) and
+ * ten second-level ones beneath `apps` and `sites` — and every read used to
+ * answer from all fifteen at once. `block list` printed 252 blocks, a third of
+ * them belonging to one product's own screens; `block lookup button` printed
+ * the global Button AND Launchpad's, concatenated, with nothing saying why
+ * there were two. The `tier` config key that was supposed to narrow this was
+ * read by nothing. So a read of a tiered noun now has a SCOPE, and the scope is
+ * part of the query rather than a predicate over what the query returned.
+ *
+ * THE RULE, in one place:
+ *
+ * - DEFAULT — the top-level tiers. A tier is top-level when its path-shaped
+ *   name has no `/` (see {@link PackTierScope.by}): nothing sits above it.
+ * - A CHOSEN tier (`--tier apps_lxd`, or `tier: "apps_lxd"` in config) — that
+ *   tier, its ancestors, and the declared base tier. `apps_lxd` therefore
+ *   answers from `global`, `apps` and `apps_lxd`: the blocks an LXD screen is
+ *   actually built from, which is the chain the design system's own colophon
+ *   describes ("a lower tier inherits and overrides the blocks of its
+ *   ancestors").
+ * - `all` — no scope at all, the pre-scope behaviour, reachable per call
+ *   (`--tier all`) or as a setting (`tier: "all"`).
+ *
+ * PRECEDENCE is the one every other per-call argument has: the flag beats the
+ * config, the config beats the default. A per-call `--tier` is not a second
+ * narrowing on top of a configured one — it REPLACES it, because a chain is not
+ * an intersection of chains and an agent that passes `--tier apps_lxd` on a
+ * machine configured to `apps_launchpad` means the first.
+ *
+ * THE HIERARCHY IS READ FROM THE STORE, ONCE. Nothing here enumerates a tier:
+ * the tiers, their names and therefore their parents are read from the pack the
+ * session booted, so a tier added upstream tomorrow is scoped correctly with no
+ * edit here. The read is memoized per store SESSION (not per process): a
+ * `sources update` on the long-lived MCP server invalidates the session, and the
+ * next read re-learns the hierarchy from the pack that replaced it.
+ */
+import { cliRecovery, PragmaError } from "../error/index.js";
+import { formatTerm } from "./sparql/escape.js";
+import { runSelect } from "./sparql/runSelect.js";
+import { EVERY_TIER } from "./types.js";
+/**
+ * Every tier read once per store session, per declaration.
+ *
+ * Keyed on the SESSION so the memo cannot outlive the pack it describes, and
+ * nested by declaration so the three nouns that declare the same hierarchy
+ * (`block`, `modifier`, `concept`) share ONE query rather than issuing three
+ * identical ones per invocation. A `WeakMap` because the session is the owner:
+ * when the runtime drops it, this drops with it.
+ */
+const SESSIONS = new WeakMap();
+/** The SELECT reading every tier and its path-shaped name. */
+function hierarchyQuery(declaration) {
+    return [
+        "SELECT ?tier ?name WHERE {",
+        `  ?tier a ${formatTerm(declaration.type)} .`,
+        `  ?tier ${formatTerm(declaration.by)} ?name .`,
+        "}",
+        "ORDER BY ?name",
+    ].join("\n");
+}
+/**
+ * Read (once per session) the tier hierarchy a declaration describes.
+ *
+ * @param rt - The runtime, for the store and the query facade.
+ * @param declaration - The noun's declared tier hierarchy.
+ * @param source - The story's provenance, for a query diagnosis.
+ * @returns The hierarchy, memoized for this store session.
+ */
+export async function readTierHierarchy(rt, declaration, source) {
+    const session = await rt.store.get();
+    const key = [
+        declaration.type,
+        declaration.via,
+        declaration.by,
+        declaration.base ?? "",
+    ].join("|");
+    let perDeclaration = SESSIONS.get(session);
+    if (!perDeclaration) {
+        perDeclaration = new Map();
+        SESSIONS.set(session, perDeclaration);
+    }
+    const memoized = perDeclaration.get(key);
+    if (memoized)
+        return memoized;
+    const reading = runSelect(rt, hierarchyQuery(declaration), source).then((rows) => buildTierHierarchy(rows.map((row) => ({ iri: row.tier ?? "", name: row.name ?? "" })), declaration));
+    perDeclaration.set(key, reading);
+    return reading;
+}
+/**
+ * The local name of a term: everything after its last `#`, `/` or `:`.
+ *
+ * The `:` is what makes one function serve both spellings a term arrives in. A
+ * tier read out of the store is an absolute IRI
+ * (`https://ds.canonical.com/global`), and the declared `base` beside it is a
+ * PREFIXED name (`ds:global`) — the grammar admits either, everywhere. Reading
+ * only `#` and `/` left `ds:global` as its own local name, so the base tier
+ * matched nothing and the base-first reporting order silently became
+ * alphabetical.
+ */
+export function localName(term) {
+    return term.replace(/^.*[#/:]/, "");
+}
+/**
+ * Every spelling of a tier a caller may type.
+ *
+ * Three, because three are in circulation and all of them are the reader's own
+ * words: the local name the `Tier` column prints (`apps_lxd`), the display name
+ * `tier list` prints (`Apps/LXD`), and that display name with its separator
+ * written the way the IRI writes it (`apps/lxd` — the spelling the config key's
+ * own documentation used before anything read it). Refusing two of the three
+ * would be refusing a value this distribution itself published.
+ */
+function spellings(tier) {
+    return [
+        tier.local.toLowerCase(),
+        tier.name.toLowerCase(),
+        tier.name.toLowerCase().replaceAll("/", "_"),
+    ];
+}
+/**
+ * Build the hierarchy from the rows the store returned.
+ *
+ * Exported for the unit tests, which state the hierarchy rules over a handful
+ * of rows rather than over the shipped pack's fifteen tiers.
+ *
+ * @param rows - One `{ iri, name }` per tier.
+ * @param declaration - The noun's declared tier hierarchy.
+ * @returns The hierarchy, with tiers carrying an empty IRI or name dropped —
+ *   a tier the scope cannot address or place is not a tier it can scope by.
+ */
+export function buildTierHierarchy(rows, declaration) {
+    const tiers = [];
+    for (const row of rows) {
+        if (row.iri === "" || row.name === "")
+            continue;
+        tiers.push({
+            iri: row.iri,
+            name: row.name,
+            local: localName(row.iri),
+            depth: row.name.split("/").length,
+        });
+    }
+    const bySpelling = new Map();
+    for (const tier of tiers) {
+        for (const spelling of spellings(tier)) {
+            if (!bySpelling.has(spelling))
+                bySpelling.set(spelling, tier);
+        }
+    }
+    const declaredBase = declaration.base;
+    const base = declaredBase === undefined
+        ? undefined
+        : tiers.find((tier) => tier.iri === declaredBase ||
+            tier.local.toLowerCase() === localName(declaredBase).toLowerCase());
+    return { tiers, bySpelling, ...(base ? { base } : {}) };
+}
+/**
+ * The reporting order: the base tier first, then shallowest first, then
+ * alphabetical.
+ *
+ * The base leads because it is what the rest inherit from, and the chain then
+ * reads root-to-leaf (`global, apps, apps_lxd`) — the direction the hierarchy
+ * is written in everywhere else in this distribution.
+ */
+function orderTiers(tiers, base) {
+    return [...tiers].sort((left, right) => {
+        if (left.iri === right.iri)
+            return 0;
+        if (base) {
+            if (left.iri === base.iri)
+                return -1;
+            if (right.iri === base.iri)
+                return 1;
+        }
+        return (left.depth - right.depth ||
+            left.local.localeCompare(right.local) ||
+            left.iri.localeCompare(right.iri));
+    });
+}
+/** The tiers whose name states no parent — the default scope. */
+function topLevel(hierarchy) {
+    return hierarchy.tiers.filter((tier) => tier.depth === 1);
+}
+/**
+ * The chosen tier's chain: itself, every tier its name sits under, and the base.
+ *
+ * An ancestor is found by NAME, not by an edge, because the graph asserts no
+ * edge (see {@link PackTierScope}). A name segment naming no declared tier
+ * contributes nothing — an orphan `Apps/LXD` in a pack with no `Apps` is
+ * scoped to itself and the base, which is the honest reading of the only
+ * hierarchy it states.
+ */
+function chain(hierarchy, chosen) {
+    const segments = chosen.name.split("/");
+    const ancestorNames = new Set(segments.slice(0, -1).map((_, index) => segments
+        .slice(0, index + 1)
+        .join("/")
+        .toLowerCase()));
+    const selected = hierarchy.tiers.filter((tier) => tier.iri === chosen.iri ||
+        ancestorNames.has(tier.name.toLowerCase()) ||
+        (hierarchy.base !== undefined && tier.iri === hierarchy.base.iri));
+    return orderTiers(selected, hierarchy.base);
+}
+/**
+ * Resolve the scope one read answers under.
+ *
+ * @param hierarchy - The tiers the store knows.
+ * @param request - The per-call argument and the configured default.
+ * @returns Every tier (when asked for, or when the store knows no tiers), else
+ *   the chosen tier's chain, else the top-level tiers.
+ * @throws PragmaError INVALID_INPUT when a tier was asked for by a name no tier
+ *   answers to, carrying the names that do.
+ */
+export function resolveTierScope(hierarchy, request) {
+    // A graph with no tiers in it is not a narrowed graph: there is nothing to
+    // scope by, so the read answers as it always did and says nothing about a
+    // scope it never applied.
+    if (hierarchy.tiers.length === 0)
+        return { kind: "all" };
+    const perCall = readRequested(request.requested);
+    const asked = perCall ?? request.configured?.trim();
+    if (asked === undefined || asked === "") {
+        return {
+            kind: "tiers",
+            tiers: orderTiers(topLevel(hierarchy), hierarchy.base),
+        };
+    }
+    if (asked.toLowerCase() === EVERY_TIER)
+        return { kind: "all" };
+    const chosen = hierarchy.bySpelling.get(asked.toLowerCase());
+    if (!chosen) {
+        const validOptions = [
+            EVERY_TIER,
+            ...hierarchy.tiers.map((tier) => tier.local).sort(),
+        ];
+        // The recovery names WHERE the bad value came from, because the two places
+        // are fixed differently and only one of them is in the caller's hand: a
+        // per-call `--tier` is retyped, a configured one is unset. A reader whose
+        // machine is set to a tier this pack does not carry would otherwise be told
+        // to retype an argument they never typed.
+        throw PragmaError.invalidInput("tier", asked, {
+            validOptions,
+            recovery: perCall === undefined
+                ? cliRecovery("config unset tier", `The \`tier\` config key names "${asked}", which is not one of this pack's ${hierarchy.tiers.length} tiers. Clear it, or set one that exists.`, { tool: "config_unset", params: { key: "tier" } })
+                : cliRecovery("tier list", `Name one of the ${hierarchy.tiers.length} tiers, or "${EVERY_TIER}" for every tier.`, { tool: "tier_list", params: {} }),
+        });
+    }
+    return { kind: "tiers", tiers: chain(hierarchy, chosen), chosen };
+}
+/**
+ * The per-call argument as a tier name.
+ *
+ * @throws PragmaError INVALID_INPUT when it is not a string — a repeated
+ *   `--tier` is a caller asking for two chains at once, which is not a chain.
+ */
+function readRequested(provided) {
+    if (provided === undefined)
+        return undefined;
+    if (typeof provided === "string") {
+        const trimmed = provided.trim();
+        return trimmed === "" ? undefined : trimmed;
+    }
+    throw PragmaError.invalidInput("tier", String(provided), {
+        recovery: {
+            message: `Pass one tier name, or "${EVERY_TIER}" for every tier.`,
+        },
+    });
+}
+/**
+ * The scope one read of a tiered noun answers under, resolved from everything
+ * that has a say: the story's declaration, the caller's argument, the config.
+ *
+ * @param rt - The runtime (store for the hierarchy, config for the default).
+ * @param declaration - The noun's declared hierarchy, absent when it is not
+ *   tiered — in which case there is no scope and nothing is read.
+ * @param requested - The per-call `--tier` argument, if any.
+ * @param source - The story's provenance, for a query diagnosis.
+ * @returns The scope, or `undefined` for an unscoped noun.
+ * @throws PragmaError INVALID_INPUT when the tier asked for does not exist.
+ */
+export async function resolveReadScope(rt, declaration, requested, source) {
+    if (!declaration)
+        return undefined;
+    const hierarchy = await readTierHierarchy(rt, declaration, source);
+    const { config } = await rt.loadConfig();
+    return resolveTierScope(hierarchy, {
+        requested,
+        ...(config.tier === undefined ? {} : { configured: config.tier }),
+    });
+}
+/**
+ * The scope in the words a reader can type back: `global, apps, apps_lxd`.
+ *
+ * @param scope - The resolved scope.
+ * @returns The in-scope tier local names, or `undefined` for every tier — a
+ *   read that narrowed nothing has no scope to report.
+ */
+export function scopeLabel(scope) {
+    if (scope.kind === "all")
+        return undefined;
+    return scope.tiers.map((tier) => tier.local).join(", ");
+}
+/** The in-scope tier IRIs, for the query filter. */
+export function scopeIris(scope) {
+    return scope.kind === "all" ? [] : scope.tiers.map((tier) => tier.iri);
+}
+//# sourceMappingURL=tierScope.js.map

package/dist/src/kernel/packs/tierScope.js.map

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

package/dist/src/kernel/packs/types.js

@@ -18,10 +18,90 @@
  * is by that canonical index — a pack's declared `levels` is any ordered subset
  * of the canonical set.
  */
+/**
+ * The parameter names the KERNEL puts on a compiled verb, which a story's own
+ * filter may therefore not claim.
+ *
+ * `search` is a story's declared free-text flag; `detail` the disclosure
+ * selector; `name` and `count` a lookup's and a sample's positionals; `limit`
+ * and `after` the page every list-shaped verb carries. A filter claiming one
+ * would collide with a flag the CLI has already registered — a Commander
+ * failure outside every error envelope the CLI owns. Declared here, in the
+ * zod-free grammar, so the validator that refuses them and any reader that
+ * needs to tell a story's OWN params from the kernel's read one list.
+ */
+export const RESERVED_STORY_PARAMS = [
+    "search",
+    "detail",
+    "name",
+    "count",
+    "limit",
+    "after",
+];
+/**
+ * The SPARQL VARIABLE prefix the kernel reserves, which a story's own query may
+ * therefore not use.
+ *
+ * The generated filter and search clauses bind a caller's values to variables
+ * under this prefix (`?__pragmaFilter0`, `?__pragmaSearch`). A story query using
+ * it would have its own variable shadowed, and the symptom would be a filter
+ * matching nothing with nothing raised anywhere. Beside the reserved PARAMS for
+ * the same reason: the grammar that refuses it and the builder that mints it
+ * must read one name, and this file is the zod-free place both can reach — the
+ * builder lives behind the dynamically imported run bodies, so nothing on the
+ * `--help` fast path may import it.
+ */
+export const RESERVED_VARIABLE_PREFIX = "__pragma";
+/**
+ * The `--tier` value that turns the tier scope OFF — every tier, the way every
+ * read answered before the scope existed.
+ *
+ * A word rather than a second flag (this distribution retired an `--all-tiers`
+ * once already): `--tier all` answers the same question the flag already asks,
+ * so there is one argument to learn and one to document.
+ *
+ * Declared HERE, in the zod-free grammar, for the reason
+ * {@link RESERVED_VARIABLE_PREFIX} is: the compiler that puts the flag on a
+ * verb runs on the storeless `--help` fast path, and the run body that reads it
+ * lives behind a dynamic import. Both must read one spelling.
+ */
+export const EVERY_TIER = "all";
+/**
+ * The parameter name the kernel puts on a TIER-SCOPED noun's reads (`--tier`,
+ * `tier` over MCP).
+ *
+ * Not in {@link RESERVED_STORY_PARAMS}, because it is reserved CONDITIONALLY:
+ * an unscoped noun may still declare a `tier` filter of its own, and one does —
+ * `variable list --tier` filters the token graph's `dt:tier`, a different
+ * predicate in a different namespace from the `ds:tier` this scope reads. The
+ * rule that a SCOPED story may not claim it lives in {@link ./storyRules}.
+ */
+export const TIER_PARAM = "tier";
+/**
+ * The SELECT variable a list-shaped story publishes its entity IRI in.
+ *
+ * A convention this package already depends on twice — the condensed renderer
+ * titles a row from `uri`/`name`, and every shipped list's IRI column is `uri`
+ * — stated here because the tier scope is compiled in as a constraint on that
+ * variable, and because both the storeless declaration rules and the query
+ * builder behind the dynamic import must read one spelling of it.
+ */
+export const ENTITY_VARIABLE = "uri";
 /** Whether an expand-select entry is a nested expand (vs a plain field). */
 export function isNestedExpand(entry) {
     return "relation" in entry;
 }
+/**
+ * Which lane resolves one expand: its own declared {@link PackExpand.source},
+ * else the lookup's, else SPARQL.
+ *
+ * Read by BOTH lanes — the GraphQL document generator skips what it does not
+ * own, and the entity fetcher runs it — so the question is answered in one
+ * place rather than asked twice with two spellings.
+ */
+export function expandIsSparql(lookup, expand) {
+    return (expand.source ?? lookup.source ?? "sparql") === "sparql";
+}
 /** A story the distribution itself declares (`pragma.conf.ts` and its kin). */
 export const distributionSource = (label) => ({
     label,

package/dist/src/kernel/packs/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/kernel/packs/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAqEH,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAC5B,KAAuB;IAEvB,OAAO,UAAU,IAAI,KAAK,CAAC;AAC7B,CAAC;AA0ZD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAe,EAAE,CAAC,CAAC;IACjE,KAAK;IACL,MAAM,EAAE,cAAc;CACvB,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/kernel/packs/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;CACR,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC;AAEnD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC;AAEhC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAgGrC,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAC5B,KAAuB;IAEvB,OAAO,UAAU,IAAI,KAAK,CAAC;AAC7B,CAAC;AAiFD;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAkC,EAClC,MAAkC;IAElC,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,QAAQ,CAAC;AACnE,CAAC;AAqgBD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAe,EAAE,CAAC,CAAC;IACjE,KAAK;IACL,MAAM,EAAE,cAAc;CACvB,CAAC,CAAC"}

package/dist/src/kernel/project/cli/buildProgram.js

@@ -124,7 +124,16 @@ function attachVerb(parent, verb, name, programName, globalFlags) {
     registerParams(command, verb);
     command.action(async (...actionArgs) => {
         const { positionals: positionalArgs, opts } = splitActionArgs(actionArgs);
-        await dispatch(verb, positionalArgs, opts, globalFlags);
+        // `command.args` is every operand this leaf received; the action arguments
+        // are only the DECLARED ones, so a verb that declares none is handed
+        // nothing and a stray word vanishes between the two. Dispatch reads the
+        // longer of the two lists and refuses what the verb cannot take
+        // (`dispatch.ts#refuseExcessPositionals`) — Commander's own excess check
+        // cannot: a sub-verb-only noun opts into excess operands to keep its
+        // "unknown command" suggestion, and `copyInheritedSettings` hands that
+        // opt-in down to every verb attached beneath it.
+        const operands = command.args.filter((arg) => typeof arg === "string");
+        await dispatch(verb, operands.length > positionalArgs.length ? operands : positionalArgs, opts, globalFlags);
     });
 }
 /**

package/dist/src/kernel/project/cli/buildProgram.js.map

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