opencode-swarm 6.13.1 → 6.13.3

package/README.md

@@ -310,6 +310,8 @@ Per-agent overrides:
 | build_check | Runs your project's native build/typecheck |
 | quality_budget | Enforces complexity, duplication, and test ratio limits |
 | pre_check_batch | Runs lint, secretscan, SAST, and quality budget in parallel (~15s vs ~60s sequential) |
+| phase_complete | Enforces phase completion, verifies required agents, requires a valid retrospective evidence bundle, logs events, and resets state |
+
 
 All tools run locally. No Docker, no network calls, no external APIs.
 
@@ -586,11 +588,30 @@ The following tools can be assigned to agents via overrides:
 | `symbols` | Extract exported symbols |
 | `test_runner` | Run project tests |
 | `todo_extract` | Extract TODO/FIXME comments |
+| `phase_complete` | Enforces phase completion, verifies required agents, logs events, resets state |
 
 ---
 
 ## Recent Changes
 
+### v6.13.2 — Pipeline Enforcement
+
+This release adds enforcement-layer tooling and self-healing guardrails:
+
+- **`phase_complete` tool**: Verifies all required agents were dispatched before a phase closes; emits events to `.swarm/events.jsonl`; configurable `enforce`/`warn` policy
+- **Summarization loop fix**: `exempt_tools` config prevents `retrieve_summary` and `task` outputs from being re-summarized (fixes Issue #8)
+- **Same-model adversarial detection**: Warns when coder and reviewer share the same model; `warn`/`gate`/`ignore` policy
+- **Architect test guardrail (HF-1b)**: Prevents architect from running full `bun test` suite — must target specific files one at a time
+- **Docs**: `docs/swarm-briefing.md` (LLM pipeline briefing), Task Field Reference in `docs/planning.md`
+
+### v6.13.1 — Consolidation & Defaults Fix
+
+- **`consolidateSystemMessages`**: Merges multiple system messages into one at index 0
+- **Test isolation helpers**: `createIsolatedTestEnv` and `assertSafeForWrite`
+- **Coder self-verify guardrail (HF-1)**: Coder and test_engineer agents blocked from running build/test/lint
+- **`/swarm` template fix**: `{{arguments}}` → `$ARGUMENTS`
+- **DEFAULT_MODELS update**: `claude-sonnet-4-5` → `claude-sonnet-4-20250514`, `gemini-2.0-flash` → `gemini-2.5-flash`
+
 ### v6.13.0 — Context Efficiency
 
 This release focuses on reducing context usage and improving mode-conditional behavior:
@@ -650,6 +671,8 @@ Upcoming: v6.14 focuses on further context optimization and agent coordination i
 - [Design Rationale](docs/design-rationale.md)
 - [Installation Guide](docs/installation.md)
 - [Linux + Docker Desktop Install Guide](docs/installation-linux-docker.md)
+- [Pre-Swarm Planning Guide](docs/planning.md)
+- [Swarm Briefing for LLMs](docs/swarm-briefing.md)
 
 ---
 

package/dist/config/evidence-schema.d.ts

@@ -191,6 +191,30 @@ export declare const RetrospectiveEvidenceSchema: z.ZodObject<{
     }>;
     top_rejection_reasons: z.ZodDefault<z.ZodArray<z.ZodString>>;
     lessons_learned: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    user_directives: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        directive: z.ZodString;
+        category: z.ZodEnum<{
+            tooling: "tooling";
+            code_style: "code_style";
+            architecture: "architecture";
+            process: "process";
+            other: "other";
+        }>;
+        scope: z.ZodEnum<{
+            project: "project";
+            session: "session";
+            global: "global";
+        }>;
+    }, z.core.$strip>>>;
+    approaches_tried: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        approach: z.ZodString;
+        result: z.ZodEnum<{
+            success: "success";
+            failure: "failure";
+            partial: "partial";
+        }>;
+        abandoned_reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type RetrospectiveEvidence = z.infer<typeof RetrospectiveEvidenceSchema>;
 export declare const SyntaxEvidenceSchema: z.ZodObject<{
@@ -242,9 +266,9 @@ export declare const PlaceholderEvidenceSchema: z.ZodObject<{
         line: z.ZodNumber;
         kind: z.ZodEnum<{
             string: "string";
+            other: "other";
             comment: "comment";
             function_body: "function_body";
-            other: "other";
         }>;
         excerpt: z.ZodString;
         rule_id: z.ZodString;
@@ -535,6 +559,30 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>;
     top_rejection_reasons: z.ZodDefault<z.ZodArray<z.ZodString>>;
     lessons_learned: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    user_directives: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        directive: z.ZodString;
+        category: z.ZodEnum<{
+            tooling: "tooling";
+            code_style: "code_style";
+            architecture: "architecture";
+            process: "process";
+            other: "other";
+        }>;
+        scope: z.ZodEnum<{
+            project: "project";
+            session: "session";
+            global: "global";
+        }>;
+    }, z.core.$strip>>>;
+    approaches_tried: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        approach: z.ZodString;
+        result: z.ZodEnum<{
+            success: "success";
+            failure: "failure";
+            partial: "partial";
+        }>;
+        abandoned_reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     task_id: z.ZodString;
     timestamp: z.ZodString;
@@ -582,9 +630,9 @@ export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         line: z.ZodNumber;
         kind: z.ZodEnum<{
             string: "string";
+            other: "other";
             comment: "comment";
             function_body: "function_body";
-            other: "other";
         }>;
         excerpt: z.ZodString;
         rule_id: z.ZodString;
@@ -870,6 +918,30 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
         }>;
         top_rejection_reasons: z.ZodDefault<z.ZodArray<z.ZodString>>;
         lessons_learned: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        user_directives: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            directive: z.ZodString;
+            category: z.ZodEnum<{
+                tooling: "tooling";
+                code_style: "code_style";
+                architecture: "architecture";
+                process: "process";
+                other: "other";
+            }>;
+            scope: z.ZodEnum<{
+                project: "project";
+                session: "session";
+                global: "global";
+            }>;
+        }, z.core.$strip>>>;
+        approaches_tried: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            approach: z.ZodString;
+            result: z.ZodEnum<{
+                success: "success";
+                failure: "failure";
+                partial: "partial";
+            }>;
+            abandoned_reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodObject<{
         task_id: z.ZodString;
         timestamp: z.ZodString;
@@ -917,9 +989,9 @@ export declare const EvidenceBundleSchema: z.ZodObject<{
             line: z.ZodNumber;
             kind: z.ZodEnum<{
                 string: "string";
+                other: "other";
                 comment: "comment";
                 function_body: "function_body";
-                other: "other";
             }>;
             excerpt: z.ZodString;
             rule_id: z.ZodString;

package/dist/config/index.d.ts

@@ -5,5 +5,5 @@ export { ApprovalEvidenceSchema, BaseEvidenceSchema, DiffEvidenceSchema, EVIDENC
 export { loadAgentPrompt, loadPluginConfig, loadPluginConfigWithMeta, } from './loader';
 export type { MigrationStatus, Phase, PhaseStatus, Plan, Task, TaskSize, TaskStatus, } from './plan-schema';
 export { MigrationStatusSchema, PhaseSchema, PhaseStatusSchema, PlanSchema, TaskSchema, TaskSizeSchema, TaskStatusSchema, } from './plan-schema';
-export type { AgentOverrideConfig, AutomationCapabilities, AutomationConfig, AutomationMode, PipelineConfig, PluginConfig, SwarmConfig, } from './schema';
-export { AgentOverrideConfigSchema, AutomationCapabilitiesSchema, AutomationConfigSchema, AutomationModeSchema, PipelineConfigSchema, PluginConfigSchema, SwarmConfigSchema, } from './schema';
+export type { AgentOverrideConfig, AutomationCapabilities, AutomationConfig, AutomationMode, PhaseCompleteConfig, PipelineConfig, PluginConfig, SwarmConfig, } from './schema';
+export { AgentOverrideConfigSchema, AutomationCapabilitiesSchema, AutomationConfigSchema, AutomationModeSchema, PhaseCompleteConfigSchema, PipelineConfigSchema, PluginConfigSchema, SwarmConfigSchema, } from './schema';

package/dist/config/schema.d.ts

@@ -190,12 +190,27 @@ export declare const PipelineConfigSchema: z.ZodObject<{
     parallel_precheck: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type PipelineConfig = z.infer<typeof PipelineConfigSchema>;
+export declare const PhaseCompleteConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    required_agents: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        reviewer: "reviewer";
+        coder: "coder";
+        test_engineer: "test_engineer";
+    }>>>;
+    require_docs: z.ZodDefault<z.ZodBoolean>;
+    policy: z.ZodDefault<z.ZodEnum<{
+        enforce: "enforce";
+        warn: "warn";
+    }>>;
+}, z.core.$strip>;
+export type PhaseCompleteConfig = z.infer<typeof PhaseCompleteConfigSchema>;
 export declare const SummaryConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     threshold_bytes: z.ZodDefault<z.ZodNumber>;
     max_summary_chars: z.ZodDefault<z.ZodNumber>;
     max_stored_bytes: z.ZodDefault<z.ZodNumber>;
     retention_days: z.ZodDefault<z.ZodNumber>;
+    exempt_tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type SummaryConfig = z.infer<typeof SummaryConfigSchema>;
 export declare const ReviewPassesConfigSchema: z.ZodObject<{
@@ -203,6 +218,16 @@ export declare const ReviewPassesConfigSchema: z.ZodObject<{
     security_globs: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type ReviewPassesConfig = z.infer<typeof ReviewPassesConfigSchema>;
+export declare const AdversarialDetectionConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    policy: z.ZodDefault<z.ZodEnum<{
+        warn: "warn";
+        gate: "gate";
+        ignore: "ignore";
+    }>>;
+    pairs: z.ZodDefault<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>>>;
+}, z.core.$strip>;
+export type AdversarialDetectionConfig = z.infer<typeof AdversarialDetectionConfigSchema>;
 export declare const IntegrationAnalysisConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -367,6 +392,19 @@ export declare const PluginConfigSchema: z.ZodObject<{
     pipeline: z.ZodOptional<z.ZodObject<{
         parallel_precheck: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
+    phase_complete: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        required_agents: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            reviewer: "reviewer";
+            coder: "coder";
+            test_engineer: "test_engineer";
+        }>>>;
+        require_docs: z.ZodDefault<z.ZodBoolean>;
+        policy: z.ZodDefault<z.ZodEnum<{
+            enforce: "enforce";
+            warn: "warn";
+        }>>;
+    }, z.core.$strip>>;
     qa_retry_limit: z.ZodDefault<z.ZodNumber>;
     inject_phase_reminders: z.ZodDefault<z.ZodBoolean>;
     hooks: z.ZodOptional<z.ZodObject<{
@@ -479,11 +517,21 @@ export declare const PluginConfigSchema: z.ZodObject<{
         max_summary_chars: z.ZodDefault<z.ZodNumber>;
         max_stored_bytes: z.ZodDefault<z.ZodNumber>;
         retention_days: z.ZodDefault<z.ZodNumber>;
+        exempt_tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
     review_passes: z.ZodOptional<z.ZodObject<{
         always_security_review: z.ZodDefault<z.ZodBoolean>;
         security_globs: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+    adversarial_detection: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        policy: z.ZodDefault<z.ZodEnum<{
+            warn: "warn";
+            gate: "gate";
+            ignore: "ignore";
+        }>>;
+        pairs: z.ZodDefault<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>>>;
+    }, z.core.$strip>>;
     integration_analysis: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;

package/dist/hooks/adversarial-detector.d.ts

@@ -0,0 +1,15 @@
+import type { PluginConfig } from '../config';
+/**
+ * Resolve the model for a given agent by checking config overrides,
+ * swarm configurations, and falling back to defaults.
+ */
+export declare function resolveAgentModel(agentName: string, config: PluginConfig): string;
+/**
+ * Detect if two agents share the same model (adversarial pair).
+ * Returns the shared model string if matched, null otherwise.
+ */
+export declare function detectAdversarialPair(agentA: string, agentB: string, config: PluginConfig): string | null;
+/**
+ * Format an adversarial warning message based on policy.
+ */
+export declare function formatAdversarialWarning(agentA: string, agentB: string, sharedModel: string, policy: string): string;

package/dist/hooks/system-enhancer.d.ts

@@ -6,6 +6,13 @@
  * Reads plan.md and injects phase context into the system prompt.
  */
 import type { PluginConfig } from '../config';
+/**
+ * Build a retrospective injection string for the architect system message.
+ * Tier 1: direct phase-scoped lookup for same-plan previous phase.
+ * Tier 2: cross-project historical lessons (Phase 1 only).
+ * Returns null if no valid retrospective found.
+ */
+export declare function buildRetroInjection(directory: string, currentPhaseNumber: number, currentPlanTitle?: string): Promise<string | null>;
 /**
  * Creates the experimental.chat.system.transform hook for system enhancement.
  */