@canonical/pragma-cli 0.34.0 → 0.36.0

package/dist/src/kernel/completion/model.js

@@ -0,0 +1,301 @@
+/**
+ * Build the completion model from the capability modules — the ONE derivation
+ * both tiers share: the static scripts inline it, the `__complete` resolver
+ * walks it, so the two can never disagree.
+ *
+ * `ParamSpec.complete` resolution (defaults when the field is absent):
+ *
+ * | declared         | param kind             | source                     |
+ * | ---------------- | ---------------------- | -------------------------- |
+ * | absent           | enum                   | values (the enum's values) |
+ * | absent           | boolean                | none (flag name only)      |
+ * | absent           | string/number/string[] | none                       |
+ * | `{values}`       | enum only              | values                     |
+ * | `{names,source}` | string/string[]        | names (dynamic tier)       |
+ * | `{names,off}`    | any                    | none (opt-out)             |
+ * | `{files}`        | string/string[]        | files (native shell)       |
+ * | `{none}`         | any                    | none                       |
+ *
+ * Injection safety, primary gate: every token the static tier would inline
+ * (nouns, verb labels, flag names, enum values) must match
+ * {@link SAFE_TOKEN_RE}; the build THROWS otherwise, so `setup completions`
+ * fails loudly and no hostile name ever reaches a shell script. The resolver
+ * wraps this in its never-throw guard, so `__complete` degrades to zero
+ * candidates instead.
+ */
+import { DETAIL_LEVELS, OUTPUT_FORMATS } from "../../constants.js";
+import { kebabCase, verbLabel } from "../spec/index.js";
+/**
+ * The allowlist every inlined completion token must match: an alphanumeric
+ * head, then word/URI-ish characters. No whitespace, quotes, `$`, backticks,
+ * semicolons, or globs — nothing a shell could expand or split.
+ *
+ * KNOWN GAP, deliberately not closed: it admits shell RESERVED WORDS — `esac`,
+ * `in`, `do`, `done`, `fi`. A noun so named emits a `case` arm bash and zsh both
+ * refuse to parse, so `_pragma` is never defined and the user gets NO completion
+ * at all rather than a wrong candidate (`fish -n` does not catch it either). The
+ * gap is owned by the syntax gates, not by this regex: `shellDrive.test.ts`
+ * runs `bash -n`/`zsh -n` over the emitted scripts, so the day a live noun is
+ * named `done` the build fails loudly and names the file. A denylist here would
+ * be new production code guarding a case nothing in the tree exhibits — and a
+ * partial one (reserved words differ across families and versions) reads as
+ * more protection than it gives.
+ */
+export const SAFE_TOKEN_RE = /^[A-Za-z0-9][A-Za-z0-9@/:._+-]*$/;
+/**
+ * Assert a token is safe to inline in a shell script.
+ *
+ * @param token - The candidate token (a noun, verb label, flag name, value).
+ * @param where - Human-readable location for the error message.
+ * @throws Error when the token fails the {@link SAFE_TOKEN_RE} allowlist.
+ */
+export function assertSafeToken(token, where) {
+    if (!SAFE_TOKEN_RE.test(token)) {
+        throw new Error(`completion: unsafe token ${JSON.stringify(token)} in ${where} — ` +
+            `must match ${String(SAFE_TOKEN_RE)}`);
+    }
+}
+/** The global flags completion offers, mirroring the surface's globalFlags. */
+const GLOBAL_FLAGS = [
+    {
+        flag: "--format",
+        takesValue: true,
+        repeatable: false,
+        source: { kind: "values", values: OUTPUT_FORMATS },
+    },
+    { flag: "--verbose", takesValue: false, repeatable: false, source: none() },
+    {
+        flag: "--detail",
+        takesValue: true,
+        repeatable: false,
+        source: { kind: "values", values: DETAIL_LEVELS },
+    },
+    {
+        flag: "--no-headers",
+        takesValue: false,
+        repeatable: false,
+        source: none(),
+    },
+    { flag: "--quiet", takesValue: false, repeatable: false, source: none() },
+    { flag: "--help", takesValue: false, repeatable: false, source: none() },
+    {
+        flag: "--version",
+        takesValue: false,
+        repeatable: false,
+        rootOnly: true,
+        source: none(),
+    },
+];
+/** The flags auto-injected for `mutates` verbs (mirrors `buildProgram`). */
+const MUTATION_FLAGS = [
+    { flag: "--dry-run", takesValue: false, repeatable: false, source: none() },
+    { flag: "--undo", takesValue: false, repeatable: false, source: none() },
+    { flag: "--yes", takesValue: false, repeatable: false, source: none() },
+];
+/** The `{kind:"none"}` source (shared instance). */
+function none() {
+    return { kind: "none" };
+}
+/**
+ * Resolve a param's completion source from `ParamSpec.complete` + its kind
+ * (the table in the module docblock).
+ */
+function resolveSource(param) {
+    const declared = param.complete;
+    if (declared === undefined) {
+        return param.kind === "enum"
+            ? { kind: "values", values: param.values }
+            : none();
+    }
+    switch (declared.kind) {
+        case "values":
+            // The zod refinement makes {values} on a non-enum unregistrable; the
+            // model mirrors the rule structurally rather than trusting call order.
+            return param.kind === "enum"
+                ? { kind: "values", values: param.values }
+                : none();
+        case "names":
+            // The per-family opt-out (`enabled:false`) collapses to no completion.
+            if (declared.enabled === false)
+                return none();
+            return {
+                kind: "names",
+                ref: declared.source,
+                match: declared.match ?? "substring",
+                caseSensitive: declared.caseSensitive ?? false,
+            };
+        case "files":
+            return { kind: "files" };
+        case "none":
+            return none();
+    }
+}
+/** Assert the safety of every token a source could inline statically. */
+function assertSafeSource(source, where) {
+    if (source.kind === "values") {
+        for (const value of source.values) {
+            assertSafeToken(value, `${where} value`);
+        }
+    }
+    if (source.kind === "names" && source.ref.type && source.ref.type !== "") {
+        // The type key is never inlined into a script (only NAMES are, at runtime,
+        // through the same allowlist) — but keep any non-empty type well-formed
+        // anyway. An empty/absent type is the legitimate "any type" query (`graph
+        // inspect`), matched against every entity by the index reader.
+        assertSafeToken(source.ref.type, `${where} names type`);
+    }
+}
+/** Project one verb spec into its completion entry, asserting name safety. */
+function toVerbEntry(verb) {
+    const label = verbLabel(verb.path);
+    assertSafeToken(label, `verb "${verb.path.join(" ")}"`);
+    const flags = [];
+    const positionals = [];
+    for (const param of verb.params) {
+        const source = resolveSource(param);
+        if (param.positional) {
+            assertSafeSource(source, `positional "${param.name}"`);
+            positionals.push({
+                name: param.name,
+                required: param.required === true,
+                variadic: param.kind === "string[]",
+                source,
+            });
+        }
+        else {
+            const name = kebabCase(param.name);
+            assertSafeToken(name, `flag "--${name}"`);
+            assertSafeSource(source, `flag "--${name}"`);
+            flags.push({
+                flag: `--${name}`,
+                takesValue: param.kind !== "boolean",
+                // Two grammars accumulate, so two shapes are repeatable: a `string[]`
+                // flag (`--tag a --tag b`) and any `string`/`enum` param the spec
+                // marks `repeatable` — the form compiled packs give every declared
+                // filter. Reading only the kind de-offered a filter after its first
+                // use, hiding the repetition the parser had just started honouring.
+                repeatable: param.kind === "string[]" || param.repeatable === true,
+                source,
+            });
+        }
+    }
+    return { label, mutates: verb.capability.mutates, flags, positionals };
+}
+/**
+ * Convert one module-declared completion node (a mounted subtree's static
+ * data) into a verb entry, asserting every inlinable token's safety exactly
+ * as spec-derived entries are asserted. `mutates` is the owning verb's
+ * mutability, applied only to the LEAVES (see the namespace note below).
+ */
+function toMountedEntry(spec, mutates, where) {
+    assertSafeToken(spec.label, `${where} label`);
+    const flags = spec.flags.map((flag) => {
+        const name = flag.flag.replace(/^--?/, "");
+        assertSafeToken(name, `${where} flag "${flag.flag}"`);
+        const source = flag.values
+            ? { kind: "values", values: flag.values }
+            : none();
+        assertSafeSource(source, `${where} flag "${flag.flag}"`);
+        return {
+            flag: flag.flag,
+            takesValue: flag.takesValue,
+            repeatable: false,
+            source,
+        };
+    });
+    const positionals = spec.positionals.map((positional) => {
+        const source = positional.values
+            ? { kind: "values", values: positional.values }
+            : positional.files
+                ? { kind: "files" }
+                : none();
+        assertSafeSource(source, `${where} positional "${positional.name}"`);
+        return {
+            name: positional.name,
+            required: positional.required,
+            variadic: false,
+            source,
+        };
+    });
+    const children = spec.children && spec.children.length > 0
+        ? spec.children.map((child) => toMountedEntry(child, mutates, `${where}/${child.label}`))
+        : undefined;
+    return {
+        label: spec.label,
+        // A node with children is a NAMESPACE, not a runnable command:
+        // `registerGeneratorCommands` adds the host mutation trio to runnable
+        // LEAVES only, so a mutating namespace would offer `--dry-run`/`--undo`/
+        // `--yes` BEFORE the framework segment — an ordering the CLI rejects as
+        // an unknown option. The verb's mutability descends to the leaves.
+        mutates: children ? false : mutates,
+        flags,
+        positionals,
+        ...(children ? { children } : {}),
+    };
+}
+/**
+ * Derive the completion model from the capability modules.
+ *
+ * Hidden verbs are excluded (matching `emitSurface` and `buildProgram`).
+ * Every noun in the model comes from a declared verb — `mcp` used to be
+ * injected here because the bin served it without a spec, and it now declares
+ * `mcp serve` like any other pair.
+ *
+ * @param modules - The capability modules.
+ * @returns The completion model, nouns and verbs sorted.
+ * @throws Error when any inlined token fails the safety allowlist.
+ */
+export function buildCompletionModel(modules) {
+    const byNoun = new Map();
+    const bucketFor = (noun) => {
+        const existing = byNoun.get(noun);
+        if (existing)
+            return existing;
+        const created = { verbs: [] };
+        byNoun.set(noun, created);
+        return created;
+    };
+    for (const module of modules) {
+        // A module-owned mount REPLACES its verbs' completion surface: the flags
+        // the mounted tree actually registers (e.g. a default-on confirm's
+        // `--no-` form), the segment positionals, and the child walk — declared
+        // as static data by the module, converted and safety-asserted here.
+        const mountedChildren = module.cliProjection?.completionChildren();
+        for (const verb of module.verbs) {
+            if (verb.hidden)
+                continue;
+            const noun = verb.path[0];
+            assertSafeToken(noun, `noun "${noun}"`);
+            const bucket = bucketFor(noun);
+            const mountedSpec = mountedChildren?.[verbLabel(verb.path)];
+            const entry = mountedSpec
+                ? toMountedEntry(mountedSpec, verb.capability.mutates, `mounted "${verb.path.join(" ")}"`)
+                : toVerbEntry(verb);
+            if (verb.path[1] === undefined) {
+                bucket.selfVerb = entry;
+            }
+            else {
+                bucket.verbs.push(entry);
+            }
+        }
+    }
+    const nouns = [...byNoun.entries()]
+        .map(([noun, bucket]) => ({
+        noun,
+        ...(bucket.selfVerb ? { selfVerb: bucket.selfVerb } : {}),
+        verbs: [...bucket.verbs].sort((a, b) => a.label.localeCompare(b.label)),
+    }))
+        .sort((a, b) => a.noun.localeCompare(b.noun));
+    return { nouns, globalFlags: GLOBAL_FLAGS, mutationFlags: MUTATION_FLAGS };
+}
+/**
+ * Look up a noun's entry in the model.
+ *
+ * @param model - The completion model.
+ * @param noun - The noun token.
+ * @returns The entry, or `undefined` for an unknown noun.
+ */
+export function findNoun(model, noun) {
+    return model.nouns.find((entry) => entry.noun === noun);
+}
+//# sourceMappingURL=model.js.map

package/dist/src/kernel/completion/model.js.map

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

package/dist/src/kernel/completion/parse.js

@@ -0,0 +1,253 @@
+/**
+ * The argv state machine: classify the word being completed.
+ *
+ * `parseWords(words, model)` scans the words BEFORE the cursor to establish
+ * position — noun, verb (or self-verb), positionals consumed, pending value
+ * flag, end-of-options — then classifies the LAST word (the partial, possibly
+ * empty) into a `CompletionContext`. Pure and storeless: only the model and
+ * the words.
+ *
+ * Scan rules (prior words, in order):
+ * - A pending value flag consumes the next word as its value. A bare `=`
+ *   while pending is transparent — bash splits `--flag=v` into
+ *   `--flag`,`=`,`v` (COMP_WORDBREAKS), so `=` tokens around a value-taking
+ *   flag are wordbreak noise, not values.
+ * - The first bare `--` is the user's end-of-options: everything after is a
+ *   positional, never a flag. (The `__complete -- <words…>` FRAMING `--` was
+ *   already stripped by the bin.)
+ * - A `-…` word (before `--`) is looked up across verb flags → mutation
+ *   flags (mutating verbs) → global flags: known value-taking flags without
+ *   an inline `=` set the pending flag; known flags are marked used;
+ *   unknown flags are skipped silently.
+ * - The first non-flag word is the noun; the second resolves a sub-verb, or
+ *   falls back to the noun's self-verb as its first positional; later ones
+ *   count positionals. Unknown nouns/verbs make non-flag contexts terminal
+ *   (`nothing`), but flag contexts still complete (globals always apply).
+ *
+ * Classification of the current word (first match wins):
+ * 1. pending value flag → flag-value for that flag
+ * 2. `--name=partial` with a known value-taking flag → flag-value
+ * 3. `-…` (before `--`) → flag-name (scoped, used flags de-offered,
+ *    `--version` at root only, mutation flags iff the verb mutates)
+ * 4. no noun yet → noun
+ * 5. unknown noun/verb → nothing
+ * 6. noun with sub-verbs, verb undecided → verb
+ * 7. verb resolved → positional at the running index (a trailing variadic
+ *    absorbs all further indices; past the end → nothing)
+ */
+import { BIN_NAME } from "../../constants.js";
+import { findNoun } from "./model.js";
+/** The resolved verb entry, when one is decided and known. */
+function knownVerb(state) {
+    return typeof state.verb === "object" ? state.verb : undefined;
+}
+/** Every flag entry in scope at the current position (offer order). */
+function flagScope(model, state) {
+    const verb = knownVerb(state);
+    const atRoot = state.noun === undefined;
+    return [
+        ...(verb?.flags ?? []),
+        ...(verb?.mutates ? model.mutationFlags : []),
+        ...model.globalFlags.filter((flag) => atRoot || flag.rootOnly !== true),
+    ];
+}
+/** Look up a flag by its full `--name` token in the current scope. */
+function lookupFlag(model, state, name) {
+    return flagScope(model, state).find((entry) => entry.flag === name);
+}
+/** Consume a prior `-…` word: mark used, maybe set the pending value flag. */
+function scanFlagWord(word, model, state) {
+    const eq = word.indexOf("=");
+    if (eq !== -1) {
+        const entry = lookupFlag(model, state, word.slice(0, eq));
+        if (entry)
+            state.used.add(entry.flag); // inline value travels with the word
+        return;
+    }
+    const entry = lookupFlag(model, state, word);
+    if (entry === undefined)
+        return; // unknown flags are skipped silently
+    state.used.add(entry.flag);
+    if (entry.takesValue)
+        state.pendingValueFlag = entry;
+}
+/** Consume a prior non-flag word: noun, then verb/self-verb, then positionals. */
+function scanCommandWord(word, model, state) {
+    if (state.noun === undefined) {
+        const entry = findNoun(model, word);
+        if (entry === undefined) {
+            state.noun = "unknown";
+            return;
+        }
+        state.noun = entry;
+        // A self-verb-only noun is its own verb; positionals start right away.
+        if (entry.verbs.length === 0 && entry.selfVerb) {
+            state.verb = entry.selfVerb;
+        }
+        return;
+    }
+    if (state.noun === "unknown" || state.verb === "unknown")
+        return;
+    if (state.verb === undefined) {
+        const match = state.noun.verbs.find((verb) => verb.label === word);
+        if (match) {
+            state.verb = match;
+            return;
+        }
+        if (state.noun.selfVerb) {
+            // Not a sub-verb: the word is the self-verb's first positional.
+            state.verb = state.noun.selfVerb;
+            state.positionalsSeen = 1;
+            return;
+        }
+        state.verb = "unknown";
+        return;
+    }
+    // A verb with segment children (a mounted subtree): the word resolves
+    // against the children BEFORE positional counting — a match descends, so
+    // deeper flags/positionals are the child's own; a non-match is terminal.
+    const resolved = knownVerb(state);
+    if (resolved?.children && resolved.children.length > 0) {
+        const child = resolved.children.find((entry) => entry.label === word);
+        if (child) {
+            state.verb = child;
+            state.positionalsSeen = 0;
+            return;
+        }
+        state.verb = "unknown";
+        return;
+    }
+    state.positionalsSeen += 1;
+}
+/** The positional entry at an index (a trailing variadic absorbs the rest). */
+function positionalAt(verb, index) {
+    const direct = verb.positionals[index];
+    if (direct)
+        return direct;
+    const last = verb.positionals[verb.positionals.length - 1];
+    return last?.variadic ? last : undefined;
+}
+/** Flag names offerable now: scoped, de-offered when used and not repeatable. */
+function offeredFlagNames(model, state) {
+    return flagScope(model, state)
+        .filter((entry) => entry.repeatable || !state.used.has(entry.flag))
+        .map((entry) => entry.flag);
+}
+/** Classify the current word against the scanned state (rules 1–7). */
+function classify(current, model, state) {
+    const pending = state.pendingValueFlag;
+    if (pending) {
+        // bash `=` wordbreaks: `--flag =` completes an empty value, `--flag = v`
+        // arrives as a leading-`=` partial in some shells.
+        const partial = current === "="
+            ? ""
+            : current.startsWith("=")
+                ? current.slice(1)
+                : current;
+        return {
+            context: {
+                kind: "flag-value",
+                flag: pending.flag,
+                source: pending.source,
+            },
+            partial,
+        };
+    }
+    if (!state.sawDashDash && current.startsWith("--")) {
+        const eq = current.indexOf("=");
+        if (eq !== -1) {
+            const entry = lookupFlag(model, state, current.slice(0, eq));
+            if (entry?.takesValue) {
+                return {
+                    context: {
+                        kind: "flag-value",
+                        flag: entry.flag,
+                        source: entry.source,
+                    },
+                    partial: current.slice(eq + 1),
+                };
+            }
+        }
+    }
+    if (!state.sawDashDash && current.startsWith("-")) {
+        return {
+            context: { kind: "flag-name", flags: offeredFlagNames(model, state) },
+            partial: current,
+        };
+    }
+    if (state.noun === undefined) {
+        return { context: { kind: "noun" }, partial: current };
+    }
+    if (state.noun === "unknown") {
+        return {
+            context: { kind: "nothing", reason: "unknown noun" },
+            partial: current,
+        };
+    }
+    if (state.verb === "unknown") {
+        return {
+            context: { kind: "nothing", reason: "unknown verb" },
+            partial: current,
+        };
+    }
+    if (state.verb === undefined) {
+        return {
+            context: { kind: "verb", noun: state.noun.noun },
+            partial: current,
+        };
+    }
+    const positional = positionalAt(state.verb, state.positionalsSeen);
+    if (positional === undefined) {
+        return {
+            context: { kind: "nothing", reason: "positionals exhausted" },
+            partial: current,
+        };
+    }
+    return {
+        context: {
+            kind: "positional",
+            name: positional.name,
+            source: positional.source,
+        },
+        partial: current,
+    };
+}
+/**
+ * Parse completion words into a classified request.
+ *
+ * @param words - The command words up to and including the cursor word (the
+ *   last word is the partial being completed, possibly empty). A leading
+ *   word equal to `binName` is stripped.
+ * @param model - The completion model.
+ * @param binName - The program name some shells include as the first word.
+ * @returns The classified context plus the partial.
+ */
+export function parseWords(words, model, binName = BIN_NAME) {
+    const stripped = words[0] === binName ? words.slice(1) : words;
+    const current = stripped[stripped.length - 1] ?? "";
+    const prior = stripped.slice(0, -1);
+    const state = {
+        positionalsSeen: 0,
+        sawDashDash: false,
+        used: new Set(),
+    };
+    for (const word of prior) {
+        if (state.pendingValueFlag) {
+            if (word === "=")
+                continue; // bash wordbreak noise, value still pending
+            state.pendingValueFlag = undefined; // the word is the flag's value
+            continue;
+        }
+        if (!state.sawDashDash && word === "--") {
+            state.sawDashDash = true;
+            continue;
+        }
+        if (!state.sawDashDash && word.startsWith("-")) {
+            scanFlagWord(word, model, state);
+            continue;
+        }
+        scanCommandWord(word, model, state);
+    }
+    return classify(current, model, state);
+}
+//# sourceMappingURL=parse.js.map

package/dist/src/kernel/completion/parse.js.map

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