@rubytech/create-maxy-code 0.1.552 → 0.1.554

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-maxy-code",
-  "version": "0.1.552",
+  "version": "0.1.554",
   "description": "Install Maxy — AI for Productive People",
   "bin": {
     "create-maxy-code": "./dist/index.js"

package/payload/platform/lib/routine-templates/dist/index.d.ts

@@ -136,8 +136,21 @@ export declare function resolveOwnerTimezone(session: SeedSessionLike, accountId
  *  destroy the operator's own caption on the next version bump; and the
  *  scheduling plugin's one-shot `converge-routine-description` has already given
  *  every pre-existing row a description, so no row is left holding only a
- *  title. */
-export declare const MERGE_CYPHER = "\nUNWIND $rows AS row\nOPTIONAL MATCH (pre:Event {accountId: $accountId, routineTemplate: row.key})\nWITH row,\n     pre IS NOT NULL AS existed,\n     coalesce(pre.routineTemplateVersion, 0) AS priorVersion,\n     pre.operatorEdited IS NOT NULL AS edited\nWITH row, existed, priorVersion, edited,\n     (existed AND NOT edited AND priorVersion < $version) AS refreshing\nMERGE (e:Event {accountId: $accountId, routineTemplate: row.key})\n  ON CREATE SET e.eventId = randomUUID(),\n                e.name = row.name,\n                e.description = row.description,\n                e.agentPrompt = row.prompt,\n                e.recurrence = row.recurrence,\n                e.routineTemplateVersion = $version,\n                e.eventStatus = 'suspended',\n                e.nextRun = null,\n                e.agentChannel = null,\n                e.agentDestination = null,\n                e.actionPlugin = null,\n                e.actionTool = null,\n                e.actionArgs = null,\n                e.sourcePlugin = null,\n                e.timezone = $timezone,\n                e.createdBySource = 'installer',\n                e.createdByAgent = 'system',\n                e.createdByTool = 'routine-roster-seed',\n                e.createdAt = $now,\n                e.updatedAt = $now\n  ON MATCH SET e.agentPrompt = CASE WHEN refreshing THEN row.prompt ELSE e.agentPrompt END,\n               e.name = CASE WHEN refreshing THEN row.name ELSE e.name END,\n               e.description = CASE WHEN refreshing THEN row.description ELSE e.description END,\n               e.routineTemplateVersion = CASE WHEN refreshing THEN $version ELSE e.routineTemplateVersion END,\n               e.updatedAt = CASE WHEN refreshing THEN $now ELSE e.updatedAt END\nRETURN row.key AS key,\n       e.eventId AS eventId,\n       CASE WHEN NOT existed THEN 'create'\n            WHEN priorVersion >= $version THEN 'unchanged'\n            WHEN edited THEN 'skip-operator-edited'\n            ELSE 'refresh-version' END AS action";
+ *  title.
+ *
+ *  The gate (Task 2379) is written by a `SET` after the MERGE rather than inside
+ *  either branch, because both branches need `e.eventId` and only one of them
+ *  has just minted it. `writing` is the same condition the prompt follows, so a
+ *  gate is written on create, refreshed on a version bump of an unedited row,
+ *  and never touched on an operator-edited one.
+ *
+ *  Two details are load-bearing. The null branch is symmetric on purpose: a
+ *  template reclassified gateless must have its three properties cleared, or the
+ *  row keeps a gate its template no longer declares and nothing reports it. And
+ *  the commit token is substituted from the same `row.gateChecks` the gate is
+ *  built from, so the precondition and the turn's own commit call cannot
+ *  disagree about what this routine checks. */
+export declare const MERGE_CYPHER = "\nUNWIND $rows AS row\nOPTIONAL MATCH (pre:Event {accountId: $accountId, routineTemplate: row.key})\nWITH row,\n     pre IS NOT NULL AS existed,\n     coalesce(pre.routineTemplateVersion, 0) AS priorVersion,\n     pre.operatorEdited IS NOT NULL AS edited\nWITH row, existed, priorVersion, edited,\n     (existed AND NOT edited AND priorVersion < $version) AS refreshing\nMERGE (e:Event {accountId: $accountId, routineTemplate: row.key})\n  ON CREATE SET e.eventId = randomUUID(),\n                e.name = row.name,\n                e.description = row.description,\n                e.agentPrompt = row.prompt,\n                e.recurrence = row.recurrence,\n                e.routineTemplateVersion = $version,\n                e.eventStatus = 'suspended',\n                e.nextRun = null,\n                e.agentChannel = null,\n                e.agentDestination = null,\n                e.actionPlugin = null,\n                e.actionTool = null,\n                e.actionArgs = null,\n                e.sourcePlugin = null,\n                e.timezone = $timezone,\n                e.createdBySource = 'installer',\n                e.createdByAgent = 'system',\n                e.createdByTool = 'routine-roster-seed',\n                e.createdAt = $now,\n                e.updatedAt = $now\n  ON MATCH SET e.agentPrompt = CASE WHEN refreshing THEN row.prompt ELSE e.agentPrompt END,\n               e.name = CASE WHEN refreshing THEN row.name ELSE e.name END,\n               e.description = CASE WHEN refreshing THEN row.description ELSE e.description END,\n               e.routineTemplateVersion = CASE WHEN refreshing THEN $version ELSE e.routineTemplateVersion END,\n               e.updatedAt = CASE WHEN refreshing THEN $now ELSE e.updatedAt END\nWITH row, e, existed, priorVersion, edited, (NOT existed OR refreshing) AS writing\nSET e.gatePlugin = CASE WHEN writing THEN (CASE WHEN row.gateChecks IS NULL THEN null ELSE 'scheduling' END) ELSE e.gatePlugin END,\n    e.gateTool = CASE WHEN writing THEN (CASE WHEN row.gateChecks IS NULL THEN null ELSE 'scheduling-gate' END) ELSE e.gateTool END,\n    e.gateArgs = CASE WHEN writing THEN (CASE WHEN row.gateChecks IS NULL THEN null ELSE '{\"eventId\":\"' + e.eventId + '\",\"checks\":' + row.gateChecks + '}' END) ELSE e.gateArgs END,\n    e.agentPrompt = CASE WHEN writing AND row.gateChecks IS NOT NULL\n                         THEN replace(e.agentPrompt, '<<gateCommit>>', '{\"eventId\":\"' + e.eventId + '\",\"checks\":' + row.gateChecks + ',\"commit\":true}')\n                         ELSE e.agentPrompt END\nRETURN row.key AS key,\n       e.eventId AS eventId,\n       CASE WHEN NOT existed THEN 'create'\n            WHEN priorVersion >= $version THEN 'unchanged'\n            WHEN edited THEN 'skip-operator-edited'\n            ELSE 'refresh-version' END AS action";
 /** The post-condition read. Counts every roster row the account actually holds,
  *  independently of what the MERGE above believes it wrote. */
 export declare const VERIFY_CYPHER = "\nMATCH (e:Event {accountId: $accountId})\nWHERE e.routineTemplate IS NOT NULL\nRETURN count(e) AS actual,\n       sum(CASE WHEN e.eventStatus = 'suspended' THEN 1 ELSE 0 END) AS suspended,\n       sum(CASE WHEN e.nextRun IS NULL THEN 1 ELSE 0 END) AS nextRunNull,\n       sum(CASE WHEN e.description IS NULL THEN 1 ELSE 0 END) AS descNull";

package/payload/platform/lib/routine-templates/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAA4C,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5F,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;2EAG2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAClH;AAED;;;;;;;4EAO4E;AAC5E,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,iBAAiB,GAAG,sBAAsB,GAAG,WAAW,CAAC;AAErG,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED;;;;;;0EAM0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;kEAO8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,eAAe,GAAG,QAAQ,CAAC;IAC3C,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAYD;4DAC4D;AAC5D,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,QAAQ,CAAA;CAAE,CAAC,CAa1E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;aAyBa;AACb,eAAO,MAAM,YAAY,8+DAwCwB,CAAC;AAElD;+DAC+D;AAC/D,eAAO,MAAM,aAAa,wVAMgD,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B;sEACkE;IAClE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgF/F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAA4C,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5F,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;2EAG2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAClH;AAED;;;;;;;4EAO4E;AAC5E,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,iBAAiB,GAAG,sBAAsB,GAAG,WAAW,CAAC;AAErG,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED;;;;;;0EAM0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;kEAO8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,eAAe,GAAG,QAAQ,CAAC;IAC3C,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAYD;4DAC4D;AAC5D,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,QAAQ,CAAA;CAAE,CAAC,CAa1E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CAsC+C;AAC/C,eAAO,MAAM,YAAY,iyFA+CwB,CAAC;AAElD;+DAC+D;AAC/D,eAAO,MAAM,aAAa,wVAMgD,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B;sEACkE;IAClE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoF/F"}

package/payload/platform/lib/routine-templates/dist/index.js

@@ -103,7 +103,20 @@ async function resolveOwnerTimezone(session, accountId) {
  *  destroy the operator's own caption on the next version bump; and the
  *  scheduling plugin's one-shot `converge-routine-description` has already given
  *  every pre-existing row a description, so no row is left holding only a
- *  title. */
+ *  title.
+ *
+ *  The gate (Task 2379) is written by a `SET` after the MERGE rather than inside
+ *  either branch, because both branches need `e.eventId` and only one of them
+ *  has just minted it. `writing` is the same condition the prompt follows, so a
+ *  gate is written on create, refreshed on a version bump of an unedited row,
+ *  and never touched on an operator-edited one.
+ *
+ *  Two details are load-bearing. The null branch is symmetric on purpose: a
+ *  template reclassified gateless must have its three properties cleared, or the
+ *  row keeps a gate its template no longer declares and nothing reports it. And
+ *  the commit token is substituted from the same `row.gateChecks` the gate is
+ *  built from, so the precondition and the turn's own commit call cannot
+ *  disagree about what this routine checks. */
 exports.MERGE_CYPHER = `
 UNWIND $rows AS row
 OPTIONAL MATCH (pre:Event {accountId: $accountId, routineTemplate: row.key})
@@ -139,6 +152,13 @@ MERGE (e:Event {accountId: $accountId, routineTemplate: row.key})
                e.description = CASE WHEN refreshing THEN row.description ELSE e.description END,
                e.routineTemplateVersion = CASE WHEN refreshing THEN $version ELSE e.routineTemplateVersion END,
                e.updatedAt = CASE WHEN refreshing THEN $now ELSE e.updatedAt END
+WITH row, e, existed, priorVersion, edited, (NOT existed OR refreshing) AS writing
+SET e.gatePlugin = CASE WHEN writing THEN (CASE WHEN row.gateChecks IS NULL THEN null ELSE 'scheduling' END) ELSE e.gatePlugin END,
+    e.gateTool = CASE WHEN writing THEN (CASE WHEN row.gateChecks IS NULL THEN null ELSE 'scheduling-gate' END) ELSE e.gateTool END,
+    e.gateArgs = CASE WHEN writing THEN (CASE WHEN row.gateChecks IS NULL THEN null ELSE '{"eventId":"' + e.eventId + '","checks":' + row.gateChecks + '}' END) ELSE e.gateArgs END,
+    e.agentPrompt = CASE WHEN writing AND row.gateChecks IS NOT NULL
+                         THEN replace(e.agentPrompt, '<<gateCommit>>', '{"eventId":"' + e.eventId + '","checks":' + row.gateChecks + ',"commit":true}')
+                         ELSE e.agentPrompt END
 RETURN row.key AS key,
        e.eventId AS eventId,
        CASE WHEN NOT existed THEN 'create'
@@ -185,6 +205,10 @@ async function seedRoutineRoster(args) {
             description: r.description,
             prompt: r.prompt,
             recurrence: r.recurrence,
+            // Task 2379 — the only place the checks are serialised. Null for a
+            // gateless template, which the MERGE reads as "clear the three gate
+            // properties on the write path".
+            gateChecks: r.gate ? JSON.stringify(r.gate.checks) : null,
         })),
     });
     const merges = mergeRes.records.map((rec) => ({

package/payload/platform/lib/routine-templates/dist/index.js.map

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

package/payload/platform/lib/routine-templates/dist/roster.d.ts

@@ -34,7 +34,62 @@
  *  routine's prompt only when the stored `routineTemplateVersion` is BELOW this
  *  and no operator has edited the row, so an unbumped edit ships to new installs
  *  and never reaches existing ones — bump it in the same commit as the edit. */
-export declare const ROUTINE_TEMPLATE_VERSION = 2;
+export declare const ROUTINE_TEMPLATE_VERSION = 3;
+/**
+ * Task 2379 — the check shapes a shipped template may name.
+ *
+ * Declared here rather than imported from the scheduling plugin:
+ * `routine-templates` is a `platform/lib` package and importing from
+ * `platform/plugins` would invert the dependency direction and break the lib
+ * build, which has no plugin on its path. The roster test reads the tool's own
+ * source and asserts every type used here is one the tool declares, which is the
+ * same drift control this file already applies to tool names.
+ */
+export interface RoutineMailCheck {
+    readonly type: "mail";
+    readonly mailbox: string;
+    readonly folder?: string;
+    readonly subjectPrefixes?: readonly string[];
+}
+export interface RoutineD1Check {
+    readonly type: "d1";
+    readonly database: string;
+    readonly sql: string;
+}
+export interface RoutineWhatsappCheck {
+    readonly type: "whatsapp";
+    readonly scope: "inbound" | "status";
+}
+export interface RoutineCalendarCheck {
+    readonly type: "calendar";
+    readonly connector: string;
+}
+export type RoutineGateCheck = RoutineMailCheck | RoutineD1Check | RoutineWhatsappCheck | RoutineCalendarCheck;
+/** The plugin and the tool are constants for every roster gate, so a template
+ *  carries neither. `hasWork` is true when ANY check is true. */
+export interface RoutineGate {
+    readonly checks: readonly RoutineGateCheck[];
+}
+/** Substituted by the seed with the full `scheduling-gate` argument object,
+ *  including the row's own event id.
+ *
+ *  A template cannot write that id: it is minted by the MERGE. Nor can the turn
+ *  supply it, because the only place a scheduled turn sees its own event is the
+ *  provenance preamble, which carries the first eight characters. The watermark
+ *  file is named from the whole id, so a turn committing against the prefix
+ *  would write a file the next gate never reads and the routine would report
+ *  work for ever. */
+export declare const GATE_COMMIT_TOKEN = "<<gateCommit>>";
+/** True when the check compares against a stored position rather than reading a
+ *  current one.
+ *
+ *  A watermarked check reads its stored value or zero, so with no watermark file
+ *  it reports work on every fire until something commits: such a gate is inert
+ *  until its routine's prompt carries the commit line. Mirrors `probe`'s `mark`
+ *  field in the scheduling plugin's `tools/scheduling-gate.ts`, which is a
+ *  function for exactly these three and null for the other two. */
+export declare function isWatermarkedCheck(check: RoutineGateCheck): boolean;
+export declare function gateNeedsCommit(gate: RoutineGate): boolean;
 export interface RoutineTemplate {
     /** Stable identity. Half of the MERGE key `(accountId, routineTemplate)`, so
      *  it is never renamed: a renamed key seeds a duplicate row and orphans the
@@ -52,7 +107,27 @@ export interface RoutineTemplate {
     readonly recurrence: string;
     /** The injected turn. Refreshed on a version bump when the row is unedited. */
     readonly prompt: string;
+    /** Task 2379 — the precondition, present when this routine's work is
+     *  conditional AND the check vocabulary can express its source without
+     *  per-account data. Seeded onto `gatePlugin`/`gateTool`/`gateArgs` under the
+     *  same rule the prompt follows: written on create, refreshed only on a
+     *  version bump of an unedited row. */
+    readonly gate?: RoutineGate;
+    /** Why this template ships with no gate. Exactly one of `gate` and `gateless`
+     *  is present on every template, and the roster test fails one carrying
+     *  neither, so a template added later cannot skip the decision. A field rather
+     *  than a comment because a comment cannot be asserted. */
+    readonly gateless?: string;
 }
+/** A template is classified when it carries exactly one of `gate` and a
+ *  non-empty `gateless`.
+ *
+ *  The rule lives here, in one function, rather than inline in the assertion
+ *  that walks the roster. A predicate the test only ever feeds passing input
+ *  reports clean while checking nothing, so the roster test asserts this both
+ *  ways: true for all thirteen, and false for a template carrying neither, both
+ *  and an empty reason. */
+export declare function isClassified(template: RoutineTemplate): boolean;
 /** The thirteen. Order is the display order on `/routines` before the operator
  *  retimes anything: the daily rhythm first, then the reconciles, then the
  *  weekly, then the standing check, then the two health reports.

package/payload/platform/lib/routine-templates/dist/roster.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roster.d.ts","sourceRoot":"","sources":["../src/roster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;gFAGgF;AAChF,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B;;mEAE+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;6EAGyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;wEACoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAgKD;;;;;;;;iFAQiF;AACjF,eAAO,MAAM,cAAc,EAAE,SAAS,eAAe,EAyGpD,CAAC;AAEF;;6DAE6D;AAC7D,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAAqC,CAAC"}
+{"version":3,"file":"roster.d.ts","sourceRoot":"","sources":["../src/roster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;gFAGgF;AAChF,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AACD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;CACtC;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AACD,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,cAAc,GACd,oBAAoB,GACpB,oBAAoB,CAAC;AAEzB;iEACiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C;AAED;;;;;;;;qBAQqB;AACrB,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAElD;;;;;;;mEAOmE;AACnE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAGnE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAE1D;AAED,MAAM,WAAW,eAAe;IAC9B;;mEAE+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;6EAGyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;wEACoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;2CAIuC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B;;;+DAG2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;2BAO2B;AAC3B,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAI/D;AAkKD;;;;;;;;iFAQiF;AACjF,eAAO,MAAM,cAAc,EAAE,SAAS,eAAe,EAsHpD,CAAC;AAEF;;6DAE6D;AAC7D,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAAqC,CAAC"}

package/payload/platform/lib/routine-templates/dist/roster.js

@@ -32,12 +32,54 @@
  * shipping a prompt that reaches for a tool no install serves.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ROUTINE_ROSTER_KEYS = exports.ROUTINE_ROSTER = exports.ROUTINE_TEMPLATE_VERSION = void 0;
+exports.ROUTINE_ROSTER_KEYS = exports.ROUTINE_ROSTER = exports.GATE_COMMIT_TOKEN = exports.ROUTINE_TEMPLATE_VERSION = void 0;
+exports.isWatermarkedCheck = isWatermarkedCheck;
+exports.gateNeedsCommit = gateNeedsCommit;
+exports.isClassified = isClassified;
 /** Bumped whenever any prompt in the roster changes. The seed refreshes a
  *  routine's prompt only when the stored `routineTemplateVersion` is BELOW this
  *  and no operator has edited the row, so an unbumped edit ships to new installs
  *  and never reaches existing ones — bump it in the same commit as the edit. */
-exports.ROUTINE_TEMPLATE_VERSION = 2;
+exports.ROUTINE_TEMPLATE_VERSION = 3;
+/** Substituted by the seed with the full `scheduling-gate` argument object,
+ *  including the row's own event id.
+ *
+ *  A template cannot write that id: it is minted by the MERGE. Nor can the turn
+ *  supply it, because the only place a scheduled turn sees its own event is the
+ *  provenance preamble, which carries the first eight characters. The watermark
+ *  file is named from the whole id, so a turn committing against the prefix
+ *  would write a file the next gate never reads and the routine would report
+ *  work for ever. */
+exports.GATE_COMMIT_TOKEN = "<<gateCommit>>";
+/** True when the check compares against a stored position rather than reading a
+ *  current one.
+ *
+ *  A watermarked check reads its stored value or zero, so with no watermark file
+ *  it reports work on every fire until something commits: such a gate is inert
+ *  until its routine's prompt carries the commit line. Mirrors `probe`'s `mark`
+ *  field in the scheduling plugin's `tools/scheduling-gate.ts`, which is a
+ *  function for exactly these three and null for the other two. */
+function isWatermarkedCheck(check) {
+    if (check.type === "whatsapp")
+        return check.scope === "inbound";
+    return check.type === "mail" || check.type === "calendar";
+}
+function gateNeedsCommit(gate) {
+    return gate.checks.some(isWatermarkedCheck);
+}
+/** A template is classified when it carries exactly one of `gate` and a
+ *  non-empty `gateless`.
+ *
+ *  The rule lives here, in one function, rather than inline in the assertion
+ *  that walks the roster. A predicate the test only ever feeds passing input
+ *  reports clean while checking nothing, so the roster test asserts this both
+ *  ways: true for all thirteen, and false for a template carrying neither, both
+ *  and an empty reason. */
+function isClassified(template) {
+    const gated = template.gate != null;
+    const declaredGateless = typeof template.gateless === "string" && template.gateless.trim() !== "";
+    return gated !== declaredGateless;
+}
 const START_OF_DAY = `Prepare the operator's morning briefing and reply with it as a single message.
 
 Call capabilities-here first and work only with the plugins it reports as enabled. Nothing below is mandatory: each part is included when its surface is present and skipped in silence when it is not.
@@ -105,7 +147,9 @@ An appointment on the provider calendar with no counterpart in the graph is invi
 
 If the account has a busy-time sync configured, run schedule-connector-busy-sync so availability reflects what was just reconciled.
 
-Reply only when something was actually changed, naming what and why. A clean reconcile ends the turn without replying, every time. This routine runs often, so a message on every clean run trains the operator to ignore it.`;
+Reply only when something was actually changed, naming what and why. A clean reconcile ends the turn without replying, every time. This routine runs often, so a message on every clean run trains the operator to ignore it.
+
+When the run has finished and nothing failed, call scheduling-gate with <<gateCommit>> so the next run does not re-examine what you have just reconciled. Do not call it after a run that failed or that you stopped early: the work would be marked as handled without anyone having seen it.`;
 const CONTACT_RECONCILE = `Reconcile the people the business actually deals with against the people it has recorded.
 
 Call capabilities-here first. If neither a mail plugin nor the contacts plugin is enabled, end the turn without replying.
@@ -199,6 +243,7 @@ exports.ROUTINE_ROSTER = [
         description: "Sends one morning message covering what needs a decision, what is time-bound and what changed overnight; stays silent when there is nothing worth saying.",
         recurrence: "30 7 * * 1-5",
         prompt: START_OF_DAY,
+        gateless: "A morning briefing is judgement every fire, so a gate would either always pass or suppress the briefing.",
     },
     {
         key: "inbound-check",
@@ -206,6 +251,7 @@ exports.ROUTINE_ROSTER = [
         description: "Triages mail that arrived since the last check and writes replies for you to approve; it never sends anything itself.",
         recurrence: "*/30 9-17 * * 1-5",
         prompt: INBOUND_CHECK,
+        gateless: "Conditional on new mail, but the mail check matches an exact mailbox address and no shipped template can name one (Task 2389).",
     },
     {
         key: "end-of-day",
@@ -213,6 +259,7 @@ exports.ROUTINE_ROSTER = [
         description: "Closes the day with your unsent drafts, overdue work and tomorrow's diary; says nothing when all three are empty.",
         recurrence: "0 18 * * 1-5",
         prompt: END_OF_DAY,
+        gateless: "A wrap-up is judgement every fire, so no cheap check stands in for reading the three surfaces it reports.",
     },
     {
         key: "appointment-reminder",
@@ -220,6 +267,7 @@ exports.ROUTINE_ROSTER = [
         description: "Reminds each attendee once before a booked appointment, on a route they already use; it never opens a conversation with a stranger.",
         recurrence: "0 * * * *",
         prompt: APPOINTMENT_REMINDER,
+        gateless: "Conditional on an appointment falling in the window, but no check type reads appointments held in the graph (Task 2389).",
     },
     {
         key: "commitment-chase",
@@ -227,6 +275,7 @@ exports.ROUTINE_ROSTER = [
         description: "Surfaces promises the business made and did not keep, and promises made to it that nobody kept; it reports them rather than chasing them.",
         recurrence: "0 10 * * 2",
         prompt: COMMITMENT_CHASE,
+        gateless: "Whether a promise has been dropped is the judgement itself, so no check can answer it more cheaply.",
     },
     {
         key: "calendar-reconcile",
@@ -234,6 +283,7 @@ exports.ROUTINE_ROSTER = [
         description: "Reconciles the provider calendar against the appointments held in the graph, writing what is missing and marking what was cancelled; a clean run says nothing.",
         recurrence: "*/15 * * * *",
         prompt: CALENDAR_RECONCILE,
+        gate: { checks: [{ type: "calendar", connector: "account" }] },
     },
     {
         key: "contact-reconcile",
@@ -241,6 +291,7 @@ exports.ROUTINE_ROSTER = [
         description: "Reconciles the people you correspond with against the people on record, creating and updating contacts; it never merges two records that might be two people.",
         recurrence: "45 6 * * 1-5",
         prompt: CONTACT_RECONCILE,
+        gateless: "Conditional on new correspondence, but no check type reads correspondence (Task 2389).",
     },
     {
         key: "crm-reconcile",
@@ -248,6 +299,7 @@ exports.ROUTINE_ROSTER = [
         description: "Brings across what changed in whichever operational system this business runs; it reads only and never writes back to that system.",
         recurrence: "0 3 * * *",
         prompt: CRM_RECONCILE,
+        gateless: "Conditional on connector movement, but no check type reads a connector queue (Task 2389).",
     },
     {
         key: "finance-reconcile",
@@ -255,6 +307,7 @@ exports.ROUTINE_ROSTER = [
         description: "Reconciles the accounting system against the internal ledger and reports what does not agree; it never adjusts an entry to make the two sides match.",
         recurrence: "0 4 * * 1",
         prompt: FINANCE_RECONCILE,
+        gateless: "Conditional on accounting movement, but no check type reads an accounting ledger (Task 2389).",
     },
     {
         key: "weekly-digest",
@@ -262,6 +315,7 @@ exports.ROUTINE_ROSTER = [
         description: "Writes the week in three paragraphs at most: what changed, what is stuck, and what next week turns on.",
         recurrence: "0 16 * * 5",
         prompt: WEEKLY_DIGEST,
+        gateless: "A digest is judgement every fire, and a gate would suppress the report it exists to send.",
     },
     {
         key: "channel-link-check",
@@ -269,6 +323,7 @@ exports.ROUTINE_ROSTER = [
         description: "Reports a messaging link that has gone down and whether it can recover on its own; it never disconnects a link or starts a re-pair.",
         recurrence: "*/15 * * * *",
         prompt: CHANNEL_LINK_CHECK,
+        gate: { checks: [{ type: "whatsapp", scope: "status" }] },
     },
     {
         key: "graph-health",
@@ -276,6 +331,7 @@ exports.ROUTINE_ROSTER = [
         description: "Reports what the hourly graph sweep last did and what is waiting for review; it reads only and never runs the sweep itself.",
         recurrence: "0 9 * * 1",
         prompt: GRAPH_HEALTH,
+        gateless: "Reports the sweep's state every fire by design, so there is nothing conditional to check.",
     },
     {
         key: "filesystem-health",
@@ -283,6 +339,7 @@ exports.ROUTINE_ROSTER = [
         description: "Reports what has grown under the account directory and which paths are worth attention; it deletes nothing.",
         recurrence: "0 9 * * 1",
         prompt: FILESYSTEM_HEALTH,
+        gateless: "Reports what has grown every fire by design, so there is nothing conditional to check.",
     },
 ];
 /** Every roster key, in roster order. The scheduling heartbeat's `op=roster`

package/payload/platform/lib/routine-templates/dist/roster.js.map

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

package/payload/platform/lib/routine-templates/src/__tests__/roster.test.ts

@@ -10,7 +10,15 @@
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { describe, expect, it } from "vitest";
-import { ROUTINE_ROSTER, ROUTINE_ROSTER_KEYS, ROUTINE_TEMPLATE_VERSION } from "../roster.js";
+import {
+  GATE_COMMIT_TOKEN,
+  gateNeedsCommit,
+  isClassified,
+  isWatermarkedCheck,
+  ROUTINE_ROSTER,
+  ROUTINE_ROSTER_KEYS,
+  ROUTINE_TEMPLATE_VERSION,
+} from "../roster.js";
 
 /** Every canonical maxy tool name, read from the generated registry rather than
  *  re-listed here. A list re-typed in this file would drift from the registry,
@@ -45,6 +53,10 @@ function citedToolCandidates(prompt: string): string[] {
     "outlook-",
     "google-",
     "schedule-",
+    // Task 2379 — the calendar template's commit sentence is the first prompt to
+    // cite `scheduling-gate`. Without this prefix the token is collected by
+    // nothing and the registry assertion passes over it without looking.
+    "scheduling-",
     "work-",
     "contact-",
     "connector-",
@@ -211,3 +223,83 @@ describe("routine prompts are generic", () => {
     expect(hits).toEqual([]);
   });
 });
+
+describe("routine gate classification", () => {
+  // Task 2379 — a template is either gated or explicitly not, and the reason
+  // for the second is a field rather than a comment because a comment cannot be
+  // asserted. The failure this prevents is silent: a conditional template that
+  // ships ungated is correct in every other respect and simply costs a full
+  // model turn per fire once enabled.
+  it("every template is classified exactly once, gated or gateless", () => {
+    for (const r of ROUTINE_ROSTER) {
+      expect(isClassified(r), `${r.key} must carry exactly one of gate and gateless`).toBe(true);
+    }
+  });
+
+  it("rejects a template that is unclassified, doubly classified, or has an empty reason", () => {
+    // The corpus passing proves nothing about the control: a predicate fed only
+    // passing input reports clean while checking nothing. These are the three
+    // ways a later template could slip past the rule.
+    const base = { key: "x", name: "X", description: "X.", recurrence: "0 9 * * 1", prompt: "p" };
+    const gate = { checks: [{ type: "whatsapp", scope: "status" }] } as const;
+    expect(isClassified(base), "neither").toBe(false);
+    expect(isClassified({ ...base, gate, gateless: "Because." }), "both").toBe(false);
+    expect(isClassified({ ...base, gateless: "   " }), "blank reason").toBe(false);
+    expect(isClassified({ ...base, gate }), "gate only").toBe(true);
+    expect(isClassified({ ...base, gateless: "Judgement every fire." }), "reason only").toBe(true);
+  });
+
+  it("gates exactly the two quarter-hourly conditional rows", () => {
+    const gatedKeys = ROUTINE_ROSTER.filter((r) => r.gate != null)
+      .map((r) => r.key)
+      .sort();
+    expect(gatedKeys).toEqual(["calendar-reconcile", "channel-link-check"]);
+  });
+
+  it("every gateless reason is a sentence, not a placeholder", () => {
+    for (const r of ROUTINE_ROSTER) {
+      if (r.gate != null) continue;
+      expect(r.gateless!.length, `${r.key} gateless reason`).toBeGreaterThan(20);
+      expect(r.gateless!.endsWith("."), `${r.key} gateless reason must end in a full stop`).toBe(true);
+    }
+  });
+
+  it("uses no check type the shipped tool does not declare", () => {
+    // Read as text, the same way CANONICAL_TOOL_NAMES is read. routine-templates
+    // is a platform/lib package; importing from platform/plugins would invert
+    // the dependency direction and break the lib build.
+    const toolSrc = readFileSync(
+      resolve(process.cwd(), "../../plugins/scheduling/mcp/src/tools/scheduling-gate.ts"),
+      "utf-8",
+    );
+    const declared = new Set([...toolSrc.matchAll(/type:\s*"([a-z]+)"/g)].map((m) => m[1]));
+    expect(declared.size, "the tool must declare check types").toBeGreaterThan(0);
+    for (const r of ROUTINE_ROSTER) {
+      for (const c of r.gate?.checks ?? []) {
+        expect(declared, `${r.key} check ${c.type}`).toContain(c.type);
+      }
+    }
+  });
+
+  it("a watermarked gate carries the commit token and a stateless one does not", () => {
+    // A watermarked check reads `stored ?? 0` and reports work on every fire
+    // until something commits, so a gate holding one is inert without the line.
+    // A stateless check has nothing to advance, so a token there would ask the
+    // turn to make a call that does nothing.
+    for (const r of ROUTINE_ROSTER) {
+      if (r.gate == null) {
+        expect(r.prompt, `${r.key} has no gate so must carry no token`).not.toContain(GATE_COMMIT_TOKEN);
+        continue;
+      }
+      expect(r.prompt.includes(GATE_COMMIT_TOKEN), `${r.key} token presence`).toBe(gateNeedsCommit(r.gate));
+    }
+  });
+
+  it("classifies which checks hold a watermark", () => {
+    expect(isWatermarkedCheck({ type: "whatsapp", scope: "status" })).toBe(false);
+    expect(isWatermarkedCheck({ type: "whatsapp", scope: "inbound" })).toBe(true);
+    expect(isWatermarkedCheck({ type: "d1", database: "d", sql: "SELECT count(*) FROM t" })).toBe(false);
+    expect(isWatermarkedCheck({ type: "calendar", connector: "account" })).toBe(true);
+    expect(isWatermarkedCheck({ type: "mail", mailbox: "m" })).toBe(true);
+  });
+});

package/payload/platform/lib/routine-templates/src/__tests__/seed.test.ts

@@ -342,3 +342,77 @@ describe("seedRoutineRoster", () => {
     expect(lines.find((l) => l.includes("op=end"))).toContain("ranMs=42");
   });
 });
+
+describe("gate seeding", () => {
+  /** The gate block runs after the MERGE, where `e.eventId` is bound on both
+   *  branches. Its runtime semantics belong to Neo4j, as for the rest of this
+   *  statement; what is testable here, and what a later edit would break
+   *  silently, is its shape. */
+  function gateBlock(): string {
+    const start = MERGE_CYPHER.indexOf("AS writing");
+    expect(start, "the post-MERGE gate block must be present").toBeGreaterThan(-1);
+    return MERGE_CYPHER.slice(start, MERGE_CYPHER.indexOf("RETURN row.key"));
+  }
+
+  it("writes the gate only when the prompt would also be written", () => {
+    expect(MERGE_CYPHER).toContain("(NOT existed OR refreshing) AS writing");
+  });
+
+  it("stamps the row's own eventId into gateArgs", () => {
+    // The tool declares eventId as required and names the watermark file from
+    // it. A template cannot know one, so the seed is the only place it can come
+    // from, and it must be the whole id rather than the eight-character prefix
+    // a turn can read from its own provenance preamble.
+    expect(gateBlock()).toContain(`'{"eventId":"' + e.eventId + '","checks":' + row.gateChecks + '}'`);
+  });
+
+  it("clears the three properties when a template is reclassified gateless", () => {
+    // Asymmetric handling would leave a row carrying a gate its template no
+    // longer declares, with nothing to say so.
+    const body = gateBlock();
+    for (const prop of ["gatePlugin", "gateTool", "gateArgs"]) {
+      expect(body, `${prop} must have a null branch`).toMatch(
+        new RegExp(`e\\.${prop} = CASE WHEN writing THEN \\(CASE WHEN row\\.gateChecks IS NULL THEN null`),
+      );
+    }
+  });
+
+  it("leaves every gate property alone when not writing", () => {
+    const body = gateBlock();
+    for (const prop of ["gatePlugin", "gateTool", "gateArgs"]) {
+      expect(body, `${prop} must fall through to itself`).toContain(`ELSE e.${prop} END`);
+    }
+  });
+
+  it("substitutes the commit token with the same eventId and checks", () => {
+    expect(gateBlock()).toContain("replace(e.agentPrompt, '<<gateCommit>>'");
+    expect(gateBlock()).toContain(`,"commit":true}'`);
+  });
+
+  it("passes serialised checks for a gated row and null for a gateless one", async () => {
+    const { session, calls } = fakeSession({
+      timezone: { timezone: "Europe/Lisbon", timezoneSource: "owner-set" },
+      merges: allUnchanged,
+      verify: cleanVerify,
+    });
+    await seedRoutineRoster({
+      session,
+      accountId: "abcd1234-0000-0000-0000-000000000000",
+      now: "2026-08-02T00:00:00.000Z",
+      log: () => {},
+    });
+    const merge = calls.find((c) => c.query.includes("MERGE (e:Event"))!;
+    const rows = merge.params.rows as Array<{ key: string; gateChecks: string | null }>;
+    const byKey = new Map(rows.map((r) => [r.key, r.gateChecks]));
+    expect(byKey.get("channel-link-check")).toBe('[{"type":"whatsapp","scope":"status"}]');
+    expect(byKey.get("calendar-reconcile")).toBe('[{"type":"calendar","connector":"account"}]');
+    expect(byKey.get("weekly-digest")).toBeNull();
+  });
+
+  it("serialises the checks in exactly one place", () => {
+    // The gate and the prompt's commit call must not be able to disagree about
+    // what this routine checks, so both read the same row.gateChecks.
+    const occurrences = MERGE_CYPHER.split("row.gateChecks").length - 1;
+    expect(occurrences).toBeGreaterThanOrEqual(4);
+  });
+});