crewly 1.0.0

package/dist/backend/backend/src/services/quality/quality-gate.service.js

@@ -0,0 +1,388 @@
+/**
+ * Quality Gate Service
+ *
+ * Executes quality gates (typecheck, tests, build, lint) to verify
+ * code quality before task completion.
+ *
+ * @module services/quality/quality-gate.service
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import { parse as parseYAML } from 'yaml';
+import { LoggerService } from '../core/logger.service.js';
+import { MAX_GATE_OUTPUT_LENGTH, } from '../../types/quality-gate.types.js';
+import { DEFAULT_GATES } from '../../../../config/quality-gates/default-gates.js';
+const execAsync = promisify(exec);
+/**
+ * Service for running quality gates on code changes
+ *
+ * @example
+ * ```typescript
+ * const service = QualityGateService.getInstance();
+ * const results = await service.runAllGates('/path/to/project');
+ * if (results.allRequiredPassed) {
+ *   console.log('All gates passed!');
+ * }
+ * ```
+ */
+export class QualityGateService {
+    static instance = null;
+    logger;
+    /**
+     * Private constructor for singleton pattern
+     */
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('QualityGateService');
+    }
+    /**
+     * Gets the singleton instance
+     *
+     * @returns The QualityGateService instance
+     */
+    static getInstance() {
+        if (!QualityGateService.instance) {
+            QualityGateService.instance = new QualityGateService();
+        }
+        return QualityGateService.instance;
+    }
+    /**
+     * Clears the singleton instance (for testing)
+     */
+    static clearInstance() {
+        QualityGateService.instance = null;
+    }
+    /**
+     * Load gate configuration from project or use defaults
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate configuration
+     */
+    async loadConfig(projectPath) {
+        const configPath = path.join(projectPath, '.crewly', 'config', 'quality-gates.yaml');
+        try {
+            const content = await fs.readFile(configPath, 'utf-8');
+            const config = parseYAML(content);
+            this.logger.debug('Loaded project gate config', { projectPath });
+            return this.validateConfig(config);
+        }
+        catch {
+            this.logger.debug('No project gate config, using defaults', { projectPath });
+            return this.getDefaultConfig();
+        }
+    }
+    /**
+     * Run all gates according to configuration
+     *
+     * @param projectPath - Path to project directory
+     * @param options - Run options
+     * @returns Complete run results
+     */
+    async runAllGates(projectPath, options) {
+        const startTime = Date.now();
+        const config = await this.loadConfig(projectPath);
+        const results = [];
+        // Collect gates to run
+        let gatesToRun = [
+            ...config.required,
+            ...(options?.skipOptional ? [] : config.optional),
+            ...config.custom,
+        ];
+        // Filter if specific gates requested
+        if (options?.gateNames?.length) {
+            gatesToRun = gatesToRun.filter((g) => options.gateNames.includes(g.name));
+        }
+        // Get current branch for runOn filtering
+        const currentBranch = await this.getCurrentBranch(projectPath);
+        const filteredGates = gatesToRun.filter((g) => this.shouldRunGate(g, currentBranch));
+        // Track skipped gates
+        const skippedGates = gatesToRun.filter((g) => !this.shouldRunGate(g, currentBranch));
+        for (const gate of skippedGates) {
+            results.push({
+                name: gate.name,
+                passed: true,
+                required: gate.required,
+                duration: 0,
+                output: '',
+                exitCode: 0,
+                skipped: true,
+                skipReason: `Branch '${currentBranch}' does not match runOn patterns`,
+            });
+        }
+        this.logger.info('Running quality gates', {
+            projectPath,
+            gates: filteredGates.map((g) => g.name),
+            skipped: skippedGates.map((g) => g.name),
+        });
+        // Run gates
+        const runInParallel = options?.parallel ?? config.settings.runInParallel;
+        if (runInParallel) {
+            const gatePromises = filteredGates.map((gate) => this.runGate(gate, projectPath));
+            const gateResults = await Promise.all(gatePromises);
+            results.push(...gateResults);
+        }
+        else {
+            for (const gate of filteredGates) {
+                const result = await this.runGate(gate, projectPath);
+                results.push(result);
+                // Stop on first failure if configured
+                if (config.settings.stopOnFirstFailure && !result.passed && gate.required) {
+                    this.logger.warn('Stopping on first failure', { gate: gate.name });
+                    break;
+                }
+            }
+        }
+        // Calculate summary
+        const summary = this.calculateSummary(results);
+        const requiredFailed = results.filter((r) => !r.passed && r.required && !r.skipped).length;
+        const runResults = {
+            allRequiredPassed: requiredFailed === 0,
+            allPassed: summary.failed === 0,
+            results,
+            summary,
+            duration: Date.now() - startTime,
+            timestamp: new Date().toISOString(),
+        };
+        this.logger.info('Quality gates completed', {
+            allRequiredPassed: runResults.allRequiredPassed,
+            allPassed: runResults.allPassed,
+            duration: runResults.duration,
+            summary,
+        });
+        return runResults;
+    }
+    /**
+     * Run a single gate
+     *
+     * @param gate - Gate definition
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    async runGate(gate, projectPath) {
+        const startTime = Date.now();
+        this.logger.debug('Running gate', { name: gate.name, command: gate.command });
+        try {
+            // Build environment
+            const env = {
+                ...process.env,
+                ...gate.env,
+                CI: 'true', // Always set CI for consistent behavior
+            };
+            // Execute command with timeout
+            const { stdout, stderr } = await execAsync(gate.command, {
+                cwd: projectPath,
+                timeout: gate.timeout,
+                env,
+                maxBuffer: 10 * 1024 * 1024, // 10MB buffer
+            });
+            const output = this.truncateOutput(stdout + stderr);
+            const duration = Date.now() - startTime;
+            this.logger.info('Gate passed', { name: gate.name, duration });
+            return {
+                name: gate.name,
+                passed: true,
+                required: gate.required,
+                duration,
+                output,
+                exitCode: 0,
+            };
+        }
+        catch (error) {
+            const execError = error;
+            const output = this.truncateOutput((execError.stdout || '') + (execError.stderr || '') + (execError.message || ''));
+            // Check if it's a timeout
+            const isTimeout = execError.killed || execError.code === 'ETIMEDOUT';
+            const duration = Date.now() - startTime;
+            this.logger.warn('Gate failed', {
+                name: gate.name,
+                exitCode: execError.code,
+                isTimeout,
+                duration,
+            });
+            return {
+                name: gate.name,
+                passed: gate.allowFailure || false,
+                required: gate.required,
+                duration,
+                output,
+                exitCode: typeof execError.code === 'number' ? execError.code : 1,
+                error: isTimeout ? 'Command timed out' : (execError.message || 'Unknown error'),
+            };
+        }
+    }
+    /**
+     * Run typecheck gate with default settings
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    async runTypecheck(projectPath) {
+        const config = this.getDefaultConfig();
+        const gate = config.required.find((g) => g.name === 'typecheck');
+        if (!gate) {
+            throw new Error('Typecheck gate not found in default config');
+        }
+        return this.runGate(gate, projectPath);
+    }
+    /**
+     * Run tests gate with default settings
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    async runTests(projectPath) {
+        const config = this.getDefaultConfig();
+        const gate = config.required.find((g) => g.name === 'tests');
+        if (!gate) {
+            throw new Error('Tests gate not found in default config');
+        }
+        return this.runGate(gate, projectPath);
+    }
+    /**
+     * Run lint gate with default settings
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    async runLint(projectPath) {
+        const config = this.getDefaultConfig();
+        const gate = config.optional.find((g) => g.name === 'lint');
+        if (!gate) {
+            throw new Error('Lint gate not found in default config');
+        }
+        return this.runGate(gate, projectPath);
+    }
+    /**
+     * Run build gate with default settings
+     *
+     * @param projectPath - Path to project directory
+     * @returns Gate result
+     */
+    async runBuild(projectPath) {
+        const config = this.getDefaultConfig();
+        const gate = config.required.find((g) => g.name === 'build');
+        if (!gate) {
+            throw new Error('Build gate not found in default config');
+        }
+        return this.runGate(gate, projectPath);
+    }
+    /**
+     * Get the default gate configuration
+     *
+     * @returns Default gate config
+     */
+    getDefaultConfig() {
+        return DEFAULT_GATES;
+    }
+    /**
+     * Check if project has custom gate configuration
+     *
+     * @param projectPath - Path to project directory
+     * @returns True if custom config exists
+     */
+    async hasProjectConfig(projectPath) {
+        const configPath = path.join(projectPath, '.crewly', 'config', 'quality-gates.yaml');
+        try {
+            await fs.access(configPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if a gate should run based on branch patterns
+     *
+     * @param gate - Gate definition
+     * @param currentBranch - Current git branch name
+     * @returns Whether the gate should run
+     */
+    shouldRunGate(gate, currentBranch) {
+        if (!gate.runOn || gate.runOn.length === 0) {
+            return true;
+        }
+        return gate.runOn.some((pattern) => {
+            if (pattern.includes('*')) {
+                // Convert glob pattern to regex
+                const regexPattern = '^' + pattern.replace(/\*/g, '.*') + '$';
+                const regex = new RegExp(regexPattern);
+                return regex.test(currentBranch);
+            }
+            return pattern === currentBranch;
+        });
+    }
+    /**
+     * Get the current git branch
+     *
+     * @param projectPath - Path to project directory
+     * @returns Current branch name or 'unknown'
+     */
+    async getCurrentBranch(projectPath) {
+        try {
+            const { stdout } = await execAsync('git rev-parse --abbrev-ref HEAD', {
+                cwd: projectPath,
+            });
+            return stdout.trim();
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+    /**
+     * Truncate output to maximum length
+     *
+     * @param output - Output to truncate
+     * @param maxLength - Maximum length (default: MAX_GATE_OUTPUT_LENGTH)
+     * @returns Truncated output
+     */
+    truncateOutput(output, maxLength = MAX_GATE_OUTPUT_LENGTH) {
+        if (output.length <= maxLength) {
+            return output;
+        }
+        const half = Math.floor(maxLength / 2);
+        return (output.substring(0, half) +
+            '\n\n... [output truncated] ...\n\n' +
+            output.substring(output.length - half));
+    }
+    /**
+     * Validate and normalize gate configuration
+     *
+     * @param config - Raw configuration from YAML
+     * @returns Normalized gate configuration
+     */
+    validateConfig(config) {
+        const settings = config.settings;
+        const required = config.required;
+        const optional = config.optional;
+        const custom = config.custom;
+        return {
+            settings: {
+                runInParallel: settings?.runInParallel ?? false,
+                stopOnFirstFailure: settings?.stopOnFirstFailure ?? false,
+                timeout: settings?.timeout ?? 300000,
+            },
+            required: (required || []).map((g) => ({ ...g, required: true })),
+            optional: (optional || []).map((g) => ({ ...g, required: false })),
+            custom: custom || [],
+        };
+    }
+    /**
+     * Calculate summary statistics from results
+     *
+     * @param results - Array of gate results
+     * @returns Summary statistics
+     */
+    calculateSummary(results) {
+        const passed = results.filter((r) => r.passed && !r.skipped).length;
+        const failed = results.filter((r) => !r.passed && !r.skipped).length;
+        const skipped = results.filter((r) => r.skipped).length;
+        return {
+            total: results.length,
+            passed,
+            failed,
+            skipped,
+        };
+    }
+}
+//# sourceMappingURL=quality-gate.service.js.map

package/dist/backend/backend/src/services/quality/quality-gate.service.js.map

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

package/dist/backend/backend/src/services/session/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Session Module
+ *
+ * Provides session backend abstraction for terminal session management.
+ * This module enables switching between different session backends (PTY, tmux)
+ * without changing higher-level code.
+ *
+ * @module session
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createSessionBackend,
+ *   getSessionBackend,
+ *   type ISession,
+ *   type ISessionBackend,
+ *   type SessionOptions,
+ * } from './services/session';
+ *
+ * // Create or get the backend
+ * const backend = await createSessionBackend('pty');
+ *
+ * // Create a session
+ * const session = await backend.createSession('my-session', {
+ *   cwd: '/home/user/project',
+ *   command: '/bin/bash',
+ * });
+ *
+ * // Subscribe to output
+ * session.onData((data) => console.log(data));
+ *
+ * // Write to session
+ * session.write('ls -la\n');
+ * ```
+ */
+export type { ISession, ISessionBackend, SessionOptions, SessionBackendType, } from './session-backend.interface.js';
+export { DEFAULT_TERMINAL_COLS, DEFAULT_TERMINAL_ROWS, DEFAULT_SHELL, } from './session-backend.interface.js';
+export { createSessionBackend, getSessionBackend, getSessionBackendSync, getSessionBackendType, destroySessionBackend, isSessionBackendInitialized, resetSessionBackendFactory, setSessionBackendForTesting, } from './session-backend.factory.js';
+export { PtySession, PtySessionBackend, PtyTerminalBuffer } from './pty/index.js';
+export { SessionCommandHelper, createSessionCommandHelper, KEY_CODES, } from './session-command-helper.js';
+export { SessionStatePersistence, getSessionStatePersistence, resetSessionStatePersistence, } from './session-state-persistence.js';
+export type { PersistedSessionInfo, PersistedState } from './session-state-persistence.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/backend/src/services/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,YAAY,EACX,QAAQ,EACR,eAAe,EACf,cAAc,EACd,kBAAkB,GAClB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACN,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,GACb,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACN,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,GAC3B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGlF,OAAO,EACN,oBAAoB,EACpB,0BAA0B,EAC1B,SAAS,GACT,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACN,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,GAC5B,MAAM,gCAAgC,CAAC;AAExC,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/backend/backend/src/services/session/index.js

@@ -0,0 +1,46 @@
+/**
+ * Session Module
+ *
+ * Provides session backend abstraction for terminal session management.
+ * This module enables switching between different session backends (PTY, tmux)
+ * without changing higher-level code.
+ *
+ * @module session
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createSessionBackend,
+ *   getSessionBackend,
+ *   type ISession,
+ *   type ISessionBackend,
+ *   type SessionOptions,
+ * } from './services/session';
+ *
+ * // Create or get the backend
+ * const backend = await createSessionBackend('pty');
+ *
+ * // Create a session
+ * const session = await backend.createSession('my-session', {
+ *   cwd: '/home/user/project',
+ *   command: '/bin/bash',
+ * });
+ *
+ * // Subscribe to output
+ * session.onData((data) => console.log(data));
+ *
+ * // Write to session
+ * session.write('ls -la\n');
+ * ```
+ */
+// Re-export constants
+export { DEFAULT_TERMINAL_COLS, DEFAULT_TERMINAL_ROWS, DEFAULT_SHELL, } from './session-backend.interface.js';
+// Re-export factory functions
+export { createSessionBackend, getSessionBackend, getSessionBackendSync, getSessionBackendType, destroySessionBackend, isSessionBackendInitialized, resetSessionBackendFactory, setSessionBackendForTesting, } from './session-backend.factory.js';
+// Re-export PTY implementations
+export { PtySession, PtySessionBackend, PtyTerminalBuffer } from './pty/index.js';
+// Re-export session command helper
+export { SessionCommandHelper, createSessionCommandHelper, KEY_CODES, } from './session-command-helper.js';
+// Re-export session state persistence
+export { SessionStatePersistence, getSessionStatePersistence, resetSessionStatePersistence, } from './session-state-persistence.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/services/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../backend/src/services/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAUH,sBAAsB;AACtB,OAAO,EACN,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,GACb,MAAM,gCAAgC,CAAC;AAExC,8BAA8B;AAC9B,OAAO,EACN,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,GAC3B,MAAM,8BAA8B,CAAC;AAEtC,gCAAgC;AAChC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAElF,mCAAmC;AACnC,OAAO,EACN,oBAAoB,EACpB,0BAA0B,EAC1B,SAAS,GACT,MAAM,6BAA6B,CAAC;AAErC,sCAAsC;AACtC,OAAO,EACN,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,GAC5B,MAAM,gCAAgC,CAAC"}

package/dist/backend/backend/src/services/session/pty/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * PTY Session Module
+ *
+ * Exports PTY-based session implementations for terminal session management.
+ *
+ * @module pty
+ */
+export { PtySession } from './pty-session.js';
+export { PtySessionBackend } from './pty-session-backend.js';
+export { PtyTerminalBuffer } from './pty-terminal-buffer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/backend/src/services/session/pty/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/session/pty/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/backend/backend/src/services/session/pty/index.js

@@ -0,0 +1,11 @@
+/**
+ * PTY Session Module
+ *
+ * Exports PTY-based session implementations for terminal session management.
+ *
+ * @module pty
+ */
+export { PtySession } from './pty-session.js';
+export { PtySessionBackend } from './pty-session-backend.js';
+export { PtyTerminalBuffer } from './pty-terminal-buffer.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/services/session/pty/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/session/pty/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}