@ashlr/hub 2.2.0

package/dist/core/swarm/planner.js

@@ -0,0 +1,293 @@
+/**
+ * core/swarm/planner.ts — M12 swarm planner.
+ *
+ * planSwarm({goal, specBody?}, cfg): Promise<SwarmPlan>
+ *
+ * Decomposes a goal (+ optional spec body) into a phased SwarmPlan via a
+ * single bounded model call (LOCAL-first). Guardrails:
+ *  - Single model call; never throws — all failures fall back to a sensible
+ *    default plan.
+ *  - Tasks per phase capped at <= 6; total tasks capped at <= 18.
+ *  - BUILD-phase tasks are independent (no intra-build deps); later phases
+ *    carry deps on the tasks from the prior phase.
+ *  - IDs are stable slugs: scaffold-1, build-1..N, integrate-1, verify-1, review-1.
+ */
+import { getActiveClient } from '../run/provider-client.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_TASKS_PER_PHASE = 6;
+const MAX_TOTAL_TASKS = 18;
+// ---------------------------------------------------------------------------
+// Planning prompt
+// ---------------------------------------------------------------------------
+const PLANNING_SYSTEM = `You are an expert software engineering planner. Given a goal (and optionally a detailed end-state spec), decompose the work into a phased plan suitable for a fleet of autonomous coding agents.
+
+Output a JSON object with the following shape (STRICT — no markdown fences, no extra keys):
+{
+  "scaffold": [
+    { "id": "scaffold-1", "goal": "<concrete task goal>" }
+  ],
+  "build": [
+    { "id": "build-1", "goal": "<concrete task goal>" },
+    { "id": "build-2", "goal": "<concrete task goal>" }
+  ],
+  "integrate": [
+    { "id": "integrate-1", "goal": "<concrete task goal>" }
+  ],
+  "verify": [
+    { "id": "verify-1", "goal": "<concrete task goal>" }
+  ],
+  "review": [
+    { "id": "review-1", "goal": "<concrete task goal>" }
+  ]
+}
+
+Phase meanings:
+- scaffold: Set up project structure, config files, boilerplate (1-2 tasks).
+- build: Core implementation tasks — these run IN PARALLEL and must be independent of each other (2-6 tasks).
+- integrate: Wire together the built components (1-2 tasks).
+- verify: Run tests, type-checks, linting, confirm correctness (1-2 tasks).
+- review: Final review, documentation, cleanup (1-2 tasks).
+
+Rules:
+- scaffold: 1-2 tasks max.
+- build: 2-6 tasks max (parallelizable, no mutual deps).
+- integrate: 1-2 tasks max.
+- verify: 1-2 tasks max.
+- review: 1-2 tasks max.
+- Total tasks across all phases: <= 18.
+- Every task goal must be CONCRETE and actionable (not vague like "implement the feature").
+- Every task goal must be CODE/BUILD/TEST work ONLY. NEVER include any outward or destructive action: no git push, no deploy/publish/release, no repository creation, no "ship"/"tidy --apply", no opening PRs. Tasks operate strictly within the target project directory.
+- Output ONLY the raw JSON object — no explanation, no markdown, no surrounding text.`;
+/**
+ * Extract a JSON object from model output that may contain prose or markdown
+ * fences. Tries the full string first, then scans for the first { ... } block.
+ */
+function extractJson(raw) {
+    const trimmed = raw.trim();
+    // 1. Strip markdown code fences if present (```json ... ``` or ``` ... ```)
+    const fenceMatch = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/);
+    const candidate = fenceMatch ? fenceMatch[1].trim() : trimmed;
+    // 2. Try direct parse
+    try {
+        return JSON.parse(candidate);
+    }
+    catch {
+        // fall through
+    }
+    // 3. Find first top-level { ... } block in the original raw string
+    const start = raw.indexOf('{');
+    const end = raw.lastIndexOf('}');
+    if (start !== -1 && end > start) {
+        try {
+            return JSON.parse(raw.slice(start, end + 1));
+        }
+        catch {
+            // fall through
+        }
+    }
+    return null;
+}
+/**
+ * Parse a raw phase array into SwarmTaskSpec[]. Caps at maxCount.
+ * Assigns canonical ids of the form "<phase>-<N>" if the model's ids look wrong.
+ */
+function parsePhase(raw, phase, maxCount, budgetRemaining) {
+    if (!Array.isArray(raw) || raw.length === 0)
+        return [];
+    const tasks = [];
+    const effectiveMax = Math.min(maxCount, budgetRemaining);
+    for (let i = 0; i < Math.min(raw.length, effectiveMax); i++) {
+        const item = raw[i];
+        if (!item || typeof item !== 'object')
+            continue;
+        const goal = typeof item.goal === 'string' && item.goal.trim().length > 0
+            ? item.goal.trim()
+            : null;
+        if (!goal)
+            continue;
+        // Normalise id: use canonical form to guarantee uniqueness and phase tagging.
+        const id = `${phase}-${tasks.length + 1}`;
+        // deps are assigned by the caller based on phase ordering, not the model output.
+        tasks.push({ id, phase, goal, deps: [] });
+    }
+    return tasks;
+}
+/**
+ * Assign cross-phase deps so later phases depend on all tasks in the
+ * immediately preceding phase. Build-phase tasks are independent (no intra-
+ * build deps). Non-build phases get deps on the last-phase task ids.
+ *
+ * Phase ordering: scaffold -> build -> integrate -> verify -> review.
+ */
+function wireDeps(tasks) {
+    const byPhase = {
+        scaffold: [],
+        build: [],
+        integrate: [],
+        verify: [],
+        review: [],
+    };
+    for (const t of tasks) {
+        byPhase[t.phase].push(t);
+    }
+    const phaseOrder = ['scaffold', 'build', 'integrate', 'verify', 'review'];
+    const wired = [];
+    let prevPhaseIds = [];
+    for (const phase of phaseOrder) {
+        const phaseTasks = byPhase[phase];
+        for (const t of phaseTasks) {
+            // BUILD tasks are parallel — all depend on scaffold tasks only (the
+            // previous phase), not on each other.
+            // All other phases depend on the entire previous phase completing.
+            wired.push({ ...t, deps: [...prevPhaseIds] });
+        }
+        // After processing this phase, its task ids become deps for the next phase.
+        prevPhaseIds = phaseTasks.map((t) => t.id);
+    }
+    return wired;
+}
+/**
+ * Try to parse a SwarmPlan from model output. Returns null if parsing fails
+ * or produces no tasks.
+ */
+function parsePlan(raw, goal) {
+    const parsed = extractJson(raw);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        return null;
+    const rp = parsed;
+    // Track total budget across phases
+    let totalRemaining = MAX_TOTAL_TASKS;
+    const scaffoldTasks = parsePhase(rp.scaffold, 'scaffold', 2, totalRemaining);
+    totalRemaining -= scaffoldTasks.length;
+    const buildTasks = parsePhase(rp.build, 'build', MAX_TASKS_PER_PHASE, totalRemaining);
+    totalRemaining -= buildTasks.length;
+    const integrateTasks = parsePhase(rp.integrate, 'integrate', 2, totalRemaining);
+    totalRemaining -= integrateTasks.length;
+    const verifyTasks = parsePhase(rp.verify, 'verify', 2, totalRemaining);
+    totalRemaining -= verifyTasks.length;
+    const reviewTasks = parsePhase(rp.review, 'review', 2, totalRemaining);
+    const allTasks = [
+        ...scaffoldTasks,
+        ...buildTasks,
+        ...integrateTasks,
+        ...verifyTasks,
+        ...reviewTasks,
+    ];
+    if (allTasks.length === 0)
+        return null;
+    const wired = wireDeps(allTasks);
+    return { specId: null, goal, tasks: wired };
+}
+// ---------------------------------------------------------------------------
+// Default fallback plan
+// ---------------------------------------------------------------------------
+/**
+ * Build a sensible default plan when model output cannot be parsed.
+ * 1 scaffold, 3 build (independent), 1 integrate, 1 verify, 1 review.
+ */
+function defaultPlan(goal) {
+    const scaffoldTask = {
+        id: 'scaffold-1',
+        phase: 'scaffold',
+        goal: `Set up project structure and boilerplate for: ${goal}`,
+        deps: [],
+    };
+    const buildTasks = [
+        {
+            id: 'build-1',
+            phase: 'build',
+            goal: `Implement core data models and types for: ${goal}`,
+            deps: ['scaffold-1'],
+        },
+        {
+            id: 'build-2',
+            phase: 'build',
+            goal: `Implement primary business logic for: ${goal}`,
+            deps: ['scaffold-1'],
+        },
+        {
+            id: 'build-3',
+            phase: 'build',
+            goal: `Implement CLI or API interface for: ${goal}`,
+            deps: ['scaffold-1'],
+        },
+    ];
+    const integrateTask = {
+        id: 'integrate-1',
+        phase: 'integrate',
+        goal: `Wire together all components and ensure they work end-to-end for: ${goal}`,
+        deps: ['build-1', 'build-2', 'build-3'],
+    };
+    const verifyTask = {
+        id: 'verify-1',
+        phase: 'verify',
+        goal: `Run tests, type-checks, and lint; fix any failures for: ${goal}`,
+        deps: ['integrate-1'],
+    };
+    const reviewTask = {
+        id: 'review-1',
+        phase: 'review',
+        goal: `Review code quality, add documentation, and clean up for: ${goal}`,
+        deps: ['verify-1'],
+    };
+    return {
+        specId: null,
+        goal,
+        tasks: [scaffoldTask, ...buildTasks, integrateTask, verifyTask, reviewTask],
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Decompose a goal (+ optional spec body) into a phased SwarmPlan.
+ *
+ * CONTRACT (from docs/contracts/CONTRACT-M12.md):
+ *   planSwarm(input: { goal: string; specBody?: string }, cfg: AshlrConfig): Promise<SwarmPlan>
+ *
+ * Guardrails:
+ *  - Single bounded model call; never throws.
+ *  - Tasks per phase <= 6; total tasks <= 18.
+ *  - BUILD-phase tasks are independent (deps = scaffold tasks only).
+ *  - Falls back to a sensible default plan on any failure.
+ *  - LOCAL-first (opts.allowCloud defaults false).
+ */
+export async function planSwarm(input, cfg) {
+    const { goal, specBody } = input;
+    // Build the user prompt
+    const userPrompt = specBody
+        ? `Goal: ${goal}\n\nSpec:\n${specBody.slice(0, 8000)}` // guard against enormous spec bodies
+        : `Goal: ${goal}`;
+    // Attempt a single LOCAL-first model call
+    let rawOutput;
+    try {
+        const client = await getActiveClient(cfg, { allowCloud: false });
+        const result = await client.chat([
+            { role: 'system', content: PLANNING_SYSTEM },
+            { role: 'user', content: userPrompt },
+        ]);
+        rawOutput = result.content;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ashlr swarm] planner model call failed: ${msg} — using default plan\n`);
+        return defaultPlan(goal);
+    }
+    // Parse the model output
+    try {
+        const plan = parsePlan(rawOutput, goal);
+        if (plan && plan.tasks.length > 0) {
+            return plan;
+        }
+    }
+    catch (parseErr) {
+        const msg = parseErr instanceof Error ? parseErr.message : String(parseErr);
+        process.stderr.write(`[ashlr swarm] planner parse error: ${msg} — using default plan\n`);
+    }
+    // Fall back to default
+    process.stderr.write(`[ashlr swarm] planner could not extract a valid plan from model output — using default plan\n`);
+    return defaultPlan(goal);
+}
+//# sourceMappingURL=planner.js.map

package/dist/core/swarm/planner.js.map

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

package/dist/core/swarm/rollback.d.ts

@@ -0,0 +1,56 @@
+/**
+ * core/swarm/rollback.ts — M17 rollback support.
+ *
+ * snapshotProject: READ-ONLY git snapshot taken before a swarm operates.
+ *   Never throws; degrades gracefully to isRepo:false on any failure.
+ *
+ * rollbackTo: CONFIRM-GATED restore of a prior snapshot.
+ *   The CLI gates this behind an explicit `ashlr swarm rollback <id>` command
+ *   with a --yes confirm and optional --force; this function assumes that
+ *   confirmation has already happened.
+ *
+ * GUARDRAILS (top priority):
+ *  - rollbackTo is the ONLY potentially-destructive operation in M17.
+ *  - NEVER pushes to a remote, NEVER deletes branches.
+ *  - NEVER force-resets without opts.force === true.
+ *  - Refuses (ok:false) on non-repo, or dirty tree without --force.
+ *  - Never throws — all error paths return { ok: false, detail }.
+ *  - Uses execFileSync with 10 s timeout and stdio:'pipe'.
+ */
+import type { RollbackSnapshot } from '../types.js';
+/**
+ * Take a READ-ONLY snapshot of the project's git state.
+ *
+ * Contract:
+ *  - NEVER throws; degrades to { isRepo: false, ... } on any failure.
+ *  - Does NOT modify the working tree (no commit, no stash pop, no checkout).
+ *  - If the tree is dirty, creates a stash object via `git stash create`
+ *    (which writes the object to the ODB but does NOT touch HEAD or the index)
+ *    and stores the resulting object sha as `stashRef`. This ensures the dirty
+ *    tree is preserved in the ODB and can be restored later via `git stash apply`.
+ */
+export declare function snapshotProject(project: string | null): RollbackSnapshot;
+/**
+ * Restore a project to a previously snapshotted git state.
+ *
+ * Contract:
+ *  - CONFIRM-GATED by the CLI; this function assumes confirmation happened.
+ *  - NEVER pushes to a remote.
+ *  - NEVER deletes branches.
+ *  - NEVER force-resets without opts.force === true.
+ *  - Refuses (returns { ok: false, detail }) without throwing when:
+ *      • snap.isRepo is false (nothing to restore)
+ *      • the current working tree is dirty and opts.force is false
+ *      • any git operation fails
+ *  - With opts.force: uses `git reset --hard <head>` so local uncommitted
+ *    changes are discarded. Without opts.force: uses `git checkout <head>`
+ *    which refuses to overwrite a dirty tree, giving the user a safe fallback.
+ *  - After restoring HEAD, if snap.stashRef is set, attempts `git stash apply`
+ *    to re-apply the dirty tree captured at snapshot time.
+ */
+export declare function rollbackTo(snap: RollbackSnapshot, opts: {
+    force: boolean;
+}): Promise<{
+    ok: boolean;
+    detail: string;
+}>;

package/dist/core/swarm/rollback.js

@@ -0,0 +1,266 @@
+/**
+ * core/swarm/rollback.ts — M17 rollback support.
+ *
+ * snapshotProject: READ-ONLY git snapshot taken before a swarm operates.
+ *   Never throws; degrades gracefully to isRepo:false on any failure.
+ *
+ * rollbackTo: CONFIRM-GATED restore of a prior snapshot.
+ *   The CLI gates this behind an explicit `ashlr swarm rollback <id>` command
+ *   with a --yes confirm and optional --force; this function assumes that
+ *   confirmation has already happened.
+ *
+ * GUARDRAILS (top priority):
+ *  - rollbackTo is the ONLY potentially-destructive operation in M17.
+ *  - NEVER pushes to a remote, NEVER deletes branches.
+ *  - NEVER force-resets without opts.force === true.
+ *  - Refuses (ok:false) on non-repo, or dirty tree without --force.
+ *  - Never throws — all error paths return { ok: false, detail }.
+ *  - Uses execFileSync with 10 s timeout and stdio:'pipe'.
+ */
+import { execFileSync } from 'node:child_process';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+const GIT_TIMEOUT = 10_000; // ms — rollback ops may take longer than reads
+/**
+ * Run a git command inside `cwd`. Returns trimmed stdout or null on error.
+ */
+function git(cwd, args) {
+    try {
+        const out = execFileSync('git', args, {
+            cwd,
+            timeout: GIT_TIMEOUT,
+            stdio: 'pipe',
+            encoding: 'utf8',
+        });
+        return typeof out === 'string' ? out.trim() : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Returns true when `dir` is the root of a git repository (standard .git dir,
+ * worktree file, or submodule pointer).
+ *
+ * Uses rev-parse rather than filesystem inspection so detached/bare repos and
+ * git worktrees are detected correctly. Returns false on any error.
+ */
+function isGitRepo(dir) {
+    // git rev-parse --git-dir exits 0 only inside a git repo.
+    const result = git(dir, ['rev-parse', '--git-dir']);
+    return result !== null;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Take a READ-ONLY snapshot of the project's git state.
+ *
+ * Contract:
+ *  - NEVER throws; degrades to { isRepo: false, ... } on any failure.
+ *  - Does NOT modify the working tree (no commit, no stash pop, no checkout).
+ *  - If the tree is dirty, creates a stash object via `git stash create`
+ *    (which writes the object to the ODB but does NOT touch HEAD or the index)
+ *    and stores the resulting object sha as `stashRef`. This ensures the dirty
+ *    tree is preserved in the ODB and can be restored later via `git stash apply`.
+ */
+export function snapshotProject(project) {
+    const ts = new Date().toISOString();
+    const base = {
+        project,
+        isRepo: false,
+        head: null,
+        dirty: false,
+        stashRef: null,
+        ts,
+    };
+    if (!project)
+        return base;
+    try {
+        if (!isGitRepo(project))
+            return base;
+        // Resolve HEAD sha.
+        const head = git(project, ['rev-parse', 'HEAD']);
+        if (!head) {
+            // Repo exists but HEAD is unresolvable (e.g. fresh repo with no commits).
+            return { ...base, isRepo: true };
+        }
+        // Record the branch name HEAD points at (null when detached: rev-parse
+        // --abbrev-ref HEAD prints 'HEAD' in detached state). Lets a non-force
+        // rollback return to the original branch instead of leaving detached HEAD.
+        const abbrev = git(project, ['rev-parse', '--abbrev-ref', 'HEAD']);
+        const branch = abbrev && abbrev !== 'HEAD' ? abbrev : null;
+        // Determine whether the working tree is dirty (any tracked/untracked changes).
+        const porcelain = git(project, ['status', '--porcelain']);
+        const dirty = porcelain !== null && porcelain.length > 0;
+        let stashRef = null;
+        if (dirty) {
+            // `git stash create` writes a stash commit to the ODB and prints its sha,
+            // WITHOUT modifying HEAD, the index, or the working tree. Safe and
+            // non-destructive. Returns empty/null if nothing to stash.
+            const sha = git(project, ['stash', 'create', '--include-untracked']);
+            if (sha && sha.length > 0) {
+                stashRef = sha;
+                // DURABILITY: a raw `stash create` object is not referenced by any ref,
+                // so `git gc`/prune can collect it before rollback. Anchor it with a
+                // content-addressed ref so it survives GC until we apply + clean it up.
+                // Best-effort: if update-ref fails the sha is still recorded (it may
+                // simply be lost to GC after a long delay — same as before this change).
+                git(project, ['update-ref', `refs/ashlr/stash/${sha}`, sha]);
+            }
+        }
+        return {
+            project,
+            isRepo: true,
+            head,
+            branch,
+            dirty,
+            stashRef,
+            ts,
+        };
+    }
+    catch {
+        // Belt-and-suspenders: the inner git() calls never throw, but we guard the
+        // whole body so snapshot is unconditionally safe to call.
+        return base;
+    }
+}
+/**
+ * Restore a project to a previously snapshotted git state.
+ *
+ * Contract:
+ *  - CONFIRM-GATED by the CLI; this function assumes confirmation happened.
+ *  - NEVER pushes to a remote.
+ *  - NEVER deletes branches.
+ *  - NEVER force-resets without opts.force === true.
+ *  - Refuses (returns { ok: false, detail }) without throwing when:
+ *      • snap.isRepo is false (nothing to restore)
+ *      • the current working tree is dirty and opts.force is false
+ *      • any git operation fails
+ *  - With opts.force: uses `git reset --hard <head>` so local uncommitted
+ *    changes are discarded. Without opts.force: uses `git checkout <head>`
+ *    which refuses to overwrite a dirty tree, giving the user a safe fallback.
+ *  - After restoring HEAD, if snap.stashRef is set, attempts `git stash apply`
+ *    to re-apply the dirty tree captured at snapshot time.
+ */
+export async function rollbackTo(snap, opts) {
+    // --- Pre-condition: must be a git repo ---
+    if (!snap.isRepo || !snap.project) {
+        return {
+            ok: false,
+            detail: 'Rollback refused: the project is not a git repository. ' +
+                'No git state can be restored.',
+        };
+    }
+    if (!snap.head) {
+        return {
+            ok: false,
+            detail: 'Rollback refused: no HEAD sha was recorded in the snapshot ' +
+                '(the repo may have had no commits when the snapshot was taken).',
+        };
+    }
+    const project = snap.project;
+    // --- Check current dirty state ---
+    try {
+        const porcelain = git(project, ['status', '--porcelain']);
+        const nowDirty = porcelain !== null && porcelain.length > 0;
+        if (nowDirty && !opts.force) {
+            return {
+                ok: false,
+                detail: 'Rollback refused: the working tree has uncommitted changes. ' +
+                    'Pass --force to discard them and restore the snapshot, or commit/stash ' +
+                    'your work first.',
+            };
+        }
+        const restoredLines = [];
+        // --- Restore HEAD ---
+        // With --force: hard reset (discards all local changes, replaces working tree).
+        // Without --force: checkout (safe; refuses to overwrite dirty files — but we
+        //   already checked dirty above, so at this point nowDirty must be false).
+        let restoreResult;
+        let restoreMethod;
+        if (opts.force) {
+            // DESTRUCTIVE-TO-COMMITTED-WORK WARNING: `reset --hard` to an older sha
+            // silently discards any commits made AFTER the snapshot (they become
+            // unreferenced, recoverable only via reflog/GC window). Surface the count
+            // so the human approving this op sees exactly what is lost — the working
+            // tree warning alone understates the loss of committed work.
+            const aheadStr = git(project, ['rev-list', '--count', `${snap.head}..HEAD`]);
+            const ahead = aheadStr !== null ? parseInt(aheadStr, 10) : NaN;
+            if (Number.isFinite(ahead) && ahead > 0) {
+                restoredLines.push(`WARNING: this discarded ${ahead} commit(s) made since the snapshot. ` +
+                    `They are unreferenced now and recoverable only via \`git reflog\` ` +
+                    `until garbage-collected.`);
+            }
+            // ONLY force-reset when the caller explicitly passed --force.
+            restoreResult = git(project, ['reset', '--hard', snap.head]);
+            restoreMethod = `git reset --hard ${snap.head}`;
+        }
+        else {
+            // Prefer returning to the ORIGINAL BRANCH (avoids detached HEAD) when the
+            // recorded branch still resolves to the snapshot sha. Otherwise fall back
+            // to checking out the raw sha (which detaches HEAD — noted below).
+            const branchSha = snap.branch ? git(project, ['rev-parse', snap.branch]) : null;
+            if (snap.branch && branchSha === snap.head) {
+                restoreResult = git(project, ['checkout', snap.branch]);
+                restoreMethod = `git checkout ${snap.branch}`;
+            }
+            else {
+                restoreResult = git(project, ['checkout', snap.head]);
+                restoreMethod = `git checkout ${snap.head}`;
+            }
+        }
+        if (restoreResult === null) {
+            return {
+                ok: false,
+                detail: `Rollback failed: \`${restoreMethod}\` returned an error. ` +
+                    'The repository state was not modified.',
+            };
+        }
+        restoredLines.push(`Restored HEAD to ${snap.head} (via ${restoreMethod}).`);
+        // Detect a detached-HEAD result and tell the user how to reattach. This
+        // happens on the non-force path when the original branch no longer points
+        // at the snapshot sha (or none was recorded), so we checked out a raw sha.
+        const afterBranch = git(project, ['rev-parse', '--abbrev-ref', 'HEAD']);
+        if (afterBranch === 'HEAD') {
+            restoredLines.push(snap.branch
+                ? `Note: HEAD is now DETACHED (branch "${snap.branch}" has moved past the ` +
+                    `snapshot). Reattach with \`git checkout ${snap.branch}\` when ready.`
+                : `Note: HEAD is now DETACHED at ${snap.head}. ` +
+                    `Reattach to a branch with \`git checkout <branch>\` when ready.`);
+        }
+        // --- Re-apply stash if one was recorded ---
+        if (snap.stashRef) {
+            const applyResult = git(project, ['stash', 'apply', snap.stashRef]);
+            if (applyResult !== null) {
+                restoredLines.push(`Re-applied dirty-tree stash ${snap.stashRef}.`);
+                // Clean up the anchor ref we created at snapshot time (best-effort).
+                git(project, ['update-ref', '-d', `refs/ashlr/stash/${snap.stashRef}`]);
+            }
+            else {
+                // Non-fatal: stash apply failure leaves the repo at the restored HEAD
+                // which is still the correct base. Report but don't fail the rollback.
+                // Leave the anchor ref in place so the stash is not lost to GC and the
+                // user can apply it manually.
+                restoredLines.push(`Warning: could not re-apply dirty-tree stash ${snap.stashRef}. ` +
+                    `HEAD was still restored to ${snap.head}. ` +
+                    'You may need to apply the stash manually: ' +
+                    `\`git stash apply ${snap.stashRef}\``);
+            }
+        }
+        return {
+            ok: true,
+            detail: restoredLines.join('\n'),
+        };
+    }
+    catch {
+        // Belt-and-suspenders: inner calls never throw, but guard the whole body.
+        return {
+            ok: false,
+            detail: 'Rollback failed: an unexpected error occurred. ' +
+                'The repository state may be unmodified.',
+        };
+    }
+}
+//# sourceMappingURL=rollback.js.map

package/dist/core/swarm/rollback.js.map

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