opencode-swarm 6.21.3 → 6.22.1

package/README.md

@@ -78,7 +78,7 @@ This checks that everything is wired up correctly.
 
 ### Configure Models (Optional)
 
-By default, Swarm v6.14+ uses free OpenCode Zen models (no API key required). You can override any agent's model by creating `.opencode/swarm.json` in your project. See the [LLM Provider Guide](#llm-provider-guide) for all options.
+By default, Swarm v6.14+ uses free OpenCode Zen models (no API key required). You can override any agent's model by creating `.opencode/opencode-swarm.json` in your project. See the [LLM Provider Guide](#llm-provider-guide) for all options.
 
 ```json
 {
@@ -152,7 +152,7 @@ OpenCode Zen provides free models via the `opencode/` provider prefix. These are
 }
 ```
 
-> Save this configuration to `.opencode/swarm.json` in your project root (or `~/.config/opencode/opencode-swarm.json` for global config).
+> Save this configuration to `.opencode/opencode-swarm.json` in your project root (or `~/.config/opencode/opencode-swarm.json` for global config).
 
 > **Note:** The `architect` key is intentionally omitted — it inherits whatever model you have selected in the OpenCode UI for maximum reasoning quality.
 
@@ -552,7 +552,7 @@ Optional enhancement: Semgrep (if on PATH).
 <details>
 <summary><strong>Full Configuration Reference</strong></summary>
 
-Config file location: `~/.config/opencode/opencode-swarm.json` (global) or `.opencode/swarm.json` (project). Project config merges over global.
+Config file location: `~/.config/opencode/opencode-swarm.json` (global) or `.opencode/opencode-swarm.json` (project). Project config merges over global.
 
 ```json
 {
@@ -1019,9 +1019,61 @@ OpenCode Swarm v6.16+ ships with language profiles for 11 languages across three
 
 ## Roadmap
 
+## Curator
+
+The Curator is an optional background analysis system that runs after each phase. It is **disabled by default** (`curator.enabled = false`) and never blocks execution — all Curator operations are wrapped in try/catch.
+
+### What the Curator Does
+
+- **Init** (`phase-monitor.ts`): On the first phase, initializes a curator summary file at `.swarm/curator-summary.json`.
+- **Phase analysis** (`phase-complete.ts`): After each phase completes, collects phase events, checks compliance, and optionally invokes the curator explorer to summarize findings.
+- **Knowledge updates** (`phase-complete.ts`): Merges curator findings into the knowledge base up to the configured `max_summary_tokens` cap.
+- **Drift injection** (`knowledge-injector.ts`): Prepends the latest drift report summary to the architect's knowledge context at phase start, up to `drift_inject_max_chars` characters.
+
+### Configuration
+
+Add a `curator` block to `.opencode/opencode-swarm.json`:
+
+```json
+{
+  "curator": {
+    "enabled": false,
+    "init_enabled": true,
+    "phase_enabled": true,
+    "max_summary_tokens": 2000,
+    "min_knowledge_confidence": 0.7,
+    "compliance_report": true,
+    "suppress_warnings": true,
+    "drift_inject_max_chars": 500
+  }
+}
+```
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `enabled` | `false` | Master switch. Set to `true` to activate the Curator pipeline. |
+| `init_enabled` | `true` | Initialize curator summary on first phase (requires `enabled: true`). |
+| `phase_enabled` | `true` | Run phase analysis and knowledge updates after each phase. |
+| `max_summary_tokens` | `2000` | Maximum token budget for curator knowledge summaries. |
+| `min_knowledge_confidence` | `0.7` | Minimum confidence threshold for curator knowledge entries. |
+| `compliance_report` | `true` | Include phase compliance check results in curator summary. |
+| `suppress_warnings` | `true` | Suppress non-critical curator warnings from the architect context. |
+| `drift_inject_max_chars` | `500` | Maximum characters of drift report text injected into each phase context. |
+
+### Drift Reports
+
+Drift reports are written to `.swarm/drift-report-phase-N.json` after each phase. The `knowledge-injector.ts` hook reads the latest report and prepends a summary to the architect's knowledge context for the next phase, helping the architect stay aware of plan vs. reality divergence.
+
+### Issue #81 Hotfix — taskWorkflowStates Persistence
+
+v6.21 includes a fix for session snapshot persistence of per-task workflow states:
+
+- **`SerializedAgentSession.taskWorkflowStates`**: Task workflow states are now serialized as `Record<string, string>` in session snapshots and deserialized back to a `Map` on load. Invalid state values are filtered out and default to `idle`.
+- **`reconcileTaskStatesFromPlan`**: On snapshot load, task states are reconciled against the current plan — tasks marked `completed` in the plan are seeded to `tests_run` state, and `in_progress` tasks are seeded to `coder_delegated` if currently `idle`. This is best-effort and never throws.
+
 See [CHANGELOG.md](CHANGELOG.md) for shipped features.
 
-Upcoming: v6.14 focuses on further context optimization and agent coordination improvements.
+Upcoming: v6.22 focuses on further context optimization and agent coordination improvements.
 
 ---
 

package/dist/agents/critic.d.ts

@@ -1,2 +1,3 @@
 import type { AgentDefinition } from './architect';
 export declare function createCriticAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;
+export declare function createCriticDriftAgent(model: string, customAppendPrompt?: string): AgentDefinition;

package/dist/agents/explorer.d.ts

@@ -1,2 +1,3 @@
 import type { AgentDefinition } from './architect';
 export declare function createExplorerAgent(model: string, customPrompt?: string, customAppendPrompt?: string): AgentDefinition;
+export declare function createExplorerCuratorAgent(model: string, mode: 'CURATOR_INIT' | 'CURATOR_PHASE', customAppendPrompt?: string): AgentDefinition;

package/dist/background/event-bus.d.ts

@@ -5,7 +5,7 @@
  * Events flow through the system without external dependencies.
  */
 /** Automation event types */
-export type AutomationEventType = 'queue.item.enqueued' | 'queue.item.dequeued' | 'queue.item.completed' | 'queue.item.failed' | 'queue.item.retry scheduled' | 'worker.started' | 'worker.stopped' | 'worker.error' | 'circuit.breaker.opened' | 'circuit.breaker.half-open' | 'circuit.breaker.closed' | 'loop.protection.triggered' | 'automation.started' | 'automation.stopped' | 'preflight.requested' | 'preflight.triggered' | 'preflight.skipped' | 'preflight.completed' | 'phase.boundary.detected' | 'phase.status.checked' | 'task.completed' | 'evidence.summary.generated' | 'evidence.summary.error';
+export type AutomationEventType = 'queue.item.enqueued' | 'queue.item.dequeued' | 'queue.item.completed' | 'queue.item.failed' | 'queue.item.retry scheduled' | 'worker.started' | 'worker.stopped' | 'worker.error' | 'circuit.breaker.opened' | 'circuit.breaker.half-open' | 'circuit.breaker.closed' | 'loop.protection.triggered' | 'automation.started' | 'automation.stopped' | 'preflight.requested' | 'preflight.triggered' | 'preflight.skipped' | 'preflight.completed' | 'phase.boundary.detected' | 'phase.status.checked' | 'task.completed' | 'evidence.summary.generated' | 'evidence.summary.error' | 'curator.init.completed' | 'curator.phase.completed' | 'curator.drift.completed' | 'curator.error';
 /** Base automation event */
 export interface AutomationEvent<T = unknown> {
     type: AutomationEventType;

package/dist/cli/index.js

@@ -14382,7 +14382,7 @@ async function loadEvidence(directory, taskId) {
       return { status: "found", bundle: validated };
     } catch (error49) {
       warn(`Wrapped flat retrospective failed validation for task ${sanitizedTaskId}: ${error49 instanceof Error ? error49.message : String(error49)}`);
-      const errors3 = error49 instanceof ZodError ? error49.issues.map((e) => e.path.join(".") + ": " + e.message) : [String(error49)];
+      const errors3 = error49 instanceof ZodError ? error49.issues.map((e) => `${e.path.join(".")}: ${e.message}`) : [String(error49)];
       return { status: "invalid_schema", errors: errors3 };
     }
   }
@@ -14391,7 +14391,7 @@ async function loadEvidence(directory, taskId) {
     return { status: "found", bundle: validated };
   } catch (error49) {
     warn(`Evidence bundle validation failed for task ${sanitizedTaskId}: ${error49 instanceof Error ? error49.message : String(error49)}`);
-    const errors3 = error49 instanceof ZodError ? error49.issues.map((e) => e.path.join(".") + ": " + e.message) : [String(error49)];
+    const errors3 = error49 instanceof ZodError ? error49.issues.map((e) => `${e.path.join(".")}: ${e.message}`) : [String(error49)];
     return { status: "invalid_schema", errors: errors3 };
   }
 }
@@ -17121,6 +17121,16 @@ var KnowledgeConfigSchema = exports_external.object({
   min_retrievals_for_utility: exports_external.number().min(1).max(100).default(3),
   schema_version: exports_external.number().int().min(1).default(1)
 });
+var CuratorConfigSchema = exports_external.object({
+  enabled: exports_external.boolean().default(false),
+  init_enabled: exports_external.boolean().default(true),
+  phase_enabled: exports_external.boolean().default(true),
+  max_summary_tokens: exports_external.number().min(500).max(8000).default(2000),
+  min_knowledge_confidence: exports_external.number().min(0).max(1).default(0.7),
+  compliance_report: exports_external.boolean().default(true),
+  suppress_warnings: exports_external.boolean().default(true),
+  drift_inject_max_chars: exports_external.number().min(100).max(2000).default(500)
+});
 var PluginConfigSchema = exports_external.object({
   agents: exports_external.record(exports_external.string(), AgentOverrideConfigSchema).optional(),
   swarms: exports_external.record(exports_external.string(), SwarmConfigSchema).optional(),
@@ -17148,6 +17158,7 @@ var PluginConfigSchema = exports_external.object({
   checkpoint: CheckpointConfigSchema.optional(),
   automation: AutomationConfigSchema.optional(),
   knowledge: KnowledgeConfigSchema.optional(),
+  curator: CuratorConfigSchema.optional(),
   tool_output: exports_external.object({
     truncation_enabled: exports_external.boolean().default(true),
     max_lines: exports_external.number().min(10).max(500).default(150),
@@ -17371,7 +17382,7 @@ async function readKnowledge(filePath) {
 }
 async function appendKnowledge(filePath, entry) {
   await mkdir(path4.dirname(filePath), { recursive: true });
-  await appendFile(filePath, JSON.stringify(entry) + `
+  await appendFile(filePath, `${JSON.stringify(entry)}
 `, "utf-8");
 }
 async function rewriteKnowledge(filePath, entries) {
@@ -30109,7 +30120,7 @@ function sanitizeString(str, maxLength) {
     return "";
   const sanitized = String(str).replace(RTL_OVERRIDE_PATTERN, "");
   if (sanitized.length > maxLength) {
-    return sanitized.substring(0, maxLength - 3) + "...";
+    return `${sanitized.substring(0, maxLength - 3)}...`;
   }
   return sanitized;
 }
@@ -30280,7 +30291,7 @@ async function getHandoffData(directory) {
       const phaseMatch = planMdContent.match(/^## Phase (\d+):?\s*(.+)?$/m);
       const taskMatch = planMdContent.match(/^- \[ \] (\d+\.\d+)/g);
       if (phaseMatch) {
-        planInfo.currentPhase = sanitizeString(`Phase ${phaseMatch[1]}${phaseMatch[2] ? ": " + phaseMatch[2] : ""}`, MAX_TASK_ID_LENGTH);
+        planInfo.currentPhase = sanitizeString(`Phase ${phaseMatch[1]}${phaseMatch[2] ? `: ${phaseMatch[2]}` : ""}`, MAX_TASK_ID_LENGTH);
       }
       if (taskMatch) {
         const rawTasks = taskMatch.map((t) => t.replace("- [ ] ", ""));
@@ -30447,7 +30458,8 @@ function serializeAgentSession(s) {
     lastPhaseCompletePhase: s.lastPhaseCompletePhase ?? 0,
     phaseAgentsDispatched,
     qaSkipCount: s.qaSkipCount ?? 0,
-    qaSkipTaskIds: s.qaSkipTaskIds ?? []
+    qaSkipTaskIds: s.qaSkipTaskIds ?? [],
+    taskWorkflowStates: Object.fromEntries(s.taskWorkflowStates ?? new Map)
   };
 }
 async function writeSnapshot(directory, state) {

package/dist/config/schema.d.ts

@@ -399,6 +399,17 @@ export declare const KnowledgeConfigSchema: z.ZodObject<{
     schema_version: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type KnowledgeConfig = z.infer<typeof KnowledgeConfigSchema>;
+export declare const CuratorConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    init_enabled: z.ZodDefault<z.ZodBoolean>;
+    phase_enabled: z.ZodDefault<z.ZodBoolean>;
+    max_summary_tokens: z.ZodDefault<z.ZodNumber>;
+    min_knowledge_confidence: z.ZodDefault<z.ZodNumber>;
+    compliance_report: z.ZodDefault<z.ZodBoolean>;
+    suppress_warnings: z.ZodDefault<z.ZodBoolean>;
+    drift_inject_max_chars: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type CuratorConfig = z.infer<typeof CuratorConfigSchema>;
 export declare const PluginConfigSchema: z.ZodObject<{
     agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         model: z.ZodOptional<z.ZodString>;
@@ -643,6 +654,16 @@ export declare const PluginConfigSchema: z.ZodObject<{
         min_retrievals_for_utility: z.ZodDefault<z.ZodNumber>;
         schema_version: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
+    curator: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        init_enabled: z.ZodDefault<z.ZodBoolean>;
+        phase_enabled: z.ZodDefault<z.ZodBoolean>;
+        max_summary_tokens: z.ZodDefault<z.ZodNumber>;
+        min_knowledge_confidence: z.ZodDefault<z.ZodNumber>;
+        compliance_report: z.ZodDefault<z.ZodBoolean>;
+        suppress_warnings: z.ZodDefault<z.ZodBoolean>;
+        drift_inject_max_chars: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
     tool_output: z.ZodOptional<z.ZodObject<{
         truncation_enabled: z.ZodDefault<z.ZodBoolean>;
         max_lines: z.ZodDefault<z.ZodNumber>;

package/dist/hooks/curator-drift.d.ts

@@ -0,0 +1,30 @@
+import type { CriticDriftResult, CuratorConfig, CuratorPhaseResult, DriftReport } from './curator-types.js';
+/**
+ * Read all prior drift reports from .swarm/drift-report-phase-*.json files.
+ * Returns reports sorted ascending by phase number.
+ * Skips corrupt/unreadable files with a console.warn.
+ */
+export declare function readPriorDriftReports(directory: string): Promise<DriftReport[]>;
+/**
+ * Write a drift report to .swarm/drift-report-phase-{N}.json.
+ * Creates .swarm/ if it doesn't exist.
+ * Returns the absolute path of the written file.
+ */
+export declare function writeDriftReport(directory: string, report: DriftReport): Promise<string>;
+/**
+ * Run the critic drift check for the given phase.
+ * Builds a structured DriftReport from curator data, plan, spec, and prior reports.
+ * Writes the report to .swarm/drift-report-phase-N.json.
+ * Emits 'curator.drift.completed' event on success.
+ * On any error: emits 'curator.error' event and returns a safe default result.
+ * NEVER throws — drift failures must not block phase_complete.
+ */
+export declare function runCriticDriftCheck(directory: string, phase: number, curatorResult: CuratorPhaseResult, config: CuratorConfig): Promise<CriticDriftResult>;
+/**
+ * Build a truncated summary suitable for architect context injection.
+ * Format: "<drift_report>Phase N: {alignment} ({drift_score}) — {key finding}. {correction if any}.</drift_report>"
+ * Truncate to maxChars (simple slice). Tags may be broken when truncation occurs mid-tag.
+ * If ALIGNED with drift_score < 0.1: minimal output "Phase N: ALIGNED, all requirements on track."
+ * If MINOR_DRIFT or worse: include first_deviation and top correction.
+ */
+export declare function buildDriftInjectionText(report: DriftReport, maxChars: number): string;

package/dist/hooks/curator-types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Curator types — phase context consolidation and drift detection.
+ * No runtime logic. Types only.
+ */
+/** Curator summary — anchored iterative format. Persisted to .swarm/curator-summary.json */
+export interface CuratorSummary {
+    schema_version: 1;
+    session_id: string;
+    last_updated: string;
+    last_phase_covered: number;
+    /** Running digest — extended each phase, never regenerated */
+    digest: string;
+    /** Phase-level digests for lookup */
+    phase_digests: PhaseDigestEntry[];
+    /** Accumulated compliance observations */
+    compliance_observations: ComplianceObservation[];
+    /** Knowledge update recommendations from the last curator run */
+    knowledge_recommendations: KnowledgeRecommendation[];
+}
+export interface PhaseDigestEntry {
+    phase: number;
+    timestamp: string;
+    summary: string;
+    agents_used: string[];
+    tasks_completed: number;
+    tasks_total: number;
+    key_decisions: string[];
+    blockers_resolved: string[];
+}
+export interface ComplianceObservation {
+    phase: number;
+    timestamp: string;
+    type: 'missing_reviewer' | 'missing_retro' | 'missing_sme' | 'skipped_test' | 'workflow_deviation';
+    description: string;
+    severity: 'info' | 'warning';
+}
+export interface KnowledgeRecommendation {
+    action: 'promote' | 'archive' | 'flag_contradiction';
+    entry_id?: string;
+    lesson: string;
+    reason: string;
+}
+/** Drift report — produced by critic after curator phase run */
+export interface DriftReport {
+    schema_version: 1;
+    phase: number;
+    timestamp: string;
+    /** Overall alignment verdict */
+    alignment: 'ALIGNED' | 'MINOR_DRIFT' | 'MAJOR_DRIFT' | 'OFF_SPEC';
+    /** Severity score 0.0-1.0 (0 = perfectly aligned, 1 = completely off-spec) */
+    drift_score: number;
+    /** First deviation point if drift detected */
+    first_deviation: {
+        phase: number;
+        task: string;
+        description: string;
+    } | null;
+    /** Compounding effects across phases */
+    compounding_effects: string[];
+    /** Recommended course corrections */
+    corrections: string[];
+    /** Spec requirements checked */
+    requirements_checked: number;
+    /** Spec requirements satisfied */
+    requirements_satisfied: number;
+    /** Scope additions not in original plan */
+    scope_additions: string[];
+    /** Truncated summary for architect context injection */
+    injection_summary: string;
+}
+export interface CuratorConfig {
+    enabled: boolean;
+    init_enabled: boolean;
+    phase_enabled: boolean;
+    max_summary_tokens: number;
+    min_knowledge_confidence: number;
+    compliance_report: boolean;
+    suppress_warnings: boolean;
+    drift_inject_max_chars: number;
+}
+export interface CuratorInitResult {
+    briefing: string;
+    contradictions: string[];
+    knowledge_entries_reviewed: number;
+    prior_phases_covered: number;
+}
+export interface CuratorPhaseResult {
+    phase: number;
+    digest: PhaseDigestEntry;
+    compliance: ComplianceObservation[];
+    knowledge_recommendations: KnowledgeRecommendation[];
+    summary_updated: boolean;
+}
+export interface CriticDriftResult {
+    phase: number;
+    report: DriftReport;
+    report_path: string;
+    injection_text: string;
+}

package/dist/hooks/curator.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Curator core — file I/O for curator summary persistence.
+ * Extended incrementally: filterPhaseEvents, checkPhaseCompliance,
+ * runCuratorInit, runCuratorPhase, applyCuratorKnowledgeUpdates added in subsequent tasks.
+ */
+import type { ComplianceObservation, CuratorConfig, CuratorInitResult, CuratorPhaseResult, CuratorSummary, KnowledgeRecommendation } from './curator-types.js';
+import type { KnowledgeConfig } from './knowledge-types.js';
+/**
+ * Read curator summary from .swarm/curator-summary.json
+ * @param directory - The workspace directory
+ * @returns CuratorSummary if valid, null if missing or invalid
+ */
+export declare function readCuratorSummary(directory: string): Promise<CuratorSummary | null>;
+/**
+ * Write curator summary to .swarm/curator-summary.json
+ * @param directory - The workspace directory
+ * @param summary - The curator summary to write
+ */
+export declare function writeCuratorSummary(directory: string, summary: CuratorSummary): Promise<void>;
+/**
+ * Filter events from JSONL by phase or timestamp.
+ * @param eventsJsonl - Raw JSONL string of events
+ * @param phase - Phase number to filter by
+ * @param sinceTimestamp - Optional ISO 8601 timestamp to filter events after
+ * @returns Array of parsed event objects
+ */
+export declare function filterPhaseEvents(eventsJsonl: string, phase: number, sinceTimestamp?: string): object[];
+/**
+ * Check compliance for a phase based on events and dispatched agents.
+ * @param phaseEvents - Array of events for the phase
+ * @param agentsDispatched - List of agent names that were dispatched
+ * @param requiredAgents - List of required agent names for this phase
+ * @param phase - Phase number
+ * @returns Array of compliance observations
+ */
+export declare function checkPhaseCompliance(phaseEvents: object[], agentsDispatched: string[], requiredAgents: string[], phase: number): ComplianceObservation[];
+/**
+ * Prepare curator init data: reads prior summary, knowledge entries, and context.md.
+ * Returns a structured briefing result. Does NOT make LLM calls.
+ * The caller (phase-monitor integration) is responsible for the actual agent delegation.
+ * @param directory - The workspace directory
+ * @param config - Curator configuration
+ * @returns CuratorInitResult with briefing text, contradictions, and stats
+ */
+export declare function runCuratorInit(directory: string, config: CuratorConfig): Promise<CuratorInitResult>;
+/**
+ * Run curator phase analysis: reads events, runs compliance, updates and writes summary.
+ * Does NOT make LLM calls. The caller is responsible for agent delegation.
+ * @param directory - The workspace directory
+ * @param phase - The phase number that just completed
+ * @param agentsDispatched - List of agent names dispatched in this phase
+ * @param config - Curator configuration
+ * @param knowledgeConfig - Knowledge configuration (used for knowledge path resolution)
+ * @returns CuratorPhaseResult with digest, compliance, and recommendations
+ */
+export declare function runCuratorPhase(directory: string, phase: number, agentsDispatched: string[], _config: CuratorConfig, _knowledgeConfig: {
+    directory?: string;
+}): Promise<CuratorPhaseResult>;
+/**
+ * Apply curator knowledge recommendations: promote, archive, or flag contradictions.
+ * Uses readKnowledge + rewriteKnowledge pattern for atomic updates.
+ * @param directory - The workspace directory
+ * @param recommendations - Array of knowledge recommendations to apply
+ * @param knowledgeConfig - Knowledge configuration (for path resolution)
+ * @returns Counts of applied and skipped recommendations
+ */
+export declare function applyCuratorKnowledgeUpdates(directory: string, recommendations: KnowledgeRecommendation[], _knowledgeConfig: KnowledgeConfig): Promise<{
+    applied: number;
+    skipped: number;
+}>;