@nodesify/astria 1.0.4 → 1.0.6

package/README.md

@@ -8,7 +8,7 @@ Turn any folder into a queryable knowledge graph.
 npm install -g @nodesify/astria
 ```
 
-Requires Node.js >= 20. No Rust toolchain needed — ships prebuilt native binaries for macOS, Linux, and Windows.
+Requires Node.js >= 22. No Rust toolchain needed — ships prebuilt native binaries for macOS, Linux, and Windows.
 
 > **Migrating from `@nodesify/graphify`?** Run `astria migrate` once (renames `.graphify/` → `.astria/` and the global store), then `astria install` to refresh AI-tool skills and hooks. `GRAPHIFY_*` env vars keep working; `ASTRIA_*` takes precedence.
 
@@ -16,7 +16,7 @@ Requires Node.js >= 20. No Rust toolchain needed — ships prebuilt native binar
 
 ```bash
 astria run <path>                            # Full pipeline: detect → extract → build → cluster → analyze → report
-astria update <path>                         # Incremental rebuild (only changed files)
+astria update <path>                         # Reuse cached extraction; reconcile current corpus
 astria watch <path> [--debounce 3000]        # Watch for file changes, auto-rebuild
 astria explain <node> [--graph .]            # Explain a node and its connections
 astria query <question> [--dfs] [--depth 2] [--budget 2000] [--graph .]  # BFS/DFS traversal
@@ -36,6 +36,14 @@ Running `astria run .` creates `.astria/` with:
 - `graph.json` — full graph export
 - `graph_report.md` — report with hub nodes, communities, surprising connections
 
+### Retrieval and upgrades
+
+Scoped code definitions survive semantic deduplication. JS/TS assigned functions retain binding names and bodies; Python implementations take precedence over overload declarations. Queries favor complete identifiers while honoring explicit requests for tests or documentation. Static receiver matching does not infer runtime types or aliases.
+
+`query --budget N` caps the full query text using `o200k_base`, including metadata. CLI and MCP share that text budget; MCP transport JSON is excluded. Budgets must fit metadata and the next complete record or the query returns an error. Use the returned `--cursor N` for the next page of node and edge records.
+
+After upgrading, run `astria update .` to refresh extraction and restore definitions removed by older deduplication. Discard old pagination cursors after an upgrade or graph rebuild.
+
 ### HTML visualization modes
 
 HTML export defaults to `--mode standard`, matching the original Graphify viewer's 5,000-node safety limit. Graphs above that limit require an explicit large-graph export:
@@ -48,7 +56,7 @@ Large mode uses precomputed positions and disabled physics, starts with key node
 
 ## Supported languages
 
-Python, JavaScript, TypeScript, Rust, Go, Java, C, C++, Ruby, Swift, Scala, PHP, C#, Lua, Haskell, Elixir, Bash, Dart, Zig, CSS.
+Python, JavaScript, TypeScript, Rust, Go, Java, C, C++, Ruby, Swift, Kotlin, Scala, PHP, C#, Lua, Haskell, Elixir, Bash, Dart, Zig, CSS, Terraform/HCL, PowerShell, Verilog/SystemVerilog, and Metal. See the [generated language table](https://nodesify.github.io/astria/docs/reference/language-support) for extensions and extraction details.
 
 ## AI platform integration
 

package/dist/commands/affected.d.ts

@@ -2,5 +2,6 @@ export declare function affectedCommand(node: string, opts: {
     graph: string;
     depth: string;
     relation?: string;
+    json?: boolean;
 }): Promise<void>;
 //# sourceMappingURL=affected.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"affected.d.ts","sourceRoot":"","sources":["../../src/commands/affected.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,iBAuBA"}
+{"version":3,"file":"affected.d.ts","sourceRoot":"","sources":["../../src/commands/affected.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,iBAsCA"}

package/dist/commands/affected.js

@@ -6,6 +6,15 @@ async function affectedCommand(node, opts) {
     try {
         const depth = parseInt(opts.depth, 10) || 2;
         const result = (0, native_1.affectedNode)(opts.graph, node, depth, opts.relation);
+        if (opts.json) {
+            console.log(JSON.stringify({
+                seed: result.seed,
+                seedLabel: result.seedLabel,
+                total: result.total,
+                hits: result.hits,
+            }, null, 2));
+            return;
+        }
         if (result.total === 0) {
             console.log(`Nothing references "${result.seedLabel}" — no blast radius.`);
             return;

package/dist/commands/affected.js.map

@@ -1 +1 @@
-{"version":3,"file":"affected.js","sourceRoot":"","sources":["../../src/commands/affected.ts"],"names":[],"mappings":";;AAEA,0CA2BC;AA7BD,sCAAyC;AAElC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAInD;IACC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,SAAS,sBAAsB,CAAC,CAAC;YAC3E,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,SAAS,cAAc,KAAK,MAAM,MAAM,CAAC,KAAK,UAAU,CAAC,CAAC;QACjG,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC5B,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"affected.js","sourceRoot":"","sources":["../../src/commands/affected.ts"],"names":[],"mappings":";;AAEA,0CA2CC;AA7CD,sCAAyC;AAElC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAKnD;IACC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;gBACE,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,SAAS,sBAAsB,CAAC,CAAC;YAC3E,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,SAAS,cAAc,KAAK,MAAM,MAAM,CAAC,KAAK,UAAU,CAAC,CAAC;QACjG,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC5B,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/callflow.d.ts

@@ -0,0 +1,7 @@
+export declare function callflowCommand(node: string, opts: {
+    graph: string;
+    depth?: string;
+    direction?: string;
+    out?: string;
+}): Promise<void>;
+//# sourceMappingURL=callflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callflow.d.ts","sourceRoot":"","sources":["../../src/commands/callflow.ts"],"names":[],"mappings":"AAGA,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,iBAmB1E"}

package/dist/commands/callflow.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callflowCommand = callflowCommand;
+const fs_1 = require("fs");
+const native_1 = require("../native");
+async function callflowCommand(node, opts) {
+    try {
+        const depth = Math.max(1, Number(opts.depth ?? 2) || 2);
+        const direction = opts.direction || 'out';
+        if (!['in', 'out', 'both'].includes(direction)) {
+            throw new Error(`Unknown direction "${direction}". Valid: in, out, both`);
+        }
+        const mermaid = (0, native_1.callflowMermaid)(opts.graph, node, depth, direction);
+        if (opts.out) {
+            (0, fs_1.writeFileSync)(opts.out, mermaid + '\n');
+            console.log(`Call-flow written to: ${opts.out}`);
+        }
+        else {
+            console.log(mermaid);
+        }
+    }
+    catch (e) {
+        console.error(`Error: ${e.message || e}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=callflow.js.map

package/dist/commands/callflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callflow.js","sourceRoot":"","sources":["../../src/commands/callflow.ts"],"names":[],"mappings":";;AAGA,0CAqBC;AAxBD,2BAAmC;AACnC,sCAA4C;AAErC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,IAAyE;IAEzE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;QAC1C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,yBAAyB,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,OAAO,GAAG,IAAA,wBAAe,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,IAAA,kBAAa,EAAC,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/communities.d.ts

@@ -0,0 +1,5 @@
+export declare function communitiesCommand(opts: {
+    graph: string;
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=communities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"communities.d.ts","sourceRoot":"","sources":["../../src/commands/communities.ts"],"names":[],"mappings":"AAEA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,iBAwB/E"}

package/dist/commands/communities.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.communitiesCommand = communitiesCommand;
+const native_1 = require("../native");
+async function communitiesCommand(opts) {
+    try {
+        const result = (0, native_1.listCommunities)(opts.graph);
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        const modularity = result.modularity != null ? ` (modularity ${result.modularity.toFixed(3)})` : '';
+        const llmNamed = result.communities.filter((c) => c.labelSource === 'llm').length;
+        console.log(`${result.communities.length} communities${modularity}:`);
+        for (const c of result.communities) {
+            // An LLM label is a summary of the code; a hub label is a fact about it.
+            const sourceTag = c.labelSource === 'llm' ? '' : ' [hub]';
+            const summary = c.summary ? ` — ${c.summary}` : '';
+            const cohesion = c.cohesion != null ? c.cohesion.toFixed(2) : '-';
+            console.log(`  [${c.id}] ${c.label}${sourceTag} - ${c.size} nodes, cohesion ${cohesion}${summary}`);
+        }
+        if (llmNamed > 0) {
+            console.log(`\n${llmNamed} communities carry LLM thematic labels (astria run --label-communities).`);
+        }
+    }
+    catch (e) {
+        console.error(`Error: ${e.message || e}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=communities.js.map

package/dist/commands/communities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"communities.js","sourceRoot":"","sources":["../../src/commands/communities.ts"],"names":[],"mappings":";;AAEA,gDAwBC;AA1BD,sCAA4C;AAErC,KAAK,UAAU,kBAAkB,CAAC,IAAuC;IAC9E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,wBAAe,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,gBAAgB,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,eAAe,UAAU,GAAG,CAAC,CAAC;QACtE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACnC,yEAAyE;YACzE,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC1D,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAClE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,GAAG,SAAS,MAAM,CAAC,CAAC,IAAI,oBAAoB,QAAQ,GAAG,OAAO,EAAE,CAAC,CAAC;QACtG,CAAC;QACD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,0EAA0E,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/explain.d.ts

@@ -1,4 +1,5 @@
 export declare function explainCommand(node: string, opts: {
     graph: string;
+    json?: boolean;
 }): Promise<void>;
 //# sourceMappingURL=explain.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":"AAEA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,iBAkCzE"}
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":"AAEA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,iBAsCzF"}

package/dist/commands/explain.js

@@ -9,6 +9,10 @@ async function explainCommand(node, opts) {
             console.log(`Node "${node}" not found`);
             return;
         }
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
         console.log(`Node: ${result.label}`);
         console.log(`  ID: ${result.id}`);
         console.log(`  File: ${result.sourceFile}${result.sourceLine != null ? `:${result.sourceLine}` : ''}`);

package/dist/commands/explain.js.map

@@ -1 +1 @@
-{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":";;AAEA,wCAkCC;AApCD,sCAAwC;AAEjC,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,IAAuB;IACxE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,aAAa,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CACT,WAAW,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1F,CAAC;QACF,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;YACxD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACjC,MAAM,GAAG,GAAG,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnF,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;gBACnD,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;gBACjE,OAAO,CAAC,GAAG,CAAC,aAAa,SAAS,OAAO,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":";;AAEA,wCAsCC;AAxCD,sCAAwC;AAEjC,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,IAAuC;IACxF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,aAAa,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CACT,WAAW,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1F,CAAC;QACF,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;YACxD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACjC,MAAM,GAAG,GAAG,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnF,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;gBACnD,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;gBACjE,OAAO,CAAC,GAAG,CAAC,aAAa,SAAS,OAAO,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/export.d.ts

@@ -3,5 +3,10 @@ export declare function exportCommand(opts: {
     out: string;
     format: string;
     mode?: string;
+    neo4jPush?: string;
+    neo4jUser?: string;
+    neo4jPass?: string;
+    redisPush?: string;
+    graphName?: string;
 }): Promise<void>;
 //# sourceMappingURL=export.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAEA,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,iBA6BtG"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAIA,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,iBA0E1M"}

package/dist/commands/export.js

@@ -1,13 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.exportCommand = exportCommand;
+const node_child_process_1 = require("node:child_process");
+const fs_1 = require("fs");
 const native_1 = require("../native");
 async function exportCommand(opts) {
     try {
         const format = opts.format || 'json';
-        if (!['json', 'html', 'graphml', 'cypher'].includes(format)) {
+        if (!['json', 'html', 'graphml', 'cypher', 'svg', 'falkordb'].includes(format)) {
             const hint = format === 'obsidian' ? ' (obsidian is a wiki format: astria wiki --format obsidian)' : '';
-            throw new Error(`Unknown export format "${format}". Valid formats: json, html, graphml, cypher${hint}`);
+            throw new Error(`Unknown export format "${format}". Valid formats: json, html, graphml, cypher, svg, falkordb${hint}`);
+        }
+        // Live Neo4j push: same graph data the Cypher file carries, straight
+        // over Bolt. Credentials come from flags or NEO4J_USERNAME/NEO4J_PASSWORD.
+        if (opts.neo4jPush) {
+            if (format !== 'cypher') {
+                throw new Error('--neo4j-push pairs with --format cypher (it pushes the same graph live)');
+            }
+            const counts = (0, native_1.neo4jPushCmd)(opts.graph, opts.neo4jPush, opts.neo4jUser ?? null, opts.neo4jPass ?? null);
+            console.log(`Pushed to Neo4j at ${opts.neo4jPush}: ${counts.nodes} nodes, ${counts.edges} edges, ${counts.communities} communities (${counts.statements} statements)`);
+            return;
         }
         if (format === 'html') {
             const outPath = opts.out.replace(/\.json$/, '.html');
@@ -24,6 +36,40 @@ async function exportCommand(opts) {
             const statements = (0, native_1.exportCypherCmd)(opts.graph, outPath);
             console.log(`Exported Cypher to: ${outPath} (${statements} MERGE statements — idempotent, safe to re-run)`);
         }
+        else if (format === 'falkordb') {
+            const outPath = opts.out.replace(/\.json$/, '.falkordb.cypher');
+            const statements = (0, native_1.exportCypherCmd)(opts.graph, outPath);
+            const body = (0, fs_1.readFileSync)(outPath, 'utf-8');
+            const NL = String.fromCharCode(10);
+            const header = '// astria FalkorDB export - openCypher, idempotent (MERGE)' + NL +
+                '// Load into a running FalkorDB/Redis:' + NL +
+                `//   redis-cli -h <host> -p <port> -x GRAPH.QUERY ${opts.graphName || 'astria'} < statement.cypher` + NL +
+                '// Or re-run this export with --redis-push <host:port> to push directly (requires redis-cli).' + NL;
+            (0, fs_1.writeFileSync)(outPath, header + body);
+            console.log(`Exported FalkorDB Cypher to: ${outPath} (${statements} MERGE statements)`);
+            if (opts.redisPush) {
+                const [host, port] = opts.redisPush.split(':');
+                const stmts = body.split(NL).filter((l) => l.trim() && !l.startsWith('//')).map((l) => l.replace(/;\s*$/, ''));
+                let sent = 0;
+                for (const stmt of stmts) {
+                    const r = (0, node_child_process_1.spawnSync)('redis-cli', ['-h', host, '-p', port || '6379', '-x', `GRAPH.QUERY ${opts.graphName || 'astria'}`], {
+                        input: stmt,
+                        encoding: 'utf8',
+                    });
+                    if (r.status !== 0) {
+                        throw new Error(`redis-cli failed on statement ${sent + 1}: ${r.stderr || r.stdout || 'unknown error'}`);
+                    }
+                    sent++;
+                }
+                console.log(`Pushed ${sent} statements to FalkorDB graph "${opts.graphName || 'astria'}"`);
+            }
+            return;
+        }
+        else if (format === 'svg') {
+            const outPath = opts.out.replace(/\.json$/, '.svg');
+            const counts = (0, native_1.exportSvgCmd)(opts.graph, outPath);
+            console.log(`Exported SVG to: ${outPath} (${counts.nodes} nodes, ${counts.edges} edges, ${counts.communities} communities${counts.truncated ? ', capped' : ''})`);
+        }
         else {
             (0, native_1.exportJsonCmd)(opts.graph, opts.out);
             console.log(`Exported JSON to: ${opts.out}`);

package/dist/commands/export.js.map

@@ -1 +1 @@
-{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":";;AAEA,sCA6BC;AA/BD,sCAA4F;AAErF,KAAK,UAAU,aAAa,CAAC,IAAmE;IACrG,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;QAErC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,GAAG,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,6DAA6D,CAAC,CAAC,CAAC,EAAE,CAAC;YACxG,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,gDAAgD,IAAI,EAAE,CAAC,CAAC;QAC1G,CAAC;QAED,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACrD,IAAA,sBAAa,EAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC;aAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACxD,IAAA,yBAAgB,EAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACvD,MAAM,UAAU,GAAG,IAAA,wBAAe,EAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,KAAK,UAAU,iDAAiD,CAAC,CAAC;QAC9G,CAAC;aAAM,CAAC;YACN,IAAA,sBAAa,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"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"}

package/dist/commands/god-nodes.d.ts

@@ -0,0 +1,5 @@
+export declare function godNodesCommand(opts: {
+    graph: string;
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=god-nodes.d.ts.map

package/dist/commands/god-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"god-nodes.d.ts","sourceRoot":"","sources":["../../src/commands/god-nodes.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,iBAmB5E"}

package/dist/commands/god-nodes.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.godNodesCommand = godNodesCommand;
+const native_1 = require("../native");
+async function godNodesCommand(opts) {
+    try {
+        const nodes = (0, native_1.godNodes)(opts.graph);
+        if (opts.json) {
+            console.log(JSON.stringify(nodes, null, 2));
+            return;
+        }
+        if (nodes.length === 0) {
+            console.log('No hub nodes found');
+            return;
+        }
+        console.log('Top hubs:');
+        for (const n of nodes) {
+            console.log(`  ${n.label} (degree ${n.degree}, community ${n.community ?? '-'})`);
+        }
+    }
+    catch (e) {
+        console.error(`Error: ${e.message || e}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=god-nodes.js.map

package/dist/commands/god-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"god-nodes.js","sourceRoot":"","sources":["../../src/commands/god-nodes.ts"],"names":[],"mappings":";;AAEA,0CAmBC;AArBD,sCAAqC;AAE9B,KAAK,UAAU,eAAe,CAAC,IAAuC;IAC3E,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAA,iBAAQ,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;YAClC,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,MAAM,eAAe,CAAC,CAAC,SAAS,IAAI,GAAG,GAAG,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/health.d.ts

@@ -0,0 +1,5 @@
+export declare function healthCommand(opts: {
+    graph: string;
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/commands/health.ts"],"names":[],"mappings":"AAEA,wBAAsB,aAAa,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,iBA2B1E"}

package/dist/commands/health.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.healthCommand = healthCommand;
+const native_1 = require("../native");
+async function healthCommand(opts) {
+    try {
+        const report = (0, native_1.healthReport)(opts.graph);
+        if (opts.json) {
+            console.log(JSON.stringify({
+                score: report.score,
+                grade: report.grade,
+                ageDays: report.ageDays,
+                nodeCount: report.nodeCount,
+                edgeCount: report.edgeCount,
+                deadCode: report.deadCode,
+                cycles: report.cycles,
+                hubs: report.hubs,
+            }, null, 2));
+        }
+        else {
+            console.log(report.text);
+        }
+    }
+    catch (e) {
+        console.error(`Error: ${e.message || e}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/commands/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/commands/health.ts"],"names":[],"mappings":";;AAEA,sCA2BC;AA7BD,sCAAyC;AAElC,KAAK,UAAU,aAAa,CAAC,IAAuC;IACzE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;gBACE,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/llm-summary.d.ts

@@ -0,0 +1,13 @@
+interface PipelineResultSummary {
+    semanticCached: number;
+    llmInputTokens: number;
+    llmOutputTokens: number;
+    llmApiCalls: number;
+    communitiesLabeled: number;
+    communitiesReused: number;
+    communitiesFailed: number;
+    deepLinks: number;
+}
+export declare function printLlmSummary(result: PipelineResultSummary): void;
+export {};
+//# sourceMappingURL=llm-summary.d.ts.map

package/dist/commands/llm-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-summary.d.ts","sourceRoot":"","sources":["../../src/commands/llm-summary.ts"],"names":[],"mappings":"AAGA,UAAU,qBAAqB;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAenE"}

package/dist/commands/llm-summary.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printLlmSummary = printLlmSummary;
+function printLlmSummary(result) {
+    if (result.llmApiCalls > 0) {
+        const cached = result.semanticCached > 0 ? `, ${result.semanticCached} files from cache` : '';
+        console.log(`LLM usage: ${result.llmApiCalls} API calls, ${result.llmInputTokens} in / ${result.llmOutputTokens} out tokens${cached}`);
+    }
+    if (result.communitiesLabeled >= 0) {
+        const reused = result.communitiesReused > 0 ? `, ${result.communitiesReused} unchanged` : '';
+        const failed = result.communitiesFailed > 0 ? `, ${result.communitiesFailed} failed (kept hub names)` : '';
+        console.log(`Communities labeled: ${result.communitiesLabeled}${reused}${failed} (--label-communities)`);
+    }
+    if (result.deepLinks >= 0) {
+        console.log(`Deep concept links: ${result.deepLinks} (--deep)`);
+    }
+}
+//# sourceMappingURL=llm-summary.js.map

package/dist/commands/llm-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-summary.js","sourceRoot":"","sources":["../../src/commands/llm-summary.ts"],"names":[],"mappings":";;AAcA,0CAeC;AAfD,SAAgB,eAAe,CAAC,MAA6B;IAC3D,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,cAAc,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,OAAO,CAAC,GAAG,CACT,cAAc,MAAM,CAAC,WAAW,eAAe,MAAM,CAAC,cAAc,SAAS,MAAM,CAAC,eAAe,cAAc,MAAM,EAAE,CAC1H,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,kBAAkB,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,iBAAiB,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,MAAM,MAAM,GAAG,MAAM,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,iBAAiB,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3G,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,kBAAkB,GAAG,MAAM,GAAG,MAAM,wBAAwB,CAAC,CAAC;IAC3G,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,SAAS,WAAW,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/commands/map.d.ts

@@ -2,5 +2,6 @@ export declare function mapCommand(opts: {
     graph: string;
     budget: string;
     detail?: string;
+    json?: boolean;
 }): Promise<void>;
 //# sourceMappingURL=map.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/commands/map.ts"],"names":[],"mappings":"AAEA,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,iBASA"}
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/commands/map.ts"],"names":[],"mappings":"AAEA,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,iBAaA"}

package/dist/commands/map.js

@@ -6,6 +6,10 @@ async function mapCommand(opts) {
     try {
         const budget = parseInt(opts.budget || '2000', 10);
         const result = (0, native_1.repoMap)(opts.graph, budget, opts.detail);
+        if (opts.json) {
+            console.log(JSON.stringify({ filesShown: result.filesShown, text: result.text }, null, 2));
+            return;
+        }
         console.log(result.text);
     }
     catch (e) {

package/dist/commands/map.js.map

@@ -1 +1 @@
-{"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/commands/map.ts"],"names":[],"mappings":";;AAEA,gCAaC;AAfD,sCAAoC;AAE7B,KAAK,UAAU,UAAU,CAAC,IAIhC;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAA,gBAAO,EAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/commands/map.ts"],"names":[],"mappings":";;AAEA,gCAkBC;AApBD,sCAAoC;AAE7B,KAAK,UAAU,UAAU,CAAC,IAKhC;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAA,gBAAO,EAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3F,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/neighbors.d.ts

@@ -0,0 +1,6 @@
+export declare function neighborsCommand(node: string, opts: {
+    graph: string;
+    relation?: string;
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=neighbors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"neighbors.d.ts","sourceRoot":"","sources":["../../src/commands/neighbors.ts"],"names":[],"mappings":"AAEA,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,iBA0C3D"}

package/dist/commands/neighbors.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.neighborsCommand = neighborsCommand;
+const native_1 = require("../native");
+async function neighborsCommand(node, opts) {
+    try {
+        const result = (0, native_1.explainNode)(opts.graph, node);
+        if (!result) {
+            console.error(`Node not found: ${node}`);
+            process.exitCode = 1;
+            return;
+        }
+        const neighbors = opts.relation
+            ? result.neighbors.filter((n) => n.relation === opts.relation)
+            : result.neighbors;
+        if (opts.json) {
+            console.log(JSON.stringify({ node: result.label, id: result.id, file: result.sourceFile, neighbors }, null, 2));
+            return;
+        }
+        const filter = opts.relation ? ` via ${opts.relation}` : '';
+        console.log(`Neighbors of ${result.label} (${neighbors.length}${filter}):`);
+        if (neighbors.length === 0) {
+            console.log('  (no matching neighbors)');
+            return;
+        }
+        for (const n of neighbors) {
+            const loc = n.neighborLine != null ? ` (${n.neighborFile}:${n.neighborLine})` : '';
+            console.log(`  ${n.neighborLabel} [${n.relation}]${loc}`);
+        }
+        // The native layer caps the returned list; only the unfiltered view
+        // hides entries.
+        if (!opts.relation && result.neighborCount > result.neighbors.length) {
+            const remaining = result.neighborCount - result.neighbors.length;
+            console.log(`  ... and ${remaining} more`);
+        }
+    }
+    catch (e) {
+        console.error(`Error: ${e.message || e}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=neighbors.js.map

package/dist/commands/neighbors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neighbors.js","sourceRoot":"","sources":["../../src/commands/neighbors.ts"],"names":[],"mappings":";;AAEA,4CA4CC;AA9CD,sCAAwC;AAEjC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,IAA0D;IAE1D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ;YAC7B,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC;YACnE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;QACrB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,EACzE,IAAI,EACJ,CAAC,CACF,CACF,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC;QAC5E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,oEAAoE;QACpE,iBAAiB;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACrE,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,aAAa,SAAS,OAAO,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/path.d.ts

@@ -2,5 +2,6 @@ export declare function pathCommand(source: string, target: string, opts: {
     graph: string;
     directed?: boolean;
     detail?: string;
+    json?: boolean;
 }): Promise<void>;
 //# sourceMappingURL=path.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/commands/path.ts"],"names":[],"mappings":"AAEA,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,iBAYA"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/commands/path.ts"],"names":[],"mappings":"AAEA,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,iBAkBA"}

package/dist/commands/path.js

@@ -5,8 +5,8 @@ const native_1 = require("../native");
 async function pathCommand(source, target, opts) {
     try {
         const result = (0, native_1.findPath)(opts.graph, source, target, opts.directed ?? false, opts.detail);
-        if (!result.found) {
-            console.log(result.text);
+        if (opts.json) {
+            console.log(JSON.stringify({ source, target, found: result.found, hops: result.hops, text: result.text }, null, 2));
             return;
         }
         console.log(result.text);

package/dist/commands/path.js.map

@@ -1 +1 @@
-{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/commands/path.ts"],"names":[],"mappings":";;AAEA,kCAgBC;AAlBD,sCAAqC;AAE9B,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,MAAc,EAAE,IAIjE;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,iBAAQ,EAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACzF,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/commands/path.ts"],"names":[],"mappings":";;AAEA,kCAuBC;AAzBD,sCAAqC;AAE9B,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,MAAc,EAAE,IAKjE;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,iBAAQ,EAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACzF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAC7E,IAAI,EACJ,CAAC,CACF,CACF,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/query.d.ts

@@ -6,5 +6,7 @@ export declare function queryCommand(question: string, opts: {
     directed?: boolean;
     detail?: string;
     cursor?: string;
+    noEmbed?: boolean;
+    json?: boolean;
 }): Promise<void>;
 //# sourceMappingURL=query.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAEA,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,iBAwBA"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAEA,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,iBA8CA"}