specweave 2.3.0 → 3.0.1

package/dist/src/core/session/handoff-doc-format.js

@@ -11,6 +11,7 @@
  *
  * @module core/session/handoff-doc-format
  */
+import * as path from 'path';
 /** Footer marker (ownership sentinel + format version handle). */
 export const DOC_FORMAT_MARKER = 'Doc format v2';
 /** Prior marker — still recognized as "ours" so v1 docs are overwritten, not treated as foreign. */
@@ -29,37 +30,62 @@ export const CLAUDE_MUNGE_EXAMPLE = '/Users/antonabyzov/Projects/github/specweav
     '→ -Users-antonabyzov-Projects-github-specweave-umb--claude-worktrees-x';
 export const TOOL_RESUME_MATRIX = [
     {
+        id: 'claude',
         tool: 'Claude Code',
         findSession: 'ls ~/.claude/projects/<munged-cwd>/ (munge: every non-alphanumeric char → "-", runs NOT collapsed; e.g. ' +
             CLAUDE_MUNGE_EXAMPLE + ')',
         resumeCmd: 'claude -r <uuid>',
     },
     {
+        id: 'codex',
         tool: 'Codex',
         findSession: 'ls ~/.codex/sessions/ (newest dir = most recent session)',
         resumeCmd: 'codex resume <uuid>   (or: codex resume --last)',
     },
     {
+        id: 'opencode',
         tool: 'OpenCode',
         findSession: 'opencode sessions list',
         resumeCmd: 'opencode -s <id>   (long form: opencode --session <id>)',
     },
     {
+        id: 'gemini',
         tool: 'Gemini CLI',
         findSession: 'run /chat list inside the Gemini session to see saved tags',
         resumeCmd: '/chat resume <tag>',
     },
     {
+        id: 'antigravity',
         tool: 'Antigravity',
         findSession: 'open the Antigravity Agent Manager and pick the prior task thread',
         resumeCmd: 'resume the thread from the Antigravity Agent Manager',
     },
     {
+        id: 'aider',
         tool: 'Aider',
         findSession: 'aider keeps .aider.chat.history.md in the repo root',
         resumeCmd: 'aider --restore-chat-history',
     },
+    {
+        id: 'grok',
+        tool: 'Grok Build',
+        findSession: 'ls ~/.grok/sessions/<encoded-cwd>/ (or pick one on the grok welcome screen)',
+        resumeCmd: 'grok --resume <id>   (or: grok --resume for the latest here)',
+    },
+    {
+        id: 'muse',
+        tool: 'Muse Code',
+        findSession: 'run muse resume to pick from recent sessions',
+        resumeCmd: 'muse resume   (headless: muse exec --session-id <uuid>)',
+    },
 ];
+/** In-repo paths print relative to the repo; paths outside it stay absolute. */
+export function repoRelative(repoRoot, p) {
+    const relative = path.relative(repoRoot, p);
+    if (!relative || relative.startsWith('..') || path.isAbsolute(relative))
+        return p;
+    return relative.split(path.sep).join('/');
+}
 const MAX_TASK_ROWS = 25;
 const MAX_DECISIONS = 8;
 function totalRedactions(counts) {
@@ -82,7 +108,9 @@ export function renderHandoffDoc(input) {
         : 'not a git repo';
     L.push(`agent: ${input.agent} · ${input.generatedAt} · ${gitBit} · redactions: ${totalRedactions(input.redactionCounts)}`);
     const claims = (inc?.tasks ?? []).filter((t) => t.status === 'claimed' || t.status === 'blocked' || t.status === 'stale');
-    L.push(`active claims: ${claims.length ? claims.map((t) => `${t.id} (${t.status} by ${t.by})`).join(', ') : 'none'}`);
+    L.push(`active claims: ${claims.length ? claims.map((t) => `${t.id} (${t.status} by ${t.by})`).join(', ') : 'none'}${input.released?.length ? ` · released: ${input.released.join(', ')}` : ''}`);
+    if (input.push?.warnings.length)
+        L.push(`push: ${input.push.warnings.join('; ')}`);
     L.push('');
     // ── Where I left off ──────────────────────────────────────────────────
     L.push('## Where I left off');
@@ -135,7 +163,9 @@ export function renderHandoffDoc(input) {
         L.push('```');
         L.push(input.git.statusPorcelain || '(no porcelain output)');
         L.push('```');
-        L.push(`Full diff: \`${input.diffPath}\``);
+        L.push(`Full diff: \`${repoRelative(input.repoRoot, input.diffPath)}\``);
+        if (input.push?.wipRef)
+            L.push(`Also pushed to \`${input.push.wipRef}\`; \`specweave pickup\` applies it.`);
     }
     else if (input.git.isGitRepo) {
         L.push('Working tree clean.');
@@ -161,9 +191,11 @@ export function renderHandoffDoc(input) {
     L.push('');
     // ── Resume ────────────────────────────────────────────────────────────
     L.push('## Resume');
-    L.push(`1. Read this file; if the path does not exist on your machine, ask for it to be pasted.`);
-    L.push(`2. \`specweave task next${inc ? ` ${inc.id}` : ''}\` → claim → implement → \`task done --run\`.`);
-    L.push(`3. Original transcript (optional): ${TOOL_RESUME_MATRIX.slice(0, 3).map((e) => `${e.tool}: \`${e.resumeCmd.split('   ')[0]}\``).join(' · ')}.`);
+    L.push('1. `specweave pickup` prints the next task with its acceptance criteria, claims and branch state.');
+    L.push(`2. \`specweave task claim <T-id>${inc ? ` ${inc.id}` : ''}\` → implement → \`specweave task done <T-id> --run "<test>"\`.`);
+    const own = TOOL_RESUME_MATRIX.find((e) => e.id === input.agent.split('@')[0]);
+    const transcripts = own ? [own] : TOOL_RESUME_MATRIX.slice(0, 3);
+    L.push(`3. Original transcript (optional): ${transcripts.map((e) => `${e.tool}: \`${e.resumeCmd.split('   ')[0]}\``).join(' · ')}.`);
     L.push('');
     L.push('---');
     L.push(`<!-- ${DOC_FORMAT_MARKER} -->`);
@@ -184,13 +216,18 @@ export function renderPastePrompt(input, opts = {}) {
         P.push(renderHandoffDoc(input));
         P.push(INLINE_END_MARKER);
     }
+    else if (input.push?.handoffRef) {
+        // Pushed: the other side needs two words, not a prompt.
+        P.push('Pick up my handed-off work: run `specweave pickup` and continue with the task it names.');
+    }
     else {
-        P.push(`Resume my work. Read the handoff doc at: ${input.docPath}`);
-        P.push('If that path does NOT exist on this machine, STOP and ask me to paste the handoff — do not improvise context.');
-        P.push(`The exact uncommitted edits are in: ${input.diffPath}`);
-        if (input.increment) {
-            P.push(`Active increment: ${input.increment.id}. Run \`specweave task next ${input.increment.id}\` and claim before editing.`);
-        }
+        // Repo-relative paths: the next tool may run in another checkout, where
+        // an absolute path means nothing.
+        const doc = repoRelative(input.repoRoot, input.docPath);
+        P.push('Pick up my handed-off work: run `specweave pickup` and continue with the task it names.');
+        P.push(`The handoff doc is ${doc}. If it is not in your checkout, STOP and ask me to paste it; do not improvise context.`);
+        if (input.git.hasUncommittedChanges)
+            P.push(`The uncommitted edits are in ${repoRelative(input.repoRoot, input.diffPath)}.`);
     }
     return P.join('\n');
 }

package/dist/src/core/session/handoff-doc-format.js.map

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

package/dist/src/core/session/handoff-git-state.d.ts

@@ -30,7 +30,18 @@ export interface GitState {
     diffStat: string;
     /** True when there are working-tree or staged changes. */
     hasUncommittedChanges: boolean;
+    /** Upstream branch (`origin/feature`), empty when none is configured. */
+    upstream?: string;
+    /** Commits on HEAD not yet on the upstream (undefined without an upstream). */
+    ahead?: number;
 }
+/**
+ * SpecWeave's own bookkeeping, excluded from the handoff diff and the "files
+ * touched" list: the next agent reads it through `specweave pickup`, and in a
+ * measured handoff it was 97% of the diff. spec.md and plan.md stay in, since
+ * edits to them are real work.
+ */
+export declare const BOOKKEEPING_PATHSPECS: readonly string[];
 /** Total Git budget leaves headroom below PreCompact's five-second budget. */
 export declare const GIT_CAPTURE_BUDGET_MS = 3500;
 /** Capture through a private index; an interrupted hook never stages user files. */

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

@@ -1 +1 @@
-{"version":3,"file":"handoff-git-state.d.ts","sourceRoot":"","sources":["../../../../src/core/session/handoff-git-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,QAAQ,CAyDlF"}
+{"version":3,"file":"handoff-git-state.d.ts","sourceRoot":"","sources":["../../../../src/core/session/handoff-git-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EASlD,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,QAAQ,CA8DlF"}

package/dist/src/core/session/handoff-git-state.js

@@ -18,6 +18,22 @@ import { execFileSync } from 'child_process';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
+/**
+ * SpecWeave's own bookkeeping, excluded from the handoff diff and the "files
+ * touched" list: the next agent reads it through `specweave pickup`, and in a
+ * measured handoff it was 97% of the diff. spec.md and plan.md stay in, since
+ * edits to them are real work.
+ */
+export const BOOKKEEPING_PATHSPECS = [
+    ':(exclude,glob).specweave/increments/*/ledger.jsonl',
+    ':(exclude,glob).specweave/increments/*/metadata.json',
+    ':(exclude,glob).specweave/increments/*/reports/**',
+    ':(exclude,glob).specweave/increments/*/handoff.md',
+    ':(exclude,glob).specweave/increments/*/handoff.diff',
+    ':(exclude,glob).specweave/intents/**',
+    ':(exclude,glob).specweave/state/**',
+    ':(exclude,glob).specweave/logs/**',
+];
 /** Total Git budget leaves headroom below PreCompact's five-second budget. */
 export const GIT_CAPTURE_BUDGET_MS = 3500;
 /** Capture through a private index; an interrupted hook never stages user files. */
@@ -61,7 +77,8 @@ export function captureGitState(repoRoot, diffOutputPath) {
         Object.assign(env, { GIT_INDEX_FILE: privateIndex });
         const branch = git(['rev-parse', '--abbrev-ref', 'HEAD']) ?? '';
         const shortSha = git(['rev-parse', '--short', 'HEAD']) ?? '';
-        const statusPorcelain = git(['status', '--porcelain']) ?? '';
+        const scope = ['--', '.', ...BOOKKEEPING_PATHSPECS];
+        const statusPorcelain = git(['status', '--porcelain', ...scope]) ?? '';
         // NUL-delimited paths handle spaces, quotes, Unicode and embedded newlines.
         const untracked = (git(['ls-files', '--others', '--exclude-standard', '-z'], false) ?? '')
             .split('\0').filter(Boolean);
@@ -70,15 +87,19 @@ export function captureGitState(repoRoot, diffOutputPath) {
         const hasHead = shortSha !== '';
         const working = ['diff', '--no-ext-diff', '--no-textconv', ...(hasHead ? ['HEAD'] : [])];
         const staged = ['diff', '--no-ext-diff', '--no-textconv', '--cached'];
-        const workingDiff = git(working) ?? '';
-        const stagedDiff = (hasHead ? git(staged) : '') ?? '';
-        const workingStat = git([...working, '--stat']) ?? '';
-        const stagedStat = (hasHead ? git([...staged, '--stat']) : '') ?? '';
+        const workingDiff = git([...working, ...scope]) ?? '';
+        const stagedDiff = (hasHead ? git([...staged, ...scope]) : '') ?? '';
+        const workingStat = git([...working, '--stat', ...scope]) ?? '';
+        const stagedStat = (hasHead ? git([...staged, '--stat', ...scope]) : '') ?? '';
         safeWriteDiff(diffOutputPath, [workingDiff, stagedDiff].filter(Boolean).join('\n'));
+        const upstream = git(['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{u}']) ?? '';
+        const aheadRaw = upstream ? git(['rev-list', '--count', `${upstream}..HEAD`]) : null;
         return {
             isGitRepo: true, branch, shortSha, statusPorcelain,
             diffStat: [workingStat, stagedStat].filter(Boolean).join('\n'),
             hasUncommittedChanges: statusPorcelain.length > 0,
+            upstream,
+            ahead: aheadRaw !== null && aheadRaw !== '' ? Number(aheadRaw) : undefined,
         };
     }
     catch {

package/dist/src/core/session/handoff-git-state.js.map

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

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

@@ -0,0 +1,63 @@
+/**
+ * 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 type { HandoffPushInfo } from './handoff-doc-format.js';
+export declare const HANDOFF_REF = "specweave-handoff";
+export declare const PICKUPS_FILE = ".specweave/state/pickups.txt";
+export declare function wipRefFor(branch: string): string;
+export interface HandoffMeta {
+    by: string;
+    at: string;
+    increment?: string;
+    reason?: string;
+}
+export interface PushOptions {
+    remote?: string;
+    /** The user asked for the push; report every reason it could not happen. */
+    explicit?: boolean;
+}
+export declare function pushHandoff(repoRoot: string, meta: HandoffMeta, opts?: PushOptions): HandoffPushInfo;
+export interface PickupApplyResult {
+    status: 'none' | 'applied' | 'here' | 'already' | 'dirty' | 'diverged' | 'failed';
+    /** Plain-language summary for the user (empty for `none`). */
+    message: string;
+    snapshot?: string;
+    meta?: Partial<HandoffMeta> & {
+        branch?: string;
+    };
+    /** Branch pickup switched to from the repository's default branch. */
+    switchedTo?: string;
+    /** Commits the current branch moved forward by. */
+    fastForwarded?: number;
+    /** Files changed by the applied uncommitted edits. */
+    editedFiles?: number;
+}
+/** Read the `Handoff-*` trailers of a snapshot commit. */
+export declare function readHandoffMeta(message: string): Partial<HandoffMeta> & {
+    branch?: string;
+};
+export interface ApplyOptions {
+    remote?: string;
+    /** Only report what would happen. */
+    dryRun?: boolean;
+}
+export declare function applyHandoff(repoRoot: string, opts?: ApplyOptions): PickupApplyResult;
+/** Mark a snapshot as present in this checkout (made here or already applied). */
+export declare function rememberPickup(repoRoot: string, snapshot: string): void;
+//# sourceMappingURL=handoff-remote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-remote.d.ts","sourceRoot":"","sources":["../../../../src/core/session/handoff-remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAC/C,eAAO,MAAM,YAAY,iCAAiC,CAAC;AAI3D,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhD;AAsCD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,WAAgB,GAAG,eAAe,CA4DxG;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IAClF,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAG3F;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,iBAAiB,CA0FzF;AA+BD,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMvE"}

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