specweave 0.32.9 → 0.33.2

package/dist/src/utils/notification-manager.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Notification Manager - Cross-platform system notifications
+ *
+ * Sends native notifications on macOS, Linux, and Windows
+ */
+import { Logger } from './logger.js';
+export declare class NotificationManager {
+    private logger;
+    constructor(options?: {
+        logger?: Logger;
+    });
+    /**
+     * Sends a system notification (cross-platform)
+     *
+     * @param title - Notification title
+     * @param body - Notification message
+     * @param sound - Optional sound name (macOS only)
+     */
+    sendNotification(title: string, body: string, sound?: string): Promise<void>;
+    /**
+     * Sends notification on macOS using osascript
+     */
+    private sendMacOSNotification;
+    /**
+     * Sends notification on Linux using notify-send
+     */
+    private sendLinuxNotification;
+    /**
+     * Sends notification on Windows using PowerShell toast
+     */
+    private sendWindowsNotification;
+    /**
+     * Escapes string for AppleScript
+     */
+    private escapeForAppleScript;
+    /**
+     * Escapes string for shell
+     */
+    private escapeForShell;
+    /**
+     * Escapes string for PowerShell
+     */
+    private escapeForPowerShell;
+}
+//# sourceMappingURL=notification-manager.d.ts.map

package/dist/src/utils/notification-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-manager.d.ts","sourceRoot":"","sources":["../../../src/utils/notification-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AAEpD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAI7C;;;;;;OAMG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBlF;;OAEG;YACW,qBAAqB;IAmBnC;;OAEG;YACW,qBAAqB;IAqBnC;;OAEG;YACW,uBAAuB;IA2BrC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAG5B"}

package/dist/src/utils/notification-manager.js

@@ -0,0 +1,130 @@
+/**
+ * Notification Manager - Cross-platform system notifications
+ *
+ * Sends native notifications on macOS, Linux, and Windows
+ */
+import { exec } from 'child_process';
+import { consoleLogger } from './logger.js';
+export class NotificationManager {
+    constructor(options = {}) {
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Sends a system notification (cross-platform)
+     *
+     * @param title - Notification title
+     * @param body - Notification message
+     * @param sound - Optional sound name (macOS only)
+     */
+    async sendNotification(title, body, sound) {
+        const platform = process.platform;
+        try {
+            if (platform === 'darwin') {
+                await this.sendMacOSNotification(title, body, sound);
+            }
+            else if (platform === 'linux') {
+                await this.sendLinuxNotification(title, body);
+            }
+            else if (platform === 'win32') {
+                await this.sendWindowsNotification(title, body);
+            }
+            else {
+                this.logger.warn(`Notifications not supported on platform: ${platform}`);
+                this.logger.info(`[Notification] ${title}: ${body}`);
+            }
+        }
+        catch (err) {
+            this.logger.error('Failed to send notification:', err);
+            // Fallback to console
+            this.logger.info(`[Notification] ${title}: ${body}`);
+        }
+    }
+    /**
+     * Sends notification on macOS using osascript
+     */
+    async sendMacOSNotification(title, body, sound) {
+        return new Promise((resolve, reject) => {
+            const soundParam = sound ? ` sound name "${sound}"` : '';
+            const script = `display notification "${this.escapeForAppleScript(body)}" with title "${this.escapeForAppleScript(title)}"${soundParam}`;
+            exec(`osascript -e '${script}'`, (error) => {
+                if (error) {
+                    reject(error);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Sends notification on Linux using notify-send
+     */
+    async sendLinuxNotification(title, body) {
+        return new Promise((resolve, reject) => {
+            // Check if notify-send is available
+            exec('command -v notify-send', (error) => {
+                if (error) {
+                    this.logger.warn('notify-send not found, skipping notification');
+                    resolve();
+                    return;
+                }
+                exec(`notify-send "${this.escapeForShell(title)}" "${this.escapeForShell(body)}"`, (error) => {
+                    if (error) {
+                        reject(error);
+                    }
+                    else {
+                        resolve();
+                    }
+                });
+            });
+        });
+    }
+    /**
+     * Sends notification on Windows using PowerShell toast
+     */
+    async sendWindowsNotification(title, body) {
+        return new Promise((resolve, reject) => {
+            const script = `
+        [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null
+        [Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType = WindowsRuntime] | Out-Null
+
+        $template = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent([Windows.UI.Notifications.ToastTemplateType]::ToastText02)
+        $toastXml = [xml] $template.GetXml()
+        $toastXml.GetElementsByTagName("text")[0].AppendChild($toastXml.CreateTextNode("${this.escapeForPowerShell(title)}")) | Out-Null
+        $toastXml.GetElementsByTagName("text")[1].AppendChild($toastXml.CreateTextNode("${this.escapeForPowerShell(body)}")) | Out-Null
+
+        $xml = New-Object Windows.Data.Xml.Dom.XmlDocument
+        $xml.LoadXml($toastXml.OuterXml)
+        $toast = [Windows.UI.Notifications.ToastNotification]::new($xml)
+        [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier("SpecWeave").Show($toast)
+      `;
+            exec(`powershell -Command "${script}"`, (error) => {
+                if (error) {
+                    reject(error);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Escapes string for AppleScript
+     */
+    escapeForAppleScript(str) {
+        return str.replace(/"/g, '\\"').replace(/\\/g, '\\\\');
+    }
+    /**
+     * Escapes string for shell
+     */
+    escapeForShell(str) {
+        return str.replace(/"/g, '\\"').replace(/\$/g, '\\$');
+    }
+    /**
+     * Escapes string for PowerShell
+     */
+    escapeForPowerShell(str) {
+        return str.replace(/"/g, '`"').replace(/\$/g, '`$');
+    }
+}
+//# sourceMappingURL=notification-manager.js.map

package/dist/src/utils/notification-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-manager.js","sourceRoot":"","sources":["../../../src/utils/notification-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAU,aAAa,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,OAAO,mBAAmB;IAG9B,YAAY,UAA+B,EAAE;QAC3C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;IAChD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,gBAAgB,CAAC,KAAa,EAAE,IAAY,EAAE,KAAc;QAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAElC,IAAI,CAAC;YACH,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YACvD,CAAC;iBAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAChD,CAAC;iBAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4CAA4C,QAAQ,EAAE,CAAC,CAAC;gBACzE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;YACvD,sBAAsB;YACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CACjC,KAAa,EACb,IAAY,EACZ,KAAc;QAEd,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,gBAAgB,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,MAAM,GAAG,yBAAyB,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;YAEzI,IAAI,CAAC,iBAAiB,MAAM,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;gBACzC,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CAAC,KAAa,EAAE,IAAY;QAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,oCAAoC;YACpC,IAAI,CAAC,wBAAwB,EAAE,CAAC,KAAK,EAAE,EAAE;gBACvC,IAAI,KAAK,EAAE,CAAC;oBACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;oBACjE,OAAO,EAAE,CAAC;oBACV,OAAO;gBACT,CAAC;gBAED,IAAI,CAAC,gBAAgB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;oBAC3F,IAAI,KAAK,EAAE,CAAC;wBACV,MAAM,CAAC,KAAK,CAAC,CAAC;oBAChB,CAAC;yBAAM,CAAC;wBACN,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,uBAAuB,CAAC,KAAa,EAAE,IAAY;QAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG;;;;;;0FAMqE,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;0FAC/B,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC;;;;;;OAMjH,CAAC;YAEF,IAAI,CAAC,wBAAwB,MAAM,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;gBAChD,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,GAAW;QACtC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,GAAW;QAChC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,GAAW;QACrC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/src/utils/platform-utils.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Platform Utilities - Cross-platform OS operations
+ *
+ * Abstracts platform-specific operations for macOS, Linux, and Windows
+ * Enhanced for process lifecycle management with async API, logger injection,
+ * and system notifications
+ */
+import { Logger } from './logger.js';
+export type Platform = 'darwin' | 'linux' | 'win32';
+/**
+ * Gets the current platform
+ */
+export declare function getCurrentPlatform(): Platform;
+/**
+ * Checks if a process exists (cross-platform)
+ *
+ * @param pid - Process ID to check
+ * @returns true if process exists
+ */
+export declare function checkProcessExists(pid: number): boolean;
+/**
+ * Gets file modification time in seconds since epoch (cross-platform)
+ *
+ * @param filePath - Path to file
+ * @returns Modification time in seconds since epoch
+ */
+export declare function getFileMtime(filePath: string): number;
+/**
+ * Kills a process (cross-platform)
+ *
+ * @param pid - Process ID to kill
+ * @param signal - Signal to send (default: SIGTERM)
+ */
+export declare function killProcess(pid: number, signal?: string): void;
+/**
+ * Acquires a file lock using atomic directory creation (cross-platform)
+ *
+ * @param lockPath - Path to lock directory
+ * @returns true if lock acquired
+ */
+export declare function acquireFileLock(lockPath: string): boolean;
+export interface PlatformUtilsOptions {
+    logger?: Logger;
+}
+/**
+ * Enhanced cross-platform utility functions with async API and logger injection
+ */
+export declare class PlatformUtils {
+    private platform;
+    private logger;
+    constructor(options?: PlatformUtilsOptions);
+    /**
+     * Get current platform
+     */
+    getPlatform(): Platform;
+    /**
+     * Check if current platform is Windows
+     */
+    isWindows(): boolean;
+    /**
+     * Check if current platform is POSIX (macOS or Linux)
+     */
+    isPosix(): boolean;
+    /**
+     * Check if a process exists by PID (async)
+     *
+     * - macOS/Linux: kill -0 $pid (signal 0 = existence check)
+     * - Windows: tasklist /FI "PID eq $pid"
+     *
+     * @param pid Process ID to check
+     * @returns true if process exists, false otherwise
+     */
+    checkProcessExistsAsync(pid: number): Promise<boolean>;
+    /**
+     * Get file modification time (async, uses fs.stat for cross-platform)
+     *
+     * @param path File path
+     * @returns Modification time in seconds since epoch
+     */
+    getFileMtimeAsync(path: string): Promise<number>;
+    /**
+     * Acquire file lock using atomic mkdir (async)
+     *
+     * @param lockPath Path to lock directory
+     * @param timeoutMs Maximum time to wait for lock (default: 5000ms)
+     * @returns true if lock acquired, false if timeout
+     */
+    acquireFileLockAsync(lockPath: string, timeoutMs?: number): Promise<boolean>;
+    /**
+     * Release file lock (async)
+     *
+     * @param lockPath Path to lock directory
+     */
+    releaseFileLockAsync(lockPath: string): Promise<void>;
+    /**
+     * Kill process with signal (async)
+     *
+     * @param pid Process ID to kill
+     * @param signal Signal to send (default: SIGTERM)
+     */
+    killProcessAsync(pid: number, signal?: NodeJS.Signals): Promise<void>;
+    /**
+     * Kill process with graceful fallback (SIGTERM → SIGKILL)
+     *
+     * @param pid Process ID to kill
+     * @param gracePeriodMs Time to wait after SIGTERM before SIGKILL (default: 2000ms)
+     */
+    killProcessGracefully(pid: number, gracePeriodMs?: number): Promise<void>;
+    /**
+     * Send system notification
+     *
+     * - macOS: osascript (AppleScript)
+     * - Linux: notify-send (if available)
+     * - Windows: PowerShell toast notification
+     *
+     * Fails gracefully if notification system is unavailable
+     *
+     * @param title Notification title
+     * @param body Notification body text
+     */
+    sendNotification(title: string, body: string): Promise<void>;
+    /**
+     * macOS notification using osascript
+     */
+    private sendNotificationMacOS;
+    /**
+     * Linux notification using notify-send
+     */
+    private sendNotificationLinux;
+    /**
+     * Windows notification using PowerShell toast
+     */
+    private sendNotificationWindows;
+}
+export declare const platformUtils: PlatformUtils;
+//# sourceMappingURL=platform-utils.d.ts.map

package/dist/src/utils/platform-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/platform-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AAEpD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,QAAQ,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAevD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmBrD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAkB,GAAG,IAAI,CAUzE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWzD;AAID,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,oBAAyB;IAK9C;;OAEG;IACH,WAAW,IAAI,QAAQ;IAIvB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;;;;;;;OAQG;IACG,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA4B5D;;;;;OAKG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUtD;;;;;;OAMG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBxF;;;;OAIG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3D;;;;;OAKG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBtF;;;;;OAKG;IACG,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCrF;;;;;;;;;;;OAWG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelE;;OAEG;YACW,qBAAqB;IAOnC;;OAEG;YACW,qBAAqB;IAWnC;;OAEG;YACW,uBAAuB;CAiBtC;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/src/utils/platform-utils.js

@@ -0,0 +1,366 @@
+/**
+ * Platform Utilities - Cross-platform OS operations
+ *
+ * Abstracts platform-specific operations for macOS, Linux, and Windows
+ * Enhanced for process lifecycle management with async API, logger injection,
+ * and system notifications
+ */
+import { execSync } from 'child_process';
+import { stat, mkdir, rmdir } from 'fs/promises';
+import { consoleLogger } from './logger.js';
+/**
+ * Gets the current platform
+ */
+export function getCurrentPlatform() {
+    return process.platform;
+}
+/**
+ * Checks if a process exists (cross-platform)
+ *
+ * @param pid - Process ID to check
+ * @returns true if process exists
+ */
+export function checkProcessExists(pid) {
+    try {
+        if (process.platform === 'win32') {
+            const output = execSync(`tasklist /FI "PID eq ${pid}" /NH`, {
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            });
+            return output.includes(String(pid));
+        }
+        else {
+            execSync(`kill -0 ${pid}`, { stdio: 'ignore' });
+            return true;
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Gets file modification time in seconds since epoch (cross-platform)
+ *
+ * @param filePath - Path to file
+ * @returns Modification time in seconds since epoch
+ */
+export function getFileMtime(filePath) {
+    try {
+        if (process.platform === 'darwin') {
+            const output = execSync(`stat -f %m "${filePath}"`, { encoding: 'utf-8' });
+            return parseInt(output.trim(), 10);
+        }
+        else if (process.platform === 'win32') {
+            const output = execSync(`powershell -Command "(Get-Item '${filePath}').LastWriteTime.ToFileTimeUtc()"`, { encoding: 'utf-8' });
+            const fileTime = parseInt(output.trim(), 10);
+            return Math.floor((fileTime - 116444736000000000) / 10000000);
+        }
+        else {
+            const output = execSync(`stat -c %Y "${filePath}"`, { encoding: 'utf-8' });
+            return parseInt(output.trim(), 10);
+        }
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Kills a process (cross-platform)
+ *
+ * @param pid - Process ID to kill
+ * @param signal - Signal to send (default: SIGTERM)
+ */
+export function killProcess(pid, signal = 'SIGTERM') {
+    try {
+        if (process.platform === 'win32') {
+            execSync(`taskkill /F /PID ${pid}`, { stdio: 'ignore' });
+        }
+        else {
+            process.kill(pid, signal);
+        }
+    }
+    catch {
+        // Process may not exist, ignore
+    }
+}
+/**
+ * Acquires a file lock using atomic directory creation (cross-platform)
+ *
+ * @param lockPath - Path to lock directory
+ * @returns true if lock acquired
+ */
+export function acquireFileLock(lockPath) {
+    const fs = require('fs');
+    try {
+        fs.mkdirSync(lockPath, { recursive: false });
+        return true;
+    }
+    catch (err) {
+        if (err.code === 'EEXIST') {
+            return false; // Lock already exists
+        }
+        throw err;
+    }
+}
+/**
+ * Enhanced cross-platform utility functions with async API and logger injection
+ */
+export class PlatformUtils {
+    constructor(options = {}) {
+        this.platform = process.platform;
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Get current platform
+     */
+    getPlatform() {
+        return this.platform;
+    }
+    /**
+     * Check if current platform is Windows
+     */
+    isWindows() {
+        return this.platform === 'win32';
+    }
+    /**
+     * Check if current platform is POSIX (macOS or Linux)
+     */
+    isPosix() {
+        return this.platform === 'darwin' || this.platform === 'linux';
+    }
+    /**
+     * Check if a process exists by PID (async)
+     *
+     * - macOS/Linux: kill -0 $pid (signal 0 = existence check)
+     * - Windows: tasklist /FI "PID eq $pid"
+     *
+     * @param pid Process ID to check
+     * @returns true if process exists, false otherwise
+     */
+    async checkProcessExistsAsync(pid) {
+        try {
+            if (this.isWindows()) {
+                const output = execSync(`tasklist /FI "PID eq ${pid}" /NH`, {
+                    encoding: 'utf-8',
+                    stdio: ['pipe', 'pipe', 'ignore'],
+                    windowsHide: true
+                });
+                return output.includes(pid.toString());
+            }
+            else {
+                // Signal 0 = check existence without actually sending a signal
+                process.kill(pid, 0);
+                return true;
+            }
+        }
+        catch (err) {
+            if (err.code === 'ESRCH') {
+                // No such process
+                return false;
+            }
+            if (err.code === 'EPERM') {
+                // Process exists but we don't have permission to signal it
+                return true;
+            }
+            this.logger.error(`Error checking process ${pid}:`, err);
+            return false;
+        }
+    }
+    /**
+     * Get file modification time (async, uses fs.stat for cross-platform)
+     *
+     * @param path File path
+     * @returns Modification time in seconds since epoch
+     */
+    async getFileMtimeAsync(path) {
+        try {
+            const stats = await stat(path);
+            return Math.floor(stats.mtimeMs / 1000);
+        }
+        catch (err) {
+            this.logger.error(`Error getting mtime for ${path}:`, err);
+            throw err;
+        }
+    }
+    /**
+     * Acquire file lock using atomic mkdir (async)
+     *
+     * @param lockPath Path to lock directory
+     * @param timeoutMs Maximum time to wait for lock (default: 5000ms)
+     * @returns true if lock acquired, false if timeout
+     */
+    async acquireFileLockAsync(lockPath, timeoutMs = 5000) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeoutMs) {
+            try {
+                await mkdir(lockPath, { recursive: false });
+                return true; // Lock acquired
+            }
+            catch (err) {
+                if (err.code === 'EEXIST') {
+                    // Lock exists, wait and retry
+                    await new Promise(resolve => setTimeout(resolve, 100));
+                    continue;
+                }
+                this.logger.error(`Error acquiring lock at ${lockPath}:`, err);
+                throw err;
+            }
+        }
+        this.logger.warn(`Lock acquisition timeout after ${timeoutMs}ms: ${lockPath}`);
+        return false;
+    }
+    /**
+     * Release file lock (async)
+     *
+     * @param lockPath Path to lock directory
+     */
+    async releaseFileLockAsync(lockPath) {
+        try {
+            await rmdir(lockPath);
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                this.logger.error(`Error releasing lock at ${lockPath}:`, err);
+                throw err;
+            }
+        }
+    }
+    /**
+     * Kill process with signal (async)
+     *
+     * @param pid Process ID to kill
+     * @param signal Signal to send (default: SIGTERM)
+     */
+    async killProcessAsync(pid, signal = 'SIGTERM') {
+        try {
+            if (this.isWindows()) {
+                execSync(`taskkill /PID ${pid} /F`, {
+                    stdio: 'ignore',
+                    windowsHide: true
+                });
+                this.logger.debug(`Killed process ${pid} (Windows taskkill /F)`);
+            }
+            else {
+                process.kill(pid, signal);
+                this.logger.debug(`Killed process ${pid} with signal ${signal}`);
+            }
+        }
+        catch (err) {
+            if (err.code === 'ESRCH') {
+                this.logger.debug(`Process ${pid} doesn't exist (already terminated)`);
+                return;
+            }
+            this.logger.error(`Error killing process ${pid}:`, err);
+            throw err;
+        }
+    }
+    /**
+     * Kill process with graceful fallback (SIGTERM → SIGKILL)
+     *
+     * @param pid Process ID to kill
+     * @param gracePeriodMs Time to wait after SIGTERM before SIGKILL (default: 2000ms)
+     */
+    async killProcessGracefully(pid, gracePeriodMs = 2000) {
+        const exists = await this.checkProcessExistsAsync(pid);
+        if (!exists) {
+            this.logger.debug(`Process ${pid} doesn't exist, skipping kill`);
+            return;
+        }
+        try {
+            // Step 1: Send SIGTERM (graceful shutdown)
+            await this.killProcessAsync(pid, 'SIGTERM');
+            this.logger.debug(`Sent SIGTERM to process ${pid}, waiting ${gracePeriodMs}ms`);
+            // Step 2: Wait for grace period
+            await new Promise(resolve => setTimeout(resolve, gracePeriodMs));
+            // Step 3: Check if process still exists
+            const stillExists = await this.checkProcessExistsAsync(pid);
+            if (!stillExists) {
+                this.logger.debug(`Process ${pid} terminated gracefully after SIGTERM`);
+                return;
+            }
+            // Step 4: Force kill with SIGKILL
+            this.logger.warn(`Process ${pid} didn't terminate after SIGTERM, sending SIGKILL`);
+            await this.killProcessAsync(pid, 'SIGKILL');
+            this.logger.debug(`Sent SIGKILL to process ${pid}`);
+        }
+        catch (err) {
+            this.logger.error(`Error during graceful kill of process ${pid}:`, err);
+            throw err;
+        }
+    }
+    /**
+     * Send system notification
+     *
+     * - macOS: osascript (AppleScript)
+     * - Linux: notify-send (if available)
+     * - Windows: PowerShell toast notification
+     *
+     * Fails gracefully if notification system is unavailable
+     *
+     * @param title Notification title
+     * @param body Notification body text
+     */
+    async sendNotification(title, body) {
+        try {
+            if (this.platform === 'darwin') {
+                await this.sendNotificationMacOS(title, body);
+            }
+            else if (this.platform === 'linux') {
+                await this.sendNotificationLinux(title, body);
+            }
+            else if (this.platform === 'win32') {
+                await this.sendNotificationWindows(title, body);
+            }
+            this.logger.debug(`Sent notification: ${title}`);
+        }
+        catch (err) {
+            this.logger.warn(`Failed to send notification "${title}": ${err}`);
+        }
+    }
+    /**
+     * macOS notification using osascript
+     */
+    async sendNotificationMacOS(title, body) {
+        const escapedTitle = title.replace(/"/g, '\\"');
+        const escapedBody = body.replace(/"/g, '\\"');
+        const cmd = `osascript -e 'display notification "${escapedBody}" with title "${escapedTitle}"'`;
+        execSync(cmd, { stdio: 'ignore' });
+    }
+    /**
+     * Linux notification using notify-send
+     */
+    async sendNotificationLinux(title, body) {
+        try {
+            execSync('command -v notify-send', { stdio: 'ignore' });
+            const escapedTitle = title.replace(/"/g, '\\"');
+            const escapedBody = body.replace(/"/g, '\\"');
+            execSync(`notify-send "${escapedTitle}" "${escapedBody}"`, { stdio: 'ignore' });
+        }
+        catch (err) {
+            throw new Error('notify-send not available on this system');
+        }
+    }
+    /**
+     * Windows notification using PowerShell toast
+     */
+    async sendNotificationWindows(title, body) {
+        const escapedTitle = title.replace(/'/g, "''");
+        const escapedBody = body.replace(/'/g, "''");
+        const psScript = `
+      [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null;
+      $template = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent([Windows.UI.Notifications.ToastTemplateType]::ToastText02);
+      $xml = [xml]$template.GetXml();
+      $xml.GetElementsByTagName('text')[0].AppendChild($xml.CreateTextNode('${escapedTitle}')) | Out-Null;
+      $xml.GetElementsByTagName('text')[1].AppendChild($xml.CreateTextNode('${escapedBody}')) | Out-Null;
+      $toast = [Windows.UI.Notifications.ToastNotification]::new($xml);
+      [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('SpecWeave').Show($toast);
+    `;
+        execSync(`powershell -Command "${psScript}"`, {
+            stdio: 'ignore',
+            windowsHide: true
+        });
+    }
+}
+// Export singleton instance for convenience
+export const platformUtils = new PlatformUtils();
+//# sourceMappingURL=platform-utils.js.map