@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/registry/table-ownership-registry.js

@@ -0,0 +1,932 @@
+"use strict";
+/**
+ * NeuraLoom Canonical Table Ownership Registry
+ *
+ * This is the single source of truth for ownership, status, and
+ * allowed access paths for every database table in NeuraLoom.
+ *
+ * Constitutional Law §7 (DB Truth Law):
+ * Every table must have a canonical owner and status.
+ * Unknown table ownership is unconstitutional.
+ *
+ * Constitutional Law §8 (No Ghost Migrations):
+ * Ghost table references must not automatically become migrations.
+ * Each must be classified before schema creation.
+ *
+ * Registry Law: If it is not registered, it is not canonical.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TABLE_OWNERSHIP_ENTRIES = void 0;
+exports.getTableOwnership = getTableOwnership;
+exports.assertTableCanonical = assertTableCanonical;
+exports.getTablesByStatus = getTablesByStatus;
+exports.getUndecidedTables = getUndecidedTables;
+exports.getBannedTables = getBannedTables;
+exports.getBannedTableNames = getBannedTableNames;
+// ─── Table Ownership Registry ─────────────────────────────────────────────────
+const TABLE_OWNERSHIP_ENTRIES = [
+    // ── Core Workflow Tables ───────────────────────────────────────────────────
+    {
+        tableName: 'workflow_artifacts',
+        schemaName: 'public',
+        domainOwner: 'workflow-spine',
+        status: 'canonical_active',
+        migrationFile: '20260501000000_workflow_artifacts.sql',
+        notes: 'Primary artifact storage. All generated content lands here. SSOT for artifact payloads.',
+    },
+    {
+        tableName: 'projects',
+        schemaName: 'public',
+        domainOwner: 'project-management',
+        status: 'canonical_active',
+        notes: 'SSOT for project metadata, workflow_variant, and project_kind.',
+    },
+    {
+        tableName: 'profiles',
+        schemaName: 'public',
+        domainOwner: 'auth',
+        status: 'canonical_active',
+        notes: 'Standard Supabase user profile table. Foreign key to auth.users.',
+    },
+    {
+        tableName: 'ai_runs',
+        schemaName: 'public',
+        domainOwner: 'ai-telemetry',
+        status: 'canonical_active',
+        notes: 'Every createEnhancedCompletion() call writes here for telemetry and billing audit.',
+    },
+    {
+        tableName: 'artifact_dependencies',
+        schemaName: 'public',
+        domainOwner: 'workflow-spine',
+        status: 'canonical_active',
+        migrationFile: '20260514000200_artifact_dependencies.sql',
+        notes: 'DAG of artifact-to-artifact dependencies. Enables stale detection and Transformation Studio traceability.',
+    },
+    {
+        tableName: 'project_relationships',
+        schemaName: 'public',
+        domainOwner: 'project-management',
+        status: 'canonical_active',
+        migrationFile: '20260514000300_project_relationships.sql',
+        notes: 'Cross-project relationships (e.g., transformation source/target, derivative works).',
+    },
+    {
+        tableName: 'pipeline_locks',
+        schemaName: 'public',
+        domainOwner: 'workflow-spine',
+        status: 'canonical_active',
+        migrationFile: '20260514000400_pipeline_locks.sql',
+        notes: 'Optimistic concurrency locks for pipeline step execution.',
+    },
+    {
+        tableName: 'execution_runs',
+        schemaName: 'public',
+        domainOwner: 'workflow-spine',
+        status: 'canonical_active',
+        notes: 'Durable workflow run header. SSOT for 18-step chain + stage_pipeline execution modes. Gateway routes enqueue here.',
+    },
+    {
+        tableName: 'execution_tasks',
+        schemaName: 'public',
+        domainOwner: 'workflow-spine',
+        status: 'canonical_active',
+        notes: 'Durable workflow task rows including stage-granular metadata (ExecutionTaskStageMetadata).',
+    },
+    {
+        tableName: 'orchestrations',
+        schemaName: 'public',
+        domainOwner: 'workflow-spine',
+        status: 'canonical_active',
+        notes: 'Orchestration session header linked to execution_runs and orchestration_events.',
+    },
+    {
+        tableName: 'orchestration_events',
+        schemaName: 'public',
+        domainOwner: 'workflow-spine',
+        status: 'canonical_active',
+        notes: 'Stage/step event stream for orchestration progress and telemetry.',
+    },
+    {
+        tableName: 'workflow_jobs',
+        schemaName: 'public',
+        domainOwner: 'workflow-spine',
+        status: 'wrong_table_reference',
+        replacementTable: 'execution_tasks',
+        notes: 'FORBIDDEN parallel job substrate. Use execution_runs/execution_tasks durable spine (CAN-022).',
+    },
+    {
+        tableName: 'knowledge_nodes',
+        schemaName: 'public',
+        domainOwner: 'knowledge-graph',
+        status: 'canonical_active',
+        notes: 'KG entity nodes. Wired through knowledge-graph service layer. DDL canonical name (baseline migration).',
+    },
+    {
+        tableName: 'knowledge_edges',
+        schemaName: 'public',
+        domainOwner: 'knowledge-graph',
+        status: 'canonical_active',
+        notes: 'KG relationship edges between nodes. DDL canonical name (baseline migration).',
+    },
+    {
+        tableName: 'knowledge_graph_nodes',
+        schemaName: 'public',
+        domainOwner: 'knowledge-graph',
+        status: 'wrong_table_reference',
+        replacementTable: 'knowledge_nodes',
+        allowedWritePaths: [],
+        notes: 'Non-DDL name that leaked into earlier code. All references must use knowledge_nodes.',
+    },
+    {
+        tableName: 'knowledge_graph_edges',
+        schemaName: 'public',
+        domainOwner: 'knowledge-graph',
+        status: 'wrong_table_reference',
+        replacementTable: 'knowledge_edges',
+        allowedWritePaths: [],
+        notes: 'Non-DDL name that leaked into earlier code. All references must use knowledge_edges.',
+    },
+    // ── AI Session / Memory Tables ─────────────────────────────────────────────
+    {
+        tableName: 'ai_sessions',
+        schemaName: 'public',
+        domainOwner: 'ai-telemetry',
+        status: 'needs_decision',
+        notes: 'Candidate for merge into ai_runs or standalone session tracking. Needs classification before adding new writes.',
+    },
+    {
+        tableName: 'ai_memory',
+        schemaName: 'public',
+        domainOwner: 'knowledge-graph',
+        status: 'needs_decision',
+        notes: 'May overlap with knowledge_graph_nodes for semantic memory. Requires ownership decision and possible consolidation.',
+    },
+    // ── Auth / Supabase Standard Tables ───────────────────────────────────────
+    {
+        tableName: 'users',
+        schemaName: 'auth',
+        domainOwner: 'auth',
+        status: 'canonical_active',
+        allowedWritePaths: [],
+        notes: 'Supabase auth schema. NEVER modify directly. Use profiles table for app data.',
+    },
+    // ── Storage (not DB tables — clarify to prevent confusion) ─────────────────
+    {
+        tableName: 'artifacts',
+        schemaName: 'storage',
+        domainOwner: 'storage',
+        status: 'wrong_table_reference',
+        replacementTable: 'workflow_artifacts',
+        allowedWritePaths: [],
+        notes: 'Storage BUCKET, not a DB table. Any DB query to "artifacts" is a wrong-table drift. Canonical DB table is workflow_artifacts.',
+    },
+    {
+        tableName: 'bucket',
+        schemaName: 'storage',
+        domainOwner: 'storage',
+        status: 'wrong_table_reference',
+        replacementTable: 'workflow_artifacts',
+        allowedWritePaths: [],
+        notes: 'Storage bucket concept — not a queryable DB table. Clarify in supabase.storage.from() vs .from() distinctions.',
+    },
+    // ── Legacy / Dead Tables ───────────────────────────────────────────────────
+    {
+        tableName: 'mission_control_steps',
+        schemaName: 'public',
+        domainOwner: 'legacy-mission-control',
+        status: 'dead_remove',
+        replacementTable: 'workflow_artifacts',
+        allowedReadPaths: [],
+        allowedWritePaths: [],
+        notes: 'Legacy split-brain table. Orchestrator tombstoned. No new reads or writes. Schedule DROP in next migration hygiene sprint.',
+    },
+    // ── Film Production Domain Module ─────────────────────────────────────────
+    {
+        tableName: 'film_scenes',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260516120000_film_domain_foundation.sql',
+        notes: 'Film production scene objects — linked to projects and workflow_artifacts.',
+    },
+    {
+        tableName: 'film_shots',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260516120000_film_domain_foundation.sql',
+        notes: 'Film production shot definitions — child of film_scenes.',
+    },
+    {
+        tableName: 'film_prompts',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260516120000_film_domain_foundation.sql',
+        notes: 'Deterministic video-generation prompts compiled from approved bibles. Orphan prompts are forbidden at DB level.',
+    },
+    {
+        tableName: 'film_clips',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260516120000_film_domain_foundation.sql',
+        notes: 'Registered AI/live-action/manual clips linked to shot + prompt.',
+    },
+    {
+        tableName: 'film_reviews',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260516120000_film_domain_foundation.sql',
+        notes: 'Review findings per clip/shot/scene. Severity-critical findings block export.',
+    },
+    {
+        tableName: 'film_exports',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260516120000_film_domain_foundation.sql',
+        notes: 'Export packets and production handoff bundles.',
+    },
+    {
+        tableName: 'film_edit_sequences',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260516120000_film_domain_foundation.sql',
+        notes: 'Edit assembly and OTIO timeline state. Tracks Resolve handoff status.',
+    },
+    {
+        tableName: 'film_reference_packs',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260520000000_film_phase2_world_ontology.sql',
+        notes: 'Phase 2 reference bundles for ontology continuity.',
+    },
+    {
+        tableName: 'film_character_packs',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260520000000_film_phase2_world_ontology.sql',
+        notes: 'Structured character ontology rows; versioned per project + character_id.',
+    },
+    {
+        tableName: 'film_location_packs',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260520000000_film_phase2_world_ontology.sql',
+        notes: 'Structured location ontology rows; versioned per project + location_id.',
+    },
+    {
+        tableName: 'film_wardrobe_states',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260520000000_film_phase2_world_ontology.sql',
+        notes: 'Wardrobe continuity states per character pack.',
+    },
+    {
+        tableName: 'film_character_scene_states',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260520000000_film_phase2_world_ontology.sql',
+        notes: 'Per-scene character emotional/physical + wardrobe link.',
+    },
+    {
+        tableName: 'film_keyframes',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260520010000_film_phase2_keyframes.sql',
+        notes: 'Keyframe stills per shot — manual/provider lineage + multimodal review payload.',
+    },
+    {
+        tableName: 'film_regeneration_plans',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260520030000_film_phase2_regeneration_plans.sql',
+        notes: 'Regeneration intents after multimodal rejection/borderline; PR-G engine fills patch prompts.',
+    },
+    {
+        tableName: 'film_projects',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_active',
+        migrationFile: '20260521000000_film_phase2_production_style_and_lessons.sql',
+        notes: 'MS-1 sidecar (PK = projects.id): production_style + retake_budget_per_shot + hero_shot_codes + hero_shot_retake_budget + lessons_manifest_id_applied.',
+    },
+    {
+        tableName: 'film_clip_review_scores',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_active',
+        migrationFile: '20260521000000_film_phase2_production_style_and_lessons.sql',
+        notes: 'MS-1: 6-dim review scoring (identity, motion, lighting, continuity, composition, intent) per clip review event.',
+    },
+    {
+        tableName: 'film_clip_structured_review_scores',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260523000000_film_phase2_clip_review_scores.sql',
+        notes: 'PR-G: multimodal clip threshold scores 1:1 with film_reviews (distinct from MS-1 critic table).',
+    },
+    {
+        tableName: 'film_generation_telemetry',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_active',
+        migrationFile: '20260521000000_film_phase2_production_style_and_lessons.sql',
+        notes: 'MS-1: per-attempt telemetry (provider, prompt_template_id, attempt_index, accepted) — RL critic substrate.',
+    },
+    {
+        tableName: 'film_ofi_reports',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_active',
+        migrationFile: '20260521000000_film_phase2_production_style_and_lessons.sql',
+        notes: 'MS-1: per-film deterministic telemetry aggregate body (FilmOfiReportSchema).',
+    },
+    {
+        tableName: 'film_lessons_manifests',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_active',
+        migrationFile: '20260521000000_film_phase2_production_style_and_lessons.sql',
+        notes: 'MS-1: cross-film carry-forward lessons body (FilmLessonsManifestSchema). Status: draft|applied.',
+    },
+    {
+        tableName: 'film_generation_tasks',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260524000000_film_phase2_generation_tasks.sql',
+        notes: 'PR-H: queue tasks + drain orchestration (state machine + idempotency_key).',
+    },
+    {
+        tableName: 'film_comfyui_workflows',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260527000000_film_phase2_comfyui_workflows.sql',
+        notes: 'PR-M — ComfyUI workflow JSON templates per project + parameter_map slot wiring.',
+    },
+    {
+        tableName: 'film_prompt_performance',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260528000000_film_phase2_prompt_performance.sql',
+        notes: 'PR-N — heuristic provider telemetry keyed by clip multimodal structured reviews.',
+    },
+    {
+        tableName: 'film_take_comparisons',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260528000000_film_phase2_prompt_performance.sql',
+        notes: 'PR-N — multi-take fan-out bookkeeping + deterministic winner rollup.',
+    },
+    {
+        tableName: 'film_generation_packages',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_planned',
+        migrationFile: '20260526000000_community_movie_operator_alignment.sql',
+        notes: 'Compiled generation packages (style + character + shot manifest) assembled for a generation run.',
+    },
+    // ── community.movie (participatory layer) ─────────────────────────────────
+    {
+        tableName: 'community_profiles',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Public-facing studio profiles extending auth identities.',
+    },
+    {
+        tableName: 'community_memberships',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Stripe subscription mirror for tiers.',
+    },
+    {
+        tableName: 'community_credit_accounts',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Studio Credits wallet balances.',
+    },
+    {
+        tableName: 'community_credit_transactions',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Append-only Studio Credits ledger.',
+    },
+    {
+        tableName: 'community_challenges',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Challenges / campaigns surfaced on community.movie.',
+    },
+    {
+        tableName: 'community_ideas',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Linked to NeuraLoom via neuraloom_project_id; never duplicate film_* rows.',
+    },
+    {
+        tableName: 'community_idea_versions',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Versioned snapshots for idea edits.',
+    },
+    {
+        tableName: 'community_votes',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Weighted votes per idea.',
+    },
+    {
+        tableName: 'community_credit_boosts',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Credit-weighted boosts referencing ledger rows.',
+    },
+    {
+        tableName: 'community_comments',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Threaded discussion on ideas.',
+    },
+    {
+        tableName: 'community_suggestions',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Structured contribution suggestions (non-film_* mutation).',
+    },
+    {
+        tableName: 'community_moderation_flags',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'User reports + editorial resolution.',
+    },
+    {
+        tableName: 'community_stage_transitions',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Audit trail for idea lifecycle transitions.',
+    },
+    {
+        tableName: 'community_slates',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Weekly/monthly slate snapshots.',
+    },
+    {
+        tableName: 'community_slate_entries',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Rows within a published slate.',
+    },
+    {
+        tableName: 'community_development_rooms',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: '1:1 idea collaboration rooms.',
+    },
+    {
+        tableName: 'community_polls',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Polls scoped to development rooms.',
+    },
+    {
+        tableName: 'community_poll_votes',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'One vote per poll per user.',
+    },
+    {
+        tableName: 'community_recognition_events',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Contributor recognition ledger.',
+    },
+    {
+        tableName: 'community_notifications',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Per-user notification inbox.',
+    },
+    {
+        tableName: 'community_waitlist',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260522000000_community_movie_foundation.sql',
+        notes: 'Marketing waitlist capture (v0.1 public insert).',
+    },
+    // ── Community.Movie catalog + i18n (202606*) ───────────────────────────────
+    {
+        tableName: 'community_films',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260519120000_community_film_worlds_trailer.sql',
+        allowedWritePaths: ['packages/frontend/src/lib/film/deliverables/bridge-community-catalog.ts'],
+        notes: 'Published viewer catalog. Writes only via NeuraLoom publish bridge.',
+    },
+    {
+        tableName: 'community_film_worlds',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260519120000_community_film_worlds_trailer.sql',
+        notes: 'World marketing metadata for community.movie viewer.',
+    },
+    {
+        tableName: 'community_film_characters',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260527001000_community_movie_actor_universe.sql',
+        notes: 'Character cards linked to films/worlds.',
+    },
+    {
+        tableName: 'community_film_subtitles',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260518171833_community_film_assets_tables.sql',
+        notes: 'Subtitle tracks for hosted playback.',
+    },
+    {
+        tableName: 'community_film_video_variants',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260624100000_community_film_video_variants.sql',
+        allowedWritePaths: ['packages/frontend/src/lib/film/deliverables/bridge-community-catalog.ts'],
+        notes: 'Per-locale video cuts (CM-13). Upsert via publish bridge only.',
+    },
+    {
+        tableName: 'community_content_translations',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260624110000_community_content_translations.sql',
+        notes: 'CMS field translations for worlds/films/characters (CM-12 DB layer).',
+    },
+    {
+        tableName: 'community_email_subscriptions',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260603120000_community_email.sql',
+        notes: 'Lifecycle email preferences + unsubscribe tokens.',
+    },
+    {
+        tableName: 'community_email_dispatches',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260603120000_community_email.sql',
+        notes: 'Resend dispatch queue (service-role writes).',
+    },
+    {
+        tableName: 'community_referral_codes',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260603120100_community_referrals.sql',
+        notes: 'Per-user shareable referral codes.',
+    },
+    {
+        tableName: 'community_referral_attributions',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260603120100_community_referrals.sql',
+        allowedWritePaths: ['packages/community-movie/src/app/api/**'],
+        notes: 'First-touch referral visits; service-role/API writes only.',
+    },
+    {
+        tableName: 'community_referral_redemptions',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260603120100_community_referrals.sql',
+        notes: 'Referral conversion rewards ledger.',
+    },
+    {
+        tableName: 'community_ad_event_dispatches',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260619120000_community_ad_capi_dispatches.sql',
+        notes: 'Server-side ad network CAPI dispatch audit log.',
+    },
+    {
+        tableName: 'community_signup_intakes',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260604120000_community_signup_intakes.sql',
+        notes: 'Free join questionnaire sessions linked post-auth.',
+    },
+    {
+        tableName: 'community_marketing_conversion_uploads',
+        schemaName: 'public',
+        domainOwner: 'marketing-intelligence',
+        status: 'canonical_active',
+        migrationFile: '20260601120000_community_marketing_conversion_queue.sql',
+        notes: 'Offline Google Ads conversion upload queue (gbraid/wbraid/gclid).',
+    },
+    {
+        tableName: 'marketing_campaign_daily_metrics',
+        schemaName: 'public',
+        domainOwner: 'marketing-intelligence',
+        status: 'canonical_active',
+        migrationFile: '20260621120100_marketing_ops_warehouse.sql',
+        notes: 'Imported daily Google Ads campaign metrics (service-role).',
+    },
+    {
+        tableName: 'marketing_recommendations',
+        schemaName: 'public',
+        domainOwner: 'marketing-intelligence',
+        status: 'canonical_active',
+        migrationFile: '20260621120100_marketing_ops_warehouse.sql',
+        notes: 'Human-reviewed campaign recommendations — no auto-mutation.',
+    },
+    {
+        tableName: 'community_world_images',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260518200000_community_film_assets.sql',
+        notes: 'World marketing imagery keyed by page slug.',
+    },
+    {
+        tableName: 'community_partner_redemptions',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260520180000_community_partner_redemptions.sql',
+        notes: 'Partner offer redemption audit rows.',
+    },
+    {
+        tableName: 'community_world_contributions',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260522015000_community_world_contributions.sql',
+        notes: 'User lore contributions scoped to worlds.',
+    },
+    {
+        tableName: 'community_kg_nodes',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260527000000_community_movie_kg_xp.sql',
+        notes: 'Community knowledge graph nodes (engagement XP spine).',
+    },
+    {
+        tableName: 'community_kg_edges',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260527000000_community_movie_kg_xp.sql',
+        notes: 'Community knowledge graph edges.',
+    },
+    {
+        tableName: 'community_xp_events',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260527000000_community_movie_kg_xp.sql',
+        notes: 'XP ledger events for community engagement.',
+    },
+    {
+        tableName: 'community_badges',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260527000000_community_movie_kg_xp.sql',
+        notes: 'Badge definitions for contributor recognition.',
+    },
+    {
+        tableName: 'community_user_badges',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_planned',
+        migrationFile: '20260527000000_community_movie_kg_xp.sql',
+        notes: 'Per-user badge awards.',
+    },
+    {
+        tableName: 'community_actors',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260527001000_community_movie_actor_universe.sql',
+        notes: 'Community-created actor profiles.',
+    },
+    {
+        tableName: 'community_actor_assets',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260527001000_community_movie_actor_universe.sql',
+        notes: 'Generated portraits and actor media assets.',
+    },
+    {
+        tableName: 'community_actor_comments',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260527001000_community_movie_actor_universe.sql',
+        notes: 'Comments on published actor profiles.',
+    },
+    {
+        tableName: 'community_actor_idea_links',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260527001000_community_movie_actor_universe.sql',
+        notes: 'Links between actors and story ideas.',
+    },
+    {
+        tableName: 'community_actor_votes',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260527001000_community_movie_actor_universe.sql',
+        notes: 'Votes on community actor profiles.',
+    },
+    {
+        tableName: 'community_moderation_events',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260527002000_community_movie_schema_polish.sql',
+        notes: 'Moderation action audit trail.',
+    },
+    {
+        tableName: 'community_telemetry_events',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260529120000_community_telemetry_events.sql',
+        notes: 'Viewer/product telemetry (service-role ingest).',
+    },
+    {
+        tableName: 'community_content_ratings',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260620180000_community_viewer_catalog.sql',
+        notes: 'Per-user film/content ratings.',
+    },
+    {
+        tableName: 'community_content_reactions',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260620180000_community_viewer_catalog.sql',
+        notes: 'Lightweight reactions on viewer content.',
+    },
+    {
+        tableName: 'community_feedback_notes',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260620180000_community_viewer_catalog.sql',
+        notes: 'Structured viewer feedback on films.',
+    },
+    {
+        tableName: 'community_watch_progress',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260620180000_community_viewer_catalog.sql',
+        notes: 'Continue-watching positions per user/film.',
+    },
+    {
+        tableName: 'community_watchlist',
+        schemaName: 'public',
+        domainOwner: 'community-movie',
+        status: 'canonical_active',
+        migrationFile: '20260620180000_community_viewer_catalog.sql',
+        notes: 'Saved films watchlist per user.',
+    },
+    {
+        tableName: 'film_deliverables',
+        schemaName: 'public',
+        domainOwner: 'film-production',
+        status: 'canonical_active',
+        migrationFile: '20260622000000_film_deliverables.sql',
+        notes: 'Final deliverables with locale/variant_kind columns for publish bridge.',
+    },
+    // ── Planned / Future Tables ────────────────────────────────────────────────
+    {
+        tableName: 'publication_packages',
+        schemaName: 'public',
+        domainOwner: 'publication',
+        status: 'canonical_planned',
+        notes: 'Publication output packaging for audiobook, book, report. Planned for publication sprint.',
+    },
+    {
+        tableName: 'transformation_traces',
+        schemaName: 'public',
+        domainOwner: 'transformation-studio',
+        status: 'canonical_planned',
+        notes: 'Cross-channel transformation traceability links. Planned for Transformation Studio sprint.',
+    },
+];
+exports.TABLE_OWNERSHIP_ENTRIES = TABLE_OWNERSHIP_ENTRIES;
+// ─── Index Maps ───────────────────────────────────────────────────────────────
+const _byTableName = new Map(TABLE_OWNERSHIP_ENTRIES.map((e) => [e.tableName, e]));
+// ─── Helper Functions ─────────────────────────────────────────────────────────
+/** Return ownership entry for a given table name. */
+function getTableOwnership(tableName) {
+    return _byTableName.get(tableName);
+}
+/**
+ * Assert a table is registered and not a wrong_table_reference or dead_remove.
+ * Throws if the table is not canonical — use in DB service layer and Guardian.
+ */
+function assertTableCanonical(tableName) {
+    const entry = _byTableName.get(tableName);
+    if (!entry) {
+        throw new Error(`[TableOwnershipRegistry] Table "${tableName}" has no ownership entry. ` +
+            `Register it in packages/contracts/src/registry/table-ownership-registry.ts.`);
+    }
+    if (entry.status === 'wrong_table_reference') {
+        throw new Error(`[TableOwnershipRegistry] Table "${tableName}" is a wrong_table_reference. ` +
+            `Use "${entry.replacementTable ?? 'the canonical replacement'}" instead.`);
+    }
+    if (entry.status === 'dead_remove') {
+        throw new Error(`[TableOwnershipRegistry] Table "${tableName}" is marked dead_remove. ` +
+            `This table is tombstoned. Do not add new queries. Use "${entry.replacementTable ?? 'the canonical replacement'}".`);
+    }
+}
+/** Return all tables by status. */
+function getTablesByStatus(status) {
+    return TABLE_OWNERSHIP_ENTRIES.filter((e) => e.status === status);
+}
+/** Return all tables that need a classification decision. */
+function getUndecidedTables() {
+    return TABLE_OWNERSHIP_ENTRIES.filter((e) => e.status === 'needs_decision');
+}
+/** Return all banned tables (wrong_table_reference or dead_remove). */
+function getBannedTables() {
+    return TABLE_OWNERSHIP_ENTRIES.filter((e) => e.status === 'wrong_table_reference' || e.status === 'dead_remove');
+}
+/** Return the set of banned table names for use in static analysis tests. */
+function getBannedTableNames() {
+    return new Set(getBannedTables().map((e) => e.tableName));
+}