@mka-rainmaker/ama 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import * as fs from "node:fs";
+import { serverStamp } from "../mcp/build-info.js";
+import { isEntrypoint } from "../runtime/entrypoint.js";
+import { ensureBaselineWasmTier } from "../runtime/wasm-tier.js";
+import { cyclesCommand } from "./commands/cycles.js";
+import { filesCommand } from "./commands/files.js";
+import { affectedCommand, impactCommand } from "./commands/impact.js";
+import { indexCommand, initCommand, uninitCommand } from "./commands/lifecycle.js";
+import { calleesCommand, callersCommand, exploreCommand, handlersCommand, implementationsCommand, importersCommand, importsCommand, interfacesCommand, nodeCommand, overriddenByCommand, overridesCommand, referrersCommand, returnsCommand, routesCommand, skeletonCommand, typeUsersCommand, typesUsedCommand, } from "./commands/query.js";
+import { searchCodeCommand, searchCommand } from "./commands/search.js";
+import { statusCommand } from "./commands/status.js";
+import { syncCommand } from "./commands/sync.js";
+function usage(commands) {
+    const lines = ["Usage: ama [--json] <command> [args]", "", "Commands:"];
+    // The MCP server is the primary way agents use Ama; the rest are one-shot CLI queries.
+    lines.push(`  ${"mcp".padEnd(12)} serve the code-intelligence MCP server over stdio (for coding agents)`);
+    if (commands.length === 0) {
+        lines.push("  (none registered yet)");
+    }
+    else {
+        for (const command of commands)
+            lines.push(`  ${command.name.padEnd(12)} ${command.summary}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Parse argv and dispatch to a command, returning a process exit code. `out`/`err`
+ * are injectable so the framework is unit-testable without touching real streams.
+ * Unlike the MCP server, the CLI *owns* stdout, so writing results there is fine.
+ */
+export async function run(argv, commands, out = (line) => process.stdout.write(`${line}\n`), err = (line) => process.stderr.write(`${line}\n`)) {
+    const json = argv.includes("--json");
+    const positional = argv.filter((arg) => arg !== "--json");
+    const name = positional[0];
+    if (name === undefined || name === "--help" || name === "-h") {
+        out(usage(commands));
+        return 0;
+    }
+    if (name === "--version" || name === "-v") {
+        out(serverStamp.version);
+        return 0;
+    }
+    const command = commands.find((c) => c.name === name);
+    if (!command) {
+        err(`Unknown command: ${name}`);
+        err(usage(commands));
+        return 1;
+    }
+    const rest = positional.slice(1);
+    // `ama <command> --help` shows the command's own help (and never reaches its
+    // run(), so it can't be misread as an argument), before dispatching.
+    if (rest.includes("--help") || rest.includes("-h")) {
+        out(`ama ${command.name} — ${command.summary}`);
+        if (command.usage)
+            out(command.usage);
+        return 0;
+    }
+    return command.run(rest, { json, write: out, error: err, stdin: readPipedStdin });
+}
+/** Read all of piped stdin synchronously; "" when stdin is a TTY (no pipe) so an
+ *  interactive `ama affected` doesn't block waiting for input. (ama-dx1) */
+function readPipedStdin() {
+    if (process.stdin.isTTY)
+        return "";
+    try {
+        return fs.readFileSync(0, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+/** Registered commands. More domain commands (search/sync/…) are added here
+ * as the CLI epic progresses (ama-5gs.4+). */
+export const COMMANDS = [
+    affectedCommand,
+    calleesCommand,
+    callersCommand,
+    cyclesCommand,
+    exploreCommand,
+    filesCommand,
+    handlersCommand,
+    impactCommand,
+    implementationsCommand,
+    importersCommand,
+    importsCommand,
+    indexCommand,
+    initCommand,
+    interfacesCommand,
+    nodeCommand,
+    overriddenByCommand,
+    overridesCommand,
+    referrersCommand,
+    returnsCommand,
+    routesCommand,
+    searchCodeCommand,
+    searchCommand,
+    skeletonCommand,
+    statusCommand,
+    syncCommand,
+    typeUsersCommand,
+    typesUsedCommand,
+    uninitCommand,
+];
+export async function main() {
+    const argv = process.argv.slice(2);
+    // `ama mcp` serves the code-intelligence MCP protocol over stdio — the entry coding
+    // agents spawn for a local server. WASM is already pinned by the entry guard; the stdio
+    // server owns the process lifecycle (it stays alive on the transport until the client
+    // disconnects), so unlike a query command it must not `process.exit`.
+    if (argv[0] === "mcp") {
+        const { main: serveMcp } = await import("../mcp/server.js");
+        await serveMcp();
+        return;
+    }
+    process.exit(await run(argv, COMMANDS));
+}
+if (isEntrypoint(import.meta.url)) {
+    // Pin grammar WASM to the baseline compiler before any command can load it, or
+    // an indexing command OOMs (ama-rgx). Re-execs once; the supervisor skips main.
+    if (!ensureBaselineWasmTier()) {
+        main().catch((error) => {
+            console.error(error);
+            process.exit(1);
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/paths.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Where a project's persisted index lives by default, mirroring `serve:dev`:
+ * the `AMA_DB` env var wins, else `<root>/.ama/index.db`. Shared by every CLI
+ * command that opens or builds the index.
+ */
+export declare function dbPathFor(root: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/cli/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/cli/paths.js

@@ -0,0 +1,10 @@
+import * as path from "node:path";
+/**
+ * Where a project's persisted index lives by default, mirroring `serve:dev`:
+ * the `AMA_DB` env var wins, else `<root>/.ama/index.db`. Shared by every CLI
+ * command that opens or builds the index.
+ */
+export function dbPathFor(root) {
+    return process.env.AMA_DB ?? path.join(path.resolve(root), ".ama", "index.db");
+}
+//# sourceMappingURL=paths.js.map

package/dist/cli/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AACjF,CAAC"}

package/dist/cli/query-runner.d.ts

@@ -0,0 +1,13 @@
+import { QueryService } from "../query/service.js";
+/**
+ * Open the persisted index read-only, run `fn` against a {@link QueryService},
+ * and close. Returns `undefined` when there is no usable index (callers map that
+ * to "run `ama index`"). The single open/close path shared by the read-query
+ * commands — `Indexer.open` does not fall back to a full build on a miss.
+ *
+ * Note the `undefined` here means "no index", which can collide with a query
+ * that itself returns `undefined` (e.g. `node` on a missing symbol). Wrap such
+ * results in an object so the two cases stay distinguishable.
+ */
+export declare function withQuery<T>(root: string, fn: (query: QueryService) => T): Promise<T | undefined>;
+//# sourceMappingURL=query-runner.d.ts.map

package/dist/cli/query-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-runner.d.ts","sourceRoot":"","sources":["../../src/cli/query-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,CAAC,GAC7B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAYxB"}

package/dist/cli/query-runner.js

@@ -0,0 +1,33 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { createDefaultIndexer } from "../indexer/indexer.js";
+import { QueryService } from "../query/service.js";
+import { SqliteStore } from "../store/sqlite.js";
+import { dbPathFor } from "./paths.js";
+/**
+ * Open the persisted index read-only, run `fn` against a {@link QueryService},
+ * and close. Returns `undefined` when there is no usable index (callers map that
+ * to "run `ama index`"). The single open/close path shared by the read-query
+ * commands — `Indexer.open` does not fall back to a full build on a miss.
+ *
+ * Note the `undefined` here means "no index", which can collide with a query
+ * that itself returns `undefined` (e.g. `node` on a missing symbol). Wrap such
+ * results in an object so the two cases stay distinguishable.
+ */
+export async function withQuery(root, fn) {
+    const dbPath = dbPathFor(root);
+    if (!fs.existsSync(dbPath))
+        return undefined;
+    const abs = path.resolve(root);
+    const indexer = createDefaultIndexer(() => new SqliteStore(dbPath));
+    const opened = await indexer.open(abs);
+    if (!opened)
+        return undefined;
+    try {
+        return fn(new QueryService(opened.store, abs));
+    }
+    finally {
+        opened.store.close();
+    }
+}
+//# sourceMappingURL=query-runner.js.map

package/dist/cli/query-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-runner.js","sourceRoot":"","sources":["../../src/cli/query-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAY,EACZ,EAA8B;IAE9B,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,EAAE,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/graph/dispatch.d.ts

@@ -0,0 +1,17 @@
+import type { GraphEdge, GraphNode } from "./types.js";
+/**
+ * Derive the dispatch edges of a graph: `Overrides` edges (a subtype method
+ * overriding/implementing a supertype method of the same name) and the fan-out of
+ * interface/superclass method calls to each subtype's implementation. Both are
+ * whole-graph inferences over `Implements`/`Inherits`/`Defines`/`Calls` edges, so
+ * they can only be computed with the *full* node/edge set in view — which is why
+ * a single-file reindex can't reproduce them and the indexer re-derives them over
+ * the whole store instead (ama-tr1). Pure: returns the derived edges (tagged
+ * `provenance: "dispatch"`) rather than mutating its input, so the same function
+ * serves the per-batch analyze() and the store-level re-derivation.
+ *
+ * Only the input `edges` are fanned (never the freshly-derived ones), so a
+ * fan-out never cascades. Language-agnostic — it reads node/edge *kinds* only.
+ */
+export declare function deriveDispatchEdges(nodes: GraphNode[], edges: GraphEdge[]): GraphEdge[];
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/graph/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/graph/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CA6DvF"}

package/dist/graph/dispatch.js

@@ -0,0 +1,82 @@
+/**
+ * Derive the dispatch edges of a graph: `Overrides` edges (a subtype method
+ * overriding/implementing a supertype method of the same name) and the fan-out of
+ * interface/superclass method calls to each subtype's implementation. Both are
+ * whole-graph inferences over `Implements`/`Inherits`/`Defines`/`Calls` edges, so
+ * they can only be computed with the *full* node/edge set in view — which is why
+ * a single-file reindex can't reproduce them and the indexer re-derives them over
+ * the whole store instead (ama-tr1). Pure: returns the derived edges (tagged
+ * `provenance: "dispatch"`) rather than mutating its input, so the same function
+ * serves the per-batch analyze() and the store-level re-derivation.
+ *
+ * Only the input `edges` are fanned (never the freshly-derived ones), so a
+ * fan-out never cascades. Language-agnostic — it reads node/edge *kinds* only.
+ */
+export function deriveDispatchEdges(nodes, edges) {
+    const byId = new Map(nodes.map((n) => [n.id, n]));
+    const definerOf = new Map(); // member id -> container id
+    const subtypes = new Map(); // supertype id -> implementing/extending subtype ids
+    const methodsByContainer = new Map(); // container -> name -> method id
+    for (const edge of edges) {
+        if (edge.kind === "Defines") {
+            definerOf.set(edge.to, edge.from);
+            const member = byId.get(edge.to);
+            if (member?.kind === "Method") {
+                const byName = methodsByContainer.get(edge.from) ?? new Map();
+                byName.set(member.name, edge.to);
+                methodsByContainer.set(edge.from, byName);
+            }
+        }
+        else if (edge.kind === "Implements" || edge.kind === "Inherits") {
+            const list = subtypes.get(edge.to) ?? [];
+            list.push(edge.from);
+            subtypes.set(edge.to, list);
+        }
+    }
+    const derived = [];
+    // Overrides: a subtype method of the same name as a supertype method
+    // overrides/implements it. Independent of any call. (ama-hft.11)
+    for (const [superId, subIds] of subtypes) {
+        const superMethods = methodsByContainer.get(superId);
+        if (!superMethods)
+            continue;
+        for (const subId of subIds) {
+            const subMethods = methodsByContainer.get(subId);
+            if (!subMethods)
+                continue;
+            for (const [name, subMethodId] of subMethods) {
+                const superMethodId = superMethods.get(name);
+                if (superMethodId && superMethodId !== subMethodId) {
+                    derived.push({
+                        from: subMethodId,
+                        to: superMethodId,
+                        kind: "Overrides",
+                        provenance: "dispatch",
+                    });
+                }
+            }
+        }
+    }
+    // Fan-out: a call to a super/interface method may reach each subtype's override.
+    for (const edge of edges) {
+        if (edge.kind !== "Calls")
+            continue;
+        const target = byId.get(edge.to);
+        if (target?.kind !== "Method")
+            continue;
+        const container = definerOf.get(edge.to);
+        if (!container)
+            continue;
+        const containerKind = byId.get(container)?.kind;
+        if (containerKind !== "Interface" && containerKind !== "Class")
+            continue;
+        for (const subId of subtypes.get(container) ?? []) {
+            const override = methodsByContainer.get(subId)?.get(target.name);
+            if (override && override !== edge.to) {
+                derived.push({ from: edge.from, to: override, kind: "Calls", provenance: "dispatch" });
+            }
+        }
+    }
+    return derived;
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/graph/dispatch.js.map

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

package/dist/graph/id.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Stable, location-independent identifiers for graph symbols.
+ *
+ * An id is derived from *where a symbol lives in the module namespace* (file +
+ * dotted qualified name), never from its byte offset or line. Moving a function
+ * within its file therefore keeps its id — which is what lets the graph survive
+ * incremental edits without re-linking every edge.
+ */
+export interface SymbolLocation {
+    /** Repo-relative file path, e.g. "src/a.ts". */
+    file: string;
+    /** Dotted qualified name within the file, e.g. "Cls.method" or "foo". */
+    qualifiedName: string;
+}
+/** Stable id for a symbol node (function, method, class, …). */
+export declare function symbolId(loc: SymbolLocation): string;
+/** Stable id for a File node — the repo-relative path itself. */
+export declare function fileId(file: string): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/graph/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/graph/id.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAEpD;AAED,iEAAiE;AACjE,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C"}

package/dist/graph/id.js

@@ -0,0 +1,17 @@
+/**
+ * Stable, location-independent identifiers for graph symbols.
+ *
+ * An id is derived from *where a symbol lives in the module namespace* (file +
+ * dotted qualified name), never from its byte offset or line. Moving a function
+ * within its file therefore keeps its id — which is what lets the graph survive
+ * incremental edits without re-linking every edge.
+ */
+/** Stable id for a symbol node (function, method, class, …). */
+export function symbolId(loc) {
+    return `${loc.file}#${loc.qualifiedName}`;
+}
+/** Stable id for a File node — the repo-relative path itself. */
+export function fileId(file) {
+    return file;
+}
+//# sourceMappingURL=id.js.map

package/dist/graph/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/graph/id.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,gEAAgE;AAChE,MAAM,UAAU,QAAQ,CAAC,GAAmB;IAC1C,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;AAC5C,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/graph/index.d.ts

@@ -0,0 +1,6 @@
+export type { NodeKind, EdgeKind, EdgeProvenance, Tier, SourceRange, GraphNode, GraphEdge, } from "./types.js";
+export { NODE_KINDS, EDGE_KINDS } from "./types.js";
+export { deriveDispatchEdges } from "./dispatch.js";
+export { symbolId, fileId } from "./id.js";
+export type { SymbolLocation } from "./id.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,IAAI,EACJ,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/dist/graph/index.js

@@ -0,0 +1,4 @@
+export { NODE_KINDS, EDGE_KINDS } from "./types.js";
+export { deriveDispatchEdges } from "./dispatch.js";
+export { symbolId, fileId } from "./id.js";
+//# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC"}

package/dist/graph/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Language-agnostic graph model: the vocabulary every analyzer emits and every
+ * query reads. Kept deliberately small for the MVP; new kinds are added as
+ * analyzers learn to resolve them.
+ */
+/** The node kinds, as a runtime array — the single source of truth (e.g. for
+ * validating a `kind` filter). `NodeKind` is derived from it, so the two stay
+ * in sync. */
+export declare const NODE_KINDS: readonly ["File", "Module", "Class", "Interface", "Enum", "TypeAlias", "Function", "Method", "Property", "Variable", "Route", "Component"];
+export type NodeKind = (typeof NODE_KINDS)[number];
+/** The edge kinds, as a runtime array — the single source of truth (e.g. for
+ * validating an edge over the wire). `EdgeKind` is derived from it, so the two stay
+ * in sync. Mirrors {@link NODE_KINDS}. */
+export declare const EDGE_KINDS: readonly ["Defines", "Calls", "Instantiates", "Overrides", "Inherits", "Implements", "UsesType", "Returns", "Imports", "ImportsType", "References"];
+export type EdgeKind = (typeof EDGE_KINDS)[number];
+/** Which analysis tier produced a piece of data. */
+export type Tier = "deep" | "baseline";
+/** 1-based, inclusive source span — used for snippet extraction, never for ids. */
+export interface SourceRange {
+    startLine: number;
+    endLine: number;
+}
+export interface GraphNode {
+    /** Stable, location-independent id (see {@link ./id.ts}). */
+    id: string;
+    kind: NodeKind;
+    /** Simple (unqualified) name, e.g. "method". */
+    name: string;
+    /** Repo-relative file the symbol lives in, e.g. "src/a.ts". */
+    file: string;
+    /** Dotted qualified name within the file, e.g. "Cls.method". */
+    qualifiedName: string;
+    /** Source span for snippet extraction; absent for synthetic nodes. */
+    range?: SourceRange;
+    /** Tier of the analyzer that produced this node. */
+    tier: Tier;
+}
+/**
+ * How an edge was derived. `resolved` (the default when absent) means a
+ * type-checker- or symbol-backed fact; `heuristic` means a pattern/string match
+ * that isn't checker-verified (route detection, callback-handler synthesis);
+ * `dispatch` means a whole-graph inference from interface/inheritance fan-out (an
+ * interface-method call reaching each implementation, and Overrides edges) — a
+ * "may-reach", not a proven direct call. Lets query results label edge trust — the
+ * node-level tier honesty rule, at edge level. `dispatch` also marks the edges the
+ * indexer re-derives after an incremental reindex (ama-tr1).
+ */
+export type EdgeProvenance = "resolved" | "heuristic" | "dispatch";
+export interface GraphEdge {
+    /** Source node id. */
+    from: string;
+    /** Target node id. */
+    to: string;
+    kind: EdgeKind;
+    /** How the edge was derived; absent ⇒ `resolved`. */
+    provenance?: EdgeProvenance;
+    /** Where the edge originates — a call/new site's 1-based line and column. With
+     *  dedup on (from,to,kind), this is the first such site. Absent for edges with
+     *  no single source point (Defines, Imports). (ama-hft.9) */
+    at?: {
+        line: number;
+        column: number;
+    };
+    /** Every call/construction site for this edge, when a caller invokes a target
+     *  more than once (`sites[0] === at`). Absent for single-site edges. (ama-hft.10) */
+    sites?: {
+        line: number;
+        column: number;
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/graph/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;cAEc;AACd,eAAO,MAAM,UAAU,4IAgBb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;0CAE0C;AAC1C,eAAO,MAAM,UAAU,qJAsBb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,oDAAoD;AACpD,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvC,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,oDAAoD;IACpD,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,qDAAqD;IACrD,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;iEAE6D;IAC7D,EAAE,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC;yFACqF;IACrF,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5C"}

package/dist/graph/types.js

@@ -0,0 +1,52 @@
+/**
+ * Language-agnostic graph model: the vocabulary every analyzer emits and every
+ * query reads. Kept deliberately small for the MVP; new kinds are added as
+ * analyzers learn to resolve them.
+ */
+/** The node kinds, as a runtime array — the single source of truth (e.g. for
+ * validating a `kind` filter). `NodeKind` is derived from it, so the two stay
+ * in sync. */
+export const NODE_KINDS = [
+    "File",
+    "Module",
+    "Class",
+    "Interface",
+    "Enum",
+    "TypeAlias",
+    "Function",
+    "Method",
+    "Property",
+    /** A module-level variable/constant binding, e.g. `const MAX_RETRIES = 3`. */
+    "Variable",
+    /** A framework route, e.g. "GET /users" — its handler is found via a References edge. */
+    "Route",
+    /** A UI component — a JSX-returning function (React) or a Vue `defineComponent`. */
+    "Component",
+];
+/** The edge kinds, as a runtime array — the single source of truth (e.g. for
+ * validating an edge over the wire). `EdgeKind` is derived from it, so the two stay
+ * in sync. Mirrors {@link NODE_KINDS}. */
+export const EDGE_KINDS = [
+    "Defines",
+    "Calls",
+    /** A `new X()` construction — distinct from a plain Calls so "who instantiates
+     *  X" is separable from "who calls X". (ama-hft.11) */
+    "Instantiates",
+    /** A subtype method that overrides/implements a supertype method of the same
+     *  name (subtype.method → supertype.method). (ama-hft.11) */
+    "Overrides",
+    "Inherits",
+    "Implements",
+    "UsesType",
+    /** A function/method → its declared return type, distinct from the param/property
+     *  type usages of UsesType. (ama-37c) */
+    "Returns",
+    "Imports",
+    /** A type-only import (`import type` / `import { type X }`) — a compile-time
+     *  dependency erased at runtime. Counted as an import for dependents/affected,
+     *  but excluded from runtime analyses like circular_imports. */
+    "ImportsType",
+    /** A route (or other dispatch) refers to the symbol that handles it. */
+    "References",
+];
+//# sourceMappingURL=types.js.map

package/dist/graph/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;cAEc;AACd,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,MAAM;IACN,QAAQ;IACR,OAAO;IACP,WAAW;IACX,MAAM;IACN,WAAW;IACX,UAAU;IACV,QAAQ;IACR,UAAU;IACV,8EAA8E;IAC9E,UAAU;IACV,yFAAyF;IACzF,OAAO;IACP,oFAAoF;IACpF,WAAW;CACH,CAAC;AAIX;;0CAE0C;AAC1C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS;IACT,OAAO;IACP;2DACuD;IACvD,cAAc;IACd;iEAC6D;IAC7D,WAAW;IACX,UAAU;IACV,YAAY;IACZ,UAAU;IACV;6CACyC;IACzC,SAAS;IACT,SAAS;IACT;;oEAEgE;IAChE,aAAa;IACb,wEAAwE;IACxE,YAAY;CACJ,CAAC"}

package/dist/indexer/debouncer.d.ts

@@ -0,0 +1,32 @@
+/** Runs a sync for one changed path. */
+export type SyncFn = (rel: string) => Promise<void>;
+/**
+ * Collapses bursts of file-change events into batched syncs. Each `notify(rel)`
+ * adds the path to a pending set and (re)arms a trailing timer; when the window
+ * elapses quietly, every pending path is synced once. A single flush runs at a
+ * time — paths that arrive while one is in progress are batched into the next —
+ * and a failing sync is isolated so the rest of the batch still runs.
+ *
+ * The debounce window collapses the several `fs.watch` events a single save can
+ * emit into one re-index. Drives ama-gd5.3's auto-sync; reusable anywhere a
+ * stream of keyed events should settle before acting.
+ */
+export declare class Debouncer {
+    private readonly sync;
+    private readonly windowMs;
+    private readonly pending;
+    private timer?;
+    private flushing;
+    constructor(sync: SyncFn, windowMs: number);
+    /** Record a changed path and (re)start the trailing window. */
+    notify(rel: string): void;
+    /** Pending paths not yet synced — for surfacing sync status (ama-gd5.6). */
+    get pendingCount(): number;
+    /** The actual queued paths — for naming stale files in a banner (ama-gd5.5). */
+    pendingPaths(): string[];
+    /** Cancel the pending window. Does not flush — stopping accepts staleness. */
+    stop(): void;
+    private arm;
+    private flush;
+}
+//# sourceMappingURL=debouncer.d.ts.map

package/dist/indexer/debouncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debouncer.d.ts","sourceRoot":"","sources":["../../src/indexer/debouncer.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,qBAAa,SAAS;IAMlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAS;gBAGN,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM;IAGnC,+DAA+D;IAC/D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB,4EAA4E;IAC5E,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,gFAAgF;IAChF,YAAY,IAAI,MAAM,EAAE;IAIxB,8EAA8E;IAC9E,IAAI,IAAI,IAAI;IAOZ,OAAO,CAAC,GAAG;YAQG,KAAK;CAyBpB"}