dravix-agent 0.1.0

package/dist/hooks/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/hooks/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,OAAO,EAAc,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,GAAG,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;AAwBpC,SAAS,aAAa;IACpB,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpD,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACpF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAYD;;;;;;;;GAQG;AACH,SAAS,qBAAqB,CAAC,CAAc,EAAE,GAAW;IACxD,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC;IAChE,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAEzE,oCAAoC;IACpC,IAAI,EAAE,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3D,CAAC;IAED,yDAAyD;IACzD,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,SAAS,IAAI,IAAI,CAAC;IACrD,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,SAAS,IAAI,IAAI,CAAC;IACrD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC/C,kEAAkE;gBAClE,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACrC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;oBACb,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;oBAC5F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;gBAC9D,CAAC;gBACD,GAAG,CAAC,KAAK,CAAC,+DAA+D,EAAE;oBACzE,IAAI,EAAE,OAAO;oBACb,UAAU,EAAE,MAAM,CAAC,MAAM;iBAC1B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,KAAK,CAAC,mDAAmD,EAAE;oBAC7D,IAAI,EAAE,OAAO;oBACb,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;iBACjB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,sEAAsE;QACtE,kEAAkE;QAClE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAkB;IAC3C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,GAAG,GAAG,KAAK,CAAC,CAAC,QAAQ,UAAU,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC;QACrH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,CAAC;IACvE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAC5D,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,KAAK,EAAE;YACP,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,qBAAqB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC5E,IAAI,CAAC,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAClC,GAAG,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;IACvE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEvC,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,OAAO,CAAC;YACrB,QAAQ,EAAE,OAAO;YACjB,OAAO;YACP,WAAW;YACX,+DAA+D;YAC/D,+DAA+D;YAC/D,gEAAgE;YAChE,gEAAgE;YAChE,kEAAkE;YAClE,2DAA2D;YAC3D,kBAAkB,EAAE,KAAK;YACzB,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,MAAM,EAAE,EAAE,CAAC;SAClF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,6DAA6D;QAC7D,GAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;QAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oFAAoF;gBAClF,mEAAmE,CACtE,CAAC;QACJ,CAAC;QACD,MAAM,cAAc,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;QACtF,MAAM,cAAc,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,cAAc,EAAE,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/index/context.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Project-context builder for the validate_edit response.
+ *
+ * Given a file's content + project root + a built SCIP index, returns
+ * focused cross-file evidence:
+ *
+ *   - For each IMPORTED symbol → its definition (file:line + code snippet).
+ *   - For each top-level FUNCTION/CLASS defined HERE → its callers
+ *     (file:line + 1-line context).
+ *
+ * This is the RepoGraph-style "what does the LLM actually need to see"
+ * approach — NOT a generic dump. The output is structured (zod-shaped) so
+ * downstream consumers (Tier-4 critic in Phase 2, hook remediation text)
+ * can format it however they like.
+ */
+import { z } from "zod";
+import { Lang } from "../lang.js";
+import { SCIPIndexer } from "./scip.js";
+export declare const ProjectContextBlockSchema: z.ZodObject<{
+    /** True iff a SCIP index is available; if false the block is empty. */
+    available: z.ZodBoolean;
+    /** Languages currently indexed (e.g. ["typescript","python"]). */
+    languages: z.ZodArray<z.ZodString, "many">;
+    /** Definitions of imported symbols. */
+    imported_definitions: z.ZodArray<z.ZodObject<{
+        symbol: z.ZodString;
+        kind: z.ZodString;
+        file: z.ZodString;
+        line: z.ZodNumber;
+        snippet: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        symbol: string;
+        file: string;
+        line: number;
+        kind: string;
+        snippet?: string | undefined;
+    }, {
+        symbol: string;
+        file: string;
+        line: number;
+        kind: string;
+        snippet?: string | undefined;
+    }>, "many">;
+    /** Callers of each top-level function/class defined in this file. */
+    callers: z.ZodArray<z.ZodObject<{
+        symbol: z.ZodString;
+        callers: z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            line: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            file: string;
+            line: number;
+        }, {
+            file: string;
+            line: number;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        symbol: string;
+        callers: {
+            file: string;
+            line: number;
+        }[];
+    }, {
+        symbol: string;
+        callers: {
+            file: string;
+            line: number;
+        }[];
+    }>, "many">;
+    /** Duration in ms it took to build this block (for budget tuning). */
+    duration_ms: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    callers: {
+        symbol: string;
+        callers: {
+            file: string;
+            line: number;
+        }[];
+    }[];
+    languages: string[];
+    available: boolean;
+    imported_definitions: {
+        symbol: string;
+        file: string;
+        line: number;
+        kind: string;
+        snippet?: string | undefined;
+    }[];
+    duration_ms: number;
+}, {
+    callers: {
+        symbol: string;
+        callers: {
+            file: string;
+            line: number;
+        }[];
+    }[];
+    languages: string[];
+    available: boolean;
+    imported_definitions: {
+        symbol: string;
+        file: string;
+        line: number;
+        kind: string;
+        snippet?: string | undefined;
+    }[];
+    duration_ms: number;
+}>;
+export type ProjectContextBlock = z.infer<typeof ProjectContextBlockSchema>;
+export declare function extractSymbols(content: string, lang: Lang): {
+    imports: string[];
+    defs: string[];
+};
+export interface BuildContextInput {
+    filePath: string;
+    content: string;
+    lang: Lang;
+    projectRoot: string;
+    /** Hard cap on query calls (imports + defs combined). Default 8. */
+    maxSymbols?: number;
+    /** Hard cap on the total block size in characters. Default 6000. */
+    maxChars?: number;
+}
+export declare function buildProjectContext(indexer: SCIPIndexer, input: BuildContextInput): Promise<ProjectContextBlock>;
+/** Convenience: render the structured block as a single markdown string. */
+export declare function renderProjectContextMarkdown(block: ProjectContextBlock): string;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/index/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,OAAO,EAAE,WAAW,EAAoD,MAAM,WAAW,CAAC;AAM1F,eAAO,MAAM,yBAAyB;IACpC,uEAAuE;;IAEvE,kEAAkE;;IAElE,uCAAuC;;;;;;;;;;;;;;;;;;;;IAUvC,qEAAqE;;;;;;;;;;;;;;;;;;;;;;;;;;IAYrE,sEAAsE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEtE,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AA2F5E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAMjG;AAID,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAkF9B;AAED,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CA+B/E"}

package/dist/index/context.js

@@ -0,0 +1,267 @@
+/**
+ * Project-context builder for the validate_edit response.
+ *
+ * Given a file's content + project root + a built SCIP index, returns
+ * focused cross-file evidence:
+ *
+ *   - For each IMPORTED symbol → its definition (file:line + code snippet).
+ *   - For each top-level FUNCTION/CLASS defined HERE → its callers
+ *     (file:line + 1-line context).
+ *
+ * This is the RepoGraph-style "what does the LLM actually need to see"
+ * approach — NOT a generic dump. The output is structured (zod-shaped) so
+ * downstream consumers (Tier-4 critic in Phase 2, hook remediation text)
+ * can format it however they like.
+ */
+import { z } from "zod";
+import { getLogger } from "../util/logger.js";
+const log = getLogger("aegis.index.context");
+// --- public shape ----------------------------------------------------------
+export const ProjectContextBlockSchema = z.object({
+    /** True iff a SCIP index is available; if false the block is empty. */
+    available: z.boolean(),
+    /** Languages currently indexed (e.g. ["typescript","python"]). */
+    languages: z.array(z.string()),
+    /** Definitions of imported symbols. */
+    imported_definitions: z.array(z.object({
+        symbol: z.string(),
+        kind: z.string(),
+        file: z.string(),
+        line: z.number().int().positive(),
+        snippet: z.string().max(4000).optional(),
+    })),
+    /** Callers of each top-level function/class defined in this file. */
+    callers: z.array(z.object({
+        symbol: z.string(),
+        callers: z.array(z.object({
+            file: z.string(),
+            line: z.number().int().positive(),
+        })),
+    })),
+    /** Duration in ms it took to build this block (for budget tuning). */
+    duration_ms: z.number(),
+});
+// --- symbol extraction (regex-based, fast) ---------------------------------
+const PY_FROM_IMPORT = /^\s*from\s+\S+\s+import\s+(.+)$/;
+const PY_IMPORT = /^\s*import\s+(.+)$/;
+const PY_TOP_DEF = /^(?:async\s+)?def\s+([A-Za-z_]\w*)\s*\(/m;
+const PY_TOP_CLASS = /^class\s+([A-Za-z_]\w*)\s*[:\(]/m;
+const JS_NAMED_IMPORT = /import\s*\{([^}]+)\}\s*from/g;
+const JS_DEFAULT_IMPORT = /import\s+([A-Za-z_]\w*)\s+from/g;
+const JS_REQUIRE = /(?:const|let|var)\s+\{?\s*([\w,\s]+?)\s*\}?\s*=\s*require\(/g;
+const JS_FN = /(?:export\s+)?(?:async\s+)?function\s+([A-Za-z_]\w*)/g;
+const JS_CONST_FN = /(?:export\s+)?(?:const|let|var)\s+([A-Za-z_]\w*)\s*=\s*(?:async\s*)?(?:\([^)]*\)\s*=>|function)/g;
+const JS_CLASS = /(?:export\s+)?class\s+([A-Za-z_]\w*)/g;
+function dedup(xs) {
+    const seen = new Set();
+    const out = [];
+    for (const x of xs) {
+        if (!x || seen.has(x))
+            continue;
+        if (!/^[A-Za-z_]/.test(x))
+            continue;
+        seen.add(x);
+        out.push(x);
+    }
+    return out;
+}
+function splitImportList(s) {
+    const out = [];
+    for (const part of s.split(",")) {
+        const trimmed = part.trim();
+        if (!trimmed)
+            continue;
+        // strip `as X` / `as X as Y`
+        const head = trimmed.split(/\s+as\s+/i)[0].trim();
+        // strip dot paths like `mod.Sub` → `mod`
+        const id = head.split(".")[0];
+        if (/^[A-Za-z_]\w*$/.test(id))
+            out.push(id);
+    }
+    return out;
+}
+function extractPython(content) {
+    const imports = [];
+    let inParen = false;
+    let buf = "";
+    for (const raw of content.split(/\n/)) {
+        const line = raw.replace(/\r$/, "");
+        if (inParen) {
+            buf += " " + line;
+            if (line.includes(")")) {
+                inParen = false;
+                const inside = buf.split("(")[1]?.split(")")[0] ?? "";
+                imports.push(...splitImportList(inside));
+                buf = "";
+            }
+            continue;
+        }
+        let m = PY_FROM_IMPORT.exec(line);
+        if (m) {
+            const names = m[1].trim();
+            if (names.startsWith("(") && !names.includes(")")) {
+                inParen = true;
+                buf = names;
+                continue;
+            }
+            imports.push(...splitImportList(names.replace(/[()]/g, "")));
+            continue;
+        }
+        m = PY_IMPORT.exec(line);
+        if (m)
+            imports.push(...splitImportList(m[1]));
+    }
+    const defs = [
+        ...Array.from(content.matchAll(new RegExp(PY_TOP_DEF.source, "gm")), (mm) => mm[1]),
+        ...Array.from(content.matchAll(new RegExp(PY_TOP_CLASS.source, "gm")), (mm) => mm[1]),
+    ];
+    return { imports: dedup(imports), defs: dedup(defs) };
+}
+function extractJsTs(content) {
+    const imports = [];
+    for (const m of content.matchAll(JS_NAMED_IMPORT))
+        imports.push(...splitImportList(m[1]));
+    for (const m of content.matchAll(JS_DEFAULT_IMPORT))
+        imports.push(m[1]);
+    for (const m of content.matchAll(JS_REQUIRE))
+        imports.push(...splitImportList(m[1]));
+    const defs = [];
+    for (const m of content.matchAll(JS_FN))
+        defs.push(m[1]);
+    for (const m of content.matchAll(JS_CONST_FN))
+        defs.push(m[1]);
+    for (const m of content.matchAll(JS_CLASS))
+        defs.push(m[1]);
+    return { imports: dedup(imports), defs: dedup(defs) };
+}
+export function extractSymbols(content, lang) {
+    if (lang === "python")
+        return extractPython(content);
+    if (lang === "javascript" || lang === "typescript" || lang === "jsx" || lang === "tsx") {
+        return extractJsTs(content);
+    }
+    return { imports: [], defs: [] };
+}
+const DEFAULT_MAX_SYMBOLS = 8;
+const DEFAULT_MAX_CHARS = 6000;
+export async function buildProjectContext(indexer, input) {
+    const t0 = Date.now();
+    const meta = await indexer.meta(input.projectRoot);
+    if (!meta) {
+        // We have no index yet; the caller can run `ensureIndexed` upstream.
+        return {
+            available: false,
+            languages: [],
+            imported_definitions: [],
+            callers: [],
+            duration_ms: Date.now() - t0,
+        };
+    }
+    const { imports, defs } = extractSymbols(input.content, input.lang);
+    const maxSyms = input.maxSymbols ?? DEFAULT_MAX_SYMBOLS;
+    const maxChars = input.maxChars ?? DEFAULT_MAX_CHARS;
+    const imported_definitions = [];
+    const callers = [];
+    // Split the budget so node-builtins / stdlib imports (which produce no SCIP
+    // hit) don't starve the second phase. Bias slightly toward imports — the
+    // cross-file definitions are the highest-value cross-file evidence.
+    let importsBudget = Math.max(2, Math.ceil(maxSyms * 0.6));
+    let defsBudget = Math.max(1, maxSyms - importsBudget);
+    let charBudget = maxChars;
+    // 1) imported symbols → definitions (highest value: cross-file evidence)
+    for (const sym of imports) {
+        if (importsBudget <= 0 || charBudget <= 100)
+            break;
+        const found = await indexer.findSymbolsByDisplay(input.projectRoot, sym);
+        if (found.length === 0)
+            continue; // budget NOT spent on misses
+        // Prefer the symbol that has a definition; pick the first.
+        let chosen = null;
+        for (const cand of found) {
+            const def = await indexer.defOf(input.projectRoot, cand.symbolId);
+            if (def && def.location.file) {
+                chosen = def;
+                break;
+            }
+        }
+        if (!chosen)
+            continue;
+        const snippet = chosen.snippet?.slice(0, Math.min(1500, charBudget));
+        const entry = {
+            symbol: chosen.displayName,
+            kind: chosen.kind,
+            file: chosen.location.file,
+            line: chosen.location.startLine,
+            ...(snippet !== undefined ? { snippet } : {}),
+        };
+        imported_definitions.push(entry);
+        importsBudget--;
+        charBudget -= snippet ? snippet.length : 100;
+    }
+    // 2) for each defined function/class here, list callers (cross-file usage)
+    for (const fn of defs) {
+        if (defsBudget <= 0 || charBudget <= 50)
+            break;
+        const callerRefs = await indexer.callersOf(input.projectRoot, fn);
+        if (callerRefs.length === 0)
+            continue;
+        // de-dup by file:line; cap at 8 per symbol
+        const seen = new Set();
+        const out = [];
+        for (const r of callerRefs) {
+            const key = `${r.location.file}:${r.location.startLine}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push({ file: r.location.file, line: r.location.startLine });
+            if (out.length >= 8)
+                break;
+        }
+        if (out.length === 0)
+            continue;
+        callers.push({ symbol: fn, callers: out });
+        defsBudget--;
+        charBudget -= 50 + out.length * 30;
+    }
+    return {
+        available: true,
+        languages: meta.languages,
+        imported_definitions,
+        callers,
+        duration_ms: Date.now() - t0,
+    };
+}
+/** Convenience: render the structured block as a single markdown string. */
+export function renderProjectContextMarkdown(block) {
+    if (!block.available) {
+        return "(no project context — SCIP index not built; run `aegis index` to enable)";
+    }
+    if (block.imported_definitions.length === 0 && block.callers.length === 0) {
+        return "(no cross-file evidence found for this file's symbols)";
+    }
+    const lines = [
+        `## PROJECT CONTEXT (SCIP — ${block.languages.join("+")} index)`,
+        "",
+    ];
+    if (block.imported_definitions.length > 0) {
+        lines.push("### Imported definitions (cross-file)");
+        for (const d of block.imported_definitions) {
+            lines.push(`- **${d.symbol}** (${d.kind}) — ${d.file}:${d.line}`);
+            if (d.snippet) {
+                lines.push("```");
+                lines.push(d.snippet);
+                lines.push("```");
+            }
+        }
+        lines.push("");
+    }
+    if (block.callers.length > 0) {
+        lines.push("### Callers of this file's symbols");
+        for (const c of block.callers) {
+            const cs = c.callers.map((x) => `${x.file}:${x.line}`).join(", ");
+            lines.push(`- **${c.symbol}** → called from: ${cs}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=context.js.map

package/dist/index/context.js.map

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

package/dist/index/embeddings.d.ts

@@ -0,0 +1,68 @@
+import { SCIPIndexer } from "./scip.js";
+export interface EmbeddedItem {
+    /** Stable id; reused as the HNSW label. */
+    id: number;
+    file: string;
+    symbolId?: string;
+    displayName?: string;
+    kind?: string;
+    /** Source snippet that was embedded (capped). */
+    snippet: string;
+}
+export interface SemanticHit {
+    item: EmbeddedItem;
+    /** Cosine similarity in [-1, 1]; closer to 1 = more similar. */
+    similarity: number;
+}
+export interface EmbedIndexInfo {
+    model: string;
+    dim: number;
+    rows: number;
+    built_at: number;
+    scip_sha?: string;
+}
+export declare class Embedder {
+    private readonly modelName;
+    private _pipeline;
+    private _dim;
+    constructor(modelName?: string);
+    /** Lazily load the model (cold cost). Returns false if unavailable. */
+    ensureLoaded(): Promise<boolean>;
+    get dim(): number;
+    get model(): string;
+    /** Returns the L2-normalised embedding (use cosine via dot product). */
+    embed(text: string): Promise<Float32Array | null>;
+    /** Batch embed; sequential on CPU to keep peak memory bounded. */
+    embedBatch(texts: ReadonlyArray<string>): Promise<Array<Float32Array | null>>;
+}
+export declare class EmbeddingIndex {
+    private readonly projectRoot;
+    private readonly embedder;
+    private hnsw;
+    private meta;
+    private info;
+    constructor(projectRoot: string, embedder?: Embedder);
+    private dir;
+    private indexPath;
+    private metaPath;
+    private infoPath;
+    /** True iff an index file exists on disk for this project. */
+    hasPersisted(): boolean;
+    /** Load an existing index from disk; returns false if any required file missing. */
+    load(): Promise<boolean>;
+    /**
+     * Build the index from scratch by walking every SymbolInformation entry the
+     * SCIP indexer has stored for this project. We embed each symbol's snippet
+     * (from defOf). Slow (~5-50 ms per symbol on CPU); meant to be invoked from
+     * ``aegis index --embed`` and persisted.
+     */
+    build(scip: SCIPIndexer, opts?: {
+        maxSymbols?: number;
+    }): Promise<boolean>;
+    /** Top-K semantically similar embedded items for a query snippet. */
+    topK(query: string, k: number): Promise<SemanticHit[]>;
+    /** Quick info accessor for `aegis index --embed` / `aegis doctor`. */
+    getInfo(): EmbedIndexInfo | null;
+}
+export declare function getEmbeddingIndex(projectRoot: string): EmbeddingIndex;
+//# sourceMappingURL=embeddings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/index/embeddings.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAuBxC,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAoCD,qBAAa,QAAQ;IAIP,OAAO,CAAC,QAAQ,CAAC,SAAS;IAHtC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,IAAI,CAAuB;gBAEN,SAAS,GAAE,MAAsB;IAE9D,uEAAuE;IACjE,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAmBtC,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,wEAAwE;IAClE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAoBvD,kEAAkE;IAC5D,UAAU,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CAOpF;AA2CD,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,IAAI,CAA+B;gBAGxB,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,QAAyB;IAGtD,OAAO,CAAC,GAAG;IAGX,OAAO,CAAC,SAAS;IAGjB,OAAO,CAAC,QAAQ;IAGhB,OAAO,CAAC,QAAQ;IAIhB,8DAA8D;IAC9D,YAAY,IAAI,OAAO;IAIvB,oFAAoF;IAC9E,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAmC9B;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAuOhF,qEAAqE;IAC/D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAoB5D,sEAAsE;IACtE,OAAO,IAAI,cAAc,GAAG,IAAI;CAGjC;AAgGD,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAQrE"}