@codebakers/mcp 5.2.0

package/dist/tools/check-scope.js

@@ -0,0 +1,251 @@
+/**
+ * codebakers_check_scope
+ *
+ * Scope Verification
+ *
+ * Verifies that a feature request is defined in PROJECT-SPEC.md.
+ * Prevents scope creep by enforcing spec boundaries.
+ *
+ * Rules:
+ * - Feature must be in Gate 1 (Entities) or Gate 2 (State Changes)
+ * - If not found, must either:
+ *   1. Add to spec (formal amendment)
+ *   2. Descope (remove from request)
+ *   3. Flag for future iteration
+ * - Never silently expand scope
+ *
+ * Based on CodeBakers Method Principle #7: Fixed Appetite, Not Open Scope
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+export async function checkScope(args) {
+    const description = args.feature_description || 'unknown';
+    const cwd = process.cwd();
+    console.error('🍞 CodeBakers: Scope Verification');
+    console.error(`Checking: ${description}`);
+    try {
+        // 1. Load PROJECT-SPEC.md
+        const specPath = path.join(cwd, '.codebakers', 'PROJECT-SPEC.md');
+        const specExists = await fs.access(specPath).then(() => true).catch(() => false);
+        if (!specExists) {
+            return `🍞 CodeBakers: Scope Check BLOCKED
+
+❌ PROJECT-SPEC.md not found
+
+Cannot verify scope without specification.
+
+Next step: Run Phase 0 first (codebakers_generate_spec)`;
+        }
+        const specContent = await fs.readFile(specPath, 'utf-8');
+        // 2. Extract entities and state changes from spec
+        const entities = extractEntities(specContent);
+        const stateChanges = extractStateChanges(specContent);
+        console.error(`Spec contains ${entities.length} entities and ${stateChanges.length} state changes`);
+        // 3. Check if feature matches spec
+        const result = checkFeatureAgainstSpec(description, entities, stateChanges);
+        console.error(`Match confidence: ${result.confidence}`);
+        console.error(`In scope: ${result.in_scope}`);
+        // 4. Generate report
+        const report = generateScopeReport(description, result, entities, stateChanges);
+        return report;
+    }
+    catch (error) {
+        console.error('Error during scope check:', error);
+        return `🍞 CodeBakers: Scope Check Failed
+
+Error: ${error instanceof Error ? error.message : String(error)}
+
+Please verify PROJECT-SPEC.md exists and is readable.`;
+    }
+}
+/**
+ * Extract entities from spec
+ */
+function extractEntities(spec) {
+    const entities = [];
+    // Extract from Gate 1 section
+    const gate1Match = spec.match(/## Gate 1: Entities([\s\S]*?)(?=---|\n## Gate|$)/);
+    if (!gate1Match)
+        return entities;
+    const gate1Content = gate1Match[1];
+    // Extract entity names (markdown headers like ### User, ### Message, etc.)
+    const entityMatches = gate1Content.matchAll(/### (\w+)/g);
+    for (const match of entityMatches) {
+        entities.push(match[1].toLowerCase());
+    }
+    return entities;
+}
+/**
+ * Extract state changes from spec
+ */
+function extractStateChanges(spec) {
+    const stateChanges = [];
+    // Extract from Gate 2 section
+    const gate2Match = spec.match(/## Gate 2: State Changes([\s\S]*?)(?=---|\n## Gate|$)/);
+    if (!gate2Match)
+        return stateChanges;
+    const gate2Content = gate2Match[1];
+    // Extract from table format: | createUser | User | create | ... |
+    const stateMatches = gate2Content.matchAll(/\|\s*(\w+)\s*\|/g);
+    for (const match of stateMatches) {
+        const action = match[1];
+        // Skip table headers
+        if (action !== 'Action' && action !== 'Affects' && action !== 'Type' && action !== 'Description') {
+            stateChanges.push(action.toLowerCase());
+        }
+    }
+    return stateChanges;
+}
+/**
+ * Check feature against spec
+ */
+function checkFeatureAgainstSpec(description, entities, stateChanges) {
+    const lowerDesc = description.toLowerCase();
+    const words = lowerDesc.split(/\s+/);
+    const matchedEntities = [];
+    const matchedStateChanges = [];
+    // Check entity matches
+    for (const entity of entities) {
+        if (lowerDesc.includes(entity)) {
+            matchedEntities.push(entity);
+        }
+    }
+    // Check state change matches
+    for (const stateChange of stateChanges) {
+        if (lowerDesc.includes(stateChange.replace(/^(create|update|delete)/, '')) ||
+            words.some(w => stateChange.includes(w))) {
+            matchedStateChanges.push(stateChange);
+        }
+    }
+    // Check for CRUD verbs
+    const crudVerbs = ['create', 'add', 'new', 'update', 'edit', 'modify', 'delete', 'remove'];
+    const hasCrudVerb = crudVerbs.some(verb => lowerDesc.includes(verb));
+    // Determine confidence
+    let confidence;
+    let inScope;
+    let recommendation;
+    let specAmendmentRequired;
+    if (matchedEntities.length > 0 && matchedStateChanges.length > 0) {
+        // Strong match
+        confidence = 'high';
+        inScope = true;
+        recommendation = `✅ Feature matches spec. Entity: ${matchedEntities.join(', ')}. State change: ${matchedStateChanges.join(', ')}.`;
+        specAmendmentRequired = false;
+    }
+    else if (matchedEntities.length > 0 && hasCrudVerb) {
+        // Moderate match - entity found, CRUD verb present
+        confidence = 'medium';
+        inScope = true;
+        recommendation = `⚠️ Entity found in spec (${matchedEntities.join(', ')}), but specific state change not defined. May need spec amendment.`;
+        specAmendmentRequired = false; // Lenient - allow if entity exists
+    }
+    else if (matchedEntities.length > 0) {
+        // Entity found but no clear action
+        confidence = 'low';
+        inScope = false;
+        recommendation = `⚠️ Entity exists (${matchedEntities.join(', ')}), but action unclear. Clarify or add state change to spec.`;
+        specAmendmentRequired = true;
+    }
+    else {
+        // No matches
+        confidence = 'none';
+        inScope = false;
+        recommendation = `❌ Feature not found in spec. This appears to be scope creep.`;
+        specAmendmentRequired = true;
+    }
+    return {
+        in_scope: inScope,
+        matched_entities: matchedEntities,
+        matched_state_changes: matchedStateChanges,
+        confidence: confidence,
+        recommendation: recommendation,
+        spec_amendment_required: specAmendmentRequired,
+    };
+}
+/**
+ * Generate scope report
+ */
+function generateScopeReport(description, result, entities, stateChanges) {
+    let report = `🍞 CodeBakers: Scope Verification\n\n`;
+    report += `**Feature:** ${description}\n`;
+    report += `**Confidence:** ${result.confidence.toUpperCase()}\n`;
+    report += `**In Scope:** ${result.in_scope ? 'YES' : 'NO'}\n\n`;
+    report += `---\n\n`;
+    // Matches
+    report += `## Analysis\n\n`;
+    if (result.matched_entities.length > 0) {
+        report += `**Matched Entities:**\n`;
+        for (const entity of result.matched_entities) {
+            report += `- ${entity}\n`;
+        }
+        report += `\n`;
+    }
+    else {
+        report += `**Matched Entities:** None\n\n`;
+    }
+    if (result.matched_state_changes.length > 0) {
+        report += `**Matched State Changes:**\n`;
+        for (const change of result.matched_state_changes) {
+            report += `- ${change}\n`;
+        }
+        report += `\n`;
+    }
+    else {
+        report += `**Matched State Changes:** None\n\n`;
+    }
+    report += `---\n\n`;
+    // Recommendation
+    report += `## Recommendation\n\n`;
+    report += `${result.recommendation}\n\n`;
+    // Next steps
+    report += `---\n\n`;
+    report += `## Next Steps\n\n`;
+    if (result.in_scope && !result.spec_amendment_required) {
+        report += `✅ **APPROVED** - Feature is in scope\n\n`;
+        report += `Proceed with build:\n`;
+        report += `1. Use: codebakers_enforce_feature\n`;
+        report += `2. Follow atomic unit protocol\n`;
+        report += `3. Build feature\n\n`;
+    }
+    else if (result.in_scope && result.spec_amendment_required) {
+        report += `⚠️ **CONDITIONAL APPROVAL** - Clarification needed\n\n`;
+        report += `Options:\n`;
+        report += `1. Add specific state change to spec (amendment)\n`;
+        report += `2. Clarify feature description to match existing spec\n`;
+        report += `3. Proceed with caution if action is implied\n\n`;
+    }
+    else {
+        report += `❌ **SCOPE CREEP DETECTED** - Feature not in spec\n\n`;
+        report += `You MUST choose one:\n\n`;
+        report += `**Option 1: Spec Amendment (Recommended)**\n`;
+        report += `1. Review PROJECT-SPEC.md\n`;
+        report += `2. Add this feature to Gate 1 (Entities) or Gate 2 (State Changes)\n`;
+        report += `3. Get human approval for spec change\n`;
+        report += `4. Then proceed with build\n\n`;
+        report += `**Option 2: Descope**\n`;
+        report += `Remove this feature from request\n\n`;
+        report += `**Option 3: Future Iteration**\n`;
+        report += `Flag for next phase/version\n\n`;
+        report += `**NOT ALLOWED:**\n`;
+        report += `❌ Silently building features not in spec\n`;
+        report += `❌ Expanding scope without formal amendment\n\n`;
+    }
+    // Spec reference
+    report += `---\n\n`;
+    report += `## Spec Reference\n\n`;
+    report += `**Entities in spec (${entities.length}):**\n`;
+    for (const entity of entities) {
+        report += `- ${entity}\n`;
+    }
+    report += `\n`;
+    report += `**State changes in spec (${stateChanges.length}):**\n`;
+    for (const change of stateChanges.slice(0, 10)) {
+        report += `- ${change}\n`;
+    }
+    if (stateChanges.length > 10) {
+        report += `- ... and ${stateChanges.length - 10} more\n`;
+    }
+    report += `\n`;
+    return report;
+}
+//# sourceMappingURL=check-scope.js.map

package/dist/tools/check-scope.js.map

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

package/dist/tools/deploy-vercel.d.ts

@@ -0,0 +1,18 @@
+/**
+ * codebakers_deploy_vercel
+ *
+ * Vercel Deployment Automation
+ *
+ * Deploys app to Vercel:
+ * - Configures project
+ * - Sets environment variables
+ * - Deploys to production
+ * - Returns live URL
+ */
+interface DeployArgs {
+    production?: boolean;
+    env_file?: string;
+}
+export declare function deployVercel(args?: DeployArgs): Promise<string>;
+export {};
+//# sourceMappingURL=deploy-vercel.d.ts.map

package/dist/tools/deploy-vercel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-vercel.d.ts","sourceRoot":"","sources":["../../src/tools/deploy-vercel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,UAAU,UAAU;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,YAAY,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAsCzE"}

package/dist/tools/deploy-vercel.js

@@ -0,0 +1,178 @@
+/**
+ * codebakers_deploy_vercel
+ *
+ * Vercel Deployment Automation
+ *
+ * Deploys app to Vercel:
+ * - Configures project
+ * - Sets environment variables
+ * - Deploys to production
+ * - Returns live URL
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { execSync } from 'child_process';
+export async function deployVercel(args = {}) {
+    const cwd = process.cwd();
+    const { production = true, env_file = '.env' } = args;
+    console.error('🍞 CodeBakers: Deploying to Vercel');
+    try {
+        // Step 1: Check if Vercel CLI is installed
+        await ensureVercelCLI();
+        // Step 2: Check if project is linked
+        const projectLinked = await isProjectLinked(cwd);
+        if (!projectLinked) {
+            console.error('Project not linked to Vercel - linking now...');
+            await linkProject(cwd);
+        }
+        // Step 3: Load environment variables
+        const envVars = await loadEnvVars(cwd, env_file);
+        // Step 4: Set environment variables in Vercel
+        if (envVars.length > 0) {
+            console.error(`Setting ${envVars.length} environment variables...`);
+            await setEnvVars(cwd, envVars);
+        }
+        // Step 5: Deploy
+        console.error(production ? 'Deploying to production...' : 'Deploying preview...');
+        const url = await deploy(cwd, production);
+        // Step 6: Update BRAIN.md with deployment info
+        await updateBrainWithDeployment(cwd, url);
+        return generateDeploymentReport(url, production, envVars.length);
+    }
+    catch (error) {
+        return `🍞 CodeBakers: Deployment Failed\n\nError: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+async function ensureVercelCLI() {
+    try {
+        execSync('vercel --version', { stdio: 'ignore' });
+    }
+    catch {
+        throw new Error('Vercel CLI not installed.\n\n' +
+            'Install with: npm install -g vercel\n' +
+            'Then run: vercel login');
+    }
+}
+async function isProjectLinked(cwd) {
+    const vercelDir = path.join(cwd, '.vercel');
+    try {
+        await fs.access(vercelDir);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function linkProject(cwd) {
+    try {
+        // Try to link project (requires user interaction)
+        execSync('vercel link', {
+            cwd,
+            stdio: 'inherit'
+        });
+    }
+    catch (error) {
+        throw new Error('Failed to link project to Vercel.\n\n' +
+            'Run: vercel link\n' +
+            'Then retry deployment.');
+    }
+}
+async function loadEnvVars(cwd, envFile) {
+    const envPath = path.join(cwd, envFile);
+    const envVars = [];
+    try {
+        const content = await fs.readFile(envPath, 'utf-8');
+        const lines = content.split('\n');
+        for (const line of lines) {
+            // Skip comments and empty lines
+            if (!line.trim() || line.trim().startsWith('#'))
+                continue;
+            const match = line.match(/^([A-Z_][A-Z0-9_]*)\s*=\s*(.+)$/);
+            if (match) {
+                const [, key, value] = match;
+                // Remove quotes if present
+                const cleanValue = value.replace(/^["']|["']$/g, '');
+                envVars.push({ key, value: cleanValue });
+            }
+        }
+    }
+    catch {
+        // .env doesn't exist - that's okay
+    }
+    return envVars;
+}
+async function setEnvVars(cwd, envVars) {
+    // Note: vercel env add requires interactive input
+    // For automation, we'll provide guidance instead
+    console.error('\nEnvironment variables detected.\n' +
+        'Set them in Vercel dashboard or run:\n');
+    for (const { key } of envVars) {
+        console.error(`  vercel env add ${key}`);
+    }
+    console.error('\nSkipping automatic env setup - deploy will continue...\n');
+}
+async function deploy(cwd, production) {
+    try {
+        const args = production ? '--prod' : '';
+        const output = execSync(`vercel ${args} --yes`, {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe']
+        });
+        // Extract URL from output
+        const urlMatch = output.match(/https:\/\/[^\s]+/);
+        if (urlMatch) {
+            return urlMatch[0];
+        }
+        throw new Error('Deployment succeeded but URL not found in output');
+    }
+    catch (error) {
+        throw new Error('Deployment failed.\n\n' +
+            'Possible causes:\n' +
+            '- Not logged in: Run `vercel login`\n' +
+            '- Build errors: Check TypeScript and Next.js config\n' +
+            '- Missing environment variables\n\n' +
+            `Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function updateBrainWithDeployment(cwd, url) {
+    const brainPath = path.join(cwd, '.codebakers', 'BRAIN.md');
+    try {
+        let content = await fs.readFile(brainPath, 'utf-8');
+        // Update or add deployment section
+        const deploymentSection = `\n## Deployment\n\n**Production URL:** ${url}\n**Last deployed:** ${new Date().toISOString()}\n**Platform:** Vercel\n`;
+        if (content.includes('## Deployment')) {
+            content = content.replace(/## Deployment[\s\S]*?(?=\n##|$)/, deploymentSection);
+        }
+        else {
+            content += deploymentSection;
+        }
+        await fs.writeFile(brainPath, content, 'utf-8');
+    }
+    catch {
+        // BRAIN.md doesn't exist - create minimal version
+        await fs.mkdir(path.dirname(brainPath), { recursive: true });
+        await fs.writeFile(brainPath, `# Project Memory\n\n## Deployment\n\n**Production URL:** ${url}\n**Last deployed:** ${new Date().toISOString()}\n**Platform:** Vercel\n`, 'utf-8');
+    }
+}
+function generateDeploymentReport(url, production, envCount) {
+    let report = `🍞 CodeBakers: Deployment ${production ? 'Complete' : 'Preview Ready'}\n\n`;
+    report += `✅ **Live URL:** ${url}\n\n`;
+    report += `## Deployment Details\n\n`;
+    report += `- **Environment:** ${production ? 'Production' : 'Preview'}\n`;
+    report += `- **Platform:** Vercel\n`;
+    report += `- **Deployed:** ${new Date().toLocaleString()}\n`;
+    if (envCount > 0) {
+        report += `- **Environment variables:** ${envCount} loaded\n`;
+    }
+    report += `\n## Next Steps\n\n`;
+    report += `1. Visit: ${url}\n`;
+    report += `2. Test core functionality\n`;
+    report += `3. Monitor errors: https://vercel.com/dashboard\n`;
+    if (envCount > 0) {
+        report += `4. Verify environment variables in Vercel dashboard\n`;
+    }
+    report += `\n✨ Your app is live!\n`;
+    return report;
+}
+//# sourceMappingURL=deploy-vercel.js.map

package/dist/tools/deploy-vercel.js.map

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

package/dist/tools/diagnose-error.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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
+ */
+interface DiagnoseArgs {
+    error_message: string;
+    stack_trace?: string;
+    context?: string;
+}
+export declare function diagnoseError(args: DiagnoseArgs): Promise<string>;
+export {};
+//# sourceMappingURL=diagnose-error.d.ts.map

package/dist/tools/diagnose-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose-error.d.ts","sourceRoot":"","sources":["../../src/tools/diagnose-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,UAAU,YAAY;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiBD,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCvE"}