sandcastle-drain 0.1.0

package/dist/orchestrator/splits.js

@@ -0,0 +1,149 @@
+/**
+ * Split protocol — let an implementer hand the wrapper a list of new issues.
+ *
+ * When an implementer realises mid-run that the issue won't fit under the
+ * 150k context ceiling, the right move is to commit what does fit, write the
+ * remaining acceptance criteria as a list of follow-up issues into
+ * `.sandcastle-drain/splits.json` in the worktree, then emit `<promise>COMPLETE</promise>`.
+ *
+ * The wrapper picks up the file after the run, files each entry as a new
+ * `sandcastle` + `priority` issue (so it jumps the queue on the next refetch,
+ * matching the rejection-loop precedent), comments on the original linking
+ * the new issues, and applies the `oversized` label so the audit trail is
+ * unambiguous.
+ *
+ * This module owns the pure pieces: locating + reading the splits file,
+ * validating the shape, and rendering the comments. The actual `gh issue
+ * create` and label/comment plumbing lives in `main.ts` next to the
+ * analogous rejection-loop calls.
+ */
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export const SPLITS_FILE_RELATIVE_PATH = '.sandcastle-drain/splits.json';
+export const OVERSIZED_LABEL = 'oversized';
+export const MAX_SPLITS = 10;
+export const MAX_TITLE_LENGTH = 256;
+function isString(v) {
+    return typeof v === 'string';
+}
+function parseSplit(raw, index) {
+    if (raw === null || typeof raw !== 'object')
+        return `splits[${index}] is not an object`;
+    const s = raw;
+    if (!isString(s.title))
+        return `splits[${index}].title must be a string`;
+    if (s.title.length === 0)
+        return `splits[${index}].title must not be empty`;
+    if (s.title.length > MAX_TITLE_LENGTH) {
+        return `splits[${index}].title must be <= ${MAX_TITLE_LENGTH} chars (got ${s.title.length})`;
+    }
+    if (!isString(s.body))
+        return `splits[${index}].body must be a string`;
+    if (s.body.length === 0)
+        return `splits[${index}].body must not be empty`;
+    return { title: s.title, body: s.body };
+}
+/**
+ * Validates the raw JSON read from `.sandcastle-drain/splits.json`. The shape is
+ * intentionally tiny: an array of `{ title, body }`. Body is markdown the
+ * implementer wrote — we never massage it on the way through.
+ */
+export function parseSplitsFile(rawJson) {
+    let parsed;
+    try {
+        parsed = JSON.parse(rawJson);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            reason: `JSON.parse failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    if (!Array.isArray(parsed)) {
+        return { ok: false, reason: 'splits file must contain a top-level JSON array' };
+    }
+    if (parsed.length === 0) {
+        return { ok: false, reason: 'splits array must contain at least one entry' };
+    }
+    if (parsed.length > MAX_SPLITS) {
+        return {
+            ok: false,
+            reason: `splits array must contain at most ${MAX_SPLITS} entries (got ${parsed.length})`,
+        };
+    }
+    const splits = [];
+    for (let i = 0; i < parsed.length; i++) {
+        const result = parseSplit(parsed[i], i);
+        if (typeof result === 'string')
+            return { ok: false, reason: result };
+        splits.push(result);
+    }
+    return { ok: true, value: splits };
+}
+export function splitsFilePath(worktreePath) {
+    return join(worktreePath, SPLITS_FILE_RELATIVE_PATH);
+}
+/**
+ * Reads + parses the splits file from a worktree. Returns `undefined` when
+ * the file isn't present — the common case, since most implementers won't
+ * split. File-read failures other than ENOENT surface as parse errors so the
+ * wrapper can post the same error-comment path.
+ */
+export async function readSplitsFile(worktreePath) {
+    const path = splitsFilePath(worktreePath);
+    if (!existsSync(path))
+        return undefined;
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch (err) {
+        return {
+            ok: false,
+            reason: `failed to read ${SPLITS_FILE_RELATIVE_PATH}: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    return parseSplitsFile(raw);
+}
+/**
+ * Renders the comment left on the parent issue when splits land successfully.
+ * The reader gets a numbered checklist of the follow-ups so they can spot at a
+ * glance how the work was decomposed, plus a note explaining the label.
+ */
+export function buildOriginalIssueSplitComment(args) {
+    const lines = [];
+    lines.push(`**sandcastle-drain implementer split this issue into ${args.splits.length} follow-up${args.splits.length === 1 ? '' : 's'}.**`);
+    lines.push('');
+    lines.push(`The implementer wrote \`.sandcastle-drain/splits.json\` during the run, signalling that the remaining acceptance criteria could not fit under the 150k context ceiling. Each follow-up has been filed with the \`sandcastle\` + \`priority\` labels and will run on the next drain.`);
+    lines.push('');
+    for (const split of args.splits) {
+        lines.push(`- #${split.number} — ${split.title}`);
+    }
+    lines.push('');
+    lines.push(`This issue has been labelled \`${OVERSIZED_LABEL}\`. The commits made during this run still flow through the normal review path — splitting does not throw away the work the implementer did finish.`);
+    return lines.join('\n');
+}
+/**
+ * Renders the error comment when the splits file is malformed. We still want
+ * the human to know the implementer tried to split — silent dropping would
+ * make the next drain look like the implementer just bailed out.
+ */
+export function buildSplitErrorComment(args) {
+    const lines = [];
+    lines.push(`**sandcastle-drain implementer wrote \`.sandcastle-drain/splits.json\` but it was malformed.**`);
+    lines.push('');
+    lines.push(`Parse error: \`${args.reason}\``);
+    lines.push('');
+    lines.push(`No follow-up issues were filed. The implementer's commits (if any) still flow through the normal review path; re-file the splits by hand or apply \`retry\` after fixing the prompt.`);
+    return lines.join('\n');
+}
+/**
+ * Renders the message the wrapper logs to its own stdout when the splits
+ * flow fires. Not posted to GitHub — this is just for the drain operator.
+ */
+export function formatSplitsLogLine(args) {
+    const numbers = args.splits.map((s) => `#${s.number}`).join(', ');
+    return `[wrapper] split #${args.parentIssue} into ${args.splits.length} follow-up(s): ${numbers}`;
+}
+//# sourceMappingURL=splits.js.map

package/dist/orchestrator/splits.js.map

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

package/dist/orchestrator/status.d.ts

@@ -0,0 +1,13 @@
+export type RunStatus = 'completed' | 'partial-work' | 'ok (windows-teardown)' | 'bailed-out' | 'failed (rate limit)' | 'failed (timeout)' | 'failed (unknown)';
+export declare function containsRateLimit(text: string): boolean;
+export declare function isRateLimitError(err: unknown): boolean;
+export declare function determineRunStatus(args: {
+    commits: {
+        sha: string;
+    }[];
+    completionSignal: string | undefined;
+    runError: unknown;
+    stdout: string;
+    windowsTeardownThrew?: boolean;
+}): RunStatus;
+//# sourceMappingURL=status.d.ts.map

package/dist/orchestrator/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/orchestrator/status.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,cAAc,GACd,uBAAuB,GACvB,YAAY,GACZ,qBAAqB,GACrB,kBAAkB,GAClB,kBAAkB,CAAC;AAIvB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGtD;AAYD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GAAG,SAAS,CAuBZ"}

package/dist/orchestrator/status.js

@@ -0,0 +1,43 @@
+const RATE_LIMIT_MARKERS = ['rate limit', 'usage limit', 'Please try again'];
+export function containsRateLimit(text) {
+    const lower = text.toLowerCase();
+    return RATE_LIMIT_MARKERS.some((m) => lower.includes(m.toLowerCase()));
+}
+export function isRateLimitError(err) {
+    const text = err instanceof Error ? err.message : String(err);
+    return containsRateLimit(text);
+}
+function isAbortError(err) {
+    if (err instanceof Error) {
+        const name = err.name;
+        if (name === 'AbortError' || name === 'TimeoutError')
+            return true;
+        const msg = err.message.toLowerCase();
+        if (msg.includes('abort') || msg.includes('timeout') || msg.includes('idle'))
+            return true;
+    }
+    return false;
+}
+export function determineRunStatus(args) {
+    const { commits, completionSignal, runError, stdout, windowsTeardownThrew = false } = args;
+    if (commits.length > 0) {
+        if (windowsTeardownThrew && runError !== undefined)
+            return 'ok (windows-teardown)';
+        return completionSignal !== undefined ? 'completed' : 'partial-work';
+    }
+    if (completionSignal !== undefined) {
+        return 'bailed-out';
+    }
+    if (runError) {
+        if (isRateLimitError(runError))
+            return 'failed (rate limit)';
+        if (isAbortError(runError))
+            return 'failed (timeout)';
+        return 'failed (unknown)';
+    }
+    if (containsRateLimit(stdout)) {
+        return 'failed (rate limit)';
+    }
+    return 'failed (unknown)';
+}
+//# sourceMappingURL=status.js.map

package/dist/orchestrator/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/orchestrator/status.ts"],"names":[],"mappings":"AASA,MAAM,kBAAkB,GAAG,CAAC,YAAY,EAAE,aAAa,EAAE,kBAAkB,CAAC,CAAC;AAE7E,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,MAAM,IAAI,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9D,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACtB,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,cAAc;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;IAC5F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAMlC;IACC,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IAE3F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,oBAAoB,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,uBAAuB,CAAC;QACnF,OAAO,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;IACvE,CAAC;IAED,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,gBAAgB,CAAC,QAAQ,CAAC;YAAE,OAAO,qBAAqB,CAAC;QAC7D,IAAI,YAAY,CAAC,QAAQ,CAAC;YAAE,OAAO,kBAAkB,CAAC;QACtD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/orchestrator/summary.d.ts

@@ -0,0 +1,33 @@
+import type { RunStatus } from './status.js';
+export interface RunSummary {
+    issue: number;
+    status: RunStatus | 'skipped (existing branch)' | 'skipped (rate-limited)' | `skipped (blocked by #${number})`;
+    branch?: string;
+    commitCount: number;
+    ciOk?: boolean;
+    autoMerged?: boolean;
+    rejected?: boolean;
+    split?: {
+        count: number;
+        followUpNumbers: readonly number[];
+    };
+    attempt?: number;
+}
+export interface SummaryCounts {
+    attempted: number;
+    completed: number;
+    partialWork: number;
+    windowsTeardown: number;
+    bailedOut: number;
+    failed: number;
+    ciFailed: number;
+    needsReview: number;
+    needsInfo: number;
+    autoMerged: number;
+    rejected: number;
+    split: number;
+    skipped: number;
+}
+export declare function computeCounts(summaries: readonly RunSummary[]): SummaryCounts;
+export declare function formatSummary(summaries: readonly RunSummary[]): string;
+//# sourceMappingURL=summary.d.ts.map

package/dist/orchestrator/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/orchestrator/summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EACF,SAAS,GACT,2BAA2B,GAC3B,wBAAwB,GACxB,wBAAwB,MAAM,GAAG,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IAGpB,IAAI,CAAC,EAAE,OAAO,CAAC;IAGf,UAAU,CAAC,EAAE,OAAO,CAAC;IAIrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAMnB,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAI9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AA6BD,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,UAAU,EAAE,GAAG,aAAa,CAgB7E;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CA4BtE"}

package/dist/orchestrator/summary.js

@@ -0,0 +1,59 @@
+const hasReviewStatus = (s) => s.status === 'completed' || s.status === 'partial-work' || s.status === 'ok (windows-teardown)';
+const isAutoMerged = (s) => s.autoMerged === true;
+const isRejected = (s) => s.rejected === true;
+const isSplit = (s) => s.split !== undefined && s.split.count > 0;
+function splitSuffix(s) {
+    if (!s.split || s.split.count === 0)
+        return '';
+    const plural = s.split.count === 1 ? '' : 's';
+    return ` [split: ${s.split.count} follow-up${plural}]`;
+}
+const isReview = (s) => hasReviewStatus(s) && s.ciOk !== false && !isAutoMerged(s) && !isRejected(s);
+const isFailed = (s) => typeof s.status === 'string' && s.status.startsWith('failed');
+const isInfo = (s) => s.status === 'bailed-out' || isFailed(s) || (hasReviewStatus(s) && s.ciOk === false);
+const isSkipped = (s) => typeof s.status === 'string' && s.status.startsWith('skipped');
+export function computeCounts(summaries) {
+    return {
+        attempted: summaries.length,
+        completed: summaries.filter((s) => s.status === 'completed').length,
+        partialWork: summaries.filter((s) => s.status === 'partial-work').length,
+        windowsTeardown: summaries.filter((s) => s.status === 'ok (windows-teardown)').length,
+        bailedOut: summaries.filter((s) => s.status === 'bailed-out').length,
+        failed: summaries.filter(isFailed).length,
+        ciFailed: summaries.filter((s) => hasReviewStatus(s) && s.ciOk === false).length,
+        needsReview: summaries.filter(isReview).length,
+        needsInfo: summaries.filter(isInfo).length,
+        autoMerged: summaries.filter(isAutoMerged).length,
+        rejected: summaries.filter(isRejected).length,
+        split: summaries.filter(isSplit).length,
+        skipped: summaries.filter(isSkipped).length,
+    };
+}
+export function formatSummary(summaries) {
+    const c = computeCounts(summaries);
+    const lines = [
+        '',
+        '[wrapper] === Drain summary ===',
+        `  attempted   : ${c.attempted}`,
+        `  auto-merged : ${c.autoMerged}`,
+        `  rejected    : ${c.rejected}`,
+        `  split       : ${c.split}`,
+        `  needs-review: ${c.needsReview} (${c.completed} completed, ${c.partialWork} partial, ${c.windowsTeardown} windows-teardown)`,
+        `  needs-info  : ${c.needsInfo} (${c.bailedOut} bailed-out, ${c.failed} failed, ${c.ciFailed} ci-failed)`,
+        `  skipped     : ${c.skipped}`,
+        `  failed      : ${c.failed}`,
+        '',
+    ];
+    for (const s of summaries) {
+        const branchPart = s.branch ? ` (${s.branch}, ${s.commitCount} commits)` : '';
+        const reviewHint = s.branch ? ` — review with: git diff main..${s.branch}` : '';
+        const ciSuffix = s.ciOk === false ? ' [CI FAILED]' : '';
+        const mergedSuffix = s.autoMerged ? ' [auto-merged]' : '';
+        const rejectedSuffix = s.rejected ? ' [rejected]' : '';
+        const split = splitSuffix(s);
+        const attemptSuffix = s.attempt && s.attempt > 1 ? ` (attempt ${s.attempt})` : '';
+        lines.push(`  #${s.issue}: ${s.status}${ciSuffix}${mergedSuffix}${rejectedSuffix}${split}${attemptSuffix}${branchPart}${reviewHint}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=summary.js.map

package/dist/orchestrator/summary.js.map

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

package/dist/orchestrator/sweep.d.ts

@@ -0,0 +1,18 @@
+export declare class SweepError extends Error {
+    constructor(message: string);
+}
+export interface SweepBranchArgs {
+    issue: number;
+}
+export interface SweepBranchResult {
+    branch: string;
+    prUrl: string;
+}
+/**
+ * Pulls main, removes the per-issue worktree, prunes worktree metadata, and
+ * deletes the local branch. Throws `SweepError` if no MERGED PR exists for the
+ * branch — that guard is the only safety net keeping a sweep from discarding
+ * in-flight work.
+ */
+export declare function sweepBranch(args: SweepBranchArgs): Promise<SweepBranchResult>;
+//# sourceMappingURL=sweep.d.ts.map

package/dist/orchestrator/sweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep.d.ts","sourceRoot":"","sources":["../../src/orchestrator/sweep.ts"],"names":[],"mappings":"AAiCA,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAqBD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0CnF"}

package/dist/orchestrator/sweep.js

@@ -0,0 +1,79 @@
+/**
+ * Post-merge cleanup for an `agent/issue-N` slice: pulls main, removes the
+ * worktree directory (Windows-safe via the shared helper), prunes git's
+ * worktree metadata, and deletes the local branch.
+ *
+ * Invoked by `src/cli.ts` as `sandcastle-drain sweep <issue>`. Refuses to run unless
+ * a MERGED PR exists for the branch — sweep is post-merge cleanup, not a way
+ * to discard in-flight work. To discard a still-open branch intentionally,
+ * use `git worktree remove` and `git branch -D` directly. The drain
+ * orchestrator (`main.ts`) also calls `sweepBranch` inline after a successful
+ * auto-ship.
+ */
+import { execa } from 'execa';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { REPO_ROOT } from './prereqs.js';
+import { removeWorktreeDir } from './worktree-cleanup.js';
+async function run(cmd, args, opts = {}) {
+    const r = await execa(cmd, args, { cwd: opts.cwd ?? REPO_ROOT, reject: opts.reject ?? true });
+    return { exitCode: r.exitCode ?? 0, stdout: r.stdout, stderr: r.stderr };
+}
+export class SweepError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SweepError';
+    }
+}
+async function findMergedPr(branch) {
+    const result = await run('gh', ['pr', 'list', '--head', branch, '--state', 'all', '--json', 'number,state,url'], { reject: false });
+    if (result.exitCode !== 0) {
+        throw new SweepError(`gh pr list failed: ${result.stderr}`);
+    }
+    const prs = JSON.parse(result.stdout || '[]');
+    return prs.find((p) => p.state === 'MERGED');
+}
+/**
+ * Pulls main, removes the per-issue worktree, prunes worktree metadata, and
+ * deletes the local branch. Throws `SweepError` if no MERGED PR exists for the
+ * branch — that guard is the only safety net keeping a sweep from discarding
+ * in-flight work.
+ */
+export async function sweepBranch(args) {
+    const branch = `agent/issue-${args.issue}`;
+    const worktreePath = resolve(REPO_ROOT, '.sandcastle-drain', 'worktrees', `agent-issue-${args.issue}`);
+    console.log(`[sweep] Checking that PR for ${branch} is merged...`);
+    const merged = await findMergedPr(branch);
+    if (!merged) {
+        throw new SweepError(`No MERGED PR found for ${branch}. Sweep is post-merge cleanup only — run \`sandcastle-drain ship ${args.issue}\` first, or remove the worktree manually if you want to discard the branch without merging.`);
+    }
+    console.log(`[sweep] Found merged PR: ${merged.url}`);
+    // Pull main so the local main has the squash commit. (Without this, the
+    // `git branch -d` step below refuses with "not yet merged to HEAD".)
+    console.log(`[sweep] Pulling main...`);
+    await run('git', ['checkout', 'main']);
+    await run('git', ['pull', 'origin', 'main']);
+    if (existsSync(worktreePath)) {
+        console.log(`[sweep] Removing worktree...`);
+        await removeWorktreeDir(worktreePath);
+    }
+    else {
+        console.log(`[sweep] Worktree already gone — skipping.`);
+    }
+    await run('git', ['worktree', 'prune']);
+    // -D = force. -d would refuse because we squash-merge: the branch tip never
+    // becomes an ancestor of main, so git's "not fully merged" check fires even
+    // though the work IS on main under a different SHA. The PR-merge check above
+    // is the real safety net — if we got here, the work is upstream.
+    const branchCheck = await run('git', ['rev-parse', '--verify', branch], { reject: false });
+    if (branchCheck.exitCode === 0) {
+        console.log(`[sweep] Deleting local branch ${branch}...`);
+        await run('git', ['branch', '-D', branch]);
+    }
+    else {
+        console.log(`[sweep] Local branch ${branch} already gone — skipping.`);
+    }
+    console.log(`[sweep] Done. #${args.issue} is fully cleaned up.`);
+    return { branch, prUrl: merged.url };
+}
+//# sourceMappingURL=sweep.js.map

package/dist/orchestrator/sweep.js.map

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

package/dist/orchestrator/teardown.d.ts

@@ -0,0 +1,12 @@
+export declare function recoverCommitsFromBranch(branch: string, cwd: string): Promise<{
+    sha: string;
+}[]>;
+export declare function tryRecoverCommits(args: {
+    result: unknown;
+    runError: unknown;
+    branch: string;
+    cwd: string;
+}): Promise<{
+    sha: string;
+}[]>;
+//# sourceMappingURL=teardown.d.ts.map

package/dist/orchestrator/teardown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teardown.d.ts","sourceRoot":"","sources":["../../src/orchestrator/teardown.ts"],"names":[],"mappings":"AAmBA,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAY5B;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAS7B"}

package/dist/orchestrator/teardown.js

@@ -0,0 +1,42 @@
+/**
+ * Windows teardown handling for sandcastle worktrees.
+ *
+ * On Windows, sandcastle's internal `WorktreeManager.remove()` throws after a
+ * successful agent run because pnpm's `node_modules/.pnpm/` symlink farm
+ * defeats git's recursive teardown ("Function not implemented"). That throw is
+ * the expected exit path for any Windows drain that runs `pnpm install`, not
+ * an error — the agent's commits are already on the branch. We read them back
+ * here and let the wrapper label the run as `ok (windows-teardown)`.
+ *
+ * See src/content/agent-docs/sandcastle-windows-cleanup.md for background.
+ */
+import { execa } from 'execa';
+async function branchExists(branch, cwd) {
+    const result = await execa('git', ['rev-parse', '--verify', branch], { cwd, reject: false });
+    return result.exitCode === 0;
+}
+export async function recoverCommitsFromBranch(branch, cwd) {
+    if (!(await branchExists(branch, cwd)))
+        return [];
+    const result = await execa('git', ['log', 'main..' + branch, '--format=%H'], {
+        cwd,
+        reject: false,
+    });
+    if (result.exitCode !== 0)
+        return [];
+    return result.stdout
+        .split(/\r?\n/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0)
+        .map((sha) => ({ sha }));
+}
+export async function tryRecoverCommits(args) {
+    if (args.result !== undefined || args.runError === undefined)
+        return [];
+    const recovered = await recoverCommitsFromBranch(args.branch, args.cwd);
+    if (recovered.length > 0) {
+        console.log(`[wrapper] read ${recovered.length} commit(s) from ${args.branch} after sandcastle.run() threw on Windows teardown`);
+    }
+    return recovered;
+}
+//# sourceMappingURL=teardown.js.map

package/dist/orchestrator/teardown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teardown.js","sourceRoot":"","sources":["../../src/orchestrator/teardown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,GAAW;IACrD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7F,OAAO,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAc,EACd,GAAW;IAEX,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,aAAa,CAAC,EAAE;QAC3E,GAAG;QACH,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM;SACjB,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAKvC;IACC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACxE,MAAM,SAAS,GAAG,MAAM,wBAAwB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACxE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CACT,kBAAkB,SAAS,CAAC,MAAM,mBAAmB,IAAI,CAAC,MAAM,mDAAmD,CACpH,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/orchestrator/worktree-cleanup.d.ts

@@ -0,0 +1,2 @@
+export declare function removeWorktreeDir(worktreePath: string): Promise<void>;
+//# sourceMappingURL=worktree-cleanup.d.ts.map

package/dist/orchestrator/worktree-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-cleanup.d.ts","sourceRoot":"","sources":["../../src/orchestrator/worktree-cleanup.ts"],"names":[],"mappings":"AAgBA,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B3E"}

package/dist/orchestrator/worktree-cleanup.js

@@ -0,0 +1,39 @@
+/**
+ * Cross-platform recursive removal of a sandcastle worktree directory.
+ *
+ * Windows-specific quirk: pnpm's `node_modules/.pnpm/<long-hash>/...` symlink
+ * farm defeats standard recursive deletion (Node's `fs.rm`, PowerShell
+ * `Remove-Item`, `rmdir /s`, even git's own worktree cleanup — git surfaces
+ * `Function not implemented` from the kernel). `robocopy /MIR` against an
+ * empty source mirror-deletes everything in the target using long-path-aware
+ * Win32 APIs that handle the symlink chain.
+ */
+import { execa } from 'execa';
+import { existsSync } from 'node:fs';
+import { mkdir, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { basename, join } from 'node:path';
+export async function removeWorktreeDir(worktreePath) {
+    if (!existsSync(worktreePath))
+        return;
+    if (process.platform !== 'win32') {
+        await rm(worktreePath, { recursive: true, force: true });
+        return;
+    }
+    // PID + basename keeps concurrent calls from colliding on the empty source.
+    const emptyDir = join(tmpdir(), `sandcastle-empty-${basename(worktreePath)}-${process.pid}`);
+    await mkdir(emptyDir, { recursive: true });
+    try {
+        const robo = await execa('robocopy', [emptyDir, worktreePath, '/MIR', '/NFL', '/NDL', '/NJH', '/NJS'], { reject: false });
+        // robocopy exit codes: 0-7 are success-ish, 8+ is an actual failure.
+        if ((robo.exitCode ?? 0) >= 8) {
+            throw new Error(`robocopy failed with code ${robo.exitCode} on ${worktreePath}.\n${robo.stderr}`);
+        }
+    }
+    finally {
+        await rm(emptyDir, { recursive: true, force: true });
+    }
+    // Worktree dir is now empty — remove the dir itself.
+    await rm(worktreePath, { recursive: true, force: true });
+}
+//# sourceMappingURL=worktree-cleanup.js.map

package/dist/orchestrator/worktree-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-cleanup.js","sourceRoot":"","sources":["../../src/orchestrator/worktree-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,YAAoB;IAC1D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO;IAEtC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,EAAE,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IAED,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,oBAAoB,QAAQ,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7F,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CACtB,UAAU,EACV,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAChE,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;QACF,qEAAqE;QACrE,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,CAAC,QAAQ,OAAO,YAAY,MAAM,IAAI,CAAC,MAAM,EAAE,CACjF,CAAC;QACJ,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,qDAAqD;IACrD,MAAM,EAAE,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC"}