@massa-ai/core 1.2.1

package/dist/tools/trace_path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace_path.d.ts","sourceRoot":"","sources":["../../src/tools/trace_path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA+B9D,qBAAa,aAAc,YAAW,YAAY;IAChD,IAAI,SAAgB;IACpB,WAAW,SAI+E;IAE1F,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAkET;IAEI,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CAqGrD"}

package/dist/tools/trace_path.js

@@ -0,0 +1,181 @@
+/**
+ * Trace Path Tool (trace_path)
+ *
+ * Trace paths through the code graph from a seed symbol, following typed
+ * structural edges (CALLS / DATA_FLOWS / HTTP_CALLS / EMITS / LISTENS).
+ *
+ * Modes:
+ *   - calls        → follow CALL edges (who calls whom)
+ *   - data_flow    → follow CALL + DATA_FLOW edges (value propagation)
+ *   - cross_service→ follow HTTP_CALL + EMITS + LISTENS + DATA_FLOW edges
+ *   - all          → follow every typed edge
+ *
+ * Direction: outbound (what the seed reaches) | inbound (what reaches the
+ * seed) | both. Default outbound.
+ *
+ * Use INSTEAD OF grep for callers, dependencies, impact analysis, or data
+ * flow tracing — it walks the indexed graph with cycle + depth bounds.
+ */
+import { tracePathService } from "../services/symbol/trace-path.js";
+import { serializeToolResponse } from "./serialize.js";
+import { validateEnum, ToolError } from "./enum-validation.js";
+import { getActiveGeneration, assertGenerationNotStale } from "../services/symbol/active-generation.js";
+export class TracePathTool {
+    name = "trace_path";
+    description = "Trace paths through the code graph from a seed symbol, following typed edges (CALLS/DATA_FLOWS/HTTP_CALLS/EMITS/LISTENS). " +
+        "Modes: calls (callers/callees), data_flow (value propagation), cross_service (HTTP/async hops), all. " +
+        "Direction: outbound (what it reaches) | inbound (what reaches it) | both. " +
+        "Use INSTEAD OF grep for callers, dependencies, impact analysis, or data flow tracing.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            function_name: {
+                type: "string",
+                description: "Seed symbol name (bare name resolved against definitions). Aliases: symbol, qualifiedName.",
+            },
+            symbol: { type: "string", description: "Alias for function_name." },
+            qualifiedName: {
+                type: "string",
+                description: "Fully-qualified name (e.g. 'services/search/rlm.ts#ContextualSearchRLM') — skips name resolution.",
+            },
+            projectId: { type: "string", description: "The project ID to trace in" },
+            direction: {
+                type: "string",
+                enum: ["outbound", "inbound", "both"],
+                default: "outbound",
+                description: "outbound = what the seed calls/flows to; inbound = what calls/flows into it; both = run each.",
+            },
+            mode: {
+                type: "string",
+                enum: ["calls", "data_flow", "cross_service", "all"],
+                default: "calls",
+                description: "calls: follow CALL edges. data_flow: CALL + DATA_FLOW. cross_service: HTTP_CALL + EMITS + LISTENS + DATA_FLOW. all: every typed edge.",
+            },
+            depth: {
+                type: "number",
+                description: "Max BFS depth (default 3, hard cap 6 to bound cost).",
+                default: 3,
+            },
+            include_tests: {
+                type: "boolean",
+                default: false,
+                description: "Whether to traverse into test files (default false).",
+            },
+            edge_types: {
+                type: "array",
+                items: { type: "string" },
+                description: "Explicit edge-type override (wins over mode): call|data_flow|http_call|emit|listen|import|type_ref|extend|implement.",
+            },
+            deadline_ms: {
+                type: "number",
+                default: 5000,
+                description: "Wall-clock budget (ms) bounding the graph traversal. If exceeded the walk aborts with truncated=true and partial nodes/edges. Default 5000.",
+            },
+            format: {
+                type: "string",
+                enum: ["json", "toon"],
+                description: "Output format (json or toon). Default: json.",
+                default: "json",
+            },
+            fields: {
+                type: "array",
+                items: { type: "string" },
+                description: "Projection — keep only these keys (dotted paths supported, e.g. ['nodes.symbol']). Absent/empty → full data.",
+            },
+            ifNoneMatch: {
+                type: "string",
+                description: "Optional precondition: the client's last-known `activatedGraphGenerationId`. If it mismatches the current active generation, the tool returns a 412 teaching error.",
+            },
+        },
+        required: ["projectId", "function_name"],
+    };
+    async handle(params) {
+        const p = params;
+        const { format = "json", fields } = p;
+        const seed = p.function_name ?? p.symbol ?? p.qualifiedName;
+        if (!seed) {
+            return { success: false, error: "function_name (or symbol/qualifiedName) is required" };
+        }
+        if (!p.projectId) {
+            return { success: false, error: "projectId is required" };
+        }
+        const direction = validateEnum("direction", p.direction ?? "outbound", ["outbound", "inbound", "both"]);
+        const mode = validateEnum("mode", p.mode ?? "calls", ["calls", "data_flow", "cross_service", "all"]);
+        // N1 (WAVE4-N1): surface the active graph generation id + opt-in stale
+        // precondition. The lookup is cheap; the precondition is opt-in.
+        const activatedGraphGenerationId = await getActiveGeneration(p.projectId);
+        try {
+            assertGenerationNotStale(p.ifNoneMatch, activatedGraphGenerationId);
+        }
+        catch (e) {
+            if (e instanceof ToolError) {
+                return { success: false, error: e.message };
+            }
+            throw e;
+        }
+        try {
+            const result = await tracePathService.tracePath({
+                symbol: p.function_name ?? p.symbol ?? "",
+                function_name: p.function_name,
+                qualifiedName: p.qualifiedName,
+                projectId: p.projectId,
+                direction,
+                mode,
+                depth: p.depth,
+                include_tests: p.include_tests,
+                edge_types: p.edge_types,
+                deadlineMs: p.deadline_ms,
+            });
+            if (result.seeds.length === 0) {
+                return {
+                    success: false,
+                    error: `Symbol '${seed}' not found in project '${p.projectId}'.`,
+                    data: {
+                        hint: "Use search_definitions(search=...) to find the exact name, then pass it to trace_path. " +
+                            "Or pass a fully-qualified name (qualifiedName='rel/path.ts#Name') to skip name resolution.",
+                        // N1 (WAVE4-N1): still surface the generation id on the not-found path.
+                        activatedGraphGenerationId,
+                    },
+                };
+            }
+            return serializeToolResponse({
+                projectId: result.projectId,
+                symbol: result.symbol,
+                mode: result.mode,
+                direction: result.direction,
+                edgeTypes: result.edgeTypes,
+                seeds: result.seeds,
+                truncated: result.truncated,
+                nodes_total: result.nodes_total,
+                nodes_shown: result.nodes_shown,
+                nodes_omitted: result.nodes_omitted,
+                nodeCount: result.nodes.length,
+                edgeCount: result.edges.length,
+                nodes: result.nodes,
+                edges: result.edges.map((e) => ({
+                    type: e.type,
+                    from: e.from,
+                    to: e.to,
+                    fromFile: e.fromFile,
+                    fromLine: e.fromLine,
+                    meta: e.meta,
+                })),
+                chains: result.chains,
+                // N1 (WAVE4-N1): the active graph generation id at query time.
+                activatedGraphGenerationId,
+            }, 
+            // Wave 5 FR-07: tree format groups nodes by file via the shared
+            // groupRowsByPrefix helper. json/toon unchanged when tree not selected.
+            format === "tree"
+                ? { format, fields, groupBy: { file: "file" } }
+                : { format, fields });
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to trace path: ${error.message}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=trace_path.js.map

package/dist/tools/trace_path.js.map

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

package/dist/tools/update_memory.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Update Memory Tool
+ *
+ * Thin MCP tool layer — validates input and delegates to MemoryController.
+ * Supports partial updates: content (re-embedded), importance, and tags
+ * (replace or merge). All business logic lives in controllers/memory-controller.ts.
+ */
+import { IToolHandler, ToolResponse } from "@massa-ai/shared";
+export declare class UpdateMemoryTool implements IToolHandler {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            importance: {
+                type: string;
+                description: string;
+                minimum: number;
+                maximum: number;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            mergeTags: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            fields: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    private controller;
+    constructor();
+    handle(params: unknown): Promise<ToolResponse>;
+}
+//# sourceMappingURL=update_memory.d.ts.map

package/dist/tools/update_memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_memory.d.ts","sourceRoot":"","sources":["../../src/tools/update_memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAe9D,qBAAa,gBAAiB,YAAW,YAAY;IACnD,IAAI,SAAmB;IACvB,WAAW,SAC0F;IACrG,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmCT;IAEF,OAAO,CAAC,UAAU,CAAmB;;IAM/B,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CAsBrD"}

package/dist/tools/update_memory.js

@@ -0,0 +1,74 @@
+/**
+ * Update Memory Tool
+ *
+ * Thin MCP tool layer — validates input and delegates to MemoryController.
+ * Supports partial updates: content (re-embedded), importance, and tags
+ * (replace or merge). All business logic lives in controllers/memory-controller.ts.
+ */
+import { logger } from "@massa-ai/shared";
+import { MemoryController } from "../controllers/memory-controller.js";
+import { serializeToolResponse } from "./serialize.js";
+export class UpdateMemoryTool {
+    name = "update_memory";
+    description = "Update an existing memory by id (content, importance, or tags). Content changes are re-embedded.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            id: { type: "string", description: "ID of the memory to update" },
+            content: { type: "string", description: "New content (re-embedded when set)" },
+            importance: {
+                type: "number",
+                description: "New importance score (0-1)",
+                minimum: 0,
+                maximum: 1,
+            },
+            tags: {
+                type: "array",
+                items: { type: "string" },
+                description: "Tags (replace existing unless mergeTags is true)",
+            },
+            mergeTags: {
+                type: "boolean",
+                description: "Union tags with existing instead of replacing",
+                default: false,
+            },
+            format: {
+                type: "string",
+                enum: ["json", "toon"],
+                description: "Output format (json or toon)",
+                default: "toon",
+            },
+            fields: {
+                type: "array",
+                items: { type: "string" },
+                description: "Projection — keep only these keys (dotted paths supported, e.g. ['nodes.symbol']). Absent/empty → full data.",
+            },
+        },
+        required: ["id"],
+    };
+    controller;
+    constructor() {
+        this.controller = MemoryController.getInstance();
+    }
+    async handle(params) {
+        const { id, content, importance, tags, mergeTags, format = "toon", fields } = params;
+        try {
+            const result = await this.controller.update({
+                id,
+                content,
+                importance,
+                tags,
+                mergeTags,
+            });
+            return serializeToolResponse(result, { format, fields });
+        }
+        catch (error) {
+            logger.error("Failed to update memory", error, { id });
+            return {
+                success: false,
+                error: `Failed to update memory: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=update_memory.js.map

package/dist/tools/update_memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_memory.js","sourceRoot":"","sources":["../../src/tools/update_memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAYvD,MAAM,OAAO,gBAAgB;IAC3B,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GACT,kGAAkG,CAAC;IACrG,WAAW,GAAG;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;YACjE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC9E,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;gBACzC,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;aACX;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,kDAAkD;aAChE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,+CAA+C;gBAC5D,OAAO,EAAE,KAAK;aACf;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;gBACtB,WAAW,EAAE,8BAA8B;gBAC3C,OAAO,EAAE,MAAM;aAChB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,8GAA8G;aACjH;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;KACjB,CAAC;IAEM,UAAU,CAAmB;IAErC;QACE,IAAI,CAAC,UAAU,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAe;QAC1B,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,GACzE,MAA4B,CAAC;QAE/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBAC1C,EAAE;gBACF,OAAO;gBACP,UAAU;gBACV,IAAI;gBACJ,SAAS;aACV,CAAC,CAAC;YAEH,OAAO,qBAAqB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAc,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAChE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aAC5F,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@massa-ai/core",
+  "version": "1.2.1",
+  "author": "luizgmassa",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "prisma"
+  ],
+  "bundledDependencies": [
+    "tree-sitter"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "default": "./dist/tools/index.js"
+    },
+    "./services": {
+      "types": "./dist/services/index.d.ts",
+      "default": "./dist/services/index.js"
+    },
+    "./controllers": {
+      "types": "./dist/controllers/index.d.ts",
+      "default": "./dist/controllers/index.js"
+    }
+  },
+  "scripts": {
+    "prebuild": "bunx prisma generate",
+    "build": "rm -f tsconfig.tsbuildinfo && tsc && cp -r src/generated dist/",
+    "dev": "bunx tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "bun scripts/run-tests-isolated.ts",
+    "test:unit": "bun scripts/run-tests-isolated.ts --unit",
+    "test:e2e": "RUN_E2E=1 bun scripts/run-tests-isolated.ts --e2e",
+    "test:integration": "bun test src/__tests__/integration/real-api.test.ts",
+    "test:watch": "bun test --watch",
+    "bench:fixture:sicad": "bun run src/scripts/create-sicad-beir-fixture.ts",
+    "bench:beir": "bun run src/scripts/beir-benchmark.ts"
+  },
+  "dependencies": {
+    "@ai-sdk/cohere": "^3.0.17",
+    "@ai-sdk/google": "^3.0.19",
+    "@ai-sdk/mistral": "^3.0.17",
+    "@ai-sdk/openai": "^3.0.24",
+    "@massa-ai/shared": "^1.2.1",
+    "@prisma/adapter-pg": "^7.5.0",
+    "@prisma/client": "^7.5.0",
+    "@prisma/client-runtime-utils": "^7.3.0",
+    "@tree-sitter-grammars/tree-sitter-kotlin": "1.1.0",
+    "@tree-sitter-grammars/tree-sitter-lua": "0.4.1",
+    "@tree-sitter-grammars/tree-sitter-markdown": "0.3.2",
+    "@tree-sitter-grammars/tree-sitter-yaml": "0.7.1",
+    "@tree-sitter-grammars/tree-sitter-zig": "1.1.2",
+    "@toon-format/toon": "^2.1.0",
+    "@huggingface/transformers": "^3.0.0",
+    "ai": "^6.0.66",
+    "glob": "^10.0.0",
+    "ignore": "^5.3.0",
+    "minimatch": "^9.0.0",
+    "ollama-ai-provider": "1.2.0",
+    "pg": "^8.20.0",
+    "tree-sitter": "0.25.0",
+    "tree-sitter-c": "0.24.1",
+    "tree-sitter-c-sharp": "0.23.5",
+    "tree-sitter-clojure-orchard": "0.2.5",
+    "tree-sitter-cpp": "0.23.4",
+    "tree-sitter-dart": "github:UserNobody14/tree-sitter-dart#be07cf7118d3dba06236a3f19541685a68209934",
+    "tree-sitter-elixir": "0.3.5",
+    "tree-sitter-erlang": "github:WhatsApp/tree-sitter-erlang#836aa2b6c3af2c7cef3f84049b0ed6d44485a870",
+    "tree-sitter-go": "0.25.0",
+    "tree-sitter-haskell": "0.23.1",
+    "tree-sitter-html": "0.23.2",
+    "tree-sitter-java": "0.23.5",
+    "tree-sitter-javascript": "0.25.0",
+    "tree-sitter-json": "0.24.8",
+    "tree-sitter-ocaml": "0.24.2",
+    "tree-sitter-php": "0.24.2",
+    "tree-sitter-python": "0.25.0",
+    "tree-sitter-ruby": "0.23.1",
+    "tree-sitter-rust": "0.24.0",
+    "tree-sitter-scala": "0.24.0",
+    "tree-sitter-swift": "0.7.1",
+    "tree-sitter-typescript": "0.23.2",
+    "turndown": "^7.2.4",
+    "turndown-plugin-gfm": "^1.0.2",
+    "zod": "^4.1.8"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.9",
+    "@types/glob": "^8.1.0",
+    "@types/node": "^25.2.2",
+    "@types/turndown": "^5.0.6",
+    "dotenv": "^17.2.4",
+    "prisma": "^7.5.0",
+    "typescript": "^5.8.3"
+  }
+}

package/prisma/migrations/20260309210441_init/migration.sql

@@ -0,0 +1,127 @@
+-- CreateTable
+CREATE TABLE "memories" (
+    "id" TEXT NOT NULL,
+    "content" TEXT NOT NULL,
+    "type" TEXT NOT NULL,
+    "level" INTEGER NOT NULL,
+    "user_id" TEXT,
+    "session_id" TEXT,
+    "project_id" TEXT,
+    "agent_id" TEXT,
+    "importance" DOUBLE PRECISION NOT NULL DEFAULT 0.5,
+    "tags" TEXT,
+    "metadata" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+    "access_count" INTEGER NOT NULL DEFAULT 0,
+
+    CONSTRAINT "memories_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "projects" (
+    "id" TEXT NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "path" TEXT NOT NULL,
+    "document_count" INTEGER NOT NULL DEFAULT 0,
+    "total_size" INTEGER NOT NULL DEFAULT 0,
+    "last_indexed" TIMESTAMP(3),
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "projects_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "documents" (
+    "id" TEXT NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "file_path" TEXT NOT NULL,
+    "file_type" TEXT,
+    "size" INTEGER NOT NULL DEFAULT 0,
+    "indexed_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "documents_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "search_queries" (
+    "id" TEXT NOT NULL,
+    "query" TEXT NOT NULL,
+    "project_id" TEXT,
+    "results_count" INTEGER NOT NULL DEFAULT 0,
+    "duration" INTEGER NOT NULL,
+    "cache_hit" BOOLEAN NOT NULL DEFAULT false,
+    "timestamp" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "search_queries_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "cache_stats" (
+    "id" TEXT NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "query_hash" TEXT NOT NULL,
+    "hit_count" INTEGER NOT NULL DEFAULT 0,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "last_hit_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "cache_stats_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "memories_user_id_idx" ON "memories"("user_id");
+
+-- CreateIndex
+CREATE INDEX "memories_session_id_idx" ON "memories"("session_id");
+
+-- CreateIndex
+CREATE INDEX "memories_project_id_idx" ON "memories"("project_id");
+
+-- CreateIndex
+CREATE INDEX "memories_agent_id_idx" ON "memories"("agent_id");
+
+-- CreateIndex
+CREATE INDEX "memories_type_idx" ON "memories"("type");
+
+-- CreateIndex
+CREATE INDEX "memories_importance_idx" ON "memories"("importance" DESC);
+
+-- CreateIndex
+CREATE INDEX "memories_created_at_idx" ON "memories"("created_at" DESC);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "projects_project_id_key" ON "projects"("project_id");
+
+-- CreateIndex
+CREATE INDEX "projects_project_id_idx" ON "projects"("project_id");
+
+-- CreateIndex
+CREATE INDEX "projects_last_indexed_idx" ON "projects"("last_indexed" DESC);
+
+-- CreateIndex
+CREATE INDEX "documents_project_id_idx" ON "documents"("project_id");
+
+-- CreateIndex
+CREATE INDEX "documents_file_type_idx" ON "documents"("file_type");
+
+-- CreateIndex
+CREATE INDEX "documents_indexed_at_idx" ON "documents"("indexed_at" DESC);
+
+-- CreateIndex
+CREATE INDEX "search_queries_project_id_idx" ON "search_queries"("project_id");
+
+-- CreateIndex
+CREATE INDEX "search_queries_timestamp_idx" ON "search_queries"("timestamp" DESC);
+
+-- CreateIndex
+CREATE INDEX "cache_stats_project_id_idx" ON "cache_stats"("project_id");
+
+-- CreateIndex
+CREATE INDEX "cache_stats_hit_count_idx" ON "cache_stats"("hit_count" DESC);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "cache_stats_project_id_query_hash_key" ON "cache_stats"("project_id", "query_hash");
+
+-- AddForeignKey
+ALTER TABLE "documents" ADD CONSTRAINT "documents_project_id_fkey" FOREIGN KEY ("project_id") REFERENCES "projects"("project_id") ON DELETE RESTRICT ON UPDATE CASCADE;