@cleocode/playbooks 2026.10.18 → 2026.10.19

package/dist/approval.d.ts

@@ -51,7 +51,7 @@ export declare function generateResumeToken(runId: string, nodeId: string, bindi
  * Input for {@link createApprovalGate}.
  */
 export interface CreateApprovalGateInput {
-    /** Run identifier (FK to `playbook_runs.run_id`). */
+    /** Run identifier (FK to `tasks_playbook_runs.run_id`). */
     runId: string;
     /** Node identifier within the run graph. */
     nodeId: string;
@@ -67,7 +67,7 @@ export interface CreateApprovalGateInput {
     secret?: string;
 }
 /**
- * Create an HITL approval gate row in `playbook_approvals`.
+ * Create an HITL approval gate row in `tasks_playbook_approvals`.
  *
  * If `autoPassed` is true, the gate is written with `status='approved'`
  * and `auto_passed=1` — used by the policy engine to short-circuit gates

package/dist/approval.js

@@ -72,7 +72,7 @@ export function generateResumeToken(runId, nodeId, bindings, secret = getPlayboo
 function narrowStatus(s) {
     if (s === 'pending' || s === 'approved' || s === 'rejected')
         return s;
-    throw new Error(`invariant: unknown playbook_approvals.status '${s}'`);
+    throw new Error(`invariant: unknown tasks_playbook_approvals.status '${s}'`);
 }
 /**
  * Read a required string column from a raw sqlite row.
@@ -115,7 +115,7 @@ function readOptionalString(row, key) {
     return v;
 }
 /**
- * Map a raw `playbook_approvals` row to the camelCase {@link PlaybookApproval}
+ * Map a raw `tasks_playbook_approvals` row to the camelCase {@link PlaybookApproval}
  * contract shape. Validates types, converts the `auto_passed` 0/1 integer to
  * a boolean, and strips nullable fields rather than emitting `null`.
  *
@@ -143,7 +143,7 @@ function rowToApproval(row) {
     return approval;
 }
 /**
- * Create an HITL approval gate row in `playbook_approvals`.
+ * Create an HITL approval gate row in `tasks_playbook_approvals`.
  *
  * If `autoPassed` is true, the gate is written with `status='approved'`
  * and `auto_passed=1` — used by the policy engine to short-circuit gates
@@ -160,13 +160,13 @@ export function createApprovalGate(db, input) {
     const autoPassed = input.autoPassed ?? false;
     const status = autoPassed ? 'approved' : 'pending';
     const stmt = db.prepare(`
-    INSERT INTO playbook_approvals
+    INSERT INTO tasks_playbook_approvals
       (approval_id, run_id, node_id, token, status, auto_passed, approver, reason)
     VALUES (?, ?, ?, ?, ?, ?, ?, ?)
   `);
     stmt.run(approvalId, input.runId, input.nodeId, token, status, autoPassed ? 1 : 0, input.approver ?? null, input.reason ?? null);
     const row = db
-        .prepare('SELECT * FROM playbook_approvals WHERE approval_id = ?')
+        .prepare('SELECT * FROM tasks_playbook_approvals WHERE approval_id = ?')
         .get(approvalId);
     if (row === undefined) {
         throw new Error(`${E_APPROVAL_NOT_FOUND}: insert did not round-trip (approval_id=${approvalId})`);
@@ -209,7 +209,9 @@ export function rejectGate(db, token, approver, reason) {
  * @internal
  */
 function transitionGate(db, token, next, approver, reason) {
-    const existing = db.prepare('SELECT * FROM playbook_approvals WHERE token = ?').get(token);
+    const existing = db
+        .prepare('SELECT * FROM tasks_playbook_approvals WHERE token = ?')
+        .get(token);
     if (existing === undefined) {
         throw new Error(`${E_APPROVAL_NOT_FOUND}: no approval gate for token`);
     }
@@ -218,10 +220,10 @@ function transitionGate(db, token, next, approver, reason) {
         const approvalId = readString(existing, 'approval_id');
         throw new Error(`${E_APPROVAL_ALREADY_DECIDED}: gate ${approvalId} is already ${existingStatus}`);
     }
-    db.prepare(`UPDATE playbook_approvals
+    db.prepare(`UPDATE tasks_playbook_approvals
        SET status = ?, approved_at = datetime('now'), approver = ?, reason = ?
      WHERE token = ?`).run(next, approver, reason ?? null, token);
-    const row = db.prepare('SELECT * FROM playbook_approvals WHERE token = ?').get(token);
+    const row = db.prepare('SELECT * FROM tasks_playbook_approvals WHERE token = ?').get(token);
     if (row === undefined) {
         // Unreachable: UPDATE just succeeded on this token.
         throw new Error(`${E_APPROVAL_NOT_FOUND}: row vanished after update (token=${token})`);
@@ -236,7 +238,7 @@ function transitionGate(db, token, next, approver, reason) {
  */
 export function getPendingApprovals(db) {
     const rows = db
-        .prepare(`SELECT * FROM playbook_approvals
+        .prepare(`SELECT * FROM tasks_playbook_approvals
         WHERE status = 'pending'
         ORDER BY requested_at ASC, approval_id ASC`)
         .all();

package/dist/state.d.ts

@@ -1,5 +1,5 @@
 /**
- * State layer for playbook runtime — CRUD against playbook_runs + playbook_approvals.
+ * State layer for playbook runtime — CRUD against tasks_playbook_runs + tasks_playbook_approvals.
  * Uses node:sqlite DatabaseSync for consistency with rest of CLEO.
  *
  * All JSON-shaped columns (`bindings`, `iteration_counts`) are serialized to
@@ -67,9 +67,10 @@ export declare function updatePlaybookRun(db: DatabaseSync, runId: string, patch
  */
 export declare function listPlaybookRuns(db: DatabaseSync, opts?: ListPlaybookRunsOptions): PlaybookRun[];
 /**
- * Deletes a playbook run by primary key. Returns `true` if a row was removed.
- * CASCADE wipes all associated approvals via the foreign-key constraint on
- * `playbook_approvals.run_id`.
+ * Deletes a playbook run by primary key, with its approvals, in one
+ * transaction. Returns `true` if the run was removed. `tasks_playbook_approvals`
+ * has no foreign key to the run (the bare twin cascaded), so the approvals are
+ * deleted first, explicitly: each delete is then a captured op of its own.
  */
 export declare function deletePlaybookRun(db: DatabaseSync, runId: string): boolean;
 /**

package/dist/state.js

@@ -1,5 +1,5 @@
 /**
- * State layer for playbook runtime — CRUD against playbook_runs + playbook_approvals.
+ * State layer for playbook runtime — CRUD against tasks_playbook_runs + tasks_playbook_approvals.
  * Uses node:sqlite DatabaseSync for consistency with rest of CLEO.
  *
  * All JSON-shaped columns (`bindings`, `iteration_counts`) are serialized to
@@ -30,7 +30,7 @@ function parseJsonColumn(raw, column, runId) {
     }
 }
 /**
- * Maps a snake_case `playbook_runs` row to the contract-shaped
+ * Maps a snake_case `tasks_playbook_runs` row to the contract-shaped
  * {@link PlaybookRun}. Performs strict JSON parsing and validates the status
  * column against the enum.
  */
@@ -53,7 +53,7 @@ function rowToPlaybookRun(row) {
     };
 }
 /**
- * Maps a snake_case `playbook_approvals` row to the contract-shaped
+ * Maps a snake_case `tasks_playbook_approvals` row to the contract-shaped
  * {@link PlaybookApproval}. Converts the integer `auto_passed` column to a
  * boolean at the boundary.
  */
@@ -83,12 +83,12 @@ function rowToPlaybookApproval(row) {
 export function createPlaybookRun(db, input) {
     const runId = randomUUID();
     const bindingsJson = JSON.stringify(input.initialBindings ?? {});
-    const insert = db.prepare(`INSERT INTO playbook_runs (
+    const insert = db.prepare(`INSERT INTO tasks_playbook_runs (
        run_id, playbook_name, playbook_hash, bindings, status,
        iteration_counts, epic_id, session_id
      ) VALUES (?, ?, ?, ?, 'running', '{}', ?, ?)`);
     insert.run(runId, input.playbookName, input.playbookHash, bindingsJson, input.epicId ?? null, input.sessionId ?? null);
-    const row = db.prepare('SELECT * FROM playbook_runs WHERE run_id = ?').get(runId);
+    const row = db.prepare('SELECT * FROM tasks_playbook_runs WHERE run_id = ?').get(runId);
     if (!row) {
         throw new Error(`playbook state: failed to read back run ${runId} after insert`);
     }
@@ -99,7 +99,7 @@ export function createPlaybookRun(db, input) {
  * does not exist. Never throws on missing rows.
  */
 export function getPlaybookRun(db, runId) {
-    const row = db.prepare('SELECT * FROM playbook_runs WHERE run_id = ?').get(runId);
+    const row = db.prepare('SELECT * FROM tasks_playbook_runs WHERE run_id = ?').get(runId);
     return row ? rowToPlaybookRun(row) : null;
 }
 /**
@@ -159,7 +159,7 @@ export function updatePlaybookRun(db, runId, patch) {
     }
     db.exec('BEGIN');
     try {
-        const stmt = db.prepare(`UPDATE playbook_runs SET ${sets.join(', ')} WHERE run_id = ?`);
+        const stmt = db.prepare(`UPDATE tasks_playbook_runs SET ${sets.join(', ')} WHERE run_id = ?`);
         values.push(runId);
         const result = stmt.run(...values);
         if (result.changes === 0) {
@@ -171,7 +171,7 @@ export function updatePlaybookRun(db, runId, patch) {
         db.exec('ROLLBACK');
         throw err;
     }
-    const row = db.prepare('SELECT * FROM playbook_runs WHERE run_id = ?').get(runId);
+    const row = db.prepare('SELECT * FROM tasks_playbook_runs WHERE run_id = ?').get(runId);
     if (!row) {
         throw new Error(`playbook state: run ${runId} disappeared after update`);
     }
@@ -196,18 +196,28 @@ export function listPlaybookRuns(db, opts = {}) {
     const limitClause = typeof opts.limit === 'number' ? 'LIMIT ?' : '';
     if (limitClause)
         values.push(opts.limit ?? 0);
-    const sql = `SELECT * FROM playbook_runs ${where} ORDER BY started_at DESC ${limitClause}`;
+    const sql = `SELECT * FROM tasks_playbook_runs ${where} ORDER BY started_at DESC ${limitClause}`;
     const rows = db.prepare(sql).all(...values);
     return rows.map(rowToPlaybookRun);
 }
 /**
- * Deletes a playbook run by primary key. Returns `true` if a row was removed.
- * CASCADE wipes all associated approvals via the foreign-key constraint on
- * `playbook_approvals.run_id`.
+ * Deletes a playbook run by primary key, with its approvals, in one
+ * transaction. Returns `true` if the run was removed. `tasks_playbook_approvals`
+ * has no foreign key to the run (the bare twin cascaded), so the approvals are
+ * deleted first, explicitly: each delete is then a captured op of its own.
  */
 export function deletePlaybookRun(db, runId) {
-    const result = db.prepare('DELETE FROM playbook_runs WHERE run_id = ?').run(runId);
-    return Number(result.changes) > 0;
+    db.exec('BEGIN');
+    try {
+        db.prepare('DELETE FROM tasks_playbook_approvals WHERE run_id = ?').run(runId);
+        const result = db.prepare('DELETE FROM tasks_playbook_runs WHERE run_id = ?').run(runId);
+        db.exec('COMMIT');
+        return Number(result.changes) > 0;
+    }
+    catch (err) {
+        db.exec('ROLLBACK');
+        throw err;
+    }
 }
 // ---------------------------------------------------------------------------
 // Playbook approval CRUD
@@ -220,11 +230,11 @@ export function deletePlaybookRun(db, runId) {
 export function createPlaybookApproval(db, input) {
     const approvalId = randomUUID();
     const autoPassed = input.autoPassed ? 1 : 0;
-    db.prepare(`INSERT INTO playbook_approvals (
+    db.prepare(`INSERT INTO tasks_playbook_approvals (
        approval_id, run_id, node_id, token, status, auto_passed
      ) VALUES (?, ?, ?, ?, 'pending', ?)`).run(approvalId, input.runId, input.nodeId, input.token, autoPassed);
     const row = db
-        .prepare('SELECT * FROM playbook_approvals WHERE approval_id = ?')
+        .prepare('SELECT * FROM tasks_playbook_approvals WHERE approval_id = ?')
         .get(approvalId);
     if (!row) {
         throw new Error(`playbook state: failed to read back approval ${approvalId} after insert`);
@@ -236,7 +246,7 @@ export function createPlaybookApproval(db, input) {
  * The token column carries a UNIQUE constraint so at most one row is returned.
  */
 export function getPlaybookApprovalByToken(db, token) {
-    const row = db.prepare('SELECT * FROM playbook_approvals WHERE token = ?').get(token);
+    const row = db.prepare('SELECT * FROM tasks_playbook_approvals WHERE token = ?').get(token);
     return row ? rowToPlaybookApproval(row) : null;
 }
 /**
@@ -276,7 +286,7 @@ export function updatePlaybookApproval(db, approvalId, patch) {
         // same guard transitionGate applies): a peer would refuse the move, so
         // the origin refuses it too (T12944).
         const current = db
-            .prepare('SELECT status FROM playbook_approvals WHERE approval_id = ?')
+            .prepare('SELECT status FROM tasks_playbook_approvals WHERE approval_id = ?')
             .get(approvalId);
         if (current && current.status !== 'pending' && current.status !== patch.status) {
             // @sync-invariant playbook.approval.once a decided gate keeps its decision locally, as every peer's merge keeps it
@@ -291,7 +301,7 @@ export function updatePlaybookApproval(db, approvalId, patch) {
     }
     if (sets.length === 0) {
         const row = db
-            .prepare('SELECT * FROM playbook_approvals WHERE approval_id = ?')
+            .prepare('SELECT * FROM tasks_playbook_approvals WHERE approval_id = ?')
             .get(approvalId);
         if (!row) {
             throw new Error(`playbook state: approval ${approvalId} not found for update`);
@@ -300,7 +310,7 @@ export function updatePlaybookApproval(db, approvalId, patch) {
     }
     db.exec('BEGIN');
     try {
-        const stmt = db.prepare(`UPDATE playbook_approvals SET ${sets.join(', ')} WHERE approval_id = ?`);
+        const stmt = db.prepare(`UPDATE tasks_playbook_approvals SET ${sets.join(', ')} WHERE approval_id = ?`);
         values.push(approvalId);
         const result = stmt.run(...values);
         if (result.changes === 0) {
@@ -313,7 +323,7 @@ export function updatePlaybookApproval(db, approvalId, patch) {
         throw err;
     }
     const row = db
-        .prepare('SELECT * FROM playbook_approvals WHERE approval_id = ?')
+        .prepare('SELECT * FROM tasks_playbook_approvals WHERE approval_id = ?')
         .get(approvalId);
     if (!row) {
         throw new Error(`playbook state: approval ${approvalId} disappeared after update`);
@@ -326,7 +336,7 @@ export function updatePlaybookApproval(db, approvalId, patch) {
  */
 export function listPlaybookApprovals(db, runId) {
     const rows = db
-        .prepare('SELECT * FROM playbook_approvals WHERE run_id = ? ORDER BY requested_at ASC, approval_id ASC')
+        .prepare('SELECT * FROM tasks_playbook_approvals WHERE run_id = ? ORDER BY requested_at ASC, approval_id ASC')
         .all(runId);
     return rows.map(rowToPlaybookApproval);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/playbooks",
-  "version": "2026.10.18",
+  "version": "2026.10.19",
   "description": "Playbook DSL + runtime for CLEO — T889 Orchestration Coherence v3",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,8 +19,8 @@
   "dependencies": {
     "drizzle-orm": "1.0.0-rc.4",
     "js-yaml": "^4.1.0",
-    "@cleocode/core": "2026.10.18",
-    "@cleocode/contracts": "2026.10.18"
+    "@cleocode/contracts": "2026.10.19",
+    "@cleocode/core": "2026.10.19"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",

package/src/__tests__/approval.test.ts

@@ -7,11 +7,8 @@
  * @task T889 / T908 / W4-16
  */
 
-import { readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
-import { dirname, resolve } from 'node:path';
 import type { DatabaseSync as _DatabaseSyncType } from 'node:sqlite';
-import { fileURLToPath } from 'node:url';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 import {
   approveGate,
@@ -23,6 +20,7 @@ import {
   getPlaybookSecret,
   rejectGate,
 } from '../approval.js';
+import { applyPlaybookTwinSchema } from './twin-schema.js';
 
 const _require = createRequire(import.meta.url);
 type DatabaseSync = _DatabaseSyncType;
@@ -30,27 +28,9 @@ const { DatabaseSync } = _require('node:sqlite') as {
   DatabaseSync: new (...args: ConstructorParameters<typeof _DatabaseSyncType>) => DatabaseSync;
 };
 
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const MIGRATION_SQL = resolve(
-  __dirname,
-  '../../../core/migrations/drizzle-tasks/20260417220000_t889-playbook-tables/migration.sql',
-);
-
-function applyMigration(db: DatabaseSync, sql: string): void {
-  const statements = sql
-    .split(/--> statement-breakpoint/)
-    .map((s) => s.trim())
-    .filter((s) => s.length > 0);
-  for (const stmt of statements) {
-    const lines = stmt.split('\n');
-    const hasSql = lines.some((l) => l.trim().length > 0 && !l.trim().startsWith('--'));
-    if (hasSql) db.exec(stmt);
-  }
-}
-
 function seedRun(db: DatabaseSync, runId: string): void {
   db.prepare(
-    `INSERT INTO playbook_runs (run_id, playbook_name, playbook_hash)
+    `INSERT INTO tasks_playbook_runs (run_id, playbook_name, playbook_hash)
      VALUES (?, 'rcasd', 'hash')`,
   ).run(runId);
 }
@@ -103,7 +83,7 @@ describe('W4-16: Approval DB operations', () => {
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL, 'utf8'));
+    applyPlaybookTwinSchema(db);
     seedRun(db, 'run-1');
   });
 
@@ -143,7 +123,7 @@ describe('W4-16: Approval DB operations', () => {
     expect(approval.reason).toBe('auto-approve low-risk deterministic step');
 
     const row = db
-      .prepare('SELECT auto_passed FROM playbook_approvals WHERE approval_id = ?')
+      .prepare('SELECT auto_passed FROM tasks_playbook_approvals WHERE approval_id = ?')
       .get(approval.approvalId) as { auto_passed: number };
     expect(row.auto_passed).toBe(1);
   });
@@ -266,7 +246,7 @@ describe('W4-16: Approval DB operations', () => {
 
     // Query by token round-trips the same approvalId
     const lookup = db
-      .prepare('SELECT approval_id FROM playbook_approvals WHERE token = ?')
+      .prepare('SELECT approval_id FROM tasks_playbook_approvals WHERE token = ?')
       .get(a.token) as { approval_id: string };
     expect(lookup.approval_id).toBe(a.approvalId);
 

package/src/__tests__/guarded-deterministic-dispatch.test.ts

@@ -33,12 +33,11 @@
  * @saga T11387
  */
 
-import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { mkdtempSync, rmSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { tmpdir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
+import { join } from 'node:path';
 import type { DatabaseSync as _DatabaseSyncType } from 'node:sqlite';
-import { fileURLToPath } from 'node:url';
 import type { PlaybookDefinition, PlaybookDeterministicNode } from '@cleocode/contracts';
 import {
   createGuardedDeterministicRunner,
@@ -47,6 +46,7 @@ import {
 } from '@cleocode/core/internal';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 import { type DeterministicRunner, executePlaybook } from '../runtime.js';
+import { playbookTwinSql } from './twin-schema.js';
 
 const _require = createRequire(import.meta.url);
 type DatabaseSync = _DatabaseSyncType;
@@ -54,13 +54,7 @@ const { DatabaseSync } = _require('node:sqlite') as {
   DatabaseSync: new (...args: ConstructorParameters<typeof _DatabaseSyncType>) => DatabaseSync;
 };
 
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
 /** Absolute path to the T889 playbook-tables migration SQL. */
-const MIGRATION_SQL = resolve(
-  __dirname,
-  '../../../core/migrations/drizzle-tasks/20260417220000_t889-playbook-tables/migration.sql',
-);
 
 /** Apply a multi-statement Drizzle migration (split on the breakpoint token). */
 function applyMigration(db: DatabaseSync, sql: string): void {
@@ -87,7 +81,7 @@ describe('T11802 (M4): deterministic node dispatch routes through guard.ts', ()
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL, 'utf8'));
+    applyMigration(db, playbookTwinSql());
     projectRoot = mkdtempSync(join(tmpdir(), 't11802-guarded-shell-'));
   });
 

package/src/__tests__/inputs-bindings.test.ts

@@ -18,11 +18,8 @@
  * @task T1944 — wire PlaybookAgenticNode.inputs → AgentDispatchInput.bindings
  */
 
-import { readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
-import { dirname, resolve } from 'node:path';
 import type { DatabaseSync as _DatabaseSyncType } from 'node:sqlite';
-import { fileURLToPath } from 'node:url';
 import type { PlaybookAgenticNode, PlaybookDefinition } from '@cleocode/contracts';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 import {
@@ -32,6 +29,7 @@ import {
   executePlaybook,
   resolveStepBindings,
 } from '../runtime.js';
+import { playbookTwinSql } from './twin-schema.js';
 
 const _require = createRequire(import.meta.url);
 type DatabaseSync = _DatabaseSyncType;
@@ -39,12 +37,6 @@ const { DatabaseSync } = _require('node:sqlite') as {
   DatabaseSync: new (...args: ConstructorParameters<typeof _DatabaseSyncType>) => DatabaseSync;
 };
 
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const MIGRATION_SQL = resolve(
-  __dirname,
-  '../../../core/migrations/drizzle-tasks/20260417220000_t889-playbook-tables/migration.sql',
-);
-
 function applyMigration(db: DatabaseSync, sql: string): void {
   const statements = sql
     .split(/--> statement-breakpoint/)
@@ -169,7 +161,7 @@ describe('T1944: AgentDispatchInput.bindings (in-process)', () => {
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL, 'utf8'));
+    applyMigration(db, playbookTwinSql());
   });
   afterEach(() => db.close());
 

package/src/__tests__/node-allowlist.test.ts

@@ -19,11 +19,8 @@
  * @task T1947
  */
 
-import { readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
-import { dirname, resolve } from 'node:path';
 import type { DatabaseSync as _DatabaseSyncType } from 'node:sqlite';
-import { fileURLToPath } from 'node:url';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 import { parsePlaybook } from '../parser.js';
 import {
@@ -32,6 +29,7 @@ import {
   type AgentDispatchResult,
   executePlaybook,
 } from '../runtime.js';
+import { playbookTwinSql } from './twin-schema.js';
 
 const _require = createRequire(import.meta.url);
 type DatabaseSync = _DatabaseSyncType;
@@ -39,12 +37,6 @@ const { DatabaseSync } = _require('node:sqlite') as {
   DatabaseSync: new (...args: ConstructorParameters<typeof _DatabaseSyncType>) => DatabaseSync;
 };
 
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const MIGRATION_SQL = resolve(
-  __dirname,
-  '../../../core/migrations/drizzle-tasks/20260417220000_t889-playbook-tables/migration.sql',
-);
-
 function applyMigration(db: DatabaseSync, sql: string): void {
   const statements = sql
     .split(/--> statement-breakpoint/)
@@ -125,7 +117,7 @@ describe('T1947: AC5 — allowlists reach the dispatch boundary', () => {
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL, 'utf8'));
+    applyMigration(db, playbookTwinSql());
   });
   afterEach(() => db.close());
 

package/src/__tests__/node-profile.test.ts

@@ -16,11 +16,8 @@
  * @task T11759
  */
 
-import { readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
-import { dirname, resolve } from 'node:path';
 import type { DatabaseSync as _DatabaseSyncType } from 'node:sqlite';
-import { fileURLToPath } from 'node:url';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 import { parsePlaybook } from '../parser.js';
 import {
@@ -29,6 +26,7 @@ import {
   type AgentDispatchResult,
   executePlaybook,
 } from '../runtime.js';
+import { playbookTwinSql } from './twin-schema.js';
 
 const _require = createRequire(import.meta.url);
 type DatabaseSync = _DatabaseSyncType;
@@ -36,12 +34,6 @@ const { DatabaseSync } = _require('node:sqlite') as {
   DatabaseSync: new (...args: ConstructorParameters<typeof _DatabaseSyncType>) => DatabaseSync;
 };
 
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const MIGRATION_SQL = resolve(
-  __dirname,
-  '../../../core/migrations/drizzle-tasks/20260417220000_t889-playbook-tables/migration.sql',
-);
-
 function applyMigration(db: DatabaseSync, sql: string): void {
   const statements = sql
     .split(/--> statement-breakpoint/)
@@ -72,7 +64,7 @@ describe('T11759: node profile pin reaches the dispatch boundary', () => {
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL, 'utf8'));
+    applyMigration(db, playbookTwinSql());
   });
   afterEach(() => db.close());
 

package/src/__tests__/pi-cantbook-e2e.test.ts

@@ -5,9 +5,9 @@
  *
  * ## What this proves (the M4 keystone)
  *
- * The two production cantbook dispatchers (`buildDefaultDispatcher` in
- * `packages/cleo/src/dispatch/domains/playbook.ts` and `buildGoDispatcher` in
- * `packages/cleo/src/cli/commands/go-ivtr-runner.ts`) now pass
+ * The production cantbook dispatcher (`buildDefaultDispatcher` in
+ * `packages/cleo/src/dispatch/domains/playbook.ts`; `cleo go`'s
+ * `buildGoDispatcher` was retired in T13821) passes
  * `runner: await maybeCreatePiRunner({ system, projectRoot })` into
  * {@link runSkillNodeOrSpawn}. This test reconstructs that EXACT production
  * dispatcher shape (`createToolGuard` + `runSkillNodeOrSpawn` + the
@@ -60,6 +60,7 @@ import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 import { parsePlaybook } from '../parser.js';
 import { executePlaybook } from '../runtime.js';
 import { getPlaybookRun } from '../state.js';
+import { playbookTwinSql } from './twin-schema.js';
 
 const _require = createRequire(import.meta.url);
 type DatabaseSync = _DatabaseSyncType;
@@ -70,10 +71,6 @@ const { DatabaseSync } = _require('node:sqlite') as {
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
 /** Absolute path to the T889 playbook-tables migration SQL. */
-const MIGRATION_SQL_PATH = resolve(
-  __dirname,
-  '../../../core/migrations/drizzle-tasks/20260417220000_t889-playbook-tables/migration.sql',
-);
 
 /** The skill-only fixture cantbook materialised for this suite. */
 const FIXTURE_PATH = resolve(__dirname, 'fixtures/pi-skill-only.cantbook');
@@ -187,7 +184,7 @@ describe('T11945 (M4): skill-only .cantbook routes through the PiAgentAdapter',
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL_PATH, 'utf8'));
+    applyMigration(db, playbookTwinSql());
 
     projectRoot = mkdtempSync(join(tmpdir(), 't11945-pi-e2e-'));
     writeFixtureSkill(projectRoot);

package/src/__tests__/rcasd-one-envelope.test.ts

@@ -50,6 +50,7 @@ import {
   type ExecutePlaybookResult,
   executePlaybook,
 } from '../runtime.js';
+import { playbookTwinSql } from './twin-schema.js';
 
 const _require = createRequire(import.meta.url);
 type DatabaseSync = _DatabaseSyncType;
@@ -60,10 +61,6 @@ const { DatabaseSync } = _require('node:sqlite') as {
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PLAYBOOKS_SRC = resolve(__dirname, '..');
 
-const MIGRATION_SQL = resolve(
-  __dirname,
-  '../../../core/migrations/drizzle-tasks/20260417220000_t889-playbook-tables/migration.sql',
-);
 const RCASD_CANTBOOK = resolve(__dirname, '../../starter/rcasd.cantbook');
 
 function applyMigration(db: DatabaseSync, sql: string): void {
@@ -155,7 +152,7 @@ describe('T11803 (M4): rcasd.cantbook → exactly ONE LAFS envelope, no GenKit',
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL, 'utf8'));
+    applyMigration(db, playbookTwinSql());
   });
   afterEach(() => db.close());
 

package/src/__tests__/runtime.test.ts

@@ -35,6 +35,7 @@ import {
   resumePlaybook,
 } from '../runtime.js';
 import { getPlaybookRun, listPlaybookApprovals } from '../state.js';
+import { applyPlaybookTwinSchema } from './twin-schema.js';
 
 const _require = createRequire(import.meta.url);
 type DatabaseSync = _DatabaseSyncType;
@@ -43,24 +44,8 @@ const { DatabaseSync } = _require('node:sqlite') as {
 };
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const MIGRATION_SQL = resolve(
-  __dirname,
-  '../../../core/migrations/drizzle-tasks/20260417220000_t889-playbook-tables/migration.sql',
-);
 const CONDITIONAL_BRANCH_CANTBOOK = resolve(__dirname, 'fixtures/conditional-branch.cantbook');
 
-function applyMigration(db: DatabaseSync, sql: string): void {
-  const statements = sql
-    .split(/--> statement-breakpoint/)
-    .map((s) => s.trim())
-    .filter((s) => s.length > 0);
-  for (const stmt of statements) {
-    const lines = stmt.split('\n');
-    const hasSql = lines.some((l) => l.trim().length > 0 && !l.trim().startsWith('--'));
-    if (hasSql) db.exec(stmt);
-  }
-}
-
 // -- Dispatcher stub helpers -------------------------------------------------
 
 interface RecordedCall {
@@ -158,7 +143,7 @@ describe('W4-10 / T930: playbook runtime state machine', () => {
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL, 'utf8'));
+    applyPlaybookTwinSchema(db);
   });
   afterEach(() => db.close());
 
@@ -674,7 +659,7 @@ describe('W4-10 / T930: playbook runtime state machine', () => {
     // The SQLite migration stamps completedAt via JS, and updatePlaybookRun
     // writes our supplied timestamp.
     const runs = db
-      .prepare("SELECT completed_at FROM playbook_runs WHERE playbook_name = 'clock'")
+      .prepare("SELECT completed_at FROM tasks_playbook_runs WHERE playbook_name = 'clock'")
       .all() as Array<{ completed_at: string }>;
     expect(runs[0]?.completed_at).toBe('2026-04-17T22:30:00.000Z');
   });
@@ -690,7 +675,7 @@ describe('T11806: cantbook runtime guarded branching', () => {
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL, 'utf8'));
+    applyPlaybookTwinSchema(db);
   });
   afterEach(() => db.close());
 
@@ -923,7 +908,7 @@ describe('T11762 ST-2: registry-driven ensures.schema enforcement', () => {
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL, 'utf8'));
+    applyPlaybookTwinSchema(db);
     tmpRoot = mkdtempSync(join(tmpdir(), 'cleo-ensures-schema-'));
   });
   afterEach(() => {

package/src/__tests__/starter.e2e.test.ts

@@ -33,6 +33,7 @@ import {
   resumePlaybook,
 } from '../runtime.js';
 import { getPlaybookRun, listPlaybookApprovals } from '../state.js';
+import { playbookTwinSql } from './twin-schema.js';
 
 const _require = createRequire(import.meta.url);
 type DatabaseSync = _DatabaseSyncType;
@@ -43,10 +44,6 @@ const { DatabaseSync } = _require('node:sqlite') as {
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
 /** Absolute path to the T889 playbook-tables migration SQL. */
-const MIGRATION_SQL_PATH = resolve(
-  __dirname,
-  '../../../core/migrations/drizzle-tasks/20260417220000_t889-playbook-tables/migration.sql',
-);
 
 /** Absolute path to the `starter/` directory shipped with this package. */
 const STARTER_DIR = resolve(__dirname, '../../starter');
@@ -205,7 +202,7 @@ describe('T934: starter playbooks — E2E against stubbed dispatcher', () => {
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL_PATH, 'utf8'));
+    applyMigration(db, playbookTwinSql());
   });
   afterEach(() => db.close());
 

package/src/__tests__/state.test.ts

@@ -5,11 +5,8 @@
  * @task T889 / T904 / W4-8
  */
 
-import { readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
-import { dirname, resolve } from 'node:path';
 import type { DatabaseSync as _DatabaseSyncType } from 'node:sqlite';
-import { fileURLToPath } from 'node:url';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 import {
   createPlaybookApproval,
@@ -22,6 +19,7 @@ import {
   updatePlaybookApproval,
   updatePlaybookRun,
 } from '../state.js';
+import { applyPlaybookTwinSchema } from './twin-schema.js';
 
 const _require = createRequire(import.meta.url);
 type DatabaseSync = _DatabaseSyncType;
@@ -29,31 +27,13 @@ const { DatabaseSync } = _require('node:sqlite') as {
   DatabaseSync: new (...args: ConstructorParameters<typeof _DatabaseSyncType>) => DatabaseSync;
 };
 
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const MIGRATION_SQL = resolve(
-  __dirname,
-  '../../../core/migrations/drizzle-tasks/20260417220000_t889-playbook-tables/migration.sql',
-);
-
-function applyMigration(db: DatabaseSync, sql: string): void {
-  const statements = sql
-    .split(/--> statement-breakpoint/)
-    .map((s) => s.trim())
-    .filter((s) => s.length > 0);
-  for (const stmt of statements) {
-    const lines = stmt.split('\n');
-    const hasSql = lines.some((l) => l.trim().length > 0 && !l.trim().startsWith('--'));
-    if (hasSql) db.exec(stmt);
-  }
-}
-
 describe('W4-8: playbook state CRUD', () => {
   let db: DatabaseSync;
 
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL, 'utf8'));
+    applyPlaybookTwinSchema(db);
   });
   afterEach(() => db.close());
 
@@ -271,7 +251,7 @@ describe('W4-8: playbook state CRUD', () => {
         playbookName: 'p',
         playbookHash: 'h',
       });
-      db.prepare('UPDATE playbook_runs SET bindings = ? WHERE run_id = ?').run(
+      db.prepare('UPDATE tasks_playbook_runs SET bindings = ? WHERE run_id = ?').run(
         '{not-json',
         run.runId,
       );

package/src/__tests__/twin-schema.ts

@@ -0,0 +1,46 @@
+/**
+ * Test helper: the playbook twins (`tasks_playbook_runs`,
+ * `tasks_playbook_approvals`) exactly as a project store creates them, read
+ * from the consolidation migration plus the uid migration, so the state layer
+ * is tested against the tables it writes (T12535).
+ *
+ * @task T12535
+ */
+
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import type { DatabaseSync } from 'node:sqlite';
+import { fileURLToPath } from 'node:url';
+
+const MIGRATIONS = resolve(
+  dirname(fileURLToPath(import.meta.url)),
+  '../../../core/migrations/drizzle-cleo-project',
+);
+
+/**
+ * The DDL of both playbook twins (with their uid columns), as statements
+ * separated by `--> statement-breakpoint`.
+ */
+export function playbookTwinSql(): string {
+  const consolidation = readFileSync(
+    resolve(MIGRATIONS, '20260531000001_t11363-consolidation-cleo-project/migration.sql'),
+    'utf8',
+  );
+  const tables = ['tasks_playbook_runs', 'tasks_playbook_approvals'].map((table) => {
+    const ddl = consolidation.match(new RegExp(`CREATE TABLE \`${table}\` \\([\\s\\S]*?\\n\\);`));
+    if (!ddl) throw new Error(`no CREATE TABLE for ${table} in the consolidation migration`);
+    return ddl[0];
+  });
+  const uids = readFileSync(
+    resolve(MIGRATIONS, '20261016120000_t12535-playbook-row-uids/migration.sql'),
+    'utf8',
+  );
+  return [...tables, uids].join('\n--> statement-breakpoint\n');
+}
+
+/** Create both playbook twins (with their uid columns) on `db`. */
+export function applyPlaybookTwinSchema(db: DatabaseSync): void {
+  for (const stmt of playbookTwinSql().split('--> statement-breakpoint')) {
+    if (stmt.split('\n').some((l) => l.trim() !== '' && !l.trim().startsWith('--'))) db.exec(stmt);
+  }
+}

package/src/approval.ts

@@ -82,7 +82,7 @@ export function generateResumeToken(
  * Input for {@link createApprovalGate}.
  */
 export interface CreateApprovalGateInput {
-  /** Run identifier (FK to `playbook_runs.run_id`). */
+  /** Run identifier (FK to `tasks_playbook_runs.run_id`). */
   runId: string;
   /** Node identifier within the run graph. */
   nodeId: string;
@@ -106,7 +106,7 @@ export interface CreateApprovalGateInput {
  */
 function narrowStatus(s: string): PlaybookApprovalStatus {
   if (s === 'pending' || s === 'approved' || s === 'rejected') return s;
-  throw new Error(`invariant: unknown playbook_approvals.status '${s}'`);
+  throw new Error(`invariant: unknown tasks_playbook_approvals.status '${s}'`);
 }
 
 /**
@@ -150,7 +150,7 @@ function readOptionalString(row: Record<string, unknown>, key: string): string |
 }
 
 /**
- * Map a raw `playbook_approvals` row to the camelCase {@link PlaybookApproval}
+ * Map a raw `tasks_playbook_approvals` row to the camelCase {@link PlaybookApproval}
  * contract shape. Validates types, converts the `auto_passed` 0/1 integer to
  * a boolean, and strips nullable fields rather than emitting `null`.
  *
@@ -176,7 +176,7 @@ function rowToApproval(row: Record<string, unknown>): PlaybookApproval {
 }
 
 /**
- * Create an HITL approval gate row in `playbook_approvals`.
+ * Create an HITL approval gate row in `tasks_playbook_approvals`.
  *
  * If `autoPassed` is true, the gate is written with `status='approved'`
  * and `auto_passed=1` — used by the policy engine to short-circuit gates
@@ -196,7 +196,7 @@ export function createApprovalGate(
   const autoPassed = input.autoPassed ?? false;
   const status: PlaybookApprovalStatus = autoPassed ? 'approved' : 'pending';
   const stmt = db.prepare(`
-    INSERT INTO playbook_approvals
+    INSERT INTO tasks_playbook_approvals
       (approval_id, run_id, node_id, token, status, auto_passed, approver, reason)
     VALUES (?, ?, ?, ?, ?, ?, ?, ?)
   `);
@@ -211,7 +211,7 @@ export function createApprovalGate(
     input.reason ?? null,
   );
   const row = db
-    .prepare('SELECT * FROM playbook_approvals WHERE approval_id = ?')
+    .prepare('SELECT * FROM tasks_playbook_approvals WHERE approval_id = ?')
     .get(approvalId) as Record<string, unknown> | undefined;
   if (row === undefined) {
     throw new Error(
@@ -275,9 +275,9 @@ function transitionGate(
   approver: string,
   reason?: string,
 ): PlaybookApproval {
-  const existing = db.prepare('SELECT * FROM playbook_approvals WHERE token = ?').get(token) as
-    | Record<string, unknown>
-    | undefined;
+  const existing = db
+    .prepare('SELECT * FROM tasks_playbook_approvals WHERE token = ?')
+    .get(token) as Record<string, unknown> | undefined;
   if (existing === undefined) {
     throw new Error(`${E_APPROVAL_NOT_FOUND}: no approval gate for token`);
   }
@@ -289,11 +289,11 @@ function transitionGate(
     );
   }
   db.prepare(
-    `UPDATE playbook_approvals
+    `UPDATE tasks_playbook_approvals
        SET status = ?, approved_at = datetime('now'), approver = ?, reason = ?
      WHERE token = ?`,
   ).run(next, approver, reason ?? null, token);
-  const row = db.prepare('SELECT * FROM playbook_approvals WHERE token = ?').get(token) as
+  const row = db.prepare('SELECT * FROM tasks_playbook_approvals WHERE token = ?').get(token) as
     | Record<string, unknown>
     | undefined;
   if (row === undefined) {
@@ -312,7 +312,7 @@ function transitionGate(
 export function getPendingApprovals(db: DatabaseSync): PlaybookApproval[] {
   const rows = db
     .prepare(
-      `SELECT * FROM playbook_approvals
+      `SELECT * FROM tasks_playbook_approvals
         WHERE status = 'pending'
         ORDER BY requested_at ASC, approval_id ASC`,
     )

package/src/state.ts

@@ -1,5 +1,5 @@
 /**
- * State layer for playbook runtime — CRUD against playbook_runs + playbook_approvals.
+ * State layer for playbook runtime — CRUD against tasks_playbook_runs + tasks_playbook_approvals.
  * Uses node:sqlite DatabaseSync for consistency with rest of CLEO.
  *
  * All JSON-shaped columns (`bindings`, `iteration_counts`) are serialized to
@@ -111,7 +111,7 @@ function parseJsonColumn<T>(raw: string, column: string, runId: string): T {
 }
 
 /**
- * Maps a snake_case `playbook_runs` row to the contract-shaped
+ * Maps a snake_case `tasks_playbook_runs` row to the contract-shaped
  * {@link PlaybookRun}. Performs strict JSON parsing and validates the status
  * column against the enum.
  */
@@ -140,7 +140,7 @@ function rowToPlaybookRun(row: PlaybookRunRow): PlaybookRun {
 }
 
 /**
- * Maps a snake_case `playbook_approvals` row to the contract-shaped
+ * Maps a snake_case `tasks_playbook_approvals` row to the contract-shaped
  * {@link PlaybookApproval}. Converts the integer `auto_passed` column to a
  * boolean at the boundary.
  */
@@ -174,7 +174,7 @@ export function createPlaybookRun(db: DatabaseSync, input: CreatePlaybookRunInpu
   const bindingsJson = JSON.stringify(input.initialBindings ?? {});
 
   const insert = db.prepare(
-    `INSERT INTO playbook_runs (
+    `INSERT INTO tasks_playbook_runs (
        run_id, playbook_name, playbook_hash, bindings, status,
        iteration_counts, epic_id, session_id
      ) VALUES (?, ?, ?, ?, 'running', '{}', ?, ?)`,
@@ -188,7 +188,7 @@ export function createPlaybookRun(db: DatabaseSync, input: CreatePlaybookRunInpu
     input.sessionId ?? null,
   );
 
-  const row = db.prepare('SELECT * FROM playbook_runs WHERE run_id = ?').get(runId) as
+  const row = db.prepare('SELECT * FROM tasks_playbook_runs WHERE run_id = ?').get(runId) as
     | PlaybookRunRow
     | undefined;
 
@@ -203,7 +203,7 @@ export function createPlaybookRun(db: DatabaseSync, input: CreatePlaybookRunInpu
  * does not exist. Never throws on missing rows.
  */
 export function getPlaybookRun(db: DatabaseSync, runId: string): PlaybookRun | null {
-  const row = db.prepare('SELECT * FROM playbook_runs WHERE run_id = ?').get(runId) as
+  const row = db.prepare('SELECT * FROM tasks_playbook_runs WHERE run_id = ?').get(runId) as
     | PlaybookRunRow
     | undefined;
   return row ? rowToPlaybookRun(row) : null;
@@ -273,7 +273,7 @@ export function updatePlaybookRun(
 
   db.exec('BEGIN');
   try {
-    const stmt = db.prepare(`UPDATE playbook_runs SET ${sets.join(', ')} WHERE run_id = ?`);
+    const stmt = db.prepare(`UPDATE tasks_playbook_runs SET ${sets.join(', ')} WHERE run_id = ?`);
     values.push(runId);
     const result = stmt.run(...values);
     if (result.changes === 0) {
@@ -285,7 +285,7 @@ export function updatePlaybookRun(
     throw err;
   }
 
-  const row = db.prepare('SELECT * FROM playbook_runs WHERE run_id = ?').get(runId) as
+  const row = db.prepare('SELECT * FROM tasks_playbook_runs WHERE run_id = ?').get(runId) as
     | PlaybookRunRow
     | undefined;
   if (!row) {
@@ -316,19 +316,28 @@ export function listPlaybookRuns(
   const limitClause = typeof opts.limit === 'number' ? 'LIMIT ?' : '';
   if (limitClause) values.push(opts.limit ?? 0);
 
-  const sql = `SELECT * FROM playbook_runs ${where} ORDER BY started_at DESC ${limitClause}`;
+  const sql = `SELECT * FROM tasks_playbook_runs ${where} ORDER BY started_at DESC ${limitClause}`;
   const rows = db.prepare(sql).all(...values) as unknown as PlaybookRunRow[];
   return rows.map(rowToPlaybookRun);
 }
 
 /**
- * Deletes a playbook run by primary key. Returns `true` if a row was removed.
- * CASCADE wipes all associated approvals via the foreign-key constraint on
- * `playbook_approvals.run_id`.
+ * Deletes a playbook run by primary key, with its approvals, in one
+ * transaction. Returns `true` if the run was removed. `tasks_playbook_approvals`
+ * has no foreign key to the run (the bare twin cascaded), so the approvals are
+ * deleted first, explicitly: each delete is then a captured op of its own.
  */
 export function deletePlaybookRun(db: DatabaseSync, runId: string): boolean {
-  const result = db.prepare('DELETE FROM playbook_runs WHERE run_id = ?').run(runId);
-  return Number(result.changes) > 0;
+  db.exec('BEGIN');
+  try {
+    db.prepare('DELETE FROM tasks_playbook_approvals WHERE run_id = ?').run(runId);
+    const result = db.prepare('DELETE FROM tasks_playbook_runs WHERE run_id = ?').run(runId);
+    db.exec('COMMIT');
+    return Number(result.changes) > 0;
+  } catch (err) {
+    db.exec('ROLLBACK');
+    throw err;
+  }
 }
 
 // ---------------------------------------------------------------------------
@@ -348,13 +357,13 @@ export function createPlaybookApproval(
   const autoPassed = input.autoPassed ? 1 : 0;
 
   db.prepare(
-    `INSERT INTO playbook_approvals (
+    `INSERT INTO tasks_playbook_approvals (
        approval_id, run_id, node_id, token, status, auto_passed
      ) VALUES (?, ?, ?, ?, 'pending', ?)`,
   ).run(approvalId, input.runId, input.nodeId, input.token, autoPassed);
 
   const row = db
-    .prepare('SELECT * FROM playbook_approvals WHERE approval_id = ?')
+    .prepare('SELECT * FROM tasks_playbook_approvals WHERE approval_id = ?')
     .get(approvalId) as PlaybookApprovalRow | undefined;
   if (!row) {
     throw new Error(`playbook state: failed to read back approval ${approvalId} after insert`);
@@ -370,7 +379,7 @@ export function getPlaybookApprovalByToken(
   db: DatabaseSync,
   token: string,
 ): PlaybookApproval | null {
-  const row = db.prepare('SELECT * FROM playbook_approvals WHERE token = ?').get(token) as
+  const row = db.prepare('SELECT * FROM tasks_playbook_approvals WHERE token = ?').get(token) as
     | PlaybookApprovalRow
     | undefined;
   return row ? rowToPlaybookApproval(row) : null;
@@ -418,7 +427,7 @@ export function updatePlaybookApproval(
     // same guard transitionGate applies): a peer would refuse the move, so
     // the origin refuses it too (T12944).
     const current = db
-      .prepare('SELECT status FROM playbook_approvals WHERE approval_id = ?')
+      .prepare('SELECT status FROM tasks_playbook_approvals WHERE approval_id = ?')
       .get(approvalId) as { status: string } | undefined;
     if (current && current.status !== 'pending' && current.status !== patch.status) {
       // @sync-invariant playbook.approval.once a decided gate keeps its decision locally, as every peer's merge keeps it
@@ -436,7 +445,7 @@ export function updatePlaybookApproval(
 
   if (sets.length === 0) {
     const row = db
-      .prepare('SELECT * FROM playbook_approvals WHERE approval_id = ?')
+      .prepare('SELECT * FROM tasks_playbook_approvals WHERE approval_id = ?')
       .get(approvalId) as PlaybookApprovalRow | undefined;
     if (!row) {
       throw new Error(`playbook state: approval ${approvalId} not found for update`);
@@ -447,7 +456,7 @@ export function updatePlaybookApproval(
   db.exec('BEGIN');
   try {
     const stmt = db.prepare(
-      `UPDATE playbook_approvals SET ${sets.join(', ')} WHERE approval_id = ?`,
+      `UPDATE tasks_playbook_approvals SET ${sets.join(', ')} WHERE approval_id = ?`,
     );
     values.push(approvalId);
     const result = stmt.run(...values);
@@ -461,7 +470,7 @@ export function updatePlaybookApproval(
   }
 
   const row = db
-    .prepare('SELECT * FROM playbook_approvals WHERE approval_id = ?')
+    .prepare('SELECT * FROM tasks_playbook_approvals WHERE approval_id = ?')
     .get(approvalId) as PlaybookApprovalRow | undefined;
   if (!row) {
     throw new Error(`playbook state: approval ${approvalId} disappeared after update`);
@@ -476,7 +485,7 @@ export function updatePlaybookApproval(
 export function listPlaybookApprovals(db: DatabaseSync, runId: string): PlaybookApproval[] {
   const rows = db
     .prepare(
-      'SELECT * FROM playbook_approvals WHERE run_id = ? ORDER BY requested_at ASC, approval_id ASC',
+      'SELECT * FROM tasks_playbook_approvals WHERE run_id = ? ORDER BY requested_at ASC, approval_id ASC',
     )
     .all(runId) as unknown as PlaybookApprovalRow[];
   return rows.map(rowToPlaybookApproval);