switchman-dev 0.1.2 → 0.1.3

package/src/core/db.js

@@ -3,18 +3,20 @@
  * SQLite-backed task queue and file ownership registry
  */
 
+import { createHash, createHmac, randomBytes } from 'node:crypto';
 import { DatabaseSync } from 'node:sqlite';
-import { existsSync, mkdirSync } from 'fs';
-import { join } from 'path';
+import { chmodSync, existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from 'fs';
+import { join, resolve } from 'path';
 
 const SWITCHMAN_DIR = '.switchman';
 const DB_FILE = 'switchman.db';
+const AUDIT_KEY_FILE = 'audit.key';
 
 // How long (ms) a writer will wait for a lock before giving up.
 // 5 seconds is generous for a CLI tool with 3-10 concurrent agents.
-const BUSY_TIMEOUT_MS = 5000;
-const CLAIM_RETRY_DELAY_MS = 100;
-const CLAIM_RETRY_ATTEMPTS = 5;
+const BUSY_TIMEOUT_MS = 10000;
+const CLAIM_RETRY_DELAY_MS = 200;
+const CLAIM_RETRY_ATTEMPTS = 20;
 export const DEFAULT_STALE_LEASE_MINUTES = 15;
 
 function sleepSync(ms) {
@@ -26,23 +28,98 @@ function isBusyError(err) {
   return message.includes('database is locked') || message.includes('sqlite_busy');
 }
 
+function withBusyRetry(fn, { attempts = CLAIM_RETRY_ATTEMPTS, delayMs = CLAIM_RETRY_DELAY_MS } = {}) {
+  for (let attempt = 1; attempt <= attempts; attempt++) {
+    try {
+      return fn();
+    } catch (err) {
+      if (isBusyError(err) && attempt < attempts) {
+        sleepSync(delayMs * attempt);
+        continue;
+      }
+      throw err;
+    }
+  }
+}
+
+function normalizeWorktreePath(path) {
+  try {
+    return realpathSync(path);
+  } catch {
+    return resolve(path);
+  }
+}
+
 function makeId(prefix) {
   return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
 }
 
-function configureDb(db) {
+function configureDb(db, { initialize = false } = {}) {
   db.exec(`
     PRAGMA foreign_keys=ON;
-    PRAGMA journal_mode=WAL;
     PRAGMA synchronous=NORMAL;
     PRAGMA busy_timeout=${BUSY_TIMEOUT_MS};
   `);
+
+  if (initialize) {
+    withBusyRetry(() => {
+      db.exec(`PRAGMA journal_mode=WAL;`);
+    });
+  }
 }
 
 function getTableColumns(db, tableName) {
   return db.prepare(`PRAGMA table_info(${tableName})`).all().map((column) => column.name);
 }
 
+function getAuditSecret(repoRoot) {
+  const keyPath = join(getSwitchmanDir(repoRoot), AUDIT_KEY_FILE);
+  if (!existsSync(keyPath)) {
+    const secret = randomBytes(32).toString('hex');
+    writeFileSync(keyPath, `${secret}\n`, { mode: 0o600 });
+    try {
+      chmodSync(keyPath, 0o600);
+    } catch {
+      // Best-effort on platforms that do not fully support chmod semantics.
+    }
+    return secret;
+  }
+  return readFileSync(keyPath, 'utf8').trim();
+}
+
+function getAuditContext(db) {
+  const repoRoot = db.__switchmanRepoRoot;
+  const secret = db.__switchmanAuditSecret;
+  if (!repoRoot || !secret) {
+    throw new Error('Audit context is not configured for this database.');
+  }
+  return { repoRoot, secret };
+}
+
+function canonicalizeAuditEvent(event) {
+  return JSON.stringify({
+    sequence: event.sequence,
+    prev_hash: event.prevHash,
+    event_type: event.eventType,
+    status: event.status,
+    reason_code: event.reasonCode,
+    worktree: event.worktree,
+    task_id: event.taskId,
+    lease_id: event.leaseId,
+    file_path: event.filePath,
+    details: event.details,
+    created_at: event.createdAt,
+  });
+}
+
+function computeAuditEntryHash(event) {
+  return createHash('sha256').update(canonicalizeAuditEvent(event)).digest('hex');
+}
+
+function signAuditEntry(secret, entryHash) {
+  return createHmac('sha256', secret).update(entryHash).digest('hex');
+}
+
 function ensureSchema(db) {
   db.exec(`
     CREATE TABLE IF NOT EXISTS tasks (
@@ -90,6 +167,8 @@ function ensureSchema(db) {
       branch        TEXT NOT NULL,
       agent         TEXT,
       status        TEXT NOT NULL DEFAULT 'idle',
+      enforcement_mode TEXT NOT NULL DEFAULT 'observed',
+      compliance_state TEXT NOT NULL DEFAULT 'observed',
       registered_at TEXT NOT NULL DEFAULT (datetime('now')),
       last_seen     TEXT NOT NULL DEFAULT (datetime('now'))
     );
@@ -102,6 +181,98 @@ function ensureSchema(db) {
       conflicting_files TEXT NOT NULL,
       resolved          INTEGER DEFAULT 0
     );
+
+    CREATE TABLE IF NOT EXISTS audit_log (
+      id           INTEGER PRIMARY KEY AUTOINCREMENT,
+      event_type   TEXT NOT NULL,
+      status       TEXT NOT NULL DEFAULT 'info',
+      reason_code  TEXT,
+      worktree     TEXT,
+      task_id      TEXT,
+      lease_id     TEXT,
+      file_path    TEXT,
+      details      TEXT,
+      created_at   TEXT NOT NULL DEFAULT (datetime('now')),
+      sequence     INTEGER,
+      prev_hash    TEXT,
+      entry_hash   TEXT,
+      signature    TEXT
+    );
+
+    CREATE TABLE IF NOT EXISTS worktree_snapshots (
+      worktree     TEXT NOT NULL,
+      file_path    TEXT NOT NULL,
+      fingerprint  TEXT NOT NULL,
+      observed_at  TEXT NOT NULL DEFAULT (datetime('now')),
+      PRIMARY KEY (worktree, file_path)
+    );
+
+    CREATE TABLE IF NOT EXISTS task_specs (
+      task_id      TEXT PRIMARY KEY,
+      spec_json    TEXT NOT NULL,
+      updated_at   TEXT NOT NULL DEFAULT (datetime('now')),
+      FOREIGN KEY(task_id) REFERENCES tasks(id) ON DELETE CASCADE
+    );
+
+    CREATE TABLE IF NOT EXISTS scope_reservations (
+      id              INTEGER PRIMARY KEY AUTOINCREMENT,
+      lease_id        TEXT NOT NULL,
+      task_id         TEXT NOT NULL,
+      worktree        TEXT NOT NULL,
+      ownership_level TEXT NOT NULL,
+      scope_pattern   TEXT,
+      subsystem_tag   TEXT,
+      reserved_at     TEXT NOT NULL DEFAULT (datetime('now')),
+      released_at     TEXT,
+      FOREIGN KEY(lease_id) REFERENCES leases(id),
+      FOREIGN KEY(task_id) REFERENCES tasks(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS boundary_validation_state (
+      lease_id           TEXT PRIMARY KEY,
+      task_id            TEXT NOT NULL,
+      pipeline_id        TEXT,
+      status             TEXT NOT NULL,
+      missing_task_types TEXT NOT NULL DEFAULT '[]',
+      touched_at         TEXT,
+      last_evaluated_at  TEXT NOT NULL DEFAULT (datetime('now')),
+      details            TEXT,
+      FOREIGN KEY(lease_id) REFERENCES leases(id),
+      FOREIGN KEY(task_id) REFERENCES tasks(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS dependency_invalidations (
+      id                   INTEGER PRIMARY KEY AUTOINCREMENT,
+      source_lease_id      TEXT NOT NULL,
+      source_task_id       TEXT NOT NULL,
+      source_pipeline_id   TEXT,
+      source_worktree      TEXT,
+      affected_task_id     TEXT NOT NULL,
+      affected_pipeline_id TEXT,
+      affected_worktree    TEXT,
+      status               TEXT NOT NULL DEFAULT 'stale',
+      reason_type          TEXT NOT NULL,
+      subsystem_tag        TEXT,
+      source_scope_pattern TEXT,
+      affected_scope_pattern TEXT,
+      details              TEXT,
+      created_at           TEXT NOT NULL DEFAULT (datetime('now')),
+      resolved_at          TEXT,
+      FOREIGN KEY(source_lease_id) REFERENCES leases(id),
+      FOREIGN KEY(source_task_id) REFERENCES tasks(id),
+      FOREIGN KEY(affected_task_id) REFERENCES tasks(id)
+    );
+
+    CREATE TABLE IF NOT EXISTS code_objects (
+      object_id      TEXT PRIMARY KEY,
+      file_path      TEXT NOT NULL,
+      kind           TEXT NOT NULL,
+      name           TEXT NOT NULL,
+      source_text    TEXT NOT NULL,
+      subsystem_tags TEXT NOT NULL DEFAULT '[]',
+      area           TEXT,
+      updated_at     TEXT NOT NULL DEFAULT (datetime('now'))
+    );
   `);
 
   const fileClaimColumns = getTableColumns(db, 'file_claims');
@@ -109,6 +280,28 @@ function ensureSchema(db) {
     db.exec(`ALTER TABLE file_claims ADD COLUMN lease_id TEXT REFERENCES leases(id)`);
   }
 
+  const worktreeColumns = getTableColumns(db, 'worktrees');
+  if (worktreeColumns.length > 0 && !worktreeColumns.includes('enforcement_mode')) {
+    db.exec(`ALTER TABLE worktrees ADD COLUMN enforcement_mode TEXT NOT NULL DEFAULT 'observed'`);
+  }
+  if (worktreeColumns.length > 0 && !worktreeColumns.includes('compliance_state')) {
+    db.exec(`ALTER TABLE worktrees ADD COLUMN compliance_state TEXT NOT NULL DEFAULT 'observed'`);
+  }
+
+  const auditColumns = getTableColumns(db, 'audit_log');
+  if (auditColumns.length > 0 && !auditColumns.includes('sequence')) {
+    db.exec(`ALTER TABLE audit_log ADD COLUMN sequence INTEGER`);
+  }
+  if (auditColumns.length > 0 && !auditColumns.includes('prev_hash')) {
+    db.exec(`ALTER TABLE audit_log ADD COLUMN prev_hash TEXT`);
+  }
+  if (auditColumns.length > 0 && !auditColumns.includes('entry_hash')) {
+    db.exec(`ALTER TABLE audit_log ADD COLUMN entry_hash TEXT`);
+  }
+  if (auditColumns.length > 0 && !auditColumns.includes('signature')) {
+    db.exec(`ALTER TABLE audit_log ADD COLUMN signature TEXT`);
+  }
+
   db.exec(`
     CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
     CREATE INDEX IF NOT EXISTS idx_leases_task ON leases(task_id);
@@ -123,11 +316,240 @@ function ensureSchema(db) {
     CREATE UNIQUE INDEX IF NOT EXISTS idx_file_claims_unique_active
       ON file_claims(file_path)
       WHERE released_at IS NULL;
+    CREATE INDEX IF NOT EXISTS idx_audit_log_event_type ON audit_log(event_type);
+    CREATE INDEX IF NOT EXISTS idx_audit_log_created_at ON audit_log(created_at);
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_audit_log_sequence ON audit_log(sequence) WHERE sequence IS NOT NULL;
+    CREATE INDEX IF NOT EXISTS idx_worktree_snapshots_worktree ON worktree_snapshots(worktree);
+    CREATE INDEX IF NOT EXISTS idx_task_specs_updated_at ON task_specs(updated_at);
+    CREATE INDEX IF NOT EXISTS idx_scope_reservations_lease_id ON scope_reservations(lease_id);
+    CREATE INDEX IF NOT EXISTS idx_scope_reservations_task_id ON scope_reservations(task_id);
+    CREATE INDEX IF NOT EXISTS idx_scope_reservations_active ON scope_reservations(released_at) WHERE released_at IS NULL;
+    CREATE INDEX IF NOT EXISTS idx_scope_reservations_scope_pattern ON scope_reservations(scope_pattern);
+    CREATE INDEX IF NOT EXISTS idx_scope_reservations_subsystem_tag ON scope_reservations(subsystem_tag);
+    CREATE INDEX IF NOT EXISTS idx_boundary_validation_pipeline_id ON boundary_validation_state(pipeline_id);
+    CREATE INDEX IF NOT EXISTS idx_boundary_validation_status ON boundary_validation_state(status);
+    CREATE INDEX IF NOT EXISTS idx_dependency_invalidations_source_lease ON dependency_invalidations(source_lease_id);
+    CREATE INDEX IF NOT EXISTS idx_dependency_invalidations_affected_task ON dependency_invalidations(affected_task_id);
+    CREATE INDEX IF NOT EXISTS idx_dependency_invalidations_affected_pipeline ON dependency_invalidations(affected_pipeline_id);
+    CREATE INDEX IF NOT EXISTS idx_dependency_invalidations_status ON dependency_invalidations(status);
+    CREATE INDEX IF NOT EXISTS idx_code_objects_file_path ON code_objects(file_path);
+    CREATE INDEX IF NOT EXISTS idx_code_objects_name ON code_objects(name);
   `);
 
+  migrateLegacyAuditLog(db);
   migrateLegacyActiveTasks(db);
 }
 
+function normalizeScopeRoot(pattern) {
+  return String(pattern || '')
+    .replace(/\\/g, '/')
+    .replace(/\/\*\*$/, '')
+    .replace(/\/\*$/, '')
+    .replace(/\/+$/, '');
+}
+
+function scopeRootsOverlap(leftPattern, rightPattern) {
+  const left = normalizeScopeRoot(leftPattern);
+  const right = normalizeScopeRoot(rightPattern);
+  if (!left || !right) return false;
+  return left === right || left.startsWith(`${right}/`) || right.startsWith(`${left}/`);
+}
+
+function intersectValues(left = [], right = []) {
+  const rightSet = new Set(right);
+  return [...new Set(left)].filter((value) => rightSet.has(value));
+}
+
+function buildSpecOverlap(sourceSpec = null, affectedSpec = null) {
+  const sourceSubsystems = Array.isArray(sourceSpec?.subsystem_tags) ? sourceSpec.subsystem_tags : [];
+  const affectedSubsystems = Array.isArray(affectedSpec?.subsystem_tags) ? affectedSpec.subsystem_tags : [];
+  const sharedSubsystems = intersectValues(sourceSubsystems, affectedSubsystems);
+
+  const sourceScopes = Array.isArray(sourceSpec?.allowed_paths) ? sourceSpec.allowed_paths : [];
+  const affectedScopes = Array.isArray(affectedSpec?.allowed_paths) ? affectedSpec.allowed_paths : [];
+  const sharedScopes = [];
+  for (const sourceScope of sourceScopes) {
+    for (const affectedScope of affectedScopes) {
+      if (scopeRootsOverlap(sourceScope, affectedScope)) {
+        sharedScopes.push({
+          source_scope_pattern: sourceScope,
+          affected_scope_pattern: affectedScope,
+        });
+      }
+    }
+  }
+
+  return {
+    shared_subsystems: sharedSubsystems,
+    shared_scopes: sharedScopes,
+  };
+}
+
+function buildLeaseScopeReservations(lease, taskSpec) {
+  if (!taskSpec) return [];
+
+  const reservations = [];
+  const pathPatterns = Array.isArray(taskSpec.allowed_paths) ? [...new Set(taskSpec.allowed_paths)] : [];
+  const subsystemTags = Array.isArray(taskSpec.subsystem_tags) ? [...new Set(taskSpec.subsystem_tags)] : [];
+
+  for (const scopePattern of pathPatterns) {
+    reservations.push({
+      leaseId: lease.id,
+      taskId: lease.task_id,
+      worktree: lease.worktree,
+      ownershipLevel: 'path_scope',
+      scopePattern,
+      subsystemTag: null,
+    });
+  }
+
+  for (const subsystemTag of subsystemTags) {
+    reservations.push({
+      leaseId: lease.id,
+      taskId: lease.task_id,
+      worktree: lease.worktree,
+      ownershipLevel: 'subsystem',
+      scopePattern: null,
+      subsystemTag,
+    });
+  }
+
+  return reservations;
+}
+
+function getActiveScopeReservationsTx(db, { leaseId = null, worktree = null } = {}) {
+  if (leaseId) {
+    return db.prepare(`
+      SELECT *
+      FROM scope_reservations
+      WHERE lease_id=? AND released_at IS NULL
+      ORDER BY id ASC
+    `).all(leaseId);
+  }
+
+  if (worktree) {
+    return db.prepare(`
+      SELECT *
+      FROM scope_reservations
+      WHERE worktree=? AND released_at IS NULL
+      ORDER BY id ASC
+    `).all(worktree);
+  }
+
+  return db.prepare(`
+    SELECT *
+    FROM scope_reservations
+    WHERE released_at IS NULL
+    ORDER BY id ASC
+  `).all();
+}
+
+function findScopeReservationConflicts(reservations, activeReservations) {
+  const conflicts = [];
+
+  for (const reservation of reservations) {
+    for (const activeReservation of activeReservations) {
+      if (activeReservation.lease_id === reservation.leaseId) continue;
+
+      if (
+        reservation.ownershipLevel === 'subsystem' &&
+        activeReservation.ownership_level === 'subsystem' &&
+        reservation.subsystemTag &&
+        reservation.subsystemTag === activeReservation.subsystem_tag
+      ) {
+        conflicts.push({
+          type: 'subsystem',
+          subsystem_tag: reservation.subsystemTag,
+          lease_id: activeReservation.lease_id,
+          worktree: activeReservation.worktree,
+        });
+        continue;
+      }
+
+      if (
+        reservation.ownershipLevel === 'path_scope' &&
+        activeReservation.ownership_level === 'path_scope' &&
+        scopeRootsOverlap(reservation.scopePattern, activeReservation.scope_pattern)
+      ) {
+        conflicts.push({
+          type: 'path_scope',
+          scope_pattern: reservation.scopePattern,
+          conflicting_scope_pattern: activeReservation.scope_pattern,
+          lease_id: activeReservation.lease_id,
+          worktree: activeReservation.worktree,
+        });
+      }
+    }
+  }
+
+  return conflicts;
+}
+
+function reserveLeaseScopesTx(db, lease) {
+  const existing = getActiveScopeReservationsTx(db, { leaseId: lease.id });
+  if (existing.length > 0) {
+    return existing;
+  }
+
+  const taskSpec = getTaskSpec(db, lease.task_id);
+  const reservations = buildLeaseScopeReservations(lease, taskSpec);
+  if (!reservations.length) {
+    return [];
+  }
+
+  const activeReservations = getActiveScopeReservationsTx(db).filter((reservation) => reservation.lease_id !== lease.id);
+  const conflicts = findScopeReservationConflicts(reservations, activeReservations);
+  if (conflicts.length > 0) {
+    const summary = conflicts[0].type === 'subsystem'
+      ? `subsystem:${conflicts[0].subsystem_tag}`
+      : `${conflicts[0].scope_pattern} overlaps ${conflicts[0].conflicting_scope_pattern}`;
+    logAuditEventTx(db, {
+      eventType: 'scope_reservation_denied',
+      status: 'denied',
+      reasonCode: 'scope_reserved_by_other_lease',
+      worktree: lease.worktree,
+      taskId: lease.task_id,
+      leaseId: lease.id,
+      details: JSON.stringify({ conflicts, summary }),
+    });
+    throw new Error(`Scope reservation conflict: ${summary}`);
+  }
+
+  const insert = db.prepare(`
+    INSERT INTO scope_reservations (lease_id, task_id, worktree, ownership_level, scope_pattern, subsystem_tag)
+    VALUES (?, ?, ?, ?, ?, ?)
+  `);
+
+  for (const reservation of reservations) {
+    insert.run(
+      reservation.leaseId,
+      reservation.taskId,
+      reservation.worktree,
+      reservation.ownershipLevel,
+      reservation.scopePattern,
+      reservation.subsystemTag,
+    );
+  }
+
+  logAuditEventTx(db, {
+    eventType: 'scope_reserved',
+    status: 'allowed',
+    worktree: lease.worktree,
+    taskId: lease.task_id,
+    leaseId: lease.id,
+    details: JSON.stringify({
+      ownership_levels: [...new Set(reservations.map((reservation) => reservation.ownershipLevel))],
+      reservations: reservations.map((reservation) => ({
+        ownership_level: reservation.ownershipLevel,
+        scope_pattern: reservation.scopePattern,
+        subsystem_tag: reservation.subsystemTag,
+      })),
+    }),
+  });
+
+  return getActiveScopeReservationsTx(db, { leaseId: lease.id });
+}
+
 function touchWorktreeLeaseState(db, worktree, agent, status) {
   if (!worktree) return;
   db.prepare(`
@@ -160,8 +582,119 @@ function createLeaseTx(db, { id, taskId, worktree, agent, status = 'active', fai
     INSERT INTO leases (id, task_id, worktree, agent, status, failure_reason)
     VALUES (?, ?, ?, ?, ?, ?)
   `).run(leaseId, taskId, worktree, agent || null, status, failureReason);
+  const lease = getLeaseTx(db, leaseId);
+  if (status === 'active') {
+    reserveLeaseScopesTx(db, lease);
+  }
   touchWorktreeLeaseState(db, worktree, agent, status === 'active' ? 'busy' : 'idle');
-  return getLeaseTx(db, leaseId);
+  logAuditEventTx(db, {
+    eventType: 'lease_started',
+    status: 'allowed',
+    worktree,
+    taskId,
+    leaseId,
+    details: JSON.stringify({ agent: agent || null }),
+  });
+  return lease;
+}
+
+function logAuditEventTx(db, { eventType, status = 'info', reasonCode = null, worktree = null, taskId = null, leaseId = null, filePath = null, details = null }) {
+  const { secret } = getAuditContext(db);
+  const previousEvent = db.prepare(`
+    SELECT sequence, entry_hash
+    FROM audit_log
+    WHERE sequence IS NOT NULL
+    ORDER BY sequence DESC, id DESC
+    LIMIT 1
+  `).get();
+  const createdAt = new Date().toISOString();
+  const sequence = (previousEvent?.sequence || 0) + 1;
+  const prevHash = previousEvent?.entry_hash || null;
+  const normalizedDetails = details == null ? null : String(details);
+  const entryHash = computeAuditEntryHash({
+    sequence,
+    prevHash,
+    eventType,
+    status,
+    reasonCode,
+    worktree,
+    taskId,
+    leaseId,
+    filePath,
+    details: normalizedDetails,
+    createdAt,
+  });
+  const signature = signAuditEntry(secret, entryHash);
+  db.prepare(`
+    INSERT INTO audit_log (
+      event_type, status, reason_code, worktree, task_id, lease_id, file_path, details, created_at, sequence, prev_hash, entry_hash, signature
+    )
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    eventType,
+    status,
+    reasonCode,
+    worktree,
+    taskId,
+    leaseId,
+    filePath,
+    normalizedDetails,
+    createdAt,
+    sequence,
+    prevHash,
+    entryHash,
+    signature,
+  );
+}
+
+function migrateLegacyAuditLog(db) {
+  const rows = db.prepare(`
+    SELECT *
+    FROM audit_log
+    WHERE sequence IS NULL OR entry_hash IS NULL OR signature IS NULL
+    ORDER BY datetime(created_at) ASC, id ASC
+  `).all();
+
+  if (!rows.length) return;
+
+  const { secret } = getAuditContext(db);
+  let previous = db.prepare(`
+    SELECT sequence, entry_hash
+    FROM audit_log
+    WHERE sequence IS NOT NULL AND entry_hash IS NOT NULL
+    ORDER BY sequence DESC, id DESC
+    LIMIT 1
+  `).get();
+
+  const update = db.prepare(`
+    UPDATE audit_log
+    SET created_at=?, sequence=?, prev_hash=?, entry_hash=?, signature=?
+    WHERE id=?
+  `);
+
+  let nextSequence = previous?.sequence || 0;
+  let prevHash = previous?.entry_hash || null;
+
+  for (const row of rows) {
+    nextSequence += 1;
+    const createdAt = row.created_at || new Date().toISOString();
+    const entryHash = computeAuditEntryHash({
+      sequence: nextSequence,
+      prevHash,
+      eventType: row.event_type,
+      status: row.status,
+      reasonCode: row.reason_code,
+      worktree: row.worktree,
+      taskId: row.task_id,
+      leaseId: row.lease_id,
+      filePath: row.file_path,
+      details: row.details,
+      createdAt,
+    });
+    const signature = signAuditEntry(secret, entryHash);
+    update.run(createdAt, nextSequence, prevHash, entryHash, signature, row.id);
+    prevHash = entryHash;
+  }
 }
 
 function migrateLegacyActiveTasks(db) {
@@ -219,6 +752,7 @@ function resolveActiveLeaseTx(db, taskId, worktree, agent) {
           agent=COALESCE(?, agent)
       WHERE id=?
     `).run(agent || null, lease.id);
+    reserveLeaseScopesTx(db, lease);
     touchWorktreeLeaseState(db, worktree, agent || lease.agent, 'busy');
     return getLeaseTx(db, lease.id);
   }
@@ -246,6 +780,331 @@ function releaseClaimsForLeaseTx(db, leaseId) {
   `).run(leaseId);
 }
 
+function releaseScopeReservationsForLeaseTx(db, leaseId) {
+  db.prepare(`
+    UPDATE scope_reservations
+    SET released_at=datetime('now')
+    WHERE lease_id=? AND released_at IS NULL
+  `).run(leaseId);
+}
+
+function releaseClaimsForTaskTx(db, taskId) {
+  db.prepare(`
+    UPDATE file_claims
+    SET released_at=datetime('now')
+    WHERE task_id=? AND released_at IS NULL
+  `).run(taskId);
+}
+
+function releaseScopeReservationsForTaskTx(db, taskId) {
+  db.prepare(`
+    UPDATE scope_reservations
+    SET released_at=datetime('now')
+    WHERE task_id=? AND released_at IS NULL
+  `).run(taskId);
+}
+
+function getBoundaryValidationStateTx(db, leaseId) {
+  return db.prepare(`
+    SELECT *
+    FROM boundary_validation_state
+    WHERE lease_id=?
+  `).get(leaseId);
+}
+
+function listActiveDependencyInvalidationsTx(db, { sourceLeaseId = null, affectedTaskId = null, pipelineId = null } = {}) {
+  const clauses = ['resolved_at IS NULL'];
+  const params = [];
+  if (sourceLeaseId) {
+    clauses.push('source_lease_id=?');
+    params.push(sourceLeaseId);
+  }
+  if (affectedTaskId) {
+    clauses.push('affected_task_id=?');
+    params.push(affectedTaskId);
+  }
+  if (pipelineId) {
+    clauses.push('(source_pipeline_id=? OR affected_pipeline_id=?)');
+    params.push(pipelineId, pipelineId);
+  }
+
+  return db.prepare(`
+    SELECT *
+    FROM dependency_invalidations
+    WHERE ${clauses.join(' AND ')}
+    ORDER BY created_at DESC, id DESC
+  `).all(...params);
+}
+
+function resolveDependencyInvalidationsForAffectedTaskTx(db, affectedTaskId, resolvedBy = null) {
+  db.prepare(`
+    UPDATE dependency_invalidations
+    SET status='revalidated',
+        resolved_at=datetime('now'),
+        details=CASE
+          WHEN details IS NULL OR details='' THEN json_object('resolved_by', ?)
+          ELSE json_set(details, '$.resolved_by', ?)
+        END
+    WHERE affected_task_id=? AND resolved_at IS NULL
+  `).run(resolvedBy || null, resolvedBy || null, affectedTaskId);
+}
+
+function syncDependencyInvalidationsForLeaseTx(db, leaseId, source = 'write') {
+  const execution = getLeaseExecutionContext(db, leaseId);
+  if (!execution?.task || !execution.task_spec) {
+    return [];
+  }
+
+  const sourceTask = execution.task;
+  const sourceSpec = execution.task_spec;
+  const sourcePipelineId = sourceSpec.pipeline_id || null;
+  const sourceWorktree = execution.lease.worktree || sourceTask.worktree || null;
+  const tasks = listTasks(db);
+  const desired = [];
+
+  for (const affectedTask of tasks) {
+    if (affectedTask.id === sourceTask.id) continue;
+    if (!['in_progress', 'done'].includes(affectedTask.status)) continue;
+
+    const affectedSpec = getTaskSpec(db, affectedTask.id);
+    if (!affectedSpec) continue;
+    if ((affectedSpec.pipeline_id || null) === sourcePipelineId) continue;
+
+    const overlap = buildSpecOverlap(sourceSpec, affectedSpec);
+    if (overlap.shared_subsystems.length === 0 && overlap.shared_scopes.length === 0) continue;
+
+    const affectedWorktree = affectedTask.worktree || null;
+    for (const subsystemTag of overlap.shared_subsystems) {
+      desired.push({
+        source_lease_id: leaseId,
+        source_task_id: sourceTask.id,
+        source_pipeline_id: sourcePipelineId,
+        source_worktree: sourceWorktree,
+        affected_task_id: affectedTask.id,
+        affected_pipeline_id: affectedSpec.pipeline_id || null,
+        affected_worktree: affectedWorktree,
+        status: 'stale',
+        reason_type: 'subsystem_overlap',
+        subsystem_tag: subsystemTag,
+        source_scope_pattern: null,
+        affected_scope_pattern: null,
+        details: {
+          source,
+          source_task_title: sourceTask.title,
+          affected_task_title: affectedTask.title,
+        },
+      });
+    }
+
+    for (const sharedScope of overlap.shared_scopes) {
+      desired.push({
+        source_lease_id: leaseId,
+        source_task_id: sourceTask.id,
+        source_pipeline_id: sourcePipelineId,
+        source_worktree: sourceWorktree,
+        affected_task_id: affectedTask.id,
+        affected_pipeline_id: affectedSpec.pipeline_id || null,
+        affected_worktree: affectedWorktree,
+        status: 'stale',
+        reason_type: 'scope_overlap',
+        subsystem_tag: null,
+        source_scope_pattern: sharedScope.source_scope_pattern,
+        affected_scope_pattern: sharedScope.affected_scope_pattern,
+        details: {
+          source,
+          source_task_title: sourceTask.title,
+          affected_task_title: affectedTask.title,
+        },
+      });
+    }
+  }
+
+  const desiredKeys = new Set(desired.map((item) => JSON.stringify([
+    item.affected_task_id,
+    item.reason_type,
+    item.subsystem_tag || '',
+    item.source_scope_pattern || '',
+    item.affected_scope_pattern || '',
+  ])));
+  const existing = listActiveDependencyInvalidationsTx(db, { sourceLeaseId: leaseId });
+
+  for (const existingRow of existing) {
+    const existingKey = JSON.stringify([
+      existingRow.affected_task_id,
+      existingRow.reason_type,
+      existingRow.subsystem_tag || '',
+      existingRow.source_scope_pattern || '',
+      existingRow.affected_scope_pattern || '',
+    ]);
+    if (!desiredKeys.has(existingKey)) {
+      db.prepare(`
+        UPDATE dependency_invalidations
+        SET status='revalidated',
+            resolved_at=datetime('now'),
+            details=CASE
+              WHEN details IS NULL OR details='' THEN json_object('resolved_by', ?)
+              ELSE json_set(details, '$.resolved_by', ?)
+            END
+        WHERE id=?
+      `).run(source, source, existingRow.id);
+    }
+  }
+
+  for (const item of desired) {
+    const existingRow = existing.find((row) =>
+      row.affected_task_id === item.affected_task_id
+      && row.reason_type === item.reason_type
+      && (row.subsystem_tag || null) === (item.subsystem_tag || null)
+      && (row.source_scope_pattern || null) === (item.source_scope_pattern || null)
+      && (row.affected_scope_pattern || null) === (item.affected_scope_pattern || null)
+      && row.resolved_at === null
+    );
+
+    if (existingRow) {
+      db.prepare(`
+        UPDATE dependency_invalidations
+        SET source_task_id=?,
+            source_pipeline_id=?,
+            source_worktree=?,
+            affected_pipeline_id=?,
+            affected_worktree=?,
+            status='stale',
+            details=?,
+            resolved_at=NULL
+        WHERE id=?
+      `).run(
+        item.source_task_id,
+        item.source_pipeline_id,
+        item.source_worktree,
+        item.affected_pipeline_id,
+        item.affected_worktree,
+        JSON.stringify(item.details || {}),
+        existingRow.id,
+      );
+      continue;
+    }
+
+    db.prepare(`
+      INSERT INTO dependency_invalidations (
+        source_lease_id, source_task_id, source_pipeline_id, source_worktree,
+        affected_task_id, affected_pipeline_id, affected_worktree,
+        status, reason_type, subsystem_tag, source_scope_pattern, affected_scope_pattern, details
+      )
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(
+      item.source_lease_id,
+      item.source_task_id,
+      item.source_pipeline_id,
+      item.source_worktree,
+      item.affected_task_id,
+      item.affected_pipeline_id,
+      item.affected_worktree,
+      item.status,
+      item.reason_type,
+      item.subsystem_tag,
+      item.source_scope_pattern,
+      item.affected_scope_pattern,
+      JSON.stringify(item.details || {}),
+    );
+  }
+
+  return listActiveDependencyInvalidationsTx(db, { sourceLeaseId: leaseId }).map((row) => ({
+    ...row,
+    details: row.details ? JSON.parse(row.details) : {},
+  }));
+}
+
+function upsertBoundaryValidationStateTx(db, state) {
+  db.prepare(`
+    INSERT INTO boundary_validation_state (
+      lease_id, task_id, pipeline_id, status, missing_task_types, touched_at, last_evaluated_at, details
+    )
+    VALUES (?, ?, ?, ?, ?, ?, datetime('now'), ?)
+    ON CONFLICT(lease_id) DO UPDATE SET
+      status=excluded.status,
+      missing_task_types=excluded.missing_task_types,
+      touched_at=COALESCE(boundary_validation_state.touched_at, excluded.touched_at),
+      last_evaluated_at=datetime('now'),
+      details=excluded.details
+  `).run(
+    state.lease_id,
+    state.task_id,
+    state.pipeline_id || null,
+    state.status,
+    JSON.stringify(state.missing_task_types || []),
+    state.touched_at || null,
+    JSON.stringify(state.details || {}),
+  );
+}
+
+function computeBoundaryValidationStateTx(db, leaseId, { touched = false, source = null } = {}) {
+  const execution = getLeaseExecutionContext(db, leaseId);
+  if (!execution?.task || !execution.task_spec?.validation_rules) {
+    return null;
+  }
+
+  const validationRules = execution.task_spec.validation_rules;
+  const requiredTaskTypes = validationRules.required_completed_task_types || [];
+  if (requiredTaskTypes.length === 0) {
+    return null;
+  }
+
+  const pipelineId = execution.task_spec.pipeline_id || null;
+  const existing = getBoundaryValidationStateTx(db, leaseId);
+  const touchedAt = existing?.touched_at || (touched ? new Date().toISOString() : null);
+  if (!touchedAt) {
+    return null;
+  }
+
+  const pipelineTasks = pipelineId
+    ? listTasks(db).filter((task) => getTaskSpec(db, task.id)?.pipeline_id === pipelineId)
+    : [];
+  const completedTaskTypes = new Set(
+    pipelineTasks
+      .filter((task) => task.status === 'done')
+      .map((task) => getTaskSpec(db, task.id)?.task_type)
+      .filter(Boolean),
+  );
+  const missingTaskTypes = requiredTaskTypes.filter((taskType) => !completedTaskTypes.has(taskType));
+  const status = missingTaskTypes.length === 0
+    ? 'satisfied'
+    : (validationRules.enforcement === 'blocked' ? 'blocked' : 'pending_validation');
+
+  return {
+    lease_id: leaseId,
+    task_id: execution.task.id,
+    pipeline_id: pipelineId,
+    status,
+    missing_task_types: missingTaskTypes,
+    touched_at: touchedAt,
+    details: {
+      source,
+      enforcement: validationRules.enforcement,
+      required_completed_task_types: requiredTaskTypes,
+      rationale: validationRules.rationale || [],
+      subsystem_tags: execution.task_spec.subsystem_tags || [],
+    },
+  };
+}
+
+function syncPipelineBoundaryValidationStatesTx(db, pipelineId, { source = null } = {}) {
+  if (!pipelineId) return [];
+  const states = db.prepare(`
+    SELECT *
+    FROM boundary_validation_state
+    WHERE pipeline_id=?
+  `).all(pipelineId);
+
+  const updated = [];
+  for (const state of states) {
+    const recomputed = computeBoundaryValidationStateTx(db, state.lease_id, { touched: false, source });
+    if (!recomputed) continue;
+    upsertBoundaryValidationStateTx(db, recomputed);
+    updated.push(recomputed);
+  }
+  return updated;
+}
+
 function closeActiveLeasesForTaskTx(db, taskId, status, failureReason = null) {
   const activeLeases = db.prepare(`
     SELECT * FROM leases
@@ -262,11 +1121,66 @@ function closeActiveLeasesForTaskTx(db, taskId, status, failureReason = null) {
 
   for (const lease of activeLeases) {
     touchWorktreeLeaseState(db, lease.worktree, lease.agent, 'idle');
+    releaseScopeReservationsForLeaseTx(db, lease.id);
   }
 
   return activeLeases;
 }
 
+function finalizeTaskWithLeaseTx(db, taskId, activeLease, { taskStatus, leaseStatus, failureReason = null, auditStatus, auditEventType, auditReasonCode = null }) {
+  const taskSpec = getTaskSpec(db, taskId);
+  if (taskStatus === 'done') {
+    db.prepare(`
+      UPDATE tasks
+      SET status='done', completed_at=datetime('now'), updated_at=datetime('now')
+      WHERE id=?
+    `).run(taskId);
+  } else if (taskStatus === 'failed') {
+    db.prepare(`
+      UPDATE tasks
+      SET status='failed', description=COALESCE(description,'') || '\nFAILED: ' || ?, updated_at=datetime('now')
+      WHERE id=?
+    `).run(failureReason || 'unknown', taskId);
+  }
+
+  if (activeLease) {
+    db.prepare(`
+      UPDATE leases
+      SET status=?,
+          finished_at=datetime('now'),
+          failure_reason=?
+      WHERE id=? AND status='active'
+    `).run(leaseStatus, failureReason, activeLease.id);
+    touchWorktreeLeaseState(db, activeLease.worktree, activeLease.agent, 'idle');
+    releaseClaimsForLeaseTx(db, activeLease.id);
+    releaseScopeReservationsForLeaseTx(db, activeLease.id);
+  } else {
+    releaseClaimsForTaskTx(db, taskId);
+    releaseScopeReservationsForTaskTx(db, taskId);
+  }
+
+  closeActiveLeasesForTaskTx(db, taskId, leaseStatus, failureReason);
+
+  logAuditEventTx(db, {
+    eventType: auditEventType,
+    status: auditStatus,
+    reasonCode: auditReasonCode,
+    worktree: activeLease?.worktree ?? null,
+    taskId,
+    leaseId: activeLease?.id ?? null,
+    details: failureReason || null,
+  });
+
+  if (activeLease?.id && taskStatus === 'done') {
+    const touchedState = computeBoundaryValidationStateTx(db, activeLease.id, { touched: true, source: auditEventType });
+    if (touchedState) {
+      upsertBoundaryValidationStateTx(db, touchedState);
+    }
+  }
+
+  syncPipelineBoundaryValidationStatesTx(db, taskSpec?.pipeline_id || null, { source: auditEventType });
+}
+
 function withImmediateTransaction(db, fn) {
   for (let attempt = 1; attempt <= CLAIM_RETRY_ATTEMPTS; attempt++) {
     let beganTransaction = false;
@@ -304,8 +1218,10 @@ export function initDb(repoRoot) {
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
 
   const db = new DatabaseSync(getDbPath(repoRoot));
-  configureDb(db);
-  ensureSchema(db);
+  db.__switchmanRepoRoot = repoRoot;
+  db.__switchmanAuditSecret = getAuditSecret(repoRoot);
+  configureDb(db, { initialize: true });
+  withBusyRetry(() => ensureSchema(db));
   return db;
 }
 
@@ -315,8 +1231,10 @@ export function openDb(repoRoot) {
     throw new Error(`No switchman database found. Run 'switchman init' first.`);
   }
   const db = new DatabaseSync(dbPath);
+  db.__switchmanRepoRoot = repoRoot;
+  db.__switchmanAuditSecret = getAuditSecret(repoRoot);
   configureDb(db);
-  ensureSchema(db);
+  withBusyRetry(() => ensureSchema(db));
   return db;
 }
 
@@ -354,23 +1272,92 @@ export function assignTask(db, taskId, worktree, agent) {
 
 export function completeTask(db, taskId) {
   withImmediateTransaction(db, () => {
-    db.prepare(`
-      UPDATE tasks
-      SET status='done', completed_at=datetime('now'), updated_at=datetime('now')
-      WHERE id=?
-    `).run(taskId);
-    closeActiveLeasesForTaskTx(db, taskId, 'completed');
+    const activeLease = getActiveLeaseForTaskTx(db, taskId);
+    finalizeTaskWithLeaseTx(db, taskId, activeLease, {
+      taskStatus: 'done',
+      leaseStatus: 'completed',
+      auditStatus: 'allowed',
+      auditEventType: 'task_completed',
+    });
   });
 }
 
 export function failTask(db, taskId, reason) {
   withImmediateTransaction(db, () => {
+    const activeLease = getActiveLeaseForTaskTx(db, taskId);
+    finalizeTaskWithLeaseTx(db, taskId, activeLease, {
+      taskStatus: 'failed',
+      leaseStatus: 'failed',
+      failureReason: reason || 'unknown',
+      auditStatus: 'denied',
+      auditEventType: 'task_failed',
+      auditReasonCode: 'task_failed',
+    });
+  });
+}
+
+export function completeLeaseTask(db, leaseId) {
+  return withImmediateTransaction(db, () => {
+    const activeLease = getLeaseTx(db, leaseId);
+    if (!activeLease || activeLease.status !== 'active') {
+      return null;
+    }
+    finalizeTaskWithLeaseTx(db, activeLease.task_id, activeLease, {
+      taskStatus: 'done',
+      leaseStatus: 'completed',
+      auditStatus: 'allowed',
+      auditEventType: 'task_completed',
+    });
+    return getTaskTx(db, activeLease.task_id);
+  });
+}
+
+export function failLeaseTask(db, leaseId, reason) {
+  return withImmediateTransaction(db, () => {
+    const activeLease = getLeaseTx(db, leaseId);
+    if (!activeLease || activeLease.status !== 'active') {
+      return null;
+    }
+    finalizeTaskWithLeaseTx(db, activeLease.task_id, activeLease, {
+      taskStatus: 'failed',
+      leaseStatus: 'failed',
+      failureReason: reason || 'unknown',
+      auditStatus: 'denied',
+      auditEventType: 'task_failed',
+      auditReasonCode: 'task_failed',
+    });
+    return getTaskTx(db, activeLease.task_id);
+  });
+}
+
+export function retryTask(db, taskId, reason = null) {
+  return withImmediateTransaction(db, () => {
+    const task = getTaskTx(db, taskId);
+    if (!task || !['failed', 'done'].includes(task.status)) {
+      return null;
+    }
+
     db.prepare(`
       UPDATE tasks
-      SET status='failed', description=COALESCE(description,'') || '\nFAILED: ' || ?, updated_at=datetime('now')
-      WHERE id=?
-    `).run(reason || 'unknown', taskId);
-    closeActiveLeasesForTaskTx(db, taskId, 'failed', reason || 'unknown');
+      SET status='pending',
+          worktree=NULL,
+          agent=NULL,
+          completed_at=NULL,
+          updated_at=datetime('now')
+      WHERE id=? AND status IN ('failed', 'done')
+    `).run(taskId);
+
+    logAuditEventTx(db, {
+      eventType: 'task_retried',
+      status: 'allowed',
+      taskId,
+      details: reason || null,
+    });
+
+    resolveDependencyInvalidationsForAffectedTaskTx(db, taskId, 'task_retried');
+    syncPipelineBoundaryValidationStatesTx(db, getTaskSpec(db, taskId)?.pipeline_id || null, { source: 'task_retried' });
+
+    return getTaskTx(db, taskId);
   });
 }
 
@@ -385,6 +1372,39 @@ export function getTask(db, taskId) {
   return db.prepare(`SELECT * FROM tasks WHERE id=?`).get(taskId);
 }
 
+export function upsertTaskSpec(db, taskId, spec) {
+  db.prepare(`
+    INSERT INTO task_specs (task_id, spec_json, updated_at)
+    VALUES (?, ?, datetime('now'))
+    ON CONFLICT(task_id) DO UPDATE SET
+      spec_json=excluded.spec_json,
+      updated_at=datetime('now')
+  `).run(taskId, JSON.stringify(spec || {}));
+
+  const activeLease = getActiveLeaseForTaskTx(db, taskId);
+  if (activeLease) {
+    withImmediateTransaction(db, () => {
+      releaseScopeReservationsForLeaseTx(db, activeLease.id);
+      reserveLeaseScopesTx(db, activeLease);
+      const updatedState = computeBoundaryValidationStateTx(db, activeLease.id, { touched: false, source: 'task_spec_updated' });
+      if (updatedState) {
+        upsertBoundaryValidationStateTx(db, updatedState);
+      }
+      syncPipelineBoundaryValidationStatesTx(db, spec?.pipeline_id || null, { source: 'task_spec_updated' });
+    });
+  }
+}
+
+export function getTaskSpec(db, taskId) {
+  const row = db.prepare(`SELECT spec_json FROM task_specs WHERE task_id=?`).get(taskId);
+  if (!row) return null;
+  try {
+    return JSON.parse(row.spec_json);
+  } catch {
+    return null;
+  }
+}
+
 export function getNextPendingTask(db) {
   return db.prepare(`
     SELECT * FROM tasks WHERE status='pending'
@@ -411,6 +1431,136 @@ export function listLeases(db, statusFilter) {
   `).all();
 }
 
+export function listScopeReservations(db, { activeOnly = true, leaseId = null, taskId = null, worktree = null } = {}) {
+  const clauses = [];
+  const params = [];
+
+  if (activeOnly) {
+    clauses.push('released_at IS NULL');
+  }
+  if (leaseId) {
+    clauses.push('lease_id=?');
+    params.push(leaseId);
+  }
+  if (taskId) {
+    clauses.push('task_id=?');
+    params.push(taskId);
+  }
+  if (worktree) {
+    clauses.push('worktree=?');
+    params.push(worktree);
+  }
+
+  const where = clauses.length ? `WHERE ${clauses.join(' AND ')}` : '';
+  return db.prepare(`
+    SELECT *
+    FROM scope_reservations
+    ${where}
+    ORDER BY id ASC
+  `).all(...params);
+}
+
+export function getBoundaryValidationState(db, leaseId) {
+  const row = getBoundaryValidationStateTx(db, leaseId);
+  if (!row) return null;
+  return {
+    ...row,
+    missing_task_types: JSON.parse(row.missing_task_types || '[]'),
+    details: row.details ? JSON.parse(row.details) : {},
+  };
+}
+
+export function listBoundaryValidationStates(db, { status = null, pipelineId = null } = {}) {
+  const clauses = [];
+  const params = [];
+  if (status) {
+    clauses.push('status=?');
+    params.push(status);
+  }
+  if (pipelineId) {
+    clauses.push('pipeline_id=?');
+    params.push(pipelineId);
+  }
+  const where = clauses.length ? `WHERE ${clauses.join(' AND ')}` : '';
+  return db.prepare(`
+    SELECT *
+    FROM boundary_validation_state
+    ${where}
+    ORDER BY last_evaluated_at DESC, lease_id ASC
+  `).all(...params).map((row) => ({
+    ...row,
+    missing_task_types: JSON.parse(row.missing_task_types || '[]'),
+    details: row.details ? JSON.parse(row.details) : {},
+  }));
+}
+
+export function listDependencyInvalidations(db, { status = 'stale', pipelineId = null, affectedTaskId = null } = {}) {
+  const clauses = [];
+  const params = [];
+  if (status === 'stale') {
+    clauses.push('resolved_at IS NULL');
+  } else if (status === 'revalidated') {
+    clauses.push('resolved_at IS NOT NULL');
+  }
+  if (pipelineId) {
+    clauses.push('(source_pipeline_id=? OR affected_pipeline_id=?)');
+    params.push(pipelineId, pipelineId);
+  }
+  if (affectedTaskId) {
+    clauses.push('affected_task_id=?');
+    params.push(affectedTaskId);
+  }
+  const where = clauses.length ? `WHERE ${clauses.join(' AND ')}` : '';
+  return db.prepare(`
+    SELECT *
+    FROM dependency_invalidations
+    ${where}
+    ORDER BY created_at DESC, id DESC
+  `).all(...params).map((row) => ({
+    ...row,
+    details: row.details ? JSON.parse(row.details) : {},
+  }));
+}
+
+export function touchBoundaryValidationState(db, leaseId, source = 'write') {
+  return withImmediateTransaction(db, () => {
+    const state = computeBoundaryValidationStateTx(db, leaseId, { touched: true, source });
+    if (state) {
+      upsertBoundaryValidationStateTx(db, state);
+      logAuditEventTx(db, {
+        eventType: 'boundary_validation_state',
+        status: state.status === 'satisfied' ? 'allowed' : (state.status === 'blocked' ? 'denied' : 'warn'),
+        reasonCode: state.status === 'satisfied' ? null : 'boundary_validation_pending',
+        taskId: state.task_id,
+        leaseId: state.lease_id,
+        details: JSON.stringify({
+          status: state.status,
+          missing_task_types: state.missing_task_types,
+          source,
+        }),
+      });
+    }
+
+    const invalidations = syncDependencyInvalidationsForLeaseTx(db, leaseId, source);
+    if (invalidations.length > 0) {
+      logAuditEventTx(db, {
+        eventType: 'dependency_invalidations_updated',
+        status: 'warn',
+        reasonCode: 'dependent_work_stale',
+        taskId: state?.task_id || getLeaseTx(db, leaseId)?.task_id || null,
+        leaseId,
+        details: JSON.stringify({
+          source,
+          stale_count: invalidations.length,
+          affected_task_ids: [...new Set(invalidations.map((item) => item.affected_task_id))],
+        }),
+      });
+    }
+
+    return state ? getBoundaryValidationState(db, leaseId) : null;
+  });
+}
+
 export function getLease(db, leaseId) {
   return db.prepare(`
     SELECT l.*, t.title AS task_title
@@ -420,6 +1570,21 @@ export function getLease(db, leaseId) {
   `).get(leaseId);
 }
 
+export function getLeaseExecutionContext(db, leaseId) {
+  const lease = getLease(db, leaseId);
+  if (!lease) return null;
+  const task = getTask(db, lease.task_id);
+  const worktree = getWorktree(db, lease.worktree);
+  return {
+    lease,
+    task,
+    task_spec: task ? getTaskSpec(db, task.id) : null,
+    worktree,
+    claims: getActiveFileClaims(db).filter((claim) => claim.lease_id === lease.id),
+    scope_reservations: listScopeReservations(db, { leaseId: lease.id }),
+  };
+}
+
 export function getActiveLeaseForTask(db, taskId) {
   const lease = getActiveLeaseForTaskTx(db, taskId);
   return lease ? getLease(db, lease.id) : null;
@@ -439,6 +1604,14 @@ export function heartbeatLease(db, leaseId, agent) {
 
   const lease = getLease(db, leaseId);
   touchWorktreeLeaseState(db, lease.worktree, agent || lease.agent, 'busy');
+  logAuditEventTx(db, {
+    eventType: 'lease_heartbeated',
+    status: 'allowed',
+    worktree: lease.worktree,
+    taskId: lease.task_id,
+    leaseId: lease.id,
+    details: JSON.stringify({ agent: agent || lease.agent || null }),
+  });
   return lease;
 }
 
@@ -485,8 +1658,17 @@ export function reapStaleLeases(db, staleAfterMinutes = DEFAULT_STALE_LEASE_MINU
     for (const lease of staleLeases) {
       expireLease.run(lease.id);
       releaseClaimsForLeaseTx(db, lease.id);
+      releaseScopeReservationsForLeaseTx(db, lease.id);
       resetTask.run(lease.task_id, lease.task_id);
       touchWorktreeLeaseState(db, lease.worktree, lease.agent, 'idle');
+      logAuditEventTx(db, {
+        eventType: 'lease_expired',
+        status: 'denied',
+        reasonCode: 'lease_expired',
+        worktree: lease.worktree,
+        taskId: lease.task_id,
+        leaseId: lease.id,
+      });
     }
 
     return staleLeases.map((lease) => ({
@@ -534,6 +1716,14 @@ export function claimFiles(db, taskId, worktree, filePaths, agent) {
       }
 
       insert.run(taskId, lease.id, fp, worktree, agent || null);
+      logAuditEventTx(db, {
+        eventType: 'file_claimed',
+        status: 'allowed',
+        worktree,
+        taskId,
+        leaseId: lease.id,
+        filePath: fp,
+      });
     }
 
     db.prepare(`
@@ -549,10 +1739,7 @@ export function claimFiles(db, taskId, worktree, filePaths, agent) {
 }
 
 export function releaseFileClaims(db, taskId) {
-  db.prepare(`
-    UPDATE file_claims SET released_at=datetime('now')
-    WHERE task_id=? AND released_at IS NULL
-  `).run(taskId);
+  releaseClaimsForTaskTx(db, taskId);
 }
 
 export function releaseLeaseFileClaims(db, leaseId) {
@@ -571,6 +1758,27 @@ export function getActiveFileClaims(db) {
   `).all();
 }
 
+export function getCompletedFileClaims(db, worktree = null) {
+  if (worktree) {
+    return db.prepare(`
+      SELECT fc.*, t.title as task_title, t.status as task_status, t.completed_at
+      FROM file_claims fc
+      JOIN tasks t ON fc.task_id = t.id
+      WHERE fc.worktree=?
+        AND t.status='done'
+      ORDER BY COALESCE(fc.released_at, t.completed_at) DESC, fc.file_path
+    `).all(worktree);
+  }
+
+  return db.prepare(`
+    SELECT fc.*, t.title as task_title, t.status as task_status, t.completed_at
+    FROM file_claims fc
+    JOIN tasks t ON fc.task_id = t.id
+    WHERE t.status='done'
+    ORDER BY COALESCE(fc.released_at, t.completed_at) DESC, fc.file_path
+  `).all();
+}
+
 export function checkFileConflicts(db, filePaths, excludeWorktree) {
   const conflicts = [];
   const stmt = db.prepare(`
@@ -593,23 +1801,40 @@ export function checkFileConflicts(db, filePaths, excludeWorktree) {
 // ─── Worktrees ────────────────────────────────────────────────────────────────
 
 export function registerWorktree(db, { name, path, branch, agent }) {
+  const normalizedPath = normalizeWorktreePath(path);
+  const existingByPath = db.prepare(`SELECT name FROM worktrees WHERE path=?`).get(normalizedPath);
+  const canonicalName = existingByPath?.name || name;
   db.prepare(`
     INSERT INTO worktrees (name, path, branch, agent)
     VALUES (?, ?, ?, ?)
     ON CONFLICT(name) DO UPDATE SET
       path=excluded.path, branch=excluded.branch,
       agent=excluded.agent, last_seen=datetime('now'), status='idle'
-  `).run(name, path, branch, agent || null);
+  `).run(canonicalName, normalizedPath, branch, agent || null);
 }
 
 export function listWorktrees(db) {
   return db.prepare(`SELECT * FROM worktrees ORDER BY registered_at`).all();
 }
 
+export function getWorktree(db, name) {
+  return db.prepare(`SELECT * FROM worktrees WHERE name=?`).get(name);
+}
+
 export function updateWorktreeStatus(db, name, status) {
   db.prepare(`UPDATE worktrees SET status=?, last_seen=datetime('now') WHERE name=?`).run(status, name);
 }
 
+export function updateWorktreeCompliance(db, name, complianceState, enforcementMode = null) {
+  db.prepare(`
+    UPDATE worktrees
+    SET compliance_state=?,
+        enforcement_mode=COALESCE(?, enforcement_mode),
+        last_seen=datetime('now')
+    WHERE name=?
+  `).run(complianceState, enforcementMode, name);
+}
+
 // ─── Conflict Log ─────────────────────────────────────────────────────────────
 
 export function logConflict(db, worktreeA, worktreeB, conflictingFiles) {
@@ -619,6 +1844,172 @@ export function logConflict(db, worktreeA, worktreeB, conflictingFiles) {
   `).run(worktreeA, worktreeB, JSON.stringify(conflictingFiles));
 }
 
+export function logAuditEvent(db, payload) {
+  logAuditEventTx(db, payload);
+}
+
+export function listAuditEvents(db, { eventType = null, status = null, taskId = null, limit = 50 } = {}) {
+  if (eventType && status && taskId) {
+    return db.prepare(`
+      SELECT * FROM audit_log
+      WHERE event_type=? AND status=? AND task_id=?
+      ORDER BY created_at DESC, id DESC
+      LIMIT ?
+    `).all(eventType, status, taskId, limit);
+  }
+  if (eventType && taskId) {
+    return db.prepare(`
+      SELECT * FROM audit_log
+      WHERE event_type=? AND task_id=?
+      ORDER BY created_at DESC, id DESC
+      LIMIT ?
+    `).all(eventType, taskId, limit);
+  }
+  if (status && taskId) {
+    return db.prepare(`
+      SELECT * FROM audit_log
+      WHERE status=? AND task_id=?
+      ORDER BY created_at DESC, id DESC
+      LIMIT ?
+    `).all(status, taskId, limit);
+  }
+  if (eventType && status) {
+    return db.prepare(`
+      SELECT * FROM audit_log
+      WHERE event_type=? AND status=?
+      ORDER BY created_at DESC, id DESC
+      LIMIT ?
+    `).all(eventType, status, limit);
+  }
+  if (eventType) {
+    return db.prepare(`
+      SELECT * FROM audit_log
+      WHERE event_type=?
+      ORDER BY created_at DESC, id DESC
+      LIMIT ?
+    `).all(eventType, limit);
+  }
+  if (status) {
+    return db.prepare(`
+      SELECT * FROM audit_log
+      WHERE status=?
+      ORDER BY created_at DESC, id DESC
+      LIMIT ?
+    `).all(status, limit);
+  }
+  return db.prepare(`
+    SELECT * FROM audit_log
+    ORDER BY created_at DESC, id DESC
+    LIMIT ?
+  `).all(limit);
+}
+
+export function verifyAuditTrail(db) {
+  const { secret } = getAuditContext(db);
+  const events = db.prepare(`
+    SELECT *
+    FROM audit_log
+    ORDER BY sequence ASC, id ASC
+  `).all();
+
+  const failures = [];
+  let expectedSequence = 1;
+  let expectedPrevHash = null;
+
+  for (const event of events) {
+    if (event.sequence == null) {
+      failures.push({ id: event.id, reason_code: 'missing_sequence', message: 'Audit event is missing sequence metadata.' });
+      continue;
+    }
+    if (event.sequence !== expectedSequence) {
+      failures.push({
+        id: event.id,
+        sequence: event.sequence,
+        reason_code: 'sequence_gap',
+        message: `Expected sequence ${expectedSequence} but found ${event.sequence}.`,
+      });
+      expectedSequence = event.sequence;
+    }
+    if ((event.prev_hash || null) !== expectedPrevHash) {
+      failures.push({
+        id: event.id,
+        sequence: event.sequence,
+        reason_code: 'prev_hash_mismatch',
+        message: 'Previous hash does not match the prior audit event.',
+      });
+    }
+
+    const recomputedHash = computeAuditEntryHash({
+      sequence: event.sequence,
+      prevHash: event.prev_hash || null,
+      eventType: event.event_type,
+      status: event.status,
+      reasonCode: event.reason_code,
+      worktree: event.worktree,
+      taskId: event.task_id,
+      leaseId: event.lease_id,
+      filePath: event.file_path,
+      details: event.details,
+      createdAt: event.created_at,
+    });
+    if (event.entry_hash !== recomputedHash) {
+      failures.push({
+        id: event.id,
+        sequence: event.sequence,
+        reason_code: 'entry_hash_mismatch',
+        message: 'Audit event payload hash does not match the stored entry hash.',
+      });
+    }
+
+    const expectedSignature = signAuditEntry(secret, recomputedHash);
+    if (event.signature !== expectedSignature) {
+      failures.push({
+        id: event.id,
+        sequence: event.sequence,
+        reason_code: 'signature_mismatch',
+        message: 'Audit event signature does not match the project audit key.',
+      });
+    }
+
+    expectedPrevHash = event.entry_hash || null;
+    expectedSequence += 1;
+  }
+
+  return {
+    ok: failures.length === 0,
+    count: events.length,
+    failures,
+  };
+}
+
+export function getWorktreeSnapshotState(db, worktree) {
+  const rows = db.prepare(`
+    SELECT * FROM worktree_snapshots
+    WHERE worktree=?
+    ORDER BY file_path
+  `).all(worktree);
+
+  return new Map(rows.map((row) => [row.file_path, row.fingerprint]));
+}
+
+export function replaceWorktreeSnapshotState(db, worktree, snapshot) {
+  withImmediateTransaction(db, () => {
+    db.prepare(`
+      DELETE FROM worktree_snapshots
+      WHERE worktree=?
+    `).run(worktree);
+
+    const insert = db.prepare(`
+      INSERT INTO worktree_snapshots (worktree, file_path, fingerprint)
+      VALUES (?, ?, ?)
+    `);
+
+    for (const [filePath, fingerprint] of snapshot.entries()) {
+      insert.run(worktree, filePath, fingerprint);
+    }
+  });
+}
+
 export function getConflictLog(db) {
   return db.prepare(`SELECT * FROM conflict_log ORDER BY detected_at DESC LIMIT 50`).all();
 }