jumbo-cli 3.17.0 → 3.19.0

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.17.0",
+  "version": "3.19.0",
   "description": "Memory and Context Orchestration for Coding Agents",
   "keywords": [
     "cli",