opencode-swarm 7.12.0 → 7.13.0

package/README.md

@@ -217,12 +217,12 @@ in your `opencode-swarm.json`.
 
 ## Commands
 
-All 41 subcommands at a glance:
+All 43 subcommands at a glance:
 
 ```bash
 /swarm help [command]      # List all commands or get detailed help for a specific command
 /swarm status              # Current phase and task
-/swarm plan [N]            # Full plan or filtered by phase
+/swarm show-plan [N]       # Full plan or filtered by phase
 /swarm agents              # Registered agents and models
 /swarm diagnose            # Health check
 /swarm evidence [task]     # Test and review results
@@ -233,7 +233,7 @@ Use `/swarm help` to see all available commands categorized by function. Use `/s
 
 Nine commands display a ⚠️ warning in help output because they share names with Claude Code built-in slash commands (e.g., `/plan`, `/reset`, `/status`). The warning reminds you to always use `/swarm <command>` — the bare CC command does something different and sometimes destructive. See [docs/commands.md#claude-code-command-conflicts](docs/commands.md#claude-code-command-conflicts) for the full conflict registry.
 
-See [docs/commands.md](docs/commands.md) for the full reference (41 commands).
+See [docs/commands.md](docs/commands.md) for the full reference (43 commands).
 
 ## Command Aliases
 
@@ -248,6 +248,8 @@ Some commands are available under deprecated names for backwards compatibility.
 | `/swarm info` | `/swarm status` |
 | `/swarm list-agents` | `/swarm agents` |
 | `/swarm health` | `/swarm diagnose` |
+| `/swarm plan` | `/swarm show-plan` |
+| `/swarm close` | `/swarm finalize` |
 | `/swarm check` | `/swarm preflight` |
 | `/swarm clear` | `/swarm reset-session` |
 
@@ -1321,7 +1323,8 @@ Control how tool outputs are summarized for LLM context.
 |---------|-------------|
 | `/swarm help [command]` | List all commands or get detailed help for a specific command |
 | `/swarm status` | Current phase, task progress, agent count |
-| `/swarm plan [N]` | Full plan or filtered by phase |
+| `/swarm show-plan [N]` | Full plan or filtered by phase |
+| `/swarm plan [N]` | Deprecated alias for `/swarm show-plan [N]` |
 | `/swarm agents` | Registered agents with models and permissions |
 | `/swarm history` | Completed phases with status |
 | `/swarm config` | Current resolved configuration |
@@ -1340,7 +1343,8 @@ Control how tool outputs are summarized for LLM context.
 | `/swarm specify [description]` | Generate or import a feature specification |
 | `/swarm clarify [topic]` | Clarify and refine an existing feature specification |
 | `/swarm analyze` | Analyze spec.md vs plan.md for requirement coverage gaps |
-| `/swarm close [--prune-branches]` | Idempotent session close-out: retrospectives, lesson curation, evidence archive, context.md reset, config-backup cleanup, optional branch pruning |
+| `/swarm finalize [--prune-branches]` | Idempotent session close-out: retrospectives, lesson curation, evidence archive, context.md reset, config-backup cleanup, optional branch pruning |
+| `/swarm close [--prune-branches]` | Deprecated alias for `/swarm finalize [--prune-branches]` |
 | `/swarm write-retro` | Write a phase retrospective manually |
 | `/swarm handoff` | Generate a handoff summary for context-budget-critical sessions |
 | `/swarm simulate` | Simulate plan execution without writing code |

package/dist/cli/index.js

@@ -34,7 +34,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.12.0",
+    version: "7.13.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",
@@ -48521,6 +48521,14 @@ var init_write_retro2 = __esm(() => {
   init_write_retro();
 });
 
+// src/commands/command-names.ts
+var COMMAND_NAMES, COMMAND_NAME_SET;
+var init_command_names = __esm(() => {
+  init_registry();
+  COMMAND_NAMES = Object.freeze(Object.keys(COMMAND_REGISTRY));
+  COMMAND_NAME_SET = new Set(COMMAND_NAMES);
+});
+
 // src/commands/index.ts
 var exports_commands = {};
 __export(exports_commands, {
@@ -48568,7 +48576,9 @@ __export(exports_commands, {
   createSwarmCommandHandler: () => createSwarmCommandHandler,
   buildHelpText: () => buildHelpText,
   VALID_COMMANDS: () => VALID_COMMANDS,
-  COMMAND_REGISTRY: () => COMMAND_REGISTRY
+  COMMAND_REGISTRY: () => COMMAND_REGISTRY,
+  COMMAND_NAME_SET: () => COMMAND_NAME_SET,
+  COMMAND_NAMES: () => COMMAND_NAMES
 });
 import fs22 from "fs";
 import path37 from "path";
@@ -48748,6 +48758,7 @@ var init_commands = __esm(() => {
   init_benchmark();
   init_checkpoint2();
   init_close();
+  init_command_names();
   init_config2();
   init_council();
   init_curate();
@@ -49005,11 +49016,19 @@ var init_registry = __esm(() => {
       category: "core",
       clashesWithNativeCcCommand: "/status"
     },
+    "show-plan": {
+      handler: (ctx) => handlePlanCommand(ctx.directory, ctx.args),
+      description: "Show current plan (optionally filter by phase number)",
+      category: "core",
+      args: "[phase-number]"
+    },
     plan: {
       handler: (ctx) => handlePlanCommand(ctx.directory, ctx.args),
-      description: "Show plan (optionally filter by phase number)",
+      description: "Show current plan (deprecated alias for /swarm show-plan)",
       category: "core",
-      clashesWithNativeCcCommand: "/plan"
+      clashesWithNativeCcCommand: "/plan",
+      aliasOf: "show-plan",
+      deprecated: true
     },
     agents: {
       handler: (ctx) => Promise.resolve(handleAgentsCommand(ctx.agents, undefined)),
@@ -49179,13 +49198,22 @@ var init_registry = __esm(() => {
       args: "--threshold <number>, --min-commits <number>",
       category: "diagnostics"
     },
-    close: {
+    finalize: {
       handler: (ctx) => handleCloseCommand(ctx.directory, ctx.args),
-      description: "Use /swarm close to close the swarm project and archive evidence",
+      description: "Use /swarm finalize to finalize the swarm project and archive evidence",
       details: "Idempotent 4-stage terminal finalization: (1) finalize writes retrospectives for in-progress phases, (2) archive creates timestamped bundle of swarm artifacts and evidence, (3) clean removes active-state files for a clean slate, (4) align performs safe git ff-only to main. Resets agent sessions and delegation chains. Reads .swarm/close-lessons.md for explicit lessons and runs curation.",
       args: "--prune-branches",
       category: "core"
     },
+    close: {
+      handler: (ctx) => handleCloseCommand(ctx.directory, ctx.args),
+      description: "Use /swarm close (deprecated alias) to finalize and archive swarm state",
+      details: "Deprecated alias for /swarm finalize. Preserved for backward compatibility.",
+      args: "--prune-branches",
+      category: "core",
+      aliasOf: "finalize",
+      deprecated: true
+    },
     simulate: {
       handler: (ctx) => handleSimulateCommand(ctx.directory, ctx.args),
       description: "Dry-run hidden coupling analysis with configurable thresholds",
@@ -49219,9 +49247,9 @@ var init_registry = __esm(() => {
     },
     council: {
       handler: (ctx) => handleCouncilCommand(ctx.directory, ctx.args),
-      description: "Enter architect MODE: COUNCIL \u2014 multi-model deliberation [question] [--spec-review]",
-      args: "<question> [--spec-review]",
-      details: "Triggers the architect to convene a three-agent General Council: Generalist (reviewer model), Skeptic (critic model), and Domain Expert (SME model). " + "The architect first runs 1\u20133 targeted web searches and passes a compiled RESEARCH CONTEXT " + "to all three agents before dispatching them in parallel. Agents deliberate using the NSED peer-review protocol (Round 1 independent analysis, Round 2 MAINTAIN/CONCEDE/NUANCE for disagreements). The architect synthesizes the final answer directly from convene_general_council output. --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.",
+      description: "Enter architect MODE: COUNCIL \u2014 multi-model deliberation [question] [--preset <name>] [--spec-review]",
+      args: "<question> [--preset <name>] [--spec-review]",
+      details: "Triggers the architect to convene a three-agent General Council: Generalist (reviewer model), Skeptic (critic model), and Domain Expert (SME model). Use --preset <name> to choose a named member preset from council.general.presets. " + "The architect first runs 1\u20133 targeted web searches and passes a compiled RESEARCH CONTEXT " + "to all three agents before dispatching them in parallel. Agents deliberate using the NSED peer-review protocol (Round 1 independent analysis, Round 2 MAINTAIN/CONCEDE/NUANCE for disagreements). The architect synthesizes the final answer directly from convene_general_council output. --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.",
       category: "agent"
     },
     "pr-review": {

package/dist/commands/command-names.d.ts

@@ -0,0 +1,4 @@
+import { COMMAND_REGISTRY } from './registry.js';
+export type CommandName = keyof typeof COMMAND_REGISTRY;
+export declare const COMMAND_NAMES: readonly CommandName[];
+export declare const COMMAND_NAME_SET: ReadonlySet<CommandName>;

package/dist/commands/command-names.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/conflict-registry.d.ts

@@ -17,12 +17,12 @@ export interface CommandConflict {
     disambiguationNote: string;
 }
 export declare const CLAUDE_CODE_CONFLICTS: readonly [{
-    readonly swarmCommand: "plan";
+    readonly swarmCommand: "show-plan";
     readonly ccCommand: "/plan";
     readonly severity: "CRITICAL";
     readonly ccBehavior: "Enters Claude Code plan mode — Claude proposes all actions before executing them";
     readonly swarmBehavior: "Displays the current .swarm/plan.md task list";
-    readonly disambiguationNote: "Use /swarm plan to read the swarm task plan. NEVER invoke the bare /plan command — it enters Claude Code plan mode and blocks execution.";
+    readonly disambiguationNote: "Use /swarm show-plan to read the swarm task plan. NEVER invoke the bare /plan command — it enters Claude Code plan mode and blocks execution.";
 }, {
     readonly swarmCommand: "reset";
     readonly ccCommand: "/reset";

package/dist/commands/index.d.ts

@@ -8,6 +8,8 @@ export { handleBrainstormCommand } from './brainstorm';
 export { handleCheckpointCommand } from './checkpoint';
 export { handleClarifyCommand } from './clarify';
 export { handleCloseCommand } from './close';
+export type { CommandName } from './command-names.js';
+export { COMMAND_NAME_SET, COMMAND_NAMES } from './command-names.js';
 export { handleConfigCommand } from './config';
 export { handleCouncilCommand } from './council';
 export { handleCurateCommand } from './curate';

package/dist/commands/registry.d.ts

@@ -50,11 +50,19 @@ export declare const COMMAND_REGISTRY: {
         readonly category: "core";
         readonly clashesWithNativeCcCommand: "/status";
     };
+    readonly 'show-plan': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Show current plan (optionally filter by phase number)";
+        readonly category: "core";
+        readonly args: "[phase-number]";
+    };
     readonly plan: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
-        readonly description: "Show plan (optionally filter by phase number)";
+        readonly description: "Show current plan (deprecated alias for /swarm show-plan)";
         readonly category: "core";
         readonly clashesWithNativeCcCommand: "/plan";
+        readonly aliasOf: "show-plan";
+        readonly deprecated: true;
     };
     readonly agents: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
@@ -224,13 +232,22 @@ export declare const COMMAND_REGISTRY: {
         readonly args: "--threshold <number>, --min-commits <number>";
         readonly category: "diagnostics";
     };
-    readonly close: {
+    readonly finalize: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
-        readonly description: "Use /swarm close to close the swarm project and archive evidence";
+        readonly description: "Use /swarm finalize to finalize the swarm project and archive evidence";
         readonly details: "Idempotent 4-stage terminal finalization: (1) finalize writes retrospectives for in-progress phases, (2) archive creates timestamped bundle of swarm artifacts and evidence, (3) clean removes active-state files for a clean slate, (4) align performs safe git ff-only to main. Resets agent sessions and delegation chains. Reads .swarm/close-lessons.md for explicit lessons and runs curation.";
         readonly args: "--prune-branches";
         readonly category: "core";
     };
+    readonly close: {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Use /swarm close (deprecated alias) to finalize and archive swarm state";
+        readonly details: "Deprecated alias for /swarm finalize. Preserved for backward compatibility.";
+        readonly args: "--prune-branches";
+        readonly category: "core";
+        readonly aliasOf: "finalize";
+        readonly deprecated: true;
+    };
     readonly simulate: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Dry-run hidden coupling analysis with configurable thresholds";
@@ -264,8 +281,8 @@ export declare const COMMAND_REGISTRY: {
     };
     readonly council: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
-        readonly description: "Enter architect MODE: COUNCIL — multi-model deliberation [question] [--spec-review]";
-        readonly args: "<question> [--spec-review]";
+        readonly description: "Enter architect MODE: COUNCIL — multi-model deliberation [question] [--preset <name>] [--spec-review]";
+        readonly args: "<question> [--preset <name>] [--spec-review]";
         readonly details: string;
         readonly category: "agent";
     };

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

@@ -15,7 +15,7 @@ export declare function synthesizeCouncilVerdicts(taskId: string, swarmId: strin
  * 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).
+ * Pure computation — no I/O. File writes are the caller's responsibility
+ * (see writePhaseCouncilEvidence in submit-phase-council-verdicts.ts).
  */
-export declare function synthesizePhaseCouncilAdvisory(phaseNumber: number, phaseSummary: string, verdicts: CouncilMemberVerdict[], roundNumber: number, config?: Partial<CouncilConfig>, workingDir?: string): PhaseCouncilSynthesis;
+export declare function synthesizePhaseCouncilAdvisory(phaseNumber: number, phaseSummary: string, verdicts: CouncilMemberVerdict[], roundNumber: number, config?: Partial<CouncilConfig>, _workingDir?: string): PhaseCouncilSynthesis;