@nodesify/astria 1.0.0 → 1.0.1

package/dist/native.d.ts

@@ -1,32 +1,32 @@
-export declare const runPipeline: any;
-export declare const updatePipeline: any;
-export declare const graphStats: any;
-export declare const explainNode: any;
-export declare const exportJsonCmd: any;
-export declare const exportHtmlCmd: any;
-export declare const exportGraphmlCmd: any;
-export declare const exportCypherCmd: any;
-export declare const tokenBenchmark: any;
-export declare const queryGraph: any;
-export declare const repoMap: any;
-export declare const findPath: any;
-export declare const clusterOnly: any;
-export declare const mergeGraphs: any;
-export declare const diffGraphs: any;
-export declare const graphHistory: any;
-export declare const affectedNode: any;
-export declare const runMcpServer: any;
-export declare const exportTree: any;
-export declare const exportWiki: any;
-export declare const exportObsidian: any;
-export declare const ingestUrl: any;
-export declare const diagnoseGraph: any;
-export declare const saveQueryResult: any;
-export declare const reflectGraph: any;
-export declare const globalAdd: any;
-export declare const globalRemove: any;
-export declare const globalList: any;
-export declare const globalPath: any;
-export declare const ingestScip: any;
-export declare const ingestPostgres: any;
+export declare const runPipeline: any;
+export declare const updatePipeline: any;
+export declare const graphStats: any;
+export declare const explainNode: any;
+export declare const exportJsonCmd: any;
+export declare const exportHtmlCmd: any;
+export declare const exportGraphmlCmd: any;
+export declare const exportCypherCmd: any;
+export declare const tokenBenchmark: any;
+export declare const queryGraph: any;
+export declare const repoMap: any;
+export declare const findPath: any;
+export declare const clusterOnly: any;
+export declare const mergeGraphs: any;
+export declare const diffGraphs: any;
+export declare const graphHistory: any;
+export declare const affectedNode: any;
+export declare const runMcpServer: any;
+export declare const exportTree: any;
+export declare const exportWiki: any;
+export declare const exportObsidian: any;
+export declare const ingestUrl: any;
+export declare const diagnoseGraph: any;
+export declare const saveQueryResult: any;
+export declare const reflectGraph: any;
+export declare const globalAdd: any;
+export declare const globalRemove: any;
+export declare const globalList: any;
+export declare const globalPath: any;
+export declare const ingestScip: any;
+export declare const ingestPostgres: any;
 //# sourceMappingURL=native.d.ts.map

package/dist/native.js

@@ -1,107 +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;
+"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/package.json

@@ -1,72 +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"
-  }
-}
+{
+  "name": "@nodesify/astria",
+  "version": "1.0.1",
+  "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.1",
+    "@nodesify/astria-darwin-x64": "1.0.1",
+    "@nodesify/astria-linux-x64-gnu": "1.0.1",
+    "@nodesify/astria-darwin-arm64": "1.0.1",
+    "@nodesify/astria-linux-arm64-gnu": "1.0.1"
+  }
+}

package/skills/skill-aider.md

@@ -1,40 +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.
+---
+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

@@ -1,46 +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.
+---
+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.