@lmctl-ai/lmctl 0.1.0

package/dist/cli/schema.sql

@@ -0,0 +1,660 @@
+-- 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,
+  version                   INTEGER NOT NULL DEFAULT 1,
+  definition_schema_version INTEGER NOT NULL DEFAULT 1,
+  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),
+  version     INTEGER NOT NULL,
+  definition  TEXT NOT NULL,
+  author      TEXT,
+  created_at  TEXT NOT NULL,
+  UNIQUE(workflow_id, 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,
+  created_at       TEXT NOT NULL
+);
+
+CREATE TABLE team_member (
+  id               INTEGER PRIMARY KEY AUTOINCREMENT,
+  team_id          INTEGER NOT NULL REFERENCES team(id),
+  alias            TEXT NOT NULL,
+  role             TEXT NOT NULL DEFAULT 'agent',
+  provider         TEXT NOT NULL,
+  model            TEXT,
+  sessionid        TEXT,
+  sessiondir       TEXT NOT NULL,
+  state            TEXT NOT NULL DEFAULT 'idle' CHECK(state IN ('idle','in_chat','attention_needed','retired')),
+  state_reason     TEXT,
+  state_updated_at TEXT,
+  role_prompt      TEXT,
+  prompt_snapshot  TEXT,
+  provider_resolved TEXT,
+  created_at       TEXT NOT NULL,
+  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),
+  companion_id    INTEGER NOT NULL REFERENCES team_member(id),
+  created_at      TEXT NOT NULL,
+  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,
+  description       TEXT,
+  local_path        TEXT NOT NULL,
+  workflow_name     TEXT NOT NULL,
+  team_id           INTEGER NOT NULL REFERENCES team(id),
+  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),
+  workflow_id         INTEGER NOT NULL REFERENCES workflow(id),
+  condition           TEXT,
+  parameters_override TEXT,
+  enabled             INTEGER NOT NULL DEFAULT 1 CHECK(enabled IN (0,1)),
+  priority            INTEGER NOT NULL DEFAULT 100,
+  created_at          TEXT NOT NULL,
+  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),
+  title              TEXT NOT NULL,
+  body               TEXT NOT NULL,
+  status             TEXT NOT NULL DEFAULT 'open' CHECK(status IN ('open','assigned','closed','reopened')),
+  severity           TEXT NOT NULL DEFAULT 'medium' CHECK(severity IN ('low','medium','high','critical')),
+  labels             TEXT,
+  ai_test_path       TEXT,
+  source_run_id      INTEGER REFERENCES run(id),
+  assigned_run_id    INTEGER REFERENCES run(id),
+  closed_run_id      INTEGER REFERENCES run(id),
+  commit_hash        TEXT,
+  created_at         TEXT NOT NULL,
+  updated_at         TEXT NOT NULL,
+  closed_at          TEXT
+);
+
+-- Jobs: SQLite-backed queue.
+CREATE TABLE job (
+  id              INTEGER PRIMARY KEY AUTOINCREMENT,
+  project_id      INTEGER NOT NULL REFERENCES project(id),
+  workflow_id_override INTEGER REFERENCES workflow(id),
+  source          TEXT NOT NULL,
+  source_ref      TEXT,
+  payload         TEXT,
+  status          TEXT NOT NULL DEFAULT 'queued',
+  priority        INTEGER NOT NULL DEFAULT 0,
+  available_at    TEXT NOT NULL,
+  locked_by       TEXT,
+  locked_until    TEXT,
+  attempt_count   INTEGER NOT NULL DEFAULT 0,
+  last_error      TEXT,
+  dedupe_key      TEXT,
+  concurrency_key_resolved TEXT,
+  enqueued_at     TEXT NOT NULL,
+  started_at      TEXT,
+  ended_at        TEXT,
+  run_id          INTEGER REFERENCES run(id),
+  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),
+  workflow_id     INTEGER NOT NULL REFERENCES workflow(id),
+  team_id         INTEGER NOT NULL REFERENCES team(id),
+  current_state   TEXT,
+  terminal_state  TEXT,
+  workflow_version_id INTEGER REFERENCES workflow_version(id),
+  started_at      TEXT NOT NULL,
+  ended_at        TEXT,
+  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),
+  parent_step_id  INTEGER REFERENCES step(id),
+  state_name      TEXT NOT NULL,
+  outcome         TEXT,
+  status_detail   TEXT,
+  started_at      TEXT NOT NULL,
+  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),
+  trigger_id      TEXT NOT NULL,
+  trigger_type    TEXT NOT NULL,
+  parameters      TEXT NOT NULL,
+  enabled         INTEGER NOT NULL DEFAULT 1 CHECK(enabled IN (0,1)),
+  cursor          TEXT,
+  last_poll_at    TEXT,
+  last_failure_at TEXT,
+  last_failure    TEXT,
+  created_at      TEXT NOT NULL,
+  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),
+  kind               TEXT NOT NULL,
+  path               TEXT,
+  content            TEXT,
+  sha                TEXT,
+  provider_call_mode TEXT,
+  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,
+  provider        TEXT NOT NULL,
+  project_id      INTEGER NOT NULL REFERENCES project(id),
+  run_id          INTEGER REFERENCES run(id),
+  external_id     TEXT NOT NULL,
+  url             TEXT,
+  status          TEXT,
+  metadata        TEXT,
+  last_seen_at    TEXT,
+  created_at      TEXT NOT NULL,
+  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),
+  kind          TEXT NOT NULL,
+  source        TEXT,
+  occurred_at   TEXT,
+  payload       TEXT,
+  signal_hash   TEXT,
+  handled_at    TEXT,
+  created_at    TEXT NOT NULL,
+  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,
+  severity            TEXT,
+  project_id          INTEGER REFERENCES project(id),
+  run_id              INTEGER REFERENCES run(id),
+  external_object_id  INTEGER REFERENCES external_object(id),
+  requires_user       INTEGER NOT NULL DEFAULT 0,
+  payload             TEXT,
+  created_at          TEXT NOT NULL,
+  acknowledged_at     TEXT
+);
+
+CREATE TABLE session_size (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  team_name     TEXT NOT NULL,
+  alias         TEXT NOT NULL,
+  sessionid     TEXT NOT NULL,
+  input_tokens  INTEGER,
+  cache_tokens  INTEGER,
+  output_tokens INTEGER,
+  total_tokens  INTEGER,
+  observed_at   TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_job_status_avail   ON job(status, available_at);
+CREATE INDEX IF NOT EXISTS idx_job_dedupe         ON job(source, dedupe_key);
+CREATE INDEX IF NOT EXISTS idx_job_concurrency_running ON job(concurrency_key_resolved, status);
+CREATE INDEX IF NOT EXISTS idx_project_workflow_project ON project_workflow(project_id, enabled);
+CREATE INDEX IF NOT EXISTS idx_project_issue_status ON project_issue(project_id, status);
+CREATE INDEX IF NOT EXISTS idx_project_issue_ai_test ON project_issue(project_id, ai_test_path) WHERE ai_test_path IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_step_run_started   ON step(run_id, started_at);
+CREATE INDEX IF NOT EXISTS idx_step_parent        ON step(parent_step_id);
+CREATE INDEX IF NOT EXISTS idx_trigger_instance_wf      ON trigger_instance(workflow_id);
+CREATE INDEX IF NOT EXISTS idx_trigger_instance_enabled ON trigger_instance(enabled) WHERE enabled = 1;
+CREATE INDEX IF NOT EXISTS idx_extobj_run         ON external_object(run_id, type);
+CREATE INDEX IF NOT EXISTS idx_extobj_unhandled   ON external_object(project_id, status, last_seen_at);
+CREATE INDEX IF NOT EXISTS idx_extsig_unhandled   ON external_signal(object_id, kind, handled_at);
+CREATE INDEX IF NOT EXISTS idx_attention_unacked  ON attention(kind, acknowledged_at);
+CREATE INDEX IF NOT EXISTS idx_session_size_member   ON session_size(team_name, alias, observed_at DESC);
+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),
+  repo            TEXT NOT NULL,
+  issue_url       TEXT NOT NULL,
+  issue_number    INTEGER NOT NULL,
+  title           TEXT,
+  status          TEXT NOT NULL,
+  reason          TEXT,
+  confidence      REAL,
+  local_path      TEXT,
+  likely_files    TEXT,
+  test_command    TEXT,
+  lmdedup_summary TEXT,
+  created_at      TEXT NOT NULL,
+  approved_at     TEXT,
+  fix_job_id      INTEGER REFERENCES job(id),
+  UNIQUE(triage_run_id, issue_url)
+);
+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,
+  pr_url                  TEXT NOT NULL UNIQUE,
+  issue_url               TEXT,
+  local_path              TEXT,
+  branch                  TEXT,
+  head_sha                TEXT,
+  status                  TEXT NOT NULL DEFAULT 'watching',
+  submitted_at            TEXT NOT NULL,
+  last_scanned_at         TEXT,
+  last_followup_at        TEXT,
+  last_known_state        TEXT,
+  last_known_checks       TEXT,
+  last_known_review       TEXT,
+  visibility_status       TEXT,
+  created_by_run_id       INTEGER REFERENCES run(id)
+);
+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),
+  run_id          INTEGER REFERENCES run(id),
+  event_kind      TEXT NOT NULL,
+  source_url      TEXT,
+  actor           TEXT,
+  author_association TEXT,
+  body_hash       TEXT,
+  classification  TEXT,
+  action_required TEXT,
+  created_at      TEXT NOT NULL,
+  seen_at         TEXT,
+  resolved_at     TEXT,
+  UNIQUE(submitted_pr_id, body_hash)
+);
+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),
+  type        TEXT NOT NULL CHECK (type IN ('user', 'feedback', 'project', 'reference')),
+  name        TEXT NOT NULL,
+  description TEXT,
+  body        TEXT NOT NULL,
+  created_at  TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at  TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE(project_id, name)
+);
+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),
+  step_id              INTEGER REFERENCES step(id),
+  kind                 TEXT NOT NULL,
+  timestamp_ms         INTEGER NOT NULL,
+  payload              TEXT NOT NULL,
+  payload_truncated    INTEGER NOT NULL DEFAULT 0,
+  overflow_artifact_id INTEGER REFERENCES step_artifact(id)
+);
+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),
+  step_id         INTEGER REFERENCES step(id),
+  metric_kind     TEXT NOT NULL,
+  value           REAL NOT NULL,
+  bucket_start_ms INTEGER NOT NULL,
+  bucket_end_ms   INTEGER NOT NULL,
+  updated_at      INTEGER NOT NULL,
+  UNIQUE(run_id, step_id, metric_kind, bucket_start_ms)
+);
+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),
+  project_id      INTEGER REFERENCES project(id),
+  signal_kind     TEXT NOT NULL,
+  severity        TEXT NOT NULL CHECK (severity IN ('low', 'medium', 'high')),
+  description     TEXT NOT NULL,
+  detected_at     INTEGER NOT NULL,
+  expires_at      INTEGER,
+  acknowledged_at INTEGER,
+  payload         TEXT
+);
+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),
+  step_id             INTEGER NOT NULL REFERENCES step(id),
+  state_name          TEXT NOT NULL,
+  turn_count          INTEGER NOT NULL DEFAULT 0,
+  last_agent_output   TEXT,
+  last_operator_input TEXT,
+  status              TEXT NOT NULL CHECK (status IN ('waiting_operator', 'waiting_agent', 'done', 'timeout')),
+  started_at          INTEGER NOT NULL,
+  last_activity_at    INTEGER NOT NULL,
+  UNIQUE(step_id)
+);
+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,
+  current_node       TEXT NOT NULL,
+  node_params        TEXT,
+  prev_node_stack    TEXT,
+  pending_form       TEXT,
+  chatbot_session_id TEXT,
+  auth_state         TEXT NOT NULL,
+  last_transition_at TEXT NOT NULL,
+  created_at         TEXT NOT NULL
+);
+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,
+  title              TEXT,
+  created_at         TEXT NOT NULL,
+  last_active_at     TEXT NOT NULL,
+  status             TEXT NOT NULL DEFAULT 'active'
+);
+CREATE INDEX IF NOT EXISTS chatbot_session_user_idx ON chatbot_session(user_id, last_active_at DESC);
+
+CREATE TABLE IF NOT EXISTS chatbot_message (
+  id                 INTEGER PRIMARY KEY AUTOINCREMENT,
+  chatbot_session_id TEXT NOT NULL REFERENCES chatbot_session(chatbot_session_id) ON DELETE CASCADE,
+  role               TEXT NOT NULL,
+  content            TEXT NOT NULL,
+  tool_calls         TEXT,
+  created_at         TEXT NOT NULL
+);
+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,
+  version                      INTEGER NOT NULL,
+  lang                         TEXT NOT NULL,
+  source                       TEXT NOT NULL,
+  source_sha                   TEXT NOT NULL,
+  compiled_workflow_version_id INTEGER REFERENCES workflow_version(id),
+  created_at                   TEXT NOT NULL,
+  UNIQUE(name, version)
+);
+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),
+  job_id       INTEGER NOT NULL REFERENCES job(id),
+  text         TEXT NOT NULL,
+  context_json TEXT,
+  created_at   TEXT NOT NULL,
+  completed_at TEXT
+);
+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,
+  idle_threshold_ms   INTEGER NOT NULL DEFAULT 600000,
+  created_at          TEXT NOT NULL,
+  deleted_at          TEXT
+);
+
+CREATE TABLE IF NOT EXISTS web_project (
+  id                     INTEGER PRIMARY KEY AUTOINCREMENT,
+  workspace_id           TEXT NOT NULL REFERENCES workspace(id),
+  name                   TEXT NOT NULL,
+  repo_path              TEXT NOT NULL,
+  config_json            TEXT,
+  linked_v4_project_id   INTEGER REFERENCES project(id),
+  last_active_at         TEXT,
+  created_at             TEXT NOT NULL,
+  deleted_at             TEXT
+);
+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,
+  raw_text       TEXT NOT NULL,
+  raw_sha256     TEXT NOT NULL,
+  registered_at  TEXT NOT NULL,
+  last_seeded_at TEXT
+);
+
+-- Cross-team connection snapshot (from _CONNECT_), captured at seed
+CREATE TABLE IF NOT EXISTS team_connection (
+  id                  INTEGER PRIMARY KEY AUTOINCREMENT,
+  source_teamfile     TEXT NOT NULL,
+  target_name         TEXT NOT NULL,
+  target_teamfile     TEXT NOT NULL,
+  created_at          TEXT NOT NULL,
+  UNIQUE(source_teamfile, target_name)
+);
+
+-- One row per request->response exchange
+CREATE TABLE IF NOT EXISTS team_chat_log (
+  id                INTEGER PRIMARY KEY AUTOINCREMENT,
+  root_teamfile     TEXT NOT NULL,
+  sender_teamfile   TEXT NOT NULL,
+  sender_alias      TEXT NOT NULL,
+  receiver_teamfile TEXT NOT NULL,
+  receiver_alias    TEXT NOT NULL,
+  message           TEXT NOT NULL,
+  response          TEXT,
+  status            TEXT NOT NULL,
+  error_detail      TEXT,
+  truncated         INTEGER NOT NULL DEFAULT 0,
+  created_at        TEXT NOT NULL
+);
+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,
+  period     TEXT NOT NULL,
+  put_count  INTEGER NOT NULL DEFAULT 0,
+  get_count  INTEGER NOT NULL DEFAULT 0,
+  list_count INTEGER NOT NULL DEFAULT 0,
+  updated_at TEXT NOT NULL,
+  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,
+  sender_teamfile   TEXT NOT NULL,
+  sender_alias      TEXT NOT NULL,
+  started_at        TEXT NOT NULL,
+  active_count      INTEGER NOT NULL DEFAULT 1,
+  PRIMARY KEY(receiver_teamfile, receiver_alias)
+);

package/dist/cli/side_effect_classifier.json

@@ -0,0 +1,19 @@
+{
+  "rules": [
+    {
+      "command": "gh",
+      "argv_patterns": ["pr create", "pr comment", "pr close", "pr review", "pr edit", "pr merge"],
+      "kind": "github_pr_mutation"
+    },
+    {
+      "command": "gh",
+      "argv_patterns": ["issue comment", "issue close", "issue edit"],
+      "kind": "github_issue_mutation"
+    },
+    {
+      "command": "git",
+      "argv_patterns": ["push"],
+      "kind": "git_push"
+    }
+  ]
+}