specweave 0.28.68 → 0.29.1

package/dist/src/hooks/platform.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Cross-Platform Hook Utilities
+ *
+ * Provides platform detection and process spawning for Windows, macOS, and Linux.
+ * Optimized for hook execution with minimal overhead.
+ *
+ * @module hooks/platform
+ */
+import { SpawnOptions, ChildProcess } from 'child_process';
+/**
+ * Platform types
+ */
+export type Platform = 'windows' | 'macos' | 'linux' | 'unknown';
+/**
+ * WSL availability status
+ */
+export interface WslStatus {
+    available: boolean;
+    version?: 1 | 2;
+    defaultDistro?: string;
+}
+/**
+ * Get normalized platform identifier
+ */
+export declare function getPlatform(): Platform;
+/**
+ * Check if running on Windows
+ */
+export declare function isWindows(): boolean;
+/**
+ * Check if running on POSIX system (macOS, Linux)
+ */
+export declare function isPosix(): boolean;
+export declare function checkWslStatus(): WslStatus;
+/**
+ * Find project root by looking for .specweave directory
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Project root path or null if not found
+ */
+export declare function findProjectRoot(startDir?: string): string | null;
+/**
+ * Spawn a detached background process (cross-platform)
+ *
+ * On Windows: Uses 'start' command or direct spawn with detached option
+ * On POSIX: Uses spawn with detached + unref
+ *
+ * @param command - Command to run
+ * @param args - Arguments
+ * @param options - Spawn options
+ * @returns ChildProcess or null if spawn failed
+ */
+export declare function spawnDetached(command: string, args?: string[], options?: SpawnOptions): ChildProcess | null;
+/**
+ * Spawn Node.js script in background (cross-platform)
+ *
+ * Optimized for spawning Node.js scripts as background daemons.
+ *
+ * @param scriptPath - Path to the Node.js script
+ * @param args - Arguments to pass to the script
+ * @param cwd - Working directory
+ * @returns ChildProcess or null if spawn failed
+ */
+export declare function spawnNodeBackground(scriptPath: string, args?: string[], cwd?: string): ChildProcess | null;
+/**
+ * Read JSON file safely with error handling
+ *
+ * @param filePath - Path to JSON file
+ * @returns Parsed JSON or null if failed
+ */
+export declare function readJsonSafe<T = unknown>(filePath: string): T | null;
+/**
+ * Write JSON file safely with atomic write
+ *
+ * @param filePath - Path to JSON file
+ * @param data - Data to write
+ * @returns true if successful, false otherwise
+ */
+export declare function writeJsonSafe(filePath: string, data: unknown): boolean;
+/**
+ * Append to log file (creates directory if needed)
+ *
+ * @param logPath - Path to log file
+ * @param message - Message to append
+ */
+export declare function appendLog(logPath: string, message: string): void;
+/**
+ * Cross-platform file locking using directory creation
+ *
+ * mkdir is atomic on all platforms (Windows, macOS, Linux)
+ */
+export declare class FileLock {
+    private lockDir;
+    private pidFile;
+    private acquired;
+    constructor(lockPath: string);
+    /**
+     * Try to acquire lock
+     *
+     * @param staleLockSeconds - Consider lock stale after this many seconds
+     * @returns true if lock acquired, false if held by another process
+     */
+    acquire(staleLockSeconds?: number): boolean;
+    /**
+     * Release the lock
+     */
+    release(): void;
+}
+/**
+ * Hook result interface (matches Claude Code hook protocol)
+ */
+export interface HookResult {
+    continue: boolean;
+    systemMessage?: string;
+    error?: string;
+}
+/**
+ * Output hook result to stdout
+ */
+export declare function outputHookResult(result: HookResult): void;
+/**
+ * Consume stdin (required for hooks that receive input)
+ */
+export declare function consumeStdin(): Promise<string>;
+//# sourceMappingURL=platform.d.ts.map

package/dist/src/hooks/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../../src/hooks/platform.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAS,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlE;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAaD;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAKtC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAUD,wBAAgB,cAAc,IAAI,SAAS,CAyB1C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAa/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,YAAiB,GACzB,YAAY,GAAG,IAAI,CAoBrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,MAAM,EAAO,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,YAAY,GAAG,IAAI,CA8BrB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAUpE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAetE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAYhE;AAED;;;;GAIG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAK5B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB,SAAM,GAAG,OAAO;IA2CxC;;OAEG;IACH,OAAO,IAAI,IAAI;CAUhB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAepD"}

package/dist/src/hooks/platform.js

@@ -0,0 +1,325 @@
+/**
+ * Cross-Platform Hook Utilities
+ *
+ * Provides platform detection and process spawning for Windows, macOS, and Linux.
+ * Optimized for hook execution with minimal overhead.
+ *
+ * @module hooks/platform
+ */
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Cached platform info (computed once at module load)
+ */
+const platformInfo = {
+    platform: process.platform,
+    isWindows: process.platform === 'win32',
+    isMacOS: process.platform === 'darwin',
+    isLinux: process.platform === 'linux',
+    isPosix: process.platform !== 'win32',
+};
+/**
+ * Get normalized platform identifier
+ */
+export function getPlatform() {
+    if (platformInfo.isWindows)
+        return 'windows';
+    if (platformInfo.isMacOS)
+        return 'macos';
+    if (platformInfo.isLinux)
+        return 'linux';
+    return 'unknown';
+}
+/**
+ * Check if running on Windows
+ */
+export function isWindows() {
+    return platformInfo.isWindows;
+}
+/**
+ * Check if running on POSIX system (macOS, Linux)
+ */
+export function isPosix() {
+    return platformInfo.isPosix;
+}
+/**
+ * Check WSL availability on Windows
+ *
+ * Checks for WSL installation without requiring it.
+ * Returns cached result for performance.
+ */
+let wslStatusCache = null;
+export function checkWslStatus() {
+    if (wslStatusCache !== null) {
+        return wslStatusCache;
+    }
+    if (!platformInfo.isWindows) {
+        wslStatusCache = { available: false };
+        return wslStatusCache;
+    }
+    try {
+        // Check if wsl.exe exists
+        const wslPath = path.join(process.env.SYSTEMROOT || 'C:\\Windows', 'System32', 'wsl.exe');
+        if (!fs.existsSync(wslPath)) {
+            wslStatusCache = { available: false };
+            return wslStatusCache;
+        }
+        // WSL exists - we could check version but keep it simple for now
+        wslStatusCache = { available: true };
+        return wslStatusCache;
+    }
+    catch {
+        wslStatusCache = { available: false };
+        return wslStatusCache;
+    }
+}
+/**
+ * Find project root by looking for .specweave directory
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Project root path or null if not found
+ */
+export function findProjectRoot(startDir = process.cwd()) {
+    let current = path.resolve(startDir);
+    const root = path.parse(current).root;
+    while (current !== root) {
+        const specweavePath = path.join(current, '.specweave');
+        if (fs.existsSync(specweavePath) && fs.statSync(specweavePath).isDirectory()) {
+            return current;
+        }
+        current = path.dirname(current);
+    }
+    return null;
+}
+/**
+ * Spawn a detached background process (cross-platform)
+ *
+ * On Windows: Uses 'start' command or direct spawn with detached option
+ * On POSIX: Uses spawn with detached + unref
+ *
+ * @param command - Command to run
+ * @param args - Arguments
+ * @param options - Spawn options
+ * @returns ChildProcess or null if spawn failed
+ */
+export function spawnDetached(command, args = [], options = {}) {
+    try {
+        const spawnOptions = {
+            ...options,
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: true,
+        };
+        // Direct spawn with detached + windowsHide works on all platforms
+        // On Windows: windowsHide prevents console window, detached allows orphaning
+        // On POSIX: detached creates new process group, unref allows parent to exit
+        // NOTE: Previously used cmd.exe /c start /b on Windows, but that has
+        // argument escaping issues and loses exit codes. Direct spawn is more reliable.
+        const child = spawn(command, args, spawnOptions);
+        child.unref();
+        return child;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Spawn Node.js script in background (cross-platform)
+ *
+ * Optimized for spawning Node.js scripts as background daemons.
+ *
+ * @param scriptPath - Path to the Node.js script
+ * @param args - Arguments to pass to the script
+ * @param cwd - Working directory
+ * @returns ChildProcess or null if spawn failed
+ */
+export function spawnNodeBackground(scriptPath, args = [], cwd) {
+    const nodeExecutable = process.execPath; // Use same Node.js that's running this script
+    try {
+        const spawnOptions = {
+            cwd: cwd || process.cwd(),
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: true,
+            env: {
+                ...process.env,
+                SPECWEAVE_BACKGROUND_PROCESS: '1',
+            },
+        };
+        if (platformInfo.isWindows) {
+            // On Windows, spawn node directly with detached
+            // The windowsHide option prevents console window
+            const child = spawn(nodeExecutable, [scriptPath, ...args], spawnOptions);
+            child.unref();
+            return child;
+        }
+        else {
+            // On POSIX, standard detached spawn
+            const child = spawn(nodeExecutable, [scriptPath, ...args], spawnOptions);
+            child.unref();
+            return child;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read JSON file safely with error handling
+ *
+ * @param filePath - Path to JSON file
+ * @returns Parsed JSON or null if failed
+ */
+export function readJsonSafe(filePath) {
+    try {
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write JSON file safely with atomic write
+ *
+ * @param filePath - Path to JSON file
+ * @param data - Data to write
+ * @returns true if successful, false otherwise
+ */
+export function writeJsonSafe(filePath, data) {
+    try {
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Atomic write: write to temp file, then rename
+        const tempPath = `${filePath}.tmp.${process.pid}`;
+        fs.writeFileSync(tempPath, JSON.stringify(data, null, 2), 'utf-8');
+        fs.renameSync(tempPath, filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Append to log file (creates directory if needed)
+ *
+ * @param logPath - Path to log file
+ * @param message - Message to append
+ */
+export function appendLog(logPath, message) {
+    try {
+        const dir = path.dirname(logPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const timestamp = new Date().toISOString().substring(11, 19); // HH:MM:SS
+        fs.appendFileSync(logPath, `[${timestamp}] ${message}\n`, 'utf-8');
+    }
+    catch {
+        // Silently ignore log failures
+    }
+}
+/**
+ * Cross-platform file locking using directory creation
+ *
+ * mkdir is atomic on all platforms (Windows, macOS, Linux)
+ */
+export class FileLock {
+    constructor(lockPath) {
+        this.acquired = false;
+        this.lockDir = lockPath + '.lock.d';
+        this.pidFile = path.join(this.lockDir, 'pid');
+    }
+    /**
+     * Try to acquire lock
+     *
+     * @param staleLockSeconds - Consider lock stale after this many seconds
+     * @returns true if lock acquired, false if held by another process
+     */
+    acquire(staleLockSeconds = 300) {
+        try {
+            // Try atomic mkdir
+            fs.mkdirSync(this.lockDir);
+            fs.writeFileSync(this.pidFile, String(process.pid), 'utf-8');
+            this.acquired = true;
+            return true;
+        }
+        catch (err) {
+            if (err.code !== 'EEXIST') {
+                return false;
+            }
+            // Lock exists - check if stale
+            try {
+                const lockPid = parseInt(fs.readFileSync(this.pidFile, 'utf-8').trim(), 10);
+                // Check if process is still running
+                if (!isNaN(lockPid)) {
+                    try {
+                        process.kill(lockPid, 0); // Signal 0 just checks existence
+                        return false; // Process is running, lock is valid
+                    }
+                    catch {
+                        // Process not running, check age
+                    }
+                }
+                // Check lock age
+                const stat = fs.statSync(this.pidFile);
+                const ageSeconds = (Date.now() - stat.mtimeMs) / 1000;
+                if (ageSeconds > staleLockSeconds) {
+                    // Stale lock - remove and retry
+                    fs.rmSync(this.lockDir, { recursive: true, force: true });
+                    return this.acquire(staleLockSeconds);
+                }
+                return false;
+            }
+            catch {
+                return false;
+            }
+        }
+    }
+    /**
+     * Release the lock
+     */
+    release() {
+        if (this.acquired) {
+            try {
+                fs.rmSync(this.lockDir, { recursive: true, force: true });
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            this.acquired = false;
+        }
+    }
+}
+/**
+ * Output hook result to stdout
+ */
+export function outputHookResult(result) {
+    console.log(JSON.stringify(result));
+}
+/**
+ * Consume stdin (required for hooks that receive input)
+ */
+export async function consumeStdin() {
+    return new Promise((resolve) => {
+        let data = '';
+        process.stdin.setEncoding('utf-8');
+        process.stdin.on('data', (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on('end', () => {
+            resolve(data);
+        });
+        // Handle case where stdin is empty/closed
+        if (process.stdin.isTTY) {
+            resolve('');
+        }
+    });
+}
+//# sourceMappingURL=platform.js.map

package/dist/src/hooks/platform.js.map

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

package/dist/src/hooks/processor.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Background Event Processor (Cross-Platform)
+ *
+ * Processes queued events asynchronously, routes to specialized handlers.
+ * Works on Windows, macOS, and Linux without WSL requirement.
+ *
+ * Usage: node processor.js [--daemon]
+ *
+ * Event routing:
+ * - increment.created/done/archived/reopened -> living-specs-handler
+ * - user-story.completed/reopened -> status-line-handler
+ * - task.updated/spec.updated -> living-docs-handler (legacy)
+ *
+ * Self-terminates after 60s of idle
+ *
+ * @module hooks/processor
+ */
+export {};
+//# sourceMappingURL=processor.d.ts.map

package/dist/src/hooks/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../../../src/hooks/processor.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG"}