@rubytech/create-maxy-code 0.1.547 → 0.1.548

package/dist/index.js

@@ -3405,6 +3405,20 @@ function setupAccount() {
             env: { ...neo4jEnv, PLATFORM_ROOT: join(INSTALL_DIR, "platform") },
         });
     }
+    // Task 2361 — collapse the two routine description properties onto
+    // `:Event.description`, preferring whichever value the operator or the agent
+    // wrote. Runs after the seed for the same reasons the convergence above does:
+    // the schema exists by then, and the same Neo4j env is already built. Scoped to
+    // this install's accounts via PLATFORM_ROOT, so a co-resident brand sharing one
+    // Neo4j is untouched. Idempotent: a converged install matches nothing and
+    // prints converged=0.
+    const convergeRoutineDescription = join(INSTALL_DIR, "platform/plugins/scheduling/mcp/dist/scripts/converge-routine-description.js");
+    if (existsSync(convergeRoutineDescription)) {
+        shell("node", [convergeRoutineDescription], {
+            cwd: INSTALL_DIR,
+            env: { ...neo4jEnv, PLATFORM_ROOT: join(INSTALL_DIR, "platform") },
+        });
+    }
     // Task 165 — register every bundled specialist subagent at
     // $CLAUDE_CONFIG_DIR/agents/<name>.md. Claude Code's `--agent <name>`
     // discovery only resolves under this path; without these symlinks,

package/package.json

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

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

@@ -70,13 +70,14 @@ export interface RoutineVerifyCounts {
     actual: number;
     suspended: number;
     nextRunNull: number;
-    /** Task 2214 — roster rows holding no description. Zero is the healthy value
-     *  on every account, not only a fresh one: `VERIFY_CYPHER` matches
-     *  `routineTemplate IS NOT NULL`, so operator-created routines are outside
-     *  its scope and cannot contribute, and `ON MATCH` writes the description
-     *  unconditionally, so an operator-edited row is covered too. Anything above
-     *  zero while `expected === actual` is a MERGE that wrote no description —
-     *  the one failure here that emits no error and does not reproduce. */
+    /** Roster rows holding no description. Zero is the healthy value on every
+     *  account, not only a fresh one: `VERIFY_CYPHER` matches `routineTemplate IS
+     *  NOT NULL`, so operator-created routines are outside its scope and cannot
+     *  contribute. Anything above zero while `expected === actual` is a MERGE that
+     *  wrote no description on create, or a row whose key left the roster before
+     *  the convergence ran — the one failure here that emits no error and does not
+     *  reproduce. `[schedule-audit] op=description-coverage` is the wider twin,
+     *  over every automation row rather than the roster alone. */
     descNull: number;
 }
 export interface RoutineSeedReport {
@@ -124,17 +125,22 @@ export declare function resolveOwnerTimezone(session: SeedSessionLike, accountId
  *  destination, or reset a retimed cron. Only the prompt, the name and the
  *  version move, and only when the row is behind and unedited.
  *
- *  `routineDescription` (Task 2214) is the one property ON MATCH writes on
- *  every match rather than only on the refresh branch, and that is not an
- *  exception to the rule above. It is roster-owned: the routines route projects
- *  it but its PATCH field set refuses it, so no operator edit exists for this
- *  to overwrite. Gating it on `refreshing` would leave every operator-edited
- *  row description-less permanently, because `skip-operator-edited` takes
- *  neither branch, and that row's card would show a title and nothing else. */
-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.routineDescription = 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.routineDescription = row.description,\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";
+ *  `description` (Task 2361) is guarded exactly as the prompt and the name are,
+ *  and that is a change of shape from Task 2214, which introduced it. It used to
+ *  be written on every match, on the grounds that it was roster-owned and the
+ *  routines PATCH refused it, so no operator edit existed for the seed to
+ *  clobber, and that gating it would leave every operator-edited row
+ *  description-less permanently because `skip-operator-edited` takes neither
+ *  branch. Both halves of that argument are gone. The routines PATCH now accepts
+ *  `description` and stamps `operatorEdited`, so an unconditional write would
+ *  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";
 /** 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.routineDescription IS NULL THEN 1 ELSE 0 END) AS descNull";
+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";
 export interface SeedRoutineRosterArgs {
     session: SeedSessionLike;
     accountId: string;

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;;;;;;2EAMuE;IACvE,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;;;;;;;;;;;;;;;;;;;;+EAoB+E;AAC/E,eAAO,MAAM,YAAY,28DAwCwB,CAAC;AAElD;+DAC+D;AAC/D,eAAO,MAAM,aAAa,+VAMuD,CAAC;AAElF,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;;;;;;;;;;;;;;;;;;;;;;;;;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"}

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

@@ -92,13 +92,18 @@ async function resolveOwnerTimezone(session, accountId) {
  *  destination, or reset a retimed cron. Only the prompt, the name and the
  *  version move, and only when the row is behind and unedited.
  *
- *  `routineDescription` (Task 2214) is the one property ON MATCH writes on
- *  every match rather than only on the refresh branch, and that is not an
- *  exception to the rule above. It is roster-owned: the routines route projects
- *  it but its PATCH field set refuses it, so no operator edit exists for this
- *  to overwrite. Gating it on `refreshing` would leave every operator-edited
- *  row description-less permanently, because `skip-operator-edited` takes
- *  neither branch, and that row's card would show a title and nothing else. */
+ *  `description` (Task 2361) is guarded exactly as the prompt and the name are,
+ *  and that is a change of shape from Task 2214, which introduced it. It used to
+ *  be written on every match, on the grounds that it was roster-owned and the
+ *  routines PATCH refused it, so no operator edit existed for the seed to
+ *  clobber, and that gating it would leave every operator-edited row
+ *  description-less permanently because `skip-operator-edited` takes neither
+ *  branch. Both halves of that argument are gone. The routines PATCH now accepts
+ *  `description` and stamps `operatorEdited`, so an unconditional write would
+ *  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. */
 exports.MERGE_CYPHER = `
 UNWIND $rows AS row
 OPTIONAL MATCH (pre:Event {accountId: $accountId, routineTemplate: row.key})
@@ -111,7 +116,7 @@ WITH row, existed, priorVersion, edited,
 MERGE (e:Event {accountId: $accountId, routineTemplate: row.key})
   ON CREATE SET e.eventId = randomUUID(),
                 e.name = row.name,
-                e.routineDescription = row.description,
+                e.description = row.description,
                 e.agentPrompt = row.prompt,
                 e.recurrence = row.recurrence,
                 e.routineTemplateVersion = $version,
@@ -131,7 +136,7 @@ MERGE (e:Event {accountId: $accountId, routineTemplate: row.key})
                 e.updatedAt = $now
   ON MATCH SET e.agentPrompt = CASE WHEN refreshing THEN row.prompt ELSE e.agentPrompt END,
                e.name = CASE WHEN refreshing THEN row.name ELSE e.name END,
-               e.routineDescription = row.description,
+               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
 RETURN row.key AS key,
@@ -148,7 +153,7 @@ WHERE e.routineTemplate IS NOT NULL
 RETURN count(e) AS actual,
        sum(CASE WHEN e.eventStatus = 'suspended' THEN 1 ELSE 0 END) AS suspended,
        sum(CASE WHEN e.nextRun IS NULL THEN 1 ELSE 0 END) AS nextRunNull,
-       sum(CASE WHEN e.routineDescription IS NULL THEN 1 ELSE 0 END) AS descNull`;
+       sum(CASE WHEN e.description IS NULL THEN 1 ELSE 0 END) AS descNull`;
 /**
  * Seed (or re-seed) the roster for one account and report what happened.
  *

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":";;;AA8GA,0BAEC;AAaD,oDAgBC;AA6GD,8CAgFC;AA1UD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,2CAA6F;AAE7F,yCAA4F;AAAnF,2GAAA,cAAc,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAAE,qHAAA,wBAAwB,OAAA;AAgEtE;gFACgF;AAChF,SAAS,KAAK,CAAC,GAAY;IACzB,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,GAAG,IAAI,OAAQ,GAAmC,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC/E,OAAQ,GAAkC,CAAC,QAAQ,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED;4DAC4D;AAC5D,SAAgB,OAAO,CAAC,SAAiB;IACvC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,oBAAoB,CACxC,OAAwB,EACxB,SAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAC3B;;;aAGS,EACT,EAAE,SAAS,EAAE,CACd,CAAC;IACF,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;aAyBa;AACA,QAAA,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAwCqB,CAAC;AAElD;+DAC+D;AAClD,QAAA,aAAa,GAAG;;;;;;0EAM6C,CAAC;AAkB3E;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,iBAAiB,CAAC,IAA2B;IACjE,MAAM,EACJ,OAAO,EACP,SAAS,EACT,OAAO,GAAG,oCAAwB,EAClC,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAC9B,MAAM,GAAG,0BAAc,EACvB,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,EACzD,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GACzB,GAAG,IAAI,CAAC;IAET,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,KAAK,EAAE,CAAC;IAC1B,GAAG,CAAC,gCAAgC,IAAI,WAAW,MAAM,CAAC,MAAM,YAAY,OAAO,EAAE,CAAC,CAAC;IAEvF,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5E,GAAG,CAAC,sCAAsC,IAAI,OAAO,QAAQ,IAAI,MAAM,WAAW,MAAM,EAAE,CAAC,CAAC;IAE5F,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAY,EAAE;QAC/C,SAAS;QACT,OAAO;QACP,QAAQ;QACR,GAAG;QACH,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvB,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB,CAAC,CAAC;KACJ,CAAC,CAAC;IAEH,MAAM,MAAM,GAAsB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/D,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAuB;KACxD,CAAC,CAAC,CAAC;IAEJ,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,GAAG,CAAC,gCAAgC,IAAI,QAAQ,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,MAAM,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,qBAAa,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,MAAM,GAAwB;QAClC,QAAQ,EAAE,MAAM,CAAC,MAAM;QACvB,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QAC7C,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;QACjD,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;KAC5C,CAAC;IACF,GAAG,CACD,iCAAiC,IAAI,aAAa,MAAM,CAAC,QAAQ,WAAW,MAAM,CAAC,MAAM,GAAG;QAC1F,aAAa,MAAM,CAAC,SAAS,gBAAgB,MAAM,CAAC,WAAW,aAAa,MAAM,CAAC,QAAQ,EAAE,CAChG,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;IACnE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,iBAAiB,CAAC,CAAC,MAAM,CAAC;IAC9E,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,sBAAsB,CAAC,CAAC,MAAM,CAAC;IAC/F,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IACxE,MAAM,KAAK,GAAG,KAAK,EAAE,GAAG,SAAS,CAAC;IAElC,GAAG,CACD,8BAA8B,IAAI,UAAU,KAAK,YAAY,OAAO,GAAG;QACrE,WAAW,qBAAqB,cAAc,SAAS,cAAc,SAAS,EAAE,CACnF,CAAC;IAEF,OAAO;QACL,SAAS;QACT,OAAO;QACP,QAAQ;QACR,cAAc,EAAE,MAAM;QACtB,MAAM;QACN,OAAO;QACP,SAAS;QACT,qBAAqB;QACrB,SAAS;QACT,MAAM;QACN,KAAK;KACN,CAAC;AACJ,CAAC"}

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

@@ -43,9 +43,9 @@ export interface RoutineTemplate {
     /** The title shown on `/routines`. */
     readonly name: string;
     /** One sentence under the title on the card: what this does and what it will
-     *  not do. Roster-owned and read-only — projected by the routines route but
-     *  absent from its PATCH field set, so no operator edit exists for the seed to
-     *  overwrite and the MERGE rewrites it on every match. */
+     *  not do. Seeded onto `e.description`, which the operator can then edit from
+     *  the routines page. The seed rewrites it only on a version refresh of an
+     *  unedited row, so an operator's own wording survives every upgrade. */
     readonly description: string;
     /** The proposed cron. Written ON CREATE only, never refreshed, so an operator
      *  who retimes a routine keeps their expression across upgrades. */

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;;;8DAG0D;IAC1D,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,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"}

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

@@ -84,7 +84,7 @@ describe("MERGE statement shape", () => {
     for (const required of [
       "eventId",
       "name",
-      "routineDescription",
+      "description",
       "agentPrompt",
       "recurrence",
       "routineTemplateVersion",
@@ -121,20 +121,24 @@ describe("MERGE statement shape", () => {
 
   it("ON MATCH touches ONLY the prompt, name, description, version and updatedAt", () => {
     expect(new Set(propertiesSetIn("ON MATCH SET"))).toEqual(
-      new Set(["agentPrompt", "name", "routineDescription", "routineTemplateVersion", "updatedAt"]),
+      new Set(["agentPrompt", "name", "description", "routineTemplateVersion", "updatedAt"]),
     );
   });
 
-  it("ON MATCH writes the description unconditionally, not only when refreshing", () => {
-    // Task 2214. The description is roster-owned and absent from the routines
-    // PATCH field set, so there is no operator edit for this to clobber.
-    // Gating it on `refreshing` would leave every operator-edited row without
-    // a description permanently: `skip-operator-edited` takes neither branch,
-    // so its card would show a title and nothing else, for ever.
+  it("ON MATCH writes the description only when refreshing, exactly as the prompt and name are", () => {
+    // The 2214 shape wrote it on every match, because gating it would have left
+    // every operator-edited row description-less for ever: skip-operator-edited
+    // takes neither branch. Task 2361's one-shot convergence removes that
+    // argument by giving every pre-existing row a description before the first
+    // guarded MERGE runs, and from here the description is operator-writable, so
+    // an unconditional write would clobber the operator's own text on every
+    // upgrade.
     const start = MERGE_CYPHER.indexOf("ON MATCH SET");
     const body = MERGE_CYPHER.slice(start, MERGE_CYPHER.indexOf("RETURN"));
-    expect(body).toContain("e.routineDescription = row.description");
-    expect(body).not.toContain("e.routineDescription = CASE");
+    expect(body).toContain(
+      "e.description = CASE WHEN refreshing THEN row.description ELSE e.description END",
+    );
+    expect(body).not.toContain("e.routineDescription");
   });
 
   it("verify counts the descriptions the graph actually holds", () => {
@@ -142,7 +146,7 @@ describe("MERGE statement shape", () => {
     // MERGE succeeds, every action reads `refresh-version`, and the property
     // is simply absent. `expected` and `actual` agree in that state.
     expect(VERIFY_CYPHER).toContain(
-      "sum(CASE WHEN e.routineDescription IS NULL THEN 1 ELSE 0 END) AS descNull",
+      "sum(CASE WHEN e.description IS NULL THEN 1 ELSE 0 END) AS descNull",
     );
   });
 

package/payload/platform/lib/routine-templates/src/index.ts

@@ -71,13 +71,14 @@ export interface RoutineVerifyCounts {
   actual: number;
   suspended: number;
   nextRunNull: number;
-  /** Task 2214 — roster rows holding no description. Zero is the healthy value
-   *  on every account, not only a fresh one: `VERIFY_CYPHER` matches
-   *  `routineTemplate IS NOT NULL`, so operator-created routines are outside
-   *  its scope and cannot contribute, and `ON MATCH` writes the description
-   *  unconditionally, so an operator-edited row is covered too. Anything above
-   *  zero while `expected === actual` is a MERGE that wrote no description —
-   *  the one failure here that emits no error and does not reproduce. */
+  /** Roster rows holding no description. Zero is the healthy value on every
+   *  account, not only a fresh one: `VERIFY_CYPHER` matches `routineTemplate IS
+   *  NOT NULL`, so operator-created routines are outside its scope and cannot
+   *  contribute. Anything above zero while `expected === actual` is a MERGE that
+   *  wrote no description on create, or a row whose key left the roster before
+   *  the convergence ran — the one failure here that emits no error and does not
+   *  reproduce. `[schedule-audit] op=description-coverage` is the wider twin,
+   *  over every automation row rather than the roster alone. */
   descNull: number;
 }
 
@@ -154,13 +155,18 @@ export async function resolveOwnerTimezone(
  *  destination, or reset a retimed cron. Only the prompt, the name and the
  *  version move, and only when the row is behind and unedited.
  *
- *  `routineDescription` (Task 2214) is the one property ON MATCH writes on
- *  every match rather than only on the refresh branch, and that is not an
- *  exception to the rule above. It is roster-owned: the routines route projects
- *  it but its PATCH field set refuses it, so no operator edit exists for this
- *  to overwrite. Gating it on `refreshing` would leave every operator-edited
- *  row description-less permanently, because `skip-operator-edited` takes
- *  neither branch, and that row's card would show a title and nothing else. */
+ *  `description` (Task 2361) is guarded exactly as the prompt and the name are,
+ *  and that is a change of shape from Task 2214, which introduced it. It used to
+ *  be written on every match, on the grounds that it was roster-owned and the
+ *  routines PATCH refused it, so no operator edit existed for the seed to
+ *  clobber, and that gating it would leave every operator-edited row
+ *  description-less permanently because `skip-operator-edited` takes neither
+ *  branch. Both halves of that argument are gone. The routines PATCH now accepts
+ *  `description` and stamps `operatorEdited`, so an unconditional write would
+ *  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 const MERGE_CYPHER = `
 UNWIND $rows AS row
 OPTIONAL MATCH (pre:Event {accountId: $accountId, routineTemplate: row.key})
@@ -173,7 +179,7 @@ WITH row, existed, priorVersion, edited,
 MERGE (e:Event {accountId: $accountId, routineTemplate: row.key})
   ON CREATE SET e.eventId = randomUUID(),
                 e.name = row.name,
-                e.routineDescription = row.description,
+                e.description = row.description,
                 e.agentPrompt = row.prompt,
                 e.recurrence = row.recurrence,
                 e.routineTemplateVersion = $version,
@@ -193,7 +199,7 @@ MERGE (e:Event {accountId: $accountId, routineTemplate: row.key})
                 e.updatedAt = $now
   ON MATCH SET e.agentPrompt = CASE WHEN refreshing THEN row.prompt ELSE e.agentPrompt END,
                e.name = CASE WHEN refreshing THEN row.name ELSE e.name END,
-               e.routineDescription = row.description,
+               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
 RETURN row.key AS key,
@@ -211,7 +217,7 @@ WHERE e.routineTemplate IS NOT NULL
 RETURN count(e) AS actual,
        sum(CASE WHEN e.eventStatus = 'suspended' THEN 1 ELSE 0 END) AS suspended,
        sum(CASE WHEN e.nextRun IS NULL THEN 1 ELSE 0 END) AS nextRunNull,
-       sum(CASE WHEN e.routineDescription IS NULL THEN 1 ELSE 0 END) AS descNull`;
+       sum(CASE WHEN e.description IS NULL THEN 1 ELSE 0 END) AS descNull`;
 
 export interface SeedRoutineRosterArgs {
   session: SeedSessionLike;

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

@@ -45,9 +45,9 @@ export interface RoutineTemplate {
   /** The title shown on `/routines`. */
   readonly name: string;
   /** One sentence under the title on the card: what this does and what it will
-   *  not do. Roster-owned and read-only — projected by the routines route but
-   *  absent from its PATCH field set, so no operator edit exists for the seed to
-   *  overwrite and the MERGE rewrites it on every match. */
+   *  not do. Seeded onto `e.description`, which the operator can then edit from
+   *  the routines page. The seed rewrites it only on a version refresh of an
+   *  unedited row, so an operator's own wording survives every upgrade. */
   readonly description: string;
   /** The proposed cron. Written ON CREATE only, never refreshed, so an operator
    *  who retimes a routine keeps their expression across upgrades. */

package/payload/platform/plugins/admin/skills/platform-architecture/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: platform-architecture
 description: Use when grounding any documented-surface claim about what Maxy ships — plugins, skills, specialists, install/deploy flows, internals. This is the install catalogue, not evidence of what is enabled on the current account. For install state on this account, call `capabilities-here`; for documented surface, cite the `Source:` URL inline.
-content-hash: sha256:27883a95ee231fb265b37617f71dfdf1a71e28fccf76d09f9e75c0726c777f48
+content-hash: sha256:db7c14326a115e7d05b687b72bef0ba3892f1614ee46484e0e90414bf2c16f27
 brand: maxy-code
 product-name: Maxy
 ---
@@ -3484,13 +3484,27 @@ The Routines surface (`/routines`) is the admin view of the account's
 automation `:Event` nodes — the device's scheduled agent turns and tool
 dispatches, which the Calendar surface deliberately excludes (`calendar.ts`
 unions only appointment events, `actionPlugin IS NULL`). It renders one card per
-routine (title, the roster's one-sentence description where the routine has one,
-human-readable schedule, next run, channel/destination or tool, status); a card
-opens a detail modal modeled on the calendar `EventDetailModal`. The description
-is roster-owned: the seed is its only writer, `GET /api/admin/routines` projects
-it read-only, and the PATCH route refuses it, so an operator-created routine has
-none and its card renders with no line and no placeholder.
-The modal edits the prose instruction (`agentPrompt`), the dispatch binding
+routine (title, its one-line description where it has one, human-readable
+schedule, next run, channel/destination or tool, status); a card opens a detail
+modal modeled on the calendar `EventDetailModal`. A shipped routine is seeded with
+a description and the operator can rewrite it from the modal; a routine nobody has
+captioned renders with no line and no placeholder. Editing it stamps the row
+operator-owned, so the next roster refresh leaves the operator's wording alone,
+and recomputes the row's search vector, which is built from the name and the
+description. A description is never dispatched: `agentPrompt` is the only text a
+fire sends.
+The read-only view shows two prose blocks, each under its own heading, in the
+order **Description** then **Instruction sent to the agent**. Both use the same
+header-above-prose shape, so neither reads as a different kind of thing from the
+other. Before this the modal showed one unheaded block, so the caption and the
+multi-KB prompt that actually fires were indistinguishable. The instruction
+heading never reads the bare word "Instruction", in either mode: that collides
+with the `## Instruction` block the platform appends to every dispatched channel
+turn, and an agent read the two as the same field. The Description block renders
+on every kind of routine, including a tool-action routine and a bare trigger,
+because both already show it on the card; the instruction block belongs to an
+agent routine, the only kind that has one. The modal edits the description, the
+prose instruction (`agentPrompt`), the dispatch binding
 (`agentChannel` and `agentDestination`, chosen from a server-supplied roster
 rather than typed), and the schedule via a friendly builder (frequency
 daily/weekly/monthly, day-of-week, day-of-month, time) that falls back to a
@@ -3551,7 +3565,7 @@ The route (`server/routes/admin/routines.ts`) is account-scoped like `calendar.t
 | `GET /api/admin/routines/:eventId` | One routine, same automation+account guard. |
 | `GET /api/admin/routines/:eventId/runs` | One routine's `:RoutineRun` history, newest first. `limit` clamps to 1..500 and defaults to 50, so a caller that wants the full page must ask for it. |
 | `GET /api/admin/routines/:eventId/runs.csv` | The same projection as a `text/csv` attachment with `Content-Disposition`, and **no** limit, so it is not the same row set as a clamped `/runs` call. Re-parses its own output and returns 500 rather than serving a document with fewer rows than the query returned. Zero rows is 404, not a header-only file: the query cannot tell a routine with no runs from an `eventId` on another account. |
-| `PATCH /api/admin/routines/:eventId` | Edits `agentPrompt`, `recurrence`, and the `agentChannel`/`agentDestination` pair. Cron validation and the timezone-aware `nextRun` recompute copy the scheduling plugin's `schedule-update` tool. The binding is revalidated against the same house-authority rule, shared as `platform/lib/agent-dispatch-rule`; it is refused `partial-binding`, `invalid-channel`, `no-prompt`, `not-registered`, `cross-account`, `action-routine` (a routine that runs a tool keeps it — an agent binding outranks the action at fire time) or `clear-would-orphan` (clearing the only field holding a one-time routine inside the automation filter would hide it from every routines surface), and no refusal writes. Both fields as `null` clears the binding. An invalid cron is rejected 400 with no write. Only creation and deletion stay agent-only (`schedule-event`/`schedule-cancel`). |
+| `PATCH /api/admin/routines/:eventId` | Edits `agentPrompt`, `description`, `recurrence`, and the `agentChannel`/`agentDestination` pair. A `description` write stamps `operatorEdited` and recomputes the row's `embedding` from `Event: <name>` plus the new text, reading the name from the row rather than the request body; the embedder returning nothing leaves the previous vector in place and the save still succeeds. A whitespace-only `description` is stored as null, so "no caption" is one state in the graph. Cron validation and the timezone-aware `nextRun` recompute copy the scheduling plugin's `schedule-update` tool. The binding is revalidated against the same house-authority rule, shared as `platform/lib/agent-dispatch-rule`; it is refused `partial-binding`, `invalid-channel`, `no-prompt`, `not-registered`, `cross-account`, `action-routine` (a routine that runs a tool keeps it — an agent binding outranks the action at fire time) or `clear-would-orphan` (clearing the only field holding a one-time routine inside the automation filter would hide it from every routines surface), and no refusal writes. Both fields as `null` clears the binding. An invalid cron is rejected 400 with no write. Only creation and deletion stay agent-only (`schedule-event`/`schedule-cancel`). |
 | `GET /api/admin/dispatch-destinations` | Every destination the session's account may bind a routine to, across both channels, each labelled by the authoritative list it came from (`House admin`, `Account manager`, `Telegram admin`), plus an optional `name`: a display-only person name resolved from `:Person` in the row's own account scope — the house for a `House admin` row, the managed sub-account for an `Account manager` row, and never for Telegram, whose destinations are chat ids. Computed from the same lists the validator reads and filtered by the same rule, so the picker cannot offer what the save refuses; `name` is never part of what Save posts, and a graph outage returns an unnamed roster rather than an error. |
 | `POST /api/admin/routines/:eventId/suspend` | Writes `eventStatus = 'suspended'` on a routine currently `'scheduled'`. 404s otherwise, so a second suspend is not a silent no-op. |
 | `POST /api/admin/routines/:eventId/resume` | Returns a suspended routine to `'scheduled'`. 404s if it is not suspended, 409s if it cannot be resumed. |
@@ -3632,6 +3646,24 @@ would say so. `completed` gets its own bucket even though no code path writes it
 today, because it remains part of the shipped enum and one row carrying it would
 otherwise pin `other` above zero forever and kill the alarm.
 
+`[schedule-audit] op=description-coverage acct=<8> routines=<n>
+withDescription=<n> withInstruction=<n> toolActions=<n>` is the pair behind the
+two prose blocks the modal shows. A routine carrying an instruction and no
+description is a card whose title is all the operator gets; one carrying a
+description and no instruction is worse, because it looks explained, fires on
+schedule and sends nothing. Neither state writes an event of its own, so only a
+periodic count reveals them, and the counts sit on one line beside the total
+because any one of them alone answers the wrong question. `toolActions` is on the
+line because `withInstruction` is otherwise comparable to nothing: a tool-action
+routine has no instruction and is not silent, it runs a tool, so an account
+holding one would sit at `routines > withInstruction` for ever and the alarm
+would be dead from that point on. The genuinely silent count is `routines -
+toolActions - withInstruction`, the same reconciliation `other` performs in the
+suspension census. Emitted per account on every sweep tick including a healthy
+one, over the same automation set the routes list. The roster seed's own
+`descNull` counter is its narrow twin, scoped to seeded rows and so blind to
+exactly the operator-created ones most likely to carry no caption.
+
 **The shipped roster.** Every account starts with eleven routines —
 `start-of-day`, `inbound-check`, `end-of-day`, `appointment-reminder`,
 `commitment-chase`, `calendar-reconcile`, `contact-reconcile`, `crm-reconcile`,

package/payload/platform/plugins/admin/skills/whats-new/SKILL.md

@@ -9,6 +9,12 @@ Invoked by the admin agent directly.
 
 This is the platform's release timeline, newest first. Each entry shows the date it shipped and the version it shipped in, so you can tell the operator how current their install is. To compare, read the installed version from `capabilities-here` and match it against the versions below. Keep answers high level and in plain English; this is a summary, not a full commit log.
 
+## 2026-08-02 (0.1.548)
+
+- Telegram now works per account: each bot has its own address and secret, a scheduled message goes to the right account, and a check reports any bot that is set up but never delivers.
+- Every WhatsApp reply and document send now names the account it belongs to, and a send whose account does not match its conversation is refused.
+- Each turn now records how much the assistant actually had to work with, so a turn that came back thin can be told apart from one that failed.
+
 ## 2026-08-02 (0.1.547)
 
 - A routine's past runs now read as cards showing status, channel and the message actually sent, with a refresh and a way back in. Runs with no captured output are flagged.

package/payload/platform/plugins/docs/references/admin-ui.md

@@ -99,13 +99,27 @@ The Routines surface (`/routines`) is the admin view of the account's
 automation `:Event` nodes — the device's scheduled agent turns and tool
 dispatches, which the Calendar surface deliberately excludes (`calendar.ts`
 unions only appointment events, `actionPlugin IS NULL`). It renders one card per
-routine (title, the roster's one-sentence description where the routine has one,
-human-readable schedule, next run, channel/destination or tool, status); a card
-opens a detail modal modeled on the calendar `EventDetailModal`. The description
-is roster-owned: the seed is its only writer, `GET /api/admin/routines` projects
-it read-only, and the PATCH route refuses it, so an operator-created routine has
-none and its card renders with no line and no placeholder.
-The modal edits the prose instruction (`agentPrompt`), the dispatch binding
+routine (title, its one-line description where it has one, human-readable
+schedule, next run, channel/destination or tool, status); a card opens a detail
+modal modeled on the calendar `EventDetailModal`. A shipped routine is seeded with
+a description and the operator can rewrite it from the modal; a routine nobody has
+captioned renders with no line and no placeholder. Editing it stamps the row
+operator-owned, so the next roster refresh leaves the operator's wording alone,
+and recomputes the row's search vector, which is built from the name and the
+description. A description is never dispatched: `agentPrompt` is the only text a
+fire sends.
+The read-only view shows two prose blocks, each under its own heading, in the
+order **Description** then **Instruction sent to the agent**. Both use the same
+header-above-prose shape, so neither reads as a different kind of thing from the
+other. Before this the modal showed one unheaded block, so the caption and the
+multi-KB prompt that actually fires were indistinguishable. The instruction
+heading never reads the bare word "Instruction", in either mode: that collides
+with the `## Instruction` block the platform appends to every dispatched channel
+turn, and an agent read the two as the same field. The Description block renders
+on every kind of routine, including a tool-action routine and a bare trigger,
+because both already show it on the card; the instruction block belongs to an
+agent routine, the only kind that has one. The modal edits the description, the
+prose instruction (`agentPrompt`), the dispatch binding
 (`agentChannel` and `agentDestination`, chosen from a server-supplied roster
 rather than typed), and the schedule via a friendly builder (frequency
 daily/weekly/monthly, day-of-week, day-of-month, time) that falls back to a
@@ -166,7 +180,7 @@ The route (`server/routes/admin/routines.ts`) is account-scoped like `calendar.t
 | `GET /api/admin/routines/:eventId` | One routine, same automation+account guard. |
 | `GET /api/admin/routines/:eventId/runs` | One routine's `:RoutineRun` history, newest first. `limit` clamps to 1..500 and defaults to 50, so a caller that wants the full page must ask for it. |
 | `GET /api/admin/routines/:eventId/runs.csv` | The same projection as a `text/csv` attachment with `Content-Disposition`, and **no** limit, so it is not the same row set as a clamped `/runs` call. Re-parses its own output and returns 500 rather than serving a document with fewer rows than the query returned. Zero rows is 404, not a header-only file: the query cannot tell a routine with no runs from an `eventId` on another account. |
-| `PATCH /api/admin/routines/:eventId` | Edits `agentPrompt`, `recurrence`, and the `agentChannel`/`agentDestination` pair. Cron validation and the timezone-aware `nextRun` recompute copy the scheduling plugin's `schedule-update` tool. The binding is revalidated against the same house-authority rule, shared as `platform/lib/agent-dispatch-rule`; it is refused `partial-binding`, `invalid-channel`, `no-prompt`, `not-registered`, `cross-account`, `action-routine` (a routine that runs a tool keeps it — an agent binding outranks the action at fire time) or `clear-would-orphan` (clearing the only field holding a one-time routine inside the automation filter would hide it from every routines surface), and no refusal writes. Both fields as `null` clears the binding. An invalid cron is rejected 400 with no write. Only creation and deletion stay agent-only (`schedule-event`/`schedule-cancel`). |
+| `PATCH /api/admin/routines/:eventId` | Edits `agentPrompt`, `description`, `recurrence`, and the `agentChannel`/`agentDestination` pair. A `description` write stamps `operatorEdited` and recomputes the row's `embedding` from `Event: <name>` plus the new text, reading the name from the row rather than the request body; the embedder returning nothing leaves the previous vector in place and the save still succeeds. A whitespace-only `description` is stored as null, so "no caption" is one state in the graph. Cron validation and the timezone-aware `nextRun` recompute copy the scheduling plugin's `schedule-update` tool. The binding is revalidated against the same house-authority rule, shared as `platform/lib/agent-dispatch-rule`; it is refused `partial-binding`, `invalid-channel`, `no-prompt`, `not-registered`, `cross-account`, `action-routine` (a routine that runs a tool keeps it — an agent binding outranks the action at fire time) or `clear-would-orphan` (clearing the only field holding a one-time routine inside the automation filter would hide it from every routines surface), and no refusal writes. Both fields as `null` clears the binding. An invalid cron is rejected 400 with no write. Only creation and deletion stay agent-only (`schedule-event`/`schedule-cancel`). |
 | `GET /api/admin/dispatch-destinations` | Every destination the session's account may bind a routine to, across both channels, each labelled by the authoritative list it came from (`House admin`, `Account manager`, `Telegram admin`), plus an optional `name`: a display-only person name resolved from `:Person` in the row's own account scope — the house for a `House admin` row, the managed sub-account for an `Account manager` row, and never for Telegram, whose destinations are chat ids. Computed from the same lists the validator reads and filtered by the same rule, so the picker cannot offer what the save refuses; `name` is never part of what Save posts, and a graph outage returns an unnamed roster rather than an error. |
 | `POST /api/admin/routines/:eventId/suspend` | Writes `eventStatus = 'suspended'` on a routine currently `'scheduled'`. 404s otherwise, so a second suspend is not a silent no-op. |
 | `POST /api/admin/routines/:eventId/resume` | Returns a suspended routine to `'scheduled'`. 404s if it is not suspended, 409s if it cannot be resumed. |
@@ -247,6 +261,24 @@ would say so. `completed` gets its own bucket even though no code path writes it
 today, because it remains part of the shipped enum and one row carrying it would
 otherwise pin `other` above zero forever and kill the alarm.
 
+`[schedule-audit] op=description-coverage acct=<8> routines=<n>
+withDescription=<n> withInstruction=<n> toolActions=<n>` is the pair behind the
+two prose blocks the modal shows. A routine carrying an instruction and no
+description is a card whose title is all the operator gets; one carrying a
+description and no instruction is worse, because it looks explained, fires on
+schedule and sends nothing. Neither state writes an event of its own, so only a
+periodic count reveals them, and the counts sit on one line beside the total
+because any one of them alone answers the wrong question. `toolActions` is on the
+line because `withInstruction` is otherwise comparable to nothing: a tool-action
+routine has no instruction and is not silent, it runs a tool, so an account
+holding one would sit at `routines > withInstruction` for ever and the alarm
+would be dead from that point on. The genuinely silent count is `routines -
+toolActions - withInstruction`, the same reconciliation `other` performs in the
+suspension census. Emitted per account on every sweep tick including a healthy
+one, over the same automation set the routes list. The roster seed's own
+`descNull` counter is its narrow twin, scoped to seeded rows and so blind to
+exactly the operator-created ones most likely to carry no caption.
+
 **The shipped roster.** Every account starts with eleven routines —
 `start-of-day`, `inbound-check`, `end-of-day`, `appointment-reminder`,
 `commitment-chase`, `calendar-reconcile`, `contact-reconcile`, `crm-reconcile`,

package/payload/platform/plugins/scheduling/PLUGIN.md

@@ -204,6 +204,12 @@ Use standard 5-field cron syntax: `minute hour day-of-month month day-of-week`.
 | `0 0 1 * *` | First of each month at midnight |
 | `*/30 * * * *` | Every 30 minutes |
 
+## What an update confirms
+
+`schedule-update` returns the properties it wrote: `Event updated: <id> — fields: description, recurrence`. Companions count — changing `recurrence` also writes `nextRun`, changing `eventStatus` also writes `suspendedInBulk`, and setting an `agentDispatch` also clears `actionPlugin`, `actionTool` and `actionArgs`. Four properties are never named: `updatedAt` and `operatorEdited` are stamps, `embedding` is a derived search vector, and `notes` is reported as `note appended` instead, and only when the caller supplied one that was not empty.
+
+When `agentPrompt` is not among the fields, the line ends `(the instruction sent to the agent was not changed)`. That clause is the answer to "did my prompt rewrite land" — a confirmation without it means the dispatch prompt was written. Editing a meeting opens `Meeting updated:` and names the caller's own field names, not the stored `title`/`startsAt`/`endsAt`.
+
 ## Skip next
 
 For recurring events, `schedule-update` with `skipNext: true` advances `nextRun` by one cycle without triggering. Use when the user says "skip tomorrow's briefing" or similar.

package/payload/platform/plugins/scheduling/mcp/dist/index.js

@@ -7,6 +7,7 @@ import { scheduleList } from "./tools/schedule-list.js";
 import { scheduleGet } from "./tools/schedule-get.js";
 import { scheduleRuns } from "./tools/schedule-runs.js";
 import { scheduleUpdate, EVENT_STATUSES } from "./tools/schedule-update.js";
+import { describeUpdate } from "./lib/update-summary.js";
 import { scheduleCancel } from "./tools/schedule-cancel.js";
 import { scheduleExportIcs } from "./tools/schedule-export-ics.js";
 import { scheduleImportIcs } from "./tools/schedule-import-ics.js";
@@ -328,11 +329,14 @@ eagerTool(server, "schedule-update", "Update an event's properties or append a n
     if (!accountId)
         return refuseNoAccount("schedule-update");
     try {
-        await scheduleUpdate({ ...params, accountId });
+        const written = await scheduleUpdate({ ...params, accountId });
         if (params.skipNext) {
             return { content: [{ type: "text", text: `Skipped next occurrence of event: ${params.eventId}` }] };
         }
-        return { content: [{ type: "text", text: `Event updated: ${params.eventId}` }] };
+        // Task 2362 — name the properties written. The flat `Event updated: <id>` this replaced read
+        // identically for a description edit and for a dispatch-prompt rewrite, and an agent read it
+        // as proof its own successful rewrite had not landed.
+        return { content: [{ type: "text", text: describeUpdate(params.eventId, written) }] };
     }
     catch (err) {
         return {