ai-sdlc 0.2.0-alpha.6 → 0.2.0-alpha.61

package/dist/core/logger.js

@@ -0,0 +1,221 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Log level priority for filtering
+ */
+const LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+/**
+ * Rolling file logger for ai-sdlc operations
+ *
+ * Features:
+ * - JSON Lines format (one JSON object per line)
+ * - Rolling by size (configurable, default 10MB)
+ * - Retains last N files (configurable, default 5)
+ * - Location: .ai-sdlc/logs/ai-sdlc-YYYY-MM-DD.log
+ */
+export class Logger {
+    projectRoot;
+    config;
+    logDir;
+    currentLogFile = null;
+    constructor(projectRoot, config) {
+        this.projectRoot = projectRoot;
+        this.config = config;
+        this.logDir = path.join(projectRoot, '.ai-sdlc', 'logs');
+        if (this.config.enabled) {
+            this.ensureLogDirectory();
+        }
+    }
+    /**
+     * Ensure the log directory exists
+     */
+    ensureLogDirectory() {
+        if (!fs.existsSync(this.logDir)) {
+            fs.mkdirSync(this.logDir, { recursive: true });
+        }
+    }
+    /**
+     * Get the current log file path based on today's date
+     */
+    getCurrentLogFile() {
+        const today = new Date().toISOString().split('T')[0]; // YYYY-MM-DD
+        return path.join(this.logDir, `ai-sdlc-${today}.log`);
+    }
+    /**
+     * Check if the current log file needs rotation based on size
+     */
+    needsRotation(logFile) {
+        if (!fs.existsSync(logFile)) {
+            return false;
+        }
+        const stats = fs.statSync(logFile);
+        const maxSizeBytes = this.config.maxFileSizeMb * 1024 * 1024;
+        return stats.size >= maxSizeBytes;
+    }
+    /**
+     * Rotate the log file by renaming it with a sequence number
+     */
+    rotateLogFile(logFile) {
+        const baseName = path.basename(logFile, '.log');
+        const dir = path.dirname(logFile);
+        // Find the next available sequence number
+        let seq = 1;
+        while (fs.existsSync(path.join(dir, `${baseName}.${seq}.log`))) {
+            seq++;
+        }
+        // Rename current file
+        fs.renameSync(logFile, path.join(dir, `${baseName}.${seq}.log`));
+        // Clean up old files
+        this.cleanupOldFiles();
+    }
+    /**
+     * Remove old log files beyond the retention limit
+     */
+    cleanupOldFiles() {
+        if (!fs.existsSync(this.logDir)) {
+            return;
+        }
+        const files = fs.readdirSync(this.logDir)
+            .filter(f => f.startsWith('ai-sdlc-') && f.endsWith('.log'))
+            .map(f => ({
+            name: f,
+            path: path.join(this.logDir, f),
+            mtime: fs.statSync(path.join(this.logDir, f)).mtime.getTime(),
+        }))
+            .sort((a, b) => b.mtime - a.mtime); // Newest first
+        // Keep only the configured number of files
+        const filesToDelete = files.slice(this.config.maxFiles);
+        for (const file of filesToDelete) {
+            try {
+                fs.unlinkSync(file.path);
+            }
+            catch {
+                // Ignore deletion errors
+            }
+        }
+    }
+    /**
+     * Check if the given level should be logged based on config
+     */
+    shouldLog(level) {
+        if (!this.config.enabled) {
+            return false;
+        }
+        return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[this.config.level];
+    }
+    /**
+     * Write a log entry to the current log file
+     */
+    write(entry) {
+        if (!this.config.enabled) {
+            return;
+        }
+        const logFile = this.getCurrentLogFile();
+        // Check for rotation
+        if (this.needsRotation(logFile)) {
+            this.rotateLogFile(logFile);
+        }
+        // Append log entry as JSON line
+        const line = JSON.stringify(entry) + '\n';
+        fs.appendFileSync(logFile, line, 'utf-8');
+    }
+    /**
+     * Create a log entry with common fields
+     */
+    createEntry(level, category, message, data) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            category,
+            message,
+        };
+        if (data !== undefined) {
+            entry.data = data;
+        }
+        return entry;
+    }
+    /**
+     * Log a debug message
+     */
+    debug(category, message, data) {
+        if (this.shouldLog('debug')) {
+            this.write(this.createEntry('debug', category, message, data));
+        }
+    }
+    /**
+     * Log an info message
+     */
+    info(category, message, data) {
+        if (this.shouldLog('info')) {
+            this.write(this.createEntry('info', category, message, data));
+        }
+    }
+    /**
+     * Log a warning message
+     */
+    warn(category, message, data) {
+        if (this.shouldLog('warn')) {
+            this.write(this.createEntry('warn', category, message, data));
+        }
+    }
+    /**
+     * Log an error message
+     */
+    error(category, message, data) {
+        if (this.shouldLog('error')) {
+            this.write(this.createEntry('error', category, message, data));
+        }
+    }
+    /**
+     * Get the path to the current log file
+     */
+    getLogFilePath() {
+        return this.getCurrentLogFile();
+    }
+    /**
+     * Get all log file paths
+     */
+    getLogFiles() {
+        if (!fs.existsSync(this.logDir)) {
+            return [];
+        }
+        return fs.readdirSync(this.logDir)
+            .filter(f => f.startsWith('ai-sdlc-') && f.endsWith('.log'))
+            .map(f => path.join(this.logDir, f))
+            .sort((a, b) => {
+            const statA = fs.statSync(a);
+            const statB = fs.statSync(b);
+            return statB.mtime.getTime() - statA.mtime.getTime();
+        });
+    }
+}
+// Singleton logger instance
+let globalLogger = null;
+/**
+ * Initialize the global logger instance
+ */
+export function initLogger(projectRoot, config) {
+    globalLogger = new Logger(projectRoot, config);
+    return globalLogger;
+}
+/**
+ * Get the global logger instance (or create a disabled one if not initialized)
+ */
+export function getLogger() {
+    if (!globalLogger) {
+        // Return a disabled logger if not initialized
+        globalLogger = new Logger(process.cwd(), {
+            enabled: false,
+            level: 'info',
+            maxFileSizeMb: 10,
+            maxFiles: 5,
+        });
+    }
+    return globalLogger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

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

package/dist/core/process-manager.d.ts

@@ -0,0 +1,15 @@
+import { ChildProcess } from 'child_process';
+export declare class ProcessManager {
+    private static instance;
+    private children;
+    private isCleaningUp;
+    private constructor();
+    static getInstance(): ProcessManager;
+    static resetInstance(): void;
+    registerChild(child: ChildProcess): void;
+    getTrackedCount(): number;
+    killAll(signal?: NodeJS.Signals): void;
+    killAllWithTimeout(gracefulTimeoutMs?: number): Promise<void>;
+}
+export declare function setupGlobalCleanupHandlers(): void;
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/core/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../src/core/process-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,YAAY,CAAkB;IAEtC,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,cAAc;IAOpC,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAcxC,eAAe,IAAI,MAAM;IAIzB,OAAO,CAAC,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,IAAI;IAiB3C,kBAAkB,CAAC,iBAAiB,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAwD1E;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAkCjD"}

package/dist/core/process-manager.js

@@ -0,0 +1,132 @@
+export class ProcessManager {
+    static instance = null;
+    children = new Set();
+    isCleaningUp = false;
+    constructor() { }
+    static getInstance() {
+        if (!ProcessManager.instance) {
+            ProcessManager.instance = new ProcessManager();
+        }
+        return ProcessManager.instance;
+    }
+    static resetInstance() {
+        if (ProcessManager.instance) {
+            ProcessManager.instance.children.clear();
+            ProcessManager.instance.isCleaningUp = false;
+        }
+        ProcessManager.instance = null;
+    }
+    registerChild(child) {
+        if (!child || !child.pid)
+            return;
+        this.children.add(child);
+        const cleanup = () => {
+            this.children.delete(child);
+        };
+        child.once('exit', cleanup);
+        child.once('error', cleanup);
+        child.once('close', cleanup);
+    }
+    getTrackedCount() {
+        return this.children.size;
+    }
+    killAll(signal = 'SIGTERM') {
+        if (this.children.size === 0)
+            return;
+        const childrenToKill = Array.from(this.children);
+        for (const child of childrenToKill) {
+            if (child.pid && !child.killed) {
+                try {
+                    child.kill(signal);
+                }
+                catch {
+                    // Process may have already exited - ignore ESRCH errors
+                }
+            }
+            this.children.delete(child);
+        }
+    }
+    async killAllWithTimeout(gracefulTimeoutMs = 5000) {
+        if (this.children.size === 0)
+            return;
+        if (this.isCleaningUp)
+            return;
+        this.isCleaningUp = true;
+        try {
+            const childrenToKill = Array.from(this.children);
+            const killPromises = childrenToKill.map((child) => {
+                return new Promise((resolve) => {
+                    if (!child.pid || child.killed) {
+                        this.children.delete(child);
+                        resolve();
+                        return;
+                    }
+                    let resolved = false;
+                    const onExit = () => {
+                        if (!resolved) {
+                            resolved = true;
+                            this.children.delete(child);
+                            resolve();
+                        }
+                    };
+                    child.once('exit', onExit);
+                    child.once('close', onExit);
+                    try {
+                        child.kill('SIGTERM');
+                    }
+                    catch {
+                        // Ignore errors
+                    }
+                    setTimeout(() => {
+                        if (!resolved) {
+                            try {
+                                child.kill('SIGKILL');
+                            }
+                            catch {
+                                // Ignore errors
+                            }
+                            resolved = true;
+                            this.children.delete(child);
+                            resolve();
+                        }
+                    }, gracefulTimeoutMs);
+                });
+            });
+            await Promise.all(killPromises);
+        }
+        finally {
+            this.isCleaningUp = false;
+        }
+    }
+}
+export function setupGlobalCleanupHandlers() {
+    const processManager = ProcessManager.getInstance();
+    process.on('exit', () => {
+        processManager.killAll('SIGKILL');
+    });
+    process.on('SIGTERM', () => {
+        processManager.killAll('SIGTERM');
+        setTimeout(() => {
+            processManager.killAll('SIGKILL');
+            process.exit(0);
+        }, 5000);
+    });
+    process.on('SIGINT', () => {
+        processManager.killAll('SIGTERM');
+        setTimeout(() => {
+            processManager.killAll('SIGKILL');
+            process.exit(0);
+        }, 5000);
+    });
+    process.on('uncaughtException', (err) => {
+        console.error('Uncaught exception:', err);
+        processManager.killAll('SIGKILL');
+        process.exit(1);
+    });
+    process.on('unhandledRejection', (reason) => {
+        console.error('Unhandled rejection:', reason);
+        processManager.killAll('SIGKILL');
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=process-manager.js.map

package/dist/core/process-manager.js.map

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

package/dist/core/story-logger.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Per-story logging for concurrent execution
+ *
+ * Each story execution creates a new timestamped log file with dual output
+ * (console + file) for debugging and audit trail.
+ */
+import { LogLevel } from '../types/index.js';
+/**
+ * Per-story logger that writes to timestamped files
+ *
+ * Features:
+ * - Dual output: console + timestamped file per execution
+ * - Automatic log rotation (keeps last N logs per story)
+ * - Crash-safe synchronous writes
+ * - Location: stories/{id}/logs/{timestamp}.log
+ */
+export declare class StoryLogger {
+    private logStream;
+    private storyId;
+    private logPath;
+    private closed;
+    /**
+     * Initialize a per-story logger
+     *
+     * @param storyId - Story ID (sanitized automatically)
+     * @param sdlcRoot - Path to .ai-sdlc directory
+     * @param maxLogs - Maximum number of log files to retain per story (default: 5)
+     */
+    constructor(storyId: string, sdlcRoot: string, maxLogs?: number);
+    /**
+     * Log a message with specified level
+     *
+     * Writes to both console and file. Sanitizes message to prevent issues
+     * with very long lines or non-printable characters.
+     *
+     * @param level - Log level (INFO, AGENT, ERROR, WARN, DEBUG)
+     * @param message - Message to log
+     */
+    log(level: LogLevel, message: string): void;
+    /**
+     * Close the log stream
+     *
+     * Should be called when story execution completes or on process exit.
+     * Flushes any buffered data and closes the file handle.
+     *
+     * @returns Promise that resolves when the stream is fully closed
+     */
+    close(): Promise<void>;
+    /**
+     * Get the path to the current log file
+     *
+     * @returns Absolute path to the current log file
+     */
+    getLogPath(): string;
+    /**
+     * Sanitize log message to prevent issues
+     *
+     * - Truncates messages longer than 10KB
+     * - Strips or escapes non-printable characters (except newlines/tabs)
+     * - Preserves ANSI color codes for console output
+     *
+     * @param message - Raw message to sanitize
+     * @returns Sanitized message
+     */
+    private sanitizeMessage;
+    /**
+     * Rotate old log files, keeping only the most recent N logs
+     *
+     * Sorting is lexicographic (filename-based) since timestamps are in ISO 8601 format.
+     * Deletes oldest logs beyond the retention limit.
+     *
+     * @param logDir - Directory containing log files
+     * @param keep - Number of logs to retain
+     */
+    private rotateOldLogs;
+}
+/**
+ * Get the latest log file path for a story
+ *
+ * @param sdlcRoot - Path to .ai-sdlc directory
+ * @param storyId - Story ID (sanitized automatically)
+ * @returns Path to latest log file, or null if no logs exist
+ */
+export declare function getLatestLogPath(sdlcRoot: string, storyId: string): string | null;
+/**
+ * Read the last N lines from a log file
+ *
+ * @param filePath - Path to log file
+ * @param lines - Number of lines to read (default: 50)
+ * @returns Last N lines as a string
+ */
+export declare function readLastLines(filePath: string, lines?: number): Promise<string>;
+/**
+ * Tail a log file (follow mode, like tail -f)
+ *
+ * Watches the file for changes and outputs new lines as they're written.
+ * Press Ctrl+C to exit.
+ *
+ * @param filePath - Path to log file
+ */
+export declare function tailLog(filePath: string): void;
+//# sourceMappingURL=story-logger.d.ts.map

package/dist/core/story-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-logger.d.ts","sourceRoot":"","sources":["../../src/core/story-logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAkB,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI7D;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAkB;IAEhC;;;;;;OAMG;gBACS,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,MAAU;IAwClE;;;;;;;;OAQG;IACH,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAwC3C;;;;;;;OAOG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IAgBvB;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;CAsBtB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBjF;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAKzF;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAiC9C"}