opencode-swarm 7.108.0 → 7.109.1

package/dist/cli/{index-1emhz3zb.js → index-nq9h2t3x.js}

@@ -54,7 +54,7 @@ import {
   savePlan,
   transientBackoff,
   validateProjectRoot
-} from "./index-48mc4d48.js";
+} from "./index-j2v3w1ds.js";
 import {
   buildOpenSpecProjectionSync,
   detectSpeckit,
@@ -63,7 +63,7 @@ import {
   resolveSpeckitProjection,
   validateSpeckit,
   writeProjectedSpecSync
-} from "./index-91j1sqzm.js";
+} from "./index-scww5b77.js";
 import {
   _internals,
   _internals1 as _internals2,
@@ -7203,11 +7203,11 @@ var _internals7 = {
     return KnowledgeConfigSchema2.parse({});
   },
   applyCuratorKnowledgeUpdates: async (directory, recommendations, knowledgeConfig) => {
-    const { applyCuratorKnowledgeUpdates } = await import("./curator-js92gc8a.js");
+    const { applyCuratorKnowledgeUpdates } = await import("./curator-q4febs18.js");
     return applyCuratorKnowledgeUpdates(directory, recommendations, knowledgeConfig);
   },
   checkHivePromotions: async (entries, knowledgeConfig) => {
-    const { checkHivePromotions } = await import("./hive-promoter-3hh8ph4a.js");
+    const { checkHivePromotions } = await import("./hive-promoter-mfd5p9f5.js");
     return checkHivePromotions(entries, knowledgeConfig);
   },
   applyProposalTriage: async (directory, triage) => {
@@ -7257,7 +7257,7 @@ var _internals7 = {
     return result;
   },
   readPriorDriftReports: async (directory) => {
-    const { readPriorDriftReports } = await import("./curator-drift-fdfgj9qf.js");
+    const { readPriorDriftReports } = await import("./curator-drift-169wgaxn.js");
     return readPriorDriftReports(directory);
   },
   readSwarmKnowledge: (directory) => readKnowledge(resolveSwarmKnowledgePath(directory))
@@ -16499,8 +16499,8 @@ var _internals21 = {
   loadCuratorDeps: async () => {
     const [{ CuratorConfigSchema }, curator, { createCuratorLLMDelegate: createCuratorLLMDelegate2 }] = await Promise.all([
       import("./schema-x17zmd03.js"),
-      import("./curator-js92gc8a.js"),
-      import("./curator-llm-factory-n70bxf40.js")
+      import("./curator-q4febs18.js"),
+      import("./curator-llm-factory-gtfhwnbr.js")
     ]);
     return { CuratorConfigSchema, curator, createCuratorLLMDelegate: createCuratorLLMDelegate2 };
   }
@@ -16996,7 +16996,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "opencode-swarm",
-  version: "7.108.0",
+  version: "7.109.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",
@@ -19254,7 +19254,7 @@ async function handleEvidenceCommand(directory, args) {
   return formatTaskEvidenceMarkdown(evidenceData);
 }
 async function handleEvidenceSummaryCommand(directory) {
-  const { buildEvidenceSummary } = await import("./evidence-summary-service-bjhr75v0.js");
+  const { buildEvidenceSummary } = await import("./evidence-summary-service-8tasw2tt.js");
   const artifact = await buildEvidenceSummary(directory);
   if (!artifact) {
     return "No plan found. Run `/swarm plan` to check plan status.";
@@ -30133,11 +30133,14 @@ async function handleRollbackCommand(directory, args) {
 // src/commands/sdd.ts
 import * as fs28 from "fs";
 import * as path59 from "path";
+var _internals43 = {
+  writeProjectedSpecSync
+};
 var SWARM_SPEC_REL = path59.join(".swarm", "spec.md");
 var USAGE9 = `Usage:
   /swarm sdd status [--json] [--source <provider>]
   /swarm sdd validate [--json] [--change <id>] [--source <provider>] [--feature <id>]
-  /swarm sdd project [--dry-run] [--json] [--change <id>] [--source <provider>] [--feature <id>]
+  /swarm sdd project [--dry-run] [--overwrite] [--json] [--change <id>] [--source <provider>] [--feature <id>]
 
 Source options (required when both openspec and speckit are detected):
   --source <swarm|openspec|speckit>  select the SDD provider explicitly
@@ -30157,13 +30160,19 @@ function isUnsafeId(value) {
   return value.includes("/") || value.includes("\\") || value.includes("..") || value.includes("[") || value.includes("]") || containsControlChars(value);
 }
 function parseArgs10(args) {
-  const parsed = { json: false, dryRun: false };
+  const parsed = {
+    json: false,
+    dryRun: false,
+    overwrite: false
+  };
   for (let i = 0;i < args.length; i++) {
     const token = args[i];
     if (token === "--json") {
       parsed.json = true;
     } else if (token === "--dry-run") {
       parsed.dryRun = true;
+    } else if (token === "--overwrite") {
+      parsed.overwrite = true;
     } else if (token === "--change") {
       if (i + 1 >= args.length || args[i + 1].startsWith("--")) {
         return { ...parsed, error: "--change requires a value" };
@@ -30472,6 +30481,20 @@ ${USAGE9}`;
 
 ${USAGE9}`;
   }
+  if (!parsed.dryRun) {
+    const nativeSpecPath = path59.join(directory, SWARM_SPEC_REL);
+    if (fs28.existsSync(nativeSpecPath)) {
+      if (!parsed.overwrite) {
+        return [
+          "Error: .swarm/spec.md already exists.",
+          "Pass --overwrite to replace it.",
+          "",
+          USAGE9
+        ].join(`
+`);
+      }
+    }
+  }
   let useSpeckit = false;
   if (parsed.source === "speckit") {
     useSpeckit = true;
@@ -30506,23 +30529,34 @@ ${USAGE9}`;
 
 ${USAGE9}`;
     }
-    const result2 = writeProjectedSpecSync(directory, {
+    const result2 = _internals43.writeProjectedSpecSync(directory, {
       source: "speckit",
       feature: resolution.feature,
-      dryRun: parsed.dryRun
-    });
-    const response2 = {
-      written: result2.written,
       dryRun: parsed.dryRun,
-      path: result2.path,
-      archivePath: result2.archivePath ?? null,
-      hash: result2.projection?.hash ?? null,
-      sourcePaths: result2.projection?.sourcePaths ?? [],
-      warnings: result2.projection?.warnings ?? []
-    };
-    if (parsed.json)
-      return JSON.stringify(response2, null, 2);
+      overwrite: parsed.overwrite
+    });
+    if (result2.error) {
+      if (parsed.json) {
+        return JSON.stringify({
+          written: false,
+          dryRun: parsed.dryRun,
+          path: result2.path,
+          error: result2.error
+        }, null, 2);
+      }
+      return `Error: ${result2.error}
+
+${USAGE9}`;
+    }
     if (!result2.projection) {
+      if (parsed.json) {
+        return JSON.stringify({
+          written: false,
+          dryRun: parsed.dryRun,
+          path: result2.path,
+          error: "no valid Spec-Kit projection could be built"
+        }, null, 2);
+      }
       return [
         "SDD projection failed: no valid Spec-Kit projection could be built.",
         "",
@@ -30530,6 +30564,17 @@ ${USAGE9}`;
       ].join(`
 `);
     }
+    const response2 = {
+      written: result2.written,
+      dryRun: parsed.dryRun,
+      path: result2.path,
+      archivePath: result2.archivePath ?? null,
+      hash: result2.projection.hash,
+      sourcePaths: result2.projection.sourcePaths,
+      warnings: result2.projection.warnings
+    };
+    if (parsed.json)
+      return JSON.stringify(response2, null, 2);
     return [
       parsed.dryRun ? "SDD projection preview" : "SDD projection written",
       `Path: ${result2.path}`,
@@ -30542,22 +30587,33 @@ ${formatList(result2.projection.warnings)}` : ""
     ].join(`
 `);
   }
-  const result = writeProjectedSpecSync(directory, {
+  const result = _internals43.writeProjectedSpecSync(directory, {
     changeId: parsed.changeId,
-    dryRun: parsed.dryRun
-  });
-  const response = {
-    written: result.written,
     dryRun: parsed.dryRun,
-    path: result.path,
-    archivePath: result.archivePath ?? null,
-    hash: result.projection?.hash ?? null,
-    sourcePaths: result.projection?.sourcePaths ?? [],
-    warnings: result.projection?.warnings ?? []
-  };
-  if (parsed.json)
-    return JSON.stringify(response, null, 2);
+    overwrite: parsed.overwrite
+  });
+  if (result.error) {
+    if (parsed.json) {
+      return JSON.stringify({
+        written: false,
+        dryRun: parsed.dryRun,
+        path: result.path,
+        error: result.error
+      }, null, 2);
+    }
+    return `Error: ${result.error}
+
+${USAGE9}`;
+  }
   if (!result.projection) {
+    if (parsed.json) {
+      return JSON.stringify({
+        written: false,
+        dryRun: parsed.dryRun,
+        path: result.path,
+        error: "no valid OpenSpec-compatible projection could be built"
+      }, null, 2);
+    }
     return [
       "SDD projection failed: no valid OpenSpec-compatible projection could be built.",
       "",
@@ -30565,6 +30621,17 @@ ${formatList(result2.projection.warnings)}` : ""
     ].join(`
 `);
   }
+  const response = {
+    written: result.written,
+    dryRun: parsed.dryRun,
+    path: result.path,
+    archivePath: result.archivePath ?? null,
+    hash: result.projection.hash,
+    sourcePaths: result.projection.sourcePaths,
+    warnings: result.projection.warnings
+  };
+  if (parsed.json)
+    return JSON.stringify(response, null, 2);
   return [
     parsed.dryRun ? "SDD projection preview" : "SDD projection written",
     `Path: ${result.path}`,
@@ -30906,7 +30973,7 @@ var DEFAULT_CONTEXT_BUDGET_CONFIG = {
 };
 
 // src/services/status-service.ts
-var _internals43 = {
+var _internals44 = {
   loadLeanTurboRunState,
   hasActiveLeanTurbo,
   hasActiveFullAuto
@@ -31011,7 +31078,7 @@ async function getStatusData(directory, agents) {
 }
 function enrichWithLeanTurbo(status, directory) {
   const turboMode = hasActiveTurboMode();
-  const leanActive = _internals43.hasActiveLeanTurbo();
+  const leanActive = _internals44.hasActiveLeanTurbo();
   let turboStrategy = "off";
   if (leanActive) {
     turboStrategy = "lean";
@@ -31030,7 +31097,7 @@ function enrichWithLeanTurbo(status, directory) {
     }
   }
   if (leanSessionID) {
-    const runState = _internals43.loadLeanTurboRunState(directory, leanSessionID);
+    const runState = _internals44.loadLeanTurboRunState(directory, leanSessionID);
     if (runState) {
       status.leanTurboPhase = runState.phase;
       status.leanMaxParallelCoders = runState.maxParallelCoders;
@@ -31062,7 +31129,7 @@ function enrichWithLeanTurbo(status, directory) {
       }
     }
   }
-  status.fullAutoActive = _internals43.hasActiveFullAuto();
+  status.fullAutoActive = _internals44.hasActiveFullAuto();
   return status;
 }
 function formatStatusMarkdown(status) {
@@ -31216,7 +31283,7 @@ No active swarm plan found. Nothing to sync.`;
 
 // src/commands/turbo.ts
 init_logger();
-var _internals44 = {
+var _internals45 = {
   loadPluginConfigWithMeta
 };
 async function handleTurboCommand(directory, args, sessionID) {
@@ -31276,7 +31343,7 @@ async function handleTurboCommand(directory, args, sessionID) {
   if (arg0 === "on") {
     let strategy = "standard";
     try {
-      const { config } = _internals44.loadPluginConfigWithMeta(directory);
+      const { config } = _internals45.loadPluginConfigWithMeta(directory);
       if (config.turbo?.strategy === "lean") {
         strategy = "lean";
       }
@@ -31373,7 +31440,7 @@ function enableLeanTurbo(session, directory, sessionID) {
   let maxParallelCoders = 4;
   let conflictPolicy = "serialize";
   try {
-    const { config } = _internals44.loadPluginConfigWithMeta(directory);
+    const { config } = _internals45.loadPluginConfigWithMeta(directory);
     const leanConfig = config.turbo?.lean;
     if (leanConfig) {
       maxParallelCoders = leanConfig.max_parallel_coders ?? 4;
@@ -31589,7 +31656,7 @@ function findSimilarCommands(query) {
   }
   const scored = VALID_COMMANDS.map((cmd) => {
     const cmdLower = cmd.toLowerCase();
-    const fullScore = _internals45.levenshteinDistance(q, cmdLower);
+    const fullScore = _internals46.levenshteinDistance(q, cmdLower);
     let tokenScore = Infinity;
     if (cmd.includes(" ") || cmd.includes("-")) {
       const qTokens = q.split(/[\s-]+/);
@@ -31602,7 +31669,7 @@ function findSimilarCommands(query) {
         for (const ct of cmdTokens) {
           if (ct.length === 0)
             continue;
-          const dist = _internals45.levenshteinDistance(qt, ct);
+          const dist = _internals46.levenshteinDistance(qt, ct);
           if (dist < minDist)
             minDist = dist;
         }
@@ -31612,7 +31679,7 @@ function findSimilarCommands(query) {
     }
     const dashStrippedQ = q.replace(/-/g, "");
     const dashStrippedCmd = cmdLower.replace(/-/g, "");
-    const dashScore = _internals45.levenshteinDistance(dashStrippedQ, dashStrippedCmd);
+    const dashScore = _internals46.levenshteinDistance(dashStrippedQ, dashStrippedCmd);
     const score = Math.min(fullScore, tokenScore, dashScore);
     return { cmd, score };
   });
@@ -31647,16 +31714,16 @@ function buildDetailedHelp(commandName, entry) {
 async function handleHelpCommand(ctx) {
   const targetCommand = ctx.args.join(" ");
   if (!targetCommand) {
-    const { buildHelpText } = await import("./index-x06d2qqm.js");
+    const { buildHelpText } = await import("./index-1capawwy.js");
     return buildHelpText();
   }
   const tokens = targetCommand.split(/\s+/);
-  const resolved = _internals45.resolveCommand(tokens);
+  const resolved = _internals46.resolveCommand(tokens);
   if (resolved) {
-    return _internals45.buildDetailedHelp(resolved.key, resolved.entry);
+    return _internals46.buildDetailedHelp(resolved.key, resolved.entry);
   }
-  const similar = _internals45.findSimilarCommands(targetCommand);
-  const { buildHelpText: fullHelp } = await import("./index-x06d2qqm.js");
+  const similar = _internals46.findSimilarCommands(targetCommand);
+  const { buildHelpText: fullHelp } = await import("./index-1capawwy.js");
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
 
@@ -31720,7 +31787,7 @@ var COMMAND_REGISTRY = {
     toolNoArgs: true
   },
   help: {
-    handler: (ctx) => _internals45.handleHelpCommand(ctx),
+    handler: (ctx) => _internals46.handleHelpCommand(ctx),
     description: "Show help for swarm commands",
     category: "core",
     args: "[command]",
@@ -31789,7 +31856,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail explain": {
     handler: async (ctx) => {
-      const { handleGuardrailExplain } = await import("./guardrail-explain-sn2a4pb7.js");
+      const { handleGuardrailExplain } = await import("./guardrail-explain-r2d8ftkv.js");
       return handleGuardrailExplain(ctx.directory, ctx.args);
     },
     description: "Dry-run: show what the guardrails would do to a command or write target (executes nothing)",
@@ -32066,9 +32133,9 @@ Subcommands:
     handler: (ctx) => handleSddProjectCommand(ctx.directory, ctx.args),
     description: "Materialize the OpenSpec-compatible effective spec into .swarm/spec.md",
     subcommandOf: "sdd",
-    args: "[--dry-run] [--json] [--change <id>]",
+    args: "[--dry-run] [--overwrite] [--json] [--change <id>]",
     category: "utility",
-    toolPolicy: "human-only"
+    toolPolicy: "agent"
   },
   "sdd-status": {
     handler: (ctx) => handleSddStatusCommand(ctx.directory, ctx.args),
@@ -32615,7 +32682,7 @@ function validateToolPolicy() {
   }
   return { valid: warnings.length === 0, warnings };
 }
-var _internals45 = {
+var _internals46 = {
   handleHelpCommand,
   validateAliases,
   validateToolPolicy,
@@ -32625,16 +32692,16 @@ var _internals45 = {
   findSimilarCommands,
   buildDetailedHelp
 };
-var validation = _internals45.validateAliases();
+var validation = _internals46.validateAliases();
 if (!validation.valid) {
   throw new Error(`COMMAND_REGISTRY alias validation failed:
 ${validation.errors.join(`
 `)}`);
 }
-_internals45.emitValidationWarnings("COMMAND_REGISTRY alias warnings", validation.warnings);
+_internals46.emitValidationWarnings("COMMAND_REGISTRY alias warnings", validation.warnings);
 try {
-  const toolPolicyValidation = _internals45.validateToolPolicy();
-  _internals45.emitValidationWarnings("COMMAND_REGISTRY toolPolicy warnings", toolPolicyValidation.warnings);
+  const toolPolicyValidation = _internals46.validateToolPolicy();
+  _internals46.emitValidationWarnings("COMMAND_REGISTRY toolPolicy warnings", toolPolicyValidation.warnings);
 } catch (e) {
   warn(`COMMAND_REGISTRY toolPolicy validation failed (non-fatal): ${e.message}`);
 }
@@ -34289,7 +34356,7 @@ function formatCommandNotFound(tokens) {
   const attemptedCommand = tokens[0] || "";
   const MAX_DISPLAY = 100;
   const displayCommand = attemptedCommand.length > MAX_DISPLAY ? `${attemptedCommand.slice(0, MAX_DISPLAY)}...` : attemptedCommand;
-  const similar = _internals45.findSimilarCommands(attemptedCommand);
+  const similar = _internals46.findSimilarCommands(attemptedCommand);
   const header = `Command \`/swarm ${displayCommand}\` not found.`;
   const suggestions = similar.length > 0 ? `Did you mean:
 ${similar.map((cmd) => `  - /swarm ${cmd}`).join(`
@@ -34555,7 +34622,7 @@ function classifySwarmCommandChatFallbackUse(resolved) {
       message: "/swarm config doctor --fix is not available through chat fallback because it can modify configuration files. Run the CLI command directly when you intend to apply fixes."
     };
   }
-  if (canonicalKey === "knowledge migrate" || canonicalKey === "knowledge quarantine" || canonicalKey === "knowledge restore" || canonicalKey === "memory import" || canonicalKey === "memory migrate" || canonicalKey === "memory compact" || canonicalKey === "sdd project") {
+  if (canonicalKey === "knowledge migrate" || canonicalKey === "knowledge quarantine" || canonicalKey === "knowledge restore" || canonicalKey === "memory import" || canonicalKey === "memory migrate" || canonicalKey === "memory compact") {
     return {
       allowed: false,
       message: `/swarm ${canonicalKey} is not available through chat fallback because it mutates .swarm state. ` + "Run the CLI command directly after confirming the intended state change."
@@ -36206,10 +36273,10 @@ function startAgentSession(sessionId, agentName, staleDurationMs = STALE_SESSION
   }
   telemetry.sessionStarted(sessionId, agentName);
   swarmState.activeAgent.set(sessionId, agentName);
-  _internals48.applyRehydrationCache(sessionState);
+  _internals49.applyRehydrationCache(sessionState);
   if (directory) {
     let rehydrationPromise;
-    rehydrationPromise = _internals48.rehydrateSessionFromDisk(directory, sessionState).then(async () => {
+    rehydrationPromise = _internals49.rehydrateSessionFromDisk(directory, sessionState).then(async () => {
       try {
         sessionState.prSubscriptions = await rehydratePrSubscriptions(sessionId, directory);
       } catch (err) {
@@ -36390,7 +36457,7 @@ function ensureAgentSession(sessionId, agentName, directory) {
     maybeSweepStaleSessions();
     return session;
   }
-  _internals48.startAgentSession(sessionId, agentName ?? "unknown", 7200000, directory);
+  _internals49.startAgentSession(sessionId, agentName ?? "unknown", 7200000, directory);
   session = swarmState.agentSessions.get(sessionId);
   if (!session) {
     throw new Error(`Failed to create guardrail session for ${sessionId}`);
@@ -36678,8 +36745,8 @@ function applyRehydrationCache(session) {
   }
 }
 async function rehydrateSessionFromDisk(directory, session) {
-  await _internals48.buildRehydrationCache(directory);
-  _internals48.applyRehydrationCache(session);
+  await _internals49.buildRehydrationCache(directory);
+  _internals49.applyRehydrationCache(session);
 }
 function hasActiveTurboMode(sessionID) {
   if (sessionID) {
@@ -36753,7 +36820,7 @@ async function rehydratePrSubscriptions(sessionID, directory) {
   }
   return map;
 }
-var _internals48 = {
+var _internals49 = {
   swarmState,
   resetSwarmState,
   ensureAgentSession,
@@ -36892,4 +36959,4 @@ function createCuratorLLMDelegate(directory, mode = "init", sessionId) {
   };
 }
 
-export { package_default, handleAcknowledgeSpecDriftCommand, handleAgentsCommand, handleAnalyzeCommand, handleArchiveCommand, DC_SAFE_TARGETS, dcNormalizeCommand, dcUnwrapWrappers, dcSplitSegments, dcValidateTargets, dcCheckJunctionCreation, dcExtractWindowsCmdTargets, dcExtractPowerShellTargets, normalizeSwarmCommandInput, canonicalCommandKey, formatCommandNotFound, executeSwarmCommand, SWARM_COMMAND_TOOL_COMMANDS, SWARM_COMMAND_TOOL_ALLOWLIST, HUMAN_ONLY_SWARM_COMMANDS, classifySwarmCommandToolUse, classifySwarmCommandChatFallbackUse, detectPosixWrites, detectWindowsWrites, resolveWriteTargets, handleAutoProceedCommand, handleBenchmarkCommand, handleBrainstormCommand, handleCheckpointCommand, handleClarifyCommand, createCuratorLLMDelegate, _internals10 as _internals, parseKnowledgeRecommendations, parseKnowledgeRecommendationsWithDiagnostics, parseStructuredCuratorBlocks, readCuratorSummary, writeCuratorSummary, filterPhaseEvents, checkPhaseCompliance, runCuratorInit, runCuratorPhase, applyCuratorKnowledgeUpdates, isHiveEligible, checkHivePromotions, createHivePromoterHook, promoteToHive, promoteFromSwarm, handleCloseCommand, handleCodebaseReviewCommand, handleConcurrencyCommand, handleConfigCommand, handleConsolidateCommand, handleCostsCommand, handleCouncilCommand, handleCurateCommand, handleDarkMatterCommand, handleDeepDiveCommand, handleDeepResearchCommand, getPluginConfigDir, getPluginCachePaths, getPluginLockFilePaths, handleDiagnoseCommand, handleDoctorCommand, handleEvidenceCommand, handleEvidenceSummaryCommand, handleExportCommand, handleFullAutoCommand, handleHandoffCommand, handleHistoryCommand, handleKnowledgeQuarantineCommand, handleKnowledgeRestoreCommand, handleKnowledgeMigrateCommand, handleKnowledgeListCommand, handleKnowledgeUnactionableCommand, handleKnowledgeRetryHardeningCommand, handleLearningCommand, handleLinkCommand, handleMemoryCommand, handleMemoryStatusCommand, handleMemoryValueLogCommand, handleMemoryMigrateCommand, handleMemoryImportCommand, handleMemoryExportCommand, handlePlanCommand, handlePreflightCommand, handlePromoteCommand, handleQaGatesCommand, handleResetCommand, handleResetSessionCommand, handleRetrieveCommand, handleRollbackCommand, handleSddStatusCommand, handleSddValidateCommand, handleSddProjectCommand, handleSddCommand, handleSimulateCommand, handleSpecifyCommand, handleStatusCommand, handleSyncPlanCommand, handleTurboCommand, handleUnlinkCommand, handleWriteRetroCommand, handleHelpCommand, COMMAND_REGISTRY, VALID_COMMANDS, _internals45 as _internals1, resolveCommand };
+export { package_default, handleAcknowledgeSpecDriftCommand, handleAgentsCommand, handleAnalyzeCommand, handleArchiveCommand, DC_SAFE_TARGETS, dcNormalizeCommand, dcUnwrapWrappers, dcSplitSegments, dcValidateTargets, dcCheckJunctionCreation, dcExtractWindowsCmdTargets, dcExtractPowerShellTargets, normalizeSwarmCommandInput, canonicalCommandKey, formatCommandNotFound, executeSwarmCommand, SWARM_COMMAND_TOOL_COMMANDS, SWARM_COMMAND_TOOL_ALLOWLIST, HUMAN_ONLY_SWARM_COMMANDS, classifySwarmCommandToolUse, classifySwarmCommandChatFallbackUse, detectPosixWrites, detectWindowsWrites, resolveWriteTargets, handleAutoProceedCommand, handleBenchmarkCommand, handleBrainstormCommand, handleCheckpointCommand, handleClarifyCommand, createCuratorLLMDelegate, _internals10 as _internals, parseKnowledgeRecommendations, parseKnowledgeRecommendationsWithDiagnostics, parseStructuredCuratorBlocks, readCuratorSummary, writeCuratorSummary, filterPhaseEvents, checkPhaseCompliance, runCuratorInit, runCuratorPhase, applyCuratorKnowledgeUpdates, isHiveEligible, checkHivePromotions, createHivePromoterHook, promoteToHive, promoteFromSwarm, handleCloseCommand, handleCodebaseReviewCommand, handleConcurrencyCommand, handleConfigCommand, handleConsolidateCommand, handleCostsCommand, handleCouncilCommand, handleCurateCommand, handleDarkMatterCommand, handleDeepDiveCommand, handleDeepResearchCommand, getPluginConfigDir, getPluginCachePaths, getPluginLockFilePaths, handleDiagnoseCommand, handleDoctorCommand, handleEvidenceCommand, handleEvidenceSummaryCommand, handleExportCommand, handleFullAutoCommand, handleHandoffCommand, handleHistoryCommand, handleKnowledgeQuarantineCommand, handleKnowledgeRestoreCommand, handleKnowledgeMigrateCommand, handleKnowledgeListCommand, handleKnowledgeUnactionableCommand, handleKnowledgeRetryHardeningCommand, handleLearningCommand, handleLinkCommand, handleMemoryCommand, handleMemoryStatusCommand, handleMemoryValueLogCommand, handleMemoryMigrateCommand, handleMemoryImportCommand, handleMemoryExportCommand, handlePlanCommand, handlePreflightCommand, handlePromoteCommand, handleQaGatesCommand, handleResetCommand, handleResetSessionCommand, handleRetrieveCommand, handleRollbackCommand, handleSddStatusCommand, handleSddValidateCommand, handleSddProjectCommand, handleSddCommand, handleSimulateCommand, handleSpecifyCommand, handleStatusCommand, handleSyncPlanCommand, handleTurboCommand, handleUnlinkCommand, handleWriteRetroCommand, handleHelpCommand, COMMAND_REGISTRY, VALID_COMMANDS, _internals46 as _internals1, resolveCommand };

package/dist/cli/{index-91j1sqzm.js → index-scww5b77.js}

@@ -291,6 +291,32 @@ function renderRequirement(req, used, warnings, reserved) {
   }
   return `- ${text} _(source: ${req.sourceRel})_`;
 }
+function sanitizeFeatureLabel(label) {
+  let out = "";
+  for (const ch of label) {
+    const code = ch.codePointAt(0) ?? 0;
+    out += ch === "[" || ch === "]" || ch === "`" || code < 32 || code === 127 ? "-" : ch;
+  }
+  return out;
+}
+function renderSuccessCriteriaScaffold(featureLabel, usedIds) {
+  let scId;
+  for (let n = 1;n <= 999; n++) {
+    const candidate = `SC-${String(n).padStart(3, "0")}`;
+    if (!usedIds.has(candidate)) {
+      scId = candidate;
+      usedIds.add(candidate);
+      break;
+    }
+  }
+  const resolvedId = scId ?? "SC-PLACEHOLDER";
+  const safeLabel = sanitizeFeatureLabel(featureLabel);
+  return [
+    "",
+    "## Success Criteria",
+    `### ${resolvedId}: [NEEDS CLARIFICATION \u2014 define success criterion for ${safeLabel}]`
+  ];
+}
 function detectSpeckit(directory) {
   const root = path.resolve(directory);
   const markerPath = path.join(root, SPECKIT_MARKER);
@@ -437,6 +463,7 @@ function resolveSpeckitProjection(directory, options = {}) {
   for (const req of requirements) {
     lines.push(renderRequirement(req, usedIds, warnings, reservedIds));
   }
+  lines.push(...renderSuccessCriteriaScaffold(selectedFeature.featureId, usedIds));
   const projected = `${lines.join(`
 `)}
 `;
@@ -578,6 +605,10 @@ function buildOpenSpecProjectionSync(directory, options = {}) {
     for (const req of reqs) {
       lines.push(renderRequirement(req, usedIds, warnings));
     }
+    lines.push(...renderSuccessCriteriaScaffold(changeId, usedIds));
+  }
+  if (currentRequirements.length > 0) {
+    lines.push(...renderSuccessCriteriaScaffold("current-requirements", usedIds));
   }
   const content = `${lines.join(`
 `)}
@@ -658,6 +689,22 @@ function writeProjectedSpecSync(directory, options = {}) {
     return { written: false, projection, path: target };
   }
   fs.mkdirSync(path.dirname(target), { recursive: true });
+  if (!options.overwrite) {
+    try {
+      fs.writeFileSync(target, projection.content, { flag: "wx" });
+    } catch (err) {
+      if (err.code === "EEXIST") {
+        return {
+          written: false,
+          projection,
+          path: target,
+          error: ".swarm/spec.md already exists; pass --overwrite to replace it"
+        };
+      }
+      throw err;
+    }
+    return { written: true, projection, path: target };
+  }
   let archivePath;
   if (fs.existsSync(target)) {
     const prior = fs.readFileSync(target, "utf-8");

package/dist/cli/{index-7jyndvsy.js → index-wsg3vkss.js}

@@ -12,7 +12,7 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-1emhz3zb.js";
+} from "./index-nq9h2t3x.js";
 import {
   checkFileAuthority,
   classifyFile,

package/dist/cli/index.js

@@ -7,13 +7,13 @@ import {
   getPluginLockFilePaths,
   package_default,
   resolveCommand
-} from "./index-1emhz3zb.js";
+} from "./index-nq9h2t3x.js";
 import"./index-wj4jeavn.js";
 import"./index-5gnp8fyw.js";
 import"./index-c8s9a3zh.js";
 import"./index-fm7xz1ne.js";
-import"./index-48mc4d48.js";
-import"./index-91j1sqzm.js";
+import"./index-j2v3w1ds.js";
+import"./index-scww5b77.js";
 import"./index-yw8qpf51.js";
 import"./index-85bacexr.js";
 import"./index-09xpycan.js";
@@ -29,7 +29,7 @@ import"./index-bfwt3abw.js";
 import"./index-wvrj16f0.js";
 import"./index-q1exe2b3.js";
 import"./index-x2q0gnt8.js";
-import"./index-f1qyj61w.js";
+import"./index-3yk9196e.js";
 import"./index-r3j3458j.js";
 import"./index-jtqkh8jf.js";
 import"./index-5e4e2hvv.js";

package/dist/commands/registry.d.ts

@@ -422,9 +422,9 @@ export declare const COMMAND_REGISTRY: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Materialize the OpenSpec-compatible effective spec into .swarm/spec.md";
         readonly subcommandOf: "sdd";
-        readonly args: "[--dry-run] [--json] [--change <id>]";
+        readonly args: "[--dry-run] [--overwrite] [--json] [--change <id>]";
         readonly category: "utility";
-        readonly toolPolicy: "human-only";
+        readonly toolPolicy: "agent";
     };
     readonly 'sdd-status': {
         readonly handler: (ctx: CommandContext) => Promise<string>;

package/dist/commands/sdd.d.ts

@@ -1,6 +1,16 @@
+import { writeProjectedSpecSync } from '../sdd/effective-spec';
+/**
+ * DI seam for testing TOCTOU error propagation without filesystem races.
+ * Tests override `_internals.writeProjectedSpecSync` to inject an error result,
+ * then restore the original in `afterEach`.
+ */
+export declare const _internals: {
+    writeProjectedSpecSync: typeof writeProjectedSpecSync;
+};
 interface ParsedSddArgs {
     json: boolean;
     dryRun: boolean;
+    overwrite: boolean;
     changeId?: string;
     source?: 'swarm' | 'openspec' | 'speckit';
     feature?: string;

package/dist/config/index.d.ts

@@ -22,3 +22,4 @@ export type { AgentOverrideConfig, AutomationCapabilities, AutomationConfig, Aut
 export { AgentOverrideConfigSchema, AutomationCapabilitiesSchema, AutomationConfigSchema, AutomationModeSchema, LeanTurboConfigSchema, MemoryConfigSchema, ModelPricingConfigSchema, PhaseCompleteConfigSchema, PipelineConfigSchema, PluginConfigSchema, PricingConfigSchema, RepoGraphConfigSchema, SkillPropagationConfigSchema, SwarmConfigSchema, TurboConfigSchema, WorktreeIsolationConfigSchema, } from './schema';
 export type { DeltaSpec, Obligation, SpecDelta, SpecRequirement, SpecScenario, SpecSection, SwarmSpec, } from './spec-schema';
 export { DeltaSpecSchema, ObligationSchema, SpecDeltaSchema, SpecRequirementSchema, SpecScenarioSchema, SpecSectionSchema, SwarmSpecSchema, validateSpecContent, } from './spec-schema';
+export { resolveWorktreeIsolationConfig } from './worktree-isolation-config';

package/dist/config/worktree-isolation-config.d.ts

@@ -0,0 +1,10 @@
+import type { PluginConfig, WorktreeIsolationConfig } from './schema';
+/**
+ * Pure config helper that resolves the worktree-isolation configuration
+ * from a PluginConfig. Lives in this leaf module (no heavy imports) so
+ * the plugin entry (src/index.ts) can call it during init without
+ * pulling in the worktree lifecycle module.
+ *
+ * @see tests/unit/turbo/lean/init-safety.test.ts (static source check)
+ */
+export declare function resolveWorktreeIsolationConfig(config: PluginConfig): WorktreeIsolationConfig;