opencode-swarm 7.33.0 → 7.33.1

package/dist/plan/ledger.d.ts

@@ -175,6 +175,15 @@ export declare function appendLedgerEventWithRetry(directory: string, eventInput
     backoffMs?: number;
     verifyValid?: () => Promise<boolean> | boolean;
 }): Promise<LedgerEvent | null>;
+/**
+ * Take a snapshot with bounded retry and always-visible warning logging (FR-004).
+ * Retries up to 3 times with exponential backoff, then logs a visible warning.
+ * Non-fatal — never throws. Shared by save-plan tool and plan manager.
+ */
+export declare function takeSnapshotWithRetry(directory: string, plan: Plan, options?: {
+    planHashAfter?: string;
+    source?: string;
+}): Promise<void>;
 /**
  * Take a snapshot event and append it to the ledger.
  * The snapshot embeds the full Plan payload for ledger-only rebuild.

package/dist/plan/manager.d.ts

@@ -39,7 +39,7 @@ export interface AcknowledgedRemovals {
     source: string;
 }
 import { type Plan, type RuntimePlan, type TaskStatus } from '../config/plan-schema';
-import { type LedgerEvent, type LedgerEventInput } from './ledger';
+import { type LedgerEvent, type LedgerEventInput, takeSnapshotWithRetry } from './ledger';
 /** Reset the startup ledger check flag. For testing only. */
 export declare function resetStartupLedgerCheck(): void;
 /**
@@ -55,6 +55,10 @@ export declare const _internals: {
     loadPlanJsonOnly: typeof loadPlanJsonOnly;
     regeneratePlanMarkdown: typeof regeneratePlanMarkdown;
 };
+/** @internal Test seam for snapshot retry helper */
+export declare const _snapshot_test_exports: {
+    takeSnapshotWithRetry: typeof takeSnapshotWithRetry;
+};
 /**
  * Append a ledger event with exponential-backoff retry on stale-writer conflicts.
  *
@@ -130,7 +134,29 @@ export declare function savePlan(directory: string, plan: Plan, options?: {
  * @param directory - The working directory
  * @returns Reconstructed Plan from ledger, or null if ledger is empty/missing
  */
-export declare function rebuildPlan(directory: string, plan?: Plan): Promise<Plan | null>;
+export declare function rebuildPlan(directory: string, plan?: Plan, options?: {
+    reason?: string;
+}): Promise<Plan | null>;
+/**
+ * Write terminal plan state through the managed write path (FR-002, FR-005, FR-006).
+ *
+ * Used by the `/swarm close` command to record the final plan state when a session
+ * is unconditionally terminated. Unlike `savePlan()`, this function:
+ * - Does NOT re-derive task statuses or enforce locked profiles
+ * - Does NOT use CAS protection (no concurrent writer should be active during close)
+ * - Appends terminal ledger events for audit trail before writing plan files
+ *
+ * @param directory - Project root directory
+ * @param plan - The plan with terminal state already applied by the caller
+ * @param options.closedPhaseIds - Phase IDs that were closed
+ * @param options.closedTaskIds - Task IDs that were closed
+ * @param options.originalStatuses - Optional map of taskId → from_status for ledger events
+ */
+export declare function closePlanTerminalState(directory: string, plan: Plan, options: {
+    closedPhaseIds: number[];
+    closedTaskIds: string[];
+    originalStatuses?: Map<string, string>;
+}): Promise<void>;
 /**
  * Load plan → find task by ID → update status → save → return updated plan.
  * Throw if plan not found or task not found.

package/dist/services/evidence-summary-service.d.ts

@@ -70,6 +70,10 @@ declare function getTaskStatus(task: Task | undefined, bundle: EvidenceBundle |
 /**
  * Check if evidence meets completion criteria for a task
  */
+declare function evidenceCompleteFromEntries(entries: Evidence[]): {
+    isComplete: boolean;
+    missingEvidence: string[];
+};
 declare function isEvidenceComplete(bundle: EvidenceBundle | null): {
     isComplete: boolean;
     missingEvidence: string[];
@@ -116,6 +120,7 @@ export declare const _internals: {
     isAutoSummaryEnabled: typeof isAutoSummaryEnabled;
     normalizeBundleEntries: typeof normalizeBundleEntries;
     getTaskStatus: typeof getTaskStatus;
+    evidenceCompleteFromEntries: typeof evidenceCompleteFromEntries;
     isEvidenceComplete: typeof isEvidenceComplete;
     getTaskBlockers: typeof getTaskBlockers;
     buildTaskSummary: typeof buildTaskSummary;

package/dist/telemetry.d.ts

@@ -1,4 +1,4 @@
-export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activated' | 'delegation_begin' | 'delegation_end' | 'task_state_changed' | 'gate_passed' | 'gate_failed' | 'gate_parse_error' | 'phase_changed' | 'budget_updated' | 'model_fallback' | 'hard_limit_hit' | 'revision_limit_hit' | 'loop_detected' | 'scope_violation' | 'qa_skip_violation' | 'heartbeat' | 'turbo_mode_changed' | 'auto_oversight_escalation' | 'environment_detected' | 'evidence_lock_acquired' | 'evidence_lock_contended' | 'evidence_lock_stale_recovered' | 'plan_ledger_cas_retry' | 'plan_md_write_failed' | 'prm_pattern_detected' | 'prm_course_correction_injected' | 'prm_escalation_triggered' | 'prm_hard_stop';
+export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activated' | 'delegation_begin' | 'delegation_end' | 'task_state_changed' | 'gate_passed' | 'gate_failed' | 'gate_parse_error' | 'phase_changed' | 'budget_updated' | 'model_fallback' | 'hard_limit_hit' | 'revision_limit_hit' | 'loop_detected' | 'scope_violation' | 'qa_skip_violation' | 'heartbeat' | 'turbo_mode_changed' | 'auto_oversight_escalation' | 'environment_detected' | 'evidence_lock_acquired' | 'evidence_lock_contended' | 'evidence_lock_stale_recovered' | 'plan_ledger_cas_retry' | 'plan_md_write_failed' | 'snapshot_failed' | 'prm_pattern_detected' | 'prm_course_correction_injected' | 'prm_escalation_triggered' | 'prm_hard_stop';
 export type TelemetryListener = (event: TelemetryEvent, data: Record<string, unknown>) => void;
 /** @internal - For testing only */
 export declare function resetTelemetryForTesting(): void;

package/dist/tools/save-plan.d.ts

@@ -3,6 +3,11 @@
  * Allows the Architect agent to save structured plans to .swarm/plan.json and .swarm/plan.md.
  */
 import type { ToolDefinition } from '@opencode-ai/plugin/tool';
+import { takeSnapshotWithRetry } from '../plan/ledger';
+/** Test seam for the snapshot retry helper (FR-004). */
+export declare const _test_exports: {
+    takeSnapshotWithRetry: typeof takeSnapshotWithRetry;
+};
 /**
  * Arguments for the save_plan tool
  */
@@ -52,6 +57,13 @@ export interface SavePlanArgs {
      * prevent a destructive reset from silently dropping unfinished work.
      */
     confirm_destructive_reset?: boolean;
+    /**
+     * When true, allows save_plan to overwrite an existing plan that has a
+     * different identity (swarm_id + title). Without this flag, save_plan
+     * rejects with PLAN_IDENTITY_MISMATCH if the incoming identity differs
+     * from the existing plan's identity.
+     */
+    confirm_identity_change?: boolean;
     /**
      * Architect-facing concurrency controls for this plan.
      * When execution_profile.locked is true the profile is immutable — subsequent

package/package.json

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