crewly 1.0.7 → 1.0.10

package/dist/backend/backend/src/services/quality/task-output-validator.service.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Task Output Validator Service
+ *
+ * Validates structured task output against JSON Schema definitions
+ * embedded in task markdown files. Uses ajv for schema validation.
+ *
+ * @module services/quality/task-output-validator.service
+ */
+import { type TaskOutputSchema, type TaskOutputValidationResult, type TaskOutputRetryInfo } from '../../types/task-output.types.js';
+/**
+ * Singleton service for validating task outputs against JSON Schema.
+ *
+ * @example
+ * ```typescript
+ * const validator = TaskOutputValidatorService.getInstance();
+ * const result = validator.validate({ summary: 'Done' }, schema);
+ * ```
+ */
+export declare class TaskOutputValidatorService {
+    private static instance;
+    private ajv;
+    private logger;
+    private constructor();
+    /**
+     * Get the singleton instance of TaskOutputValidatorService
+     *
+     * @returns The singleton instance
+     */
+    static getInstance(): TaskOutputValidatorService;
+    /**
+     * Clear the singleton instance (for testing)
+     */
+    static clearInstance(): void;
+    /**
+     * Validate output data against a JSON Schema
+     *
+     * @param output - The output object to validate
+     * @param schema - The JSON Schema to validate against
+     * @returns Validation result with errors if invalid
+     */
+    validate(output: Record<string, unknown>, schema: TaskOutputSchema): TaskOutputValidationResult;
+    /**
+     * Extract a TaskOutputSchema from a task markdown file's content.
+     * Looks for a fenced JSON code block under the ## Output Schema header.
+     *
+     * @param content - The full markdown content of a task file
+     * @returns The parsed schema, or null if none found
+     */
+    extractSchemaFromMarkdown(content: string): TaskOutputSchema | null;
+    /**
+     * Extract retry information from a task markdown file's content.
+     * Looks for structured data under the ## Output Validation Retry Info header.
+     *
+     * @param content - The full markdown content of a task file
+     * @returns The parsed retry info, or null if none found
+     */
+    extractRetryInfoFromMarkdown(content: string): TaskOutputRetryInfo | null;
+    /**
+     * Generate a markdown section containing the output schema
+     *
+     * @param schema - The schema to embed
+     * @returns Markdown string with the schema in a fenced code block
+     */
+    generateSchemaMarkdown(schema: TaskOutputSchema): string;
+    /**
+     * Generate a markdown section containing retry information
+     *
+     * @param retryInfo - The retry info to embed
+     * @returns Markdown string with the retry info in a fenced code block
+     */
+    generateRetryMarkdown(retryInfo: TaskOutputRetryInfo): string;
+    /**
+     * Validate output size against the maximum allowed size
+     *
+     * @param output - The output object to check
+     * @returns Object with valid flag, size in bytes, and optional error
+     */
+    validateOutputSize(output: Record<string, unknown>): {
+        valid: boolean;
+        sizeBytes: number;
+        error?: string;
+    };
+}
+//# sourceMappingURL=task-output-validator.service.d.ts.map

package/dist/backend/backend/src/services/quality/task-output-validator.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-output-validator.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/quality/task-output-validator.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EAEzB,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;GAQG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2C;IAClE,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO;IAKP;;;;OAIG;WACW,WAAW,IAAI,0BAA0B;IAOvD;;OAEG;WACW,aAAa,IAAI,IAAI;IAInC;;;;;;OAMG;IACI,QAAQ,CACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,gBAAgB,GACvB,0BAA0B;IAsB7B;;;;;;OAMG;IACI,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAsB1E;;;;;;OAMG;IACI,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAqBhF;;;;;OAKG;IACI,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;IAI/D;;;;;OAKG;IACI,qBAAqB,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM;IAIpE;;;;;OAKG;IACI,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAC1D,KAAK,EAAE,OAAO,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;CAeF"}

package/dist/backend/backend/src/services/quality/task-output-validator.service.js

@@ -0,0 +1,163 @@
+/**
+ * Task Output Validator Service
+ *
+ * Validates structured task output against JSON Schema definitions
+ * embedded in task markdown files. Uses ajv for schema validation.
+ *
+ * @module services/quality/task-output-validator.service
+ */
+import Ajv from 'ajv';
+import { LoggerService } from '../core/logger.service.js';
+import { TASK_OUTPUT_CONSTANTS, } from '../../types/task-output.types.js';
+/**
+ * Singleton service for validating task outputs against JSON Schema.
+ *
+ * @example
+ * ```typescript
+ * const validator = TaskOutputValidatorService.getInstance();
+ * const result = validator.validate({ summary: 'Done' }, schema);
+ * ```
+ */
+export class TaskOutputValidatorService {
+    static instance = null;
+    ajv;
+    logger;
+    constructor() {
+        this.ajv = new Ajv({ allErrors: true });
+        this.logger = LoggerService.getInstance().createComponentLogger('TaskOutputValidatorService');
+    }
+    /**
+     * Get the singleton instance of TaskOutputValidatorService
+     *
+     * @returns The singleton instance
+     */
+    static getInstance() {
+        if (!TaskOutputValidatorService.instance) {
+            TaskOutputValidatorService.instance = new TaskOutputValidatorService();
+        }
+        return TaskOutputValidatorService.instance;
+    }
+    /**
+     * Clear the singleton instance (for testing)
+     */
+    static clearInstance() {
+        TaskOutputValidatorService.instance = null;
+    }
+    /**
+     * Validate output data against a JSON Schema
+     *
+     * @param output - The output object to validate
+     * @param schema - The JSON Schema to validate against
+     * @returns Validation result with errors if invalid
+     */
+    validate(output, schema) {
+        try {
+            const valid = this.ajv.validate(schema, output);
+            if (valid) {
+                return { valid: true, errors: [] };
+            }
+            const errors = (this.ajv.errors || []).map((err) => {
+                const path = err.instancePath || '/';
+                return `${path}: ${err.message || 'unknown error'}`;
+            });
+            this.logger.debug('Output validation failed', { errors });
+            return { valid: false, errors };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.logger.error('Schema validation threw an error', { error: message });
+            return { valid: false, errors: [`Schema validation error: ${message}`] };
+        }
+    }
+    /**
+     * Extract a TaskOutputSchema from a task markdown file's content.
+     * Looks for a fenced JSON code block under the ## Output Schema header.
+     *
+     * @param content - The full markdown content of a task file
+     * @returns The parsed schema, or null if none found
+     */
+    extractSchemaFromMarkdown(content) {
+        const header = TASK_OUTPUT_CONSTANTS.SECTION_HEADERS.OUTPUT_SCHEMA;
+        const headerIndex = content.indexOf(header);
+        if (headerIndex === -1) {
+            return null;
+        }
+        // Find the fenced code block after the header
+        const afterHeader = content.substring(headerIndex + header.length);
+        const codeBlockMatch = afterHeader.match(/```json\s*\n([\s\S]*?)```/);
+        if (!codeBlockMatch) {
+            return null;
+        }
+        try {
+            return JSON.parse(codeBlockMatch[1].trim());
+        }
+        catch {
+            this.logger.warn('Failed to parse output schema from markdown');
+            return null;
+        }
+    }
+    /**
+     * Extract retry information from a task markdown file's content.
+     * Looks for structured data under the ## Output Validation Retry Info header.
+     *
+     * @param content - The full markdown content of a task file
+     * @returns The parsed retry info, or null if none found
+     */
+    extractRetryInfoFromMarkdown(content) {
+        const header = TASK_OUTPUT_CONSTANTS.SECTION_HEADERS.RETRY_INFO;
+        const headerIndex = content.indexOf(header);
+        if (headerIndex === -1) {
+            return null;
+        }
+        const afterHeader = content.substring(headerIndex + header.length);
+        const codeBlockMatch = afterHeader.match(/```json\s*\n([\s\S]*?)```/);
+        if (!codeBlockMatch) {
+            return null;
+        }
+        try {
+            return JSON.parse(codeBlockMatch[1].trim());
+        }
+        catch {
+            this.logger.warn('Failed to parse retry info from markdown');
+            return null;
+        }
+    }
+    /**
+     * Generate a markdown section containing the output schema
+     *
+     * @param schema - The schema to embed
+     * @returns Markdown string with the schema in a fenced code block
+     */
+    generateSchemaMarkdown(schema) {
+        return `\n\n${TASK_OUTPUT_CONSTANTS.SECTION_HEADERS.OUTPUT_SCHEMA}\n\n\`\`\`json\n${JSON.stringify(schema, null, 2)}\n\`\`\`\n`;
+    }
+    /**
+     * Generate a markdown section containing retry information
+     *
+     * @param retryInfo - The retry info to embed
+     * @returns Markdown string with the retry info in a fenced code block
+     */
+    generateRetryMarkdown(retryInfo) {
+        return `\n\n${TASK_OUTPUT_CONSTANTS.SECTION_HEADERS.RETRY_INFO}\n\n\`\`\`json\n${JSON.stringify(retryInfo, null, 2)}\n\`\`\`\n`;
+    }
+    /**
+     * Validate output size against the maximum allowed size
+     *
+     * @param output - The output object to check
+     * @returns Object with valid flag, size in bytes, and optional error
+     */
+    validateOutputSize(output) {
+        const serialized = JSON.stringify(output);
+        const sizeBytes = Buffer.byteLength(serialized, 'utf-8');
+        const maxSize = TASK_OUTPUT_CONSTANTS.MAX_OUTPUT_SIZE_BYTES;
+        if (sizeBytes > maxSize) {
+            return {
+                valid: false,
+                sizeBytes,
+                error: `Output size ${sizeBytes} bytes exceeds maximum ${maxSize} bytes`,
+            };
+        }
+        return { valid: true, sizeBytes };
+    }
+}
+//# sourceMappingURL=task-output-validator.service.js.map

package/dist/backend/backend/src/services/quality/task-output-validator.service.js.map

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

package/dist/backend/backend/src/services/runtime-adapter.d.ts

@@ -0,0 +1,254 @@
+/**
+ * Runtime Adapter Layer
+ *
+ * Provides a unified, pluggable interface for managing AI runtime sessions.
+ * Each adapter encapsulates the full lifecycle of a specific runtime (Claude Code,
+ * Gemini CLI, Codex): starting a session, writing input, reading output, and stopping.
+ *
+ * This replaces the need to coordinate between ISessionBackend, SessionCommandHelper,
+ * and RuntimeAgentService manually — the adapter handles it all.
+ *
+ * @module services/runtime-adapter
+ */
+import { type RuntimeType } from '../constants.js';
+import { RuntimeAgentService } from './agent/runtime-agent.service.abstract.js';
+import { type ISessionBackend, type SessionCommandHelper } from './session/index.js';
+/**
+ * Configuration for starting a new agent session via a runtime adapter.
+ *
+ * @example
+ * ```typescript
+ * const config: RuntimeAdapterConfig = {
+ *   sessionName: 'dev-agent-1',
+ *   projectPath: '/home/user/my-project',
+ *   runtimeFlags: ['--chrome'],
+ *   promptFilePath: '/tmp/prompt.md',
+ * };
+ * ```
+ */
+export interface RuntimeAdapterConfig {
+    /** Unique name for the PTY session */
+    sessionName: string;
+    /** Working directory for the agent */
+    projectPath: string;
+    /** Optional CLI flags injected before --dangerously-skip-permissions */
+    runtimeFlags?: string[];
+    /** Optional path to a system prompt file */
+    promptFilePath?: string;
+    /** Optional environment variables to set in the session shell */
+    env?: Record<string, string>;
+}
+/**
+ * Unified interface for AI runtime adapters.
+ *
+ * Each implementation wraps a specific runtime CLI (Claude Code, Gemini CLI, Codex)
+ * and provides a consistent API for managing agent sessions. Adapters handle the
+ * full lifecycle: session creation, runtime initialization, I/O, and teardown.
+ *
+ * @example
+ * ```typescript
+ * const adapter = getRuntimeAdapter('claude-code');
+ *
+ * await adapter.start({ sessionName: 'agent-1', projectPath: '/project' });
+ * await adapter.write('agent-1', 'Hello, build a REST API');
+ * const output = await adapter.getOutput('agent-1');
+ * await adapter.stop('agent-1');
+ * ```
+ */
+export interface RuntimeAdapter {
+    /** The runtime type this adapter handles */
+    readonly runtimeType: RuntimeType;
+    /** Human-readable display name for this runtime */
+    readonly displayName: string;
+    /**
+     * Start a new agent session.
+     *
+     * Creates a PTY session, sets environment variables, and launches the
+     * runtime CLI with the specified configuration.
+     *
+     * @param config - Session configuration
+     * @throws Error if session creation or runtime initialization fails
+     */
+    start(config: RuntimeAdapterConfig): Promise<void>;
+    /**
+     * Stop an agent session and clean up resources.
+     *
+     * @param sessionName - Name of the session to stop
+     * @throws Error if session does not exist
+     */
+    stop(sessionName: string): Promise<void>;
+    /**
+     * Write data to an agent session's stdin.
+     *
+     * @param sessionName - Name of the target session
+     * @param data - Data to write (sent via the session's shell)
+     * @throws Error if session does not exist
+     */
+    write(sessionName: string, data: string): Promise<void>;
+    /**
+     * Get recent output from an agent session.
+     *
+     * @param sessionName - Name of the target session
+     * @param lines - Number of recent lines to capture (default: 50)
+     * @returns Captured terminal output as a string
+     * @throws Error if session does not exist
+     */
+    getOutput(sessionName: string, lines?: number): Promise<string>;
+    /**
+     * Check if a session is currently running.
+     *
+     * @param sessionName - Name of the session to check
+     * @returns True if the session exists and is active
+     */
+    isRunning(sessionName: string): boolean;
+    /**
+     * Wait for the runtime CLI to become ready after initialization.
+     *
+     * Polls the session output for runtime-specific ready patterns.
+     *
+     * @param sessionName - Name of the session to monitor
+     * @param timeout - Maximum wait time in milliseconds (default: 60000)
+     * @returns True if runtime became ready within timeout, false otherwise
+     */
+    waitForReady(sessionName: string, timeout?: number): Promise<boolean>;
+    /**
+     * Detect if the runtime CLI is currently active in a session.
+     *
+     * Uses runtime-specific detection strategies (e.g., sending '/' to trigger
+     * a command palette and checking for output changes).
+     *
+     * @param sessionName - Name of the session to check
+     * @returns True if the runtime is detected as running
+     */
+    detectRuntime(sessionName: string): Promise<boolean>;
+    /**
+     * Trigger context window compaction for a session.
+     *
+     * Sends the runtime-specific compact/compress command to reduce context usage.
+     * Each runtime handles this differently:
+     * - Claude Code: `/compact` — LLM-based summarization
+     * - Gemini CLI: `/compress` — summarizer persona with context snapshots
+     * - Codex CLI: `/compact` — server-side opaque compaction
+     *
+     * @param sessionName - Name of the session to compact
+     * @returns True if the compact command was sent successfully
+     */
+    compact(sessionName: string): Promise<boolean>;
+}
+/**
+ * Base adapter that delegates to the existing RuntimeAgentService and ISessionBackend.
+ *
+ * Concrete adapters extend this class and provide their runtime type.
+ * The base handles all common operations — subclasses only need to override
+ * behavior that differs from the default.
+ */
+declare abstract class BaseRuntimeAdapter implements RuntimeAdapter {
+    abstract readonly runtimeType: RuntimeType;
+    abstract readonly displayName: string;
+    protected sessionBackend: ISessionBackend;
+    protected sessionHelper: SessionCommandHelper;
+    protected runtimeService: RuntimeAgentService;
+    constructor(sessionBackend: ISessionBackend, sessionHelper: SessionCommandHelper, runtimeService: RuntimeAgentService);
+    /**
+     * Start a new agent session with the runtime CLI.
+     *
+     * Creates a PTY shell, sets environment variables, and executes the
+     * runtime initialization script.
+     *
+     * @param config - Session start configuration
+     */
+    start(config: RuntimeAdapterConfig): Promise<void>;
+    /** @inheritdoc */
+    stop(sessionName: string): Promise<void>;
+    /** @inheritdoc */
+    write(sessionName: string, data: string): Promise<void>;
+    /** @inheritdoc */
+    getOutput(sessionName: string, lines?: number): Promise<string>;
+    /** @inheritdoc */
+    isRunning(sessionName: string): boolean;
+    /** @inheritdoc */
+    waitForReady(sessionName: string, timeout?: number): Promise<boolean>;
+    /** @inheritdoc */
+    detectRuntime(sessionName: string): Promise<boolean>;
+    /**
+     * Send the runtime-specific compact command to the session.
+     *
+     * @param sessionName - Name of the session to compact
+     * @returns True if the compact command was sent successfully
+     */
+    compact(sessionName: string): Promise<boolean>;
+}
+/**
+ * Adapter for Anthropic's Claude Code CLI.
+ *
+ * Full implementation — Claude Code is the default runtime.
+ * Handles Claude-specific initialization, detection (slash command palette),
+ * and MCP configuration.
+ */
+export declare class ClaudeCodeAdapter extends BaseRuntimeAdapter {
+    readonly runtimeType: "claude-code";
+    readonly displayName = "Claude Code";
+    /**
+     * Start a Claude Code session.
+     *
+     * Extends the base start with Claude-specific post-initialization
+     * (MCP server configuration).
+     *
+     * @param config - Session start configuration
+     */
+    start(config: RuntimeAdapterConfig): Promise<void>;
+}
+/**
+ * Adapter for Google's Gemini CLI.
+ *
+ * Stub implementation — basic structure in place for future development.
+ * Uses the base adapter behavior which delegates to GeminiRuntimeService.
+ */
+export declare class GeminiCliAdapter extends BaseRuntimeAdapter {
+    readonly runtimeType: "gemini-cli";
+    readonly displayName = "Gemini CLI";
+}
+/**
+ * Adapter for OpenAI's Codex CLI.
+ *
+ * Stub implementation — basic structure in place for future development.
+ * Uses the base adapter behavior which delegates to CodexRuntimeService.
+ */
+export declare class CodexAdapter extends BaseRuntimeAdapter {
+    readonly runtimeType: "codex-cli";
+    readonly displayName = "OpenAI Codex";
+}
+/**
+ * Creates a RuntimeAdapter for the specified runtime type.
+ *
+ * Uses the existing RuntimeServiceFactory and session backend to construct
+ * the appropriate adapter. Requires the session backend to be initialized
+ * first (via createSessionBackend()).
+ *
+ * @param runtimeType - The runtime type ('claude-code', 'gemini-cli', 'codex-cli')
+ * @param projectRoot - The project root directory (for runtime config resolution)
+ * @returns A RuntimeAdapter instance for the specified runtime
+ * @throws Error if session backend is not initialized or runtime type is unknown
+ *
+ * @example
+ * ```typescript
+ * const adapter = getRuntimeAdapter('claude-code', '/home/user/project');
+ * await adapter.start({ sessionName: 'agent-1', projectPath: '/project' });
+ * ```
+ */
+export declare function getRuntimeAdapter(runtimeType: RuntimeType, projectRoot: string): RuntimeAdapter;
+/**
+ * Returns the list of all supported runtime types.
+ *
+ * @returns Array of RuntimeType values
+ */
+export declare function getSupportedRuntimeTypes(): RuntimeType[];
+/**
+ * Checks whether a given string is a supported runtime type.
+ *
+ * @param value - The string to check
+ * @returns True if the value is a valid RuntimeType
+ */
+export declare function isSupportedRuntime(value: string): value is RuntimeType;
+export {};
+//# sourceMappingURL=runtime-adapter.d.ts.map

package/dist/backend/backend/src/services/runtime-adapter.d.ts.map

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