@codebakers/mcp 5.2.0

package/dist/tools/diagnose-error.js

@@ -0,0 +1,351 @@
+/**
+ * codebakers_diagnose_error
+ *
+ * AI-Powered Error Diagnosis
+ *
+ * Analyzes errors and provides:
+ * - Root cause analysis
+ * - Affected files
+ * - Multiple fix approaches
+ * - Confidence scores
+ * - Related patterns from ERROR-LOG.md
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+export async function diagnoseError(args) {
+    const cwd = process.cwd();
+    const { error_message, stack_trace, context } = args;
+    console.error('🍞 CodeBakers: Diagnosing Error');
+    try {
+        // Step 1: Check ERROR-LOG.md for similar errors
+        const relatedErrors = await findRelatedErrors(cwd, error_message);
+        // Step 2: Analyze stack trace to find affected files
+        const affectedFiles = extractAffectedFiles(stack_trace || '');
+        // Step 3: Determine root cause
+        const rootCause = analyzeRootCause(error_message, stack_trace || '', context);
+        // Step 4: Generate fix approaches
+        const fixApproaches = generateFixApproaches(error_message, rootCause, affectedFiles);
+        // Step 5: Generate diagnosis report
+        const diagnosis = {
+            root_cause: rootCause.cause,
+            confidence: rootCause.confidence,
+            affected_files: affectedFiles,
+            fix_approaches: fixApproaches,
+            related_errors: relatedErrors
+        };
+        // Step 6: Log to ERROR-LOG.md
+        await logError(cwd, error_message, stack_trace || '', diagnosis);
+        return generateDiagnosisReport(diagnosis, error_message);
+    }
+    catch (error) {
+        return `🍞 CodeBakers: Error Diagnosis Failed\n\nError: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+async function findRelatedErrors(cwd, errorMessage) {
+    const errorLogPath = path.join(cwd, '.codebakers', 'ERROR-LOG.md');
+    const related = [];
+    try {
+        const content = await fs.readFile(errorLogPath, 'utf-8');
+        const entries = content.split('## Error:').slice(1);
+        // Extract key terms from current error
+        const keyTerms = extractKeyTerms(errorMessage);
+        for (const entry of entries) {
+            // Check if entry contains any key terms
+            for (const term of keyTerms) {
+                if (entry.toLowerCase().includes(term.toLowerCase())) {
+                    const title = entry.split('\n')[0].trim();
+                    if (!related.includes(title)) {
+                        related.push(title);
+                    }
+                    break;
+                }
+            }
+        }
+    }
+    catch {
+        // ERROR-LOG.md doesn't exist
+    }
+    return related.slice(0, 3); // Top 3 related errors
+}
+function extractKeyTerms(error) {
+    const terms = [];
+    // Extract error type (e.g., "TypeError", "ReferenceError")
+    const typeMatch = error.match(/([A-Z][a-z]+Error)/);
+    if (typeMatch) {
+        terms.push(typeMatch[1]);
+    }
+    // Extract quoted identifiers (e.g., 'undefined', "null")
+    const quotedMatches = error.matchAll(/['"]([a-zA-Z_$][a-zA-Z0-9_$]*)['"]/g);
+    for (const match of quotedMatches) {
+        terms.push(match[1]);
+    }
+    // Extract file extensions
+    if (error.includes('.tsx'))
+        terms.push('tsx');
+    if (error.includes('.ts'))
+        terms.push('typescript');
+    if (error.includes('.jsx'))
+        terms.push('jsx');
+    return terms;
+}
+function extractAffectedFiles(stackTrace) {
+    const files = [];
+    const lines = stackTrace.split('\n');
+    for (const line of lines) {
+        // Match file paths in stack trace
+        const match = line.match(/(?:at|in)\s+(?:.*?\s+)?\(?([^\s()]+\.(?:tsx?|jsx?|mjs)):(\d+)/);
+        if (match) {
+            const file = match[1];
+            if (!files.includes(file)) {
+                files.push(file);
+            }
+        }
+    }
+    return files.slice(0, 5); // Top 5 affected files
+}
+function analyzeRootCause(error, stackTrace, context) {
+    // Pattern matching for common error types
+    // TypeScript errors
+    if (error.includes('Property') && error.includes('does not exist on type')) {
+        return {
+            cause: 'Attempting to access a property that TypeScript doesn\'t recognize on the type',
+            confidence: 'high'
+        };
+    }
+    if (error.includes('Cannot read property') || error.includes('Cannot read properties of undefined')) {
+        return {
+            cause: 'Accessing a property on undefined or null value (data not loaded or wrong type)',
+            confidence: 'high'
+        };
+    }
+    if (error.includes('window is not defined') || error.includes('document is not defined')) {
+        return {
+            cause: 'Server-side rendering (SSR) code trying to access browser-only APIs',
+            confidence: 'high'
+        };
+    }
+    if (error.includes('Hydration') || error.includes('Text content does not match')) {
+        return {
+            cause: 'Server-rendered HTML doesn\'t match client-rendered output (hydration mismatch)',
+            confidence: 'high'
+        };
+    }
+    if (error.includes('.maybeSingle() expected 0 or 1 rows')) {
+        return {
+            cause: 'Database query returned multiple rows when expecting single row',
+            confidence: 'high'
+        };
+    }
+    if (error.includes('Class') && error.includes('not found')) {
+        return {
+            cause: 'Tailwind CSS class not defined (missing from tailwind.config or not compiled)',
+            confidence: 'high'
+        };
+    }
+    if (error.includes('Module not found') || error.includes('Cannot find module')) {
+        return {
+            cause: 'Import path incorrect or dependency not installed',
+            confidence: 'high'
+        };
+    }
+    if (error.includes('401') || error.includes('Unauthorized')) {
+        return {
+            cause: 'Authentication failure (user not logged in or token expired)',
+            confidence: 'high'
+        };
+    }
+    if (error.includes('403') || error.includes('Forbidden')) {
+        return {
+            cause: 'Authorization failure (user lacks permission for this resource)',
+            confidence: 'high'
+        };
+    }
+    if (error.includes('404') || error.includes('Not Found')) {
+        return {
+            cause: 'Resource not found (wrong URL, deleted record, or route not defined)',
+            confidence: 'high'
+        };
+    }
+    if (error.includes('500') || error.includes('Internal Server Error')) {
+        return {
+            cause: 'Server-side error (check API route, database connection, or server logs)',
+            confidence: 'medium'
+        };
+    }
+    // Generic analysis
+    if (stackTrace.length > 0) {
+        return {
+            cause: 'Runtime error during execution (check stack trace for file location)',
+            confidence: 'medium'
+        };
+    }
+    return {
+        cause: 'Unknown error - manual investigation needed',
+        confidence: 'low'
+    };
+}
+function generateFixApproaches(error, rootCause, affectedFiles) {
+    const approaches = [];
+    // Generate approaches based on error type
+    if (rootCause.cause.includes('undefined or null')) {
+        approaches.push({
+            approach: 'Add null check',
+            steps: [
+                'Identify the variable being accessed',
+                'Add optional chaining: `obj?.property` instead of `obj.property`',
+                'Or add explicit check: `if (obj) { ... }`',
+                'Consider why value is undefined (data not loaded, wrong type, etc.)'
+            ],
+            confidence: 90,
+            risk: 'low'
+        });
+        approaches.push({
+            approach: 'Ensure data is loaded first',
+            steps: [
+                'Check if data is being fetched asynchronously',
+                'Add loading state check before accessing data',
+                'Use conditional rendering: `{data && <Component data={data} />}`'
+            ],
+            confidence: 85,
+            risk: 'low'
+        });
+    }
+    if (rootCause.cause.includes('SSR')) {
+        approaches.push({
+            approach: 'Use client-side only',
+            steps: [
+                'Add "use client" directive at top of file',
+                'Or use dynamic import with { ssr: false }',
+                'Or check if window exists: `if (typeof window !== "undefined")`'
+            ],
+            confidence: 95,
+            risk: 'low'
+        });
+        approaches.push({
+            approach: 'Use useEffect for browser APIs',
+            steps: [
+                'Move browser API calls into useEffect hook',
+                'useEffect only runs on client side',
+                'Store result in state if needed'
+            ],
+            confidence: 90,
+            risk: 'low'
+        });
+    }
+    if (rootCause.cause.includes('Hydration')) {
+        approaches.push({
+            approach: 'Fix server/client mismatch',
+            steps: [
+                'Ensure server and client render the same HTML',
+                'Avoid random values, timestamps, or client-only data during SSR',
+                'Use suppressHydrationWarning if intentional mismatch',
+                'Check for browser extensions injecting HTML'
+            ],
+            confidence: 80,
+            risk: 'medium'
+        });
+    }
+    if (rootCause.cause.includes('TypeScript')) {
+        approaches.push({
+            approach: 'Fix type definition',
+            steps: [
+                'Add property to type/interface definition',
+                'Or use type assertion if you know type is correct',
+                'Or check if property name is spelled correctly'
+            ],
+            confidence: 95,
+            risk: 'low'
+        });
+    }
+    if (rootCause.cause.includes('Module not found')) {
+        approaches.push({
+            approach: 'Install missing dependency',
+            steps: [
+                'Check import path is correct',
+                'If external package: Run `pnpm add [package-name]`',
+                'If local file: Check file exists and path is correct',
+                'Restart dev server after installing'
+            ],
+            confidence: 95,
+            risk: 'low'
+        });
+    }
+    if (rootCause.cause.includes('Tailwind')) {
+        approaches.push({
+            approach: 'Define CSS variable',
+            steps: [
+                'Check if using custom color (e.g., "border-border")',
+                'Add to globals.css: `--border: ...`',
+                'Add to tailwind.config.ts: extend theme with CSS variables',
+                'See: agents/patterns/tailwind-css-variables.md'
+            ],
+            confidence: 90,
+            risk: 'low'
+        });
+    }
+    if (approaches.length === 0) {
+        // Generic approach
+        approaches.push({
+            approach: 'Investigate affected files',
+            steps: affectedFiles.length > 0
+                ? affectedFiles.map(f => `Check file: ${f}`)
+                : ['Review stack trace for file locations', 'Add console.log to trace execution'],
+            confidence: 50,
+            risk: 'medium'
+        });
+    }
+    return approaches;
+}
+async function logError(cwd, error, stackTrace, diagnosis) {
+    const errorLogPath = path.join(cwd, '.codebakers', 'ERROR-LOG.md');
+    const entry = `\n## Error: ${error.split('\n')[0].slice(0, 100)}\n\n`;
+    const details = `**Date:** ${new Date().toISOString()}\n`;
+    const cause = `**Root Cause:** ${diagnosis.root_cause}\n`;
+    const fixes = `**Fix Approaches:** ${diagnosis.fix_approaches.length}\n`;
+    const fullEntry = entry + details + cause + fixes + '\n---\n';
+    try {
+        const existing = await fs.readFile(errorLogPath, 'utf-8');
+        await fs.writeFile(errorLogPath, existing + fullEntry, 'utf-8');
+    }
+    catch {
+        // ERROR-LOG.md doesn't exist
+        await fs.mkdir(path.dirname(errorLogPath), { recursive: true });
+        await fs.writeFile(errorLogPath, `# Error Log\n\n${fullEntry}`, 'utf-8');
+    }
+}
+function generateDiagnosisReport(diagnosis, error) {
+    let report = `🍞 CodeBakers: Error Diagnosis\n\n`;
+    report += `**Error:** ${error.split('\n')[0]}\n\n`;
+    report += `## Root Cause\n\n`;
+    report += `${diagnosis.root_cause}\n\n`;
+    report += `**Confidence:** ${diagnosis.confidence === 'high' ? '✅ High' : diagnosis.confidence === 'medium' ? '⚠️ Medium' : '❓ Low'}\n\n`;
+    if (diagnosis.affected_files.length > 0) {
+        report += `## Affected Files\n\n`;
+        for (const file of diagnosis.affected_files) {
+            report += `- ${file}\n`;
+        }
+        report += `\n`;
+    }
+    if (diagnosis.related_errors.length > 0) {
+        report += `## Related Past Errors\n\n`;
+        for (const related of diagnosis.related_errors) {
+            report += `- ${related}\n`;
+        }
+        report += `\nCheck .codebakers/ERROR-LOG.md for solutions.\n\n`;
+    }
+    report += `## Fix Approaches (${diagnosis.fix_approaches.length})\n\n`;
+    for (let i = 0; i < diagnosis.fix_approaches.length; i++) {
+        const approach = diagnosis.fix_approaches[i];
+        report += `### Approach ${i + 1}: ${approach.approach}\n\n`;
+        report += `**Confidence:** ${approach.confidence}%\n`;
+        report += `**Risk:** ${approach.risk}\n\n`;
+        report += `**Steps:**\n`;
+        for (const step of approach.steps) {
+            report += `${i + 1}. ${step}\n`;
+        }
+        report += `\n`;
+    }
+    report += `**Logged to:** .codebakers/ERROR-LOG.md\n`;
+    return report;
+}
+//# sourceMappingURL=diagnose-error.js.map

package/dist/tools/diagnose-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose-error.js","sourceRoot":"","sources":["../../src/tools/diagnose-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAuB7B,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAkB;IACpD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAErD,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,gDAAgD;QAChD,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAElE,qDAAqD;QACrD,MAAM,aAAa,GAAG,oBAAoB,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAE9D,+BAA+B;QAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,aAAa,EAAE,WAAW,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAE9E,kCAAkC;QAClC,MAAM,aAAa,GAAG,qBAAqB,CAAC,aAAa,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAErF,oCAAoC;QACpC,MAAM,SAAS,GAAoB;YACjC,UAAU,EAAE,SAAS,CAAC,KAAK;YAC3B,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,cAAc,EAAE,aAAa;YAC7B,cAAc,EAAE,aAAa;YAC7B,cAAc,EAAE,aAAa;SAC9B,CAAC;QAEF,8BAA8B;QAC9B,MAAM,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;QAEjE,OAAO,uBAAuB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,mDAAmD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACrH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,GAAW,EAAE,YAAoB;IAChE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;IACnE,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEpD,uCAAuC;QACvC,MAAM,QAAQ,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAE/C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,wCAAwC;YACxC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBACrD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC1C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC7B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACtB,CAAC;oBACD,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,uBAAuB;AACrD,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,2DAA2D;IAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,yDAAyD;IACzD,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,qCAAqC,CAAC,CAAC;IAC5E,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,0BAA0B;IAC1B,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE9C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,UAAkB;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,kCAAkC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAC1F,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,uBAAuB;AACnD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,UAAkB,EAAE,OAAgB;IAC3E,0CAA0C;IAE1C,oBAAoB;IACpB,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;QAC3E,OAAO;YACL,KAAK,EAAE,gFAAgF;YACvF,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,sBAAsB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,qCAAqC,CAAC,EAAE,CAAC;QACpG,OAAO;YACL,KAAK,EAAE,iFAAiF;YACxF,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,uBAAuB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;QACzF,OAAO;YACL,KAAK,EAAE,qEAAqE;YAC5E,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE,CAAC;QACjF,OAAO;YACL,KAAK,EAAE,iFAAiF;YACxF,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,qCAAqC,CAAC,EAAE,CAAC;QAC1D,OAAO;YACL,KAAK,EAAE,iEAAiE;YACxE,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3D,OAAO;YACL,KAAK,EAAE,+EAA+E;YACtF,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC/E,OAAO;YACL,KAAK,EAAE,mDAAmD;YAC1D,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC5D,OAAO;YACL,KAAK,EAAE,8DAA8D;YACrE,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACzD,OAAO;YACL,KAAK,EAAE,iEAAiE;YACxE,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACzD,OAAO;YACL,KAAK,EAAE,sEAAsE;YAC7E,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;QACrE,OAAO;YACL,KAAK,EAAE,0EAA0E;YACjF,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;IAED,mBAAmB;IACnB,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,sEAAsE;YAC7E,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,6CAA6C;QACpD,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa,EAAE,SAA4B,EAAE,aAAuB;IACjG,MAAM,UAAU,GAAkB,EAAE,CAAC;IAErC,0CAA0C;IAE1C,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAClD,UAAU,CAAC,IAAI,CAAC;YACd,QAAQ,EAAE,gBAAgB;YAC1B,KAAK,EAAE;gBACL,sCAAsC;gBACtC,kEAAkE;gBAClE,2CAA2C;gBAC3C,qEAAqE;aACtE;YACD,UAAU,EAAE,EAAE;YACd,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QAEH,UAAU,CAAC,IAAI,CAAC;YACd,QAAQ,EAAE,6BAA6B;YACvC,KAAK,EAAE;gBACL,+CAA+C;gBAC/C,+CAA+C;gBAC/C,kEAAkE;aACnE;YACD,UAAU,EAAE,EAAE;YACd,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,UAAU,CAAC,IAAI,CAAC;YACd,QAAQ,EAAE,sBAAsB;YAChC,KAAK,EAAE;gBACL,2CAA2C;gBAC3C,2CAA2C;gBAC3C,iEAAiE;aAClE;YACD,UAAU,EAAE,EAAE;YACd,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QAEH,UAAU,CAAC,IAAI,CAAC;YACd,QAAQ,EAAE,gCAAgC;YAC1C,KAAK,EAAE;gBACL,4CAA4C;gBAC5C,oCAAoC;gBACpC,iCAAiC;aAClC;YACD,UAAU,EAAE,EAAE;YACd,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1C,UAAU,CAAC,IAAI,CAAC;YACd,QAAQ,EAAE,4BAA4B;YACtC,KAAK,EAAE;gBACL,+CAA+C;gBAC/C,iEAAiE;gBACjE,sDAAsD;gBACtD,6CAA6C;aAC9C;YACD,UAAU,EAAE,EAAE;YACd,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACL,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3C,UAAU,CAAC,IAAI,CAAC;YACd,QAAQ,EAAE,qBAAqB;YAC/B,KAAK,EAAE;gBACL,2CAA2C;gBAC3C,mDAAmD;gBACnD,gDAAgD;aACjD;YACD,UAAU,EAAE,EAAE;YACd,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACjD,UAAU,CAAC,IAAI,CAAC;YACd,QAAQ,EAAE,4BAA4B;YACtC,KAAK,EAAE;gBACL,8BAA8B;gBAC9B,oDAAoD;gBACpD,sDAAsD;gBACtD,qCAAqC;aACtC;YACD,UAAU,EAAE,EAAE;YACd,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,UAAU,CAAC,IAAI,CAAC;YACd,QAAQ,EAAE,qBAAqB;YAC/B,KAAK,EAAE;gBACL,qDAAqD;gBACrD,qCAAqC;gBACrC,4DAA4D;gBAC5D,gDAAgD;aACjD;YACD,UAAU,EAAE,EAAE;YACd,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,mBAAmB;QACnB,UAAU,CAAC,IAAI,CAAC;YACd,QAAQ,EAAE,4BAA4B;YACtC,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC;gBAC7B,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC5C,CAAC,CAAC,CAAC,uCAAuC,EAAE,oCAAoC,CAAC;YACnF,UAAU,EAAE,EAAE;YACd,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,KAAa,EAAE,UAAkB,EAAE,SAA0B;IAChG,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;IAEnE,MAAM,KAAK,GAAG,eAAe,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC;IACtE,MAAM,OAAO,GAAG,aAAa,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAG,mBAAmB,SAAS,CAAC,UAAU,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAG,uBAAuB,SAAS,CAAC,cAAc,CAAC,MAAM,IAAI,CAAC;IACzE,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,QAAQ,GAAG,SAAS,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;QAC7B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,kBAAkB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,SAA0B,EAAE,KAAa;IACxE,IAAI,MAAM,GAAG,oCAAoC,CAAC;IAClD,MAAM,IAAI,cAAc,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEnD,MAAM,IAAI,mBAAmB,CAAC;IAC9B,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,MAAM,CAAC;IACxC,MAAM,IAAI,mBAAmB,SAAS,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC;IAE1I,IAAI,SAAS,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,uBAAuB,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,IAAI,IAAI,CAAC;QAC1B,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,SAAS,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,4BAA4B,CAAC;QACvC,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,OAAO,IAAI,CAAC;QAC7B,CAAC;QACD,MAAM,IAAI,qDAAqD,CAAC;IAClE,CAAC;IAED,MAAM,IAAI,sBAAsB,SAAS,CAAC,cAAc,CAAC,MAAM,OAAO,CAAC;IAEvE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzD,MAAM,QAAQ,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,QAAQ,MAAM,CAAC;QAC5D,MAAM,IAAI,mBAAmB,QAAQ,CAAC,UAAU,KAAK,CAAC;QACtD,MAAM,IAAI,aAAa,QAAQ,CAAC,IAAI,MAAM,CAAC;QAC3C,MAAM,IAAI,cAAc,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC;QAClC,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;IACjB,CAAC;IAED,MAAM,IAAI,2CAA2C,CAAC;IAEtD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/enforce-feature.d.ts

@@ -0,0 +1,25 @@
+/**
+ * codebakers_enforce_feature
+ *
+ * Feature Build Enforcement
+ *
+ * Enforces FULL atomic unit protocol (no shortcuts allowed).
+ * Use when: @feature [description] or // [description]
+ *
+ * MANDATORY steps (cannot be skipped):
+ * 1. Context loading (BRAIN.md, DEPENDENCY-MAP.md, ERROR-LOG.md)
+ * 2. Error Sniffer scan (all patterns checked)
+ * 3. Atomic unit declaration (in FIX-QUEUE.md BEFORE code)
+ * 4. UNIT-PROGRESS.md creation (crash recovery)
+ * 5. All 8 steps (schema → API → store → UI → states → tests → gate)
+ * 6. BUILD-LOG.md update after every step
+ * 7. Gate check (all items must pass)
+ * 8. Atomic commit format: feat(atomic): [name] — gate passed [N/N checks]
+ *
+ * Result: Feature guaranteed complete, tested, and atomic.
+ */
+export declare function enforceFeature(args: {
+    feature_name?: string;
+    description?: string;
+}): Promise<string>;
+//# sourceMappingURL=enforce-feature.d.ts.map

package/dist/tools/enforce-feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enforce-feature.d.ts","sourceRoot":"","sources":["../../src/tools/enforce-feature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAmBH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwD3G"}