@krr2020/taskflow-core 0.1.0-beta.3 → 0.1.0-beta.5

package/dist/index.js

@@ -7,6 +7,7 @@ export * from "./cli/index.js";
 // Export command base (includes CommandContext and CommandResult)
 export * from "./commands/base.js";
 // Export all commands
+export * from "./commands/configure.js";
 export * from "./commands/init.js";
 export * from "./commands/prd/create.js";
 export * from "./commands/prd/generate-arch.js";
@@ -29,8 +30,13 @@ export * from "./lib/config-paths.js";
 export * from "./lib/data-access.js";
 // Export errors
 export * from "./lib/errors.js";
+export * from "./lib/file-validator.js";
 export * from "./lib/git.js";
+// Export log parser and file validator
+export * from "./lib/log-parser.js";
 export * from "./lib/output.js";
 export * from "./lib/retrospective.js";
 export { parseTaskId, STATUS_TRANSITIONS, TaskStatusSchema, } from "./lib/types.js";
 export * from "./lib/validation.js";
+// Export LLM providers
+export * from "./llm/index.js";

package/dist/lib/config-paths.d.ts

@@ -11,23 +11,23 @@ export declare function getProjectPaths(projectRoot: string): {
     configPath: string;
 };
 export declare const PROJECT_INDEX_FILE = "project-index.json";
-export declare const RETROSPECTIVE_FILE = "RETROSPECTIVE.md";
+export declare const RETROSPECTIVE_FILE = "retrospective.md";
 export declare const CONFIG_FILE = "taskflow.config.json";
 export declare const TEMPLATE_FILES: {
     readonly protocols: {
-        readonly aiProtocol: "protocols/AI-PROTOCOL.md";
-        readonly taskGenerator: "protocols/TASK-GENERATOR.md";
-        readonly taskExecutor: "protocols/TASK-EXECUTOR.md";
+        readonly aiProtocol: "protocols/ai-protocol.md";
+        readonly taskGenerator: "protocols/task-generator.md";
+        readonly taskExecutor: "protocols/task-executor.md";
     };
     readonly prd: {
-        readonly prdGenerator: "prd/PRD-GENERATOR.md";
+        readonly prdGenerator: "prd/prd-generator.md";
     };
     readonly project: {
-        readonly codingStandards: "project/CODING-STANDARDS.md";
-        readonly architectureRules: "project/ARCHITECTURE-RULES.md";
+        readonly codingStandards: "project/coding-standards.md";
+        readonly architectureRules: "project/architecture-rules.md";
     };
     readonly retrospective: {
-        readonly retrospective: "retrospective/RETROSPECTIVE.md";
+        readonly retrospective: "retrospective/retrospective.md";
     };
     readonly skills: {
         readonly backend: "skills/backend.md";
@@ -39,13 +39,13 @@ export declare const TEMPLATE_FILES: {
     };
 };
 export declare const REF_FILES: {
-    readonly aiProtocol: "AI-PROTOCOL.md";
-    readonly taskGenerator: "TASK-GENERATOR.md";
-    readonly taskExecutor: "TASK-EXECUTOR.md";
-    readonly prdGenerator: "PRD-GENERATOR.md";
-    readonly codingStandards: "CODING-STANDARDS.md";
-    readonly architectureRules: "ARCHITECTURE-RULES.md";
-    readonly retrospective: "RETROSPECTIVE.md";
+    readonly aiProtocol: "ai-protocol.md";
+    readonly taskGenerator: "task-generator.md";
+    readonly taskExecutor: "task-executor.md";
+    readonly prdGenerator: "prd-generator.md";
+    readonly codingStandards: "coding-standards.md";
+    readonly architectureRules: "architecture-rules.md";
+    readonly retrospective: "retrospective.md";
 };
 export declare const SKILL_FILES: {
     readonly backend: "skills/backend.md";

package/dist/lib/config-paths.js

@@ -25,26 +25,26 @@ export function getProjectPaths(projectRoot) {
 // File Names
 // ============================================================================
 export const PROJECT_INDEX_FILE = "project-index.json";
-export const RETROSPECTIVE_FILE = "RETROSPECTIVE.md";
+export const RETROSPECTIVE_FILE = "retrospective.md";
 export const CONFIG_FILE = "taskflow.config.json";
 // ============================================================================
 // Template Structure (source paths in package)
 // ============================================================================
 export const TEMPLATE_FILES = {
     protocols: {
-        aiProtocol: "protocols/AI-PROTOCOL.md",
-        taskGenerator: "protocols/TASK-GENERATOR.md",
-        taskExecutor: "protocols/TASK-EXECUTOR.md",
+        aiProtocol: "protocols/ai-protocol.md",
+        taskGenerator: "protocols/task-generator.md",
+        taskExecutor: "protocols/task-executor.md",
     },
     prd: {
-        prdGenerator: "prd/PRD-GENERATOR.md",
+        prdGenerator: "prd/prd-generator.md",
     },
     project: {
-        codingStandards: "project/CODING-STANDARDS.md",
-        architectureRules: "project/ARCHITECTURE-RULES.md",
+        codingStandards: "project/coding-standards.md",
+        architectureRules: "project/architecture-rules.md",
     },
     retrospective: {
-        retrospective: "retrospective/RETROSPECTIVE.md",
+        retrospective: "retrospective/retrospective.md",
     },
     skills: {
         backend: "skills/backend.md",
@@ -59,12 +59,12 @@ export const TEMPLATE_FILES = {
 // Reference Files (destination paths in user's .taskflow/ref directory)
 // ============================================================================
 export const REF_FILES = {
-    aiProtocol: "AI-PROTOCOL.md",
-    taskGenerator: "TASK-GENERATOR.md",
-    taskExecutor: "TASK-EXECUTOR.md",
-    prdGenerator: "PRD-GENERATOR.md",
-    codingStandards: "CODING-STANDARDS.md",
-    architectureRules: "ARCHITECTURE-RULES.md",
+    aiProtocol: "ai-protocol.md",
+    taskGenerator: "task-generator.md",
+    taskExecutor: "task-executor.md",
+    prdGenerator: "prd-generator.md",
+    codingStandards: "coding-standards.md",
+    architectureRules: "architecture-rules.md",
     retrospective: RETROSPECTIVE_FILE,
 };
 export const SKILL_FILES = {
@@ -118,7 +118,12 @@ export function getProjectIndexPath(tasksDir) {
     return path.join(tasksDir, PROJECT_INDEX_FILE);
 }
 export function getFeatureFilePath(tasksDir, featurePath) {
-    return path.join(tasksDir, featurePath, `${featurePath}.json`);
+    // If the path ends in .json, return it as is (relative to tasksDir)
+    if (featurePath.endsWith(".json")) {
+        return path.join(tasksDir, featurePath);
+    }
+    // Otherwise assume it's a directory and look for a json file with the same name as the directory
+    return path.join(tasksDir, featurePath, `${path.basename(featurePath)}.json`);
 }
 export function getRefFilePath(refDir, filename) {
     return path.join(refDir, filename);

package/dist/lib/file-validator.d.ts

@@ -0,0 +1,119 @@
+/**
+ * File Validator
+ * Validates code files using LLM to provide fix suggestions and guidance
+ */
+import type { LLMProvider } from "../llm/base.js";
+export interface ValidationResult {
+    /**
+     * File path
+     */
+    file: string;
+    /**
+     * Whether file passed validation
+     */
+    passed: boolean;
+    /**
+     * Issues found
+     */
+    issues: ValidationIssue[];
+    /**
+     * Suggestions for fixes
+     */
+    suggestions: string[];
+    /**
+     * Validation summary
+     */
+    summary: string;
+}
+export interface ValidationIssue {
+    /**
+     * Severity of the issue
+     */
+    severity: "error" | "warning" | "info";
+    /**
+     * Line number (if available)
+     */
+    line?: number;
+    /**
+     * Issue description
+     */
+    message: string;
+    /**
+     * Code or type of issue
+     */
+    code?: string;
+    /**
+     * Suggested fix
+     */
+    suggestedFix?: string;
+}
+export interface ValidatorOptions {
+    /**
+     * Provider to use for validation
+     */
+    provider: LLMProvider;
+    /**
+     * Whether to include context in validation
+     */
+    includeContext?: boolean;
+    /**
+     * Whether to provide fix suggestions
+     */
+    provideFixes?: boolean;
+    /**
+     * Maximum issues to report
+     */
+    maxIssues?: number;
+}
+/**
+ * File Validator class
+ * Validates code files using LLM for analysis and fix suggestions
+ */
+export declare class FileValidator {
+    private options;
+    constructor(options: ValidatorOptions);
+    /**
+     * Validate a file
+     */
+    validate(filePath: string): Promise<ValidationResult>;
+    /**
+     * Validate multiple files
+     */
+    validateFiles(filePaths: string[]): Promise<ValidationResult[]>;
+    /**
+     * Validate file content
+     */
+    validateContent(filePath: string, content: string): Promise<ValidationResult>;
+    /**
+     * Create validation prompt
+     */
+    private createValidationPrompt;
+    /**
+     * Truncate content to fit within context limits
+     */
+    private truncateContent;
+    /**
+     * Parse validation response from LLM
+     */
+    private parseValidationResponse;
+    /**
+     * Extract suggestions from issues
+     */
+    private extractSuggestions;
+    /**
+     * Create validation summary
+     */
+    private createSummary;
+    /**
+     * Create fallback result when LLM fails
+     */
+    private createFallbackResult;
+    /**
+     * Format validation result for display
+     */
+    formatResult(result: ValidationResult): string;
+    /**
+     * Format multiple validation results
+     */
+    formatResults(results: ValidationResult[]): string;
+}

package/dist/lib/file-validator.js

@@ -0,0 +1,291 @@
+/**
+ * File Validator
+ * Validates code files using LLM to provide fix suggestions and guidance
+ */
+import { readFile } from "node:fs/promises";
+/**
+ * File Validator class
+ * Validates code files using LLM for analysis and fix suggestions
+ */
+export class FileValidator {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Validate a file
+     */
+    async validate(filePath) {
+        const content = await readFile(filePath, "utf-8");
+        return this.validateContent(filePath, content);
+    }
+    /**
+     * Validate multiple files
+     */
+    async validateFiles(filePaths) {
+        const results = [];
+        for (const filePath of filePaths) {
+            const result = await this.validate(filePath);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Validate file content
+     */
+    async validateContent(filePath, content) {
+        const provider = this.options.provider;
+        // Create validation prompt
+        const messages = [
+            {
+                role: "user",
+                content: this.createValidationPrompt(filePath, content),
+            },
+        ];
+        try {
+            // Call LLM for validation
+            const response = await provider.generate(messages, {
+                maxTokens: 2000,
+                temperature: 0.3, // Lower temperature for more deterministic results
+            });
+            // Parse LLM response
+            const issues = this.parseValidationResponse(response.content);
+            const suggestions = this.extractSuggestions(issues);
+            // Determine if passed
+            const hasErrors = issues.some((i) => i.severity === "error");
+            const hasWarnings = issues.some((i) => i.severity === "warning");
+            const summary = this.createSummary(issues, filePath);
+            return {
+                file: filePath,
+                passed: !hasErrors && !hasWarnings,
+                issues,
+                suggestions,
+                summary,
+            };
+        }
+        catch (error) {
+            // Fallback to basic validation if LLM fails
+            return this.createFallbackResult(filePath, content, error);
+        }
+    }
+    /**
+     * Create validation prompt
+     */
+    createValidationPrompt(filePath, content) {
+        const fileName = filePath.split("/").pop() || "";
+        const fileExtension = fileName.split(".").pop() || "";
+        const prompt = `Analyze the following ${fileExtension} file and identify any issues:
+
+File: ${fileName}
+Path: ${filePath}
+
+\`\`\`$${fileExtension}
+${this.truncateContent(content)}
+\`\`\`
+
+Please provide:
+1. Any syntax errors or type errors
+2. Any logical errors or bugs
+3. Code quality issues (naming, complexity, etc.)
+4. Security concerns
+5. Performance concerns
+6. Suggested fixes for issues found
+
+Format your response as JSON:
+\`\`\`json
+{
+  "issues": [
+    {
+      "severity": "error" | "warning" | "info",
+      "line": number,
+      "message": string,
+      "code": string,
+      "suggestedFix": string
+    }
+  ],
+  "suggestions": ["string", "string"]
+}
+\`\`\`
+
+If no issues are found, respond with:
+\`\`\`json
+{
+  "issues": [],
+  "suggestions": ["File looks good"]
+}
+\`\`\``;
+        return prompt;
+    }
+    /**
+     * Truncate content to fit within context limits
+     */
+    truncateContent(content, maxLength = 8000) {
+        if (content.length <= maxLength) {
+            return content;
+        }
+        // Return first part with indicator
+        return `${content.substring(0, maxLength)}\n\n... (content truncated)`;
+    }
+    /**
+     * Parse validation response from LLM
+     */
+    parseValidationResponse(response) {
+        try {
+            // Try to extract JSON from response
+            const jsonMatch = response.match(/```json\s*([\s\S]*?)\s*```/);
+            if (jsonMatch?.[1]) {
+                const parsed = JSON.parse(jsonMatch[1]);
+                return parsed.issues ?? [];
+            }
+            // Try to parse entire response as JSON
+            const parsed = JSON.parse(response);
+            return parsed.issues ?? [];
+        }
+        catch {
+            // If parsing fails, return empty issues
+            return [];
+        }
+    }
+    /**
+     * Extract suggestions from issues
+     */
+    extractSuggestions(issues) {
+        const suggestions = [];
+        for (const issue of issues) {
+            if (issue.suggestedFix) {
+                suggestions.push(issue.suggestedFix);
+            }
+        }
+        // Add general suggestions if needed
+        if (issues.length === 0) {
+            suggestions.push("No issues found in the file");
+        }
+        return suggestions;
+    }
+    /**
+     * Create validation summary
+     */
+    createSummary(issues, filePath) {
+        const errorCount = issues.filter((i) => i.severity === "error").length;
+        const warningCount = issues.filter((i) => i.severity === "warning").length;
+        const infoCount = issues.filter((i) => i.severity === "info").length;
+        const fileName = filePath.split("/").pop() || "";
+        if (errorCount === 0 && warningCount === 0 && infoCount === 0) {
+            return `${fileName}: No issues found`;
+        }
+        const parts = [`${fileName}:`];
+        if (errorCount > 0) {
+            parts.push(`${errorCount} error${errorCount > 1 ? "s" : ""}`);
+        }
+        if (warningCount > 0) {
+            parts.push(`${warningCount} warning${warningCount > 1 ? "s" : ""}`);
+        }
+        if (infoCount > 0) {
+            parts.push(`${infoCount} info`);
+        }
+        return parts.join(" ");
+    }
+    /**
+     * Create fallback result when LLM fails
+     */
+    createFallbackResult(filePath, content, error) {
+        const fileName = filePath.split("/").pop() || "";
+        // Basic validation checks
+        const issues = [];
+        if (content.trim().length === 0) {
+            issues.push({
+                severity: "error",
+                message: "File is empty",
+                code: "EMPTY_FILE",
+            });
+        }
+        if (content.length > 100000) {
+            issues.push({
+                severity: "warning",
+                message: "File is very large, may affect validation",
+                code: "LARGE_FILE",
+            });
+        }
+        return {
+            file: filePath,
+            passed: issues.length === 0,
+            issues,
+            suggestions: [
+                `Validation error: ${error.message}`,
+                "AI validation unavailable - showing basic checks only",
+            ],
+            summary: `${fileName}: Basic validation only (${issues.length} issue${issues.length > 1 ? "s" : ""})`,
+        };
+    }
+    /**
+     * Format validation result for display
+     */
+    formatResult(result) {
+        const lines = [];
+        lines.push(`\n${"=".repeat(60)}`);
+        lines.push(`File: ${result.file}`);
+        lines.push(`Status: ${result.passed ? "✓ PASSED" : "✗ FAILED"}`);
+        lines.push("=".repeat(60));
+        lines.push("");
+        if (result.issues.length > 0) {
+            lines.push("Issues:");
+            lines.push("");
+            for (const issue of result.issues.slice(0, this.options.maxIssues || 10)) {
+                const icon = issue.severity === "error"
+                    ? "✗"
+                    : issue.severity === "warning"
+                        ? "⚠"
+                        : "ℹ";
+                lines.push(`  ${icon} ${issue.message}`);
+                if (issue.line) {
+                    lines.push(`    Line: ${issue.line}`);
+                }
+                if (issue.code) {
+                    lines.push(`    Code: ${issue.code}`);
+                }
+                if (issue.suggestedFix) {
+                    lines.push(`    Fix: ${issue.suggestedFix}`);
+                }
+                lines.push("");
+            }
+            if (result.issues.length > (this.options.maxIssues || 10)) {
+                const remaining = result.issues.length - (this.options.maxIssues || 10);
+                lines.push(`  ... and ${remaining} more issue${remaining > 1 ? "s" : ""} (truncated)`);
+                lines.push("");
+            }
+        }
+        if (result.suggestions.length > 0) {
+            lines.push("Suggestions:");
+            lines.push("");
+            for (const suggestion of result.suggestions) {
+                lines.push(`  • ${suggestion}`);
+            }
+            lines.push("");
+        }
+        lines.push(`Summary: ${result.summary}`);
+        lines.push("");
+        return lines.join("\n");
+    }
+    /**
+     * Format multiple validation results
+     */
+    formatResults(results) {
+        const lines = [];
+        lines.push(`\n${"=".repeat(80)}`);
+        lines.push("Validation Report");
+        lines.push("=".repeat(80));
+        const passedCount = results.filter((r) => r.passed).length;
+        const failedCount = results.filter((r) => !r.passed).length;
+        const totalIssues = results.reduce((sum, r) => sum + r.issues.length, 0);
+        lines.push(`Files: ${results.length}`);
+        lines.push(`Passed: ${passedCount}`);
+        lines.push(`Failed: ${failedCount}`);
+        lines.push(`Total Issues: ${totalIssues}`);
+        lines.push("=".repeat(80));
+        lines.push("");
+        for (const result of results) {
+            lines.push(this.formatResult(result));
+        }
+        return lines.join("\n");
+    }
+}

package/dist/lib/git.js

@@ -100,8 +100,10 @@ export function verifyBranch(story) {
                 console.log("Pulling latest changes...");
                 execaSync("git", ["pull"], { stdio: "inherit" });
             }
-            catch {
-                // Ignore pull errors (e.g. no upstream)
+            catch (error) {
+                // Warn but proceed - branch may be outdated or have no upstream
+                console.warn(`Warning: git pull failed - ${error instanceof Error ? error.message : String(error)}`);
+                console.warn("Branch may be outdated. Consider pulling manually before merging.");
             }
             execaSync("git", ["checkout", "-b", expected], { stdio: "inherit" });
             console.log("✓ Branch created and checked out");

package/dist/lib/log-parser.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Log Parser
+ * Extracts errors and diagnostic information from build/test logs
+ */
+export interface ParsedError {
+    /**
+     * File path (relative or absolute)
+     */
+    file: string;
+    /**
+     * Line number where error occurred
+     */
+    line: number;
+    /**
+     * Column number where error occurred
+     */
+    column: number;
+    /**
+     * Error message
+     */
+    message: string;
+    /**
+     * Error code or type (e.g., TS2322, E404)
+     */
+    code: string;
+    /**
+     * Error severity (error, warning, info)
+     */
+    severity: "error" | "warning" | "info";
+    /**
+     * Context lines around the error
+     */
+    context?: string[];
+    /**
+     * Raw log line
+     */
+    raw: string;
+}
+export interface LogParseResult {
+    /**
+     * Parsed errors
+     */
+    errors: ParsedError[];
+    /**
+     * Warning count
+     */
+    warningCount: number;
+    /**
+     * Error count
+     */
+    errorCount: number;
+    /**
+     * Success indicator (no errors found)
+     */
+    success: boolean;
+}
+/**
+ * Log Parser class
+ * Parses build/test logs to extract errors and diagnostics
+ */
+export declare class LogParser {
+    private patterns;
+    /**
+     * Parse log string
+     */
+    parse(logContent: string): LogParseResult;
+    /**
+     * Parse log file
+     */
+    parseFile(filePath: string): Promise<LogParseResult>;
+    /**
+     * Create error from regex match
+     */
+    private createErrorFromMatch;
+    /**
+     * Group errors by file
+     */
+    groupErrorsByFile(errors: ParsedError[]): Map<string, ParsedError[]>;
+    /**
+     * Filter errors by severity
+     */
+    filterBySeverity(errors: ParsedError[], severity: "error" | "warning" | "info"): ParsedError[];
+    /**
+     * Filter errors by file
+     */
+    filterByFile(errors: ParsedError[], filePattern: string): ParsedError[];
+    /**
+     * Format error for display
+     */
+    formatError(error: ParsedError): string;
+}