instar 1.3.413 → 1.3.414

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "1.3.413",
+  "version": "1.3.414",
   "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-07T22:15:02.666Z",
-  "instarVersion": "1.3.413",
+  "generatedAt": "2026-06-07T22:18:32.589Z",
+  "instarVersion": "1.3.414",
   "entryCount": 199,
   "entries": {
     "hook:session-start": {
@@ -11,7 +11,7 @@
       "domain": "identity",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/session-start.sh",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:dangerous-command-guard": {
@@ -20,7 +20,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/dangerous-command-guard.sh",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:grounding-before-messaging": {
@@ -29,7 +29,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/grounding-before-messaging.sh",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:compaction-recovery": {
@@ -38,7 +38,7 @@
       "domain": "identity",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/compaction-recovery.sh",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:external-operation-gate": {
@@ -47,7 +47,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/external-operation-gate.js",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:deferral-detector": {
@@ -56,7 +56,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/deferral-detector.js",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:self-stop-guard": {
@@ -65,7 +65,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/self-stop-guard.js",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:post-action-reflection": {
@@ -74,7 +74,7 @@
       "domain": "evolution",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/post-action-reflection.js",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:external-communication-guard": {
@@ -83,7 +83,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/external-communication-guard.js",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:scope-coherence-collector": {
@@ -92,7 +92,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/scope-coherence-collector.js",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:scope-coherence-checkpoint": {
@@ -101,7 +101,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/scope-coherence-checkpoint.js",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:free-text-guard": {
@@ -110,7 +110,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/free-text-guard.sh",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:claim-intercept": {
@@ -119,7 +119,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/claim-intercept.js",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:claim-intercept-response": {
@@ -128,7 +128,7 @@
       "domain": "coherence",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/claim-intercept-response.js",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:stop-gate-router": {
@@ -137,7 +137,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/stop-gate-router.js",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "hook:auto-approve-permissions": {
@@ -146,7 +146,7 @@
       "domain": "safety",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
       "installedPath": ".instar/hooks/instar/auto-approve-permissions.js",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "job:health-check": {
@@ -1538,7 +1538,7 @@
       "type": "subsystem",
       "domain": "updates",
       "sourcePath": "src/core/PostUpdateMigrator.ts",
-      "contentHash": "91751f5d379223d5219959314caaeff35e6534ade7acf5193b5768bc1fc79198",
+      "contentHash": "b086e0a128b4785908844ebb86e015403fa5bbc4063b30f46f3dffd8333695bb",
       "since": "2025-01-01"
     },
     "subsystem:scheduler": {

package/upgrades/{1.3.413.md → 1.3.414.md}

@@ -15,12 +15,22 @@ degradation and brings the session ready anyway, so the pool serves real prompts
 empty-prompt detection runs best-effort for that lifetime. This makes the structured-fail
 path consistent with the adjacent canary-infra-error path, which was already non-fatal.
 
+instar now manages Claude Code's transcript retention (`cleanupPeriodDays`), setting it to
+14 days for new agents (init) and existing agents (migration, set-if-unset). Claude writes a
+transcript per session — including every fleet background `claude -p` one-shot — and the
+unset default of 30 days let them accumulate (observed ~322k files / 18 GB on one box). This
+caps the pile-up fleet-wide.
+
 ## What to Tell Your User
 
 If the cheaper subscription path went dark and everything fell back to metered credits
 (with repeated "pausing all LLM work" circuit trips) during a busy period: a failed pool
 self-test no longer takes the whole pool down. Nothing for them to do.
 
+Nothing required — internal disk hygiene. Chat transcripts older than 14 days are pruned by
+Claude automatically; recent ones (and the ability to resume them) are unaffected. If you set
+your own retention period, it is left as-is.
+
 ## Summary of New Capabilities
 
 - `InteractivePool.spawnOne` treats a startup empty-prompt canary `status: 'fail'` as
@@ -28,6 +38,8 @@ self-test no longer takes the whole pool down. Nothing for them to do.
   ready (no throw, no session kill). A genuinely broken session is still caught by the
   existing per-call retire/replace path.
 
+- `.claude/settings.json` `cleanupPeriodDays` is now instar-managed (default 14; set-if-unset).
+
 ## Evidence
 
 `pool-canary-graceful.test.ts`: source guards that the canary-fail branch no longer
@@ -39,6 +51,9 @@ structured-fail branch was fatal from the start while the adjacent infra-error b
 was non-fatal; surfaced as a circuit-tripping outage only once a busy box made the canary
 round-trip slow enough to "fail."
 
+`tests/unit/PostUpdateMigrator-cleanupPeriodDays.test.ts` 4/4; adjacent migrateSettings suites
+27/27; `tsc` clean.
+
 ## Scope (honest)
 
 Contained Tier-1 change to one conditional in one file
@@ -46,3 +61,6 @@ Contained Tier-1 change to one conditional in one file
 (subscription-path). Normal (canary-passes) operation is unchanged. No new API/route/
 config/migration. Note: Justin already stabilized this live during the incident; this is
 the durable code fix so it can't recur.
+
+Pure disk/file-count hygiene, NOT a CPU fix — transcripts were already Spotlight-excluded.
+Tunable per-agent; reversible.

package/upgrades/side-effects/transcript-cleanup-period.md

@@ -0,0 +1,31 @@
+# Side effects — transcript cleanup-period (cleanupPeriodDays)
+
+## Change
+
+Sets `cleanupPeriodDays: 14` in `.claude/settings.json` — for new agents (init.ts) and
+existing agents (`PostUpdateMigrator.migrateSettings()`, set-if-unset).
+
+## Behavioral surface
+
+- **New behavior**: Claude Code now prunes chat transcripts under `~/.claude/projects`
+  older than 14 days (was the unset default of 30). Caps the per-fleet transcript pile-up.
+- **What does NOT change**: nothing about runtime sessions, hooks, MCP, or the server. This
+  is a Claude Code client setting only. Recent transcripts (≤14d) are untouched, so active
+  and recently-idle sessions keep full `--resume` support.
+
+## Migration / compatibility
+
+- Migration is **set-if-unset** (`settings.cleanupPeriodDays === undefined`) — an operator's
+  explicit value (including `0` = no cleanup) is never overwritten. Idempotent.
+- No config-schema change, no API, no state. Reversible by editing settings.json.
+
+## Risk
+
+Low. Worst case: a conversation left idle 14–30 days loses its Claude `--resume` transcript;
+instar's CONTINUATION mechanism reconstructs context across such gaps, so the conversation
+still resumes. Tunable up per-agent if any agent needs longer retention.
+
+## Tests
+
+`tests/unit/PostUpdateMigrator-cleanupPeriodDays.test.ts` (4/4): set-when-absent, no-override-7,
+respect-explicit-0, idempotent. Adjacent migrateSettings suites green (27/27). `tsc` clean.