things-api 0.9.0 → 0.11.0

package/dist/write/vectors/simulator.js

@@ -0,0 +1,1136 @@
+/**
+ * The SIMULATOR write vector (bench harness, Phase 0). It presents to the
+ * pipeline exactly like the real `url-scheme` transport but, instead of handing
+ * a payload to the OS, applies the mutation with SQL against a SYNTHETIC fixture
+ * database — so the whole write pipeline (guards → plan → execute → verified
+ * read-after-write → audit) can run end-to-end with no Things app installed.
+ *
+ * It NEVER parses the compiled payload: every applier reads the STRUCTURED
+ * `invocation.op` / `invocation.opParams` the pipeline attaches after compile.
+ * Its own read-write `node:sqlite` connection is separate from the pipeline's
+ * (which stays read-only); both point at the same WAL file, so the pipeline's
+ * verification poller observes each committed applier write.
+ *
+ * SAFETY — a triple fence (checked at creation AND on first execute) keeps this
+ * pointed only at a disposable bench DB, never at a real Things database:
+ *   1. env `THINGS_SIM_WRITES=1`,
+ *   2. env `THINGS_DB` set and byte-equal to the dbPath in use (never a
+ *      container-glob-located production path),
+ *   3. the DB's `Meta` table carries `benchFixture` = "1".
+ * When any check fails, {@link defaultVectors} omits the simulator and
+ * {@link createSimulatorVector} refuses (throws at creation; execute refuses
+ * defensively should the environment change underneath a live instance).
+ */
+import { randomBytes } from "node:crypto";
+import { DatabaseSync } from "node:sqlite";
+import { readDatabaseVersion } from "../../db/fingerprint.js";
+import { addDaysIso, decodePackedDate, encodePackedDate, encodeReminderTime, localToday, } from "../../model/dates.js";
+import { decodeRecurrenceRule } from "../../model/recurrence.js";
+import { resolveArea, resolveHeading, resolveProject, resolveTag } from "../pre-state.js";
+import { composeRepeatRuleSpec, ruleXml } from "../recurrence-rule-blob.js";
+import { resolveTagRefs } from "../tag-refs.js";
+// Enum encodings mirror test/fixtures/seed.ts / docs/atlas/schema-v26.md.
+const STATUS = { open: 0, canceled: 2, completed: 3 };
+const START = { inbox: 0, active: 1, someday: 2 };
+/** Substring signature of the production group container — never a bench path. */
+const PROD_CONTAINER = "Group Containers/JLMPQHK86H.com.culturedcode.ThingsMac";
+// --------------------------------------------------------------- fence
+/**
+ * The fence reason, or null when the simulator may run against `dbPath`. Pure
+ * with respect to `env`; opens `dbPath` READ-ONLY only to read the marker.
+ */
+export function simulatorFenceReason(dbPath, env = process.env) {
+    if (env["THINGS_SIM_WRITES"] !== "1") {
+        return "THINGS_SIM_WRITES is not set to 1";
+    }
+    const thingsDb = env["THINGS_DB"];
+    if (thingsDb === undefined || thingsDb.trim() === "") {
+        return "THINGS_DB is not set";
+    }
+    if (thingsDb !== dbPath) {
+        return `THINGS_DB (${thingsDb}) does not equal the simulator dbPath (${dbPath})`;
+    }
+    if (dbPath.includes(PROD_CONTAINER)) {
+        return "the dbPath points at the production Things group container";
+    }
+    if (!hasBenchMarker(dbPath)) {
+        return `the database at ${dbPath} carries no Meta.benchFixture marker`;
+    }
+    // Scratch state/config dirs are part of the fence (2026-07-17 incident): a
+    // simulated run without them appends bench audit records into the operator's
+    // real audit trail and reads their real config profile.
+    for (const key of ["THINGS_API_STATE_DIR", "THINGS_API_CONFIG_DIR"]) {
+        const dir = env[key];
+        if (dir === undefined || dir.trim() === "") {
+            return `${key} is not set — simulated runs must use scratch state/config dirs, never the operator's real ones`;
+        }
+    }
+    const version = fixtureDatabaseVersion(dbPath);
+    if (version !== SIMULATED_DATABASE_VERSION) {
+        return (`the fixture reports databaseVersion ${version ?? "unknown"} but the simulator's ` +
+            `appliers model version ${SIMULATED_DATABASE_VERSION} — a Things schema change must be ` +
+            `re-modeled in lockstep (atlas → seed builders → simulator appliers → bench world/corpus; ` +
+            `see docs/lab/drift-runbook.md) before simulated writes may resume`);
+    }
+    return null;
+}
+/**
+ * The Things schema generation the appliers are written against. When a
+ * Things update bumps the real database version, the fence refuses to
+ * simulate until the whole modeling chain is consciously re-verified —
+ * a schema tripwire, not a compatibility claim.
+ */
+export const SIMULATED_DATABASE_VERSION = 26;
+function fixtureDatabaseVersion(dbPath) {
+    let db;
+    try {
+        db = new DatabaseSync(dbPath, { readOnly: true, timeout: 2000 });
+        return readDatabaseVersion(db);
+    }
+    catch {
+        return null;
+    }
+    finally {
+        db?.close();
+    }
+}
+/** Whether the simulator's triple fence is satisfied for `dbPath`. */
+export function simulatorFenceActive(dbPath, env = process.env) {
+    return simulatorFenceReason(dbPath, env) === null;
+}
+/**
+ * Whether the simulator fence is active for the ambient environment — the
+ * single signal every host-escaping code path (reveal `open`, setup install
+ * sheets, the live-app doctor probes, the pipeline's app-launch) consults so a
+ * bench run never touches the real Things/Shortcuts app. True only when
+ * THINGS_SIM_WRITES=1 AND THINGS_DB names a fenced bench fixture (marker
+ * present, not the production container); false — the ordinary path — otherwise.
+ */
+export function simFenceActive(env = process.env) {
+    const dbPath = env["THINGS_DB"];
+    if (dbPath === undefined || dbPath.trim() === "")
+        return false;
+    return simulatorFenceActive(dbPath, env);
+}
+/**
+ * Whether the database at `dbPath` carries the bench-fixture marker — i.e. it
+ * is a synthetic bench DB by construction. Consulted by defaultVectors as a
+ * fail-closed backstop (a marked DB must never be paired with real write
+ * transports) and by the reveal gate. False on any read error.
+ */
+export function dbCarriesBenchMarker(dbPath) {
+    return hasBenchMarker(dbPath);
+}
+function hasBenchMarker(dbPath) {
+    let db;
+    try {
+        db = new DatabaseSync(dbPath, { readOnly: true, timeout: 2000 });
+        const row = db.prepare("SELECT value FROM Meta WHERE key = 'benchFixture'").get();
+        return row?.value === "1";
+    }
+    catch {
+        return false;
+    }
+    finally {
+        db?.close();
+    }
+}
+// ------------------------------------------------------------- uuids
+const BASE62 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+/** A fresh 22-char base62 id — the shape of a real Things object uuid. */
+function genUuid() {
+    const bytes = randomBytes(22);
+    let out = "";
+    for (let i = 0; i < 22; i++)
+        out += BASE62[(bytes[i] ?? 0) % 62];
+    return out;
+}
+// ---------------------------------------------------- shared appliers
+/** Full TMTask row insert, mirroring test/fixtures/seed.ts insertTask columns. */
+function insertTask(sim, type, ctx, opts) {
+    sim
+        .prepare(`INSERT INTO TMTask (
+         uuid, type, status, stopDate, trashed, title, notes,
+         creationDate, userModificationDate,
+         start, startDate, startBucket, reminderTime, deadline, deadlineSuppressionDate,
+         "index", todayIndex, todayIndexReferenceDate, area, project, heading,
+         untrashedLeafActionsCount, openUntrashedLeafActionsCount,
+         checklistItemsCount, openChecklistItemsCount,
+         rt1_repeatingTemplate, rt1_recurrenceRule,
+         rt1_nextInstanceStartDate, rt1_instanceCreationPaused, repeater
+       ) VALUES (?, ?, ?, NULL, 0, ?, ?, ?, ?, ?, ?, ?, ?, ?, NULL, 0, 0, NULL, ?, ?, ?, 0, 0, ?, ?, NULL, NULL, NULL, 0, NULL)`)
+        .run(opts.uuid, type, STATUS[opts.status ?? "open"], opts.title, opts.notes ?? "", ctx.nowEpoch, ctx.nowEpoch, opts.start ?? START.active, opts.startDate ?? null, opts.startBucket ?? 0, opts.reminderTime ?? null, opts.deadline ?? null, opts.area ?? null, opts.project ?? null, opts.heading ?? null, opts.checklistItemsCount ?? 0, opts.openChecklistItemsCount ?? 0);
+}
+/** The (start, startDate, startBucket) triple a `when` value materializes. */
+function scheduleColumns(when, todayIso, hasContainer) {
+    const today = encodePackedDate(todayIso);
+    switch (when) {
+        case undefined:
+            // No schedule requested — Inbox for a bare add, the container's Anytime
+            // otherwise (only startDate is ever asserted, so this is plausibility).
+            return { start: hasContainer ? START.active : START.inbox, startDate: null, startBucket: 0 };
+        case "today":
+            return { start: START.active, startDate: today, startBucket: 0 };
+        case "evening":
+            return { start: START.active, startDate: today, startBucket: 1 };
+        case "anytime":
+            return { start: START.active, startDate: null, startBucket: 0 };
+        case "someday":
+            return { start: START.someday, startDate: null, startBucket: 0 };
+        default:
+            // A concrete YYYY-MM-DD: only the date is invariant (start-state semantics
+            // differ for past/future dates and are not asserted).
+            return { start: START.active, startDate: encodePackedDate(when), startBucket: 0 };
+    }
+}
+function containerUuid(sim, ref, kind) {
+    if (ref === undefined || (ref.uuid === undefined && ref.title === undefined))
+        return null;
+    const res = kind === "project" ? resolveProject(sim, ref) : resolveArea(sim, ref);
+    if (res.resolved === null)
+        throw new Error(`simulator: unresolved ${kind} reference`);
+    return res.resolved.uuid;
+}
+/** Resolve each tag ref to a TMTag uuid (leaf title match), skipping unknowns. */
+function tagUuids(sim, refs) {
+    const { titles } = resolveTagRefs(sim, refs);
+    const uuids = [];
+    for (const title of titles) {
+        const row = sim
+            .prepare("SELECT uuid FROM TMTag WHERE title = ? COLLATE NOCASE LIMIT 1")
+            .get(title);
+        if (row !== undefined)
+            uuids.push(row.uuid);
+    }
+    return uuids;
+}
+function setTaskTags(sim, taskUuid, refs) {
+    sim.prepare("DELETE FROM TMTaskTag WHERE tasks = ?").run(taskUuid);
+    for (const tagUuid of tagUuids(sim, refs)) {
+        sim.prepare("INSERT INTO TMTaskTag (tasks, tags) VALUES (?, ?)").run(taskUuid, tagUuid);
+    }
+}
+/** Recreate a to-do's checklist wholesale (all items open unless flagged). */
+function replaceChecklist(sim, taskUuid, items, ctx) {
+    sim.prepare("DELETE FROM TMChecklistItem WHERE task = ?").run(taskUuid);
+    let open = 0;
+    items.forEach((item, i) => {
+        const title = typeof item === "string" ? item : item.title;
+        const completed = typeof item !== "string" && item.completed === true;
+        if (!completed)
+            open++;
+        sim
+            .prepare(`INSERT INTO TMChecklistItem (uuid, userModificationDate, creationDate, title, status, stopDate, "index", task, leavesTombstone)
+         VALUES (?, ?, ?, ?, ?, NULL, ?, ?, 0)`)
+            .run(genUuid(), ctx.nowEpoch, ctx.nowEpoch, title, completed ? STATUS.completed : STATUS.open, i, taskUuid);
+    });
+    sim
+        .prepare("UPDATE TMTask SET checklistItemsCount = ?, openChecklistItemsCount = ?, userModificationDate = ? WHERE uuid = ?")
+        .run(items.length, open, ctx.nowEpoch, taskUuid);
+}
+/** The joined notes an append/prepend update should leave (mirrors expectedNotes). */
+function joinedNotes(sim, uuid, params) {
+    if (params.appendNotes === undefined && params.prependNotes === undefined)
+        return undefined;
+    const row = sim.prepare("SELECT notes FROM TMTask WHERE uuid = ?").get(uuid);
+    const current = row?.notes ?? "";
+    if (params.appendNotes !== undefined) {
+        return current === "" ? params.appendNotes : `${current}\n${params.appendNotes}`;
+    }
+    const prepend = params.prependNotes ?? "";
+    return current === "" ? prepend : `${prepend}\n${current}`;
+}
+/** The reminderTime packed value an update leaves (mirrors effectiveReminder). */
+function effectiveReminderValue(sim, uuid, params) {
+    if (params.reminder !== undefined) {
+        return params.reminder === null ? null : encodeReminderTime(params.reminder);
+    }
+    const when = params.when;
+    const schedulable = when === "today" ||
+        when === "evening" ||
+        (typeof when === "string" && /^\d{4}-\d{2}-\d{2}$/.test(when));
+    if (!schedulable)
+        return null;
+    // Preserve the existing reminder across a bare re-schedule.
+    const row = sim.prepare("SELECT reminderTime FROM TMTask WHERE uuid = ?").get(uuid);
+    return row?.reminderTime ?? null;
+}
+/** Shared to-do/project field update (title/notes/when+reminder/deadline). */
+function applyEntityUpdate(sim, params, ctx) {
+    const sets = [];
+    const binds = [];
+    if (params.title !== undefined) {
+        sets.push("title = ?");
+        binds.push(params.title);
+    }
+    if (params.notes !== undefined) {
+        sets.push("notes = ?");
+        binds.push(params.notes);
+    }
+    else {
+        const joined = joinedNotes(sim, params.uuid, params);
+        if (joined !== undefined) {
+            sets.push("notes = ?");
+            binds.push(joined);
+        }
+    }
+    if (params.when !== undefined) {
+        const s = scheduleColumns(params.when, ctx.todayIso, true);
+        sets.push("start = ?", "startDate = ?", "startBucket = ?");
+        binds.push(s.start, s.startDate, s.startBucket);
+        sets.push("reminderTime = ?");
+        binds.push(effectiveReminderValue(sim, params.uuid, params));
+    }
+    else if (params.reminder !== undefined) {
+        sets.push("reminderTime = ?");
+        binds.push(params.reminder === null ? null : encodeReminderTime(params.reminder));
+    }
+    if (params.deadline !== undefined) {
+        sets.push("deadline = ?");
+        binds.push(params.deadline === null ? null : encodePackedDate(params.deadline));
+    }
+    sets.push("userModificationDate = ?");
+    binds.push(ctx.nowEpoch);
+    sim.prepare(`UPDATE TMTask SET ${sets.join(", ")} WHERE uuid = ?`).run(...binds, params.uuid);
+}
+function setStatus(sim, uuid, status, stopDate, ctx) {
+    sim
+        .prepare("UPDATE TMTask SET status = ?, stopDate = ?, userModificationDate = ? WHERE uuid = ?")
+        .run(status, stopDate, ctx.nowEpoch, uuid);
+}
+// ------------------------------------------------- recurrence appliers
+//
+// The row-level shapes below reproduce the RSIM campaign verdicts
+// (docs/lab/rsim-results.md, RSIM1–6): making a to-do/project repeat, the
+// fixed-vs-after-completion identity asymmetry, in-place reschedule, and the
+// completion-side stamping that schedules the next after-completion occurrence
+// without materializing it. Rule blobs come from the SHARED composer
+// (recurrence-rule-blob.ts), so every emitted template decodes with the real
+// read-path decoder.
+/** A deadlined template's own `deadline` column carries this far-future sentinel (§8a). */
+const DEADLINE_SENTINEL_ISO = "4001-01-01";
+/** Add whole recurrence units to an ISO date (day/week/month/year). */
+function addUnitsIso(iso, frequency, interval) {
+    switch (frequency) {
+        case "daily":
+            return addDaysIso(iso, interval);
+        case "weekly":
+            return addDaysIso(iso, 7 * interval);
+        case "monthly":
+            return addMonthsIso(iso, interval);
+        case "yearly":
+            return addMonthsIso(iso, 12 * interval);
+    }
+}
+/** Add whole months to an ISO date, clamping the day to the target month's length. */
+function addMonthsIso(iso, months) {
+    const [y, m, d] = iso.split("-").map(Number);
+    const anchor = new Date(Date.UTC(y, m - 1 + months, 1));
+    const year = anchor.getUTCFullYear();
+    const month0 = anchor.getUTCMonth();
+    const lastDay = new Date(Date.UTC(year, month0 + 1, 0)).getUTCDate();
+    const day = Math.min(d, lastDay);
+    return (`${String(year).padStart(4, "0")}-` +
+        `${String(month0 + 1).padStart(2, "0")}-` +
+        `${String(day).padStart(2, "0")}`);
+}
+/** Epoch seconds at UTC-noon of an ISO date — the (decoder-ignored) rule anchor. */
+function epochOfIso(iso) {
+    return Math.floor(Date.parse(`${iso}T12:00:00Z`) / 1000);
+}
+/** Insert a template or instance row, covering the full rt1_* recurrence column set. */
+function insertRecurrenceRow(sim, ctx, o) {
+    sim
+        .prepare(`INSERT INTO TMTask (
+         uuid, type, status, stopDate, trashed, title, notes,
+         creationDate, userModificationDate,
+         start, startDate, startBucket, reminderTime, deadline, deadlineSuppressionDate,
+         "index", todayIndex, todayIndexReferenceDate, area, project, heading,
+         untrashedLeafActionsCount, openUntrashedLeafActionsCount,
+         checklistItemsCount, openChecklistItemsCount,
+         rt1_repeatingTemplate, rt1_recurrenceRule, rt1_instanceCreationStartDate,
+         rt1_instanceCreationPaused, rt1_instanceCreationCount,
+         rt1_afterCompletionReferenceDate, rt1_nextInstanceStartDate, repeater
+       ) VALUES (?, ?, 0, NULL, 0, ?, ?, ?, ?, ?, ?, 0, NULL, ?, NULL, 0, 0, NULL, ?, NULL, NULL,
+                 0, 0, 0, 0, ?, ?, ?, 0, ?, ?, ?, NULL)`)
+        .run(o.uuid, o.type, o.title, o.notes, ctx.nowEpoch, ctx.nowEpoch, o.start, o.startDate, o.deadline, o.area, o.repeatingTemplate ?? null, o.recurrenceRuleXml !== undefined ? new TextEncoder().encode(o.recurrenceRuleXml) : null, o.instanceCreationStartDate ?? null, o.instanceCreationCount ?? 0, o.afterCompletionReferenceDate ?? null, o.nextInstanceStartDate ?? null);
+}
+/** Copy a task's direct tag links onto another task (title/notes/tags/area copy from source). */
+function copyTaskTags(sim, fromUuid, toUuid) {
+    const rows = sim.prepare("SELECT tags FROM TMTaskTag WHERE tasks = ?").all(fromUuid);
+    for (const r of rows) {
+        sim.prepare("INSERT INTO TMTaskTag (tasks, tags) VALUES (?, ?)").run(toUuid, r.tags);
+    }
+}
+function loadRepeatSource(sim, uuid) {
+    const src = sim
+        .prepare("SELECT title, notes, area, startDate FROM TMTask WHERE uuid = ?")
+        .get(uuid);
+    if (src === undefined)
+        throw new Error("simulator: make-repeating target not found");
+    return {
+        title: src.title ?? "",
+        notes: src.notes ?? "",
+        area: src.area,
+        startDate: src.startDate,
+    };
+}
+/**
+ * Read a project's full containment subtree (headings + direct/headed to-dos,
+ * with tags + checklist) before any mutation.
+ *
+ * RSIM-S (§RSIM-S S-R1): trashed rows are INCLUDED (each tagged `trashed`) so a
+ * source-DELETE conversion can hard-delete the WHOLE subtree — reality destroys
+ * a pre-trashed child along with the source, leaving no orphan. Copy paths
+ * (`materializeSubtreeCopy`) filter these back out — a spawned/template copy
+ * never carries trashed rows (RSIM-P2 A3, probe-verified).
+ */
+function readProjectSubtree(sim, projectUuid) {
+    const headingRows = sim
+        .prepare(`SELECT uuid, title, notes, status, stopDate, trashed, "index" AS idx
+         FROM TMTask WHERE type = 2 AND project = ? ORDER BY "index"`)
+        .all(projectUuid);
+    const headings = headingRows.map((h) => ({
+        uuid: h.uuid,
+        title: h.title ?? "",
+        notes: h.notes ?? "",
+        status: h.status,
+        stopDate: h.stopDate,
+        index: h.idx,
+        trashed: h.trashed === 1,
+    }));
+    const headingUuids = headings.map((h) => h.uuid);
+    // A direct child has project=<projectUuid>; a headed child has project=NULL
+    // and heading=<one of this project's headings> — this union captures both.
+    const placeholders = headingUuids.map(() => "?").join(", ");
+    const todoRows = sim
+        .prepare(`SELECT uuid, title, notes, status, stopDate, deadline, heading, trashed,
+              rt1_recurrenceRule AS recurrenceRule, rt1_repeatingTemplate AS repeatingTemplate,
+              "index" AS idx
+         FROM TMTask WHERE type = 0
+           AND (project = ?${headingUuids.length > 0 ? ` OR heading IN (${placeholders})` : ""})
+         ORDER BY "index"`)
+        .all(projectUuid, ...headingUuids);
+    const todos = todoRows.map((t) => ({
+        uuid: t.uuid,
+        title: t.title ?? "",
+        notes: t.notes ?? "",
+        status: t.status,
+        stopDate: t.stopDate,
+        deadline: t.deadline,
+        index: t.idx,
+        trashed: t.trashed === 1,
+        headingUuid: t.heading,
+        recurrenceRule: t.recurrenceRule,
+        repeatingTemplate: t.repeatingTemplate,
+        tags: sim.prepare("SELECT tags FROM TMTaskTag WHERE tasks = ?").all(t.uuid).map((r) => r.tags),
+        checklist: sim
+            .prepare(`SELECT title, status, "index" AS idx FROM TMChecklistItem WHERE task = ? ORDER BY "index"`)
+            .all(t.uuid).map((c) => ({ title: c.title ?? "", status: c.status, index: c.idx })),
+    }));
+    return { headings, todos };
+}
+/** UPDATE a row's list index (insertTask hardcodes 0; the copy preserves source order). */
+function setRowIndex(sim, uuid, index) {
+    sim.prepare(`UPDATE TMTask SET "index" = ? WHERE uuid = ?`).run(index, uuid);
+}
+/**
+ * Materialize a PLAIN copy of `subtree` under `newProjectUuid` (fresh uuids for
+ * every heading/to-do; tags + checklist duplicated; index order + heading
+ * membership preserved; children `start=1`, `rt1_recurrenceRule`/
+ * `rt1_repeatingTemplate` NULL).
+ *
+ * RSIM-R: copied children are ALWAYS plain — both fixed and after-completion
+ * instance/template sides. (RSIM-P P4's per-child instance→template links are a
+ * non-reproducible anomaly; A5/R7/R8 = 3/3 plain — so no linkMap parameter.)
+ */
+function materializeSubtreeCopy(sim, ctx, subtree, newProjectUuid) {
+    const headingIdMap = new Map();
+    for (const h of subtree.headings) {
+        if (h.trashed)
+            continue; // RSIM-S S-R1: copies exclude trashed rows (RSIM-P2 A3).
+        const newUuid = genUuid();
+        insertTask(sim, 2, ctx, {
+            uuid: newUuid,
+            title: h.title,
+            notes: h.notes,
+            start: START.active, // RSIM-P P1: copied children are start=1
+            project: newProjectUuid,
+        });
+        setRowIndex(sim, newUuid, h.index);
+        if (h.status !== STATUS.open)
+            setStatus(sim, newUuid, h.status, h.stopDate ?? ctx.nowEpoch, ctx);
+        headingIdMap.set(h.uuid, newUuid);
+    }
+    for (const t of subtree.todos) {
+        if (t.trashed)
+            continue; // RSIM-S S-R1: copies exclude trashed rows (RSIM-P2 A3).
+        const newUuid = genUuid();
+        // Preserve the containment invariant: a headed child points at the COPIED
+        // heading with project NULL; a direct child points at the new project.
+        const heading = t.headingUuid !== null ? (headingIdMap.get(t.headingUuid) ?? null) : null;
+        const project = heading !== null ? null : newProjectUuid;
+        const openChecklist = t.checklist.filter((c) => c.status === STATUS.open).length;
+        insertTask(sim, 0, ctx, {
+            uuid: newUuid,
+            title: t.title,
+            notes: t.notes,
+            start: START.active, // RSIM-P P1: start=1
+            startDate: null,
+            deadline: t.deadline,
+            project,
+            heading,
+            checklistItemsCount: t.checklist.length,
+            openChecklistItemsCount: openChecklist,
+        });
+        setRowIndex(sim, newUuid, t.index);
+        if (t.status !== STATUS.open)
+            setStatus(sim, newUuid, t.status, t.stopDate ?? ctx.nowEpoch, ctx);
+        for (const tag of t.tags) {
+            sim.prepare("INSERT INTO TMTaskTag (tasks, tags) VALUES (?, ?)").run(newUuid, tag);
+        }
+        for (const c of t.checklist) {
+            sim
+                .prepare(`INSERT INTO TMChecklistItem (uuid, userModificationDate, creationDate, title, status, stopDate, "index", task, leavesTombstone)
+             VALUES (?, ?, ?, ?, ?, NULL, ?, ?, 0)`)
+                .run(genUuid(), ctx.nowEpoch, ctx.nowEpoch, c.title, c.status, c.index, newUuid);
+        }
+    }
+}
+/**
+ * Hard-DELETE a source subtree: each to-do's tags + checklist + row, then the
+ * heading rows.
+ *
+ * RSIM-S (§RSIM-S S-R1): the subtree includes already-trashed rows, and they are
+ * destroyed here too — a source-DELETE conversion hard-deletes the WHOLE source
+ * subtree, so a pre-trashed child does NOT survive as a dangling row pointing at
+ * the deleted source (it is neither copied nor left in the Trash).
+ */
+function deleteProjectSubtree(sim, subtree) {
+    for (const t of subtree.todos) {
+        sim.prepare("DELETE FROM TMTaskTag WHERE tasks = ?").run(t.uuid);
+        sim.prepare("DELETE FROM TMChecklistItem WHERE task = ?").run(t.uuid);
+        sim.prepare("DELETE FROM TMTask WHERE uuid = ?").run(t.uuid);
+    }
+    for (const h of subtree.headings) {
+        sim.prepare("DELETE FROM TMTaskTag WHERE tasks = ?").run(h.uuid);
+        sim.prepare("DELETE FROM TMTask WHERE uuid = ?").run(h.uuid);
+    }
+}
+/**
+ * RSIM-R: a NESTED repeater in a project's subtree is a to-do carrying either
+ * `rt1_recurrenceRule` (the nested hidden template) or `rt1_repeatingTemplate`
+ * (the nested repeater's instance). Its presence flips the fixed project
+ * make-repeating from delete-and-mint-both to the source-preserving flatten path.
+ */
+function subtreeHasNestedRepeater(subtree) {
+    // RSIM-S S-R1: consider only live rows — a trashed nested repeater does not
+    // flip source-fate (a trashed child alone leaves the delete-default intact).
+    return subtree.todos.some((t) => !t.trashed && (t.recurrenceRule !== null || t.repeatingTemplate !== null));
+}
+/**
+ * FIXED make-repeating (RSIM1 to-do / RSIM6 project / RSIM3 create leg): the
+ * source is DESTROYED (identity replacement) and replaced by a hidden template
+ * (start=someday, rule tp=0, next-occurrence dates) plus EXACTLY ONE instance
+ * dated at the current occurrence. Area/title/notes/tags copy to both. For a
+ * PROJECT (type=1) with children, the source subtree is hard-deleted and a plain
+ * copy is minted under BOTH new projects (RSIM-P P1).
+ *
+ * RSIM-R exception (fixed PROJECT only): if the source project's subtree contains
+ * a NESTED repeater, the source is instead PRESERVED and relinked as the current-
+ * occurrence instance, the nested repeater is FLATTENED in place, and ONLY the
+ * hidden template project is minted (no separate instance project). See
+ * `applyMakeRepeatingFixedProjectFlatten`. Area/When are irrelevant; the sole
+ * discriminator is the nested repeater. The to-do fixed-preserve anomaly (a
+ * content-rich to-do; §RSIM-R parked, unisolated trigger) is deliberately
+ * UNMODELED — to-dos always delete here.
+ */
+function applyMakeRepeatingFixed(sim, type, params, ctx) {
+    const src = loadRepeatSource(sim, params.uuid);
+    // RSIM-P P1: a project's child subtree is captured BEFORE any mutation so the
+    // hidden template and the instance each receive a plain copy. To-dos have none.
+    const subtree = type === 1 ? readProjectSubtree(sim, params.uuid) : null;
+    const todayIso = ctx.todayIso;
+    const nextIso = addUnitsIso(todayIso, params.frequency, params.interval);
+    const deadlined = params.deadline === true || (params.startDaysEarlier ?? 0) > 0;
+    const startEarlier = params.startDaysEarlier ?? 0;
+    const spec = composeRepeatRuleSpec(params, todayIso, epochOfIso(nextIso));
+    const templateUuid = genUuid();
+    // The hidden template row is identical in both fixed-project fates.
+    insertRecurrenceRow(sim, ctx, {
+        uuid: templateUuid,
+        type,
+        title: src.title,
+        notes: src.notes,
+        area: src.area,
+        start: START.someday,
+        startDate: null,
+        deadline: deadlined ? encodePackedDate(DEADLINE_SENTINEL_ISO) : null,
+        recurrenceRuleXml: ruleXml(spec),
+        instanceCreationCount: 1,
+        instanceCreationStartDate: encodePackedDate(nextIso),
+        nextInstanceStartDate: encodePackedDate(nextIso),
+    });
+    copyTaskTags(sim, params.uuid, templateUuid);
+    // The current occurrence's start (deadlined series back off `startDaysEarlier`;
+    // decode identity deadline = startDate − ts; deadlined creation is not itself
+    // RSIM-drive-proven).
+    const instStartIso = deadlined ? addDaysIso(todayIso, -startEarlier) : todayIso;
+    // RSIM-R: fixed PROJECT with a nested repeater PRESERVES the source (flatten path).
+    if (subtree !== null && subtreeHasNestedRepeater(subtree)) {
+        applyMakeRepeatingFixedProjectFlatten(sim, ctx, params.uuid, subtree, templateUuid, instStartIso);
+        return;
+    }
+    // RSIM-P P1: template-side children are completely PLAIN (no per-child link).
+    if (subtree !== null)
+        materializeSubtreeCopy(sim, ctx, subtree, templateUuid);
+    // ONE instance at the current occurrence (start=someday pending maintenance
+    // promotion). A deadlined series dates the instance's deadline at the occurrence.
+    const instanceUuid = genUuid();
+    insertRecurrenceRow(sim, ctx, {
+        uuid: instanceUuid,
+        type,
+        title: src.title,
+        notes: src.notes,
+        area: src.area,
+        start: START.someday,
+        startDate: encodePackedDate(instStartIso),
+        deadline: deadlined ? encodePackedDate(todayIso) : null,
+        repeatingTemplate: templateUuid,
+    });
+    copyTaskTags(sim, params.uuid, instanceUuid);
+    // RSIM-P P1: FIXED instance-side children are ALSO plain — no per-child link.
+    if (subtree !== null)
+        materializeSubtreeCopy(sim, ctx, subtree, instanceUuid);
+    // RSIM-P P1: hard-delete the whole source subtree, then the source project.
+    if (subtree !== null)
+        deleteProjectSubtree(sim, subtree);
+    sim.prepare("DELETE FROM TMTaskTag WHERE tasks = ?").run(params.uuid);
+    sim.prepare("DELETE FROM TMTask WHERE uuid = ?").run(params.uuid);
+}
+/**
+ * RSIM-R (fixed PROJECT whose subtree contains a nested repeater — A1/A2/A3/S2/
+ * S2b): the source project is PRESERVED and relinked as the current-occurrence
+ * instance rather than deleted; the nested repeater is FLATTENED in place; and
+ * only the (already-minted) hidden template project is populated — there is NO
+ * separate instance project. Row-level shape (S2, re-derived uuid-by-uuid):
+ *   - source project CHANGED: `start → 2` (someday), `startDate → currentOccurrence`,
+ *     `rt1_repeatingTemplate → template`. All other source columns (title, notes,
+ *     area, deadline) are left untouched.
+ *   - nested template row hard-deleted; nested instance demoted to PLAIN
+ *     (`rt1_repeatingTemplate → NULL`).
+ *   - the template project receives a PLAIN copy of the FLATTENED subtree (the
+ *     nested template rows excluded; the demoted instance copied as a plain to-do).
+ */
+function applyMakeRepeatingFixedProjectFlatten(sim, ctx, sourceUuid, subtree, templateUuid, instStartIso) {
+    // The template project gets a plain copy of the FLATTENED subtree — nested
+    // template rows are dropped; every surviving to-do copies plain via
+    // materializeSubtreeCopy (start=1, no recurrence/template links).
+    // RSIM-S S-R1: the copy excludes trashed rows; materializeSubtreeCopy also
+    // skips them, but keep the flattened set clean for clarity.
+    const flattened = {
+        headings: subtree.headings.filter((h) => !h.trashed),
+        todos: subtree.todos.filter((t) => t.recurrenceRule === null && !t.trashed),
+    };
+    materializeSubtreeCopy(sim, ctx, flattened, templateUuid);
+    // Flatten the nested repeater IN the preserved source subtree. Trashed rows
+    // ride along untouched under the preserved source (RSIM-S S-R2, inferred).
+    for (const t of subtree.todos) {
+        if (t.trashed)
+            continue;
+        if (t.recurrenceRule !== null) {
+            // Nested hidden template: hard-delete its tags + checklist + row.
+            sim.prepare("DELETE FROM TMTaskTag WHERE tasks = ?").run(t.uuid);
+            sim.prepare("DELETE FROM TMChecklistItem WHERE task = ?").run(t.uuid);
+            sim.prepare("DELETE FROM TMTask WHERE uuid = ?").run(t.uuid);
+        }
+        else if (t.repeatingTemplate !== null) {
+            // Nested instance: demote to a plain to-do.
+            sim.prepare("UPDATE TMTask SET rt1_repeatingTemplate = NULL WHERE uuid = ?").run(t.uuid);
+        }
+    }
+    // Preserve the source project AS the current-occurrence instance.
+    sim
+        .prepare(`UPDATE TMTask SET start = ?, startDate = ?, rt1_repeatingTemplate = ?, userModificationDate = ? WHERE uuid = ?`)
+        .run(START.someday, encodePackedDate(instStartIso), templateUuid, ctx.nowEpoch, sourceUuid);
+}
+/**
+ * AFTER-COMPLETION make-repeating.
+ *
+ * TO-DO (type=0, RSIM2): the source is PRESERVED and relinked as the sole first
+ * instance (identity kept — §8g: identity replacement is fixed-only). A new tp=1
+ * template is created with NO next/reference dates (unknown until a completion).
+ * No fresh instance row is minted.
+ *
+ * PROJECT (type=1, RSIM-P P4): the type-0 path does NOT hold — the source is
+ * DELETED (like the fixed case) and BOTH a template and a fresh instance are
+ * minted, each with a full plain child copy, and each instance-side to-do child
+ * carries a per-child rt1_repeatingTemplate. Split out to a dedicated applier.
+ */
+function applyMakeRepeatingAfterCompletion(sim, type, params, ctx) {
+    // RSIM-P P4: the after-completion PROJECT path is NOT the to-do path.
+    if (type === 1) {
+        applyMakeRepeatingAfterCompletionProject(sim, params, ctx);
+        return;
+    }
+    const src = loadRepeatSource(sim, params.uuid);
+    const refIso = decodePackedDate(src.startDate) ?? ctx.todayIso;
+    const deadlined = params.deadline === true || (params.startDaysEarlier ?? 0) > 0;
+    const spec = composeRepeatRuleSpec(params, refIso, epochOfIso(refIso));
+    const templateUuid = genUuid();
+    insertRecurrenceRow(sim, ctx, {
+        uuid: templateUuid,
+        type,
+        title: src.title,
+        notes: src.notes,
+        area: src.area,
+        start: START.someday,
+        startDate: null,
+        deadline: deadlined ? encodePackedDate(DEADLINE_SENTINEL_ISO) : null,
+        recurrenceRuleXml: ruleXml(spec),
+        instanceCreationCount: 0,
+    });
+    copyTaskTags(sim, params.uuid, templateUuid);
+    // Relink the preserved source as the instance; startDate/start unchanged.
+    sim
+        .prepare("UPDATE TMTask SET rt1_repeatingTemplate = ?, userModificationDate = ? WHERE uuid = ?")
+        .run(templateUuid, ctx.nowEpoch, params.uuid);
+}
+/**
+ * AFTER-COMPLETION make-repeating for a PROJECT (RSIM-P P4). Unlike the to-do
+ * path (RSIM2, source preserved), the source project is DELETED and both a
+ * template and a fresh instance are minted — the same delete+duplicate shape as
+ * the fixed project case, but with:
+ *   - a tp=1 (after-completion) rule and NO next/reference dates
+ *     (`rt1_nextInstanceStartDate` / `rt1_afterCompletionReferenceDate` NULL);
+ *   - the template's `rt1_instanceCreationCount` = 1 (P4 observed, vs 0 for the
+ *     after-completion TO-DO template);
+ *   - the instance's `startDate` = the SOURCE project's startDate (not the
+ *     current occurrence used by the fixed case).
+ *
+ * RSIM-R: instance-side children (to-dos AND headings) are PLAIN — no per-child
+ * `rt1_repeatingTemplate` link. RSIM-P P4's per-child links are a NON-reproducible
+ * anomaly (A5/R7/R8 = 3/3 plain); only the project row carries the instance→
+ * template link.
+ */
+function applyMakeRepeatingAfterCompletionProject(sim, params, ctx) {
+    const src = loadRepeatSource(sim, params.uuid);
+    const subtree = readProjectSubtree(sim, params.uuid);
+    const refIso = decodePackedDate(src.startDate) ?? ctx.todayIso;
+    const deadlined = params.deadline === true || (params.startDaysEarlier ?? 0) > 0;
+    const spec = composeRepeatRuleSpec(params, refIso, epochOfIso(refIso));
+    const templateUuid = genUuid();
+    const instanceUuid = genUuid();
+    // Template: tp=1 rule, hidden, icCount=1, NO next/reference dates (P4).
+    insertRecurrenceRow(sim, ctx, {
+        uuid: templateUuid,
+        type: 1,
+        title: src.title,
+        notes: src.notes,
+        area: src.area,
+        start: START.someday,
+        startDate: null,
+        deadline: deadlined ? encodePackedDate(DEADLINE_SENTINEL_ISO) : null,
+        recurrenceRuleXml: ruleXml(spec),
+        instanceCreationCount: 1, // RSIM-P P4
+    });
+    copyTaskTags(sim, params.uuid, templateUuid);
+    // Template-side children are PLAIN.
+    materializeSubtreeCopy(sim, ctx, subtree, templateUuid);
+    // Instance: fresh row (source is deleted, unlike the to-do path), tmpl link,
+    // startDate = the SOURCE project's startDate (P4).
+    insertRecurrenceRow(sim, ctx, {
+        uuid: instanceUuid,
+        type: 1,
+        title: src.title,
+        notes: src.notes,
+        area: src.area,
+        start: START.someday,
+        startDate: src.startDate,
+        deadline: null,
+        repeatingTemplate: templateUuid,
+    });
+    copyTaskTags(sim, params.uuid, instanceUuid);
+    // RSIM-R: instance-side children are PLAIN — no per-child template link
+    // (P4's links do not reproduce; pass null exactly as the fixed case does).
+    materializeSubtreeCopy(sim, ctx, subtree, instanceUuid);
+    // Hard-delete the source subtree + the source project (P4 deletes the source).
+    deleteProjectSubtree(sim, subtree);
+    sim.prepare("DELETE FROM TMTaskTag WHERE tasks = ?").run(params.uuid);
+    sim.prepare("DELETE FROM TMTask WHERE uuid = ?").run(params.uuid);
+}
+/** Route a make-repeating to the fixed or after-completion applier by rule type. */
+function applyMakeRepeating(sim, type, params, ctx) {
+    if (params.afterCompletion === true)
+        applyMakeRepeatingAfterCompletion(sim, type, params, ctx);
+    else
+        applyMakeRepeatingFixed(sim, type, params, ctx);
+}
+/**
+ * reschedule-repeat (RSIM5, to-do or project): identity PRESERVED, the rule
+ * rewritten in place to the target `{frequency, interval, anchors}` with the
+ * instance-creation date advanced to the new next occurrence. `tp` and the
+ * deadline-ness (ts + the template's deadline column) are preserved unless the
+ * reschedule explicitly changes them. (The shipped op's interval-entry app bug
+ * — RSIM5 caveat — is NOT modeled here: the simulator applies the TARGET rule.)
+ */
+function applyReschedule(sim, params, ctx) {
+    const row = sim
+        .prepare("SELECT rt1_recurrenceRule AS rule FROM TMTask WHERE uuid = ?")
+        .get(params.uuid);
+    if (row === undefined || row.rule === null) {
+        throw new Error("simulator: reschedule-repeat target is not a repeating template");
+    }
+    const existing = decodeRecurrenceRule(row.rule);
+    const paramsHasAnchor = params.weekdays !== undefined || params.monthly !== undefined || params.yearly !== undefined;
+    const preserveAfterCompletion = params.afterCompletion === undefined &&
+        !paramsHasAnchor &&
+        existing.type === "after-completion";
+    const effective = { ...params };
+    if (preserveAfterCompletion)
+        effective.afterCompletion = true;
+    const todayIso = ctx.todayIso;
+    const nextIso = addUnitsIso(todayIso, params.frequency, params.interval);
+    const spec = composeRepeatRuleSpec(effective, todayIso, epochOfIso(nextIso));
+    const setsDeadline = params.deadline !== undefined || params.startDaysEarlier !== undefined;
+    if (!setsDeadline)
+        spec.ts = existing.startOffsetDays; // preserve the prior start offset
+    const sets = [
+        "rt1_recurrenceRule = ?",
+        "rt1_instanceCreationStartDate = ?",
+        "rt1_nextInstanceStartDate = ?",
+        "userModificationDate = ?",
+    ];
+    const binds = [
+        new TextEncoder().encode(ruleXml(spec)),
+        encodePackedDate(nextIso),
+        encodePackedDate(nextIso),
+        ctx.nowEpoch,
+    ];
+    if (setsDeadline) {
+        const deadlined = params.deadline === true || (params.startDaysEarlier ?? 0) > 0;
+        sets.push("deadline = ?");
+        binds.push(deadlined ? encodePackedDate(DEADLINE_SENTINEL_ISO) : null);
+    }
+    sim.prepare(`UPDATE TMTask SET ${sets.join(", ")} WHERE uuid = ?`).run(...binds, params.uuid);
+}
+/**
+ * Completion-side scheduling (RSIM4): completing an INSTANCE of an
+ * after-completion (tp=1) template stamps the template's reference + next-start
+ * dates (completion date, completion date + interval) WITHOUT materializing the
+ * next instance — it stays pending until its future start date arrives. A
+ * fixed-template instance (or a non-instance) is untouched here.
+ */
+function stampAfterCompletionTemplate(sim, instanceUuid, ctx) {
+    const inst = sim
+        .prepare("SELECT rt1_repeatingTemplate AS tmpl FROM TMTask WHERE uuid = ?")
+        .get(instanceUuid);
+    const templateUuid = inst?.tmpl;
+    if (templateUuid === null || templateUuid === undefined)
+        return;
+    const tpl = sim
+        .prepare("SELECT rt1_recurrenceRule AS rule FROM TMTask WHERE uuid = ?")
+        .get(templateUuid);
+    if (tpl === undefined || tpl.rule === null)
+        return;
+    let rule;
+    try {
+        rule = decodeRecurrenceRule(tpl.rule);
+    }
+    catch {
+        return; // undecodable template — leave it untouched
+    }
+    if (rule.type !== "after-completion")
+        return;
+    const completionIso = ctx.todayIso;
+    const nextIso = addUnitsIso(completionIso, rule.unit, rule.interval);
+    sim
+        .prepare("UPDATE TMTask SET rt1_afterCompletionReferenceDate = ?, rt1_nextInstanceStartDate = ?, " +
+        "userModificationDate = ? WHERE uuid = ?")
+        .run(encodePackedDate(completionIso), encodePackedDate(nextIso), ctx.nowEpoch, templateUuid);
+}
+/** Typed applier helper — narrows the params for one operation kind. */
+function op(fn) {
+    return (sim, params, ctx) => fn(sim, params, ctx);
+}
+const APPLIERS = {
+    "todo.add": op((sim, params, ctx) => {
+        let project = null;
+        let heading = null;
+        let area = null;
+        if (params.heading !== undefined && params.project !== undefined) {
+            const projUuid = containerUuid(sim, params.project, "project");
+            if (projUuid === null)
+                throw new Error("simulator: to-do heading needs a project");
+            const h = resolveHeading(sim, projUuid, params.heading);
+            if (h.resolved === null)
+                throw new Error("simulator: unresolved heading");
+            heading = h.resolved.uuid; // project reached via the heading (project col NULL)
+        }
+        else if (params.project !== undefined) {
+            project = containerUuid(sim, params.project, "project");
+        }
+        else if (params.area !== undefined) {
+            area = containerUuid(sim, params.area, "area");
+        }
+        const hasContainer = project !== null || heading !== null || area !== null;
+        const s = scheduleColumns(params.when, ctx.todayIso, hasContainer);
+        const uuid = genUuid();
+        insertTask(sim, 0, ctx, {
+            uuid,
+            title: params.title,
+            notes: params.notes ?? "",
+            start: s.start,
+            startDate: s.startDate,
+            startBucket: s.startBucket,
+            reminderTime: params.reminder !== undefined ? encodeReminderTime(params.reminder) : null,
+            deadline: params.deadline !== undefined ? encodePackedDate(params.deadline) : null,
+            area,
+            project,
+            heading,
+        });
+        if (params.tags !== undefined)
+            setTaskTags(sim, uuid, params.tags);
+        if (params.checklistItems !== undefined)
+            replaceChecklist(sim, uuid, params.checklistItems, ctx);
+    }),
+    "todo.update": op((sim, params, ctx) => applyEntityUpdate(sim, params, ctx)),
+    "todo.complete": op((sim, params, ctx) => {
+        setStatus(sim, params.uuid, STATUS.completed, ctx.nowEpoch, ctx);
+        // RSIM4: completing an after-completion instance schedules the next
+        // occurrence on its template without materializing it.
+        stampAfterCompletionTemplate(sim, params.uuid, ctx);
+    }),
+    "todo.cancel": op((sim, params, ctx) => setStatus(sim, params.uuid, STATUS.canceled, ctx.nowEpoch, ctx)),
+    "todo.reopen": op((sim, params, ctx) => setStatus(sim, params.uuid, STATUS.open, null, ctx)),
+    "todo.delete": op((sim, params, ctx) => sim
+        .prepare("UPDATE TMTask SET trashed = 1, userModificationDate = ? WHERE uuid = ?")
+        .run(ctx.nowEpoch, params.uuid)),
+    "todo.restore": op((sim, params, ctx) => 
+    // Put Back → un-trash into the Inbox, de-scheduled (E15).
+    sim
+        .prepare("UPDATE TMTask SET trashed = 0, start = 0, startDate = NULL, startBucket = 0, userModificationDate = ? WHERE uuid = ?")
+        .run(ctx.nowEpoch, params.uuid)),
+    "todo.move": op((sim, params, ctx) => {
+        if (params.inbox === true) {
+            sim
+                .prepare("UPDATE TMTask SET start = 0, startDate = NULL, startBucket = 0, project = NULL, area = NULL, heading = NULL, userModificationDate = ? WHERE uuid = ?")
+                .run(ctx.nowEpoch, params.uuid);
+            return;
+        }
+        if (params.detach === true) {
+            sim
+                .prepare("UPDATE TMTask SET project = NULL, area = NULL, heading = NULL, userModificationDate = ? WHERE uuid = ?")
+                .run(ctx.nowEpoch, params.uuid);
+            return;
+        }
+        if (params.heading !== undefined && params.project !== undefined) {
+            const projUuid = containerUuid(sim, params.project, "project");
+            if (projUuid === null)
+                throw new Error("simulator: move heading needs a project");
+            const h = resolveHeading(sim, projUuid, params.heading);
+            if (h.resolved === null)
+                throw new Error("simulator: unresolved heading");
+            sim
+                .prepare("UPDATE TMTask SET heading = ?, project = NULL, area = NULL, start = CASE WHEN start = 0 THEN 1 ELSE start END, userModificationDate = ? WHERE uuid = ?")
+                .run(h.resolved.uuid, ctx.nowEpoch, params.uuid);
+            return;
+        }
+        if (params.project !== undefined) {
+            const projUuid = containerUuid(sim, params.project, "project");
+            sim
+                .prepare("UPDATE TMTask SET project = ?, heading = NULL, area = NULL, start = CASE WHEN start = 0 THEN 1 ELSE start END, userModificationDate = ? WHERE uuid = ?")
+                .run(projUuid, ctx.nowEpoch, params.uuid);
+            return;
+        }
+        if (params.area !== undefined) {
+            const areaUuid = containerUuid(sim, params.area, "area");
+            // Filing an inbox item into a container promotes it to Anytime (start
+            // 0→1), matching the app; someday (2) and already-active items keep
+            // their start. Same promotion on the project/heading branches above.
+            sim
+                .prepare("UPDATE TMTask SET area = ?, project = NULL, heading = NULL, start = CASE WHEN start = 0 THEN 1 ELSE start END, userModificationDate = ? WHERE uuid = ?")
+                .run(areaUuid, ctx.nowEpoch, params.uuid);
+        }
+    }),
+    "todo.set-tags": op((sim, params, ctx) => {
+        setTaskTags(sim, params.uuid, params.tags);
+        sim
+            .prepare("UPDATE TMTask SET userModificationDate = ? WHERE uuid = ?")
+            .run(ctx.nowEpoch, params.uuid);
+    }),
+    "todo.replace-checklist": op((sim, params, ctx) => replaceChecklist(sim, params.uuid, params.items, ctx)),
+    "project.add": op((sim, params, ctx) => {
+        const area = containerUuid(sim, params.area, "area");
+        const s = scheduleColumns(params.when, ctx.todayIso, area !== null);
+        const uuid = genUuid();
+        insertTask(sim, 1, ctx, {
+            uuid,
+            title: params.title,
+            notes: params.notes ?? "",
+            start: s.start,
+            startDate: s.startDate,
+            startBucket: s.startBucket,
+            deadline: params.deadline !== undefined ? encodePackedDate(params.deadline) : null,
+            area,
+        });
+        // `todos` seed children are not asserted by the delta and are omitted.
+    }),
+    "project.update": op((sim, params, ctx) => applyEntityUpdate(sim, params, ctx)),
+    "project.complete": op((sim, params, ctx) => {
+        // Cascade open children to completed; canceled children are untouched (T08).
+        // RSIM-P P2: completion also flips the containing HEADING rows (type=2)
+        // status 0→3, not just the to-dos (type=0).
+        const children = sim
+            .prepare(`SELECT uuid FROM TMTask WHERE trashed = 0 AND status = 0
+         AND (
+           (type = 0 AND (project = ? OR heading IN (SELECT uuid FROM TMTask WHERE type = 2 AND project = ?)))
+           OR (type = 2 AND project = ?)
+         )`)
+            .all(params.uuid, params.uuid, params.uuid);
+        for (const c of children)
+            setStatus(sim, c.uuid, STATUS.completed, ctx.nowEpoch, ctx);
+        setStatus(sim, params.uuid, STATUS.completed, ctx.nowEpoch, ctx);
+        // RSIM-P P2: completing an INSTANCE project also promotes its own start 2→1
+        // (observed only for instance projects — a plain project is left untouched).
+        sim
+            .prepare("UPDATE TMTask SET start = 1 WHERE uuid = ? AND rt1_repeatingTemplate IS NOT NULL")
+            .run(params.uuid);
+    }),
+    "area.add": op((sim, params) => {
+        const uuid = genUuid();
+        sim
+            .prepare(`INSERT INTO TMArea (uuid, title, visible, "index") VALUES (?, ?, 1, 0)`)
+            .run(uuid, params.title);
+        if (params.tags !== undefined) {
+            for (const tagUuid of tagUuids(sim, params.tags)) {
+                sim.prepare("INSERT INTO TMAreaTag (areas, tags) VALUES (?, ?)").run(uuid, tagUuid);
+            }
+        }
+    }),
+    "area.update": op((sim, params) => {
+        const res = resolveArea(sim, { uuid: params.target, title: params.target });
+        if (res.resolved === null)
+            throw new Error("simulator: unresolved area target");
+        const uuid = res.resolved.uuid;
+        if (params.title !== undefined) {
+            sim.prepare("UPDATE TMArea SET title = ? WHERE uuid = ?").run(params.title, uuid);
+        }
+        if (params.tags !== undefined) {
+            sim.prepare("DELETE FROM TMAreaTag WHERE areas = ?").run(uuid);
+            for (const tagUuid of tagUuids(sim, params.tags)) {
+                sim.prepare("INSERT INTO TMAreaTag (areas, tags) VALUES (?, ?)").run(uuid, tagUuid);
+            }
+        }
+    }),
+    "tag.add": op((sim, params) => {
+        let parent = null;
+        if (params.parent !== undefined) {
+            const res = resolveTag(sim, params.parent);
+            if (res.resolved === null)
+                throw new Error("simulator: unresolved parent tag");
+            parent = res.resolved.uuid;
+        }
+        sim
+            .prepare(`INSERT INTO TMTag (uuid, title, shortcut, usedDate, parent, "index") VALUES (?, ?, NULL, NULL, ?, 0)`)
+            .run(genUuid(), params.title, parent);
+    }),
+    "heading.create": op((sim, params, ctx) => {
+        const projUuid = containerUuid(sim, params.project, "project");
+        if (projUuid === null)
+            throw new Error("simulator: heading.create needs a project");
+        insertTask(sim, 2, ctx, { uuid: genUuid(), title: params.title, project: projUuid });
+    }),
+    // Recurrence ops (RSIM1–6). project.create-repeating is delivered by the
+    // runCreateRepeatingProject orchestrator over project.add + project.make-repeating
+    // (both covered here), so it needs no direct applier. pause/resume/stop-repeat
+    // are deliberately OMITTED — no RSIM shape proves their delta, and unsupported
+    // beats guessed.
+    "todo.make-repeating": op((sim, params, ctx) => applyMakeRepeating(sim, 0, params, ctx)),
+    "todo.reschedule-repeat": op((sim, params, ctx) => applyReschedule(sim, params, ctx)),
+    "project.make-repeating": op((sim, params, ctx) => applyMakeRepeating(sim, 1, params, ctx)),
+    "project.reschedule-repeat": op((sim, params, ctx) => applyReschedule(sim, params, ctx)),
+};
+/** The ops this simulator can apply — the ONLY entries in its honest matrix. */
+export const SIMULATOR_COVERAGE = Object.keys(APPLIERS);
+function simulatorMatrix() {
+    const support = {
+        support: "yes",
+        disruption: 0,
+        validation: "validated",
+        notes: "simulated",
+    };
+    const matrix = {};
+    for (const kind of SIMULATOR_COVERAGE)
+        matrix[kind] = { ...support };
+    return matrix;
+}
+// ------------------------------------------------------------- vector
+/**
+ * Build the simulator vector for `dbPath`. Throws at creation if the fence is
+ * not satisfied (so a misconfigured harness fails loud, never silently writing
+ * to a wrong DB). `now` is injectable for tests; production reads the effective
+ * clock from the environment (THINGS_NOW) so applier timestamps align with the
+ * pipeline's, which the create-probe verification depends on.
+ */
+export function createSimulatorVector(dbPath, opts = {}) {
+    const reason = simulatorFenceReason(dbPath);
+    if (reason !== null) {
+        throw new Error(`simulator write vector refused: ${reason}`);
+    }
+    const now = opts.now ?? resolveEnvNow();
+    let sim;
+    return {
+        id: "url-scheme",
+        matrix: simulatorMatrix(),
+        simulates: true,
+        async execute(invocation) {
+            // Defensive re-check: the environment could have changed underneath a
+            // live instance. Refuse rather than write to a now-unfenced DB.
+            const liveReason = simulatorFenceReason(dbPath);
+            if (liveReason !== null) {
+                return { exitCode: 1, stdout: "", stderr: `simulator fence inactive: ${liveReason}` };
+            }
+            const kind = invocation.op;
+            if (kind === undefined) {
+                return {
+                    exitCode: 1,
+                    stdout: "",
+                    stderr: "simulator: invocation carries no structured op",
+                };
+            }
+            const applier = APPLIERS[kind];
+            if (applier === undefined) {
+                return { exitCode: 1, stdout: "", stderr: `simulator: no applier for op ${kind}` };
+            }
+            sim ??= new DatabaseSync(dbPath);
+            const when = now();
+            const ctx = {
+                nowEpoch: Math.floor(when.getTime() / 1000),
+                todayIso: localToday(when),
+            };
+            try {
+                applier(sim, invocation.opParams, ctx);
+            }
+            catch (err) {
+                return {
+                    exitCode: 1,
+                    stdout: "",
+                    stderr: `simulator applier for ${kind} failed: ${err.message}`,
+                };
+            }
+            return { exitCode: 0, stdout: "", stderr: "" };
+        },
+    };
+}
+/** Read the pinned THINGS_NOW instant, if any; else real time per call. */
+function resolveEnvNow() {
+    const raw = process.env["THINGS_NOW"];
+    if (raw !== undefined && raw.trim() !== "") {
+        const ms = new Date(raw).getTime();
+        if (!Number.isNaN(ms))
+            return () => new Date(ms);
+    }
+    return () => new Date();
+}
+//# sourceMappingURL=simulator.js.map