@nodesify/astria 1.0.0 → 1.0.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Nodesify
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Nodesify
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,65 +1,65 @@
-# @nodesify/astria
-
-Turn any folder into a queryable knowledge graph.
-
-## Install
-
-```bash
-npm install -g @nodesify/astria
-```
-
-Requires Node.js >= 20. 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.
-
-## Usage
-
-```bash
-astria run <path>                            # Full pipeline: detect → extract → build → cluster → analyze → report
-astria update <path>                         # Incremental rebuild (only changed files)
-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
-astria path <A> <B> [--graph .]              # Shortest path between two concepts
-astria stats [--graph .]                     # Node/edge/community counts
-astria export [--graph .] [--out graph.json] [--format json|html|graphml] [--mode standard|large] # Export graph; HTML defaults to standard
-astria merge <pathA> <pathB> <outPath>       # Merge two graphs
-astria diff <pathA> <pathB>                  # Compare two graphs
-astria history [--limit 20] [--graph .]      # Show recent query history
-astria install [--platform claude]           # Install skill files for AI coding assistants
-astria hook install                          # Install git post-commit/post-checkout hooks
-```
-
-Running `astria run .` creates `.astria/` with:
-
-- `db.sqlite` — the graph database
-- `graph.json` — full graph export
-- `graph_report.md` — report with hub nodes, communities, surprising connections
-
-### 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:
-
-```bash
-astria export --graph . --format html --mode large --out graph-view.html
-```
-
-Large mode uses precomputed positions and disabled physics, starts with key nodes visible, and provides debounced search plus a “Show all nodes” toggle. The `--mode` option only affects HTML export; JSON and GraphML remain unchanged.
-
-## Supported languages
-
-Python, JavaScript, TypeScript, Rust, Go, Java, C, C++, Ruby, Swift, Scala, PHP, C#, Lua, Haskell, Elixir, Bash, Dart, Zig, CSS.
-
-## AI platform integration
-
-```bash
-astria install --platform claude   # or: codex, gemini, cursor, copilot, aider, opencode, kiro, trae, zcode
-```
-
-## .astriaignore
-
-Place a `.astriaignore` file in your project root (gitignore syntax) to exclude files from the graph.
-
-## License
-
-MIT
+# @nodesify/astria
+
+Turn any folder into a queryable knowledge graph.
+
+## Install
+
+```bash
+npm install -g @nodesify/astria
+```
+
+Requires Node.js >= 20. 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.
+
+## Usage
+
+```bash
+astria run <path>                            # Full pipeline: detect → extract → build → cluster → analyze → report
+astria update <path>                         # Incremental rebuild (only changed files)
+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
+astria path <A> <B> [--graph .]              # Shortest path between two concepts
+astria stats [--graph .]                     # Node/edge/community counts
+astria export [--graph .] [--out graph.json] [--format json|html|graphml] [--mode standard|large] # Export graph; HTML defaults to standard
+astria merge <pathA> <pathB> <outPath>       # Merge two graphs
+astria diff <pathA> <pathB>                  # Compare two graphs
+astria history [--limit 20] [--graph .]      # Show recent query history
+astria install [--platform claude]           # Install skill files for AI coding assistants
+astria hook install                          # Install git post-commit/post-checkout hooks
+```
+
+Running `astria run .` creates `.astria/` with:
+
+- `db.sqlite` — the graph database
+- `graph.json` — full graph export
+- `graph_report.md` — report with hub nodes, communities, surprising connections
+
+### 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:
+
+```bash
+astria export --graph . --format html --mode large --out graph-view.html
+```
+
+Large mode uses precomputed positions and disabled physics, starts with key nodes visible, and provides debounced search plus a “Show all nodes” toggle. The `--mode` option only affects HTML export; JSON and GraphML remain unchanged.
+
+## Supported languages
+
+Python, JavaScript, TypeScript, Rust, Go, Java, C, C++, Ruby, Swift, Scala, PHP, C#, Lua, Haskell, Elixir, Bash, Dart, Zig, CSS.
+
+## AI platform integration
+
+```bash
+astria install --platform claude   # or: codex, gemini, cursor, copilot, aider, opencode, kiro, trae, zcode
+```
+
+## .astriaignore
+
+Place a `.astriaignore` file in your project root (gitignore syntax) to exclude files from the graph.
+
+## License
+
+MIT

package/dist/commands/add.d.ts

@@ -1,8 +1,8 @@
-export declare function addCommand(url: string, opts: {
-    graph: string;
-    author?: string;
-    contributor?: string;
-    scip?: string;
-    postgres?: string;
-}): Promise<void>;
+export declare function addCommand(url: string, opts: {
+    graph: string;
+    author?: string;
+    contributor?: string;
+    scip?: string;
+    postgres?: string;
+}): Promise<void>;
 //# sourceMappingURL=add.d.ts.map

package/dist/commands/add.js

@@ -1,34 +1,34 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addCommand = addCommand;
-const native_1 = require("../native");
-async function addCommand(url, opts) {
-    if (!url && !opts.scip && !opts.postgres) {
-        console.error('Error: provide a URL, or --scip <file>, or --postgres <dsn>');
-        process.exitCode = 1;
-        return;
-    }
-    try {
-        if (opts.scip) {
-            const counts = (0, native_1.ingestScip)(opts.graph, opts.scip);
-            console.log(`SCIP index ingested: ${counts.nodesAdded} nodes, ${counts.edgesAdded} edges`);
-            return;
-        }
-        if (opts.postgres) {
-            const counts = (0, native_1.ingestPostgres)(opts.graph, opts.postgres);
-            console.log(`Postgres schema ingested: ${counts.nodesAdded} nodes, ${counts.edgesAdded} edges`);
-            return;
-        }
-        console.log(`Fetching ${url}...`);
-        const result = (0, native_1.ingestUrl)(opts.graph, url, opts.author, opts.contributor);
-        console.log(`Saved: ${result.savedPath}`);
-        if (result.graphUpdated) {
-            console.log('Graph updated with the new content.');
-        }
-    }
-    catch (e) {
-        console.error(`Error: ${e.message || e}`);
-        process.exitCode = 1;
-    }
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addCommand = addCommand;
+const native_1 = require("../native");
+async function addCommand(url, opts) {
+    if (!url && !opts.scip && !opts.postgres) {
+        console.error('Error: provide a URL, or --scip <file>, or --postgres <dsn>');
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        if (opts.scip) {
+            const counts = (0, native_1.ingestScip)(opts.graph, opts.scip);
+            console.log(`SCIP index ingested: ${counts.nodesAdded} nodes, ${counts.edgesAdded} edges`);
+            return;
+        }
+        if (opts.postgres) {
+            const counts = (0, native_1.ingestPostgres)(opts.graph, opts.postgres);
+            console.log(`Postgres schema ingested: ${counts.nodesAdded} nodes, ${counts.edgesAdded} edges`);
+            return;
+        }
+        console.log(`Fetching ${url}...`);
+        const result = (0, native_1.ingestUrl)(opts.graph, url, opts.author, opts.contributor);
+        console.log(`Saved: ${result.savedPath}`);
+        if (result.graphUpdated) {
+            console.log('Graph updated with the new content.');
+        }
+    }
+    catch (e) {
+        console.error(`Error: ${e.message || e}`);
+        process.exitCode = 1;
+    }
+}
 //# sourceMappingURL=add.js.map

package/dist/commands/affected.d.ts

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

package/dist/commands/affected.js

@@ -1,30 +1,30 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.affectedCommand = affectedCommand;
-const native_1 = require("../native");
-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 (result.total === 0) {
-            console.log(`Nothing references "${result.seedLabel}" — no blast radius.`);
-            return;
-        }
-        console.log(`Blast radius of "${result.seedLabel}" (depth ≤ ${depth}): ${result.total} node(s)`);
-        console.log();
-        let lastDepth = 0;
-        for (const hit of result.hits) {
-            if (hit.depth !== lastDepth) {
-                lastDepth = hit.depth;
-                console.log(`  depth ${hit.depth}:`);
-            }
-            const via = hit.viaFile ? `  [${hit.viaFile}]` : '';
-            console.log(`    ${hit.label} (${hit.relation})${via}`);
-        }
-    }
-    catch (e) {
-        console.error(`Error: ${e.message || e}`);
-        process.exitCode = 1;
-    }
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.affectedCommand = affectedCommand;
+const native_1 = require("../native");
+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 (result.total === 0) {
+            console.log(`Nothing references "${result.seedLabel}" — no blast radius.`);
+            return;
+        }
+        console.log(`Blast radius of "${result.seedLabel}" (depth ≤ ${depth}): ${result.total} node(s)`);
+        console.log();
+        let lastDepth = 0;
+        for (const hit of result.hits) {
+            if (hit.depth !== lastDepth) {
+                lastDepth = hit.depth;
+                console.log(`  depth ${hit.depth}:`);
+            }
+            const via = hit.viaFile ? `  [${hit.viaFile}]` : '';
+            console.log(`    ${hit.label} (${hit.relation})${via}`);
+        }
+    }
+    catch (e) {
+        console.error(`Error: ${e.message || e}`);
+        process.exitCode = 1;
+    }
+}
 //# sourceMappingURL=affected.js.map

package/dist/commands/cluster.d.ts

@@ -1,2 +1,2 @@
-export declare function clusterCommand(path: string): Promise<void>;
+export declare function clusterCommand(path: string): Promise<void>;
 //# sourceMappingURL=cluster.d.ts.map

package/dist/commands/cluster.js

@@ -1,51 +1,51 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.clusterCommand = clusterCommand;
-const pathMod = __importStar(require("path"));
-const native_1 = require("../native");
-async function clusterCommand(path) {
-    try {
-        console.log(`Running cluster + analyze on: ${path}`);
-        const result = (0, native_1.clusterOnly)(path);
-        console.log(`Communities: ${result.communities}`);
-        console.log(`Report updated at: ${pathMod.join(path, '.astria', 'graph_report.md')}`);
-    }
-    catch (e) {
-        console.error(`Error: ${e.message || e}`);
-        process.exitCode = 1;
-    }
-}
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clusterCommand = clusterCommand;
+const pathMod = __importStar(require("path"));
+const native_1 = require("../native");
+async function clusterCommand(path) {
+    try {
+        console.log(`Running cluster + analyze on: ${path}`);
+        const result = (0, native_1.clusterOnly)(path);
+        console.log(`Communities: ${result.communities}`);
+        console.log(`Report updated at: ${pathMod.join(path, '.astria', 'graph_report.md')}`);
+    }
+    catch (e) {
+        console.error(`Error: ${e.message || e}`);
+        process.exitCode = 1;
+    }
+}
 //# sourceMappingURL=cluster.js.map

package/dist/commands/diagnose.d.ts

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

package/dist/commands/diagnose.js

@@ -1,20 +1,20 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.diagnoseCommand = diagnoseCommand;
-const native_1 = require("../native");
-async function diagnoseCommand(opts) {
-    try {
-        const report = (0, native_1.diagnoseGraph)(opts.graph);
-        if (opts.json) {
-            const { text: _text, ...rest } = report;
-            console.log(JSON.stringify(rest, null, 2));
-            return;
-        }
-        console.log(report.text);
-    }
-    catch (e) {
-        console.error(`Error: ${e.message || e}`);
-        process.exitCode = 1;
-    }
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diagnoseCommand = diagnoseCommand;
+const native_1 = require("../native");
+async function diagnoseCommand(opts) {
+    try {
+        const report = (0, native_1.diagnoseGraph)(opts.graph);
+        if (opts.json) {
+            const { text: _text, ...rest } = report;
+            console.log(JSON.stringify(rest, null, 2));
+            return;
+        }
+        console.log(report.text);
+    }
+    catch (e) {
+        console.error(`Error: ${e.message || e}`);
+        process.exitCode = 1;
+    }
+}
 //# sourceMappingURL=diagnose.js.map

package/dist/commands/diff.d.ts

@@ -1,2 +1,2 @@
-export declare function diffCommand(pathA: string, pathB: string): Promise<void>;
+export declare function diffCommand(pathA: string, pathB: string): Promise<void>;
 //# sourceMappingURL=diff.d.ts.map

package/dist/commands/diff.js

@@ -1,36 +1,36 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.diffCommand = diffCommand;
-const native_1 = require("../native");
-async function diffCommand(pathA, pathB) {
-    try {
-        const result = (0, native_1.diffGraphs)(pathA, pathB);
-        console.log(`Nodes added: ${result.nodesAdded}`);
-        console.log(`Nodes removed: ${result.nodesRemoved}`);
-        console.log(`Edges added: ${result.edgesAdded}`);
-        console.log(`Edges removed: ${result.edgesRemoved}`);
-        if (result.addedNodeLabels.length > 0) {
-            console.log('\nAdded nodes:');
-            for (const label of result.addedNodeLabels.slice(0, 20)) {
-                console.log(`  + ${label}`);
-            }
-            if (result.addedNodeLabels.length > 20) {
-                console.log(`  ... and ${result.addedNodeLabels.length - 20} more`);
-            }
-        }
-        if (result.removedNodeLabels.length > 0) {
-            console.log('\nRemoved nodes:');
-            for (const label of result.removedNodeLabels.slice(0, 20)) {
-                console.log(`  - ${label}`);
-            }
-            if (result.removedNodeLabels.length > 20) {
-                console.log(`  ... and ${result.removedNodeLabels.length - 20} more`);
-            }
-        }
-    }
-    catch (e) {
-        console.error(`Error: ${e.message || e}`);
-        process.exitCode = 1;
-    }
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffCommand = diffCommand;
+const native_1 = require("../native");
+async function diffCommand(pathA, pathB) {
+    try {
+        const result = (0, native_1.diffGraphs)(pathA, pathB);
+        console.log(`Nodes added: ${result.nodesAdded}`);
+        console.log(`Nodes removed: ${result.nodesRemoved}`);
+        console.log(`Edges added: ${result.edgesAdded}`);
+        console.log(`Edges removed: ${result.edgesRemoved}`);
+        if (result.addedNodeLabels.length > 0) {
+            console.log('\nAdded nodes:');
+            for (const label of result.addedNodeLabels.slice(0, 20)) {
+                console.log(`  + ${label}`);
+            }
+            if (result.addedNodeLabels.length > 20) {
+                console.log(`  ... and ${result.addedNodeLabels.length - 20} more`);
+            }
+        }
+        if (result.removedNodeLabels.length > 0) {
+            console.log('\nRemoved nodes:');
+            for (const label of result.removedNodeLabels.slice(0, 20)) {
+                console.log(`  - ${label}`);
+            }
+            if (result.removedNodeLabels.length > 20) {
+                console.log(`  ... and ${result.removedNodeLabels.length - 20} more`);
+            }
+        }
+    }
+    catch (e) {
+        console.error(`Error: ${e.message || e}`);
+        process.exitCode = 1;
+    }
+}
 //# sourceMappingURL=diff.js.map

package/dist/commands/explain.d.ts

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