specweave 2.2.3 → 3.0.0

package/dist/src/core/session/handoff-remote.js

@@ -0,0 +1,294 @@
+/**
+ * Handoff through the Git remote, so "hand off" and "pick up" work across
+ * tools, machines, accounts and cloud sessions with no pasted prompt.
+ *
+ * Hand off ({@link pushHandoff}):
+ *   1. Push the current branch when it has no upstream or is ahead of it.
+ *   2. Build a snapshot commit of the whole working tree (tracked and
+ *      untracked, minus ignored files) through a private index, on top of
+ *      HEAD, with trailers saying who handed off, from which branch and why.
+ *   3. Force-push it to `specweave-handoff` (the latest handoff) and
+ *      `wip/<branch>`. The user's index, working tree and branch are untouched.
+ *
+ * Pick up ({@link applyHandoff}): fetch `specweave-handoff`, fast-forward the
+ * current branch to the handed-off commit, and apply the uncommitted edits on
+ * top, only when the working tree is clean and the history allows it. Every
+ * other case is reported in words and changes nothing.
+ *
+ * @module core/session/handoff-remote
+ */
+import { execFileSync } from 'child_process';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+export const HANDOFF_REF = 'specweave-handoff';
+export const PICKUPS_FILE = '.specweave/state/pickups.txt';
+const NETWORK_TIMEOUT_MS = 60000;
+export function wipRefFor(branch) {
+    return `wip/${branch}`;
+}
+function gitRunner(repoRoot) {
+    const env = { ...process.env, GIT_OPTIONAL_LOCKS: '0', GIT_TERMINAL_PROMPT: '0' };
+    const git = (args, extraEnv = {}) => execFileSync('git', args, {
+        cwd: repoRoot, env: { ...env, ...extraEnv }, encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'], timeout: NETWORK_TIMEOUT_MS, maxBuffer: 64 * 1024 * 1024,
+    }).trim();
+    const tryGit = (args, extraEnv) => {
+        try {
+            return git(args, extraEnv);
+        }
+        catch {
+            return null;
+        }
+    };
+    return { git, tryGit };
+}
+/** Tree of the working tree as `git add -A` would stage it, without touching the real index. */
+function workingTreeId(git) {
+    const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'specweave-handoff-index-'));
+    try {
+        const indexPath = git(['rev-parse', '--path-format=absolute', '--git-path', 'index']);
+        const privateIndex = path.join(tmp, 'index');
+        if (fs.existsSync(indexPath)) {
+            fs.copyFileSync(indexPath, privateIndex);
+            // Keep the index's mtime: git rehashes files changed in the same second
+            // as the index was written only when it can see that second.
+            const { atime, mtime } = fs.statSync(indexPath);
+            fs.utimesSync(privateIndex, atime, mtime);
+        }
+        const withIndex = { GIT_INDEX_FILE: privateIndex };
+        git(['add', '-A', '--', '.'], withIndex);
+        return git(['write-tree'], withIndex);
+    }
+    finally {
+        try {
+            fs.rmSync(tmp, { recursive: true, force: true });
+        }
+        catch { /* best effort */ }
+    }
+}
+export function pushHandoff(repoRoot, meta, opts = {}) {
+    const remote = opts.remote ?? 'origin';
+    const warnings = [];
+    const quiet = (why) => ({ warnings: opts.explicit ? [why] : [], skipped: why });
+    const { git, tryGit } = gitRunner(repoRoot);
+    if (tryGit(['rev-parse', '--is-inside-work-tree']) !== 'true')
+        return quiet('not a git repository');
+    if (tryGit(['remote', 'get-url', remote]) === null)
+        return quiet(`no "${remote}" remote`);
+    const branch = tryGit(['symbolic-ref', '--quiet', '--short', 'HEAD']);
+    if (!branch)
+        return { warnings: ['detached HEAD; check out a branch to hand off'] };
+    const head = tryGit(['rev-parse', 'HEAD']);
+    if (!head)
+        return { warnings: ['no commits yet; commit once before handing off'] };
+    const info = { warnings };
+    // 1. The branch itself.
+    const upstream = tryGit(['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{u}']);
+    const ahead = upstream ? Number(tryGit(['rev-list', '--count', `${upstream}..HEAD`]) ?? '0') : undefined;
+    if (!upstream || (ahead ?? 0) > 0) {
+        try {
+            if (upstream) {
+                const slash = upstream.indexOf('/');
+                git(['push', upstream.slice(0, slash), `HEAD:refs/heads/${upstream.slice(slash + 1)}`]);
+            }
+            else {
+                git(['push', '-u', remote, branch]);
+            }
+            info.branch = branch;
+        }
+        catch (e) {
+            warnings.push(`branch push failed (${firstLine(e)}); push it yourself`);
+        }
+    }
+    // 2 + 3. Snapshot commit with trailers, pushed to the well-known ref.
+    try {
+        const tree = workingTreeId(git);
+        const identity = tryGit(['config', 'user.email']) ? {} : {
+            GIT_AUTHOR_NAME: 'SpecWeave handoff', GIT_AUTHOR_EMAIL: 'handoff@specweave.local',
+            GIT_COMMITTER_NAME: 'SpecWeave handoff', GIT_COMMITTER_EMAIL: 'handoff@specweave.local',
+        };
+        const message = [
+            `SpecWeave handoff from ${meta.by}`,
+            '',
+            `Handoff-Branch: ${branch}`,
+            `Handoff-By: ${meta.by}`,
+            `Handoff-At: ${meta.at}`,
+            ...(meta.increment ? [`Handoff-Increment: ${meta.increment}`] : []),
+            ...(meta.reason ? [`Handoff-Reason: ${oneLine(meta.reason)}`] : []),
+        ].join('\n');
+        const commit = git(['commit-tree', '--no-gpg-sign', tree, '-p', head, '-m', message], identity);
+        const wip = wipRefFor(branch);
+        git(['push', '--force', remote, `${commit}:refs/heads/${HANDOFF_REF}`, `${commit}:refs/heads/${wip}`]);
+        info.handoffRef = HANDOFF_REF;
+        info.snapshot = commit;
+        // This checkout already has the work; its own pickup must not re-apply it.
+        rememberPickup(repoRoot, commit);
+        if (tree !== git(['rev-parse', 'HEAD^{tree}']))
+            info.wipRef = wip;
+    }
+    catch (e) {
+        warnings.push(`handoff snapshot push failed (${firstLine(e)}); the handoff doc and diff are still local`);
+    }
+    return info;
+}
+/** Read the `Handoff-*` trailers of a snapshot commit. */
+export function readHandoffMeta(message) {
+    const field = (name) => message.match(new RegExp(`^Handoff-${name}: (.+)$`, 'm'))?.[1]?.trim();
+    return { branch: field('Branch'), by: field('By'), at: field('At'), increment: field('Increment'), reason: field('Reason') };
+}
+export function applyHandoff(repoRoot, opts = {}) {
+    const remote = opts.remote ?? 'origin';
+    const { git, tryGit } = gitRunner(repoRoot);
+    const none = { status: 'none', message: '' };
+    if (tryGit(['rev-parse', '--is-inside-work-tree']) !== 'true')
+        return none;
+    if (tryGit(['remote', 'get-url', remote]) === null)
+        return none;
+    const tracking = `refs/remotes/${remote}/${HANDOFF_REF}`;
+    // A fetch failure (offline, no such ref) falls back to what was fetched before.
+    tryGit(['fetch', '--quiet', '--no-tags', remote, `+refs/heads/${HANDOFF_REF}:${tracking}`]);
+    const snapshot = tryGit(['rev-parse', '--verify', '--quiet', `${tracking}^{commit}`]);
+    if (!snapshot)
+        return none;
+    const meta = readHandoffMeta(git(['log', '-1', '--format=%B', snapshot]));
+    const who = `${meta.by ?? 'someone'}${meta.at ? ` ${ago(meta.at)}` : ''}${meta.reason ? ` (${meta.reason})` : ''}`;
+    const base = { snapshot, meta };
+    if (pickedUp(repoRoot).includes(snapshot))
+        return { ...base, status: 'already', message: '' };
+    const remember = () => { if (!opts.dryRun)
+        rememberPickup(repoRoot, snapshot); };
+    const parent = git(['rev-parse', `${snapshot}^`]);
+    const snapTree = git(['rev-parse', `${snapshot}^{tree}`]);
+    if (workingTreeId(git) === snapTree) {
+        remember();
+        return { ...base, status: 'here', message: `The last handoff, from ${who}, is already this checkout.` };
+    }
+    let dirty = git(['status', '--porcelain']);
+    if (dirty && !opts.dryRun) {
+        // Edits that are exactly a handoff made or picked up here are already in
+        // the new handoff's history: set them aside (stashed, never deleted).
+        const here = workingTreeId(git);
+        const known = pickedUp(repoRoot).some((sha) => tryGit(['rev-parse', `${sha}^{tree}`]) === here);
+        if (known && tryGit(['stash', 'push', '--include-untracked', '-m', `specweave pickup: edits already handed off (${snapshot.slice(0, 7)})`]) !== null) {
+            dirty = git(['status', '--porcelain']);
+        }
+    }
+    if (dirty) {
+        return {
+            ...base, status: 'dirty',
+            message: `A handoff from ${who} is waiting, but this checkout has uncommitted changes, so nothing was applied. Commit or stash them, then run \`specweave pickup\` again.`,
+        };
+    }
+    const switchedTo = opts.dryRun ? undefined : switchToHandedOffBranch(tryGit, remote, meta.branch, parent);
+    const head = tryGit(['rev-parse', 'HEAD']);
+    const isAncestor = (a, b) => tryGit(['merge-base', '--is-ancestor', a, b]) !== null;
+    let fastForwarded = 0;
+    if (head !== parent) {
+        if (!head || isAncestor(head, parent)) {
+            fastForwarded = head ? Number(git(['rev-list', '--count', `${head}..${parent}`])) : Number(git(['rev-list', '--count', parent]));
+            if (!opts.dryRun) {
+                try {
+                    git(head ? ['merge', '--ff-only', '--quiet', parent] : ['reset', '--hard', '--quiet', parent]);
+                }
+                catch (e) {
+                    return { ...base, status: 'failed', message: `Could not fast-forward to the handoff (${firstLine(e)}).` };
+                }
+            }
+        }
+        else if (!isAncestor(parent, head)) {
+            return {
+                ...base, status: 'diverged',
+                message: `A handoff from ${who} is on branch ${meta.branch ?? '(unknown)'}, which has diverged from this branch. Merge it first (\`git merge ${remote}/${meta.branch ?? HANDOFF_REF}\`), then run \`specweave pickup\` again.`,
+            };
+        }
+    }
+    let editedFiles = 0;
+    const parentTree = git(['rev-parse', `${parent}^{tree}`]);
+    if (snapTree !== parentTree) {
+        editedFiles = git(['diff', '--name-only', parent, snapshot]).split('\n').filter(Boolean).length;
+        if (!opts.dryRun) {
+            try {
+                git(['cherry-pick', '--no-commit', snapshot]);
+                // Leave the edits unstaged, the way the previous session had them.
+                git(['reset', '--quiet']);
+            }
+            catch (e) {
+                tryGit(['cherry-pick', '--abort']);
+                return { ...base, status: 'failed', fastForwarded, message: `Could not apply the handed-off edits (${firstLine(e)}).` };
+            }
+        }
+    }
+    remember();
+    const parts = [
+        switchedTo ? `switched to branch ${switchedTo}` : '',
+        fastForwarded ? `moved this branch forward ${fastForwarded} commit${fastForwarded === 1 ? '' : 's'}` : '',
+        editedFiles ? `applied ${editedFiles} uncommitted file${editedFiles === 1 ? '' : 's'}` : '',
+    ].filter(Boolean);
+    return {
+        ...base, status: 'applied', ...(switchedTo ? { switchedTo } : {}), fastForwarded, editedFiles,
+        message: `Picked up the handoff from ${who}${parts.length ? `: ${parts.join(', ')}` : ''}.`,
+    };
+}
+/**
+ * A checkout on the repository's default branch (or on no commit yet) picks
+ * up on the handed-off branch instead of moving the default branch to it.
+ * Any other branch, such as a cloud thread's own, carries on as it is.
+ */
+function switchToHandedOffBranch(tryGit, remote, branch, parent) {
+    const current = tryGit(['symbolic-ref', '--quiet', '--short', 'HEAD']);
+    if (!branch || !current || current === branch)
+        return undefined;
+    if (tryGit(['check-ref-format', '--branch', branch]) === null)
+        return undefined;
+    const unborn = tryGit(['rev-parse', '--verify', '--quiet', 'HEAD']) === null;
+    const remoteHead = tryGit(['symbolic-ref', '--quiet', '--short', `refs/remotes/${remote}/HEAD`]);
+    const defaults = remoteHead ? [remoteHead.slice(remote.length + 1)] : ['main', 'master'];
+    if (!unborn && !defaults.includes(current))
+        return undefined;
+    if (tryGit(['rev-parse', '--verify', '--quiet', `refs/heads/${branch}`]) !== null) {
+        return tryGit(['switch', '--quiet', branch]) !== null ? branch : undefined;
+    }
+    tryGit(['fetch', '--quiet', '--no-tags', remote, `+refs/heads/${branch}:refs/remotes/${remote}/${branch}`]);
+    const upstream = `${remote}/${branch}`;
+    const start = tryGit(['rev-parse', '--verify', '--quiet', `refs/remotes/${upstream}`]) !== null
+        ? ['switch', '--quiet', '--create', branch, '--track', upstream]
+        : ['switch', '--quiet', '--create', branch, parent];
+    return tryGit(start) !== null ? branch : undefined;
+}
+function pickedUp(repoRoot) {
+    try {
+        return fs.readFileSync(path.join(repoRoot, PICKUPS_FILE), 'utf8').split('\n').filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/** Mark a snapshot as present in this checkout (made here or already applied). */
+export function rememberPickup(repoRoot, snapshot) {
+    try {
+        const file = path.join(repoRoot, PICKUPS_FILE);
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        fs.appendFileSync(file, snapshot + '\n');
+    }
+    catch { /* best effort */ }
+}
+function oneLine(s) {
+    return s.replace(/\s+/g, ' ').trim().slice(0, 200);
+}
+function ago(iso) {
+    const t = Date.parse(iso);
+    if (Number.isNaN(t))
+        return '';
+    const min = Math.max(0, Math.round((Date.now() - t) / 60000));
+    if (min < 60)
+        return `${min}m ago`;
+    const h = Math.round(min / 60);
+    return h < 48 ? `${h}h ago` : `${Math.round(h / 24)}d ago`;
+}
+function firstLine(e) {
+    const err = e;
+    const text = (err.stderr ? String(err.stderr) : '') || err.message || String(e);
+    return text.split('\n').map((l) => l.trim()).find(Boolean)?.slice(0, 160) ?? 'unknown error';
+}
+//# sourceMappingURL=handoff-remote.js.map

package/dist/src/core/session/handoff-remote.js.map

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

package/dist/src/core/session/handoff-report.d.ts

@@ -0,0 +1,24 @@
+/**
+ * HTML handoff report: one self-contained page that shows how an increment
+ * moved between tools, accounts and sessions, straight from its ledger.
+ *
+ * Every row comes from `ledger.jsonl` (claims, done with evidence, handoffs,
+ * pickups, sessions, notes), so the page is evidence, not a summary someone
+ * wrote. No scripts, no external assets.
+ *
+ * @module core/session/handoff-report
+ */
+export declare const REPORT_FILE = "handoff-report.html";
+export interface HandoffReport {
+    html: string;
+    /** Distinct `<tool>@<host>` agents in the ledger, in order of first appearance. */
+    agents: string[];
+    handoffs: number;
+    pickups: number;
+}
+export declare function buildHandoffReport(incDir: string, incrementId: string, now?: Date): HandoffReport;
+export declare function writeHandoffReport(incDir: string, incrementId: string, out?: string): {
+    path: string;
+    report: HandoffReport;
+};
+//# sourceMappingURL=handoff-report.d.ts.map

package/dist/src/core/session/handoff-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-report.d.ts","sourceRoot":"","sources":["../../../../src/core/session/handoff-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,eAAO,MAAM,WAAW,wBAAwB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,aAAa,CA2FvG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAM7H"}

package/dist/src/core/session/handoff-report.js

@@ -0,0 +1,147 @@
+/**
+ * HTML handoff report: one self-contained page that shows how an increment
+ * moved between tools, accounts and sessions, straight from its ledger.
+ *
+ * Every row comes from `ledger.jsonl` (claims, done with evidence, handoffs,
+ * pickups, sessions, notes), so the page is evidence, not a summary someone
+ * wrote. No scripts, no external assets.
+ *
+ * @module core/session/handoff-report
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { ledgerPath, readLedger } from '../tasks/ledger.js';
+import { loadTaskBoard } from '../tasks/task-board.js';
+import { hasTasksFile } from '../tasks/tasks-source.js';
+import { readSpecAcs, deriveAcStatus } from '../tasks/verify-runner.js';
+import { readTitle } from './pickup.js';
+export const REPORT_FILE = 'handoff-report.html';
+export function buildHandoffReport(incDir, incrementId, now = new Date()) {
+    const { events } = readLedger(ledgerPath(incDir));
+    const sorted = [...events].sort((a, b) => Date.parse(a.at) - Date.parse(b.at));
+    const board = hasTasksFile(incDir) ? safe(() => loadTaskBoard(incDir)) : undefined;
+    const acs = board ? deriveAcStatus(readSpecAcs(incDir), board) : readSpecAcs(incDir);
+    const title = readTitle(incDir) || incrementId;
+    const status = safe(() => JSON.parse(fs.readFileSync(path.join(incDir, 'metadata.json'), 'utf8')).status) ?? 'unknown';
+    const agents = [];
+    for (const e of sorted)
+        if (!agents.includes(e.by))
+            agents.push(e.by);
+    const tools = [...new Set(agents.map((a) => a.split('@')[0]))];
+    const handoffs = sorted.filter((e) => e.e === 'handoff').length;
+    const pickups = sorted.filter((e) => e.e === 'pickup').length;
+    const sessions = new Set(sorted.filter((e) => e.e === 'session').map((e) => e.note)).size;
+    const counts = board?.counts;
+    const metAcs = acs.filter((a) => a.done).length;
+    const stat = (value, label) => `<div class="stat"><div class="v">${esc(String(value))}</div><div class="l">${esc(label)}</div></div>`;
+    const timeline = sorted.map((e) => {
+        const kind = e.e === 'handoff' || e.e === 'pickup' ? ' class="hand"' : '';
+        const detail = e.evidence ? firstLines(e.evidence, 3) : e.note ?? '';
+        return `<tr${kind}><td class="t">${esc(fmt(e.at))}</td><td><span class="who ${toolClass(e.by)}">${esc(e.by)}</span></td>` +
+            `<td>${esc(label(e))}</td><td>${e.t === '*' ? '' : esc(e.t)}</td><td class="d">${esc(detail)}</td></tr>`;
+    }).join('\n');
+    const taskRows = (board?.tasks ?? []).map((t) => `<tr><td>${esc(t.id)}</td><td>${esc(t.title)}</td><td><span class="st ${esc(t.state.status)}">${esc(t.state.status)}</span></td>` +
+        `<td>${t.state.by ? `<span class="who ${toolClass(t.state.by)}">${esc(t.state.by)}</span>` : ''}</td></tr>`).join('\n');
+    const acRows = acs.map((a) => `<li class="${a.done ? 'met' : ''}"><b>${esc(a.id)}</b> ${esc(a.text)}${a.done && a.via === 'ledger' ? ' <small>(met by its tasks)</small>' : ''}</li>`).join('\n');
+    const html = `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Handoff report: ${esc(title)}</title>
+<style>
+:root{--bg:#fbfaf7;--fg:#1c1b19;--mut:#6b6760;--line:#e4e0d8;--card:#fff;--acc:#2f6f5e;--hand:#fff6e0;--claude:#b8612f;--codex:#2f5f9e;--grok:#6a4bb0;--muse:#0f7c86;--gemini:#9a6a00;--other:#555}
+@media (prefers-color-scheme:dark){:root{--bg:#161614;--fg:#ece9e2;--mut:#a29d93;--line:#2e2c28;--card:#1e1d1a;--acc:#6fc2a8;--hand:#3a3120}}
+*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--fg);font:15px/1.5 system-ui,-apple-system,Segoe UI,sans-serif}
+main{max-width:1000px;margin:0 auto;padding:32px 16px}h1{font-size:26px;margin:0 0 4px}h2{font-size:17px;margin:32px 0 10px}
+.sub{color:var(--mut);margin:0 0 24px}.stats{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:10px}
+.stat{background:var(--card);border:1px solid var(--line);border-radius:10px;padding:12px 14px}.stat .v{font-size:22px;font-weight:650}.stat .l{color:var(--mut);font-size:13px}
+.wrap{overflow-x:auto;border:1px solid var(--line);border-radius:10px;background:var(--card)}
+table{border-collapse:collapse;width:100%;font-size:14px}th,td{text-align:left;padding:8px 10px;border-bottom:1px solid var(--line);vertical-align:top}
+th{color:var(--mut);font-weight:600}tr:last-child td{border-bottom:0}tr.hand td{background:var(--hand)}
+td.t{white-space:nowrap;color:var(--mut)}td.d{white-space:pre-wrap;font-family:ui-monospace,Menlo,monospace;font-size:12.5px;max-width:420px}
+.who{font-family:ui-monospace,Menlo,monospace;font-size:12.5px;padding:1px 6px;border-radius:6px;border:1px solid currentColor;white-space:nowrap}
+.claude{color:var(--claude)}.codex{color:var(--codex)}.grok{color:var(--grok)}.muse{color:var(--muse)}.gemini{color:var(--gemini)}.other{color:var(--other)}
+.st{font-size:12.5px;padding:1px 6px;border-radius:6px;background:var(--line)}.st.done{background:var(--acc);color:var(--bg)}
+ul.acs{padding-left:18px}ul.acs li.met{color:var(--acc)}ul.acs li.met::marker{content:"✓ "}footer{color:var(--mut);font-size:13px;margin-top:32px}
+</style>
+</head>
+<body>
+<main>
+<h1>${esc(title)}</h1>
+<p class="sub">Increment ${esc(incrementId)} · ${esc(status)} · report generated ${esc(fmt(now.toISOString()))} from <code>ledger.jsonl</code></p>
+<div class="stats">
+${stat(counts ? `${counts.done + counts.skipped}/${counts.total}` : '-', 'tasks done')}
+${stat(acs.length ? `${metAcs}/${acs.length}` : '-', 'acceptance criteria met')}
+${stat(handoffs, handoffs === 1 ? 'handoff' : 'handoffs')}
+${stat(pickups, pickups === 1 ? 'pickup' : 'pickups')}
+${stat(tools.join(', ') || '-', 'tools')}
+${stat(sessions || agents.length, sessions ? 'recorded sessions' : 'agents')}
+</div>
+<h2>Timeline</h2>
+<div class="wrap"><table>
+<thead><tr><th>When (UTC)</th><th>Who</th><th>What</th><th>Task</th><th>Evidence or note</th></tr></thead>
+<tbody>
+${timeline || '<tr><td colspan="5">No ledger events yet.</td></tr>'}
+</tbody></table></div>
+<h2>Tasks</h2>
+<div class="wrap"><table>
+<thead><tr><th>Task</th><th>Title</th><th>State</th><th>By</th></tr></thead>
+<tbody>
+${taskRows || '<tr><td colspan="4">No tasks.</td></tr>'}
+</tbody></table></div>
+<h2>Acceptance criteria</h2>
+<ul class="acs">
+${acRows || '<li>None listed in spec.md.</li>'}
+</ul>
+<footer>Agents: ${agents.map((a) => esc(a)).join(', ') || 'none'}. Handoff and pickup rows are highlighted. Generated by <code>specweave report</code>.</footer>
+</main>
+</body>
+</html>
+`;
+    return { html, agents, handoffs, pickups };
+}
+export function writeHandoffReport(incDir, incrementId, out) {
+    const report = buildHandoffReport(incDir, incrementId);
+    const file = out ?? path.join(incDir, 'reports', REPORT_FILE);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, report.html, 'utf8');
+    return { path: file, report };
+}
+function label(e) {
+    switch (e.e) {
+        case 'claim': return 'claimed';
+        case 'done': return 'finished';
+        case 'release': return 'released';
+        case 'block': return 'blocked';
+        case 'skip': return 'skipped';
+        case 'note': return 'left a note';
+        case 'session': return 'started a session';
+        case 'handoff': return 'handed off';
+        case 'pickup': return 'picked up';
+    }
+}
+function toolClass(agent) {
+    const tool = agent.split('@')[0];
+    return ['claude', 'codex', 'grok', 'muse', 'gemini'].includes(tool) ? tool : 'other';
+}
+function fmt(iso) {
+    const d = new Date(iso);
+    return Number.isNaN(d.getTime()) ? iso : d.toISOString().replace('T', ' ').slice(0, 16);
+}
+function firstLines(s, n) {
+    const lines = s.split('\n');
+    return lines.slice(0, n).join('\n') + (lines.length > n ? '\n…' : '');
+}
+function esc(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function safe(fn) {
+    try {
+        return fn();
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=handoff-report.js.map

package/dist/src/core/session/handoff-report.js.map

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

package/dist/src/core/session/pickup.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Pickup: everything a fresh session needs to continue, in one read.
+ *
+ * `specweave pickup` prints the full form (the next task with its acceptance
+ * criteria, claims held by others, branch and upstream state, the last
+ * handoff, recent notes and the memory index). The SessionStart hook prints
+ * the compact form, which skips Git so the hook stays fast.
+ *
+ * Read-only: nothing here writes the ledger or any file. A session is recorded
+ * when it claims a task, not when it looks.
+ *
+ * @module core/session/pickup
+ */
+export declare const MEMORY_INDEX_PATH = ".specweave/memory/MEMORY.md";
+export interface PickupOptions {
+    /** Increment to focus on; default: the single active (or planned) one. */
+    incrementId?: string;
+    /** Compact form for the SessionStart hook: no Git, no per-task detail. */
+    compact?: boolean;
+    /** Override the agent id (tests). */
+    agent?: string;
+    /** Explicit increment ids in priority order (the hook's active-increment state). */
+    activeIds?: string[];
+}
+export interface PickupResult {
+    text: string;
+    /** Increment the full form focused on, if any. */
+    incrementId?: string;
+}
+/** Build the pickup text. Returns empty text when there is nothing to say. */
+export declare function buildPickup(projectRoot: string, opts?: PickupOptions): PickupResult;
+/** Title: metadata.title → spec.md frontmatter `title:` → first `# ` heading. */
+export declare function readTitle(incDir: string): string;
+//# sourceMappingURL=pickup.d.ts.map

package/dist/src/core/session/pickup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickup.d.ts","sourceRoot":"","sources":["../../../../src/core/session/pickup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,eAAO,MAAM,iBAAiB,gCAAgC,CAAC;AAM/D,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,CAgDvF;AAiFD,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQhD"}