bonecode 1.0.0

package/bone/output/rag/src/index.ts

@@ -0,0 +1,95 @@
+// Generated by BoneScript compiler. DO NOT EDIT.
+// System: RAGDomain
+require("dotenv").config();
+import express from "express";
+import { createServer } from "http";
+import cors from "cors";
+import helmet from "helmet";
+import rateLimit from "express-rate-limit";
+import { authMiddleware } from "./auth";
+import { healthRouter } from "./health";
+import { logger } from "./logger";
+import { eventBus } from "./events";
+import { pool } from "./db";
+
+import { knowledgeBasesRouter } from "./routes/knowledge_base";
+import { codeFilesRouter } from "./routes/code_file";
+import { codeChunksRouter } from "./routes/code_chunk";
+import { memoryEntrysRouter } from "./routes/memory_entry";
+import { indexingJobsRouter } from "./routes/indexing_job";
+
+const app = express();
+const httpServer = createServer(app);
+const PORT = parseInt(process.env.PORT || "3000");
+
+// Middleware
+app.use(helmet());
+// CORS: restrict to ALLOWED_ORIGINS env var (comma-separated). Defaults to same-origin only.
+const __allowedOrigins = (process.env.ALLOWED_ORIGINS || "").split(",").map(s => s.trim()).filter(Boolean);
+app.use(cors({
+  origin: __allowedOrigins.length > 0
+    ? (origin, cb) => { if (!origin || __allowedOrigins.includes(origin)) cb(null, true); else cb(new Error("Not allowed by CORS")); }
+    : false,
+  credentials: true,
+}));
+app.use(express.json({ limit: "1mb" }));
+app.use(express.urlencoded({ extended: false, limit: "1mb" }));
+app.use(authMiddleware);
+app.use(rateLimit({ windowMs: 60000, max: 1000 }));
+
+// Request timeout (default 30s, override per-route)
+app.use((req: any, res: any, next: any) => {
+  const timeout = parseInt(process.env.REQUEST_TIMEOUT_MS || "30000");
+  const timer = setTimeout(() => {
+    if (!res.headersSent) {
+      res.status(503).json({ error: { code: "REQUEST_TIMEOUT", message: "Request timed out" } });
+    }
+  }, timeout);
+  res.on("finish", () => clearTimeout(timer));
+  next();
+});
+
+// Health & metrics
+app.use("/health", healthRouter);
+
+// Routes
+app.use("/knowledge_bases", knowledgeBasesRouter);
+app.use("/code_files", codeFilesRouter);
+app.use("/code_chunks", codeChunksRouter);
+app.use("/memory_entrys", memoryEntrysRouter);
+app.use("/indexing_jobs", indexingJobsRouter);
+
+// Start
+httpServer.listen(PORT, () => {
+  logger.info("server_started", { event: "startup", metadata: { port: PORT } });
+  // Start durable event worker (no-op in in_process mode)
+  eventBus.startWorker(parseInt(process.env.EVENT_WORKER_INTERVAL_MS || "1000"));
+  console.log(`[RAGDomain] Running on port ${PORT}`);
+  console.log(`  HTTP routes:`);
+  console.log(`    /knowledge_bases`);
+  console.log(`    /code_files`);
+  console.log(`    /code_chunks`);
+  console.log(`    /memory_entrys`);
+  console.log(`    /indexing_jobs`);
+  console.log(`  Health: /health/live, /health/ready, /health/metrics`);
+});
+
+// Graceful shutdown
+const shutdown = async (signal: string) => {
+  logger.info("server_stopping", { event: "shutdown", metadata: { signal } });
+  httpServer.close(async () => {
+    try {
+      await pool.end();
+      logger.info("server_stopped", { event: "shutdown", status: "success" });
+    } catch (e: any) {
+      logger.error("shutdown_error", { event: "shutdown", metadata: { error: e.message } });
+    }
+    process.exit(0);
+  });
+  // Force exit after 10s if connections don't drain
+  setTimeout(() => { logger.error("shutdown_timeout", { event: "shutdown" }); process.exit(1); }, 10000);
+};
+process.on("SIGTERM", () => shutdown("SIGTERM"));
+process.on("SIGINT", () => shutdown("SIGINT"));
+
+export { app, httpServer };

package/bone/output/rag/src/logger.ts

@@ -0,0 +1,66 @@
+// Generated by BoneScript compiler. DO NOT EDIT.
+// Implements spec/10 §3 (Logging Schema)
+
+import { v4 as uuid } from "uuid";
+
+export type LogLevel = "debug" | "info" | "warn" | "error" | "fatal";
+export type LogStatus = "success" | "failure" | "timeout" | "rejected";
+
+export interface LogEntry {
+  timestamp: string;
+  level: LogLevel;
+  service: string;
+  trace_id: string;
+  span_id: string;
+  event: string;
+  duration_ms?: number;
+  status: LogStatus;
+  entity_id?: string;
+  actor_id?: string | null;
+  error_code?: string | null;
+  metadata?: Record<string, unknown>;
+}
+
+class Logger {
+  private service: string;
+
+  constructor(service: string) {
+    this.service = service;
+  }
+
+  emit(entry: Omit<LogEntry, "timestamp" | "service" | "span_id">): void {
+    const full: LogEntry = {
+      timestamp: new Date().toISOString(),
+      service: this.service,
+      span_id: uuid(),
+      ...entry,
+    };
+    // In production: send to log aggregator. In dev: console.
+    const fn = entry.level === "error" || entry.level === "fatal" ? console.error : console.log;
+    fn(JSON.stringify(full));
+  }
+
+  info(event: string, fields: Partial<LogEntry> = {}): void {
+    this.emit({ level: "info", event, status: "success", trace_id: fields.trace_id || "", ...fields });
+  }
+
+  warn(event: string, fields: Partial<LogEntry> = {}): void {
+    this.emit({ level: "warn", event, status: "rejected", trace_id: fields.trace_id || "", ...fields });
+  }
+
+  error(event: string, fields: Partial<LogEntry> = {}): void {
+    this.emit({ level: "error", event, status: "failure", trace_id: fields.trace_id || "", ...fields });
+  }
+
+  debug(event: string, fields: Partial<LogEntry> = {}): void {
+    if (process.env.LOG_LEVEL === "debug") {
+      this.emit({ level: "debug", event, status: "success", trace_id: fields.trace_id || "", ...fields });
+    }
+  }
+}
+
+export function createLogger(service: string): Logger {
+  return new Logger(service);
+}
+
+export const logger = createLogger("RAGDomain");

package/bone/output/rag/src/metrics.ts

@@ -0,0 +1,75 @@
+// Generated by BoneScript compiler. DO NOT EDIT.
+// Implements spec/10 §4 (Telemetry Hooks)
+
+interface Counter {
+  type: "counter";
+  value: number;
+  labels: Record<string, string>;
+}
+
+interface Histogram {
+  type: "histogram";
+  values: number[];
+  labels: Record<string, string>;
+}
+
+interface Gauge {
+  type: "gauge";
+  value: number;
+  labels: Record<string, string>;
+}
+
+type Metric = Counter | Histogram | Gauge;
+
+const metrics: Map<string, Metric> = new Map();
+
+function key(name: string, labels: Record<string, string>): string {
+  const parts = Object.keys(labels).sort().map(k => `${k}="${labels[k]}"`);
+  return parts.length > 0 ? `${name}{${parts.join(",")}}` : name;
+}
+
+export function counter(name: string, labels: Record<string, string> = {}): void {
+  const k = key(name, labels);
+  const existing = metrics.get(k);
+  if (existing && existing.type === "counter") {
+    existing.value++;
+  } else {
+    metrics.set(k, { type: "counter", value: 1, labels });
+  }
+}
+
+export function histogram(name: string, value: number, labels: Record<string, string> = {}): void {
+  const k = key(name, labels);
+  const existing = metrics.get(k);
+  if (existing && existing.type === "histogram") {
+    existing.values.push(value);
+  } else {
+    metrics.set(k, { type: "histogram", values: [value], labels });
+  }
+}
+
+export function gauge(name: string, value: number, labels: Record<string, string> = {}): void {
+  const k = key(name, labels);
+  metrics.set(k, { type: "gauge", value, labels });
+}
+
+export function dump(): string {
+  const lines: string[] = [];
+  for (const [k, m] of metrics.entries()) {
+    if (m.type === "counter" || m.type === "gauge") {
+      lines.push(`${k} ${m.value}`);
+    } else {
+      const sum = m.values.reduce((a, b) => a + b, 0);
+      const count = m.values.length;
+      const avg = count > 0 ? sum / count : 0;
+      lines.push(`${k}_count ${count}`);
+      lines.push(`${k}_sum ${sum}`);
+      lines.push(`${k}_avg ${avg.toFixed(2)}`);
+    }
+  }
+  return lines.join("\n");
+}
+
+export function reset(): void {
+  metrics.clear();
+}

package/bone/output/rag/src/migrate.ts

@@ -0,0 +1,364 @@
+// Generated by BoneScript compiler. DO NOT EDIT.
+require("dotenv").config();
+import { pool } from "./db";
+
+async function migrate() {
+  console.log("Running migrations...");
+  const client = await pool.connect();
+  try {
+    await client.query(`-- Generated by BoneScript compiler. DO NOT EDIT.
+-- Source: 1f72617e51bc07fb
+-- Module: KnowledgeBaseStore
+
+CREATE TABLE IF NOT EXISTS knowledge_bases (
+  id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
+  project_id UUID NOT NULL,
+  name VARCHAR NOT NULL,
+  description VARCHAR NOT NULL,
+  embedding_model VARCHAR NOT NULL,
+  embedding_dimensions BIGINT NOT NULL,
+  chunk_strategy VARCHAR NOT NULL,
+  chunk_size BIGINT NOT NULL,
+  chunk_overlap BIGINT NOT NULL,
+  total_files BIGINT NOT NULL,
+  total_chunks BIGINT NOT NULL,
+  last_indexed_at TIMESTAMPTZ NOT NULL,
+  state VARCHAR NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+
+CREATE OR REPLACE FUNCTION update_knowledge_bases_updated_at()
+RETURNS TRIGGER AS \$\$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+\$\$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_knowledge_bases_updated_at
+  BEFORE UPDATE ON knowledge_bases
+  FOR EACH ROW
+  EXECUTE FUNCTION update_knowledge_bases_updated_at();
+`);
+    await client.query(`-- Generated by BoneScript compiler. DO NOT EDIT.
+-- Source: 1f72617e51bc07fb
+-- Module: CodeFileStore
+
+CREATE TABLE IF NOT EXISTS code_files (
+  id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
+  knowledge_base_id UUID NOT NULL,
+  project_id UUID NOT NULL,
+  file_path VARCHAR NOT NULL,
+  language VARCHAR NOT NULL,
+  file_hash VARCHAR NOT NULL,
+  file_size_bytes BIGINT NOT NULL,
+  total_chunks BIGINT NOT NULL,
+  last_modified_at TIMESTAMPTZ NOT NULL,
+  metadata JSONB NOT NULL,
+  state VARCHAR NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+
+CREATE OR REPLACE FUNCTION update_code_files_updated_at()
+RETURNS TRIGGER AS \$\$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+\$\$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_code_files_updated_at
+  BEFORE UPDATE ON code_files
+  FOR EACH ROW
+  EXECUTE FUNCTION update_code_files_updated_at();
+`);
+    await client.query(`-- Generated by BoneScript compiler. DO NOT EDIT.
+-- Source: 1f72617e51bc07fb
+-- Module: CodeChunkStore
+
+CREATE TABLE IF NOT EXISTS code_chunks (
+  id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
+  code_file_id UUID NOT NULL,
+  knowledge_base_id UUID NOT NULL,
+  project_id UUID NOT NULL,
+  content VARCHAR NOT NULL,
+  start_line BIGINT NOT NULL,
+  end_line BIGINT NOT NULL,
+  chunk_index BIGINT NOT NULL,
+  language VARCHAR NOT NULL,
+  symbol_name VARCHAR NOT NULL,
+  symbol_type VARCHAR NOT NULL,
+  metadata JSONB NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+
+CREATE OR REPLACE FUNCTION update_code_chunks_updated_at()
+RETURNS TRIGGER AS \$\$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+\$\$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_code_chunks_updated_at
+  BEFORE UPDATE ON code_chunks
+  FOR EACH ROW
+  EXECUTE FUNCTION update_code_chunks_updated_at();
+`);
+    await client.query(`-- Generated by BoneScript compiler. DO NOT EDIT.
+-- Source: 1f72617e51bc07fb
+-- Module: MemoryEntryStore
+
+CREATE TABLE IF NOT EXISTS memory_entrys (
+  id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
+  session_id UUID NOT NULL,
+  project_id UUID NOT NULL,
+  agent_id UUID NOT NULL,
+  memory_type VARCHAR NOT NULL,
+  content VARCHAR NOT NULL,
+  importance DOUBLE PRECISION NOT NULL,
+  access_count BIGINT NOT NULL,
+  last_accessed_at TIMESTAMPTZ NOT NULL,
+  expires_at TIMESTAMPTZ NOT NULL,
+  metadata JSONB NOT NULL,
+  state VARCHAR NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+
+CREATE OR REPLACE FUNCTION update_memory_entrys_updated_at()
+RETURNS TRIGGER AS \$\$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+\$\$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_memory_entrys_updated_at
+  BEFORE UPDATE ON memory_entrys
+  FOR EACH ROW
+  EXECUTE FUNCTION update_memory_entrys_updated_at();
+`);
+    await client.query(`-- Generated by BoneScript compiler. DO NOT EDIT.
+-- Source: 1f72617e51bc07fb
+-- Module: IndexingJobStore
+
+CREATE TABLE IF NOT EXISTS indexing_jobs (
+  id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
+  knowledge_base_id UUID NOT NULL,
+  project_id UUID NOT NULL,
+  job_type VARCHAR NOT NULL,
+  file_paths JSONB NOT NULL,
+  files_total BIGINT NOT NULL,
+  files_processed BIGINT NOT NULL,
+  chunks_total BIGINT NOT NULL,
+  chunks_embedded BIGINT NOT NULL,
+  error VARCHAR NOT NULL,
+  state VARCHAR NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+
+CREATE OR REPLACE FUNCTION update_indexing_jobs_updated_at()
+RETURNS TRIGGER AS \$\$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+\$\$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_indexing_jobs_updated_at
+  BEFORE UPDATE ON indexing_jobs
+  FOR EACH ROW
+  EXECUTE FUNCTION update_indexing_jobs_updated_at();
+`);
+    await client.query(`-- Generated by BoneScript compiler. DO NOT EDIT.
+-- Source: 1f72617e51bc07fb
+-- Module: KnowledgeBaseStore
+
+CREATE TABLE IF NOT EXISTS knowledge_bases (
+  id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
+  project_id UUID NOT NULL,
+  name VARCHAR NOT NULL,
+  description VARCHAR NOT NULL,
+  embedding_model VARCHAR NOT NULL,
+  embedding_dimensions BIGINT NOT NULL,
+  chunk_strategy VARCHAR NOT NULL,
+  chunk_size BIGINT NOT NULL,
+  chunk_overlap BIGINT NOT NULL,
+  total_files BIGINT NOT NULL,
+  total_chunks BIGINT NOT NULL,
+  last_indexed_at TIMESTAMPTZ NOT NULL,
+  state VARCHAR NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+
+CREATE OR REPLACE FUNCTION update_knowledge_bases_updated_at()
+RETURNS TRIGGER AS \$\$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+\$\$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_knowledge_bases_updated_at
+  BEFORE UPDATE ON knowledge_bases
+  FOR EACH ROW
+  EXECUTE FUNCTION update_knowledge_bases_updated_at();
+`);
+    await client.query(`-- Generated by BoneScript compiler. DO NOT EDIT.
+-- Source: 1f72617e51bc07fb
+-- Module: CodeFileStore
+
+CREATE TABLE IF NOT EXISTS code_files (
+  id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
+  knowledge_base_id UUID NOT NULL,
+  project_id UUID NOT NULL,
+  file_path VARCHAR NOT NULL,
+  language VARCHAR NOT NULL,
+  file_hash VARCHAR NOT NULL,
+  file_size_bytes BIGINT NOT NULL,
+  total_chunks BIGINT NOT NULL,
+  last_modified_at TIMESTAMPTZ NOT NULL,
+  metadata JSONB NOT NULL,
+  state VARCHAR NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+
+CREATE OR REPLACE FUNCTION update_code_files_updated_at()
+RETURNS TRIGGER AS \$\$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+\$\$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_code_files_updated_at
+  BEFORE UPDATE ON code_files
+  FOR EACH ROW
+  EXECUTE FUNCTION update_code_files_updated_at();
+`);
+    await client.query(`-- Generated by BoneScript compiler. DO NOT EDIT.
+-- Source: 1f72617e51bc07fb
+-- Module: CodeChunkStore
+
+CREATE TABLE IF NOT EXISTS code_chunks (
+  id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
+  code_file_id UUID NOT NULL,
+  knowledge_base_id UUID NOT NULL,
+  project_id UUID NOT NULL,
+  content VARCHAR NOT NULL,
+  start_line BIGINT NOT NULL,
+  end_line BIGINT NOT NULL,
+  chunk_index BIGINT NOT NULL,
+  language VARCHAR NOT NULL,
+  symbol_name VARCHAR NOT NULL,
+  symbol_type VARCHAR NOT NULL,
+  metadata JSONB NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+
+CREATE OR REPLACE FUNCTION update_code_chunks_updated_at()
+RETURNS TRIGGER AS \$\$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+\$\$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_code_chunks_updated_at
+  BEFORE UPDATE ON code_chunks
+  FOR EACH ROW
+  EXECUTE FUNCTION update_code_chunks_updated_at();
+`);
+    await client.query(`-- Generated by BoneScript compiler. DO NOT EDIT.
+-- Source: 1f72617e51bc07fb
+-- Module: MemoryEntryStore
+
+CREATE TABLE IF NOT EXISTS memory_entrys (
+  id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
+  session_id UUID NOT NULL,
+  project_id UUID NOT NULL,
+  agent_id UUID NOT NULL,
+  memory_type VARCHAR NOT NULL,
+  content VARCHAR NOT NULL,
+  importance DOUBLE PRECISION NOT NULL,
+  access_count BIGINT NOT NULL,
+  last_accessed_at TIMESTAMPTZ NOT NULL,
+  expires_at TIMESTAMPTZ NOT NULL,
+  metadata JSONB NOT NULL,
+  state VARCHAR NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+
+CREATE OR REPLACE FUNCTION update_memory_entrys_updated_at()
+RETURNS TRIGGER AS \$\$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+\$\$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_memory_entrys_updated_at
+  BEFORE UPDATE ON memory_entrys
+  FOR EACH ROW
+  EXECUTE FUNCTION update_memory_entrys_updated_at();
+`);
+    await client.query(`-- Generated by BoneScript compiler. DO NOT EDIT.
+-- Source: 1f72617e51bc07fb
+-- Module: IndexingJobStore
+
+CREATE TABLE IF NOT EXISTS indexing_jobs (
+  id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
+  knowledge_base_id UUID NOT NULL,
+  project_id UUID NOT NULL,
+  job_type VARCHAR NOT NULL,
+  file_paths JSONB NOT NULL,
+  files_total BIGINT NOT NULL,
+  files_processed BIGINT NOT NULL,
+  chunks_total BIGINT NOT NULL,
+  chunks_embedded BIGINT NOT NULL,
+  error VARCHAR NOT NULL,
+  state VARCHAR NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+
+CREATE OR REPLACE FUNCTION update_indexing_jobs_updated_at()
+RETURNS TRIGGER AS \$\$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+\$\$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_indexing_jobs_updated_at
+  BEFORE UPDATE ON indexing_jobs
+  FOR EACH ROW
+  EXECUTE FUNCTION update_indexing_jobs_updated_at();
+`);
+    console.log("Migrations complete.");
+  } finally {
+    client.release();
+    await pool.end();
+  }
+}
+
+migrate().catch(e => { console.error(e); process.exit(1); });

package/bone/output/rag/src/migration_diff.ts

@@ -0,0 +1,108 @@
+// Generated by BoneScript compiler. DO NOT EDIT.
+// Migration diff utility — compares two IR snapshots and produces ALTER statements.
+
+import * as fs from "fs";
+
+interface Field {
+  name: string;
+  type: string;
+  nullable: boolean;
+}
+
+interface Model {
+  name: string;
+  fields: Field[];
+  primary_key: string;
+}
+
+export function diffModels(oldModels: Model[], newModels: Model[]): string[] {
+  const statements: string[] = [];
+  const oldByName = new Map(oldModels.map(m => [m.name, m]));
+  const newByName = new Map(newModels.map(m => [m.name, m]));
+
+  // New tables
+  for (const [name, model] of newByName) {
+    if (!oldByName.has(name)) {
+      const tableName = toSnake(name) + "s";
+      statements.push(`-- New table: ${tableName}`);
+      statements.push(`-- (Generated by previous migration)`);
+    }
+  }
+
+  // Removed tables (warn but don't auto-drop)
+  for (const [name] of oldByName) {
+    if (!newByName.has(name)) {
+      const tableName = toSnake(name) + "s";
+      statements.push(`-- WARNING: Table ${tableName} no longer in schema. Manual DROP required.`);
+    }
+  }
+
+  // Modified tables
+  for (const [name, newModel] of newByName) {
+    const oldModel = oldByName.get(name);
+    if (!oldModel) continue;
+
+    const tableName = toSnake(name) + "s";
+    const oldFields = new Map(oldModel.fields.map(f => [f.name, f]));
+    const newFields = new Map(newModel.fields.map(f => [f.name, f]));
+
+    // New columns (backward-compatible)
+    for (const [fname, field] of newFields) {
+      if (!oldFields.has(fname)) {
+        const sqlType = mapType(field.type);
+        const nullability = field.nullable ? "" : " NOT NULL DEFAULT (CASE WHEN false THEN NULL ELSE NULL END)";
+        statements.push(`ALTER TABLE ${tableName} ADD COLUMN ${fname} ${sqlType}${nullability};`);
+      }
+    }
+
+    // Removed columns (NOT auto-dropped — backward compat)
+    for (const [fname] of oldFields) {
+      if (!newFields.has(fname)) {
+        statements.push(`-- WARNING: Column ${tableName}.${fname} removed from schema. Run manually: ALTER TABLE ${tableName} DROP COLUMN ${fname};`);
+      }
+    }
+
+    // Type changes
+    for (const [fname, newField] of newFields) {
+      const oldField = oldFields.get(fname);
+      if (!oldField) continue;
+      if (oldField.type !== newField.type) {
+        const sqlType = mapType(newField.type);
+        statements.push(`ALTER TABLE ${tableName} ALTER COLUMN ${fname} TYPE ${sqlType};`);
+      }
+    }
+  }
+
+  return statements;
+}
+
+function toSnake(s: string): string {
+  return s.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
+}
+
+function mapType(t: string): string {
+  const map: Record<string, string> = {
+    string: "VARCHAR", uint: "BIGINT", int: "BIGINT", float: "DOUBLE PRECISION",
+    bool: "BOOLEAN", timestamp: "TIMESTAMPTZ", uuid: "UUID", bytes: "BYTEA", json: "JSONB",
+  };
+  return map[t] || "JSONB";
+}
+
+if (require.main === module) {
+  const oldFile = process.argv[2];
+  const newFile = process.argv[3];
+  if (!oldFile || !newFile) {
+    console.error("Usage: node migration-diff.js <old-ir.json> <new-ir.json>");
+    process.exit(1);
+  }
+  const oldIR = JSON.parse(fs.readFileSync(oldFile, "utf-8"));
+  const newIR = JSON.parse(fs.readFileSync(newFile, "utf-8"));
+
+  const oldModels: Model[] = [];
+  const newModels: Model[] = [];
+  for (const sys of oldIR) for (const mod of sys.modules) for (const m of mod.models) oldModels.push(m);
+  for (const sys of newIR) for (const mod of sys.modules) for (const m of mod.models) newModels.push(m);
+
+  const diff = diffModels(oldModels, newModels);
+  console.log(diff.join("\n"));
+}