@madmatt112org/spec-workflow-mcp 3.0.0

package/dist/core/task-review-manager.d.ts

@@ -0,0 +1,56 @@
+import { TaskReview, ReviewFinding } from '../types.js';
+/**
+ * Validate that verdict and findings are consistent.
+ * Shared by review-task tool handler and TaskReviewRunner.
+ */
+export declare function validateVerdictConsistency(verdict: string, findings: ReviewFinding[]): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Manager for task review storage using markdown files with YAML frontmatter.
+ * Each review is stored as an individual markdown file in the spec's "reviews" directory.
+ */
+export declare class TaskReviewManager {
+    private specPath;
+    private reviewsDir;
+    constructor(specPath: string);
+    private ensureReviewsDir;
+    /**
+     * Determine the next version number for a task's review
+     */
+    getNextVersion(taskId: string): Promise<number>;
+    /**
+     * Write a prepare marker file to gate the record action
+     */
+    writePrepareMarker(taskId: string): Promise<void>;
+    /**
+     * Check if a prepare marker exists for this task
+     */
+    hasPrepareMarker(taskId: string): Promise<boolean>;
+    /**
+     * Remove the prepare marker after recording a review
+     */
+    removePrepareMarker(taskId: string): Promise<void>;
+    /**
+     * Save a review to disk as a markdown file with YAML frontmatter
+     */
+    saveReview(review: Omit<TaskReview, 'id' | 'version' | 'timestamp'>): Promise<TaskReview>;
+    /**
+     * Get all reviews for a specific task, sorted by version ascending
+     */
+    getReviewsForTask(taskId: string): Promise<TaskReview[]>;
+    /**
+     * Get the latest review for a task (highest version)
+     */
+    getLatestReview(taskId: string): Promise<TaskReview | null>;
+    /**
+     * Load all reviews from the reviews directory
+     */
+    loadAllReviews(): Promise<TaskReview[]>;
+    private generateFileName;
+    private reviewToMarkdown;
+    private parseReviewMarkdown;
+    getReviewsDir(): string;
+}
+//# sourceMappingURL=task-review-manager.d.ts.map

package/dist/core/task-review-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-review-manager.d.ts","sourceRoot":"","sources":["../../src/core/task-review-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAExD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,EAAE,GACxB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAcpC;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;gBAEf,QAAQ,EAAE,MAAM;YAKd,gBAAgB;IAiB9B;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMrD;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWxD;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxD;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,SAAS,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IA0B/F;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAO9D;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAKjE;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAwB7C,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,gBAAgB;IAmDxB,OAAO,CAAC,mBAAmB;IA6E3B,aAAa,IAAI,MAAM;CAGxB"}

package/dist/core/task-review-manager.js

@@ -0,0 +1,281 @@
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { randomUUID } from 'crypto';
+/**
+ * Validate that verdict and findings are consistent.
+ * Shared by review-task tool handler and TaskReviewRunner.
+ */
+export function validateVerdictConsistency(verdict, findings) {
+    const criticalCount = findings.filter(f => f.severity === 'critical').length;
+    if (verdict === 'pass' && findings.length > 0) {
+        return { valid: false, error: 'Verdict "pass" requires zero findings. Use "findings" or "fail" if there are issues.' };
+    }
+    if (verdict === 'fail' && criticalCount === 0) {
+        return { valid: false, error: 'Verdict "fail" requires at least one critical finding.' };
+    }
+    if (verdict === 'findings' && criticalCount > 0) {
+        return { valid: false, error: 'Verdict "findings" cannot contain critical-severity items. Use "fail" instead.' };
+    }
+    return { valid: true };
+}
+/**
+ * Manager for task review storage using markdown files with YAML frontmatter.
+ * Each review is stored as an individual markdown file in the spec's "reviews" directory.
+ */
+export class TaskReviewManager {
+    specPath;
+    reviewsDir;
+    constructor(specPath) {
+        this.specPath = specPath;
+        this.reviewsDir = join(specPath, 'reviews');
+    }
+    async ensureReviewsDir() {
+        // One-time migration: rename Reviews/ → reviews/ on case-sensitive filesystems
+        const oldDir = join(this.specPath, 'Reviews');
+        try {
+            const oldExists = await fs.stat(oldDir).then(() => true, () => false);
+            const newExists = await fs.stat(this.reviewsDir).then(() => true, () => false);
+            if (oldExists && !newExists) {
+                await fs.rename(oldDir, this.reviewsDir);
+                return;
+            }
+        }
+        catch {
+            // Ignore migration errors
+        }
+        await fs.mkdir(this.reviewsDir, { recursive: true });
+    }
+    /**
+     * Determine the next version number for a task's review
+     */
+    async getNextVersion(taskId) {
+        const existing = await this.getReviewsForTask(taskId);
+        if (existing.length === 0)
+            return 1;
+        return Math.max(...existing.map(r => r.version)) + 1;
+    }
+    /**
+     * Write a prepare marker file to gate the record action
+     */
+    async writePrepareMarker(taskId) {
+        await this.ensureReviewsDir();
+        const sanitized = taskId.replace(/[/.]/g, '-');
+        const markerPath = join(this.reviewsDir, `.prepare-${sanitized}`);
+        await fs.writeFile(markerPath, new Date().toISOString(), 'utf-8');
+    }
+    /**
+     * Check if a prepare marker exists for this task
+     */
+    async hasPrepareMarker(taskId) {
+        const sanitized = taskId.replace(/[/.]/g, '-');
+        const markerPath = join(this.reviewsDir, `.prepare-${sanitized}`);
+        try {
+            await fs.access(markerPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Remove the prepare marker after recording a review
+     */
+    async removePrepareMarker(taskId) {
+        const sanitized = taskId.replace(/[/.]/g, '-');
+        const markerPath = join(this.reviewsDir, `.prepare-${sanitized}`);
+        try {
+            await fs.unlink(markerPath);
+        }
+        catch {
+            // Ignore if already removed
+        }
+    }
+    /**
+     * Save a review to disk as a markdown file with YAML frontmatter
+     */
+    async saveReview(review) {
+        await this.ensureReviewsDir();
+        const version = await this.getNextVersion(review.taskId);
+        const id = randomUUID();
+        const timestamp = new Date().toISOString();
+        const fullReview = {
+            ...review,
+            id,
+            version,
+            timestamp,
+        };
+        const fileName = this.generateFileName(fullReview.taskId, version, timestamp);
+        const filePath = join(this.reviewsDir, fileName);
+        const markdown = this.reviewToMarkdown(fullReview);
+        await fs.writeFile(filePath, markdown, 'utf-8');
+        // Clean up the prepare marker
+        await this.removePrepareMarker(review.taskId);
+        return fullReview;
+    }
+    /**
+     * Get all reviews for a specific task, sorted by version ascending
+     */
+    async getReviewsForTask(taskId) {
+        const all = await this.loadAllReviews();
+        return all
+            .filter(r => r.taskId === taskId)
+            .sort((a, b) => a.version - b.version);
+    }
+    /**
+     * Get the latest review for a task (highest version)
+     */
+    async getLatestReview(taskId) {
+        const reviews = await this.getReviewsForTask(taskId);
+        return reviews.length > 0 ? reviews[reviews.length - 1] : null;
+    }
+    /**
+     * Load all reviews from the reviews directory
+     */
+    async loadAllReviews() {
+        await this.ensureReviewsDir();
+        try {
+            const files = await fs.readdir(this.reviewsDir);
+            const mdFiles = files.filter(f => f.startsWith('review-') && f.endsWith('.md'));
+            const reviews = [];
+            for (const file of mdFiles) {
+                try {
+                    const content = await fs.readFile(join(this.reviewsDir, file), 'utf-8');
+                    const review = this.parseReviewMarkdown(content);
+                    if (review)
+                        reviews.push(review);
+                }
+                catch {
+                    // Skip unparseable files
+                }
+            }
+            return reviews;
+        }
+        catch {
+            return [];
+        }
+    }
+    generateFileName(taskId, version, timestamp) {
+        const sanitizedTaskId = taskId.replace(/[/.]/g, '-');
+        const ts = timestamp.replace(/[:.Z]/g, '').slice(0, 15);
+        return `review-${sanitizedTaskId}_v${version}_${ts}.md`;
+    }
+    reviewToMarkdown(review) {
+        const criticalCount = review.findings.filter(f => f.severity === 'critical').length;
+        const warningCount = review.findings.filter(f => f.severity === 'warning').length;
+        const infoCount = review.findings.filter(f => f.severity === 'info').length;
+        let md = `---\n`;
+        md += `id: ${review.id}\n`;
+        md += `taskId: "${review.taskId}"\n`;
+        md += `specName: ${review.specName}\n`;
+        md += `version: ${review.version}\n`;
+        md += `verdict: ${review.verdict}\n`;
+        md += `timestamp: ${review.timestamp}\n`;
+        md += `criticalCount: ${criticalCount}\n`;
+        md += `warningCount: ${warningCount}\n`;
+        md += `infoCount: ${infoCount}\n`;
+        md += `---\n\n`;
+        md += `# Task Review: Task ${review.taskId} (v${review.version})\n\n`;
+        md += `**Spec:** ${review.specName}\n`;
+        md += `**Reviewed:** ${review.timestamp}\n`;
+        md += `**Verdict:** ${review.verdict}\n\n`;
+        md += `---\n\n`;
+        md += `## Summary\n\n${review.summary}\n\n`;
+        if (review.findings.length === 0) {
+            md += `## Findings\n\n_No findings — clean review._\n`;
+        }
+        else {
+            md += `## Findings\n\n`;
+            for (const finding of review.findings) {
+                const tag = finding.severity.toUpperCase();
+                const cat = finding.category && finding.category !== 'spec-compliance'
+                    ? ` [${finding.category}]` : '';
+                md += `### ${tag}${cat}: ${finding.title}\n`;
+                if (finding.file) {
+                    md += `- **File:** ${finding.file}${finding.line ? `:${finding.line}` : ''}\n`;
+                }
+                md += `- **Issue:** ${finding.description}\n`;
+                if (finding.taskRequirement) {
+                    md += `- **Task Requirement:** ${finding.taskRequirement}\n`;
+                }
+                if (finding.classification) {
+                    md += `- **Classification:** ${finding.classification}\n`;
+                }
+                md += `\n`;
+            }
+        }
+        return md;
+    }
+    parseReviewMarkdown(content) {
+        try {
+            // Parse YAML frontmatter
+            const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+            if (!fmMatch)
+                return null;
+            const fm = fmMatch[1];
+            const get = (key) => {
+                const match = fm.match(new RegExp(`^${key}:\\s*"?([^"\\n]*)"?`, 'm'));
+                return match ? match[1].trim() : '';
+            };
+            const id = get('id');
+            const taskId = get('taskId');
+            const specName = get('specName');
+            const version = parseInt(get('version')) || 0;
+            const verdict = get('verdict');
+            const timestamp = get('timestamp');
+            if (!id || !taskId || !specName || !verdict)
+                return null;
+            // Parse summary from markdown body
+            const summaryMatch = content.match(/## Summary\n\n([\s\S]*?)(?:\n\n## |\n\n_No findings)/);
+            const summary = summaryMatch ? summaryMatch[1].trim() : '';
+            // Parse findings from markdown body
+            const findings = [];
+            const findingPattern = /### (CRITICAL|WARNING|INFO)(?:\s*\[([^\]]+)\])?:\s*(.+)/g;
+            let match;
+            while ((match = findingPattern.exec(content)) !== null) {
+                const severity = match[1].toLowerCase();
+                const category = match[2];
+                const title = match[3].trim();
+                // Extract details from the lines following the heading
+                const afterHeading = content.slice(match.index + match[0].length);
+                const nextHeadingIdx = afterHeading.search(/\n### /);
+                const block = nextHeadingIdx >= 0
+                    ? afterHeading.slice(0, nextHeadingIdx)
+                    : afterHeading;
+                const fileMatch = block.match(/- \*\*File:\*\*\s*(.+)/);
+                const issueMatch = block.match(/- \*\*Issue:\*\*\s*(.+)/);
+                const reqMatch = block.match(/- \*\*Task Requirement:\*\*\s*(.+)/);
+                const classMatch = block.match(/- \*\*Classification:\*\*\s*(novel|compounding|recurring)/);
+                let file;
+                let line;
+                if (fileMatch) {
+                    const fileParts = fileMatch[1].trim().match(/^(.+?):(\d+)$/);
+                    if (fileParts) {
+                        file = fileParts[1];
+                        line = parseInt(fileParts[2]);
+                    }
+                    else {
+                        file = fileMatch[1].trim();
+                    }
+                }
+                findings.push({
+                    severity,
+                    title,
+                    file,
+                    line,
+                    description: issueMatch ? issueMatch[1].trim() : '',
+                    taskRequirement: reqMatch ? reqMatch[1].trim() : undefined,
+                    category: category || 'spec-compliance',
+                    classification: classMatch ? classMatch[1] : undefined,
+                });
+            }
+            return { id, taskId, specName, version, timestamp, verdict, summary, findings };
+        }
+        catch {
+            return null;
+        }
+    }
+    getReviewsDir() {
+        return this.reviewsDir;
+    }
+}
+//# sourceMappingURL=task-review-manager.js.map

package/dist/core/task-review-manager.js.map

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

package/dist/core/task-validator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Task Validator Module
+ * Validates tasks.md format compliance before approval
+ */
+export interface ValidationError {
+    line: number;
+    taskId?: string;
+    field: string;
+    message: string;
+    suggestion?: string;
+    severity: 'error' | 'warning';
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+    summary: {
+        totalTasks: number;
+        validTasks: number;
+        invalidTasks: number;
+    };
+}
+/**
+ * Validate tasks.md content against required format
+ * @param content The markdown content to validate
+ * @returns ValidationResult with errors, warnings, and summary
+ */
+export declare function validateTasksMarkdown(content: string): ValidationResult;
+/**
+ * Format validation errors for display
+ * @param result The validation result
+ * @returns Formatted string array of errors and warnings
+ */
+export declare function formatValidationErrors(result: ValidationResult): string[];
+//# sourceMappingURL=task-validator.d.ts.map

package/dist/core/task-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-validator.d.ts","sourceRoot":"","sources":["../../src/core/task-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAyNvE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,CA0BzE"}

package/dist/core/task-validator.js

@@ -0,0 +1,236 @@
+/**
+ * Task Validator Module
+ * Validates tasks.md format compliance before approval
+ */
+/**
+ * Validate tasks.md content against required format
+ * @param content The markdown content to validate
+ * @returns ValidationResult with errors, warnings, and summary
+ */
+export function validateTasksMarkdown(content) {
+    const lines = content.split('\n');
+    const errors = [];
+    const warnings = [];
+    let taskCount = 0;
+    let validTaskCount = 0;
+    // Find all checkbox lines and their ranges (including malformed ones with asterisks)
+    const checkboxIndices = [];
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].match(/^\s*[-*]\s*\[/)) {
+            checkboxIndices.push(i);
+        }
+    }
+    // Process each checkbox task
+    for (let idx = 0; idx < checkboxIndices.length; idx++) {
+        const lineIndex = checkboxIndices[idx];
+        const endLine = idx < checkboxIndices.length - 1 ? checkboxIndices[idx + 1] : lines.length;
+        const line = lines[lineIndex];
+        const lineNum = lineIndex + 1; // 1-based for user-friendly messages
+        taskCount++;
+        let taskValid = true;
+        let taskId;
+        // 1. Validate checkbox format: must be "- [ ]", "- [-]", or "- [x]"
+        const checkboxMatch = line.match(/^\s*-\s+\[([ x\-])\]\s+(.+)/);
+        if (!checkboxMatch) {
+            // Check for common malformed patterns
+            const malformedPatterns = [
+                { pattern: /^\s*-\s*\[\]\s/, message: 'Empty checkbox brackets', suggestion: 'Use "- [ ]" with a space inside brackets' },
+                { pattern: /^\s*-\s*\[([^x \-])\]/, message: 'Invalid checkbox character', suggestion: 'Use space for pending, x for completed, - for in-progress' },
+                { pattern: /^\s*-\[\s*[x \-]?\s*\]/, message: 'Missing space after hyphen', suggestion: 'Use "- [ ]" with space between - and [' },
+                { pattern: /^\s*\*\s+\[/, message: 'Wrong bullet character', suggestion: 'Use hyphen (-) instead of asterisk (*)' },
+            ];
+            let foundMalformed = false;
+            for (const { pattern, message, suggestion } of malformedPatterns) {
+                if (line.match(pattern)) {
+                    errors.push({
+                        line: lineNum,
+                        field: 'checkbox',
+                        message,
+                        suggestion,
+                        severity: 'error'
+                    });
+                    foundMalformed = true;
+                    taskValid = false;
+                    break;
+                }
+            }
+            if (!foundMalformed) {
+                errors.push({
+                    line: lineNum,
+                    field: 'checkbox',
+                    message: 'Invalid checkbox format',
+                    suggestion: 'Expected format: "- [ ] 1. Task description"',
+                    severity: 'error'
+                });
+                taskValid = false;
+            }
+            continue;
+        }
+        const statusChar = checkboxMatch[1];
+        const taskText = checkboxMatch[2];
+        // 2. Validate task ID: must have numeric ID like "1.", "1.1", "2.3"
+        const taskIdMatch = taskText.match(/^(\d+(?:\.\d+)*)\s*\.?\s+(.+)/);
+        if (!taskIdMatch) {
+            errors.push({
+                line: lineNum,
+                field: 'taskId',
+                message: 'Missing task ID number',
+                suggestion: 'Add numeric ID like "1." or "1.1" after checkbox',
+                severity: 'error'
+            });
+            taskValid = false;
+        }
+        else {
+            taskId = taskIdMatch[1];
+        }
+        // 3. Validate metadata in following lines
+        let hasRequirements = false;
+        let hasLeverage = false;
+        let hasPrompt = false;
+        let hasFiles = false;
+        let promptHasClosingUnderscore = false;
+        let promptSections = [];
+        for (let lineIdx = lineIndex + 1; lineIdx < endLine; lineIdx++) {
+            const contentLine = lines[lineIdx];
+            const trimmedLine = contentLine.trim();
+            if (!trimmedLine)
+                continue;
+            // Check for _Requirements:_ format
+            if (trimmedLine.includes('Requirements:')) {
+                hasRequirements = true;
+                // Check for proper underscore delimiters
+                if (!trimmedLine.match(/_Requirements:\s*[^_]+_/)) {
+                    if (trimmedLine.match(/Requirements:\s*\S/) && !trimmedLine.includes('_Requirements:')) {
+                        warnings.push({
+                            line: lineIdx + 1,
+                            taskId,
+                            field: 'requirements',
+                            message: 'Requirements field missing underscore delimiters',
+                            suggestion: 'Use "_Requirements: ..._" format for proper parsing',
+                            severity: 'warning'
+                        });
+                    }
+                }
+            }
+            // Check for _Leverage:_ format
+            if (trimmedLine.includes('Leverage:')) {
+                hasLeverage = true;
+                // Check for proper underscore delimiters
+                if (!trimmedLine.match(/_Leverage:\s*[^_]+_/)) {
+                    if (trimmedLine.match(/Leverage:\s*\S/) && !trimmedLine.includes('_Leverage:')) {
+                        warnings.push({
+                            line: lineIdx + 1,
+                            taskId,
+                            field: 'leverage',
+                            message: 'Leverage field missing underscore delimiters',
+                            suggestion: 'Use "_Leverage: ..._" format for proper parsing',
+                            severity: 'warning'
+                        });
+                    }
+                }
+            }
+            // Check for Files: field
+            if (trimmedLine.match(/Files?:/i)) {
+                hasFiles = true;
+            }
+            // Check for _Prompt:_ format
+            if (trimmedLine.includes('_Prompt:')) {
+                hasPrompt = true;
+                // Check for closing underscore
+                if (trimmedLine.match(/_Prompt:\s*.+_$/)) {
+                    promptHasClosingUnderscore = true;
+                }
+                else {
+                    // Check if prompt continues on multiple lines - look for closing underscore
+                    let foundClosing = false;
+                    for (let j = lineIdx; j < endLine; j++) {
+                        if (lines[j].trim().endsWith('_') && !lines[j].trim().match(/^_[A-Z]/)) {
+                            foundClosing = true;
+                            break;
+                        }
+                    }
+                    promptHasClosingUnderscore = foundClosing;
+                }
+                // Extract prompt content and check structure
+                const promptContent = trimmedLine.replace(/_Prompt:\s*/, '').replace(/_$/, '');
+                // Check for required prompt sections: Role, Task, Restrictions, Success
+                const requiredSections = ['Role', 'Task', 'Restrictions', 'Success'];
+                for (const section of requiredSections) {
+                    if (promptContent.toLowerCase().includes(section.toLowerCase() + ':')) {
+                        promptSections.push(section);
+                    }
+                }
+            }
+        }
+        // Validate prompt requirements
+        if (hasPrompt) {
+            if (!promptHasClosingUnderscore) {
+                warnings.push({
+                    line: lineNum,
+                    taskId,
+                    field: 'prompt',
+                    message: 'Prompt field may be missing closing underscore',
+                    suggestion: 'Ensure _Prompt: ..._ ends with underscore',
+                    severity: 'warning'
+                });
+            }
+            // Check for missing prompt sections
+            const requiredSections = ['Role', 'Task', 'Restrictions', 'Success'];
+            const missingSections = requiredSections.filter(s => !promptSections.includes(s));
+            if (missingSections.length > 0) {
+                warnings.push({
+                    line: lineNum,
+                    taskId,
+                    field: 'prompt_structure',
+                    message: `Prompt missing sections: ${missingSections.join(', ')}`,
+                    suggestion: 'Format: Role: ... | Task: ... | Restrictions: ... | Success: ...',
+                    severity: 'warning'
+                });
+            }
+        }
+        // Track if task is valid (only errors affect validity, not warnings)
+        if (taskValid) {
+            validTaskCount++;
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        summary: {
+            totalTasks: taskCount,
+            validTasks: validTaskCount,
+            invalidTasks: taskCount - validTaskCount
+        }
+    };
+}
+/**
+ * Format validation errors for display
+ * @param result The validation result
+ * @returns Formatted string array of errors and warnings
+ */
+export function formatValidationErrors(result) {
+    const messages = [];
+    if (result.errors.length > 0) {
+        messages.push(`Found ${result.errors.length} error(s):`);
+        for (const error of result.errors) {
+            const taskInfo = error.taskId ? ` (Task ${error.taskId})` : '';
+            messages.push(`  Line ${error.line}${taskInfo}: ${error.message}`);
+            if (error.suggestion) {
+                messages.push(`    Suggestion: ${error.suggestion}`);
+            }
+        }
+    }
+    if (result.warnings.length > 0) {
+        messages.push(`Found ${result.warnings.length} warning(s):`);
+        for (const warning of result.warnings) {
+            const taskInfo = warning.taskId ? ` (Task ${warning.taskId})` : '';
+            messages.push(`  Line ${warning.line}${taskInfo}: ${warning.message}`);
+            if (warning.suggestion) {
+                messages.push(`    Suggestion: ${warning.suggestion}`);
+            }
+        }
+    }
+    return messages;
+}
+//# sourceMappingURL=task-validator.js.map

package/dist/core/task-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-validator.js","sourceRoot":"","sources":["../../src/core/task-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsBH;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,qFAAqF;IACrF,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;YACpC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QACtD,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,GAAG,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QAC3F,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,qCAAqC;QAEpE,SAAS,EAAE,CAAC;QACZ,IAAI,SAAS,GAAG,IAAI,CAAC;QACrB,IAAI,MAA0B,CAAC;QAE/B,oEAAoE;QACpE,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAEhE,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,sCAAsC;YACtC,MAAM,iBAAiB,GAAG;gBACxB,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,yBAAyB,EAAE,UAAU,EAAE,0CAA0C,EAAE;gBACzH,EAAE,OAAO,EAAE,uBAAuB,EAAE,OAAO,EAAE,4BAA4B,EAAE,UAAU,EAAE,2DAA2D,EAAE;gBACpJ,EAAE,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,4BAA4B,EAAE,UAAU,EAAE,wCAAwC,EAAE;gBAClI,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,wBAAwB,EAAE,UAAU,EAAE,wCAAwC,EAAE;aACpH,CAAC;YAEF,IAAI,cAAc,GAAG,KAAK,CAAC;YAC3B,KAAK,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,iBAAiB,EAAE,CAAC;gBACjE,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;oBACxB,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,UAAU;wBACjB,OAAO;wBACP,UAAU;wBACV,QAAQ,EAAE,OAAO;qBAClB,CAAC,CAAC;oBACH,cAAc,GAAG,IAAI,CAAC;oBACtB,SAAS,GAAG,KAAK,CAAC;oBAClB,MAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,UAAU;oBACjB,OAAO,EAAE,yBAAyB;oBAClC,UAAU,EAAE,8CAA8C;oBAC1D,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;gBACH,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAElC,oEAAoE;QACpE,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAEpE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,wBAAwB;gBACjC,UAAU,EAAE,kDAAkD;gBAC9D,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YACH,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QAED,0CAA0C;QAC1C,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,0BAA0B,GAAG,KAAK,CAAC;QACvC,IAAI,cAAc,GAAa,EAAE,CAAC;QAElC,KAAK,IAAI,OAAO,GAAG,SAAS,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YAC/D,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;YAEvC,IAAI,CAAC,WAAW;gBAAE,SAAS;YAE3B,mCAAmC;YACnC,IAAI,WAAW,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC1C,eAAe,GAAG,IAAI,CAAC;gBACvB,yCAAyC;gBACzC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC;oBAClD,IAAI,WAAW,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;wBACvF,QAAQ,CAAC,IAAI,CAAC;4BACZ,IAAI,EAAE,OAAO,GAAG,CAAC;4BACjB,MAAM;4BACN,KAAK,EAAE,cAAc;4BACrB,OAAO,EAAE,kDAAkD;4BAC3D,UAAU,EAAE,qDAAqD;4BACjE,QAAQ,EAAE,SAAS;yBACpB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAED,+BAA+B;YAC/B,IAAI,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACtC,WAAW,GAAG,IAAI,CAAC;gBACnB,yCAAyC;gBACzC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC;oBAC9C,IAAI,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;wBAC/E,QAAQ,CAAC,IAAI,CAAC;4BACZ,IAAI,EAAE,OAAO,GAAG,CAAC;4BACjB,MAAM;4BACN,KAAK,EAAE,UAAU;4BACjB,OAAO,EAAE,8CAA8C;4BACvD,UAAU,EAAE,iDAAiD;4BAC7D,QAAQ,EAAE,SAAS;yBACpB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAED,yBAAyB;YACzB,IAAI,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClC,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;YAED,6BAA6B;YAC7B,IAAI,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACrC,SAAS,GAAG,IAAI,CAAC;gBAEjB,+BAA+B;gBAC/B,IAAI,WAAW,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;oBACzC,0BAA0B,GAAG,IAAI,CAAC;gBACpC,CAAC;qBAAM,CAAC;oBACN,4EAA4E;oBAC5E,IAAI,YAAY,GAAG,KAAK,CAAC;oBACzB,KAAK,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;wBACvC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;4BACvE,YAAY,GAAG,IAAI,CAAC;4BACpB,MAAM;wBACR,CAAC;oBACH,CAAC;oBACD,0BAA0B,GAAG,YAAY,CAAC;gBAC5C,CAAC;gBAED,6CAA6C;gBAC7C,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAE/E,wEAAwE;gBACxE,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;gBACrE,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;oBACvC,IAAI,aAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;wBACtE,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBAC/B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,0BAA0B,EAAE,CAAC;gBAChC,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,OAAO;oBACb,MAAM;oBACN,KAAK,EAAE,QAAQ;oBACf,OAAO,EAAE,gDAAgD;oBACzD,UAAU,EAAE,2CAA2C;oBACvD,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAC;YACL,CAAC;YAED,oCAAoC;YACpC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;YACrE,MAAM,eAAe,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAClF,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,OAAO;oBACb,MAAM;oBACN,KAAK,EAAE,kBAAkB;oBACzB,OAAO,EAAE,4BAA4B,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACjE,UAAU,EAAE,kEAAkE;oBAC9E,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,qEAAqE;QACrE,IAAI,SAAS,EAAE,CAAC;YACd,cAAc,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,QAAQ;QACR,OAAO,EAAE;YACP,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,cAAc;YAC1B,YAAY,EAAE,SAAS,GAAG,cAAc;SACzC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC7D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,CAAC,CAAC;QACzD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,IAAI,GAAG,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACnE,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,QAAQ,CAAC,MAAM,cAAc,CAAC,CAAC;QAC7D,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,IAAI,GAAG,QAAQ,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YACvE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,QAAQ,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}