Merge Conflicts (#41)

Co-authored-by: Sayan Datta <sayan@Sayans-MacBook-Air.local>
Reviewed-on: sagnik/Project_Velocity#41

backend/migrations/__init__.py

@@ -0,0 +1,2 @@
+"""Velocity backend migration utilities."""
+

backend/migrations/runner.py

@@ -0,0 +1,102 @@
+from __future__ import annotations
+
+import hashlib
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Iterable
+
+
+MIGRATIONS_DIR = Path(__file__).resolve().parent / "versions"
+
+
+@dataclass(frozen=True)
+class Migration:
+    version: str
+    name: str
+    path: Path
+    checksum: str
+    sql: str
+
+
+def _checksum(sql: str) -> str:
+    return hashlib.sha256(sql.encode("utf-8")).hexdigest()
+
+
+def discover_migrations(directory: Path = MIGRATIONS_DIR) -> list[Migration]:
+    if not directory.exists():
+        return []
+
+    migrations: list[Migration] = []
+    for path in sorted(directory.glob("*.sql")):
+        version, _, name = path.stem.partition("_")
+        if not version or not name:
+            raise ValueError(f"Invalid migration filename: {path.name}")
+        sql = path.read_text(encoding="utf-8")
+        migrations.append(
+            Migration(
+                version=version,
+                name=name,
+                path=path,
+                checksum=_checksum(sql),
+                sql=sql,
+            )
+        )
+
+    seen: set[str] = set()
+    for migration in migrations:
+        if migration.version in seen:
+            raise ValueError(f"Duplicate migration version: {migration.version}")
+        seen.add(migration.version)
+    return migrations
+
+
+async def ensure_migration_table(conn) -> None:
+    await conn.execute(
+        """
+        CREATE TABLE IF NOT EXISTS schema_migrations (
+            version TEXT PRIMARY KEY,
+            name TEXT NOT NULL,
+            checksum TEXT NOT NULL,
+            applied_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+        )
+        """
+    )
+
+
+async def applied_versions(conn) -> dict[str, str]:
+    await ensure_migration_table(conn)
+    rows = await conn.fetch("SELECT version, checksum FROM schema_migrations")
+    return {row["version"]: row["checksum"] for row in rows}
+
+
+async def apply_migrations(conn, migrations: Iterable[Migration] | None = None) -> list[str]:
+    pending = list(migrations if migrations is not None else discover_migrations())
+    applied = await applied_versions(conn)
+    applied_now: list[str] = []
+
+    for migration in pending:
+        existing_checksum = applied.get(migration.version)
+        if existing_checksum == migration.checksum:
+            continue
+        if existing_checksum and existing_checksum != migration.checksum:
+            raise RuntimeError(
+                f"Migration checksum mismatch for {migration.version}; "
+                "create a new migration instead of editing an applied one."
+            )
+
+        transaction = conn.transaction()
+        async with transaction:
+            await conn.execute(migration.sql)
+            await conn.execute(
+                """
+                INSERT INTO schema_migrations (version, name, checksum)
+                VALUES ($1, $2, $3)
+                """,
+                migration.version,
+                migration.name,
+                migration.checksum,
+            )
+        applied_now.append(migration.version)
+
+    return applied_now
+

backend/migrations/versions/202604230001_observability_foundation.sql

@@ -0,0 +1,22 @@
+-- Velocity production observability foundation.
+-- Creates a lightweight table for durable request/error telemetry when enabled.
+
+CREATE TABLE IF NOT EXISTS app_request_events (
+    event_id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    request_id TEXT NOT NULL,
+    method TEXT NOT NULL,
+    path TEXT NOT NULL,
+    status_code INTEGER NOT NULL,
+    duration_ms DOUBLE PRECISION NOT NULL,
+    tenant_id TEXT,
+    user_id UUID,
+    error_type TEXT,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_app_request_events_created_at
+    ON app_request_events (created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_app_request_events_path_status
+    ON app_request_events (path, status_code, created_at DESC);
+

backend/migrations/versions/202604260001_mobile_edge_calendar_events.sql

@@ -0,0 +1,30 @@
+CREATE EXTENSION IF NOT EXISTS pgcrypto;
+
+CREATE TABLE IF NOT EXISTS user_calendar_events (
+    calendar_event_id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id TEXT NOT NULL,
+    owner_user_id TEXT NOT NULL,
+    lead_id TEXT,
+    source_event_id UUID,
+    title TEXT NOT NULL,
+    description TEXT,
+    start_at TIMESTAMPTZ NOT NULL,
+    end_at TIMESTAMPTZ NOT NULL,
+    all_day BOOLEAN NOT NULL DEFAULT FALSE,
+    status TEXT NOT NULL DEFAULT 'confirmed'
+        CHECK (status IN ('tentative', 'confirmed', 'done', 'cancelled')),
+    reminder_minutes INTEGER[] NOT NULL DEFAULT '{15}'::INTEGER[],
+    created_by TEXT NOT NULL DEFAULT 'user'
+        CHECK (created_by IN ('user', 'nemoclaw_suggested', 'operator_import')),
+    is_nemoclaw_confirmed BOOLEAN NOT NULL DEFAULT FALSE,
+    location TEXT,
+    metadata JSONB NOT NULL DEFAULT '{}'::JSONB,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_calendar_events_owner
+    ON user_calendar_events (tenant_id, owner_user_id, start_at);
+
+CREATE INDEX IF NOT EXISTS idx_calendar_events_lead
+    ON user_calendar_events (tenant_id, lead_id, start_at);

backend/migrations/versions/202604260002_calendar_event_done_status.sql

@@ -0,0 +1,6 @@
+ALTER TABLE user_calendar_events
+    DROP CONSTRAINT IF EXISTS user_calendar_events_status_check;
+
+ALTER TABLE user_calendar_events
+    ADD CONSTRAINT user_calendar_events_status_check
+    CHECK (status IN ('tentative', 'confirmed', 'done', 'cancelled'));