ultra-builder-pro-cli 0.20.0 → 0.22.0

package/spec/schemas/change-delta.v1.schema.json

@@ -0,0 +1,153 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ultra-builder-pro.dev/schemas/change-delta.v1.schema.json",
+  "title": "Ultra Change delta v1",
+  "type": "object",
+  "required": [
+    "$schema",
+    "change_id",
+    "baseline_anchor",
+    "decisions",
+    "non_goals",
+    "acceptance",
+    "documentation_impact",
+    "unknowns",
+    "mutations"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "const": "ultra-change-delta-v1" },
+    "change_id": { "type": "string", "minLength": 1 },
+    "baseline_anchor": {
+      "type": "object",
+      "required": ["baseline_id", "repository_revision", "specs"],
+      "additionalProperties": false,
+      "properties": {
+        "baseline_id": { "type": "string", "minLength": 1 },
+        "repository_revision": { "type": ["string", "null"] },
+        "specs": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "required": ["path", "digest"],
+            "additionalProperties": false,
+            "properties": {
+              "path": { "type": "string", "minLength": 1 },
+              "digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+            }
+          }
+        }
+      }
+    },
+    "decisions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "summary"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-zA-Z0-9_\\-]+$" },
+          "summary": { "type": "string", "minLength": 1 },
+          "rationale": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "non_goals": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "acceptance": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "criterion", "verification"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-zA-Z0-9_\\-]+$" },
+          "criterion": { "type": "string", "minLength": 1 },
+          "verification": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "documentation_impact": {
+      "type": "object",
+      "required": ["status", "files", "rationale"],
+      "additionalProperties": false,
+      "properties": {
+        "status": { "enum": ["none", "required"] },
+        "files": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "rationale": { "type": "string", "minLength": 3 }
+      }
+    },
+    "unknowns": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "summary", "blocking"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-zA-Z0-9_\\-]+$" },
+          "summary": { "type": "string", "minLength": 1 },
+          "blocking": { "type": "boolean" }
+        }
+      }
+    },
+    "no_semantic_change_reason": { "type": "string", "minLength": 3 },
+    "mutations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "action",
+          "target_path",
+          "overlay_path",
+          "before_digest",
+          "after_digest",
+          "acceptance_refs",
+          "documentation_refs"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-zA-Z0-9_\\-]+$" },
+          "action": { "enum": ["add", "update"] },
+          "target_path": { "type": "string", "minLength": 1 },
+          "overlay_path": { "type": "string", "minLength": 1 },
+          "before_digest": {
+            "type": ["string", "null"],
+            "pattern": "^[0-9a-f]{64}$"
+          },
+          "after_digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+          "acceptance_refs": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "documentation_refs": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "mutations": { "maxItems": 0 }
+        }
+      },
+      "then": { "required": ["no_semantic_change_reason"] }
+    }
+  ]
+}

package/spec/schemas/context-file.v4.5.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://ultra-builder-pro.dev/spec/context-file.v4.5.schema.json",
   "title": "context-file projection (v4.5)",
-  "description": "Schema for the parsed representation of .ultra/tasks/contexts/task-*.md. The header is regenerated by the projector from state.db. Body sections are author-owned; status MUST NOT appear in body. Authority boundary: docs/DECISIONS.md.",
+  "description": "Schema for the parsed representation of .ultra/.runtime/projections/contexts/task-*.md. The file is regenerated by the projector from state.db and remains checkout-local. Authority boundary: docs/ARTIFACT-AUTHORITY.md.",
   "type": "object",
   "required": ["header", "body"],
   "additionalProperties": false,

package/spec/schemas/documentation-reconciliation.v1.schema.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ultra-builder-pro.dev/schemas/documentation-reconciliation.v1.schema.json",
+  "title": "Ultra documentation reconciliation v1",
+  "type": "object",
+  "required": [
+    "$schema",
+    "change_id",
+    "delta_artifact_id",
+    "delta_digest",
+    "documents"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "const": "ultra-documentation-reconciliation-v1" },
+    "change_id": { "type": "string", "minLength": 1 },
+    "delta_artifact_id": { "type": "string", "minLength": 1 },
+    "delta_digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "no_change_reason": { "type": "string", "minLength": 3 },
+    "documents": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "path",
+          "action",
+          "overlay_path",
+          "before_digest",
+          "after_digest",
+          "delta_refs",
+          "acceptance_refs",
+          "verification",
+          "consumers"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "action": { "enum": ["add", "update"] },
+          "overlay_path": { "type": "string", "minLength": 1 },
+          "before_digest": {
+            "type": ["string", "null"],
+            "pattern": "^[0-9a-f]{64}$"
+          },
+          "after_digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+          "delta_refs": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "acceptance_refs": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "verification": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "required": ["command", "status", "evidence_refs"],
+              "additionalProperties": false,
+              "properties": {
+                "command": { "type": "string", "minLength": 1 },
+                "status": { "const": "pass" },
+                "evidence_refs": {
+                  "type": "array",
+                  "minItems": 1,
+                  "uniqueItems": true,
+                  "items": { "type": "string", "minLength": 1 }
+                }
+              }
+            }
+          },
+          "consumers": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["type", "id", "relation"],
+              "additionalProperties": false,
+              "properties": {
+                "type": {
+                  "enum": ["artifact", "project", "baseline", "change", "task", "workflow", "external"]
+                },
+                "id": { "type": "string", "minLength": 1 },
+                "relation": { "type": "string", "minLength": 1 }
+              }
+            }
+          },
+          "no_consumer_reason": { "type": "string", "minLength": 3 }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "documents": { "maxItems": 0 }
+        }
+      },
+      "then": { "required": ["no_change_reason"] }
+    }
+  ]
+}

package/spec/schemas/mcp-tools.schema.json

@@ -60,7 +60,7 @@
         },
         "family": {
           "type": "string",
-          "enum": ["task", "memory", "review", "impact", "skill", "session", "ask", "plan", "baseline", "change", "decision", "workflow", "system"]
+          "enum": ["task", "memory", "review", "impact", "skill", "session", "ask", "plan", "baseline", "change", "decision", "workflow", "artifact", "system"]
         },
         "description": { "type": "string", "minLength": 10 },
         "phase": {

package/spec/schemas/state-db.sql

@@ -1,5 +1,5 @@
 -- Ultra Builder Pro — authoritative state schema
--- This file builds .ultra/state.db, the source of truth for all
+-- This file builds .ultra/.runtime/state.db, the source of truth for all
 -- baseline / change / task / session / event / telemetry data. tasks.json and context md status
 -- headers are projections.
 --
@@ -15,7 +15,7 @@
 -- ──────────────────────────── project baseline ─────────────────────────────
 -- The baseline is the approved, repository-scoped snapshot that every change
 -- is measured against. It stores digests and evidence references, never source,
--- prompt, transcript, memory, or code-graph payloads.
+-- prompt, transcript, general memory-provider, or code-graph payloads.
 CREATE TABLE IF NOT EXISTS baselines (
   id                  TEXT PRIMARY KEY,
   project_name        TEXT NOT NULL,
@@ -105,7 +105,7 @@ CREATE TABLE IF NOT EXISTS tasks (
   docs_impact_json  TEXT NOT NULL DEFAULT '{"status":"unknown","files":[],"rationale":null}',
   ownership_json    TEXT NOT NULL DEFAULT '{}',
   context_file      TEXT,                -- projection target path
-  completion_commit TEXT,                -- backfilled hash (Phase 2.8)
+  completion_commit TEXT,                -- checkout-local integrated commit evidence
   change_id         TEXT REFERENCES changes(id) ON DELETE SET NULL,
   parent_id         TEXT REFERENCES tasks(id) ON DELETE SET NULL,  -- Phase 8A.1: task.expand subtask→parent
   created_at        TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
@@ -159,6 +159,8 @@ CREATE TABLE IF NOT EXISTS sessions (
 
 CREATE INDEX IF NOT EXISTS sessions_active ON sessions(status, task_id);
 CREATE INDEX IF NOT EXISTS sessions_lease  ON sessions(lease_expires_at) WHERE status = 'running';
+CREATE UNIQUE INDEX IF NOT EXISTS sessions_one_active_task
+  ON sessions(task_id) WHERE status = 'running';
 
 -- ──────────────────────────── schema_version ──────────────────────────────
 -- Cross-version misread guard (D30, R27). Single row per applied version.
@@ -225,20 +227,51 @@ CREATE INDEX IF NOT EXISTS circuit_breaker_tripped ON circuit_breaker(tripped_at
 
 -- ──────────────────────────── change artifacts ────────────────────────────
 CREATE TABLE IF NOT EXISTS artifacts (
-  id            TEXT PRIMARY KEY,
-  change_id     TEXT NOT NULL REFERENCES changes(id) ON DELETE CASCADE,
-  task_id       TEXT REFERENCES tasks(id) ON DELETE SET NULL,
-  kind          TEXT NOT NULL,
-  path          TEXT NOT NULL,
-  content_hash  TEXT,
-  metadata_json TEXT,
-  status        TEXT NOT NULL DEFAULT 'current' CHECK (status IN ('current', 'archived')),
-  created_at    TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
-  updated_at    TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
-  UNIQUE(change_id, kind, path)
+  id              TEXT PRIMARY KEY,
+  owner_type      TEXT NOT NULL
+                    CHECK (owner_type IN ('project', 'baseline', 'change', 'task', 'workflow')),
+  owner_id        TEXT NOT NULL,
+  change_id       TEXT REFERENCES changes(id) ON DELETE SET NULL,
+  task_id         TEXT REFERENCES tasks(id) ON DELETE SET NULL,
+  kind            TEXT NOT NULL,
+  path            TEXT NOT NULL,
+  digest          TEXT,
+  content_hash    TEXT,
+  before_digest   TEXT,
+  after_digest    TEXT,
+  provenance_json TEXT NOT NULL DEFAULT '{}',
+  metadata_json   TEXT,
+  managed         INTEGER NOT NULL DEFAULT 0 CHECK (managed IN (0, 1)),
+  status          TEXT NOT NULL DEFAULT 'current'
+                    CHECK (status IN ('current', 'stale', 'terminal', 'archived')),
+  created_at      TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  updated_at      TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  UNIQUE(owner_type, owner_id, kind, path)
 );
 
 CREATE INDEX IF NOT EXISTS artifacts_change ON artifacts(change_id, kind);
+CREATE INDEX IF NOT EXISTS artifacts_owner ON artifacts(owner_type, owner_id, status);
+CREATE INDEX IF NOT EXISTS artifacts_path ON artifacts(path, status);
+CREATE UNIQUE INDEX IF NOT EXISTS artifacts_one_active_path
+  ON artifacts(path) WHERE status <> 'archived';
+
+CREATE TABLE IF NOT EXISTS artifact_edges (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  source_type TEXT NOT NULL
+                CHECK (source_type IN ('artifact', 'project', 'baseline', 'change', 'task', 'workflow', 'external')),
+  source_id   TEXT NOT NULL,
+  target_type TEXT NOT NULL
+                CHECK (target_type IN ('artifact', 'project', 'baseline', 'change', 'task', 'workflow', 'external')),
+  target_id   TEXT NOT NULL,
+  relation    TEXT NOT NULL,
+  created_at  TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  UNIQUE(source_type, source_id, target_type, target_id, relation)
+);
+
+CREATE INDEX IF NOT EXISTS artifact_edges_source
+  ON artifact_edges(source_type, source_id);
+CREATE INDEX IF NOT EXISTS artifact_edges_target
+  ON artifact_edges(target_type, target_id);
 
 CREATE TABLE IF NOT EXISTS context_snapshots (
   id                 TEXT PRIMARY KEY,
@@ -265,6 +298,8 @@ CREATE TABLE IF NOT EXISTS context_snapshots (
 );
 
 CREATE INDEX IF NOT EXISTS context_snapshots_change ON context_snapshots(change_id, created_at);
+CREATE INDEX IF NOT EXISTS context_snapshots_binding
+  ON context_snapshots(change_id, task_id, role, gate, created_at);
 
 CREATE TABLE IF NOT EXISTS spec_learning_candidates (
   id            TEXT PRIMARY KEY,
@@ -495,3 +530,5 @@ INSERT OR IGNORE INTO schema_version (version, description)
 VALUES ('18.0', 'Adaptive capability transitions, independent initialization, and recoverable workflow migration');
 INSERT OR IGNORE INTO schema_version (version, description)
 VALUES ('19.0', 'Non-ceremonial decision completion and host-neutral intent persistence');
+INSERT OR IGNORE INTO schema_version (version, description)
+VALUES ('20.0', 'Typed artifact registry, normalized dependency edges, and orphan diagnostics');

package/spec/schemas/task-ledger.v1.schema.json

@@ -0,0 +1,217 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ultra-builder-pro.dev/spec/task-ledger.v1.schema.json",
+  "title": "Ultra team task ledger v1",
+  "description": "Git-facing checkpoint ledger for durable task contracts and statuses. Live sessions, leases, worktrees, and in-progress ownership remain in .ultra/.runtime/state.db.",
+  "type": "object",
+  "required": [
+    "kind",
+    "schema_version",
+    "generation",
+    "parent_digest",
+    "ancestors",
+    "state_digest",
+    "published_at",
+    "reason",
+    "baseline",
+    "changes",
+    "tasks"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "kind": { "const": "ultra-team-task-ledger" },
+    "schema_version": { "const": "1.0" },
+    "generation": { "type": "integer", "minimum": 0 },
+    "parent_digest": {
+      "type": ["string", "null"],
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "ancestors": {
+      "type": "array",
+      "maxItems": 64,
+      "items": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+    },
+    "state_digest": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "published_at": {
+      "type": ["string", "null"],
+      "format": "date-time"
+    },
+    "reason": { "type": "string", "minLength": 1 },
+    "baseline": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/baseline" }
+      ]
+    },
+    "changes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "title",
+          "kind",
+          "status",
+          "intent",
+          "artifact_root",
+          "revision",
+          "parent_digest",
+          "digest"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string" },
+          "title": { "type": "string", "minLength": 1 },
+          "kind": { "type": "string", "enum": ["quick", "standard", "major", "incident"] },
+          "status": { "type": "string", "enum": ["active", "blocked", "ready", "archived", "cancelled"] },
+          "intent": { "type": "string", "minLength": 1 },
+          "docs_impact": { "type": "object" },
+          "provider_refs": { "type": "object" },
+          "baseline_bypass": { "type": "object" },
+          "contract": { "type": "object" },
+          "classification": { "type": "object" },
+          "research_disposition": { "type": "object" },
+          "base_commit": { "type": "string" },
+          "artifact_root": { "type": "string", "minLength": 1 },
+          "closed_at": { "type": "string" },
+          "revision": { "type": "integer", "minimum": 1 },
+          "parent_digest": {
+            "type": ["string", "null"],
+            "pattern": "^[0-9a-f]{64}$"
+          },
+          "digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+        }
+      }
+    },
+    "tasks": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/task" }
+    }
+  },
+  "$defs": {
+    "baseline": {
+      "type": "object",
+      "required": [
+        "id",
+        "project_name",
+        "mode",
+        "status",
+        "scope",
+        "worktree_accepted",
+        "known_red_accepted",
+        "spec_refs",
+        "evidence",
+        "verification",
+        "unknowns",
+        "gaps",
+        "classification",
+        "provider_refs",
+        "revision",
+        "parent_digest",
+        "digest"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "project_name": { "type": "string", "minLength": 1 },
+        "project_type": { "type": "string" },
+        "stack": { "type": "string" },
+        "mode": {
+          "type": "string",
+          "enum": ["greenfield", "brownfield", "migrated"]
+        },
+        "status": {
+          "type": "string",
+          "enum": ["draft", "adopting", "blocked", "ready"]
+        },
+        "scope": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "repository_revision": { "type": "string" },
+        "repository_branch": { "type": "string" },
+        "worktree_state": { "type": "string" },
+        "worktree_digest": { "type": "string" },
+        "worktree_accepted": { "type": "boolean" },
+        "known_red_accepted": { "type": "boolean" },
+        "spec_refs": { "type": "array" },
+        "evidence": { "type": "array" },
+        "verification": { "type": "array" },
+        "unknowns": { "type": "array" },
+        "gaps": { "type": "array" },
+        "classification": { "type": "object" },
+        "provider_refs": { "type": "object" },
+        "research_run_id": { "type": "string" },
+        "approved_by": { "type": "string" },
+        "approval_note": { "type": "string" },
+        "converged_at": { "type": "string" },
+        "revision": { "type": "integer", "minimum": 1 },
+        "parent_digest": {
+          "type": ["string", "null"],
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+      }
+    },
+    "task": {
+      "type": "object",
+      "required": [
+        "id",
+        "title",
+        "type",
+        "priority",
+        "status",
+        "deps",
+        "files_modified",
+        "stale",
+        "acceptance",
+        "context_refs",
+        "docs_impact",
+        "ownership",
+        "revision",
+        "parent_digest",
+        "digest"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-zA-Z0-9_\\-]+$" },
+        "title": { "type": "string", "minLength": 3 },
+        "type": { "type": "string", "enum": ["architecture", "feature", "bugfix"] },
+        "priority": { "type": "string", "enum": ["P0", "P1", "P2", "P3"] },
+        "complexity": { "type": "integer", "minimum": 1, "maximum": 10 },
+        "estimated_days": { "type": "number", "exclusiveMinimum": 0 },
+        "status": {
+          "type": "string",
+          "enum": ["pending", "completed", "blocked", "expanded"]
+        },
+        "deps": { "type": "array", "items": { "type": "string" } },
+        "files_modified": { "type": "array", "items": { "type": "string" } },
+        "stale": { "type": "boolean" },
+        "trace_to": { "type": "string" },
+        "outcome": { "type": "string" },
+        "slice_kind": {
+          "type": "string",
+          "enum": ["tracer_bullet", "expand_contract", "integration_checkpoint"]
+        },
+        "public_seam": { "type": "string" },
+        "verification_command": { "type": "string" },
+        "acceptance": { "type": "array", "items": { "type": "object" } },
+        "context_refs": { "type": "array", "items": { "type": "object" } },
+        "docs_impact": { "type": "object" },
+        "ownership": { "type": "object" },
+        "change_id": { "type": "string" },
+        "parent_id": { "type": "string" },
+        "revision": { "type": "integer", "minimum": 1 },
+        "parent_digest": {
+          "type": ["string", "null"],
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+      }
+    }
+  }
+}

package/spec/schemas/tasks.v4.5.schema.json

@@ -9,7 +9,7 @@
   "properties": {
     "schema_version": { "const": "4.5" },
     "generated_at":   { "type": "string", "format": "date-time" },
-    "source":         { "const": ".ultra/state.db", "description": "authoritative source (D32)" },
+    "source":         { "const": ".ultra/.runtime/state.db", "description": "authoritative source (D32)" },
     "tasks": {
       "type": "array",
       "items": { "$ref": "#/$defs/task" }

package/ultra-tools/cli.cjs

@@ -17,6 +17,7 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
+const runtimePaths = require('../mcp-server/lib/runtime-paths.cjs');
 
 const VERSION = (() => {
   try {
@@ -38,7 +39,7 @@ SUBCOMMANDS:
   system    doctor [--repair] | restore | rebaseline
   status    [--cost] [--since <duration>] [--json]
   db        init | checkpoint | vacuum | integrity | backup (Phase 2)
-  migrate   --from=<4.4|4.5> --to=<4.5|19.0> [--dry|--rollback]
+  migrate   --from=<4.4|4.5> --to=<4.5|20.0> [--dry|--rollback]
   legacy-memory inspect | archive | prune --confirm DELETE_ULTRA_LEGACY_MEMORY
 
   --help / -h      show this message
@@ -75,7 +76,7 @@ const TELEMETRY_SUBCOMMANDS = new Set(['session']);
 
 function emitCliTelemetry(sub, rest) {
   try {
-    const dbPath = path.resolve('.ultra', 'state.db');
+    const dbPath = runtimePaths.locateStateDb(process.cwd());
     if (!fs.existsSync(dbPath)) return;
     const Database = require('better-sqlite3');
     const db = new Database(dbPath);