@specship/specship 0.11.0

package/dist/statusline/render.js.map

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

package/dist/statusline/session-marker.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Tier-B session marker (REQ-STATUSLINE-004).
+ *
+ * Scoped to one MCP-server process lifetime: Claude Code spawns one MCP
+ * server per session, so "calls since this server initialized the marker" is
+ * the session's specship-call count. `initSession` resets it once at server
+ * start; `recordCall` increments it at the tool-dispatch chokepoint; the
+ * status-line reader reads it with `readSessionMarker`.
+ *
+ * Every write is best-effort and swallows errors — recording a call must
+ * never block or fail the underlying tool call (REQ-STATUSLINE-004.A3).
+ */
+import { SessionMarker } from './types';
+/**
+ * Reset the marker to a fresh session (calls: 0). Called once when the MCP
+ * server attaches its code graph. Idempotent within a process: subsequent
+ * calls are no-ops so the running count is preserved.
+ */
+export declare function initSession(projectRoot: string): void;
+/**
+ * Increment the call count and record the tool name. Reads the current
+ * marker (or starts a fresh one if absent) and writes it back atomically.
+ * Never throws.
+ */
+export declare function recordCall(projectRoot: string, toolName: string): void;
+/** Read the session marker, or null when absent/corrupt. */
+export declare function readSessionMarker(projectRoot: string): SessionMarker | null;
+/** Test-only: reset the per-process started guard. */
+export declare function __resetSessionGuardForTests(): void;
+//# sourceMappingURL=session-marker.d.ts.map

package/dist/statusline/session-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-marker.d.ts","sourceRoot":"","sources":["../../src/statusline/session-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAMxC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CASrD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAgBtE;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAG3E;AAED,sDAAsD;AACtD,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/dist/statusline/session-marker.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Tier-B session marker (REQ-STATUSLINE-004).
+ *
+ * Scoped to one MCP-server process lifetime: Claude Code spawns one MCP
+ * server per session, so "calls since this server initialized the marker" is
+ * the session's specship-call count. `initSession` resets it once at server
+ * start; `recordCall` increments it at the tool-dispatch chokepoint; the
+ * status-line reader reads it with `readSessionMarker`.
+ *
+ * Every write is best-effort and swallows errors — recording a call must
+ * never block or fail the underlying tool call (REQ-STATUSLINE-004.A3).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initSession = initSession;
+exports.recordCall = recordCall;
+exports.readSessionMarker = readSessionMarker;
+exports.__resetSessionGuardForTests = __resetSessionGuardForTests;
+const paths_1 = require("./paths");
+/** Per-process guard so a re-attached code graph doesn't reset the count mid-session. */
+let sessionStarted = false;
+/**
+ * Reset the marker to a fresh session (calls: 0). Called once when the MCP
+ * server attaches its code graph. Idempotent within a process: subsequent
+ * calls are no-ops so the running count is preserved.
+ */
+function initSession(projectRoot) {
+    if (sessionStarted)
+        return;
+    sessionStarted = true;
+    const marker = { v: 1, startedAt: Date.now(), calls: 0, lastTool: null, lastAt: null };
+    try {
+        (0, paths_1.writeJsonAtomic)((0, paths_1.sessionMarkerPath)(projectRoot), marker);
+    }
+    catch {
+        /* best-effort */
+    }
+}
+/**
+ * Increment the call count and record the tool name. Reads the current
+ * marker (or starts a fresh one if absent) and writes it back atomically.
+ * Never throws.
+ */
+function recordCall(projectRoot, toolName) {
+    try {
+        const cur = (0, paths_1.readJsonSafe)((0, paths_1.sessionMarkerPath)(projectRoot));
+        const base = cur && cur.v === 1
+            ? cur
+            : { v: 1, startedAt: Date.now(), calls: 0, lastTool: null, lastAt: null };
+        const next = {
+            ...base,
+            calls: base.calls + 1,
+            lastTool: toolName,
+            lastAt: Date.now(),
+        };
+        (0, paths_1.writeJsonAtomic)((0, paths_1.sessionMarkerPath)(projectRoot), next);
+    }
+    catch {
+        /* best-effort — a failed marker write must not affect the tool call */
+    }
+}
+/** Read the session marker, or null when absent/corrupt. */
+function readSessionMarker(projectRoot) {
+    const m = (0, paths_1.readJsonSafe)((0, paths_1.sessionMarkerPath)(projectRoot));
+    return m && m.v === 1 ? m : null;
+}
+/** Test-only: reset the per-process started guard. */
+function __resetSessionGuardForTests() {
+    sessionStarted = false;
+}
+//# sourceMappingURL=session-marker.js.map

package/dist/statusline/session-marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-marker.js","sourceRoot":"","sources":["../../src/statusline/session-marker.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAaH,kCASC;AAOD,gCAgBC;AAGD,8CAGC;AAGD,kEAEC;AArDD,mCAA2E;AAE3E,yFAAyF;AACzF,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B;;;;GAIG;AACH,SAAgB,WAAW,CAAC,WAAmB;IAC7C,IAAI,cAAc;QAAE,OAAO;IAC3B,cAAc,GAAG,IAAI,CAAC;IACtB,MAAM,MAAM,GAAkB,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACtG,IAAI,CAAC;QACH,IAAA,uBAAe,EAAC,IAAA,yBAAiB,EAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,WAAmB,EAAE,QAAgB;IAC9D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,oBAAY,EAAgB,IAAA,yBAAiB,EAAC,WAAW,CAAC,CAAC,CAAC;QACxE,MAAM,IAAI,GAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC;YAC5C,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC5E,MAAM,IAAI,GAAkB;YAC1B,GAAG,IAAI;YACP,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC;YACrB,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE;SACnB,CAAC;QACF,IAAA,uBAAe,EAAC,IAAA,yBAAiB,EAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;AACH,CAAC;AAED,4DAA4D;AAC5D,SAAgB,iBAAiB,CAAC,WAAmB;IACnD,MAAM,CAAC,GAAG,IAAA,oBAAY,EAAgB,IAAA,yBAAiB,EAAC,WAAW,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC;AAED,sDAAsD;AACtD,SAAgB,2BAA2B;IACzC,cAAc,GAAG,KAAK,CAAC;AACzB,CAAC"}

package/dist/statusline/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Shared types for the SpecShip status-line segment (SHIP-STATUSLINE-DOC).
+ *
+ * Two cache files back the segment so the read path never opens SQLite:
+ *   - `.specship/statusline.json`        — Tier-A index state (this file's
+ *     {@link StatuslineCache}); refreshed by index/sync/watcher events.
+ *   - `.specship/session/marker.json`    — Tier-B per-session call data
+ *     ({@link SessionMarker}); owned by the MCP server process.
+ *   - `.specship/session/active-run.json`— the in-flight workflow run
+ *     ({@link ActiveRun}); written by the workflow executor.
+ *
+ * All three are tiny JSON blobs read with a single `readFileSync` each.
+ */
+/** Tier-A index state. Mirrors the fields `specship status --json` exposes. */
+export interface StatuslineCache {
+    /** Schema version, so a future shape change is detectable on read. */
+    v: 1;
+    /** Whether the project is initialized (has an index). */
+    initialized: boolean;
+    /** ms epoch when this cache was written. */
+    updatedAt: number;
+    /** Pending file changes not yet synced into the index. */
+    pending: {
+        added: number;
+        modified: number;
+        removed: number;
+    };
+    /** Count of spec→code links in a drifted/broken/orphaned state. */
+    drift: number;
+    /** Active SQLite backend, e.g. `better-sqlite3` (native) or `node-sqlite` (built-in). */
+    backend: string;
+    /**
+     * Whether the DB is on a degraded/slow path — a non-WAL journal, where reads
+     * can block on writes (network mounts, WSL2 /mnt, or the wasm fallback). This
+     * is the runtime "backend health" warning the segment surfaces.
+     */
+    degraded: boolean;
+    /** Indexed file count. */
+    fileCount: number;
+    /** Indexed node count. */
+    nodeCount: number;
+    /** ms epoch of the last full index, or null if never. */
+    lastIndexed: number | null;
+}
+/** Tier-B per-session call data, scoped to one MCP-server process lifetime. */
+export interface SessionMarker {
+    v: 1;
+    /** ms epoch when this server process initialized the marker. */
+    startedAt: number;
+    /** Number of specship tool calls handled since {@link startedAt}. */
+    calls: number;
+    /** Name of the most recently invoked tool, or null before the first call. */
+    lastTool: string | null;
+    /** ms epoch of the most recent call, or null before the first call. */
+    lastAt: number | null;
+}
+/** The active (or most recent) workflow run for the project. */
+export interface ActiveRun {
+    v: 1;
+    /** The spec ID the run targets, e.g. `REQ-STATUSLINE-001`. */
+    specId: string | null;
+    /** Run lifecycle status, e.g. `running`, `awaiting-approval`, `completed`, `failed`. */
+    status: string;
+    /** ms epoch of the last status change. */
+    updatedAt: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/statusline/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/statusline/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,CAAC,EAAE,CAAC,CAAC;IACL,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,CAAC,CAAC;IACL,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,gEAAgE;AAChE,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,CAAC,CAAC;IACL,8DAA8D;IAC9D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/statusline/types.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Shared types for the SpecShip status-line segment (SHIP-STATUSLINE-DOC).
+ *
+ * Two cache files back the segment so the read path never opens SQLite:
+ *   - `.specship/statusline.json`        — Tier-A index state (this file's
+ *     {@link StatuslineCache}); refreshed by index/sync/watcher events.
+ *   - `.specship/session/marker.json`    — Tier-B per-session call data
+ *     ({@link SessionMarker}); owned by the MCP server process.
+ *   - `.specship/session/active-run.json`— the in-flight workflow run
+ *     ({@link ActiveRun}); written by the workflow executor.
+ *
+ * All three are tiny JSON blobs read with a single `readFileSync` each.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/statusline/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/statusline/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG"}

package/dist/sync/git-hooks.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Git Sync Hooks
+ *
+ * When the live file watcher is disabled (e.g. on WSL2 `/mnt/*` drives,
+ * see watch-policy.ts), the SpecShip index would otherwise go stale until
+ * the user runs `specship sync` by hand. As an opt-in alternative, we can
+ * install git hooks that refresh the index after the operations that change
+ * files on disk: commit, merge (covers `git pull`), and checkout.
+ *
+ * The hooks run `specship sync` in the background so they never block git,
+ * and are guarded by `command -v specship` so they no-op cleanly when the
+ * CLI isn't on PATH. Our snippet is delimited by marker comments so install
+ * is idempotent and removal preserves any user-authored hook content.
+ */
+export type GitHookName = 'post-commit' | 'post-merge' | 'post-checkout';
+/** Hooks installed by default: commit, merge (git pull), and checkout. */
+export declare const DEFAULT_SYNC_HOOKS: GitHookName[];
+export interface GitHookResult {
+    /** Hook names that were created or updated. */
+    installed: GitHookName[];
+    /** Resolved hooks directory, or null when not a git repo. */
+    hooksDir: string | null;
+    /** Reason nothing happened (e.g. not a git repository). */
+    skipped?: string;
+}
+/**
+ * Whether `projectRoot` is inside a git working tree. Returns false if git
+ * isn't installed or the path isn't a repo.
+ */
+export declare function isGitRepo(projectRoot: string): boolean;
+/**
+ * Install (or update) the SpecShip sync hooks in a git repository.
+ * Idempotent: re-running replaces our marker block rather than duplicating
+ * it, and any user-authored hook content is preserved.
+ */
+export declare function installGitSyncHook(projectRoot: string, hooks?: GitHookName[]): GitHookResult;
+/**
+ * Remove the SpecShip sync hooks. Strips only our marker block; deletes the
+ * hook file entirely when nothing but a shebang remains, otherwise rewrites
+ * the user's content untouched.
+ */
+export declare function removeGitSyncHook(projectRoot: string, hooks?: GitHookName[]): GitHookResult;
+/** Whether any SpecShip sync hook is currently installed. */
+export declare function isSyncHookInstalled(projectRoot: string, hooks?: GitHookName[]): boolean;
+//# sourceMappingURL=git-hooks.d.ts.map

package/dist/sync/git-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-hooks.d.ts","sourceRoot":"","sources":["../../src/sync/git-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,eAAe,CAAC;AAEzE,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,EAAE,WAAW,EAAmD,CAAC;AAEhG,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAYtD;AAiED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,WAAW,EAAuB,GACxC,aAAa,CAmCf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,WAAW,EAAuB,GACxC,aAAa,CA0Bf;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,WAAW,EAAuB,GACxC,OAAO,CAOT"}

package/dist/sync/git-hooks.js

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * Git Sync Hooks
+ *
+ * When the live file watcher is disabled (e.g. on WSL2 `/mnt/*` drives,
+ * see watch-policy.ts), the SpecShip index would otherwise go stale until
+ * the user runs `specship sync` by hand. As an opt-in alternative, we can
+ * install git hooks that refresh the index after the operations that change
+ * files on disk: commit, merge (covers `git pull`), and checkout.
+ *
+ * The hooks run `specship sync` in the background so they never block git,
+ * and are guarded by `command -v specship` so they no-op cleanly when the
+ * CLI isn't on PATH. Our snippet is delimited by marker comments so install
+ * is idempotent and removal preserves any user-authored hook content.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SYNC_HOOKS = void 0;
+exports.isGitRepo = isGitRepo;
+exports.installGitSyncHook = installGitSyncHook;
+exports.removeGitSyncHook = removeGitSyncHook;
+exports.isSyncHookInstalled = isSyncHookInstalled;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const MARKER_BEGIN = '# >>> specship sync hook >>>';
+const MARKER_END = '# <<< specship sync hook <<<';
+/** Hooks installed by default: commit, merge (git pull), and checkout. */
+exports.DEFAULT_SYNC_HOOKS = ['post-commit', 'post-merge', 'post-checkout'];
+/**
+ * Whether `projectRoot` is inside a git working tree. Returns false if git
+ * isn't installed or the path isn't a repo.
+ */
+function isGitRepo(projectRoot) {
+    try {
+        const out = (0, child_process_1.execFileSync)('git', ['rev-parse', '--is-inside-work-tree'], {
+            cwd: projectRoot,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            windowsHide: true,
+        }).trim();
+        return out === 'true';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve the git hooks directory for a project, honoring `core.hooksPath`
+ * and git worktrees. Returns an absolute path, or null when not a repo.
+ */
+function gitHooksDir(projectRoot) {
+    try {
+        const out = (0, child_process_1.execFileSync)('git', ['rev-parse', '--git-path', 'hooks'], {
+            cwd: projectRoot,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            windowsHide: true,
+        }).trim();
+        if (!out)
+            return null;
+        return path.isAbsolute(out) ? out : path.resolve(projectRoot, out);
+    }
+    catch {
+        return null;
+    }
+}
+/** The shell snippet (between markers) injected into each hook. */
+function markerBlock() {
+    return [
+        MARKER_BEGIN,
+        '# Keeps the SpecShip index fresh while the live file watcher is off',
+        '# (e.g. WSL2 /mnt drives). Runs in the background so it never blocks git.',
+        '# Managed by specship; remove with `specship uninit` or delete this block.',
+        'if command -v specship >/dev/null 2>&1; then',
+        '  ( specship sync >/dev/null 2>&1 & ) >/dev/null 2>&1',
+        'fi',
+        MARKER_END,
+    ].join('\n');
+}
+/** Remove our marker block (and the marker lines) from hook content. */
+function stripMarkerBlock(content) {
+    const lines = content.split('\n');
+    const kept = [];
+    let inBlock = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === MARKER_BEGIN) {
+            inBlock = true;
+            continue;
+        }
+        if (trimmed === MARKER_END) {
+            inBlock = false;
+            continue;
+        }
+        if (!inBlock)
+            kept.push(line);
+    }
+    return kept.join('\n');
+}
+/** Whether a hook body is just a shebang / blank lines (i.e. only ever ours). */
+function isEffectivelyEmpty(content) {
+    return content
+        .split('\n')
+        .map((l) => l.trim())
+        .every((l) => l.length === 0 || l.startsWith('#!'));
+}
+function chmodExecutable(file) {
+    try {
+        fs.chmodSync(file, 0o755);
+    }
+    catch {
+        /* chmod is a no-op / unsupported on some platforms (e.g. Windows) */
+    }
+}
+/**
+ * Install (or update) the SpecShip sync hooks in a git repository.
+ * Idempotent: re-running replaces our marker block rather than duplicating
+ * it, and any user-authored hook content is preserved.
+ */
+function installGitSyncHook(projectRoot, hooks = exports.DEFAULT_SYNC_HOOKS) {
+    const hooksDir = gitHooksDir(projectRoot);
+    if (!hooksDir) {
+        return { installed: [], hooksDir: null, skipped: 'not a git repository' };
+    }
+    try {
+        fs.mkdirSync(hooksDir, { recursive: true });
+    }
+    catch {
+        return { installed: [], hooksDir, skipped: 'could not access the git hooks directory' };
+    }
+    const block = markerBlock();
+    const installed = [];
+    for (const hook of hooks) {
+        const file = path.join(hooksDir, hook);
+        let content;
+        if (fs.existsSync(file)) {
+            // Strip any prior block, then re-append the current one.
+            const base = stripMarkerBlock(fs.readFileSync(file, 'utf8')).replace(/\s*$/, '');
+            content = base.length > 0
+                ? `${base}\n\n${block}\n`
+                : `#!/bin/sh\n${block}\n`;
+        }
+        else {
+            content = `#!/bin/sh\n${block}\n`;
+        }
+        fs.writeFileSync(file, content);
+        chmodExecutable(file);
+        installed.push(hook);
+    }
+    return { installed, hooksDir };
+}
+/**
+ * Remove the SpecShip sync hooks. Strips only our marker block; deletes the
+ * hook file entirely when nothing but a shebang remains, otherwise rewrites
+ * the user's content untouched.
+ */
+function removeGitSyncHook(projectRoot, hooks = exports.DEFAULT_SYNC_HOOKS) {
+    const hooksDir = gitHooksDir(projectRoot);
+    if (!hooksDir) {
+        return { installed: [], hooksDir: null, skipped: 'not a git repository' };
+    }
+    const removed = [];
+    for (const hook of hooks) {
+        const file = path.join(hooksDir, hook);
+        if (!fs.existsSync(file))
+            continue;
+        const original = fs.readFileSync(file, 'utf8');
+        if (!original.includes(MARKER_BEGIN))
+            continue;
+        const stripped = stripMarkerBlock(original);
+        if (isEffectivelyEmpty(stripped)) {
+            fs.unlinkSync(file);
+        }
+        else {
+            fs.writeFileSync(file, `${stripped.replace(/\s*$/, '')}\n`);
+            chmodExecutable(file);
+        }
+        removed.push(hook);
+    }
+    return { installed: removed, hooksDir };
+}
+/** Whether any SpecShip sync hook is currently installed. */
+function isSyncHookInstalled(projectRoot, hooks = exports.DEFAULT_SYNC_HOOKS) {
+    const hooksDir = gitHooksDir(projectRoot);
+    if (!hooksDir)
+        return false;
+    return hooks.some((hook) => {
+        const file = path.join(hooksDir, hook);
+        return fs.existsSync(file) && fs.readFileSync(file, 'utf8').includes(MARKER_BEGIN);
+    });
+}
+//# sourceMappingURL=git-hooks.js.map

package/dist/sync/git-hooks.js.map

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

package/dist/sync/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Sync Module
+ *
+ * Provides synchronization functionality for keeping the code graph
+ * up-to-date with file system changes.
+ *
+ * Components:
+ * - FileWatcher: Debounced fs.watch that auto-triggers sync on file changes
+ * - Watch policy: decides when the watcher must be disabled (e.g. WSL2 /mnt)
+ * - Git sync hooks: opt-in commit/merge/checkout hooks when watching is off
+ * - Git worktree awareness: detect when a query borrows another tree's index
+ * - Content hashing for change detection (in extraction module)
+ * - Incremental reindexing (in extraction module)
+ */
+export { FileWatcher, WatchOptions, PendingFile, LockUnavailableError } from './watcher';
+export { watchDisabledReason, detectWsl } from './watch-policy';
+export { installGitSyncHook, removeGitSyncHook, isSyncHookInstalled, isGitRepo, DEFAULT_SYNC_HOOKS, type GitHookName, type GitHookResult, } from './git-hooks';
+export { gitWorktreeRoot, detectWorktreeIndexMismatch, worktreeMismatchWarning, worktreeMismatchNotice, type WorktreeIndexMismatch, } from './worktree';
+//# sourceMappingURL=index.d.ts.map

package/dist/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,EACT,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,uBAAuB,EACvB,sBAAsB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC"}

package/dist/sync/index.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Sync Module
+ *
+ * Provides synchronization functionality for keeping the code graph
+ * up-to-date with file system changes.
+ *
+ * Components:
+ * - FileWatcher: Debounced fs.watch that auto-triggers sync on file changes
+ * - Watch policy: decides when the watcher must be disabled (e.g. WSL2 /mnt)
+ * - Git sync hooks: opt-in commit/merge/checkout hooks when watching is off
+ * - Git worktree awareness: detect when a query borrows another tree's index
+ * - Content hashing for change detection (in extraction module)
+ * - Incremental reindexing (in extraction module)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.worktreeMismatchNotice = exports.worktreeMismatchWarning = exports.detectWorktreeIndexMismatch = exports.gitWorktreeRoot = exports.DEFAULT_SYNC_HOOKS = exports.isGitRepo = exports.isSyncHookInstalled = exports.removeGitSyncHook = exports.installGitSyncHook = exports.detectWsl = exports.watchDisabledReason = exports.LockUnavailableError = exports.FileWatcher = void 0;
+var watcher_1 = require("./watcher");
+Object.defineProperty(exports, "FileWatcher", { enumerable: true, get: function () { return watcher_1.FileWatcher; } });
+Object.defineProperty(exports, "LockUnavailableError", { enumerable: true, get: function () { return watcher_1.LockUnavailableError; } });
+var watch_policy_1 = require("./watch-policy");
+Object.defineProperty(exports, "watchDisabledReason", { enumerable: true, get: function () { return watch_policy_1.watchDisabledReason; } });
+Object.defineProperty(exports, "detectWsl", { enumerable: true, get: function () { return watch_policy_1.detectWsl; } });
+var git_hooks_1 = require("./git-hooks");
+Object.defineProperty(exports, "installGitSyncHook", { enumerable: true, get: function () { return git_hooks_1.installGitSyncHook; } });
+Object.defineProperty(exports, "removeGitSyncHook", { enumerable: true, get: function () { return git_hooks_1.removeGitSyncHook; } });
+Object.defineProperty(exports, "isSyncHookInstalled", { enumerable: true, get: function () { return git_hooks_1.isSyncHookInstalled; } });
+Object.defineProperty(exports, "isGitRepo", { enumerable: true, get: function () { return git_hooks_1.isGitRepo; } });
+Object.defineProperty(exports, "DEFAULT_SYNC_HOOKS", { enumerable: true, get: function () { return git_hooks_1.DEFAULT_SYNC_HOOKS; } });
+var worktree_1 = require("./worktree");
+Object.defineProperty(exports, "gitWorktreeRoot", { enumerable: true, get: function () { return worktree_1.gitWorktreeRoot; } });
+Object.defineProperty(exports, "detectWorktreeIndexMismatch", { enumerable: true, get: function () { return worktree_1.detectWorktreeIndexMismatch; } });
+Object.defineProperty(exports, "worktreeMismatchWarning", { enumerable: true, get: function () { return worktree_1.worktreeMismatchWarning; } });
+Object.defineProperty(exports, "worktreeMismatchNotice", { enumerable: true, get: function () { return worktree_1.worktreeMismatchNotice; } });
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,qCAAyF;AAAhF,sGAAA,WAAW,OAAA;AAA6B,+GAAA,oBAAoB,OAAA;AACrE,+CAAgE;AAAvD,mHAAA,mBAAmB,OAAA;AAAE,yGAAA,SAAS,OAAA;AACvC,yCAQqB;AAPnB,+GAAA,kBAAkB,OAAA;AAClB,8GAAA,iBAAiB,OAAA;AACjB,gHAAA,mBAAmB,OAAA;AACnB,sGAAA,SAAS,OAAA;AACT,+GAAA,kBAAkB,OAAA;AAIpB,uCAMoB;AALlB,2GAAA,eAAe,OAAA;AACf,uHAAA,2BAA2B,OAAA;AAC3B,mHAAA,uBAAuB,OAAA;AACvB,kHAAA,sBAAsB,OAAA"}

package/dist/sync/watch-policy.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Watch Policy
+ *
+ * Decides whether the live file watcher should run for a given project.
+ *
+ * Native recursive `fs.watch` is pathologically slow on WSL2 `/mnt/*`
+ * drives (NTFS exposed over the 9p/drvfs bridge): setting up the recursive
+ * watch walks the directory tree, and every readdir/stat crosses the
+ * Windows boundary. Inside an MCP server this stalls the event loop during
+ * startup long enough to blow past Claude Code's handshake timeout, so
+ * the tools never appear. See issue #199.
+ *
+ * This module centralizes the on/off decision so the watcher, the MCP
+ * server (for diagnostics), and the installer all agree.
+ */
+/**
+ * Detect whether the current process is running under WSL (Windows
+ * Subsystem for Linux). Result is cached after the first call.
+ *
+ * Checks the WSL-specific env vars first (no I/O), then falls back to
+ * `/proc/version`, which contains "microsoft" on WSL kernels.
+ */
+export declare function detectWsl(): boolean;
+/**
+ * Inputs that can be overridden in tests so the decision is deterministic
+ * without touching real env vars or `/proc/version`.
+ */
+export interface WatchProbe {
+    /** Defaults to `process.env`. */
+    env?: NodeJS.ProcessEnv;
+    /** Defaults to `detectWsl()`. */
+    isWsl?: boolean;
+}
+/**
+ * Decide whether the file watcher should be disabled for a project, and why.
+ *
+ * Returns a short human-readable reason when watching should be skipped, or
+ * `null` when it should run normally.
+ *
+ * Precedence (first match wins):
+ *  1. `SPECSHIP_NO_WATCH=1`    → off  (explicit opt-out always wins)
+ *  2. `SPECSHIP_FORCE_WATCH=1` → on   (overrides auto-detection)
+ *  3. WSL2 + `/mnt/*` drive     → off  (recursive fs.watch is too slow; #199)
+ */
+export declare function watchDisabledReason(projectRoot: string, probe?: WatchProbe): string | null;
+/** Test-only: reset the cached WSL detection. */
+export declare function __resetWslCacheForTests(): void;
+//# sourceMappingURL=watch-policy.d.ts.map

package/dist/sync/watch-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-policy.d.ts","sourceRoot":"","sources":["../../src/sync/watch-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAmBnC;AAWD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,iCAAiC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,GAAE,UAAe,GAAG,MAAM,GAAG,IAAI,CAgB9F;AAED,iDAAiD;AACjD,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}