@nclamvn/vibecode-cli 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nclamvn/vibecode-cli",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Build software with discipline - AI coding with guardrails",
   "main": "src/index.js",
   "type": "module",

package/src/commands/build.js

@@ -487,11 +487,12 @@ Starting build-test-fix loop...`;
   );
   await writeSessionFile('build_report.md', reportContent);
 
-  // Update state
-  stateData.build_completed = endTime;
-  stateData.iterations = iterationState.currentIteration;
-  stateData.iteration_result = loopResult.success ? 'success' : 'failed';
-  await saveState(stateData);
+  // Update state - RELOAD to get current state (after BUILD_IN_PROGRESS transition)
+  const finalStateData = await loadState();
+  finalStateData.build_completed = endTime;
+  finalStateData.iterations = iterationState.currentIteration;
+  finalStateData.iteration_result = loopResult.success ? 'success' : 'failed';
+  await saveState(finalStateData);
 
   console.log();
   console.log(chalk.cyan('─'.repeat(60)));

package/src/commands/plan.js

@@ -45,7 +45,7 @@ export async function planCommand(options = {}) {
     const sessionPath = await getCurrentSessionPath();
     const specHash = await getSpecHash();
 
-    // Read contract and blueprint
+    // Read contract, blueprint, and intake
     spinner.text = 'Reading contract...';
     const contractContent = await readSessionFile('contract.md');
 
@@ -54,6 +54,11 @@ export async function planCommand(options = {}) {
       blueprintContent = await readSessionFile('blueprint.md');
     }
 
+    let intakeContent = '';
+    if (await sessionFileExists('intake.md')) {
+      intakeContent = await readSessionFile('intake.md');
+    }
+
     // Generate plan
     spinner.text = 'Generating plan...';
     const planContent = getPlanTemplate(projectName, sessionId, specHash, contractContent);
@@ -66,7 +71,8 @@ export async function planCommand(options = {}) {
       sessionId,
       specHash,
       contractContent,
-      blueprintContent
+      blueprintContent,
+      intakeContent
     );
     await writeSessionFile('coder_pack.md', coderPackContent);
 

package/src/config/templates.js

@@ -124,11 +124,39 @@ src/
 }
 
 /**
- * Get contract template
+ * Get contract template with content extracted from intake and blueprint
  */
-export function getContractTemplate(projectName, sessionId) {
+export function getContractTemplate(projectName, sessionId, intakeContent = '', blueprintContent = '') {
   const timestamp = new Date().toISOString();
 
+  // Extract goal from intake (look for "Mô tả dự án" section)
+  let goal = extractSection(intakeContent, '## 🎯 Mô tả dự án', '---') ||
+             extractSection(intakeContent, '## Mô tả dự án', '---') ||
+             '[Define your clear, specific goal here]';
+
+  // Extract tech stack from blueprint
+  let techStack = extractSection(blueprintContent, '## 💻 Tech Stack', '---') || '';
+
+  // Extract architecture from blueprint
+  let architecture = extractSection(blueprintContent, '## 📐 Architecture', '---') || '';
+
+  // Extract file structure from blueprint
+  let fileStructure = extractSection(blueprintContent, '## 📁 File Structure', '---') || '';
+
+  // Generate deliverables from goal and architecture
+  const deliverables = generateDeliverablesFromContent(goal, techStack, architecture);
+
+  // Generate acceptance criteria from deliverables
+  const acceptanceCriteria = generateAcceptanceCriteria(deliverables);
+
+  // Generate in-scope items
+  const inScopeItems = deliverables.map(d => `- [ ] ${d.item}`).join('\n');
+
+  // Generate deliverables table
+  const deliverablesTable = deliverables.map((d, i) =>
+    `| ${i + 1} | ${d.item} | ${d.description} | ⬜ |`
+  ).join('\n');
+
   return `# 📜 CONTRACT: ${projectName}
 
 ## Session: ${sessionId}
@@ -140,22 +168,21 @@ export function getContractTemplate(projectName, sessionId) {
 
 ## 🎯 Goal
 
-[Define your clear, specific goal here]
+${goal.trim()}
 
 ---
 
 ## ✅ In-Scope
 
-- [ ] [Deliverable 1]
-- [ ] [Deliverable 2]
-- [ ] [Deliverable 3]
+${inScopeItems || '- [ ] [Deliverable 1]\n- [ ] [Deliverable 2]\n- [ ] [Deliverable 3]'}
 
 ---
 
 ## ❌ Out-of-Scope
 
-- [What is NOT included]
-- [Explicitly excluded items]
+- Features not mentioned in goal
+- Additional integrations not specified
+- Performance optimization beyond MVP
 
 ---
 
@@ -163,14 +190,13 @@ export function getContractTemplate(projectName, sessionId) {
 
 | # | Item | Description | Status |
 |---|------|-------------|--------|
-| 1 | [Item] | [Description] | ⬜ |
+${deliverablesTable || '| 1 | [Item] | [Description] | ⬜ |'}
 
 ---
 
 ## ✔️ Acceptance Criteria
 
-- [ ] [Criterion 1]
-- [ ] [Criterion 2]
+${acceptanceCriteria || '- [ ] [Criterion 1]\n- [ ] [Criterion 2]'}
 
 ---
 
@@ -178,13 +204,17 @@ export function getContractTemplate(projectName, sessionId) {
 
 | Risk | Mitigation |
 |------|------------|
-| [Risk] | [Mitigation] |
+| Dependencies unavailable | Use alternative packages |
+| Scope creep | Strict contract adherence |
 
 ---
 
 ## 🔙 Rollback Plan
 
-[Define rollback strategy]
+If build fails:
+1. Revert to last stable commit
+2. Review contract requirements
+3. Rebuild with corrections
 
 ---
 
@@ -193,6 +223,91 @@ export function getContractTemplate(projectName, sessionId) {
 `;
 }
 
+/**
+ * Extract a section from markdown content
+ */
+function extractSection(content, startMarker, endMarker) {
+  if (!content) return null;
+
+  const startIndex = content.indexOf(startMarker);
+  if (startIndex === -1) return null;
+
+  const contentStart = startIndex + startMarker.length;
+  const endIndex = content.indexOf(endMarker, contentStart);
+
+  if (endIndex === -1) {
+    return content.substring(contentStart).trim();
+  }
+
+  return content.substring(contentStart, endIndex).trim();
+}
+
+/**
+ * Generate deliverables from content analysis
+ */
+function generateDeliverablesFromContent(goal, techStack, architecture) {
+  const deliverables = [];
+
+  // Parse goal for keywords to generate deliverables
+  const goalLower = goal.toLowerCase();
+
+  // Common patterns
+  if (goalLower.includes('landing page') || goalLower.includes('website')) {
+    deliverables.push({ item: 'Landing Page', description: 'Main landing page with hero section' });
+    deliverables.push({ item: 'Responsive Design', description: 'Mobile-friendly layout' });
+  }
+
+  if (goalLower.includes('cli') || goalLower.includes('command')) {
+    deliverables.push({ item: 'CLI Commands', description: 'Core command implementations' });
+    deliverables.push({ item: 'Help System', description: 'Command help and documentation' });
+  }
+
+  if (goalLower.includes('api') || goalLower.includes('backend')) {
+    deliverables.push({ item: 'API Endpoints', description: 'REST/GraphQL endpoints' });
+    deliverables.push({ item: 'Data Models', description: 'Database models and schemas' });
+  }
+
+  if (goalLower.includes('auth') || goalLower.includes('login')) {
+    deliverables.push({ item: 'Authentication', description: 'User login/logout flow' });
+  }
+
+  if (goalLower.includes('dashboard') || goalLower.includes('admin')) {
+    deliverables.push({ item: 'Dashboard UI', description: 'Admin dashboard interface' });
+  }
+
+  // Always include core deliverables if none detected
+  if (deliverables.length === 0) {
+    deliverables.push({ item: 'Core Implementation', description: 'Main functionality as described' });
+    deliverables.push({ item: 'UI/UX', description: 'User interface implementation' });
+    deliverables.push({ item: 'Documentation', description: 'Usage documentation' });
+  }
+
+  // Add testing if not already included
+  if (!deliverables.some(d => d.item.toLowerCase().includes('test'))) {
+    deliverables.push({ item: 'Testing', description: 'Basic functionality tests' });
+  }
+
+  return deliverables;
+}
+
+/**
+ * Generate acceptance criteria from deliverables
+ */
+function generateAcceptanceCriteria(deliverables) {
+  if (!deliverables || deliverables.length === 0) {
+    return '- [ ] All features work as expected\n- [ ] No console errors\n- [ ] Documentation complete';
+  }
+
+  const criteria = deliverables.map(d =>
+    `- [ ] ${d.item} is complete and functional`
+  );
+
+  criteria.push('- [ ] No console errors or warnings');
+  criteria.push('- [ ] Code is clean and documented');
+
+  return criteria.join('\n');
+}
+
 /**
  * Get plan template
  */
@@ -260,9 +375,13 @@ ${deliverables}
 /**
  * Get coder pack template - instructions for AI coder
  */
-export function getCoderPackTemplate(projectName, sessionId, specHash, contractContent, blueprintContent) {
+export function getCoderPackTemplate(projectName, sessionId, specHash, contractContent, blueprintContent, intakeContent = '') {
   const timestamp = new Date().toISOString();
 
+  // Extract the goal from intake for quick reference
+  const goalMatch = intakeContent.match(/## 🎯 Mô tả dự án\s*([\s\S]*?)(?=---|##|$)/);
+  const projectGoal = goalMatch ? goalMatch[1].trim() : 'See contract for details';
+
   return `# 🏗️ CODER PACK: ${projectName}
 
 ## Session: ${sessionId}
@@ -283,6 +402,12 @@ You are the **Thợ (Builder)**. Your job is to execute the locked contract exac
 
 ---
 
+## 🎯 PROJECT GOAL (Quick Reference)
+
+${projectGoal}
+
+---
+
 ## 📜 CONTRACT (LOCKED)
 
 ${contractContent}
@@ -291,7 +416,13 @@ ${contractContent}
 
 ## 📘 BLUEPRINT REFERENCE
 
-${blueprintContent}
+${blueprintContent || '[No blueprint provided - follow contract specifications]'}
+
+---
+
+## 📥 ORIGINAL INTAKE
+
+${intakeContent || '[No intake provided]'}
 
 ---
 

package/src/core/session.js

@@ -114,9 +114,25 @@ export async function createBlueprint(projectName, sessionId) {
 }
 
 /**
- * Create contract file
+ * Create contract file from intake and blueprint
  */
 export async function createContract(projectName, sessionId) {
-  const template = getContractTemplate(projectName, sessionId);
+  // Read intake and blueprint to extract real content
+  let intakeContent = '';
+  let blueprintContent = '';
+
+  try {
+    intakeContent = await readSessionFile('intake.md');
+  } catch (e) {
+    // Intake not found, use empty
+  }
+
+  try {
+    blueprintContent = await readSessionFile('blueprint.md');
+  } catch (e) {
+    // Blueprint not found, use empty
+  }
+
+  const template = getContractTemplate(projectName, sessionId, intakeContent, blueprintContent);
   await writeSessionFile('contract.md', template);
 }

package/src/providers/claude-code.js

@@ -15,6 +15,7 @@ export const CLAUDE_CODE_CONFIG = {
   command: 'claude',
   flags: [
     '--dangerously-skip-permissions',  // Trust the AI - Contract đã locked
+    '--print',                          // Non-interactive mode (no TTY required)
   ],
   timeout: 30 * 60 * 1000, // 30 minutes max
 };
@@ -61,18 +62,22 @@ export async function spawnClaudeCode(prompt, options = {}) {
   await fs.default.writeFile(promptFile, prompt, 'utf-8');
 
   return new Promise((resolve, reject) => {
-    // Use cat to pipe the prompt file content to claude
-    const command = `cat "${promptFile}" | claude ${CLAUDE_CODE_CONFIG.flags.join(' ')}`;
+    // Build command with --print mode and -p for prompt file
+    const args = [
+      ...CLAUDE_CODE_CONFIG.flags,
+      '-p', promptFile
+    ];
+    const command = `claude ${args.map(a => `"${a}"`).join(' ')}`;
 
     // Log the command being run
     if (logPath) {
-      appendToFile(logPath, `\n[${new Date().toISOString()}] Running: claude with prompt from ${promptFile}\n`);
+      appendToFile(logPath, `\n[${new Date().toISOString()}] Running: claude --print -p ${promptFile}\n`);
     }
 
-    const proc = spawn(command, [], {
+    const proc = spawn('claude', args, {
       cwd: cwd || process.cwd(),
       stdio: 'inherit', // Stream directly to terminal
-      shell: true,
+      shell: false,     // No shell needed, safer
     });
 
     let timeoutId = setTimeout(() => {
@@ -153,7 +158,7 @@ export function getProviderInfo() {
   return {
     name: 'Claude Code',
     command: CLAUDE_CODE_CONFIG.command,
-    mode: '--dangerously-skip-permissions',
-    description: 'AI coding with guardrails disabled (contract-approved)'
+    mode: '--dangerously-skip-permissions --print',
+    description: 'AI coding in non-interactive mode (contract-approved)'
   };
 }