kibi-cli 0.12.8 → 0.16.1

package/dist/commands/discovery-shared.js

@@ -1,10 +1,17 @@
 import path from "node:path";
-import Table from "cli-table3";
 import { getBranchOverride } from "../env.js";
 import { PrologProcess, resolveKbPlPath } from "../prolog.js";
 import { escapeAtom } from "../prolog/codec.js";
+import { executeOperation, } from "../public/operations/index.js";
+import { createCliRuntime } from "../runtime/cli-runtime.js";
 import { safeCleanupProlog } from "../utils/prolog-cleanup.js";
+import { renderDiscoveryTable } from "./discovery-table.js";
 import { getCurrentBranch } from "./init-helpers.js";
+export { renderCoverageTable } from "./discovery-table.js";
+// implements REQ-kibi-operation-interface-parity
+export async function executeReportingSpec(spec, input, options = {}) {
+    return executeOperation(createCliRuntime(options), spec, input, options);
+}
 // implements REQ-003
 export async function withAttachedBranchProlog(callback, deps) {
     const createProlog = deps?.createProlog ?? ((opts) => new PrologProcess(opts));
@@ -34,24 +41,6 @@ export async function withAttachedBranchProlog(callback, deps) {
     }
 }
 // implements REQ-003
-export async function withPrologProcess(callback, deps) {
-    const createProlog = deps?.createProlog ?? ((opts) => new PrologProcess(opts));
-    const prolog = createProlog({ timeout: 120000 });
-    try {
-        await prolog.start();
-        // NOTE: useOneShotMode is an internal optimization flag on PrologProcess that
-        // forces single-query mode (start → query → terminate per call) instead of the
-        // default interactive session. It is not exposed in the public PrologProcess
-        // type because callers should not set it directly — only internal discovery
-        // helpers use it for lightweight one-shot queries that don't need session state.
-        prolog.useOneShotMode = true;
-        await prolog.query("set_prolog_flag(answer_write_options, [max_depth(0), spacing(next_argument)])");
-        return await callback(prolog);
-    }
-    finally {
-        await safeCleanupProlog(prolog);
-    }
-}
 // implements REQ-003
 export async function resolveCurrentKbPath() {
     let branch;
@@ -97,193 +86,3 @@ export function printDiscoveryResult(format, structured, fallbackText) {
     const rendered = renderDiscoveryTable(structured);
     console.log(rendered || fallbackText);
 }
-function renderDiscoveryTable(structured) {
-    if (!structured || typeof structured !== "object") {
-        return null;
-    }
-    const payload = structured;
-    if (Array.isArray(payload.results)) {
-        return renderSearchTable(payload);
-    }
-    if (typeof payload.branch === "string" &&
-        typeof payload.syncState === "string") {
-        return renderStatusTable(payload);
-    }
-    if (Array.isArray(payload.nodes) && Array.isArray(payload.edges)) {
-        return renderGraphTable(payload);
-    }
-    if (Array.isArray(payload.rows) &&
-        payload.summary &&
-        typeof payload.summary === "object") {
-        return renderCoverageTable(payload);
-    }
-    if (Array.isArray(payload.rows)) {
-        return renderGapsTable(payload);
-    }
-    return null;
-}
-function renderSearchTable(payload) {
-    const rows = Array.isArray(payload.results) ? payload.results : [];
-    const table = new Table({
-        head: ["ID", "Type", "Title", "Score", "Reasons", "Snippet"],
-        wordWrap: true,
-        colWidths: [20, 10, 32, 8, 28, 44],
-    });
-    for (const row of rows) {
-        const match = row;
-        const entity = (match.entity ?? {});
-        const reasons = Array.isArray(match.reasons)
-            ? match.reasons.join(", ")
-            : "";
-        table.push([
-            stringifyCell(entity.id),
-            stringifyCell(entity.type),
-            stringifyCell(entity.title),
-            stringifyCell(match.score),
-            reasons,
-            stringifyCell(match.snippet),
-        ]);
-    }
-    return [
-        `Search results: ${stringifyCell(payload.count)} total`,
-        table.toString(),
-    ].join("\n");
-}
-function renderStatusTable(payload) {
-    const table = new Table({
-        head: ["Field", "Value"],
-        colWidths: [18, 72],
-        wordWrap: true,
-    });
-    table.push(["Branch", stringifyCell(payload.branch)], ["Sync State", stringifyCell(payload.syncState)], ["Dirty", stringifyCell(payload.dirty)], ["Snapshot", stringifyCell(payload.snapshotId)], ["Synced At", stringifyCell(payload.syncedAt)], ["KB Path", stringifyCell(payload.kbPath)]);
-    return table.toString();
-}
-function renderGapsTable(payload) {
-    const rows = Array.isArray(payload.rows) ? payload.rows : [];
-    const table = new Table({
-        head: ["ID", "Type", "Status", "Missing", "Present", "Source"],
-        colWidths: [20, 10, 12, 24, 24, 40],
-        wordWrap: true,
-    });
-    for (const row of rows) {
-        const item = row;
-        table.push([
-            stringifyCell(item.id),
-            stringifyCell(item.type),
-            stringifyCell(item.status),
-            joinCells(item.missingRelationships),
-            joinCells(item.presentRelationships),
-            stringifyCell(item.source),
-        ]);
-    }
-    return [`Gap rows: ${stringifyCell(payload.count)}`, table.toString()].join("\n");
-}
-function renderCoverageTable(payload) {
-    const summary = (payload.summary ?? {});
-    const rows = Array.isArray(payload.rows) ? payload.rows : [];
-    const summaryTable = new Table({
-        head: ["Metric", "Value"],
-        colWidths: [24, 16],
-    });
-    for (const [key, value] of Object.entries(summary)) {
-        summaryTable.push([key, stringifyCell(value)]);
-    }
-    const firstRow = rows[0];
-    const isRequirementCoverage = firstRow && Object.hasOwn(firstRow, "scenarioCount");
-    const table = isRequirementCoverage
-        ? new Table({
-            head: [
-                "ID",
-                "Status",
-                "Priority",
-                "Coverage",
-                "Scen",
-                "Tests",
-                "Symbols",
-                "Gaps",
-            ],
-            colWidths: [20, 12, 12, 18, 8, 8, 10, 28],
-            wordWrap: true,
-        })
-        : new Table({
-            head: ["ID", "Type", "Coverage", "Details", "Gaps"],
-            colWidths: [20, 10, 18, 28, 28],
-            wordWrap: true,
-        });
-    for (const row of rows) {
-        const item = row;
-        if (isRequirementCoverage) {
-            table.push([
-                stringifyCell(item.id),
-                stringifyCell(item.status),
-                stringifyCell(item.priority),
-                stringifyCell(item.coverageStatus),
-                stringifyCell(item.scenarioCount),
-                stringifyCell(item.testCount),
-                stringifyCell(item.transitiveSymbolCount),
-                joinCells(item.gaps),
-            ]);
-        }
-        else {
-            table.push([
-                stringifyCell(item.id),
-                stringifyCell(item.type),
-                stringifyCell(item.coverageStatus),
-                `req=${stringifyCell(item.directRequirementCount)} test=${stringifyCell(item.testCount)} count=${stringifyCell(item.count)}`,
-                joinCells(item.gaps),
-            ]);
-        }
-    }
-    return [summaryTable.toString(), table.toString()].join("\n\n");
-}
-function renderGraphTable(payload) {
-    const nodes = Array.isArray(payload.nodes) ? payload.nodes : [];
-    const edges = Array.isArray(payload.edges) ? payload.edges : [];
-    const nodeTable = new Table({
-        head: ["Node ID", "Type", "Title", "Status"],
-        colWidths: [22, 10, 36, 12],
-        wordWrap: true,
-    });
-    for (const row of nodes) {
-        const item = row;
-        nodeTable.push([
-            stringifyCell(item.id),
-            stringifyCell(item.type),
-            stringifyCell(item.title),
-            stringifyCell(item.status),
-        ]);
-    }
-    const edgeTable = new Table({
-        head: ["Relationship", "From", "To"],
-        colWidths: [18, 22, 22],
-        wordWrap: true,
-    });
-    for (const row of edges) {
-        const item = row;
-        edgeTable.push([
-            stringifyCell(item.type),
-            stringifyCell(item.from),
-            stringifyCell(item.to),
-        ]);
-    }
-    return [
-        `Nodes: ${nodes.length}  Edges: ${edges.length}  Truncated: ${stringifyCell(payload.truncated)}`,
-        nodeTable.toString(),
-        edgeTable.toString(),
-    ].join("\n\n");
-}
-function stringifyCell(value) {
-    if (value === null || value === undefined || value === "") {
-        return "-";
-    }
-    if (typeof value === "string") {
-        return value;
-    }
-    return String(value);
-}
-function joinCells(value) {
-    if (!Array.isArray(value) || value.length === 0) {
-        return "-";
-    }
-    return value.map((item) => stringifyCell(item)).join(", ");
-}

package/dist/commands/discovery-table.d.ts

@@ -0,0 +1,3 @@
+export declare function renderDiscoveryTable(structured: unknown): string | null;
+export declare function renderCoverageTable(payload: Readonly<Record<string, unknown>>): string;
+//# sourceMappingURL=discovery-table.d.ts.map

package/dist/commands/discovery-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-table.d.ts","sourceRoot":"","sources":["../../src/commands/discovery-table.ts"],"names":[],"mappings":"AAIA,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAmCvE;AA4ED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACzC,MAAM,CA+DR"}

package/dist/commands/discovery-table.js

@@ -0,0 +1,204 @@
+import Table from "cli-table3";
+const EMPTY_FIELDS = Object.freeze({});
+export function renderDiscoveryTable(structured) {
+    if (!isFields(structured)) {
+        return null;
+    }
+    const payload = structured;
+    if (Array.isArray(payload.results)) {
+        return renderSearchTable(payload);
+    }
+    if (typeof payload.branch === "string" &&
+        typeof payload.syncState === "string") {
+        return renderStatusTable(payload);
+    }
+    if (Array.isArray(payload.nodes) && Array.isArray(payload.edges)) {
+        return renderGraphTable(payload);
+    }
+    if (Array.isArray(payload.rows) &&
+        payload.summary &&
+        typeof payload.summary === "object") {
+        return renderCoverageTable(payload);
+    }
+    if (Array.isArray(payload.rows)) {
+        return renderGapsTable(payload);
+    }
+    return null;
+}
+function renderSearchTable(payload) {
+    const rows = Array.isArray(payload.results) ? payload.results : [];
+    const table = new Table({
+        head: ["ID", "Type", "Title", "Score", "Reasons", "Snippet"],
+        wordWrap: true,
+        colWidths: [20, 10, 32, 8, 28, 44],
+    });
+    for (const row of rows) {
+        const match = fieldsFrom(row);
+        const entity = fieldsFrom(match.entity);
+        const reasons = Array.isArray(match.reasons)
+            ? match.reasons.join(", ")
+            : "";
+        table.push([
+            stringifyCell(entity.id),
+            stringifyCell(entity.type),
+            stringifyCell(entity.title),
+            stringifyCell(match.score),
+            reasons,
+            stringifyCell(match.snippet),
+        ]);
+    }
+    return [
+        `Search results: ${stringifyCell(payload.count)} total`,
+        table.toString(),
+    ].join("\n");
+}
+function renderStatusTable(payload) {
+    const table = new Table({
+        head: ["Field", "Value"],
+        colWidths: [18, 72],
+        wordWrap: true,
+    });
+    table.push(["Branch", stringifyCell(payload.branch)], ["Sync State", stringifyCell(payload.syncState)], ["Dirty", stringifyCell(payload.dirty)], ["Snapshot", stringifyCell(payload.snapshotId)], ["Synced At", stringifyCell(payload.syncedAt)], ["KB Path", stringifyCell(payload.kbPath)]);
+    return table.toString();
+}
+function renderGapsTable(payload) {
+    const rows = Array.isArray(payload.rows) ? payload.rows : [];
+    const table = new Table({
+        head: ["ID", "Type", "Status", "Missing", "Present", "Source"],
+        colWidths: [20, 10, 12, 24, 24, 40],
+        wordWrap: true,
+    });
+    for (const row of rows) {
+        const item = fieldsFrom(row);
+        table.push([
+            stringifyCell(item.id),
+            stringifyCell(item.type),
+            stringifyCell(item.status),
+            joinCells(item.missingRelationships),
+            joinCells(item.presentRelationships),
+            stringifyCell(item.source),
+        ]);
+    }
+    return [`Gap rows: ${stringifyCell(payload.count)}`, table.toString()].join("\n");
+}
+export function renderCoverageTable(payload) {
+    const summary = fieldsFrom(payload.summary);
+    const rows = Array.isArray(payload.rows) ? payload.rows : [];
+    const summaryTable = new Table({
+        head: ["Metric", "Value"],
+        colWidths: [24, 16],
+    });
+    for (const [key, value] of Object.entries(summary)) {
+        summaryTable.push([key, stringifyCell(value)]);
+    }
+    const firstRow = firstFields(rows);
+    const isRequirementCoverage = firstRow !== undefined && Object.hasOwn(firstRow, "scenarioCount");
+    const table = isRequirementCoverage
+        ? new Table({
+            head: [
+                "ID",
+                "Status",
+                "Priority",
+                "Coverage",
+                "Depth",
+                "Scen",
+                "Tests",
+                "Symbols",
+                "Gaps",
+            ],
+            colWidths: [20, 12, 12, 18, 32, 8, 8, 10, 28],
+            wordWrap: true,
+        })
+        : new Table({
+            head: ["ID", "Type", "Coverage", "Details", "Gaps"],
+            colWidths: [20, 10, 18, 28, 28],
+            wordWrap: true,
+        });
+    for (const row of rows) {
+        const item = fieldsFrom(row);
+        if (isRequirementCoverage) {
+            table.push([
+                stringifyCell(item.id),
+                stringifyCell(item.status),
+                stringifyCell(item.priority),
+                stringifyCell(item.coverageStatus),
+                stringifyCell(item.coverageDepth),
+                stringifyCell(item.scenarioCount),
+                stringifyCell(item.testCount),
+                stringifyCell(item.transitiveSymbolCount),
+                joinCells(item.gaps),
+            ]);
+        }
+        else {
+            table.push([
+                stringifyCell(item.id),
+                stringifyCell(item.type),
+                stringifyCell(item.coverageStatus),
+                `req=${stringifyCell(item.directRequirementCount)} test=${stringifyCell(item.testCount)} count=${stringifyCell(item.count)}`,
+                joinCells(item.gaps),
+            ]);
+        }
+    }
+    return [summaryTable.toString(), table.toString()].join("\n\n");
+}
+function renderGraphTable(payload) {
+    const nodes = Array.isArray(payload.nodes) ? payload.nodes : [];
+    const edges = Array.isArray(payload.edges) ? payload.edges : [];
+    const nodeTable = new Table({
+        head: ["Node ID", "Type", "Title", "Status"],
+        colWidths: [22, 10, 36, 12],
+        wordWrap: true,
+    });
+    for (const row of nodes) {
+        const item = fieldsFrom(row);
+        nodeTable.push([
+            stringifyCell(item.id),
+            stringifyCell(item.type),
+            stringifyCell(item.title),
+            stringifyCell(item.status),
+        ]);
+    }
+    const edgeTable = new Table({
+        head: ["Relationship", "From", "To"],
+        colWidths: [18, 22, 22],
+        wordWrap: true,
+    });
+    for (const row of edges) {
+        const item = fieldsFrom(row);
+        edgeTable.push([
+            stringifyCell(item.type),
+            stringifyCell(item.from),
+            stringifyCell(item.to),
+        ]);
+    }
+    return [
+        `Nodes: ${nodes.length}  Edges: ${edges.length}  Truncated: ${stringifyCell(payload.truncated)}`,
+        nodeTable.toString(),
+        edgeTable.toString(),
+    ].join("\n\n");
+}
+function isFields(value) {
+    return value !== null && typeof value === "object";
+}
+function fieldsFrom(value) {
+    return isFields(value) ? value : EMPTY_FIELDS;
+}
+function firstFields(values) {
+    const first = values[0];
+    return isFields(first) ? first : undefined;
+}
+function stringifyCell(value) {
+    if (value === null || value === undefined || value === "") {
+        return "-";
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    return String(value);
+}
+function joinCells(value) {
+    if (!Array.isArray(value) || value.length === 0) {
+        return "-";
+    }
+    return value.map((item) => stringifyCell(item)).join(", ");
+}

package/dist/commands/gaps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gaps.d.ts","sourceRoot":"","sources":["../../src/commands/gaps.ts"],"names":[],"mappings":"AAQA,UAAU,WAAW;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B;AAGD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAyBf"}
+{"version":3,"file":"gaps.d.ts","sourceRoot":"","sources":["../../src/commands/gaps.ts"],"names":[],"mappings":"AAMA,UAAU,WAAW;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B;AAGD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/commands/gaps.js

@@ -1,28 +1,24 @@
-import { escapeAtom } from "../prolog/codec.js";
-import { printDiscoveryResult, resolveCurrentKbPath, runJsonModuleQuery, withPrologProcess, } from "./discovery-shared.js";
+import { findGapsSpec } from "../public/operations/index.js";
+import { executeReportingSpec, printDiscoveryResult, } from "./discovery-shared.js";
 // implements REQ-002, REQ-003
 export async function gapsCommand(type, options) {
-    await withPrologProcess(async (prolog) => {
-        const kbPath = await resolveCurrentKbPath();
-        const missing = csvToPrologList(options.missingRel);
-        const present = csvToPrologList(options.presentRel);
-        const tags = csvToPrologList(options.tag);
-        const source = options.source ? `'${escapeAtom(options.source)}'` : "none";
-        const limit = Number.parseInt(options.limit || "100", 10);
-        const offset = Number.parseInt(options.offset || "0", 10);
-        const typeArg = type ? `'${escapeAtom(type)}'` : "none";
-        const result = await runJsonModuleQuery(prolog, "discovery.pl", `discovery:find_gaps_json(${typeArg}, ${missing}, ${present}, ${tags}, ${source}, ${limit}, ${offset}, JsonString)`, "gaps query failed", kbPath);
-        printDiscoveryResult(options.format, result, `Found ${result.count ?? 0} gap rows.`);
+    const result = await executeReportingSpec(findGapsSpec, {
+        ...(type === undefined ? {} : { type }),
+        missingRelationships: csvValues(options.missingRel),
+        presentRelationships: csvValues(options.presentRel),
+        tags: csvValues(options.tag),
+        ...(options.source === undefined ? {} : { sourceFile: options.source }),
+        limit: Number.parseInt(options.limit || "100", 10),
+        offset: Number.parseInt(options.offset || "0", 10),
     });
+    printDiscoveryResult(options.format, result.structuredContent, result.content[0]?.text ?? "No matching gaps found.");
 }
-function csvToPrologList(value) {
+function csvValues(value) {
     if (!value?.trim()) {
-        return "[]";
+        return [];
     }
-    return `[${value
+    return value
         .split(",")
         .map((item) => item.trim())
-        .filter(Boolean)
-        .map((item) => `'${escapeAtom(item)}'`)
-        .join(",")}]`;
+        .filter(Boolean);
 }

package/dist/commands/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AAQA,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B;AAGD,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCvE"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AAMA,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B;AAGD,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBvE"}

package/dist/commands/graph.js

@@ -1,5 +1,5 @@
-import { escapeAtom } from "../prolog/codec.js";
-import { printDiscoveryResult, resolveCurrentKbPath, runJsonModuleQuery, withPrologProcess, } from "./discovery-shared.js";
+import { graphSpec } from "../public/operations/index.js";
+import { executeReportingSpec, printDiscoveryResult, } from "./discovery-shared.js";
 // implements REQ-002, REQ-003
 export async function graphCommand(options) {
     if (!options.from?.trim()) {
@@ -7,29 +7,23 @@ export async function graphCommand(options) {
         process.exitCode = 1;
         return;
     }
-    await withPrologProcess(async (prolog) => {
-        const kbPath = await resolveCurrentKbPath();
-        const seedIds = csvToPrologList(options.from);
-        const relationships = csvToPrologList(options.relationships);
-        const direction = options.direction || "outgoing";
-        const depth = Number.parseInt(options.depth || "1", 10);
-        const entityTypes = csvToPrologList(options.entityTypes);
-        const maxNodes = Number.parseInt(options.maxNodes || "200", 10);
-        const maxEdges = Number.parseInt(options.maxEdges || "500", 10);
-        const result = await runJsonModuleQuery(prolog, "discovery.pl", `discovery:graph_expand_json(${seedIds}, ${relationships}, '${direction}', ${depth}, ${entityTypes}, ${maxNodes}, ${maxEdges}, JsonString)`, "graph query failed", kbPath);
-        const nodes = Array.isArray(result.nodes) ? result.nodes.length : 0;
-        const edges = Array.isArray(result.edges) ? result.edges.length : 0;
-        printDiscoveryResult(options.format, result, `Graph traversal returned ${nodes} nodes and ${edges} edges.`);
+    const result = await executeReportingSpec(graphSpec, {
+        seedIds: csvValues(options.from),
+        relationships: csvValues(options.relationships),
+        direction: options.direction ?? "outgoing",
+        depth: Number.parseInt(options.depth || "1", 10),
+        entityTypes: csvValues(options.entityTypes),
+        maxNodes: Number.parseInt(options.maxNodes || "200", 10),
+        maxEdges: Number.parseInt(options.maxEdges || "500", 10),
     });
+    printDiscoveryResult(options.format, result.structuredContent, result.content[0]?.text ?? "Graph traversal returned no nodes.");
 }
-function csvToPrologList(value) {
+function csvValues(value) {
     if (!value?.trim()) {
-        return "[]";
+        return [];
     }
-    return `[${value
+    return value
         .split(",")
         .map((item) => item.trim())
-        .filter(Boolean)
-        .map((item) => `'${escapeAtom(item)}'`)
-        .join(",")}]`;
+        .filter(Boolean);
 }

package/dist/commands/query.d.ts

@@ -1,11 +1,11 @@
 interface QueryOptions {
-    id?: string;
-    tag?: string;
-    source?: string;
-    relationships?: string;
-    format?: "json" | "table";
-    limit?: string;
-    offset?: string;
+    readonly id?: string;
+    readonly tag?: string;
+    readonly source?: string;
+    readonly relationships?: string;
+    readonly format?: "json" | "table";
+    readonly limit?: string;
+    readonly offset?: string;
 }
 export declare function queryCommand(type: string | undefined, options: QueryOptions): Promise<{
     exitCode: number;

package/dist/commands/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AA4CA,UAAU,YAAY;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA4K/B"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAqBA,UAAU,YAAY;IACpB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA+C/B"}