@nodesify/astria 1.1.1 → 1.3.0

package/README.md

@@ -2,6 +2,21 @@
 
 Turn any folder into a queryable knowledge graph.
 
+## Measured results (October 2026, release candidate)
+
+Head-to-head against the original Python [Graphify](https://github.com/safishamsi/graphify) on identical corpora, pinned commits, one shared `o200k_base` tokenizer — structural pipeline only, no LLM:
+
+| Measurement | astria | Graphify |
+|---|---|---|
+| Token reduction (17 MB corpus, 4.59M tokens) | **2,875×** | 2,575× |
+| Avg tokens per answer (same questions, same budget) | **1,597** | 1,783 |
+| Retrieval suites won or tied (file recall@5, 10 held-out/frozen suites) | **10 / 10** | — |
+| Exact-declaration recall@5 | **40–100%** | ~0% |
+| Over-budget answers | **0** | 6 of 10 suites |
+| LoCoMo conversational-memory recall@5 (full 1,977-question set) | **83.6%** | — |
+
+Self-corpus retrieval gate: hit@5 0.800, recall@5 0.743, zero failures, zero budget violations. Version-over-version performance (v1.2.0 → candidate): no regressions; queries 9–22% faster, explain 37% faster. Full methodology, tables, and reproduction commands: [Benchmarks and evidence](https://nodesify.github.io/astria/docs/explanation/benchmarks) and [RESULTS-2026-10-16.md](https://github.com/Nodesify/astria/blob/develop/RESULTS-2026-10-16.md).
+
 ## Install
 
 ```bash
@@ -10,8 +25,6 @@ npm install -g @nodesify/astria
 
 Requires Node.js >= 22. No Rust toolchain needed — ships prebuilt native binaries for macOS, Linux, and Windows.
 
-> **Migrating from `@nodesify/graphify`?** Run `astria migrate` once (renames `.graphify/` → `.astria/` and the global store), then `astria install` to refresh AI-tool skills and hooks. `GRAPHIFY_*` env vars keep working; `ASTRIA_*` takes precedence.
-
 ## Usage
 
 ```bash
@@ -19,15 +32,17 @@ astria run <path>                            # Full pipeline: detect → extract
 astria update <path>                         # Reuse cached extraction; reconcile current corpus
 astria watch <path> [--debounce 3000]        # Watch for file changes, auto-rebuild
 astria explain <node> [--graph .]            # Explain a node and its connections
-astria query <question> [--dfs] [--depth 2] [--budget 2000] [--graph .]  # BFS/DFS traversal
+astria query <question> [--seed <symbol>]... [--dfs] [--depth 2] [--budget 2000] [--graph .]  # BFS/DFS traversal from explicit symbols
 astria path <A> <B> [--graph .]              # Shortest path between two concepts
-astria stats [--graph .]                     # Node/edge/community counts
+astria stats [--graph .]                     # Node/edge/community counts + extraction completeness
+astria save-result <question> [--answer <text>|--answer-file <path>] [--outcome useful|dead_end|corrected] [--correction <text>] [--nodes <ids>]  # Curate a memory
+astria reflect [--graph .]                   # Aggregate memories into actionable LESSONS.md
 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
+astria hook install                          # Install git post-commit/post-checkout/post-merge hooks
 ```
 
 Running `astria run .` creates `.astria/` with:
@@ -35,15 +50,40 @@ 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
+- `memory/` + `reflections/LESSONS.md` — the curated memory loop (see below)
+
+### Explicit query seeds
+
+`astria query "..." --seed <symbol>` (repeatable; also a `seeds` argument on the MCP `query_graph` tool) anchors the traversal at known symbols instead of keyword ranking — node id, label, bare name, or a unique source path all resolve. Unresolved seeds are reported (`unresolvedSeeds` in JSON, a header line in text), and when every supplied seed fails to resolve the query returns an explicit miss rather than silently falling back to keyword search.
 
 ### Retrieval and upgrades
 
 Scoped code definitions survive semantic deduplication. JS/TS assigned functions retain binding names and bodies; Python implementations take precedence over overload declarations. Queries favor complete identifiers while honoring explicit requests for tests or documentation. Static receiver matching does not infer runtime types or aliases.
 
+TypeScript member calls resolve through declared types — constructor parameter properties, typed fields, locals, and `new` initializers — including inherited members; ambiguous receivers stay unresolved, and these bindings are name/type-derived (`RESOLVED`), never compiler-proven. Interfaces are extracted with their members and dispatch to every implementing class via `dispatch` edges, marked INFERRED: possible implementations, not proven runtime calls. Member calls whose receiver type is known but whose member lives in another repository retain `receiver::type::<T>::<m>` evidence that the cross-repo global resolver links on a unique name+member match.
+
 `query --budget N` caps the full query text using `o200k_base`, including metadata. CLI and MCP share that text budget; MCP transport JSON is excluded. Budgets must fit metadata and the next complete record or the query returns an error. Use the returned `--cursor N` for the next page of node and edge records.
 
+Extraction completeness is tracked per file — complete, partial (with the first parser-error lines), unsupported, skipped, or suspicious-empty — and surfaced by `astria stats`, `astria diagnose`, and the MCP `graph_stats` tool, so a missing relationship is distinguishable from an incompletely-understood file. Community detection weights edges by their stored evidence (EXTRACTED > RESOLVED > INFERRED > SEMANTIC) so weak links cannot outvote strong structure, and query-usage `learned` edges never shape module boundaries.
+
 After upgrading, run `astria update .` to refresh extraction and restore definitions removed by older deduplication. Discard old pagination cursors after an upgrade or graph rebuild.
 
+### Project configuration (`.astria.toml`)
+
+```toml
+[languages]
+".inc" = "PHP"      # remap an ambiguous suffix to a registered language
+".tpl" = "TypeScript"
+```
+
+Remapped suffixes flow consistently through discovery, parser selection, watch, and cache identity; invalid entries warn and are skipped, and changing a mapping re-extracts exactly the affected files.
+
+### Memory loop: save-result and reflect
+
+`astria save-result` records a Q/A verdict (useful / dead_end / corrected, optionally a correction and cited node ids) into `.astria/memory/`. `astria reflect` aggregates those memories into `.astria/reflections/LESSONS.md` as actionable output: preferred sources (corroborated by multiple useful memories, most recent first), corrections to apply, known dead ends, contested evidence, and tentative findings awaiting verification — with citations of deleted nodes discarded automatically.
+
+Verdicts also gate the learned-edge loop: a node pair promoted from repeated queries must be backed by at least one question that was not judged a dead end or correction, so repeated unsuccessful exploration never becomes an authoritative edge. Lessons stay experiential — they never merge into the structural graph facts.
+
 ### 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:
@@ -71,3 +111,5 @@ Place a `.astriaignore` file in your project root (gitignore syntax) to exclude
 ## License
 
 MIT
+
+Installation defaults to project scope: `astria install --platform codex --scope project`. Use `--scope user` explicitly for user-wide integrations. Run `astria doctor` after setup or upgrades. See the [installation lifecycle guide](https://nodesify.github.io/astria/docs/guides/installation-lifecycle) for supported platforms, upgrade, backup/restore and complete removal.

package/dist/commands/change-review.d.ts

@@ -0,0 +1,73 @@
+export interface ChangedDeclaration {
+    id: string;
+    label: string;
+    file: string;
+    line: number;
+    endLine: number;
+    kind: string;
+    snapshot: 'before' | 'after';
+    change: string;
+    owners: string[];
+    ownerSource: string | null;
+}
+export interface ChangeConsumer {
+    id: string;
+    label: string;
+    file: string;
+    line: number | null;
+    snapshot: 'before' | 'after';
+    changedId: string;
+    depth: number;
+    evidence: string;
+    stillPresent: boolean;
+    isTest: boolean;
+    owners: string[];
+    ownerSource: string | null;
+    path: Array<{
+        from: string;
+        to: string;
+        relation: string;
+        evidence: string;
+        file: string;
+        line: number | null;
+    }>;
+}
+export interface ChangeReview {
+    schemaVersion: 1;
+    score: number | null;
+    level: string;
+    scope: string;
+    baseCommit: string;
+    requestedBaseCommit: string;
+    headCommit: string | null;
+    beforeIdentity: string;
+    afterIdentity: string;
+    changedFiles: Array<{
+        status: string;
+        oldPath: string | null;
+        newPath: string | null;
+    }>;
+    declarations: ChangedDeclaration[];
+    consumers: ChangeConsumer[];
+    impacted: number;
+    directConsumers: number;
+    inferredConsumers: number;
+    testConsumers: number;
+    coverageComplete: boolean;
+    coverageIssues: string[];
+    unresolvedBefore: number;
+    unresolvedAfter: number;
+    filesIndexedBefore: number;
+    filesIndexedAfter: number;
+    indexingMs: number;
+    text: string;
+}
+export interface ReviewOptions {
+    graph: string;
+    staged?: boolean;
+    base?: string;
+    head?: string;
+}
+/** One native engine serves local review, merge gates, and the PR dashboard. */
+export declare function changeReview(opts: ReviewOptions): ChangeReview;
+//# sourceMappingURL=change-review.d.ts.map

package/dist/commands/change-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-review.d.ts","sourceRoot":"","sources":["../../src/commands/change-review.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IACvE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAC3D,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7D,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IACjF,YAAY,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACrF,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAClH;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IACnD,UAAU,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3E,cAAc,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAC9C,YAAY,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACxF,YAAY,EAAE,kBAAkB,EAAE,CAAC;IAAC,SAAS,EAAE,cAAc,EAAE,CAAC;IAChE,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAC5F,gBAAgB,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IACpD,gBAAgB,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAClD,kBAAkB,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAC1E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAEhG,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CAM9D"}

package/dist/commands/change-review.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.changeReview = changeReview;
+const native_1 = require("../native");
+/** One native engine serves local review, merge gates, and the PR dashboard. */
+function changeReview(opts) {
+    if (opts.head && !opts.base)
+        throw new Error('--head requires --base');
+    if (opts.staged && opts.base)
+        throw new Error('--staged cannot be combined with --base');
+    const result = (0, native_1.riskReport)(opts.graph, opts.staged === true, opts.base, opts.base ? (opts.head ?? 'HEAD') : undefined);
+    const report = JSON.parse(result.reportJson);
+    return { ...report, text: result.text };
+}
+//# sourceMappingURL=change-review.js.map

package/dist/commands/change-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-review.js","sourceRoot":"","sources":["../../src/commands/change-review.ts"],"names":[],"mappings":";;;AAAA,sCAAuC;AA+BvC,gFAAgF;AAChF,sBAA6B,IAAmB;IAC9C,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACzF,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACtH,MAAM,MAAM,GAAiB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3D,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,6 @@
+export declare function doctorCommand(opts: {
+    graph: string;
+    scope: string;
+    json?: boolean;
+}): void;
+//# sourceMappingURL=doctor.d.ts.map

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

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

package/dist/commands/doctor.js

@@ -0,0 +1,139 @@
+"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.doctorCommand = doctorCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const native_1 = require("../native");
+const state_1 = require("../install/state");
+const platforms_1 = require("../install/platforms");
+const settings_inject_1 = require("../install/settings-inject");
+const hooks_1 = require("../install/hooks");
+const crypto_1 = require("crypto");
+function executableOnPath(name) {
+    const extensions = process.platform === 'win32' ? (process.env.PATHEXT ?? '.EXE;.CMD;.BAT').split(';') : [''];
+    for (const dir of (process.env.PATH ?? '').split(path.delimiter)) {
+        if (!dir)
+            continue;
+        for (const extension of extensions) {
+            const file = path.join(dir.replace(/^"|"$/g, ''), name + extension);
+            try {
+                fs.accessSync(file, process.platform === 'win32' ? fs.constants.R_OK : fs.constants.X_OK);
+                if (fs.statSync(file).isFile())
+                    return file;
+            }
+            catch { /* Try next PATH entry. */ }
+        }
+    }
+    return undefined;
+}
+function doctorCommand(opts) {
+    const checks = [];
+    const add = (name, status, detail) => checks.push({ name, status, detail });
+    const check = (name, work) => { try {
+        work();
+    }
+    catch (error) {
+        add(name, 'error', error.message);
+    } };
+    check('node', () => add('node', Number(process.versions.node.split('.')[0]) >= 22 ? 'ok' : 'error', `${process.version} at ${process.execPath}; requires Node 22+`));
+    check('native', () => {
+        const embed = (0, native_1.embeddingsSupported)();
+        add('native', 'ok', `Loaded ${(0, native_1.getPlatformSuffix)()}`);
+        add('embeddings', embed ? 'ok' : 'warning', embed ? 'Local embeddings supported; doctor does not download the model' : 'This build has no local embedding runtime; omit --embed');
+    });
+    const executable = executableOnPath('astria');
+    add('executable', executable ? 'ok' : 'error', executable ? `PATH resolves to ${executable}; check the editor uses this same PATH and restart it after upgrades` : 'astria is absent from PATH; install globally or expose the local node_modules/.bin directory to the editor');
+    check('installation', () => {
+        const scope = (0, state_1.parseScope)(opts.scope);
+        const root = (0, state_1.installRoot)(opts.graph, scope);
+        const state = (0, state_1.readInstallState)(opts.graph, scope);
+        add('installation', state.platforms.length ? 'ok' : 'warning', `${scope}: ${state.platforms.join(', ') || 'no recorded integrations'}`);
+        for (const platform of state.platforms.length ? state.platforms : platforms_1.PLATFORM_NAMES) {
+            const cfg = platforms_1.PLATFORMS[platform];
+            if (!cfg) {
+                add(platform, 'error', 'Unknown platform in installation record');
+                continue;
+            }
+            if (cfg.mcp && (scope === 'project' || platform === 'codex'))
+                check(`${platform} MCP`, () => {
+                    const result = (0, settings_inject_1.inspectAgentMcp)(root, cfg.mcp);
+                    if (!result.present && !state.platforms.includes(platform))
+                        return;
+                    add(`${platform} MCP`, !result.present ? 'error' : result.managed ? 'ok' : 'warning', `${result.file}: ${result.present ? (result.managed ? 'registered' : 'customized; inspect command and arguments') : 'missing; rerun install'}`);
+                });
+        }
+        for (const [file, expected] of Object.entries(state.files))
+            check('managed file', () => {
+                const actual = (0, crypto_1.createHash)('sha256').update(fs.readFileSync(file, 'utf8')).digest('hex');
+                add('managed file', actual === expected ? 'ok' : 'warning', `${file}: ${actual === expected ? 'intact' : 'customized; install/uninstall will preserve it and request manual resolution'}`);
+            });
+        let existing = root;
+        while (!fs.existsSync(existing) && path.dirname(existing) !== existing)
+            existing = path.dirname(existing);
+        fs.accessSync(existing, fs.constants.W_OK);
+        for (const file of Object.keys(state.files)) {
+            let target = file;
+            while (!fs.existsSync(target) && path.dirname(target) !== target)
+                target = path.dirname(target);
+            fs.accessSync(target, fs.constants.W_OK);
+        }
+        add('permissions', 'ok', `${existing} is writable; editor sandbox permissions may differ`);
+    });
+    check('git hooks', () => {
+        const hooks = (0, hooks_1.statusGitHooks)(path.resolve(opts.graph));
+        add('git hooks', hooks.some(h => /unsafe|legacy|Not a git/.test(h)) ? 'warning' : 'ok', hooks.join('; '));
+    });
+    check('graph', () => {
+        if (!fs.existsSync(path.join(opts.graph, '.astria', 'db.sqlite'))) {
+            add('graph', 'warning', 'No graph; run astria run . --backend none');
+            return;
+        }
+        const info = (0, native_1.graphBuildInfo)(path.resolve(opts.graph));
+        const outdated = info.extractionHashVersion !== info.currentExtractionHashVersion;
+        add('graph', outdated ? 'warning' : 'ok', outdated ? 'Extraction rules changed; run astria update .' : `Graph built by Astria ${info.astriaVersion ?? 'unknown'}`);
+        if (info.staleExternalIndexes.length)
+            add('external indexes', 'warning', `Reimport: ${info.staleExternalIndexes.join(', ')}`);
+    });
+    const ok = !checks.some(c => c.status === 'error');
+    if (opts.json)
+        console.log(JSON.stringify({ ok, checks }, null, 2));
+    else
+        for (const c of checks)
+            console.log(`${c.status.toUpperCase()} ${c.name}: ${c.detail}`);
+    if (!ok)
+        process.exitCode = 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../../src/commands/global.ts"],"names":[],"mappings":"AAEA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,iBAYzE;AAED,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,iBAQpD;AAED,wBAAsB,iBAAiB,kBAetC;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,iBAYrE"}
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../../src/commands/global.ts"],"names":[],"mappings":"AAEA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,iBAYzE;AAED,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,iBAQpD;AAED,wBAAsB,iBAAiB,kBAiBtC;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,iBAYrE"}

package/dist/commands/global.js

@@ -36,7 +36,9 @@ async function globalListCommand() {
         }
         console.log('Global graph repos:');
         for (const e of entries) {
-            console.log(`  ${e.tag} — ${e.nodes} nodes, ${e.edges} edges`);
+            console.log(`  ${e.tag} — ${e.nodes} nodes, ${e.edges} edges | ${e.state}`);
+            console.log(`    commit: ${e.sourceCommit ?? 'unknown'} | generation: ${e.graphGeneration ?? 'unknown'}`);
+            console.log(`    source: ${e.root || 'unavailable'} | built: ${e.graphBuiltAt ?? 'unknown'}`);
         }
     }
     catch (e) {

package/dist/commands/global.js.map

@@ -1 +1 @@
-{"version":3,"file":"global.js","sourceRoot":"","sources":["../../src/commands/global.ts"],"names":[],"mappings":";;;;;;AAAA,sCAA4E;AAErE,KAAK,2BAA2B,IAAY,EAAE,IAAqB;IACxE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,kBAAS,EAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,GAAG,iCAAiC,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CACT,UAAU,MAAM,CAAC,UAAU,aAAa,MAAM,CAAC,UAAU,KAAK;YAC5D,iBAAiB,MAAM,CAAC,aAAa,wBAAwB,MAAM,CAAC,kBAAkB,EAAE,CAC3F,CAAC;IACJ,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAEM,KAAK,8BAA8B,GAAW;IACnD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,qBAAY,EAAC,GAAG,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,MAAM,OAAO,gCAAgC,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAEM,KAAK;IACV,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,mBAAU,GAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;YAC/E,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAEM,KAAK,4BAA4B,MAAc,EAAE,MAAc;IACpE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,0BAA0B,MAAM,UAAU,MAAM,IAAI,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../src/commands/global.ts"],"names":[],"mappings":"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"}

package/dist/commands/hook-guard.d.ts

@@ -1,2 +1,22 @@
+export interface SymbolEntry {
+    /** Node id. */
+    i: string;
+    /** Display label, e.g. `hookGuard()`. */
+    l: string;
+    /** Source file as stored in the graph (absolute, forward slashes). */
+    f: string;
+    /** Source line. */
+    n: number;
+    /** Graph degree (edge endpoint count) — used to rank hubs first. */
+    d: number;
+}
+export declare function symbolIndex(gdir: string): SymbolEntry[] | null;
+export declare function contextAlreadyEmitted(gdir: string, key: string, ttlSeconds: number): boolean;
+export declare function markContextEmitted(gdir: string, key: string, ttlSeconds: number): void;
+export declare function extractSearchPattern(command: string): string | null;
+export declare function matchSymbols(index: SymbolEntry[], pattern: string, limit: number): SymbolEntry[];
+export declare function symbolsInFile(index: SymbolEntry[], root: string, absPath: string): SymbolEntry[];
+export declare function displayPath(root: string, f: string): string;
+export declare function formatSymbolList(entries: SymbolEntry[], root: string, limit: number): string;
 export declare function hookGuard(mode: string, _args: string[]): void;
 //# sourceMappingURL=hook-guard.d.ts.map

package/dist/commands/hook-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook-guard.d.ts","sourceRoot":"","sources":["../../src/commands/hook-guard.ts"],"names":[],"mappings":"AAiFA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAmF7D"}
+{"version":3,"file":"hook-guard.d.ts","sourceRoot":"","sources":["../../src/commands/hook-guard.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,WAAW;IAC1B,eAAe;IACf,CAAC,EAAE,MAAM,CAAC;IACV,yCAAyC;IACzC,CAAC,EAAE,MAAM,CAAC;IACV,sEAAsE;IACtE,CAAC,EAAE,MAAM,CAAC;IACV,mBAAmB;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,oEAAoE;IACpE,CAAC,EAAE,MAAM,CAAC;CACX;AAiGD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,IAAI,CAkD9D;AAUD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAQ5F;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAsBtF;AAYD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyBnE;AAKD,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAwBhG;AAMD,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAahG;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAK3D;AAcD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM5F;AAOD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAgI7D"}