opencode-swarm 7.19.0 → 7.19.2

package/dist/plan/ledger.d.ts

@@ -6,13 +6,18 @@
  */
 import { type Plan } from '../config/plan-schema';
 /**
- * Ledger schema version
+ * Ledger schema version.
+ *
+ * v7.19.0: bumped from 1.0.0 → 1.1.0 with the addition of `task_removed`.
+ * Older plugin readers throw on unknown event types (applyEventToPlan default
+ * branch); restart any running OpenCode session after upgrade so the new
+ * reader is loaded in-process.
  */
-export declare const LEDGER_SCHEMA_VERSION = "1.0.0";
+export declare const LEDGER_SCHEMA_VERSION = "1.1.0";
 /**
  * Valid ledger event types
  */
-export declare const LEDGER_EVENT_TYPES: readonly ["plan_created", "task_added", "task_updated", "task_status_changed", "task_reordered", "phase_completed", "plan_rebuilt", "plan_exported", "plan_reset", "snapshot", "execution_profile_set", "execution_profile_locked"];
+export declare const LEDGER_EVENT_TYPES: readonly ["plan_created", "task_added", "task_removed", "task_updated", "task_status_changed", "task_reordered", "phase_completed", "plan_rebuilt", "plan_exported", "plan_reset", "snapshot", "execution_profile_set", "execution_profile_locked"];
 export type LedgerEventType = (typeof LEDGER_EVENT_TYPES)[number];
 /**
  * A ledger event representing a plan mutation.

package/dist/plan/manager.d.ts

@@ -6,6 +6,38 @@
 export declare class PlanConcurrentModificationError extends Error {
     constructor(message: string);
 }
+/**
+ * Thrown when savePlan detects that the incoming plan would silently drop one
+ * or more tasks from the prior plan without the caller acknowledging the
+ * removal (issue #853).
+ *
+ * Callers must pass `options.acknowledged_removals.ids` covering every missing
+ * task id together with a non-empty reason to proceed.
+ */
+export declare class PlanTaskRemovalNotAcknowledgedError extends Error {
+    readonly missingTasks: Array<{
+        id: string;
+        phase: number;
+        status: TaskStatus;
+    }>;
+    constructor(missingTasks: Array<{
+        id: string;
+        phase: number;
+        status: TaskStatus;
+    }>);
+}
+/**
+ * Caller-supplied acknowledgement that a save_plan operation is intentionally
+ * removing tasks from the prior plan (issue #853). Passed to savePlan via the
+ * `acknowledged_removals` option; `ids` must list every task id missing from
+ * the incoming plan; `reason` must be non-empty; `source` identifies the
+ * caller (e.g. 'save_plan_tool', 'phase_complete_rebuild_from_ledger').
+ */
+export interface AcknowledgedRemovals {
+    ids: string[];
+    reason: string;
+    source: string;
+}
 import { type Plan, type RuntimePlan, type TaskStatus } from '../config/plan-schema';
 import { type LedgerEvent, type LedgerEventInput } from './ledger';
 /** Reset the startup ledger check flag. For testing only. */
@@ -63,12 +95,32 @@ export declare function regeneratePlanMarkdown(directory: string, plan: Plan): P
  * 4. Neither exists -> return null
  */
 export declare function loadPlan(directory: string): Promise<RuntimePlan | null>;
+/**
+ * Recovery-path helper for callers that legitimately need to replace the
+ * plan task set without explicit per-id acknowledgement (e.g. rebuilding
+ * from the ledger after replay, importing an external checkpoint, or
+ * recovering from a critic-approved snapshot).
+ *
+ * Diffs the on-disk plan against the incoming plan, auto-populates
+ * `acknowledged_removals` with every missing id, and delegates to savePlan.
+ * The architect-facing save_plan tool MUST NOT use this — it should fail
+ * closed and require the caller to enumerate removals explicitly.
+ *
+ * Returns the count of auto-acknowledged removals so the caller can attach
+ * `_midLoadRemovals` to the RuntimePlan for Layer A disclosure.
+ */
+export declare function savePlanWithAutoAcknowledgedRemovals(directory: string, plan: Plan, source: string, reason: string, options?: {
+    preserveCompletedStatuses?: boolean;
+}): Promise<{
+    removedCount: number;
+}>;
 /**
  * Validate against PlanSchema (throw on invalid), write to .swarm/plan.json via atomic temp+rename pattern,
  * then derive and write .swarm/plan.md
  */
 export declare function savePlan(directory: string, plan: Plan, options?: {
     preserveCompletedStatuses?: boolean;
+    acknowledged_removals?: AcknowledgedRemovals;
 }): Promise<void>;
 /**
  * Rebuild plan from ledger events.

package/dist/services/status-service.d.ts

@@ -46,6 +46,14 @@ export interface StatusData {
     compactionCount: number;
     /** ISO timestamp of last compaction snapshot, or null if none */
     lastSnapshotAt: string | null;
+    /** Issue #853 Layer C: true if spec drift was detected for this plan */
+    specStale?: boolean;
+    /** Reason text from .swarm/spec-staleness.json (or RuntimePlan._specStaleReason) */
+    specStaleReason?: string;
+    /** Stored spec hash from when the plan was last saved */
+    specStaleStoredHash?: string;
+    /** Current spec.md hash on disk (null when spec.md is missing) */
+    specStaleCurrentHash?: string | null;
 }
 /**
  * Get status data from the swarm directory.

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

@@ -33,6 +33,25 @@ export interface SavePlanArgs {
      * after a failed phase).  Defaults to false (existing statuses preserved).
      */
     reset_statuses?: boolean;
+    /**
+     * Issue #853: tasks that are present in the prior plan but intentionally
+     * being removed by this save. Every task missing from `phases` must be
+     * enumerated here, otherwise save_plan rejects with
+     * `PLAN_TASK_REMOVAL_NOT_ACKNOWLEDGED`.
+     */
+    removed_task_ids?: string[];
+    /**
+     * Human-readable reason for the removals listed in `removed_task_ids`.
+     * Must be non-empty when `removed_task_ids` is non-empty. Recorded on
+     * each `task_removed` ledger event for audit.
+     */
+    removal_reason?: string;
+    /**
+     * Required when both `reset_statuses` is true AND at least one task is
+     * missing from the new plan. Without this flag set, save_plan rejects to
+     * prevent a destructive reset from silently dropping unfinished work.
+     */
+    confirm_destructive_reset?: boolean;
     /**
      * Architect-facing concurrency controls for this plan.
      * When execution_profile.locked is true the profile is immutable — subsequent

package/dist/tools/test-runner.d.ts

@@ -4,6 +4,7 @@ export declare const MAX_COMMAND_LENGTH = 500;
 export declare const DEFAULT_TIMEOUT_MS = 60000;
 export declare const MAX_TIMEOUT_MS = 300000;
 export declare const MAX_SAFE_TEST_FILES = 50;
+export declare const MAX_SAFE_SOURCE_FILES = 1;
 export declare const SUPPORTED_FRAMEWORKS: readonly ["bun", "vitest", "jest", "mocha", "pytest", "cargo", "pester", "go-test", "maven", "gradle", "dotnet-test", "ctest", "swift-test", "dart-test", "rspec", "minitest"];
 export type TestFramework = (typeof SUPPORTED_FRAMEWORKS)[number] | 'none';
 export interface TestRunnerArgs {

package/dist/types/events.d.ts

@@ -90,6 +90,26 @@ export interface SpecDriftAcknowledgedEvent {
     previousHash: string;
     newHash: string | null;
 }
+/**
+ * Emitted whenever savePlan removes one or more tasks from the prior plan
+ * (issue #853). Functional during replayFromLedger (post-merge fix) — the
+ * ledger commit precedes the plan.json rename, so rebuild must drop the
+ * task to maintain crash consistency. The `source` identifies the caller
+ * (e.g. 'save_plan_tool', 'phase_complete_rebuild_from_ledger'); the
+ * removal reason rides on the `payload` envelope to match LedgerEvent.
+ */
+export interface TaskRemovedEvent {
+    type: 'task_removed';
+    timestamp: string;
+    task_id: string;
+    phase_id: number;
+    from_status: string;
+    source: string;
+    payload?: {
+        reason?: string;
+        source?: string;
+    };
+}
 export interface PrmPatternDetectedEvent {
     type: 'prm_pattern_detected';
     timestamp: string;
@@ -122,4 +142,4 @@ export interface PrmHardStopEvent {
     level: number;
     occurrenceCount: number;
 }
-export type V619Event = SoundingBoardConsultedEvent | ArchitectLoopDetectedEvent | PrecedentManipulationDetectedEvent | CoderSelfAuditEvent | CoderRetryCircuitBreakerEvent | AgentConflictDetectedEvent | AuthorityHandoffResolvedEvent | SpecStaleDetectedEvent | SpecDriftAcknowledgedEvent | PrmPatternDetectedEvent | PrmCourseCorrectionInjectedEvent | PrmEscalationTriggeredEvent | PrmHardStopEvent;
+export type V619Event = SoundingBoardConsultedEvent | ArchitectLoopDetectedEvent | PrecedentManipulationDetectedEvent | CoderSelfAuditEvent | CoderRetryCircuitBreakerEvent | AgentConflictDetectedEvent | AuthorityHandoffResolvedEvent | SpecStaleDetectedEvent | SpecDriftAcknowledgedEvent | TaskRemovedEvent | PrmPatternDetectedEvent | PrmCourseCorrectionInjectedEvent | PrmEscalationTriggeredEvent | PrmHardStopEvent;

package/package.json

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