aline-ai 0.5.10__py3-none-any.whl → 0.5.12__py3-none-any.whl

{aline_ai-0.5.10.dist-info → aline_ai-0.5.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aline-ai
-Version: 0.5.10
+Version: 0.5.12
 Summary: Shared AI memory; everyone knows everything in teams
 Author: Sharemind
 License: MIT

{aline_ai-0.5.10.dist-info → aline_ai-0.5.12.dist-info}/RECORD

@@ -1,10 +1,10 @@
-aline_ai-0.5.10.dist-info/licenses/LICENSE,sha256=H8wTqV5IF1oHw_HbBtS1PSDU8G_q81yblEIL_JfV8Vo,1077
-realign/__init__.py,sha256=cxZ-7zshfDXh7ZfRZqr7NrX86rO2tjfUbtVcF9Ls0BQ,1624
+aline_ai-0.5.12.dist-info/licenses/LICENSE,sha256=H8wTqV5IF1oHw_HbBtS1PSDU8G_q81yblEIL_JfV8Vo,1077
+realign/__init__.py,sha256=6cJg0KmEft8KkD6TMW5-Lib2T9w9w105TIzIZ8mfEao,1624
 realign/claude_detector.py,sha256=ZLSJacMo6zzQclXByABKA70UNpstxqIv3fPGqdpA934,2792
 realign/cli.py,sha256=9VS3WbysZ78NRK5EvkJVg8s6Uh2TQjsGX1E9Pl81pHc,31234
 realign/codex_detector.py,sha256=N9ulgMgvTzDfXE4s4vLd6OoS0hT7R6h2bDFFXWa-2hE,4183
 realign/config.py,sha256=lIKZqeOwYc_gHo760lYYX6PnapuKrCWGqT5SA8-PbeA,12044
-realign/context.py,sha256=ctQWoz883jXx_whObCoB58vhJjGAVUxld9sOZ371Tn8,13821
+realign/context.py,sha256=8hzgNOg-7_eMW22wt7OM5H9IsmMveKXCv0epG7E0G7w,13917
 realign/file_lock.py,sha256=kLNm1Rra4TCrTMyPM5fwjVascq-CUz2Bzh9HHKtCKOE,3444
 realign/hooks.py,sha256=NR4LgWgkA6npW_B68I7OdCaZNWseYSP7ZbK4Sl5nnTo,74692
 realign/llm_client.py,sha256=KPfJScQvqse-Tm-VpqnZ6C5jvajPl2n4Ddz9sUp7WIY,24564
@@ -28,7 +28,7 @@ realign/claude_hooks/permission_request_hook.py,sha256=jMN7UtL6bMqHObUCP5A5ysvFr
 realign/claude_hooks/permission_request_hook_installer.py,sha256=_8Wr_L5MES7iGukJzcaj4bqR0BH8kFL44U_X4iKtw2Y,7791
 realign/claude_hooks/stop_hook.py,sha256=2nzF2aF1p5teMJ0eV0ALEHD1K-yVj5sSh7UE8xL54ZE,12025
 realign/claude_hooks/stop_hook_installer.py,sha256=uyqKOqpix7CQP64ERBvvh7viSPp_wx_JVGNAX18rKh0,7228
-realign/claude_hooks/terminal_state.py,sha256=tq-PLwPLoadP8m_QN3WlQvPP_wi-rLG881Z8-tINjxo,5224
+realign/claude_hooks/terminal_state.py,sha256=i8B6b_2_9ttPEemp7SrGdFRJSa-vm5lc7YSTRTvAWNg,5397
 realign/claude_hooks/user_prompt_submit_hook.py,sha256=WD-UavhBTueN2TPfnZrnPC7DFYGEeptjUEF21EJn7Qo,10312
 realign/claude_hooks/user_prompt_submit_hook_installer.py,sha256=2xLF8yZcE7Iwib9gU-xCkA1NWxNH9Nc5CFKPYK7rtXw,5371
 realign/commands/__init__.py,sha256=sx_ck55oxaoiF4N3LugG0ZXwonUDxeEZ5uHbBKCC7K8,89
@@ -37,7 +37,7 @@ realign/commands/config.py,sha256=nYnu_h2pk7GODcrzrV04K51D-s7v06FlRXHJ0HJ-gvU,67
 realign/commands/context.py,sha256=pM2KfZHVkB-ou4nBhFvKSwnYliLBzwN3zerLyBAbhfE,7095
 realign/commands/export_shares.py,sha256=Djy1aO7MoU1_ewzn6CZ43oNhSEEonV3sTkSQbHgiaKI,135806
 realign/commands/import_shares.py,sha256=ukX8huvLvEM5g0qEIoqrV1-imz1g-r0Jj2FqD-ojrIA,25297
-realign/commands/init.py,sha256=ef-q3Qz5D_0Eqld8qjtX26X2QrovBSYcva3uAjiJuwk,33015
+realign/commands/init.py,sha256=tQyOX7csS8t9Ils3FKla41pS8_0Kd7I1Y1rz58a83aU,33511
 realign/commands/restore.py,sha256=s2BxQZHxQw9r12NzRVsK20KlGafy5AIoSjWMo5PcnHY,11173
 realign/commands/search.py,sha256=QJrC0hln9sCDFxXbpo0nPGMHXrud18qA5QfRyD0z6fQ,25926
 realign/commands/upgrade.py,sha256=L3PLOUIN5qAQTbkfoVtSsIbbzEezA_xjjk9F1GMVfjw,12781
@@ -45,7 +45,7 @@ realign/commands/watcher.py,sha256=fWL3kaRkqE03-NtFLaXlx93hJAQrAuNPSoYhOyQZfq8,1
 realign/commands/worker.py,sha256=K1DG1uZ--ebKwklHCyIFdN_axoLjL9Onx8Naq-DOZBs,23078
 realign/dashboard/__init__.py,sha256=QZkHTsGityH8UkF8rmvA3xW7dMXNe0swEWr443qfgCM,128
 realign/dashboard/app.py,sha256=jyW6mqmItTy253CPSqInxctkWzkrGEikdy-ikuShQ14,13299
-realign/dashboard/tmux_manager.py,sha256=-8LEupS7e4PzwwQ5uwOYV-EzrXaprypQObw8OP1MgG4,26380
+realign/dashboard/tmux_manager.py,sha256=Vt_30WNtDg7c_9SEh8xdDtBLJ8kNq6bGSPh5r3VXpg0,26276
 realign/dashboard/screens/__init__.py,sha256=US6sAmQs5VVkH2tFkH_z0WDT4H8cVhLL-JckfSR1yQY,446
 realign/dashboard/screens/create_agent.py,sha256=lpcT1zLq_p02codtHTE8KdbEzCEaNLnk1lqU3QLcXCg,10057
 realign/dashboard/screens/create_event.py,sha256=oiQY1zKpUYnQU-5fQLeuZH9BV5NClE5B5XZIVBYG5A8,5506
@@ -67,9 +67,9 @@ realign/dashboard/widgets/worker_panel.py,sha256=F_jKWABuCNmjQgeeuCr4KnFRKdY4CLT
 realign/db/__init__.py,sha256=65LsNdsq_rkwNC1eg1OAr3HC0ORXtelOh0I8MhNGr-g,3288
 realign/db/base.py,sha256=MIqu08uG8i5atjZ9uF-uc0Rx35ondxCtUPK92hMoHx4,13179
 realign/db/locks.py,sha256=yzCiPJZ4eOQX-Q4mXB6s76U2U7lXAzIBBy1t59w-AVU,1698
-realign/db/migrate_agents.py,sha256=RPSVDAM-mQMAyTar3-XGrVUQIoCrMprk9tGa-AoZL_A,9421
+realign/db/migrate_agents.py,sha256=cDeVUzKW950dJ0lV74QObHuONqKwErSrXI5akU2vBmQ,9633
 realign/db/migration.py,sha256=af1QFEfIh_qX0pFyXzm5gWFVbQn0sKOUNLSJHlr__FU,13405
-realign/db/schema.py,sha256=S0BPY8V823ttPWk69W5PO6nu0DQDVHvYY0UObGI9ePo,23481
+realign/db/schema.py,sha256=93dfMtw3LgkBMpiUlCQ0EscY9RFsuS8sEBDckH8lGws,25864
 realign/db/sqlite_db.py,sha256=sZXcvEaSu4C_MQ8pF20RUhwsPtBlNr6ANqf8suM5X8E,102660
 realign/events/__init__.py,sha256=IM-NxF4Zk2hYFD07k4WrfNRuuiC9ihGjf4GBpJhjd2E,35
 realign/events/debouncer.py,sha256=U3Q7dYpnMsAgWsW_E_IbSC4lrdEoi6H_SFLGLOAazs4,3062
@@ -89,8 +89,8 @@ realign/triggers/next_turn_trigger.py,sha256=BpP0PWn4mU1MZd6mv89jWcjs8Jtv0zEWapW
 realign/triggers/registry.py,sha256=cb-AVLbYB2pqwfWL3q1DQxLv4kOw7g7m-GshTdfFESc,3827
 realign/triggers/turn_status.py,sha256=wAZEhXDAmDoX5F-ohWfSnZZ0eA6DAJ9svSPiSv_f6sg,6041
 realign/triggers/turn_summary.py,sha256=f3hEUshgv9skJ9AbfWpoYs417lsv_HK2A_vpPjgryO4,4467
-aline_ai-0.5.10.dist-info/METADATA,sha256=efo6zCepaEc3fBPRcQAi6QL9k5Y-gUee8RfSQBxbRwE,1598
-aline_ai-0.5.10.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-aline_ai-0.5.10.dist-info/entry_points.txt,sha256=TvYELpMoWsUTcQdMV8tBHxCbEf_LbK4sESqK3r8PM6Y,78
-aline_ai-0.5.10.dist-info/top_level.txt,sha256=yIL3s2xv9nf1GwD5n71Aq_JEIV4AfzCIDNKBzewuRm4,8
-aline_ai-0.5.10.dist-info/RECORD,,
+aline_ai-0.5.12.dist-info/METADATA,sha256=bMuapdLKzuZXb45akvIB6w7uhc5jXl31onpetDCEAxQ,1598
+aline_ai-0.5.12.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+aline_ai-0.5.12.dist-info/entry_points.txt,sha256=TvYELpMoWsUTcQdMV8tBHxCbEf_LbK4sESqK3r8PM6Y,78
+aline_ai-0.5.12.dist-info/top_level.txt,sha256=yIL3s2xv9nf1GwD5n71Aq_JEIV4AfzCIDNKBzewuRm4,8
+aline_ai-0.5.12.dist-info/RECORD,,

realign/__init__.py

@@ -3,7 +3,7 @@
 import hashlib
 from pathlib import Path
 
-__version__ = "0.5.10"
+__version__ = "0.5.12"
 
 
 def get_realign_dir(project_root: Path) -> Path:

realign/claude_hooks/terminal_state.py

@@ -34,6 +34,16 @@ def _read_json(path: Path) -> dict[str, Any]:
         return {}
 
 
+def _get_db():
+    """Get database connection (lazy import to avoid circular deps in hooks)."""
+    try:
+        from ..db import get_database
+
+        return get_database(read_only=False)
+    except Exception:
+        return None
+
+
 def _write_to_db(
     *,
     terminal_id: str,
@@ -52,11 +62,9 @@ def _write_to_db(
     Returns True if successful, False otherwise.
     """
     try:
-        from ..db.sqlite_db import SQLiteDatabase
-
-        db_path = Path.home() / ".aline" / "realign.db"
-        db = SQLiteDatabase(str(db_path))
-        db.initialize()
+        db = _get_db()
+        if not db:
+            return False
 
         # Check if agent exists
         existing = db.get_agent_by_id(terminal_id)
@@ -88,7 +96,7 @@ def _write_to_db(
                 source=source if source else None,
                 attention=attention,
             )
-        db.close()
+        # Note: Don't close - get_database() returns a singleton
         return True
     except Exception:
         return False

realign/commands/init.py

@@ -19,7 +19,7 @@ console = Console()
 # tmux config template for Aline-managed dashboard sessions.
 # Stored at ~/.aline/tmux/tmux.conf and sourced by the dashboard tmux bootstrap.
 # Bump this version when the tmux config changes to trigger auto-update on `aline init`.
-_TMUX_CONFIG_VERSION = 2
+_TMUX_CONFIG_VERSION = 8
 
 
 def _get_tmux_config() -> str:
@@ -53,16 +53,25 @@ set -s escape-time 0
 # Better scrolling: enter copy-mode with -e so scrolling to bottom exits it.
 bind-key -n WheelUpPane if-shell -F -t = "#{mouse_any_flag}" "send-keys -M" "if -Ft= '#{pane_in_mode}' 'send-keys -M' 'copy-mode -e -t ='"
 
-# macOS clipboard (pbcopy). Only set bindings if pbcopy is available.
-if-shell 'command -v pbcopy >/dev/null 2>&1' '
-    bind -T copy-mode-vi MouseDragEnd1Pane send -X copy-pipe "pbcopy" \; if -F "#{==:#{scroll_position},0}" "send -X cancel"
-    bind -T copy-mode    MouseDragEnd1Pane send -X copy-pipe "pbcopy" \; if -F "#{==:#{scroll_position},0}" "send -X cancel"
-' ''
+# macOS clipboard: copy selection to clipboard when drag ends.
+# Use copy-pipe-no-clear to preserve selection highlight after copying.
+bind -T copy-mode-vi MouseDragEnd1Pane send -X copy-pipe-no-clear "pbcopy"
+bind -T copy-mode    MouseDragEnd1Pane send -X copy-pipe-no-clear "pbcopy"
 
-# Prevent mouse click from exiting copy-mode (stay in copy mode, just clear selection).
+# MouseDrag1Pane: Clear old selection and start new one when dragging begins.
+# This ensures selection only clears when starting a NEW drag, not on click.
+bind -T copy-mode-vi MouseDrag1Pane select-pane \; send -X clear-selection \; send -X begin-selection
+bind -T copy-mode    MouseDrag1Pane select-pane \; send -X clear-selection \; send -X begin-selection
+
+# MouseDown1Pane: Click clears selection but stays in copy-mode (no scroll).
+# To exit copy-mode: scroll to bottom (auto-exit) or press q/Escape.
 bind -T copy-mode-vi MouseDown1Pane select-pane \; send -X clear-selection
 bind -T copy-mode    MouseDown1Pane select-pane \; send -X clear-selection
 
+# Escape key: exit copy-mode (also use this before Cmd+V paste in copy-mode).
+bind -T copy-mode-vi Escape send -X cancel
+bind -T copy-mode    Escape send -X cancel
+
 # Type-to-Exit: Typing any alphanumeric character exits copy-mode and sends the key.
 """
     def _tmux_quote(value: str) -> str:

realign/context.py

@@ -23,12 +23,19 @@ CONTEXT_ID_ENV_VAR = "ALINE_CONTEXT_ID"
 def _get_db():
     """Get database connection (lazy import to avoid circular deps)."""
     try:
-        from .db.sqlite_db import SQLiteDatabase
+        from .db import get_database
 
-        db_path = Path.home() / ".aline" / "realign.db"
-        db = SQLiteDatabase(str(db_path))
-        db.initialize()
-        return db
+        return get_database(read_only=False)
+    except Exception:
+        return None
+
+
+def _get_db_readonly():
+    """Get read-only database connection."""
+    try:
+        from .db import get_database
+
+        return get_database(read_only=True)
     except Exception:
         return None
 
@@ -95,13 +102,12 @@ class ContextConfig:
 def _load_context_config_from_db() -> Optional[ContextConfig]:
     """Load context configuration from database (best-effort)."""
     try:
-        db = _get_db()
+        db = _get_db_readonly()
         if not db:
             return None
 
         db_contexts = db.list_agent_contexts(limit=100)
         if not db_contexts:
-            db.close()
             return None
 
         contexts = []
@@ -115,7 +121,6 @@ def _load_context_config_from_db() -> Optional[ContextConfig]:
             )
             contexts.append(entry)
 
-        db.close()
         return ContextConfig(contexts=contexts)
     except Exception:
         return None
@@ -190,7 +195,7 @@ def _sync_context_to_db(entry: ContextEntry) -> bool:
         else:
             db.set_agent_context_events(entry.context_id, [])
 
-        db.close()
+        # Note: Don't close - get_database() returns a singleton
         return True
     except Exception:
         return False
@@ -439,10 +444,9 @@ def get_context_by_id(
     """
     # Phase 1: Try to load from database
     try:
-        db = _get_db()
+        db = _get_db_readonly()
         if db:
             ctx = db.get_agent_context_by_id(context_id)
-            db.close()
             if ctx:
                 return ContextEntry(
                     context_sessions=ctx.session_ids or [],

realign/dashboard/tmux_manager.py

@@ -194,13 +194,10 @@ def _session_id_from_transcript_path(transcript_path: str | None) -> str | None:
 def _load_terminal_state_from_db() -> dict[str, dict[str, str]]:
     """Load terminal state from database (best-effort)."""
     try:
-        from ..db.sqlite_db import SQLiteDatabase
-
-        db_path = Path.home() / ".aline" / "realign.db"
-        db = SQLiteDatabase(str(db_path), read_only=True)
+        from ..db import get_database
 
+        db = get_database(read_only=True)
         agents = db.list_agents(status="active", limit=100)
-        db.close()
 
         out: dict[str, dict[str, str]] = {}
         for agent in agents:

realign/db/migrate_agents.py

@@ -240,8 +240,8 @@ def main():
     parser.add_argument(
         "--db-path",
         type=str,
-        default=str(Path.home() / ".aline" / "realign.db"),
-        help="Path to SQLite database",
+        default=None,
+        help="Path to SQLite database (uses config default if not specified)",
     )
 
     args = parser.parse_args()
@@ -262,13 +262,19 @@ def main():
 
     # Initialize database
     if not args.dry_run:
-        from .sqlite_db import SQLiteDatabase
-
-        print(f"\n[step] Initializing database at {args.db_path}")
-        db = SQLiteDatabase(args.db_path)
-        if not db.initialize():
-            print("[error] Database initialization failed")
-            sys.exit(1)
+        if args.db_path:
+            from .sqlite_db import SQLiteDatabase
+
+            print(f"\n[step] Initializing database at {args.db_path}")
+            db = SQLiteDatabase(args.db_path)
+            if not db.initialize():
+                print("[error] Database initialization failed")
+                sys.exit(1)
+        else:
+            from . import get_database
+
+            print("\n[step] Using configured database path")
+            db = get_database(read_only=False)
     else:
         db = None
 

realign/db/schema.py

@@ -58,9 +58,13 @@ Schema V15: Agents and contexts tables (replaces terminal.json and load.json).
 - agent_contexts table: context definitions (replaces load.json)
 - agent_context_sessions table: M2M context-session links
 - agent_context_events table: M2M context-event links
+
+Schema V16: Remove FK constraints from agent_context_sessions/events.
+- Context may reference sessions/events not yet imported to DB
+- Recreate M2M tables without FK constraints on session_id/event_id
 """
 
-SCHEMA_VERSION = 15
+SCHEMA_VERSION = 16
 
 FTS_EVENTS_SCRIPTS = [
     # Full Text Search for Events
@@ -288,10 +292,11 @@ INIT_SCRIPTS = [
     """,
     "CREATE INDEX IF NOT EXISTS idx_agent_contexts_workspace ON agent_contexts(workspace);",
     # Agent context sessions (M2M)
+    # Note: No FK on session_id - context may reference sessions not yet imported
     """
     CREATE TABLE IF NOT EXISTS agent_context_sessions (
         context_id TEXT NOT NULL REFERENCES agent_contexts(id) ON DELETE CASCADE,
-        session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
+        session_id TEXT NOT NULL,
         added_at TEXT DEFAULT (datetime('now')),
         PRIMARY KEY (context_id, session_id)
     );
@@ -299,10 +304,11 @@ INIT_SCRIPTS = [
     "CREATE INDEX IF NOT EXISTS idx_agent_context_sessions_context ON agent_context_sessions(context_id);",
     "CREATE INDEX IF NOT EXISTS idx_agent_context_sessions_session ON agent_context_sessions(session_id);",
     # Agent context events (M2M)
+    # Note: No FK on event_id - context may reference events not yet created
     """
     CREATE TABLE IF NOT EXISTS agent_context_events (
         context_id TEXT NOT NULL REFERENCES agent_contexts(id) ON DELETE CASCADE,
-        event_id TEXT NOT NULL REFERENCES events(id) ON DELETE CASCADE,
+        event_id TEXT NOT NULL,
         added_at TEXT DEFAULT (datetime('now')),
         PRIMARY KEY (context_id, event_id)
     );
@@ -503,10 +509,11 @@ MIGRATION_V14_TO_V15 = [
     """,
     "CREATE INDEX IF NOT EXISTS idx_agent_contexts_workspace ON agent_contexts(workspace);",
     # Agent context sessions (M2M)
+    # Note: No FK on session_id - context may reference sessions not yet imported
     """
     CREATE TABLE IF NOT EXISTS agent_context_sessions (
         context_id TEXT NOT NULL REFERENCES agent_contexts(id) ON DELETE CASCADE,
-        session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
+        session_id TEXT NOT NULL,
         added_at TEXT DEFAULT (datetime('now')),
         PRIMARY KEY (context_id, session_id)
     );
@@ -514,14 +521,51 @@ MIGRATION_V14_TO_V15 = [
     "CREATE INDEX IF NOT EXISTS idx_agent_context_sessions_context ON agent_context_sessions(context_id);",
     "CREATE INDEX IF NOT EXISTS idx_agent_context_sessions_session ON agent_context_sessions(session_id);",
     # Agent context events (M2M)
+    # Note: No FK on event_id - context may reference events not yet created
     """
     CREATE TABLE IF NOT EXISTS agent_context_events (
         context_id TEXT NOT NULL REFERENCES agent_contexts(id) ON DELETE CASCADE,
-        event_id TEXT NOT NULL REFERENCES events(id) ON DELETE CASCADE,
+        event_id TEXT NOT NULL,
+        added_at TEXT DEFAULT (datetime('now')),
+        PRIMARY KEY (context_id, event_id)
+    );
+    """,
+    "CREATE INDEX IF NOT EXISTS idx_agent_context_events_context ON agent_context_events(context_id);",
+    "CREATE INDEX IF NOT EXISTS idx_agent_context_events_event ON agent_context_events(event_id);",
+]
+
+# V15 to V16: Remove FK constraints from agent_context_sessions/events
+# Context may reference sessions/events not yet in the database
+MIGRATION_V15_TO_V16 = [
+    # Step 1: Rename old tables
+    "ALTER TABLE agent_context_sessions RENAME TO agent_context_sessions_old;",
+    "ALTER TABLE agent_context_events RENAME TO agent_context_events_old;",
+    # Step 2: Create new tables without FK constraints on session_id/event_id
+    """
+    CREATE TABLE agent_context_sessions (
+        context_id TEXT NOT NULL REFERENCES agent_contexts(id) ON DELETE CASCADE,
+        session_id TEXT NOT NULL,
+        added_at TEXT DEFAULT (datetime('now')),
+        PRIMARY KEY (context_id, session_id)
+    );
+    """,
+    """
+    CREATE TABLE agent_context_events (
+        context_id TEXT NOT NULL REFERENCES agent_contexts(id) ON DELETE CASCADE,
+        event_id TEXT NOT NULL,
         added_at TEXT DEFAULT (datetime('now')),
         PRIMARY KEY (context_id, event_id)
     );
     """,
+    # Step 3: Copy data from old tables
+    "INSERT INTO agent_context_sessions SELECT * FROM agent_context_sessions_old;",
+    "INSERT INTO agent_context_events SELECT * FROM agent_context_events_old;",
+    # Step 4: Drop old tables
+    "DROP TABLE agent_context_sessions_old;",
+    "DROP TABLE agent_context_events_old;",
+    # Step 5: Recreate indexes
+    "CREATE INDEX IF NOT EXISTS idx_agent_context_sessions_context ON agent_context_sessions(context_id);",
+    "CREATE INDEX IF NOT EXISTS idx_agent_context_sessions_session ON agent_context_sessions(session_id);",
     "CREATE INDEX IF NOT EXISTS idx_agent_context_events_context ON agent_context_events(context_id);",
     "CREATE INDEX IF NOT EXISTS idx_agent_context_events_event ON agent_context_events(event_id);",
 ]
@@ -579,4 +623,10 @@ def get_migration_scripts(from_version: int, to_version: int) -> list:
     if from_version < 15 and to_version >= 15:
         scripts.extend(MIGRATION_V14_TO_V15)
 
+    if from_version < 16 and to_version >= 16:
+        # Only run V15->V16 if coming from exactly V15 (tables exist with FK)
+        # For V14 or earlier, V14_TO_V15 now creates tables without FK
+        if from_version == 15:
+            scripts.extend(MIGRATION_V15_TO_V16)
+
     return scripts