@canonical/pragma-cli 0.34.0 → 0.36.0

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

@@ -0,0 +1,72 @@
+/**
+ * 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, updateGuidance, } 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);
+    // Only a GLOBAL install gets a command; every other state gets the honest
+    // guidance sentence — a confidently wrong `npm i -g` against a linked
+    // checkout would overwrite the development link.
+    const update = registry && registry.latest !== runtime.version
+        ? {
+            current: runtime.version,
+            latest: registry.latest,
+            ...(install.kind === "global"
+                ? { command: pmUpdateCommand(install, PRAGMA_PACKAGE) }
+                : { guidance: updateGuidance(install) }),
+        }
+        : 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,
+        installKind: install.kind,
+        ...(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":"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"}

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,57 @@
+/**
+ * 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}`, data.update.command
+                ? `  Run: ${data.update.command}`
+                : `  ${data.update.guidance}`);
+        }
+        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(data.update.command
+                ? `- Update available: ${data.update.current} → ${data.update.latest} (\`${data.update.command}\`)`
+                : `- Update available: ${data.update.current} → ${data.update.latest} — ${data.update.guidance}`);
+        }
+        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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"}

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

@@ -0,0 +1,66 @@
+/**
+ * Formatters for `ontology list` and `ontology lookup`.
+ */
+import { compactUri, DEFAULT_PREFIX_MAP } from "../../kernel/render/index.js";
+export const ontologyListFormatters = {
+    plain: (rows) => rows
+        .map((r) => `${r.prefix}  ${compactUri(r.namespace, DEFAULT_PREFIX_MAP)}  ${r.classCount} classes, ${r.propertyCount} properties`)
+        .join("\n"),
+    llm: (rows) => [
+        `## Ontologies (${rows.length})`,
+        "",
+        ...rows.map((r) => `- \`${r.prefix}\` — ${r.classCount} classes, ${r.propertyCount} properties (\`${r.namespace}\`)`),
+    ].join("\n"),
+    json: (rows) => JSON.stringify(rows, null, 2),
+};
+/** Render a URI compacted or full, per the show flags. */
+function uri(value, full) {
+    return full ? value : compactUri(value, DEFAULT_PREFIX_MAP);
+}
+function classLine(c, full, bullet) {
+    const sup = c.superclass ? ` extends ${uri(c.superclass, full)}` : "";
+    const count = c.instanceCount > 0 ? ` [${c.instanceCount}]` : "";
+    return `${bullet}${c.label} (${uri(c.uri, full)})${sup}${count}`;
+}
+function propLine(p, full, bullet) {
+    const domain = p.domain ? ` domain: ${uri(p.domain, full)}` : "";
+    const range = p.range ? ` range: ${uri(p.range, full)}` : "";
+    return `${bullet}${p.label} (${uri(p.uri, full)}) (${p.type})${domain}${range}`;
+}
+export const ontologyShowFormatters = {
+    plain(data) {
+        const title = `${data.prefix}: ${compactUri(data.namespace, DEFAULT_PREFIX_MAP)}${data.focus ? ` — ${data.focus}` : ""}`;
+        const lines = [title, "═".repeat(Math.max(title.length, 24))];
+        if (data.classes.length > 0) {
+            lines.push("", "Classes:");
+            for (const c of data.classes)
+                lines.push(classLine(c, data.fullUris, "  "));
+        }
+        if (data.properties.length > 0) {
+            lines.push("", "Properties:");
+            for (const p of data.properties)
+                lines.push(propLine(p, data.fullUris, "  "));
+        }
+        return lines.join("\n");
+    },
+    llm(data) {
+        const lines = [
+            `## ${data.prefix}: ${compactUri(data.namespace, DEFAULT_PREFIX_MAP)}${data.focus ? ` — ${data.focus}` : ""}`,
+            "",
+        ];
+        if (data.classes.length > 0) {
+            lines.push("### Classes");
+            for (const c of data.classes)
+                lines.push(classLine(c, data.fullUris, "- "));
+            lines.push("");
+        }
+        if (data.properties.length > 0) {
+            lines.push("### Properties");
+            for (const p of data.properties)
+                lines.push(propLine(p, data.fullUris, "- "));
+        }
+        return lines.join("\n").trimEnd();
+    },
+    json: (data) => JSON.stringify(data, null, 2),
+};
+//# sourceMappingURL=render.js.map

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

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