zelari-code 2.37.2 → 2.38.0

package/dist/cli/kraken/worktreeCleanupBatch.js

@@ -0,0 +1,110 @@
+/**
+ * worktreeCleanupBatch — Int3c (plan v2 §7.3) cleanup policy + queue.
+ *
+ * The per-worktree git calls live in `tools/krakenWorktree.ts`; this module
+ * owns only the POLICY (`batch` vs `eager`) and the in-process QUEUE of
+ * repo-level cleanup that a run defers. Split out because krakenWorktree.ts is
+ * already at its size budget and the state here is unrelated to worktree
+ * creation/merging.
+ *
+ * Why defer anything: removing a worktree used to cost three git processes —
+ * `worktree remove --force` (must stay eager: the directory has to be free
+ * before the next writer, and a merge node may run right after), then
+ * `worktree prune`, then `branch -D <branch>`. Prune and branch deletion are
+ * idempotent, order-independent and invisible to the run, so inside a run
+ * scope they are coalesced into ONE `prune` + ONE `branch -D <list>` at the
+ * end of the run.
+ *
+ * Scope, not "always": `cleanupKrakenWorktree` only defers while a scope is
+ * open (`beginKrakenWorktreeCleanupBatch`). Outside one, nothing would ever
+ * drain the queue — a standalone `task` call would silently keep its branches
+ * — so cleanup stays eager there. The flag's default is still `batch`: every
+ * run that opens a scope defers, `ZELARI_KRAKEN_WORKTREE_CLEANUP=eager` opts
+ * out for all callers.
+ *
+ * Pure state + policy: no fs, no git, no clock. The caller does the spawning.
+ *
+ * @since v2.38.0 (Int3c)
+ */
+/**
+ * `ZELARI_KRAKEN_WORKTREE_CLEANUP`, default `batch` (plan v2 §13):
+ *
+ * `batch`  — inside a run scope, coalesce `worktree prune` + `branch -D` into
+ *            ONE pair at the end of the run.
+ * `eager`  — kill-switch: per-worktree `prune` + `branch -D`, exactly as
+ *            before Int3c.
+ *
+ * An unrecognized value falls back to the default rather than to `eager`: a
+ * typo must not silently re-enable the extra subprocesses the slice removed.
+ */
+export function resolveWorktreeCleanupMode(env = process.env) {
+    const v = (env.ZELARI_KRAKEN_WORKTREE_CLEANUP ?? '').trim().toLowerCase();
+    if (v === 'eager')
+        return 'eager';
+    return 'batch';
+}
+/** repoRoot → the `worktree prune` it still owes (one per removed worktree). */
+const pendingPruneRoots = new Set();
+/** repoRoot → branches whose worktree is gone but whose branch is not. */
+const pendingBranches = new Map();
+/**
+ * Open run scopes. A counter (not a boolean) so two concurrent scopes — an
+ * executor run and, say, a nested one — cannot close each other's batch: each
+ * `begin` is matched by one `take`, and a take already drains the whole queue
+ * (deleting a queued branch earlier than "end of run" is only ever *more*
+ * eager, never wrong).
+ */
+let batchScopes = 0;
+/** True when `cleanupKrakenWorktree` should defer instead of cleaning eagerly. */
+export function isKrakenWorktreeCleanupBatched(env = process.env) {
+    return batchScopes > 0 && resolveWorktreeCleanupMode(env) === 'batch';
+}
+/**
+ * Open the cleanup batch for a run. Returns whether deferral is active: false
+ * in `eager` mode (nothing is queued, so the caller has no flush to make).
+ */
+export function beginKrakenWorktreeCleanupBatch(env = process.env) {
+    if (resolveWorktreeCleanupMode(env) !== 'batch')
+        return false;
+    batchScopes += 1;
+    return true;
+}
+/**
+ * Queue the repo-level half of one cleanup. Duplicates collapse: N worktrees
+ * of the same repo cost one prune, and a branch name is unique per worktree
+ * anyway (it embeds a timestamp + random id).
+ */
+export function queueWorktreeCleanup(repoRoot, branch) {
+    pendingPruneRoots.add(repoRoot);
+    if (!branch)
+        return;
+    const queued = pendingBranches.get(repoRoot) ?? new Set();
+    queued.add(branch);
+    pendingBranches.set(repoRoot, queued);
+}
+/**
+ * Close one scope and drain the queue. Draining clears the state, so a second
+ * drain in the same process returns empty work — the caller can issue no git
+ * command for it (an idle flush costs zero spawns).
+ */
+export function takeQueuedWorktreeCleanup() {
+    if (batchScopes > 0)
+        batchScopes -= 1;
+    const repoRoots = new Set([...pendingPruneRoots, ...pendingBranches.keys()]);
+    const branchesByRoot = new Map();
+    for (const repoRoot of repoRoots) {
+        const queued = pendingBranches.get(repoRoot);
+        if (queued && queued.size > 0)
+            branchesByRoot.set(repoRoot, [...queued]);
+        pendingPruneRoots.delete(repoRoot);
+        pendingBranches.delete(repoRoot);
+    }
+    return { repoRoots: [...repoRoots], branchesByRoot };
+}
+/** Test-only: drop the queue and any open scope. */
+export function __resetKrakenWorktreeCleanupQueueForTests() {
+    pendingPruneRoots.clear();
+    pendingBranches.clear();
+    batchScopes = 0;
+}
+//# sourceMappingURL=worktreeCleanupBatch.js.map

package/dist/cli/kraken/worktreeCleanupBatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktreeCleanupBatch.js","sourceRoot":"","sources":["../../../src/cli/kraken/worktreeCleanupBatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1E,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAClC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE5C,0EAA0E;AAC1E,MAAM,eAAe,GAAG,IAAI,GAAG,EAAuB,CAAC;AAEvD;;;;;;GAMG;AACH,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB,kFAAkF;AAClF,MAAM,UAAU,8BAA8B,CAC5C,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,WAAW,GAAG,CAAC,IAAI,0BAA0B,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAC7C,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,0BAA0B,CAAC,GAAG,CAAC,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC9D,WAAW,IAAI,CAAC,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,MAAqB;IAC1E,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;IAClE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB;IACvC,IAAI,WAAW,GAAG,CAAC;QAAE,WAAW,IAAI,CAAC,CAAC;IAEtC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,iBAAiB,EAAE,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACrF,MAAM,cAAc,GAAG,IAAI,GAAG,EAAoB,CAAC;IACnD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC;YAAE,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;QACzE,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;AACvD,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,yCAAyC;IACvD,iBAAiB,CAAC,KAAK,EAAE,CAAC;IAC1B,eAAe,CAAC,KAAK,EAAE,CAAC;IACxB,WAAW,GAAG,CAAC,CAAC;AAClB,CAAC"}