opencode-swarm 7.140.0 → 7.140.2

package/dist/cli/{index-6ykm2eha.js → index-t59cdg48.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-rtry5xyf.js";
 import {
   readKnowledgeEvents
-} from "./index-p6h8f59v.js";
+} from "./index-jfp1bgt1.js";
 import {
   isLinked,
   readLinkPointer,

package/dist/cli/{index-chycpf9y.js → index-vjqe1z2w.js}

@@ -7,7 +7,7 @@ import {
   loadPluginConfigWithMeta,
   loadPluginConfigWithMetaAsync,
   resolveWorktreeIsolationConfig
-} from "./index-43k8ntw7.js";
+} from "./index-0tevsq1a.js";
 import {
   ApprovalEvidenceSchema,
   BaseEvidenceSchema,
@@ -65,7 +65,7 @@ import {
   TurboConfigSchema,
   WorktreeIsolationConfigSchema,
   resolveAutoReviewConfig
-} from "./index-0pqh1710.js";
+} from "./index-bmmzfrc7.js";
 import {
   ALL_AGENT_NAMES,
   ALL_SUBAGENT_NAMES,
@@ -75,7 +75,7 @@ import {
   QA_AGENTS,
   isQAAgent,
   isSubagent
-} from "./index-r4t92q32.js";
+} from "./index-n408rw7n.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";

package/dist/cli/{index-zebb6yw0.js → index-x6mtyj6q.js}

@@ -15,10 +15,10 @@ import {
 import {
   init_schema,
   stripKnownSwarmPrefix
-} from "./index-0pqh1710.js";
+} from "./index-bmmzfrc7.js";
 import {
   init_constants
-} from "./index-r4t92q32.js";
+} from "./index-n408rw7n.js";
 import {
   __commonJS,
   __toESM

package/dist/cli/{index-6d7jkk1s.js → index-y98ngs4g.js}

@@ -12,14 +12,14 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-mb34t6w9.js";
+} from "./index-n831qq2v.js";
 import {
   checkFileAuthority,
   classifyFile,
   isInDeclaredScope,
   redactPath,
   redactShellCommand
-} from "./index-zebb6yw0.js";
+} from "./index-x6mtyj6q.js";
 
 // src/services/guardrail-explain-service.ts
 import path from "path";

package/dist/cli/{index-bdnrrx3w.js → index-yt3vz0e1.js}

@@ -2,7 +2,7 @@
 import {
   readKnowledge,
   transactKnowledge
-} from "./index-s38e38qy.js";
+} from "./index-325zmfyj.js";
 import {
   resolveKnowledgeStoreDir
 } from "./index-rs1f1bh0.js";

package/dist/cli/{index-fxw0zvxc.js → index-z6md3t8m.js}

@@ -6,13 +6,13 @@ import {
   resolveSwarmKnowledgePath,
   transactKnowledge,
   wordBigrams
-} from "./index-s38e38qy.js";
+} from "./index-325zmfyj.js";
 import {
   countEntryContradictionsInWindow,
   countEntryViolationsInWindow,
   readKnowledgeEvents,
   recordKnowledgeEvent
-} from "./index-p6h8f59v.js";
+} from "./index-jfp1bgt1.js";
 import {
   init_knowledge_types,
   isActiveStatus
@@ -190,11 +190,11 @@ async function maybeQuarantineOnContradiction(directory, entryId, threshold, win
         alreadyInactive: true
       };
     }
-    const { quarantineEntry } = await import("./knowledge-validator-58s2j0dp.js");
+    const { quarantineEntry } = await import("./knowledge-validator-1dtj02q8.js");
     let policyConfig;
     try {
-      const { KnowledgeConfigSchema } = await import("./schema-9ryqandr.js");
-      const { loadPluginConfigWithMeta } = await import("./index-chycpf9y.js");
+      const { KnowledgeConfigSchema } = await import("./schema-b046zss2.js");
+      const { loadPluginConfigWithMeta } = await import("./index-vjqe1z2w.js");
       const { config: loadedConfig } = loadPluginConfigWithMeta(directory);
       policyConfig = KnowledgeConfigSchema.parse(loadedConfig.knowledge ?? {});
     } catch {

package/dist/cli/index.js

@@ -6,19 +6,19 @@ import {
   getPluginConfigDir,
   getPluginLockFilePaths,
   resolveCommand
-} from "./index-mb34t6w9.js";
+} from "./index-n831qq2v.js";
 import"./index-41hkt36g.js";
 import"./index-1m1ksyqt.js";
-import"./index-zebb6yw0.js";
-import"./index-0jbhmm8b.js";
+import"./index-x6mtyj6q.js";
+import"./index-chx92bes.js";
 import"./index-brh827g0.js";
 import"./index-yyyk63kk.js";
 import"./index-y8552snf.js";
 import"./index-4905hd2m.js";
 import"./index-134d35c1.js";
-import"./index-f8dhh53t.js";
-import"./index-fxw0zvxc.js";
-import"./index-bdnrrx3w.js";
+import"./index-9txca231.js";
+import"./index-z6md3t8m.js";
+import"./index-yt3vz0e1.js";
 import"./index-v2xrer41.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
@@ -28,7 +28,7 @@ import"./index-556ja8an.js";
 import"./index-kbfsp07d.js";
 import"./index-1kyex7z2.js";
 import"./index-b8zgtz81.js";
-import"./index-hbnsmnb0.js";
+import"./index-898f16j9.js";
 import"./index-b9rd29ge.js";
 import"./index-k46me75h.js";
 import"./index-ee3x66a5.js";
@@ -36,11 +36,11 @@ import"./index-74hpm6sh.js";
 import"./index-n0pja0qs.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
-import"./index-ma8vk3v1.js";
-import"./index-6ykm2eha.js";
+import"./index-1j5my2qy.js";
+import"./index-t59cdg48.js";
 import"./index-rtry5xyf.js";
-import"./index-s38e38qy.js";
-import"./index-p6h8f59v.js";
+import"./index-325zmfyj.js";
+import"./index-jfp1bgt1.js";
 import"./index-ae75rja9.js";
 import"./index-rs1f1bh0.js";
 import"./index-h2waehqq.js";
@@ -48,7 +48,7 @@ import"./index-ed5ykebp.js";
 import"./index-hfvxhk4z.js";
 import"./index-7g4c7s5r.js";
 import"./index-4nt52yr9.js";
-import"./index-43k8ntw7.js";
+import"./index-0tevsq1a.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
 import"./index-d181x9zr.js";
@@ -57,11 +57,11 @@ import"./index-zgwm4ryv.js";
 import {
   init_package,
   package_default
-} from "./index-0pqh1710.js";
+} from "./index-bmmzfrc7.js";
 import {
   DEFAULT_AGENT_CONFIGS,
   init_constants
-} from "./index-r4t92q32.js";
+} from "./index-n408rw7n.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
 import"./index-ry0hgg3m.js";

package/dist/cli/{knowledge-escalator-qjdfv9sj.js → knowledge-escalator-58tw74js.js}

@@ -8,9 +8,9 @@ import {
   maybeEscalateOnViolation,
   maybeQuarantineOnContradiction,
   readRecentEscalations
-} from "./index-fxw0zvxc.js";
-import"./index-s38e38qy.js";
-import"./index-p6h8f59v.js";
+} from "./index-z6md3t8m.js";
+import"./index-325zmfyj.js";
+import"./index-jfp1bgt1.js";
 import"./index-ae75rja9.js";
 import"./index-rs1f1bh0.js";
 import"./index-h2waehqq.js";

package/dist/cli/{knowledge-events-7szzg70x.js → knowledge-events-knr0pfq4.js}

@@ -28,7 +28,7 @@ import {
   resolveKnowledgeCounterBaselinePath,
   resolveKnowledgeEventsPath,
   resolveLegacyApplicationLogPath
-} from "./index-p6h8f59v.js";
+} from "./index-jfp1bgt1.js";
 import"./index-ae75rja9.js";
 import"./index-rs1f1bh0.js";
 import"./index-h2waehqq.js";

package/dist/cli/{knowledge-store-9mr7a9n8.js → knowledge-store-e2srcd89.js}

@@ -41,7 +41,7 @@ import {
   transactKnowledge,
   transactKnowledgeWithCas,
   wordBigrams
-} from "./index-s38e38qy.js";
+} from "./index-325zmfyj.js";
 import {
   resolveHiveDataDir
 } from "./index-ae75rja9.js";

package/dist/cli/{knowledge-validator-58s2j0dp.js → knowledge-validator-1dtj02q8.js}

@@ -23,11 +23,11 @@ import {
   validateLesson,
   validateSkillCandidatePath,
   validateSkillPath
-} from "./index-ma8vk3v1.js";
-import"./index-6ykm2eha.js";
+} from "./index-1j5my2qy.js";
+import"./index-t59cdg48.js";
 import"./index-rtry5xyf.js";
-import"./index-s38e38qy.js";
-import"./index-p6h8f59v.js";
+import"./index-325zmfyj.js";
+import"./index-jfp1bgt1.js";
 import"./index-ae75rja9.js";
 import"./index-rs1f1bh0.js";
 import"./index-h2waehqq.js";

package/dist/cli/{scan-cursor-h3j1egky.js → scan-cursor-7tqsvbp8.js}

@@ -4,8 +4,8 @@ import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   getScanStatus
-} from "./index-bdnrrx3w.js";
-import"./index-s38e38qy.js";
+} from "./index-yt3vz0e1.js";
+import"./index-325zmfyj.js";
 import"./index-ae75rja9.js";
 import"./index-rs1f1bh0.js";
 import"./index-h2waehqq.js";

package/dist/cli/{schema-9ryqandr.js → schema-b046zss2.js}

@@ -96,8 +96,8 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-0pqh1710.js";
-import"./index-r4t92q32.js";
+} from "./index-bmmzfrc7.js";
+import"./index-n408rw7n.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";

package/dist/cli/{skill-generator-66ez26yh.js → skill-generator-bvph9d98.js}

@@ -33,12 +33,12 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-f8dhh53t.js";
-import"./index-ma8vk3v1.js";
-import"./index-6ykm2eha.js";
+} from "./index-9txca231.js";
+import"./index-1j5my2qy.js";
+import"./index-t59cdg48.js";
 import"./index-rtry5xyf.js";
-import"./index-s38e38qy.js";
-import"./index-p6h8f59v.js";
+import"./index-325zmfyj.js";
+import"./index-jfp1bgt1.js";
 import"./index-ae75rja9.js";
 import"./index-rs1f1bh0.js";
 import"./index-h2waehqq.js";

package/dist/commands/registry.d.ts

@@ -619,7 +619,7 @@ export declare const COMMAND_REGISTRY: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Clear a stuck PR_REVIEW/PR_FEEDBACK mechanical gate and stop the auto-resume loop [mode] [reason]";
         readonly args: "[PR_REVIEW|PR_FEEDBACK] [reason...]";
-        readonly details: "Human-only escape hatch for an unrecoverable PR_REVIEW or PR_FEEDBACK mechanical gate. When the architect cannot reach complete_pr_workflow — for example a compound `git fetch && git checkout` was rejected as read-only shell syntax, the PR head cannot be fetched, or the working tree is on the wrong branch — running this clears the durable gate state for the current session and stops the auto-resume loop without depending on the trapped model. The agent itself cannot run this command; it must call the abort_pr_workflow tool (or ask you to run this command). Both paths funnel into the same fail-closed abortPrWorkflow hook, which refuses while the workflow is armed for publication or while PR workflow lanes are still in flight. An audit event is appended to .swarm/events.jsonl.";
+        readonly details: "Human-only escape hatch for an unrecoverable PR_REVIEW or PR_FEEDBACK mechanical gate. When the architect cannot reach complete_pr_workflow — for example a compound `git fetch && git checkout` was rejected as read-only shell syntax, the PR head cannot be fetched, or the working tree is on the wrong branch — running this clears the durable gate state for the current session and stops the auto-resume loop without depending on the trapped model. The agent itself cannot run this command; it must call the abort_pr_workflow tool (or ask you to run this command). Both paths funnel into the same fail-closed abortPrWorkflow hook, which refuses while the workflow is armed for publication or while PR workflow lanes are still in flight. When checkout preparation preserved a stash, the result instructs the caller to run prepare_pr_workflow_checkout operation=restore after the clear. An audit event is appended to .swarm/events.jsonl.";
         readonly category: "utility";
         readonly toolPolicy: "restricted";
     };

package/dist/git/pr-workflow-state.d.ts

@@ -28,7 +28,9 @@ declare function activeOperations(gitDir: string): Promise<string[]>;
  * Unknown Git state fails closed; ordinary tracked/untracked dirt is explicitly
  * distinguished from conflict and in-progress-operation recovery states.
  */
-export declare function classifyPrWorkflowGitState(directory: string): Promise<PrWorkflowGitState>;
+export declare function classifyPrWorkflowGitState(directory: string, options?: {
+    ignoredPaths?: readonly string[];
+}): Promise<PrWorkflowGitState>;
 export declare const _internals: {
     runGitCapture: typeof runGitCapture;
     activeOperations: typeof activeOperations;

package/dist/hooks/issue-trace-reducer.d.ts

@@ -3,7 +3,15 @@
  *
  * Determines the next mode transition for an issue-trace workflow
  * based on current trace state and workflow artifacts. Evaluated
- * top-to-bottom (first-match-wins) against an 8-row decision table.
+ * top-to-bottom (first-match-wins) against the decision table below.
+ *
+ * Issue #2131 finding 2: the reducer no longer conflates "the engine
+ * handed off to commit-pr" with "the issue is resolved." Trace state is a
+ * typed `status` (`in_progress` → `publication_handoff` → `published`), and
+ * the commit-pr handoff sets `publication_handoff` (NOT a terminal
+ * "completed"). `published` is reachable only after a verifiable publication
+ * receipt is observed. A reproduction gate (evidence OR a typed waiver) must
+ * be satisfied before the PLAN transition fires.
  */
 export interface IssueReference {
     url: string;
@@ -22,10 +30,20 @@ export interface IssueReference {
         timestamp: string;
     };
 }
+/**
+ * Trace lifecycle status. Replaces the boolean `completed` (issue #2131
+ * finding 2.4):
+ * - `in_progress`: the engine is driving PLAN → CRITIC-GATE → EXECUTE.
+ * - `publication_handoff`: all phases complete; the engine has emitted the
+ *   commit-pr directive and stopped driving. This is NOT "issue resolved" —
+ *   publication is owned by commit-pr and has not yet been confirmed.
+ * - `published`: a verifiable publication receipt was observed. Terminal.
+ */
+export type TraceStatus = 'in_progress' | 'publication_handoff' | 'published';
 export interface TraceState {
     issueNumber: number;
     lastTransition: string | null;
-    completed: boolean;
+    status: TraceStatus;
 }
 export interface WorkflowArtifacts {
     specExists: boolean;
@@ -33,12 +51,16 @@ export interface WorkflowArtifacts {
     planExists: boolean;
     criticApproved: boolean;
     allPhasesComplete: boolean;
+    /** Reproduction evidence OR a typed waiver is present (issue #2131 2.6). */
+    reproductionPermitted: boolean;
+    /** A verifiable publication receipt has been observed (issue #2131 2.4). */
+    publicationObserved: boolean;
 }
 export interface TransitionResult {
     nextMode: string | null;
     directive: string | null;
     nextLastTransition: string | null;
-    nextCompleted: boolean;
+    nextStatus: TraceStatus;
 }
 export interface ComputeNextModeParams {
     issueReference: IssueReference | null;
@@ -51,16 +73,18 @@ export interface ComputeNextModeParams {
  *
  * Decision table (top-to-bottom, first match wins):
  *   (a) No issue reference or trace not requested        → no-op
- *   (b) Trace already completed                           → no-op
- *   (c) Cross-issue guard (spec issue ≠ current issue)   → no-op
- *   (d) Spec does not exist                              → no-op
- *   (e) Spec exists, no plan, never transitioned          → PLAN
- *   (f) Plan exists but critic not approved               → no-op
- *   (g) Critic approved, phases incomplete, not yet PLAN_TO_EXECUTE → EXECUTE
- *   (h) All phases complete, not yet EXECUTE_TO_COMMIT    → COMMIT directive
+ *   (b) Trace already published (terminal)               → no-op
+ *   (c) publication_handoff: observe publication → PUBLISHED; else no-op
+ *   (d) Cross-issue guard (spec issue ≠ current issue)   → no-op
+ *   (e) Spec does not exist                              → no-op
+ *   (f) Spec exists, no plan, reproduction permitted,
+ *       never transitioned (or re-entrant idempotency)   → PLAN
+ *   (f-block) Spec exists, no plan, reproduction NOT permitted → no-op
+ *   (g) Plan exists but critic not approved              → no-op
+ *   (h) Critic approved, phases incomplete, not yet PLAN_TO_EXECUTE → EXECUTE
+ *   (i) All phases complete, not yet EXECUTE_TO_COMMIT   → publication_handoff + COMMIT directive
  *
- * Idempotency: rows (e), (g), (h) return no-op when
- * `traceState.lastTransition` already equals the target
- * transition value.
+ * Idempotency: rows (f), (h), (i) return no-op when
+ * `traceState.lastTransition` already equals the target transition value.
  */
 export declare function computeNextMode(params: ComputeNextModeParams): TransitionResult;

package/dist/hooks/issue-trace-state.d.ts

@@ -4,11 +4,19 @@
  *
  * Uses the `_internals` DI seam pattern (AGENTS.md invariant 7) so
  * tests can override filesystem calls without `mock.module` leakage.
+ *
+ * Issue #2131 finding 2.3: plan state is read through the AUTHORITATIVE
+ * ledger-aware `loadPlan` (never `loadPlanJsonOnly`, never projection
+ * existence). Finding 2.4: trace state is a typed `status`, with
+ * backward-compatible reading of legacy `completed: boolean` records.
+ * Findings 2.6 / 2.4(published): reproduction + publication receipt readers.
  */
 import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
 import type { Plan } from '../config/plan-schema';
 import type { IssueReference, TraceState } from './issue-trace-reducer';
 declare function _defaultLoadPlanFromLedger(directory: string): Promise<Plan | null>;
+declare function _defaultReproductionReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
+declare function _defaultPublicationReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
 export declare const _internals: {
     readFileSync: typeof readFileSync;
     writeFileSync: typeof writeFileSync;
@@ -17,6 +25,8 @@ export declare const _internals: {
     mkdirSync: typeof mkdirSync;
     unlinkSync: typeof unlinkSync;
     loadPlanFromLedger: typeof _defaultLoadPlanFromLedger;
+    reproductionReceiptExists: typeof _defaultReproductionReceiptExists;
+    publicationReceiptExists: typeof _defaultPublicationReceiptExists;
 };
 /**
  * Reads `.swarm/issue-reference.json` and returns the parsed object,
@@ -24,9 +34,10 @@ export declare const _internals: {
  */
 export declare function readIssueReference(directory: string): IssueReference | null;
 /**
- * Reads `.swarm/issue-trace-state.json` and returns the parsed state,
- * or a default `{issueNumber:0, lastTransition:null, completed:false}`
- * if the file is absent or malformed.
+ * Reads `.swarm/issue-trace-state.json` and returns the parsed state
+ * (new `status` or legacy `completed`, normalized), or a default
+ * `{issueNumber:0, lastTransition:null, status:'in_progress'}` if the file is
+ * absent or malformed.
  */
 export declare function readTraceState(directory: string): TraceState;
 /**
@@ -42,23 +53,41 @@ export declare function writeTraceState(directory: string, state: TraceState): v
  */
 export declare function readSpecIssueNumber(directory: string): number | null;
 /**
- * Loads the plan from the ledger-aware plan loader.
- * Async because the underlying ledger loader is async.
+ * Loads the plan from the AUTHORITATIVE ledger-aware loader (issue #2131 2.3).
+ * Async because the underlying loader is async.
  */
 export declare function loadPlanFromLedger(directory: string): Promise<Plan | null>;
 /**
- * Checks whether all phases in the plan have a completed status.
- * Returns `{allComplete: false}` if the plan is null.
+ * Computes plan presence AND phase-completion status from a single
+ * AUTHORITATIVE plan load. `planExists` reflects ledger authority, not
+ * projection (`.swarm/plan.json`) existence. Returns
+ * `{ planExists: false, allComplete: false }` if the plan is null/empty.
  */
 export declare function readPlanPhaseStatus(directory: string): Promise<{
+    planExists: boolean;
     allComplete: boolean;
 }>;
+/**
+ * Returns whether an AUTHORITATIVE plan exists (ledger-aware). Async because
+ * the loader is async. Prefer {@link readPlanPhaseStatus} when both presence
+ * and phase status are needed, to load the plan once.
+ */
+export declare function planExists(directory: string): Promise<boolean>;
 /**
  * Returns whether `.swarm/spec.md` exists.
  */
 export declare function specExists(directory: string): boolean;
 /**
- * Returns whether `.swarm/plan.json` exists.
+ * Returns whether a valid reproduction receipt exists for the given issue
+ * (issue #2131 2.6). The receipt is written by the `record_issue_reproduction`
+ * tool and binds to the issue number.
+ */
+export declare function reproductionReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
+/**
+ * Returns whether a valid publication receipt exists for the given issue (issue
+ * #2131 2.4). The receipt is written by the `record_issue_publication` tool
+ * after PR creation and is issue-bound so a prior issue's receipt cannot satisfy
+ * a new trace.
  */
-export declare function planExists(directory: string): boolean;
+export declare function publicationReceiptExists(directory: string, issueNumber: number): Promise<boolean>;
 export {};

package/dist/hooks/issue-trace.d.ts

@@ -8,9 +8,16 @@
  *
  * Uses the `_internals` DI seam pattern (AGENTS.md invariant 7) so
  * tests can override adapter functions without `mock.module` leakage.
+ *
+ * Issue #2131 finding 2.5: a transition is persisted ONLY AFTER its
+ * directive/mode message is durably appended to the host `output.messages`.
+ * If the host output lacks a mutable messages array the transition is NOT
+ * advanced, so the next cycle recomputes and retries — a lost directive can
+ * no longer be permanently suppressed by idempotency while state advances.
  */
+import { error as _logErrorImpl } from '../utils/logger.js';
 import { isPlanCriticApproved } from './delegation-gate';
-import { planExists, readIssueReference, readPlanPhaseStatus, readSpecIssueNumber, readTraceState, specExists, writeTraceState } from './issue-trace-state';
+import { publicationReceiptExists, readIssueReference, readPlanPhaseStatus, readSpecIssueNumber, readTraceState, reproductionReceiptExists, specExists, writeTraceState } from './issue-trace-state';
 export declare const _internals: {
     readIssueReference: typeof readIssueReference;
     readTraceState: typeof readTraceState;
@@ -18,8 +25,10 @@ export declare const _internals: {
     readSpecIssueNumber: typeof readSpecIssueNumber;
     readPlanPhaseStatus: typeof readPlanPhaseStatus;
     specExists: typeof specExists;
-    planExists: typeof planExists;
+    reproductionReceiptExists: typeof reproductionReceiptExists;
+    publicationReceiptExists: typeof publicationReceiptExists;
     isPlanCriticApproved: typeof isPlanCriticApproved;
+    logError: typeof _logErrorImpl;
 };
 export declare function createIssueTraceHook(_config: unknown, directory: string, approvalTimeoutMs?: number): {
     messagesTransform: (input: unknown, output: unknown) => Promise<void>;
@@ -29,3 +38,7 @@ export declare function createIssueTraceHook(_config: unknown, directory: string
  * cross-test pollution from the module-level cache.
  */
 export declare function resetApprovalCache(): void;
+/**
+ * Reset the plan phase-status cache. Called by tests in afterEach.
+ */
+export declare function resetPhaseStatusCache(): void;

package/dist/hooks/pr-workflow-gate.d.ts

@@ -4,7 +4,7 @@ import { type LaneOutputArtifact } from '../background/lane-output-store.js';
 import { type BackgroundDelegationRecord, type BackgroundDelegationResult, findByBatchId } from '../background/pending-delegations.js';
 import { type PrReviewInlineTriggerRow } from '../background/pr-review-trigger-contract.js';
 import { type RevisionDigestResult, resolveCommitCountSince, resolveCommitCountSinceAsync, resolveCurrentGitHead, resolveCurrentGitHeadAsync, resolveCurrentUpstreamPushTarget, resolveCurrentUpstreamPushTargetAsync, resolveCurrentUpstreamRemoteRef, resolveExactRemoteBranchHead, resolveExactRemoteBranchHeadAsync, resolveIsExactSingleChildCommit, resolveIsExactSingleChildCommitAsync, resolveIsWorkingTreeClean, resolveIsWorkingTreeCleanAsync, resolvePrReviewDiffStats, resolvePrReviewDiffStatsAsync, resolvePrWorkflowRevisionDigest, resolvePrWorkflowRevisionDigestDetailed, resolveRemoteRefsContainingHead, resolveRemoteRefsContainingHeadAsync } from '../background/workspace-snapshot.js';
-import { type PrWorkflowGitState } from '../git/pr-workflow-state.js';
+import { classifyPrWorkflowGitState, type PrWorkflowGitState } from '../git/pr-workflow-state.js';
 export declare const PR_REVIEW_BASE_DIMENSION_IDS: readonly ["intent-architecture", "correctness-state", "tests-falsifiability", "security-trust", "reliability-performance", "compatibility-delivery"];
 export declare const PR_REVIEW_REQUIRED_MICRO_LANE_IDS: ("auth-identity-secrets" | "untrusted-input-boundaries" | "subprocess-platform" | "concurrency-state" | "dependencies-build-release" | "api-schema-migrations" | "test-infrastructure" | "ui-accessibility-i18n" | "privacy-observability" | "generated-provenance" | "unclassified-risk")[];
 export type PrReviewBaseDimensionId = (typeof PR_REVIEW_BASE_DIMENSION_IDS)[number];
@@ -33,7 +33,7 @@ export interface PrReviewDiscoveryLaneValidationInput {
     result: BackgroundDelegationResult;
     artifact: LaneOutputArtifact | null;
     expected: {
-        mode: 'swarm-pr-review:base' | 'swarm-pr-review:micro';
+        mode: 'swarm-pr-review:base' | 'swarm-pr-review:micro' | 'swarm-pr-review:council';
         workflowLane: string;
         ownedWorkflowLanes?: readonly string[];
         prHeadSha: string;
@@ -359,6 +359,13 @@ export declare function readPrWorkflowGateState(directory: string, sessionID: st
 export declare function withPrWorkflowCheckoutPreparationLock<T>(directory: string, sessionID: string, action: (state: PrWorkflowGateState, controls: {
     markRecoveryRequired: (gitState: PrWorkflowGitState) => Promise<PrWorkflowGateState>;
 }) => Promise<T>): Promise<T>;
+/**
+ * Serialize post-terminal checkout restoration against both checkout mutations
+ * and same-session gate activation. Holding the session-state lock while the
+ * caller restores makes the inactive-gate check atomic with respect to a new
+ * activatePrWorkflow/persistState call.
+ */
+export declare function withInactivePrWorkflowCheckoutRestoreLock<T>(directory: string, sessionID: string, action: () => Promise<T>): Promise<T>;
 export declare function clearPrWorkflowGateState(directory: string, sessionID: string, expectedRevision?: number): Promise<void>;
 /**
  * Abort an active PR workflow gate without reaching terminal completion.
@@ -380,13 +387,19 @@ export declare function clearPrWorkflowGateState(directory: string, sessionID: s
  *      commit. The tool gate refuses armed abort too (defense in depth).
  *   4. Refuses while open `swarm-pr-*` delegations exist, matching
  *      `completePrWorkflow` — aborting mid-flight would orphan running lanes.
+ *   5. A `recovery` abort may clear an unbound or bound gate once every lane
+ *      has settled. This is the bounded escape hatch for exhausted discovery,
+ *      validation, or checkout recovery; requiring a pre-bind
+ *      `checkoutRecovery` marker here would strand failures discovered only
+ *      after the head was bound. `force` remains the explicit user override.
  *
  * Records a non-fatal audit event into the existing `.swarm/events.jsonl`
  * (no new ledger file), then delegates to `clearPrWorkflowGateState`.
  */
 export declare function abortPrWorkflow(directory: string, sessionID: string, options?: {
     expectedMode?: PrWorkflowMode;
-    reason?: string;
+    kind: 'recovery' | 'force';
+    reason: string;
 }): Promise<{
     mode: PrWorkflowMode;
     prHeadSha?: string;
@@ -528,6 +541,7 @@ export declare const _test_exports: {
     openCheckoutLock: typeof openCheckoutLockFile;
     removeCheckoutLock: typeof removeCheckoutLockFile;
     checkoutMutationActionTimeoutMs: number;
+    classifyPrWorkflowGitStateAsync: typeof classifyPrWorkflowGitState;
     resolveCurrentGitHead: typeof resolveCurrentGitHead;
     resolveCurrentGitHeadAsync: typeof resolveCurrentGitHeadAsync;
     resolveCurrentUpstreamPushTarget: typeof resolveCurrentUpstreamPushTarget;
@@ -788,10 +802,10 @@ declare function analyzePrReviewBatchRecordIntegrity(args: {
     expectedPrHeadSha?: string;
 }): BatchRecordIntegrityAnalysis[];
 /**
- * Validate a just-collected base/micro discovery result before the delegation
- * ledger publishes it as completed. The caller supplies the prospective result
- * and the exact stored artifact, so this pure validator cannot accidentally
- * accept stale terminal state or a different output reference.
+ * Validate a just-collected base, micro, or council discovery result before the
+ * delegation ledger publishes it as completed. The caller supplies the
+ * prospective result and exact stored artifact, so this pure validator cannot
+ * accidentally accept stale terminal state or a different output reference.
  */
 export declare function validatePrReviewDiscoveryLaneCompletion(input: PrReviewDiscoveryLaneValidationInput): PrReviewLaneValidationResult;
 /** Require at least one semantically valid discovery row or CLEAN attestation. */