opencode-swarm 7.176.2 → 7.177.1

package/dist/observability/catalog.d.ts

@@ -1,7 +1,7 @@
 /**
  * The event catalog (issue #2029).
  *
- * Exactly 63 entries, matching the `TelemetryEvent` union at
+ * Exactly 64 entries, matching the `TelemetryEvent` union at
  * `src/telemetry.ts:20-172`. Thirty-eight predate the #2029 contract; the 39th is
  * `agent_conflict_detected` (previously emitted through a force-cast past the
  * type system), the 40th is `close_archive_result` (issue #2030 — the
@@ -89,7 +89,7 @@ export interface CatalogEntry {
     /**
      * Whether an event of this kind must carry `trace.parentSpanId`.
      *
-     * `false` for all 63 entries today, and that is a truthful statement about
+     * `false` for all 64 entries today, and that is a truthful statement about
      * the current system rather than a placeholder: no producer supplies a
      * parent span, so `createObservation` never sets one. Setting this to `true`
      * for a kind whose producer cannot supply a parent would make every

package/dist/prm/escalation.d.ts

@@ -2,7 +2,19 @@
  * Escalation Tracker Module
  * Implements a 3-strike protocol for pattern detection escalation
  */
-import type { CourseCorrection, EscalationState, PatternMatch } from './types';
+import type { CourseCorrection, EscalationState, PatternMatch, PrmEpisodeState } from './types';
+export { PRM_HARD_STOP_TERMINAL_EVENT } from './types';
+/**
+ * Issue #2678 — hard-stop detections after the first one (within one episode)
+ * before the episode escalates to its bounded TERMINAL/handoff state.
+ */
+export declare const PRM_HARD_STOP_TERMINAL_REPEATS = 1;
+/**
+ * Issue #2678 — after a terminal handoff, re-escalation of the SAME ladder is
+ * suppressed for this window unless an owner-verified `clearAction` clears the
+ * episode first. 15 minutes mirrors the pattern-persistence cooldown budget.
+ */
+export declare const PRM_TERMINAL_COOLDOWN_MS: number;
 /**
  * Resolves the LADDER key for a match — the identity whose 1→2→3 strike count
  * this detection belongs to (issue #2134 follow-up).
@@ -65,6 +77,9 @@ export declare class EscalationTracker {
         level: number;
         correction: CourseCorrection | null;
         hardStop: boolean;
+        /** Issue #2678 — this detection is the (or is inside the) bounded
+         * TERMINAL/handoff state of the ladder's episode. */
+        terminal: boolean;
     };
     /**
      * Returns a defensive copy of the current escalation state.
@@ -82,6 +97,32 @@ export declare class EscalationTracker {
      * per-tool-call hot path, for one field.
      */
     getLadderCounts(): Map<string, number>;
+    /**
+     * Defensive copy of the per-ladder episode state (issue #2678) — the
+     * `getLadderCounts` precedent: producers mirror this onto the session so a
+     * tracker rebuilt mid-session restores the same episode keyspace.
+     */
+    getEpisodes(): Map<string, PrmEpisodeState>;
+    /** Current generation (issue #2678) — advances on every episode-state
+     * transition; owner-checked resets must match it exactly. */
+    getGeneration(): number;
+    /**
+     * Action-local corrected-success clear (issue #2678): clears ONLY the
+     * matching ladder (its strike count and its episode record — the next
+     * detection starts at level 1) and leaves every unrelated ladder touched.
+     *
+     * Owner semantics: an ownerless call (in-session corrected success —
+     * possession of the tracker IS the session binding) proceeds. When an
+     * `owner` is provided it must match this tracker's exact `sessionId` AND
+     * the current `generation`, else the clear fails closed (returns false,
+     * state untouched) — a stale-generation or foreign-session reset can never
+     * clear current recovery state. Generation advances only on an
+     * owner-provided, matching clear.
+     */
+    clearAction(matchOrKey: PatternMatch | string, owner?: {
+        sessionId: string;
+        generation: number;
+    }): boolean;
     /**
      * Resets all escalation counts and flags to their default values.
      * Clears pattern counts and all flags.

package/dist/prm/index.d.ts

@@ -82,6 +82,10 @@ interface ResettablePrmSessionState {
     prmStruckEpisodes?: Map<string, number>;
     /** Issue #2134 follow-up — ladder counts; reset with the ledger. */
     prmLadderCounts?: Map<string, number>;
+    /** Issue #2678 — hard-stop episodes; reset with the ladder counts. */
+    prmEpisodes?: Map<string, import('./types.js').PrmEpisodeState>;
+    /** Issue #2678 — tracker generation; reset with the episodes. */
+    prmEpisodeGeneration?: number;
     replayArtifactPath?: string | null;
 }
 export declare function resetPrmSessionState(session: ResettablePrmSessionState, sessionId?: string): void;

package/dist/prm/types.d.ts

@@ -2,6 +2,12 @@
  * PRM (Prompt Response Monitoring) Type Definitions
  * Core types for trajectory logging, pattern detection, and course correction
  */
+/**
+ * Issue #2678 — telemetry event name for the TERMINAL/handoff transition of a
+ * PRM hard-stop episode. Lives here (not in `escalation.ts`) so the telemetry
+ * emitter can import it without a cycle; `escalation.ts` re-exports it.
+ */
+export declare const PRM_HARD_STOP_TERMINAL_EVENT = "prm_hard_stop_terminal";
 /**
  * All detectable pattern types in the SWE-PRM system
  */
@@ -112,6 +118,28 @@ export interface PrmConfig {
     /** Max time for detection in milliseconds */
     detection_timeout_ms: number;
 }
+/**
+ * Per-ladder hard-stop episode state (issue #2678).
+ *
+ * Keyed by the ladder identity (`resolveLadderKey`), so the episode is scoped
+ * to the exact session (the tracker is per-session) + ladder (pattern|target,
+ * or bare pattern for a growing target set — the pattern type is the failure
+ * category). This is the bounded-episode record that turns an unbounded
+ * repeated-stop loop into: first stop → (one repeat) → TERMINAL handoff with
+ * a cooldown, after which a fresh episode may re-escalate.
+ */
+export interface PrmEpisodeState {
+    /** False-to-true latch for the `prm_hard_stop` TRIGGER telemetry — the
+     * trigger fires exactly once per episode, on the transition. */
+    hardStopTriggered: boolean;
+    /** Hard-stop detections after the first one, within this episode. */
+    repeats: number;
+    /** This episode has terminally handed off — no further stop re-arming
+     * for this ladder until the cooldown lapses or an owner-verified clear. */
+    terminal: boolean;
+    /** Epoch-ms deadline until which re-escalation is suppressed. */
+    cooldownUntil: number;
+}
 /**
  * Per-session escalation tracking state
  */
@@ -134,4 +162,12 @@ export interface EscalationState {
     lastPatternDetected: PatternMatch | null;
     /** Whether a hard stop has been triggered */
     hardStopPending: boolean;
+    /** Issue #2678 — per-ladder bounded hard-stop episodes (terminal state,
+     * cooldown, and the trigger latch live here, evicted together with the
+     * ladder's count under `MAX_TRACKED_LADDERS`). */
+    episodes: Map<string, PrmEpisodeState>;
+    /** Issue #2678 — advances on every episode-state transition (hard-stop
+     * trigger, terminal transition, owner-verified clear). Resets carrying an
+     * older generation fail closed in `clearAction`. */
+    generation: number;
 }

package/dist/state.d.ts

@@ -12,7 +12,7 @@ import { type QaGates } from './db/qa-gate-profile.js';
 import { type EnvironmentProfile } from './environment/profile.js';
 import { type TaskWorkflowMetadata } from './gate-evidence';
 import type { EscalationTracker } from './prm/escalation.js';
-import type { PatternMatch } from './prm/types.js';
+import type { PatternMatch, PrmEpisodeState } from './prm/types.js';
 import type { ReviewRouteEvidence } from './review/routing-enforcement.js';
 import { AgentRunContext } from './state/agent-run-context.js';
 export { AgentRunContext } from './state/agent-run-context.js';
@@ -510,6 +510,13 @@ export interface AgentSessionState {
      * mis-restore every count.
      */
     prmLadderCounts?: Map<string, number>;
+    /** Issue #2678 — per-ladder hard-stop episode state mirrored from the
+     * escalation tracker (terminal flag, cooldown, trigger latch); reset with
+     * the ladder counts it is keyed alongside. Not serialized. */
+    prmEpisodes?: Map<string, PrmEpisodeState>;
+    /** Issue #2678 — tracker generation mirrored per strike; owner-checked
+     * PRM resets must match it exactly or fail closed. */
+    prmEpisodeGeneration?: number;
     /**
      * Issue #2134 — dispatch identity of the delegation whose start already reset
      * this session's PRM state. Holds the Task tool `callID`, which is unique per

package/dist/telemetry.d.ts

@@ -28,6 +28,14 @@ export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activa
  * package root so no user home path is written to the ledger.
  */
  | 'swarm_internals_read_denied' | 'prm_pattern_detected' | 'prm_course_correction_injected' | 'prm_escalation_triggered' | 'prm_hard_stop'
+/**
+ * Issue #2678 — a PRM hard-stop EPISODE reached its bounded TERMINAL/handoff
+ * state, fired exactly once per terminal transition by
+ * `src/prm/escalation.ts`. The third of the three noninterchangeable PRM
+ * stop counters: TRIGGER (`prm_hard_stop`), DELIVERY
+ * (`prm_hard_stop_delivered`), TERMINAL (this member).
+ */
+ | 'prm_hard_stop_terminal'
 /**
  * Issue #2063 C2 — DELIVERY of a PRM hard stop, as distinct from the
  * `prm_hard_stop` TRIGGER emitted by `src/prm/escalation.ts`. A trigger with
@@ -253,6 +261,15 @@ export declare const telemetry: {
     prmCourseCorrectionInjected(sessionId: string, pattern: string, level: number): void;
     prmEscalationTriggered(sessionId: string, pattern: string, level: number, occurrenceCount: number): void;
     prmHardStop(sessionId: string, pattern: string, level: number, occurrenceCount: number): void;
+    /**
+     * Issue #2678 — a PRM hard-stop EPISODE reached its bounded TERMINAL/handoff
+     * state. Fired exactly once per terminal transition by the escalation
+     * tracker. Distinct from `prm_hard_stop` (the TRIGGER, once per
+     * false-to-true transition) and `prm_hard_stop_delivered` (the DELIVERY,
+     * emitted by the guardrails deny consumer): the three counters are
+     * noninterchangeable.
+     */
+    prmHardStopTerminal(sessionId: string, pattern: string, level: number, occurrenceCount: number): void;
     /**
      * Close/archive structured result (issue #2030). This single event is the
      * shared source of truth for both the user-facing close summary prose and

package/dist/tools/approve-retry-sounding-board.d.ts

@@ -0,0 +1,5 @@
+import { createSwarmTool } from './create-tool.js';
+export declare function executeApproveRetrySoundingBoard(args: unknown, directory: string, context?: {
+    sessionID?: string;
+}): Promise<string>;
+export declare const approve_retry_sounding_board: ReturnType<typeof createSwarmTool>;

package/dist/tools/index.d.ts

@@ -98,6 +98,7 @@ export type { FlakyTestEntry } from '../test-impact/flaky-detector.js';
 export { computeFlakyScore, detectFlakyTests, isTestQuarantined, } from '../test-impact/flaky-detector.js';
 export { abort_pr_workflow, executeAbortPrWorkflow, } from './abort-pr-workflow';
 export { approve_plan_critic, executeApprovePlanCritic, } from './approve-plan-critic';
+export { approve_retry_sounding_board, executeApproveRetrySoundingBoard, } from './approve-retry-sounding-board';
 export { authorize_pr_review_reentry } from './authorize-pr-review-reentry';
 export { complete_pr_workflow, executeCompletePrWorkflow, } from './complete-pr-workflow';
 export { epic_plan_waves } from './epic-plan-waves';

package/dist/tools/manifest.d.ts

@@ -47,6 +47,7 @@ export declare const TOOL_MANIFEST: {
     authorize_pr_review_reentry: () => ToolDefinition;
     submit_pr_review_result: () => ToolDefinition;
     approve_plan_critic: () => ToolDefinition;
+    approve_retry_sounding_board: () => ToolDefinition;
     prepare_pr_workflow_checkout: () => ToolDefinition;
     record_implementation_review: () => ToolDefinition;
     record_issue_publication: () => ToolDefinition;

package/dist/tools/repo-map.d.ts

@@ -60,6 +60,7 @@ export declare const _internals: {
         prmCourseCorrectionInjected(sessionId: string, pattern: string, level: number): void;
         prmEscalationTriggered(sessionId: string, pattern: string, level: number, occurrenceCount: number): void;
         prmHardStop(sessionId: string, pattern: string, level: number, occurrenceCount: number): void;
+        prmHardStopTerminal(sessionId: string, pattern: string, level: number, occurrenceCount: number): void;
         closeArchiveResult(data: {
             archive_valid: boolean;
             archive_empty: boolean;

package/dist/tools/tool-metadata.d.ts

@@ -173,6 +173,10 @@ export declare const TOOL_METADATA: {
         description: string;
         agents: "architect"[];
     };
+    approve_retry_sounding_board: {
+        description: string;
+        agents: "architect"[];
+    };
     prepare_pr_workflow_checkout: {
         description: string;
         agents: "architect"[];

package/dist/types/events.d.ts

@@ -52,7 +52,11 @@ export interface CoderRetryCircuitBreakerEvent {
     rejectionCount: number;
     rejectionHistory: string[];
     phase: number;
-    action: 'sounding_board_consultation' | 'simplification' | 'user_escalation';
+    action: 'sounding_board_consultation' | 'simplification' | 'user_escalation' | 'sounding_board_manual_approval';
+    /** Present only on sounding_board_manual_approval (issue #2703): the
+     * architect-stated justification for the manual override, bounded to 500
+     * chars by the recorder. */
+    reason?: string;
 }
 export interface AgentConflictDetectedEvent {
     type: 'agent_conflict_detected';
@@ -183,4 +187,18 @@ export interface PrmHardStopDeliveredEvent {
     level: number;
     occurrenceCount: number;
 }
-export type V619Event = SoundingBoardConsultedEvent | ArchitectLoopDetectedEvent | PrecedentManipulationDetectedEvent | CoderSelfAuditEvent | CoderRetryCircuitBreakerEvent | AgentConflictDetectedEvent | AuthorityHandoffResolvedEvent | SpecStaleDetectedEvent | SpecDriftAcknowledgedEvent | SpecDriftRepairedEvent | TaskWorkflowRepairedEvent | TaskRemovedEvent | PrmPatternDetectedEvent | PrmCourseCorrectionInjectedEvent | PrmEscalationTriggeredEvent | PrmHardStopEvent | PrmHardStopDeliveredEvent;
+/**
+ * Issue #2678 — a PRM hard-stop EPISODE reached its bounded TERMINAL/handoff
+ * state (fired exactly once per terminal transition). The third of the three
+ * noninterchangeable counters: TRIGGER (`prm_hard_stop`), DELIVERY
+ * (`prm_hard_stop_delivered`), TERMINAL (this event).
+ */
+export interface PrmHardStopTerminalEvent {
+    type: 'prm_hard_stop_terminal';
+    timestamp: string;
+    sessionId: string;
+    pattern: string;
+    level: number;
+    occurrenceCount: number;
+}
+export type V619Event = SoundingBoardConsultedEvent | ArchitectLoopDetectedEvent | PrecedentManipulationDetectedEvent | CoderSelfAuditEvent | CoderRetryCircuitBreakerEvent | AgentConflictDetectedEvent | AuthorityHandoffResolvedEvent | SpecStaleDetectedEvent | SpecDriftAcknowledgedEvent | SpecDriftRepairedEvent | TaskWorkflowRepairedEvent | TaskRemovedEvent | PrmPatternDetectedEvent | PrmCourseCorrectionInjectedEvent | PrmEscalationTriggeredEvent | PrmHardStopEvent | PrmHardStopTerminalEvent | PrmHardStopDeliveredEvent;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.176.2",
+	"version": "7.177.1",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -98,6 +98,7 @@
 		"lint": "biome lint .",
 		"lint:ci": "biome ci .",
 		"test:unit:ci": "bun scripts/ci/run-unit-tests-local.ts",
+		"validate:repo": "bun scripts/ci/repository-validation.ts",
 		"drift:check": "bun run scripts/drift-check.ts",
 		"check:pre-push": "bun run scripts/drift-check.ts --enforce --no-report && bun run check:registry-citations",
 		"schema:generate": "bun run scripts/generate-config-schema.ts",

package/dist/cli/curator-llm-factory-bvck3388.js

@@ -1,72 +0,0 @@
-// @bun
-import {
-  createCuratorLLMDelegate
-} from "./index-kc9jbsxh.js";
-import"./index-hnvmj9wx.js";
-import"./index-02sbqp2j.js";
-import"./index-vqhpemaw.js";
-import"./index-fsrfamds.js";
-import"./index-30dx8h76.js";
-import"./index-tfvtf8z5.js";
-import"./index-36gm5wzh.js";
-import"./index-txdagbh7.js";
-import"./index-n1tcj1q7.js";
-import"./index-fpbcxykc.js";
-import"./index-7yms2y29.js";
-import"./index-d3mzw88v.js";
-import"./index-nmrcgs2v.js";
-import"./index-fyfbpz4f.js";
-import"./index-yj8hn89a.js";
-import"./index-549wxbe1.js";
-import"./index-zsrtt42s.js";
-import"./index-ycb3h9gp.js";
-import"./index-yss54mb9.js";
-import"./index-b6xgqf81.js";
-import"./index-pt7h91zc.js";
-import"./index-q7sjgr1y.js";
-import"./index-g364gm8a.js";
-import"./index-mezy2tc7.js";
-import"./index-pgtrsc2t.js";
-import"./index-yg3aqync.js";
-import"./index-gaa1h7rv.js";
-import"./index-2s7dvzff.js";
-import"./index-z7f3z7t0.js";
-import"./index-agwajtws.js";
-import"./index-rtry5xyf.js";
-import"./index-3gmfzg4w.js";
-import"./index-frcemc0b.js";
-import"./index-wrt875kh.js";
-import"./index-hc00tn5a.js";
-import"./index-6kn88mce.js";
-import"./index-fwjenx4w.js";
-import"./index-mw5k6s43.js";
-import"./index-p2r8cejw.js";
-import"./index-nxgbfgmc.js";
-import"./index-rdm3px0g.js";
-import"./index-ry16d01s.js";
-import"./index-swhxs3n7.js";
-import"./index-gq1qbzsw.js";
-import"./index-vzm6zre7.js";
-import"./index-ae75rja9.js";
-import"./index-bh07vpsw.js";
-import"./index-25aq56s9.js";
-import"./index-7g4c7s5r.js";
-import"./index-68nc7zev.js";
-import"./index-g4m0t1y4.js";
-import"./index-1xnse449.js";
-import"./index-c1ggtmpm.js";
-import"./index-pedvpj59.js";
-import"./index-zz7gzw57.js";
-import"./index-4ddpvd5c.js";
-import"./index-1d28c88a.js";
-import"./index-5frh43fj.js";
-import"./index-bk5tah7q.js";
-import"./index-gknz3bv1.js";
-import"./index-zpsr8rpc.js";
-import"./index-76qm2c2y.js";
-import"./index-yzjaj53h.js";
-import"./index-zgwm4ryv.js";
-import"./index-a76rekgs.js";
-export {
-  createCuratorLLMDelegate
-};

package/dist/cli/guardrail-explain-vs575z3y.js

@@ -1,73 +0,0 @@
-// @bun
-import {
-  handleGuardrailExplain
-} from "./index-dp0zm7mj.js";
-import"./index-kc9jbsxh.js";
-import"./index-hnvmj9wx.js";
-import"./index-02sbqp2j.js";
-import"./index-vqhpemaw.js";
-import"./index-fsrfamds.js";
-import"./index-30dx8h76.js";
-import"./index-tfvtf8z5.js";
-import"./index-36gm5wzh.js";
-import"./index-txdagbh7.js";
-import"./index-n1tcj1q7.js";
-import"./index-fpbcxykc.js";
-import"./index-7yms2y29.js";
-import"./index-d3mzw88v.js";
-import"./index-nmrcgs2v.js";
-import"./index-fyfbpz4f.js";
-import"./index-yj8hn89a.js";
-import"./index-549wxbe1.js";
-import"./index-zsrtt42s.js";
-import"./index-ycb3h9gp.js";
-import"./index-yss54mb9.js";
-import"./index-b6xgqf81.js";
-import"./index-pt7h91zc.js";
-import"./index-q7sjgr1y.js";
-import"./index-g364gm8a.js";
-import"./index-mezy2tc7.js";
-import"./index-pgtrsc2t.js";
-import"./index-yg3aqync.js";
-import"./index-gaa1h7rv.js";
-import"./index-2s7dvzff.js";
-import"./index-z7f3z7t0.js";
-import"./index-agwajtws.js";
-import"./index-rtry5xyf.js";
-import"./index-3gmfzg4w.js";
-import"./index-frcemc0b.js";
-import"./index-wrt875kh.js";
-import"./index-hc00tn5a.js";
-import"./index-6kn88mce.js";
-import"./index-fwjenx4w.js";
-import"./index-mw5k6s43.js";
-import"./index-p2r8cejw.js";
-import"./index-nxgbfgmc.js";
-import"./index-rdm3px0g.js";
-import"./index-ry16d01s.js";
-import"./index-swhxs3n7.js";
-import"./index-gq1qbzsw.js";
-import"./index-vzm6zre7.js";
-import"./index-ae75rja9.js";
-import"./index-bh07vpsw.js";
-import"./index-25aq56s9.js";
-import"./index-7g4c7s5r.js";
-import"./index-68nc7zev.js";
-import"./index-g4m0t1y4.js";
-import"./index-1xnse449.js";
-import"./index-c1ggtmpm.js";
-import"./index-pedvpj59.js";
-import"./index-zz7gzw57.js";
-import"./index-4ddpvd5c.js";
-import"./index-1d28c88a.js";
-import"./index-5frh43fj.js";
-import"./index-bk5tah7q.js";
-import"./index-gknz3bv1.js";
-import"./index-zpsr8rpc.js";
-import"./index-76qm2c2y.js";
-import"./index-yzjaj53h.js";
-import"./index-zgwm4ryv.js";
-import"./index-a76rekgs.js";
-export {
-  handleGuardrailExplain
-};