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

package/dist/core/llm-utils.js

@@ -0,0 +1,368 @@
+import { z } from 'zod';
+import yaml from 'js-yaml';
+import { getLogger } from './logger.js';
+/**
+ * Try to extract JSON directly from the response
+ */
+function tryDirectJson(response, schema) {
+    try {
+        const trimmed = response.trim();
+        // Must start with { or [ to be valid JSON
+        if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) {
+            return { success: false, error: 'Response does not start with JSON' };
+        }
+        const parsed = JSON.parse(trimmed);
+        const result = schema.safeParse(parsed);
+        if (result.success) {
+            return { success: true, data: result.data, strategy: 'direct_json' };
+        }
+        return {
+            success: false,
+            error: `Schema validation failed: ${result.error.message}`,
+        };
+    }
+    catch (e) {
+        return {
+            success: false,
+            error: `JSON parse error: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+/**
+ * Try to extract JSON from markdown code blocks
+ * Supports ```json, ```JSON, and plain ``` blocks
+ */
+function tryMarkdownJsonBlock(response, schema) {
+    // Match JSON in code blocks: ```json ... ``` or ``` ... ```
+    const codeBlockRegex = /```(?:json|JSON)?\s*\n?([\s\S]*?)```/g;
+    const matches = [...response.matchAll(codeBlockRegex)];
+    for (const match of matches) {
+        const content = match[1].trim();
+        if (!content)
+            continue;
+        try {
+            const parsed = JSON.parse(content);
+            const result = schema.safeParse(parsed);
+            if (result.success) {
+                return { success: true, data: result.data, strategy: 'markdown_json_block' };
+            }
+        }
+        catch {
+            // Try next match
+            continue;
+        }
+    }
+    return {
+        success: false,
+        error: 'No valid JSON found in markdown code blocks',
+    };
+}
+/**
+ * Try to extract JSON by stripping leading/trailing text
+ * Finds the first { and last } to extract potential JSON
+ */
+function tryStrippedJson(response, schema) {
+    const firstBrace = response.indexOf('{');
+    const lastBrace = response.lastIndexOf('}');
+    if (firstBrace === -1 || lastBrace === -1 || firstBrace >= lastBrace) {
+        // Try array format
+        const firstBracket = response.indexOf('[');
+        const lastBracket = response.lastIndexOf(']');
+        if (firstBracket === -1 || lastBracket === -1 || firstBracket >= lastBracket) {
+            return { success: false, error: 'No JSON object or array found in response' };
+        }
+        try {
+            const jsonStr = response.substring(firstBracket, lastBracket + 1);
+            const parsed = JSON.parse(jsonStr);
+            const result = schema.safeParse(parsed);
+            if (result.success) {
+                return { success: true, data: result.data, strategy: 'stripped_json' };
+            }
+            return {
+                success: false,
+                error: `Schema validation failed: ${result.error.message}`,
+            };
+        }
+        catch (e) {
+            return {
+                success: false,
+                error: `Stripped JSON parse error: ${e instanceof Error ? e.message : String(e)}`,
+            };
+        }
+    }
+    try {
+        const jsonStr = response.substring(firstBrace, lastBrace + 1);
+        const parsed = JSON.parse(jsonStr);
+        const result = schema.safeParse(parsed);
+        if (result.success) {
+            return { success: true, data: result.data, strategy: 'stripped_json' };
+        }
+        return {
+            success: false,
+            error: `Schema validation failed: ${result.error.message}`,
+        };
+    }
+    catch (e) {
+        return {
+            success: false,
+            error: `Stripped JSON parse error: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+/**
+ * Try to parse response as YAML
+ */
+function tryYamlFallback(response, schema) {
+    try {
+        // First try to extract YAML from code blocks
+        const yamlBlockRegex = /```(?:yaml|YAML|yml|YML)\s*\n?([\s\S]*?)```/g;
+        const matches = [...response.matchAll(yamlBlockRegex)];
+        for (const match of matches) {
+            const content = match[1].trim();
+            if (!content)
+                continue;
+            try {
+                const parsed = yaml.load(content);
+                const result = schema.safeParse(parsed);
+                if (result.success) {
+                    return { success: true, data: result.data, strategy: 'yaml_fallback' };
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        // Try parsing the whole response as YAML (after stripping obvious non-YAML parts)
+        // Skip lines that look like prose (sentences without colons)
+        const lines = response.split('\n');
+        const yamlLines = [];
+        let inYamlSection = false;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Start of YAML-like content
+            if (trimmed.includes(':') || trimmed.startsWith('-') || inYamlSection) {
+                yamlLines.push(line);
+                inYamlSection = true;
+            }
+            // Empty line might end YAML section if we haven't found valid content
+            if (trimmed === '' && yamlLines.length > 0) {
+                inYamlSection = false;
+            }
+        }
+        if (yamlLines.length > 0) {
+            const yamlContent = yamlLines.join('\n');
+            const parsed = yaml.load(yamlContent);
+            const result = schema.safeParse(parsed);
+            if (result.success) {
+                return { success: true, data: result.data, strategy: 'yaml_fallback' };
+            }
+        }
+        return { success: false, error: 'No valid YAML found in response' };
+    }
+    catch (e) {
+        return {
+            success: false,
+            error: `YAML parse error: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+/**
+ * Generate a clarification prompt for retry attempts
+ */
+function generateClarificationPrompt(schema, attemptNumber, lastError) {
+    // Get schema shape for the prompt
+    let schemaDescription = 'the expected JSON structure';
+    try {
+        if (schema instanceof z.ZodObject) {
+            const shape = schema.shape;
+            const fields = Object.keys(shape).join(', ');
+            schemaDescription = `an object with fields: ${fields}`;
+        }
+    }
+    catch {
+        // Fall back to generic description
+    }
+    return `Your previous response could not be parsed. Attempt ${attemptNumber} failed with: ${lastError}
+
+Please respond with ONLY valid JSON matching ${schemaDescription}.
+
+Rules:
+1. Start your response directly with { or [
+2. Do not include any text before or after the JSON
+3. Ensure all strings are properly escaped
+4. Ensure all required fields are present
+
+Try again:`;
+}
+/**
+ * Extract structured response from LLM output using multiple strategies
+ *
+ * Tries extraction strategies in order:
+ * 1. Direct JSON parse (response is pure JSON)
+ * 2. JSON within markdown code blocks (\`\`\`json ... \`\`\`)
+ * 3. JSON with leading/trailing text stripped
+ * 4. YAML format fallback
+ *
+ * If all strategies fail and retries are configured, prompts the LLM
+ * to try again with clearer instructions.
+ *
+ * @param response - Raw LLM response string
+ * @param schema - Zod schema to validate against
+ * @param options - Extraction options including retry configuration
+ * @returns ExtractionResult with success status, data, and metadata
+ *
+ * @example
+ * ```typescript
+ * const ReviewSchema = z.object({
+ *   passed: z.boolean(),
+ *   issues: z.array(z.object({
+ *     severity: z.enum(['blocker', 'critical', 'major', 'minor']),
+ *     description: z.string(),
+ *   })),
+ * });
+ *
+ * const result = await extractStructuredResponse(llmResponse, ReviewSchema, {
+ *   maxRetries: 2,
+ *   retryFn: async (prompt) => await callLLM(prompt),
+ * });
+ *
+ * if (result.success) {
+ *   console.log('Parsed review:', result.data);
+ * } else {
+ *   console.error('Failed to parse:', result.error);
+ * }
+ * ```
+ */
+export async function extractStructuredResponse(response, schema, options = {}) {
+    const { maxRetries = 0, retryFn, logOnFailure = true } = options;
+    const logger = getLogger();
+    // Store all errors for debugging
+    const errors = [];
+    // Strategy 1: Direct JSON
+    const directResult = tryDirectJson(response, schema);
+    if (directResult.success) {
+        return directResult;
+    }
+    errors.push(`direct_json: ${directResult.error}`);
+    // Strategy 2: Markdown JSON block
+    const markdownResult = tryMarkdownJsonBlock(response, schema);
+    if (markdownResult.success) {
+        return markdownResult;
+    }
+    errors.push(`markdown_json_block: ${markdownResult.error}`);
+    // Strategy 3: Stripped JSON
+    const strippedResult = tryStrippedJson(response, schema);
+    if (strippedResult.success) {
+        return strippedResult;
+    }
+    errors.push(`stripped_json: ${strippedResult.error}`);
+    // Strategy 4: YAML fallback
+    const yamlResult = tryYamlFallback(response, schema);
+    if (yamlResult.success) {
+        return yamlResult;
+    }
+    errors.push(`yaml_fallback: ${yamlResult.error}`);
+    // All strategies failed - try retries if configured
+    if (maxRetries > 0 && retryFn) {
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            logger.info('llm-utils', `Retry attempt ${attempt}/${maxRetries} for structured response extraction`);
+            const clarificationPrompt = generateClarificationPrompt(schema, attempt, errors[errors.length - 1]);
+            try {
+                const retryResponse = await retryFn(clarificationPrompt);
+                // Try all strategies again on retry response
+                const retryDirectResult = tryDirectJson(retryResponse, schema);
+                if (retryDirectResult.success) {
+                    return retryDirectResult;
+                }
+                const retryMarkdownResult = tryMarkdownJsonBlock(retryResponse, schema);
+                if (retryMarkdownResult.success) {
+                    return retryMarkdownResult;
+                }
+                const retryStrippedResult = tryStrippedJson(retryResponse, schema);
+                if (retryStrippedResult.success) {
+                    return retryStrippedResult;
+                }
+                const retryYamlResult = tryYamlFallback(retryResponse, schema);
+                if (retryYamlResult.success) {
+                    return retryYamlResult;
+                }
+                errors.push(`retry_${attempt}: All strategies failed`);
+            }
+            catch (e) {
+                errors.push(`retry_${attempt}: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+    }
+    // All attempts failed
+    const finalError = `All extraction strategies failed:\n${errors.join('\n')}`;
+    if (logOnFailure) {
+        logger.error('llm-utils', 'Failed to extract structured response', {
+            errors,
+            responsePreview: response.substring(0, 500),
+        });
+    }
+    return {
+        success: false,
+        error: finalError,
+        rawResponse: response,
+    };
+}
+/**
+ * Synchronous version of extractStructuredResponse without retry support
+ *
+ * Useful when you don't need retry functionality or are in a synchronous context.
+ *
+ * @param response - Raw LLM response string
+ * @param schema - Zod schema to validate against
+ * @param logOnFailure - Whether to log the raw response on failure (default: true)
+ * @returns ExtractionResult with success status, data, and metadata
+ */
+export function extractStructuredResponseSync(response, schema, logOnFailure = true) {
+    const logger = getLogger();
+    const errors = [];
+    // Strategy 1: Direct JSON
+    const directResult = tryDirectJson(response, schema);
+    if (directResult.success) {
+        return directResult;
+    }
+    errors.push(`direct_json: ${directResult.error}`);
+    // Strategy 2: Markdown JSON block
+    const markdownResult = tryMarkdownJsonBlock(response, schema);
+    if (markdownResult.success) {
+        return markdownResult;
+    }
+    errors.push(`markdown_json_block: ${markdownResult.error}`);
+    // Strategy 3: Stripped JSON
+    const strippedResult = tryStrippedJson(response, schema);
+    if (strippedResult.success) {
+        return strippedResult;
+    }
+    errors.push(`stripped_json: ${strippedResult.error}`);
+    // Strategy 4: YAML fallback
+    const yamlResult = tryYamlFallback(response, schema);
+    if (yamlResult.success) {
+        return yamlResult;
+    }
+    errors.push(`yaml_fallback: ${yamlResult.error}`);
+    // All attempts failed
+    const finalError = `All extraction strategies failed:\n${errors.join('\n')}`;
+    if (logOnFailure) {
+        logger.error('llm-utils', 'Failed to extract structured response', {
+            errors,
+            responsePreview: response.substring(0, 500),
+        });
+    }
+    return {
+        success: false,
+        error: finalError,
+        rawResponse: response,
+    };
+}
+// Export individual strategies for testing
+export const extractionStrategies = {
+    tryDirectJson,
+    tryMarkdownJsonBlock,
+    tryStrippedJson,
+    tryYamlFallback,
+};
+//# sourceMappingURL=llm-utils.js.map

package/dist/core/llm-utils.js.map

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

package/dist/core/logger.d.ts

@@ -0,0 +1,92 @@
+import { LogConfig } from '../types/index.js';
+/**
+ * Log entry structure for JSON Lines format
+ */
+export interface LogEntry {
+    timestamp: string;
+    level: 'debug' | 'info' | 'warn' | 'error';
+    category: string;
+    message: string;
+    data?: unknown;
+}
+/**
+ * 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 declare class Logger {
+    private projectRoot;
+    private config;
+    private logDir;
+    private currentLogFile;
+    constructor(projectRoot: string, config: LogConfig);
+    /**
+     * Ensure the log directory exists
+     */
+    private ensureLogDirectory;
+    /**
+     * Get the current log file path based on today's date
+     */
+    private getCurrentLogFile;
+    /**
+     * Check if the current log file needs rotation based on size
+     */
+    private needsRotation;
+    /**
+     * Rotate the log file by renaming it with a sequence number
+     */
+    private rotateLogFile;
+    /**
+     * Remove old log files beyond the retention limit
+     */
+    private cleanupOldFiles;
+    /**
+     * Check if the given level should be logged based on config
+     */
+    private shouldLog;
+    /**
+     * Write a log entry to the current log file
+     */
+    private write;
+    /**
+     * Create a log entry with common fields
+     */
+    private createEntry;
+    /**
+     * Log a debug message
+     */
+    debug(category: string, message: string, data?: unknown): void;
+    /**
+     * Log an info message
+     */
+    info(category: string, message: string, data?: unknown): void;
+    /**
+     * Log a warning message
+     */
+    warn(category: string, message: string, data?: unknown): void;
+    /**
+     * Log an error message
+     */
+    error(category: string, message: string, data?: unknown): void;
+    /**
+     * Get the path to the current log file
+     */
+    getLogFilePath(): string;
+    /**
+     * Get all log file paths
+     */
+    getLogFiles(): string[];
+}
+/**
+ * Initialize the global logger instance
+ */
+export declare function initLogger(projectRoot: string, config: LogConfig): Logger;
+/**
+ * Get the global logger instance (or create a disabled one if not initialized)
+ */
+export declare function getLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAYD;;;;;;;;GAQG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAuB;gBAEjC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS;IAUlD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyBvB;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,OAAO,CAAC,KAAK;IAiBb;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM9D;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM7D;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM7D;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM9D;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;CAcxB;AAKD;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAGzE;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAWlC"}