@cleocode/core 2026.10.1 → 2026.10.3

package/dist/store/sync/trigger-classes.js

@@ -0,0 +1,441 @@
+/**
+ * Trigger classes and the suspension clause (journal spec §3.5 Rule 4, C2,
+ * D4; T12813, T12819, T12827).
+ *
+ * Every trigger in a store has exactly one class. The class decides whether
+ * the trigger carries the suspension clause, which a rebase frame uses to
+ * turn a class off inside its own transaction:
+ *
+ * | Class | Carries the clause | Example |
+ * |---|---|---|
+ * | `capture` | yes, scope `capture` | `_sync_cap_*` (S2 capture triggers) |
+ * | `guard` | yes, scope `guard` | the parent-cycle and status-pipeline guards |
+ * | `side-effect` | yes, scope `side-effect` | claim release, the handoff mirror |
+ * | `derived-maintenance` | no, always active | FTS `_ai`/`_ad`/`_au` |
+ * | `frozen-guard` | no, never modified | triggers on frozen-legacy bare twins |
+ *
+ * `guard` and `side-effect` triggers are OWNED: {@link OWNED_TRIGGERS} names
+ * each one, and its DDL is the last `CREATE TRIGGER` for that name in the
+ * migration lineage from the C2 migration on, or the code-held DDL of
+ * {@link CODE_OWNED_TRIGGER_DDL} ({@link ownedTriggerDdl}). The open pass and
+ * the doctor compare each owned trigger's LIVE text with that DDL and re-run
+ * the DDL when it differs or is missing (C2(b)), but only where every table
+ * the trigger needs exists ({@link OWNED_TRIGGER_REQUIRES}).
+ *
+ * A trigger is `frozen-guard` ONLY because of the table it fires ON: a
+ * `frozen-legacy` bare twin. A rebase never touches a frozen twin, and giving
+ * such a trigger a clause would make 9.24's replace-if-text-differs
+ * (`twin-collapse.ts`) and this build's repair flip its DDL on every open
+ * that alternates builds (D4). Its name never decides: a trigger on a live
+ * table (even one named `t12535_*`) is owned, or unclassified.
+ *
+ * @task T12819
+ * @task T12827
+ * @module store/sync/trigger-classes
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveCorePackageMigrationsFolder } from '../resolve-migrations-folder.js';
+import { classifyTable } from '../table-classification.js';
+/** The schema-owned flag table the suspension clause reads. Never dropped. */
+export const TRIGGER_SUSPEND_TABLE = 'cleo_trigger_suspend';
+/**
+ * DDL of the flag table, byte-identical to the C2 migration's first
+ * statement. The open pass runs it (step 0) before migrations.
+ */
+export const TRIGGER_SUSPEND_TABLE_DDL = `CREATE TABLE IF NOT EXISTS \`cleo_trigger_suspend\` (
+  \`scope\` TEXT PRIMARY KEY NOT NULL CHECK (\`scope\` IN ('capture', 'guard', 'side-effect', 'all'))
+)`;
+/** The C2 migration folder (drizzle-cleo-project). Owned DDL is read from it on. */
+export const TRIGGER_CLAUSE_MIGRATION = '20260930170000_t12819-trigger-suspend-clause';
+/** The lineage the owned triggers live in. */
+export const OWNED_TRIGGER_LINEAGE = 'drizzle-cleo-project';
+/**
+ * The suspension clause a trigger of `cls` carries, exactly as written in
+ * migration SQL. Verification compares it whitespace-normalized.
+ *
+ * The table name is unqualified on purpose. A persistent trigger resolves an
+ * unqualified name in its own schema (a TEMP table cannot shadow it), so the
+ * trigger keeps working when the store is ATTACHed under another name; a
+ * `main.` qualifier makes an attached schema unreadable ("cannot reference
+ * objects in database main").
+ */
+export function suspendClause(cls) {
+    return `NOT EXISTS (SELECT 1 FROM cleo_trigger_suspend WHERE scope IN ('${cls}', 'all'))`;
+}
+/**
+ * The owned guard and side-effect triggers (project store), by name. Each
+ * one's DDL comes from the migration lineage or from
+ * {@link CODE_OWNED_TRIGGER_DDL} ({@link ownedTriggerDdl}).
+ */
+export const OWNED_TRIGGERS = {
+    tasks_tasks_parent_cycle_guard_insert: 'guard',
+    tasks_tasks_parent_cycle_guard_update: 'guard',
+    tasks_tasks_parent_type_matrix_insert: 'guard',
+    tasks_tasks_parent_type_matrix_update: 'guard',
+    trg_tasks_tasks_status_pipeline_insert: 'guard',
+    trg_tasks_tasks_status_pipeline_update: 'guard',
+    tasks_task_relations_non_containment_insert: 'guard',
+    tasks_task_relations_non_containment_update: 'guard',
+    tasks_task_acceptance_child_target_insert: 'guard',
+    tasks_task_acceptance_child_target_update: 'guard',
+    trg_tasks_session_handoff_no_update: 'guard',
+    tasks_tasks_lease_iso_insert: 'guard',
+    tasks_tasks_lease_iso_update: 'guard',
+    // T12886 (9.26): first created by its own released migration; the C2 file
+    // (dated after it) re-creates both with the suspension clause.
+    tasks_task_dependencies_cycle_guard_insert: 'guard',
+    tasks_task_dependencies_cycle_guard_update: 'guard',
+    trg_tasks_session_handoff_mirror: 'side-effect',
+    tasks_sessions_release_claims_on_end: 'side-effect',
+    tasks_sessions_release_claims_on_delete: 'side-effect',
+    tasks_tasks_release_claim_on_terminal: 'side-effect',
+    trg_tasks_ac_uid_graveyard: 'side-effect',
+};
+/**
+ * Owned triggers whose DDL is held in code, not in the C2 migration.
+ *
+ * The AC uid graveyard trigger writes `tasks_ac_uid_graveyard`. A store whose
+ * t12341 migration was probe-stamped after only its ADD COLUMNs ran (the
+ * 9.25 live-cleocode shape) has no graveyard table, and the table is created
+ * only by the flag-gated identity heal. A migration that created the trigger
+ * unconditionally would make every acceptance-criterion delete fail there
+ * ("no such table: main.tasks_ac_uid_graveyard"), so the trigger is installed
+ * by the open pass, and only where its table exists.
+ */
+export const CODE_OWNED_TRIGGER_DDL = {
+    trg_tasks_ac_uid_graveyard: `CREATE TRIGGER \`trg_tasks_ac_uid_graveyard\`
+AFTER DELETE ON \`tasks_task_acceptance_criteria\`
+WHEN (OLD.\`uid\` IS NOT NULL)
+  AND ${suspendClause('side-effect')}
+BEGIN
+  INSERT INTO \`tasks_ac_uid_graveyard\` (\`ac_id\`, \`uid\`, \`task_id\`, \`ordinal\`, \`text\`, \`birth_fp\`, \`deleted_at\`)
+  VALUES (OLD.\`id\`, OLD.\`uid\`, OLD.\`task_id\`, OLD.\`ordinal\`, OLD.\`text\`, OLD.\`birth_fp\`, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'));
+END`,
+};
+/**
+ * Tables an owned trigger needs besides the one it fires ON. Where one is
+ * missing the trigger is not verified or installed, and a live copy is a
+ * finding (`dangling`) that repair drops: it would fail every write that
+ * fires it.
+ */
+export const OWNED_TRIGGER_REQUIRES = {
+    trg_tasks_ac_uid_graveyard: ['tasks_ac_uid_graveyard'],
+};
+/** Prefix of every capture trigger (S2, §2.3). */
+export const CAPTURE_TRIGGER_PREFIX = '_sync_cap_';
+/**
+ * The tables a trigger body writes: `INSERT INTO t`, `UPDATE t`,
+ * `DELETE FROM t`, `REPLACE INTO t`. Lower-cased; quotes stripped.
+ */
+export function triggerWriteTargets(sql) {
+    const body = sql.slice(Math.max(0, sql.search(/\bBEGIN\b/i)));
+    const out = new Set();
+    const re = /\b(?:insert(?:\s+or\s+\w+)?\s+into|replace\s+into|update(?:\s+or\s+\w+)?|delete\s+from)\s+[`"[]?(?:main\.)?[`"[]?(\w+)/gi;
+    for (const m of body.matchAll(re))
+        out.add(m[1].toLowerCase());
+    return [...out];
+}
+/**
+ * Classify one trigger. Returns `undefined` for a trigger no rule covers,
+ * which the Gate test reports.
+ *
+ * @param scope - The store the trigger lives in.
+ * @param name - `sqlite_master.name`.
+ * @param table - `sqlite_master.tbl_name`.
+ * @param sql - `sqlite_master.sql`.
+ */
+export function classifyTrigger(scope, name, table, sql) {
+    if (name.startsWith(CAPTURE_TRIGGER_PREFIX)) {
+        return { name, table, class: 'capture', reason: 'journal capture trigger (§2.3)' };
+    }
+    const tableClass = classifyTable(scope, table);
+    if (tableClass.kind === 'entry' && tableClass.entry.status === 'frozen-legacy') {
+        return {
+            name,
+            table,
+            class: 'frozen-guard',
+            reason: 'on a frozen-legacy bare twin: no clause, never rewritten (D4)',
+        };
+    }
+    const owned = OWNED_TRIGGERS[name];
+    if (owned !== undefined) {
+        return { name, table, class: owned, reason: 'owned by the C2 migration (T12819)' };
+    }
+    const targets = triggerWriteTargets(sql);
+    if (targets.length > 0 &&
+        targets.every((t) => {
+            const c = classifyTable(scope, t);
+            return (c.kind === 'entry' || c.kind === 'pattern') && c.class === 'derived';
+        })) {
+        return {
+            name,
+            table,
+            class: 'derived-maintenance',
+            reason: `writes only derived tables (${targets.join(', ')}); always active`,
+        };
+    }
+    return undefined;
+}
+/** Collapse whitespace so text comparisons ignore layout. */
+export function normalizeSql(sql) {
+    return sql
+        .replace(/--[^\n]*/g, '')
+        .replace(/\s+/g, ' ')
+        .replace(/\s*;\s*$/, '')
+        .trim();
+}
+/**
+ * Split migration text into `CREATE TRIGGER` statements, by name. Later
+ * definitions of the same name replace earlier ones. `IF NOT EXISTS` is
+ * removed, as SQLite removes it from `sqlite_master.sql`.
+ */
+export function createTriggerStatements(migrationSql) {
+    const out = new Map();
+    for (const chunk of migrationSql.split('--> statement-breakpoint')) {
+        const stmt = chunk.replace(/^(?:\s*--[^\n]*\n|\s*\n)*/, '').trim();
+        const m = /^CREATE\s+TRIGGER\s+(?:IF\s+NOT\s+EXISTS\s+)?[`"]?(\w+)[`"]?/i.exec(stmt);
+        if (!m)
+            continue;
+        out.set(m[1], stmt
+            .replace(/^CREATE\s+TRIGGER\s+IF\s+NOT\s+EXISTS\s+/i, 'CREATE TRIGGER ')
+            .replace(/;$/, ''));
+    }
+    return out;
+}
+/**
+ * The owned trigger DDL: {@link CODE_OWNED_TRIGGER_DDL}, then the last
+ * `CREATE TRIGGER` for each owned name in the lineage's migration files from
+ * {@link TRIGGER_CLAUSE_MIGRATION} on, in folder order (a later migration
+ * replaces a code-held text).
+ *
+ * @param folder - The lineage folder (tests pass one; default: installed).
+ * @throws {Error} When an owned trigger has no DDL from C2 on.
+ */
+export function ownedTriggerDdl(folder = resolveCorePackageMigrationsFolder(OWNED_TRIGGER_LINEAGE)) {
+    const cached = ownedDdlCache.get(folder);
+    if (cached)
+        return cached;
+    const ddl = new Map(Object.entries(CODE_OWNED_TRIGGER_DDL));
+    const names = readdirSync(folder)
+        .filter((n) => n >= TRIGGER_CLAUSE_MIGRATION && existsSync(join(folder, n, 'migration.sql')))
+        .sort();
+    for (const n of names) {
+        for (const [name, sql] of createTriggerStatements(readFileSync(join(folder, n, 'migration.sql'), 'utf8'))) {
+            if (Object.hasOwn(OWNED_TRIGGERS, name))
+                ddl.set(name, sql);
+        }
+    }
+    const missing = Object.keys(OWNED_TRIGGERS).filter((n) => !ddl.has(n));
+    if (missing.length > 0) {
+        // @sync-invariant none:local-only owned-trigger DDL missing from the build; packaging check on local schema
+        throw new Error(`owned triggers without DDL from ${TRIGGER_CLAUSE_MIGRATION}: ${missing.join(', ')}`);
+    }
+    ownedDdlCache.set(folder, ddl);
+    return ddl;
+}
+/** Owned DDL per lineage folder: migration files never change at runtime. */
+const ownedDdlCache = new Map();
+/** Whether the flag table exists. Read-only. */
+export function hasTriggerSuspendTable(db) {
+    return (db
+        .prepare("SELECT 1 FROM main.sqlite_master WHERE type = 'table' AND name = ?")
+        .get(TRIGGER_SUSPEND_TABLE) !== undefined);
+}
+/**
+ * Compare every owned trigger's live `sqlite_master.sql` with its owned DDL,
+ * and optionally repair (drop, then re-run the owned DDL) each one that is
+ * missing or differs.
+ *
+ * Only meaningful on a store whose journal has the C2 migration: before it,
+ * the owned DDL references a table the store may not have. Callers check
+ * {@link hasTriggerSuspendTable} and that the owned tables exist.
+ *
+ * @param db - A project store handle.
+ * @param options - `repair` rewrites; `ddl` overrides the owned DDL (tests).
+ * @returns One finding per trigger that was not identical.
+ */
+export function verifyOwnedTriggers(db, options = {}) {
+    const ddl = options.ddl ?? ownedTriggerDdl();
+    const live = new Map(db
+        .prepare("SELECT name, tbl_name, sql FROM main.sqlite_master WHERE type = 'trigger'")
+        .all().map((r) => [r.name, r]));
+    const hasTable = (t) => db.prepare("SELECT 1 FROM main.sqlite_master WHERE type = 'table' AND name = ?").get(t) !==
+        undefined;
+    const findings = [];
+    // Repairs are planned first and applied in one unit (T13024 MED-2).
+    const work = [];
+    for (const [name, cls] of Object.entries(OWNED_TRIGGERS)) {
+        const want = ddl.get(name);
+        const onTable = /\bON\s+[`"]?(\w+)[`"]?/i.exec(want.slice(0, want.search(/\bBEGIN\b/i)))?.[1];
+        // The trigger's table may not exist in this store shape (a store the
+        // owning migration never reached); nothing to verify then.
+        if (onTable && !hasTable(onTable))
+            continue;
+        const row = live.get(name);
+        if ((OWNED_TRIGGER_REQUIRES[name] ?? []).some((t) => !hasTable(t))) {
+            if (!row)
+                continue;
+            if (options.repair)
+                work.push({ name, create: null });
+            findings.push({ name, problem: 'dangling', repaired: options.repair === true });
+            continue;
+        }
+        let problem;
+        if (!row)
+            problem = 'missing';
+        else if (normalizeSql(row.sql) !== normalizeSql(want)) {
+            problem = normalizeSql(row.sql).includes(normalizeSql(suspendClause(cls)))
+                ? 'text-differs'
+                : 'no-clause';
+        }
+        if (!problem)
+            continue;
+        if (options.repair)
+            work.push({ name, create: want });
+        findings.push({ name, problem, repaired: options.repair === true });
+    }
+    if (work.length > 0) {
+        atomicDdl(db, () => {
+            for (const w of work) {
+                db.exec(`DROP TRIGGER IF EXISTS \`${w.name}\``);
+                if (w.create !== null)
+                    db.exec(w.create);
+            }
+        });
+    }
+    return findings;
+}
+/**
+ * Run DDL as one unit (T13024 MED-2): `BEGIN IMMEDIATE` … `COMMIT` on an idle
+ * connection, a SAVEPOINT inside a caller's transaction. A failure rolls the
+ * whole unit back, so a DROP never commits without its CREATE.
+ */
+export function atomicDdl(db, fn) {
+    if (db.isTransaction) {
+        db.exec('SAVEPOINT cleo_atomic_ddl');
+        try {
+            const out = fn();
+            db.exec('RELEASE cleo_atomic_ddl');
+            return out;
+        }
+        catch (err) {
+            // SQLite may already have rolled the caller's transaction back (FULL,
+            // IOERR, interrupt): then there is no savepoint, and the original error
+            // is the one to report.
+            if (db.isTransaction) {
+                try {
+                    db.exec('ROLLBACK TO cleo_atomic_ddl; RELEASE cleo_atomic_ddl');
+                }
+                catch {
+                    // keep the original error
+                }
+            }
+            throw err;
+        }
+    }
+    db.exec('BEGIN IMMEDIATE');
+    try {
+        const out = fn();
+        db.exec('COMMIT');
+        return out;
+    }
+    catch (err) {
+        if (db.isTransaction)
+            db.exec('ROLLBACK');
+        throw err;
+    }
+}
+/**
+ * Classify every trigger of a store. Read-only.
+ *
+ * @returns The classified triggers, and the names no rule covers.
+ */
+export function classifyStoreTriggers(db, scope) {
+    const rows = db
+        .prepare("SELECT name, tbl_name, sql FROM main.sqlite_master WHERE type = 'trigger' ORDER BY name")
+        .all();
+    const classified = [];
+    const unclassified = [];
+    for (const r of rows) {
+        const c = classifyTrigger(scope, r.name, r.tbl_name, r.sql);
+        if (c)
+            classified.push(c);
+        else
+            unclassified.push(r.name);
+    }
+    return { classified, unclassified };
+}
+/**
+ * Open-pass step 0 (C2, round 9): make sure `cleo_trigger_suspend` exists,
+ * BEFORE migrations, and that it is empty.
+ *
+ * Every write to tasks, sessions and acceptance criteria fires an owned
+ * trigger that reads the table, and any `ALTER … RENAME` re-validates every
+ * trigger, so a store missing it cannot be written. A committed row is
+ * impossible through the rebase frame (it deletes and asserts before
+ * COMMIT); if one is found anyway it is cleared, because a committed
+ * suspension would silently disable guards for everyone.
+ *
+ * Writes nothing when the table exists and is empty.
+ */
+export function ensureTriggerSuspendTable(db) {
+    if (!hasTriggerSuspendTable(db)) {
+        db.exec(TRIGGER_SUSPEND_TABLE_DDL);
+        return { created: true, cleared: 0 };
+    }
+    const n = db.prepare('SELECT count(*) AS n FROM main.cleo_trigger_suspend').get().n;
+    if (n > 0)
+        db.exec('DELETE FROM main.cleo_trigger_suspend');
+    return { created: false, cleared: n };
+}
+/**
+ * Throw unless `cleo_trigger_suspend` is empty. A frame calls this right
+ * before COMMIT, so a suspension can never be committed (C4).
+ *
+ * @throws {Error} `E_TRIGGER_SUSPEND_NOT_EMPTY` when a row remains.
+ */
+export function assertTriggerSuspendEmpty(db) {
+    const row = db.prepare('SELECT scope FROM main.cleo_trigger_suspend LIMIT 1').get();
+    if (row) {
+        // @sync-invariant none:local-only owned-trigger repair/suspension guard on this store; local schema, not synced rows
+        throw Object.assign(new Error(`E_TRIGGER_SUSPEND_NOT_EMPTY: cleo_trigger_suspend still holds scope '${row.scope}'; refusing to commit a suspension`), { code: 'E_TRIGGER_SUSPEND_NOT_EMPTY' });
+    }
+}
+/** Purposes that may suspend the `guard` class (T12344 AC5). */
+const GUARD_SUSPEND_PURPOSES = new Set(['rewind', 'undo']);
+/**
+ * Run `fn` with the given trigger classes suspended, inside the caller's
+ * transaction: insert the scope rows, run, delete them, and assert the table
+ * is empty before returning. Other connections never see the rows (WAL), so
+ * their triggers stay active; a crash rolls the rows back.
+ *
+ * Suspending `guard` (or `all`) is allowed only to rewind or undo (T12344
+ * AC5): a forward apply or replay with the guards off would commit a merged
+ * state they refuse (a dependency or parent cycle) without a word.
+ *
+ * @throws {Error} When called outside a transaction, or
+ *   `E_GUARD_SUSPEND_FORWARD` when a forward purpose suspends `guard`.
+ */
+export function withTriggersSuspended(db, scopes, purpose, fn) {
+    if (!db.isTransaction) {
+        // @sync-invariant none:local-only programming-error guard on the local suspension bracket
+        throw new Error('withTriggersSuspended must run inside the caller transaction');
+    }
+    if ((scopes.includes('guard') || scopes.includes('all')) &&
+        !GUARD_SUSPEND_PURPOSES.has(purpose)) {
+        // @sync-invariant none:local-only owned-trigger repair/suspension guard on this store; local schema, not synced rows
+        throw Object.assign(new Error(`E_GUARD_SUSPEND_FORWARD: guards may be suspended only to rewind or undo, not for a '${purpose}' write`), { code: 'E_GUARD_SUSPEND_FORWARD' });
+    }
+    const ins = db.prepare('INSERT OR IGNORE INTO main.cleo_trigger_suspend (scope) VALUES (?)');
+    for (const s of scopes)
+        ins.run(s);
+    try {
+        return fn();
+    }
+    finally {
+        db.exec('DELETE FROM main.cleo_trigger_suspend');
+        assertTriggerSuspendEmpty(db);
+    }
+}
+//# sourceMappingURL=trigger-classes.js.map

package/dist/store/sync/trigger-classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-classes.js","sourceRoot":"","sources":["../../../src/store/sync/trigger-classes.ts"],"names":[],"mappings":"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"}

package/dist/store/sync/trigger-suspend-at-path.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Create `cleo_trigger_suspend` in a store FILE that was just placed outside
+ * the open pass: a bundle import or a restore from a snapshot (journal spec
+ * §3.5 Rule 4, round 9; T12819).
+ *
+ * A placed store that syncs also has its whole sync set marked suspect
+ * (§2.3a rule 3). A placed store may come from an older build. Until the next chokepoint
+ * open, a 9.24 binary would open it as is; with the table present its owned
+ * triggers (if any carry the clause) keep working. A file that is not a
+ * project store (no `tasks_tasks`) is left alone.
+ *
+ * @task T12819
+ * @module store/sync/trigger-suspend-at-path
+ */
+import { type TriggerSuspendStepZero } from './trigger-classes.js';
+/**
+ * Open `dbPath` read-write, create the flag table when it is a project store
+ * missing it, and close.
+ *
+ * @returns What step 0 did, or `null` when the file is not a project store.
+ */
+export declare function ensureTriggerSuspendTableAtPath(dbPath: string): TriggerSuspendStepZero | null;
+//# sourceMappingURL=trigger-suspend-at-path.d.ts.map

package/dist/store/sync/trigger-suspend-at-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-suspend-at-path.d.ts","sourceRoot":"","sources":["../../../src/store/sync/trigger-suspend-at-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAA6B,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9F;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAiB7F"}

package/dist/store/sync/trigger-suspend-at-path.js

@@ -0,0 +1,44 @@
+/**
+ * Create `cleo_trigger_suspend` in a store FILE that was just placed outside
+ * the open pass: a bundle import or a restore from a snapshot (journal spec
+ * §3.5 Rule 4, round 9; T12819).
+ *
+ * A placed store that syncs also has its whole sync set marked suspect
+ * (§2.3a rule 3). A placed store may come from an older build. Until the next chokepoint
+ * open, a 9.24 binary would open it as is; with the table present its owned
+ * triggers (if any carry the clause) keep working. A file that is not a
+ * project store (no `tasks_tasks`) is left alone.
+ *
+ * @task T12819
+ * @module store/sync/trigger-suspend-at-path
+ */
+import { openCleoDbSnapshot } from '../open-cleo-db.js';
+import { syncSetTables } from './capture.js';
+import { markSuspect } from './structural.js';
+import { ensureTriggerSuspendTable } from './trigger-classes.js';
+/**
+ * Open `dbPath` read-write, create the flag table when it is a project store
+ * missing it, and close.
+ *
+ * @returns What step 0 did, or `null` when the file is not a project store.
+ */
+export function ensureTriggerSuspendTableAtPath(dbPath) {
+    const snap = openCleoDbSnapshot(dbPath, { readOnly: false });
+    try {
+        const isProject = snap.db
+            .prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'tasks_tasks'")
+            .get() !== undefined;
+        if (!isProject)
+            return null;
+        const step0 = ensureTriggerSuspendTable(snap.db);
+        // §2.3a rule 3 (B): nothing in a placed file was written through this
+        // device's capture, so a store that syncs has its whole sync set marked
+        // suspect for the repair diff. A store without the sync schema stays so.
+        markSuspect(snap.db, 'project', syncSetTables('project'));
+        return step0;
+    }
+    finally {
+        snap.close();
+    }
+}
+//# sourceMappingURL=trigger-suspend-at-path.js.map

package/dist/store/sync/trigger-suspend-at-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-suspend-at-path.js","sourceRoot":"","sources":["../../../src/store/sync/trigger-suspend-at-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAA+B,MAAM,sBAAsB,CAAC;AAE9F;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAAc;IAC5D,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,SAAS,GACb,IAAI,CAAC,EAAE;aACJ,OAAO,CAAC,2EAA2E,CAAC;aACpF,GAAG,EAAE,KAAK,SAAS,CAAC;QACzB,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5B,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjD,sEAAsE;QACtE,wEAAwE;QACxE,yEAAyE;QACzE,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1D,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/store/sync/writer-version.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The store-level minimum writer version (S2 ruling (c), T12343).
+ *
+ * A released binary older than S2 writes without frames; its captures are
+ * sealed as singleton transactions flagged `unframed` (S3), never claimed
+ * atomic. To bound that mixed-version window, turning capture on records
+ * `min_writer_version` in `_sync_meta` (this build's version, never lowered).
+ * Every build from S2 on checks it at open, before any write, and refuses to
+ * write a store that requires a newer writer. Builds released before S2 do
+ * not know the marker: that is the window the release notes name.
+ *
+ * @task T12343
+ * @module store/sync/writer-version
+ */
+import type { DatabaseSync } from 'node:sqlite';
+/** `_sync_meta` key of the marker. */
+export declare const MIN_WRITER_VERSION_KEY = "min_writer_version";
+/** A writer older than the store's `min_writer_version`. */
+export declare class StoreWriterTooOldError extends Error {
+    readonly required: string;
+    readonly actual: string;
+    readonly code = "E_STORE_WRITER_TOO_OLD";
+    constructor(required: string, actual: string);
+}
+/** Compare two versions by their numeric parts; null when either is unparseable. */
+export declare function compareWriterVersions(a: string, b: string): number | null;
+/** The store's marker, or undefined. Read-only. */
+export declare function readMinWriterVersion(db: DatabaseSync): string | undefined;
+/**
+ * Record `version` as the store's minimum writer version, unless the marker
+ * already requires as much or more. Call inside the capture-on transaction.
+ *
+ * @returns Whether the marker changed.
+ */
+export declare function raiseMinWriterVersion(db: DatabaseSync, version?: string): boolean;
+/**
+ * Refuse to write a store whose marker requires a newer writer. Call at open,
+ * before any write. An unparseable version on either side never refuses.
+ *
+ * @throws {StoreWriterTooOldError}
+ */
+export declare function assertWriterVersion(db: DatabaseSync, version?: string): void;
+//# sourceMappingURL=writer-version.d.ts.map

package/dist/store/sync/writer-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer-version.d.ts","sourceRoot":"","sources":["../../../src/store/sync/writer-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D,4DAA4D;AAC5D,qBAAa,sBAAuB,SAAQ,KAAK;IAI7C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM;IAJzB,QAAQ,CAAC,IAAI,4BAA4B;gBAG9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM;CAO1B;AAQD,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASzE;AAED,mDAAmD;AACnD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,YAAY,EAChB,OAAO,GAAE,MAAyB,GACjC,OAAO,CAUT;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,GAAE,MAAyB,GAAG,IAAI,CAM9F"}