@zq-silk/yui 0.16.1 → 1.0.0-alpha

package/dist/storage/baselineSchema.js

@@ -0,0 +1,606 @@
+/** Current Home schema. Fresh initialization executes this once; no historical DDL is replayed. */
+export const BASELINE_SCHEMA_SQL = String.raw `CREATE TABLE storage_schema (
+  id INTEGER PRIMARY KEY CHECK (id = 1),
+  format TEXT NOT NULL,
+  major INTEGER NOT NULL CHECK (major > 0),
+  minor INTEGER NOT NULL CHECK (minor >= 0),
+  checksum TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+
+CREATE TABLE active_turns (
+  task_id    TEXT NOT NULL,
+  pointer    TEXT NOT NULL,
+  turn_id    TEXT NOT NULL,
+  payload    TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (task_id, pointer)
+);
+
+CREATE TABLE agent_profiles (
+  id         TEXT PRIMARY KEY,
+  payload    TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE capability_grants (
+  task_id    TEXT NOT NULL,
+  grant_id   TEXT NOT NULL,
+  payload    TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (task_id, grant_id)
+);
+
+CREATE TABLE change_sets (
+  task_id       TEXT NOT NULL,
+  change_set_id TEXT NOT NULL,
+  project_id    TEXT NOT NULL,
+  head_sha      TEXT NOT NULL,
+  payload       TEXT NOT NULL,
+  created_at    TEXT NOT NULL,
+  PRIMARY KEY (task_id, change_set_id)
+);
+
+CREATE TABLE config (
+  id         INTEGER PRIMARY KEY CHECK (id = 1),
+  payload    TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE configured_agents (
+  id         TEXT PRIMARY KEY,
+  payload    TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE context_snapshots (
+  task_id     TEXT NOT NULL,
+  snapshot_id TEXT NOT NULL,
+  scope       TEXT NOT NULL CHECK (scope IN ('task','workitem','stage')),
+  scope_ref   TEXT,
+  sequence    INTEGER NOT NULL CHECK (sequence > 0),
+  digest      TEXT NOT NULL CHECK (length(digest) = 64),
+  payload     TEXT NOT NULL,
+  frozen_at   TEXT NOT NULL,
+  PRIMARY KEY (task_id, snapshot_id),
+  FOREIGN KEY (task_id) REFERENCES tasks_catalog(task_id) ON DELETE CASCADE,
+  CHECK ((scope = 'task' AND scope_ref IS NULL) OR (scope <> 'task' AND scope_ref IS NOT NULL))
+);
+
+CREATE TABLE decisions (
+  task_id     TEXT NOT NULL,
+  decision_id TEXT NOT NULL,
+  payload     TEXT NOT NULL,
+  created_at  TEXT NOT NULL,
+  PRIMARY KEY (task_id, decision_id)
+);
+
+CREATE TABLE durable_jobs (
+  job_id           TEXT NOT NULL,
+  task_id          TEXT NOT NULL,
+  idempotency_key  TEXT,
+  status           TEXT NOT NULL,
+  payload          TEXT NOT NULL,
+  created_at       TEXT NOT NULL,
+  updated_at       TEXT NOT NULL,
+  PRIMARY KEY (task_id, job_id)
+);
+
+CREATE TABLE environment_preparations (
+  task_id TEXT NOT NULL REFERENCES tasks_catalog(task_id),
+  id TEXT NOT NULL,
+  payload TEXT NOT NULL,
+  PRIMARY KEY (task_id, id)
+);
+
+CREATE TABLE events (
+  task_id     TEXT NOT NULL,
+  event_id    TEXT NOT NULL,
+  type        TEXT NOT NULL,
+  occurred_at TEXT NOT NULL,
+  payload     TEXT NOT NULL,
+  PRIMARY KEY (task_id, event_id)
+);
+
+CREATE TABLE gate_artifact_logs (
+  artifact_key  TEXT NOT NULL,
+  step_name     TEXT NOT NULL,
+  log_content   BLOB NOT NULL,
+  log_digest    TEXT NOT NULL,
+  log_bytes     INTEGER NOT NULL,
+  PRIMARY KEY (artifact_key, step_name),
+  FOREIGN KEY (artifact_key) REFERENCES gate_artifacts(key) ON DELETE CASCADE
+);
+
+CREATE TABLE gate_artifacts (
+  key               TEXT PRIMARY KEY,
+  project_id        TEXT NOT NULL,
+  level             TEXT NOT NULL CHECK (level IN ('L1','L2')),
+  commit_sha        TEXT NOT NULL,
+  plan_digest       TEXT NOT NULL,
+  toolchain_digest  TEXT NOT NULL,
+  target_ref        TEXT,
+  status            TEXT NOT NULL CHECK (status IN ('incomplete','complete')),
+  outcome           TEXT NOT NULL CHECK (outcome IN ('unknown','succeeded','failed')),
+  payload           TEXT NOT NULL,
+  created_at        TEXT NOT NULL,
+  completed_at      TEXT,
+  last_used_at      TEXT NOT NULL
+);
+
+CREATE TABLE global_role_messages (
+  name       TEXT NOT NULL,
+  message_id TEXT NOT NULL,
+  seq        INTEGER NOT NULL,
+  payload    TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  PRIMARY KEY (name, message_id),
+  FOREIGN KEY (name) REFERENCES global_roles(name)
+);
+
+CREATE TABLE global_role_session_sets (
+  name       TEXT PRIMARY KEY,
+  payload    TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (name) REFERENCES global_roles(name)
+);
+
+CREATE TABLE global_roles (
+  name       TEXT PRIMARY KEY,
+  payload    TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE global_sequences (
+  name       TEXT PRIMARY KEY,
+  high_water INTEGER NOT NULL
+);
+
+CREATE TABLE home_meta (
+  id            INTEGER PRIMARY KEY CHECK (id = 1),
+  home_identity TEXT NOT NULL,
+  revision      INTEGER NOT NULL,
+  created_at    TEXT NOT NULL,
+  updated_at    TEXT NOT NULL
+);
+
+CREATE TABLE id_sequences (
+  task_id    TEXT NOT NULL,
+  kind       TEXT NOT NULL,
+  high_water INTEGER NOT NULL,
+  PRIMARY KEY (task_id, kind)
+);
+
+CREATE TABLE input_requests (
+  task_id       TEXT NOT NULL,
+  input_id      TEXT NOT NULL,
+  status        TEXT NOT NULL,
+  blocks        TEXT,
+  payload       TEXT NOT NULL,
+  created_at    TEXT NOT NULL,
+  updated_at    TEXT NOT NULL,
+  PRIMARY KEY (task_id, input_id)
+);
+
+CREATE TABLE integration_attempts (
+  task_id        TEXT NOT NULL,
+  integration_id TEXT NOT NULL,
+  status         TEXT NOT NULL,
+  payload        TEXT NOT NULL,
+  updated_at     TEXT NOT NULL,
+  PRIMARY KEY (task_id, integration_id)
+);
+
+CREATE TABLE local_resources (
+  id TEXT PRIMARY KEY,
+  canonical_identity TEXT NOT NULL UNIQUE,
+  payload TEXT NOT NULL
+);
+
+CREATE TABLE mailboxes (
+  mailbox_id    INTEGER PRIMARY KEY,
+  target_kind   TEXT NOT NULL CHECK (target_kind IN
+                  ('task','role','role-runtime','global-role-runtime','operator')),
+  task_id       TEXT,
+  role_name     TEXT,
+  -- The stable mailboxTargetKey string carries the real uniqueness: the column
+  -- UNIQUE below cannot, because NULL task_id/role_name (the 'operator' and
+  -- 'global-role-runtime' targets) are distinct under SQL NULL semantics.
+  target_key    TEXT NOT NULL,
+  next_sequence INTEGER NOT NULL,
+  processing    TEXT,
+  pending       TEXT,
+  recent_dedupe_keys TEXT NOT NULL DEFAULT '[]',
+  UNIQUE (target_kind, task_id, role_name)
+);
+
+CREATE TABLE managed_workspaces (
+  owner_kind  TEXT NOT NULL CHECK (owner_kind IN
+                ('task','work-item','review-round','integration-attempt','execution-lane')),
+  owner_id    TEXT NOT NULL,
+  task_id     TEXT,
+  path        TEXT NOT NULL,
+  payload     TEXT NOT NULL,
+  status      TEXT NOT NULL,
+  created_at  TEXT NOT NULL,
+  updated_at  TEXT NOT NULL,
+  PRIMARY KEY (owner_kind, owner_id)
+);
+
+CREATE TABLE messages (
+  task_id    TEXT NOT NULL,
+  message_id TEXT NOT NULL,
+  seq        INTEGER NOT NULL,
+  payload    TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  PRIMARY KEY (task_id, message_id)
+);
+
+CREATE TABLE milestones (
+  task_id      TEXT NOT NULL,
+  milestone_id TEXT NOT NULL,
+  payload      TEXT NOT NULL,
+  created_at   TEXT NOT NULL,
+  PRIMARY KEY (task_id, milestone_id)
+);
+
+CREATE TABLE outbox (
+  outbox_id  INTEGER PRIMARY KEY,
+  request_id TEXT NOT NULL UNIQUE,
+  command    TEXT NOT NULL,
+  state      TEXT NOT NULL DEFAULT 'pending',
+  created_at TEXT NOT NULL,
+  applied_at TEXT
+);
+
+CREATE TABLE plugin_intents (
+  task_id TEXT NOT NULL REFERENCES tasks_catalog(task_id),
+  plugin_id TEXT NOT NULL,
+  payload TEXT NOT NULL,
+  PRIMARY KEY (task_id, plugin_id)
+);
+
+CREATE TABLE plugin_validations (
+  task_id TEXT NOT NULL REFERENCES tasks_catalog(task_id),
+  id TEXT NOT NULL,
+  payload TEXT NOT NULL,
+  PRIMARY KEY (task_id, id)
+);
+
+CREATE TABLE projects (
+  id         TEXT PRIMARY KEY,
+  name       TEXT NOT NULL,
+  path       TEXT NOT NULL,
+  payload    TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE publication_references (
+  task_id         TEXT NOT NULL,
+  publication_id  TEXT NOT NULL,
+  project_id      TEXT NOT NULL,
+  provider        TEXT NOT NULL,
+  repository      TEXT NOT NULL,
+  external_kind   TEXT NOT NULL,
+  external_id     TEXT NOT NULL,
+  external_key    TEXT NOT NULL,
+  state           TEXT NOT NULL,
+  verification    TEXT NOT NULL,
+  external_url    TEXT,
+  title           TEXT,
+  source_branch   TEXT,
+  target_branch   TEXT,
+  local_commit    TEXT,
+  remote_commit   TEXT,
+  supersedes      TEXT,
+  payload         TEXT NOT NULL,
+  merged_at       TEXT,
+  created_at      TEXT NOT NULL,
+  PRIMARY KEY (task_id, publication_id)
+);
+
+CREATE TABLE release_workflows (
+  task_id     TEXT NOT NULL,
+  workflow_id TEXT NOT NULL,
+  payload     TEXT NOT NULL,
+  updated_at  TEXT NOT NULL,
+  PRIMARY KEY (task_id, workflow_id)
+);
+
+CREATE TABLE resource_registry (
+  id          TEXT PRIMARY KEY,
+  kind        TEXT NOT NULL,
+  path        TEXT NOT NULL,
+  disposition TEXT NOT NULL,
+  task_id     TEXT,
+  payload     TEXT NOT NULL,
+  created_at  TEXT NOT NULL,
+  updated_at  TEXT NOT NULL
+);
+
+CREATE TABLE review_rounds (
+  task_id         TEXT NOT NULL,
+  review_round_id TEXT NOT NULL,
+  status          TEXT NOT NULL,
+  payload         TEXT NOT NULL,
+  updated_at      TEXT NOT NULL,
+  PRIMARY KEY (task_id, review_round_id)
+);
+
+CREATE TABLE role_session_sets (
+  task_id     TEXT NOT NULL,
+  role_name   TEXT NOT NULL,
+  payload     TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (task_id, role_name)
+);
+
+CREATE TABLE runtime_session_candidates (
+  scope TEXT NOT NULL CHECK(scope IN ('task','global')), task_id TEXT NOT NULL,
+  role_name TEXT NOT NULL, agent_id TEXT NOT NULL, adapter_id TEXT NOT NULL,
+  native_session_id TEXT NOT NULL, session_updated_at TEXT NOT NULL,
+  PRIMARY KEY(scope, task_id, role_name),
+  CHECK((scope = 'task' AND length(task_id) > 0) OR (scope = 'global' AND task_id = ''))
+);
+
+CREATE TABLE session_owners (
+  process_key TEXT PRIMARY KEY, scope TEXT NOT NULL CHECK(scope IN ('task','global')),
+  task_id TEXT, role_name TEXT NOT NULL, agent_id TEXT NOT NULL, native_session_id TEXT,
+  provider_root_pid INTEGER, payload TEXT NOT NULL, recorded_at TEXT NOT NULL
+);
+
+CREATE TABLE storage_migration_archive (
+  migration_version INTEGER NOT NULL,
+  family TEXT NOT NULL,
+  record_key TEXT NOT NULL,
+  payload TEXT NOT NULL,
+  content BLOB,
+  PRIMARY KEY (migration_version, family, record_key)
+);
+
+CREATE TABLE task_projections (
+  task_id    TEXT NOT NULL,
+  kind       TEXT NOT NULL CHECK (kind IN ('leader-failure','operator-notification')),
+  payload    TEXT,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (task_id, kind)
+);
+
+CREATE TABLE task_records (
+  task_id     TEXT PRIMARY KEY,
+  payload     TEXT NOT NULL,
+  brief       TEXT,
+  updated_at  TEXT NOT NULL,
+  FOREIGN KEY (task_id) REFERENCES tasks_catalog(task_id)
+);
+
+CREATE TABLE task_roles (
+  task_id     TEXT NOT NULL,
+  role_name   TEXT NOT NULL,
+  payload     TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (task_id, role_name)
+);
+
+CREATE TABLE task_wakes (
+  task_id     TEXT NOT NULL,
+  wake_id     TEXT NOT NULL,
+  seq         INTEGER NOT NULL,
+  status      TEXT NOT NULL CHECK (status IN ('dispatched','consumed')),
+  from_cursor TEXT NOT NULL,
+  to_cursor   TEXT NOT NULL,
+  reasons     TEXT NOT NULL,
+  payload     TEXT NOT NULL,
+  created_at  TEXT NOT NULL,
+  consumed_at TEXT,
+  PRIMARY KEY (task_id, wake_id)
+);
+
+CREATE TABLE tasks_catalog (
+  task_id     TEXT PRIMARY KEY,
+  status      TEXT NOT NULL,
+  lifecycle   TEXT NOT NULL,
+  is_active   INTEGER NOT NULL CHECK (is_active IN (0,1)),
+  created_at  TEXT NOT NULL,
+  updated_at  TEXT NOT NULL
+);
+
+CREATE TABLE telemetry (
+  task_id TEXT NOT NULL, role_name TEXT NOT NULL, turn_id TEXT NOT NULL,
+  progress_id TEXT NOT NULL, sequence INTEGER, payload TEXT NOT NULL,
+  received_at TEXT NOT NULL,
+  PRIMARY KEY (task_id, role_name, turn_id, progress_id)
+) WITHOUT ROWID;
+
+CREATE TABLE telemetry_aggregate (
+  task_id TEXT NOT NULL, role_name TEXT NOT NULL, turn_id TEXT NOT NULL,
+  first_at TEXT NOT NULL, last_at TEXT NOT NULL, count INTEGER NOT NULL,
+  max_sequence INTEGER, error_count INTEGER NOT NULL DEFAULT 0, updated_at TEXT NOT NULL,
+  PRIMARY KEY (task_id, role_name, turn_id)
+) WITHOUT ROWID;
+
+CREATE TABLE turns (
+  task_id    TEXT NOT NULL,
+  turn_id    TEXT NOT NULL,
+  role_name  TEXT NOT NULL,
+  status     TEXT NOT NULL,
+  payload    TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (task_id, turn_id)
+);
+
+CREATE TABLE work_items (
+  task_id      TEXT NOT NULL,
+  work_item_id TEXT NOT NULL,
+  status       TEXT NOT NULL,
+  payload      TEXT NOT NULL,
+  updated_at   TEXT NOT NULL,
+  PRIMARY KEY (task_id, work_item_id)
+);
+
+CREATE INDEX idx_change_sets_project ON change_sets(task_id, project_id);
+
+CREATE UNIQUE INDEX idx_context_snapshots_scope_sequence
+  ON context_snapshots(task_id, scope, COALESCE(scope_ref, ''), sequence);
+
+CREATE UNIQUE INDEX idx_durable_jobs_idempotency
+  ON durable_jobs(task_id, idempotency_key) WHERE idempotency_key IS NOT NULL;
+
+CREATE UNIQUE INDEX idx_durable_jobs_request
+ON durable_jobs(task_id, json_extract(payload, '$.operation.actorId'),
+  json_extract(payload, '$.operation.requestId'));
+
+CREATE INDEX idx_durable_jobs_status ON durable_jobs(status);
+
+CREATE INDEX idx_durable_jobs_task ON durable_jobs(task_id);
+
+CREATE INDEX idx_events_type_time ON events(task_id, type, occurred_at);
+
+CREATE INDEX idx_gate_artifacts_project_commit
+  ON gate_artifacts(project_id, commit_sha);
+
+CREATE INDEX idx_gate_artifacts_project_last_used
+  ON gate_artifacts(project_id, last_used_at);
+
+CREATE INDEX idx_global_provider_retry ON global_role_session_sets(
+  json_extract(payload, '$.providerBinding.retry.status')
+) WHERE json_extract(payload, '$.providerBinding.retry.status') IN ('waiting', 'in-flight');
+
+CREATE INDEX idx_global_role_messages_seq ON global_role_messages(name, seq);
+
+CREATE INDEX idx_input_requests_open_hot
+  ON input_requests(task_id, input_id)
+  WHERE status = 'open';
+
+CREATE INDEX idx_mailboxes_ready
+  ON mailboxes(target_key)
+  WHERE processing IS NOT NULL OR json_type(pending) <> 'null';
+
+CREATE UNIQUE INDEX idx_mailboxes_target_key
+  ON mailboxes(target_key);
+
+CREATE INDEX idx_messages_seq ON messages(task_id, seq);
+
+CREATE INDEX idx_outbox_state ON outbox(state, created_at);
+
+CREATE INDEX idx_publication_references_external
+  ON publication_references(external_key);
+
+CREATE UNIQUE INDEX idx_publication_references_external_root
+  ON publication_references(external_key) WHERE supersedes IS NULL;
+
+CREATE INDEX idx_publication_references_task
+  ON publication_references(task_id);
+
+CREATE INDEX idx_resource_registry_disposition
+  ON resource_registry(disposition);
+
+CREATE INDEX idx_resource_registry_task
+  ON resource_registry(task_id);
+
+CREATE INDEX idx_session_owners_task ON session_owners(task_id, role_name);
+
+CREATE INDEX idx_task_provider_retry ON role_session_sets(
+  json_extract(payload, '$.providerBinding.retry.status')
+) WHERE json_extract(payload, '$.providerBinding.retry.status') IN ('waiting', 'in-flight');
+
+CREATE INDEX idx_task_wakes_seq ON task_wakes(task_id, seq);
+
+CREATE INDEX idx_tasks_activation_pending ON task_records(task_id)
+  WHERE json_extract(payload, '$.activationRequest.disposition') = 'pending';
+
+CREATE INDEX idx_tasks_active ON tasks_catalog(is_active) WHERE is_active = 1;
+
+CREATE INDEX idx_telemetry_turn ON telemetry(task_id, turn_id);
+
+CREATE INDEX idx_turns_planning_active ON turns(task_id, turn_id)
+  WHERE status = 'active' AND json_extract(payload, '$.purpose') = 'planning';
+
+CREATE INDEX idx_turns_role_status ON turns(task_id, role_name, status);
+
+CREATE INDEX idx_work_items_status ON work_items(task_id, status);
+
+CREATE INDEX idx_workspaces_task ON managed_workspaces(task_id);
+
+CREATE TRIGGER telemetry_ai AFTER INSERT ON telemetry
+BEGIN
+  INSERT INTO telemetry_aggregate
+    (task_id, role_name, turn_id, first_at, last_at, count, max_sequence, error_count, updated_at)
+  VALUES (NEW.task_id, NEW.role_name, NEW.turn_id, NEW.received_at, NEW.received_at,
+    1, NEW.sequence,
+    CASE WHEN json_valid(NEW.payload)
+      AND (COALESCE(json_extract(NEW.payload, '$.error'), '') <> ''
+        OR COALESCE(json_extract(NEW.payload, '$.errorKind'), '') <> '')
+      THEN 1 ELSE 0 END, NEW.received_at)
+  ON CONFLICT(task_id, role_name, turn_id) DO UPDATE SET
+    first_at = MIN(telemetry_aggregate.first_at, excluded.first_at),
+    last_at = MAX(telemetry_aggregate.last_at, excluded.last_at),
+    count = telemetry_aggregate.count + 1,
+    max_sequence = CASE WHEN excluded.max_sequence IS NOT NULL
+      AND (telemetry_aggregate.max_sequence IS NULL OR excluded.max_sequence > telemetry_aggregate.max_sequence)
+      THEN excluded.max_sequence ELSE telemetry_aggregate.max_sequence END,
+    error_count = telemetry_aggregate.error_count + excluded.error_count,
+    updated_at = excluded.updated_at;
+END;
+
+CREATE TRIGGER telemetry_au AFTER UPDATE ON telemetry
+BEGIN
+  UPDATE telemetry_aggregate SET
+    last_at = MAX(last_at, NEW.received_at),
+    max_sequence = CASE WHEN NEW.sequence IS NOT NULL
+      AND (max_sequence IS NULL OR NEW.sequence > max_sequence) THEN NEW.sequence ELSE max_sequence END,
+    updated_at = NEW.received_at
+  WHERE task_id = NEW.task_id AND role_name = NEW.role_name AND turn_id = NEW.turn_id;
+END;
+`;
+export const SQLITE_SCHEMA_TABLES = [
+    "storage_schema",
+    "active_turns",
+    "agent_profiles",
+    "capability_grants",
+    "change_sets",
+    "config",
+    "configured_agents",
+    "context_snapshots",
+    "decisions",
+    "durable_jobs",
+    "environment_preparations",
+    "events",
+    "gate_artifact_logs",
+    "gate_artifacts",
+    "global_role_messages",
+    "global_role_session_sets",
+    "global_roles",
+    "global_sequences",
+    "home_meta",
+    "id_sequences",
+    "input_requests",
+    "integration_attempts",
+    "local_resources",
+    "mailboxes",
+    "managed_workspaces",
+    "messages",
+    "milestones",
+    "outbox",
+    "plugin_intents",
+    "plugin_validations",
+    "projects",
+    "publication_references",
+    "release_workflows",
+    "resource_registry",
+    "review_rounds",
+    "role_session_sets",
+    "runtime_session_candidates",
+    "session_owners",
+    "storage_migration_archive",
+    "task_projections",
+    "task_records",
+    "task_roles",
+    "task_wakes",
+    "tasks_catalog",
+    "telemetry",
+    "telemetry_aggregate",
+    "turns",
+    "work_items"
+];

package/dist/storage/homeLayout.js

@@ -3,16 +3,10 @@ import { createHash } from "node:crypto";
 /**
  * The single authority for every Yui self-managed path derived from a Home.
  *
- * Historically the managed Git worktrees and provider runtimes escaped Home
- * through two different mechanisms: worktree/task roots were derived from the
- * user-facing `defaultWorkspace` (an out-of-Home directory), and provider
- * runtimes/backups were written to string-built siblings of Home
- * (`${home}.task-runtimes`, `${home}-backups`). Both are unified here so that a
- * single canonical YUI_HOME contains all self-managed data, with only the
+ * A single canonical YUI_HOME contains all self-managed data, with only the
  * approved short-path IPC sockets (Controller, tmux, Agent Host, integration
  * runtime) remaining outside it for the `sockaddr_un` length budget. Within the
- * managed workspace root, storage v25 further collapses the former
- * physical-worktree/symlink-view split into a single layer of real worktrees
+ * managed workspace root contains a single layer of real worktrees
  * under `tasks/` (see {@link managedTaskRoot}).
  *
  * `defaultWorkspace` is intentionally NOT an input to this module: it remains a
@@ -28,11 +22,8 @@ function homeRoot(home) {
     return resolved;
 }
 /**
- * Root that contains every managed Git workspace. Since storage v25 this holds a
- * single layer of real worktrees under `tasks/` (plus the legacy `worktree/`
- * root, preserved by the 24->25 migration as its rollback anchor). A single
- * parent keeps the managed families adjacent and lets the storage migrations
- * relocate them as one subtree.
+ * Root that contains every managed Git workspace, with a single layer of real
+ * worktrees under `tasks/`.
  */
 export function managedWorkspacesRoot(home) {
     return join(homeRoot(home), "workspaces");
@@ -41,9 +32,7 @@ export function managedWorkspacesRoot(home) {
  * Managed Git worktrees, one real worktree per Task owner and Project at
  * `<home>/workspaces/tasks/<taskId>/<owner>/<projectDirectory>` (owner being
  * `main`, `work-items/<id>`, `reviews/<name>`, `integrations/<id>`, or
- * `execution-lanes/<g>/<l>`). Before storage v25 these were symlink views over
- * the physical `worktree/` root; the 24->25 migration makes them the worktrees
- * themselves, so the logical entry path and the physical Git worktree coincide.
+ * `execution-lanes/<g>/<l>`). The logical entry path and physical Git worktree coincide.
  */
 export function managedTaskRoot(home) {
     return join(managedWorkspacesRoot(home), "tasks");

package/dist/storage/recordValidation.js

@@ -24,10 +24,11 @@ import { validateGateArtifact } from "../verification/gateArtifact.js";
 import { validateWorkItem } from "../workItem/workItem.js";
 import { validateManagedWorkspace } from "../worktree/managedWorkspace.js";
 import { StorageRecordError, storedCapabilityGrant, storedPublicationReference, storedReleaseWorkflow } from "./taskStore.js";
+import { requireKnownFields } from "../domain/validation.js";
 const check = (validate) => record => { validate(record); };
 /** One current domain contract for saves, reads and explicit Home diagnostics.
  * Protocol-specific metadata/outbox/telemetry have their own readers. This is
- * validation only: historical formats belong exclusively to migrations. */
+ * validation only: other storage formats require an independent converter. */
 const validators = {
     task_records: check(validateTask),
     work_items: check(validateWorkItem),
@@ -36,8 +37,16 @@ const validators = {
     projects: check(validateProject),
     task_roles: check(validateTaskRole),
     global_roles: check(validateGlobalRole),
-    role_session_sets: check(validateRoleSessionSet),
-    global_role_session_sets: check(validateRoleSessionSet),
+    role_session_sets: check(record => {
+        if (record.owner?.scope !== "task")
+            throw new Error("Task Session set requires task scope.");
+        validateRoleSessionSet(record);
+    }),
+    global_role_session_sets: check(record => {
+        if (record.owner?.scope !== "global")
+            throw new Error("Global Session set requires global scope.");
+        validateRoleSessionSet(record);
+    }),
     messages: check(validateTaskMessage),
     global_role_messages: check(validateGlobalRoleMessage),
     turns: check(validateRun),
@@ -61,7 +70,10 @@ const validators = {
     plugin_intents: check(validatePluginIntent),
     plugin_validations: check(validatePluginValidation),
     session_owners: check((record) => {
-        if (record.schemaVersion !== 2 || record.kind !== "yui-session-owner" || Object.hasOwn(record, "launchId")) {
+        requireKnownFields(record, [
+            "schemaVersion", "kind", "owner", "agentId", "adapterId", "nativeSessionId", "tmux", "providerRoot", "runtimeRoot", "recordedAt"
+        ], "Session owner identity");
+        if (record.schemaVersion !== 1 || record.kind !== "yui-session-owner") {
             throw new Error("Session owner identity is invalid.");
         }
         createSessionOwnerIdentity({ ...record, recordedAt: new Date(record.recordedAt) });