@lmctl-ai/lmctl 0.2.37 → 0.2.39

package/dist/cli/schema.sql

@@ -1,7 +1,4 @@
--- lmctl-next v1 schema. Forward-only migration; see migrate.ts.
--- Timestamps are ISO-8601 UTC TEXT values.
 
--- Workflows (declarative, JSON-stored). Versioned.
 CREATE TABLE workflow (
   id                        INTEGER PRIMARY KEY AUTOINCREMENT,
   name                      TEXT NOT NULL,
@@ -10,18 +7,11 @@ CREATE TABLE workflow (
   definition                TEXT NOT NULL,
   active_version_id         INTEGER REFERENCES workflow_version(id),
   created_at                TEXT NOT NULL,
-  -- P2 (distribution-redesign §2): additive, nullable template provenance.
-  -- Populated when a workflow is loaded from a known template/path; NULL
-  -- everywhere else (zero back-compat break — old rows stay NULL). Mirrors
-  -- the v26 migration block byte-for-byte so a fresh schema.sql DB and a
-  -- v25→v26 migrated DB converge.
   source_uri                TEXT,
   source_sha256             TEXT,
   UNIQUE(name, version)
 );
 
--- V3.1: immutable workflow JSON snapshots. Future editor flows append rows
--- here and point workflow.active_version_id at the current snapshot.
 CREATE TABLE workflow_version (
   id          INTEGER PRIMARY KEY AUTOINCREMENT,
   workflow_id INTEGER NOT NULL REFERENCES workflow(id),
@@ -33,7 +23,6 @@ CREATE TABLE workflow_version (
 );
 CREATE INDEX IF NOT EXISTS idx_workflow_version_wf ON workflow_version(workflow_id, version DESC);
 
--- Teams (replaces .lmctl files).
 CREATE TABLE team (
   id               INTEGER PRIMARY KEY AUTOINCREMENT,
   name             TEXT NOT NULL UNIQUE,
@@ -59,7 +48,6 @@ CREATE TABLE team_member (
   UNIQUE(team_id, alias)
 );
 
--- Interpreter members can observe companion agent members.
 CREATE TABLE team_member_companion (
   id              INTEGER PRIMARY KEY AUTOINCREMENT,
   interpreter_id  INTEGER NOT NULL REFERENCES team_member(id),
@@ -68,10 +56,6 @@ CREATE TABLE team_member_companion (
   UNIQUE(interpreter_id, companion_id)
 );
 
--- Projects (target repos/codebases). Workflow name resolves to a version at job->run creation.
--- v23: the per-project workflow lock columns (active_run_id / active_locked_at /
--- active_locked_by / active_locked_expires_at) were removed under the V4
--- master-agent architecture. Serialization is structural now.
 CREATE TABLE project (
   id                INTEGER PRIMARY KEY AUTOINCREMENT,
   name              TEXT NOT NULL,
@@ -82,22 +66,12 @@ CREATE TABLE project (
   default_branch    TEXT,
   intake_config     TEXT,
   test_argv         TEXT,
-  -- DG-6 D-6 / v31: per-project test command consumed by the
-  -- `lmctl/shell-step` `focused_test` step in the bugfix-* workflows.
-  -- When NULL or empty the `{{project.test_command}}` template
-  -- substituter falls back to `npm test` for backward-compat (matches
-  -- the historical hardcode the column replaces). Set to a project-
-  -- specific command (e.g. "go test ./...", "cargo test --quiet") to
-  -- target non-Node projects without forking the workflow JSON.
-  -- ADDITIVE ONLY — no existing column altered/dropped.
   test_command      TEXT,
   durable_memory_mode TEXT NOT NULL DEFAULT 'folder' CHECK(durable_memory_mode IN ('folder','db')),
   created_at        TEXT NOT NULL,
   UNIQUE(name)
 );
 
--- App 2 / v17: project-to-workflow dispatcher rows. Each enabled row
--- can match an intake event and enqueue a job for its workflow.
 CREATE TABLE project_workflow (
   id                  INTEGER PRIMARY KEY AUTOINCREMENT,
   project_id          INTEGER NOT NULL REFERENCES project(id),
@@ -110,8 +84,6 @@ CREATE TABLE project_workflow (
   UNIQUE(project_id, workflow_id, condition)
 );
 
--- Post-V3 Step 1 / v18: per-project issue queue. QA producers create
--- failures; PR-fix consumers atomically claim and close them.
 CREATE TABLE project_issue (
   id                 INTEGER PRIMARY KEY AUTOINCREMENT,
   project_id         INTEGER NOT NULL REFERENCES project(id),
@@ -130,7 +102,6 @@ CREATE TABLE project_issue (
   closed_at          TEXT
 );
 
--- Jobs: SQLite-backed queue.
 CREATE TABLE job (
   id              INTEGER PRIMARY KEY AUTOINCREMENT,
   project_id      INTEGER NOT NULL REFERENCES project(id),
@@ -154,7 +125,6 @@ CREATE TABLE job (
   UNIQUE(source, dedupe_key)
 );
 
--- Runs: an instance of a workflow execution against a job.
 CREATE TABLE run (
   id              INTEGER PRIMARY KEY AUTOINCREMENT,
   job_id          INTEGER NOT NULL REFERENCES job(id),
@@ -168,12 +138,9 @@ CREATE TABLE run (
   paused_at       TEXT,
   blocker         TEXT,
   parent_run_id   INTEGER REFERENCES run(id),
-  -- DEF-1 v27: step.id-keyed JSON map of the operator escalation-resume
-  -- decision. Additive nullable; old rows NULL. Mirrors the v27 migration.
   pending_escalation_decision TEXT
 );
 
--- Steps: one row per state transition inside a run.
 CREATE TABLE step (
   id              INTEGER PRIMARY KEY AUTOINCREMENT,
   run_id          INTEGER NOT NULL REFERENCES run(id),
@@ -185,7 +152,6 @@ CREATE TABLE step (
   ended_at        TEXT
 );
 
--- V3.2: per-workflow trigger registrations polled by trigger_watcher.
 CREATE TABLE trigger_instance (
   id              INTEGER PRIMARY KEY AUTOINCREMENT,
   workflow_id     INTEGER NOT NULL REFERENCES workflow(id),
@@ -201,15 +167,6 @@ CREATE TABLE trigger_instance (
   UNIQUE(workflow_id, trigger_id)
 );
 
--- Step artifacts (transcripts, file paths, inline content).
---
--- `provider_call_mode` (A2.5): when the artifact was produced by a
--- provider-backed step (engine chat() call), this column records
--- whether the chat went through the in-process library path or the
--- legacy `lmctl chat` subprocess. Values: 'library' | 'subprocess'
--- | NULL (artifact wasn't produced by a chat call). Lets audits
--- answer "was this turn run in-process?" without grepping
--- process trees.
 CREATE TABLE step_artifact (
   id                 INTEGER PRIMARY KEY AUTOINCREMENT,
   step_id            INTEGER NOT NULL REFERENCES step(id),
@@ -221,7 +178,6 @@ CREATE TABLE step_artifact (
   created_at         TEXT NOT NULL
 );
 
--- Generic external object layer: PRs, issues, tickets, deployments, incidents, etc.
 CREATE TABLE external_object (
   id              INTEGER PRIMARY KEY AUTOINCREMENT,
   type            TEXT NOT NULL,
@@ -237,7 +193,6 @@ CREATE TABLE external_object (
   UNIQUE(provider, type, external_id)
 );
 
--- Idempotent signals observed on external objects.
 CREATE TABLE external_signal (
   id            INTEGER PRIMARY KEY AUTOINCREMENT,
   object_id     INTEGER NOT NULL REFERENCES external_object(id),
@@ -251,9 +206,6 @@ CREATE TABLE external_signal (
   UNIQUE(object_id, kind, signal_hash)
 );
 
--- Operator-facing alerts.
--- requires_user=1 when this attention demands explicit human action (e.g. resume
--- a Pause). UI flickers + multi-channel notification fires for these. Phase 3 L2.
 CREATE TABLE attention (
   id                  INTEGER PRIMARY KEY AUTOINCREMENT,
   kind                TEXT NOT NULL,
@@ -297,7 +249,6 @@ CREATE INDEX IF NOT EXISTS idx_session_size_member   ON session_size(team_name,
 CREATE INDEX IF NOT EXISTS idx_session_size_session  ON session_size(sessionid, observed_at DESC);
 CREATE INDEX IF NOT EXISTS idx_session_size_observed ON session_size(observed_at DESC);
 
--- Triage candidates (one row per evaluated issue produced by the triage workflow).
 CREATE TABLE candidate_issue (
   id              INTEGER PRIMARY KEY AUTOINCREMENT,
   triage_run_id   INTEGER NOT NULL REFERENCES run(id),
@@ -320,7 +271,6 @@ CREATE TABLE candidate_issue (
 CREATE INDEX IF NOT EXISTS idx_candidate_issue_run    ON candidate_issue(triage_run_id);
 CREATE INDEX IF NOT EXISTS idx_candidate_issue_status ON candidate_issue(status);
 
--- Submitted PRs being watched by the PR follow-up workflow.
 CREATE TABLE submitted_pr (
   id                      INTEGER PRIMARY KEY AUTOINCREMENT,
   repo                    TEXT NOT NULL,
@@ -342,7 +292,6 @@ CREATE TABLE submitted_pr (
 CREATE INDEX IF NOT EXISTS idx_submitted_pr_status   ON submitted_pr(status);
 CREATE INDEX IF NOT EXISTS idx_submitted_pr_scanned  ON submitted_pr(last_scanned_at);
 
--- One row per delta observed on a submitted PR (comment, check, review, state change).
 CREATE TABLE pr_followup_event (
   id              INTEGER PRIMARY KEY AUTOINCREMENT,
   submitted_pr_id INTEGER NOT NULL REFERENCES submitted_pr(id),
@@ -362,8 +311,6 @@ CREATE TABLE pr_followup_event (
 CREATE INDEX IF NOT EXISTS idx_pr_followup_event_pr   ON pr_followup_event(submitted_pr_id);
 CREATE INDEX IF NOT EXISTS idx_pr_followup_event_kind ON pr_followup_event(event_kind);
 
--- Durable memory entries (C.1). Used by DB-backend projects; folder-backend
--- projects store entries as .md files on disk under <project_local_path>/durable-memory/.
 CREATE TABLE IF NOT EXISTS durable_memory (
   id          INTEGER PRIMARY KEY AUTOINCREMENT,
   project_id  INTEGER NOT NULL REFERENCES project(id),
@@ -378,7 +325,6 @@ CREATE TABLE IF NOT EXISTS durable_memory (
 CREATE INDEX IF NOT EXISTS idx_durable_memory_project_type ON durable_memory(project_id, type);
 CREATE INDEX IF NOT EXISTS idx_durable_memory_project_name ON durable_memory(project_id, name);
 
--- D.1: fine-grained agent activity events captured during chat turns.
 CREATE TABLE IF NOT EXISTS session_event (
   id                   INTEGER PRIMARY KEY AUTOINCREMENT,
   run_id               INTEGER NOT NULL REFERENCES run(id),
@@ -393,7 +339,6 @@ CREATE INDEX IF NOT EXISTS idx_session_event_run       ON session_event(run_id);
 CREATE INDEX IF NOT EXISTS idx_session_event_kind_step ON session_event(kind, step_id);
 CREATE INDEX IF NOT EXISTS idx_session_event_timestamp ON session_event(timestamp_ms);
 
--- D.3: per-minute-bucket rolled-up stats; dashboard reads this, never session_event.
 CREATE TABLE IF NOT EXISTS rollup_stats (
   id              INTEGER PRIMARY KEY AUTOINCREMENT,
   run_id          INTEGER NOT NULL REFERENCES run(id),
@@ -408,7 +353,6 @@ CREATE TABLE IF NOT EXISTS rollup_stats (
 CREATE INDEX IF NOT EXISTS idx_rollup_run_metric ON rollup_stats(run_id, metric_kind);
 CREATE INDEX IF NOT EXISTS idx_rollup_bucket     ON rollup_stats(bucket_start_ms);
 
--- D.4: detected drift signals flagged by the policy engine.
 CREATE TABLE IF NOT EXISTS drift_signal (
   id              INTEGER PRIMARY KEY AUTOINCREMENT,
   team_member_id  INTEGER NOT NULL REFERENCES team_member(id),
@@ -424,13 +368,11 @@ CREATE TABLE IF NOT EXISTS drift_signal (
 CREATE INDEX IF NOT EXISTS idx_drift_member ON drift_signal(team_member_id);
 CREATE INDEX IF NOT EXISTS idx_drift_unacked ON drift_signal(team_member_id) WHERE acknowledged_at IS NULL;
 
--- D.3: monotonic cursor so the 250ms rollup updater survives daemon restarts.
 CREATE TABLE IF NOT EXISTS rollup_cursor (
   key   TEXT PRIMARY KEY,
   value INTEGER NOT NULL DEFAULT 0
 );
 
--- R2.3: interactive_session table for multi-turn Interactive state.
 CREATE TABLE IF NOT EXISTS interactive_session (
   id                  INTEGER PRIMARY KEY AUTOINCREMENT,
   run_id              INTEGER NOT NULL REFERENCES run(id),
@@ -447,8 +389,6 @@ CREATE TABLE IF NOT EXISTS interactive_session (
 CREATE INDEX IF NOT EXISTS idx_interactive_status    ON interactive_session(status);
 CREATE INDEX IF NOT EXISTS idx_interactive_run_state ON interactive_session(run_id, state_name);
 
--- webui v2 / v19: per-user transition-graph session for the operator webui.
--- See briefs/webui-transition-graph-v2.md §"Schemas (v19 migration)".
 CREATE TABLE IF NOT EXISTS webui_session (
   session_id         TEXT PRIMARY KEY,
   user_id            TEXT NOT NULL,
@@ -463,7 +403,6 @@ CREATE TABLE IF NOT EXISTS webui_session (
 );
 CREATE INDEX IF NOT EXISTS webui_session_user_idx ON webui_session(user_id);
 
--- webui v2 / v19: chatbot sidekick conversations and messages.
 CREATE TABLE IF NOT EXISTS chatbot_session (
   chatbot_session_id TEXT PRIMARY KEY,
   user_id            TEXT NOT NULL,
@@ -484,22 +423,12 @@ CREATE TABLE IF NOT EXISTS chatbot_message (
 );
 CREATE INDEX IF NOT EXISTS chatbot_message_session_idx ON chatbot_message(chatbot_session_id, id);
 
--- Phase A / v20: SQLite-canonical config table for api.url / api.port /
--- api.token. Eliminates env-var-propagation hazards when serve is launched
--- via run_in_background (Claude Code Bash strips env on spawn).
 CREATE TABLE IF NOT EXISTS lmctl_config (
   key        TEXT PRIMARY KEY,
   value      TEXT NOT NULL,
   updated_at TEXT NOT NULL
 );
 
--- M1 / v25 (#218): composition-DSL source + shareable template
--- (template↔instance split) for the scripting frontend. ADDITIVE — no
--- existing table/column changed. The compiled IR still lives in
--- workflow.definition / workflow_version; compiled_workflow_version_id links
--- a unit to its compiled snapshot. Mirrors the migrate.ts v25 block so a
--- fresh DB and a v24→v25 migrated DB converge. See
--- durable-memory/composition-language-design.md §5.
 CREATE TABLE IF NOT EXISTS composition_unit (
   id                           INTEGER PRIMARY KEY AUTOINCREMENT,
   name                         TEXT NOT NULL,
@@ -513,13 +442,6 @@ CREATE TABLE IF NOT EXISTS composition_unit (
 );
 CREATE INDEX IF NOT EXISTS idx_composition_unit_name ON composition_unit(name, version DESC);
 
--- L-7 / v28: webui prompt → V4 job dispatch map. `submitPrompt(project_id,
--- text)` inserts a row + enqueues a `manual` job for the project's bound
--- workflow; `pollPrompt(id)` joins back to job/run to derive a {pending |
--- running | done | error} status + the run terminal_state. ADDITIVE — no
--- existing table/column changed. Mirrors the migrate.ts v28 block so a fresh
--- DB and a v27→v28 migrated DB converge. See
--- durable-memory/lmctl-next-migration-design-2026-05-24.md §C.3.
 CREATE TABLE IF NOT EXISTS prompt_dispatch (
   prompt_id    TEXT PRIMARY KEY,
   project_id   INTEGER NOT NULL REFERENCES project(id),
@@ -532,14 +454,6 @@ CREATE TABLE IF NOT EXISTS prompt_dispatch (
 CREATE INDEX IF NOT EXISTS idx_prompt_dispatch_project ON prompt_dispatch(project_id, created_at DESC);
 CREATE INDEX IF NOT EXISTS idx_prompt_dispatch_job     ON prompt_dispatch(job_id);
 
--- L-8 Gap 4 / v29: webui workspace + project tables (K1 + K7 per
--- durable-memory/lmctl-next-migration-design-2026-05-24.md §C.2 / §K.7).
--- DELIBERATELY distinct from v27 `project` (which holds standing-team
--- projects, CLI-managed). `web_project` is what the webui's
--- createProject / updateProject / deleteProject mutate; soft-delete via
--- `deleted_at` so prompt history retains a reference but the UI hides the
--- row. ADDITIVE ONLY — no existing table/column altered or dropped. Mirrors
--- the migrate.ts v29 block so a fresh DB and a v28→v29 migrated DB converge.
 CREATE TABLE IF NOT EXISTS workspace (
   id                  TEXT PRIMARY KEY,
   name                TEXT NOT NULL,
@@ -562,34 +476,18 @@ CREATE TABLE IF NOT EXISTS web_project (
 CREATE INDEX IF NOT EXISTS idx_web_project_workspace ON web_project(workspace_id, deleted_at);
 CREATE INDEX IF NOT EXISTS idx_web_project_v4_link   ON web_project(linked_v4_project_id) WHERE linked_v4_project_id IS NOT NULL;
 
--- Seed the default workspace so `Query.workspace` always returns a row even
--- before the operator creates any project. The "default" id matches the
--- pre-L-8 resolver constant (preserves the `workspace.id == "default"`
--- baseline in tests/graphql/{batch,server}.test.ts).
 INSERT OR IGNORE INTO workspace (id, name, idle_threshold_ms, created_at)
 VALUES ('default', 'Default workspace', 600000, '1970-01-01T00:00:00.000Z');
 
--- MX-9 final fixup / v30 (durable-memory/MX-design-2026-05-25.md §2 lines 162,
--- 233): persist the agent-side mailbox cursor so restarts don't re-process the
--- entire backlog. Without this row, on agent restart the
--- VersionedMailboxClient starts with `cursor = undefined` → walks every
--- visible version as new → MailboxRpc.handleIncoming re-dispatches every
--- historical request envelope to the registered handler → duplicate
--- submitPrompt enqueues + duplicate job dispatch. ADDITIVE ONLY — no existing
--- table/column altered or dropped. Mirrors the migrate.ts v30 block so a fresh
--- DB and a v29→v30 migrated DB converge.
 CREATE TABLE IF NOT EXISTS mailbox_cursor (
   user_id                   TEXT NOT NULL,
   mailbox_key               TEXT NOT NULL,
   last_processed_version_id TEXT,
   last_processed_at         TEXT NOT NULL,
-  -- v35: last column to match `ALTER TABLE ... ADD COLUMN` append order on
-  -- migrated DBs (see migrate.ts v35), so fresh and migrated converge.
   last_processed_seq        INTEGER,
   PRIMARY KEY(user_id, mailbox_key)
 );
 
--- Path-keyed root-team registry (NOT a reuse of team/team_member)
 CREATE TABLE IF NOT EXISTS root_team (
   teamfile_path  TEXT PRIMARY KEY,
   name           TEXT,
@@ -599,7 +497,6 @@ CREATE TABLE IF NOT EXISTS root_team (
   last_seeded_at TEXT
 );
 
--- One row per request->response exchange
 CREATE TABLE IF NOT EXISTS team_chat_log (
   id                INTEGER PRIMARY KEY AUTOINCREMENT,
   root_teamfile     TEXT NOT NULL,
@@ -614,26 +511,17 @@ CREATE TABLE IF NOT EXISTS team_chat_log (
   error_detail      TEXT,
   truncated         INTEGER NOT NULL DEFAULT 0,
   created_at        TEXT NOT NULL,
-  -- v61: batch-vs-individual framing ('batch' for rows belonging to a batch
-  -- run, NULL for individual chats). Distinct from
-  -- message_pending.message_type (request/response lane semantics).
-  -- Appended LAST so a fresh create and a v60->v61 ALTER-upgrade converge on
-  -- the same column order (migrate-v32's table_info parity check).
   message_type      TEXT CHECK(message_type IN ('batch'))
 );
 CREATE INDEX IF NOT EXISTS idx_team_chat_log_root_time
   ON team_chat_log(root_teamfile, created_at);
 
--- Per-mailbox durable watermark for daemon team_chat_log pushes. First-ever
--- start seeds this at current MAX(team_chat_log.id) to skip historic backlog;
--- subsequent restarts resume from the last successfully published id.
 CREATE TABLE IF NOT EXISTS team_chat_log_cursor (
   cursor_key     TEXT PRIMARY KEY,
   last_pushed_id INTEGER NOT NULL,
   updated_at     TEXT NOT NULL
 );
 
--- v36: client-side S3 usage metering — per-device monthly op counts for quota.
 CREATE TABLE IF NOT EXISTS usage_meter (
   user_id    TEXT NOT NULL,
   device_id  TEXT NOT NULL,
@@ -645,7 +533,6 @@ CREATE TABLE IF NOT EXISTS usage_meter (
   PRIMARY KEY(user_id, device_id, period)
 );
 
--- Per-receiver in-flight marker for single-sender serialization (§5)
 CREATE TABLE IF NOT EXISTS agent_inflight (
   receiver_teamfile TEXT NOT NULL,
   receiver_alias    TEXT NOT NULL,
@@ -657,9 +544,6 @@ CREATE TABLE IF NOT EXISTS agent_inflight (
   PRIMARY KEY(receiver_teamfile, receiver_alias)
 );
 
--- v40: tracked background delegation substrate. Inert until the later
--- Legacy/dormant tracked background delegation tables. Kept for existing DB
--- compatibility; current tracked wakeup uses tracked_invocation.
 CREATE TABLE IF NOT EXISTS delegation_job (
   id                INTEGER PRIMARY KEY AUTOINCREMENT,
   teamfile          TEXT NOT NULL,
@@ -700,7 +584,6 @@ CREATE TABLE IF NOT EXISTS delegation_event (
 CREATE INDEX IF NOT EXISTS idx_delegation_event_job_id
   ON delegation_event(delegation_job_id, id);
 
--- v43: generic runtime checkpoint substrate for meta-lead/toolkit state.
 CREATE TABLE IF NOT EXISTS runtime_state (
   scope      TEXT NOT NULL,
   key        TEXT NOT NULL,
@@ -710,7 +593,6 @@ CREATE TABLE IF NOT EXISTS runtime_state (
   PRIMARY KEY(scope, key, kind)
 );
 
--- v44: durable start/finish records for lmctl wait wake semantics.
 CREATE TABLE IF NOT EXISTS tracked_invocation (
   id                INTEGER PRIMARY KEY AUTOINCREMENT,
   kind              TEXT NOT NULL CHECK(kind IN ('chat', 'exec')),
@@ -738,13 +620,7 @@ CREATE TABLE IF NOT EXISTS tracked_invocation (
   notified_at       TEXT,
   launch_source     TEXT,
   request_payload   TEXT,
-  -- v58: dispatch-lineage edge for `lmctl running --tree` -- the id of the
-  -- tracked_invocation whose turn sent the message that triggered this one.
-  -- Null = a root (not itself triggered by another tracked turn).
   parent_invocation_id INTEGER,
-  -- v60 (task #232): JSON array of human-readable strings when this turn's
-  -- provider silently dropped a declared model=/effort=. Null when the
-  -- provider honored its declared config (absence IS the signal).
   config_warnings TEXT
 );
 CREATE INDEX IF NOT EXISTS idx_tracked_invocation_status_started
@@ -756,20 +632,6 @@ CREATE INDEX IF NOT EXISTS idx_tracked_invocation_scope_status_started
 CREATE INDEX IF NOT EXISTS idx_tracked_invocation_status_ended
   ON tracked_invocation(status, ended_at);
 
--- v53: event-log message substrate (design:
--- backlog/DESIGN-event-log-message-substrate-DRAFT.md §2/§4; impl plan:
--- backlog/IMPL-PLAN-event-log-message-substrate.md Phase A). Additive only —
--- no existing read/write path changes in this phase.
---
--- message_event is the append-only log. `seq` (not `ts`) is the ordering
--- authority; `ts` is display/audit only. `event_id` is the idempotency key
--- and MUST be deterministic from intent (hash of stream_id + event_type +
--- observed projection last_seq — see src/db/event-log.ts), never a random
--- per-attempt id. The generated sender/receiver columns are load-bearing
--- (promoted from caveat by the low-level-primitives review): hot selectors
--- cannot index json_extract() directly; they populate on CREATE/
--- RESPONSE_CREATE payloads and are NULL for lease/invocation/terminal
--- streams (json_extract returns NULL on a missing path).
 CREATE TABLE IF NOT EXISTS message_event (
   seq         INTEGER PRIMARY KEY AUTOINCREMENT,
   event_id    TEXT NOT NULL UNIQUE,
@@ -787,12 +649,6 @@ CREATE INDEX IF NOT EXISTS idx_message_event_type   ON message_event(event_type,
 CREATE INDEX IF NOT EXISTS idx_message_event_sender   ON message_event(sender_teamfile, sender_alias, seq);
 CREATE INDEX IF NOT EXISTS idx_message_event_receiver ON message_event(receiver_teamfile, receiver_alias, seq);
 
--- Mutex + terminal occupancy projection. Will replace agent_inflight + the
--- terminal-lock slice of runtime_state at cutover (Phase D). PK is the
--- actual mutual-exclusion constraint. The terminal_invocation_* slice is
--- dual-written by terminal-kind INVOCATION_START/HEARTBEAT/FINISH events so
--- ALL THREE busy-check tiers resolve from this one row (the phantom-tolerant
--- invocation_state below is never read by the busy check).
 CREATE TABLE IF NOT EXISTS agent_state (
   receiver_teamfile TEXT NOT NULL,
   receiver_alias    TEXT NOT NULL,
@@ -814,9 +670,6 @@ CREATE TABLE IF NOT EXISTS agent_state (
   PRIMARY KEY(receiver_teamfile, receiver_alias)
 );
 
--- One row per undelivered/unhandled message. Will replace the
--- delivered_at/delivering_at slice of agent_mailbox. in_reply_to's UNIQUE
--- enforces "one response per request" at the schema level.
 CREATE TABLE IF NOT EXISTS message_pending (
   message_id        TEXT PRIMARY KEY,
   message_type      TEXT NOT NULL CHECK(message_type IN ('request','response')),
@@ -836,10 +689,6 @@ CREATE INDEX IF NOT EXISTS idx_message_pending_lane
                       receiver_alias, message_type, created_seq)
   WHERE lifecycle_state = 'queued';
 
--- Diagnostic/observability projection: "what is a process doing right now."
--- Deliberately separate from agent_state (two correctness regimes): rows here
--- are EXPECTED to go stale on hard kills (#88 capture gap) and are cleaned by
--- a reconciliation probe, never consulted by the busy check.
 CREATE TABLE IF NOT EXISTS invocation_state (
   invocation_id     TEXT PRIMARY KEY,
   kind              TEXT NOT NULL,
@@ -870,36 +719,18 @@ CREATE INDEX IF NOT EXISTS idx_invocation_state_target_status
 CREATE INDEX IF NOT EXISTS idx_invocation_state_from_time
   ON invocation_state(from_identity, started_at DESC);
 
--- v59: source-generation identity. A single-row, non-secret random id assigned
--- ONCE at migration time. Every lmctl-issued reference (invocation/provider-
--- session/mail ref) binds to it so a ref minted against one ledger can never
--- silently resolve against an unrelated or recovered one. The singleton CHECK
--- makes >1 row structurally impossible; the row itself is inserted by
--- migrate()'s ensureLedgerIdentity (fresh create AND upgrade paths).
--- DELIBERATELY EXCLUDED from the db-recovery salvage set (salvageEssentialConfig
--- copies only root_team + lmctl_config): a salvage-into-fresh-db is a NEW ledger
--- and must mint a NEW id; only a full-file backup restore retains this row.
 CREATE TABLE IF NOT EXISTS state_ledger_identity (
   singleton   INTEGER PRIMARY KEY CHECK (singleton = 1),
   instance_id TEXT NOT NULL,
   created_at  TEXT NOT NULL
 );
 
--- v61: schema metadata kv. Holds min_reader_version -- the oldest build
--- schema version that may safely open this db (batch redesign Landing A,
--- item 0). migrate()'s skew check refuses a newer db only when
--- min_reader_version exceeds the binary's CURRENT_USER_VERSION; a db without
--- the marker defaults to its raw user_version (strict, pre-v61 behavior).
--- v61 is purely additive, so its floor is 60. Additive migrations keep/lower
--- the floor (INSERT OR IGNORE); breaking ones raise it to their own version.
 CREATE TABLE IF NOT EXISTS schema_meta (
   key   TEXT PRIMARY KEY,
   value TEXT NOT NULL
 );
 INSERT OR IGNORE INTO schema_meta (key, value) VALUES ('min_reader_version', '60');
 
--- v62: lmbee queue and task-linked chat storage. lmbee remains on its own DB;
--- no lmctl reader or writer uses these tables yet.
 CREATE TABLE IF NOT EXISTS queue(
   id INTEGER PRIMARY KEY,
   from_id TEXT NOT NULL,