instar 1.3.581 → 1.3.583

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.581",
+  "version": "1.3.583",
   "description": "Coherence infrastructure for self-evolving AI agents — on the Claude Code or Codex subscription you already have.",
   "type": "module",
   "main": "dist/index.js",

package/src/data/builtin-manifest.json

@@ -1,8 +1,8 @@
 {
   "$schema": "./builtin-manifest.schema.json",
   "schemaVersion": 1,
-  "generatedAt": "2026-06-15T22:20:44.830Z",
-  "instarVersion": "1.3.581",
+  "generatedAt": "2026-06-15T23:23:58.124Z",
+  "instarVersion": "1.3.583",
   "entryCount": 201,
   "entries": {
     "hook:session-start": {
@@ -418,7 +418,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:agents": {
@@ -426,7 +426,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:backups": {
@@ -434,7 +434,7 @@
       "type": "route-group",
       "domain": "operations",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:git": {
@@ -442,7 +442,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:memory": {
@@ -450,7 +450,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:semantic": {
@@ -458,7 +458,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:status": {
@@ -466,7 +466,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:capabilities": {
@@ -474,7 +474,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:project-map": {
@@ -482,7 +482,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:coherence": {
@@ -490,7 +490,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:topic-bindings": {
@@ -498,7 +498,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:context": {
@@ -506,7 +506,7 @@
       "type": "route-group",
       "domain": "context",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:scope-coherence": {
@@ -514,7 +514,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:canonical-state": {
@@ -522,7 +522,7 @@
       "type": "route-group",
       "domain": "state",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:ci": {
@@ -530,7 +530,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:sessions": {
@@ -538,7 +538,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:jobs": {
@@ -546,7 +546,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:skip-ledger": {
@@ -554,7 +554,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:telegram": {
@@ -562,7 +562,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:attention": {
@@ -570,7 +570,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:relationships": {
@@ -578,7 +578,7 @@
       "type": "route-group",
       "domain": "relationships",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:feedback": {
@@ -586,7 +586,7 @@
       "type": "route-group",
       "domain": "feedback",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:updates": {
@@ -594,7 +594,7 @@
       "type": "route-group",
       "domain": "updates",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:dispatches": {
@@ -602,7 +602,7 @@
       "type": "route-group",
       "domain": "dispatches",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:quota": {
@@ -610,7 +610,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:publishing": {
@@ -618,7 +618,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:private-views": {
@@ -626,7 +626,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:tunnel": {
@@ -634,7 +634,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:events": {
@@ -642,7 +642,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:evolution": {
@@ -650,7 +650,7 @@
       "type": "route-group",
       "domain": "evolution",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:watchdog": {
@@ -658,7 +658,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:topic-memory": {
@@ -666,7 +666,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:state-sync": {
@@ -674,7 +674,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:intent": {
@@ -682,7 +682,7 @@
       "type": "route-group",
       "domain": "intent",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:triage": {
@@ -690,7 +690,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:operations": {
@@ -698,7 +698,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:sentinel": {
@@ -706,7 +706,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:trust": {
@@ -714,7 +714,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:monitoring": {
@@ -722,7 +722,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:commitments": {
@@ -730,7 +730,7 @@
       "type": "route-group",
       "domain": "commitments",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:episodes": {
@@ -738,7 +738,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:messages": {
@@ -746,7 +746,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:system-reviews": {
@@ -754,7 +754,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "route-group:machine-mesh": {
@@ -770,7 +770,7 @@
       "type": "route-group",
       "domain": "security",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "1eb5f96423afcb2cdf205bdc5fa411c3cd388e5056bc8c3ebd4725b67133e0d4",
+      "contentHash": "3cc60e918a373b7e290b7831998b6ba5c8260fd4f441b687dc45cb9413f34d2a",
       "since": "2025-01-01"
     },
     "cli:init": {
@@ -1522,7 +1522,7 @@
       "type": "subsystem",
       "domain": "server",
       "sourcePath": "src/server/AgentServer.ts",
-      "contentHash": "8587c3a5e417b209d259c45458f1d6049f3c9263895ff9265d40d36f9452c257",
+      "contentHash": "9fb97d1eb14b51e7956450cf33d15732c7d3a99dda89e294a7d96ecf0784d93b",
       "since": "2025-01-01"
     },
     "subsystem:session-manager": {

package/upgrades/1.3.582.md

@@ -0,0 +1,47 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: patch -->
+
+## What Changed
+
+The `preferences` store is now wired into the WS2 send-side — the LAST of the 7 replicated
+stores. Unlike the others, `preferences` had no emit seam (it rode the deprecated
+`preferences-sync` verb), so this authors one on `PreferencesManager` (a
+`setReplicationEmitter` + a best-effort emitPut at the end of `recordPreference`) and plumbs
+the journal emitter to the correction-loop's PreferencesManager (the sole writer) through the
+existing RouteContext replication channel. `ws2SendWiring`'s PENDING set is now EMPTY — every
+replicated memory/PII store sends. PUT-ONLY (recordPreference upserts on dedupeKey; no delete
+path). Dark by default (`multiMachine.stateSync.preferences`).
+
+With this, **all seven WS2 stores send across machines**: learnings, relationships,
+knowledge, evolutionActions, topicOperator, userRegistry, and preferences.
+
+## What to Tell Your User
+
+- **What I've learned about how you like to work now travels across machines**: "When you
+  correct me the same way enough times, I save it as a durable preference. If you run me on
+  more than one machine, a preference I learn on one now applies on the others — so I don't
+  have to re-learn 'lead with the action' separately per machine. Only the preference text +
+  how confident I am crosses; a preference that arrives from another machine is advisory, not
+  a hard rule. It stays off until you turn on multi-machine sync." ⚗️ Experimental — ships
+  dark.
+
+## Summary of New Capabilities
+
+| Capability | How to Use |
+|-----------|-----------|
+| Cross-machine replication of learned preferences (dedupeKey-keyed) | Automatic once `multiMachine.stateSync.preferences` is enabled (off by default) |
+| Same preference (same dedupeKey) on two machines collapses to one record | Automatic (read path) |
+| An upsert (re-recording the same preference) re-replicates the refreshed learning + confidence | Automatic (recordPreference path) |
+
+## Evidence
+
+Verified by a two-instance in-process E2E
+(`tests/e2e/ws2-preferences-cross-instance.test.ts`): a preference recorded on instance A is
+read back on B through the bypass-proof union reader as a foreign-origin record (dedupeKey-
+keyed); and an upsert (same dedupeKey, refreshed learning + raised confidence) re-replicates
+the latest record, over the real journal serve/apply path. `tsc --noEmit` clean; the new e2e
+(2) passes; the existing PreferencesManager unit suites (41) stay green with the authored
+seam; the ws2-send-wiring integration ratchet (4) accepts the PENDING→WIRED move (PENDING now
+empty — all 7 stores wired).

package/upgrades/1.3.583.md

@@ -0,0 +1,51 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: patch -->
+
+## What Changed
+
+A short timer drift that recurs while load sits in the **1.0–1.5/core band** slipped past both
+existing guards: the load guard fires only above 1.5/core, and the consecutive burst floor resets
+whenever on-time ticks fall between drifts. Its ~2-minute cadence also outlasted the 60s cooldown.
+So each isolated drift emitted a **false `wake`**, firing the full wake-recovery cascade (tunnel
+restart, Slack reconnect, mesh-lease churn, topic failover) — the source of a class of multi-machine
+UX failures: a reply that's lost the conversation thread, messages that get no reply, and "remote
+typing is disabled" (the 2026-06-15 incident, measured at ~1.13/core).
+
+The detector now adds a **recurring-drift guard**: a short drift within `recentDriftWindowMs`
+(default 5 min) of a prior short drift, while load is oversubscribed (`> recentDriftLoadFloor`,
+default 1.0/core), is treated as recurring CPU starvation and suppressed. This generalizes the burst
+floor from *consecutive* ticks to *recent* ticks, and the load gate confines it to the
+oversubscribed band the hard guard leaves open.
+
+## What to Tell Your User
+
+- **Fewer spurious reconnects on a busy laptop**: "When my machine got busy I used to mistake the
+  slowdown for the computer going to sleep, which kicked off a disruptive recovery — dropping the
+  conversation thread, going quiet, or disabling typing. I now recognize that pattern and stay calm,
+  so those multi-machine glitches should largely stop."
+- **Real sleeps still handled**: "If the machine genuinely sleeps, I still notice and recover
+  properly — nothing changes there."
+
+## Summary of New Capabilities
+
+| Capability | How to Use |
+|-----------|-----------|
+| Suppress false "wake" events from CPU starvation on a loaded host | automatic |
+| Tune or disable the new guard | `monitoring.sleepWake.recentDriftWindowMs` / `.recentDriftLoadFloor` (set window to 0 to disable) |
+
+## Evidence
+
+Reproduction (live, 2026-06-15): on a host measured at loadavg ~18 on 16 cores (~1.13/core — above
+1.0 but below the 1.5 hard guard), `server.log` showed `[SleepWakeDetector] Wake detected after
+~33s/~21s sleep` recurring roughly every 2 minutes while the host was actively in use (not sleeping),
+each triggering the wake-recovery cascade. The drifts were isolated (on-time ticks between them reset
+the consecutive counter) and ~2 min apart (outlasting the 60s cooldown), so neither existing guard
+caught them.
+
+After the fix (verified by 45/45 sleep-wake unit tests across 5 files, both sides of the boundary): a
+recurring short drift in the 1.0–1.5 band is suppressed (no `wake` emitted, recorded as
+`cpu-starvation`); a genuinely isolated short drift, any drift on a light/idle host (ratio ≤ 1.0),
+and every long (real) sleep still emit; `recentDriftWindowMs: 0` restores byte-identical prior
+behavior. tsc clean.

package/upgrades/side-effects/sleepwake-recurring-drift-guard.md

@@ -0,0 +1,46 @@
+# Side-effects — SleepWakeDetector recurring-drift guard (gap #3 / CMT-1563)
+
+## What changed (3 files)
+
+- `src/core/SleepWakeDetector.ts` — new config `recentDriftWindowMs` (default 300000) +
+  `recentDriftLoadFloor` (default 1.0); new state `lastShortDriftAtMs`; a new suppression branch
+  in `start()` (after the load guard, before the cooldown) that suppresses a SHORT drift recurring
+  within the window while `loadRatio > recentDriftLoadFloor`. Reuses the existing `cpu-starvation`
+  suppression reason — the stats/telemetry type is unchanged.
+- `src/core/types.ts` — `config.monitoring.sleepWake` gains the two optional knobs (mirrors the
+  existing `maxLoadRatio` plumbing; no ConfigDefaults change, no migration).
+- `src/commands/server.ts` — the production `new SleepWakeDetector({...})` boot site forwards the
+  two new knobs from `config.monitoring.sleepWake`.
+
+## Behavioral side-effects
+
+- **On a moderately-loaded host (loadRatio in the 1.0–1.5 band):** a short timer drift that recurs
+  within 5 min of a prior short drift no longer emits a `wake` — so it no longer triggers the
+  wake-recovery cascade (tunnel restart / Slack reconnect / mesh-lease churn / topic failover). This
+  is the fix for the 2026-06-15 multi-machine UX cascade.
+- **No change** on a light/idle host (ratio ≤ 1.0): repeated short drifts still emit (the existing
+  "genuinely-isolated drifts both emit" behavior is preserved — verified by the unchanged tests).
+- **No change** for long sleeps (≥ `longSleepFloorSeconds`): always emitted, recovery preserved.
+- **No change** for an isolated short drift (no prior drift in the window): still emits.
+- The wake-reaper's cumulative-sleep accounting is unaffected — suppressed drifts were already
+  excluded from `wakeHistory`, and this branch suppresses the same way.
+
+## Risk + rollback
+
+- HIGH-risk surface (session-lifecycle / recovery trigger). Fail-safe direction: the branch only
+  ADDS suppression to a SHORT drift on an OVERSUBSCRIBED host; it can never suppress a real long
+  sleep or change light-host behavior.
+- Rollback lever: `config.monitoring.sleepWake.recentDriftWindowMs: 0` disables the guard with no
+  logic redeploy (restores exactly today's behavior).
+
+## Tests
+
+- `tests/unit/sleep-wake-starvation-guard.test.ts` — new `describe('recurring-drift guard for the
+  moderate-load band')` with 5 cases (band-suppress, light-host-emit, isolated-emit, disable-lever,
+  long-sleep-exempt). Full sleep-wake unit suite: 39/39 green. tsc clean on the touched files.
+
+## Migration parity
+
+The fix ships in the class default, so every agent gets it on update (the boot site reads optional
+config but the default is in the constructor). No `.claude`/hook/skill/CLAUDE.md template change is
+required — this is an internal monitoring guard, not an agent-facing capability or route.

package/upgrades/side-effects/ws2-send-3-preferences.md

@@ -0,0 +1,50 @@
+# Side-Effects Review — WS2-SEND-3: preferences send-side replication (emit seam authored)
+
+**Version / slug:** `ws2-send-3-preferences`
+**Date:** `2026-06-15`
+**Author:** `Instar Agent (echo)`
+**Second-pass reviewer:** `not required` (no block/allow/lifecycle authority — additive, dark-gated data-replication wiring; see §4)
+
+## Summary of the change
+
+Completes WS2 send-side emission — the LAST of the 7 replicated stores. `preferences` had NO emit seam (it rode the deprecated `preferences-sync` mesh verb), so this AUTHORS one:
+
+- `src/core/PreferencesManager.ts`: a new `PreferenceReplicationEmitter` interface + private `replication` field + `setReplicationEmitter()` (mirroring RelationshipManager), and a best-effort `this.replication?.emitPut(result)` fired at the end of `recordPreference` (after the durable write). PUT-ONLY: `recordPreference` is the sole writer and upserts on `dedupeKey`; there is no delete path.
+- The sole `recordPreference` writer is the correction-loop's per-request PreferencesManager in `routes.ts` (16739). The journal emitter is plumbed to it through the EXISTING RouteContext replication-field channel: `replicatedRecordEmitter` added to `RouteContext` (routes.ts) + `AgentServerOptions` + the AgentServer→ctx forward + the server.ts AgentServer construction; routes.ts attaches it to `prefs` right after construction.
+- `src/core/ws2SendWiring.ts`: `preferences` PENDING→WIRED; `WS2_SEND_PENDING_STORES` is now EMPTY (all 7 stores wired).
+
+The union reader + projection already shipped (WS2.1). New e2e round-trip.
+
+## Decision-point inventory
+
+- `ReplicatedRecordEmitter.emit` dark gate (`stateSync.preferences.enabled`) — **pass-through** — pre-existing; `preferences` becomes a registered emit target. Default false ⇒ no-op.
+- `PreferencesManager.recordPreference` emit funnel — **NEW (additive)** — the authored seam fires emitPut after the durable write, best-effort (try/catch). When no emitter is attached (default) it is a strict no-op — byte-identical single-machine behavior.
+- `RouteContext.replicatedRecordEmitter` plumb — **NEW field (additive)** — null while dark; mirrors the existing preferenceReplicaStore plumbing.
+- `ws2SendWiring` ratchet — **modify** — `preferences` reclassified PENDING→WIRED; PENDING now empty.
+
+---
+
+## 1. Over-block
+No block/allow surface. The emitter never rejects a preference write; null projection / over-cap is a counted no-op and the local write always succeeds.
+
+## 2. Under-block
+Not applicable (no block surface). PUT-ONLY is correct + complete: `recordPreference` only upserts (keyed on dedupeKey, bumping a counter + refreshing the learning), so a put carries the latest state and there is no delete event to wire — there is no tombstone by construction. The authored seam fires on the SOLE write path (the correction loop), so capture is complete (unlike userRegistry, preferences has exactly one writer).
+
+## 3. Level-of-abstraction fit
+Correct layer. The seam lives on the manager (mirroring every other store's seam); the attach happens at the single write site via the existing RouteContext replication-field channel. No new abstraction.
+
+## 4. Signal vs authority compliance
+Compliant. No blocking authority. The authored seam is additive/best-effort: a builder/journal fault is swallowed + counted, never propagated, so a preference write can never fail because replication did (the durable write already completed before the emit). The union read is advisory HIGH-tier (a replicated preference is a HINT, never authoritative). Per `docs/signal-vs-authority.md`.
+
+## 5. Interactions
+- Uses the single `replicatedRecordEmitter`, plumbed to routes via the new RouteContext field. Distinct store key/kind from the other WS2 stores. No double-fire (recordPreference is the single funnel; an upsert re-emits the latest, which is the intended status-refresh behavior).
+- Touches `server.ts` + `ws2SendWiring.ts` (shared WS2-SEND files) + PreferencesManager.ts + routes.ts + AgentServer.ts → serialized on top of merged userRegistry; no parallel WS2-SEND PRs.
+
+## 6. External surfaces
+Dark by default (`multiMachine.stateSync.preferences`). Off ⇒ byte-identical single-machine behavior (the authored seam is a no-op without an attached emitter). On (multi-machine, opt-in): crosses the dedupeKey-keyed projection (learning text — credential-scrubbed, confidence, dedupeCount, provenance, recordedAt); the `violationPattern` is NEVER included (local-only). A received record is quoted `<replicated-untrusted-data>`, advisory only.
+
+## 7. Multi-machine posture (Cross-Machine Coherence)
+**Replicated (put-only).** Path: `recordPreference → (authored seam) emitPut → ReplicatedRecordEmitter.emit → CoherenceJournal.emitReplicatedRecord → peer serve/apply → ReplicatedPeerStreamReader → preferencesUnionReader`. Identity = dedupeKey (the same learned preference on two machines collapses to one record). An upsert re-emits the latest (HLC-ordered). No delete path. Verified end-to-end by the new e2e (put round-trip + upsert re-replicates refreshed learning + bumped confidence).
+
+## 8. Rollback cost
+Trivial. Dark by default. Back-out = revert the change or set the flag false (instant, no migration). The authored seam is inert without an attached emitter, so reverting only the server.ts/routes plumbing (leaving the manager seam) is also safe. Receive-side + envelope schema already shipped, unaffected.