@canonical/pragma-cli 0.34.0 → 0.36.0

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

@@ -0,0 +1,92 @@
+/**
+ * Emit the static shell-completion scripts from the grammar.
+ *
+ * Builds the completion model from the capability modules (the same
+ * derivation the `__complete` resolver uses — the tiers cannot disagree) and
+ * renders one script per supported shell. The static tier answers STRUCTURE
+ * with zero exec: nouns, verbs, flag names, enum values, mutation + global
+ * flags, native file completion. Only `{kind:"names"}` value contexts shell
+ * out to `<bin> __complete`.
+ *
+ * PR6 boundary (`setup completions`): this module exports pure CONTENT only
+ * — shell detection, install paths, mkdir/write effects, and hints all
+ * belong to setup. `binName` is parameterized so a fork's rename reaches the
+ * script body (`completionScriptPath` derives the file NAME from the same
+ * constant, and the two must agree or the shell never loads the file);
+ * `minChars` and `disabledFamilies` are read from `completion` config by setup.
+ *
+ * `minChars` (default {@link DEFAULT_MIN_CHARS}) is baked into the scripts to
+ * gate the `__complete` exec for NAME contexts only — structure and enum values
+ * stay inlined and complete on bare TAB with zero exec. `disabledFamilies`
+ * scrubs a noun's name sources to `none` (the config-level opt-out), so its
+ * name arms drop out of every script; the pack-grammar opt-out (`enabled:false`)
+ * lands earlier, in the model.
+ *
+ * @throws Emitting THROWS on any name outside the safety allowlist (the
+ *   model build asserts, and every template re-asserts what it inlines) —
+ *   `setup completions` fails loudly rather than installing a hostile token.
+ */
+import { BIN_NAME } from "../../constants.js";
+import { assertSafeToken, buildCompletionModel } from "./model.js";
+import { bashScript } from "./templates/bash.js";
+import { fishScript } from "./templates/fish.js";
+import { zshScript } from "./templates/zsh.js";
+/** The default `minChars` gate baked into the generated scripts. */
+export const DEFAULT_MIN_CHARS = 2;
+/** Replace a name source with `none` (the family-level opt-out). */
+function scrubSource(source) {
+    return source.kind === "names" ? { kind: "none" } : source;
+}
+/** Scrub every name source of a verb entry to `none`. */
+function scrubVerb(verb) {
+    return {
+        ...verb,
+        flags: verb.flags.map((flag) => ({
+            ...flag,
+            source: scrubSource(flag.source),
+        })),
+        positionals: verb.positionals.map((positional) => ({
+            ...positional,
+            source: scrubSource(positional.source),
+        })),
+    };
+}
+/**
+ * Drop name completion for the disabled noun families (config opt-out): every
+ * name source under a disabled noun becomes `none`, so no template emits its
+ * exec. A pure structural transform on the model — the templates stay unaware.
+ */
+function applyDisabledFamilies(model, disabled) {
+    if (disabled.size === 0)
+        return model;
+    return {
+        ...model,
+        nouns: model.nouns.map((noun) => disabled.has(noun.noun)
+            ? {
+                ...noun,
+                ...(noun.selfVerb ? { selfVerb: scrubVerb(noun.selfVerb) } : {}),
+                verbs: noun.verbs.map(scrubVerb),
+            }
+            : noun),
+    };
+}
+/**
+ * Emit the completion scripts for every supported shell.
+ *
+ * @param modules - The capability modules to derive completions from.
+ * @param options - Bin name, `minChars` gate, and disabled name families.
+ * @returns A map of shell to its completion script.
+ * @throws Error when any inlinable token fails the safety allowlist.
+ */
+export function emitScripts(modules, options = {}) {
+    const binName = options.binName ?? BIN_NAME;
+    assertSafeToken(binName, "bin name");
+    const minChars = options.minChars ?? DEFAULT_MIN_CHARS;
+    const model = applyDisabledFamilies(buildCompletionModel(modules), new Set(options.disabledFamilies ?? []));
+    return {
+        bash: bashScript(model, binName, minChars),
+        zsh: zshScript(model, binName, minChars),
+        fish: fishScript(model, binName, minChars),
+    };
+}
+//# sourceMappingURL=emitScripts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emitScripts.js","sourceRoot":"","sources":["../../../../src/kernel/completion/emitScripts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQ/C,oEAAoE;AACpE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAYnC,oEAAoE;AACpE,SAAS,WAAW,CAAC,MAAwB;IAC3C,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAC7D,CAAC;AAED,yDAAyD;AACzD,SAAS,SAAS,CAAC,IAAe;IAChC,OAAO;QACL,GAAG,IAAI;QACP,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/B,GAAG,IAAI;YACP,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;SACjC,CAAC,CAAC;QACH,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YACjD,GAAG,UAAU;YACb,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC;SACvC,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAC5B,KAAsB,EACtB,QAA6B;IAE7B,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO;QACL,GAAG,KAAK;QACR,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC9B,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YACrB,CAAC,CAAC;gBACE,GAAG,IAAI;gBACP,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;aACjC;YACH,CAAC,CAAC,IAAI,CACT;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,OAAoC,EACpC,UAA8B,EAAE;IAEhC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC;IAC5C,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACvD,MAAM,KAAK,GAAG,qBAAqB,CACjC,oBAAoB,CAAC,OAAO,CAAC,EAC7B,IAAI,GAAG,CAAC,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC,CACxC,CAAC;IACF,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC;QAC1C,GAAG,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC;QACxC,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC;KAC3C,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,285 @@
+/**
+ * The dynamic-tier seam: where `{kind:"names"}` completions get their candidates
+ * for EVERY object family, plus the storeless pack-index read the resource
+ * browser (`info`, `doctor`, MCP prompts, the resource provider) shares.
+ *
+ * {@link indexCompletionEnv} is the one source-dispatched reader wired at the
+ * `__complete` fast path (bin) and the `__complete` verb. It resolves three
+ * storeless sources — all disk-readable, never a store/SPARQL:
+ * - `index`    → the active pack's `index.json`, filtered by a prefixed `type`
+ *                and read from the declared `field` (`name` by default).
+ * - `skills`   → SKILL.md names via {@link discoverSkills} (filesystem walk).
+ * - `prefixes` → the pack index's prefixes ∪ the default display prefixes.
+ *
+ * There is no per-family source. An entity family IS a `type` filter plus the
+ * field that family is addressed by, and both are declared at the verb, so this
+ * module names no entity type at all.
+ *
+ * The index is loaded once (lazy `readFileSync` + plain `JSON.parse` — never a
+ * store, facade, config evaluator, or zod schema; any I/O or parse error
+ * degrades to `[]`) and shared across the index and prefixes sources;
+ * the skills walk is memoized to one walk per `__complete` process.
+ * {@link createIndexEntityReader} exposes the index read for the storeless
+ * behavioural/safety tests; {@link emptyNameSource} is the default (no names).
+ *
+ * {@link readPackIndex} and {@link entityTotal} expose the same storeless read
+ * to `info`/`doctor` and the resource surfaces — but those callers are NOT on
+ * the fast path, so `readPackIndex` takes the boot decision rather than
+ * re-deriving one. Everything here relies only on the FROZEN `{ name, type }`
+ * index minimum (plus optional enrichment like `label`/`altNames`), so the
+ * index can grow without breaking completion.
+ *
+ * Storeless-graph notes:
+ * - The embedded fallback is read from `pack.index.generated` — its OWN
+ *   generated module (only the index string) — so the storeless `__complete`
+ *   path never EVALUATES the n-quads/schema/manifest strings that live in
+ *   `pack.generated`. Under the compiled binary it did not avoid PARSING them
+ *   either — one emitted script meant the whole embed was parsed at process
+ *   start on every invocation (~+25 ms, measured on `--version`; BUDGETS.md
+ *   records it), and the split bought only that a completion never allocated
+ *   the 1.87 MB. Shipping per-module output changed that: `pack.generated` is
+ *   a separate module the fast path never imports, so it is no longer parsed
+ *   at all there. The split now buys both.
+ * - The active pack is resolved through `kernel/runtime/paths` — a LEAF module
+ *   (node builtins only) that shares the pointer read with `resolveSources`.
+ *   `resolveSources` itself is unreachable from here: it pulls the graphpack
+ *   manifest schema (zod), which `safety.test.ts` forbids on this graph, and
+ *   `origins.packs` needs the config evaluator. So {@link loadActiveIndex}
+ *   implements only the POINTER half of the decision table — pointer → that
+ *   pack (else nothing), no pointer → the embedded snapshot. It cannot tell a
+ *   fresh install from a project that declared its own packs and never built
+ *   them, so a `__complete` in the latter still offers the snapshot's names.
+ *   That is the price of a config-free fast path, and it is bounded to
+ *   completion candidates: every read, and every surface that takes the
+ *   decision, refuses. `PackIndex`/`PackIndexEntity` are imported type-only, so
+ *   no zod schema is loaded at runtime.
+ * - `discoverSkills` (`node:fs/os/path` only) and `DEFAULT_PREFIX_MAP` (whose
+ *   domain half the distribution declares) are the only new edges — both
+ *   leaf-clean, so the fast path stays free of boot/config/store/zod.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { discoverSkills } from "../../capabilities/skill/discover.js";
+// Inlined embedded index — its OWN generated module (only the index string), so
+// the storeless `__complete` path never pulls the n-quads/schema/manifest
+// strings that live in `pack.generated.ts`.
+import { DEFAULT_PREFIX_MAP } from "../render/index.js";
+import { indexJson as EMBEDDED_INDEX_JSON } from "../runtime/graphpack/embedded/pack.index.generated.js";
+import { packDir, readActivePack } from "../runtime/paths.js";
+/** The default name source: no index tier, so no candidates. */
+export const emptyNameSource = () => [];
+/** The pack index filename (kept local so this path never imports the zod schema). */
+const INDEX_FILE = "index.json";
+/**
+ * Read the storeless index of the pack the BOOT DECISION names — for `info`,
+ * `doctor`, the MCP resource browser, and native `prompts/list`. Never boots the
+ * store, never validates with zod — a plain `JSON.parse` off disk.
+ *
+ * It takes the decision rather than re-deriving one so these surfaces cannot
+ * list entities the same project's reads refuse: `unavailable` yields
+ * `undefined`, and callers degrade to a recovery hint (`buildResourceList`
+ * emits the `pragma:sources` entry, `info` omits the total).
+ *
+ * @param decision - The boot decision from `resolveSources`.
+ * @returns The answering pack's index, or `undefined` when none answers.
+ */
+export function readPackIndex(decision) {
+    switch (decision.kind) {
+        case "pack":
+            return readIndexFile(decision.dir);
+        case "embedded":
+            return parseIndex(EMBEDDED_INDEX_JSON);
+        case "unavailable":
+            return undefined;
+    }
+}
+/**
+ * Count a pack index's DISTINCT abox subjects — the "total entities" figure
+ * `info` and `doctor` report. Works over any {@link PackIndex}, whether read
+ * storelessly via {@link readPackIndex} or taken from a booted store session.
+ *
+ * NOT a sum of `instanceCountByType`: on a real OWL/Protégé export that raw
+ * multiset double-counts — every individual is typed as both its domain class
+ * AND `owl:NamedIndividual`, and the `owl:Class`/property meta-buckets pile on
+ * top — so the total ran ~2× the real entity count (A1). Counting distinct
+ * abox subjects (the individuals, each once) is the figure users expect; the
+ * tbox schema classes/properties are not "entities" in this count.
+ *
+ * @param index - A pack index.
+ * @returns The number of distinct abox subjects indexed.
+ */
+export function entityTotal(index) {
+    const subjects = new Set();
+    for (const entity of index.entities) {
+        if (entity.box === "abox")
+            subjects.add(entity.uri ?? entity.name);
+    }
+    return subjects.size;
+}
+/** Parse an index JSON string; any malformed input degrades to `undefined`. */
+function parseIndex(json) {
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Read a pack directory's `index.json`; any I/O or parse error is `undefined`. */
+function readIndexFile(dir) {
+    try {
+        return parseIndex(readFileSync(join(dir, INDEX_FILE), "utf-8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The fast path's index — the POINTER half of the decision table (see the module
+ * docblock). A project with a pointer reads that pack and nothing else: a
+ * pointer whose pack the cache lost yields no candidates rather than the
+ * snapshot's, which is what the boot decision does with the same state.
+ */
+function loadActiveIndex(cwd) {
+    const contentHash = readActivePack(cwd);
+    return contentHash === undefined
+        ? parseIndex(EMBEDDED_INDEX_JSON)
+        : readIndexFile(packDir(contentHash));
+}
+/**
+ * Whether an entity matches a prefixed type filter (primary type or any type).
+ *
+ * Exported because the MCP resource listing addresses the index by the SAME
+ * vocabulary a completion source does (`McpListableRef` reuses
+ * `CompletionSourceRef`'s fields), and "which entities is this type?" must be
+ * ONE rule — two would let a type list entities its completion refuses.
+ *
+ * @param entity - The indexed entity to test.
+ * @param type - A prefixed type filter; empty matches every entity.
+ * @returns Whether the entity carries that type.
+ */
+export function matchesType(entity, type) {
+    if (!type)
+        return true;
+    if (entity.type === type)
+        return true;
+    return Array.isArray(entity.types) && entity.types.includes(type);
+}
+/**
+ * Build a storeless entity-name reader for a working directory.
+ *
+ * @param cwd - The project directory (to resolve the active pack).
+ * @returns `(type, partial) => string[]` — sorted entity names of `type`
+ *   starting with `partial`. The index is loaded once, lazily, and reused.
+ */
+export function createIndexEntityReader(cwd) {
+    let index;
+    let loaded = false;
+    return (type, partial) => {
+        if (!loaded) {
+            index = loadActiveIndex(cwd);
+            loaded = true;
+        }
+        if (!index)
+            return [];
+        const names = new Set();
+        for (const entity of index.entities) {
+            if (!matchesType(entity, type))
+                continue;
+            if (partial && !entity.name.startsWith(partial))
+                continue;
+            names.add(entity.name);
+        }
+        return [...names].sort();
+    };
+}
+/**
+ * One entity's completable tokens for a declared field, with NO fallback.
+ *
+ * A verb declares the field because that is the one its lookup matches on, so
+ * an entity the pack did not enrich contributes nothing. Standing a label in
+ * for an absent alt name would offer a token the lookup provably cannot resolve
+ * — a completion that hands the user a value and then refuses it — which is the
+ * complete-but-cannot-resolve split this whole declaration exists to close.
+ * Offering nothing for an under-enriched entity is the honest answer.
+ *
+ * @param entity - One index entity.
+ * @param field - The declared field to read.
+ * @returns The tokens that entity contributes; empty when it carries none.
+ */
+function readEntityNames(entity, field) {
+    switch (field) {
+        case "name":
+            return [entity.name];
+        case "label":
+            return entity.label ? [entity.label] : [];
+        case "altNames":
+            return entity.altNames ?? [];
+    }
+}
+/** A ref's candidates: entities of its type, read from its field, sorted. */
+function indexNames(index, ref) {
+    if (!index)
+        return [];
+    const names = new Set();
+    for (const entity of index.entities) {
+        if (!matchesType(entity, ref.type ?? ""))
+            continue;
+        for (const name of readEntityNames(entity, ref.field ?? "name")) {
+            names.add(name);
+        }
+    }
+    return [...names].sort();
+}
+/** The completable namespace prefixes: the index's ∪ the default display map. */
+function prefixNames(index) {
+    const keys = new Set(Object.keys(DEFAULT_PREFIX_MAP));
+    if (index?.prefixes) {
+        for (const key of Object.keys(index.prefixes))
+            keys.add(key);
+    }
+    return [...keys].sort();
+}
+/**
+ * The completion environment for a working directory — the one source-dispatched
+ * reader every name family shares. Wired at the `__complete` fast path (bin) and
+ * the `__complete` verb; storeless throughout (see the module docblock).
+ *
+ * The pack index is loaded once, lazily, and reused across the index and
+ * prefixes sources; the skills filesystem walk is memoized to one walk per
+ * process (the design's perf caveat). Every source returns the FULL candidate
+ * list in canonical casing — the resolver ranks/filters against the partial.
+ *
+ * @param cwd - The project directory (to resolve the active pack + skills).
+ * @returns A {@link CompletionEnv} dispatching on {@link CompletionSourceRef}.
+ */
+export function indexCompletionEnv(cwd) {
+    let index;
+    let indexLoaded = false;
+    const getIndex = () => {
+        if (!indexLoaded) {
+            index = loadActiveIndex(cwd);
+            indexLoaded = true;
+        }
+        return index;
+    };
+    let skills;
+    const getSkills = () => {
+        if (skills === undefined)
+            skills = discoverSkills(cwd).map((s) => s.name);
+        return skills;
+    };
+    return {
+        names(ref) {
+            switch (ref.from) {
+                case "index":
+                    return indexNames(getIndex(), ref);
+                case "skills":
+                    return getSkills();
+                case "prefixes":
+                    return prefixNames(getIndex());
+            }
+        },
+    };
+}
+//# sourceMappingURL=entitySource.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Completion kernel barrel — the shared model, the `__complete` resolver
+ * pipeline (parse → resolve → rank), the static script emitter, and the
+ * dynamic-tier entity seam. Both tiers are driven off the grammar via
+ * `buildCompletionModel`, so they can never disagree.
+ */
+export { runComplete } from "./complete.js";
+export { emitScripts } from "./emitScripts.js";
+export { createIndexEntityReader, emptyNameSource, indexCompletionEnv, } from "./entitySource.js";
+export { assertSafeToken, buildCompletionModel, findNoun, SAFE_TOKEN_RE, } from "./model.js";
+export { parseWords } from "./parse.js";
+export { filterPrefix, MAX_CANDIDATES, rankCandidates } from "./rank.js";
+export { completionDebug, resolveRequest } from "./resolve.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/kernel/completion/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,QAAQ,EACR,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}