@nodesify/astria 1.0.0

package/dist/native.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ingestPostgres = exports.ingestScip = exports.globalPath = exports.globalList = exports.globalRemove = exports.globalAdd = exports.reflectGraph = exports.saveQueryResult = exports.diagnoseGraph = exports.ingestUrl = exports.exportObsidian = exports.exportWiki = exports.exportTree = exports.runMcpServer = exports.affectedNode = exports.graphHistory = exports.diffGraphs = exports.mergeGraphs = exports.clusterOnly = exports.findPath = exports.repoMap = exports.queryGraph = exports.tokenBenchmark = exports.exportCypherCmd = exports.exportGraphmlCmd = exports.exportHtmlCmd = exports.exportJsonCmd = exports.explainNode = exports.graphStats = exports.updatePipeline = exports.runPipeline = void 0;
+const path_1 = require("path");
+const fs_1 = require("fs");
+const PLATFORM_SUFFIX = {
+    'win32-x64': 'win32-x64-msvc',
+    'darwin-x64': 'darwin-x64',
+    'darwin-arm64': 'darwin-arm64',
+    'linux-x64': 'linux-x64-gnu',
+    'linux-arm64': 'linux-arm64-gnu',
+};
+function isMusl() {
+    try {
+        const { execFileSync } = require('child_process');
+        // execFileSync never invokes a shell: ldd runs with a fixed arg vector.
+        const out = execFileSync('ldd', ['--version'], { encoding: 'utf-8' });
+        return out.includes('musl');
+    }
+    catch {
+        return false;
+    }
+}
+function getPlatformSuffix() {
+    if (process.platform === 'linux' && isMusl()) {
+        return `linux-${process.arch}-musl`;
+    }
+    return PLATFORM_SUFFIX[`${process.platform}-${process.arch}`] || `${process.platform}-${process.arch}`;
+}
+/// Require the fallback platform package for a suffix. Module names are
+/// literal strings in the switch arms — nothing is constructed at runtime —
+/// so require() only ever sees fixed, known package names.
+function requirePlatformPackage(suffix) {
+    switch (suffix) {
+        case 'win32-x64-msvc':
+            return require('@nodesify/astria-win32-x64-msvc');
+        case 'darwin-x64':
+            return require('@nodesify/astria-darwin-x64');
+        case 'darwin-arm64':
+            return require('@nodesify/astria-darwin-arm64');
+        case 'linux-x64-gnu':
+            return require('@nodesify/astria-linux-x64-gnu');
+        case 'linux-arm64-gnu':
+            return require('@nodesify/astria-linux-arm64-gnu');
+        case 'linux-x64-musl':
+            return require('@nodesify/astria-linux-x64-musl');
+        case 'linux-arm64-musl':
+            return require('@nodesify/astria-linux-arm64-musl');
+        default:
+            return undefined;
+    }
+}
+/// Local candidates are fixed paths relative to this module; each require()
+/// below uses a literal relative specifier, guarded by existsSync so a
+/// missing binary never throws at load time.
+function loadNativeBinding() {
+    const local = (0, path_1.join)(__dirname, '..', 'astria.node');
+    if ((0, fs_1.existsSync)(local))
+        return require('../astria.node');
+    // tsx runs tests from src/, where CI's built binary lands in dist/
+    const localDist = (0, path_1.join)(__dirname, '..', 'dist', 'astria.node');
+    if ((0, fs_1.existsSync)(localDist))
+        return require('../dist/astria.node');
+    const localSrc = (0, path_1.join)(__dirname, 'astria.node');
+    if ((0, fs_1.existsSync)(localSrc))
+        return require('./astria.node');
+    const platformBinding = requirePlatformPackage(getPlatformSuffix());
+    if (platformBinding) {
+        return platformBinding;
+    }
+    throw new Error(`@nodesify/astria: failed to load native module for ${process.platform}-${process.arch}.\n` +
+        `Tried: local astria.node and the platform fallback package\n` +
+        `Ensure the correct platform package is installed.`);
+}
+const binding = loadNativeBinding();
+exports.runPipeline = binding.runPipeline;
+exports.updatePipeline = binding.updatePipeline;
+exports.graphStats = binding.graphStats;
+exports.explainNode = binding.explainNode;
+exports.exportJsonCmd = binding.exportJsonCmd;
+exports.exportHtmlCmd = binding.exportHtmlCmd;
+exports.exportGraphmlCmd = binding.exportGraphmlCmd;
+exports.exportCypherCmd = binding.exportCypherCmd;
+exports.tokenBenchmark = binding.tokenBenchmark;
+exports.queryGraph = binding.queryGraph;
+exports.repoMap = binding.repoMap;
+exports.findPath = binding.findPath;
+exports.clusterOnly = binding.clusterOnly;
+exports.mergeGraphs = binding.mergeGraphs;
+exports.diffGraphs = binding.diffGraphs;
+exports.graphHistory = binding.graphHistory;
+exports.affectedNode = binding.affectedNode;
+exports.runMcpServer = binding.runMcpServer;
+exports.exportTree = binding.exportTree;
+exports.exportWiki = binding.exportWiki;
+exports.exportObsidian = binding.exportObsidian;
+exports.ingestUrl = binding.ingestUrl;
+exports.diagnoseGraph = binding.diagnoseGraph;
+exports.saveQueryResult = binding.saveQueryResult;
+exports.reflectGraph = binding.reflect;
+exports.globalAdd = binding.globalAdd;
+exports.globalRemove = binding.globalRemove;
+exports.globalList = binding.globalList;
+exports.globalPath = binding.globalPath;
+exports.ingestScip = binding.ingestScip;
+exports.ingestPostgres = binding.ingestPostgres;
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

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

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@nodesify/astria",
+  "version": "1.0.0",
+  "description": "Turn any folder into a queryable knowledge graph",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "astria": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "!dist/__tests__/**",
+    "skills/**/*",
+    "README.md",
+    "LICENSE",
+    "!dist/astria.node"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "napi:build": "napi build --platform --release dist",
+    "napi:dev": "napi build --platform dist",
+    "napi:artifacts": "napi artifacts",
+    "prepublishOnly": "napi prepublish -t npm",
+    "test": "npx tsx src/__tests__/cli.test.ts && npx tsx src/__tests__/install.test.ts && npx tsx src/__tests__/hooks.test.ts && npx tsx src/__tests__/e2e.test.ts"
+  },
+  "keywords": [
+    "knowledge-graph",
+    "code-analysis",
+    "tree-sitter",
+    "ast",
+    "code-intelligence"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nodesify/astria.git"
+  },
+  "homepage": "https://github.com/Nodesify/astria#readme",
+  "bugs": {
+    "url": "https://github.com/Nodesify/astria/issues"
+  },
+  "dependencies": {
+    "commander": "^12"
+  },
+  "devDependencies": {
+    "tsx": "^4",
+    "typescript": "^5",
+    "@types/node": "^22",
+    "@napi-rs/cli": "^2.18.4"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "napi": {
+    "name": "astria",
+    "triples": {
+      "defaults": true,
+      "additional": [
+        "aarch64-apple-darwin",
+        "aarch64-unknown-linux-gnu"
+      ]
+    }
+  },
+  "optionalDependencies": {
+    "@nodesify/astria-win32-x64-msvc": "1.0.0",
+    "@nodesify/astria-darwin-x64": "1.0.0",
+    "@nodesify/astria-linux-x64-gnu": "1.0.0",
+    "@nodesify/astria-darwin-arm64": "1.0.0",
+    "@nodesify/astria-linux-arm64-gnu": "1.0.0"
+  }
+}

package/skills/skill-aider.md

@@ -0,0 +1,40 @@
+---
+name: astria
+description: Turn any directory into a queryable knowledge graph. Trigger: /astria
+---
+
+# astria skill (Aider)
+
+When the user types `/astria`, run the astria knowledge graph pipeline.
+
+## Step 1 - Build or update the graph
+
+Run in terminal:
+```bash
+node -e "const fs=require('fs');if(!fs.existsSync('.astria/graph.json')){console.log('missing')}else{const age=Math.round((Date.now()-fs.statSync('.astria/graph.json').mtimeMs)/60000);console.log(age>30?'stale':'fresh')}"
+```
+
+- `missing` → run `astria run .`
+- `stale` → run `astria update .`
+- `fresh` → skip to Step 2
+
+## Step 2 - Read the report
+
+Read `.astria/graph_report.md` and summarize: hub nodes, communities, surprising connections.
+## Prefer MCP tools when connected
+
+If the `astria` MCP server is connected (registered by `astria install` for claude, cursor, gemini, and zcode), prefer its native tools over shell commands: `repo_map` to orient, `query_graph` for a natural-language question, `explain`/`get_neighbors` for one symbol, `shortest_path` to trace a connection, `affected` before changing a shared symbol. Use the CLI commands below only when the server is not connected.
+
+
+## Usage with Aider
+
+Aider focuses on code editing. Use astria to understand the codebase before making changes:
+
+```bash
+astria query "authentication flow"    # understand a feature
+astria explain "UserService"           # see what a class does
+astria path "Config" "Database"        # trace dependencies
+astria affected "UserService"          # blast radius of a change
+```
+
+After editing, run `astria update .` to keep the graph current.

package/skills/skill-codex.md

@@ -0,0 +1,46 @@
+---
+name: astria
+description: Turn any directory into a queryable knowledge graph. Trigger: /astria
+---
+
+# astria skill (Codex)
+
+When the user types `/astria`, run the astria knowledge graph pipeline.
+
+## Step 1 - Build or update the graph
+
+Run via Bash:
+```bash
+node -e "const fs=require('fs');if(!fs.existsSync('.astria/graph.json')){console.log('missing')}else{const age=Math.round((Date.now()-fs.statSync('.astria/graph.json').mtimeMs)/60000);console.log(age>30?'stale':'fresh')}"
+```
+
+- `missing` → run `astria run .`
+- `stale` → run `astria update .`
+- `fresh` → skip to Step 2
+
+## Step 2 - Read the report
+
+Read `.astria/graph_report.md` and summarize: hub nodes, communities, surprising connections.
+## Prefer MCP tools when connected
+
+If the `astria` MCP server is connected (registered by `astria install` for claude, cursor, gemini, and zcode), prefer its native tools over shell commands: `repo_map` to orient, `query_graph` for a natural-language question, `explain`/`get_neighbors` for one symbol, `shortest_path` to trace a connection, `affected` before changing a shared symbol. Use the CLI commands below only when the server is not connected.
+
+
+## Enforcement Rules
+
+When `.astria/` exists, you MUST use astria commands BEFORE using Bash grep/find:
+
+| Question | Command |
+|----------|---------|
+| Where is X? | `astria query "X"` |
+| How does X connect to Y? | `astria path "X" "Y"` |
+| What breaks if X changes? | `astria affected "X"` |
+| How does X reach Y (call direction)? | `astria path "X" "Y" --directed` |
+| What does X do? | `astria explain "X"` |
+| Architecture overview? | Read `.astria/graph_report.md` |
+
+Only use native file tools AFTER the graph identified the exact files.
+
+## After editing code
+
+Run `astria update .` to keep the graph current.

package/skills/skill-copilot.md

@@ -0,0 +1,46 @@
+---
+name: astria
+description: Turn any directory into a queryable knowledge graph. Trigger: /astria
+---
+
+# astria skill (GitHub Copilot)
+
+When the user types `/astria`, run the astria knowledge graph pipeline.
+
+## Step 1 - Build or update the graph
+
+Run via terminal:
+```bash
+node -e "const fs=require('fs');if(!fs.existsSync('.astria/graph.json')){console.log('missing')}else{const age=Math.round((Date.now()-fs.statSync('.astria/graph.json').mtimeMs)/60000);console.log(age>30?'stale':'fresh')}"
+```
+
+- `missing` → run `astria run .`
+- `stale` → run `astria update .`
+- `fresh` → skip to Step 2
+
+## Step 2 - Read the report
+
+Read `.astria/graph_report.md` and summarize: hub nodes, communities, surprising connections.
+## Prefer MCP tools when connected
+
+If the `astria` MCP server is connected (registered by `astria install` for claude, cursor, gemini, and zcode), prefer its native tools over shell commands: `repo_map` to orient, `query_graph` for a natural-language question, `explain`/`get_neighbors` for one symbol, `shortest_path` to trace a connection, `affected` before changing a shared symbol. Use the CLI commands below only when the server is not connected.
+
+
+## Enforcement Rules
+
+When `.astria/` exists, you MUST use astria commands BEFORE searching files:
+
+| Question | Command |
+|----------|---------|
+| Where is X? | `astria query "X"` |
+| How does X connect to Y? | `astria path "X" "Y"` |
+| What breaks if X changes? | `astria affected "X"` |
+| How does X reach Y (call direction)? | `astria path "X" "Y" --directed` |
+| What does X do? | `astria explain "X"` |
+| Architecture overview? | Read `.astria/graph_report.md` |
+
+Copilot Chat with `.github/copilot-instructions.md` will reference these rules.
+
+## After editing code
+
+Run `astria update .` to keep the graph current.

package/skills/skill-cursor.md

@@ -0,0 +1,39 @@
+---
+name: astria
+description: Turn any directory into a queryable knowledge graph. Trigger: /astria
+---
+
+# astria skill (Cursor)
+
+When the user types `/astria`, run the astria knowledge graph pipeline.
+
+## Step 1 - Build or update the graph
+
+Run via terminal:
+```bash
+node -e "const fs=require('fs');if(!fs.existsSync('.astria/graph.json')){console.log('missing')}else{const age=Math.round((Date.now()-fs.statSync('.astria/graph.json').mtimeMs)/60000);console.log(age>30?'stale':'fresh')}"
+```
+
+- `missing` → run `astria run .`
+- `stale` → run `astria update .`
+- `fresh` → skip to Step 2
+
+## Step 2 - Read the report
+
+Read `.astria/graph_report.md` and summarize: hub nodes, communities, surprising connections.
+## Prefer MCP tools when connected
+
+If the `astria` MCP server is connected (registered by `astria install` for claude, cursor, gemini, and zcode), prefer its native tools over shell commands: `repo_map` to orient, `query_graph` for a natural-language question, `explain`/`get_neighbors` for one symbol, `shortest_path` to trace a connection, `affected` before changing a shared symbol. Use the CLI commands below only when the server is not connected.
+
+
+## Enforcement Rules
+
+When `.astria/` exists, the `.cursor/rules/astria.mdc` rule enforces graph usage. You MUST:
+
+1. Read `.astria/graph_report.md` before searching files
+2. Use `astria query`, `path` (add `--directed` for call direction), `explain`, or `affected` for cross-module questions
+3. Only use native file tools AFTER the graph identified the exact files
+
+## After editing code
+
+Run `astria update .` to keep the graph current.

package/skills/skill-gemini.md

@@ -0,0 +1,46 @@
+---
+name: astria
+description: Turn any directory into a queryable knowledge graph. Trigger: /astria
+---
+
+# astria skill (Gemini)
+
+When the user types `/astria`, run the astria knowledge graph pipeline.
+
+## Step 1 - Build or update the graph
+
+Run via shell:
+```bash
+node -e "const fs=require('fs');if(!fs.existsSync('.astria/graph.json')){console.log('missing')}else{const age=Math.round((Date.now()-fs.statSync('.astria/graph.json').mtimeMs)/60000);console.log(age>30?'stale':'fresh')}"
+```
+
+- `missing` → run `astria run .`
+- `stale` → run `astria update .`
+- `fresh` → skip to Step 2
+
+## Step 2 - Read the report
+
+Read `.astria/graph_report.md` and summarize: hub nodes, communities, surprising connections.
+## Prefer MCP tools when connected
+
+If the `astria` MCP server is connected (registered by `astria install` for claude, cursor, gemini, and zcode), prefer its native tools over shell commands: `repo_map` to orient, `query_graph` for a natural-language question, `explain`/`get_neighbors` for one symbol, `shortest_path` to trace a connection, `affected` before changing a shared symbol. Use the CLI commands below only when the server is not connected.
+
+
+## Enforcement Rules
+
+When `.astria/` exists, you MUST use astria commands BEFORE using `read_file` or `list_directory` for architecture questions:
+
+| Question | Command |
+|----------|---------|
+| Where is X? | `astria query "X"` |
+| How does X connect to Y? | `astria path "X" "Y"` |
+| What breaks if X changes? | `astria affected "X"` |
+| How does X reach Y (call direction)? | `astria path "X" "Y" --directed` |
+| What does X do? | `astria explain "X"` |
+| Architecture overview? | Read `.astria/graph_report.md` |
+
+Only use native file tools AFTER the graph identified the exact files.
+
+## After editing code
+
+Run `astria update .` to keep the graph current.

package/skills/skill-kiro.md

@@ -0,0 +1,39 @@
+---
+name: astria
+description: Turn any directory into a queryable knowledge graph. Trigger: /astria
+---
+
+# astria skill (Kiro)
+
+When the user types `/astria`, run the astria knowledge graph pipeline.
+
+## Step 1 - Build or update the graph
+
+Run via terminal:
+```bash
+node -e "const fs=require('fs');if(!fs.existsSync('.astria/graph.json')){console.log('missing')}else{const age=Math.round((Date.now()-fs.statSync('.astria/graph.json').mtimeMs)/60000);console.log(age>30?'stale':'fresh')}"
+```
+
+- `missing` → run `astria run .`
+- `stale` → run `astria update .`
+- `fresh` → skip to Step 2
+
+## Step 2 - Read the report
+
+Read `.astria/graph_report.md` and summarize: hub nodes, communities, surprising connections.
+## Prefer MCP tools when connected
+
+If the `astria` MCP server is connected (registered by `astria install` for claude, cursor, gemini, and zcode), prefer its native tools over shell commands: `repo_map` to orient, `query_graph` for a natural-language question, `explain`/`get_neighbors` for one symbol, `shortest_path` to trace a connection, `affected` before changing a shared symbol. Use the CLI commands below only when the server is not connected.
+
+
+## Enforcement Rules
+
+The `.kiro/steering/astria.md` steering file enforces graph usage. You MUST:
+
+1. Read `.astria/graph_report.md` before searching files
+2. Use `astria query`, `path` (add `--directed` for call direction), `explain`, or `affected` for cross-module questions
+3. Only use native file tools AFTER the graph identified the exact files
+
+## After editing code
+
+Run `astria update .` to keep the graph current.

package/skills/skill-opencode.md

@@ -0,0 +1,44 @@
+---
+name: astria
+description: Turn any directory into a queryable knowledge graph. Trigger: /astria
+---
+
+# astria skill (OpenCode)
+
+When the user types `/astria`, run the astria knowledge graph pipeline.
+
+## Step 1 - Build or update the graph
+
+Run via bash:
+```bash
+node -e "const fs=require('fs');if(!fs.existsSync('.astria/graph.json')){console.log('missing')}else{const age=Math.round((Date.now()-fs.statSync('.astria/graph.json').mtimeMs)/60000);console.log(age>30?'stale':'fresh')}"
+```
+
+- `missing` → run `astria run .`
+- `stale` → run `astria update .`
+- `fresh` → skip to Step 2
+
+## Step 2 - Read the report
+
+Read `.astria/graph_report.md` and summarize: hub nodes, communities, surprising connections.
+## Prefer MCP tools when connected
+
+If the `astria` MCP server is connected (registered by `astria install` for claude, cursor, gemini, and zcode), prefer its native tools over shell commands: `repo_map` to orient, `query_graph` for a natural-language question, `explain`/`get_neighbors` for one symbol, `shortest_path` to trace a connection, `affected` before changing a shared symbol. Use the CLI commands below only when the server is not connected.
+
+
+## Enforcement Rules
+
+When `.astria/` exists, the astria plugin intercepts `view`, `grep`, `glob`, `ls`, and `bash` tools. You MUST use astria commands first:
+
+| Question | Command |
+|----------|---------|
+| Where is X? | `astria query "X"` |
+| How does X connect to Y? | `astria path "X" "Y"` |
+| What breaks if X changes? | `astria affected "X"` |
+| How does X reach Y (call direction)? | `astria path "X" "Y" --directed` |
+| What does X do? | `astria explain "X"` |
+| Architecture overview? | Read `.astria/graph_report.md` |
+
+## After editing code
+
+Run `astria update .` to keep the graph current.

package/skills/skill-trae.md

@@ -0,0 +1,46 @@
+---
+name: astria
+description: Turn any directory into a queryable knowledge graph. Trigger: /astria
+---
+
+# astria skill (Trae)
+
+When the user types `/astria`, run the astria knowledge graph pipeline.
+
+## Step 1 - Build or update the graph
+
+Run via terminal:
+```bash
+node -e "const fs=require('fs');if(!fs.existsSync('.astria/graph.json')){console.log('missing')}else{const age=Math.round((Date.now()-fs.statSync('.astria/graph.json').mtimeMs)/60000);console.log(age>30?'stale':'fresh')}"
+```
+
+- `missing` → run `astria run .`
+- `stale` → run `astria update .`
+- `fresh` → skip to Step 2
+
+## Step 2 - Read the report
+
+Read `.astria/graph_report.md` and summarize: hub nodes, communities, surprising connections.
+## Prefer MCP tools when connected
+
+If the `astria` MCP server is connected (registered by `astria install` for claude, cursor, gemini, and zcode), prefer its native tools over shell commands: `repo_map` to orient, `query_graph` for a natural-language question, `explain`/`get_neighbors` for one symbol, `shortest_path` to trace a connection, `affected` before changing a shared symbol. Use the CLI commands below only when the server is not connected.
+
+
+## Enforcement Rules
+
+When `.astria/` exists, you MUST use astria commands BEFORE searching files:
+
+| Question | Command |
+|----------|---------|
+| Where is X? | `astria query "X"` |
+| How does X connect to Y? | `astria path "X" "Y"` |
+| What breaks if X changes? | `astria affected "X"` |
+| How does X reach Y (call direction)? | `astria path "X" "Y" --directed` |
+| What does X do? | `astria explain "X"` |
+| Architecture overview? | Read `.astria/graph_report.md` |
+
+Only use native file tools AFTER the graph identified the exact files.
+
+## After editing code
+
+Run `astria update .` to keep the graph current.