opencode-swarm 6.20.2 → 6.21.0

package/dist/state.d.ts

@@ -33,6 +33,11 @@ export interface DelegationEntry {
     to: string;
     timestamp: number;
 }
+/**
+ * Per-task workflow state for gate progression tracking.
+ * Transitions must be forward-only: idle → coder_delegated → pre_check_passed → reviewer_run → tests_run → complete
+ */
+export type TaskWorkflowState = 'idle' | 'coder_delegated' | 'pre_check_passed' | 'reviewer_run' | 'tests_run' | 'complete';
 /**
  * Represents per-session state for guardrail tracking.
  * Budget fields (toolCallCount, consecutiveErrors, etc.) have moved to InvocationWindow.
@@ -81,6 +86,23 @@ export interface AgentSessionState {
     qaSkipCount: number;
     /** Task IDs skipped without QA (for audit trail), reset when reviewer/test_engineer fires */
     qaSkipTaskIds: string[];
+    /** Per-task workflow state — taskId → current state */
+    taskWorkflowStates: Map<string, TaskWorkflowState>;
+    /** Last gate outcome for deliberation preamble injection */
+    lastGateOutcome: {
+        gate: string;
+        taskId: string;
+        passed: boolean;
+        timestamp: number;
+    } | null;
+    /** Declared file scope for current coder task (null = no scope declared) */
+    declaredCoderScope: string[] | null;
+    /** Last scope violation message (null = no violation) */
+    lastScopeViolation: string | null;
+    /** Flag for one-shot scope violation warning injection in messagesTransform */
+    scopeViolationDetected?: boolean;
+    /** Files modified by the current coder task (populated by guardrails toolBefore/toolAfter, reset on new coder delegation) */
+    modifiedFilesThisCoderTask: string[];
     /** Timestamp of most recent phase completion */
     lastPhaseCompleteTimestamp: number;
     /** Phase number of most recent phase completion */
@@ -209,3 +231,23 @@ export declare function pruneOldWindows(sessionId: string, maxAgeMs?: number, ma
  * @param agentName - Agent name to record (will be normalized)
  */
 export declare function recordPhaseAgentDispatch(sessionId: string, agentName: string): void;
+/**
+ * Advance a task's workflow state. Validates forward-only transitions.
+ * Throws 'INVALID_TASK_STATE_TRANSITION: [taskId] [current] → [requested]' on illegal transition.
+ *
+ * Valid forward order: idle → coder_delegated → pre_check_passed → reviewer_run → tests_run → complete
+ *
+ * @param session - The agent session state
+ * @param taskId - The task identifier
+ * @param newState - The requested new state
+ */
+export declare function advanceTaskState(session: AgentSessionState, taskId: string, newState: TaskWorkflowState): void;
+/**
+ * Get the current workflow state for a task.
+ * Returns 'idle' if no entry exists.
+ *
+ * @param session - The agent session state
+ * @param taskId - The task identifier
+ * @returns Current task workflow state
+ */
+export declare function getTaskState(session: AgentSessionState, taskId: string): TaskWorkflowState;

package/dist/tools/declare-scope.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Declare scope tool for setting the file scope for coder delegations.
+ * Implements FR-010: Declare coder scope before delegation.
+ * This tool must be called before delegating to mega_coder to enable scope containment checking.
+ */
+import { type ToolDefinition } from '@opencode-ai/plugin/tool';
+/**
+ * Arguments for the declare_scope tool
+ */
+export interface DeclareScopeArgs {
+    taskId: string;
+    files: string[];
+    whitelist?: string[];
+    working_directory?: string;
+}
+/**
+ * Result from executing declare_scope
+ */
+export interface DeclareScopeResult {
+    success: boolean;
+    message: string;
+    taskId?: string;
+    fileCount?: number;
+    errors?: string[];
+}
+/**
+ * Validate that taskId matches the required format (N.M or N.M.P).
+ * @param taskId - The task ID to validate
+ * @returns Error message if invalid, undefined if valid
+ */
+export declare function validateTaskIdFormat(taskId: string): string | undefined;
+/**
+ * Validate file entries for security concerns.
+ * @param files - Array of file paths to validate
+ * @returns Array of error messages, empty if all valid
+ */
+export declare function validateFiles(files: string[]): string[];
+/**
+ * Execute the declare_scope tool.
+ * Validates the taskId and files, then sets the declared scope on all active architect sessions.
+ * @param args - The declare scope arguments
+ * @param fallbackDir - Fallback directory for plan lookup
+ * @returns DeclareScopeResult with success status and details
+ */
+export declare function executeDeclareScope(args: DeclareScopeArgs, fallbackDir?: string): Promise<DeclareScopeResult>;
+/**
+ * Tool definition for declare_scope
+ */
+export declare const declare_scope: ToolDefinition;

package/dist/tools/index.d.ts

@@ -1,6 +1,7 @@
 export { build_check } from './build-check';
 export { checkpoint } from './checkpoint';
 export { complexity_hotspots } from './complexity-hotspots';
+export { declare_scope } from './declare-scope';
 export { type DiffErrorResult, type DiffResult, diff } from './diff';
 export { detect_domains } from './domain-detector';
 export { evidence_check } from './evidence-check';
@@ -23,6 +24,6 @@ export { type SecretFinding, type SecretscanResult, secretscan, } from './secret
 export { symbols } from './symbols';
 export { type SyntaxCheckFileResult, type SyntaxCheckInput, type SyntaxCheckResult, syntaxCheck, } from './syntax-check';
 export { test_runner } from './test-runner';
-export { type UpdateTaskStatusArgs, type UpdateTaskStatusResult, executeUpdateTaskStatus, update_task_status, } from './update-task-status';
 export { todo_extract } from './todo-extract';
+export { executeUpdateTaskStatus, type UpdateTaskStatusArgs, type UpdateTaskStatusResult, update_task_status, } from './update-task-status';
 export { executeWriteRetro, write_retro } from './write-retro';

package/dist/tools/tool-names.d.ts

@@ -3,7 +3,7 @@
  * Used for constants and agent setup references.
  */
 /** Union type of all valid tool names */
-export type ToolName = 'diff' | 'syntax_check' | 'placeholder_scan' | 'imports' | 'lint' | 'secretscan' | 'sast_scan' | 'build_check' | 'pre_check_batch' | 'quality_budget' | 'symbols' | 'complexity_hotspots' | 'schema_drift' | 'todo_extract' | 'evidence_check' | 'sbom_generate' | 'checkpoint' | 'pkg_audit' | 'test_runner' | 'detect_domains' | 'gitingest' | 'retrieve_summary' | 'extract_code_blocks' | 'phase_complete' | 'save_plan' | 'update_task_status' | 'write_retro';
+export type ToolName = 'diff' | 'syntax_check' | 'placeholder_scan' | 'imports' | 'lint' | 'secretscan' | 'sast_scan' | 'build_check' | 'pre_check_batch' | 'quality_budget' | 'symbols' | 'complexity_hotspots' | 'schema_drift' | 'todo_extract' | 'evidence_check' | 'sbom_generate' | 'checkpoint' | 'pkg_audit' | 'test_runner' | 'detect_domains' | 'gitingest' | 'retrieve_summary' | 'extract_code_blocks' | 'phase_complete' | 'save_plan' | 'update_task_status' | 'write_retro' | 'declare_scope';
 /** Readonly array of all tool names */
 export declare const TOOL_NAMES: readonly ToolName[];
 /** Set for O(1) tool name validation */

package/dist/tools/update-task-status.d.ts

@@ -34,6 +34,21 @@ export declare function validateStatus(status: string): string | undefined;
  * @returns Error message if invalid, undefined if valid
  */
 export declare function validateTaskId(taskId: string): string | undefined;
+/**
+ * Result from checking reviewer gate presence
+ */
+export interface ReviewerGateResult {
+    blocked: boolean;
+    reason: string;
+}
+/**
+ * Check if a task has passed required QA gates using the state machine.
+ * Requires the task to be in 'tests_run' or 'complete' state, which means
+ * both reviewer delegation and test_engineer runs have been recorded.
+ * @param taskId - The task ID to check gate state for
+ * @returns ReviewerGateResult indicating whether the gate is blocked
+ */
+export declare function checkReviewerGate(taskId: string): ReviewerGateResult;
 /**
  * Execute the update_task_status tool.
  * Validates the task_id and status, then updates the task status in the plan.

package/package.json

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