@canonical/pragma-cli 0.34.0 → 0.36.0

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

@@ -0,0 +1,101 @@
+/**
+ * Candidate ranking and filtering for the completion tiers.
+ *
+ * Two disciplines, deliberately different:
+ * - {@link filterPrefix} for STRUCTURAL sets (nouns, verbs, flag names):
+ *   case-sensitive `startsWith` + lexicographic sort, agreeing with what the
+ *   static scripts' `compgen -W` would produce for the same table.
+ * - {@link rankCandidates} for VALUE sets (enum values, entity names):
+ *   case-insensitive exact > prefix > substring, deduped, tie-broken
+ *   lexicographically, capped — ported from the v1 `rankUriCompletions`.
+ */
+/** Maximum candidates a ranked (value-tier) resolution returns. */
+export const MAX_CANDIDATES = 50;
+/** Match strength of a partial against one candidate, higher is better. */
+const NO_MATCH = 0;
+const FUZZY_MATCH = 1;
+const SUBSTRING_MATCH = 2;
+const PREFIX_MATCH = 3;
+const EXACT_MATCH = 4;
+/** Whether every char of `needle` appears in `hay`, in order (subsequence). */
+function isSubsequence(needle, hay) {
+    if (needle === "")
+        return true;
+    let i = 0;
+    for (const ch of hay) {
+        if (ch === needle[i] && ++i === needle.length)
+            return true;
+    }
+    return false;
+}
+/**
+ * Score a folded candidate against a folded partial under a match strategy.
+ * `prefix` accepts only exact/prefix; `substring` (default) adds substring;
+ * `fuzzy` additionally accepts an in-order subsequence, ranked lowest.
+ */
+function score(candidate, partial, match) {
+    if (candidate === partial)
+        return EXACT_MATCH;
+    if (candidate.startsWith(partial))
+        return PREFIX_MATCH;
+    if (match === "prefix")
+        return NO_MATCH;
+    if (candidate.includes(partial))
+        return SUBSTRING_MATCH;
+    if (match === "fuzzy" && isSubsequence(partial, candidate))
+        return FUZZY_MATCH;
+    return NO_MATCH;
+}
+/**
+ * Rank value candidates for a partial word.
+ *
+ * Exact > prefix > substring > fuzzy; ties broken by the candidate text for
+ * determinism; duplicates dropped; capped at `limit`. Case-insensitive by
+ * default (canonical casing is preserved in the emitted candidate — `bu` →
+ * `Button`). An empty partial matches everything (as a prefix), so it lists the
+ * full set sorted.
+ *
+ * @param candidates - The candidate values.
+ * @param partial - The partial word being completed.
+ * @param limit - Maximum candidates to return.
+ * @param match - Match strategy (default `"substring"`).
+ * @param caseSensitive - Match case-sensitively (default `false`).
+ * @returns Ranked, deduped, capped candidates (original casing preserved).
+ */
+export function rankCandidates(candidates, partial, limit = MAX_CANDIDATES, match = "substring", caseSensitive = false) {
+    const fold = (value) => caseSensitive ? value : value.toLowerCase();
+    const needle = fold(partial);
+    const scored = [];
+    for (const candidate of candidates) {
+        const strength = score(fold(candidate), needle, match);
+        if (strength > NO_MATCH)
+            scored.push({ candidate, strength });
+    }
+    scored.sort((a, b) => b.strength !== a.strength
+        ? b.strength - a.strength
+        : a.candidate.localeCompare(b.candidate));
+    const seen = new Set();
+    const ranked = [];
+    for (const { candidate } of scored) {
+        if (seen.has(candidate))
+            continue;
+        seen.add(candidate);
+        ranked.push(candidate);
+        if (ranked.length >= limit)
+            break;
+    }
+    return ranked;
+}
+/**
+ * Filter a structural set by a case-sensitive prefix.
+ *
+ * @param candidates - The structural candidates (nouns, verbs, flag names).
+ * @param partial - The partial word being completed.
+ * @returns The matches, deduped and sorted lexicographically.
+ */
+export function filterPrefix(candidates, partial) {
+    return [...new Set(candidates)]
+        .filter((candidate) => candidate.startsWith(partial))
+        .sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=rank.js.map

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

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

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

@@ -0,0 +1,100 @@
+/**
+ * Resolve a classified completion request into candidates.
+ *
+ * Structural contexts (noun, verb, flag-name) filter their model-derived
+ * tables with the case-sensitive {@link filterPrefix} — the same offers the
+ * static scripts inline. Value contexts (flag-value, positional) go through
+ * the source table: enum values and entity names are ranked case-insensitively
+ * and capped; `files` returns nothing (the static scripts complete files
+ * natively — the resolver never lists the filesystem); `none` and unknown
+ * (reserved) kinds return nothing.
+ *
+ * Injection safety, runtime gate: every value-tier candidate must match the
+ * same {@link SAFE_TOKEN_RE} allowlist the emit-time gate enforces — hostile
+ * names from an index file are dropped before they can reach a shell buffer.
+ * Structural candidates were already asserted safe when the model was built.
+ */
+import { findNoun, SAFE_TOKEN_RE } from "./model.js";
+import { filterPrefix, MAX_CANDIDATES, rankCandidates } from "./rank.js";
+/**
+ * Write a completion debug line to stderr when `PRAGMA_COMPLETE_DEBUG=1`.
+ * Silent otherwise — stdout is reserved for candidates, and stderr must not
+ * leak into shell buffers during normal completion.
+ *
+ * @param message - The debug message (prefixed with `[complete]`).
+ * @note Impure — reads the environment, writes stderr.
+ */
+export function completionDebug(message) {
+    if (process.env.PRAGMA_COMPLETE_DEBUG === "1") {
+        process.stderr.write(`[complete] ${message}\n`);
+    }
+}
+/** Drop candidates that fail the shell-safety allowlist (with a debug note). */
+function sanitize(candidates) {
+    const safe = candidates.filter((candidate) => SAFE_TOKEN_RE.test(candidate));
+    if (safe.length !== candidates.length) {
+        completionDebug(`dropped ${candidates.length - safe.length} unsafe candidate(s)`);
+    }
+    return safe;
+}
+/** Resolve a value-tier source into ranked, sanitized candidates. */
+async function resolveSource(source, partial, env) {
+    switch (source.kind) {
+        case "values":
+            return rankCandidates(sanitize(source.values), partial);
+        case "names": {
+            let names;
+            try {
+                names = await env.names(source.ref);
+            }
+            catch (error) {
+                // The seam contract is never-throw; degrade anyway, never break TAB.
+                completionDebug(`name source read failed: ${error instanceof Error ? error.message : String(error)}`);
+                return [];
+            }
+            return rankCandidates(sanitize(names), partial, MAX_CANDIDATES, source.match, source.caseSensitive);
+        }
+        case "files":
+            // Consumer rule: files are completed natively by the shell scripts
+            // (compgen -f / _files / fish -rF); the resolver offers nothing.
+            return [];
+        case "none":
+            return [];
+        default: {
+            // Reserved kinds ({kind:"query"} and future ones) are not in the union;
+            // if one arrives at runtime it resolves to nothing, with a reason.
+            const kind = source.kind;
+            completionDebug(`nothing: reserved completion kind "${kind}"`);
+            return [];
+        }
+    }
+}
+/**
+ * Resolve a parsed completion request against the model and environment.
+ *
+ * @param request - The classified context plus partial from `parseWords`.
+ * @param model - The completion model.
+ * @param env - The completion environment (the entity seam).
+ * @returns Matching candidates, ranked/filtered per tier; `[]` when there is
+ *   nothing to offer.
+ */
+export async function resolveRequest(request, model, env) {
+    const { context, partial } = request;
+    switch (context.kind) {
+        case "noun":
+            return filterPrefix(model.nouns.map((entry) => entry.noun), partial);
+        case "verb": {
+            const noun = findNoun(model, context.noun);
+            return filterPrefix((noun?.verbs ?? []).map((verb) => verb.label), partial);
+        }
+        case "flag-name":
+            return filterPrefix(context.flags, partial);
+        case "flag-value":
+        case "positional":
+            return resolveSource(context.source, partial, env);
+        case "nothing":
+            completionDebug(`nothing: ${context.reason}`);
+            return [];
+    }
+}
+//# sourceMappingURL=resolve.js.map

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

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

package/dist/src/kernel/completion/templates/bash.js

@@ -0,0 +1,209 @@
+// biome-ignore-all lint/suspicious/noTemplateCurlyInString: bash parameter expansions, not JS templates
+/**
+ * The bash completion script (static tier). Requires bash >= 4 for `mapfile`.
+ * That floor is NOT guaranteed by the platform any more: the package dropped
+ * its `os: ["linux"]` pin when it stopped shipping a linux-x64 executable, and
+ * macOS still ships bash 3.2, which has no `mapfile`. `setup completions`
+ * writes this script wherever it is asked to; on such a machine the user's
+ * remedy is a newer bash (zsh and fish are unaffected and are the platform
+ * defaults there).
+ *
+ * Structure — nouns, verbs, flag names, enum values — is inlined into
+ * generator-validated LITERAL `compgen -W` tables (never a variable, never
+ * anything `compgen -W` could evaluate). File params use native `compgen -f`.
+ * Only `{kind:"names"}` contexts exec the CLI: `mapfile` ingests
+ * `pragma __complete` output line-by-line, so candidates are never
+ * word-split or evaluated. That exec is gated by `minChars` (structure + enum
+ * values still complete on bare TAB with zero exec). No `eval`, no backticks,
+ * `--` guards throughout.
+ */
+import { globalFlagNames, globalValueFlags, hasOwnFlags, nounNames, offeredFlagNames, rootFlagNames, valueFlagNames, verbViews, wordList, } from "./shared.js";
+/** A shell-safe function-name base for the bin (`pragma` -> `_pragma`). */
+function fnBase(binName) {
+    return `_${binName.replace(/[^A-Za-z0-9_]/g, "_")}`;
+}
+/** The bash action completing a value source, or undefined for `none`. */
+function sourceAction(source, fn) {
+    switch (source.kind) {
+        case "values":
+            return `COMPREPLY=($(compgen -W "${wordList(source.values, "bash values")}" -- "$cur"))`;
+        case "files":
+            return 'COMPREPLY=($(compgen -f -- "$cur"))';
+        case "names":
+            return `${fn}_dynamic`;
+        case "none":
+            return undefined;
+    }
+}
+/** The `noun/verb/--flag` case arms answering flag-value contexts. */
+function flagValueArms(model, fn) {
+    const arms = [];
+    for (const view of verbViews(model)) {
+        for (const flag of view.verb.flags) {
+            if (!flag.takesValue)
+                continue;
+            const action = sourceAction(flag.source, fn);
+            // A known value flag with nothing to offer still returns silently, so
+            // its value slot is never mistaken for a positional.
+            arms.push(`    ${view.key}/${flag.flag}) ${action === undefined ? "return" : `${action}; return`} ;;`);
+        }
+    }
+    return arms;
+}
+/** The global `--flag` case arms (e.g. --format, --detail values). */
+function globalValueArms(model, fn) {
+    return globalValueFlags(model).flatMap((flag) => {
+        const action = sourceAction(flag.source, fn);
+        return action === undefined
+            ? []
+            : [`    ${flag.flag}) ${action}; return ;;`];
+    });
+}
+/** The `noun/verb` case arms offering per-verb flag names. */
+function flagNameArms(model) {
+    return verbViews(model)
+        .filter(hasOwnFlags)
+        .map((view) => `      ${view.key}) COMPREPLY=($(compgen -W "${wordList(offeredFlagNames(model, view), "bash flags")}" -- "$cur")); return ;;`);
+}
+/** The `noun` case arms offering sub-verb labels. */
+function verbArms(model) {
+    return model.nouns
+        .filter((entry) => entry.verbs.length > 0)
+        .map((entry) => `      ${entry.noun}) COMPREPLY=($(compgen -W "${wordList(entry.verbs.map((verb) => verb.label), "bash verbs")}" -- "$cur")); return ;;`);
+}
+/** The positional case arm for one view, or undefined when it offers nothing. */
+function positionalArm(model, view, fn) {
+    const slots = [];
+    view.verb.positionals.forEach((positional, index) => {
+        const action = sourceAction(positional.source, fn);
+        if (action === undefined)
+            return;
+        const last = index === view.verb.positionals.length - 1;
+        const pattern = positional.variadic && last ? "*" : String(index);
+        slots.push(`        ${pattern}) ${action} ;;`);
+    });
+    if (slots.length === 0)
+        return undefined;
+    return [
+        `    ${view.key})`,
+        `      ${fn}_pos ${view.skipWords} "${wordList(valueFlagNames(model, view), "bash value flags")}"`,
+        '      case "$POS" in',
+        ...slots,
+        "      esac",
+        "      ;;",
+    ].join("\n");
+}
+/** Wrap case arms in a `case` statement, or nothing when there are no arms. */
+function caseBlock(subject, arms, indent) {
+    if (arms.length === 0)
+        return [];
+    return [`${indent}case ${subject} in`, ...arms, `${indent}esac`];
+}
+/**
+ * Render the bash completion script.
+ *
+ * @param model - The completion model.
+ * @param binName - The binary to complete (function names derive from it).
+ * @param minChars - Minimum typed chars before a name source execs `__complete`.
+ * @returns The script text.
+ */
+export function bashScript(model, binName, minChars) {
+    const fn = fnBase(binName);
+    const positionalArms = verbViews(model).flatMap((view) => {
+        const arm = positionalArm(model, view, fn);
+        return arm === undefined ? [] : [arm];
+    });
+    const globalValueSkips = globalValueFlags(model)
+        .map((flag) => flag.flag)
+        .join("|");
+    // Emit the verb block only when there are arms (bash rejects an empty then).
+    const verbSection = verbArms(model).length === 0
+        ? []
+        : [
+            "",
+            "  # verbs",
+            '  if [ -z "$verb" ]; then',
+            ...caseBlock('"$noun"', verbArms(model), "    "),
+            "  fi",
+        ];
+    const lines = [
+        `# ${binName} bash completion (static tier) — generated by \`${binName} setup completions\`. Do not edit.`,
+        "# Structure (nouns, verbs, flags, enum values) is inlined and never execs;",
+        `# entity arguments call \`${binName} __complete\` (storeless, never-throw);`,
+        "# file arguments use native completion. Requires bash >= 4 (mapfile).",
+        `${fn}_dynamic() {`,
+        ...(minChars > 0 ? [`  [ \${#cur} -ge ${minChars} ] || return 0`] : []),
+        `  mapfile -t COMPREPLY < <("${binName}" __complete -- "\${COMP_WORDS[@]:1:COMP_CWORD-1}" "$cur" 2>/dev/null)`,
+        "}",
+        `${fn}_pos() {`,
+        '  local skip="$1" vflags=" $2 " i w',
+        "  POS=0",
+        "  for ((i = 1; i < COMP_CWORD; i++)); do",
+        '    w="${COMP_WORDS[i]}"',
+        '    case "$w" in',
+        '      -*) case "$vflags" in *" $w "*) ((i++)) ;; esac ;;',
+        '      *) if [ "$skip" -gt 0 ]; then skip=$((skip - 1)); else POS=$((POS + 1)); fi ;;',
+        "    esac",
+        "  done",
+        "}",
+        `${fn}() {`,
+        "  local cur prev noun verb i w POS",
+        '  cur="${COMP_WORDS[COMP_CWORD]}"',
+        '  prev="${COMP_WORDS[COMP_CWORD-1]}"',
+        "  # Normalize the COMP_WORDBREAKS '=' split so a --flag=value context routes",
+        "  # as a flag value (mirrors parse.ts). The default breaks split",
+        "  # `--flag=val` into `--flag` `=` `val`; a custom COMP_WORDBREAKS may keep",
+        "  # `--flag=val` whole. Either way, recover $prev=flag and $cur=value.",
+        '  if [[ "$cur" == "=" ]]; then',
+        '    cur=""',
+        '  elif [[ "$prev" == "=" ]]; then',
+        '    prev="${COMP_WORDS[COMP_CWORD-2]}"',
+        '  elif [[ "$cur" == --*=* ]]; then',
+        '    prev="${cur%%=*}"',
+        '    cur="${cur#*=}"',
+        "  fi",
+        '  noun="" verb="" POS=0',
+        "  for ((i = 1; i < COMP_CWORD; i++)); do",
+        '    w="${COMP_WORDS[i]}"',
+        '    case "$w" in',
+        `      ${globalValueSkips}) ((i++)) ;;`,
+        "      -*) ;;",
+        "      *)",
+        '        if [ -z "$noun" ]; then noun="$w"',
+        '        elif [ -z "$verb" ]; then verb="$w"',
+        "        fi",
+        "        ;;",
+        "    esac",
+        "  done",
+        "",
+        "  # flag values (verb-scoped, then global)",
+        ...caseBlock('"$noun/$verb/$prev"', flagValueArms(model, fn), "  "),
+        ...caseBlock('"$prev"', globalValueArms(model, fn), "  "),
+        "",
+        "  # flag names",
+        '  if [[ "$cur" == -* ]]; then',
+        ...caseBlock('"$noun/$verb"', flagNameArms(model), "    "),
+        '    if [ -z "$noun" ]; then',
+        `      COMPREPLY=($(compgen -W "${wordList(rootFlagNames(model), "bash root flags")}" -- "$cur"))`,
+        "    else",
+        `      COMPREPLY=($(compgen -W "${wordList(globalFlagNames(model), "bash global flags")}" -- "$cur"))`,
+        "    fi",
+        "    return",
+        "  fi",
+        "",
+        "  # nouns",
+        '  if [ -z "$noun" ]; then',
+        `    COMPREPLY=($(compgen -W "${wordList(nounNames(model), "bash nouns")}" -- "$cur"))`,
+        "    return",
+        "  fi",
+        ...verbSection,
+        "",
+        "  # positionals",
+        ...caseBlock('"$noun/$verb"', positionalArms, "  "),
+        "}",
+        `complete -F ${fn} ${binName}`,
+        "",
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=bash.js.map

package/dist/src/kernel/completion/templates/bash.js.map

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

package/dist/src/kernel/completion/templates/fish.js

@@ -0,0 +1,214 @@
+/**
+ * The fish completion script (static tier). Requires fish >= 3.
+ *
+ * Declarative: one `complete -c` rule per fact, gated by the
+ * `__<bin>_at <noun> [verb]` position probe. Default file completion is
+ * suppressed (`-f`); enum values are inlined literals; file params force
+ * native files back on (`-rF`); only `{kind:"names"}` contexts exec the CLI
+ * via a command substitution — fish treats substitution results as literal
+ * candidates (split on newlines, never evaluated). Each name rule ANDs a
+ * `__<bin>_minchars` guard into its condition, so the exec waits for `minChars`
+ * typed chars, and a name-source POSITIONAL also ANDs `__<bin>_notflag` — fish
+ * evaluates every matching rule rather than one exclusive branch, so without it
+ * a structural `--<TAB>` would spawn the delegate too. No `eval`, no backticks.
+ *
+ * Static-tier coarseness (the resolver is exact): positional value rules are
+ * not index-gated, and a mixed self-verb + sub-verb noun only offers its
+ * sub-verbs — `__complete` answers both cases precisely.
+ */
+import { globalValueFlags, nounNames, verbViews, wordList } from "./shared.js";
+/** A shell-safe function-name base for the bin (`pragma` -> `__pragma`). */
+function fnBase(binName) {
+    return `__${binName.replace(/[^A-Za-z0-9_]/g, "_")}`;
+}
+/** AND a guard into a rule's condition (or start one with it). */
+function and(condition, guard) {
+    return condition ? `${condition}; and ${guard}` : guard;
+}
+/** AND a `minChars` guard into a name rule's condition (or start one). */
+function withMinChars(fn, condition, minChars) {
+    if (minChars <= 0)
+        return condition;
+    return and(condition, `${fn}_minchars ${minChars}`);
+}
+/** The rule fragment completing one flag of a view (or a global flag). */
+function flagRule(binName, fn, condition, flag, minChars) {
+    const name = flag.flag.replace(/^--/, "");
+    // A name-source value gates its exec on `minChars`; other rules keep the bare
+    // position condition (enum/file/none complete on bare TAB).
+    const cond = flag.takesValue && flag.source.kind === "names"
+        ? withMinChars(fn, condition, minChars)
+        : condition;
+    const parts = [`complete -c ${binName}`];
+    if (cond)
+        parts.push(`-n "${cond}"`);
+    parts.push(`-l ${name}`);
+    if (flag.takesValue) {
+        switch (flag.source.kind) {
+            case "values":
+                parts.push(`-x -a "${wordList(flag.source.values, "fish values")}"`);
+                break;
+            case "files":
+                parts.push("-rF");
+                break;
+            case "names":
+                parts.push(`-x -a "(${binName} __complete -- (${fn}_words) 2>/dev/null)"`);
+                break;
+            case "none":
+                parts.push("-x");
+                break;
+        }
+    }
+    return parts.join(" ");
+}
+/** The positional value rule for a view, or undefined when it offers nothing. */
+function positionalRule(binName, fn, condition, verb, minChars) {
+    // fish rules are not index-gated; offer the union of the verb's positional
+    // sources (a name source delegates to the resolver, which IS index-exact).
+    const values = new Set();
+    let names = false;
+    let files = false;
+    for (const positional of verb.positionals) {
+        if (positional.source.kind === "values") {
+            for (const value of positional.source.values)
+                values.add(value);
+        }
+        if (positional.source.kind === "names")
+            names = true;
+        if (positional.source.kind === "files")
+            files = true;
+    }
+    // A name source gates its exec on `minChars` AND on the current token not
+    // being a flag; a values/files positional keeps the bare position condition
+    // so it still completes on bare TAB.
+    //
+    // The `_notflag` half is what keeps a purely STRUCTURAL `--<TAB>` free of
+    // exec. fish evaluates every `complete` rule matching a position, so without
+    // it this positional rule fires alongside the flag-name rules the moment the
+    // token clears `minChars` — and `--` is two characters. That cost a process
+    // spawn per TAB on a flag name AND put the delegate's answer in the user's
+    // candidate list. bash and zsh route the same context through one exclusive
+    // `case` arm and exec nothing; this is how fish joins them.
+    const cond = names
+        ? withMinChars(fn, and(condition, `${fn}_notflag`), minChars)
+        : condition;
+    const parts = [`complete -c ${binName} -n "${cond}"`];
+    if (names) {
+        parts.push(`-a "(${binName} __complete -- (${fn}_words) 2>/dev/null)"`);
+    }
+    else if (values.size > 0) {
+        parts.push(`-a "${wordList([...values].sort(), "fish positional values")}"`);
+    }
+    else if (files) {
+        parts.push("-F");
+    }
+    else {
+        return undefined;
+    }
+    return parts.join(" ");
+}
+/**
+ * Render the fish completion script.
+ *
+ * @param model - The completion model.
+ * @param binName - The binary to complete (function names derive from it).
+ * @param minChars - Minimum typed chars before a name source execs `__complete`.
+ * @returns The script text.
+ */
+export function fishScript(model, binName, minChars) {
+    const fn = fnBase(binName);
+    const globalValueSkips = wordList(globalValueFlags(model).map((flag) => flag.flag), "fish global value flags");
+    const lines = [
+        `# ${binName} fish completion (static tier) — generated by \`${binName} setup completions\`. Do not edit.`,
+        "# Structure (nouns, verbs, flags, enum values) is inlined and never execs;",
+        `# name arguments call \`${binName} __complete\` (storeless, never-throw) once`,
+        `# ${minChars} chars are typed; file arguments use native completion (-rF). Requires fish >= 3.`,
+        `function ${fn}_words`,
+        "    set -l toks (commandline -opc)",
+        "    set -l cur (commandline -ct)",
+        "    printf '%s\\n' $toks[2..-1] $cur",
+        "end",
+        ...(minChars > 0
+            ? [
+                `function ${fn}_minchars`,
+                "    test (string length -- (commandline -ct)) -ge $argv[1]",
+                "end",
+            ]
+            : []),
+        // True when the token being completed is not a flag, so a name-source
+        // positional rule stays out of a structural `--<TAB>`.
+        `function ${fn}_notflag`,
+        "    not string match -q -- '-*' (commandline -ct)",
+        "end",
+        `function ${fn}_at`,
+        "    set -l cmd (commandline -opc)",
+        "    set -l noun ''",
+        "    set -l verb ''",
+        "    set -l skip 0",
+        "    for w in $cmd[2..-1]",
+        "        if test $skip -eq 1",
+        "            set skip 0",
+        "            continue",
+        "        end",
+        "        switch $w",
+        `            case ${globalValueSkips}`,
+        "                set skip 1",
+        "            case '-*'",
+        "            case '*'",
+        '                if test -z "$noun"',
+        "                    set noun $w",
+        '                else if test -z "$verb"',
+        "                    set verb $w",
+        "                end",
+        "        end",
+        "    end",
+        '    test "$noun" = "$argv[1]"; and test "$verb" = "$argv[2]"',
+        "end",
+        `complete -c ${binName} -f`,
+        "",
+        "# nouns",
+        `complete -c ${binName} -n "${fn}_at ''" -a "${wordList(nounNames(model), "fish nouns")}"`,
+        "",
+        "# global flags",
+        ...model.globalFlags.map((flag) => flagRule(binName, fn, flag.rootOnly === true ? `${fn}_at ''` : undefined, flag, minChars)),
+    ];
+    for (const entry of model.nouns) {
+        if (entry.verbs.length > 0) {
+            lines.push("", `# ${entry.noun} verbs`, `complete -c ${binName} -n "${fn}_at ${entry.noun}" -a "${wordList(entry.verbs.map((verb) => verb.label), "fish verbs")}"`);
+        }
+    }
+    for (const view of verbViews(model)) {
+        // A mixed noun's self-verb state is not expressible with the probe; its
+        // sub-verbs own the second word and the resolver owns the rest.
+        if (view.self &&
+            view.verb.positionals.length === 0 &&
+            view.verb.flags.length === 0 &&
+            !view.verb.mutates) {
+            continue;
+        }
+        const nounEntry = model.nouns.find((entry) => entry.noun === view.noun);
+        if (view.self && (nounEntry?.verbs.length ?? 0) > 0)
+            continue;
+        const condition = view.self
+            ? `${fn}_at ${view.noun}`
+            : `${fn}_at ${view.noun} ${view.verb.label}`;
+        const rules = [];
+        for (const flag of view.verb.flags) {
+            rules.push(flagRule(binName, fn, condition, flag, minChars));
+        }
+        if (view.verb.mutates) {
+            for (const flag of model.mutationFlags) {
+                rules.push(flagRule(binName, fn, condition, flag, minChars));
+            }
+        }
+        const positional = positionalRule(binName, fn, condition, view.verb, minChars);
+        if (positional)
+            rules.push(positional);
+        if (rules.length > 0) {
+            lines.push("", `# ${view.key}`, ...rules);
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=fish.js.map

package/dist/src/kernel/completion/templates/fish.js.map

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