opencode-swarm 7.115.0 → 7.116.1

package/dist/cli/{skill-generator-tav44xpm.js → skill-generator-22nk6c6a.js}

@@ -33,17 +33,17 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-x12hvfpf.js";
-import"./index-n18yy0z1.js";
-import"./index-8f2270hc.js";
-import"./index-rk6qhyng.js";
+} from "./index-wxkf3089.js";
+import"./index-t5f01hnz.js";
+import"./index-g4p13g8t.js";
+import"./index-5h7d37nf.js";
 import"./index-bfwt3abw.js";
-import"./index-g40r5d08.js";
-import"./index-jtqkh8jf.js";
+import"./index-34g1mv3c.js";
 import"./index-zgwm4ryv.js";
-import"./index-0p660a87.js";
-import"./index-4sckv7y6.js";
-import"./index-pa6t33pt.js";
+import"./index-0pfqcjp6.js";
+import"./index-42cx6g2h.js";
+import"./index-fsrp8wp3.js";
+import"./index-q2rrv0cy.js";
 import"./index-vvk2g744.js";
 import"./index-qe3v54nb.js";
 import"./index-a76rekgs.js";

package/dist/cli/{telemetry-jny76r83.js → telemetry-qh78ymq4.js}

@@ -8,7 +8,7 @@ import {
   resetTelemetryForTesting,
   rotateTelemetryIfNeeded,
   telemetry
-} from "./index-pa6t33pt.js";
+} from "./index-q2rrv0cy.js";
 import"./index-a76rekgs.js";
 export {
   telemetry,

package/dist/commands/archive.d.ts

@@ -1,5 +1,5 @@
-/**
- * Handles the /swarm archive command.
- * Archives old evidence bundles based on retention policy.
- */
+export declare const _internals: {
+    now: () => Date;
+};
+/** Handles `/swarm archive` with a truthful preview/execution report. */
 export declare function handleArchiveCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/close.d.ts

@@ -156,6 +156,17 @@ export declare function runCleanStage(ctx: CloseStageContext): Promise<CleanStag
  * the close summary. All warnings are pushed into ctx.warnings.
  */
 export declare function runAlignStage(ctx: CloseStageContext): Promise<GitAlignResult>;
+/**
+ * Builds the `/swarm finalize --dry-run` report. Purely READ-ONLY: inspects the
+ * plan and the filesystem and describes what a real finalize WOULD do, without
+ * acquiring the finalize lock, creating an archive bundle, deleting any file,
+ * running git, or tearing down session state. (#1692)
+ *
+ * The archive-first guard means the clean stage only removes files it first
+ * archived successfully; this report approximates that by listing existing
+ * clean-set members as "would remove" and notes the approximation.
+ */
+export declare function runFinalizeDryRun(directory: string, swarmDir: string, planData: PlanData, planExists: boolean): Promise<string>;
 /**
  * Handles /swarm close command - performs full terminal session finalization:
  * 0. Guarantee: mark all incomplete phases/tasks as closed
@@ -198,6 +209,7 @@ export declare const _internals: {
     runArchiveEvidenceRetention: typeof runArchiveEvidenceRetention;
     runCleanStage: typeof runCleanStage;
     runAlignStage: typeof runAlignStage;
+    runFinalizeDryRun: typeof runFinalizeDryRun;
     archiveEvidence: typeof archiveEvidence;
     closePlanTerminalState: typeof closePlanTerminalState;
     endAgentSession: typeof endAgentSession;

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

@@ -1,4 +1,5 @@
 import type { AgentDefinition } from '../agents/index.js';
+import type { EvaluationModelDispatcher } from '../evaluation/model-dispatcher.js';
 import { type CommandEntry, resolveCommand } from './registry.js';
 export type ResolvedSwarmCommand = NonNullable<ReturnType<typeof resolveCommand>>;
 export type SwarmCommandPolicyResult = {
@@ -27,5 +28,6 @@ export declare function executeSwarmCommand(args: {
     packageRoot?: string;
     buildHelpText?: () => string;
     policy?: SwarmCommandPolicy;
+    evaluationModelDispatcher?: EvaluationModelDispatcher;
 }): Promise<SwarmCommandExecutionResult>;
 export type { CommandEntry };

package/dist/commands/gate-audit.d.ts

@@ -0,0 +1,28 @@
+import type { GateName } from '../evaluation/contracts.js';
+import type { EvaluationModelDispatcher } from '../evaluation/model-dispatcher.js';
+type ParsedGateAuditArgs = {
+    runId?: string;
+    models: string[];
+    preferredSwarm?: string;
+    gates: GateName[];
+    tasks: string[];
+    repetitions: number;
+    seed: string;
+    maxConcurrency: number;
+    maxRetries: number;
+    maxTimeMs: number;
+    maxCostUsd?: number;
+    json: boolean;
+};
+declare function resolvePackageRoot(modulePath: string): string;
+declare function parseArgs(args: string[]): ParsedGateAuditArgs;
+export declare function handleGateAuditCommand(directory: string, args: string[], runtime?: {
+    packageRoot?: string;
+    dispatcher?: EvaluationModelDispatcher;
+    parentSessionId?: string;
+}): Promise<string>;
+export declare const _internals: {
+    parseArgs: typeof parseArgs;
+    resolvePackageRoot: typeof resolvePackageRoot;
+};
+export {};

package/dist/commands/gate-stats.d.ts

@@ -0,0 +1 @@
+export declare function handleGateStatsCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/index.d.ts

@@ -1,4 +1,5 @@
 import type { AgentDefinition } from '../agents/index.js';
+import type { EvaluationModelDispatcher } from '../evaluation/model-dispatcher.js';
 export { handleAcknowledgeSpecDriftCommand } from './acknowledge-spec-drift';
 export { handleAgentsCommand } from './agents';
 export { handleAnalyzeCommand } from './analyze';
@@ -28,6 +29,8 @@ export { handleDoctorCommand } from './doctor';
 export { handleEvidenceCommand, handleEvidenceSummaryCommand, } from './evidence';
 export { handleExportCommand } from './export';
 export { handleFullAutoCommand } from './full-auto';
+export { handleGateAuditCommand } from './gate-audit';
+export { handleGateStatsCommand } from './gate-stats';
 export { handleGuardrailExplain } from './guardrail-explain';
 export { handleGuardrailLog } from './guardrail-log';
 export { handleHandoffCommand } from './handoff';
@@ -67,6 +70,7 @@ export declare function createSwarmCommandHandler(directory: string, agents: Rec
     registeredAgents?: Record<string, {
         tools?: Record<string, boolean>;
     }>;
+    evaluationModelDispatcher?: EvaluationModelDispatcher;
 }): (input: {
     command: string;
     sessionID: string;

package/dist/commands/registry.d.ts

@@ -1,4 +1,5 @@
 import type { AgentDefinition } from '../agents/index.js';
+import type { EvaluationModelDispatcher } from '../evaluation/model-dispatcher.js';
 declare function levenshteinDistance(a: string, b: string): number;
 declare function findSimilarCommands(query: string): string[];
 declare function emitValidationWarnings(prefix: string, warnings: readonly string[]): void;
@@ -18,6 +19,7 @@ export type CommandContext = {
      * with existing callers.
      */
     source?: 'cli' | 'chat';
+    evaluationModelDispatcher?: EvaluationModelDispatcher;
 };
 export type CommandResult = Promise<string>;
 export type CommandCategory = 'core' | 'agent' | 'config' | 'diagnostics' | 'utility';
@@ -214,8 +216,23 @@ export declare const COMMAND_REGISTRY: {
     };
     readonly benchmark: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
-        readonly description: "Show performance metrics [--cumulative] [--ci-gate] [--max-cost-usd <n>]";
-        readonly args: "--cumulative, --ci-gate, --max-cost-usd <n>";
+        readonly description: "Show performance metrics [--cumulative] [--ci-gate] [--max-cost-usd <n>] [--gate-audit-run <id>]";
+        readonly args: "--cumulative, --ci-gate, --max-cost-usd <n>, --gate-audit-run <id>";
+        readonly category: "diagnostics";
+        readonly toolPolicy: "agent";
+    };
+    readonly 'gate-audit': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Run the bounded Tier-1 reviewer/test/SAST/mutation/quality gate matrix";
+        readonly args: "--model <id>, --swarm <id>, --gates <csv>, --tasks <csv>, --runs <n>, --max-concurrency <n>, --max-retries <n>, --max-time-ms <n>, --max-cost-usd <n>, --seed <value>, --run-id <id>, --json";
+        readonly details: "Runs immutable curated defects only in disposable copies, records unavailable data honestly, and writes versioned results below .swarm/evidence/gate-audit/. Container tasks are unsupported until a safe array-form runner exists.";
+        readonly category: "diagnostics";
+        readonly toolPolicy: "agent";
+    };
+    readonly 'gate-stats': {
+        readonly handler: (ctx: CommandContext) => Promise<string>;
+        readonly description: "Show offline per-model gate catch, false-reject, retry, cost, and reviewer fallback statistics";
+        readonly args: "--json, --min-samples <n>";
         readonly category: "diagnostics";
         readonly toolPolicy: "agent";
     };
@@ -364,16 +381,16 @@ export declare const COMMAND_REGISTRY: {
     readonly finalize: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         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 aggressive git reset --hard to the default remote branch, discarding uncommitted changes and gitignored build artifacts (user-created untracked files are preserved); falls back to a cautious reset that preserves uncommitted changes when the aggressive path cannot proceed. WARNING: alignment discards local changes and gitignored files. Resets agent sessions and delegation chains. Reads .swarm/close-lessons.md for explicit lessons and runs curation. Use --skill-review to run the quota-bounded skill_improver in proposal mode.";
-        readonly args: "--prune-branches, --skill-review";
+        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 aggressive git reset --hard to the default remote branch, discarding uncommitted changes and gitignored build artifacts (user-created untracked files are preserved); falls back to a cautious reset that preserves uncommitted changes when the aggressive path cannot proceed. WARNING: alignment discards local changes and gitignored files. Resets agent sessions and delegation chains. Reads .swarm/close-lessons.md for explicit lessons and runs curation. Use --skill-review to run the quota-bounded skill_improver in proposal mode. Use --dry-run to preview what finalize would archive, clean, and align without taking the lock or changing anything.";
+        readonly args: "--prune-branches, --skill-review, --dry-run";
         readonly category: "core";
         readonly toolPolicy: "none";
     };
     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, --skill-review";
+        readonly details: "Deprecated alias for /swarm finalize. Preserved for backward compatibility. Supports the same flags, including --dry-run.";
+        readonly args: "--prune-branches, --skill-review, --dry-run";
         readonly category: "core";
         readonly aliasOf: "finalize";
         readonly deprecated: true;
@@ -681,7 +698,7 @@ export declare const COMMAND_REGISTRY: {
     readonly reset: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Clear swarm state files [--confirm]";
-        readonly details: "DELETES plan.md, context.md, and summaries/ directory from .swarm/. Stops background automation and clears in-memory queues. SAFETY: requires --confirm flag — without it, displays a warning and tips to export first.";
+        readonly details: "DELETES plan.md, context.md, and summaries/ directory from .swarm/. Stops background automation and clears in-memory queues. SAFETY: requires --confirm flag — without it, displays a warning and tips to export first. Before deleting, auto-backs up the state it removes to .swarm/reset-backups/<timestamp>/ (newest 5 kept) so it can be restored by copying the files back.";
         readonly args: "--confirm (required)";
         readonly category: "utility";
         readonly clashesWithNativeCcCommand: "/reset";
@@ -690,7 +707,7 @@ export declare const COMMAND_REGISTRY: {
     readonly 'reset-session': {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Clear session state while preserving plan, evidence, and knowledge";
-        readonly details: "Deletes only .swarm/session/state.json and any other session files. Clears in-memory agent sessions and delegation chains. Preserves plan, evidence, and knowledge for cross-session continuity.";
+        readonly details: "Deletes only .swarm/session/state.json and any other session files. Clears in-memory agent sessions and delegation chains. Preserves plan, evidence, and knowledge for cross-session continuity. Before deleting, auto-backs up the session files it removes to .swarm/reset-backups/<timestamp>/ (newest 5 kept).";
         readonly args: "";
         readonly category: "utility";
         readonly toolPolicy: "restricted";

package/dist/commands/reset-backup.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Result of an auto-backup taken before a destructive /swarm reset or
+ * /swarm reset-session. Fail-open by contract: any per-entry failure is
+ * recorded as a warning and never thrown.
+ */
+export interface ResetBackupResult {
+    /** Absolute path of the backup directory, or null if nothing was backed up. */
+    backupDir: string | null;
+    /** Relative names actually copied into the backup. */
+    copied: string[];
+    /** Non-fatal warnings (source unreadable, prune failure, etc.). */
+    warnings: string[];
+}
+/** How many backup directories to retain under .swarm/reset-backups/. */
+export declare const RESET_BACKUP_RETENTION = 5;
+/**
+ * Copy the swarm-state entries a reset is about to delete into a durable,
+ * timestamped directory under `.swarm/reset-backups/` BEFORE deletion, so the
+ * user can recover by copying the files back. The backup directory is not part
+ * of any reset deletion set, so it survives the reset.
+ *
+ * This deliberately does NOT use the git checkpoint tool: that tool excludes
+ * `.swarm/` (`git add ... :!.swarm/`) — i.e. it excludes exactly the state a
+ * reset destroys — and would commit unrelated working-tree changes to the
+ * user's branch. A direct file copy of the deleted state is the faithful,
+ * non-surprising backup. (#1692)
+ *
+ * @param directory  project root (contains `.swarm/`)
+ * @param kind       backup label prefix ('reset' | 'reset-session')
+ * @param relEntries entries relative to `.swarm/` to back up (files or dirs)
+ */
+export declare function backupSwarmStateBeforeReset(directory: string, kind: 'reset' | 'reset-session', relEntries: string[]): ResetBackupResult;

package/dist/commands/reset-session.d.ts

@@ -1,4 +1,5 @@
 import { type OrphanCleanupResult } from '../worktree/merge';
+import { type ResetBackupResult } from './reset-backup';
 /**
  * _internals DI seam for testing reset-session without spawning real git processes.
  * Production code calls `_internals.cleanupOrphanedBranches(...)` so tests can
@@ -7,6 +8,7 @@ import { type OrphanCleanupResult } from '../worktree/merge';
  */
 export declare const _internals: {
     cleanupOrphanedBranches: (directory: string, activeSessionIds: string[]) => Promise<OrphanCleanupResult>;
+    backupSwarmStateBeforeReset: (directory: string, kind: 'reset' | 'reset-session', relEntries: string[]) => ResetBackupResult;
 };
 /**
  * Handles the /swarm reset-session command.

package/dist/commands/reset.d.ts

@@ -1,3 +1,12 @@
+import { type ResetBackupResult } from './reset-backup';
+/**
+ * _internals DI seam so tests can stub the pre-deletion backup without touching
+ * the real filesystem-copy helper. Mutations are file-scoped and restorable in
+ * afterEach.
+ */
+export declare const _internals: {
+    backupSwarmStateBeforeReset: (directory: string, kind: 'reset' | 'reset-session', relEntries: string[]) => ResetBackupResult;
+};
 /**
  * Handles the /swarm reset command.
  * Clears all swarm state files from .swarm/ and project root.

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

@@ -8,10 +8,10 @@ export declare const ExecutionProfileSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ExecutionProfile = z.infer<typeof ExecutionProfileSchema>;
 export declare const TaskStatusSchema: z.ZodEnum<{
+    blocked: "blocked";
     pending: "pending";
     in_progress: "in_progress";
     completed: "completed";
-    blocked: "blocked";
     closed: "closed";
 }>;
 export type TaskStatus = z.infer<typeof TaskStatusSchema>;
@@ -22,10 +22,10 @@ export declare const TaskSizeSchema: z.ZodEnum<{
 }>;
 export type TaskSize = z.infer<typeof TaskSizeSchema>;
 export declare const PhaseStatusSchema: z.ZodEnum<{
+    blocked: "blocked";
     pending: "pending";
     in_progress: "in_progress";
     completed: "completed";
-    blocked: "blocked";
     closed: "closed";
     complete: "complete";
 }>;
@@ -52,10 +52,10 @@ export declare const TaskSchema: z.ZodObject<{
     id: z.ZodString;
     phase: z.ZodNumber;
     status: z.ZodDefault<z.ZodEnum<{
+        blocked: "blocked";
         pending: "pending";
         in_progress: "in_progress";
         completed: "completed";
-        blocked: "blocked";
         closed: "closed";
     }>>;
     size: z.ZodDefault<z.ZodEnum<{
@@ -75,10 +75,10 @@ export declare const PhaseSchema: z.ZodObject<{
     id: z.ZodNumber;
     name: z.ZodString;
     status: z.ZodDefault<z.ZodEnum<{
+        blocked: "blocked";
         pending: "pending";
         in_progress: "in_progress";
         completed: "completed";
-        blocked: "blocked";
         closed: "closed";
         complete: "complete";
     }>>;
@@ -86,10 +86,10 @@ export declare const PhaseSchema: z.ZodObject<{
         id: z.ZodString;
         phase: z.ZodNumber;
         status: z.ZodDefault<z.ZodEnum<{
+            blocked: "blocked";
             pending: "pending";
             in_progress: "in_progress";
             completed: "completed";
-            blocked: "blocked";
             closed: "closed";
         }>>;
         size: z.ZodDefault<z.ZodEnum<{
@@ -120,10 +120,10 @@ export declare const PlanSchema: z.ZodObject<{
         id: z.ZodNumber;
         name: z.ZodString;
         status: z.ZodDefault<z.ZodEnum<{
+            blocked: "blocked";
             pending: "pending";
             in_progress: "in_progress";
             completed: "completed";
-            blocked: "blocked";
             closed: "closed";
             complete: "complete";
         }>>;
@@ -131,10 +131,10 @@ export declare const PlanSchema: z.ZodObject<{
             id: z.ZodString;
             phase: z.ZodNumber;
             status: z.ZodDefault<z.ZodEnum<{
+                blocked: "blocked";
                 pending: "pending";
                 in_progress: "in_progress";
                 completed: "completed";
-                blocked: "blocked";
                 closed: "closed";
             }>>;
             size: z.ZodDefault<z.ZodEnum<{