@svenroth-ai/shipwright 0.25.0 → 0.27.0

package/server/dist/config/default-actions.json

@@ -1,90 +1,90 @@
-{
-  "schemaVersion": 1,
-  "defaults": {
-    "autonomy": "guided"
-  },
-  "actions": [
-    {
-      "id": "new-task",
-      "label": "New task",
-      "kind": "external_launch",
-      "description": "Plain Claude invocation scoped to a Shipwright phase. Fire-and-forget — no pipeline state.",
-      "command_template": "{cd.prefix}claude --session-id {task.uuid} --name {task.session_name} {plugin.dirs} {task.initial_prompt}",
-      "modal_fields": ["title", "phase", "description", "domain", "priority", "complexityHint", "tags", "blockedBy"],
-      "phase_parameters": {
-        "adopt": [
-          { "name": "dry-run", "type": "boolean", "label": "Dry run", "cli_flag": "--dry-run", "helpText": "Simulate adoption without commits" },
-          { "name": "scope", "type": "enum", "label": "Scope", "enum": ["full_app", "library", "cli"], "cli_flag": "--scope", "value_separator": "space" },
-          { "name": "include-nested", "type": "boolean", "label": "Include nested projects", "cli_flag": "--include-nested" },
-          { "name": "skip-crawl", "type": "boolean", "label": "Skip Playwright crawl", "cli_flag": "--skip-crawl" },
-          { "name": "crawl-base-url", "type": "string", "label": "Crawl base URL", "cli_flag": "--crawl-base-url", "value_separator": "space", "placeholder": "e.g. http://localhost:3000" },
-          { "name": "crawl-auth-token", "type": "string", "label": "Crawl auth token", "cli_flag": "--crawl-auth-token", "value_separator": "space", "sensitive": true },
-          { "name": "crawl-max-depth", "type": "string", "label": "Crawl max depth", "cli_flag": "--crawl-max-depth", "value_separator": "space", "pattern": "^[1-9][0-9]?$", "default": "3" },
-          { "name": "crawl-max-pages", "type": "string", "label": "Crawl max pages", "cli_flag": "--crawl-max-pages", "value_separator": "space", "pattern": "^[1-9][0-9]{0,3}$", "default": "50" },
-          { "name": "no-backfill-events", "type": "boolean", "label": "Skip event backfill", "cli_flag": "--no-backfill-events" },
-          { "name": "no-sync", "type": "boolean", "label": "Skip writing sync config", "cli_flag": "--no-sync" },
-          { "name": "planning-split", "type": "string", "label": "Planning split name", "cli_flag": "--planning-split", "value_separator": "space", "default": "01-adopted", "pattern": "^[A-Za-z0-9_-]+$" }
-        ],
-        "build": [
-          { "name": "section", "type": "string", "label": "Section file (relative to project)", "cli_flag": "@", "value_separator": "none", "pattern": "^[A-Za-z0-9_./-]+\\.md$", "placeholder": "e.g. planning/03-build-feature.md", "required": true, "helpText": "Path relative to your project root — e.g. planning/03-build-feature.md. /shipwright-plan creates these files; pick one to build now." },
-          { "name": "from", "type": "string", "label": "Start from section number", "cli_flag": "--from", "value_separator": "space", "pattern": "^[0-9]+$", "placeholder": "e.g. 03", "helpText": "Resume autonomous build from this section number" }
-        ],
-        "test": [
-          { "name": "fix", "type": "boolean", "label": "Auto-fix failing tests", "cli_flag": "--fix" },
-          { "name": "e2e-only", "type": "boolean", "label": "E2E tests only", "cli_flag": "--e2e-only" },
-          { "name": "design-fidelity", "type": "boolean", "label": "Design-fidelity check only", "cli_flag": "--design-fidelity" }
-        ],
-        "deploy": [
-          { "name": "target", "type": "enum", "label": "Target", "enum": ["dev", "prod", "rollback"], "cli_flag_map": { "prod": "--prod", "rollback": "--rollback" }, "default": "dev", "helpText": "Dev is default — no CLI flag emitted." }
-        ],
-        "changelog": [
-          { "name": "from", "type": "string", "label": "From git tag", "cli_flag": "--from", "value_separator": "space", "pattern": "^[A-Za-z0-9._/-]+$", "placeholder": "e.g. v0.3.1" }
-        ]
-      }
-    },
-    {
-      "id": "new-pipeline",
-      "label": "New pipeline",
-      "kind": "external_launch",
-      "description": "Full Shipwright pipeline — project → design → plan → build → test → deploy → changelog.",
-      "command_template": "{cd.prefix}claude --session-id {task.uuid} --name {task.session_name} {plugin.dirs} {task.initial_prompt}",
-      "modal_fields": ["title", "autonomy", "description"]
-    },
-    {
-      "id": "new-iterate",
-      "label": "New iterate",
-      "kind": "external_launch",
-      "description": "Run the complexity-adaptive iterate skill against an existing project.",
-      "command_template": "{cd.prefix}claude --session-id {task.uuid} --name {task.session_name} {plugin.dirs} {task.initial_prompt}",
-      "modal_fields": ["title", "autonomy", "description", "domain", "priority", "complexityHint", "tags", "blockedBy"],
-      "parameters": [
-        { "name": "type", "type": "enum", "label": "Change type", "enum": ["feature", "change", "bug"], "cli_flag": "--type", "value_separator": "space", "helpText": "Auto-detected if omitted" },
-        { "name": "plan-review-model", "type": "enum", "label": "Plan review", "enum": ["opus", "sonnet", "haiku", "inherit"], "cli_flag": "--plan-review-model", "value_separator": "space" },
-        { "name": "review-model", "type": "enum", "label": "Review", "enum": ["opus", "sonnet", "haiku", "inherit"], "cli_flag": "--review-model", "value_separator": "space" }
-      ]
-    },
-    {
-      "id": "new-plain",
-      "label": "Plain Claude",
-      "kind": "external_launch",
-      "description": "Plain Claude session in this project's directory. No Shipwright skill — just chat.",
-      "command_template": "{cd.prefix}claude --session-id {task.uuid} --name {task.session_name} {plugin.dirs}{task.description?}",
-      "modal_fields": ["title", "description"]
-    }
-  ],
-  "phases": [
-    { "id": "adopt",      "label": "Adopt",      "color": "#64748B" },
-    { "id": "project",    "label": "Project",    "color": "#9ca3af" },
-    { "id": "design",     "label": "Design",     "color": "#A855F7" },
-    { "id": "plan",       "label": "Plan",       "color": "#3B82F6" },
-    { "id": "build",      "label": "Build",      "color": "#F59E0B", "supports_autonomy": true },
-    { "id": "test",       "label": "Test",       "color": "#059669", "supports_autonomy": true },
-    { "id": "deploy",     "label": "Deploy",     "color": "#14B8A6" },
-    { "id": "changelog",  "label": "Changelog",  "color": "#6366F1" },
-    { "id": "compliance", "label": "Compliance", "color": "#0EA5E9" },
-    { "id": "security",   "label": "Security",   "color": "#DC2626", "supports_autonomy": true }
-  ],
-  "preview": {
-    "enabled": "auto"
-  }
-}
+{
+  "schemaVersion": 1,
+  "defaults": {
+    "autonomy": "guided"
+  },
+  "actions": [
+    {
+      "id": "new-task",
+      "label": "New task",
+      "kind": "external_launch",
+      "description": "Plain Claude invocation scoped to a Shipwright phase. Fire-and-forget — no pipeline state.",
+      "command_template": "{cd.prefix}claude --session-id {task.uuid} --name {task.session_name} {plugin.dirs} {task.initial_prompt}",
+      "modal_fields": ["title", "phase", "description", "domain", "priority", "complexityHint", "tags", "blockedBy"],
+      "phase_parameters": {
+        "adopt": [
+          { "name": "dry-run", "type": "boolean", "label": "Dry run", "cli_flag": "--dry-run", "helpText": "Simulate adoption without commits" },
+          { "name": "scope", "type": "enum", "label": "Scope", "enum": ["full_app", "library", "cli"], "cli_flag": "--scope", "value_separator": "space" },
+          { "name": "include-nested", "type": "boolean", "label": "Include nested projects", "cli_flag": "--include-nested" },
+          { "name": "skip-crawl", "type": "boolean", "label": "Skip Playwright crawl", "cli_flag": "--skip-crawl" },
+          { "name": "crawl-base-url", "type": "string", "label": "Crawl base URL", "cli_flag": "--crawl-base-url", "value_separator": "space", "placeholder": "e.g. http://localhost:3000" },
+          { "name": "crawl-auth-token", "type": "string", "label": "Crawl auth token", "cli_flag": "--crawl-auth-token", "value_separator": "space", "sensitive": true },
+          { "name": "crawl-max-depth", "type": "string", "label": "Crawl max depth", "cli_flag": "--crawl-max-depth", "value_separator": "space", "pattern": "^[1-9][0-9]?$", "default": "3" },
+          { "name": "crawl-max-pages", "type": "string", "label": "Crawl max pages", "cli_flag": "--crawl-max-pages", "value_separator": "space", "pattern": "^[1-9][0-9]{0,3}$", "default": "50" },
+          { "name": "no-backfill-events", "type": "boolean", "label": "Skip event backfill", "cli_flag": "--no-backfill-events" },
+          { "name": "no-sync", "type": "boolean", "label": "Skip writing sync config", "cli_flag": "--no-sync" },
+          { "name": "planning-split", "type": "string", "label": "Planning split name", "cli_flag": "--planning-split", "value_separator": "space", "default": "01-adopted", "pattern": "^[A-Za-z0-9_-]+$" }
+        ],
+        "build": [
+          { "name": "section", "type": "string", "label": "Section file (relative to project)", "cli_flag": "@", "value_separator": "none", "pattern": "^[A-Za-z0-9_./-]+\\.md$", "placeholder": "e.g. planning/03-build-feature.md", "required": true, "helpText": "Path relative to your project root — e.g. planning/03-build-feature.md. /shipwright-plan creates these files; pick one to build now." },
+          { "name": "from", "type": "string", "label": "Start from section number", "cli_flag": "--from", "value_separator": "space", "pattern": "^[0-9]+$", "placeholder": "e.g. 03", "helpText": "Resume autonomous build from this section number" }
+        ],
+        "test": [
+          { "name": "fix", "type": "boolean", "label": "Auto-fix failing tests", "cli_flag": "--fix" },
+          { "name": "e2e-only", "type": "boolean", "label": "E2E tests only", "cli_flag": "--e2e-only" },
+          { "name": "design-fidelity", "type": "boolean", "label": "Design-fidelity check only", "cli_flag": "--design-fidelity" }
+        ],
+        "deploy": [
+          { "name": "target", "type": "enum", "label": "Target", "enum": ["dev", "prod", "rollback"], "cli_flag_map": { "prod": "--prod", "rollback": "--rollback" }, "default": "dev", "helpText": "Dev is default — no CLI flag emitted." }
+        ],
+        "changelog": [
+          { "name": "from", "type": "string", "label": "From git tag", "cli_flag": "--from", "value_separator": "space", "pattern": "^[A-Za-z0-9._/-]+$", "placeholder": "e.g. v0.3.1" }
+        ]
+      }
+    },
+    {
+      "id": "new-pipeline",
+      "label": "New pipeline",
+      "kind": "external_launch",
+      "description": "Full Shipwright pipeline — project → design → plan → build → test → deploy → changelog.",
+      "command_template": "{cd.prefix}claude --session-id {task.uuid} --name {task.session_name} {plugin.dirs} {task.initial_prompt}",
+      "modal_fields": ["title", "autonomy", "description"]
+    },
+    {
+      "id": "new-iterate",
+      "label": "New iterate",
+      "kind": "external_launch",
+      "description": "Run the complexity-adaptive iterate skill against an existing project.",
+      "command_template": "{cd.prefix}claude --session-id {task.uuid} --name {task.session_name} {plugin.dirs} {task.initial_prompt}",
+      "modal_fields": ["title", "autonomy", "description", "domain", "priority", "complexityHint", "tags", "blockedBy"],
+      "parameters": [
+        { "name": "type", "type": "enum", "label": "Change type", "enum": ["feature", "change", "bug"], "cli_flag": "--type", "value_separator": "space", "helpText": "Auto-detected if omitted" },
+        { "name": "plan-review-model", "type": "enum", "label": "Plan review", "enum": ["opus", "sonnet", "haiku", "inherit"], "cli_flag": "--plan-review-model", "value_separator": "space" },
+        { "name": "review-model", "type": "enum", "label": "Review", "enum": ["opus", "sonnet", "haiku", "inherit"], "cli_flag": "--review-model", "value_separator": "space" }
+      ]
+    },
+    {
+      "id": "new-plain",
+      "label": "Plain Claude",
+      "kind": "external_launch",
+      "description": "Plain Claude session in this project's directory. No Shipwright skill — just chat.",
+      "command_template": "{cd.prefix}claude --session-id {task.uuid} --name {task.session_name} {plugin.dirs}{task.description?}",
+      "modal_fields": ["title", "description"]
+    }
+  ],
+  "phases": [
+    { "id": "adopt",      "label": "Adopt",      "color": "#64748B" },
+    { "id": "project",    "label": "Project",    "color": "#9ca3af" },
+    { "id": "design",     "label": "Design",     "color": "#A855F7" },
+    { "id": "plan",       "label": "Plan",       "color": "#3B82F6" },
+    { "id": "build",      "label": "Build",      "color": "#F59E0B", "supports_autonomy": true },
+    { "id": "test",       "label": "Test",       "color": "#059669", "supports_autonomy": true },
+    { "id": "deploy",     "label": "Deploy",     "color": "#14B8A6" },
+    { "id": "changelog",  "label": "Changelog",  "color": "#6366F1" },
+    { "id": "compliance", "label": "Compliance", "color": "#0EA5E9" },
+    { "id": "security",   "label": "Security",   "color": "#DC2626", "supports_autonomy": true }
+  ],
+  "preview": {
+    "enabled": "auto"
+  }
+}

package/server/dist/core/mission-context/association.d.ts

@@ -24,4 +24,50 @@ export declare function setMissionContextOnce(store: Pick<SdkSessionsStore, "get
  * concurrent writer's value is never clobbered.
  */
 export declare function revertMissionContext(store: Pick<SdkSessionsStore, "get" | "patch">, taskId: string, attempted: MissionContextAssociation): void;
+/**
+ * Evidence-gated UPDATE of an association ALREADY on file — the one
+ * deliberate exception to the once-only doctrine above (external code
+ * review, openai HIGH, iterate-2026-08-31-mission-feed-gaps).
+ *
+ * Without this, scenario.ts rule 2b's supersession is provably decorative:
+ * the ONCE-only write above makes every corrected `associateRunId` it returns
+ * unreachable, so a long-lived task's stale association never durably
+ * corrects — and once the newer run's `Run-ID:` footer scrolls past this
+ * task's (narrower, associated-task) reach-back window, rule 2b's per-poll
+ * scan stops finding it too, and the Mission tab is stuck on the stale run
+ * for good. Persisting the correction closes both holes.
+ *
+ * Narrow on purpose — this is a correction, not a general-purpose write: the
+ * caller only ever offers a `transcript_run_id`-sourced association, and only
+ * after scenario.ts rule 2b has required a corroborated footer naming a
+ * PROVABLY newer run than the one on file (`isProvablyNewerRunId`). This
+ * function does not re-derive that recency itself — it trusts the one caller
+ * that computes it, the same posture `setMissionContextOnce` already takes
+ * toward its own caller's pointer validation.
+ *
+ * Compare-and-set against `expectedPrevious` (external code review, openai
+ * MEDIUM): without it, this is a blind overwrite of "whatever is currently
+ * stored", not of the specific stale association the resolver actually
+ * decided against. Two polls can race on the same stale association — poll
+ * A resolves against it and decides to supersede with run X, poll B resolves
+ * against the SAME stale read (a later poll interval, different transcript
+ * snapshot) and decides to supersede with run Y — and whichever write lands
+ * second would clobber the other's answer even though it is validating a read
+ * that is no longer current. Requiring the stored value to still equal what
+ * THIS caller read before writing turns that into a no-op instead: the loser
+ * skips its write and the next resolve operates on whatever is now current.
+ */
+export declare function supersedeMissionContext(store: Pick<SdkSessionsStore, "get" | "patch">, taskId: string, association: MissionContextAssociation, expectedPrevious: MissionContextAssociation): boolean;
+/**
+ * Roll back a supersession that was set in memory but FAILED to persist — the
+ * supersede counterpart to `revertMissionContext`. Restores the PREVIOUS
+ * association rather than clearing the field: unlike a first association,
+ * there was already a valid, durable value here, and losing it to a
+ * transient lock contention would be a second, worse regression stacked on
+ * top of the one this whole mechanism exists to fix.
+ *
+ * Only reverts when the field still holds the association WE just set, so a
+ * concurrent writer's value is never clobbered.
+ */
+export declare function revertSupersession(store: Pick<SdkSessionsStore, "get" | "patch">, taskId: string, attempted: MissionContextAssociation, previous: MissionContextAssociation): void;
 //# sourceMappingURL=association.d.ts.map

package/server/dist/core/mission-context/association.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"association.d.ts","sourceRoot":"","sources":["../../../src/core/mission-context/association.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAA+B,KAAK,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEzF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,GAAG,OAAO,CAAC,EAC9C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,yBAAyB,GACrC,OAAO,CAOT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,GAAG,OAAO,CAAC,EAC9C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,yBAAyB,GACnC,IAAI,CAMN"}
+{"version":3,"file":"association.d.ts","sourceRoot":"","sources":["../../../src/core/mission-context/association.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAA+B,KAAK,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEzF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,GAAG,OAAO,CAAC,EAC9C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,yBAAyB,GACrC,OAAO,CAOT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,GAAG,OAAO,CAAC,EAC9C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,yBAAyB,GACnC,IAAI,CAMN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,GAAG,OAAO,CAAC,EAC9C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,yBAAyB,EACtC,gBAAgB,EAAE,yBAAyB,GAC1C,OAAO,CAST;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,KAAK,GAAG,OAAO,CAAC,EAC9C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,yBAAyB,EACpC,QAAQ,EAAE,yBAAyB,GAClC,IAAI,CAMN"}

package/server/dist/core/mission-context/association.js

@@ -66,4 +66,73 @@ export function revertMissionContext(store, taskId, attempted) {
         return;
     store.patch(taskId, { missionContext: undefined });
 }
+/**
+ * Evidence-gated UPDATE of an association ALREADY on file — the one
+ * deliberate exception to the once-only doctrine above (external code
+ * review, openai HIGH, iterate-2026-08-31-mission-feed-gaps).
+ *
+ * Without this, scenario.ts rule 2b's supersession is provably decorative:
+ * the ONCE-only write above makes every corrected `associateRunId` it returns
+ * unreachable, so a long-lived task's stale association never durably
+ * corrects — and once the newer run's `Run-ID:` footer scrolls past this
+ * task's (narrower, associated-task) reach-back window, rule 2b's per-poll
+ * scan stops finding it too, and the Mission tab is stuck on the stale run
+ * for good. Persisting the correction closes both holes.
+ *
+ * Narrow on purpose — this is a correction, not a general-purpose write: the
+ * caller only ever offers a `transcript_run_id`-sourced association, and only
+ * after scenario.ts rule 2b has required a corroborated footer naming a
+ * PROVABLY newer run than the one on file (`isProvablyNewerRunId`). This
+ * function does not re-derive that recency itself — it trusts the one caller
+ * that computes it, the same posture `setMissionContextOnce` already takes
+ * toward its own caller's pointer validation.
+ *
+ * Compare-and-set against `expectedPrevious` (external code review, openai
+ * MEDIUM): without it, this is a blind overwrite of "whatever is currently
+ * stored", not of the specific stale association the resolver actually
+ * decided against. Two polls can race on the same stale association — poll
+ * A resolves against it and decides to supersede with run X, poll B resolves
+ * against the SAME stale read (a later poll interval, different transcript
+ * snapshot) and decides to supersede with run Y — and whichever write lands
+ * second would clobber the other's answer even though it is validating a read
+ * that is no longer current. Requiring the stored value to still equal what
+ * THIS caller read before writing turns that into a no-op instead: the loser
+ * skips its write and the next resolve operates on whatever is now current.
+ */
+export function supersedeMissionContext(store, taskId, association, expectedPrevious) {
+    const task = store.get(taskId);
+    if (!task?.missionContext)
+        return false;
+    if (task.missionContext.runId !== expectedPrevious.runId)
+        return false;
+    if (task.missionContext.observedAt !== expectedPrevious.observedAt)
+        return false;
+    if (association.source !== "transcript_run_id")
+        return false;
+    if (!isMissionContextAssociation(association))
+        return false;
+    store.patch(taskId, { missionContext: association });
+    return true;
+}
+/**
+ * Roll back a supersession that was set in memory but FAILED to persist — the
+ * supersede counterpart to `revertMissionContext`. Restores the PREVIOUS
+ * association rather than clearing the field: unlike a first association,
+ * there was already a valid, durable value here, and losing it to a
+ * transient lock contention would be a second, worse regression stacked on
+ * top of the one this whole mechanism exists to fix.
+ *
+ * Only reverts when the field still holds the association WE just set, so a
+ * concurrent writer's value is never clobbered.
+ */
+export function revertSupersession(store, taskId, attempted, previous) {
+    const task = store.get(taskId);
+    if (!task?.missionContext)
+        return;
+    if (task.missionContext.runId !== attempted.runId)
+        return;
+    if (task.missionContext.observedAt !== attempted.observedAt)
+        return;
+    store.patch(taskId, { missionContext: previous });
+}
 //# sourceMappingURL=association.js.map

package/server/dist/core/mission-context/association.js.map

@@ -1 +1 @@
-{"version":3,"file":"association.js","sourceRoot":"","sources":["../../../src/core/mission-context/association.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,2BAA2B,EAAkC,MAAM,YAAY,CAAC;AAEzF;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAA8C,EAC9C,MAAc,EACd,WAAsC;IAEtC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,IAAI,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC,2BAA2B,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAA8C,EAC9C,MAAc,EACd,SAAoC;IAEpC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,cAAc;QAAE,OAAO;IAClC,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK;QAAE,OAAO;IAC1D,IAAI,IAAI,CAAC,cAAc,CAAC,UAAU,KAAK,SAAS,CAAC,UAAU;QAAE,OAAO;IACpE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC;AACrD,CAAC"}
+{"version":3,"file":"association.js","sourceRoot":"","sources":["../../../src/core/mission-context/association.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,2BAA2B,EAAkC,MAAM,YAAY,CAAC;AAEzF;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAA8C,EAC9C,MAAc,EACd,WAAsC;IAEtC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,IAAI,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC,2BAA2B,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAA8C,EAC9C,MAAc,EACd,SAAoC;IAEpC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,cAAc;QAAE,OAAO;IAClC,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK;QAAE,OAAO;IAC1D,IAAI,IAAI,CAAC,cAAc,CAAC,UAAU,KAAK,SAAS,CAAC,UAAU;QAAE,OAAO;IACpE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAA8C,EAC9C,MAAc,EACd,WAAsC,EACtC,gBAA2C;IAE3C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,cAAc;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,KAAK,gBAAgB,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACvE,IAAI,IAAI,CAAC,cAAc,CAAC,UAAU,KAAK,gBAAgB,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IACjF,IAAI,WAAW,CAAC,MAAM,KAAK,mBAAmB;QAAE,OAAO,KAAK,CAAC;IAC7D,IAAI,CAAC,2BAA2B,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAA8C,EAC9C,MAAc,EACd,SAAoC,EACpC,QAAmC;IAEnC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,cAAc;QAAE,OAAO;IAClC,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK;QAAE,OAAO;IAC1D,IAAI,IAAI,CAAC,cAAc,CAAC,UAAU,KAAK,SAAS,CAAC,UAAU;QAAE,OAAO;IACpE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/server/dist/core/mission-context/resolver-iterate.d.ts

@@ -0,0 +1,6 @@
+import type { ReadPointerResult } from "./pointer.js";
+import type { ScenarioDecision } from "./scenario.js";
+import type { ResolveDeps, ResolveRequest, ResolveResult } from "./resolver-io.js";
+/** `decision.runId` resolved and non-null — caller has already checked. */
+export declare function resolveIterateContext(req: ResolveRequest, deps: ResolveDeps, decision: ScenarioDecision, runId: string, pointer: ReadPointerResult, baseRevPaths: string[]): Promise<ResolveResult>;
+//# sourceMappingURL=resolver-iterate.d.ts.map

package/server/dist/core/mission-context/resolver-iterate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver-iterate.d.ts","sourceRoot":"","sources":["../../../src/core/mission-context/resolver-iterate.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAanF,2EAA2E;AAC3E,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,iBAAiB,EAC1B,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,aAAa,CAAC,CA0MxB"}

package/server/dist/core/mission-context/resolver-iterate.js

@@ -0,0 +1,202 @@
+/*
+ * core/mission-context/resolver-iterate.ts — the ITERATE-scenario branch of
+ * `resolveMissionContext`, split out of resolver.ts (2026-08-31,
+ * iterate-2026-08-31-mission-feed-gaps) to stay under the 300-line file-size
+ * limit. Pure continuation of the same function body: `resolver.ts` handles
+ * scenario detection and the non-iterate early returns, then hands off here
+ * once `decision.scenario === "iterate"` with a resolved `runId`. Contract
+ * and architecture notes live in resolver.ts's header.
+ */
+import { cache, CACHE_CAP, computeSourceRev, docFingerprint, readBounded, } from "./resolver-parts.js";
+import { loadFoldMap, SPEC_REL_PARTS, specPath } from "./fold-map.js";
+import { checkSquashMerged, extractPrMarker, readOriginSlug } from "./merge-check.js";
+import { refreshMerge } from "./merge-refresh.js";
+import { mintDocId } from "./doc-ids.js";
+import { buildRequirementArtifact, buildSpecArtifact } from "./artifacts.js";
+import { buildCommitArtifact } from "./artifacts-commit.js";
+import { buildSlice2Artifacts, slice2RevPaths } from "./slice2-sources.js";
+import { iterateDocPath, readIterateDoc } from "./iterate-record.js";
+import { resolveWorkCompleted } from "./merged-events.js";
+import { campaignSpecCandidates, specCandidates, specHintCandidate } from "./spec-candidates.js";
+import { toMissionTests } from "./artifacts-tests.js";
+import { chooseRoot, readAllowedRootsCached, resolveFirstDoc } from "./worktree-roots.js";
+import { MISSION_CONTEXT_SCHEMA_VERSION, } from "./types.js";
+/** `decision.runId` resolved and non-null — caller has already checked. */
+export async function resolveIterateContext(req, deps, decision, runId, pointer, baseRevPaths) {
+    const { projectRoot, sessionUuid } = req;
+    const slug = pointer.status === "ok" ? pointer.pointer.slug : null;
+    const worktreePath = pointer.status === "ok" ? pointer.pointer.worktreePath : null;
+    const roots = await readAllowedRootsCached(projectRoot, { git: deps.git });
+    // A worktree git does not know is simply NOT USED as a read root — that is
+    // `chooseRoot`'s contract, and it is the normal post-Finalize state, not an
+    // integrity failure. MEASURED 2026-07-21: git registered 0 of this project's
+    // 20 live pointers' worktrees (removed at Finalize, directory left behind),
+    // and the earlier hard failure here erased all six artifacts for every one of
+    // them although every run had its record in the main root. See ADR.
+    const chosen = chooseRoot(roots, worktreePath);
+    // --- Records (the spec candidates below are built from them). The event
+    // lookup is (mtime,size)-indexed: ahead of the cache check it is a Map hit.
+    const iterateDoc = readIterateDoc(projectRoot, runId);
+    // Working tree first, then — for a FINISHED run whose worktree is gone
+    // (`!isWorktree`) and whose row is not local — the default remote ref where
+    // the squash landed it. This is the "merged but not pulled" case that
+    // otherwise leaves only Decisions on the rail (merged-events.ts).
+    const { events, mergedRefMiss } = await resolveWorkCompleted(projectRoot, runId, chosen.isWorktree, { git: deps.git });
+    const run = events.status === "found" ? events.run : null;
+    // --- Spec: known layout, agent-doc hint, then that same campaign path rebuilt
+    // from the never-evicted event log — APPENDED, so preference order is
+    // unchanged and it only adds reach once the doc evicts (trg-92c0c36b).
+    const hint = specHintCandidate(iterateDoc?.specHint);
+    const candidates = [
+        ...specCandidates(runId, slug),
+        ...(hint ? [hint] : []),
+        ...campaignSpecCandidates(chosen.root, run?.campaign, run?.subIterateId),
+    ];
+    const doc = resolveFirstDoc(chosen.root, candidates);
+    // The rev covers EVERY source used, incl. the iterate + agent docs AND the
+    // Slice-2 sources. An input missing from here is an input FROZEN by the cache.
+    const rev = computeSourceRev([
+        ...baseRevPaths,
+        iterateDocPath(projectRoot, runId),
+        ...slice2RevPaths(projectRoot, runId),
+        ...(doc.ok ? [doc.absolute] : []),
+    ], [runId, chosen.root, req.taskId]);
+    // Task terminal state is server-owned input, not a filesystem revision. It
+    // must participate in the cache identity so a completed task cannot reuse a
+    // previously-live context while its worktree and event log are unchanged.
+    const cacheKey = `${projectRoot}::${sessionUuid}::${runId}::${req.taskTerminal ? "terminal" : "active"}`;
+    // Report the id + source the route should persist — a LIVE pointer (rule
+    // 2), a first association from a corroborated footer (rule 5), or a
+    // confirmed supersession of a stale one (rule 2b, association.ts
+    // `supersedeMissionContext`). Read back off the WINNING rule so the id and
+    // its provenance cannot disagree; an id that already came from the store
+    // (an unchanged association) is reported but the route's guard makes that
+    // report a no-op write.
+    const associate = decision.runIdSource === "pointer" || decision.runIdSource === "transcript" ? runId : null;
+    const associateSource = decision.runIdSource === "transcript" ? "transcript_run_id" : "iterate_active_pointer";
+    const hit = cache.get(cacheKey);
+    if (hit && hit.rev === rev) {
+        // NOT returned verbatim — merge is the one time-varying field and must be
+        // re-derived, or it freezes at "pending" forever. See merge-refresh.ts.
+        return {
+            context: await refreshMerge(hit.context, projectRoot, req.transcript, deps),
+            associateRunId: associate,
+            associateSource,
+        };
+    }
+    let documentId = null, title = null, specText = null;
+    if (doc.ok) {
+        // BY INDEX — a suffix-compare against the realpath misses on a leaf-casing
+        // normalisation and silently pairs candidates[0] with the OTHER file's
+        // fingerprint (see resolveFirstDoc).
+        // BY INDEX — what resolveFirstDoc returns it for. See
+        // resolver.candidate-pairing.test.ts for why re-deriving it is a trap.
+        const rel = candidates[doc.index].join("/");
+        title = rel.slice(rel.lastIndexOf("/") + 1);
+        documentId = mintDocId({
+            t: req.taskId,
+            s: sessionUuid,
+            p: projectRoot,
+            r: runId,
+            root: chosen.root,
+            rel,
+            rev,
+            f: docFingerprint(doc.absolute),
+        });
+        specText = readBounded(doc.absolute);
+    }
+    const foldMap = loadFoldMap(projectRoot);
+    const requirementsDocument = mintDocId({
+        t: req.taskId,
+        s: sessionUuid,
+        p: projectRoot,
+        r: runId,
+        root: projectRoot,
+        rel: SPEC_REL_PARTS.join("/"),
+        rev,
+        f: docFingerprint(specPath(projectRoot)),
+    });
+    // --- Commit + merge -------------------------------------------------------
+    // The marker must belong to THIS project's own origin repo (a sibling repo's
+    // PR number would grep our origin/main), and merge is only checked once the
+    // run completed — a per-poll git call mid-run is waste (§5.3).
+    const marker = extractPrMarker(req.transcript, await readOriginSlug(projectRoot, deps.git));
+    const merge = run && marker
+        ? await checkSquashMerged(projectRoot, marker.number, { git: deps.git, ...deps.merge })
+        : "unknown";
+    const slice2 = await buildSlice2Artifacts({
+        projectRoot,
+        runId,
+        events,
+        commit: run?.commit?.trim() || null,
+        git: deps.git,
+    });
+    // `runLive` retains its visual worktree meaning. Requirement planning has a
+    // separate authority: the server-owned task state, which can mark a run
+    // terminal while a worktree lingers (or active while root selection fell back).
+    const runLive = chosen.isWorktree && !req.taskTerminal && events.status !== "found";
+    const requirementLive = !req.taskTerminal && events.status !== "found";
+    // CONTRACT §6 order: Spec · Requirement · Tests · Review · Decisions · Commit.
+    const artifacts = [
+        buildSpecArtifact({
+            documentId,
+            title,
+            denied: !doc.ok && doc.reason === "denied",
+            fromWorktree: chosen.isWorktree,
+            intent: run?.intent ?? null,
+        }),
+        buildRequirementArtifact({
+            foldMap,
+            doc: iterateDoc,
+            events,
+            specText,
+            runLive: requirementLive,
+            sourceDocument: {
+                documentId: requirementsDocument,
+                title: "Requirements specification",
+            },
+        }),
+        ...slice2.artifacts,
+        buildCommitArtifact({ events, prNumber: marker?.number ?? null, prUrl: marker?.url ?? null, merge }),
+    ];
+    const requirement = artifacts[1];
+    const servesFrId = requirement.kind === "requirement" && requirement.detail?.rows.length
+        ? requirement.detail.rows[0].displayFrId
+        : null;
+    const context = {
+        schemaVersion: MISSION_CONTEXT_SCHEMA_VERSION,
+        scenario: "iterate",
+        missionTabVisible: true,
+        runId,
+        // IN FLIGHT = git still registers the pointer's worktree AND the run has not
+        // recorded completion. The worktree alone is a filesystem PROXY (external
+        // plan review, openai MEDIUM): an abandoned or already-finished run can
+        // leave a registered worktree behind, and "pending" for a run that is over
+        // is the same lie in the other direction. A `work_completed` record is a
+        // terminal fact, so it ends live-ness. Both inputs participate in `rev`
+        // (`chosen.root` + the event log's mtime), so neither can freeze in cache.
+        runLive,
+        artifacts,
+        // Shares artifacts-tests.ts's constructor so this never diverges from
+        // the Tests artifact's own `detail.results` on the `{0,0}` edge case.
+        tests: run ? toMissionTests(run.tests, run.ts) : null,
+        servesFrId,
+        sourceRev: rev,
+    };
+    // A TRANSIENT git failure is not cached: git's answer is not a statted file,
+    // so it cannot participate in `rev`, and caching it would pin Tests at
+    // "currently unavailable" until an unrelated source file changed. A merged-ref
+    // MISS is excluded for the same reason — the run may land on the ref after a
+    // later fetch, which `rev` would not see; re-resolving is cheap (the ref blob
+    // is TTL-cached in merged-events). A merged-ref HIT is stable and caches.
+    if (slice2.cacheable && !mergedRefMiss) {
+        if (cache.size >= CACHE_CAP)
+            cache.clear();
+        cache.set(cacheKey, { rev, context });
+    }
+    // `associate` comes from EVIDENCE — a validated pointer or a corroborated
+    // footer — never from the task's `state`, which decays to `idle` on a parked
+    // design gate. See association.ts.
+    return { context, associateRunId: associate, associateSource };
+}
+//# sourceMappingURL=resolver-iterate.js.map

package/server/dist/core/mission-context/resolver-iterate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver-iterate.js","sourceRoot":"","sources":["../../../src/core/mission-context/resolver-iterate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,EACL,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EACL,8BAA8B,GAI/B,MAAM,YAAY,CAAC;AAEpB,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAmB,EACnB,IAAiB,EACjB,QAA0B,EAC1B,KAAa,EACb,OAA0B,EAC1B,YAAsB;IAEtB,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IAEnF,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAE3E,2EAA2E;IAC3E,4EAA4E;IAC5E,6EAA6E;IAC7E,4EAA4E;IAC5E,8EAA8E;IAC9E,oEAAoE;IACpE,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAE/C,yEAAyE;IACzE,4EAA4E;IAC5E,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACtD,uEAAuE;IACvE,4EAA4E;IAC5E,sEAAsE;IACtE,kEAAkE;IAClE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,oBAAoB,CAC1D,WAAW,EACX,KAAK,EACL,MAAM,CAAC,UAAU,EACjB,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAClB,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAE1D,+EAA+E;IAC/E,sEAAsE;IACtE,uEAAuE;IACvE,MAAM,IAAI,GAAG,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG;QACjB,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvB,GAAG,sBAAsB,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,CAAC;KACzE,CAAC;IACF,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAErD,2EAA2E;IAC3E,+EAA+E;IAC/E,MAAM,GAAG,GAAG,gBAAgB,CAC1B;QACE,GAAG,YAAY;QACf,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC;QAClC,GAAG,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC;QACrC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAClC,EACD,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CACjC,CAAC;IACF,2EAA2E;IAC3E,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,GAAG,WAAW,KAAK,WAAW,KAAK,KAAK,KAAK,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACzG,yEAAyE;IACzE,oEAAoE;IACpE,iEAAiE;IACjE,2EAA2E;IAC3E,yEAAyE;IACzE,0EAA0E;IAC1E,wBAAwB;IACxB,MAAM,SAAS,GACb,QAAQ,CAAC,WAAW,KAAK,SAAS,IAAI,QAAQ,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7F,MAAM,eAAe,GACnB,QAAQ,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,wBAAwB,CAAC;IAEzF,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;QAC3B,0EAA0E;QAC1E,wEAAwE;QACxE,OAAO;YACL,OAAO,EAAE,MAAM,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC;YAC3E,cAAc,EAAE,SAAS;YACzB,eAAe;SAChB,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,GAAkB,IAAI,EAAE,KAAK,GAAkB,IAAI,EAAE,QAAQ,GAAkB,IAAI,CAAC;IAClG,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;QACX,2EAA2E;QAC3E,uEAAuE;QACvE,qCAAqC;QACrC,sDAAsD;QACtD,uEAAuE;QACvE,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5C,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,UAAU,GAAG,SAAS,CAAC;YACrB,CAAC,EAAE,GAAG,CAAC,MAAM;YACb,CAAC,EAAE,WAAW;YACd,CAAC,EAAE,WAAW;YACd,CAAC,EAAE,KAAK;YACR,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG;YACH,GAAG;YACH,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC;SAChC,CAAC,CAAC;QACH,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,oBAAoB,GAAG,SAAS,CAAC;QACrC,CAAC,EAAE,GAAG,CAAC,MAAM;QACb,CAAC,EAAE,WAAW;QACd,CAAC,EAAE,WAAW;QACd,CAAC,EAAE,KAAK;QACR,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;QAC7B,GAAG;QACH,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;KACzC,CAAC,CAAC;IAEH,6EAA6E;IAC7E,6EAA6E;IAC7E,4EAA4E;IAC5E,+DAA+D;IAC/D,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5F,MAAM,KAAK,GACT,GAAG,IAAI,MAAM;QACX,CAAC,CAAC,MAAM,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACvF,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC;QACxC,WAAW;QACX,KAAK;QACL,MAAM;QACN,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI;QACnC,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAC;IACH,4EAA4E;IAC5E,wEAAwE;IACxE,gFAAgF;IAChF,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC;IACpF,MAAM,eAAe,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC;IAEvE,+EAA+E;IAC/E,MAAM,SAAS,GAAyB;QACtC,iBAAiB,CAAC;YAChB,UAAU;YACV,KAAK;YACL,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;YAC1C,YAAY,EAAE,MAAM,CAAC,UAAU;YAC/B,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,IAAI;SAC5B,CAAC;QACF,wBAAwB,CAAC;YACvB,OAAO;YACP,GAAG,EAAE,UAAU;YACf,MAAM;YACN,QAAQ;YACR,OAAO,EAAE,eAAe;YACxB,cAAc,EAAE;gBACd,UAAU,EAAE,oBAAoB;gBAChC,KAAK,EAAE,4BAA4B;aACpC;SACF,CAAC;QACF,GAAG,MAAM,CAAC,SAAS;QACnB,mBAAmB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;KACrG,CAAC;IAEF,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,UAAU,GACd,WAAW,CAAC,IAAI,KAAK,aAAa,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW;QACxC,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,OAAO,GAAmB;QAC9B,aAAa,EAAE,8BAA8B;QAC7C,QAAQ,EAAE,SAAS;QACnB,iBAAiB,EAAE,IAAI;QACvB,KAAK;QACL,6EAA6E;QAC7E,0EAA0E;QAC1E,wEAAwE;QACxE,2EAA2E;QAC3E,yEAAyE;QACzE,wEAAwE;QACxE,2EAA2E;QAC3E,OAAO;QACP,SAAS;QACT,sEAAsE;QACtE,sEAAsE;QACtE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;QACrD,UAAU;QACV,SAAS,EAAE,GAAG;KACf,CAAC;IAEF,6EAA6E;IAC7E,uEAAuE;IACvE,+EAA+E;IAC/E,6EAA6E;IAC7E,8EAA8E;IAC9E,0EAA0E;IAC1E,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,IAAI,SAAS;YAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QAC3C,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,0EAA0E;IAC1E,6EAA6E;IAC7E,mCAAmC;IACnC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AACjE,CAAC"}

package/server/dist/core/mission-context/resolver-parts.d.ts

@@ -27,6 +27,26 @@ export declare const cache: Map<string, CacheEntry>;
 export declare const CACHE_CAP = 256;
 /** Test-only: drop the module-level cache between cases. */
 export declare function _clearResolverCache(): void;
+/**
+ * The memoized, CONFIRMED supersession for this (session, association,
+ * transcript-content) triple — `undefined` when none is cached (either this
+ * content was never checked, or it was checked and found nothing, which is
+ * deliberately never memoized here; a scan is owed either way).
+ */
+export declare function supersessionMemoHit(sessionUuid: string, associationRunId: string, transcript: string): string | undefined;
+/** Record this triple's CONFIRMED recovery, so the next unchanged poll reuses it instead of re-scanning. */
+export declare function markSupersessionResult(sessionUuid: string, associationRunId: string, transcript: string, recovered: string): void;
+/** Test-only: drop the supersession-check memo between cases. */
+export declare function _clearSupersessionMemo(): void;
+/**
+ * Builds the LAZY `recoverTranscriptRunId` thunk `detectScenario` calls for
+ * both rule 5 (no association) and rule 2b (supersession check) — wiring the
+ * throttle above around `recoverRunIdFromTranscript` in one place so the
+ * orchestrator (resolver.ts) stays a one-line call site. `memoHit` is read at
+ * BUILD time (this resolve's transcript/association snapshot), not
+ * re-evaluated inside the thunk, since neither changes within one call.
+ */
+export declare function buildRecoveryThunk(projectRoot: string, sessionUuid: string, transcript: string, associationRunId: string | null): () => string | null;
 /**
  * Bounded read of a document body (mid-run planned impact + the detail
  * endpoint). Atomic: the size cap is enforced against the SAME descriptor the

package/server/dist/core/mission-context/resolver-parts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver-parts.d.ts","sourceRoot":"","sources":["../../../src/core/mission-context/resolver-parts.ts"],"names":[],"mappings":"AAeA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,CAYpF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOvD;AAoBD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAavE;AAED,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,wFAAwF;AACxF,eAAO,MAAM,KAAK,yBAAgC,CAAC;AACnD,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,4DAA4D;AAC5D,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,EACpC,iBAAiB,EAAE,OAAO,EAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,cAAc,EAAE,IAAI,CAAC;IAAC,eAAe,EAAE,wBAAwB,CAAA;CAAE,CAU9F;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,EACpC,iBAAiB,EAAE,OAAO,EAC1B,SAAS,EAAE,MAAM,GAChB,cAAc,CAahB"}
+{"version":3,"file":"resolver-parts.d.ts","sourceRoot":"","sources":["../../../src/core/mission-context/resolver-parts.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,CAYpF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOvD;AAoBD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAavE;AAED,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,wFAAwF;AACxF,eAAO,MAAM,KAAK,yBAAgC,CAAC;AACnD,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,4DAA4D;AAC5D,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAgDD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAIpB;AAED,4GAA4G;AAC5G,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,IAAI,CAIN;AAED,iEAAiE;AACjE,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAC9B,MAAM,MAAM,GAAG,IAAI,CAerB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,EACpC,iBAAiB,EAAE,OAAO,EAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,cAAc,EAAE,IAAI,CAAC;IAAC,eAAe,EAAE,wBAAwB,CAAA;CAAE,CAU9F;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,EACpC,iBAAiB,EAAE,OAAO,EAC1B,SAAS,EAAE,MAAM,GAChB,cAAc,CAahB"}