wicked-crew 0.7.11 → 0.7.12

package/dist/campaigns/worktrees.d.ts

@@ -1,39 +0,0 @@
-/**
- * Pre-provisioned campaign-node worktrees — the daemon-side workaround for an ENGINE defect
- * (found while landing crew#390): the engine names every run's worktree branch
- * `wicked/{run_id}` VERBATIM (`wicked-core src/repo.rs create_worktree`), and a campaign node's
- * run id is `{campaign}:{node}:a{attempt}` — a string git REFUSES as a branch name (':' is
- * illegal in a ref). Every repo-scoped campaign node therefore fails at dispatch with
- * "git worktree add failed: … is not a valid branch name" before a single unit runs, on every
- * released engine.
- *
- * The workaround rides the same function's DOCUMENTED contract: `create_worktree` is
- * "idempotent for a genuine resume: a live worktree already at the path is reused". So the
- * daemon creates each node's worktree FIRST — at the engine's own layout
- * (`<repo_root>/wicked-worktrees/<run_id>`, the crew#276 non-dotted root every engine this
- * daemon can install uses: `wicked-core-ts` floor ^0.7.6) — on a branch-SAFE name
- * (`wicked/<run_id with ':' → '-'>`), and the engine's dispatch finds and reuses it instead of
- * minting the illegal branch. When the engine later sanitizes its branch names natively, these
- * pre-created worktrees keep reading as the same legitimate resume state.
- *
- * Fail-closed and atomic-ish: provisioning happens BEFORE the campaign launches, so a git
- * failure aborts the whole request with nothing scheduled; the returned rollback lets the
- * caller reclaim the worktrees when the launch itself is then refused. NOTE: the run-id path
- * carries ':' — legal on macOS/Linux, ILLEGAL on Windows filesystems — so callers must keep a
- * non-campaign fallback on win32 (the recon route does).
- */
-/** One node's provisioning target: the engine-derived run id and its repo's root checkout. */
-export interface WorktreeTarget {
-    runId: string;
-    repoRoot: string;
-}
-/** The branch-safe spelling of a campaign-node run id (':' is illegal in a git ref). */
-export declare function branchSafe(runId: string): string;
-/**
- * Create one live worktree per target at the engine's layout, on a branch-safe branch.
- * Throws (after removing whatever it already created) when any `git worktree add` refuses —
- * the caller aborts the launch with nothing scheduled. Returns a best-effort rollback for the
- * caller's own abort paths (e.g. the engine then refusing the campaign def).
- */
-export declare function provisionCampaignWorktrees(targets: WorktreeTarget[]): Promise<() => Promise<void>>;
-//# sourceMappingURL=worktrees.d.ts.map

package/dist/campaigns/worktrees.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worktrees.d.ts","sourceRoot":"","sources":["../../src/campaigns/worktrees.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,8FAA8F;AAC9F,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAsBD;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,cAAc,EAAE,GACxB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAoC9B"}

package/dist/campaigns/worktrees.js

@@ -1,95 +0,0 @@
-/**
- * Pre-provisioned campaign-node worktrees — the daemon-side workaround for an ENGINE defect
- * (found while landing crew#390): the engine names every run's worktree branch
- * `wicked/{run_id}` VERBATIM (`wicked-core src/repo.rs create_worktree`), and a campaign node's
- * run id is `{campaign}:{node}:a{attempt}` — a string git REFUSES as a branch name (':' is
- * illegal in a ref). Every repo-scoped campaign node therefore fails at dispatch with
- * "git worktree add failed: … is not a valid branch name" before a single unit runs, on every
- * released engine.
- *
- * The workaround rides the same function's DOCUMENTED contract: `create_worktree` is
- * "idempotent for a genuine resume: a live worktree already at the path is reused". So the
- * daemon creates each node's worktree FIRST — at the engine's own layout
- * (`<repo_root>/wicked-worktrees/<run_id>`, the crew#276 non-dotted root every engine this
- * daemon can install uses: `wicked-core-ts` floor ^0.7.6) — on a branch-SAFE name
- * (`wicked/<run_id with ':' → '-'>`), and the engine's dispatch finds and reuses it instead of
- * minting the illegal branch. When the engine later sanitizes its branch names natively, these
- * pre-created worktrees keep reading as the same legitimate resume state.
- *
- * Fail-closed and atomic-ish: provisioning happens BEFORE the campaign launches, so a git
- * failure aborts the whole request with nothing scheduled; the returned rollback lets the
- * caller reclaim the worktrees when the launch itself is then refused. NOTE: the run-id path
- * carries ':' — legal on macOS/Linux, ILLEGAL on Windows filesystems — so callers must keep a
- * non-campaign fallback on win32 (the recon route does).
- */
-import { join } from 'node:path';
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
-import { execCapped } from '../core/exec.js';
-/** The branch-safe spelling of a campaign-node run id (':' is illegal in a git ref). */
-export function branchSafe(runId) {
-    return runId.replaceAll(':', '-');
-}
-async function git(repoRoot, args) {
-    await execCapped('git', ['-C', repoRoot, ...args], { windowsHide: true });
-}
-/** Mirror of the engine's `ensure_worktrees_excluded` (repo-local `.git/info/exclude`) — the
- *  engine only writes it on the mint path, which the reuse contract skips. Best-effort. */
-async function ensureExcluded(repoRoot) {
-    const ENTRY = 'wicked-worktrees/';
-    const exclude = join(repoRoot, '.git', 'info', 'exclude');
-    try {
-        const existing = await readFile(exclude, 'utf8').catch(() => '');
-        if (existing.split('\n').some((l) => l.trim() === ENTRY))
-            return;
-        const body = existing === '' || existing.endsWith('\n') ? existing : `${existing}\n`;
-        await mkdir(join(repoRoot, '.git', 'info'), { recursive: true });
-        await writeFile(exclude, `${body}${ENTRY}\n`, 'utf8');
-    }
-    catch {
-        /* cosmetic — a dirty `git status` in the parent checkout, never a failed run */
-    }
-}
-/**
- * Create one live worktree per target at the engine's layout, on a branch-safe branch.
- * Throws (after removing whatever it already created) when any `git worktree add` refuses —
- * the caller aborts the launch with nothing scheduled. Returns a best-effort rollback for the
- * caller's own abort paths (e.g. the engine then refusing the campaign def).
- */
-export async function provisionCampaignWorktrees(targets) {
-    const created = [];
-    const rollback = async () => {
-        for (const t of created) {
-            const wt = join(t.repoRoot, 'wicked-worktrees', t.runId);
-            // Forced remove is correct here: the run never started, so there is no work to preserve.
-            await execCapped('git', ['-C', t.repoRoot, 'worktree', 'remove', '--force', wt], {
-                windowsHide: true,
-            }).catch(() => { });
-            await execCapped('git', ['-C', t.repoRoot, 'branch', '-D', `wicked/${branchSafe(t.runId)}`], {
-                windowsHide: true,
-            }).catch(() => { });
-        }
-    };
-    for (const t of targets) {
-        const wt = join(t.repoRoot, 'wicked-worktrees', t.runId);
-        const branch = `wicked/${branchSafe(t.runId)}`;
-        try {
-            await mkdir(join(t.repoRoot, 'wicked-worktrees'), { recursive: true });
-            try {
-                await git(t.repoRoot, ['worktree', 'add', wt, '-b', branch]);
-            }
-            catch {
-                // The engine's own retry idiom: a stale branch from a prior attempt blocks `-b` — reuse it.
-                await git(t.repoRoot, ['worktree', 'add', wt, branch]);
-            }
-            await ensureExcluded(t.repoRoot);
-            created.push(t);
-        }
-        catch (err) {
-            await rollback();
-            throw new Error(`pre-provisioning the campaign worktree for run '${t.runId}' failed in ` +
-                `'${t.repoRoot}': ${err instanceof Error ? err.message : String(err)}`);
-        }
-    }
-    return rollback;
-}
-//# sourceMappingURL=worktrees.js.map

package/dist/campaigns/worktrees.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"worktrees.js","sourceRoot":"","sources":["../../src/campaigns/worktrees.ts"],"names":[],"mappings":"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"}