codestrate 0.1.0

package/dist/store/interface.d.ts

@@ -0,0 +1,73 @@
+/**
+ * StoreProvider — abstraction over storage backends.
+ *
+ * Supports SQLite as default production store and JSON files as
+ * a lightweight fallback. All store operations go through this
+ * interface so domain code never depends on a specific backend.
+ */
+import type { RepoSnapshot, SymbolInfo, SymbolRelation, Experience, Memory, ValidationResult } from "../types.js";
+export interface Migration {
+    version: number;
+    name: string;
+    sql: string[];
+}
+export interface IndexStore {
+    open(): void;
+    close(): void;
+    isOpen(): boolean;
+    getSnapshot(): RepoSnapshot | null;
+    setSnapshot(snapshot: RepoSnapshot): void;
+    getRepoFingerprint(): string | null;
+    setRepoFingerprint(fingerprint: string): void;
+    getSymbols(): SymbolInfo[];
+    getSymbol(name: string, file?: string): SymbolInfo | null;
+    addSymbol(symbol: SymbolInfo): void;
+    addSymbols(symbols: SymbolInfo[]): void;
+    removeSymbolsByFile(file: string): void;
+    clearSymbols(): void;
+    getRelations(): SymbolRelation[];
+    getRelationsForSymbol(symbol: string): SymbolRelation[];
+    addRelation(relation: SymbolRelation): void;
+    addRelations(relations: SymbolRelation[]): void;
+    clearRelations(): void;
+    getFilesByLanguage(): Record<string, string[]>;
+    addFile(language: string, filePath: string): void;
+    setFilesByLanguage(files: Record<string, string[]>): void;
+    getIndexedCommit(): string | null;
+    setIndexedCommit(sha: string): void;
+    getIndexedAt(): string | null;
+    setIndexedAt(ts: string): void;
+    purge(): void;
+}
+export interface MemoryStore {
+    open(): void;
+    close(): void;
+    isOpen(): boolean;
+    addExperience(exp: Experience): void;
+    getExperience(id: string): Experience | null;
+    getAllExperiences(repo?: string): Experience[];
+    updateExperience(id: string, updates: Partial<Experience>): void;
+    deleteExperience(id: string): void;
+    addMemory(mem: Memory): void;
+    getMemory(id: string): Memory | null;
+    getAllMemories(repo?: string): Memory[];
+    updateMemory(id: string, updates: Partial<Memory>): void;
+    deleteMemory(id: string): void;
+    updateQualityScore(id: string, delta: number): void;
+    purge(repo?: string): void;
+}
+export interface ValidationResultStore {
+    save(result: ValidationResult): void;
+    getLatest(limit?: number): ValidationResult[];
+}
+export interface Store extends IndexStore, MemoryStore, ValidationResultStore {
+    open(): void;
+    close(): void;
+    isOpen(): boolean;
+    purge(repo?: string): void;
+    getCurrentVersion(): number;
+    migrate(targetVersion?: number): void;
+    vacuum(): void;
+    backup(destPath: string): void;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/store/interface.d.ts.map

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

package/dist/store/interface.js

@@ -0,0 +1,9 @@
+/**
+ * StoreProvider — abstraction over storage backends.
+ *
+ * Supports SQLite as default production store and JSON files as
+ * a lightweight fallback. All store operations go through this
+ * interface so domain code never depends on a specific backend.
+ */
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/store/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/store/interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/store/memory.d.ts

@@ -0,0 +1,21 @@
+import type { Experience, ExperienceEvidence, Memory, MemoryType } from "../types.js";
+export interface MemoryStoreData {
+    experiences: Experience[];
+    memories: Memory[];
+}
+export declare function loadMemoryStore(storePath?: string): void;
+export declare function saveMemoryStore(storePath?: string): void;
+export declare function addExperience(input: {
+    task: string;
+    diagnosis: string;
+    solution: string;
+    changedFiles: string[];
+    commit: string;
+    failedAttempts: string[];
+}, evidence: ExperienceEvidence, repoFingerprint: string): Experience;
+export declare function getExperience(id: string): Experience | undefined;
+export declare function searchExperiences(query: string, repo?: string, topK?: number, memoryTypes?: MemoryType[]): Experience[];
+export declare function addMemory(memory: Omit<Memory, "id" | "timestamp" | "quality">): Memory;
+export declare function searchMemories(query: string, repo?: string, topK?: number, types?: MemoryType[]): Memory[];
+export declare function recallAll(query: string, repo?: string, topK?: number, types?: MemoryType[]): (Experience | Memory)[];
+//# sourceMappingURL=memory.d.ts.map

package/dist/store/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/store/memory.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAWD,wBAAgB,eAAe,CAAC,SAAS,GAAE,MAA2B,GAAG,IAAI,CAU5E;AAED,wBAAgB,eAAe,CAAC,SAAS,GAAE,MAA2B,GAAG,IAAI,CAM5E;AAID,wBAAgB,aAAa,CAC3B,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,EACD,QAAQ,EAAE,kBAAkB,EAC5B,eAAe,EAAE,MAAM,GACtB,UAAU,CAmCZ;AAYD,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEhE;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,GAAE,MAAU,EAChB,WAAW,CAAC,EAAE,UAAU,EAAE,GACzB,UAAU,EAAE,CAqBd;AAID,wBAAgB,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,WAAW,GAAG,SAAS,CAAC,GAAG,MAAM,CAUtF;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,GAAE,MAAU,EAChB,KAAK,CAAC,EAAE,UAAU,EAAE,GACnB,MAAM,EAAE,CAYV;AAID,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,GAAE,MAAU,EAChB,KAAK,CAAC,EAAE,UAAU,EAAE,GACnB,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,CAYzB"}

package/dist/store/memory.js

@@ -0,0 +1,157 @@
+/**
+ * Memory Store — JSON-based persistence for experiences and memories.
+ *
+ * Stores:
+ * - Episodic: verified experiences from ci_record_experience
+ * - Semantic: architecture/convention knowledge
+ * - Procedural: workflow processes
+ * - Negative: known failures
+ *
+ * Quality scoring:
+ *   quality = 0.35 * testSuccess + 0.25 * humanAcceptance + 0.15 * noRegression + 0.15 * codeReviewScore + 0.10 * reuseSuccess
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+import { randomUUID } from "crypto";
+import { DEFAULT_STORE_PATH, MEMORY_FILE } from "../constants.js";
+let data = {
+    experiences: [],
+    memories: [],
+};
+function getPath(storePath) {
+    return join(storePath, MEMORY_FILE);
+}
+export function loadMemoryStore(storePath = DEFAULT_STORE_PATH) {
+    const path = getPath(storePath);
+    if (existsSync(path)) {
+        try {
+            const raw = readFileSync(path, "utf-8");
+            data = JSON.parse(raw);
+        }
+        catch {
+            data = { experiences: [], memories: [] };
+        }
+    }
+}
+export function saveMemoryStore(storePath = DEFAULT_STORE_PATH) {
+    const path = getPath(storePath);
+    if (!existsSync(storePath)) {
+        mkdirSync(storePath, { recursive: true });
+    }
+    writeFileSync(path, JSON.stringify(data, null, 2), "utf-8");
+}
+// ─── Experience CRUD ──────────────────────────────────────
+export function addExperience(input, evidence, repoFingerprint) {
+    // Evidence check: commitSha, changedFiles, validationCommand, repoFingerprint all required
+    if (!evidence.commitSha)
+        throw new Error("Evidence.commitSha is required");
+    if (!evidence.changedFiles || evidence.changedFiles.length === 0)
+        throw new Error("Evidence.changedFiles must have at least one file");
+    if (!evidence.validationCommand)
+        throw new Error("Evidence.validationCommand is required");
+    if (!evidence.repoFingerprint)
+        throw new Error("Evidence.repoFingerprint is required");
+    // Require at least one validation to have passed
+    if (!evidence.buildPassed && !evidence.testsPassed) {
+        throw new Error("Evidence must include at least one passed validation (buildPassed or testsPassed). " +
+            "Run ci_run_validation first to verify the fix.");
+    }
+    // Compute quality score
+    const quality = computeQuality(evidence);
+    const experience = {
+        id: randomUUID(),
+        task: input.task,
+        diagnosis: input.diagnosis,
+        solution: input.solution,
+        changedFiles: input.changedFiles,
+        commit: input.commit,
+        validation: [],
+        failedAttempts: input.failedAttempts,
+        evidence,
+        quality,
+        timestamp: new Date().toISOString(),
+        repo: repoFingerprint,
+        type: "episodic",
+    };
+    data.experiences.push(experience);
+    saveMemoryStore();
+    return experience;
+}
+function computeQuality(evidence) {
+    let score = 0;
+    if (evidence.buildPassed)
+        score += 0.35;
+    if (evidence.testsPassed)
+        score += 0.25;
+    if (evidence.humanAccepted)
+        score += 0.15;
+    if (evidence.commitCreated !== false)
+        score += 0.15; // presence of commit = likely reviewed
+    score += 0.10; // baseline for reuse potential
+    return Math.min(1, score);
+}
+export function getExperience(id) {
+    return data.experiences.find(e => e.id === id);
+}
+export function searchExperiences(query, repo, topK = 5, memoryTypes) {
+    const q = query.toLowerCase();
+    let results = data.experiences.filter(e => {
+        if (repo && e.repo !== repo)
+            return false;
+        if (memoryTypes && !memoryTypes.includes(e.type))
+            return false;
+        return (e.task.toLowerCase().includes(q) ||
+            e.diagnosis.toLowerCase().includes(q) ||
+            e.solution.toLowerCase().includes(q) ||
+            e.changedFiles.some(f => f.toLowerCase().includes(q)));
+    });
+    // Sort by quality desc, then recency
+    results.sort((a, b) => {
+        const qDiff = b.quality - a.quality;
+        if (qDiff !== 0)
+            return qDiff;
+        return new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime();
+    });
+    return results.slice(0, topK);
+}
+// ─── Memory CRUD (semantic, procedural, negative) ─────────
+export function addMemory(memory) {
+    const m = {
+        ...memory,
+        id: randomUUID(),
+        quality: 0.5, // default for unvalidated
+        timestamp: new Date().toISOString(),
+    };
+    data.memories.push(m);
+    saveMemoryStore();
+    return m;
+}
+export function searchMemories(query, repo, topK = 5, types) {
+    const q = query.toLowerCase();
+    let results = data.memories.filter(m => {
+        if (repo && m.repo !== repo)
+            return false;
+        if (types && !types.includes(m.type))
+            return false;
+        return (m.content.toLowerCase().includes(q) ||
+            m.symbols.some(s => s.toLowerCase().includes(q)));
+    });
+    results.sort((a, b) => b.quality - a.quality);
+    return results.slice(0, topK);
+}
+// ─── Hybrid recall ────────────────────────────────────────
+export function recallAll(query, repo, topK = 5, types) {
+    const exps = searchExperiences(query, repo, topK, types);
+    const mems = searchMemories(query, repo, topK, types);
+    // Interleave by quality
+    const combined = [];
+    const maxLen = Math.max(exps.length, mems.length);
+    for (let i = 0; i < maxLen && combined.length < topK; i++) {
+        if (i < exps.length)
+            combined.push(exps[i]);
+        if (i < mems.length && combined.length < topK)
+            combined.push(mems[i]);
+    }
+    return combined;
+}
+//# sourceMappingURL=memory.js.map

package/dist/store/memory.js.map

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

package/dist/store/sqlite.d.ts

@@ -0,0 +1,95 @@
+/**
+ * SQLite Store — default production storage backend.
+ *
+ * Uses better-sqlite3 for synchronous, fast SQLite access.
+ * Implements the full Store interface with schema migration support.
+ *
+ * @module store/sqlite
+ */
+import { type Store } from "./interface.js";
+import type { RepoSnapshot, SymbolInfo, SymbolRelation, Experience, Memory, ValidationResult, GraphNode, GraphEdge } from "../types.js";
+export declare class SQLiteStore implements Store {
+    private db;
+    private dbPath;
+    constructor(dbPath?: string);
+    open(): void;
+    close(): void;
+    isOpen(): boolean;
+    getCurrentVersion(): number;
+    migrate(targetVersion?: number): void;
+    getSnapshot(): RepoSnapshot | null;
+    setSnapshot(snapshot: RepoSnapshot): void;
+    getRepoFingerprint(): string | null;
+    setRepoFingerprint(fingerprint: string): void;
+    getSymbols(): SymbolInfo[];
+    getSymbol(name: string, file?: string): SymbolInfo | null;
+    addSymbol(symbol: SymbolInfo): void;
+    addSymbols(symbols: SymbolInfo[]): void;
+    removeSymbolsByFile(file: string): void;
+    clearSymbols(): void;
+    /**
+     * Search symbols using FTS5 full-text index.
+     * Returns symbols ranked by relevance (BM25).
+     * Limited to `limit` results (default 20, max 50).
+     * Falls back to name LIKE search when FTS is unavailable
+     * (pre-v4 migration databases).
+     */
+    searchSymbolsFTS(query: string, limit?: number): SymbolInfo[];
+    /** Populate graph nodes and edges from symbol data.
+     *  Accepts symbols directly to decouple from store backend.
+     *  Clears previous graph data first. */
+    populateGraph(symbols: SymbolInfo[], relations: SymbolRelation[]): void;
+    /** Get a graph node by ID. */
+    getGraphNode(id: number): GraphNode | null;
+    /** Get edges for a graph node. */
+    getGraphEdges(nodeId: number, direction?: "incoming" | "outgoing" | "both", kind?: string): GraphEdge[];
+    /** Search graph nodes by name (LIKE fallback). */
+    searchGraphNodes(query: string, limit?: number): GraphNode[];
+    /** Search graph nodes by name using FTS5. */
+    searchGraphNodesFTS(query: string, limit?: number): GraphNode[];
+    /** CamelCase-aware graph search — split query into segments. */
+    searchGraphNodesCamel(query: string, limit?: number): GraphNode[];
+    /** Find a path between two graph nodes using BFS. */
+    findGraphPath(fromNodeId: number, toNodeId: number, maxDepth?: number): GraphEdge[] | null;
+    /** Remove graph entries for a file (cascade via FK — foreign_keys must be ON). */
+    removeGraphForFile(file: string): void;
+    /** Clear all graph data. */
+    clearGraph(): void;
+    getRelations(): SymbolRelation[];
+    getRelationsForSymbol(symbol: string): SymbolRelation[];
+    addRelation(relation: SymbolRelation): void;
+    addRelations(relations: SymbolRelation[]): void;
+    clearRelations(): void;
+    getFilesByLanguage(): Record<string, string[]>;
+    addFile(language: string, filePath: string): void;
+    setFilesByLanguage(files: Record<string, string[]>): void;
+    getIndexedCommit(): string | null;
+    setIndexedCommit(sha: string): void;
+    getIndexedAt(): string | null;
+    setIndexedAt(ts: string): void;
+    purge(): void;
+    addExperience(exp: Experience): void;
+    getExperience(id: string): Experience | null;
+    getAllExperiences(repo?: string): Experience[];
+    updateExperience(id: string, updates: Partial<Experience>): void;
+    deleteExperience(id: string): void;
+    addMemory(mem: Memory): void;
+    getMemory(id: string): Memory | null;
+    getAllMemories(repo?: string): Memory[];
+    updateMemory(id: string, updates: Partial<Memory>): void;
+    deleteMemory(id: string): void;
+    updateQualityScore(id: string, delta: number): void;
+    save(result: ValidationResult): void;
+    getLatest(limit?: number): ValidationResult[];
+    vacuum(): void;
+    backup(destPath: string): void;
+    private ensureOpen;
+    private rowToSymbol;
+    private rowToExperience;
+    private rowToMemory;
+}
+export declare function getStore(dbPath?: string): SQLiteStore;
+export declare function closeStore(): void;
+/** CamelCase / snake_case splitting for fuzzy symbol matching. */
+export declare function nameSegmentVocab(name: string): string[];
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/store/sqlite.d.ts.map

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