things-api 0.18.0 → 0.19.0

package/dist/write/capabilities.d.ts

@@ -4,11 +4,20 @@
  * and library consumers.
  */
 import { type OperationKind } from "./operations.ts";
+import { type ParamSummary } from "./param-schema.ts";
 import { type ReversibilityEntry } from "./reversibility.ts";
 import { type CertificationEntry } from "./vectors/ui-certification.ts";
 import type { VectorId, VectorSupport } from "./vectors/types.ts";
 export interface CapabilityEntry {
     op: OperationKind;
+    /**
+     * The operation's PARAMETER shapes, from the one schema registry that also
+     * enforces them (param-schema.ts) — so "call capabilities for the parameter
+     * shapes" is answered with data instead of prose. Each entry names the field,
+     * its kind, whether it is optional, a behavioral description of the accepted
+     * shape, and (for an enum) the accepted values.
+     */
+    params: ParamSummary[];
     /** What `things undo` can do with this operation afterward (test-locked per op). */
     undo: ReversibilityEntry;
     vectors: ({

package/dist/write/capabilities.js

@@ -4,6 +4,7 @@
  * and library consumers.
  */
 import { OPERATION_KINDS } from "./operations.js";
+import { paramSummary } from "./param-schema.js";
 import { REVERSIBILITY } from "./reversibility.js";
 import { certificationOf } from "./vectors/ui-certification.js";
 import { defaultVectors } from "./vectors/registry.js";
@@ -14,6 +15,7 @@ export function capabilitiesTable(op) {
         const cert = certificationOf(kind);
         const entry = {
             op: kind,
+            params: paramSummary(kind),
             undo: REVERSIBILITY[kind],
             // oxlint-disable-next-line no-map-spread -- building fresh capability rows, not mutating
             vectors: vectors.map((v) => ({ vector: v.id, ...(v.matrix[kind] ?? { support: "no" }) })),

package/dist/write/capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/write/capabilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAsB,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAA2B,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAiBvD,MAAM,UAAU,iBAAiB,CAAC,EAAkB;IAClD,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,KAAK,GAAoB;YAC7B,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;YACzB,yFAAyF;YACzF,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;SAC1F,CAAC;QACF,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/write/capabilities.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAsB,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAqB,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAA2B,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAyBvD,MAAM,UAAU,iBAAiB,CAAC,EAAkB;IAClD,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,KAAK,GAAoB;YAC7B,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC;YAC1B,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;YACzB,yFAAyF;YACzF,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;SAC1F,CAAC;QACF,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/write/clear-reminder.js

@@ -136,7 +136,7 @@ async function runBounce(deps, uuid, target, options) {
             expected: leg1.kind === "verify-failed" ? leg1.expected : { mode: "update", uuid, assert: [] },
             observed: leg1.kind === "verify-failed" ? leg1.observed : null,
             detail: "bounce leg 1 (when=today) failed — the item was NOT touched; its dated reminder is " +
-                "unchanged. Retry, or clear it via `things setup shortcuts`",
+                "unchanged. Retry, or clear it via `things setup`",
         };
     }
     const leg2 = await runMutation(deps, "todo.update", { uuid, when: originalDate }, legOptions);

package/dist/write/clear-reminder.js.map

@@ -1 +1 @@
-{"version":3,"file":"clear-reminder.js","sourceRoot":"","sources":["../../src/write/clear-reminder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"clear-reminder.js","sourceRoot":"","sources":["../../src/write/clear-reminder.ts"],"names":[],"mappings":"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"}

package/dist/write/commands.d.ts

@@ -7,7 +7,7 @@
 import type { DatabaseSync } from "node:sqlite";
 import { type IsoDate } from "../model/dates.ts";
 import type { HazardId } from "./guards.ts";
-import type { OperationKind, OperationParamsMap } from "./operations.ts";
+import type { ContainerRef, OperationKind, OperationParamsMap } from "./operations.ts";
 import { type PreState } from "./pre-state.ts";
 import { assertRepeatRule } from "./repeat-rule.ts";
 import type { CompiledInvocation, VectorId } from "./vectors/types.ts";
@@ -37,6 +37,17 @@ export interface CommandSpec<K extends OperationKind = OperationKind> {
     expectedDelta(pre: PreState, params: OperationParamsMap[K], ctx: DeltaCtx): DeltaSpec;
     compile(params: OperationParamsMap[K], vector: VectorId, pre: PreState, ctx: CompileCtx): CompiledInvocation;
 }
+/**
+ * Is a destination container SUPPLIED? A PRESENCE check, not a duck-test (#580):
+ * the parameter schema (param-schema.ts) has already proven that a present ref is
+ * a `{uuid}`/`{title}` object, so anything else reaching here is an engine bug,
+ * not caller input — and it THROWS rather than reading as "no destination given",
+ * which is precisely how a bare-string `project` used to compile an Inbox capture
+ * with no placement and no placement assertion, then verify clean.
+ */
+export declare function containerGiven(ref: ContainerRef | undefined | null): boolean;
+/** Belt-and-braces: a present container reference must carry a uuid or a title. */
+export declare function assertContainerRef(ref: ContainerRef): void;
 /**
  * Parse an ISO date (`2025-01-15`) OR datetime (`2025-01-15T09:30[:ss]`) and
  * resolve it to a single UTC instant in the effective `zone`. A date-only value

package/dist/write/commands.js

@@ -1,16 +1,16 @@
-import { decodeReminderTime, encodeReminderTime, localToday, reminderUrlToken, zonedWallInstant, } from "../model/dates.js";
+import { localToday, zonedWallInstant } from "../model/dates.js";
 import { byUuid } from "../read/detail.js";
 import { manualLogDateEpoch, pendingLogCount } from "../read/log-boundary.js";
 import { isLooseRef } from "../read/pseudo-area.js";
-import { reminderIsLive } from "../read/stage.js";
-import { areaMemberCounts, childTagTitles, classifyHeadingConvert, classifyHeadingDissolve, classifyHeadingMoveToProject, classifyProjectRepeat, computeHeadingMovePre, computeReorderPre, emptyPreState, loadTarget, projectChildren, projectStatus, projectSubtreeUuids, resolveArea, resolveHeading, resolveProject, resolveTag, sameTitleTaskUuids, trashedCount, } from "./pre-state.js";
+import { areaMemberCounts, childTagTitles, classifyHeadingConvert, classifyHeadingDissolve, classifyHeadingMoveToProject, classifyProjectRepeat, computeHeadingMovePre, computeReorderPre, emptyPreState, loadTarget, projectChildren, projectStatus, projectSubtreeUuids, resolveArea, resolveHeading, resolveProject, resolveTag, sameTitleTaskUuids, seriesRowUuids, trashedCount, } from "./pre-state.js";
+import { assertNotesModesExclusive, normalizeReminder, updateAssertions, updateWireParams, whenAssertions, whenWithReminder, } from "./update-fields.js";
 import { resolveTagRefs } from "./tag-refs.js";
 import { PRIVATE_REORDER_COMMAND } from "./experimental.js";
 import { assertRepeatRule } from "./repeat-rule.js";
 import { assessOffRuleFirst, deadlineDriveNext, deriveFixedAnchor } from "./repeat-anchor.js";
 import { expectedRuleAssertions } from "./repeat-asserts.js";
 import { escapeAppleScript } from "./vectors/applescript.js";
-import { areaReorderSidebarRecipe, convertToProjectRecipe, dissolveHeadingRecipe, headingConvertToProjectRecipe, moveHeadingToProjectRecipe, makeRepeatingRecipe, pauseRepeatRecipe, projectMakeRepeatingRecipe, projectPauseRepeatRecipe, projectRescheduleRepeatRecipe, projectResumeRepeatRecipe, rescheduleRepeatRecipe, resumeRepeatRecipe, } from "./vectors/ui-recipes.js";
+import { areaReorderSidebarRecipe, convertToProjectRecipe, dissolveHeadingRecipe, headingConvertToProjectRecipe, moveHeadingToProjectRecipe, makeRepeatingRecipe, createNextCopyRecipe, pauseRepeatRecipe, projectMakeRepeatingRecipe, projectPauseRepeatRecipe, projectRescheduleRepeatRecipe, projectResumeRepeatRecipe, rescheduleRepeatRecipe, resumeRepeatRecipe, } from "./vectors/ui-recipes.js";
 import { buildRepeatingFingerprint } from "./verify/delta.js";
 // ------------------------------------------------------------------ helpers
 function thingsUrl(command, params, token) {
@@ -65,65 +65,6 @@ function q(value) {
 function unsupportedVector(op, vector) {
     throw new Error(`${op} cannot be compiled for vector ${vector} (planner bug)`);
 }
-function whenAssertions(when, todayIso, opts = { mode: "add" }) {
-    // Strict shape check: an unvalidated string used to flow straight into the
-    // URL (e.g. "2026-07-20@09:30", the raw URL grammar) — the app would SET
-    // date+reminder while verification asserted the literal string as the date,
-    // reporting a false mismatch on a write that succeeded.
-    if (when !== "today" &&
-        when !== "evening" &&
-        when !== "anytime" &&
-        when !== "someday" &&
-        !/^\d{4}-\d{2}-\d{2}$/.test(when)) {
-        throw new RangeError(when.includes("@")
-            ? `invalid when "${when}" — a reminder time is a separate parameter (reminder: "HH:mm"; CLI --reminder), not an @ suffix`
-            : `invalid when "${when}" — expected today | evening | anytime | someday | YYYY-MM-DD`);
-    }
-    switch (when) {
-        case "today":
-            // Today's non-evening section: in Today (the `today` marker) AND NOT in the
-            // evening sub-bucket (the presence-keyed `evening` marker absent — asserted
-            // as null, which valuesEqual treats as absent). Gated to Today members under
-            // the verify clock exactly as the retired `todaySection` was.
-            //
-            // The `startDate` assertion differs by op (field bug §0½.8):
-            //  - ADD mints a fresh Today item with no schedule history, so the app dates
-            //    it EXACTLY today — exact equality is right.
-            //  - UPDATE of an item ALREADY in Today whose `startDate` has already arrived
-            //    (past or today): the app PRESERVES that historical date rather than
-            //    rewriting the storage byte to today (arrived-date law). Assert the
-            //    arrived-date PREDICATE (non-null and <= today) so a preserved historical
-            //    date verifies, while an undated deadline-only pull (null startDate) is
-            //    still rejected — the item's Today membership then rests only on a
-            //    deadline, not on the requested schedule.
-            return [
-                { field: "start", equals: "active" },
-                opts.mode === "update"
-                    ? { field: "startDate", satisfies: { predicate: "arrived-on-or-before", date: todayIso } }
-                    : { field: "startDate", equals: todayIso },
-                { field: "today", equals: true },
-                { field: "evening", equals: null },
-            ];
-        case "evening":
-            // The This-Evening sub-bucket: the `evening` marker (which implies `today`).
-            return [
-                { field: "start", equals: "active" },
-                { field: "startDate", equals: todayIso },
-                { field: "evening", equals: true },
-            ];
-        case "anytime":
-            return [
-                { field: "start", equals: "active" },
-                { field: "startDate", equals: null },
-            ];
-        case "someday":
-            return [{ field: "start", equals: "someday" }];
-        default:
-            // Concrete date: assert only the date — start-state semantics differ
-            // for past/today/future dates (only the date itself is invariant).
-            return [{ field: "startDate", equals: when }];
-    }
-}
 function sortedTags(tags) {
     return [...tags].toSorted();
 }
@@ -139,21 +80,28 @@ function applyTagRefs(db, pre, tags) {
     pre.missingTags = res.missing;
     pre.resolvedTagTitles = res.titles;
 }
-/** Round-trip normalization: "6:5"-style inputs → canonical "06:05". */
-function normalizeReminder(time) {
-    return decodeReminderTime(encodeReminderTime(time)) ?? time;
-}
 /**
- * The URL `when` value with an optional reminder token appended through the
- * deterministic emitter (never a bare 1–11 hour — oddity 2d).
+ * Is a destination container SUPPLIED? A PRESENCE check, not a duck-test (#580):
+ * the parameter schema (param-schema.ts) has already proven that a present ref is
+ * a `{uuid}`/`{title}` object, so anything else reaching here is an engine bug,
+ * not caller input — and it THROWS rather than reading as "no destination given",
+ * which is precisely how a bare-string `project` used to compile an Inbox capture
+ * with no placement and no placement assertion, then verify clean.
  */
-function whenWithReminder(when, reminder) {
-    if (reminder === undefined || reminder === null)
-        return when;
-    return `${when}@${reminderUrlToken(reminder)}`;
+export function containerGiven(ref) {
+    if (ref === undefined || ref === null)
+        return false;
+    assertContainerRef(ref);
+    return true;
 }
-function containerGiven(ref) {
-    return ref !== undefined && (ref.uuid !== undefined || ref.title !== undefined);
+/** Belt-and-braces: a present container reference must carry a uuid or a title. */
+export function assertContainerRef(ref) {
+    if (typeof ref !== "object" || Array.isArray(ref)) {
+        throw new RangeError(`a container reference must be an object naming a uuid or a title — received ${JSON.stringify(ref)}`);
+    }
+    if (ref.uuid === undefined && ref.title === undefined) {
+        throw new RangeError("a container reference must name a uuid or a title — it names neither");
+    }
 }
 /**
  * The create-probe title for the duplicate / identity-replacement ops, whose
@@ -351,108 +299,35 @@ const todoAdd = {
     },
 };
 /**
- * The effective reminder a when-bearing update should leave behind. A bare
- * `when=` CLEARS an existing reminder (R07/R20), so when the caller
- * re-schedules to today/evening/a date without addressing the reminder we
- * auto-preserve the current one; an explicit null is the intentional clear.
- *
- * §9n: a reminder whose row's `startDate` is already strictly PAST is
- * presentation-dead (the GUI hides its bell; the byte lingers in the DB). We do
- * NOT auto-preserve such a stale byte — carrying it into the re-schedule would
- * RESURRECT a reminder the user believes gone. A LIVE reminder (startDate
- * today/future) is preserved as before. The liveness test is the SAME
- * {@link reminderIsLive} predicate the read side gates on, consulted against the
- * target's CURRENT `startDate` under the response clock.
+ * The to-do / project update pair. Both legs — the URL parameters and the
+ * expected-delta assertions — are DERIVED from the single exhaustive registry in
+ * update-fields.ts (the #491 exhaustive-map doctrine): the only per-verb
+ * difference is the URL command name, so neither verb can accept a field the
+ * other drops, and a field added to `UpdateFields` breaks compilation there
+ * until every leg handles it.
  */
-function effectiveReminder(pre, params) {
-    if (params.reminder !== undefined)
-        return 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;
-    const target = pre.target;
-    if (target === null || target.type === "heading")
-        return null;
-    if (!reminderIsLive(target.startDate, pre.todayIso))
-        return null;
-    // Read the RAW stored byte off the substrate (top-level `reminder` is
-    // live-gated under the LOAD clock, which can differ from `pre.todayIso` under a
-    // pinned THINGS_NOW). The `reminderIsLive` guard above applies liveness under
-    // the injected clock explicitly, so the raw byte + this gate reproduce the
-    // former semantics exactly.
-    return target.derived.reminder;
-}
-function assertNotesModesExclusive(params) {
-    if (params.notes !== undefined &&
-        (params.appendNotes !== undefined || params.prependNotes !== undefined)) {
-        throw new RangeError("notes (replace) is exclusive with appendNotes/prependNotes");
-    }
-    if (params.appendNotes !== undefined && params.prependNotes !== undefined) {
-        throw new RangeError("appendNotes and prependNotes cannot be combined in one update");
-    }
-}
-function expectedNotes(pre, params) {
-    const current = pre.target !== null && pre.target.type !== "heading" ? pre.target.notes : "";
-    // Separator semantics probed: newline-joined, no stray newline against an
-    // empty note (E04/E05/E11/E12).
-    if (params.appendNotes !== undefined) {
-        return current === "" ? params.appendNotes : `${current}\n${params.appendNotes}`;
-    }
-    if (params.prependNotes !== undefined) {
-        return current === "" ? params.prependNotes : `${params.prependNotes}\n${current}`;
-    }
-    return undefined;
+function updateSpec(op, urlCommand) {
+    return {
+        op,
+        hazards: ["H-UNKNOWN-DESTINATION", "H-REPEAT-SCHEDULE", "H-REMINDER-SCOPE"],
+        preRead(db, params, now) {
+            assertNotesModesExclusive(params);
+            const pre = emptyPreState();
+            pre.todayIso = localToday(now);
+            pre.target = loadTarget(db, params.uuid);
+            return pre;
+        },
+        expectedDelta(pre, params, ctx) {
+            return { mode: "update", uuid: params.uuid, assert: updateAssertions(params, pre, ctx) };
+        },
+        compile(params, vector, pre, ctx) {
+            if (vector !== "url-scheme")
+                unsupportedVector(op, vector);
+            return thingsUrl(urlCommand, { id: params.uuid, ...updateWireParams(params, pre) }, ctx.token);
+        },
+    };
 }
-const todoUpdate = {
-    op: "todo.update",
-    hazards: ["H-UNKNOWN-DESTINATION", "H-REPEAT-SCHEDULE", "H-REMINDER-SCOPE"],
-    preRead(db, params, now) {
-        assertNotesModesExclusive(params);
-        const pre = emptyPreState();
-        pre.todayIso = localToday(now);
-        pre.target = loadTarget(db, params.uuid);
-        return pre;
-    },
-    expectedDelta(pre, params, ctx) {
-        const assert = [];
-        if (params.title !== undefined)
-            assert.push({ field: "title", equals: params.title });
-        if (params.notes !== undefined)
-            assert.push({ field: "notes", equals: params.notes });
-        const joined = expectedNotes(pre, params);
-        if (joined !== undefined)
-            assert.push({ field: "notes", equals: joined });
-        if (params.when !== undefined) {
-            assert.push(...whenAssertions(params.when, ctx.todayIso, { mode: "update" }));
-            const reminder = effectiveReminder(pre, params);
-            assert.push({
-                field: "reminder",
-                equals: reminder === null ? null : normalizeReminder(reminder),
-            });
-        }
-        if (params.deadline !== undefined)
-            assert.push({ field: "deadline", equals: params.deadline });
-        return { mode: "update", uuid: params.uuid, assert };
-    },
-    compile(params, vector, pre, ctx) {
-        if (vector !== "url-scheme")
-            unsupportedVector(this.op, vector);
-        return thingsUrl("update", {
-            id: params.uuid,
-            title: params.title,
-            notes: params.notes,
-            "append-notes": params.appendNotes,
-            "prepend-notes": params.prependNotes,
-            when: params.when === undefined
-                ? undefined
-                : whenWithReminder(params.when, effectiveReminder(pre, params)),
-            deadline: params.deadline === null ? "" : params.deadline,
-        }, ctx.token);
-    },
-};
+const todoUpdate = updateSpec("todo.update", "update");
 function statusSpec(op, urlParam, asStatus, scriptStatus) {
     return {
         op,
@@ -826,6 +701,14 @@ const projectAdd = {
         const area = pre.destArea?.resolved;
         if (area !== undefined && area !== null)
             assert.push({ field: "area.uuid", equals: area.uuid });
+        // KNOWN SHALLOW SPOT (audited 2026-08-23, exhaustive-map sweep): the seeded
+        // children — `todos` and the structured `items` (headings + rich children) —
+        // contribute NO assertion, so a project born with an empty body still
+        // verifies `ok`. Unlike a to-do's `checklistItems` (asserted through
+        // `checklistTitles`) there is no child-list field on the delta vocabulary to
+        // compare against, and adding one needs probe evidence that the imported
+        // children are readable inside the verify window before a missing child may
+        // be called a failure. Tracked in docs/up-next.md; do NOT "fix" it blind.
         return {
             mode: "create",
             probe: {
@@ -873,55 +756,9 @@ const projectAdd = {
         }, ctx.token);
     },
 };
-const projectUpdate = {
-    op: "project.update",
-    hazards: ["H-UNKNOWN-DESTINATION", "H-REPEAT-SCHEDULE", "H-REMINDER-SCOPE"],
-    preRead(db, params, now) {
-        assertNotesModesExclusive(params);
-        const pre = emptyPreState();
-        pre.todayIso = localToday(now);
-        pre.target = loadTarget(db, params.uuid);
-        return pre;
-    },
-    expectedDelta(pre, params, ctx) {
-        const assert = [];
-        if (params.title !== undefined)
-            assert.push({ field: "title", equals: params.title });
-        if (params.notes !== undefined)
-            assert.push({ field: "notes", equals: params.notes });
-        const joined = expectedNotes(pre, params);
-        if (joined !== undefined)
-            assert.push({ field: "notes", equals: joined });
-        if (params.when !== undefined) {
-            assert.push(...whenAssertions(params.when, ctx.todayIso, { mode: "update" }));
-            // Projects carry the same reminderTime codec as to-dos (A3); a bare
-            // when= clears an existing reminder unless auto-preserved.
-            const reminder = effectiveReminder(pre, params);
-            assert.push({
-                field: "reminder",
-                equals: reminder === null ? null : normalizeReminder(reminder),
-            });
-        }
-        if (params.deadline !== undefined)
-            assert.push({ field: "deadline", equals: params.deadline });
-        return { mode: "update", uuid: params.uuid, assert };
-    },
-    compile(params, vector, pre, ctx) {
-        if (vector !== "url-scheme")
-            unsupportedVector(this.op, vector);
-        return thingsUrl("update-project", {
-            id: params.uuid,
-            title: params.title,
-            notes: params.notes,
-            "append-notes": params.appendNotes,
-            "prepend-notes": params.prependNotes,
-            when: params.when === undefined
-                ? undefined
-                : whenWithReminder(params.when, effectiveReminder(pre, params)),
-            deadline: params.deadline === null ? "" : params.deadline,
-        }, ctx.token);
-    },
-};
+// Projects carry the same reminderTime codec and notes/schedule semantics as
+// to-dos (A3/E18) — same registry, same legs, only the URL command differs.
+const projectUpdate = updateSpec("project.update", "update-project");
 const projectSetTags = {
     op: "project.set-tags",
     hazards: ["H-UNKNOWN-DESTINATION", "H-UNKNOWN-TAG"],
@@ -2072,6 +1909,56 @@ const todoPauseRepeat = {
         return uiDrive(pauseRepeatRecipe(params.uuid));
     },
 };
+/**
+ * `Items ▸ Repeat ▸ Create Next Copy` (CNC1) — materialize the pending
+ * occurrence and advance the series. The INTERNAL first leg of the
+ * template-mutation composites (template-mutation.ts); it is not a user-facing
+ * verb, because a bare "spawn one now" has no use we have been asked for and
+ * every honest use of it mutates the row it mints.
+ *
+ * Verified as a CREATE: the minted row wears the template's own title, is a
+ * to-do, carries a fresh (gesture wall-clock) creationDate, and is not one of
+ * the rows the series already had — which is exactly the create-probe's
+ * gauntlet, and it hands the composite back the minted uuid it needs. The one
+ * field assertion is the FK: the discovered row must be an instance of THIS
+ * template, so a same-titled row created by anything else in the window cannot
+ * pass. The cursor advance is deliberately NOT asserted here — a create delta
+ * asserts against the created row, and the composite re-reads the template
+ * afterwards anyway to disclose when the next occurrence lands.
+ */
+const todoCreateNextCopy = {
+    op: "todo.create-next-copy",
+    hazards: UI_HAZARDS,
+    preRead(db, params) {
+        const pre = emptyPreState();
+        pre.target = loadTarget(db, params.uuid);
+        // The series' existing rows — the template plus every instance it has
+        // already spawned, all of which share its title. They are the create
+        // probe's exclusion set, so "the new row" is unambiguous even on a series
+        // whose occurrences all look alike.
+        pre.sameTitleUuids = seriesRowUuids(db, params.uuid);
+        return pre;
+    },
+    expectedDelta(pre, params, ctx) {
+        const target = pre.target;
+        const title = target !== null && target.type !== "heading" ? target.title : "";
+        return {
+            mode: "create",
+            probe: {
+                title,
+                type: "to-do",
+                sinceEpoch: ctx.nowEpoch - 2,
+                excludeUuids: pre.sameTitleUuids,
+            },
+            assert: [{ field: "repeating.templateUuid", equals: params.uuid }],
+        };
+    },
+    compile(params, vector) {
+        if (vector !== "ui")
+            unsupportedVector(this.op, vector);
+        return uiDrive(createNextCopyRecipe(params.uuid));
+    },
+};
 const todoResumeRepeat = {
     op: "todo.resume-repeat",
     hazards: UI_HAZARDS,
@@ -2612,6 +2499,7 @@ export const COMMANDS = {
     "todo.make-repeating": todoMakeRepeating,
     "todo.reschedule-repeat": todoRescheduleRepeat,
     "todo.pause-repeat": todoPauseRepeat,
+    "todo.create-next-copy": todoCreateNextCopy,
     "todo.resume-repeat": todoResumeRepeat,
     "todo.convert-to-project": todoConvertToProject,
     "project.reschedule-repeat": projectRescheduleRepeat,