opencode-swarm 7.51.6 → 7.52.1

package/dist/state.d.ts

@@ -7,6 +7,7 @@
  * and delegation chains.
  */
 import type { OpencodeClient } from '@opencode-ai/sdk';
+import type { CouncilAgent } from './council/types';
 import { type QaGates } from './db/qa-gate-profile.js';
 import { type EnvironmentProfile } from './environment/profile.js';
 import type { EscalationTracker } from './prm/escalation.js';
@@ -124,6 +125,11 @@ export interface AgentSessionState {
          */
         quorumSize: number;
     }>;
+    /**
+     * Per-(task,round) required council members for the next submission attempt.
+     * Key format: `${taskId}:${roundNumber}`.
+     */
+    pendingCouncilRequirements?: Map<string, Set<CouncilAgent>>;
     /** Last gate outcome for deliberation preamble injection */
     lastGateOutcome: {
         gate: string;

package/dist/summaries/schema.d.ts

@@ -22,8 +22,8 @@ export declare const MAX_LIST_ITEMS = 5;
 /** Verdict vocabulary — mirrors the phase-council gate (APPROVE | CONCERNS | REJECT). */
 export declare const SupervisorVerdictSchema: z.ZodEnum<{
     APPROVE: "APPROVE";
-    REJECT: "REJECT";
     CONCERNS: "CONCERNS";
+    REJECT: "REJECT";
 }>;
 export type SupervisorVerdict = z.infer<typeof SupervisorVerdictSchema>;
 /** Count whitespace-delimited words in a string. */
@@ -120,8 +120,8 @@ export declare const ArchitectureSupervisorReportSchema: z.ZodObject<{
     phase: z.ZodNumber;
     verdict: z.ZodEnum<{
         APPROVE: "APPROVE";
-        REJECT: "REJECT";
         CONCERNS: "CONCERNS";
+        REJECT: "REJECT";
     }>;
     findings: z.ZodDefault<z.ZodArray<z.ZodObject<{
         severity: z.ZodEnum<{

package/dist/tools/convene-council.d.ts

@@ -29,9 +29,10 @@ export declare const ArgsSchema: z.ZodObject<{
         }>;
         verdict: z.ZodEnum<{
             APPROVE: "APPROVE";
-            REJECT: "REJECT";
             CONCERNS: "CONCERNS";
+            REJECT: "REJECT";
         }>;
+        verdictRound: z.ZodOptional<z.ZodNumber>;
         confidence: z.ZodNumber;
         findings: z.ZodArray<z.ZodObject<{
             severity: z.ZodEnum<{

package/dist/tools/submit-phase-council-verdicts.d.ts

@@ -15,9 +15,10 @@ export declare const ArgsSchema: z.ZodObject<{
         }>;
         verdict: z.ZodEnum<{
             APPROVE: "APPROVE";
-            REJECT: "REJECT";
             CONCERNS: "CONCERNS";
+            REJECT: "REJECT";
         }>;
+        verdictRound: z.ZodOptional<z.ZodNumber>;
         confidence: z.ZodNumber;
         findings: z.ZodArray<z.ZodObject<{
             severity: z.ZodEnum<{

package/dist/tools/write-final-council-evidence.d.ts

@@ -22,8 +22,8 @@ export declare const ArgsSchema: z.ZodObject<{
         }>;
         verdict: z.ZodEnum<{
             APPROVE: "APPROVE";
-            REJECT: "REJECT";
             CONCERNS: "CONCERNS";
+            REJECT: "REJECT";
         }>;
         confidence: z.ZodNumber;
         findings: z.ZodArray<z.ZodObject<{

package/dist/types/context-capsule.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Context Capsule Types
+ * Role-specific context injection at delegation time for the opencode-swarm plugin.
+ * These types define the schema used by the Context Capsule feature to build
+ * targeted, role-appropriate context packages for agent delegation.
+ *
+ * Capsules are generated by the capsule builder and consumed by delegated agents
+ * to receive focused, relevant context without re-reading the entire codebase.
+ *
+ * See issue #1104, FR-003 and FR-004.
+ */
+/**
+ * Reason a capsule was generated for a delegated agent.
+ * Named `CapsuleDelegationReason` to avoid collision with `DelegationReason`
+ * in `src/state.ts`, which serves a different purpose (tracking agent
+ * interaction history).
+ */
+export type CapsuleDelegationReason = 'new_task' | 'reviewer_rejection_fix' | 'critic_plan_review' | 'test_failure_fix';
+/**
+ * Agent roles that can receive context capsules.
+ * Each role maps to a different capsule strategy determining
+ * which context is included and how it is presented.
+ */
+export type AgentRole = 'coder' | 'reviewer' | 'critic' | 'test_engineer' | 'sme';
+/**
+ * A single read policy instruction within a context capsule.
+ * Tells the delegated agent whether it can trust the cached summary
+ * for a given file or must read the original source directly.
+ */
+export interface ReadPolicyEntry {
+    /** Relative file path this policy applies to */
+    file_path: string;
+    /** Whether the agent can trust the cached summary for this file */
+    trust_summary: boolean;
+    /** Whether the agent should read the actual file contents */
+    read_original: boolean;
+    /** Why this policy decision was made (e.g. "summary is stale", "file is small") */
+    reason: string;
+}
+/**
+ * Maps an agent role to its capsule construction strategy.
+ * Controls how much context is included and which optional
+ * sections (rejection history, coverage targets, claims) are added.
+ */
+export interface RoleProfile {
+    /** The agent role this profile applies to */
+    role: AgentRole;
+    /** Strategy name (e.g. "scoped_files_plus_rejection") */
+    strategy: string;
+    /** Maximum number of files to include in the capsule */
+    max_files: number;
+    /** Whether to include prior rejection context for fix iterations */
+    include_rejection: boolean;
+    /** Whether to include coverage targets (relevant for test_engineer) */
+    include_coverage: boolean;
+    /** Whether to include claimed fix or implementation details */
+    include_claims: boolean;
+}
+/**
+ * Metadata returned by the capsule builder after generating a capsule.
+ * Provides diagnostics on cache utilization, staleness detection,
+ * and reading recommendations for the consuming agent.
+ */
+export interface CapsuleMetadata {
+    /** Whether the capsule was generated successfully */
+    success: boolean;
+    /** File system path where the capsule was written */
+    capsule_path: string;
+    /** Estimated token count of the capsule content */
+    token_estimate: number;
+    /** Number of entries reused from the context map cache */
+    cache_hits: number;
+    /** Number of entries that required fresh computation */
+    cache_misses: number;
+    /** Number of stale entries detected during generation */
+    stale_entries: number;
+    /** Files the agent should still read directly despite summaries */
+    recommended_reads: string[];
+    /** Files whose cached summaries were sufficient (no direct read needed) */
+    skipped_reads: string[];
+}
+/**
+ * The full context capsule delivered to a delegated agent.
+ * Contains all role-specific context needed for the agent to begin
+ * work, including task goals, file scope, prior feedback, and
+ * per-file read policies.
+ */
+export interface ContextCapsule {
+    /** Task ID this capsule is for (e.g. "1.1", "2.3") */
+    task_id: string;
+    /** Which agent role receives this capsule */
+    agent_role: AgentRole;
+    /** Why this capsule was generated */
+    delegation_reason: CapsuleDelegationReason;
+    /** ISO 8601 timestamp of when the capsule was generated */
+    generated_at: string;
+    /** Files relevant to this task (the task's file scope) */
+    files_in_scope: string[];
+    /** What the task aims to accomplish */
+    task_goal: string;
+    /** Prior rejection reason, if this capsule is for a fix iteration */
+    prior_rejection?: string;
+    /** What needs to be fixed, if applicable */
+    required_fix?: string;
+    /** Repository facts relevant to this task */
+    relevant_facts: string[];
+    /** Review checklist items, included for reviewer capsules */
+    review_checklist?: string[];
+    /** Coverage targets, included for test_engineer capsules */
+    coverage_targets?: string[];
+    /** Per-file read policy: which summaries to trust vs which files to read */
+    read_policy: ReadPolicyEntry[];
+    /** The full markdown content of the capsule */
+    content: string;
+}

package/dist/types/context-map.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Context Map Types
+ * Durable data model for cross-agent context sharing in the opencode-swarm plugin.
+ * These types define the schema used by the Context Map feature to capture
+ * file-level summaries, task history, and architectural decisions for
+ * efficient context injection across agent interactions.
+ *
+ * The Context Map is opt-in (enabled=false by default) and uses SHA-256
+ * content hashes for file invalidation detection.
+ */
+/**
+ * Branded type alias for a SHA-256 content hash string.
+ * Always a 64-character lowercase hex string produced by hashing file contents.
+ */
+export type ContentHash = string;
+/**
+ * Summary of a single source file in the context map.
+ * Provides a condensed view of file contents, structure, and metadata
+ * to enable efficient cross-agent context sharing without re-reading full files.
+ */
+export interface FileContextEntry {
+    /** Relative file path within the project */
+    path: string;
+    /** SHA-256 hash of file contents for invalidation detection */
+    content_hash: ContentHash;
+    /** File modification timestamp in milliseconds since epoch (fast pre-check) */
+    mtime_ms: number;
+    /** Programming language (e.g. "typescript", "javascript", "python") */
+    language?: string;
+    /** One-to-two sentence description of what this file does */
+    purpose: string;
+    /** Exported symbol names from this file */
+    exports?: string[];
+    /** Imported module paths referenced by this file */
+    imports?: string[];
+    /** Important types, functions, or classes defined in this file */
+    key_symbols?: string[];
+    /** Observed constraints or rules governing this file's behavior */
+    invariants?: string[];
+    /** Detected risk factors (complexity, churn, fragility, etc.) */
+    risks?: string[];
+    /** Related test file paths covering this file */
+    tests?: string[];
+    /** Task IDs that last accessed or modified this file */
+    last_seen_task_ids?: string[];
+    /** Natural language summary of file purpose and key behavior */
+    summary: string;
+}
+/**
+ * Summary of a completed or in-progress task within the context map.
+ * Captures what a task set out to do, what files it touched, and
+ * the evidence from reviewer, critic, and test gates.
+ */
+export interface TaskContextSummary {
+    /** Unique task identifier (e.g. "1.1", "2.3") */
+    task_id: string;
+    /** What the task was supposed to accomplish */
+    goal: string;
+    /** Files modified during the task */
+    files_touched: string[];
+    /** Natural language description of what was actually implemented */
+    implementation_summary?: string;
+    /** Reviewer feedback extracted from evidence files */
+    reviewer_findings?: string[];
+    /** Critic feedback extracted from evidence files */
+    critic_findings?: string[];
+    /** Test results extracted from evidence files */
+    test_findings?: string[];
+    /** Final disposition of the task after QA gates */
+    final_status: 'pending' | 'approved' | 'rejected' | 'blocked';
+}
+/**
+ * Architectural decision made during a session, captured in the context map.
+ * These decisions provide reasoning context for future agents to understand
+ * why certain approaches were chosen or rejected.
+ */
+export interface DecisionEntry {
+    /** Unique identifier for the decision (e.g. "D1", "D2") */
+    id: string;
+    /** The actual decision text describing what was decided */
+    decision: string;
+    /** Rationale explaining why this decision was made */
+    rationale: string;
+    /** ISO 8601 timestamp of when the decision was recorded */
+    timestamp: string;
+    /** Related task ID if the decision was made in the context of a specific task */
+    task_id?: string;
+    /** Related phase number if the decision was phase-scoped */
+    phase?: number;
+}
+/**
+ * The top-level context map structure.
+ * This is the root object that aggregates file summaries, task history,
+ * and architectural decisions into a single durable snapshot.
+ * Used for efficient cross-agent context injection without re-reading
+ * full source files.
+ */
+export interface ContextMap {
+    /** Schema version for forward-compatibility (currently 1) */
+    schema_version: 1;
+    /** ISO 8601 timestamp of when this context map was generated */
+    generated_at: string;
+    /** Unique repository identifier for cache invalidation across repos */
+    repo_fingerprint: string;
+    /** File context entries keyed by relative file path */
+    files: Record<string, FileContextEntry>;
+    /** Task history entries keyed by task ID */
+    task_history: Record<string, TaskContextSummary>;
+    /** Architectural decisions recorded during the session */
+    decisions: DecisionEntry[];
+}
+/**
+ * Entry tracking a file detected as stale in the context map.
+ * Used to identify which files need re-analysis due to content changes
+ * since the context map was last generated.
+ */
+export interface ContextMapStaleEntry {
+    /** Relative file path of the stale file */
+    path: string;
+    /** SHA-256 content hash at the time the context map was generated */
+    old_hash: ContentHash;
+    /** ISO 8601 timestamp of when staleness was detected */
+    detected_at: string;
+}

package/package.json

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