@canonical/pragma-cli 0.34.0 → 0.35.0

package/dist/src/capabilities/graph/query.verb.js

@@ -0,0 +1,49 @@
+/**
+ * `graph query <sparql>` — the raw SPARQL escape hatch (the twin of `graph
+ * inspect`'s single-entity read). Store-backed and read-only: the dispatcher
+ * boots the store before `run`, and `rt.query.sparql` auto-prefixes the query
+ * from the pack's prefix map, so `ds:Component` resolves without a PREFIX line.
+ *
+ * Injection-safe by construction: the whole query IS the user's text — there is
+ * no interpolation into a template — so there is nothing to escape. A malformed
+ * query surfaces as INVALID_INPUT with a recovery pointer to `ontology list`.
+ */
+import { BIN_NAME } from "../../constants.js";
+import { asVerb } from "../../kernel/spec/asVerb.js";
+import { queryFormatters } from "./query.render.js";
+const queryVerb = {
+    path: ["graph", "query"],
+    summary: "Run a raw SPARQL query against the loaded graph.",
+    doc: "Executes an arbitrary SPARQL query (SELECT / ASK / CONSTRUCT) against the store. Prefixes are applied automatically from the pack's namespace map; list the ontology namespaces to discover the available prefixes.",
+    params: [
+        {
+            kind: "string",
+            name: "sparql",
+            doc: "The SPARQL query text (SELECT, ASK, or CONSTRUCT).",
+            positional: true,
+            required: true,
+        },
+    ],
+    output: { formatters: queryFormatters },
+    examples: [
+        {
+            cmd: `${BIN_NAME} graph query "SELECT ?s WHERE { ?s a ds:Component }"`,
+            note: "list every component subject",
+        },
+        {
+            cmd: `${BIN_NAME} graph query "ASK { <https://ds.canonical.com/global.component.button> a ds:Component }" --format json`,
+        },
+    ],
+    capability: {
+        needsStore: true,
+        mutates: false,
+        mcp: {
+            expose: true,
+            annotations: { readOnlyHint: true, openWorldHint: false },
+        },
+    },
+    run: (params, rt) => import("./runQuery.js").then((m) => m.runQuery(rt, String(params.sparql))),
+};
+/** The `graph query` verb. */
+export const graphQueryVerb = asVerb(queryVerb);
+//# sourceMappingURL=query.verb.js.map

package/dist/src/capabilities/graph/query.verb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/graph/query.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,MAAM,SAAS,GAAmD;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,kDAAkD;IAC3D,GAAG,EAAE,qNAAqN;IAC1N,MAAM,EAAE;QACN;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,GAAG,EAAE,oDAAoD;YACzD,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;SACf;KACF;IACD,MAAM,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE;IACvC,QAAQ,EAAE;QACR;YACE,GAAG,EAAE,GAAG,QAAQ,sDAAsD;YACtE,IAAI,EAAE,8BAA8B;SACrC;QACD;YACE,GAAG,EAAE,GAAG,QAAQ,wGAAwG;SACzH;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,KAAK;QACd,GAAG,EAAE;YACH,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;SAC1D;KACF;IACD,GAAG,EAAE,CAAC,MAA+B,EAAE,EAAiB,EAAE,EAAE,CAC1D,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;CAC7E,CAAC;AAEF,8BAA8B;AAC9B,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC"}

package/dist/src/capabilities/graph/runQuery.js

@@ -0,0 +1,41 @@
+/**
+ * The `graph query` run body (lazily imported, off the fast path).
+ *
+ * Delegates to the `rt.query.sparql` facade (which the dispatcher has already
+ * booted the store for) and translates a query failure into the v2 error
+ * kernel. The old shell raised `STORE_ERROR`; v2 has no such code, so a SPARQL
+ * syntax/execution failure becomes INVALID_INPUT (exit 2) with a recovery
+ * pointer to the loaded namespaces. A `PragmaError` that already carries a
+ * precise code (e.g. STORE_UNAVAILABLE from a cold boot) is re-thrown unchanged.
+ */
+import { cliRecovery, PragmaError } from "../../kernel/error/index.js";
+/**
+ * Execute a raw SPARQL query against the booted store.
+ *
+ * @param rt - The per-invocation runtime (its store is booted by the dispatcher).
+ * @param sparql - The raw SPARQL query text.
+ * @returns The select bindings / ask boolean / construct triples.
+ * @throws PragmaError INVALID_INPUT on a query failure (with a recovery hint).
+ */
+export async function runQuery(rt, sparql) {
+    try {
+        return await rt.query.sparql(sparql);
+    }
+    catch (error) {
+        if (error instanceof PragmaError)
+            throw error;
+        // Keep the parser's own message — the WHY (bad token, line/column, an
+        // unknown prefix) — instead of an opaque "(query)" placeholder.
+        const detail = (error instanceof Error ? error.message : String(error)).trim();
+        throw new PragmaError({
+            code: "INVALID_INPUT",
+            message: detail
+                ? `Invalid SPARQL query: ${detail}`
+                : "Invalid SPARQL query.",
+            recovery: cliRecovery("ontology list", "Check your SPARQL syntax and the loaded namespaces.", {
+                tool: "ontology_list",
+            }),
+        });
+    }
+}
+//# sourceMappingURL=runQuery.js.map

package/dist/src/capabilities/graph/runQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runQuery.js","sourceRoot":"","sources":["../../../../src/capabilities/graph/runQuery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAGvE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,EAAiB,EACjB,MAAc;IAEd,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW;YAAE,MAAM,KAAK,CAAC;QAC9C,sEAAsE;QACtE,gEAAgE;QAChE,MAAM,MAAM,GAAG,CACb,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC,IAAI,EAAE,CAAC;QACT,MAAM,IAAI,WAAW,CAAC;YACpB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,MAAM;gBACb,CAAC,CAAC,yBAAyB,MAAM,EAAE;gBACnC,CAAC,CAAC,uBAAuB;YAC3B,QAAQ,EAAE,WAAW,CACnB,eAAe,EACf,qDAAqD,EACrD;gBACE,IAAI,EAAE,eAAe;aACtB,CACF;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/src/capabilities/index.js

@@ -0,0 +1,56 @@
+/**
+ * The capability registry: every capability module the projectors consume
+ * (D8 — test-only fixtures are never listed here).
+ *
+ * Two sources, in this order: the literal array of AUTHORED modules (in
+ * authoring order; projectors sort where they need to), then every story
+ * `pragma.conf.ts` declares that no authored module already claims. Since
+ * L-OPEN-9 no DATA noun is authored — the authored array is the kernel's own
+ * nouns and nothing else, and every design-system noun appears only in the
+ * config. No noun literal is written here: the second half is derived.
+ *
+ * Importing this barrel pulls only spec + formatter modules — every run body is
+ * behind a lazy dynamic import, and `distribution.ts` is zod-free — so the
+ * `--help`/`__complete` fast paths stay free of the config reader and zod.
+ */
+import { capabilitiesModule } from "./capabilities/index.js";
+import { colophonModule } from "./colophon/index.js";
+import { configModule } from "./config/index.js";
+import { createModule } from "./create/index.js";
+import { storyModules } from "./distribution.js";
+import { doctorModule } from "./doctor/index.js";
+import { graphModule } from "./graph/index.js";
+import { infoModule } from "./info/index.js";
+import { metaModule } from "./meta/index.js";
+import { ontologyModule } from "./ontology/index.js";
+import { promptModule } from "./prompt/index.js";
+import { setupModule } from "./setup/index.js";
+import { skillModule } from "./skill/index.js";
+import { sourcesModule } from "./sources/index.js";
+import { upgradeModule } from "./upgrade/index.js";
+import { versionModule } from "./version/index.js";
+/** The modules with hand-written code, in authoring order. */
+const authored = [
+    infoModule,
+    versionModule,
+    configModule,
+    createModule,
+    sourcesModule,
+    ontologyModule,
+    skillModule,
+    graphModule,
+    promptModule,
+    doctorModule,
+    upgradeModule,
+    setupModule,
+    capabilitiesModule,
+    colophonModule,
+    metaModule,
+];
+const claimed = new Set(authored.map((module) => module.name));
+/** Every capability module: the authored ones, then the unclaimed declared stories. */
+export const capabilities = [
+    ...authored,
+    ...[...storyModules.values()].filter((module) => !claimed.has(module.name)),
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,8DAA8D;AAC9D,MAAM,QAAQ,GAAgC;IAC5C,UAAU;IACV,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,cAAc;IACd,WAAW;IACX,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,WAAW;IACX,kBAAkB;IAClB,cAAc;IACd,UAAU;CACX,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAE/D,uFAAuF;AACvF,MAAM,CAAC,MAAM,YAAY,GAAgC;IACvD,GAAG,QAAQ;IACX,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAC5E,CAAC"}

package/dist/src/capabilities/info/collectInfo.js

@@ -0,0 +1,66 @@
+/**
+ * Collect the `info` payload — the verb's run body (lazily imported).
+ *
+ * STORELESS but network-aware (PR6): reads the layered config, reports the
+ * version and install source, then enriches with (a) an update-check against
+ * the npm registry — this deliberately REVERSES PR1's networkless-D11 stance for
+ * `info` (the reversal IS the enrichment), unconditional because the covenant
+ * `info` verb carries no flag, 3s timeout, silent-fail — and (b) a storeless
+ * entity total, read from the index of whichever pack the boot decision names
+ * (`resolveSources` → `readPackIndex`, the same predicate `sources status` and
+ * `doctor` switch on) so `info` never counts a graph this project's reads
+ * refuse. Neither enrichment boots the store, so the storeless-guarantee spy
+ * still sees `store.booted === false`. Kept out of the spec module so building
+ * the command tree never pulls it onto the `--help` fast path.
+ */
+import { entityTotal, readPackIndex, } from "../../kernel/completion/entitySource.js";
+import { readConfig } from "../../kernel/config/index.js";
+import { resolveSources } from "../../kernel/runtime/resolveSources.js";
+import { checkRegistryVersion, detectInstallSource, PRAGMA_PACKAGE, pmUpdateCommand, } from "../shared/index.js";
+/**
+ * Assemble the `info` data for the current runtime.
+ *
+ * @param runtime - The per-invocation runtime.
+ * @returns The storeless (network-aware) info payload.
+ * @note Impure — reads the config layers + pack index from disk and checks the
+ *   registry (never boots the store).
+ */
+export async function collectInfo(runtime) {
+    const layers = await readConfig(runtime.cwd);
+    const { config } = layers;
+    const install = detectInstallSource();
+    // Update-check: unconditional (no flag exists), 3s timeout, silent-fail.
+    const registry = await checkRegistryVersion(PRAGMA_PACKAGE, config.channel);
+    const update = registry && registry.latest !== runtime.version
+        ? {
+            current: runtime.version,
+            latest: registry.latest,
+            command: pmUpdateCommand(install.pm, PRAGMA_PACKAGE),
+        }
+        : undefined;
+    const updateSkipped = registry === undefined;
+    // Entity total: storeless, over the pack the boot decision names — so a
+    // configured-but-unbuilt project reports no total rather than the snapshot's.
+    const index = readPackIndex(resolveSources(layers, runtime.cwd));
+    const entities = index ? entityTotal(index) : undefined;
+    return {
+        version: runtime.version,
+        installSource: install.label,
+        ...(update ? { update } : {}),
+        updateSkipped,
+        ...(entities !== undefined ? { entities } : {}),
+        config: {
+            ...(config.tier !== undefined ? { tier: config.tier } : {}),
+            channel: config.channel,
+            ...(config.detail !== undefined ? { detail: config.detail } : {}),
+            origins: layers.origins,
+            ...(layers.project.path
+                ? { projectConfigPath: layers.project.path }
+                : {}),
+            globalConfigPath: layers.global.path,
+            projectExists: layers.project.exists,
+            globalExists: layers.global.exists,
+        },
+    };
+}
+//# sourceMappingURL=collectInfo.js.map

package/dist/src/capabilities/info/collectInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectInfo.js","sourceRoot":"","sources":["../../../../src/capabilities/info/collectInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,GACd,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAsB;IACtD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC1B,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IAEtC,yEAAyE;IACzE,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5E,MAAM,MAAM,GACV,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,OAAO;QAC7C,CAAC,CAAC;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,EAAE,cAAc,CAAC;SACrD;QACH,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,aAAa,GAAG,QAAQ,KAAK,SAAS,CAAC;IAE7C,wEAAwE;IACxE,8EAA8E;IAC9E,MAAM,KAAK,GAAG,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAExD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,aAAa,EAAE,OAAO,CAAC,KAAK;QAC5B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,aAAa;QACb,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,EAAE;YACN,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI;gBACrB,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;gBAC5C,CAAC,CAAC,EAAE,CAAC;YACP,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;YACpC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YACpC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;SACnC;KACF,CAAC;AACJ,CAAC"}

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

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

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

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

package/dist/src/capabilities/info/info.render.js

@@ -0,0 +1,53 @@
+/**
+ * Formatters for `pragma info` — plain, llm, json (no ink).
+ */
+import { BIN_NAME } from "../../constants.js";
+/** A `[layer]` marker for values a config file supplied (blank for defaults). */
+function originMarker(origin) {
+    return origin === "default" ? "" : ` [${origin}]`;
+}
+export const infoFormatters = {
+    plain(data) {
+        const { config } = data;
+        const lines = [
+            `${BIN_NAME} v${data.version}`,
+            `  Installed via: ${data.installSource}`,
+            `  tier: ${config.tier ?? "(none)"}${originMarker(config.origins.tier)}`,
+            `  channel: ${config.channel}${originMarker(config.origins.channel)}`,
+            `  detail: ${config.detail ?? "standard"}${originMarker(config.origins.detail)}`,
+        ];
+        if (data.entities !== undefined) {
+            lines.push(`  entities: ${data.entities.toLocaleString()}`);
+        }
+        lines.push("", "Config files:", `  global:  ${config.globalConfigPath}${config.globalExists ? "" : " (not found)"}`, `  project: ${config.projectConfigPath ?? "(none)"}${config.projectConfigPath && !config.projectExists ? " (not found)" : ""}`);
+        if (data.update) {
+            lines.push("", `Update available: ${data.update.current} → ${data.update.latest}`, `  Run: ${data.update.command}`);
+        }
+        return lines.join("\n");
+    },
+    llm(data) {
+        const { config } = data;
+        const lines = [
+            `# ${BIN_NAME} v${data.version}`,
+            `- Installed via: ${data.installSource}`,
+            `- Tier: ${config.tier ?? "(none)"}${originMarker(config.origins.tier)}`,
+            `- Channel: ${config.channel}${originMarker(config.origins.channel)}`,
+            `- Detail: ${config.detail ?? "standard"}${originMarker(config.origins.detail)}`,
+            `- Global config: ${config.globalConfigPath}`,
+        ];
+        if (config.projectConfigPath) {
+            lines.push(`- Project config: ${config.projectConfigPath}`);
+        }
+        if (data.entities !== undefined) {
+            lines.push(`- Entities: ${data.entities.toLocaleString()}`);
+        }
+        if (data.update) {
+            lines.push(`- Update available: ${data.update.current} → ${data.update.latest} (\`${data.update.command}\`)`);
+        }
+        return lines.join("\n");
+    },
+    json(data) {
+        return JSON.stringify(data);
+    },
+};
+//# sourceMappingURL=info.render.js.map

package/dist/src/capabilities/info/info.render.js.map

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

package/dist/src/capabilities/info/info.verb.js

@@ -0,0 +1,42 @@
+/**
+ * The `info` verb spec (noun `info`, self-verb).
+ *
+ * `run` is a lazy thunk: it dynamic-imports the collector, so building the
+ * command tree (help, completion, surface emit) reads this spec without pulling
+ * the config reader or zod onto the fast path.
+ */
+import { BIN_NAME } from "../../constants.js";
+import { asVerb } from "../../kernel/spec/asVerb.js";
+import { infoFormatters } from "./info.render.js";
+const infoVerb = {
+    path: ["info"],
+    summary: "Show version, resolved config, provenance, and update status.",
+    doc: "Storeless — reports the CLI version, how it was installed, the layered config with per-field origins, an entity total from the pack index, and (network, silent-fail) whether a newer release is available.",
+    params: [],
+    output: { formatters: infoFormatters },
+    examples: [
+        { cmd: `${BIN_NAME} info`, note: "human-readable summary" },
+        {
+            cmd: `${BIN_NAME} info --format json`,
+            note: "the full {ok,data,meta} envelope",
+        },
+    ],
+    capability: {
+        needsStore: false,
+        mutates: false,
+        // Network-aware (PR6 enrichment): the update-check reads the registry. This
+        // does NOT affect the emitted surface — `emitVerb` ignores `needsNetwork`.
+        needsNetwork: true,
+        mcp: {
+            expose: true,
+            annotations: { readOnlyHint: true, openWorldHint: false },
+        },
+    },
+    run: (_params, runtime) => import("./collectInfo.js").then((m) => m.collectInfo(runtime)),
+};
+/** The `info` capability module. */
+export const infoModule = {
+    name: "info",
+    verbs: [asVerb(infoVerb)],
+};
+//# sourceMappingURL=info.verb.js.map

package/dist/src/capabilities/info/info.verb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/info/info.verb.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,QAAQ,GAAgD;IAC5D,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,OAAO,EAAE,+DAA+D;IACxE,GAAG,EAAE,6MAA6M;IAClN,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE;IACtC,QAAQ,EAAE;QACR,EAAE,GAAG,EAAE,GAAG,QAAQ,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE;QAC3D;YACE,GAAG,EAAE,GAAG,QAAQ,qBAAqB;YACrC,IAAI,EAAE,kCAAkC;SACzC;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;QACd,4EAA4E;QAC5E,2EAA2E;QAC3E,YAAY,EAAE,IAAI;QAClB,GAAG,EAAE;YACH,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;SAC1D;KACF;IACD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CACxB,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;CACjE,CAAC;AAEF,oCAAoC;AACpC,MAAM,CAAC,MAAM,UAAU,GAAqB;IAC1C,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;CAC1B,CAAC"}

package/dist/src/capabilities/info/types.js

@@ -0,0 +1,5 @@
+/**
+ * Data shapes for `pragma info`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/capabilities/info/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/capabilities/info/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/capabilities/meta/complete.verb.js

@@ -0,0 +1,43 @@
+/**
+ * The hidden `__complete` verb — the dynamic shell-completion resolver.
+ *
+ * Declared as a verb so the grammar is the single registry (every command is a
+ * verb, even internal ones), but `hidden` so it never shows in help or the
+ * surface, and withheld from MCP with a reason. The bin fast-paths `__complete`
+ * for latency; this spec's lazy `run` is the same resolution — the full
+ * completion engine, fed by the active pack's index through
+ * `indexCompletionEnv(runtime.cwd)` — reachable if a future tier dispatches it.
+ * Storeless: the entity tier reads the index off disk, never booting the store.
+ */
+/** The `__complete` verb spec. */
+export const completeVerb = {
+    path: ["__complete"],
+    summary: "Resolve shell completions for the given words.",
+    hidden: true,
+    params: [
+        {
+            kind: "string[]",
+            name: "words",
+            doc: "The command words typed so far (last is the partial).",
+            positional: true,
+        },
+    ],
+    output: {
+        formatters: {
+            plain: (matches) => matches.join("\n"),
+            llm: (matches) => matches.join("\n"),
+            json: (matches) => JSON.stringify(matches),
+        },
+    },
+    capability: {
+        needsStore: false,
+        mutates: false,
+        mcp: { expose: false, reason: "internal shell-completion resolver" },
+    },
+    run: (params, runtime) => Promise.all([
+        import("../../kernel/completion/complete.js"),
+        import("../../kernel/completion/entitySource.js"),
+        import("../index.js"),
+    ]).then(([completion, entitySource, caps]) => completion.runComplete(params.words ?? [], caps.capabilities, entitySource.indexCompletionEnv(runtime.cwd))),
+};
+//# sourceMappingURL=complete.verb.js.map

package/dist/src/capabilities/meta/complete.verb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/meta/complete.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,kCAAkC;AAClC,MAAM,CAAC,MAAM,YAAY,GAAgD;IACvE,IAAI,EAAE,CAAC,YAAY,CAAC;IACpB,OAAO,EAAE,gDAAgD;IACzD,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE;QACN;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,uDAAuD;YAC5D,UAAU,EAAE,IAAI;SACjB;KACF;IACD,MAAM,EAAE;QACN,UAAU,EAAE;YACV,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACtC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACpC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC3C;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;QACd,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,oCAAoC,EAAE;KACrE;IACD,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CACvB,OAAO,CAAC,GAAG,CAAC;QACV,MAAM,CAAC,qCAAqC,CAAC;QAC7C,MAAM,CAAC,yCAAyC,CAAC;QACjD,MAAM,CAAC,aAAa,CAAC;KACtB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,EAAE,CAC3C,UAAU,CAAC,WAAW,CACnB,MAAM,CAAC,KAA8B,IAAI,EAAE,EAC5C,IAAI,CAAC,YAAY,EACjB,YAAY,CAAC,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAC7C,CACF;CACJ,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * The `meta` capability barrel — the hidden internal verbs (`__complete`,
+ * `mcp`). Both are withheld from the surface and MCP; the bin fast-paths them.
+ */
+import { asVerb } from "../../kernel/spec/asVerb.js";
+import { completeVerb } from "./complete.verb.js";
+import { mcpVerb } from "./mcp.verb.js";
+/** The `meta` capability module. */
+export const metaModule = {
+    name: "meta",
+    verbs: [asVerb(completeVerb), asVerb(mcpVerb)],
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/capabilities/meta/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,oCAAoC;AACpC,MAAM,CAAC,MAAM,UAAU,GAAqB;IAC1C,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;CAC/C,CAAC"}

package/dist/src/capabilities/meta/mcp.verb.js

@@ -0,0 +1,34 @@
+/**
+ * `mcp serve` — the MCP server entry point.
+ *
+ * The server is not an agent tool, so it is withheld from MCP with a reason —
+ * but it IS a command, and it is spelled like one: a noun and a verb, the same
+ * shape as every other pair in the grammar, so it completes, appears in help,
+ * and answers `--help` without a special case. The bin still short-circuits
+ * the exact `pragma mcp serve` invocation before flag parsing and first-run,
+ * because the server's stdout carries JSON-RPC and nothing else may reach it;
+ * this spec's lazy `run` is that same serve, for any tier that dispatches it.
+ */
+/** The `mcp` verb spec. */
+export const mcpVerb = {
+    path: ["mcp", "serve"],
+    summary: "Start the MCP server over stdio.",
+    params: [],
+    output: {
+        formatters: {
+            plain: () => "",
+            llm: () => "",
+            json: () => JSON.stringify(null),
+        },
+    },
+    capability: {
+        needsStore: false,
+        mutates: false,
+        mcp: { expose: false, reason: "server entry, not an agent tool" },
+    },
+    run: () => Promise.all([
+        import("../../kernel/project/mcp/serve.js"),
+        import("../index.js"),
+    ]).then(([mcp, caps]) => mcp.serveMcp(caps.capabilities)),
+};
+//# sourceMappingURL=mcp.verb.js.map

package/dist/src/capabilities/meta/mcp.verb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/meta/mcp.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAA4C;IAC9D,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,kCAAkC;IAC3C,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN,UAAU,EAAE;YACV,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE;YACf,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE;YACb,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SACjC;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;QACd,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,EAAE;KAClE;IACD,GAAG,EAAE,GAAG,EAAE,CACR,OAAO,CAAC,GAAG,CAAC;QACV,MAAM,CAAC,mCAAmC,CAAC;QAC3C,MAAM,CAAC,aAAa,CAAC;KACtB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;CAC5D,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * The `ontology` capability module — schema (TBox) inspection.
+ */
+import { ontologyListVerb, ontologyLookupVerb } from "./verbs.js";
+/** The `ontology` capability module (`list` and the `lookup` by-name read). */
+export const ontologyModule = {
+    name: "ontology",
+    verbs: [ontologyListVerb, ontologyLookupVerb],
+    /**
+     * The ONE hand-declared listing in the distribution. Every other module is
+     * story-compiled and has its slice DERIVED from the types its lookup already
+     * names; this noun addresses the schema itself, which no `type` filter
+     * expresses — the whole TBox is the answer, so it is stated once, here.
+     *
+     * `0.5` puts the schema below the story collections (weight 1) it explains
+     * and above nothing else: an agent orienting itself wants the collections
+     * first, then the vocabulary they are described in.
+     */
+    mcpListable: { sources: [{ box: "tbox", as: "entities", weight: 0.5 }] },
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/capabilities/ontology/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;IAC7C;;;;;;;;;OASG;IACH,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE;CACzE,CAAC"}

package/dist/src/capabilities/ontology/queries.js

@@ -0,0 +1,123 @@
+/**
+ * Store-backed ontology inspection queries + shapes (the TBox exception).
+ *
+ * Unlike instance reads (GraphQL by default), ontology inspection queries the
+ * schema directly with SPARQL over `owl:Class`/`owl:*Property` — a recorded
+ * TBox exception to the source rule. Full IRIs are used in the query text so the
+ * result never depends on which vocabulary prefixes the store injected.
+ */
+const OWL = "http://www.w3.org/2002/07/owl#";
+const RDFS = "http://www.w3.org/2000/01/rdf-schema#";
+const OWL_CLASS = `${OWL}Class`;
+const OWL_OBJECT_PROPERTY = `${OWL}ObjectProperty`;
+const OWL_DATATYPE_PROPERTY = `${OWL}DatatypeProperty`;
+/** Local name of an IRI (`…#Thing`/`…/Thing` → `Thing`). */
+export function localName(uri) {
+    const hash = uri.lastIndexOf("#");
+    if (hash !== -1)
+        return uri.slice(hash + 1);
+    const slash = uri.lastIndexOf("/");
+    return slash !== -1 ? uri.slice(slash + 1) : uri;
+}
+async function select(rt, text) {
+    const result = await rt.query.sparql(text);
+    return result.type === "select"
+        ? result.bindings
+        : [];
+}
+/** Group all defined classes/properties by their namespace prefix, with counts. */
+export async function listNamespaces(rt, prefixes) {
+    const [classes, props] = await Promise.all([
+        select(rt, `SELECT ?class WHERE { ?class a <${OWL_CLASS}> }`),
+        select(rt, `SELECT ?prop WHERE { ?prop a ?t . VALUES ?t { <${OWL_OBJECT_PROPERTY}> <${OWL_DATATYPE_PROPERTY}> } }`),
+    ]);
+    const entries = Object.entries(prefixes);
+    const classByPrefix = new Map();
+    const propByPrefix = new Map();
+    const tally = (rows, key, into) => {
+        for (const row of rows) {
+            const uri = row[key] ?? "";
+            const match = findNamespace(uri, entries);
+            if (!match)
+                continue;
+            const set = into.get(match.prefix) ?? new Set();
+            set.add(uri);
+            into.set(match.prefix, set);
+        }
+    };
+    tally(classes, "class", classByPrefix);
+    tally(props, "prop", propByPrefix);
+    const allPrefixes = new Set([
+        ...classByPrefix.keys(),
+        ...propByPrefix.keys(),
+    ]);
+    return [...allPrefixes].sort().map((prefix) => ({
+        prefix,
+        namespace: prefixes[prefix] ?? "",
+        classCount: classByPrefix.get(prefix)?.size ?? 0,
+        propertyCount: propByPrefix.get(prefix)?.size ?? 0,
+    }));
+}
+/** The longest-matching namespace prefix for a URI. */
+function findNamespace(uri, entries) {
+    let best;
+    for (const [prefix, namespace] of entries) {
+        if (uri.startsWith(namespace) &&
+            (!best || namespace.length > best.namespace.length)) {
+            best = { prefix, namespace };
+        }
+    }
+    return best;
+}
+/** All classes in a namespace, with labels, superclasses, and index counts. */
+export async function queryClasses(rt, namespace, instanceCountByType) {
+    const rows = await select(rt, [
+        "SELECT ?class ?label ?superclass WHERE {",
+        `  ?class a <${OWL_CLASS}> .`,
+        `  FILTER(STRSTARTS(STR(?class), "${namespace}"))`,
+        `  OPTIONAL { ?class <${RDFS}label> ?label }`,
+        `  OPTIONAL { ?class <${RDFS}subClassOf> ?superclass }`,
+        "} ORDER BY ?class",
+    ].join("\n"));
+    const seen = new Map();
+    for (const row of rows) {
+        const uri = row.class ?? "";
+        if (seen.has(uri))
+            continue;
+        seen.set(uri, {
+            uri,
+            label: row.label || localName(uri),
+            ...(row.superclass ? { superclass: row.superclass } : {}),
+            instanceCount: instanceCountByType[uri] ?? 0,
+        });
+    }
+    return [...seen.values()];
+}
+/** All object/datatype properties in a namespace. */
+export async function queryProperties(rt, namespace) {
+    const rows = await select(rt, [
+        "SELECT ?prop ?label ?domain ?range ?propType WHERE {",
+        "  ?prop a ?propType .",
+        `  VALUES ?propType { <${OWL_OBJECT_PROPERTY}> <${OWL_DATATYPE_PROPERTY}> }`,
+        `  FILTER(STRSTARTS(STR(?prop), "${namespace}"))`,
+        `  OPTIONAL { ?prop <${RDFS}label> ?label }`,
+        `  OPTIONAL { ?prop <${RDFS}domain> ?domain }`,
+        `  OPTIONAL { ?prop <${RDFS}range> ?range }`,
+        "} ORDER BY ?prop",
+    ].join("\n"));
+    const seen = new Map();
+    for (const row of rows) {
+        const uri = row.prop ?? "";
+        if (seen.has(uri))
+            continue;
+        seen.set(uri, {
+            uri,
+            label: row.label || localName(uri),
+            ...(row.domain ? { domain: row.domain } : {}),
+            ...(row.range ? { range: row.range } : {}),
+            type: row.propType?.includes("ObjectProperty") ? "object" : "datatype",
+        });
+    }
+    return [...seen.values()];
+}
+//# sourceMappingURL=queries.js.map

package/dist/src/capabilities/ontology/queries.js.map

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