instar 1.3.775 → 1.3.776

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.775",
+  "version": "1.3.776",
   "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-07-05T09:42:32.432Z",
-  "instarVersion": "1.3.775",
+  "generatedAt": "2026-07-05T10:48:04.777Z",
+  "instarVersion": "1.3.776",
   "entryCount": 202,
   "entries": {
     "hook:session-start": {
@@ -418,7 +418,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:agents": {
@@ -426,7 +426,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:backups": {
@@ -434,7 +434,7 @@
       "type": "route-group",
       "domain": "operations",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:git": {
@@ -442,7 +442,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:memory": {
@@ -450,7 +450,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:semantic": {
@@ -458,7 +458,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:status": {
@@ -466,7 +466,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:capabilities": {
@@ -474,7 +474,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:project-map": {
@@ -482,7 +482,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:coherence": {
@@ -490,7 +490,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:topic-bindings": {
@@ -498,7 +498,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:context": {
@@ -506,7 +506,7 @@
       "type": "route-group",
       "domain": "context",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:scope-coherence": {
@@ -514,7 +514,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:canonical-state": {
@@ -522,7 +522,7 @@
       "type": "route-group",
       "domain": "state",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:ci": {
@@ -530,7 +530,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:sessions": {
@@ -538,7 +538,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:jobs": {
@@ -546,7 +546,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:skip-ledger": {
@@ -554,7 +554,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:telegram": {
@@ -562,7 +562,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:attention": {
@@ -570,7 +570,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:relationships": {
@@ -578,7 +578,7 @@
       "type": "route-group",
       "domain": "relationships",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:feedback": {
@@ -586,7 +586,7 @@
       "type": "route-group",
       "domain": "feedback",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:updates": {
@@ -594,7 +594,7 @@
       "type": "route-group",
       "domain": "updates",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:dispatches": {
@@ -602,7 +602,7 @@
       "type": "route-group",
       "domain": "dispatches",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:quota": {
@@ -610,7 +610,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:publishing": {
@@ -618,7 +618,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:private-views": {
@@ -626,7 +626,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:tunnel": {
@@ -634,7 +634,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:events": {
@@ -642,7 +642,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:evolution": {
@@ -650,7 +650,7 @@
       "type": "route-group",
       "domain": "evolution",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:watchdog": {
@@ -658,7 +658,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:topic-memory": {
@@ -666,7 +666,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:state-sync": {
@@ -674,7 +674,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:intent": {
@@ -682,7 +682,7 @@
       "type": "route-group",
       "domain": "intent",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:triage": {
@@ -690,7 +690,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:operations": {
@@ -698,7 +698,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:sentinel": {
@@ -706,7 +706,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:trust": {
@@ -714,7 +714,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:monitoring": {
@@ -722,7 +722,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:commitments": {
@@ -730,7 +730,7 @@
       "type": "route-group",
       "domain": "commitments",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:episodes": {
@@ -738,7 +738,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:messages": {
@@ -746,7 +746,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:system-reviews": {
@@ -754,7 +754,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "route-group:machine-mesh": {
@@ -770,7 +770,7 @@
       "type": "route-group",
       "domain": "security",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "ed2dedc8e041d28e3fa14d73c7756e8cc877c061b436b539987eadec9c27ce0c",
+      "contentHash": "c1f6435b5397d5e34abba67698ba1f52f95c05bf15ab21ea82c02cbb1349fac3",
       "since": "2025-01-01"
     },
     "cli:init": {
@@ -1530,7 +1530,7 @@
       "type": "subsystem",
       "domain": "server",
       "sourcePath": "src/server/AgentServer.ts",
-      "contentHash": "6ea126c1d402104b6fb6b892179326ba177cf96ad655ac7bea69ce7fd2767d48",
+      "contentHash": "66078aa3bc4caae43f36bc7a65667045e00bf3ce9519dde983c6d58e91ae0c66",
       "since": "2025-01-01"
     },
     "subsystem:session-manager": {

package/upgrades/1.3.776.md

@@ -0,0 +1,44 @@
+# Upgrade Guide — vNEXT
+
+<!-- assembled-by: assemble-next-md -->
+<!-- bump: patch -->
+
+## What Changed
+
+Adds a lease-gated background loop that ANTICIPATES which of an agent's working-set files a conversation
+will need next and PROPOSES a bounded, side-effect-free preload — so on a multi-machine setup the right
+files are already warm when a conversation moves, instead of being fetched on-demand. It is deliberately
+**propose-only**: the LLM never moves a conversation itself (placement stays with the existing deterministic
+planner); it only ranks preload candidates and, when a cheap deterministic ranking already has a clear
+winner, it doesn't spend an LLM call at all. It ships **dark** on the fleet (a dev-agent gate resolves it
+off) and **dry-run-first** even on a development agent — the loop logs what it WOULD preload and actuates
+nothing until an operator flips it live, one increment at a time.
+
+## What to Tell Your User
+
+⚗️ Experimental and off by default — nothing changes until you turn it on, and even then it starts in a
+dry-run mode where it only observes and never acts. When eventually enabled on a multi-machine setup, it
+quietly pre-warms the files a conversation is likely to need next so a move between your machines feels
+seamless. It can never move a conversation on its own — that decision stays with the deterministic system
+you already have — and it runs on only one machine at a time, backs off under load, caps itself hard
+(at most a few suggestions per cycle, a long cooldown per conversation, and it blacklists anything that
+starts thrashing), and has a strict spending cap on the AI calls. On a single-machine setup it does nothing.
+
+## Summary of New Capabilities
+
+- New `SeamlessOrchestratorEngine` (pure, lease-gated, deterministic-first ranking with the LLM as an
+  A/B-lift-gated residual on a low-priority queue lane) + `OrchestratorActuator` (guarded, propose-only,
+  audit-before-actuate, dry-run actuates nothing) + `OrchestratorPoller` (15-min cadence, idle-backoff,
+  error-breaker) + `OscillationBreaker` (blacklists a thrashing conversation).
+- `POST /intelligence/seamless-orchestrator/tick` (a manual soak tick) + `GET /intelligence/seamless-orchestrator/audit`
+  (the audit tail + last-tick surface); both 503 when the feature is dark.
+- `multiMachine.seamlessOrchestrator` config block (dry-run-first; the dev-agent gate resolves `enabled`),
+  delivered to existing agents on update via config-defaults deep-merge.
+
+## Evidence
+
+- 36 tests green (engine, actuator, poller, oscillation-breaker unit tests + the HTTP route integration test).
+- `tsc --noEmit` clean; all four constitutional-enforcement ratchets green locally (dark-gate, write-domain,
+  no-silent-fallbacks, compaction-parity).
+- Dark-ship verified: the dev-agent gate resolves the feature off on the fleet (never constructed); the
+  dry-run default actuates nothing even on a development agent. The four live-flip prerequisites are tracked.