jumbo-cli 3.16.1 → 3.18.0

package/dist/presentation/cli/commands/relations/list/relations.list.js

@@ -15,7 +15,23 @@ export const metadata = {
         },
         {
             flags: "--entity-id <id>",
-            description: "Filter by entity ID (requires --entity-type)",
+            description: "Filter by entity ID",
+        },
+        {
+            flags: "-d, --direction <direction>",
+            description: "Filter relative to the entity: in, out, or both (default)",
+        },
+        {
+            flags: "--relation-type <type>",
+            description: "Filter by relation type",
+        },
+        {
+            flags: "--related-entity-type <type>",
+            description: "Filter by the type at the opposite endpoint",
+        },
+        {
+            flags: "--strength <strength>",
+            description: "Filter by strength: strong, medium, or weak",
         },
         {
             flags: "-s, --status <status>",
@@ -37,16 +53,18 @@ export async function relationsList(options, container) {
     const renderer = Renderer.getInstance();
     try {
         const request = {
+            entity: options.entityType && options.entityId
+                ? { entityType: options.entityType, entityId: options.entityId }
+                : undefined,
             entityType: options.entityType,
             entityId: options.entityId,
+            direction: options.direction,
+            relationType: options.relationType,
+            relatedEntityType: options.relatedEntityType,
+            strength: options.strength,
             status: options.status ?? "active",
         };
         const { relations } = await container.getRelationsController.handle(request);
-        if (relations.length === 0) {
-            const filterMsg = options.entityType ? ` involving ${options.entityType}` : "";
-            renderer.info(`No relations found${filterMsg}. Use 'jumbo relation add' to add one.`);
-            return;
-        }
         const config = renderer.getConfig();
         const outputBuilder = new RelationListOutputBuilder();
         if (config.format === "text") {
@@ -57,11 +75,7 @@ export async function relationsList(options, container) {
             renderer.info(output.toHumanReadable());
         }
         else {
-            const output = outputBuilder.buildStructuredOutput(relations, {
-                entityType: options.entityType ?? null,
-                entityId: options.entityId ?? null,
-                status: options.status ?? "active",
-            });
+            const output = outputBuilder.buildStructuredOutput(relations, request);
             const sections = output.getSections();
             const dataSection = sections.find(s => s.type === "data");
             if (dataSection)
@@ -69,7 +83,16 @@ export async function relationsList(options, container) {
         }
     }
     catch (error) {
-        renderer.error("Failed to list relations", error instanceof Error ? error : String(error));
+        const output = new RelationListOutputBuilder().buildFailureError(error instanceof Error ? error : String(error));
+        const config = renderer.getConfig();
+        if (config.format === "text") {
+            renderer.error(output.toHumanReadable());
+        }
+        else {
+            const dataSection = output.getSections().find((section) => section.type === "data");
+            if (dataSection)
+                renderer.data(dataSection.content);
+        }
         process.exit(1);
     }
 }

package/dist/presentation/cli/commands/relations/list/relations.list.js.map

@@ -1 +1 @@
-{"version":3,"file":"relations.list.js","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/relations/list/relations.list.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"relations.list.js","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/relations/list/relations.list.ts"],"names":[],"mappings":"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"}

package/dist/presentation/cli/commands/relations/traverse/RelationTraverseOutputBuilder.d.ts

@@ -0,0 +1,13 @@
+import { RelationTraversalResult } from "../../../../../application/context/relations/traverse/RelationTraversalResult.js";
+import { TerminalOutput } from "../../../output/TerminalOutput.js";
+export declare class RelationTraverseOutputBuilder {
+    private readonly builder;
+    build(result: RelationTraversalResult): TerminalOutput;
+    buildStructuredOutput(result: RelationTraversalResult): TerminalOutput;
+    buildFailureError(error: Error | string): TerminalOutput;
+    private edgeData;
+    private edgeHop;
+    private nodeKey;
+    private nodeLabel;
+}
+//# sourceMappingURL=RelationTraverseOutputBuilder.d.ts.map

package/dist/presentation/cli/commands/relations/traverse/RelationTraverseOutputBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelationTraverseOutputBuilder.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/relations/traverse/RelationTraverseOutputBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kFAAkF,CAAC;AAE3H,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAKnE,qBAAa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IAEvD,KAAK,CAAC,MAAM,EAAE,uBAAuB,GAAG,cAAc;IA6CtD,qBAAqB,CAAC,MAAM,EAAE,uBAAuB,GAAG,cAAc;IActE,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,cAAc;IAQxD,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,SAAS;CAGlB"}

package/dist/presentation/cli/commands/relations/traverse/RelationTraverseOutputBuilder.js

@@ -0,0 +1,95 @@
+import { TerminalOutputBuilder } from "../../../output/TerminalOutputBuilder.js";
+import { contentLine, heading, metaField } from "../../../rendering/OutputLayout.js";
+import { BrandColors, Colors, Symbols } from "../../../rendering/StyleConfig.js";
+export class RelationTraverseOutputBuilder {
+    constructor() {
+        this.builder = new TerminalOutputBuilder();
+    }
+    build(result) {
+        this.builder.reset();
+        const lines = [
+            "",
+            heading(`Relation traversal from ${this.nodeLabel(result.root.entityType, result.root.entityId)}`),
+            metaField("Depth", Colors.muted(`${result.reachedDepth}/${result.requestedDepth}`), 11),
+            metaField("Edges", Colors.muted(`${result.edges.length}/${result.limit}`), 11),
+            metaField("Truncated", Colors.muted(String(result.truncated)), 11),
+        ];
+        if (result.edges.length === 0) {
+            lines.push("");
+            lines.push(contentLine(Colors.muted("No matching relations were found.")));
+        }
+        else {
+            const distances = new Map([
+                [this.nodeKey(result.root.entityType, result.root.entityId), 0],
+                ...result.nodes.map((node) => [
+                    this.nodeKey(node.entityType, node.entityId),
+                    node.distance,
+                ]),
+            ]);
+            for (let hop = 1; hop <= result.reachedDepth; hop++) {
+                const nodes = result.nodes.filter((node) => node.distance === hop);
+                const edges = result.edges.filter((edge) => this.edgeHop(edge, distances) === hop);
+                lines.push("");
+                lines.push(heading(`Hop ${hop}`));
+                for (const node of nodes) {
+                    lines.push(contentLine(BrandColors.accentCyan(this.nodeLabel(node.entityType, node.entityId))));
+                }
+                for (const edge of edges) {
+                    const strength = edge.strength ? `, ${edge.strength}` : "";
+                    lines.push(contentLine(`${this.nodeLabel(edge.fromEntityType, edge.fromEntityId)} ` +
+                        `--[${edge.relationType}${strength}]--> ` +
+                        this.nodeLabel(edge.toEntityType, edge.toEntityId)));
+                }
+            }
+        }
+        this.builder.addPrompt(lines.join("\n"));
+        return this.builder.build();
+    }
+    buildStructuredOutput(result) {
+        this.builder.reset();
+        this.builder.addData({
+            root: { ...result.root },
+            nodes: result.nodes.map((node) => ({ ...node })),
+            edges: result.edges.map((edge) => this.edgeData(edge)),
+            requestedDepth: result.requestedDepth,
+            reachedDepth: result.reachedDepth,
+            limit: result.limit,
+            truncated: result.truncated,
+        });
+        return this.builder.build();
+    }
+    buildFailureError(error) {
+        this.builder.reset();
+        const message = error instanceof Error ? error.message : error;
+        this.builder.addPrompt(`${Symbols.cross} ${Colors.error("Failed to traverse relations")}: ${message}`);
+        this.builder.addData({ error: "Failed to traverse relations", message });
+        return this.builder.build();
+    }
+    edgeData(edge) {
+        return {
+            relationId: edge.relationId,
+            fromEntityType: edge.fromEntityType,
+            fromEntityId: edge.fromEntityId,
+            toEntityType: edge.toEntityType,
+            toEntityId: edge.toEntityId,
+            relationType: edge.relationType,
+            strength: edge.strength,
+            description: edge.description,
+            status: edge.status,
+            createdAt: edge.createdAt,
+            updatedAt: edge.updatedAt,
+        };
+    }
+    edgeHop(edge, distances) {
+        const fromDistance = distances.get(this.nodeKey(edge.fromEntityType, edge.fromEntityId)) ?? 0;
+        const toDistance = distances.get(this.nodeKey(edge.toEntityType, edge.toEntityId)) ?? 0;
+        return Math.max(fromDistance, toDistance, 1);
+    }
+    nodeKey(entityType, entityId) {
+        return `${entityType}\u0000${entityId}`;
+    }
+    nodeLabel(entityType, entityId) {
+        return `${entityType}:${entityId}`;
+    }
+}
+//# sourceMappingURL=RelationTraverseOutputBuilder.js.map

package/dist/presentation/cli/commands/relations/traverse/RelationTraverseOutputBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelationTraverseOutputBuilder.js","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/relations/traverse/RelationTraverseOutputBuilder.ts"],"names":[],"mappings":"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"}

package/dist/presentation/cli/commands/relations/traverse/relations.traverse.d.ts

@@ -0,0 +1,15 @@
+import { IApplicationContainer } from "../../../../../application/host/IApplicationContainer.js";
+import { CommandMetadata } from "../../registry/CommandMetadata.js";
+export declare const metadata: CommandMetadata;
+export declare function relationsTraverse(options: {
+    id: string;
+    entityType?: string;
+    depth?: string;
+    direction?: string;
+    relationType?: string;
+    relatedEntityType?: string;
+    strength?: string;
+    status?: string;
+    limit?: string;
+}, container: IApplicationContainer): Promise<void>;
+//# sourceMappingURL=relations.traverse.d.ts.map

package/dist/presentation/cli/commands/relations/traverse/relations.traverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.traverse.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/relations/traverse/relations.traverse.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0DAA0D,CAAC;AAMjG,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGpE,eAAO,MAAM,QAAQ,EAAE,eAuBtB,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE;IACP,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,SAAS,EAAE,qBAAqB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/presentation/cli/commands/relations/traverse/relations.traverse.js

@@ -0,0 +1,66 @@
+import { Renderer } from "../../../rendering/Renderer.js";
+import { RelationTraverseOutputBuilder } from "./RelationTraverseOutputBuilder.js";
+export const metadata = {
+    description: "Traverse bounded relation context from an entity",
+    category: "relations",
+    requiredOptions: [
+        { flags: "-i, --id <id>", description: "Entity ID at the traversal root" },
+    ],
+    options: [
+        { flags: "--entity-type <type>", description: "Root entity type (inferred when the ID is unique)" },
+        { flags: "--depth <depth>", description: "Traversal depth from 1 through 5", default: 1 },
+        { flags: "-d, --direction <direction>", description: "Direction: in, out, or both", default: "both" },
+        { flags: "--relation-type <type>", description: "Filter by relation type" },
+        { flags: "--related-entity-type <type>", description: "Filter each expansion by opposite endpoint type" },
+        { flags: "--strength <strength>", description: "Filter by strength: strong, medium, or weak" },
+        { flags: "-s, --status <status>", description: "Filter by status: active, deactivated, removed, or all", default: "active" },
+        { flags: "--limit <limit>", description: "Maximum number of distinct edges from 1 through 1000", default: 100 },
+    ],
+    examples: [
+        { command: "jumbo relations traverse --id goal_123", description: "Inspect the immediate active context" },
+        { command: "jumbo relations traverse --id goal_123 --entity-type goal --depth 3", description: "Traverse three hops from a typed root" },
+        { command: "jumbo relations traverse --id comp_123 --direction out --relation-type requires --format json", description: "Return filtered outgoing context as JSON" },
+    ],
+    related: ["relations list", "relation add", "relation remove"],
+    requiresProject: true,
+};
+export async function relationsTraverse(options, container) {
+    const renderer = Renderer.getInstance();
+    const outputBuilder = new RelationTraverseOutputBuilder();
+    try {
+        const request = {
+            entityId: options.id,
+            entityType: options.entityType,
+            depth: Number(options.depth ?? 1),
+            direction: options.direction ?? "both",
+            relationType: options.relationType,
+            relatedEntityType: options.relatedEntityType,
+            strength: options.strength,
+            status: options.status ?? "active",
+            limit: Number(options.limit ?? 100),
+        };
+        const result = await container.traverseRelationsController.handle(request);
+        if (renderer.getConfig().format === "text") {
+            renderer.info(outputBuilder.build(result).toHumanReadable());
+        }
+        else {
+            const output = outputBuilder.buildStructuredOutput(result);
+            const dataSection = output.getSections().find((section) => section.type === "data");
+            if (dataSection)
+                renderer.data(dataSection.content);
+        }
+    }
+    catch (error) {
+        const output = outputBuilder.buildFailureError(error instanceof Error ? error : String(error));
+        if (renderer.getConfig().format === "text") {
+            renderer.error(output.toHumanReadable());
+        }
+        else {
+            const dataSection = output.getSections().find((section) => section.type === "data");
+            if (dataSection)
+                renderer.data(dataSection.content);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=relations.traverse.js.map

package/dist/presentation/cli/commands/relations/traverse/relations.traverse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.traverse.js","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/relations/traverse/relations.traverse.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jumbo-cli",
-  "version": "3.16.1",
+  "version": "3.18.0",
   "description": "Memory and Context Orchestration for Coding Agents",
   "keywords": [
     "cli",