@codebakers/cli 3.8.7 → 3.8.9

package/dist/commands/go.d.ts

@@ -1,9 +1,17 @@
 interface GoOptions {
     verbose?: boolean;
+    type?: 'personal' | 'client' | 'business';
+    name?: string;
+    describe?: 'guided' | 'template' | 'paste' | 'chat' | 'files';
+    skipReview?: boolean;
 }
 /**
  * Zero-friction entry point - start using CodeBakers instantly
  * Single command for both trial and paid users
+ *
+ * SMART BEHAVIOR:
+ * - If CodeBakers already set up → Show context and resume from where you left off
+ * - If not set up → Run first-time setup (trial or login)
  */
 export declare function go(options?: GoOptions): Promise<void>;
 export {};

package/dist/commands/go.js

@@ -709,6 +709,190 @@ function updateGitignore(cwd) {
         }
     }
 }
+function analyzeProjectState(cwd) {
+    const state = {
+        isSetUp: false,
+        hasPrd: false,
+        inProgressTasks: [],
+        completedTasks: [],
+        blockers: [],
+        suggestion: '',
+    };
+    // Check if CodeBakers is set up
+    const codebakersJsonPath = (0, path_1.join)(cwd, '.codebakers.json');
+    if (!(0, fs_1.existsSync)(codebakersJsonPath)) {
+        state.suggestion = 'Project not set up. Running first-time setup...';
+        return state;
+    }
+    state.isSetUp = true;
+    // Read .codebakers.json
+    try {
+        const cbState = JSON.parse((0, fs_1.readFileSync)(codebakersJsonPath, 'utf-8'));
+        state.projectName = cbState.projectName;
+        state.projectType = cbState.projectType;
+    }
+    catch {
+        // Ignore parse errors
+    }
+    // Check for PRD.md
+    const prdPath = (0, path_1.join)(cwd, 'PRD.md');
+    if ((0, fs_1.existsSync)(prdPath)) {
+        state.hasPrd = true;
+        try {
+            const prdContent = (0, fs_1.readFileSync)(prdPath, 'utf-8');
+            // Extract one-liner if present
+            const oneLineMatch = prdContent.match(/\*\*One-liner:\*\*\s*(.+)/);
+            if (oneLineMatch) {
+                state.prdSummary = oneLineMatch[1].trim();
+            }
+            else {
+                // Get first non-comment, non-header line
+                const lines = prdContent.split('\n').filter(l => l.trim() && !l.startsWith('#') && !l.startsWith('<!--'));
+                if (lines[0]) {
+                    state.prdSummary = lines[0].substring(0, 100);
+                }
+            }
+        }
+        catch {
+            // Ignore read errors
+        }
+    }
+    // Read PROJECT-STATE.md for tasks
+    const projectStatePath = (0, path_1.join)(cwd, 'PROJECT-STATE.md');
+    if ((0, fs_1.existsSync)(projectStatePath)) {
+        try {
+            const content = (0, fs_1.readFileSync)(projectStatePath, 'utf-8');
+            // Extract In Progress section
+            const inProgressMatch = content.match(/## In Progress\n([\s\S]*?)(?=\n##|$)/);
+            if (inProgressMatch) {
+                const lines = inProgressMatch[1].split('\n')
+                    .filter(l => l.trim().startsWith('-'))
+                    .map(l => l.replace(/^-\s*/, '').trim())
+                    .filter(l => l && !l.startsWith('<!--'));
+                state.inProgressTasks = lines;
+            }
+            // Extract Completed section (last 5)
+            const completedMatch = content.match(/## Completed\n([\s\S]*?)(?=\n##|$)/);
+            if (completedMatch) {
+                const lines = completedMatch[1].split('\n')
+                    .filter(l => l.trim().startsWith('-'))
+                    .map(l => l.replace(/^-\s*/, '').trim())
+                    .filter(l => l && !l.startsWith('<!--'));
+                state.completedTasks = lines.slice(-5);
+            }
+            // Extract Blockers section
+            const blockersMatch = content.match(/## Blockers\n([\s\S]*?)(?=\n##|$)/);
+            if (blockersMatch) {
+                const lines = blockersMatch[1].split('\n')
+                    .filter(l => l.trim().startsWith('-'))
+                    .map(l => l.replace(/^-\s*/, '').trim())
+                    .filter(l => l && !l.startsWith('<!--'));
+                state.blockers = lines;
+            }
+        }
+        catch {
+            // Ignore read errors
+        }
+    }
+    // Read DEVLOG for last session
+    const devlogPath = (0, path_1.join)(cwd, '.codebakers', 'DEVLOG.md');
+    if ((0, fs_1.existsSync)(devlogPath)) {
+        try {
+            const content = (0, fs_1.readFileSync)(devlogPath, 'utf-8');
+            // Get first session entry
+            const sessionMatch = content.match(/## .+?\n\*\*Session:\*\*\s*(.+)/);
+            if (sessionMatch) {
+                state.lastSession = sessionMatch[1].trim();
+            }
+            // Get "What was done" from most recent entry
+            const whatDoneMatch = content.match(/### What was done:\n([\s\S]*?)(?=\n###|---|\n\n)/);
+            if (whatDoneMatch && !state.lastSession) {
+                const lines = whatDoneMatch[1].split('\n')
+                    .filter(l => l.trim().startsWith('-'))
+                    .map(l => l.replace(/^-\s*/, '').trim());
+                if (lines[0]) {
+                    state.lastSession = lines[0];
+                }
+            }
+        }
+        catch {
+            // Ignore read errors
+        }
+    }
+    // Determine suggestion based on state
+    if (state.blockers.length > 0) {
+        state.suggestion = `BLOCKED: ${state.blockers[0]}. Address this blocker first.`;
+    }
+    else if (state.inProgressTasks.length > 0) {
+        state.suggestion = `CONTINUE: ${state.inProgressTasks[0]}`;
+    }
+    else if (state.hasPrd && state.completedTasks.length === 0) {
+        state.suggestion = `START BUILDING: PRD exists. Begin implementing features from PRD.md`;
+    }
+    else if (!state.hasPrd) {
+        state.suggestion = `DEFINE PROJECT: No PRD found. Describe what you want to build.`;
+    }
+    else {
+        state.suggestion = `READY: Project set up. Ask for the next feature to build.`;
+    }
+    return state;
+}
+function showResumeContext(state) {
+    console.log(chalk_1.default.blue(`
+  ╔═══════════════════════════════════════════════════════════╗
+  ║                                                           ║
+  ║   ${chalk_1.default.bold.white('CodeBakers - Resuming Session')}                          ║
+  ║                                                           ║
+  ╚═══════════════════════════════════════════════════════════╝
+  `));
+    console.log(chalk_1.default.white(`  📁 Project: ${chalk_1.default.cyan(state.projectName || 'Unknown')}`));
+    if (state.prdSummary) {
+        console.log(chalk_1.default.gray(`  📝 ${state.prdSummary}`));
+    }
+    console.log('');
+    // Show blockers first (critical)
+    if (state.blockers.length > 0) {
+        console.log(chalk_1.default.red('  ⚠️  BLOCKERS:'));
+        for (const blocker of state.blockers) {
+            console.log(chalk_1.default.red(`      • ${blocker}`));
+        }
+        console.log('');
+    }
+    // Show in-progress tasks
+    if (state.inProgressTasks.length > 0) {
+        console.log(chalk_1.default.yellow('  🔄 IN PROGRESS:'));
+        for (const task of state.inProgressTasks) {
+            console.log(chalk_1.default.yellow(`      • ${task}`));
+        }
+        console.log('');
+    }
+    // Show recent completed (context)
+    if (state.completedTasks.length > 0) {
+        console.log(chalk_1.default.green('  ✓ RECENTLY COMPLETED:'));
+        for (const task of state.completedTasks.slice(-3)) {
+            console.log(chalk_1.default.gray(`      • ${task}`));
+        }
+        console.log('');
+    }
+    // Show last session timestamp if available
+    if (state.lastSession) {
+        console.log(chalk_1.default.gray(`  📅 Last session: ${state.lastSession}`));
+        console.log('');
+    }
+    // Show the suggestion prominently
+    console.log(chalk_1.default.cyan('  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk_1.default.white.bold(`\n  → ${state.suggestion}\n`));
+    console.log(chalk_1.default.cyan('  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+    // Output machine-readable context for AI
+    console.log(chalk_1.default.gray('  [AI Context]'));
+    console.log(chalk_1.default.gray(`  Project: ${state.projectName || 'Unknown'}`));
+    console.log(chalk_1.default.gray(`  Status: ${state.inProgressTasks.length > 0 ? 'IN_PROGRESS' : state.blockers.length > 0 ? 'BLOCKED' : 'READY'}`));
+    console.log(chalk_1.default.gray(`  Next Action: ${state.suggestion}`));
+    if (state.hasPrd) {
+        console.log(chalk_1.default.gray(`  PRD: Available at PRD.md`));
+    }
+    console.log('');
+}
 /**
  * Get CLI version from package.json
  */
@@ -754,11 +938,42 @@ function log(message, options) {
 /**
  * Zero-friction entry point - start using CodeBakers instantly
  * Single command for both trial and paid users
+ *
+ * SMART BEHAVIOR:
+ * - If CodeBakers already set up → Show context and resume from where you left off
+ * - If not set up → Run first-time setup (trial or login)
  */
 async function go(options = {}) {
     log('Starting go command...', options);
     log(`API URL: ${(0, config_js_1.getApiUrl)()}`, options);
     log(`Working directory: ${process.cwd()}`, options);
+    const cwd = process.cwd();
+    // =========================================================================
+    // SMART CONTEXT CHECK - If already set up, show resume context
+    // =========================================================================
+    const projectState = analyzeProjectState(cwd);
+    if (projectState.isSetUp) {
+        // Project already has CodeBakers - show context and resume
+        showResumeContext(projectState);
+        // Verify auth is still valid
+        const existingApiKey = (0, config_js_1.getApiKey)();
+        const existingTrial = (0, config_js_1.getTrialState)();
+        if (existingApiKey) {
+            console.log(chalk_1.default.green('  ✓ Authenticated (API key)\n'));
+        }
+        else if (existingTrial && !(0, config_js_1.isTrialExpired)()) {
+            const daysRemaining = (0, config_js_1.getTrialDaysRemaining)();
+            console.log(chalk_1.default.green(`  ✓ Trial active (${daysRemaining} days remaining)\n`));
+        }
+        else if (existingTrial && (0, config_js_1.isTrialExpired)()) {
+            console.log(chalk_1.default.yellow('  ⚠️  Trial expired. Run `codebakers extend` or login.\n'));
+        }
+        // Don't run setup again - just show context
+        return;
+    }
+    // =========================================================================
+    // FIRST-TIME SETUP - Project not yet configured
+    // =========================================================================
     console.log(chalk_1.default.blue(`
   ╔═══════════════════════════════════════════════════════════╗
   ║                                                           ║
@@ -1113,19 +1328,29 @@ async function setupProject(options = {}, auth) {
 }
 async function setupNewProject(cwd, options = {}, auth) {
     console.log(chalk_1.default.cyan('\n  ━━━ New Project Setup ━━━\n'));
-    // Get project info
-    console.log(chalk_1.default.white('  What kind of project is this?\n'));
-    console.log(chalk_1.default.gray('    1. ') + chalk_1.default.cyan('PERSONAL') + chalk_1.default.gray(' - Just building for myself'));
-    console.log(chalk_1.default.gray('    2. ') + chalk_1.default.cyan('CLIENT') + chalk_1.default.gray('   - Building for someone else'));
-    console.log(chalk_1.default.gray('    3. ') + chalk_1.default.cyan('BUSINESS') + chalk_1.default.gray(' - My own product/startup\n'));
-    let typeChoice = '';
-    while (!['1', '2', '3'].includes(typeChoice)) {
-        typeChoice = await prompt('  Enter 1, 2, or 3: ');
-    }
-    const typeMap = { '1': 'personal', '2': 'client', '3': 'business' };
-    const projectType = typeMap[typeChoice];
+    let projectType;
+    let projectName;
     const defaultName = cwd.split(/[\\/]/).pop() || 'my-project';
-    const projectName = await prompt(`  Project name (${defaultName}): `) || defaultName;
+    // Use flags if provided (non-interactive mode for AI)
+    if (options.type) {
+        projectType = options.type;
+        projectName = options.name || defaultName;
+        console.log(chalk_1.default.green(`  Using: ${projectType.toUpperCase()} project named "${projectName}"\n`));
+    }
+    else {
+        // Interactive mode - ask questions
+        console.log(chalk_1.default.white('  What kind of project is this?\n'));
+        console.log(chalk_1.default.gray('    1. ') + chalk_1.default.cyan('PERSONAL') + chalk_1.default.gray(' - Just building for myself'));
+        console.log(chalk_1.default.gray('    2. ') + chalk_1.default.cyan('CLIENT') + chalk_1.default.gray('   - Building for someone else'));
+        console.log(chalk_1.default.gray('    3. ') + chalk_1.default.cyan('BUSINESS') + chalk_1.default.gray(' - My own product/startup\n'));
+        let typeChoice = '';
+        while (!['1', '2', '3'].includes(typeChoice)) {
+            typeChoice = await prompt('  Enter 1, 2, or 3: ');
+        }
+        const typeMap = { '1': 'personal', '2': 'client', '3': 'business' };
+        projectType = typeMap[typeChoice];
+        projectName = await prompt(`  Project name (${defaultName}): `) || defaultName;
+    }
     console.log(chalk_1.default.green(`\n  ✓ Setting up "${projectName}" as ${projectType.toUpperCase()} project\n`));
     // Install bootstrap files
     console.log(chalk_1.default.white('  Installing CodeBakers...\n'));
@@ -1140,15 +1365,26 @@ async function setupNewProject(cwd, options = {}, auth) {
     // Update .gitignore
     updateGitignore(cwd);
     // How to describe project
-    console.log(chalk_1.default.white('\n  📝 How would you like to describe your project?\n'));
-    console.log(chalk_1.default.gray('    1. ') + chalk_1.default.cyan('GUIDED QUESTIONS') + chalk_1.default.gray(' - I\'ll ask you step by step'));
-    console.log(chalk_1.default.gray('    2. ') + chalk_1.default.cyan('WRITE A PRD') + chalk_1.default.gray('      - Create a blank template to fill out'));
-    console.log(chalk_1.default.gray('    3. ') + chalk_1.default.cyan('PASTE/UPLOAD PRD') + chalk_1.default.gray(' - I already have requirements written'));
-    console.log(chalk_1.default.gray('    4. ') + chalk_1.default.cyan('DESCRIBE IN CHAT') + chalk_1.default.gray(' - Just tell the AI what you want'));
-    console.log(chalk_1.default.gray('    5. ') + chalk_1.default.cyan('SHARE FILES') + chalk_1.default.gray('      - I\'ll share docs/mockups/screenshots\n'));
     let describeChoice = '';
-    while (!['1', '2', '3', '4', '5'].includes(describeChoice)) {
-        describeChoice = await prompt('  Enter 1-5: ');
+    // Use flag if provided (non-interactive mode for AI)
+    if (options.describe) {
+        const describeMap = {
+            'guided': '1', 'template': '2', 'paste': '3', 'chat': '4', 'files': '5'
+        };
+        describeChoice = describeMap[options.describe] || '4';
+        console.log(chalk_1.default.green(`  Using: ${options.describe} mode for project description\n`));
+    }
+    else {
+        // Interactive mode
+        console.log(chalk_1.default.white('\n  📝 How would you like to describe your project?\n'));
+        console.log(chalk_1.default.gray('    1. ') + chalk_1.default.cyan('GUIDED QUESTIONS') + chalk_1.default.gray(' - I\'ll ask you step by step'));
+        console.log(chalk_1.default.gray('    2. ') + chalk_1.default.cyan('WRITE A PRD') + chalk_1.default.gray('      - Create a blank template to fill out'));
+        console.log(chalk_1.default.gray('    3. ') + chalk_1.default.cyan('PASTE/UPLOAD PRD') + chalk_1.default.gray(' - I already have requirements written'));
+        console.log(chalk_1.default.gray('    4. ') + chalk_1.default.cyan('DESCRIBE IN CHAT') + chalk_1.default.gray(' - Just tell the AI what you want'));
+        console.log(chalk_1.default.gray('    5. ') + chalk_1.default.cyan('SHARE FILES') + chalk_1.default.gray('      - I\'ll share docs/mockups/screenshots\n'));
+        while (!['1', '2', '3', '4', '5'].includes(describeChoice)) {
+            describeChoice = await prompt('  Enter 1-5: ');
+        }
     }
     let prdCreated = false;
     if (describeChoice === '1') {
@@ -1244,15 +1480,36 @@ async function setupExistingProject(cwd, projectInfo, options = {}, auth) {
     }
     // Get project name
     const defaultName = cwd.split(/[\\/]/).pop() || 'my-project';
-    const projectName = await prompt(`\n  Project name (${defaultName}): `) || defaultName;
-    // Code review offer
-    console.log(chalk_1.default.white('\n  Want me to review your code and bring it up to CodeBakers standards?\n'));
-    console.log(chalk_1.default.gray('    1. ') + chalk_1.default.cyan('YES, REVIEW & FIX') + chalk_1.default.gray(' - Run audit, then auto-fix issues'));
-    console.log(chalk_1.default.gray('    2. ') + chalk_1.default.cyan('REVIEW ONLY') + chalk_1.default.gray('      - Just show me the issues'));
-    console.log(chalk_1.default.gray('    3. ') + chalk_1.default.cyan('SKIP') + chalk_1.default.gray('             - Just install CodeBakers\n'));
-    let reviewChoice = '';
-    while (!['1', '2', '3'].includes(reviewChoice)) {
-        reviewChoice = await prompt('  Enter 1, 2, or 3: ');
+    let projectName;
+    let reviewChoice;
+    // Use flags if provided (non-interactive mode for AI)
+    if (options.name) {
+        projectName = options.name;
+        console.log(chalk_1.default.green(`\n  Using project name: "${projectName}"\n`));
+    }
+    else {
+        projectName = await prompt(`\n  Project name (${defaultName}): `) || defaultName;
+    }
+    // Use skipReview flag or ask
+    if (options.skipReview) {
+        reviewChoice = '3';
+        console.log(chalk_1.default.gray('  Skipping code review (--skip-review flag)\n'));
+    }
+    else if (options.type) {
+        // If running in non-interactive mode, default to skip review
+        reviewChoice = '3';
+        console.log(chalk_1.default.gray('  Skipping code review (non-interactive mode)\n'));
+    }
+    else {
+        // Interactive mode - ask about code review
+        console.log(chalk_1.default.white('\n  Want me to review your code and bring it up to CodeBakers standards?\n'));
+        console.log(chalk_1.default.gray('    1. ') + chalk_1.default.cyan('YES, REVIEW & FIX') + chalk_1.default.gray(' - Run audit, then auto-fix issues'));
+        console.log(chalk_1.default.gray('    2. ') + chalk_1.default.cyan('REVIEW ONLY') + chalk_1.default.gray('      - Just show me the issues'));
+        console.log(chalk_1.default.gray('    3. ') + chalk_1.default.cyan('SKIP') + chalk_1.default.gray('             - Just install CodeBakers\n'));
+        reviewChoice = '';
+        while (!['1', '2', '3'].includes(reviewChoice)) {
+            reviewChoice = await prompt('  Enter 1, 2, or 3: ');
+        }
     }
     let auditScore;
     if (reviewChoice !== '3') {

package/dist/index.js

@@ -202,7 +202,18 @@ program
     .alias('start')
     .description('Start using CodeBakers instantly (no signup required)')
     .option('-v, --verbose', 'Show detailed debug output for troubleshooting')
-    .action((options) => (0, go_js_1.go)({ verbose: options.verbose }));
+    // Non-interactive flags for programmatic use (e.g., by AI assistants)
+    .option('-t, --type <type>', 'Project type: personal, client, or business')
+    .option('-n, --name <name>', 'Project name')
+    .option('-d, --describe <mode>', 'Description mode: guided, template, paste, chat, or files')
+    .option('--skip-review', 'Skip the review question for existing projects')
+    .action((options) => (0, go_js_1.go)({
+    verbose: options.verbose,
+    type: options.type,
+    name: options.name,
+    describe: options.describe,
+    skipReview: options.skipReview,
+}));
 program
     .command('extend')
     .description('Extend your free trial with GitHub')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codebakers/cli",
-  "version": "3.8.7",
+  "version": "3.8.9",
   "description": "CodeBakers CLI - Production patterns for AI-assisted development",
   "main": "dist/index.js",
   "bin": {

package/src/commands/go.ts

@@ -771,6 +771,227 @@ function updateGitignore(cwd: string): void {
 
 interface GoOptions {
   verbose?: boolean;
+  // Non-interactive flags for programmatic use (e.g., by AI assistants)
+  type?: 'personal' | 'client' | 'business';
+  name?: string;
+  describe?: 'guided' | 'template' | 'paste' | 'chat' | 'files';
+  skipReview?: boolean;
+}
+
+// ============================================================================
+// SMART CONTEXT DETECTION - "Where am I? What's next?"
+// ============================================================================
+
+interface ProjectState {
+  isSetUp: boolean;
+  projectName?: string;
+  projectType?: string;
+  hasPrd: boolean;
+  prdSummary?: string;
+  inProgressTasks: string[];
+  completedTasks: string[];
+  blockers: string[];
+  lastSession?: string;
+  suggestion: string;
+}
+
+function analyzeProjectState(cwd: string): ProjectState {
+  const state: ProjectState = {
+    isSetUp: false,
+    hasPrd: false,
+    inProgressTasks: [],
+    completedTasks: [],
+    blockers: [],
+    suggestion: '',
+  };
+
+  // Check if CodeBakers is set up
+  const codebakersJsonPath = join(cwd, '.codebakers.json');
+  if (!existsSync(codebakersJsonPath)) {
+    state.suggestion = 'Project not set up. Running first-time setup...';
+    return state;
+  }
+
+  state.isSetUp = true;
+
+  // Read .codebakers.json
+  try {
+    const cbState = JSON.parse(readFileSync(codebakersJsonPath, 'utf-8'));
+    state.projectName = cbState.projectName;
+    state.projectType = cbState.projectType;
+  } catch {
+    // Ignore parse errors
+  }
+
+  // Check for PRD.md
+  const prdPath = join(cwd, 'PRD.md');
+  if (existsSync(prdPath)) {
+    state.hasPrd = true;
+    try {
+      const prdContent = readFileSync(prdPath, 'utf-8');
+      // Extract one-liner if present
+      const oneLineMatch = prdContent.match(/\*\*One-liner:\*\*\s*(.+)/);
+      if (oneLineMatch) {
+        state.prdSummary = oneLineMatch[1].trim();
+      } else {
+        // Get first non-comment, non-header line
+        const lines = prdContent.split('\n').filter(l =>
+          l.trim() && !l.startsWith('#') && !l.startsWith('<!--')
+        );
+        if (lines[0]) {
+          state.prdSummary = lines[0].substring(0, 100);
+        }
+      }
+    } catch {
+      // Ignore read errors
+    }
+  }
+
+  // Read PROJECT-STATE.md for tasks
+  const projectStatePath = join(cwd, 'PROJECT-STATE.md');
+  if (existsSync(projectStatePath)) {
+    try {
+      const content = readFileSync(projectStatePath, 'utf-8');
+
+      // Extract In Progress section
+      const inProgressMatch = content.match(/## In Progress\n([\s\S]*?)(?=\n##|$)/);
+      if (inProgressMatch) {
+        const lines = inProgressMatch[1].split('\n')
+          .filter(l => l.trim().startsWith('-'))
+          .map(l => l.replace(/^-\s*/, '').trim())
+          .filter(l => l && !l.startsWith('<!--'));
+        state.inProgressTasks = lines;
+      }
+
+      // Extract Completed section (last 5)
+      const completedMatch = content.match(/## Completed\n([\s\S]*?)(?=\n##|$)/);
+      if (completedMatch) {
+        const lines = completedMatch[1].split('\n')
+          .filter(l => l.trim().startsWith('-'))
+          .map(l => l.replace(/^-\s*/, '').trim())
+          .filter(l => l && !l.startsWith('<!--'));
+        state.completedTasks = lines.slice(-5);
+      }
+
+      // Extract Blockers section
+      const blockersMatch = content.match(/## Blockers\n([\s\S]*?)(?=\n##|$)/);
+      if (blockersMatch) {
+        const lines = blockersMatch[1].split('\n')
+          .filter(l => l.trim().startsWith('-'))
+          .map(l => l.replace(/^-\s*/, '').trim())
+          .filter(l => l && !l.startsWith('<!--'));
+        state.blockers = lines;
+      }
+    } catch {
+      // Ignore read errors
+    }
+  }
+
+  // Read DEVLOG for last session
+  const devlogPath = join(cwd, '.codebakers', 'DEVLOG.md');
+  if (existsSync(devlogPath)) {
+    try {
+      const content = readFileSync(devlogPath, 'utf-8');
+      // Get first session entry
+      const sessionMatch = content.match(/## .+?\n\*\*Session:\*\*\s*(.+)/);
+      if (sessionMatch) {
+        state.lastSession = sessionMatch[1].trim();
+      }
+      // Get "What was done" from most recent entry
+      const whatDoneMatch = content.match(/### What was done:\n([\s\S]*?)(?=\n###|---|\n\n)/);
+      if (whatDoneMatch && !state.lastSession) {
+        const lines = whatDoneMatch[1].split('\n')
+          .filter(l => l.trim().startsWith('-'))
+          .map(l => l.replace(/^-\s*/, '').trim());
+        if (lines[0]) {
+          state.lastSession = lines[0];
+        }
+      }
+    } catch {
+      // Ignore read errors
+    }
+  }
+
+  // Determine suggestion based on state
+  if (state.blockers.length > 0) {
+    state.suggestion = `BLOCKED: ${state.blockers[0]}. Address this blocker first.`;
+  } else if (state.inProgressTasks.length > 0) {
+    state.suggestion = `CONTINUE: ${state.inProgressTasks[0]}`;
+  } else if (state.hasPrd && state.completedTasks.length === 0) {
+    state.suggestion = `START BUILDING: PRD exists. Begin implementing features from PRD.md`;
+  } else if (!state.hasPrd) {
+    state.suggestion = `DEFINE PROJECT: No PRD found. Describe what you want to build.`;
+  } else {
+    state.suggestion = `READY: Project set up. Ask for the next feature to build.`;
+  }
+
+  return state;
+}
+
+function showResumeContext(state: ProjectState): void {
+  console.log(chalk.blue(`
+  ╔═══════════════════════════════════════════════════════════╗
+  ║                                                           ║
+  ║   ${chalk.bold.white('CodeBakers - Resuming Session')}                          ║
+  ║                                                           ║
+  ╚═══════════════════════════════════════════════════════════╝
+  `));
+
+  console.log(chalk.white(`  📁 Project: ${chalk.cyan(state.projectName || 'Unknown')}`));
+
+  if (state.prdSummary) {
+    console.log(chalk.gray(`  📝 ${state.prdSummary}`));
+  }
+
+  console.log('');
+
+  // Show blockers first (critical)
+  if (state.blockers.length > 0) {
+    console.log(chalk.red('  ⚠️  BLOCKERS:'));
+    for (const blocker of state.blockers) {
+      console.log(chalk.red(`      • ${blocker}`));
+    }
+    console.log('');
+  }
+
+  // Show in-progress tasks
+  if (state.inProgressTasks.length > 0) {
+    console.log(chalk.yellow('  🔄 IN PROGRESS:'));
+    for (const task of state.inProgressTasks) {
+      console.log(chalk.yellow(`      • ${task}`));
+    }
+    console.log('');
+  }
+
+  // Show recent completed (context)
+  if (state.completedTasks.length > 0) {
+    console.log(chalk.green('  ✓ RECENTLY COMPLETED:'));
+    for (const task of state.completedTasks.slice(-3)) {
+      console.log(chalk.gray(`      • ${task}`));
+    }
+    console.log('');
+  }
+
+  // Show last session timestamp if available
+  if (state.lastSession) {
+    console.log(chalk.gray(`  📅 Last session: ${state.lastSession}`));
+    console.log('');
+  }
+
+  // Show the suggestion prominently
+  console.log(chalk.cyan('  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+  console.log(chalk.white.bold(`\n  → ${state.suggestion}\n`));
+  console.log(chalk.cyan('  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+
+  // Output machine-readable context for AI
+  console.log(chalk.gray('  [AI Context]'));
+  console.log(chalk.gray(`  Project: ${state.projectName || 'Unknown'}`));
+  console.log(chalk.gray(`  Status: ${state.inProgressTasks.length > 0 ? 'IN_PROGRESS' : state.blockers.length > 0 ? 'BLOCKED' : 'READY'}`));
+  console.log(chalk.gray(`  Next Action: ${state.suggestion}`));
+  if (state.hasPrd) {
+    console.log(chalk.gray(`  PRD: Available at PRD.md`));
+  }
+  console.log('');
 }
 
 interface ConfirmData {
@@ -833,12 +1054,48 @@ function log(message: string, options?: GoOptions): void {
 /**
  * Zero-friction entry point - start using CodeBakers instantly
  * Single command for both trial and paid users
+ *
+ * SMART BEHAVIOR:
+ * - If CodeBakers already set up → Show context and resume from where you left off
+ * - If not set up → Run first-time setup (trial or login)
  */
 export async function go(options: GoOptions = {}): Promise<void> {
   log('Starting go command...', options);
   log(`API URL: ${getApiUrl()}`, options);
   log(`Working directory: ${process.cwd()}`, options);
 
+  const cwd = process.cwd();
+
+  // =========================================================================
+  // SMART CONTEXT CHECK - If already set up, show resume context
+  // =========================================================================
+  const projectState = analyzeProjectState(cwd);
+
+  if (projectState.isSetUp) {
+    // Project already has CodeBakers - show context and resume
+    showResumeContext(projectState);
+
+    // Verify auth is still valid
+    const existingApiKey = getApiKey();
+    const existingTrial = getTrialState();
+
+    if (existingApiKey) {
+      console.log(chalk.green('  ✓ Authenticated (API key)\n'));
+    } else if (existingTrial && !isTrialExpired()) {
+      const daysRemaining = getTrialDaysRemaining();
+      console.log(chalk.green(`  ✓ Trial active (${daysRemaining} days remaining)\n`));
+    } else if (existingTrial && isTrialExpired()) {
+      console.log(chalk.yellow('  ⚠️  Trial expired. Run `codebakers extend` or login.\n'));
+    }
+
+    // Don't run setup again - just show context
+    return;
+  }
+
+  // =========================================================================
+  // FIRST-TIME SETUP - Project not yet configured
+  // =========================================================================
+
   console.log(chalk.blue(`
   ╔═══════════════════════════════════════════════════════════╗
   ║                                                           ║
@@ -1240,22 +1497,31 @@ async function setupProject(options: GoOptions = {}, auth?: AuthInfo): Promise<v
 async function setupNewProject(cwd: string, options: GoOptions = {}, auth?: AuthInfo): Promise<void> {
   console.log(chalk.cyan('\n  ━━━ New Project Setup ━━━\n'));
 
-  // Get project info
-  console.log(chalk.white('  What kind of project is this?\n'));
-  console.log(chalk.gray('    1. ') + chalk.cyan('PERSONAL') + chalk.gray(' - Just building for myself'));
-  console.log(chalk.gray('    2. ') + chalk.cyan('CLIENT') + chalk.gray('   - Building for someone else'));
-  console.log(chalk.gray('    3. ') + chalk.cyan('BUSINESS') + chalk.gray(' - My own product/startup\n'));
-
-  let typeChoice = '';
-  while (!['1', '2', '3'].includes(typeChoice)) {
-    typeChoice = await prompt('  Enter 1, 2, or 3: ');
-  }
+  let projectType: string;
+  let projectName: string;
+  const defaultName = cwd.split(/[\\/]/).pop() || 'my-project';
 
-  const typeMap: Record<string, string> = { '1': 'personal', '2': 'client', '3': 'business' };
-  const projectType = typeMap[typeChoice];
+  // Use flags if provided (non-interactive mode for AI)
+  if (options.type) {
+    projectType = options.type;
+    projectName = options.name || defaultName;
+    console.log(chalk.green(`  Using: ${projectType.toUpperCase()} project named "${projectName}"\n`));
+  } else {
+    // Interactive mode - ask questions
+    console.log(chalk.white('  What kind of project is this?\n'));
+    console.log(chalk.gray('    1. ') + chalk.cyan('PERSONAL') + chalk.gray(' - Just building for myself'));
+    console.log(chalk.gray('    2. ') + chalk.cyan('CLIENT') + chalk.gray('   - Building for someone else'));
+    console.log(chalk.gray('    3. ') + chalk.cyan('BUSINESS') + chalk.gray(' - My own product/startup\n'));
+
+    let typeChoice = '';
+    while (!['1', '2', '3'].includes(typeChoice)) {
+      typeChoice = await prompt('  Enter 1, 2, or 3: ');
+    }
 
-  const defaultName = cwd.split(/[\\/]/).pop() || 'my-project';
-  const projectName = await prompt(`  Project name (${defaultName}): `) || defaultName;
+    const typeMap: Record<string, string> = { '1': 'personal', '2': 'client', '3': 'business' };
+    projectType = typeMap[typeChoice];
+    projectName = await prompt(`  Project name (${defaultName}): `) || defaultName;
+  }
 
   console.log(chalk.green(`\n  ✓ Setting up "${projectName}" as ${projectType.toUpperCase()} project\n`));
 
@@ -1276,16 +1542,27 @@ async function setupNewProject(cwd: string, options: GoOptions = {}, auth?: Auth
   updateGitignore(cwd);
 
   // How to describe project
-  console.log(chalk.white('\n  📝 How would you like to describe your project?\n'));
-  console.log(chalk.gray('    1. ') + chalk.cyan('GUIDED QUESTIONS') + chalk.gray(' - I\'ll ask you step by step'));
-  console.log(chalk.gray('    2. ') + chalk.cyan('WRITE A PRD') + chalk.gray('      - Create a blank template to fill out'));
-  console.log(chalk.gray('    3. ') + chalk.cyan('PASTE/UPLOAD PRD') + chalk.gray(' - I already have requirements written'));
-  console.log(chalk.gray('    4. ') + chalk.cyan('DESCRIBE IN CHAT') + chalk.gray(' - Just tell the AI what you want'));
-  console.log(chalk.gray('    5. ') + chalk.cyan('SHARE FILES') + chalk.gray('      - I\'ll share docs/mockups/screenshots\n'));
-
   let describeChoice = '';
-  while (!['1', '2', '3', '4', '5'].includes(describeChoice)) {
-    describeChoice = await prompt('  Enter 1-5: ');
+
+  // Use flag if provided (non-interactive mode for AI)
+  if (options.describe) {
+    const describeMap: Record<string, string> = {
+      'guided': '1', 'template': '2', 'paste': '3', 'chat': '4', 'files': '5'
+    };
+    describeChoice = describeMap[options.describe] || '4';
+    console.log(chalk.green(`  Using: ${options.describe} mode for project description\n`));
+  } else {
+    // Interactive mode
+    console.log(chalk.white('\n  📝 How would you like to describe your project?\n'));
+    console.log(chalk.gray('    1. ') + chalk.cyan('GUIDED QUESTIONS') + chalk.gray(' - I\'ll ask you step by step'));
+    console.log(chalk.gray('    2. ') + chalk.cyan('WRITE A PRD') + chalk.gray('      - Create a blank template to fill out'));
+    console.log(chalk.gray('    3. ') + chalk.cyan('PASTE/UPLOAD PRD') + chalk.gray(' - I already have requirements written'));
+    console.log(chalk.gray('    4. ') + chalk.cyan('DESCRIBE IN CHAT') + chalk.gray(' - Just tell the AI what you want'));
+    console.log(chalk.gray('    5. ') + chalk.cyan('SHARE FILES') + chalk.gray('      - I\'ll share docs/mockups/screenshots\n'));
+
+    while (!['1', '2', '3', '4', '5'].includes(describeChoice)) {
+      describeChoice = await prompt('  Enter 1-5: ');
+    }
   }
 
   let prdCreated = false;
@@ -1384,17 +1661,36 @@ async function setupExistingProject(cwd: string, projectInfo: ProjectInfo, optio
 
   // Get project name
   const defaultName = cwd.split(/[\\/]/).pop() || 'my-project';
-  const projectName = await prompt(`\n  Project name (${defaultName}): `) || defaultName;
+  let projectName: string;
+  let reviewChoice: string;
 
-  // Code review offer
-  console.log(chalk.white('\n  Want me to review your code and bring it up to CodeBakers standards?\n'));
-  console.log(chalk.gray('    1. ') + chalk.cyan('YES, REVIEW & FIX') + chalk.gray(' - Run audit, then auto-fix issues'));
-  console.log(chalk.gray('    2. ') + chalk.cyan('REVIEW ONLY') + chalk.gray('      - Just show me the issues'));
-  console.log(chalk.gray('    3. ') + chalk.cyan('SKIP') + chalk.gray('             - Just install CodeBakers\n'));
+  // Use flags if provided (non-interactive mode for AI)
+  if (options.name) {
+    projectName = options.name;
+    console.log(chalk.green(`\n  Using project name: "${projectName}"\n`));
+  } else {
+    projectName = await prompt(`\n  Project name (${defaultName}): `) || defaultName;
+  }
 
-  let reviewChoice = '';
-  while (!['1', '2', '3'].includes(reviewChoice)) {
-    reviewChoice = await prompt('  Enter 1, 2, or 3: ');
+  // Use skipReview flag or ask
+  if (options.skipReview) {
+    reviewChoice = '3';
+    console.log(chalk.gray('  Skipping code review (--skip-review flag)\n'));
+  } else if (options.type) {
+    // If running in non-interactive mode, default to skip review
+    reviewChoice = '3';
+    console.log(chalk.gray('  Skipping code review (non-interactive mode)\n'));
+  } else {
+    // Interactive mode - ask about code review
+    console.log(chalk.white('\n  Want me to review your code and bring it up to CodeBakers standards?\n'));
+    console.log(chalk.gray('    1. ') + chalk.cyan('YES, REVIEW & FIX') + chalk.gray(' - Run audit, then auto-fix issues'));
+    console.log(chalk.gray('    2. ') + chalk.cyan('REVIEW ONLY') + chalk.gray('      - Just show me the issues'));
+    console.log(chalk.gray('    3. ') + chalk.cyan('SKIP') + chalk.gray('             - Just install CodeBakers\n'));
+
+    reviewChoice = '';
+    while (!['1', '2', '3'].includes(reviewChoice)) {
+      reviewChoice = await prompt('  Enter 1, 2, or 3: ');
+    }
   }
 
   let auditScore: number | undefined;

package/src/index.ts

@@ -224,7 +224,18 @@ program
   .alias('start')
   .description('Start using CodeBakers instantly (no signup required)')
   .option('-v, --verbose', 'Show detailed debug output for troubleshooting')
-  .action((options) => go({ verbose: options.verbose }));
+  // Non-interactive flags for programmatic use (e.g., by AI assistants)
+  .option('-t, --type <type>', 'Project type: personal, client, or business')
+  .option('-n, --name <name>', 'Project name')
+  .option('-d, --describe <mode>', 'Description mode: guided, template, paste, chat, or files')
+  .option('--skip-review', 'Skip the review question for existing projects')
+  .action((options) => go({
+    verbose: options.verbose,
+    type: options.type,
+    name: options.name,
+    describe: options.describe,
+    skipReview: options.skipReview,
+  }));
 
 program
   .command('extend')