opencode-swarm 6.86.14 → 7.0.0

package/dist/commands/close.d.ts

@@ -1,5 +1,6 @@
 /**
  * Handles /swarm close command - performs full terminal session finalization:
+ * 0. Guarantee: mark all incomplete phases/tasks as closed
  * 1. Finalize: write retrospectives, produce terminal summary
  * 2. Archive: create timestamped bundle of swarm artifacts
  * 3. Clean: clear active-state files that confuse future swarms

package/dist/commands/issue.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Handle /swarm issue command.
+ *
+ * Triggers the architect to enter MODE: ISSUE_INGEST — the swarm issue ingest workflow.
+ * Accepts issue URL in multiple formats and sanitizes inputs against injection.
+ *
+ * Flag parsing:
+ *   --plan        → appends plan=true to emitted signal
+ *   --trace       → appends trace=true to emitted signal (implies --plan)
+ *   --no-repro    → appends noRepro=true to emitted signal
+ *   no args       → returns usage string (no throw)
+ */
+export declare function handleIssueCommand(_directory: string, args: string[]): string;

package/dist/commands/pr-review.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Handle /swarm pr-review command.
+ *
+ * Triggers the architect to enter MODE: PR_REVIEW — the swarm PR review workflow.
+ * Accepts PR URL in multiple formats and sanitizes inputs against injection.
+ *
+ * Flag parsing:
+ *   --council       → appends council=true to emitted signal
+ *   no args         → returns usage string (no throw)
+ */
+export declare function handlePrReviewCommand(_directory: string, args: string[]): string;

package/dist/commands/registry.d.ts

@@ -166,11 +166,23 @@ export declare const COMMAND_REGISTRY: {
         readonly args: "<question> [--preset <name>] [--spec-review]";
         readonly details: "Triggers the architect to convene a configurable General Council: each member independently web-searches, answers, and engages in one structured deliberation round on disagreements; an optional moderator pass synthesizes the final answer. --preset <name> selects a member group from council.general.presets. --spec-review switches to single-pass advisory mode for spec review. Requires council.general.enabled: true and a search API key in opencode-swarm.json.";
     };
+    readonly 'pr-review': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Launch deep PR review with multi-lane analysis [url] [--council]";
+        readonly args: "<pr-url|owner/repo#N|N> [--council]";
+        readonly details: "Launches a structured PR review: reconstructs PR intent via obligation extraction cascade, runs 6 parallel explorer lanes (correctness, security, dependencies, docs-intent-vs-actual, tests, performance-architecture), validates findings through independent reviewer confirmation, applies critic challenge to HIGH/CRITICAL findings, synthesizes structured report. --council variant fires adversarial multi-model review. Supports full GitHub URL, owner/repo#N shorthand, or bare PR number (resolves against origin remote).";
+    };
+    readonly issue: {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Ingest a GitHub issue into the swarm workflow [url] [--plan] [--trace] [--no-repro]";
+        readonly args: "<issue-url|owner/repo#N|N> [--plan] [--trace] [--no-repro]";
+        readonly details: "Triggers the architect to enter MODE: ISSUE_INGEST — ingests a GitHub issue, restructures it into a normalized intake note, localizes root cause through hypothesis-driven tracing, and outputs a resolution spec. --plan transitions to plan creation after spec generation. --trace runs the full fix-and-PR workflow (implies --plan). --no-repro skips the reproduction step. Supports full GitHub URL, owner/repo#N shorthand, or bare issue number (resolves against origin remote).";
+    };
     readonly 'qa-gates': {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "View or modify QA gate profile for the current plan [enable|override <gate>...]";
         readonly args: "[show|enable|override] <gate>...";
-        readonly details: "show: display spec-level, session-override, and effective QA gates for the current plan. enable: persist gate(s) into the locked-once profile (architect; rejected after critic approval lock). override: session-only ratchet-tighter enable. Valid gates: reviewer, test_engineer, council_mode, sme_enabled, critic_pre_plan, hallucination_guard, sast_enabled, mutation_test, council_general_review.";
+        readonly details: "show: display spec-level, session-override, and effective QA gates for the current plan. enable: persist gate(s) into the locked-once profile (architect; rejected after critic approval lock). override: session-only ratchet-tighter enable. Valid gates: reviewer, test_engineer, council_mode, sme_enabled, critic_pre_plan, hallucination_guard, sast_enabled, mutation_test, council_general_review, drift_check.";
     };
     readonly promote: {
         readonly handler: (ctx: CommandContext) => Promise<string>;

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

@@ -103,6 +103,10 @@ export declare const PhaseSchema: z.ZodObject<{
         evidence_path: z.ZodOptional<z.ZodString>;
         blocked_reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+    type: z.ZodOptional<z.ZodEnum<{
+        code: "code";
+        "non-code": "non-code";
+    }>>;
     required_agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type Phase = z.infer<typeof PhaseSchema>;
@@ -144,6 +148,10 @@ export declare const PlanSchema: z.ZodObject<{
             evidence_path: z.ZodOptional<z.ZodString>;
             blocked_reason: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
+        type: z.ZodOptional<z.ZodEnum<{
+            code: "code";
+            "non-code": "non-code";
+        }>>;
         required_agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
     migration_status: z.ZodOptional<z.ZodEnum<{

package/dist/config/schema.d.ts

@@ -583,6 +583,7 @@ export declare const CouncilConfigSchema: z.ZodObject<{
     requireAllMembers: z.ZodDefault<z.ZodBoolean>;
     minimumMembers: z.ZodDefault<z.ZodNumber>;
     escalateOnMaxRounds: z.ZodOptional<z.ZodString>;
+    phaseConcernsAllowComplete: z.ZodDefault<z.ZodBoolean>;
     general: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         searchProvider: z.ZodDefault<z.ZodEnum<{
@@ -625,6 +626,8 @@ export declare const ParallelizationConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     maxConcurrentTasks: z.ZodDefault<z.ZodNumber>;
     evidenceLockTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    max_coders: z.ZodDefault<z.ZodNumber>;
+    max_reviewers: z.ZodDefault<z.ZodNumber>;
     stageB: z.ZodDefault<z.ZodObject<{
         parallel: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1007,6 +1010,7 @@ export declare const PluginConfigSchema: z.ZodObject<{
         requireAllMembers: z.ZodDefault<z.ZodBoolean>;
         minimumMembers: z.ZodDefault<z.ZodNumber>;
         escalateOnMaxRounds: z.ZodOptional<z.ZodString>;
+        phaseConcernsAllowComplete: z.ZodDefault<z.ZodBoolean>;
         general: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             searchProvider: z.ZodDefault<z.ZodEnum<{
@@ -1048,6 +1052,8 @@ export declare const PluginConfigSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         maxConcurrentTasks: z.ZodDefault<z.ZodNumber>;
         evidenceLockTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        max_coders: z.ZodDefault<z.ZodNumber>;
+        max_reviewers: z.ZodDefault<z.ZodNumber>;
         stageB: z.ZodDefault<z.ZodObject<{
             parallel: z.ZodDefault<z.ZodObject<{
                 enabled: z.ZodDefault<z.ZodBoolean>;

package/dist/council/council-service.d.ts

@@ -8,5 +8,14 @@
  * No I/O — fully unit-testable with mock inputs. All file reads/writes happen in
  * sibling modules (criteria-store, council-evidence-writer).
  */
-import type { CouncilConfig, CouncilCriteria, CouncilMemberVerdict, CouncilSynthesis } from './types';
+import type { CouncilConfig, CouncilCriteria, CouncilMemberVerdict, CouncilSynthesis, PhaseCouncilSynthesis } from './types';
 export declare function synthesizeCouncilVerdicts(taskId: string, swarmId: string, verdicts: CouncilMemberVerdict[], criteria: CouncilCriteria | null, roundNumber: number, config?: Partial<CouncilConfig>): CouncilSynthesis;
+/**
+ * Synthesize phase-level council verdicts into a PhaseCouncilSynthesis.
+ * Reuses the same veto detection, conflict detection, and finding
+ * classification logic as per-task council, but scoped to a phase number.
+ *
+ * Evidence is written to .swarm/evidence/{phase}/phase-council.json relative
+ * to workingDir (or cwd).
+ */
+export declare function synthesizePhaseCouncilAdvisory(phaseNumber: number, phaseSummary: string, verdicts: CouncilMemberVerdict[], roundNumber: number, config?: Partial<CouncilConfig>, workingDir?: string): PhaseCouncilSynthesis;

package/dist/council/types.d.ts

@@ -53,6 +53,40 @@ export interface CouncilSynthesis {
     /** true when called with an empty verdicts array — the APPROVE is vacuous */
     emptyVerdictsWarning?: boolean;
 }
+/**
+ * Phase-level council synthesis result.
+ * Distinct from CouncilSynthesis — scoped to a phase number
+ * rather than a task ID, and targets .swarm/evidence/{phase}/phase-council.json
+ * for evidence-file attestation.
+ */
+export interface PhaseCouncilSynthesis {
+    phaseNumber: number;
+    /** Always 'phase' — distinguishes from task-level council */
+    scope: 'phase';
+    /** ISO 8601 */
+    timestamp: string;
+    overallVerdict: CouncilVerdict;
+    vetoedBy: CouncilAgent[] | null;
+    memberVerdicts: CouncilMemberVerdict[];
+    unresolvedConflicts: string[];
+    /** Severity HIGH + MEDIUM from veto members */
+    requiredFixes: CouncilFinding[];
+    /** Severity LOW or from non-veto members */
+    advisoryFindings: CouncilFinding[];
+    /** Phase-level advisory notes for the architect */
+    advisoryNotes: string[];
+    /** Single markdown document for phase review */
+    unifiedFeedbackMd: string;
+    /** 1-indexed */
+    roundNumber: number;
+    allCriteriaMet: boolean;
+    /** Distinct council members that produced verdicts */
+    quorumSize: number;
+    /** Path where evidence was written, e.g. .swarm/evidence/1/phase-council.json */
+    evidencePath: string;
+    /** Summary of the phase being reviewed */
+    phaseSummary?: string;
+}
 export interface CouncilCriteriaItem {
     id: string;
     description: string;
@@ -86,5 +120,7 @@ export interface CouncilConfig {
      * options: critic_oversight agent, HTTP webhook, or configurable handler.
      */
     escalateOnMaxRounds?: string;
+    /** Default true — CONCERNS verdict at phase-level council does NOT block completion (advisory). Set false to make CONCERNS block like REJECT. */
+    phaseConcernsAllowComplete: boolean;
 }
 export declare const COUNCIL_DEFAULTS: CouncilConfig;

package/dist/db/qa-gate-profile.d.ts

@@ -7,7 +7,7 @@
  * Sessions can only ratchet gates tighter (enable more), never disable them.
  */
 /**
- * QA gate flags. All nine gates are tracked explicitly.
+ * QA gate flags. All ten gates are tracked explicitly.
  */
 export interface QaGates {
     reviewer: boolean;
@@ -19,6 +19,7 @@ export interface QaGates {
     sast_enabled: boolean;
     mutation_test: boolean;
     council_general_review: boolean;
+    drift_check: boolean;
 }
 /**
  * Default QA gate configuration for newly-created profiles.
@@ -96,6 +97,8 @@ export declare function computeProfileHash(profile: QaGateProfile): string;
  * - council_general_review — src/agents/architect.ts SPECIFY-COUNCIL-REVIEW
  *   (fires when gate is true; runs convene_general_council on draft spec before
  *   critic-gate to fold multi-model deliberation into the spec).
+ * - drift_check — src/tools/phase-complete.ts Gate 2 (blocks phase_complete when
+ *   drift-verifier.json missing or rejected)
  *
  * Session overrides are intentionally ephemeral — they live only in
  * in-memory `AgentSessionState.qaGateSessionOverrides` and are NOT

package/dist/git/branch.d.ts

@@ -48,3 +48,23 @@ export declare function getCurrentSha(cwd: string): string;
  * Check if there are uncommitted changes
  */
 export declare function hasUncommittedChanges(cwd: string): boolean;
+export interface ResetToRemoteBranchResult {
+    success: boolean;
+    targetBranch: string;
+    localBranch: string;
+    message: string;
+    alreadyAligned: boolean;
+    prunedBranches: string[];
+    warnings: string[];
+}
+/**
+ * Reset local branch to align with its remote counterpart.
+ * Safely handles uncommitted changes, unpushed commits, and detached HEAD states.
+ *
+ * @param cwd - Working directory
+ * @param options - Options including pruneBranches flag
+ * @returns Result object with success status and details
+ */
+export declare function resetToRemoteBranch(cwd: string, options?: {
+    pruneBranches?: boolean;
+}): ResetToRemoteBranchResult;