opencode-swarm 7.58.0 → 7.59.0

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

@@ -26,6 +26,7 @@ export declare function executeSwarmCommand(args: {
     agents: Record<string, AgentDefinition>;
     sessionID: string;
     tokens: string[];
+    packageRoot?: string;
     includeWelcome?: boolean;
     buildHelpText?: () => string;
     policy?: SwarmCommandPolicy;

package/dist/commands/index.d.ts

@@ -52,6 +52,7 @@ export declare function buildHelpText(): string;
  */
 export declare function createSwarmCommandHandler(directory: string, agents: Record<string, AgentDefinition>, options?: {
     getActiveAgentName?: (sessionID: string) => string | undefined;
+    packageRoot?: string;
     registeredAgents?: Record<string, {
         tools?: Record<string, boolean>;
     }>;

package/dist/commands/registry.d.ts

@@ -8,6 +8,7 @@ export type CommandContext = {
     args: string[];
     sessionID: string;
     agents: Record<string, AgentDefinition>;
+    packageRoot?: string;
     /**
      * Dispatch path identifier. Issue #890: forensic audit trail for
      * commands that need to distinguish "user typed /swarm <cmd>" (chat)
@@ -276,89 +277,89 @@ export declare const COMMAND_REGISTRY: {
         readonly category: "agent";
     };
     readonly clarify: {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         readonly description: "Clarify and refine an existing feature specification";
         readonly args: "[description-text]";
         readonly category: "agent";
     };
     readonly specify: {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         readonly description: "Generate or import a feature specification [description]";
         readonly args: "[description-text]";
         readonly category: "agent";
     };
     readonly brainstorm: {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         readonly description: "Enter architect MODE: BRAINSTORM — structured seven-phase planning workflow [topic]";
         readonly args: "[topic-text]";
         readonly details: "Triggers the architect to run the brainstorm workflow: CONTEXT SCAN, single-question DIALOGUE, APPROACHES, DESIGN SECTIONS, SPEC WRITE + SELF-REVIEW, QA GATE SELECTION, TRANSITION. Use for new plans where requirements need to be drawn out before writing spec.md / plan.md.";
         readonly category: "agent";
     };
     readonly council: {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         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";
     };
     readonly 'pr-review': {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         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 category: "agent";
     };
     readonly 'pr-feedback': {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         readonly description: "Ingest and close known PR feedback (review comments, CI failures, conflicts) [pr] [instructions]";
         readonly args: "[url|owner/repo#N|N] [instructions...]";
         readonly details: "Triggers MODE: PR_FEEDBACK — ingests existing pull-request feedback (review threads, requested changes, CI/check failures, merge conflicts, stale branch state, pasted notes), verifies every claim against source, clusters related problems, fixes confirmed items, validates the branch, and reports closure status for every ledger item. Distinct from /swarm pr-review, which discovers new findings. The PR reference is optional: with none, the architect builds the ledger from the current PR/branch; text after the reference is forwarded as extra instructions. Supports full GitHub URL, owner/repo#N shorthand, or bare PR number (resolved against origin).";
         readonly category: "agent";
     };
     readonly 'deep-dive': {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         readonly description: "Launch deep codebase audit with parallel explorer waves, dual reviewers, and critic challenge [scope]";
         readonly args: "<scope> [--profile standard|security|ux|architecture|full] [--max-explorers 1..8] [--json] [--skip-update] [--allow-dirty]";
         readonly details: "Runs a read-only deep audit of the specified scope using parallel explorer waves (8-file cap per mission, ~3500 line guardrail), always 2 parallel reviewers for verification, and sequential critic challenge on HIGH/CRITICAL findings. Profiles select explorer lanes: standard (5 lanes), security, ux, architecture, full (all 8 lanes). Emits a structured findings report without mutating source code.";
         readonly category: "agent";
     };
     readonly 'deep dive': {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         readonly description: "Alias for /swarm deep-dive — launch deep codebase audit";
         readonly args: "<scope> [--profile standard|security|ux|architecture|full] [--max-explorers 1..8] [--json] [--skip-update] [--allow-dirty]";
         readonly category: "agent";
         readonly aliasOf: "deep-dive";
     };
     readonly 'codebase-review': {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         readonly description: "Launch codebase-review-swarm for a quote-grounded full-repo or large-subsystem audit";
         readonly args: "[scope] [--mode phase0|complete|defect|security|correctness|testing|ui|performance|ai-slop|enhancements|custom] [--tracks <list>] [--continue <run-id>] [--json] [--skip-update] [--allow-dirty]";
-        readonly details: "Runs the codebase-review-swarm workflow: Phase 0 inventory, selected-track depth planning, non-diluting review passes, coverage closure, reviewer validation, critic challenge, and .swarm/review-v8 artifacts. The command is side-effect free and emits a MODE signal; the architect workflow must not mutate source files.";
+        readonly details: "Runs the codebase-review-swarm workflow: Phase 0 inventory, selected-track depth planning, non-diluting review passes, coverage closure, reviewer validation, critic challenge, and .swarm/review-v8 artifacts. Materializes the bundled skill package if missing, then emits a MODE signal; the architect workflow must not mutate source files.";
         readonly category: "agent";
     };
     readonly 'codebase review': {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         readonly description: "Alias for /swarm codebase-review - launch codebase-review-swarm";
         readonly args: "[scope] [--mode phase0|complete|defect|security|correctness|testing|ui|performance|ai-slop|enhancements|custom] [--tracks <list>] [--continue <run-id>] [--json] [--skip-update] [--allow-dirty]";
         readonly category: "agent";
         readonly aliasOf: "codebase-review";
     };
     readonly 'design-docs': {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         readonly description: "Generate or sync language-agnostic design docs (domain, technical-spec, behavior-spec, reference/) for the project under build [description]";
         readonly args: "<description> [--out <dir>] [--lang <name>] [--update]";
         readonly details: "Triggers the architect to enter MODE: DESIGN_DOCS — delegates to the docs_design agent to author/sync docs/domain.md, docs/technical-spec.md, docs/behavior-spec.md, and docs/reference/* (plus reference/traceability.json and design-changelog.md). Normative docs are 100% language-agnostic; all framework-specific material is quarantined under reference/. --update syncs existing docs to current code/spec instead of generating fresh. Requires design_docs.enabled: true.";
         readonly category: "agent";
     };
     readonly 'design docs': {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         readonly description: "Alias for /swarm design-docs — generate or sync design docs";
         readonly args: "<description> [--out <dir>] [--lang <name>] [--update]";
         readonly category: "agent";
         readonly aliasOf: "design-docs";
     };
     readonly issue: {
-        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly handler: (ctx: CommandContext) => CommandResult;
         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).";

package/dist/config/bundled-skills.d.ts

@@ -0,0 +1,25 @@
+export declare const BUNDLED_PROJECT_SKILLS: readonly ["brainstorm", "specify", "clarify-spec", "resume", "clarify", "discover", "consult", "pre-phase-briefing", "council", "deep-dive", "codebase-review-swarm", "design-docs", "swarm-pr-review", "swarm-pr-feedback", "issue-ingest", "plan", "critic-gate", "execute", "phase-wrap"];
+interface CopyState {
+    files: number;
+    bytes: number;
+}
+interface BundledSkillFile {
+    relativePath: string;
+}
+declare function getSyncCacheKey(projectDirectory: string, packageRoot: string): string;
+declare function collectBundledSkillFilesBounded(sourceDir: string, state: CopyState, relativeDir?: string): BundledSkillFile[];
+/**
+ * Materialize missing built-in mode skills into the target project so architect
+ * MODE dispatch can load SKILL.md files in repositories that do not already
+ * vendor the latest opencode-swarm skill tree.
+ *
+ * This is intentionally missing-only and fail-open: custom project skills are
+ * never overwritten, and any filesystem error leaves command execution fail-open.
+ */
+export declare function syncBundledProjectSkillsIfMissing(projectDirectory: string, packageRoot: string, quiet?: boolean): void;
+export declare const _test_exports: {
+    collectBundledSkillFilesBounded: typeof collectBundledSkillFilesBounded;
+    getSyncCacheKey: typeof getSyncCacheKey;
+    resetBundledProjectSkillSyncCache: () => void;
+};
+export {};

package/dist/config/constants.d.ts

@@ -74,7 +74,7 @@ export declare const FULL_AUTO_BANNER = "## \u26A1 FULL-AUTO MODE ACTIVE\n\nYou
 /**
  * Canonical default Lean Turbo configuration.
  *
- * This is the single source of truth for all 9 LeanTurboConfig fields.
+ * This is the single source of truth for all LeanTurboConfig fields.
  * Consumers MUST reference this constant instead of hardcoding their own
  * defaults — see v7.4.x config-drift fix (3 of 9 fields disagreed across
  * runner.ts, lean-turbo-plan-lanes.ts, lean-turbo-status.ts, and the

package/dist/config/schema.d.ts

@@ -835,6 +835,12 @@ export declare const LeanTurboConfigSchema: z.ZodObject<{
     integrated_diff_required: z.ZodDefault<z.ZodBoolean>;
     allow_docs_only_without_reviewer: z.ZodDefault<z.ZodBoolean>;
     worktree_isolation: z.ZodDefault<z.ZodBoolean>;
+    merge_strategy: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        merge: "merge";
+        rebase: "rebase";
+        "cherry-pick": "cherry-pick";
+    }>>>;
+    worktree_dir: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type LeanTurboConfig = z.infer<typeof LeanTurboConfigSchema>;
 export declare const StandardTurboConfigSchema: z.ZodObject<{
@@ -852,6 +858,12 @@ export declare const StandardTurboConfigSchema: z.ZodObject<{
         integrated_diff_required: z.ZodDefault<z.ZodBoolean>;
         allow_docs_only_without_reviewer: z.ZodDefault<z.ZodBoolean>;
         worktree_isolation: z.ZodDefault<z.ZodBoolean>;
+        merge_strategy: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            merge: "merge";
+            rebase: "rebase";
+            "cherry-pick": "cherry-pick";
+        }>>>;
+        worktree_dir: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const LeanTurboStrategyConfigSchema: z.ZodObject<{
@@ -869,6 +881,12 @@ export declare const LeanTurboStrategyConfigSchema: z.ZodObject<{
         integrated_diff_required: z.ZodDefault<z.ZodBoolean>;
         allow_docs_only_without_reviewer: z.ZodDefault<z.ZodBoolean>;
         worktree_isolation: z.ZodDefault<z.ZodBoolean>;
+        merge_strategy: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            merge: "merge";
+            rebase: "rebase";
+            "cherry-pick": "cherry-pick";
+        }>>>;
+        worktree_dir: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const TurboConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -886,6 +904,12 @@ export declare const TurboConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         integrated_diff_required: z.ZodDefault<z.ZodBoolean>;
         allow_docs_only_without_reviewer: z.ZodDefault<z.ZodBoolean>;
         worktree_isolation: z.ZodDefault<z.ZodBoolean>;
+        merge_strategy: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            merge: "merge";
+            rebase: "rebase";
+            "cherry-pick": "cherry-pick";
+        }>>>;
+        worktree_dir: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     strategy: z.ZodLiteral<"lean">;
@@ -902,6 +926,12 @@ export declare const TurboConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         integrated_diff_required: z.ZodDefault<z.ZodBoolean>;
         allow_docs_only_without_reviewer: z.ZodDefault<z.ZodBoolean>;
         worktree_isolation: z.ZodDefault<z.ZodBoolean>;
+        merge_strategy: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            merge: "merge";
+            rebase: "rebase";
+            "cherry-pick": "cherry-pick";
+        }>>>;
+        worktree_dir: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>], "strategy">;
 export type TurboConfig = z.infer<typeof TurboConfigSchema>;
@@ -1466,6 +1496,12 @@ export declare const PluginConfigSchema: z.ZodObject<{
             integrated_diff_required: z.ZodDefault<z.ZodBoolean>;
             allow_docs_only_without_reviewer: z.ZodDefault<z.ZodBoolean>;
             worktree_isolation: z.ZodDefault<z.ZodBoolean>;
+            merge_strategy: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                merge: "merge";
+                rebase: "rebase";
+                "cherry-pick": "cherry-pick";
+            }>>>;
+            worktree_dir: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         strategy: z.ZodLiteral<"lean">;
@@ -1482,6 +1518,12 @@ export declare const PluginConfigSchema: z.ZodObject<{
             integrated_diff_required: z.ZodDefault<z.ZodBoolean>;
             allow_docs_only_without_reviewer: z.ZodDefault<z.ZodBoolean>;
             worktree_isolation: z.ZodDefault<z.ZodBoolean>;
+            merge_strategy: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                merge: "merge";
+                rebase: "rebase";
+                "cherry-pick": "cherry-pick";
+            }>>>;
+            worktree_dir: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
     }, z.core.$strip>], "strategy">>;
     turbo_mode: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;