@mirnoorata/codexa 0.2.0

package/dist/indexer/parsing.js

@@ -0,0 +1,177 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { isGeneratedPath, isTestPath, languageForPath } from "../language.js";
+import { parseFile } from "../parser.js";
+import { MAX_INDEXED_SOURCE_BYTES } from "../repo-files.js";
+import { mapLimit, stableId } from "../util.js";
+const PARSE_CACHE_VERSION = "parse-cache-v1-shallow-rust-go-java-20260606";
+const PARSE_CACHE_PATH = ".codex/cache/codexa-parse-cache.json";
+const PYTHON_SEMANTIC_SOURCE_TOTAL_BYTES = 16 * 1024 * 1024;
+export async function parseRepoSources(input) {
+    const parseCache = await loadParseCache(input.repoRoot);
+    const nextCache = { version: PARSE_CACHE_VERSION, entries: {} };
+    let parseCacheHits = 0;
+    const parsedSourceFiles = await mapLimit(input.files, 12, async (file) => {
+        const parseInput = {
+            repoRoot: input.repoRoot,
+            relativePath: file.path,
+            absolutePath: file.absolutePath,
+            dirty: file.dirty,
+            sizeBytes: file.sizeBytes,
+            snapshotId: input.snapshotId,
+            indexedAt: input.indexedAt
+        };
+        const cached = parseCache.entries[file.path];
+        if (cached?.contentHash === file.contentHash && cached.sizeBytes === file.sizeBytes && isParseResult(cached.result)) {
+            parseCacheHits += 1;
+            const rebased = rebaseParseResult(cached.result, parseInput);
+            nextCache.entries[file.path] = {
+                contentHash: file.contentHash,
+                sizeBytes: file.sizeBytes,
+                result: rebased
+            };
+            return rebased;
+        }
+        const result = await parseFile(parseInput);
+        nextCache.entries[file.path] = {
+            contentHash: file.contentHash,
+            sizeBytes: file.sizeBytes,
+            result
+        };
+        return result;
+    });
+    const parsed = [...parsedSourceFiles, ...input.skippedFiles.map((file) => skippedFileParseResult(file, input.snapshotId, input.indexedAt))].sort((a, b) => a.file.path.localeCompare(b.file.path));
+    return { parsed, nextCache, parseCacheHits };
+}
+export async function writeParseCache(repoRoot, cache) {
+    const target = path.join(repoRoot, PARSE_CACHE_PATH);
+    const temp = `${target}.tmp-${process.pid}-${Date.now()}`;
+    await fs.mkdir(path.dirname(target), { recursive: true });
+    await fs.writeFile(temp, `${JSON.stringify(cache)}\n`, "utf8");
+    await fs.rename(temp, target);
+}
+export async function loadPythonSemanticSourceFiles(files) {
+    const selected = [];
+    let totalBytes = 0;
+    for (const file of files.filter((entry) => entry.path.endsWith(".py"))) {
+        if (totalBytes + file.sizeBytes > PYTHON_SEMANTIC_SOURCE_TOTAL_BYTES) {
+            continue;
+        }
+        try {
+            selected.push({
+                path: file.path,
+                sourceText: await fs.readFile(file.absolutePath, "utf8"),
+                contentHash: file.contentHash
+            });
+            totalBytes += file.sizeBytes;
+        }
+        catch {
+            // The file may have been removed between git discovery and semantic assist.
+        }
+    }
+    return selected;
+}
+export function formatBytes(bytes) {
+    if (bytes >= 1024 * 1024) {
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+    }
+    if (bytes >= 1024) {
+        return `${(bytes / 1024).toFixed(1)} KiB`;
+    }
+    return `${bytes} bytes`;
+}
+async function loadParseCache(repoRoot) {
+    try {
+        const parsed = JSON.parse(await fs.readFile(path.join(repoRoot, PARSE_CACHE_PATH), "utf8"));
+        if (parsed.version === PARSE_CACHE_VERSION && parsed.entries && typeof parsed.entries === "object") {
+            return {
+                version: parsed.version,
+                entries: Object.fromEntries(Object.entries(parsed.entries).filter(([filePath, entry]) => Boolean(entry?.contentHash && typeof entry.sizeBytes === "number" && isParseResult(entry.result) && parseResultMatchesPath(entry.result, filePath))))
+            };
+        }
+    }
+    catch {
+        // Missing or corrupt caches are safe to ignore; Codexa can always rebuild from source.
+    }
+    return { version: PARSE_CACHE_VERSION, entries: {} };
+}
+function isParseResult(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const record = value;
+    return (Boolean(record.file && typeof record.file === "object" && typeof record.file.path === "string") &&
+        Array.isArray(record.symbols) &&
+        Array.isArray(record.usageSites) &&
+        Array.isArray(record.imports) &&
+        Array.isArray(record.testEdges) &&
+        Array.isArray(record.risks) &&
+        Array.isArray(record.parserErrors));
+}
+function parseResultMatchesPath(result, filePath) {
+    return (result.file.path === filePath &&
+        result.symbols.every((fact) => fact.path === filePath) &&
+        result.usageSites.every((fact) => fact.path === filePath) &&
+        result.imports.every((fact) => fact.path === filePath) &&
+        result.testEdges.every((fact) => fact.path === filePath) &&
+        result.risks.every((fact) => fact.path === filePath) &&
+        result.parserErrors.every((fact) => fact.path === filePath));
+}
+function rebaseParseResult(result, input) {
+    const rebase = (fact) => ({
+        ...fact,
+        snapshotId: input.snapshotId,
+        indexedAt: input.indexedAt
+    });
+    return {
+        file: {
+            ...rebase(result.file),
+            path: input.relativePath,
+            dirty: input.dirty,
+            sizeBytes: input.sizeBytes
+        },
+        symbols: result.symbols.map(rebase),
+        usageSites: result.usageSites.map(rebase),
+        imports: result.imports.map(rebase),
+        testEdges: result.testEdges.map(rebase),
+        risks: result.risks.map(rebase),
+        parserErrors: result.parserErrors.map(rebase)
+    };
+}
+function skippedFileParseResult(file, snapshotId, indexedAt) {
+    const language = languageForPath(file.path);
+    return {
+        file: {
+            id: stableId("file", file.path),
+            type: "File",
+            path: file.path,
+            source: "git",
+            confidence: "authoritative",
+            snapshotId,
+            indexedAt,
+            language,
+            sizeBytes: file.sizeBytes,
+            dirty: file.dirty,
+            generated: isGeneratedPath(file.path),
+            test: isTestPath(file.path)
+        },
+        symbols: [],
+        usageSites: [],
+        imports: [],
+        testEdges: [],
+        risks: [],
+        parserErrors: [
+            {
+                id: stableId("parser-error", file.path, file.reason, file.sizeBytes),
+                type: "ParserError",
+                path: file.path,
+                source: "git",
+                confidence: "heuristic",
+                snapshotId,
+                indexedAt,
+                message: `Skipped source parsing for ${file.path}: ${formatBytes(file.sizeBytes)} exceeds Codexa's ${formatBytes(MAX_INDEXED_SOURCE_BYTES)} per-file index cap`
+            }
+        ]
+    };
+}
+//# sourceMappingURL=parsing.js.map

package/dist/indexer/parsing.js.map

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

package/dist/indexer/pipeline.d.ts

@@ -0,0 +1,5 @@
+export interface IndexPipelineStage<Context> {
+    name: string;
+    run(context: Context): Promise<Context> | Context;
+}
+export declare function runIndexPipeline<Context>(initialContext: Context, stages: Array<IndexPipelineStage<Context>>): Promise<Context>;

package/dist/indexer/pipeline.js

@@ -0,0 +1,8 @@
+export async function runIndexPipeline(initialContext, stages) {
+    let context = initialContext;
+    for (const stage of stages) {
+        context = await stage.run(context);
+    }
+    return context;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/indexer/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/indexer/pipeline.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAU,cAAuB,EAAE,MAA0C;IACjH,IAAI,OAAO,GAAG,cAAc,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/indexer/ranking.d.ts

@@ -0,0 +1,4 @@
+import type { CodexaIndex } from "../types.js";
+import type { OutcomeRankSignals } from "../outcome-ranking.js";
+export declare function applyRanking(index: CodexaIndex, churnByPath: Map<string, number>, outcomeSignals?: OutcomeRankSignals): CodexaIndex;
+export declare function applyModules(index: CodexaIndex): CodexaIndex;

package/dist/indexer/ranking.js

@@ -0,0 +1,134 @@
+import { moduleNameForPath } from "../language.js";
+import { stableId, uniqueSorted } from "../util.js";
+export function applyRanking(index, churnByPath, outcomeSignals) {
+    const incomingImports = countBy(index.imports.flatMap((imp) => (imp.resolvedPath ? [imp.resolvedPath] : [])));
+    // Eval-only experiment per the architecture contract: transitive centrality
+    // must not change default ranking until the eval harness shows material wins.
+    const transitiveCentrality = process.env.CODEXA_EXPERIMENTAL_TRANSITIVE_RANK === "1" ? transitiveImportCentrality(index) : undefined;
+    const importsByPath = countBy(index.imports.map((imp) => imp.path));
+    const usageByPath = countBy(index.usageSites.map((usage) => usage.path));
+    const symbolsByPath = countBy(index.symbols.map((symbol) => symbol.path));
+    const filesWithTestEdges = new Set(index.testEdges.flatMap((edge) => (edge.targetPath ? [edge.targetPath] : [])));
+    const riskByPath = new Map();
+    for (const risk of index.risks) {
+        riskByPath.set(risk.path, (riskByPath.get(risk.path) ?? 0) + risk.score);
+    }
+    const files = index.files.map((file) => {
+        const centrality = incomingImports.get(file.path) ?? 0;
+        const usage = usageByPath.get(file.path) ?? 0;
+        const symbols = symbolsByPath.get(file.path) ?? 0;
+        const publicSurface = file.path.includes("/api/") || file.path.includes("app.") || file.path.includes("index.") ? 2 : 0;
+        const churn = churnByPath.get(file.path) ?? 0;
+        const testProximity = file.test ? 0.5 : filesWithTestEdges.has(file.path) ? 1.5 : 0;
+        const dirtyRisk = file.dirty ? 3 : 0;
+        const riskScore = riskByPath.get(file.path) ?? 0;
+        const generatedPenalty = file.generated ? -2 : 0;
+        const outcomeHistory = Math.min(3, outcomeSignals?.boosts.get(file.path) ?? 0);
+        const rankReasons = {
+            centrality: Math.log2(centrality + 1),
+            transitiveCentrality: transitiveCentrality?.get(file.path) ?? 0,
+            usage: Math.log2(usage + 1),
+            symbols: Math.min(symbols, 20) / 4,
+            publicSurface,
+            churn: Math.min(churn, 20) / 4,
+            testProximity,
+            dirtyRisk,
+            riskScore: Math.min(riskScore, 12),
+            outcomeHistory,
+            generatedPenalty
+        };
+        const rank = Object.values(rankReasons).reduce((sum, value) => sum + value, 0);
+        return {
+            ...file,
+            symbolCount: symbols,
+            usageCount: usage,
+            importCount: importsByPath.get(file.path) ?? 0,
+            riskScore,
+            rank,
+            rankReasons
+        };
+    });
+    return { ...index, files: files.sort((a, b) => b.rank - a.rank || a.path.localeCompare(b.path)) };
+}
+export function applyModules(index) {
+    const byModule = new Map();
+    for (const file of index.files) {
+        const name = moduleNameForPath(file.path);
+        const files = byModule.get(name) ?? [];
+        files.push(file);
+        byModule.set(name, files);
+    }
+    const modules = [...byModule.entries()]
+        .map(([name, files]) => {
+        const rank = files.reduce((sum, file) => sum + file.rank, 0);
+        const topFiles = files.slice(0, 5).map((file) => file.path).join(", ");
+        return {
+            id: stableId("module", name),
+            type: "ModuleCluster",
+            source: "heuristic",
+            confidence: "heuristic",
+            snapshotId: index.snapshot.snapshotId,
+            indexedAt: index.snapshot.indexedAt,
+            name,
+            files: uniqueSorted(files.map((file) => file.path)),
+            summary: `${name} contains ${files.length} indexed files. Top files: ${topFiles || "none"}.`,
+            rank
+        };
+    })
+        .sort((a, b) => b.rank - a.rank || a.name.localeCompare(b.name));
+    return { ...index, modules };
+}
+const TRANSITIVE_RANK_DAMPING = 0.85;
+const TRANSITIVE_RANK_ITERATIONS = 4;
+const TRANSITIVE_RANK_WEIGHT = 2;
+/**
+ * Damped power iteration over the resolved import graph (PageRank-style).
+ * One-hop in-degree misses deep API consumers; this propagates importance
+ * from importers to importees so widely-depended-on leaves rank above
+ * incidental hubs. Deterministic, bounded iterations, normalized so the
+ * average file contributes 0 and the strongest hubs contribute up to
+ * TRANSITIVE_RANK_WEIGHT to the composite rank.
+ */
+function transitiveImportCentrality(index) {
+    const fileCount = index.files.length;
+    if (fileCount === 0) {
+        return new Map();
+    }
+    const outEdges = new Map();
+    const filePaths = new Set(index.files.map((file) => file.path));
+    for (const imp of index.imports) {
+        if (!imp.resolvedPath || !filePaths.has(imp.resolvedPath) || !filePaths.has(imp.path)) {
+            continue;
+        }
+        const targets = outEdges.get(imp.path) ?? [];
+        targets.push(imp.resolvedPath);
+        outEdges.set(imp.path, targets);
+    }
+    let scores = new Map([...filePaths].map((path) => [path, 1 / fileCount]));
+    for (let iteration = 0; iteration < TRANSITIVE_RANK_ITERATIONS; iteration += 1) {
+        const next = new Map([...filePaths].map((path) => [path, (1 - TRANSITIVE_RANK_DAMPING) / fileCount]));
+        for (const [source, targets] of outEdges) {
+            const share = (TRANSITIVE_RANK_DAMPING * (scores.get(source) ?? 0)) / targets.length;
+            for (const target of targets) {
+                next.set(target, (next.get(target) ?? 0) + share);
+            }
+        }
+        scores = next;
+    }
+    // score * fileCount == 1 for a file of exactly average importance, so the
+    // -1 shift makes the average file contribute 0 and below-average files clamp
+    // to 0 instead of every file receiving a flat boost.
+    const normalized = new Map();
+    for (const [path, score] of scores) {
+        normalized.set(path, Math.min(TRANSITIVE_RANK_WEIGHT, Math.max(0, Math.log2(score * fileCount + 1) - 1)));
+    }
+    return normalized;
+}
+function countBy(values) {
+    const counts = new Map();
+    for (const value of values) {
+        counts.set(value, (counts.get(value) ?? 0) + 1);
+    }
+    return counts;
+}
+//# sourceMappingURL=ranking.js.map

package/dist/indexer/ranking.js.map

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

package/dist/indexer.d.ts

@@ -0,0 +1,13 @@
+import type { CodexaIndex, FreshnessInfo, IndexOptions } from "./types.js";
+export declare const CODEBASE_DIR = ".codex/codebase";
+export { persistIndex, writeIndexBundle } from "./indexer/artifact-writing.js";
+export declare function buildIndex(options: IndexOptions): Promise<CodexaIndex>;
+export declare function buildIndexLocked(options: IndexOptions): Promise<CodexaIndex>;
+export declare function loadIndex(repoRoot: string, options?: {
+    recover?: boolean;
+}): Promise<CodexaIndex | null>;
+export declare function loadIndexReadOnly(repoRoot: string): Promise<CodexaIndex | null>;
+export declare function loadFreshnessReadOnly(repoRoot: string): Promise<FreshnessInfo | null>;
+export declare function getFreshness(repoRoot: string, index?: CodexaIndex | null, options?: {
+    recover?: boolean;
+}): Promise<FreshnessInfo>;