opencode-swarm 6.22.18 → 6.22.20

package/README.md

@@ -932,6 +932,16 @@ The following tools can be assigned to agents via overrides:
 
 ## Recent Changes
 
+### v6.22 — Curator Background Analysis + Session State Persistence
+
+This release adds the optional Curator system for phase-level intelligence and fixes session snapshot persistence for task workflow states.
+
+- **Curator system**: New optional background analysis system (`curator.enabled = false` by default). After each phase, collects events, checks compliance, and writes drift reports to `.swarm/drift-report-phase-N.json`. Three integration points: init on first phase, phase analysis after each phase, and drift injection into architect context at phase start.
+- **Drift reports**: `runCriticDriftCheck` compares planned vs. actual decisions and writes structured drift reports with alignment scores (`ALIGNED` / `MINOR_DRIFT` / `MAJOR_DRIFT` / `OFF_SPEC`). Latest drift summary is prepended to the architect's knowledge context each phase.
+- **Issue #81 fix — taskWorkflowStates persistence**: Session snapshots now correctly serialize and restore the per-task state machine. Invalid state values are filtered to `idle` on deserialization. `reconcileTaskStatesFromPlan` seeds task states from `plan.json` on snapshot load (completed → `tests_run`, in-progress → `coder_delegated`).
+
+See the [Curator section](#curator) above for configuration details and the [v6.22 release notes](docs/releases/v6.22.0.md) for the full change list.
+
 ### v6.21 — Gate Enforcement Hardening
 
 This release replaces soft advisory warnings with hard runtime blocks and adds structural compliance tooling for all model tiers.
@@ -1103,8 +1113,6 @@ 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.
@@ -1152,15 +1160,13 @@ Drift reports are written to `.swarm/drift-report-phase-N.json` after each phase
 
 ### Issue #81 Hotfix — taskWorkflowStates Persistence
 
-v6.21 includes a fix for session snapshot persistence of per-task workflow states:
+v6.22 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.22 focuses on further context optimization and agent coordination improvements.
-
 ---
 
 ## FAQ
@@ -1184,6 +1190,7 @@ Run `/swarm reset --confirm`.
 
 ## Documentation
 
+- [Documentation Index](docs/index.md)
 - [Getting Started](docs/getting-started.md)
 - [Architecture Deep Dive](docs/architecture.md)
 - [Design Rationale](docs/design-rationale.md)

package/dist/hooks/phase-monitor.d.ts

@@ -13,8 +13,10 @@ export type CuratorInitRunner = (directory: string, config: CuratorConfig) => Pr
  * Creates a hook that monitors plan phase transitions and triggers preflight.
  *
  * @param directory - Project directory (where .swarm/ lives)
- * @param preflightManager - The PreflightTriggerManager to call on phase change
+ * @param preflightManager - Optional PreflightTriggerManager to call on phase change.
+ *   When undefined, preflight checks are skipped but curator initialization still runs
+ *   at session start (useful when knowledge.enabled but phase_preflight is disabled).
  * @param curatorRunner - Optional curator init runner (defaults to runCuratorInit; injectable for tests)
  * @returns A safeHook-wrapped system.transform handler
  */
-export declare function createPhaseMonitorHook(directory: string, preflightManager: PreflightTriggerManager, curatorRunner?: CuratorInitRunner): (input: unknown, output: unknown) => Promise<void>;
+export declare function createPhaseMonitorHook(directory: string, preflightManager?: PreflightTriggerManager, curatorRunner?: CuratorInitRunner): (input: unknown, output: unknown) => Promise<void>;

package/dist/index.js

@@ -39880,8 +39880,8 @@ When writing output consumed by other agents, prefix with:
   [FOR: agent1, agent2] \u2014 relevant to specific agents
   [FOR: ALL] \u2014 relevant to all agents
 Examples:
-  [FOR: {{AGENT_PREFIX}}reviewer, {{AGENT_PREFIX}}test_engineer] "Added validation \u2014 needs safety check"
-  [FOR: {{AGENT_PREFIX}}architect] "Research: Tree-sitter supports TypeScript AST"
+  [FOR: reviewer, test_engineer] "Added validation \u2014 needs safety check"
+  [FOR: architect] "Research: Tree-sitter supports TypeScript AST"
   [FOR: ALL] "Breaking change: StateManager renamed"
 This tag is informational in v6.19; v6.20 will use for context filtering.
 `;
@@ -49221,7 +49221,9 @@ function createPhaseMonitorHook(directory, preflightManager, curatorRunner = run
       const phase = plan.phases.find((p) => p.id === previousPhase);
       const completedTasks = phase?.tasks.filter((t) => t.status === "completed").length ?? 0;
       const totalTasks = phase?.tasks.length ?? 0;
-      await preflightManager.checkAndTrigger(currentPhase, completedTasks, totalTasks);
+      if (preflightManager) {
+        await preflightManager.checkAndTrigger(currentPhase, completedTasks, totalTasks);
+      }
     }
   };
   return safeHook(handler);
@@ -61098,7 +61100,7 @@ var OpenCodeSwarm = async (ctx) => {
   const activityHooks = createAgentActivityHooks(config3, ctx.directory);
   const delegationGateHooks = createDelegationGateHook(config3);
   const delegationSanitizerHook = createDelegationSanitizerHook(ctx.directory);
-  const guardrailsFallback = config3.guardrails?.enabled === false ? { ...config3.guardrails, enabled: false } : loadedFromFile ? config3.guardrails ?? {} : config3.guardrails;
+  const guardrailsFallback = config3.guardrails?.enabled === false ? { ...config3.guardrails, enabled: false } : config3.guardrails ?? {};
   const guardrailsConfig = GuardrailsConfigSchema.parse(guardrailsFallback);
   if (loadedFromFile && guardrailsConfig.enabled === false) {
     console.warn("");
@@ -61379,7 +61381,7 @@ var OpenCodeSwarm = async (ctx) => {
     ].filter((fn) => Boolean(fn))),
     "experimental.chat.system.transform": composeHandlers(...[
       systemEnhancerHook["experimental.chat.system.transform"],
-      automationConfig.capabilities?.phase_preflight === true && preflightTriggerManager ? createPhaseMonitorHook(ctx.directory, preflightTriggerManager) : undefined
+      automationConfig.capabilities?.phase_preflight === true && preflightTriggerManager ? createPhaseMonitorHook(ctx.directory, preflightTriggerManager) : knowledgeConfig.enabled ? createPhaseMonitorHook(ctx.directory) : undefined
     ].filter(Boolean)),
     "experimental.session.compacting": compactionHook["experimental.session.compacting"],
     "command.execute.before": safeHook(commandHandler),

package/package.json

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