vibe-me 1.0.0 → 2.0.0

package/Vibe.bat

@@ -0,0 +1,39 @@
+@echo off
+:: ──────────────────────────────────────────────
+:: Vibe.bat — One-click project setup
+:: Drop this file in any project root and double-click.
+:: Creates .vibe/ semantic layer + docs/ operational docs.
+:: ──────────────────────────────────────────────
+
+echo.
+echo   ⚡ Vibe.bat — Setting up semantic layer + docs
+echo   ─────────────────────────────────────────────────
+echo.
+
+:: Check if Node.js is installed
+where node >nul 2>nul
+if %ERRORLEVEL% neq 0 (
+    echo   ✖ Node.js is not installed.
+    echo     Download it from https://nodejs.org
+    echo.
+    pause
+    exit /b 1
+)
+
+:: Run vibes all (init + docs) in the current directory
+echo   Running: npx vibe-me@latest all
+echo.
+call npx -y vibe-me@latest all
+
+echo.
+echo   ─────────────────────────────────────────────────
+echo   ✔ Done! Now tell your AI agent:
+echo.
+echo     "Read .vibe/VIBE_GUIDE.md, then analyze this
+echo      codebase and fill out all skeleton files in
+echo      .vibe/ and docs/. Ask me any questions you
+echo      can't answer from the code."
+echo.
+echo   ─────────────────────────────────────────────────
+echo.
+pause

package/bin/vibes.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// vibes — Create a .vibe/ semantic layer for any project
+// vibes — Semantic repository layers + standardized docs for humans and AI
 // Zero dependencies. Single file. Works with npx.
 
 const fs = require('fs');
@@ -11,18 +11,23 @@ const path = require('path');
 // ─────────────────────────────────────────────
 
 const VIBE_DIR = '.vibe';
+const DOCS_DIR = 'docs';
 const TEMPLATES_DIR = path.join(__dirname, '..', 'templates');
 const SPEC_DIR = path.join(__dirname, '..', 'spec');
 
-const TEMPLATE_FILES = [
-  'purpose.md',
-  'architecture.md',
-  'flows.md',
-  'entities.md',
-  'decisions.md',
-  'state.json'
+const VIBE_FILES = [
+  'purpose.md', 'architecture.md', 'flows.md',
+  'entities.md', 'decisions.md', 'state.json'
 ];
 
+const DOCS_FILES = [
+  'README.md', 'topology.md', 'architecture.md', 'api.md',
+  'issues.md', 'resolved.md', 'roadmap.md', 'developer_guide.md',
+  'troubleshooting.md', 'glossary.md'
+];
+
+const DOCS_DIRS = ['decisions'];
+const DOCS_EXTRA = ['decisions/0001-template.md'];
 const SPEC_FILE = 'VIBE_GUIDE.md';
 
 // ─────────────────────────────────────────────
@@ -35,68 +40,44 @@ const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
 const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
 const dim = (s) => `\x1b[2m${s}\x1b[0m`;
 const red = (s) => `\x1b[31m${s}\x1b[0m`;
+const magenta = (s) => `\x1b[35m${s}\x1b[0m`;
 
 // ─────────────────────────────────────────────
 // Helpers
 // ─────────────────────────────────────────────
 
-function fileExists(filePath) {
-  try {
-    fs.accessSync(filePath);
-    return true;
-  } catch {
-    return false;
-  }
+function exists(p) {
+  try { fs.accessSync(p); return true; } catch { return false; }
 }
 
-function copyFile(src, dest) {
-  const content = fs.readFileSync(src, 'utf-8');
-  fs.writeFileSync(dest, content, 'utf-8');
+function copy(src, dest) {
+  fs.writeFileSync(dest, fs.readFileSync(src, 'utf-8'), 'utf-8');
 }
 
 function getProjectName(dir) {
-  // Try package.json
-  const pkgPath = path.join(dir, 'package.json');
-  if (fileExists(pkgPath)) {
+  for (const [file, regex] of [
+    ['package.json', null],
+    ['Cargo.toml', /^name\s*=\s*"(.+)"/m],
+    ['go.mod', /^module\s+(.+)/m],
+    ['pyproject.toml', /^name\s*=\s*"(.+)"/m],
+  ]) {
+    const p = path.join(dir, file);
+    if (!exists(p)) continue;
     try {
-      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-      if (pkg.name) return pkg.name;
-    } catch {}
-  }
-  // Try Cargo.toml
-  const cargoPath = path.join(dir, 'Cargo.toml');
-  if (fileExists(cargoPath)) {
-    try {
-      const cargo = fs.readFileSync(cargoPath, 'utf-8');
-      const match = cargo.match(/^name\s*=\s*"(.+)"/m);
-      if (match) return match[1];
-    } catch {}
-  }
-  // Try go.mod
-  const goModPath = path.join(dir, 'go.mod');
-  if (fileExists(goModPath)) {
-    try {
-      const goMod = fs.readFileSync(goModPath, 'utf-8');
-      const match = goMod.match(/^module\s+(.+)/m);
-      if (match) return match[1].split('/').pop();
-    } catch {}
-  }
-  // Try pyproject.toml
-  const pyPath = path.join(dir, 'pyproject.toml');
-  if (fileExists(pyPath)) {
-    try {
-      const py = fs.readFileSync(pyPath, 'utf-8');
-      const match = py.match(/^name\s*=\s*"(.+)"/m);
-      if (match) return match[1];
+      const content = fs.readFileSync(p, 'utf-8');
+      if (file === 'package.json') {
+        const pkg = JSON.parse(content);
+        if (pkg.name) return pkg.name;
+      } else {
+        const m = content.match(regex);
+        if (m) return file === 'go.mod' ? m[1].split('/').pop() : m[1];
+      }
     } catch {}
   }
-  // Fallback to directory name
   return path.basename(dir);
 }
 
-function getNow() {
-  return new Date().toISOString();
-}
+function now() { return new Date().toISOString(); }
 
 // ─────────────────────────────────────────────
 // Commands
@@ -104,207 +85,297 @@ function getNow() {
 
 function cmdInit(targetDir) {
   const vibeDir = path.join(targetDir, VIBE_DIR);
-  const projectName = getProjectName(targetDir);
+  const name = getProjectName(targetDir);
 
-  // Check if .vibe already exists
-  if (fileExists(vibeDir)) {
-    console.log(red('\n  ✖ .vibe/ already exists in this directory.'));
-    console.log(dim('    Use "vibes reset" to overwrite, or edit files directly.\n'));
+  if (exists(vibeDir)) {
+    console.log(red('\n  ✖ .vibe/ already exists.'));
+    console.log(dim('    Use "vibes reset" to overwrite.\n'));
     process.exit(1);
   }
 
   console.log('');
   console.log(bold('  ⚡ vibes init'));
-  console.log(dim(`  Creating .vibe/ semantic layer for ${cyan(projectName)}`));
+  console.log(dim(`  Creating .vibe/ semantic layer for ${cyan(name)}`));
   console.log('');
 
-  // Create .vibe directory
   fs.mkdirSync(vibeDir, { recursive: true });
 
-  // Copy template files
-  let created = 0;
-  for (const file of TEMPLATE_FILES) {
+  let count = 0;
+  for (const file of VIBE_FILES) {
     const src = path.join(TEMPLATES_DIR, file);
     const dest = path.join(vibeDir, file);
-
     if (file === 'state.json') {
-      // Inject project name and timestamp into state.json
-      let content = fs.readFileSync(src, 'utf-8');
-      content = content.replace('PROJECT_NAME', projectName);
-      content = content.replace('TIMESTAMP', getNow());
-      fs.writeFileSync(dest, content, 'utf-8');
+      let c = fs.readFileSync(src, 'utf-8');
+      c = c.replace('PROJECT_NAME', name).replace(/TIMESTAMP/g, now());
+      fs.writeFileSync(dest, c, 'utf-8');
     } else {
-      // Copy markdown templates as-is
-      copyFile(src, dest);
+      copy(src, dest);
     }
-
     console.log(green('  ✔ ') + dim('.vibe/') + file);
-    created++;
+    count++;
   }
 
-  // Copy the guide as a hidden instruction file inside .vibe
-  const guideSrc = path.join(SPEC_DIR, SPEC_FILE);
-  const guideDest = path.join(vibeDir, SPEC_FILE);
-  copyFile(guideSrc, guideDest);
+  // Copy guide
+  copy(path.join(SPEC_DIR, SPEC_FILE), path.join(vibeDir, SPEC_FILE));
   console.log(green('  ✔ ') + dim('.vibe/') + SPEC_FILE + dim(' (agent instructions)'));
-  created++;
+  count++;
 
   console.log('');
-  console.log(green(`  ✔ Created ${created} files in .vibe/`));
+  console.log(green(`  ✔ Created ${count} files in .vibe/`));
+  printNextSteps();
+}
+
+function cmdDocs(targetDir) {
+  const docsDir = path.join(targetDir, DOCS_DIR);
+  const name = getProjectName(targetDir);
+
+  if (exists(docsDir)) {
+    // Check if it has content already
+    const contents = fs.readdirSync(docsDir);
+    if (contents.length > 0) {
+      console.log(yellow('\n  ⚠ docs/ already exists with ' + contents.length + ' items.'));
+      console.log(dim('    Skipping files that already exist. Adding missing ones only.\n'));
+    }
+  }
+
   console.log('');
-  console.log(bold('  Next steps:'));
+  console.log(bold('  📄 vibes docs'));
+  console.log(dim(`  Creating docs/ structure for ${cyan(name)}`));
   console.log('');
-  console.log('  1. Point your AI coding agent at this project');
-  console.log('  2. Tell it:');
+
+  // Create docs dir and subdirs
+  fs.mkdirSync(docsDir, { recursive: true });
+  for (const sub of DOCS_DIRS) {
+    fs.mkdirSync(path.join(docsDir, sub), { recursive: true });
+  }
+
+  let created = 0;
+  let skipped = 0;
+
+  // Copy doc files (skip if they already exist)
+  for (const file of [...DOCS_FILES, ...DOCS_EXTRA]) {
+    const src = path.join(TEMPLATES_DIR, 'docs', file);
+    const dest = path.join(docsDir, file);
+    if (exists(dest)) {
+      console.log(yellow('  ⊘ ') + dim('docs/') + file + dim(' (exists, skipped)'));
+      skipped++;
+    } else {
+      copy(src, dest);
+      console.log(green('  ✔ ') + dim('docs/') + file);
+      created++;
+    }
+  }
+
   console.log('');
-  console.log(cyan('     "Read .vibe/VIBE_GUIDE.md, then analyze this codebase'));
-  console.log(cyan('      and fill out all the skeleton files in .vibe/'));
-  console.log(cyan('      Ask me any questions you can\'t answer from the code."'));
+  if (skipped > 0) {
+    console.log(green(`  ✔ Created ${created} files`) + dim(`, skipped ${skipped} existing`));
+  } else {
+    console.log(green(`  ✔ Created ${created} files in docs/`));
+  }
+  console.log('');
+  console.log(bold('  Next steps:'));
   console.log('');
-  console.log('  3. Review the output, commit to version control');
+  console.log('  Tell your AI agent:');
   console.log('');
-  console.log(dim('  The guide contains full instructions, examples, and'));
-  console.log(dim('  quality checklists for the AI to follow.'));
+  console.log(cyan('     "Read .vibe/VIBE_GUIDE.md for context, then analyze'));
+  console.log(cyan('      the codebase and fill out all skeleton files in docs/.'));
+  console.log(cyan('      Ask me any questions you can\'t answer from the code."'));
   console.log('');
 }
 
 function cmdCheck(targetDir) {
   const vibeDir = path.join(targetDir, VIBE_DIR);
+  const docsDir = path.join(targetDir, DOCS_DIR);
+  const hasVibe = exists(vibeDir);
+  const hasDocs = exists(docsDir);
 
-  if (!fileExists(vibeDir)) {
-    console.log(red('\n  ✖ No .vibe/ folder found. Run "vibes init" first.\n'));
+  if (!hasVibe && !hasDocs) {
+    console.log(red('\n  ✖ No .vibe/ or docs/ found. Run "vibes init" first.\n'));
     process.exit(1);
   }
 
   console.log('');
   console.log(bold('  🔍 vibes check'));
-  console.log('');
 
-  let passed = 0;
-  let failed = 0;
-  let warnings = 0;
-
-  // Check each file exists and is non-empty
-  for (const file of TEMPLATE_FILES) {
-    const filePath = path.join(vibeDir, file);
-    if (!fileExists(filePath)) {
-      console.log(red('  ✖ ') + `${file} — missing`);
-      failed++;
-      continue;
+  let passed = 0, failed = 0, warnings = 0;
+
+  // Check .vibe/
+  if (hasVibe) {
+    console.log('');
+    console.log(dim('  ── .vibe/ (semantic layer) ──'));
+    console.log('');
+
+    for (const file of VIBE_FILES) {
+      const fp = path.join(vibeDir, file);
+      if (!exists(fp)) { console.log(red('  ✖ ') + file + ' — missing'); failed++; continue; }
+
+      const content = fs.readFileSync(fp, 'utf-8').trim();
+      const lines = content.split('\n').length;
+
+      if (lines < 5) { console.log(yellow('  ⚠ ') + file + ` — looks empty (${lines} lines)`); warnings++; continue; }
+
+      // File-specific quality checks
+      let warn = null;
+      if (file === 'purpose.md' && !content.toLowerCase().includes('not do')) warn = 'missing "NOT do" section';
+      if (file === 'decisions.md' && (content.match(/^## Why /gm) || []).length < 2) warn = 'fewer than 2 decisions';
+      if (file === 'entities.md' && !content.includes('What depends on it')) warn = 'missing "What depends on it?" fields';
+      if (file === 'flows.md' && (content.match(/^## \d+\./gm) || []).length < 2) warn = 'fewer than 2 flows';
+      if (file === 'state.json') {
+        try {
+          const s = JSON.parse(content);
+          if (!s.vibe_updated) warn = 'missing vibe_updated timestamp';
+          else {
+            const days = (Date.now() - new Date(s.vibe_updated).getTime()) / 86400000;
+            if (days > 30) warn = `last updated ${Math.floor(days)} days ago`;
+          }
+        } catch { console.log(red('  ✖ ') + file + ' — invalid JSON'); failed++; continue; }
+      }
+
+      if (warn) { console.log(yellow('  ⚠ ') + file + ` — ${warn}`); warnings++; }
+      else { console.log(green('  ✔ ') + file + ` — ${lines} lines`); passed++; }
     }
+  }
 
-    const content = fs.readFileSync(filePath, 'utf-8').trim();
-    const lines = content.split('\n').length;
+  // Check docs/
+  if (hasDocs) {
+    console.log('');
+    console.log(dim('  ── docs/ (operational docs) ──'));
+    console.log('');
 
-    if (lines < 5) {
-      console.log(yellow('  ⚠ ') + `${file} — exists but looks empty (${lines} lines)`);
-      warnings++;
-      continue;
-    }
+    for (const file of DOCS_FILES) {
+      const fp = path.join(docsDir, file);
+      if (!exists(fp)) { console.log(yellow('  ⚠ ') + file + ' — missing'); warnings++; continue; }
 
-    // File-specific checks
-    if (file === 'purpose.md') {
-      if (!content.includes('NOT do') && !content.includes('not do') && !content.includes('NOT Do')) {
-        console.log(yellow('  ⚠ ') + `${file} — missing "What does it explicitly NOT do?" section`);
-        warnings++;
-        continue;
-      }
-    }
+      const content = fs.readFileSync(fp, 'utf-8').trim();
+      const lines = content.split('\n').length;
 
-    if (file === 'decisions.md') {
-      // Check for at least 2 "## Why" headings
-      const decisionCount = (content.match(/^## Why /gm) || []).length;
-      if (decisionCount < 2) {
-        console.log(yellow('  ⚠ ') + `${file} — only ${decisionCount} decision(s). Most projects have 3+.`);
-        warnings++;
-        continue;
-      }
+      if (lines < 5) { console.log(yellow('  ⚠ ') + file + ` — looks empty (${lines} lines)`); warnings++; }
+      else { console.log(green('  ✔ ') + file + ` — ${lines} lines`); passed++; }
     }
+  }
 
-    if (file === 'entities.md') {
-      if (!content.includes('What depends on it')) {
-        console.log(yellow('  ⚠ ') + `${file} — entities missing "What depends on it?" field`);
-        warnings++;
-        continue;
-      }
-    }
+  console.log('');
+  if (failed > 0) console.log(red(`  Result: ${failed} failed, ${warnings} warnings, ${passed} passed`));
+  else if (warnings > 0) console.log(yellow(`  Result: ${warnings} warnings, ${passed} passed`));
+  else console.log(green(`  Result: All ${passed} files pass ✔`));
+  console.log('');
+}
 
-    if (file === 'state.json') {
+function cmdStatus(targetDir) {
+  const vibeDir = path.join(targetDir, VIBE_DIR);
+  const docsDir = path.join(targetDir, DOCS_DIR);
+  const name = getProjectName(targetDir);
+
+  console.log('');
+  console.log(bold(`  📊 ${name}`));
+  console.log('');
+
+  // .vibe status
+  if (exists(vibeDir)) {
+    const filled = VIBE_FILES.filter(f => {
+      const fp = path.join(vibeDir, f);
+      if (!exists(fp)) return false;
+      return fs.readFileSync(fp, 'utf-8').trim().split('\n').length >= 10;
+    }).length;
+    const icon = filled === VIBE_FILES.length ? green('✔') : filled > 0 ? yellow('◐') : red('✖');
+    console.log(`  ${icon} .vibe/   ${filled}/${VIBE_FILES.length} files filled`);
+
+    // Show state.json health if available
+    const statePath = path.join(vibeDir, 'state.json');
+    if (exists(statePath)) {
       try {
-        const state = JSON.parse(content);
-        if (!state.vibe_updated) {
-          console.log(yellow('  ⚠ ') + `${file} — missing vibe_updated timestamp`);
-          warnings++;
-          continue;
-        }
-        // Check staleness
-        const updated = new Date(state.vibe_updated);
-        const daysOld = (Date.now() - updated.getTime()) / (1000 * 60 * 60 * 24);
-        if (daysOld > 30) {
-          console.log(yellow('  ⚠ ') + `${file} — last updated ${Math.floor(daysOld)} days ago. Consider refreshing.`);
-          warnings++;
-          continue;
+        const s = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+        if (s.health) console.log(dim(`             health: ${s.health}`));
+        if (s.version) console.log(dim(`             version: ${s.version}`));
+        if (s.vibe_updated) {
+          const days = Math.floor((Date.now() - new Date(s.vibe_updated).getTime()) / 86400000);
+          console.log(dim(`             updated: ${days === 0 ? 'today' : days + ' days ago'}`));
         }
-      } catch {
-        console.log(red('  ✖ ') + `${file} — invalid JSON`);
-        failed++;
-        continue;
-      }
-    }
-
-    if (file === 'flows.md') {
-      const flowCount = (content.match(/^## \d+\./gm) || []).length;
-      if (flowCount < 2) {
-        console.log(yellow('  ⚠ ') + `${file} — only ${flowCount} flow(s). Most projects have 2+.`);
-        warnings++;
-        continue;
-      }
+      } catch {}
     }
-
-    console.log(green('  ✔ ') + `${file} — ${lines} lines`);
-    passed++;
+  } else {
+    console.log(red('  ✖') + ' .vibe/   not initialized');
   }
 
-  console.log('');
-  if (failed > 0) {
-    console.log(red(`  Result: ${failed} failed, ${warnings} warnings, ${passed} passed`));
-  } else if (warnings > 0) {
-    console.log(yellow(`  Result: ${warnings} warnings, ${passed} passed`));
+  // docs status
+  if (exists(docsDir)) {
+    const filled = DOCS_FILES.filter(f => {
+      const fp = path.join(docsDir, f);
+      if (!exists(fp)) return false;
+      return fs.readFileSync(fp, 'utf-8').trim().split('\n').length >= 10;
+    }).length;
+    const icon = filled === DOCS_FILES.length ? green('✔') : filled > 0 ? yellow('◐') : red('✖');
+    console.log(`  ${icon} docs/    ${filled}/${DOCS_FILES.length} files filled`);
   } else {
-    console.log(green(`  Result: All ${passed} files pass ✔`));
+    console.log(red('  ✖') + ' docs/    not initialized');
   }
+
   console.log('');
 }
 
-function cmdReset(targetDir) {
+function cmdAll(targetDir) {
+  console.log('');
+  console.log(bold('  🚀 vibes all'));
+  console.log(dim('  Full setup — semantic layer + operational docs'));
+
   const vibeDir = path.join(targetDir, VIBE_DIR);
+  const docsDir = path.join(targetDir, DOCS_DIR);
+
+  if (!exists(vibeDir)) {
+    cmdInit(targetDir);
+  } else {
+    console.log(yellow('\n  ⊘ .vibe/ already exists, skipping init'));
+  }
 
-  if (fileExists(vibeDir)) {
-    // Remove existing .vibe
-    fs.rmSync(vibeDir, { recursive: true, force: true });
-    console.log(yellow('\n  ⚠ Removed existing .vibe/ folder'));
+  if (!exists(docsDir) || fs.readdirSync(docsDir).length === 0) {
+    cmdDocs(targetDir);
+  } else {
+    cmdDocs(targetDir); // docs command already handles existing files gracefully
   }
+}
 
-  cmdInit(targetDir);
+function cmdReset(targetDir) {
+  for (const dir of [VIBE_DIR, DOCS_DIR]) {
+    const p = path.join(targetDir, dir);
+    if (exists(p)) {
+      fs.rmSync(p, { recursive: true, force: true });
+      console.log(yellow(`\n  ⚠ Removed ${dir}/`));
+    }
+  }
+  cmdAll(targetDir);
+}
+
+function printNextSteps() {
+  console.log('');
+  console.log(bold('  Next steps:'));
+  console.log('');
+  console.log('  1. Point your AI coding agent at this project');
+  console.log('  2. Tell it:');
+  console.log('');
+  console.log(cyan('     "Read .vibe/VIBE_GUIDE.md, then analyze this codebase'));
+  console.log(cyan('      and fill out all the skeleton files in .vibe/'));
+  console.log(cyan('      Ask me any questions you can\'t answer from the code."'));
+  console.log('');
+  console.log('  3. Run ' + cyan('vibes docs') + ' to scaffold operational docs too');
+  console.log('  4. Review the output, commit to version control');
+  console.log('');
 }
 
 function printHelp() {
   console.log('');
-  console.log(bold('  vibes') + ' — Semantic repository layers for humans and AI');
+  console.log(bold('  vibes') + ' — Semantic layers + standardized docs for humans and AI');
   console.log('');
   console.log('  ' + bold('Usage:'));
   console.log('');
-  console.log('    vibes init      Create .vibe/ skeleton in the current directory');
-  console.log('    vibes check     Validate .vibe/ files for completeness');
-  console.log('    vibes reset     Delete and recreate .vibe/ skeleton');
+  console.log('    vibes init      Create .vibe/ semantic layer (6 files)');
+  console.log('    vibes docs      Create docs/ operational documentation (11 files)');
+  console.log('    vibes all       Create both .vibe/ and docs/ at once');
+  console.log('    vibes check     Validate all files for completeness');
+  console.log('    vibes status    Quick health overview');
+  console.log('    vibes reset     Delete and recreate everything');
   console.log('    vibes help      Show this help message');
   console.log('');
-  console.log('  ' + bold('What is .vibe?'));
-  console.log('');
-  console.log('  A small set of 6 files that lets any human or AI understand');
-  console.log('  a project without reading the source code.');
-  console.log('');
-  console.log('  ' + dim('.vibe/'));
+  console.log('  ' + bold('.vibe/') + dim(' — Semantic layer (intent, decisions, flows)'));
   console.log('  ' + dim('├── purpose.md       — What is this? Who is it for?'));
   console.log('  ' + dim('├── architecture.md  — Systems and how they connect'));
   console.log('  ' + dim('├── flows.md         — User journeys, step by step'));
@@ -312,10 +383,18 @@ function printHelp() {
   console.log('  ' + dim('├── decisions.md     — Why things exist the way they do'));
   console.log('  ' + dim('└── state.json       — Machine-readable project health'));
   console.log('');
-  console.log('  After running ' + cyan('vibes init') + ', point your AI coding agent');
-  console.log('  at the project and tell it to read ' + cyan('.vibe/VIBE_GUIDE.md') + '.');
-  console.log('  The guide contains everything the agent needs to analyze');
-  console.log('  your codebase and fill out the semantic layer.');
+  console.log('  ' + bold('docs/') + dim(' — Operational docs (topology, API, issues, guides)'));
+  console.log('  ' + dim('├── README.md          — Executive summary'));
+  console.log('  ' + dim('├── topology.md        — File/folder map'));
+  console.log('  ' + dim('├── architecture.md    — Component-level details'));
+  console.log('  ' + dim('├── api.md             — API endpoints'));
+  console.log('  ' + dim('├── issues.md          — Open bugs and blockers'));
+  console.log('  ' + dim('├── resolved.md        — Closed issues archive'));
+  console.log('  ' + dim('├── roadmap.md         — Milestones and priorities'));
+  console.log('  ' + dim('├── developer_guide.md — Setup, build, test, deploy'));
+  console.log('  ' + dim('├── troubleshooting.md — Common errors and fixes'));
+  console.log('  ' + dim('├── glossary.md        — Project-specific terms'));
+  console.log('  ' + dim('└── decisions/         — Architecture decision records'));
   console.log('');
 }
 
@@ -328,20 +407,13 @@ const command = args[0] || 'help';
 const targetDir = path.resolve(args[1] || '.');
 
 switch (command) {
-  case 'init':
-    cmdInit(targetDir);
-    break;
-  case 'check':
-    cmdCheck(targetDir);
-    break;
-  case 'reset':
-    cmdReset(targetDir);
-    break;
-  case 'help':
-  case '--help':
-  case '-h':
-    printHelp();
-    break;
+  case 'init':    cmdInit(targetDir); break;
+  case 'docs':    cmdDocs(targetDir); break;
+  case 'all':     cmdAll(targetDir); break;
+  case 'check':   cmdCheck(targetDir); break;
+  case 'status':  cmdStatus(targetDir); break;
+  case 'reset':   cmdReset(targetDir); break;
+  case 'help': case '--help': case '-h': printHelp(); break;
   default:
     console.log(red(`\n  Unknown command: ${command}`));
     printHelp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-me",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Create a .vibe/ semantic repository layer for any project. Helps humans and AI agents understand your codebase without reading the source.",
   "keywords": [
     "vibes",
@@ -22,7 +22,8 @@
   "files": [
     "bin/",
     "templates/",
-    "spec/"
+    "spec/",
+    "Vibe.bat"
   ],
   "repository": {
     "type": "git",

package/templates/docs/README.md

@@ -0,0 +1,34 @@
+# Executive Summary
+
+<!-- 
+  INSTRUCTIONS FOR AI AGENT:
+  This is the landing page for the project's operational documentation.
+  Write a 1-2 paragraph executive summary, then auto-link to every doc below.
+  Keep this under 100 lines. It's a table of contents, not a novel.
+  Delete these instruction comments when done.
+-->
+
+## Overview
+
+[1-2 paragraphs: what this project is, its current status, and what's active right now]
+
+## Documentation Map
+
+| Document | Description |
+|---|---|
+| [topology.md](topology.md) | File and folder structure with descriptions |
+| [architecture.md](architecture.md) | Systems, components, and data flow |
+| [api.md](api.md) | API endpoints, request/response formats |
+| [issues.md](issues.md) | Open bugs, blockers, known problems |
+| [resolved.md](resolved.md) | Closed issues and their resolutions |
+| [roadmap.md](roadmap.md) | Milestones, priorities, what's next |
+| [developer_guide.md](developer_guide.md) | Setup, build, test, deploy instructions |
+| [troubleshooting.md](troubleshooting.md) | Common errors and how to fix them |
+| [glossary.md](glossary.md) | Project-specific terms defined |
+| [decisions/](decisions/) | Architecture decision records |
+
+## Quick Links
+
+- **Current Milestone:** [see roadmap](roadmap.md)
+- **Active Blockers:** [see issues](issues.md)
+- **Semantic Layer:** [.vibe/](../.vibe/) — purpose, architecture intent, decisions rationale

package/templates/docs/api.md

@@ -0,0 +1,36 @@
+# API Reference
+
+<!-- 
+  INSTRUCTIONS FOR AI AGENT:
+  Document every API endpoint, WebSocket event, IPC command, or CLI interface.
+  If this is a library, document the public API surface.
+  If there's no API, write "N/A — this project has no API surface" and describe
+  how it's invoked instead (CLI args, config files, etc.)
+  Delete these instruction comments when done.
+-->
+
+## Base URL / Connection
+
+- **Base URL:** `http://localhost:PORT`
+- **Auth:** [none / Bearer token / API key / etc.]
+
+## Endpoints
+
+### `METHOD /path`
+
+**Description:** 
+
+**Request:**
+```json
+{}
+```
+
+**Response:**
+```json
+{}
+```
+
+**Errors:**
+| Code | Meaning |
+|---|---|
+| | |

package/templates/docs/architecture.md

@@ -0,0 +1,28 @@
+# Architecture
+
+<!-- 
+  INSTRUCTIONS FOR AI AGENT:
+  This is the IMPLEMENTATION-LEVEL architecture — specific components, 
+  data flow, and technical details. Different from .vibe/architecture.md 
+  which describes intent-level systems.
+  Include diagrams, component breakdowns, and data flow.
+  Delete these instruction comments when done.
+-->
+
+## Components
+
+<!-- List each major component/module with its responsibility -->
+
+### [Component Name]
+- **Responsibility:** 
+- **Key Files:** 
+- **Depends On:** 
+- **Depended On By:** 
+
+## Data Flow
+
+<!-- How does data move through the system? Request lifecycle, event flow, etc. -->
+
+## Infrastructure
+
+<!-- Hosting, CI/CD, databases, external services, environment config -->

package/templates/docs/decisions/0001-template.md

@@ -0,0 +1,21 @@
+# ADR-0001: [Decision Title]
+
+## Status
+
+[Proposed / Accepted / Deprecated / Superseded]
+
+## Context
+
+[What is the issue or question that prompted this decision?]
+
+## Decision
+
+[What was decided?]
+
+## Alternatives Considered
+
+[What other options were evaluated and why were they rejected?]
+
+## Consequences
+
+[What are the positive and negative outcomes of this decision?]

package/templates/docs/developer_guide.md

@@ -0,0 +1,46 @@
+# Developer Guide
+
+<!-- 
+  INSTRUCTIONS FOR AI AGENT:
+  Write this for a developer who just cloned the repo and needs to:
+  1. Set up their environment
+  2. Build the project
+  3. Run tests
+  4. Make changes safely
+  Be specific — exact commands, exact versions, exact paths.
+  Delete these instruction comments when done.
+-->
+
+## Prerequisites
+
+<!-- What must be installed before anything else? Include version numbers. -->
+
+| Tool | Version | Install |
+|---|---|---|
+| | | |
+
+## Setup
+
+```bash
+# Step-by-step commands to get from fresh clone to running
+```
+
+## Build
+
+```bash
+# How to build the project
+```
+
+## Test
+
+```bash
+# How to run the test suite
+```
+
+## Project Rules
+
+<!-- Coding conventions, file size limits, naming conventions, banned patterns -->
+
+## Deployment
+
+<!-- How to ship to production. If not applicable, say so. -->

package/templates/docs/glossary.md

@@ -0,0 +1,13 @@
+# Glossary
+
+<!-- 
+  INSTRUCTIONS FOR AI AGENT:
+  Define every project-specific term, acronym, or concept that a new 
+  contributor wouldn't immediately understand.
+  Sort alphabetically. Keep definitions to 1-2 sentences.
+  Delete these instruction comments when done.
+-->
+
+| Term | Definition |
+|---|---|
+| | |

package/templates/docs/issues.md

@@ -0,0 +1,25 @@
+# Open Issues
+
+<!-- 
+  INSTRUCTIONS FOR AI AGENT:
+  Track all known bugs, blockers, incomplete features, and tech debt.
+  Use priority tags: 🔴 Critical, 🟡 Medium, 🟢 Low
+  When an issue is resolved, move it to resolved.md with the date and fix description.
+  Delete these instruction comments when done.
+-->
+
+## 🔴 Critical
+
+<!-- Issues that block core functionality or cause data loss -->
+
+## 🟡 Medium
+
+<!-- Issues that affect user experience but have workarounds -->
+
+## 🟢 Low / Tech Debt
+
+<!-- Nice-to-haves, cleanup tasks, future improvements -->
+
+## Backlog
+
+<!-- Ideas and enhancements not yet prioritized -->

package/templates/docs/resolved.md

@@ -0,0 +1,20 @@
+# Resolved Issues
+
+<!-- 
+  INSTRUCTIONS FOR AI AGENT:
+  When closing an issue from issues.md, move it here with:
+  - The date it was resolved
+  - How it was fixed (1-2 sentences)
+  - Link to the relevant commit/PR if available
+  This file is append-only. Never delete entries.
+  Delete these instruction comments when done.
+-->
+
+## Resolved
+
+<!-- 
+  Format:
+  ### [Issue Title]
+  - **Resolved:** YYYY-MM-DD
+  - **Fix:** [Brief description of what was done]
+-->

package/templates/docs/roadmap.md

@@ -0,0 +1,27 @@
+# Roadmap
+
+<!-- 
+  INSTRUCTIONS FOR AI AGENT:
+  Organize by milestones. Each milestone has a goal and a list of deliverables.
+  Use checkboxes to track progress.
+  Delete these instruction comments when done.
+-->
+
+## Current Milestone: [Name]
+
+**Goal:** [What does completing this milestone achieve?]
+
+- [ ] [Deliverable 1]
+- [ ] [Deliverable 2]
+- [ ] [Deliverable 3]
+
+## Next Milestone: [Name]
+
+**Goal:** 
+
+- [ ] [Deliverable 1]
+- [ ] [Deliverable 2]
+
+## Completed Milestones
+
+<!-- Move milestones here when done, with completion date -->

package/templates/docs/topology.md

@@ -0,0 +1,30 @@
+# Codebase Topology
+
+<!-- 
+  INSTRUCTIONS FOR AI AGENT:
+  Map every top-level directory and key file. For each, include:
+  - Path, description, language, and approximate line count
+  Group by component or feature area.
+  Update this whenever files are added, removed, or significantly restructured.
+  Delete these instruction comments when done.
+-->
+
+## Directory Structure
+
+```
+project-root/
+├── [folder]/        — [description]
+│   ├── [file]       — [description]
+│   └── ...
+└── ...
+```
+
+## File Inventory
+
+| File | Lines | Language | Description |
+|---|---|---|---|
+| | | | |
+
+## Dependency Map
+
+<!-- Which modules depend on which? Show the import/call graph at a high level. -->

package/templates/docs/troubleshooting.md

@@ -0,0 +1,32 @@
+# Troubleshooting
+
+<!-- 
+  INSTRUCTIONS FOR AI AGENT:
+  Document every error a developer or user might encounter.
+  Format: Symptom → Cause → Fix.
+  Add to this file every time you debug something non-obvious.
+  Delete these instruction comments when done.
+-->
+
+## Common Issues
+
+### [Error message or symptom]
+
+**Cause:** [Why this happens]
+
+**Fix:**
+```bash
+# Exact commands or steps to resolve
+```
+
+---
+
+<!-- Copy the template above for each issue. Aim for 5+ entries. -->
+
+## Diagnostic Commands
+
+<!-- Quick commands to check system health, versions, connectivity, etc. -->
+
+```bash
+# Example: check versions
+```