opencode-swarm 7.167.1 → 7.167.2

package/dist/cli/{scan-cursor-6zcs0frg.js → scan-cursor-ymfvzdkz.js}

@@ -4,19 +4,19 @@ import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   getScanStatus
-} from "./index-79wnzc8q.js";
-import"./index-9bhzbwa4.js";
+} from "./index-pdcperq5.js";
+import"./index-18rfc7qv.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-t8tw1bhs.js";
-import"./index-2w0beg3s.js";
-import"./index-m21x1bkx.js";
-import"./index-f6zgz02s.js";
-import"./index-7qefgq4j.js";
-import"./index-ee6ydtfe.js";
+import"./index-0q839sg6.js";
+import"./index-vgpedapd.js";
 import"./index-7g4c7s5r.js";
-import"./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
+import"./index-x7pm61wk.js";
+import"./index-tcj8v6my.js";
+import"./index-1xnse449.js";
+import"./index-ee6ydtfe.js";
+import"./index-0mhftbpp.js";
+import"./index-a1w58b47.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{schema-warvhy9h.js → schema-chc4aez6.js}

@@ -106,8 +106,8 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-87agfprq.js";
-import"./index-0tc0pcmh.js";
+} from "./index-2b1hd1fx.js";
+import"./index-g5m43paw.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{scope-persistence-c2ck77cv.js → scope-persistence-3xnr59y8.js}

@@ -23,30 +23,30 @@ import {
   tombstoneScopeBinding,
   writeScopeBindingToDisk,
   writeScopeToDisk
-} from "./index-mgc3c483.js";
-import"./index-fenasyvr.js";
-import"./index-qd619x3r.js";
-import"./index-75f9jj3h.js";
-import"./index-6d4dc99f.js";
-import"./index-rk10x4zr.js";
-import"./index-ry16d01s.js";
+} from "./index-jhd3pmd1.js";
+import"./index-z7z3g5wt.js";
+import"./index-z6we1abx.js";
+import"./index-g409c7ke.js";
+import"./index-962qme08.js";
+import"./index-hhkm64wh.js";
 import"./index-n4fzmqz8.js";
-import"./index-qd726agw.js";
-import"./index-9bhzbwa4.js";
+import"./index-ry16d01s.js";
+import"./index-gs12223x.js";
+import"./index-18rfc7qv.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-t8tw1bhs.js";
-import"./index-2w0beg3s.js";
-import"./index-m21x1bkx.js";
-import"./index-f6zgz02s.js";
-import"./index-7qefgq4j.js";
-import"./index-ee6ydtfe.js";
+import"./index-0q839sg6.js";
+import"./index-vgpedapd.js";
 import"./index-7g4c7s5r.js";
-import"./index-emwezg3y.js";
-import"./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
-import"./index-87agfprq.js";
-import"./index-0tc0pcmh.js";
+import"./index-x7pm61wk.js";
+import"./index-tcj8v6my.js";
+import"./index-1xnse449.js";
+import"./index-ee6ydtfe.js";
+import"./index-wjet7x0a.js";
+import"./index-0mhftbpp.js";
+import"./index-a1w58b47.js";
+import"./index-2b1hd1fx.js";
+import"./index-g5m43paw.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{skill-generator-jamm1cna.js → skill-generator-3mvaghxk.js}

@@ -33,33 +33,33 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-bzdc4b7t.js";
+} from "./index-f91fhch0.js";
 import"./index-q7sjgr1y.js";
-import"./index-z5gdgdkp.js";
-import"./index-sahf5yz3.js";
+import"./index-m3z83nhs.js";
+import"./index-8vbahc4c.js";
 import"./index-p612v1mv.js";
-import"./index-f8xk5q5j.js";
-import"./index-qww0h314.js";
+import"./index-shrf0wt3.js";
+import"./index-syedr4e3.js";
 import"./index-rtry5xyf.js";
-import"./index-hdsg7yf6.js";
+import"./index-s7a9dqtb.js";
 import"./index-3qf1vxtb.js";
 import"./index-n832052r.js";
-import"./index-qd726agw.js";
-import"./index-9bhzbwa4.js";
+import"./index-gs12223x.js";
+import"./index-18rfc7qv.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-t8tw1bhs.js";
-import"./index-2w0beg3s.js";
-import"./index-m21x1bkx.js";
-import"./index-f6zgz02s.js";
-import"./index-7qefgq4j.js";
-import"./index-ee6ydtfe.js";
+import"./index-0q839sg6.js";
+import"./index-vgpedapd.js";
 import"./index-7g4c7s5r.js";
-import"./index-emwezg3y.js";
-import"./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
-import"./index-87agfprq.js";
-import"./index-0tc0pcmh.js";
+import"./index-x7pm61wk.js";
+import"./index-tcj8v6my.js";
+import"./index-1xnse449.js";
+import"./index-ee6ydtfe.js";
+import"./index-wjet7x0a.js";
+import"./index-0mhftbpp.js";
+import"./index-a1w58b47.js";
+import"./index-2b1hd1fx.js";
+import"./index-g5m43paw.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{snapshot-coordination-init-st0xsn3f.js → snapshot-coordination-init-arnc77r9.js}

@@ -8,64 +8,64 @@ import {
   markSnapshotCoordinationClosing,
   retrySnapshotCoordinationInitialization,
   startSnapshotCoordinationInitialization
-} from "./index-32bxwzw0.js";
+} from "./index-y1sj2e1n.js";
 import"./index-d5qf7hvh.js";
-import"./index-m3tx1q9v.js";
-import"./index-q265ytw6.js";
-import"./index-bf6zx8cq.js";
-import"./index-qyr17fbz.js";
-import"./index-5bd84nxc.js";
+import"./index-k73ehxa1.js";
+import"./index-dme7wvwg.js";
+import"./index-f8cc92g7.js";
+import"./index-rrne6g2m.js";
+import"./index-arqv4psy.js";
+import"./index-83r0v5tn.js";
 import"./index-txdagbh7.js";
+import"./index-9br68j86.js";
 import"./index-cw912re7.js";
-import"./index-bzdc4b7t.js";
-import"./index-qtd3hrk8.js";
-import"./index-79wnzc8q.js";
-import"./index-70ha9e09.js";
-import"./index-1aex5zd9.js";
-import"./index-9ss2m4rs.js";
-import"./index-3nm1b3t2.js";
+import"./index-f91fhch0.js";
+import"./index-ce8p9t28.js";
+import"./index-pdcperq5.js";
+import"./index-fyfbpz4f.js";
+import"./index-mtepgqan.js";
 import"./index-zsrtt42s.js";
-import"./index-eretcr6t.js";
-import"./index-251vrmge.js";
-import"./index-9wv6a3jx.js";
+import"./index-5sjq3shs.js";
+import"./index-m7cwnt9r.js";
+import"./index-gmjg65tm.js";
 import"./index-b43rt5ph.js";
 import"./index-q7sjgr1y.js";
-import"./index-bv8ha57q.js";
-import"./index-fmzz6aw7.js";
-import"./index-zwsbegc1.js";
-import"./index-z5gdgdkp.js";
-import"./index-sahf5yz3.js";
+import"./index-3r6k6qa7.js";
+import"./index-09gv90d7.js";
+import"./index-sjkg2hc4.js";
+import"./index-m3z83nhs.js";
+import"./index-8vbahc4c.js";
 import"./index-p612v1mv.js";
-import"./index-f8xk5q5j.js";
-import"./index-qww0h314.js";
+import"./index-shrf0wt3.js";
+import"./index-syedr4e3.js";
 import"./index-rtry5xyf.js";
-import"./index-hdsg7yf6.js";
+import"./index-s7a9dqtb.js";
 import"./index-3qf1vxtb.js";
 import"./index-n832052r.js";
-import"./index-mgc3c483.js";
-import"./index-fenasyvr.js";
-import"./index-qd619x3r.js";
-import"./index-75f9jj3h.js";
-import"./index-6d4dc99f.js";
-import"./index-rk10x4zr.js";
-import"./index-ry16d01s.js";
+import"./index-jhd3pmd1.js";
+import"./index-z7z3g5wt.js";
+import"./index-z6we1abx.js";
+import"./index-g409c7ke.js";
+import"./index-962qme08.js";
+import"./index-hhkm64wh.js";
 import"./index-n4fzmqz8.js";
-import"./index-qd726agw.js";
-import"./index-9bhzbwa4.js";
+import"./index-ry16d01s.js";
+import"./index-gs12223x.js";
+import"./index-18rfc7qv.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-t8tw1bhs.js";
-import"./index-2w0beg3s.js";
-import"./index-m21x1bkx.js";
-import"./index-f6zgz02s.js";
-import"./index-7qefgq4j.js";
-import"./index-ee6ydtfe.js";
+import"./index-0q839sg6.js";
+import"./index-vgpedapd.js";
 import"./index-7g4c7s5r.js";
-import"./index-emwezg3y.js";
-import"./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
-import"./index-87agfprq.js";
-import"./index-0tc0pcmh.js";
+import"./index-x7pm61wk.js";
+import"./index-tcj8v6my.js";
+import"./index-1xnse449.js";
+import"./index-ee6ydtfe.js";
+import"./index-wjet7x0a.js";
+import"./index-0mhftbpp.js";
+import"./index-a1w58b47.js";
+import"./index-2b1hd1fx.js";
+import"./index-g5m43paw.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{telemetry-ce0tx41h.js → telemetry-g9pppt9e.js}

@@ -14,8 +14,8 @@ import {
   startHeartbeatTracking,
   stopHeartbeatTracking,
   telemetry
-} from "./index-f6zgz02s.js";
-import"./index-7qefgq4j.js";
+} from "./index-tcj8v6my.js";
+import"./index-1xnse449.js";
 import"./index-ee6ydtfe.js";
 import"./index-bpmtbmy9.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{workspace-snapshot-0kxj2grt.js → workspace-snapshot-hvsjtepd.js}

@@ -45,14 +45,14 @@ import {
   shouldSkipSnapshot,
   switchPrFeedbackTrackingCandidateAsync,
   workspaceSnapshotMatches
-} from "./index-251vrmge.js";
-import"./index-sahf5yz3.js";
+} from "./index-m7cwnt9r.js";
+import"./index-8vbahc4c.js";
 import"./index-p612v1mv.js";
-import"./index-m21x1bkx.js";
-import"./index-7qefgq4j.js";
+import"./index-x7pm61wk.js";
+import"./index-1xnse449.js";
 import"./index-ee6ydtfe.js";
-import"./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
+import"./index-0mhftbpp.js";
+import"./index-a1w58b47.js";
 import"./index-zpsr8rpc.js";
 import"./index-zgwm4ryv.js";
 import"./index-a76rekgs.js";

package/dist/cli/{worktree-collision-ownership-qra7r8pw.js → worktree-collision-ownership-vj8anvb7.js}

@@ -6,38 +6,38 @@ import {
   WORKTREE_PROVISIONING_OWNER_LEASE_MS,
   removeWorktreeProvisioningOwner,
   scanWorktreeProvisioningOwnersForRecovery
-} from "./index-9wv6a3jx.js";
+} from "./index-gmjg65tm.js";
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-zwsbegc1.js";
-import"./index-sahf5yz3.js";
+} from "./index-sjkg2hc4.js";
+import"./index-8vbahc4c.js";
 import {
   bunSpawn
 } from "./index-p612v1mv.js";
-import"./index-75f9jj3h.js";
-import"./index-6d4dc99f.js";
-import"./index-rk10x4zr.js";
-import"./index-ry16d01s.js";
+import"./index-g409c7ke.js";
+import"./index-962qme08.js";
+import"./index-hhkm64wh.js";
 import"./index-n4fzmqz8.js";
-import"./index-qd726agw.js";
-import"./index-9bhzbwa4.js";
+import"./index-ry16d01s.js";
+import"./index-gs12223x.js";
+import"./index-18rfc7qv.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-t8tw1bhs.js";
-import"./index-2w0beg3s.js";
-import"./index-m21x1bkx.js";
-import"./index-f6zgz02s.js";
+import"./index-0q839sg6.js";
+import"./index-vgpedapd.js";
+import"./index-7g4c7s5r.js";
+import"./index-x7pm61wk.js";
+import"./index-tcj8v6my.js";
 import {
   canonicalRootKeyFresh
-} from "./index-7qefgq4j.js";
+} from "./index-1xnse449.js";
 import"./index-ee6ydtfe.js";
-import"./index-7g4c7s5r.js";
 import {
   init_git_executable,
   resolveGitExecutable
-} from "./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
+} from "./index-0mhftbpp.js";
+import"./index-a1w58b47.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{worktree-isolation-yr9gnf64.js → worktree-isolation-mt7z75hz.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   MAX_TRACKED_STANDARD_WORKTREE_CALLS,
-  _internals,
+  _internals1 as _internals,
   abortStandardWorktreeDispatch,
   awaitingMergeByCallID,
   checkStandardWorktreeSerializationRelease,
@@ -21,66 +21,66 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-32bxwzw0.js";
+} from "./index-y1sj2e1n.js";
 import"./index-d5qf7hvh.js";
-import"./index-m3tx1q9v.js";
-import"./index-q265ytw6.js";
-import"./index-bf6zx8cq.js";
-import"./index-qyr17fbz.js";
-import"./index-5bd84nxc.js";
+import"./index-k73ehxa1.js";
+import"./index-dme7wvwg.js";
+import"./index-f8cc92g7.js";
+import"./index-rrne6g2m.js";
+import"./index-arqv4psy.js";
+import"./index-83r0v5tn.js";
 import"./index-txdagbh7.js";
+import"./index-9br68j86.js";
 import"./index-cw912re7.js";
-import"./index-bzdc4b7t.js";
-import"./index-qtd3hrk8.js";
-import"./index-79wnzc8q.js";
-import"./index-70ha9e09.js";
-import"./index-1aex5zd9.js";
-import"./index-9ss2m4rs.js";
-import"./index-3nm1b3t2.js";
+import"./index-f91fhch0.js";
+import"./index-ce8p9t28.js";
+import"./index-pdcperq5.js";
+import"./index-fyfbpz4f.js";
+import"./index-mtepgqan.js";
 import"./index-zsrtt42s.js";
-import"./index-eretcr6t.js";
-import"./index-251vrmge.js";
-import"./index-9wv6a3jx.js";
+import"./index-5sjq3shs.js";
+import"./index-m7cwnt9r.js";
+import"./index-gmjg65tm.js";
 import"./index-b43rt5ph.js";
 import"./index-q7sjgr1y.js";
-import"./index-bv8ha57q.js";
-import"./index-fmzz6aw7.js";
-import"./index-zwsbegc1.js";
-import"./index-z5gdgdkp.js";
-import"./index-sahf5yz3.js";
+import"./index-3r6k6qa7.js";
+import"./index-09gv90d7.js";
+import"./index-sjkg2hc4.js";
+import"./index-m3z83nhs.js";
+import"./index-8vbahc4c.js";
 import"./index-p612v1mv.js";
-import"./index-f8xk5q5j.js";
-import"./index-qww0h314.js";
+import"./index-shrf0wt3.js";
+import"./index-syedr4e3.js";
 import"./index-rtry5xyf.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-hdsg7yf6.js";
+} from "./index-s7a9dqtb.js";
 import"./index-3qf1vxtb.js";
 import"./index-n832052r.js";
-import"./index-mgc3c483.js";
-import"./index-fenasyvr.js";
-import"./index-qd619x3r.js";
-import"./index-75f9jj3h.js";
-import"./index-6d4dc99f.js";
-import"./index-rk10x4zr.js";
-import"./index-ry16d01s.js";
+import"./index-jhd3pmd1.js";
+import"./index-z7z3g5wt.js";
+import"./index-z6we1abx.js";
+import"./index-g409c7ke.js";
+import"./index-962qme08.js";
+import"./index-hhkm64wh.js";
 import"./index-n4fzmqz8.js";
-import"./index-qd726agw.js";
-import"./index-9bhzbwa4.js";
+import"./index-ry16d01s.js";
+import"./index-gs12223x.js";
+import"./index-18rfc7qv.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-t8tw1bhs.js";
-import"./index-2w0beg3s.js";
-import"./index-m21x1bkx.js";
-import"./index-f6zgz02s.js";
-import"./index-7qefgq4j.js";
-import"./index-ee6ydtfe.js";
+import"./index-0q839sg6.js";
+import"./index-vgpedapd.js";
 import"./index-7g4c7s5r.js";
-import"./index-emwezg3y.js";
-import"./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
-import"./index-87agfprq.js";
-import"./index-0tc0pcmh.js";
+import"./index-x7pm61wk.js";
+import"./index-tcj8v6my.js";
+import"./index-1xnse449.js";
+import"./index-ee6ydtfe.js";
+import"./index-wjet7x0a.js";
+import"./index-0mhftbpp.js";
+import"./index-a1w58b47.js";
+import"./index-2b1hd1fx.js";
+import"./index-g5m43paw.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zpsr8rpc.js";

package/dist/commands/close/align-stage.d.ts

@@ -0,0 +1,10 @@
+import type { CloseStageContext, GitAlignResult } from './context.js';
+/**
+ * STAGE 4: ALIGN
+ *
+ * Performs safe git alignment to main (resetToMainAfterMerge / resetToRemoteBranch
+ * via _internals), handling post-merge scenarios and non-git directories.
+ * Returns { gitAlignResult, prunedBranches } so the orchestrator can build
+ * the close summary. All warnings are pushed into ctx.warnings.
+ */
+export declare function runAlignStage(ctx: CloseStageContext): Promise<GitAlignResult>;

package/dist/commands/close/archive-stage.d.ts

@@ -0,0 +1,34 @@
+import type { ArchiveStageContext, CleanStageResult, CloseStageContext } from './context.js';
+/**
+ * Emit the single `close_archive_result` telemetry event whose payload is the
+ * SAME `ctx.archiveResults` array the user-facing prose derives from, so the
+ * two cannot disagree (issue #2030 item 6). Called AFTER `runCleanStage` so
+ * `source_disposition` can be finalized truthfully: artifacts that were
+ * successfully archived AND then unlinked by the clean stage report `'removed'`;
+ * artifacts preserved (absent, or failed/retained) keep their archive-time
+ * disposition. Counts only — no row content (issue items 4/9).
+ */
+export declare function emitCloseArchiveResult(ctx: CloseStageContext, cleanResult: CleanStageResult): void;
+/**
+ * Bounded activity probe for the archive-mismatch alarm (#2044): does recorded
+ * project activity predict archive content? Existence + size only — no reads
+ * of record content, no unbounded scans.
+ */
+export declare function archiveActivityPredictsContent(directory: string): boolean;
+/**
+ * STAGE 2: ARCHIVE
+ *
+ * Creates a timestamped archive bundle under .swarm/archive/, copies flat-file
+ * artifacts and active-state directories, then runs the evidence retention
+ * policy. All state mutations (archive path, counts, success sets) are written
+ * back to ctx so the caller can build the close summary.
+ */
+export declare function runArchiveStage(ctx: CloseStageContext): Promise<void>;
+/**
+ * Runs the evidence-retention sub-logic of STAGE 2 (ARCHIVE).
+ * Reads max_age_days / max_bundles / cache_max_bytes / cache_max_records from
+ * config.evidence (FR-016, issue #1184) and calls archiveEvidence. The report
+ * overload is used so the documents-cache prune runs when cache caps are set.
+ * Fail-open: pushes a warning on error but never throws.
+ */
+export declare function runArchiveEvidenceRetention(ctx: ArchiveStageContext): Promise<void>;

package/dist/commands/close/clean-stage.d.ts

@@ -0,0 +1,2 @@
+import type { CleanStageResult, CloseStageContext } from './context.js';
+export declare function runCleanStage(ctx: CloseStageContext): Promise<CleanStageResult>;

package/dist/commands/close/constants.d.ts

@@ -0,0 +1,122 @@
+export declare const NO_RECEIPT_PHASE_CLOSE_SCOPE_DETAIL = "no exact receipt lifecycle scope exists for phase closure";
+export declare const CLOSE_SKILL_REVIEW_TIMEOUT_MS = 120000;
+export declare const CLOSE_REFLECTION_TIMEOUT_MS = 90000;
+/**
+ * Flat-file artifacts to include in the archive bundle.
+ * Each entry is a relative path under .swarm/.
+ *
+ * plan-ledger.jsonl is included so the archive bundle is a self-contained
+ * forensic snapshot of the session: the ledger holds the full audit trail of
+ * task state transitions and snapshot events that plan.json/plan.md don't
+ * preserve.
+ */
+export declare const ARCHIVE_ARTIFACTS: string[];
+/**
+ * Active-state flat files to clean after archiving so future swarms start clean.
+ *
+ * plan.json, plan.md, and plan-ledger.jsonl are all removed so the next /swarm
+ * session starts with a clean slate. The user's original ask for /swarm close
+ * was to "archive plan files so future swarms aren't confused" — leaving a
+ * terminal-state plan.json in place violates that invariant because the next
+ * session's loadPlan() would pick it up as if it were still active.
+ *
+ * CRITICAL: the ledger must also be removed. Without this, loadPlan()'s Step 4
+ * would see no plan.json but a surviving ledger, call replayFromLedger(), and
+ * materialize the CLOSED plan back into plan.json on the next session. The
+ * ledger is a second backing store for the same "terminal-state plan" and
+ * leaving it behind re-enables the exact bug this cleanup is meant to fix.
+ * The archive-first guard below ensures we only delete files we successfully
+ * copied to the archive bundle, so the audit trail is preserved in the bundle.
+ *
+ * knowledge-rejected.jsonl, repo-graph.json, doc-manifest.json,
+ * dark-matter.md, telemetry.jsonl, and swarm.db are
+ * session-generated artifacts that do not persist meaningfully across sessions —
+ * they are recreated on next session init and must be removed to avoid stale-state
+ * interference.
+ *
+ * The SQLite WAL sidecars swarm.db-shm and swarm.db-wal are deliberately NOT in
+ * either list (the archive-first guard would preserve them anyway): since #2483
+ * they are removed immediately AFTER the swarm.db unlink by
+ * removeSqliteSidecarsAfterClose, deliberately reversing #1692. Post-unlink the
+ * sidecar paths are meaningless for future opens (no new opener can attach),
+ * live processes keep their already-open fds so deleting the PATH cannot
+ * corrupt them, and a Windows open-handle collision yields EBUSY which the
+ * helper skips fail-open.
+ *
+ * Note: knowledge.jsonl is intentionally NOT cleaned because it contains cumulative
+ * project knowledge (lessons learned) that should persist across sessions and finalize
+ * cycles. The archive step still creates a backup for safety.
+ * close-summary.md is NOT cleaned because it is written as the final close output
+ * AFTER the clean stage runs. spec.md IS cleaned: it is single-session state coupled
+ * to the plan lifecycle (the plan it produced is removed above), so leaving it behind
+ * makes the next session pick up a stale spec via readEffectiveSpecSync and mis-route
+ * the architect into CLARIFY-SPEC/overwrite prompts. It is archived first (archive-first
+ * guard), so the forensic copy is preserved in the bundle. The earlier "spec.md may not
+ * exist" rationale was wrong — handoff.md is equally optional and is cleaned the same way.
+ * session-reflection.md is a single-session snapshot (not cumulative like
+ * knowledge.jsonl) so it IS cleaned to maintain the clean-slate invariant.
+ * spec-staleness.json and spec-snapshot.md are the same class of single-session
+ * spec-drift state as spec.md. spec-staleness.json is an existence-only gate
+ * checked unconditionally by enforceSpecDriftGate, which hard-blocks the core
+ * write tools (save_plan, update_task_status, phase_complete,
+ * lean_turbo_run_phase, lean_turbo_acquire_locks) with SPEC_DRIFT_BLOCK — a
+ * survivor would block the NEXT session against drift that no longer applies.
+ * spec-snapshot.md is its companion diff source, feeding the mismatch shown in
+ * the SPEC_DRIFT_BLOCK message. Both are archived first (archive-first guard),
+ * then cleaned so the next session starts drift-free.
+ */
+export declare const ACTIVE_STATE_TO_CLEAN: string[];
+/**
+ * Terminal plan-state files that must be removed at finalize UNCONDITIONALLY — even
+ * when archiving them failed — so the next session cannot resurrect the CLOSED plan
+ * (loadPlan Step 1 / replayFromLedger have no terminal-status filter). Kept as a
+ * shared constant so the archive-failure diagnostics and the unconditional removal
+ * below agree on the set; otherwise the "Preserved …" warning would contradict the
+ * removal that always follows for these files.
+ */
+export declare const TERMINAL_STATE_FILES: readonly ["plan.json", "plan-ledger.jsonl", "spec-staleness.json", "spec-snapshot.md"];
+/**
+ * Knowledge-family artifacts whose backing store redirects to a shared link
+ * directory when the worktree is linked (`.swarm/link.json`). A single
+ * worktree's `/swarm close` must NOT archive or delete the cohort-shared store —
+ * peers may still be active, and the shared store is durable with its own
+ * lifecycle (curation/hive-promotion already run on it, link-aware, during
+ * close). When the worktree is NOT linked these are handled normally (local).
+ *
+ * Scope: this set lists exactly the knowledge-family files that close otherwise
+ * archives/cleans — i.e. the intersection with `ARCHIVE_ARTIFACTS` /
+ * `ACTIVE_STATE_TO_CLEAN`. The other redirected files (retractions, counters,
+ * quarantine, unactionable, application, knowledge-events) appear in neither
+ * list, so close never touches them and they need no guard here. Note the two
+ * stages cover different members: the archive-stage guard fires for both
+ * `knowledge.jsonl` and `knowledge-rejected.jsonl` (both in `ARCHIVE_ARTIFACTS`),
+ * while the clean-stage guard is only reachable for `knowledge-rejected.jsonl`
+ * (`ACTIVE_STATE_TO_CLEAN` has no `knowledge.jsonl`).
+ */
+export declare const KNOWLEDGE_FAMILY_ARTIFACTS: Set<string>;
+/**
+ * Artifacts whose absence is a genuine state anomaly (vs the normal "optional,
+ * session-generated, may simply not exist" case). `plan.json`/`plan-ledger.jsonl`
+ * back the authoritative plan state (plan-durability invariant 5); their
+ * absence in a plan-based session warrants a warning. All other artifacts —
+ * including `swarm.db`, which `getProjectDb` creates lazily only when a
+ * DB-backed tool actually runs — are optional: a fresh or plan-free session
+ * legitimately has none of them, and an absent optional artifact is reported
+ * as `source_disposition: 'absent'`, NOT as a failure (issue #2030 item 7).
+ */
+export declare const REQUIRED_ARTIFACTS: Set<string>;
+/**
+ * Active-state directories to archive and clean after archiving.
+ * These contain session-generated data that must be removed so future
+ * swarms start clean. Each entry is a relative path under .swarm/.
+ */
+export declare const ACTIVE_STATE_DIRS_TO_CLEAN: string[];
+/**
+ * STAGE 3: CLEAN
+ *
+ * Removes active-state files and directories that were successfully archived
+ * (archive-first guard), plus stale config-backup/ledger-sibling/SWARM_PLAN/.tmp
+ * artifacts. Resets context.md for the next session. All state mutations are
+ * written back to ctx so the caller can build the close summary.
+ */
+export declare const ACTIVE_STATE_UNLINK_RETRY_DELAYS_MS: readonly [25, 50, 100, 200];