@canonical/pragma-cli 0.34.0 → 0.36.0

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

@@ -0,0 +1,49 @@
+/**
+ * The `doctor` verb spec (noun `doctor`, self-verb).
+ *
+ * A read (`mutates: false`) that declares `needsStore: false` — the covenant has
+ * neither flag — so the dispatcher never pre-boots the store. The one store
+ * check boots it lazily inside a try/catch, keeping doctor storeless-by-default
+ * while still reporting store health. `run` lazily imports the orchestrator, so
+ * building the tree pulls neither the checks nor `@canonical/harnesses`.
+ *
+ * Exit-code decision: doctor always exits 0 — failures live in the `{ failed }`
+ * envelope (agents read the data; CI greps it). See PARITY_GAP
+ * `doctor-exit-zero-with-failures`.
+ */
+import { BIN_NAME } from "../../constants.js";
+import { asVerb } from "../../kernel/spec/asVerb.js";
+import { doctorFormatters } from "./doctor.render.js";
+const doctorVerb = {
+    path: ["doctor"],
+    summary: "Check your environment and every setup target, globally and in this project.",
+    // Two house rules constrain this string and both are PROTECTED: it may not
+    // name the distribution (`identity.test.ts`) and it may not spell a CLI flag
+    // (`toolDescriptions.test.ts`), so the inventory's widening is described as
+    // "the verbose global flag" rather than by its spelling.
+    doc: "Reports the environment checks first, then one row per setup target — once for your home directory, once for this project. Each row is pass, fail, available (an optional integration you have not set up yet), or skip (nothing to do here, and the row says why), with the next step printed inline. Every row is named after the setup target that repairs it, except `harnesses`: a listing, per scope, of the AI harnesses found on this machine and whether this CLI's MCP server is registered in each — the ones actually found, or every harness it knows about under the verbose global flag. Needs no store; the store check boots lazily and never fails the run.",
+    params: [],
+    output: { formatters: doctorFormatters },
+    examples: [
+        { cmd: `${BIN_NAME} doctor` },
+        {
+            cmd: `${BIN_NAME} doctor --format json`,
+            note: "machine-readable checks",
+        },
+    ],
+    capability: {
+        needsStore: false,
+        mutates: false,
+        mcp: {
+            expose: true,
+            annotations: { readOnlyHint: true, openWorldHint: false },
+        },
+    },
+    run: (_params, runtime) => import("./runChecks.js").then((m) => m.runChecks(runtime)),
+};
+/** The `doctor` capability module. */
+export const doctorModule = {
+    name: "doctor",
+    verbs: [asVerb(doctorVerb)],
+};
+//# sourceMappingURL=doctor.verb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/doctor/doctor.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,UAAU,GAAkD;IAChE,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,OAAO,EACL,8EAA8E;IAChF,2EAA2E;IAC3E,6EAA6E;IAC7E,4EAA4E;IAC5E,yDAAyD;IACzD,GAAG,EAAE,+oBAA+oB;IACppB,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACxC,QAAQ,EAAE;QACR,EAAE,GAAG,EAAE,GAAG,QAAQ,SAAS,EAAE;QAC7B;YACE,GAAG,EAAE,GAAG,QAAQ,uBAAuB;YACvC,IAAI,EAAE,yBAAyB;SAChC;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,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,OAAO,EAAE,OAAO,EAAE,EAAE,CACxB,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;CAC7D,CAAC;AAEF,sCAAsC;AACtC,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;CAC5B,CAAC"}

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

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

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

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

package/dist/src/capabilities/doctor/runChecks.js

@@ -0,0 +1,86 @@
+/**
+ * The `doctor` run body: the unscoped environment checks plus the scoped rows
+ * the setup target table derives.
+ *
+ * Two kinds of finding live in one report and they are not the same kind. The
+ * ENVIRONMENT checks — the Node version, this CLI's own version, pack refs, the
+ * store — diagnose things `setup` cannot install; they carry no scope and stay
+ * their own section. The SCOPED rows are the setup targets, in both scopes,
+ * named with the target ids verbatim and repaired by the target's own command
+ * — plus, per scope, the `harnesses` inventory row: a listing of what this
+ * machine holds and where pragma stands in it, which is the thing the targets
+ * are measured against rather than a target itself. Adding a target adds its
+ * rows here for free.
+ *
+ * Checks are started eagerly (they run concurrently) and collected in
+ * declaration order for a deterministic report. Each is guarded so a thrown
+ * check becomes an attributable `fail` rather than aborting the whole run.
+ * Lazily imported by `doctor.verb.ts`, so neither the checks nor
+ * `@canonical/harnesses` land on the fast path.
+ */
+import { BIN_NAME } from "../../constants.js";
+import { checkKeStore } from "./checks/checkKeStore.js";
+import { checkNodeVersion } from "./checks/checkNodeVersion.js";
+import { checkPackageRefs } from "./checks/checkPackageRefs.js";
+import { checkPragmaVersion } from "./checks/checkPragmaVersion.js";
+import { scopedChecks } from "./checks/targetHealth.js";
+/**
+ * The unscoped environment checks, each paired with the display name used if it
+ * rejects. The fallback name matches the `name` each check returns on success,
+ * so a thrown check reports the same label and stays correlatable.
+ */
+function buildEnvironmentChecks(rt) {
+    return [
+        ["Node version", checkNodeVersion()],
+        [`${BIN_NAME} version`, checkPragmaVersion(rt)],
+        ["pack refs", checkPackageRefs(rt)],
+        ["store", checkKeStore(rt)],
+    ];
+}
+/** Turn a rejected check into an attributable failure rather than a crash. */
+async function guarded(name, promise) {
+    try {
+        return await promise;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        return {
+            name,
+            status: "fail",
+            detail: `Check threw an unexpected error: ${reason}`,
+            remedy: `Re-run \`${BIN_NAME} doctor\`; if it persists, report this as a bug.`,
+        };
+    }
+}
+/**
+ * Run every health check and aggregate the results.
+ *
+ * @param rt - The per-invocation runtime.
+ * @returns The `{ checks, passed, failed, available, skipped }` summary.
+ * @note Impure — the checks read the fs, boot the store, and detect harnesses.
+ */
+export async function runChecks(rt) {
+    // The scoped rows come back as a batch (one detection pass over the table),
+    // so they are guarded as a batch: a detection that throws becomes one
+    // attributable failure instead of taking the environment section with it.
+    const [environmentResults, scopedResults] = await Promise.all([
+        Promise.all(buildEnvironmentChecks(rt).map(([name, promise]) => guarded(name, promise))),
+        scopedChecks(rt, BIN_NAME).catch((error) => [
+            {
+                name: "setup targets",
+                status: "fail",
+                detail: `Detection threw an unexpected error: ${error instanceof Error ? error.message : String(error)}`,
+                remedy: `Re-run \`${BIN_NAME} doctor\`; if it persists, report this as a bug.`,
+            },
+        ]),
+    ]);
+    const checks = [...environmentResults, ...scopedResults];
+    return {
+        checks,
+        passed: checks.filter((c) => c.status === "pass").length,
+        failed: checks.filter((c) => c.status === "fail").length,
+        available: checks.filter((c) => c.status === "available").length,
+        skipped: checks.filter((c) => c.status === "skip").length,
+    };
+}
+//# sourceMappingURL=runChecks.js.map

package/dist/src/capabilities/doctor/runChecks.js.map

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

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

@@ -0,0 +1,5 @@
+/**
+ * Data shapes for `pragma doctor` (ported verbatim from the old shell).
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * The `graph` capability module — `inspect` (single-entity read) plus `query`
+ * (the raw SPARQL escape hatch, PR6). The covenant blesses both.
+ */
+import { resourceProvider } from "../resources/index.js";
+import { graphInspectVerb } from "./inspect.verb.js";
+import { graphQueryVerb } from "./query.verb.js";
+/**
+ * The `graph` capability module. Carries the MCP resource browser: `graph
+ * inspect` (CLI) and the resource read (MCP) share one entity reader, so the
+ * two projections stay in lockstep. Resources are NOT tools — the emitted tool
+ * surface (and the golden) is unaffected.
+ */
+export const graphModule = {
+    name: "graph",
+    verbs: [graphInspectVerb, graphQueryVerb],
+    mcpResources: resourceProvider,
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/capabilities/graph/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,CAAC,gBAAgB,EAAE,cAAc,CAAC;IACzC,YAAY,EAAE,gBAAgB;CAC/B,CAAC"}

package/dist/src/capabilities/graph/inspect.render.js

@@ -0,0 +1,76 @@
+/**
+ * Formatters for `graph inspect` — the entity's neighbourhood in three shapes.
+ *
+ * Terms arrive ALREADY compacted and named: the reader does it against the
+ * store's own merged prefix map, which is the map the graph was actually built
+ * with, so these formatters neither carry a prefix map nor re-derive one. They
+ * choose between the forms the reader supplies and nothing more.
+ */
+import { toTurtle } from "../../kernel/render/turtle.js";
+/** The short form of a term: prefixed when there is one, else the raw value. */
+const short = (term) => term.prefixed ?? term.value;
+/** A term as a reader should see it — short form, with its name when known. */
+const named = (term) => term.title ? `${short(term)} (${term.title})` : short(term);
+/**
+ * `predicate (330, sample of 5)` — the count is the truth, the list is not.
+ *
+ * A roster and a truncated relation read differently on purpose: "sample of"
+ * tells a reader that paging will not produce the rest and the noun's list verb
+ * is where the full set lives, where "showing" invites them to ask for more.
+ */
+function inboundHeading(group) {
+    if (group.sampled) {
+        return `${short(group.predicate)} (${group.count}, sample of ${group.subjects.length})`;
+    }
+    const suffix = group.truncated
+        ? `${group.count}, showing ${group.subjects.length}`
+        : `${group.count}`;
+    return `${short(group.predicate)} (${suffix})`;
+}
+export const inspectFormatters = {
+    plain(data) {
+        const title = data.label
+            ? `${short({ termType: "NamedNode", value: data.uri, ...(data.prefixed ? { prefixed: data.prefixed } : {}) })} — ${data.label}`
+            : (data.prefixed ?? data.uri);
+        const lines = [title, "═".repeat(Math.max(title.length, 24)), ""];
+        for (const group of data.groups) {
+            lines.push(`  ${short(group.predicate)}:`);
+            for (const object of group.objects)
+                lines.push(`    ${named(object)}`);
+        }
+        for (const [via, rows] of Object.entries(data.nested)) {
+            lines.push("", `  ${via}:`);
+            for (const row of rows) {
+                // Values are TERMS; `String(term)` rendered every nested field as
+                // `[object Object]`, which made the whole plain-format record unreadable.
+                const fields = Object.entries(row)
+                    .map(([key, value]) => `${key}=${named(value)}`)
+                    .join("  ");
+                lines.push(`    ${fields}`);
+            }
+        }
+        if (data.inbound.length > 0) {
+            lines.push("", "  Referenced by:");
+            for (const group of data.inbound) {
+                lines.push(`    ${inboundHeading(group)}`);
+                for (const subject of group.subjects) {
+                    lines.push(`      ${named(subject)}`);
+                }
+            }
+        }
+        return lines.join("\n").trimEnd();
+    },
+    /**
+     * The agent-facing format IS Turtle — same bytes the `pragma:{+uri}` resource
+     * read serves, which is what keeps the mirror contract meaningful now that the
+     * two are no longer both JSON. Measured on one button: 15.8 KB of JSON against
+     * 4.5 KB of Turtle for the same neighbourhood.
+     *
+     * `prefixes` comes from the reader, not from this formatter: it compacted the
+     * terms against the store's own merged map, so re-deriving a map here could
+     * only disagree with the names already in the payload.
+     */
+    llm: (data) => toTurtle(data, data.prefixes),
+    json: (data) => JSON.stringify(data, null, 2),
+};
+//# sourceMappingURL=inspect.render.js.map

package/dist/src/capabilities/graph/inspect.render.js.map

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

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

@@ -0,0 +1,53 @@
+/**
+ * `graph inspect <uri>` — every triple where the URI is the subject, grouped by
+ * predicate. The CLI twin of the MCP resource read (both share {@link readEntity}
+ * in PR3's resources browser); `graph query` (arbitrary SPARQL) lands in PR6.
+ *
+ * Store-backed: the URI is resolved through the store's merged prefix map and
+ * validated to the embeddable shape before it is interpolated, so a prefixed
+ * name or absolute IRI addresses the subject exactly.
+ */
+import { BIN_NAME, DEFAULT_DETAIL_LEVEL, DETAIL_LEVELS, } from "../../constants.js";
+import { readEntity } from "../../kernel/runtime/readEntity.js";
+import { asVerb } from "../../kernel/spec/asVerb.js";
+import { inspectFormatters } from "./inspect.render.js";
+const inspectVerb = {
+    path: ["graph", "inspect"],
+    summary: "Show every triple where a URI is the subject, grouped by predicate.",
+    doc: "Inspect one entity: all predicate/object pairs asserted on the subject. Address it by prefixed name (ds:global.component.button) or absolute IRI.",
+    params: [
+        {
+            kind: "string",
+            name: "uri",
+            doc: "The subject URI — a prefixed name or absolute IRI.",
+            positional: true,
+            required: true,
+            complete: { kind: "names", source: { from: "index", type: "" } },
+        },
+    ],
+    output: { formatters: inspectFormatters },
+    // The read is BOUNDED by disclosure — inbound exemplars and literal previews
+    // both widen with the level — so the verb must declare the ladder it honours.
+    // Without this the CLI `--detail` flag has nothing to validate against and the
+    // MCP projector injects no `detail` argument at all, so the documented knob
+    // was one an agent could not actually reach.
+    disclosure: { levels: [...DETAIL_LEVELS], default: DEFAULT_DETAIL_LEVEL },
+    examples: [
+        { cmd: `${BIN_NAME} graph inspect ds:global.component.button` },
+        {
+            cmd: `${BIN_NAME} graph inspect https://ds.canonical.com/global.component.button`,
+        },
+    ],
+    capability: {
+        needsStore: true,
+        mutates: false,
+        mcp: {
+            expose: true,
+            annotations: { readOnlyHint: true, openWorldHint: false },
+        },
+    },
+    run: (params, rt) => readEntity(rt, String(params.uri)),
+};
+/** The `graph inspect` verb. */
+export const graphInspectVerb = asVerb(inspectVerb);
+//# sourceMappingURL=inspect.verb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/graph/inspect.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,GAAqD;IACpE,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;IAC1B,OAAO,EACL,qEAAqE;IACvE,GAAG,EAAE,mJAAmJ;IACxJ,MAAM,EAAE;QACN;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,KAAK;YACX,GAAG,EAAE,oDAAoD;YACzD,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;SACjE;KACF;IACD,MAAM,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE;IACzC,6EAA6E;IAC7E,8EAA8E;IAC9E,+EAA+E;IAC/E,4EAA4E;IAC5E,6CAA6C;IAC7C,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,aAAa,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE;IACzE,QAAQ,EAAE;QACR,EAAE,GAAG,EAAE,GAAG,QAAQ,2CAA2C,EAAE;QAC/D;YACE,GAAG,EAAE,GAAG,QAAQ,iEAAiE;SAClF;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,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;CACrC,CAAC;AAEF,gCAAgC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC"}

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

@@ -0,0 +1,73 @@
+/**
+ * Formatters for `pragma graph query` — plain, llm, json (no ink).
+ *
+ * Ported verbatim from the old shell's `graph/formatters/query.ts`:
+ * - plain: a tab-separated table for SELECT, `ASK: true/false`, readable triple
+ *   lines for CONSTRUCT.
+ * - llm: condensed Markdown (a table for SELECT, one line for ASK, a triple list
+ *   for CONSTRUCT).
+ * - json: the serialized {@link QueryResult}.
+ */
+/**
+ * Render CONSTRUCT triples as readable `subject\tpredicate\tobject` lines,
+ * collapsing any newlines in literal objects so each triple stays on one line.
+ */
+function formatTriples(triples) {
+    if (triples.length === 0)
+        return "No triples.";
+    return triples
+        .map((t) => {
+        const object = t.object.replace(/\s*\n\s*/g, " ").trim();
+        return `${t.subject}\t${t.predicate}\t${object}`;
+    })
+        .join("\n");
+}
+export const queryFormatters = {
+    // Zero rows/triples: plain stdout stays empty — the notice is
+    // `notice`, routed to stderr (exit 0) by the dispatcher so a pipe
+    // reads no prose. ASK always has a result and never goes empty.
+    notice(result) {
+        if (result.type === "select" && result.bindings.length === 0) {
+            return "No results.";
+        }
+        if (result.type === "construct" && result.triples.length === 0) {
+            return "No triples.";
+        }
+        return undefined;
+    },
+    plain(result) {
+        if (result.type === "select") {
+            if (result.bindings.length === 0)
+                return "";
+            const cols = Object.keys(result.bindings[0] ?? {});
+            const rows = result.bindings.map((b) => cols.map((c) => b[c] ?? "").join("\t"));
+            return [cols.join("\t"), ...rows].join("\n");
+        }
+        if (result.type === "ask") {
+            return `ASK: ${String(result.result)}`;
+        }
+        return result.triples.length === 0 ? "" : formatTriples(result.triples);
+    },
+    llm(result) {
+        if (result.type === "select") {
+            if (result.bindings.length === 0)
+                return "_No results._";
+            const cols = Object.keys(result.bindings[0] ?? {});
+            const header = `| ${cols.join(" | ")} |`;
+            const divider = `| ${cols.map(() => "---").join(" | ")} |`;
+            const rows = result.bindings.map((b) => `| ${cols.map((c) => b[c] ?? "").join(" | ")} |`);
+            return [header, divider, ...rows].join("\n");
+        }
+        if (result.type === "ask") {
+            return `**ASK** → ${String(result.result)}`;
+        }
+        return formatTriples(result.triples)
+            .split("\n")
+            .map((line) => (line.includes("\t") ? `- ${line}` : line))
+            .join("\n");
+    },
+    json(result) {
+        return JSON.stringify(result);
+    },
+};
+//# sourceMappingURL=query.render.js.map

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

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

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"}