opencode-swarm 7.116.0 → 7.116.1

package/dist/cli/{index-81vzywh3.js → index-abjjn4yh.js}

@@ -3,7 +3,7 @@ import {
   atomicWriteFile,
   taskEvidencePath,
   withTaskEvidenceLock
-} from "./index-bbsaxnj5.js";
+} from "./index-0pfqcjp6.js";
 import {
   exports_external
 } from "./index-293f68mj.js";

package/dist/cli/{index-tvgvb5pa.js → index-efdyjgeh.js}

@@ -12,7 +12,7 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-me46ffm2.js";
+} from "./index-7kcpkm4y.js";
 import {
   checkFileAuthority,
   classifyFile,
@@ -279,7 +279,7 @@ function evaluateDestructiveDecision(rawCommand, cwd, declaredScope) {
         firingRule: "destructive_block: dd with /dev/zero|null|urandom (data wipe)"
       };
     }
-    if (/^git\s+push\b.*?(--force|-f)\b/.test(seg)) {
+    if (/^git\s+push\b.*?(--force(?!-with-lease)|-f)\b/.test(seg)) {
       return {
         decision: "block",
         firingRule: "destructive_block: git push --force"

package/dist/cli/{index-jtqkh8jf.js → index-fsrp8wp3.js}

@@ -115,5 +115,14 @@ async function readCachedParsedFile(filePath, namespace, readText, parse) {
   }
   return cloneCachedValue(value);
 }
+function invalidateCachedArtifact(filePath) {
+  const resolvedPath = path.resolve(filePath);
+  textCache.delete(resolvedPath);
+  const prefix = `${resolvedPath}\x00`;
+  for (const key of parsedCache.keys()) {
+    if (key.startsWith(prefix))
+      parsedCache.delete(key);
+  }
+}
 
-export { readCachedTextFile, readCachedParsedFile };
+export { readCachedTextFile, readCachedParsedFile, invalidateCachedArtifact };

package/dist/cli/{index-3yh67t1h.js → index-g4p13g8t.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
   resolveKnowledgeStoreDir
-} from "./index-qgeeyy75.js";
+} from "./index-34g1mv3c.js";
 import {
   init_logger,
   warn
 } from "./index-zgwm4ryv.js";
 import {
   atomicWriteFile
-} from "./index-bbsaxnj5.js";
+} from "./index-0pfqcjp6.js";
 import {
   require_proper_lockfile
 } from "./index-vvk2g744.js";
@@ -594,7 +594,7 @@ async function applyKnowledgeVerdictFeedback(directory, options) {
       deltas.push({ id, delta });
     }
     if (deltas.length > 0) {
-      const { bumpKnowledgeConfidenceBatch } = await import("./knowledge-store-q8x4h82m.js");
+      const { bumpKnowledgeConfidenceBatch } = await import("./knowledge-store-5cns5sns.js");
       await bumpKnowledgeConfidenceBatch(directory, deltas, options?.floorOptions);
     }
     return {

package/dist/cli/{index-wh8949ef.js → index-kzj3fp7c.js}

@@ -1,13 +1,13 @@
 // @bun
-import {
-  readCachedTextFile
-} from "./index-jtqkh8jf.js";
 import {
   SwarmError
 } from "./index-5e4e2hvv.js";
 import {
   warn
 } from "./index-zgwm4ryv.js";
+import {
+  readCachedTextFile
+} from "./index-fsrp8wp3.js";
 import {
   bunFile
 } from "./index-qe3v54nb.js";

package/dist/cli/{index-3b8n3dbd.js → index-p9jf8gt8.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-tvgvb5pa.js";
+} from "./index-efdyjgeh.js";
 import {
   handleGuardrailLog
 } from "./index-m43zgtjn.js";
@@ -83,7 +83,7 @@ import {
   handleWriteRetroCommand,
   normalizeSwarmCommandInput,
   resolveCommand
-} from "./index-me46ffm2.js";
+} from "./index-7kcpkm4y.js";
 import"./index-nprawcc0.js";
 import"./index-8j5d3ytd.js";
 import"./index-c8s9a3zh.js";
@@ -93,32 +93,32 @@ import {
   ORCHESTRATOR_NAME,
   stripKnownSwarmPrefix
 } from "./index-nvc0nsvg.js";
-import"./index-cnrhj56z.js";
+import"./index-xdsd2hma.js";
 import"./index-scww5b77.js";
 import"./index-4905hd2m.js";
-import"./index-a6f8b0vn.js";
-import"./index-s385axt1.js";
-import"./index-jyetmzcn.js";
-import"./index-8bvh0qfa.js";
-import"./index-3yh67t1h.js";
-import"./index-k5ey429j.js";
+import"./index-5bcrp3bc.js";
+import"./index-wxkf3089.js";
+import"./index-t5f01hnz.js";
+import"./index-wegc6xwr.js";
+import"./index-g4p13g8t.js";
+import"./index-5h7d37nf.js";
 import"./index-bfwt3abw.js";
-import"./index-qgeeyy75.js";
+import"./index-34g1mv3c.js";
 import"./index-vxv732ex.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
 import"./index-n6fa2hhk.js";
 import"./index-rdwfqhp7.js";
-import"./index-wh8949ef.js";
-import"./index-jtqkh8jf.js";
+import"./index-kzj3fp7c.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";
 import"./index-zgwm4ryv.js";
 import"./index-dqh3zhhc.js";
-import"./index-81vzywh3.js";
-import"./index-bbsaxnj5.js";
+import"./index-abjjn4yh.js";
+import"./index-0pfqcjp6.js";
 import"./index-293f68mj.js";
 import"./index-42cx6g2h.js";
+import"./index-fsrp8wp3.js";
 import"./index-q2rrv0cy.js";
 import"./index-vvk2g744.js";
 import"./index-qe3v54nb.js";

package/dist/cli/{index-jyetmzcn.js → index-t5f01hnz.js}

@@ -6,17 +6,17 @@ import {
   resolveSwarmKnowledgePath,
   resolveSwarmRejectedPath,
   transactKnowledge
-} from "./index-k5ey429j.js";
+} from "./index-5h7d37nf.js";
 import {
   resolveKnowledgeStoreDir
-} from "./index-qgeeyy75.js";
+} from "./index-34g1mv3c.js";
 import {
   init_logger,
   warn
 } from "./index-zgwm4ryv.js";
 import {
   atomicWriteFile
-} from "./index-bbsaxnj5.js";
+} from "./index-0pfqcjp6.js";
 import {
   require_proper_lockfile
 } from "./index-vvk2g744.js";

package/dist/cli/{index-8bvh0qfa.js → index-wegc6xwr.js}

@@ -4,7 +4,7 @@ import {
   countEntryViolationsInWindow,
   readKnowledgeEvents,
   recordKnowledgeEvent
-} from "./index-3yh67t1h.js";
+} from "./index-g4p13g8t.js";
 import {
   jaccardBigram,
   readKnowledge,
@@ -12,7 +12,7 @@ import {
   resolveSwarmKnowledgePath,
   transactKnowledge,
   wordBigrams
-} from "./index-k5ey429j.js";
+} from "./index-5h7d37nf.js";
 import {
   isActiveStatus
 } from "./index-bfwt3abw.js";
@@ -188,7 +188,7 @@ async function maybeQuarantineOnContradiction(directory, entryId, threshold, win
         alreadyInactive: true
       };
     }
-    const { quarantineEntry } = await import("./knowledge-validator-zr0djm02.js");
+    const { quarantineEntry } = await import("./knowledge-validator-xre0s774.js");
     await quarantineEntry(directory, entryId, `repeat_contradiction: ${count} contradicted events in ${windowDays}d`, "auto");
     return { quarantined: true, entryId, contradictionsInWindow: count };
   } catch {

package/dist/cli/{index-s385axt1.js → index-wxkf3089.js}

@@ -2,18 +2,18 @@
 import {
   ALLOWED_SKILL_PATH_PREFIXES,
   validateSkillPath
-} from "./index-jyetmzcn.js";
+} from "./index-t5f01hnz.js";
 import {
   effectiveRetrievalOutcomes,
   readKnowledgeCounterRollups
-} from "./index-3yh67t1h.js";
+} from "./index-g4p13g8t.js";
 import {
   computeOutcomeSignal,
   readKnowledge,
   resolveHiveKnowledgePath,
   resolveSwarmKnowledgePath,
   transactKnowledge
-} from "./index-k5ey429j.js";
+} from "./index-5h7d37nf.js";
 import {
   isActiveStatus
 } from "./index-bfwt3abw.js";

package/dist/cli/{index-cnrhj56z.js → index-xdsd2hma.js}

@@ -12,10 +12,7 @@ import {
 import {
   readSwarmFileAsync,
   validateSwarmPath
-} from "./index-wh8949ef.js";
-import {
-  readCachedParsedFile
-} from "./index-jtqkh8jf.js";
+} from "./index-kzj3fp7c.js";
 import {
   criticalWarn,
   error,
@@ -27,10 +24,10 @@ import {
   readTaskEvidence,
   readTaskEvidenceRaw,
   sanitizeTaskId
-} from "./index-81vzywh3.js";
+} from "./index-abjjn4yh.js";
 import {
   atomicWriteFile
-} from "./index-bbsaxnj5.js";
+} from "./index-0pfqcjp6.js";
 import {
   ZodError,
   exports_external
@@ -38,6 +35,9 @@ import {
 import {
   withEvidenceLock
 } from "./index-42cx6g2h.js";
+import {
+  readCachedParsedFile
+} from "./index-fsrp8wp3.js";
 import {
   emit
 } from "./index-q2rrv0cy.js";

package/dist/cli/index.js

@@ -7,7 +7,7 @@ import {
   getPluginLockFilePaths,
   package_default,
   resolveCommand
-} from "./index-me46ffm2.js";
+} from "./index-7kcpkm4y.js";
 import"./index-nprawcc0.js";
 import"./index-8j5d3ytd.js";
 import"./index-c8s9a3zh.js";
@@ -15,32 +15,32 @@ import"./index-m7hc7nn7.js";
 import {
   DEFAULT_AGENT_CONFIGS
 } from "./index-nvc0nsvg.js";
-import"./index-cnrhj56z.js";
+import"./index-xdsd2hma.js";
 import"./index-scww5b77.js";
 import"./index-4905hd2m.js";
-import"./index-a6f8b0vn.js";
-import"./index-s385axt1.js";
-import"./index-jyetmzcn.js";
-import"./index-8bvh0qfa.js";
-import"./index-3yh67t1h.js";
-import"./index-k5ey429j.js";
+import"./index-5bcrp3bc.js";
+import"./index-wxkf3089.js";
+import"./index-t5f01hnz.js";
+import"./index-wegc6xwr.js";
+import"./index-g4p13g8t.js";
+import"./index-5h7d37nf.js";
 import"./index-bfwt3abw.js";
-import"./index-qgeeyy75.js";
+import"./index-34g1mv3c.js";
 import"./index-vxv732ex.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
 import"./index-n6fa2hhk.js";
 import"./index-rdwfqhp7.js";
-import"./index-wh8949ef.js";
-import"./index-jtqkh8jf.js";
+import"./index-kzj3fp7c.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";
 import"./index-zgwm4ryv.js";
 import"./index-dqh3zhhc.js";
-import"./index-81vzywh3.js";
-import"./index-bbsaxnj5.js";
+import"./index-abjjn4yh.js";
+import"./index-0pfqcjp6.js";
 import"./index-293f68mj.js";
 import"./index-42cx6g2h.js";
+import"./index-fsrp8wp3.js";
 import"./index-q2rrv0cy.js";
 import"./index-vvk2g744.js";
 import"./index-qe3v54nb.js";

package/dist/cli/{knowledge-escalator-0bq62d34.js → knowledge-escalator-tthw6c9q.js}

@@ -8,15 +8,15 @@ import {
   maybeEscalateOnViolation,
   maybeQuarantineOnContradiction,
   readRecentEscalations
-} from "./index-8bvh0qfa.js";
-import"./index-3yh67t1h.js";
-import"./index-k5ey429j.js";
+} from "./index-wegc6xwr.js";
+import"./index-g4p13g8t.js";
+import"./index-5h7d37nf.js";
 import"./index-bfwt3abw.js";
-import"./index-qgeeyy75.js";
-import"./index-jtqkh8jf.js";
+import"./index-34g1mv3c.js";
 import"./index-zgwm4ryv.js";
-import"./index-bbsaxnj5.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";

package/dist/cli/{knowledge-events-cwwky393.js → knowledge-events-hrbmwxxj.js}

@@ -25,11 +25,12 @@ import {
   resolveKnowledgeCounterBaselinePath,
   resolveKnowledgeEventsPath,
   resolveLegacyApplicationLogPath
-} from "./index-3yh67t1h.js";
-import"./index-qgeeyy75.js";
+} from "./index-g4p13g8t.js";
+import"./index-34g1mv3c.js";
 import"./index-zgwm4ryv.js";
-import"./index-bbsaxnj5.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";

package/dist/cli/{knowledge-store-q8x4h82m.js → knowledge-store-5cns5sns.js}

@@ -34,13 +34,13 @@ import {
   transactFile,
   transactKnowledge,
   wordBigrams
-} from "./index-k5ey429j.js";
+} from "./index-5h7d37nf.js";
 import"./index-bfwt3abw.js";
-import"./index-qgeeyy75.js";
-import"./index-jtqkh8jf.js";
+import"./index-34g1mv3c.js";
 import"./index-zgwm4ryv.js";
-import"./index-bbsaxnj5.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";

package/dist/cli/{knowledge-validator-zr0djm02.js → knowledge-validator-xre0s774.js}

@@ -23,14 +23,14 @@ import {
   validateLesson,
   validateSkillCandidatePath,
   validateSkillPath
-} from "./index-jyetmzcn.js";
-import"./index-k5ey429j.js";
+} from "./index-t5f01hnz.js";
+import"./index-5h7d37nf.js";
 import"./index-bfwt3abw.js";
-import"./index-qgeeyy75.js";
-import"./index-jtqkh8jf.js";
+import"./index-34g1mv3c.js";
 import"./index-zgwm4ryv.js";
-import"./index-bbsaxnj5.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";

package/dist/cli/{pending-delegations-rr9x47rd.js → pending-delegations-9cn17983.js}

@@ -1,8 +1,7 @@
 // @bun
 import {
   validateSwarmPath
-} from "./index-wh8949ef.js";
-import"./index-jtqkh8jf.js";
+} from "./index-kzj3fp7c.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";
 import {
@@ -15,6 +14,7 @@ import {
 import {
   withEvidenceLock
 } from "./index-42cx6g2h.js";
+import"./index-fsrp8wp3.js";
 import"./index-q2rrv0cy.js";
 import"./index-vvk2g744.js";
 import"./index-qe3v54nb.js";

package/dist/cli/{pr-subscriptions-cny2jz2d.js → pr-subscriptions-8a6jwek2.js}

@@ -9,14 +9,14 @@ import {
   sweepStale,
   unsubscribe,
   updateSnapshot
-} from "./index-a6f8b0vn.js";
-import"./index-wh8949ef.js";
-import"./index-jtqkh8jf.js";
+} from "./index-5bcrp3bc.js";
+import"./index-kzj3fp7c.js";
 import"./index-5e4e2hvv.js";
 import"./index-p0arc26j.js";
 import"./index-zgwm4ryv.js";
 import"./index-293f68mj.js";
 import"./index-42cx6g2h.js";
+import"./index-fsrp8wp3.js";
 import"./index-q2rrv0cy.js";
 import"./index-vvk2g744.js";
 import"./index-qe3v54nb.js";

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

@@ -33,16 +33,16 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-s385axt1.js";
-import"./index-jyetmzcn.js";
-import"./index-3yh67t1h.js";
-import"./index-k5ey429j.js";
+} from "./index-wxkf3089.js";
+import"./index-t5f01hnz.js";
+import"./index-g4p13g8t.js";
+import"./index-5h7d37nf.js";
 import"./index-bfwt3abw.js";
-import"./index-qgeeyy75.js";
-import"./index-jtqkh8jf.js";
+import"./index-34g1mv3c.js";
 import"./index-zgwm4ryv.js";
-import"./index-bbsaxnj5.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";

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/registry.d.ts

@@ -381,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;
@@ -698,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";
@@ -707,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/evidence/task-file.d.ts

@@ -39,6 +39,13 @@ export declare const _internals: {
  * Atomic write: write to a unique temp file, then rename over the target.
  * The rename is atomic on POSIX and Windows, so readers never observe a torn
  * file. The temp file is cleaned up in `finally` (no-op once renamed away).
+ *
+ * Invalidates any swarm-artifact-cache entry for `targetPath` after a
+ * successful rename: the cache's stat-based staleness check can collide on a
+ * same-size rewrite that lands within one filesystem timestamp tick (issue
+ * #1729), which would otherwise let a read immediately following this write
+ * (e.g. a second locked transaction in the same logical operation) observe
+ * the pre-write content instead of what was just committed.
  */
 export declare function atomicWriteFile(targetPath: string, content: string): Promise<void>;
 /**