diff --git a/services/assistant-api/src/main/resources/db/migration/V12__workspace_agent_session_cli_session_id.sql b/services/assistant-api/src/main/resources/db/migration/V12__workspace_agent_session_cli_session_id.sql
index 90e8a875..8a51cc93 100644
--- a/services/assistant-api/src/main/resources/db/migration/V12__workspace_agent_session_cli_session_id.sql
+++ b/services/assistant-api/src/main/resources/db/migration/V12__workspace_agent_session_cli_session_id.sql
@@ -1,5 +1,5 @@
--- Store the native CLI session id for observability and future explicit
--- continuation flows. Nullable because:
+-- Store the native CLI session id so a resume flag can be passed on
+-- wake/re-attach without starting a fresh session. Nullable because:
 --   - SHELL sessions have no native CLI id
 --   - Codex session id discovery is async (captured after spawn)
 --   - Old rows have no id