ai-sdlc 0.2.0-alpha.5 → 0.2.0-alpha.50

package/dist/agents/single-task.js

@@ -0,0 +1,357 @@
+import { spawnSync } from 'child_process';
+import { createHash } from 'crypto';
+import { runAgentQuery } from '../core/client.js';
+import { getLogger } from '../core/logger.js';
+/**
+ * System prompt for single-task implementation agent
+ * Focused instructions without full story context
+ */
+export const TASK_AGENT_SYSTEM_PROMPT = `You are a senior software engineer executing a single implementation task.
+
+Your job is to:
+1. Read and understand the task description
+2. Review the existing code in the target files
+3. Make the necessary changes to satisfy the task requirements
+4. Follow the project conventions strictly
+5. Write clean, maintainable code that follows existing patterns
+
+CRITICAL RULES:
+- Modify ONLY the files listed in the task context
+- If you need a file that's not provided, state this clearly in your output
+- Do NOT create new files unless explicitly listed in the task
+- Follow the acceptance criteria relevant to this task
+- Ensure your changes are focused and minimal (do what's needed, nothing more)
+
+When complete, provide a brief summary of:
+- What you changed
+- Which files you modified
+- Any issues or missing dependencies encountered`;
+/**
+ * Build minimal context prompt for a single task
+ */
+export function buildTaskPrompt(context) {
+    const { task, acceptanceCriteria, existingFiles, projectPatterns } = context;
+    let prompt = `# Implementation Task\n\n`;
+    prompt += `**Task ID:** ${task.id}\n`;
+    prompt += `**Description:** ${task.description}\n\n`;
+    // Add existing files
+    if (existingFiles.length > 0) {
+        prompt += `## Target Files\n\n`;
+        for (const file of existingFiles) {
+            prompt += `### ${file.path}\n\n`;
+            prompt += `\`\`\`\n${file.content}\n\`\`\`\n\n`;
+        }
+    }
+    else {
+        prompt += `## Target Files\n\nNo existing files provided. You may need to create new files as specified in the task.\n\n`;
+    }
+    // Add relevant acceptance criteria
+    if (acceptanceCriteria.length > 0) {
+        prompt += `## Acceptance Criteria\n\n`;
+        for (const ac of acceptanceCriteria) {
+            prompt += `- ${ac}\n`;
+        }
+        prompt += `\n`;
+    }
+    // Add project conventions (enforce max length)
+    if (projectPatterns) {
+        const MAX_PATTERN_LENGTH = 2000; // ~500 tokens
+        let patterns = projectPatterns;
+        if (patterns.length > MAX_PATTERN_LENGTH) {
+            console.warn(`projectPatterns truncated from ${patterns.length} to ${MAX_PATTERN_LENGTH} characters`);
+            patterns = patterns.substring(0, MAX_PATTERN_LENGTH) + '\n\n[... truncated for length]';
+        }
+        prompt += `## Project Conventions\n\n${patterns}\n\n`;
+    }
+    prompt += `## Instructions\n\n`;
+    prompt += `1. Implement the task by modifying the files listed above\n`;
+    prompt += `2. Follow the project conventions strictly\n`;
+    prompt += `3. Ensure your changes satisfy the relevant acceptance criteria\n`;
+    prompt += `4. Report if you need additional files not provided\n\n`;
+    prompt += `Proceed with the implementation.`;
+    return prompt;
+}
+/**
+ * Detect if agent modified files outside the declared scope
+ */
+export function detectScopeViolation(declaredFiles, actualFiles) {
+    const violations = actualFiles.filter((f) => !declaredFiles.includes(f));
+    return violations.length > 0 ? violations : undefined;
+}
+/**
+ * Get current git diff hash to detect changes
+ */
+function getCurrentDiffHash(workingDir) {
+    const result = spawnSync('git', ['diff', 'HEAD'], {
+        cwd: workingDir,
+        encoding: 'utf8',
+        maxBuffer: 50 * 1024 * 1024,
+    });
+    if (result.error) {
+        throw new Error(`Failed to get git diff: ${result.error.message}`);
+    }
+    const diff = result.stdout || '';
+    return createHash('sha256').update(diff).digest('hex');
+}
+/**
+ * Get list of files changed in working directory
+ */
+function getChangedFiles(workingDir) {
+    const result = spawnSync('git', ['diff', '--name-only', 'HEAD'], {
+        cwd: workingDir,
+        encoding: 'utf8',
+    });
+    if (result.error) {
+        throw new Error(`Failed to get changed files: ${result.error.message}`);
+    }
+    const files = (result.stdout || '')
+        .split('\n')
+        .map((f) => f.trim())
+        .filter((f) => f.length > 0);
+    return files;
+}
+/**
+ * Validate file paths to prevent command injection
+ * Throws an error if any path contains suspicious characters or patterns
+ */
+export function validateFilePaths(paths) {
+    // Shell metacharacters that could be used for injection
+    const dangerousChars = /[;|&`$()<>]/;
+    for (const path of paths) {
+        // Check for shell metacharacters
+        if (dangerousChars.test(path)) {
+            throw new Error(`Invalid file path "${path}": contains shell metacharacters that could be used for command injection`);
+        }
+        // Check for directory traversal attempts
+        if (path.includes('..')) {
+            throw new Error(`Invalid file path "${path}": directory traversal is not allowed`);
+        }
+        // Ensure path starts with expected directories (basic sanity check)
+        // Allow: src/, tests/, dist/, .ai-sdlc/, or relative paths starting with ./
+        const validPrefixes = ['src/', 'tests/', 'dist/', '.ai-sdlc/', './', ''];
+        const hasValidPrefix = validPrefixes.some((prefix) => path.startsWith(prefix) || path === prefix.slice(0, -1));
+        if (!hasValidPrefix && !path.match(/^[a-zA-Z0-9_.-]+$/)) {
+            throw new Error(`Invalid file path "${path}": must start with an expected directory (src/, tests/, etc.) or be a simple filename`);
+        }
+    }
+}
+/**
+ * Detect test files related to changed modules
+ * Checks for co-located .test.ts files
+ */
+function detectTestFiles(filesChanged) {
+    const testFiles = new Set();
+    for (const file of filesChanged) {
+        // Check for co-located test files (e.g., foo.ts -> foo.test.ts)
+        if (file.endsWith('.ts') || file.endsWith('.tsx')) {
+            const testFile = file.replace(/\.(ts|tsx)$/, '.test.$1');
+            testFiles.add(testFile);
+        }
+    }
+    return Array.from(testFiles);
+}
+/**
+ * Verify changes using TypeScript, ESLint, and tests
+ */
+export async function verifyChanges(filesChanged, workingDir) {
+    const errors = [];
+    let testsRun = false;
+    if (filesChanged.length === 0) {
+        return { passed: true, errors: [], testsRun: false };
+    }
+    // Validate file paths to prevent command injection
+    try {
+        validateFilePaths(filesChanged);
+    }
+    catch (error) {
+        errors.push(`Path validation failed: ${error.message}`);
+        return { passed: false, errors, testsRun: false };
+    }
+    // Run TypeScript type checking
+    // NOTE: TypeScript doesn't support true per-file checking - it always checks the whole project
+    // to ensure type safety across module boundaries. This is a TypeScript limitation.
+    const tscResult = spawnSync('npx', ['tsc', '--noEmit'], {
+        cwd: workingDir,
+        encoding: 'utf8',
+    });
+    if (tscResult.status !== 0) {
+        const stderr = tscResult.stderr || tscResult.stdout || '';
+        if (stderr.trim()) {
+            errors.push(`TypeScript errors (whole project checked):\n${stderr}`);
+        }
+    }
+    // Run ESLint on changed files
+    const tsFiles = filesChanged.filter((f) => f.endsWith('.ts') || f.endsWith('.tsx'));
+    if (tsFiles.length > 0) {
+        const eslintResult = spawnSync('npx', ['eslint', ...tsFiles], {
+            cwd: workingDir,
+            encoding: 'utf8',
+        });
+        if (eslintResult.status !== 0) {
+            const stderr = eslintResult.stderr || eslintResult.stdout || '';
+            if (stderr.trim()) {
+                errors.push(`ESLint errors:\n${stderr}`);
+            }
+        }
+    }
+    // Run tests for changed modules
+    const testFiles = detectTestFiles(filesChanged);
+    if (testFiles.length > 0) {
+        // Check if test files actually exist before running
+        const testResult = spawnSync('npm', ['test', '--', ...testFiles], {
+            cwd: workingDir,
+            encoding: 'utf8',
+        });
+        testsRun = true;
+        if (testResult.status !== 0) {
+            const stderr = testResult.stderr || testResult.stdout || '';
+            if (stderr.trim()) {
+                errors.push(`Test failures:\n${stderr}`);
+            }
+        }
+    }
+    else {
+        errors.push('No tests detected for changed files');
+    }
+    return {
+        passed: errors.length === 0,
+        errors,
+        testsRun,
+    };
+}
+/**
+ * Detect missing dependencies or files mentioned in agent output
+ * Scans for phrases indicating the agent needs additional files
+ */
+export function detectMissingDependencies(agentOutput) {
+    const missingFiles = [];
+    const lines = agentOutput.split('\n');
+    // Keywords that indicate missing dependencies
+    const keywords = ['need', 'missing file', 'not provided', 'required file', 'cannot find'];
+    for (const line of lines) {
+        const lowerLine = line.toLowerCase();
+        // Check if line contains any missing dependency keywords
+        if (keywords.some((keyword) => lowerLine.includes(keyword))) {
+            // Try to extract file paths from the line
+            // Match common path patterns: src/foo.ts, ./foo.ts, foo.ts, etc.
+            // Note: Order extensions from longest to shortest to avoid partial matches (json before js, tsx before ts)
+            const pathMatches = line.match(/[\w/./-]+\.(json|tsx|jsx|ts|js)/g);
+            if (pathMatches) {
+                missingFiles.push(...pathMatches);
+            }
+        }
+    }
+    return missingFiles.length > 0 ? missingFiles : undefined;
+}
+/**
+ * Parse agent output and construct structured result
+ */
+export async function parseTaskResult(agentOutput, task, workingDir) {
+    const logger = getLogger();
+    try {
+        // Get files actually changed
+        const filesChanged = getChangedFiles(workingDir);
+        // Detect scope violations
+        const declaredFiles = task.files || [];
+        const scopeViolation = detectScopeViolation(declaredFiles, filesChanged);
+        // Detect missing dependencies from agent output
+        const missingDependencies = detectMissingDependencies(agentOutput);
+        // Run verification on changed files
+        const verification = await verifyChanges(filesChanged, workingDir);
+        // Determine overall success
+        const success = verification.passed && filesChanged.length > 0;
+        const result = {
+            success,
+            task,
+            filesChanged,
+            verificationPassed: verification.passed,
+            agentOutput,
+            scopeViolation,
+            missingDependencies,
+        };
+        if (!verification.passed) {
+            result.error = verification.errors.join('\n\n');
+        }
+        else if (filesChanged.length === 0) {
+            result.error = 'No files were modified';
+            result.success = false;
+        }
+        logger.debug('single-task', 'Task result parsed', {
+            taskId: task.id,
+            success,
+            filesChanged: filesChanged.length,
+            verificationPassed: verification.passed,
+            hasScopeViolation: !!scopeViolation,
+            hasMissingDependencies: !!missingDependencies,
+        });
+        return result;
+    }
+    catch (error) {
+        // Git operation failed - this is an environment issue
+        logger.error('single-task', 'Git operation failed during result parsing', {
+            error: error.message,
+        });
+        return {
+            success: false,
+            task,
+            filesChanged: [],
+            verificationPassed: false,
+            agentOutput,
+            error: `Git operation failed: ${error.message}`,
+        };
+    }
+}
+/**
+ * Execute a single implementation task with minimal context
+ */
+export async function runSingleTaskAgent(context, options) {
+    const logger = getLogger();
+    const { task, workingDirectory } = context;
+    logger.info('single-task', `Starting task ${task.id}: ${task.description}`);
+    // Build focused prompt
+    const prompt = buildTaskPrompt(context);
+    // Handle dry run
+    if (options?.dryRun) {
+        logger.info('single-task', 'DRY RUN MODE - Prompt generated but not executed');
+        logger.debug('single-task', 'Generated prompt', { prompt });
+        return {
+            success: false,
+            task,
+            filesChanged: [],
+            verificationPassed: false,
+            error: 'Dry run - no execution performed',
+            agentOutput: prompt,
+        };
+    }
+    try {
+        // Execute agent query
+        const agentOutput = await runAgentQuery({
+            prompt,
+            systemPrompt: TASK_AGENT_SYSTEM_PROMPT,
+            workingDirectory,
+            timeout: options?.timeout,
+            onProgress: options?.onProgress,
+        });
+        // Parse and return structured result
+        const result = await parseTaskResult(agentOutput, task, workingDirectory);
+        if (result.success) {
+            logger.info('single-task', `Task ${task.id} completed successfully`);
+        }
+        else {
+            logger.warn('single-task', `Task ${task.id} failed`, { error: result.error });
+        }
+        return result;
+    }
+    catch (error) {
+        logger.error('single-task', `Task ${task.id} execution failed`, { error: error.message });
+        return {
+            success: false,
+            task,
+            filesChanged: [],
+            verificationPassed: false,
+            error: error.message || 'Unknown error during task execution',
+            agentOutput: undefined,
+        };
+    }
+}
+//# sourceMappingURL=single-task.js.map

package/dist/agents/single-task.js.map

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

package/dist/agents/state-assessor.d.ts

@@ -9,13 +9,13 @@ import { StateAssessment, Action } from '../types/index.js';
  * In the future, this could use an LLM to make smarter decisions about
  * prioritization and workflow optimization.
  */
-export declare function runStateAssessor(sdlcRoot: string): StateAssessment;
+export declare function runStateAssessor(sdlcRoot: string): Promise<StateAssessment>;
 /**
  * Get the next recommended action
  */
-export declare function getNextAction(sdlcRoot: string): Action | null;
+export declare function getNextAction(sdlcRoot: string): Promise<Action | null>;
 /**
  * Check if there's any work to be done
  */
-export declare function hasWork(sdlcRoot: string): boolean;
+export declare function hasWork(sdlcRoot: string): Promise<boolean>;
 //# sourceMappingURL=state-assessor.d.ts.map

package/dist/agents/state-assessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-assessor.d.ts","sourceRoot":"","sources":["../../src/agents/state-assessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG5D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAElE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGjD"}
+{"version":3,"file":"state-assessor.d.ts","sourceRoot":"","sources":["../../src/agents/state-assessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG5D;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAEjF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG5E;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGhE"}

package/dist/agents/state-assessor.js

@@ -9,21 +9,21 @@ import { assessState } from '../core/kanban.js';
  * In the future, this could use an LLM to make smarter decisions about
  * prioritization and workflow optimization.
  */
-export function runStateAssessor(sdlcRoot) {
-    return assessState(sdlcRoot);
+export async function runStateAssessor(sdlcRoot) {
+    return await assessState(sdlcRoot);
 }
 /**
  * Get the next recommended action
  */
-export function getNextAction(sdlcRoot) {
-    const assessment = assessState(sdlcRoot);
+export async function getNextAction(sdlcRoot) {
+    const assessment = await assessState(sdlcRoot);
     return assessment.recommendedActions[0] || null;
 }
 /**
  * Check if there's any work to be done
  */
-export function hasWork(sdlcRoot) {
-    const assessment = assessState(sdlcRoot);
+export async function hasWork(sdlcRoot) {
+    const assessment = await assessState(sdlcRoot);
     return assessment.recommendedActions.length > 0;
 }
 //# sourceMappingURL=state-assessor.js.map

package/dist/agents/state-assessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-assessor.js","sourceRoot":"","sources":["../../src/agents/state-assessor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,UAAU,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"state-assessor.js","sourceRoot":"","sources":["../../src/agents/state-assessor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,OAAO,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAAgB;IAC5C,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,UAAU,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;AAClD,CAAC"}

package/dist/agents/test-pattern-detector.d.ts

@@ -0,0 +1,49 @@
+import { ReviewIssue } from '../types/index.js';
+/**
+ * Extract function names from file content using regex patterns
+ * Supports: function declarations, arrow functions, const functions
+ *
+ * @param fileContent - Source code to analyze
+ * @returns Array of function names found in the file
+ */
+export declare function extractFunctionNames(fileContent: string): string[];
+/**
+ * Check if a function name matches legitimate test utility patterns
+ * Returns true if the function is a legitimate test helper (should NOT be flagged)
+ *
+ * Legitimate patterns:
+ * - Factory functions: create*, make*, build*, mock*, stub*, fake*
+ * - Setup/teardown: setup*, teardown*, before*, after*, cleanup*
+ * - Assertion helpers: assert*, expect*, verify*, check*, should*
+ * - Test data builders: with*, given*, having*
+ *
+ * @param functionName - Name of the function to check
+ * @returns true if legitimate test utility, false if potential anti-pattern
+ */
+export declare function isLegitimateTestUtility(functionName: string): boolean;
+/**
+ * Find the corresponding production file for a test file
+ * Handles both colocated tests and centralized test directories
+ *
+ * @param testFilePath - Absolute path to test file
+ * @returns Absolute path to production file, or null if not found
+ */
+export declare function findProductionFile(testFilePath: string): string | null;
+/**
+ * Analyze a single test file for duplication patterns
+ *
+ * @param testFilePath - Absolute path to test file
+ * @param testFileContent - Content of the test file
+ * @param productionFileContent - Content of the corresponding production file
+ * @returns Array of ReviewIssue objects for detected anti-patterns
+ */
+export declare function analyzeTestFile(testFilePath: string, testFileContent: string, productionFileContent: string): ReviewIssue[];
+/**
+ * Detect test duplication patterns across all test files in working directory
+ * Main entry point for the detection system
+ *
+ * @param workingDir - Project root directory
+ * @returns Array of ReviewIssue objects for all detected anti-patterns
+ */
+export declare function detectTestDuplicationPatterns(workingDir: string): Promise<ReviewIssue[]>;
+//# sourceMappingURL=test-pattern-detector.d.ts.map

package/dist/agents/test-pattern-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-pattern-detector.d.ts","sourceRoot":"","sources":["../../src/agents/test-pattern-detector.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAuBlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAiCrE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgCtE;AAyBD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,qBAAqB,EAAE,MAAM,GAC5B,WAAW,EAAE,CAqCf;AA8DD;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAiD9F"}