@nodesify/astria 1.0.0 → 1.0.2

package/dist/index.js

@@ -1,251 +1,251 @@
 #!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.program = void 0;
-const commander_1 = require("commander");
-const run_1 = require("./commands/run");
-const stats_1 = require("./commands/stats");
-const explain_1 = require("./commands/explain");
-const export_1 = require("./commands/export");
-const query_1 = require("./commands/query");
-const path_1 = require("./commands/path");
-const map_1 = require("./commands/map");
-const affected_1 = require("./commands/affected");
-const mcp_1 = require("./commands/mcp");
-const tree_1 = require("./commands/tree");
-const wiki_1 = require("./commands/wiki");
-const prs_1 = require("./commands/prs");
-const add_1 = require("./commands/add");
-const diagnose_1 = require("./commands/diagnose");
-const feedback_1 = require("./commands/feedback");
-const global_1 = require("./commands/global");
-const hook_guard_1 = require("./commands/hook-guard");
-const migrate_1 = require("./commands/migrate");
-const update_1 = require("./commands/update");
-const watch_1 = require("./commands/watch");
-const cluster_1 = require("./commands/cluster");
-const merge_1 = require("./commands/merge");
-const diff_1 = require("./commands/diff");
-const history_1 = require("./commands/history");
-const status_1 = require("./commands/status");
-const install_1 = require("./commands/install");
-const hook_1 = require("./commands/hook");
-const program = new commander_1.Command();
-exports.program = program;
-program
-    .name('astria')
-    .description('Turn any folder into a queryable knowledge graph')
-    .version(require('../package.json').version);
-program
-    .command('run')
-    .description('Run the full pipeline on a directory')
-    .argument('<path>', 'Directory to analyze')
-    .option('--no-dedup', 'Skip near-duplicate node merging')
-    .option('--backend <name>', 'Semantic LLM backend: claude, openai (any OpenAI-compatible), or gemini')
-    .option('--model <name>', 'Semantic LLM model name (backend-specific)')
-    .option('--wiki', 'Also export a markdown wiki to .astria/wiki')
-    .option('--embed', 'Compute local embeddings: similar_to edges + semantic query recall (downloads a small model on first use)')
-    .option('--global', 'After building, merge this repo into the cross-repo global graph')
-    .option('--as <tag>', 'Repo tag for --global (defaults to the directory name)')
-    .action((path, opts) => (0, run_1.runCommand)(path, { ...opts, global: opts.global, as: opts.as }));
-program
-    .command('update')
-    .description('Run incremental AST-only rebuild')
-    .argument('<path>', 'Directory to update')
-    .option('--no-dedup', 'Skip near-duplicate node merging')
-    .option('--backend <name>', 'Semantic LLM backend: claude, openai (any OpenAI-compatible), or gemini')
-    .option('--model <name>', 'Semantic LLM model name (backend-specific)')
-    .option('--embed', 'Compute local embeddings: similar_to edges + semantic query recall (downloads a small model on first use)')
-    .action(update_1.updateCommand);
-program
-    .command('watch')
-    .description('Watch for file changes and auto-rebuild')
-    .argument('<path>', 'Directory to watch')
-    .option('--debounce <ms>', 'Debounce interval in milliseconds', '3000')
-    .action(watch_1.watchCommand);
-program
-    .command('explain')
-    .description('Explain a node and its connections')
-    .argument('<node>', 'Node ID or label')
-    .option('--graph <path>', 'Path to project root', '.')
-    .action(explain_1.explainCommand);
-program
-    .command('query')
-    .description('BFS/DFS graph traversal for a question')
-    .argument('<question>', 'Search terms')
-    .option('--graph <path>', 'Path to project root', '.')
-    .option('--dfs', 'Use depth-first search instead of breadth-first')
-    .option('--depth <n>', 'Traversal depth', '2')
-    .option('--budget <n>', 'Token budget for output', '2000')
-    .option('--directed', 'Follow edges only in their stored direction (caller -> callee)')
-    .option('--detail <level>', 'Fidelity tier: "high" keeps only EXTRACTED/DECLARED facts')
-    .option('--cursor <n>', 'Continuation token from a previous truncated query', '0')
-    .action(query_1.queryCommand);
-program
-    .command('path')
-    .description('Find shortest path between two nodes')
-    .argument('<source>', 'Source node label')
-    .argument('<target>', 'Target node label')
-    .option('--graph <path>', 'Path to project root', '.')
-    .option('--directed', 'Follow edges only in their stored direction (caller -> callee)')
-    .option('--detail <level>', 'Fidelity tier: "high" keeps only EXTRACTED/DECLARED facts')
-    .action(path_1.pathCommand);
-program
-    .command('map')
-    .description('Repo map: PageRank-ranked files with top symbols, within a token budget')
-    .option('--graph <path>', 'Path to project root', '.')
-    .option('--budget <n>', 'Token budget for output', '2000')
-    .option('--detail <level>', 'Fidelity tier: "high" keeps only EXTRACTED/DECLARED facts')
-    .action(map_1.mapCommand);
-program
-    .command('affected')
-    .description('Show the blast radius of a node — everything impacted by changing it')
-    .argument('<node>', 'Node ID, label, or source file path')
-    .option('--graph <path>', 'Path to project root', '.')
-    .option('--depth <n>', 'Maximum hops to traverse', '2')
-    .option('--relation <type>', 'Only follow one relation (e.g. calls, imports, uses)')
-    .action(affected_1.affectedCommand);
-program
-    .command('stats')
-    .description('Show graph statistics')
-    .option('--graph <path>', 'Path to project root', '.')
-    .action(stats_1.statsCommand);
-program
-    .command('export')
-    .description('Export graph to JSON, HTML, GraphML, or Cypher (Neo4j)')
-    .option('--graph <path>', 'Path to project root', '.')
-    .option('--out <file>', 'Output file', 'graph.json')
-    .option('--format <type>', 'Export format: json, html, graphml, cypher', 'json')
-    .option('--mode <mode>', 'HTML visualization mode: standard or large', 'standard')
-    .action(export_1.exportCommand);
-program
-    .command('cluster-only')
-    .description('Run cluster + analyze + report only (no extract/build)')
-    .argument('<path>', 'Directory with existing graph')
-    .action(cluster_1.clusterCommand);
-program
-    .command('merge')
-    .description('Merge two graphs into a new output graph')
-    .argument('<pathA>', 'First project root')
-    .argument('<pathB>', 'Second project root')
-    .argument('<outPath>', 'Output project root')
-    .action(merge_1.mergeCommand);
-program
-    .command('diff')
-    .description('Compare two graphs and show differences')
-    .argument('<pathA>', 'First project root')
-    .argument('<pathB>', 'Second project root')
-    .action(diff_1.diffCommand);
-program
-    .command('history')
-    .description('Show recent query history')
-    .option('--limit <n>', 'Number of entries to show', '20')
-    .option('--graph <path>', 'Path to project root', '.')
-    .action(history_1.historyCommand);
-program
-    .command('mcp')
-    .description('Run an MCP stdio server exposing the graph to AI agents (Claude, etc.)')
-    .option('--graph <path>', 'Path to project root', '.')
-    .action(mcp_1.mcpCommand);
-program
-    .command('tree')
-    .description('Export a collapsible filesystem tree of all graph symbols (self-contained HTML)')
-    .option('--graph <path>', 'Path to project root', '.')
-    .option('--out <file>', 'Output HTML file', 'tree.html')
-    .option('--max-children <n>', 'Max symbols shown per directory', '40')
-    .action(tree_1.treeCommand);
-program
-    .command('wiki')
-    .description('Export a Wikipedia-style markdown wiki (index.md + one article per community and god node)')
-    .option('--graph <path>', 'Path to project root', '.')
-    .option('--out <dir>', 'Output directory', '.astria/wiki')
-    .option('--max-nodes <n>', 'Max key concepts listed per community article', '25')
-    .option('--format <type>', 'markdown (wiki articles) or obsidian (vault: per-node notes + canvas)', 'markdown')
-    .action(wiki_1.wikiCommand);
-program
-    .command('prs')
-    .description('Map open pull requests onto the knowledge graph (impact + merge-order risk)')
-    .argument('[count]', 'Number of PRs to analyze', '20')
-    .option('--graph <path>', 'Path to project root', '.')
-    .option('--conflicts', 'Flag PRs sharing communities (merge-order risk)')
-    .action(prs_1.prsCommand);
-program
-    .command('add')
-    .description('Fetch a URL (arXiv paper, tweet, webpage, image, PDF) into ./raw and update the graph')
-    .argument('[url]', 'URL to fetch (required unless --scip/--postgres is given)')
-    .option('--graph <path>', 'Path to project root', '.')
-    .option('--author <name>', 'Author recorded in the saved metadata')
-    .option('--contributor <name>', 'Contributor recorded in the saved metadata')
-    .option('--scip <file>', 'Ingest a simplified SCIP JSON index instead of fetching a URL')
-    .option('--postgres <dsn>', 'Introspect a live PostgreSQL schema (requires psql on PATH) instead of fetching a URL')
-    .action(add_1.addCommand);
-program
-    .command('status')
-    .description('Check graph health and staleness')
-    .option('--graph <path>', 'Path to project root', '.')
-    .action(status_1.statusCommand);
-program
-    .command('migrate')
-    .description('Migrate a pre-1.0 .graphify layout to .astria (renames the data folder, ignore file, and global store)')
-    .option('--graph <path>', 'Path to project root', '.')
-    .action(migrate_1.migrateCommand);
-(0, install_1.registerInstallCommand)(program);
-(0, hook_1.registerHookCommand)(program);
-program
-    .command('diagnose')
-    .description('Read-only graph health report: dangling edges, self-loops, duplicates, stubs')
-    .option('--graph <path>', 'Path to project root', '.')
-    .option('--json', 'Machine-readable output')
-    .action(diagnose_1.diagnoseCommand);
-program
-    .command('save-result')
-    .description('Save a Q/A pair into the graph memory for future runs')
-    .argument('<question>', 'The question that was asked')
-    .option('--graph <path>', 'Path to project root', '.')
-    .option('--answer <text>', 'The answer to record')
-    .option('--answer-file <path>', 'Read the answer from a file')
-    .option('--outcome <kind>', 'useful | dead_end | corrected')
-    .option('--correction <text>', 'Corrections to the recorded answer')
-    .option('--nodes <ids>', 'Comma-separated source node ids this answer cites')
-    .action(feedback_1.saveResultCommand);
-program
-    .command('reflect')
-    .description('Aggregate memory outcomes into .astria/reflections/LESSONS.md')
-    .option('--graph <path>', 'Path to project root', '.')
-    .action(feedback_1.reflectCommand);
-const globalCmd = program
-    .command('global')
-    .description('Cross-repo global graph: merge many repo graphs into one queryable store');
-globalCmd
-    .command('add')
-    .description('Merge a repo graph into the global store (idempotent by tag)')
-    .argument('<path>', 'Repo root with a .astria directory')
-    .option('--as <tag>', 'Repo tag (defaults to the directory name)')
-    .action(global_1.globalAddCommand);
-globalCmd
-    .command('remove')
-    .description('Remove a repo from the global graph')
-    .argument('<tag>', 'Repo tag')
-    .action(global_1.globalRemoveCommand);
-globalCmd
-    .command('list')
-    .description('List repos registered in the global graph')
-    .action(() => (0, global_1.globalListCommand)());
-globalCmd
-    .command('path')
-    .description('Shortest path across repos in the global graph')
-    .argument('<source>', 'Source node id or unique label')
-    .argument('<target>', 'Target node id or unique label')
-    .action(global_1.globalPathCommand);
-program
-    .command('hook-guard')
-    .description('Editor PreToolUse guard (installed into .claude/settings.json) — internal use')
-    .argument('<mode>', 'search | read | gemini')
-    .allowUnknownOption(true)
-    .action((mode) => {
-    (0, hook_guard_1.hookGuard)(mode, process.argv.slice(4));
-});
-if (require.main === module) {
-    program.parse();
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.program = void 0;
+const commander_1 = require("commander");
+const run_1 = require("./commands/run");
+const stats_1 = require("./commands/stats");
+const explain_1 = require("./commands/explain");
+const export_1 = require("./commands/export");
+const query_1 = require("./commands/query");
+const path_1 = require("./commands/path");
+const map_1 = require("./commands/map");
+const affected_1 = require("./commands/affected");
+const mcp_1 = require("./commands/mcp");
+const tree_1 = require("./commands/tree");
+const wiki_1 = require("./commands/wiki");
+const prs_1 = require("./commands/prs");
+const add_1 = require("./commands/add");
+const diagnose_1 = require("./commands/diagnose");
+const feedback_1 = require("./commands/feedback");
+const global_1 = require("./commands/global");
+const hook_guard_1 = require("./commands/hook-guard");
+const migrate_1 = require("./commands/migrate");
+const update_1 = require("./commands/update");
+const watch_1 = require("./commands/watch");
+const cluster_1 = require("./commands/cluster");
+const merge_1 = require("./commands/merge");
+const diff_1 = require("./commands/diff");
+const history_1 = require("./commands/history");
+const status_1 = require("./commands/status");
+const install_1 = require("./commands/install");
+const hook_1 = require("./commands/hook");
+const program = new commander_1.Command();
+exports.program = program;
+program
+    .name('astria')
+    .description('Turn any folder into a queryable knowledge graph')
+    .version(require('../package.json').version);
+program
+    .command('run')
+    .description('Run the full pipeline on a directory')
+    .argument('<path>', 'Directory to analyze')
+    .option('--no-dedup', 'Skip near-duplicate node merging')
+    .option('--backend <name>', 'Semantic LLM backend: claude, openai (any OpenAI-compatible), or gemini')
+    .option('--model <name>', 'Semantic LLM model name (backend-specific)')
+    .option('--wiki', 'Also export a markdown wiki to .astria/wiki')
+    .option('--embed', 'Compute local embeddings: similar_to edges + semantic query recall (downloads a small model on first use)')
+    .option('--global', 'After building, merge this repo into the cross-repo global graph')
+    .option('--as <tag>', 'Repo tag for --global (defaults to the directory name)')
+    .action((path, opts) => (0, run_1.runCommand)(path, { ...opts, global: opts.global, as: opts.as }));
+program
+    .command('update')
+    .description('Run incremental AST-only rebuild')
+    .argument('<path>', 'Directory to update')
+    .option('--no-dedup', 'Skip near-duplicate node merging')
+    .option('--backend <name>', 'Semantic LLM backend: claude, openai (any OpenAI-compatible), or gemini')
+    .option('--model <name>', 'Semantic LLM model name (backend-specific)')
+    .option('--embed', 'Compute local embeddings: similar_to edges + semantic query recall (downloads a small model on first use)')
+    .action(update_1.updateCommand);
+program
+    .command('watch')
+    .description('Watch for file changes and auto-rebuild')
+    .argument('<path>', 'Directory to watch')
+    .option('--debounce <ms>', 'Debounce interval in milliseconds', '3000')
+    .action(watch_1.watchCommand);
+program
+    .command('explain')
+    .description('Explain a node and its connections')
+    .argument('<node>', 'Node ID or label')
+    .option('--graph <path>', 'Path to project root', '.')
+    .action(explain_1.explainCommand);
+program
+    .command('query')
+    .description('BFS/DFS graph traversal for a question')
+    .argument('<question>', 'Search terms')
+    .option('--graph <path>', 'Path to project root', '.')
+    .option('--dfs', 'Use depth-first search instead of breadth-first')
+    .option('--depth <n>', 'Traversal depth', '2')
+    .option('--budget <n>', 'Token budget for output', '2000')
+    .option('--directed', 'Follow edges only in their stored direction (caller -> callee)')
+    .option('--detail <level>', 'Fidelity tier: "high" keeps only EXTRACTED/DECLARED facts')
+    .option('--cursor <n>', 'Continuation token from a previous truncated query', '0')
+    .action(query_1.queryCommand);
+program
+    .command('path')
+    .description('Find shortest path between two nodes')
+    .argument('<source>', 'Source node label')
+    .argument('<target>', 'Target node label')
+    .option('--graph <path>', 'Path to project root', '.')
+    .option('--directed', 'Follow edges only in their stored direction (caller -> callee)')
+    .option('--detail <level>', 'Fidelity tier: "high" keeps only EXTRACTED/DECLARED facts')
+    .action(path_1.pathCommand);
+program
+    .command('map')
+    .description('Repo map: PageRank-ranked files with top symbols, within a token budget')
+    .option('--graph <path>', 'Path to project root', '.')
+    .option('--budget <n>', 'Token budget for output', '2000')
+    .option('--detail <level>', 'Fidelity tier: "high" keeps only EXTRACTED/DECLARED facts')
+    .action(map_1.mapCommand);
+program
+    .command('affected')
+    .description('Show the blast radius of a node — everything impacted by changing it')
+    .argument('<node>', 'Node ID, label, or source file path')
+    .option('--graph <path>', 'Path to project root', '.')
+    .option('--depth <n>', 'Maximum hops to traverse', '2')
+    .option('--relation <type>', 'Only follow one relation (e.g. calls, imports, uses)')
+    .action(affected_1.affectedCommand);
+program
+    .command('stats')
+    .description('Show graph statistics')
+    .option('--graph <path>', 'Path to project root', '.')
+    .action(stats_1.statsCommand);
+program
+    .command('export')
+    .description('Export graph to JSON, HTML, GraphML, or Cypher (Neo4j)')
+    .option('--graph <path>', 'Path to project root', '.')
+    .option('--out <file>', 'Output file', 'graph.json')
+    .option('--format <type>', 'Export format: json, html, graphml, cypher', 'json')
+    .option('--mode <mode>', 'HTML visualization mode: standard or large', 'standard')
+    .action(export_1.exportCommand);
+program
+    .command('cluster-only')
+    .description('Run cluster + analyze + report only (no extract/build)')
+    .argument('<path>', 'Directory with existing graph')
+    .action(cluster_1.clusterCommand);
+program
+    .command('merge')
+    .description('Merge two graphs into a new output graph')
+    .argument('<pathA>', 'First project root')
+    .argument('<pathB>', 'Second project root')
+    .argument('<outPath>', 'Output project root')
+    .action(merge_1.mergeCommand);
+program
+    .command('diff')
+    .description('Compare two graphs and show differences')
+    .argument('<pathA>', 'First project root')
+    .argument('<pathB>', 'Second project root')
+    .action(diff_1.diffCommand);
+program
+    .command('history')
+    .description('Show recent query history')
+    .option('--limit <n>', 'Number of entries to show', '20')
+    .option('--graph <path>', 'Path to project root', '.')
+    .action(history_1.historyCommand);
+program
+    .command('mcp')
+    .description('Run an MCP stdio server exposing the graph to AI agents (Claude, etc.)')
+    .option('--graph <path>', 'Path to project root', '.')
+    .action(mcp_1.mcpCommand);
+program
+    .command('tree')
+    .description('Export a collapsible filesystem tree of all graph symbols (self-contained HTML)')
+    .option('--graph <path>', 'Path to project root', '.')
+    .option('--out <file>', 'Output HTML file', 'tree.html')
+    .option('--max-children <n>', 'Max symbols shown per directory', '40')
+    .action(tree_1.treeCommand);
+program
+    .command('wiki')
+    .description('Export a Wikipedia-style markdown wiki (index.md + one article per community and god node)')
+    .option('--graph <path>', 'Path to project root', '.')
+    .option('--out <dir>', 'Output directory', '.astria/wiki')
+    .option('--max-nodes <n>', 'Max key concepts listed per community article', '25')
+    .option('--format <type>', 'markdown (wiki articles) or obsidian (vault: per-node notes + canvas)', 'markdown')
+    .action(wiki_1.wikiCommand);
+program
+    .command('prs')
+    .description('Map open pull requests onto the knowledge graph (impact + merge-order risk)')
+    .argument('[count]', 'Number of PRs to analyze', '20')
+    .option('--graph <path>', 'Path to project root', '.')
+    .option('--conflicts', 'Flag PRs sharing communities (merge-order risk)')
+    .action(prs_1.prsCommand);
+program
+    .command('add')
+    .description('Fetch a URL (arXiv paper, tweet, webpage, image, PDF) into ./raw and update the graph')
+    .argument('[url]', 'URL to fetch (required unless --scip/--postgres is given)')
+    .option('--graph <path>', 'Path to project root', '.')
+    .option('--author <name>', 'Author recorded in the saved metadata')
+    .option('--contributor <name>', 'Contributor recorded in the saved metadata')
+    .option('--scip <file>', 'Ingest a simplified SCIP JSON index instead of fetching a URL')
+    .option('--postgres <dsn>', 'Introspect a live PostgreSQL schema (requires psql on PATH) instead of fetching a URL')
+    .action(add_1.addCommand);
+program
+    .command('status')
+    .description('Check graph health and staleness')
+    .option('--graph <path>', 'Path to project root', '.')
+    .action(status_1.statusCommand);
+program
+    .command('migrate')
+    .description('Migrate a pre-1.0 .graphify layout to .astria (renames the data folder, ignore file, and global store)')
+    .option('--graph <path>', 'Path to project root', '.')
+    .action(migrate_1.migrateCommand);
+(0, install_1.registerInstallCommand)(program);
+(0, hook_1.registerHookCommand)(program);
+program
+    .command('diagnose')
+    .description('Read-only graph health report: dangling edges, self-loops, duplicates, stubs')
+    .option('--graph <path>', 'Path to project root', '.')
+    .option('--json', 'Machine-readable output')
+    .action(diagnose_1.diagnoseCommand);
+program
+    .command('save-result')
+    .description('Save a Q/A pair into the graph memory for future runs')
+    .argument('<question>', 'The question that was asked')
+    .option('--graph <path>', 'Path to project root', '.')
+    .option('--answer <text>', 'The answer to record')
+    .option('--answer-file <path>', 'Read the answer from a file')
+    .option('--outcome <kind>', 'useful | dead_end | corrected')
+    .option('--correction <text>', 'Corrections to the recorded answer')
+    .option('--nodes <ids>', 'Comma-separated source node ids this answer cites')
+    .action(feedback_1.saveResultCommand);
+program
+    .command('reflect')
+    .description('Aggregate memory outcomes into .astria/reflections/LESSONS.md')
+    .option('--graph <path>', 'Path to project root', '.')
+    .action(feedback_1.reflectCommand);
+const globalCmd = program
+    .command('global')
+    .description('Cross-repo global graph: merge many repo graphs into one queryable store');
+globalCmd
+    .command('add')
+    .description('Merge a repo graph into the global store (idempotent by tag)')
+    .argument('<path>', 'Repo root with a .astria directory')
+    .option('--as <tag>', 'Repo tag (defaults to the directory name)')
+    .action(global_1.globalAddCommand);
+globalCmd
+    .command('remove')
+    .description('Remove a repo from the global graph')
+    .argument('<tag>', 'Repo tag')
+    .action(global_1.globalRemoveCommand);
+globalCmd
+    .command('list')
+    .description('List repos registered in the global graph')
+    .action(() => (0, global_1.globalListCommand)());
+globalCmd
+    .command('path')
+    .description('Shortest path across repos in the global graph')
+    .argument('<source>', 'Source node id or unique label')
+    .argument('<target>', 'Target node id or unique label')
+    .action(global_1.globalPathCommand);
+program
+    .command('hook-guard')
+    .description('Editor PreToolUse guard (installed into .claude/settings.json) — internal use')
+    .argument('<mode>', 'search | read | gemini')
+    .allowUnknownOption(true)
+    .action((mode) => {
+    (0, hook_guard_1.hookGuard)(mode, process.argv.slice(4));
+});
+if (require.main === module) {
+    program.parse();
+}
 //# sourceMappingURL=index.js.map

package/dist/install/hooks.d.ts

@@ -1,12 +1,12 @@
-declare const LEGACY_HOOK_PREFIXES: ({
-    js: string;
-    shell?: undefined;
-} | {
-    shell: string;
-    js?: undefined;
-})[];
-export declare function installGitHooks(projectDir: string): string[];
-export declare function uninstallGitHooks(projectDir: string): string[];
-export declare function statusGitHooks(projectDir: string): string[];
-export { LEGACY_HOOK_PREFIXES };
+declare const LEGACY_HOOK_PREFIXES: ({
+    js: string;
+    shell?: undefined;
+} | {
+    shell: string;
+    js?: undefined;
+})[];
+export declare function installGitHooks(projectDir: string): string[];
+export declare function uninstallGitHooks(projectDir: string): string[];
+export declare function statusGitHooks(projectDir: string): string[];
+export { LEGACY_HOOK_PREFIXES };
 //# sourceMappingURL=hooks.d.ts.map