@selvakumaresra/specship 0.1.3 → 0.3.0

package/dist/server/server.js

@@ -0,0 +1,206 @@
+/**
+ * Fastify HTTP server for specship + SpecShip Desktop UI.
+ *
+ * Routes follow the design spec — `/api/graph/*`, `/api/spec/*`,
+ * `/api/drift`, `/api/workflows/*`, `/api/claude/*`. Each route group lives
+ * in its own file under `./routes/` and registers itself on a passed
+ * Fastify instance.
+ *
+ * Why Fastify: lighter than Express, faster, first-class TypeScript types,
+ * built-in JSON schema validation, plugins for CORS + SSE. The 30K LoC
+ * Archon UI port pulls ~20+ API routes — Fastify's plugin model keeps the
+ * registration code tidy.
+ */
+import path from 'node:path';
+import { existsSync, promises as fs } from 'node:fs';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import Fastify from 'fastify';
+import cors from '@fastify/cors';
+import { startWatcher } from './ingest/index.js';
+import { ProjectRegistry } from './project-registry.js';
+import { makeStaticHandler } from './static-handler.js';
+import { registerGraphRoutes } from './routes/graph.js';
+import { registerSpecRoutes } from './routes/spec.js';
+import { registerWorkflowRoutes } from './routes/workflow.js';
+import { registerClaudeRoutes } from './routes/claude.js';
+import { registerStatusRoutes } from './routes/status.js';
+import { registerMemoryRoutes } from './routes/memory.js';
+import { registerProjectsRoutes } from './routes/projects.js';
+/**
+ * Lazy-import the specship core. Two delivery shapes are supported:
+ *
+ *   1. **Bundled** — the platform-specific npm tarball lays the compiled
+ *      server out at `<bundle>/lib/dist/server/server.js` and the specship
+ *      core at `<bundle>/lib/dist/index.js`. We try this relative path
+ *      first so the bundled mode never depends on Node's package
+ *      resolution finding `@selvakumaresra/specship` (it won't, the
+ *      bundle stages a single package by name `@selvakumaresra/specship`).
+ *
+ *   2. **Workspace / dev** — `packages/server/dist/server.js` imports via
+ *      the workspace `file:../..` dep. Falls through to the named import.
+ *
+ * The function caches the resolved module so the lookup only runs once.
+ */
+let cachedSpecShip = null;
+async function loadSpecShip() {
+    if (cachedSpecShip)
+        return cachedSpecShip;
+    // Bundled mode: dist/server/server.js → ../index.js (root dist/index.js).
+    try {
+        const here = path.dirname(fileURLToPath(import.meta.url));
+        const candidate = path.resolve(here, '..', 'index.js');
+        if (existsSync(candidate)) {
+            cachedSpecShip = (await import(pathToFileURL(candidate).href));
+            return cachedSpecShip;
+        }
+    }
+    catch { /* fall through */ }
+    // Workspace/dev: resolve via the named dep.
+    cachedSpecShip = await import('@selvakumaresra/specship');
+    return cachedSpecShip;
+}
+export async function createServer(options) {
+    const host = options.host ?? '127.0.0.1';
+    const port = options.port ?? 4242;
+    const verbose = options.verbose ?? false;
+    const app = Fastify({
+        logger: verbose
+            ? { transport: { target: 'pino-pretty', options: { translateTime: 'HH:MM:ss.l' } } }
+            : false,
+    });
+    if (options.cors !== false) {
+        // Permissive CORS for local dev. The server is bound to loopback by
+        // default, so the broad allowlist is fine — Browsers won't get to it
+        // from a non-localhost origin without explicit user override.
+        await app.register(cors, {
+            origin: true,
+            credentials: false,
+        });
+    }
+    // Lazy-load specship. Used as the open() impl for the registry, and
+    // (only when a primary path is set) to open the primary instance below.
+    const cgMod = await loadSpecShip();
+    const registry = new ProjectRegistry({ verbose }, (p) => cgMod.SpecShip.open(p));
+    // Primary project (optional). When set, specship-scoped routes default to
+    // it when no `?project=<slug>` is provided, and the analytics ingest
+    // hooks into its SQLite handle.
+    let primaryCg = null;
+    if (options.projectRoot) {
+        primaryCg = await registry.get(options.projectRoot);
+        if (!primaryCg && verbose) {
+            console.error(`[specship-server] primary project ${options.projectRoot} not initialized — booting projectless`);
+        }
+    }
+    // Start the JSONL ingest watcher in-process unless the caller already
+    // provided one or explicitly opted out. Hooks into the primary project's
+    // SQLite handle — when there's no primary, analytics endpoints will return
+    // 409 until one is set (typically the next server restart with -p).
+    let watcher = options.watcher ?? null;
+    let ownedWatcher = false;
+    if (!watcher && options.ingest !== false && primaryCg) {
+        const cgAny = primaryCg;
+        const dbHandle = cgAny.db?.getDb ? cgAny.db.getDb() : cgAny.queries?.db;
+        if (dbHandle) {
+            watcher = startWatcher(dbHandle, { verbose });
+            ownedWatcher = true;
+            if (verbose)
+                console.error('[specship-server] JSONL ingest watcher started');
+        }
+    }
+    else if (!primaryCg && options.ingest !== false && verbose) {
+        console.error('[specship-server] no primary project — analytics will be empty until one is set');
+    }
+    // Decorate the Fastify instance so route handlers can access shared state
+    // without globals or DI containers.
+    app.decorate('projects', registry);
+    app.decorate('primaryCg', primaryCg);
+    app.decorate('watcher', watcher);
+    // activeCg(req): resolve `?project=<slug>` → SpecShip instance, with the
+    // primary as fallback. Returns null when nothing is selectable; route
+    // handlers respond 409 in that case.
+    app.decorate('activeCg', async function (req) {
+        const q = (req.query ?? {});
+        if (q.project) {
+            const bySlug = await registry.getBySlug(q.project);
+            if (bySlug)
+                return bySlug;
+        }
+        if (q.projectPath) {
+            const byPath = await registry.get(q.projectPath);
+            if (byPath)
+                return byPath;
+        }
+        return primaryCg;
+    });
+    // Register route groups.
+    await registerStatusRoutes(app);
+    await registerGraphRoutes(app);
+    await registerSpecRoutes(app);
+    await registerWorkflowRoutes(app);
+    await registerClaudeRoutes(app);
+    await registerMemoryRoutes(app);
+    await registerProjectsRoutes(app);
+    // Optional: serve the built Angular UI from `webDir` and fall back to
+    // index.html for client-side routes. Must register AFTER the /api/*
+    // routes so they take precedence over the SPA wildcard.
+    if (options.webDir) {
+        const indexPath = path.join(options.webDir, 'index.html');
+        let indexBuffer = null;
+        try {
+            indexBuffer = await fs.readFile(indexPath);
+        }
+        catch {
+            if (verbose) {
+                console.error(`[specship-server] webDir provided but index.html not found at ${indexPath} — skipping static mount`);
+            }
+        }
+        if (indexBuffer) {
+            const cachedIndex = indexBuffer;
+            const serveStatic = makeStaticHandler(options.webDir);
+            // A single 404 handler does both jobs:
+            //   1. Try the requested URL as a real file under webDir → serve it
+            //      with the right content-type. Covers the SPA's chunk-*.js,
+            //      styles.css, favicons, fonts, etc.
+            //   2. Fall through to index.html for any other GET so Angular's
+            //      client-side router can take over (`/memory`, `/graph`, …).
+            // Non-GET methods and `/api/*` paths still 404 cleanly so the UI
+            // can surface them.
+            app.setNotFoundHandler((request, reply) => {
+                if (request.method !== 'GET') {
+                    reply.code(404).send({ error: 'not found' });
+                    return;
+                }
+                if (request.url.startsWith('/api/')) {
+                    reply.code(404).send({ error: 'not found' });
+                    return;
+                }
+                const hit = serveStatic(request.url);
+                if (hit) {
+                    reply.code(200).type(hit.contentType).send(hit.body);
+                    return;
+                }
+                reply.code(200).type('text/html').send(cachedIndex);
+            });
+            if (verbose)
+                console.error(`[specship-server] serving SPA from ${options.webDir}`);
+        }
+    }
+    await app.listen({ host, port });
+    const url = `http://${host}:${port}`;
+    return {
+        app,
+        url,
+        host,
+        port,
+        stop: async () => {
+            if (ownedWatcher && watcher) {
+                try {
+                    watcher.stop();
+                }
+                catch { /* ignore */ }
+            }
+            registry.closeAll();
+            await app.close();
+        },
+    };
+}

package/dist/server/static-handler.js

@@ -0,0 +1,87 @@
+/**
+ * In-house static file serving for the desktop SPA. Replaces the
+ * `@fastify/static` plugin so we don't pull in `glob` (deprecated maintainer-side
+ * across every 10.x and 11.x release, which polluted every user's install
+ * with a deprecation warning).
+ *
+ * Usage from server.ts:
+ *
+ *   const serveStatic = makeStaticHandler(options.webDir);
+ *   app.setNotFoundHandler((req, reply) => {
+ *     if (req.method !== 'GET' || req.url.startsWith('/api/')) {
+ *       reply.code(404).send({ error: 'not found' });
+ *       return;
+ *     }
+ *     const hit = serveStatic(req.url);
+ *     if (hit) { reply.type(hit.contentType).send(hit.body); return; }
+ *     reply.code(200).type('text/html').send(cachedIndex);
+ *   });
+ *
+ * Path traversal is blocked by resolving the requested path inside webDir and
+ * rejecting anything that resolves outside.
+ */
+import { readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+const CT = {
+    '.html': 'text/html; charset=utf-8',
+    '.htm': 'text/html; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.ico': 'image/x-icon',
+    '.webp': 'image/webp',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.otf': 'font/otf',
+    '.txt': 'text/plain; charset=utf-8',
+    '.wasm': 'application/wasm',
+};
+export function makeStaticHandler(rootDir) {
+    const absRoot = path.resolve(rootDir);
+    return function serveStatic(urlPath) {
+        // Strip query/hash — Fastify gives us the raw URL.
+        const qIdx = urlPath.indexOf('?');
+        const hIdx = urlPath.indexOf('#');
+        let clean = urlPath;
+        if (qIdx >= 0)
+            clean = clean.slice(0, qIdx);
+        if (hIdx >= 0)
+            clean = clean.slice(0, hIdx);
+        // Decode percent-encoding (but reject anything that throws).
+        let decoded;
+        try {
+            decoded = decodeURIComponent(clean);
+        }
+        catch {
+            return null;
+        }
+        // Strip leading slash so path.resolve doesn't escape the root.
+        const rel = decoded.replace(/^\/+/, '');
+        // Resolve under root and verify containment to block ../../ traversal.
+        const candidate = path.resolve(absRoot, rel);
+        if (candidate !== absRoot && !candidate.startsWith(absRoot + path.sep)) {
+            return null;
+        }
+        let stat;
+        try {
+            stat = statSync(candidate);
+        }
+        catch {
+            return null;
+        }
+        if (!stat.isFile())
+            return null;
+        const body = readFileSync(candidate);
+        const ext = path.extname(candidate).toLowerCase();
+        const contentType = CT[ext] ?? 'application/octet-stream';
+        return { body, contentType };
+    };
+}

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"}