opencode-swarm 7.184.6 → 7.184.8

package/dist/services/context-budget-service.d.ts

@@ -84,6 +84,16 @@ export declare const DEFAULT_CONTEXT_BUDGET_CONFIG: ContextBudgetConfig;
  * authoritative when available.
  */
 export declare function estimateTokens(text: string): number;
+/**
+ * Schema shape of the `plan_cursor` config block (see PlanCursorConfigSchema
+ * in src/config/schema.ts). Named — not inline — so guarded signatures stay
+ * brace-free for the trusted-root validator's body matcher.
+ */
+interface PlanCursorConfigShape {
+    enabled?: boolean;
+    max_tokens?: number;
+    lookahead_tasks?: number;
+}
 /**
  * Get context budget report with detailed token breakdown
  *
@@ -92,7 +102,7 @@ export declare function estimateTokens(text: string): number;
  * @param config - Budget configuration
  * @returns Context budget report
  */
-export declare function getContextBudgetReport(directory: string, assembledSystemPrompt: string, config: ContextBudgetConfig): Promise<ContextBudgetReport>;
+export declare function getContextBudgetReport(directory: string, assembledSystemPrompt: string, config: ContextBudgetConfig, planCursor?: PlanCursorConfigShape): Promise<ContextBudgetReport>;
 /**
  * Format budget warning message based on report
  *
@@ -108,3 +118,4 @@ export declare function formatBudgetWarning(report: ContextBudgetReport, directo
  * @returns Default configuration
  */
 export declare function getDefaultConfig(): ContextBudgetConfig;
+export {};

package/dist/tools/index.d.ts

@@ -127,6 +127,7 @@ export { executeRecordMergeApproval, record_merge_approval, } from './record-mer
 export { executeRecordRecurrenceSweep, record_recurrence_sweep, } from './record-recurrence-sweep';
 export { executeRecordTraceValidation, record_trace_validation, } from './record-trace-validation';
 export { executeRecoverReworkTask, recover_rework_task, } from './recover-rework-task';
+export { executeRecoverStageATask, recover_stage_a_task, } from './recover-stage-a-task';
 export { executeRunPrFeedbackStageA, run_pr_feedback_stage_a, } from './run-pr-feedback-stage-a';
 export { symbols } from './symbols';
 export { type SyntaxCheckFileResult, type SyntaxCheckInput, type SyntaxCheckResult, syntax_check, syntaxCheck, } from './syntax-check';

package/dist/tools/manifest.d.ts

@@ -49,6 +49,7 @@ export declare const TOOL_MANIFEST: {
     approve_plan_critic: () => ToolDefinition;
     approve_retry_sounding_board: () => ToolDefinition;
     recover_rework_task: () => ToolDefinition;
+    recover_stage_a_task: () => ToolDefinition;
     prepare_pr_workflow_checkout: () => ToolDefinition;
     record_implementation_review: () => ToolDefinition;
     record_issue_publication: () => ToolDefinition;

package/dist/tools/record-branch-freshness.d.ts

@@ -9,6 +9,12 @@
  * whether the outcome permits the trace: synced permits, behind never
  * permits, fetch-failed permits only with a non-empty recorded override.
  * The reducer's FRESHNESS_GATE consumes that verdict before PLAN.
+ *
+ * The persist step goes through the canonical atomic writer
+ * (src/utils/atomic-write.ts), which owns exact own-temp cleanup and the
+ * bounded Windows rename retry (issue #2788). The response's `permits` field
+ * is the gate READER's verdict computed from the persisted receipt — an
+ * advisory read-back for the calling agent, never consumed by the reducer.
  */
 import { createSwarmTool } from './create-tool';
 export declare function executeRecordBranchFreshness(args: unknown, directory: string, context?: {

package/dist/tools/record-trace-validation.d.ts

@@ -10,6 +10,17 @@
  * recorded phase's latest run passed". The reducer's TRACE_VALIDATION_GATE
  * blocks the commit-pr handoff while any entry is missing, failing, or
  * malformed.
+ *
+ * The read-modify-write upsert runs under the per-file receipt lock
+ * (tryAcquireLock, keyed by this receipt's name — the same keyed-lock family
+ * as plan.json and the MCP receipt journal) so concurrent invocations
+ * serialize instead of silently dropping entries; contention resolves to
+ * serialization or a typed busy failure, never last-writer-wins (issue #2788).
+ * The persist step goes through the canonical atomic writer
+ * (src/utils/atomic-write.ts), which owns exact own-temp cleanup and the
+ * bounded Windows rename retry. The response's `allGreen` field is the gate
+ * READER's verdict computed from the persisted receipt — an advisory
+ * read-back for the calling agent, never consumed by the reducer.
  */
 import { createSwarmTool } from './create-tool';
 export declare function executeRecordTraceValidation(args: unknown, directory: string, context?: {

package/dist/tools/recover-stage-a-task.d.ts

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

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

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

package/dist/workflow/settlement-recovery.d.ts

@@ -0,0 +1,52 @@
+export interface SettlementRecoverySummary {
+    taskId: string;
+    generation: number;
+    state: string;
+    transitionId: string;
+    recordedAt: string;
+    /** True when the recovery was a no-op because Stage A was already recorded. */
+    alreadyRecovered: boolean;
+    /**
+     * Whether the stage_a_repair audit event actually landed in
+     * `.swarm/events.jsonl`. The durable transition is authoritative regardless;
+     * this surfaces the best-effort append honestly instead of asserting an
+     * audit record that may not exist (issue #2755 review, FB-001 contract).
+     */
+    auditEventRecorded: boolean;
+}
+/**
+ * Architect-supervised settlement-backed Stage A recovery (issue #2828).
+ *
+ * The mechanical `stage_a_passed` transition deliberately fails closed from
+ * `idle` and `blocked` (`TASK_WORKFLOW_CODER_MUTATION_REQUIRED` /
+ * `TASK_WORKFLOW_TERMINAL`): those labels say the task never started or was
+ * deliberately stopped. But the durable receipts can disagree — a COMMITTED
+ * accepted coder settlement (the code is committed) plus green
+ * post-settlement pre-check bundles (it passed Stage A checks) while the
+ * workflow label drifted (`repair_idle` force-repair cleared the proofs, or
+ * `task_blocked` moved past a recorded pass). Until this recovery, that
+ * disagreement was a total deadlock: `/swarm recover` refused, a
+ * `pre_check_batch` re-run could never re-record Stage A (attribution
+ * requires `coder_delegated`), `recover_rework_task` requires exactly
+ * `rework_required`, and re-dispatching the coder produces no mutation.
+ *
+ * This is the audited escape hatch the #2755 `recover_rework_task`
+ * precedent established for the same class: it writes the SAME durable
+ * transition the mechanical path would have written, admitted ONLY by the
+ * `settlementRecovery` flag the reducer accepts from `idle`/`blocked`, and
+ * records a distinguishable `stage_a_repair` audit event. Every
+ * precondition fails closed; the deterministic `/swarm recover`
+ * settlement-wedge scan and the mechanical recorder are untouched.
+ *
+ * Unlike `recover_rework_task` there is no plan-membership precondition: the
+ * durable predicates (evidence file + COMMITTED accepted settlement WAL +
+ * green post-settlement bundles) already bind the repair to a task that
+ * genuinely had a settled coder dispatch, and the deterministic
+ * `/swarm recover` scan this tool mirrors enumerates evidence files the same
+ * way, plan or no plan. Requiring plan.json here would re-introduce exactly
+ * the extra-refusal wedge class this recovery removes.
+ */
+export declare function recoverStageATaskSupervised(directory: string, sessionID: string, options: {
+    taskId: string;
+    reason?: string;
+}): Promise<SettlementRecoverySummary>;

package/dist/workflow/stage-a-repair.d.ts

@@ -1,3 +1,4 @@
+import { type CoderSettlementWalState } from './coder-settlement.js';
 import { type TaskRecoveryStatus } from './task-recovery-status.js';
 export type StageARepairOutcome = {
     taskId: string;
@@ -69,6 +70,8 @@ export type PreCheckGreennessResult = {
  * with individual entries tagged `type: 'sast'`.
  */
 export declare function hasGreenPostSettlementPreCheck(directory: string, settledAfterMs: number | null): Promise<PreCheckGreennessResult>;
+/** Latest COMMITTED settlement facts for one task, from the shared WAL listing. */
+export declare function latestCommittedAcceptedSettlementMs(taskId: string, walStates: readonly CoderSettlementWalState[]): number | null;
 export interface StageAScanResult {
     /** One entry per enumerated task, classified in the shared #2665 vocabulary. */
     results: TaskRecoveryStatus[];
@@ -86,14 +89,16 @@ export declare function scanWedgedStageA(directory: string, options?: {
     taskIds?: string[];
 }): Promise<StageAScanResult>;
 /**
- * Repair path for tasks already wedged at `coder_delegated`
- * (TASK_WORKFLOW_STAGE_A_REQUIRED post-reset wedge). For each flat task
- * evidence file whose workflow store sits at `coder_delegated` with no
- * pre_check gate proof AND a green post-settlement pre-check bundle, emits
- * the missing `stage_a_passed` transition directly and appends an audit
- * event. Never re-runs the coder; live DISPATCHED/PREPARED settlement WALs
- * refuse the transition loudly (CODER_SETTLEMENT_IN_PROGRESS) and surface as
- * per-task errors without blocking siblings.
+ * Repair path for tasks wedged without a recorded Stage A (issue #2665 live
+ * wedge; issue #2828 settlement wedge). For each flat task evidence file
+ * whose workflow store sits at `coder_delegated` with no pre_check gate proof
+ * AND a green post-settlement pre-check bundle — or whose workflow drifted to
+ * `idle`/`blocked` while a COMMITTED accepted coder settlement plus green
+ * post-settlement pre-check proof still justify Stage A — emits the missing
+ * `stage_a_passed` transition directly and appends an audit event. Never
+ * re-runs the coder; live DISPATCHED/PREPARED settlement WALs refuse the
+ * transition loudly (CODER_SETTLEMENT_IN_PROGRESS) and surface as per-task
+ * errors without blocking siblings.
  */
 export declare function repairWedgedStageA(directory: string, options?: {
     taskIds?: string[];

package/dist/workflow/task-recovery-status.d.ts

@@ -12,7 +12,7 @@
  */
 import type { TaskEvidence, TaskWorkflowSnapshot } from '../gate-evidence.js';
 import type { CoderSettlementWalState } from './coder-settlement.js';
-export type TaskRecoveryCategory = 'healthy' | 'missing' | 'stale' | 'ambiguous' | 'corrupt' | 'live_wedge';
+export type TaskRecoveryCategory = 'healthy' | 'missing' | 'stale' | 'ambiguous' | 'corrupt' | 'live_wedge' | 'settlement_wedge';
 export interface TaskRecoveryStatus {
     taskId: string;
     category: TaskRecoveryCategory;
@@ -52,7 +52,16 @@ export declare function classifySettlementWalState(entry: CoderSettlementWalStat
  * the coder and never edits evidence speculatively) when green
  * post-settlement pre-check proof exists.
  */
-export declare function classifyEvidenceRecoveryTask(taskId: string, evidence: TaskEvidence | null, greenPreCheck: boolean | null): TaskRecoveryStatus;
+export declare function classifyEvidenceRecoveryTask(taskId: string, evidence: TaskEvidence | null, greenPreCheck: boolean | null, options?: {
+    /**
+     * The scan verified a COMMITTED settlement WAL with `accepted === true`
+     * for this task (issue #2828). Only the wedge scan supplies this; it
+     * distinguishes a settlement wedge (idle/blocked state whose durable
+     * receipts still justify Stage A) from an ordinary not-started or
+     * terminal task.
+     */
+    settlementCommittedAccepted?: boolean;
+}): TaskRecoveryStatus;
 /**
  * One diagnose-detail line per non-healthy task. Healthy tasks are rendered
  * by their COUNT only (never a per-task line) so no category token can

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.184.6",
+	"version": "7.184.8",
 	"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",

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

@@ -1,75 +0,0 @@
-// @bun
-import {
-  createCuratorLLMDelegate
-} from "./index-m62eysrr.js";
-import"./index-8x0vtc05.js";
-import"./index-hamqvzqn.js";
-import"./index-6g664sy8.js";
-import"./index-kkj76rky.js";
-import"./index-77g30h6x.js";
-import"./index-kx3hfpb8.js";
-import"./index-ya32wfkp.js";
-import"./index-txdagbh7.js";
-import"./index-taw9b4v5.js";
-import"./index-6b295cas.js";
-import"./index-qksf7d8b.js";
-import"./index-zm08qe68.js";
-import"./index-k1p87csx.js";
-import"./index-rdec0y3z.js";
-import"./index-ar2gsn6b.js";
-import"./index-cjapb4hy.js";
-import"./index-zsrtt42s.js";
-import"./index-4b8997qs.js";
-import"./index-vyjped9g.js";
-import"./index-3n5zsp31.js";
-import"./index-pt7h91zc.js";
-import"./index-q7sjgr1y.js";
-import"./index-gekvpzaf.js";
-import"./index-7136wpb2.js";
-import"./index-skw3bgg1.js";
-import"./index-h2vpqaf1.js";
-import"./index-3w3cssas.js";
-import"./index-wy3zpwjy.js";
-import"./index-2s7dvzff.js";
-import"./index-dtgj8d9k.js";
-import"./index-earq3mda.js";
-import"./index-rtry5xyf.js";
-import"./index-5j6g6kqj.js";
-import"./index-frcemc0b.js";
-import"./index-0725jpp7.js";
-import"./index-jjdrhr7z.js";
-import"./index-9vbsarg2.js";
-import"./index-jvk95e6y.js";
-import"./index-456awy1p.js";
-import"./index-f0nj3d8z.js";
-import"./index-w9hxzcz4.js";
-import"./index-rdm3px0g.js";
-import"./index-ry16d01s.js";
-import"./index-zzvxj02e.js";
-import"./index-y1xtkdys.js";
-import"./index-vzm6zre7.js";
-import"./index-ae75rja9.js";
-import"./index-475bkab8.js";
-import"./index-xf69xty9.js";
-import"./index-t7hmqgjy.js";
-import"./index-x1gyqgze.js";
-import"./index-mc72pk74.js";
-import"./index-c1ggtmpm.js";
-import"./index-ejhxgyvm.js";
-import"./index-7g4c7s5r.js";
-import"./index-k53a69vb.js";
-import"./index-gx2vp8gx.js";
-import"./index-d4rhnvtf.js";
-import"./index-zxdawwc7.js";
-import"./index-g1aa3sdm.js";
-import"./index-wzec3c4g.js";
-import"./index-bk5tah7q.js";
-import"./index-gknz3bv1.js";
-import"./index-zpsr8rpc.js";
-import"./index-wvghb3x6.js";
-import"./index-9rwhas09.js";
-import"./index-zgwm4ryv.js";
-import"./index-a76rekgs.js";
-export {
-  createCuratorLLMDelegate
-};

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

@@ -1,76 +0,0 @@
-// @bun
-import {
-  handleGuardrailExplain
-} from "./index-5p5tpj50.js";
-import"./index-m62eysrr.js";
-import"./index-8x0vtc05.js";
-import"./index-hamqvzqn.js";
-import"./index-6g664sy8.js";
-import"./index-kkj76rky.js";
-import"./index-77g30h6x.js";
-import"./index-kx3hfpb8.js";
-import"./index-ya32wfkp.js";
-import"./index-txdagbh7.js";
-import"./index-taw9b4v5.js";
-import"./index-6b295cas.js";
-import"./index-qksf7d8b.js";
-import"./index-zm08qe68.js";
-import"./index-k1p87csx.js";
-import"./index-rdec0y3z.js";
-import"./index-ar2gsn6b.js";
-import"./index-cjapb4hy.js";
-import"./index-zsrtt42s.js";
-import"./index-4b8997qs.js";
-import"./index-vyjped9g.js";
-import"./index-3n5zsp31.js";
-import"./index-pt7h91zc.js";
-import"./index-q7sjgr1y.js";
-import"./index-gekvpzaf.js";
-import"./index-7136wpb2.js";
-import"./index-skw3bgg1.js";
-import"./index-h2vpqaf1.js";
-import"./index-3w3cssas.js";
-import"./index-wy3zpwjy.js";
-import"./index-2s7dvzff.js";
-import"./index-dtgj8d9k.js";
-import"./index-earq3mda.js";
-import"./index-rtry5xyf.js";
-import"./index-5j6g6kqj.js";
-import"./index-frcemc0b.js";
-import"./index-0725jpp7.js";
-import"./index-jjdrhr7z.js";
-import"./index-9vbsarg2.js";
-import"./index-jvk95e6y.js";
-import"./index-456awy1p.js";
-import"./index-f0nj3d8z.js";
-import"./index-w9hxzcz4.js";
-import"./index-rdm3px0g.js";
-import"./index-ry16d01s.js";
-import"./index-zzvxj02e.js";
-import"./index-y1xtkdys.js";
-import"./index-vzm6zre7.js";
-import"./index-ae75rja9.js";
-import"./index-475bkab8.js";
-import"./index-xf69xty9.js";
-import"./index-t7hmqgjy.js";
-import"./index-x1gyqgze.js";
-import"./index-mc72pk74.js";
-import"./index-c1ggtmpm.js";
-import"./index-ejhxgyvm.js";
-import"./index-7g4c7s5r.js";
-import"./index-k53a69vb.js";
-import"./index-gx2vp8gx.js";
-import"./index-d4rhnvtf.js";
-import"./index-zxdawwc7.js";
-import"./index-g1aa3sdm.js";
-import"./index-wzec3c4g.js";
-import"./index-bk5tah7q.js";
-import"./index-gknz3bv1.js";
-import"./index-zpsr8rpc.js";
-import"./index-wvghb3x6.js";
-import"./index-9rwhas09.js";
-import"./index-zgwm4ryv.js";
-import"./index-a76rekgs.js";
-export {
-  handleGuardrailExplain
-};