@massa-ai/core 1.2.1

package/prisma/migrations/20260413122356_add_workspaces_symbol_graph/migration.sql

@@ -0,0 +1,224 @@
+/*
+  Migration: add_workspaces_symbol_graph
+  Idempotent version — safe to re-run after partial failures.
+*/
+
+-- Enable pgvector extension (required for vector(N) columns)
+CREATE EXTENSION IF NOT EXISTS vector;
+
+-- DropIndex (may have been dropped already by a previous run)
+DROP INDEX IF EXISTS "projects_project_id_idx";
+
+-- AlterTable memories — add new columns only if they don't exist yet
+ALTER TABLE "memories" ADD COLUMN IF NOT EXISTS "embedding" BYTEA;
+ALTER TABLE "memories" ADD COLUMN IF NOT EXISTS "last_accessed" TIMESTAMP(3);
+ALTER TABLE "memories" ADD COLUMN IF NOT EXISTS "tags" TEXT[] DEFAULT ARRAY[]::TEXT[];
+ALTER TABLE "memories" ADD COLUMN IF NOT EXISTS "metadata" JSONB;
+
+-- AlterTable cache_stats
+ALTER TABLE "cache_stats" ALTER COLUMN "last_hit_at" SET DEFAULT CURRENT_TIMESTAMP;
+
+-- CreateTable workspaces
+CREATE TABLE IF NOT EXISTS "workspaces" (
+    "project_id" TEXT NOT NULL,
+    "project_path" TEXT NOT NULL,
+    "display_name" TEXT,
+    "status" TEXT NOT NULL DEFAULT 'pending',
+    "last_indexed_at" TIMESTAMP(3),
+    "last_error" TEXT,
+    "files_count" INTEGER NOT NULL DEFAULT 0,
+    "chunks_count" INTEGER NOT NULL DEFAULT 0,
+    "symbols_count" INTEGER NOT NULL DEFAULT 0,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT "workspaces_pkey" PRIMARY KEY ("project_id")
+);
+
+-- CreateTable symbol_files
+CREATE TABLE IF NOT EXISTS "symbol_files" (
+    "project_id" TEXT NOT NULL,
+    "relative_path" TEXT NOT NULL,
+    "content_hash" TEXT NOT NULL,
+    "mtime" BIGINT NOT NULL,
+    "size" INTEGER NOT NULL DEFAULT 0,
+    "indexed_at" TIMESTAMP(3) NOT NULL,
+    "symbol_count" INTEGER NOT NULL DEFAULT 0,
+    "chunk_count" INTEGER NOT NULL DEFAULT 0,
+    CONSTRAINT "symbol_files_pkey" PRIMARY KEY ("project_id","relative_path")
+);
+
+-- CreateTable symbol_definitions
+CREATE TABLE IF NOT EXISTS "symbol_definitions" (
+    "id" TEXT NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "file_path" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "kind" TEXT NOT NULL,
+    "line_start" INTEGER NOT NULL,
+    "line_end" INTEGER NOT NULL,
+    "exported" BOOLEAN NOT NULL DEFAULT false,
+    "doc_comment" TEXT,
+    "indexed_at" TIMESTAMP(3) NOT NULL,
+    CONSTRAINT "symbol_definitions_pkey" PRIMARY KEY ("project_id","id")
+);
+
+-- CreateTable symbol_references
+CREATE TABLE IF NOT EXISTS "symbol_references" (
+    "id" SERIAL NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "from_file" TEXT NOT NULL,
+    "from_line" INTEGER NOT NULL,
+    "symbol_name" TEXT NOT NULL,
+    "target_fqn" TEXT NOT NULL,
+    "ref_kind" TEXT NOT NULL,
+    CONSTRAINT "symbol_references_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable symbol_imports
+CREATE TABLE IF NOT EXISTS "symbol_imports" (
+    "id" SERIAL NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "from_file" TEXT NOT NULL,
+    "to_file" TEXT,
+    "specifier" TEXT NOT NULL,
+    "imported_names" TEXT[] DEFAULT ARRAY[]::TEXT[],
+    "is_external" BOOLEAN NOT NULL DEFAULT false,
+    "is_type_only" BOOLEAN NOT NULL DEFAULT false,
+    CONSTRAINT "symbol_imports_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable symbol_centrality
+CREATE TABLE IF NOT EXISTS "symbol_centrality" (
+    "project_id" TEXT NOT NULL,
+    "file_path" TEXT NOT NULL,
+    "score" DOUBLE PRECISION NOT NULL DEFAULT 0,
+    "updated_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT "symbol_centrality_pkey" PRIMARY KEY ("project_id","file_path")
+);
+
+-- CreateTable memory_edges
+CREATE TABLE IF NOT EXISTS "memory_edges" (
+    "id" SERIAL NOT NULL,
+    "from_id" TEXT NOT NULL,
+    "to_id" TEXT NOT NULL,
+    "edge_type" TEXT NOT NULL,
+    "weight" DOUBLE PRECISION NOT NULL DEFAULT 1.0,
+    "metadata" JSONB,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT "memory_edges_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable embedding_cache
+CREATE TABLE IF NOT EXISTS "embedding_cache" (
+    "text_hash" TEXT NOT NULL,
+    "embedding" BYTEA NOT NULL,
+    "model" TEXT NOT NULL DEFAULT 'nomic-embed-text',
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "accessed_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "hit_count" INTEGER NOT NULL DEFAULT 1,
+    CONSTRAINT "embedding_cache_pkey" PRIMARY KEY ("text_hash")
+);
+
+-- CreateTable vector_documents_1024d
+CREATE TABLE IF NOT EXISTS "vector_documents_1024d" (
+    "id" TEXT NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "content" TEXT NOT NULL,
+    "metadata" JSONB NOT NULL DEFAULT '{}',
+    "embedding" vector(1024),
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT "vector_documents_1024d_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable vector_documents_3072d
+CREATE TABLE IF NOT EXISTS "vector_documents_3072d" (
+    "id" TEXT NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "content" TEXT NOT NULL,
+    "metadata" JSONB NOT NULL DEFAULT '{}',
+    "embedding" vector(3072),
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT "vector_documents_3072d_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable vector_documents (legacy)
+CREATE TABLE IF NOT EXISTS "vector_documents" (
+    "id" TEXT NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "content" TEXT NOT NULL,
+    "metadata" JSONB NOT NULL DEFAULT '{}',
+    "embedding" vector(1024),
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT "vector_documents_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex (IF NOT EXISTS where supported via DO block)
+CREATE INDEX IF NOT EXISTS "workspaces_status_idx" ON "workspaces"("status");
+CREATE INDEX IF NOT EXISTS "workspaces_project_path_idx" ON "workspaces"("project_path");
+CREATE INDEX IF NOT EXISTS "symbol_files_project_id_idx" ON "symbol_files"("project_id");
+CREATE INDEX IF NOT EXISTS "symbol_definitions_project_id_idx" ON "symbol_definitions"("project_id");
+CREATE INDEX IF NOT EXISTS "symbol_definitions_project_id_file_path_idx" ON "symbol_definitions"("project_id", "file_path");
+CREATE INDEX IF NOT EXISTS "symbol_definitions_project_id_name_idx" ON "symbol_definitions"("project_id", "name");
+CREATE INDEX IF NOT EXISTS "symbol_references_project_id_idx" ON "symbol_references"("project_id");
+CREATE INDEX IF NOT EXISTS "symbol_references_project_id_target_fqn_idx" ON "symbol_references"("project_id", "target_fqn");
+CREATE INDEX IF NOT EXISTS "symbol_references_project_id_from_file_idx" ON "symbol_references"("project_id", "from_file");
+CREATE INDEX IF NOT EXISTS "symbol_imports_project_id_from_file_idx" ON "symbol_imports"("project_id", "from_file");
+CREATE INDEX IF NOT EXISTS "symbol_imports_project_id_to_file_idx" ON "symbol_imports"("project_id", "to_file");
+CREATE INDEX IF NOT EXISTS "symbol_imports_imported_names_idx" ON "symbol_imports"("imported_names");
+CREATE INDEX IF NOT EXISTS "memory_edges_from_id_idx" ON "memory_edges"("from_id");
+CREATE INDEX IF NOT EXISTS "memory_edges_to_id_idx" ON "memory_edges"("to_id");
+CREATE INDEX IF NOT EXISTS "memory_edges_edge_type_idx" ON "memory_edges"("edge_type");
+CREATE UNIQUE INDEX IF NOT EXISTS "memory_edges_from_id_to_id_edge_type_key" ON "memory_edges"("from_id", "to_id", "edge_type");
+CREATE INDEX IF NOT EXISTS "embedding_cache_model_idx" ON "embedding_cache"("model");
+CREATE INDEX IF NOT EXISTS "embedding_cache_accessed_at_idx" ON "embedding_cache"("accessed_at" DESC);
+CREATE INDEX IF NOT EXISTS "vector_documents_1024d_project_id_idx" ON "vector_documents_1024d"("project_id");
+CREATE INDEX IF NOT EXISTS "vector_documents_3072d_project_id_idx" ON "vector_documents_3072d"("project_id");
+CREATE INDEX IF NOT EXISTS "vector_documents_project_id_idx" ON "vector_documents"("project_id");
+CREATE INDEX IF NOT EXISTS "memories_tags_idx" ON "memories"("tags");
+
+-- AddForeignKey (only if not exists)
+DO $$ BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'symbol_files_project_id_fkey') THEN
+    ALTER TABLE "symbol_files" ADD CONSTRAINT "symbol_files_project_id_fkey" FOREIGN KEY ("project_id") REFERENCES "workspaces"("project_id") ON DELETE CASCADE ON UPDATE CASCADE;
+  END IF;
+END $$;
+
+DO $$ BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'symbol_definitions_project_id_fkey') THEN
+    ALTER TABLE "symbol_definitions" ADD CONSTRAINT "symbol_definitions_project_id_fkey" FOREIGN KEY ("project_id") REFERENCES "workspaces"("project_id") ON DELETE CASCADE ON UPDATE CASCADE;
+  END IF;
+END $$;
+
+DO $$ BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'symbol_references_project_id_fkey') THEN
+    ALTER TABLE "symbol_references" ADD CONSTRAINT "symbol_references_project_id_fkey" FOREIGN KEY ("project_id") REFERENCES "workspaces"("project_id") ON DELETE CASCADE ON UPDATE CASCADE;
+  END IF;
+END $$;
+
+DO $$ BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'symbol_imports_project_id_fkey') THEN
+    ALTER TABLE "symbol_imports" ADD CONSTRAINT "symbol_imports_project_id_fkey" FOREIGN KEY ("project_id") REFERENCES "workspaces"("project_id") ON DELETE CASCADE ON UPDATE CASCADE;
+  END IF;
+END $$;
+
+DO $$ BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'symbol_centrality_project_id_fkey') THEN
+    ALTER TABLE "symbol_centrality" ADD CONSTRAINT "symbol_centrality_project_id_fkey" FOREIGN KEY ("project_id") REFERENCES "workspaces"("project_id") ON DELETE CASCADE ON UPDATE CASCADE;
+  END IF;
+END $$;
+
+DO $$ BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'memory_edges_from_id_fkey') THEN
+    ALTER TABLE "memory_edges" ADD CONSTRAINT "memory_edges_from_id_fkey" FOREIGN KEY ("from_id") REFERENCES "memories"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+  END IF;
+END $$;
+
+DO $$ BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'memory_edges_to_id_fkey') THEN
+    ALTER TABLE "memory_edges" ADD CONSTRAINT "memory_edges_to_id_fkey" FOREIGN KEY ("to_id") REFERENCES "memories"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+  END IF;
+END $$;

package/prisma/migrations/20260413200000_add_vector_4096_bq/migration.sql

@@ -0,0 +1,33 @@
+/*
+  Migration: add_vector_4096_bq
+  Adds vector_documents_4096d table with binary-quantized column for HNSW indexing.
+  pgvector 0.8+ supports HNSW on bit columns (any dimension) via bit_hamming_ops.
+  Idempotent — safe to re-run.
+*/
+
+-- CreateTable vector_documents_4096d (idempotent)
+CREATE TABLE IF NOT EXISTS "vector_documents_4096d" (
+    "id" TEXT NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "content" TEXT NOT NULL,
+    "metadata" JSONB NOT NULL DEFAULT '{}',
+    "embedding" vector(4096),
+    "embedding_bq" bit(4096),
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT "vector_documents_4096d_pkey" PRIMARY KEY ("id")
+);
+
+-- AddColumn: add embedding_bq if the table already existed without it
+ALTER TABLE "vector_documents_4096d" ADD COLUMN IF NOT EXISTS "embedding_bq" bit(4096);
+
+-- CreateIndex: project lookup
+CREATE INDEX IF NOT EXISTS "vector_documents_4096d_project_id_idx"
+    ON "vector_documents_4096d"("project_id");
+
+-- CreateIndex: HNSW on binary-quantized column (bit_hamming_ops, no dimension limit)
+-- This replaces the unavailable cosine HNSW on the 4096-dim float column.
+CREATE INDEX IF NOT EXISTS "idx_vector_documents_4096d_embedding_bq"
+    ON "vector_documents_4096d"
+    USING hnsw (embedding_bq bit_hamming_ops)
+    WITH (m = 16, ef_construction = 64);

package/prisma/migrations/20260419193214_hnsw_ef_construction_128/migration.sql

@@ -0,0 +1,38 @@
+/*
+  Migration: hnsw_ef_construction_128
+
+  Rebuilds the HNSW BQ index on vector_documents_4096d with ef_construction=128
+  (up from 64) — pgvector's recommended value for high-dim embeddings (4096d
+  qwen3-embedding). Build time roughly doubles; runtime search latency is
+  unaffected (controlled by hnsw.ef_search GUC, not ef_construction).
+
+  Only affects 4096d because that is the only dimension whose HNSW index is
+  created via migration. Indexes for 1024d and 3072d are created lazily at
+  runtime by PostgresVectorStore.createVectorIndex() and pick up the new
+  default (128) on next index creation.
+
+  -- Note on CONCURRENTLY --
+  Prisma wraps every migration in a transaction, which blocks CONCURRENTLY.
+  This migration uses plain DROP/CREATE, which briefly locks the table. For
+  production deploys against large tables, run the equivalent CONCURRENTLY
+  statements manually before applying the migration, then mark this migration
+  as already applied:
+
+    -- Run manually against production (outside any transaction):
+    DROP INDEX CONCURRENTLY IF EXISTS "idx_vector_documents_4096d_embedding_bq";
+    CREATE INDEX CONCURRENTLY IF NOT EXISTS "idx_vector_documents_4096d_embedding_bq"
+        ON "vector_documents_4096d"
+        USING hnsw (embedding_bq bit_hamming_ops)
+        WITH (m = 16, ef_construction = 128);
+
+    -- Then tell Prisma to skip re-running it:
+    prisma migrate resolve --applied 20260419193214_hnsw_ef_construction_128
+*/
+
+-- Drop the old BQ HNSW index (ef_construction=64) and recreate with 128
+DROP INDEX IF EXISTS "idx_vector_documents_4096d_embedding_bq";
+
+CREATE INDEX IF NOT EXISTS "idx_vector_documents_4096d_embedding_bq"
+    ON "vector_documents_4096d"
+    USING hnsw (embedding_bq bit_hamming_ops)
+    WITH (m = 16, ef_construction = 128);

package/prisma/migrations/20260419214959_add_vector_1536/migration.sql

@@ -0,0 +1,28 @@
+/*
+  Migration: add_vector_1536
+
+  Adds vector_documents_1536d table for 1536-dimension embedding models.
+  Primary use case: openai/text-embedding-3-small (native 1536 dims, MRL-capable).
+
+  1536 < 2000, so pgvector supports HNSW directly on the vector column with
+  vector_cosine_ops (no binary quantization needed — that path is reserved for
+  dims > 2000 in vector_documents_4096d).
+
+  Idempotent — safe to re-run.
+*/
+
+-- CreateTable
+CREATE TABLE IF NOT EXISTS "vector_documents_1536d" (
+    "id" TEXT NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "content" TEXT NOT NULL,
+    "metadata" JSONB NOT NULL DEFAULT '{}',
+    "embedding" vector(1536),
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT "vector_documents_1536d_pkey" PRIMARY KEY ("id")
+);
+
+-- Project lookup index
+CREATE INDEX IF NOT EXISTS "vector_documents_1536d_project_id_idx"
+    ON "vector_documents_1536d"("project_id");

package/prisma/migrations/20260705060000_add_memories_pinned_softdelete/migration.sql

@@ -0,0 +1,10 @@
+-- Add pinned (decay-exempt) and deleted_at (soft-delete tombstone) to memories.
+-- schema.prisma declares both (lines 35, 37) and the PG repository writes them,
+-- but no prior migration created the columns — every memory store/update/delete
+-- failed with PG 42703 "column pinned of relation memories does not exist".
+-- Additive, safe, matches the schema.
+ALTER TABLE "memories" ADD COLUMN "pinned" BOOLEAN NOT NULL DEFAULT false;
+ALTER TABLE "memories" ADD COLUMN "deleted_at" TIMESTAMP(3);
+
+-- Sparse index on deleted_at (most rows NULL). Matches @@index([deletedAt]).
+CREATE INDEX "memories_deleted_at_idx" ON "memories"("deleted_at");

package/prisma/migrations/20260706105826_drop_symbol_refs_target_fqn_not_null/migration.sql

@@ -0,0 +1,2 @@
+-- Drop NOT NULL on symbol_references.target_fqn so unresolved-target refs can be stored (parity with SQLite backend).
+ALTER TABLE "symbol_references" ALTER COLUMN "target_fqn" DROP NOT NULL;

package/prisma/migrations/20260707100000_add_index_jobs_pg/migration.sql

@@ -0,0 +1,28 @@
+-- Index Jobs (Phase 1, T9): PG parity for the durable job store.
+-- The SQLite store (SqliteJobStore / index-jobs.db) is the local-first default;
+-- this table lets a Postgres deployment keep indexing-job runtime state in the
+-- SAME backend as the rest of the data plane (one-backend rule).
+-- Timestamps are BIGINT ms-epochs (parity with the SQLite store's INTEGER epoch
+-- columns and SymbolFile.mtime). Idempotent — safe to re-run.
+CREATE TABLE IF NOT EXISTS "index_jobs" (
+    "job_id"        TEXT NOT NULL,
+    "project_id"    TEXT NOT NULL,
+    "project_path"  TEXT NOT NULL,
+    "status"        TEXT NOT NULL,
+    "current"       INTEGER NOT NULL DEFAULT 0,
+    "total"         INTEGER NOT NULL DEFAULT 0,
+    "percentage"    INTEGER NOT NULL DEFAULT 0,
+    "files_indexed" INTEGER,
+    "chunks_indexed" INTEGER,
+    "errors"        INTEGER,
+    "duration"      INTEGER,
+    "error"         TEXT,
+    "created_at"    BIGINT NOT NULL,
+    "started_at"    BIGINT,
+    "completed_at"  BIGINT,
+    "heartbeat_at"  BIGINT,
+    CONSTRAINT "index_jobs_pkey" PRIMARY KEY ("job_id")
+);
+
+CREATE INDEX IF NOT EXISTS "index_jobs_project_id_idx" ON "index_jobs"("project_id");
+CREATE INDEX IF NOT EXISTS "index_jobs_status_idx" ON "index_jobs"("status");

package/prisma/migrations/20260709120000_add_scheduled_jobs_pg/migration.sql

@@ -0,0 +1,22 @@
+-- Scheduled Jobs (Phase 3, C2): PG parity for the in-process scheduler.
+-- The SQLite store (SqliteScheduledJobStore / scheduled-jobs.db) is the
+-- local-first default; this table lets a Postgres deployment keep scheduler
+-- state in the SAME backend as the rest of the data plane (one-backend rule).
+-- Timestamps are BIGINT ms-epochs (parity with the SQLite store's INTEGER epoch
+-- columns and IndexJob). Idempotent — safe to re-run.
+CREATE TABLE IF NOT EXISTS "scheduled_jobs" (
+    "id"            TEXT NOT NULL,
+    "name"          TEXT NOT NULL,
+    "job_kind"      TEXT NOT NULL,
+    "schedule_type" TEXT NOT NULL,
+    "interval_ms"   BIGINT,
+    "cron"          TEXT,
+    "next_run_at"   BIGINT NOT NULL,
+    "last_run_at"   BIGINT NOT NULL DEFAULT 0,
+    "enabled"       INTEGER NOT NULL DEFAULT 1,
+    "payload"       TEXT,
+    CONSTRAINT "scheduled_jobs_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX IF NOT EXISTS "scheduled_jobs_enabled_idx" ON "scheduled_jobs"("enabled");
+CREATE INDEX IF NOT EXISTS "scheduled_jobs_next_run_at_idx" ON "scheduled_jobs"("next_run_at");

package/prisma/migrations/20260710120000_add_synapse_sessions_pg/migration.sql

@@ -0,0 +1,36 @@
+-- Synapse Sessions (Phase 3, C4): PG parity for the Synapse session store.
+-- The SQLite store (SqliteSessionStore / synapse-sessions.db) is the
+-- local-first default; these tables let a Postgres deployment persist Synapse
+-- agent-session + working-memory buffer state across process restarts
+-- (one-backend rule). Timestamps are BIGINT ms-epochs (parity with the SQLite
+-- store's INTEGER epoch columns and IndexJob/ScheduledJob). Idempotent — safe
+-- to re-run.
+
+CREATE TABLE IF NOT EXISTS "synapse_sessions" (
+    "session_id"            TEXT NOT NULL,
+    "agent_id"              TEXT NOT NULL,
+    "workspace_id"          TEXT,
+    "task_context"          TEXT,
+    "task_tokens"           TEXT,
+    "task_embedding"        BYTEA,
+    "ttl_ms"                BIGINT NOT NULL,
+    "created_at"            BIGINT NOT NULL,
+    "expires_at"            BIGINT NOT NULL,
+    "access_history_limit"  INTEGER NOT NULL,
+    "buffer_config"         TEXT,
+    "buffer_snapshot"       TEXT,
+    "updated_at"            BIGINT NOT NULL,
+    CONSTRAINT "synapse_sessions_pkey" PRIMARY KEY ("session_id")
+);
+
+CREATE INDEX IF NOT EXISTS "synapse_sessions_expires_at_idx" ON "synapse_sessions"("expires_at");
+
+CREATE TABLE IF NOT EXISTS "synapse_access_history" (
+    "session_id"        TEXT NOT NULL,
+    "memory_id"         TEXT NOT NULL,
+    "access_count"      INTEGER NOT NULL DEFAULT 0,
+    "last_accessed_at"  BIGINT NOT NULL,
+    CONSTRAINT "synapse_access_history_pkey" PRIMARY KEY ("session_id", "memory_id")
+);
+
+CREATE INDEX IF NOT EXISTS "synapse_access_history_session_id_idx" ON "synapse_access_history"("session_id");

package/prisma/migrations/20260710123800_add_observations_pg/migration.sql

@@ -0,0 +1,35 @@
+-- Observations (Phase 3, G1): PG parity for the observation store.
+-- The SQLite store (SqliteObservationStore / observations.db) is the
+-- local-first default; this table lets a Postgres deployment persist the
+-- passive lifecycle captures (hook-ingestion telemetry) and compaction
+-- snapshots in the SAME backend as the rest of the data plane (one-backend
+-- rule). Timestamps are BIGINT ms-epochs (parity with the SQLite store's
+-- INTEGER epoch `created_at` column and the ObservationStore interface's
+-- `createdAt: number`). Idempotent — safe to re-run.
+--
+-- NOTE: the Prisma `Observation` model declares `createdAt DateTime`, but the
+-- ObservationStore interface (and the SQLite store) use a numeric ms-epoch.
+-- PgObservationStore reads/writes created_at as BIGINT to match the store
+-- contract; the Prisma model's DateTime is aspirational and not used by the
+-- raw-SQL store (same discipline as scheduled_jobs / synapse_sessions).
+
+CREATE TABLE IF NOT EXISTS "observations" (
+    "id"            TEXT NOT NULL,
+    "project_id"    TEXT NOT NULL,
+    "session_id"    TEXT,
+    "source"        TEXT NOT NULL,
+    "category"      TEXT,
+    "payload_json"  TEXT NOT NULL,
+    "importance"    DOUBLE PRECISION NOT NULL,
+    "created_at"    BIGINT NOT NULL,
+    CONSTRAINT "observations_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX IF NOT EXISTS "observations_project_id_created_at_idx"
+    ON "observations"("project_id", "created_at" DESC);
+
+CREATE INDEX IF NOT EXISTS "observations_session_id_idx"
+    ON "observations"("session_id");
+
+CREATE INDEX IF NOT EXISTS "observations_session_id_created_at_idx"
+    ON "observations"("session_id", "created_at" DESC);

package/prisma/migrations/20260710140000_add_symbol_refs_meta_and_kind_index/migration.sql

@@ -0,0 +1,8 @@
+-- Add nullable `meta` JSON column to symbol_references for typed-edge metadata
+-- (route URL, event name, param index, caller FQN). Backward-compatible:
+-- existing rows have NULL meta. Parity with SQLite backend (migration v2).
+ALTER TABLE "symbol_references" ADD COLUMN "meta" JSONB;
+
+-- Index for typed-edge filtering (WHERE ref_kind IN (...)).
+CREATE INDEX IF NOT EXISTS "symbol_references_project_id_ref_kind_idx"
+  ON "symbol_references" ("project_id", "ref_kind");

package/prisma/migrations/20260710160000_add_task_checkpoints_pg/migration.sql

@@ -0,0 +1,30 @@
+-- Task Checkpoints (Phase 3, #16): PG parity for the checkpoint store.
+-- The SQLite store (CheckpointManager / memories.db / task_checkpoints) is the
+-- local-first default; this table lets a Postgres deployment persist task/INDEX
+-- execution state in the same backend as the rest of the data plane (one-backend
+-- rule). Timestamps are BIGINT ms-epochs (parity with the SQLite store's INTEGER
+-- epoch columns and IndexJob/ScheduledJob/SynapseSession). State is a
+-- gzip-compressed JSON blob (parity with Bun.deflateSync). Idempotent — safe
+-- to re-run.
+
+CREATE TABLE IF NOT EXISTS "task_checkpoints" (
+    "id"                    TEXT NOT NULL,
+    "task_id"               TEXT NOT NULL,
+    "task_description"      TEXT,
+    "agent_id"              TEXT,
+    "project_id"            TEXT,
+    "state"                 BYTEA NOT NULL,
+    "state_schema_version"  INTEGER NOT NULL DEFAULT 1,
+    "memory_ids"            TEXT,
+    "file_changes"          TEXT,
+    "checkpoint_type"       TEXT NOT NULL,
+    "parent_checkpoint_id"  TEXT,
+    "created_at"            BIGINT NOT NULL,
+    "expires_at"            BIGINT,
+    CONSTRAINT "task_checkpoints_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX IF NOT EXISTS "task_checkpoints_task_id_idx" ON "task_checkpoints"("task_id");
+CREATE INDEX IF NOT EXISTS "task_checkpoints_project_id_idx" ON "task_checkpoints"("project_id");
+CREATE INDEX IF NOT EXISTS "task_checkpoints_created_at_idx" ON "task_checkpoints"("created_at");
+CREATE INDEX IF NOT EXISTS "task_checkpoints_checkpoint_type_idx" ON "task_checkpoints"("checkpoint_type");

package/prisma/migrations/20260713090000_add_handoffs_proposals_pg/migration.sql

@@ -0,0 +1,42 @@
+-- PostgreSQL parity for the existing handoff/proposal runtime stores.
+-- Additive only: SQLite tables and runtime fallback remain unchanged.
+
+CREATE TABLE "handoffs" (
+    "id" TEXT NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "source_session_id" TEXT,
+    "target_agent" TEXT,
+    "summary" TEXT NOT NULL DEFAULT '',
+    "open_questions_json" TEXT NOT NULL DEFAULT '[]',
+    "next_steps_json" TEXT NOT NULL DEFAULT '[]',
+    "files_json" TEXT NOT NULL DEFAULT '[]',
+    "status" TEXT NOT NULL DEFAULT 'open',
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "accepted_at" TIMESTAMP(3),
+
+    CONSTRAINT "handoffs_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "handoffs_status_check" CHECK ("status" IN ('open', 'accepted', 'expired'))
+);
+
+CREATE INDEX "handoffs_project_id_status_idx" ON "handoffs"("project_id", "status");
+CREATE INDEX "handoffs_target_agent_status_idx" ON "handoffs"("target_agent", "status");
+CREATE INDEX "handoffs_created_at_idx" ON "handoffs"("created_at" DESC);
+
+CREATE TABLE "proposals" (
+    "id" TEXT NOT NULL,
+    "project_id" TEXT NOT NULL,
+    "kind" TEXT NOT NULL,
+    "target_memory_id" TEXT,
+    "payload_json" TEXT NOT NULL,
+    "rationale" TEXT NOT NULL DEFAULT '',
+    "status" TEXT NOT NULL DEFAULT 'pending',
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "decided_at" TIMESTAMP(3),
+
+    CONSTRAINT "proposals_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "proposals_kind_check" CHECK ("kind" IN ('memory.create', 'memory.update', 'memory.tag')),
+    CONSTRAINT "proposals_status_check" CHECK ("status" IN ('pending', 'approved', 'rejected'))
+);
+
+CREATE INDEX "proposals_project_id_status_idx" ON "proposals"("project_id", "status");
+CREATE INDEX "proposals_created_at_idx" ON "proposals"("created_at" DESC);