@mka-rainmaker/ama 0.1.0

package/dist/cli/commands/query.js

@@ -0,0 +1,187 @@
+import { emitError } from "../emit.js";
+import { withQuery } from "../query-runner.js";
+const NO_INDEX = "No index found. Run `ama index` first.";
+/** One compact line per node: kind, qualified name, location, tier. */
+export function nodeLine(node) {
+    const where = node.range ? `${node.file}:${node.range.startLine}` : node.file;
+    return `  ${node.kind.padEnd(10)} ${node.qualifiedName || node.name}  ${where}  [${node.tier}]`;
+}
+/** Comma-separated qualified names, for the compact relationship summaries. */
+function names(nodes) {
+    return nodes.map((n) => n.qualifiedName || n.name).join(", ");
+}
+/** Render a node list (callers/callees) for the terminal, or `--json`. */
+export function renderNodeList(label, ref, nodes, json) {
+    if (json)
+        return JSON.stringify(nodes, null, 2);
+    if (nodes.length === 0)
+        return `No ${label} found for "${ref}".`;
+    const lines = [`${nodes.length} ${label} of "${ref}":`];
+    for (const node of nodes)
+        lines.push(nodeLine(node));
+    return lines.join("\n");
+}
+/** Render a {@link NodeView} (the `node` command) for the terminal, or `--json`. */
+export function renderNodeView(view, json) {
+    if (json)
+        return JSON.stringify(view, null, 2);
+    const lines = [nodeLine(view.node).trimStart()];
+    // The symbol's own source — the point of a single-symbol detail view.
+    if (view.snippet)
+        lines.push("", view.snippet.text, "");
+    lines.push(`  callers (${view.callers.length}): ${names(view.callers)}`, `  callees (${view.callees.length}): ${names(view.callees)}`, `  referrers (${view.referrers.length}): ${names(view.referrers)}`, `  dependents (${view.dependents.length}): ${names(view.dependents)}`);
+    return lines.join("\n");
+}
+/** Render a {@link FileSkeleton} (the `skeleton` command) for the terminal, or `--json`. */
+export function renderFileSkeleton(skeleton, json) {
+    if (json)
+        return JSON.stringify(skeleton, null, 2);
+    const lines = [
+        `${skeleton.file.file} — ${skeleton.symbols.length} symbol(s), ` +
+            `${skeleton.dependents.length} dependent(s)`,
+    ];
+    for (const sym of skeleton.symbols)
+        lines.push(nodeLine(sym));
+    lines.push(`  dependents (${skeleton.dependents.length}): ${names(skeleton.dependents)}`);
+    return lines.join("\n");
+}
+/** Render an {@link Exploration} (the `explore` command) for the terminal, or `--json`. */
+export function renderExploration(exploration, json) {
+    if (json)
+        return JSON.stringify(exploration, null, 2);
+    const files = Object.entries(exploration.byFile);
+    const shown = exploration.relationships.length;
+    const matchSummary = exploration.totalMatches > shown
+        ? `showing top ${shown} of ${exploration.totalMatches} matches in ${files.length} file(s) (narrow the query to see more)`
+        : `matches in ${files.length} file(s)`;
+    const lines = [`Exploring "${exploration.question}" — ${matchSummary}:`];
+    for (const [file, nodes] of files)
+        lines.push(`  ${file}: ${names(nodes)}`);
+    const blast = exploration.blastRadius.length;
+    const blastSummary = exploration.totalBlastRadius > blast
+        ? `${blast} of ${exploration.totalBlastRadius} symbol(s)`
+        : `${blast} symbol(s)`;
+    lines.push(`blast radius: ${blastSummary}`);
+    return lines.join("\n");
+}
+/** Build a `callers`/`callees`-style command from the QueryService method it wraps. */
+function refQueryCommand(name, summary, pick) {
+    return {
+        name,
+        summary,
+        usage: `Usage: ama ${name} <symbol>`,
+        async run(args, ctx) {
+            const ref = args[0];
+            if (ref === undefined) {
+                emitError(ctx, `Usage: ama ${name} <symbol>`);
+                return 1;
+            }
+            const nodes = await withQuery(process.env.AMA_ROOT ?? ".", (query) => pick(query, ref));
+            if (nodes === undefined) {
+                emitError(ctx, NO_INDEX);
+                return 1;
+            }
+            ctx.write(renderNodeList(name, ref, nodes, ctx.json));
+            return 0;
+        },
+    };
+}
+export const callersCommand = refQueryCommand("callers", "List the callers of a symbol", (q, ref) => q.findCallers(ref).map((c) => c.symbol));
+export const calleesCommand = refQueryCommand("callees", "List what a symbol calls", (q, ref) => q.findCallees(ref).map((c) => c.symbol));
+export const implementationsCommand = refQueryCommand("implementations", "List classes that implement an interface", (q, ref) => q.findImplementations(ref));
+export const interfacesCommand = refQueryCommand("interfaces", "List interfaces a class implements", (q, ref) => q.findInterfaces(ref));
+export const importersCommand = refQueryCommand("importers", "List files that import a file or symbol", (q, ref) => q.findImporters(ref));
+export const importsCommand = refQueryCommand("imports", "List what a file imports", (q, ref) => q.findImports(ref));
+export const typeUsersCommand = refQueryCommand("type-users", "List symbols that use a type", (q, ref) => q.findTypeUsers(ref));
+export const typesUsedCommand = refQueryCommand("types-used", "List the types a symbol uses", (q, ref) => q.findTypesUsed(ref));
+export const returnsCommand = refQueryCommand("returns", "List the named type(s) a function or method returns", (q, ref) => q.findReturns(ref));
+export const handlersCommand = refQueryCommand("handlers", "List the handler(s) a route maps to", (q, ref) => q.findHandlers(ref).map((h) => h.symbol));
+export const routesCommand = refQueryCommand("routes", "List the routes that map to a symbol", (q, ref) => q.findRoutes(ref).map((r) => r.symbol));
+export const referrersCommand = refQueryCommand("referrers", "List everything that references a symbol (variable readers, routes, dispatch)", (q, ref) => q.findReferrers(ref).map((r) => r.symbol));
+export const overridesCommand = refQueryCommand("overrides", "List the supertype methods a method overrides/implements", (q, ref) => q.findOverrides(ref).map((o) => o.symbol));
+export const overriddenByCommand = refQueryCommand("overridden-by", "List the methods that override a method", (q, ref) => q.findOverriddenBy(ref).map((o) => o.symbol));
+export const nodeCommand = {
+    name: "node",
+    summary: "Show a symbol with its callers, callees, and dependents",
+    usage: "Usage: ama node <symbol>",
+    async run(args, ctx) {
+        const ref = args[0];
+        if (ref === undefined) {
+            emitError(ctx, "Usage: ama node <symbol>");
+            return 1;
+        }
+        // Wrap so the outer undefined ("no index") stays distinct from node()'s own
+        // undefined ("symbol not found").
+        const result = await withQuery(process.env.AMA_ROOT ?? ".", (query) => ({
+            view: query.node(ref),
+        }));
+        if (result === undefined) {
+            emitError(ctx, NO_INDEX);
+            return 1;
+        }
+        if (result.view === undefined) {
+            emitError(ctx, `Symbol not found: ${ref}`);
+            return 1;
+        }
+        ctx.write(renderNodeView(result.view, ctx.json));
+        return 0;
+    },
+};
+export const skeletonCommand = {
+    name: "skeleton",
+    summary: "Show a file's symbol outline and the files that depend on it",
+    usage: "Usage: ama skeleton <file>",
+    async run(args, ctx) {
+        const ref = args[0];
+        if (ref === undefined) {
+            emitError(ctx, "Usage: ama skeleton <file>");
+            return 1;
+        }
+        // Wrap so the outer undefined ("no index") stays distinct from
+        // fileSkeleton()'s own undefined ("file not found").
+        const result = await withQuery(process.env.AMA_ROOT ?? ".", (query) => ({
+            skeleton: query.fileSkeleton(ref),
+        }));
+        if (result === undefined) {
+            emitError(ctx, NO_INDEX);
+            return 1;
+        }
+        if (result.skeleton === undefined) {
+            emitError(ctx, `File not found: ${ref}`);
+            return 1;
+        }
+        ctx.write(renderFileSkeleton(result.skeleton, ctx.json));
+        return 0;
+    },
+};
+export const exploreCommand = {
+    name: "explore",
+    summary: "Explore symbols matching a question and their blast radius",
+    usage: "Usage: ama explore [--limit N] <question>",
+    async run(args, ctx) {
+        let limit;
+        const words = [];
+        for (let i = 0; i < args.length; i++) {
+            if (args[i] === "--limit" && i + 1 < args.length) {
+                const n = Number(args[++i]);
+                if (Number.isInteger(n) && n > 0)
+                    limit = n;
+                continue;
+            }
+            words.push(args[i]);
+        }
+        const question = words.join(" ").trim();
+        if (question === "") {
+            emitError(ctx, "Usage: ama explore [--limit N] <question>");
+            return 1;
+        }
+        const exploration = await withQuery(process.env.AMA_ROOT ?? ".", (query) => query.explore(question, { limit }));
+        if (exploration === undefined) {
+            emitError(ctx, NO_INDEX);
+            return 1;
+        }
+        ctx.write(renderExploration(exploration, ctx.json));
+        return 0;
+    },
+};
+//# sourceMappingURL=query.js.map

package/dist/cli/commands/query.js.map

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

package/dist/cli/commands/search.d.ts

@@ -0,0 +1,21 @@
+import { type GraphNode, type NodeKind } from "../../graph/types.js";
+import type { CliCommand } from "../index.js";
+/** Result of parsing `search` arguments: the query plus filters, or an error. */
+export interface SearchArgs {
+    query?: string;
+    kind?: NodeKind;
+    limit?: number;
+    error?: string;
+}
+/**
+ * Parse `search` positionals/flags. Returns `{ error }` (not a throw) on bad
+ * input so the command can print usage and exit 1; `--kind` is validated against
+ * {@link NODE_KINDS}, the single source of truth shared with the MCP schema.
+ */
+export declare function parseSearchArgs(args: string[]): SearchArgs;
+/** Render search hits for the terminal, or `--json` (the raw node array).
+ *  `lowConfidence` appends a refine-the-query nudge in human mode (ama-b79). */
+export declare function renderSearch(query: string, nodes: GraphNode[], json: boolean, lowConfidence?: boolean): string;
+export declare const searchCommand: CliCommand;
+export declare const searchCodeCommand: CliCommand;
+//# sourceMappingURL=search.d.ts.map

package/dist/cli/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAc,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQ9C,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA8B1D;AAED;gFACgF;AAChF,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,EAAE,EAClB,IAAI,EAAE,OAAO,EACb,aAAa,UAAQ,GACpB,MAAM,CAaR;AAwBD,eAAO,MAAM,aAAa,EAAE,UAmB3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,UAyC/B,CAAC"}

package/dist/cli/commands/search.js

@@ -0,0 +1,160 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { NODE_KINDS } from "../../graph/types.js";
+import { createDefaultIndexer } from "../../indexer/indexer.js";
+import { QueryService } from "../../query/service.js";
+import { SqliteStore } from "../../store/sqlite.js";
+import { emitError } from "../emit.js";
+import { dbPathFor } from "../paths.js";
+import { withQuery } from "../query-runner.js";
+const USAGE = "Usage: ama search <query> [--kind <Kind>] [--limit <N>]\n" +
+    "  query may include inline filters: path:src/api kind:Function lang:python name:handler";
+/**
+ * Parse `search` positionals/flags. Returns `{ error }` (not a throw) on bad
+ * input so the command can print usage and exit 1; `--kind` is validated against
+ * {@link NODE_KINDS}, the single source of truth shared with the MCP schema.
+ */
+export function parseSearchArgs(args) {
+    let query;
+    let kind;
+    let limit;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === undefined)
+            continue;
+        if (arg === "--kind") {
+            const value = args[i + 1];
+            i++;
+            if (value === undefined)
+                return { error: "--kind requires a value" };
+            if (!NODE_KINDS.includes(value)) {
+                return { error: `unknown --kind: ${value} (expected one of ${NODE_KINDS.join(", ")})` };
+            }
+            kind = value;
+        }
+        else if (arg === "--limit") {
+            const value = args[i + 1];
+            i++;
+            const n = Number(value);
+            if (!Number.isInteger(n) || n <= 0)
+                return { error: "--limit requires a positive integer" };
+            limit = n;
+        }
+        else if (arg.startsWith("--")) {
+            return { error: `unknown flag: ${arg}` };
+        }
+        else if (query === undefined) {
+            query = arg;
+        }
+        else {
+            return { error: `unexpected argument: ${arg}` };
+        }
+    }
+    return { query, kind, limit };
+}
+/** Render search hits for the terminal, or `--json` (the raw node array).
+ *  `lowConfidence` appends a refine-the-query nudge in human mode (ama-b79). */
+export function renderSearch(query, nodes, json, lowConfidence = false) {
+    if (json)
+        return JSON.stringify(nodes, null, 2);
+    if (nodes.length === 0)
+        return `No symbols match "${query}".`;
+    const lines = [`${nodes.length} result${nodes.length === 1 ? "" : "s"} for "${query}":`];
+    for (const node of nodes) {
+        const where = node.range ? `${node.file}:${node.range.startLine}` : node.file;
+        const label = node.qualifiedName || node.name;
+        lines.push(`  ${node.kind.padEnd(10)} ${label}  ${where}  [${node.tier}]`);
+    }
+    if (lowConfidence) {
+        lines.push("  ⚠️  no exact or prefix match — loose substring hits; refine the query.");
+    }
+    return lines.join("\n");
+}
+/**
+ * Open the persisted index read-only and run the query. Returns `undefined`
+ * (not `[]`) when there is no usable index, so the command can distinguish
+ * "no index" from "indexed, zero matches".
+ */
+async function runSearch(root, opts) {
+    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 new QueryService(opened.store, abs).searchSymbolWithConfidence(opts.query ?? "", {
+            kind: opts.kind,
+            limit: opts.limit,
+        });
+    }
+    finally {
+        opened.store.close();
+    }
+}
+export const searchCommand = {
+    name: "search",
+    summary: "Find symbols by name, with inline path:/kind:/lang:/name: filters",
+    usage: USAGE,
+    async run(args, ctx) {
+        const parsed = parseSearchArgs(args);
+        if (parsed.error !== undefined || parsed.query === undefined) {
+            emitError(ctx, parsed.error ? `${parsed.error}\n${USAGE}` : USAGE);
+            return 1;
+        }
+        const root = process.env.AMA_ROOT ?? ".";
+        const hit = await runSearch(root, parsed);
+        if (hit === undefined) {
+            emitError(ctx, "No index found. Run `ama index` first.");
+            return 1;
+        }
+        ctx.write(renderSearch(parsed.query, hit.results, ctx.json, hit.lowConfidence));
+        return 0;
+    },
+};
+export const searchCodeCommand = {
+    name: "search-code",
+    summary: "Find symbols whose body text contains a string",
+    usage: "Usage: ama search-code <text> [--limit <N>]",
+    async run(args, ctx) {
+        let limit;
+        const terms = [];
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            if (arg === undefined)
+                continue;
+            if (arg === "--limit") {
+                const value = args[i + 1];
+                i++;
+                const n = Number(value);
+                if (!Number.isInteger(n) || n <= 0) {
+                    emitError(ctx, "--limit requires a positive integer");
+                    return 1;
+                }
+                limit = n;
+            }
+            else if (arg.startsWith("--")) {
+                emitError(ctx, `unknown flag: ${arg}`);
+                return 1;
+            }
+            else {
+                terms.push(arg);
+            }
+        }
+        const query = terms.join(" ");
+        if (query === "") {
+            emitError(ctx, "Usage: ama search-code <text> [--limit <N>]");
+            return 1;
+        }
+        const hits = await withQuery(process.env.AMA_ROOT ?? ".", (q) => q.searchCode(query, { limit }));
+        if (hits === undefined) {
+            emitError(ctx, "No index found. Run `ama index` first.");
+            return 1;
+        }
+        ctx.write(renderSearch(query, hits, ctx.json));
+        return 0;
+    },
+};
+//# sourceMappingURL=search.js.map

package/dist/cli/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAkB,UAAU,EAAiB,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAqB,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,KAAK,GACT,2DAA2D;IAC3D,yFAAyF,CAAC;AAU5F;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAc;IAC5C,IAAI,KAAyB,CAAC;IAC9B,IAAI,IAA0B,CAAC;IAC/B,IAAI,KAAyB,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,CAAC,EAAE,CAAC;YACJ,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;YACrE,IAAI,CAAE,UAAgC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,OAAO,EAAE,KAAK,EAAE,mBAAmB,KAAK,qBAAqB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAC1F,CAAC;YACD,IAAI,GAAG,KAAiB,CAAC;QAC3B,CAAC;aAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,CAAC,EAAE,CAAC;YACJ,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;YAC5F,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,iBAAiB,GAAG,EAAE,EAAE,CAAC;QAC3C,CAAC;aAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,KAAK,GAAG,GAAG,CAAC;QACd,CAAC;aAAM,CAAC;YACN,OAAO,EAAE,KAAK,EAAE,wBAAwB,GAAG,EAAE,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC;AAED;gFACgF;AAChF,MAAM,UAAU,YAAY,CAC1B,KAAa,EACb,KAAkB,EAClB,IAAa,EACb,aAAa,GAAG,KAAK;IAErB,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,qBAAqB,KAAK,IAAI,CAAC;IAC9D,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,UAAU,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC;IACzF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,KAAK,KAAK,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,IAAgB;IACrD,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,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,0BAA0B,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE;YACtF,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAe;IACvC,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,mEAAmE;IAC5E,KAAK,EAAE,KAAK;IACZ,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;QACjB,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7D,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACnE,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,SAAS,CAAC,GAAG,EAAE,wCAAwC,CAAC,CAAC;YACzD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,CAAC;IACX,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,gDAAgD;IACzD,KAAK,EAAE,6CAA6C;IACpD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;QACjB,IAAI,KAAyB,CAAC;QAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAS;YAChC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1B,CAAC,EAAE,CAAC;gBACJ,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnC,SAAS,CAAC,GAAG,EAAE,qCAAqC,CAAC,CAAC;oBACtD,OAAO,CAAC,CAAC;gBACX,CAAC;gBACD,KAAK,GAAG,CAAC,CAAC;YACZ,CAAC;iBAAM,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,EAAE,CAAC,CAAC;gBACvC,OAAO,CAAC,CAAC;YACX,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACjB,SAAS,CAAC,GAAG,EAAE,6CAA6C,CAAC,CAAC;YAC9D,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAC9D,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAC/B,CAAC;QACF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,SAAS,CAAC,GAAG,EAAE,wCAAwC,CAAC,CAAC;YACzD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC;IACX,CAAC;CACF,CAAC"}

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,6 @@
+import type { IndexStatus } from "../../mcp/session.js";
+import type { CliCommand } from "../index.js";
+/** Render an {@link IndexStatus} for the terminal (human lines) or `--json`. */
+export declare function renderStatus(status: IndexStatus, json: boolean): string;
+export declare const statusCommand: CliCommand;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA6B9C,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAgBvE;AAED,eAAO,MAAM,aAAa,EAAE,UAS3B,CAAC"}

package/dist/cli/commands/status.js

@@ -0,0 +1,63 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { createDefaultIndexer } from "../../indexer/indexer.js";
+import { serverStamp } from "../../mcp/build-info.js";
+import { SqliteStore } from "../../store/sqlite.js";
+import { dbPathFor } from "../paths.js";
+/**
+ * Read a persisted index's stats without re-analyzing. Uses {@link Indexer.open}
+ * (not {@link AmaSession.open}) so a missing/stale index reports "not indexed"
+ * rather than silently triggering a full re-index — `status` reports, it never
+ * builds. `pendingSync` is always 0: a one-shot CLI process runs no watcher.
+ */
+async function loadStatus(root, dbPath) {
+    if (!fs.existsSync(dbPath))
+        return { indexed: false, server: serverStamp };
+    const indexer = createDefaultIndexer(() => new SqliteStore(dbPath));
+    const opened = await indexer.open(path.resolve(root));
+    if (!opened)
+        return { indexed: false, server: serverStamp };
+    const { root: r, nodeCount, edgeCount, fileCount, languages } = opened.stats;
+    opened.store.close();
+    return {
+        indexed: true,
+        root: r,
+        nodeCount,
+        edgeCount,
+        fileCount,
+        languages,
+        pendingSync: 0,
+        projects: [{ root: r, nodeCount, edgeCount, fileCount }],
+        server: serverStamp,
+    };
+}
+/** Render an {@link IndexStatus} for the terminal (human lines) or `--json`. */
+export function renderStatus(status, json) {
+    if (json)
+        return JSON.stringify(status, null, 2);
+    const rev = status.server.revision?.slice(0, 7) ?? "unknown";
+    const stamp = `ama ${status.server.version} (${rev})`;
+    if (!status.indexed) {
+        return ["No index found. Run `ama index` to build one.", `server: ${stamp}`].join("\n");
+    }
+    const lines = [
+        `Index: ${status.root}`,
+        `  ${status.fileCount} files · ${status.nodeCount} nodes · ${status.edgeCount} edges`,
+    ];
+    for (const lang of status.languages) {
+        lines.push(`  ${lang.language}  ${lang.tier}  ${lang.files} files`);
+    }
+    lines.push(`  pending sync: ${status.pendingSync}`, `server: ${stamp}`);
+    return lines.join("\n");
+}
+export const statusCommand = {
+    name: "status",
+    summary: "Show index statistics and pending-sync info",
+    async run(args, ctx) {
+        const root = args[0] ?? process.env.AMA_ROOT ?? ".";
+        const status = await loadStatus(root, dbPathFor(root));
+        ctx.write(renderStatus(status, ctx.json));
+        return 0;
+    },
+};
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

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

package/dist/cli/commands/sync.d.ts

@@ -0,0 +1,6 @@
+import { type SyncResult } from "../../indexer/indexer.js";
+import type { CliCommand } from "../index.js";
+/** Render a {@link SyncResult} for the terminal, or `--json` (the raw result). */
+export declare function renderSync(result: SyncResult, json: boolean): string;
+export declare const syncCommand: CliCommand;
+//# sourceMappingURL=sync.d.ts.map

package/dist/cli/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sync.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAwB,MAAM,0BAA0B,CAAC;AAGjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CASpE;AAsBD,eAAO,MAAM,WAAW,EAAE,UAazB,CAAC"}

package/dist/cli/commands/sync.js

@@ -0,0 +1,57 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { createDefaultIndexer } from "../../indexer/indexer.js";
+import { SqliteStore } from "../../store/sqlite.js";
+import { emitError } from "../emit.js";
+import { dbPathFor } from "../paths.js";
+/** Render a {@link SyncResult} for the terminal, or `--json` (the raw result). */
+export function renderSync(result, json) {
+    if (json)
+        return JSON.stringify(result, null, 2);
+    if (result.changed.length === 0 && result.removed.length === 0) {
+        return "Already up to date.";
+    }
+    const lines = [`Synced: ${result.changed.length} changed, ${result.removed.length} removed.`];
+    for (const file of result.changed)
+        lines.push(`  ~ ${file}`);
+    for (const file of result.removed)
+        lines.push(`  - ${file}`);
+    return lines.join("\n");
+}
+/**
+ * Open the persisted index and reconcile it with on-disk changes in place.
+ * Returns `undefined` when there is no usable index (so the command can say
+ * "run `ama index`" rather than building one) — `sync` is incremental and
+ * presupposes an existing index, unlike `index` which rebuilds from scratch.
+ */
+async function runSync(root) {
+    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 await indexer.sync(opened.store, abs);
+    }
+    finally {
+        opened.store.close();
+    }
+}
+export const syncCommand = {
+    name: "sync",
+    summary: "Incrementally reconcile the index with on-disk changes",
+    async run(args, ctx) {
+        const root = args[0] ?? process.env.AMA_ROOT ?? ".";
+        const result = await runSync(root);
+        if (result === undefined) {
+            emitError(ctx, "No index found. Run `ama index` first.");
+            return 1;
+        }
+        ctx.write(renderSync(result, ctx.json));
+        return 0;
+    },
+};
+//# sourceMappingURL=sync.js.map

package/dist/cli/commands/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../src/cli/commands/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAmB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,kFAAkF;AAClF,MAAM,UAAU,UAAU,CAAC,MAAkB,EAAE,IAAa;IAC1D,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,WAAW,MAAM,CAAC,OAAO,CAAC,MAAM,aAAa,MAAM,CAAC,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;IAC9F,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAC7D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,OAAO,CAAC,IAAY;IACjC,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,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAe;IACrC,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,wDAAwD;IACjE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,SAAS,CAAC,GAAG,EAAE,wCAAwC,CAAC,CAAC;YACzD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACxC,OAAO,CAAC,CAAC;IACX,CAAC;CACF,CAAC"}

package/dist/cli/emit.d.ts

@@ -0,0 +1,9 @@
+import type { CliContext } from "./index.js";
+/**
+ * Route a diagnostic (usage, "no index", not-found) to stderr when an error sink
+ * is present, else fall back to stdout. Lives in its own leaf module — the type
+ * import of {@link CliContext} is erased, so command modules can import this
+ * value without forming a runtime cycle with the command registry in `index.ts`.
+ */
+export declare function emitError(ctx: CliContext, line: string): void;
+//# sourceMappingURL=emit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/cli/emit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7D"}

package/dist/cli/emit.js

@@ -0,0 +1,10 @@
+/**
+ * Route a diagnostic (usage, "no index", not-found) to stderr when an error sink
+ * is present, else fall back to stdout. Lives in its own leaf module — the type
+ * import of {@link CliContext} is erased, so command modules can import this
+ * value without forming a runtime cycle with the command registry in `index.ts`.
+ */
+export function emitError(ctx, line) {
+    (ctx.error ?? ctx.write)(line);
+}
+//# sourceMappingURL=emit.js.map

package/dist/cli/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../src/cli/emit.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,GAAe,EAAE,IAAY;IACrD,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/** Global options parsed from argv and handed to each command. */
+export interface CliContext {
+    /** True when `--json` was passed; commands should emit machine-readable JSON. */
+    readonly json: boolean;
+    /** Write a result line to stdout. */
+    write(line: string): void;
+    /**
+     * Write a diagnostic (usage, "no index", not-found) to stderr, keeping stdout
+     * reserved for results so a `--json` consumer's stream stays clean. Optional:
+     * `run()` always supplies it, but a direct `command.run(args, { write })` unit
+     * call may omit it — use {@link emitError} so diagnostics fall back to stdout.
+     */
+    error?(line: string): void;
+    /** Read all of piped stdin (for `git diff … | ama affected`); returns "" when
+     *  stdin is a TTY or empty. Injectable so commands stay unit-testable. (ama-dx1) */
+    stdin?(): string;
+}
+/** A subcommand of the `ama` CLI. */
+export interface CliCommand {
+    readonly name: string;
+    readonly summary: string;
+    /** One-line usage shown by `ama <command> --help`; falls back to the summary. */
+    readonly usage?: string;
+    run(args: string[], ctx: CliContext): number | Promise<number>;
+}
+/**
+ * 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 declare function run(argv: string[], commands: readonly CliCommand[], out?: (line: string) => void, err?: (line: string) => void): Promise<number>;
+/** Registered commands. More domain commands (search/sync/…) are added here
+ * as the CLI epic progresses (ama-5gs.4+). */
+export declare const COMMANDS: readonly CliCommand[];
+export declare function main(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAgCA,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACzB,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,qCAAqC;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;OAKG;IACH,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;wFACoF;IACpF,KAAK,CAAC,IAAI,MAAM,CAAC;CAClB;AAED,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChE;AAgBD;;;;GAIG;AACH,wBAAsB,GAAG,CACvB,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkD,EACzE,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkD,GACxE,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAaD;8CAC8C;AAC9C,eAAO,MAAM,QAAQ,EAAE,SAAS,UAAU,EA6BzC,CAAC;AAEF,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAY1C"}