brainforge-ai 1.0.1 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 # ⚡ BrainForge
 
-> Transform any idea into a structured, AI-assisted project — with agents, slash commands, a phase roadmap, persistent memory, and a live HTML dashboard.
+> Transform any idea into a structured, AI-assisted project — with agents, slash commands, a phase roadmap, persistent memory, and a live dashboard.
 
 [![npm version](https://img.shields.io/npm/v/brainforge-ai.svg)](https://www.npmjs.com/package/brainforge-ai)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
@@ -19,7 +19,7 @@ BrainForge is a CLI that installs a **structured AI development system** into an
 Instead of vibing and hoping the AI does the right thing, BrainForge forces a clean workflow:
 
 ```
-Idea → Plan → Research → Execute → Review → Commit → Repeat
+Idea → Plan → Research → Execute → Test → Review → Commit → Repeat
 ```
 
 It works with any AI tool: **Claude Code**, **GitHub Copilot**, **Gemini CLI**, **Codex**, **Cursor**, **OpenCode**.
@@ -34,8 +34,9 @@ It works with any AI tool: **Claude Code**, **GitHub Copilot**, **Gemini CLI**,
 | No memory between sessions | Persistent project memory |
 | Hard to explain your code | `/explain-my-code` generates your defense speech |
 | Code looks too AI-perfect | Code Level Engine adapts to your real level |
+| No tests | `/write-tests` generates the right tests for your level |
 | No version history | Automatic git checkpoints |
-| Lost in files | Live HTML dashboard |
+| Lost in files | Live dashboard with auto-reload |
 
 ---
 
@@ -74,7 +75,7 @@ Answer the questions:
 - Target code level
 - Whether it's a school project
 
-BrainForge will generate the full structure and make the first git commit.
+BrainForge generates the full structure and makes the first git commit automatically.
 
 ---
 
@@ -82,7 +83,7 @@ BrainForge will generate the full structure and make the first git commit.
 
 Open **Claude Code**, **Cursor**, or any AI tool in the project folder.
 
-The AI will automatically read `AGENTS.md` and know the rules.
+The AI reads `AGENTS.md` automatically and knows the rules.
 
 ---
 
@@ -92,7 +93,7 @@ The AI will automatically read `AGENTS.md` and know the rules.
 ```
 /start-project
 ```
-Describe your idea. The AI asks questions, fills in `.brainforge/project.md`.
+Describe your idea. The AI asks questions and fills in `.brainforge/project.md`.
 
 #### Step 2 — Create the roadmap
 ```
@@ -112,25 +113,31 @@ Research + planning. The AI proposes an approach and waits for your confirmation
 ```
 The AI codes **only what was planned**. Nothing more.
 
-#### Step 5 — Review the phase
+#### Step 5 — Write tests
+```
+/write-tests
+```
+Generates tests adapted to your stack and code level.
+
+#### Step 6 — Review the phase
 ```
 /review-phase 1
 ```
 Checks for bugs, dead code, complexity, and level-appropriateness.
 
-#### Step 6 — Save your progress
+#### Step 7 — Save your progress
 ```
 /checkpoint
 ```
-Creates a local git commit. Never pushes.
+Creates a local git commit. Never pushes automatically.
 
-#### Step 7 — Update the dashboard
-```
-brainforge update-dashboard
-brainforge dashboard
+#### Step 8 — Watch the dashboard update live
+```bash
+brainforge serve
 ```
+Opens `localhost:3000` — reloads automatically as you work.
 
-Repeat steps 3–7 for each phase.
+Repeat steps 3–8 for each phase.
 
 ---
 
@@ -139,9 +146,11 @@ Repeat steps 3–7 for each phase.
 | Command | Description |
 |---------|-------------|
 | `brainforge init` | Initialize BrainForge in the current directory |
-| `brainforge doctor` | Health check — verify all files and setup |
-| `brainforge dashboard` | Open the HTML dashboard in the browser |
+| `brainforge serve` | Live dashboard on localhost:3000 (auto-reloads) |
+| `brainforge dashboard` | Open the static HTML dashboard in the browser |
 | `brainforge update-dashboard` | Refresh dashboard data from project state |
+| `brainforge doctor` | Health check — verify all files and setup |
+| `brainforge guide` | Show all CLI and slash commands with project status |
 | `brainforge version` | Show version info |
 
 ---
@@ -150,28 +159,74 @@ Repeat steps 3–7 for each phase.
 
 These are prompt files in `.brainforge/commands/` — paste the command name into your AI tool.
 
+### Project Setup
+
+| Command | What it does |
+|---------|-------------|
+| `/start-project` | Document your idea and gather all project info |
+| `/create-roadmap` | Break project into phases (Epic › Feature › Task) |
+
+### Phase Workflow
+
 | Command | What it does |
 |---------|-------------|
-| `/start-project` | Document your idea, gather all project info |
-| `/create-roadmap` | Break project into phases (Epic > Feature > Task) |
 | `/initiate-phase N` | Research + plan phase N before any coding |
 | `/execute-phase N` | Code phase N following the plan exactly |
 | `/review-phase N` | Quality review — bugs, level check, academic check |
-| `/humanize-code` | Adapt code to match your real coding level |
-| `/explain-my-code` | Generate an explanation for a professor or team |
-| `/professor-check` | Detect code that looks suspiciously AI-generated |
 | `/checkpoint` | Local git commit (never pushes automatically) |
+
+### Code Quality
+
+| Command | What it does |
+|---------|-------------|
+| `/write-tests` | Generate tests for a file, function, or phase |
+| `/humanize-code` | Adapt code to match your real coding level |
 | `/debug-issue` | Systematic bug analysis and fix |
+
+### Student Tools
+
+| Command | What it does |
+|---------|-------------|
+| `/explain-my-code` | Generate an explanation for your professor or team |
+| `/professor-check` | Detect code that looks suspiciously AI-generated |
+| `/generate-report` | Generate an academic report template |
+
+### Documentation & UI
+
+| Command | What it does |
+|---------|-------------|
 | `/design-system` | Create a UI/UX design system guide |
 | `/generate-docs` | Generate README and docs/ folder |
-| `/generate-report` | Generate an academic report template |
-| `/update-dashboard` | Refresh the HTML dashboard |
+| `/update-dashboard` | Refresh the HTML dashboard data |
+
+---
+
+## The Live Dashboard
+
+Run `brainforge serve` to open a live dashboard at `localhost:3000`.
+
+It **auto-reloads** every time a file in `.brainforge/` changes — no manual refresh needed.
+
+```bash
+brainforge serve              # localhost:3000
+brainforge serve --port 4000  # custom port
+```
+
+It shows:
+- Project name, description, stack, and level
+- Phase progress bar
+- Status of each phase (pending / in-progress / done)
+- Recent git commits
+- Known bugs
+- Last architecture decisions
+- Git status
+- A green dot in the corner when live reload is active
 
 ---
 
 ## Code Level Engine
 
-BrainForge adapts all generated code to your target level:
+BrainForge adapts all generated and reviewed code to your target level:
 
 | Level | Who it's for | What it produces |
 |-------|-------------|-----------------|
@@ -182,16 +237,34 @@ BrainForge adapts all generated code to your target level:
 
 ### The `academic-realistic` level
 
-This is the most important level for students. It produces code that:
+The most important level for students. It produces code that:
 
 - ✅ Is clean enough to get a good grade
-- ✅ Is simple enough to explain in an oral defense
+- ✅ Is simple enough to explain line by line in an oral defense
 - ✅ Has no enterprise patterns that would raise suspicion
 - ✅ Looks like it was written by a good student, not a senior engineer
 - ✅ Has natural comments — not AI-generated-sounding ones
 
 ---
 
+## `/write-tests` — Test Generator
+
+The `/write-tests` command generates tests adapted to your project:
+
+- **Detects the right framework** automatically (Jest, Vitest, pytest, PHPUnit…)
+- **Adapts test complexity** to your code level
+- **Beginner:** 2-3 tests per function, happy path only, no mocks
+- **Academic-realistic:** happy path + edge cases, mocks for external services, readable names
+- **Professional:** full coverage, integration tests, all error paths
+
+```
+/write-tests src/auth/login.ts
+/write-tests the login feature
+/write-tests phase 2
+```
+
+---
+
 ## Project Structure
 
 After `brainforge init`, your project contains:
@@ -227,6 +300,7 @@ After `brainforge init`, your project contains:
     initiate-phase.md      ← /initiate-phase
     execute-phase.md       ← /execute-phase
     review-phase.md        ← /review-phase
+    write-tests.md         ← /write-tests
     humanize-code.md       ← /humanize-code
     explain-my-code.md     ← /explain-my-code
     professor-check.md     ← /professor-check
@@ -237,7 +311,7 @@ After `brainforge init`, your project contains:
     generate-report.md     ← /generate-report
     update-dashboard.md    ← /update-dashboard
   dashboard/
-    index.html             ← visual dashboard (open in browser)
+    index.html             ← visual dashboard
     style.css
     data.json
 AGENTS.md                  ← instructions for all AI agents
@@ -248,36 +322,9 @@ OPENAI.md                  ← OpenAI / Codex specific config
 
 ---
 
-## The Dashboard
-
-The dashboard is a static HTML file at `.brainforge/dashboard/index.html`.
-
-It shows:
-- Project name, description, stack, and level
-- Phase progress bar
-- Status of each phase (pending / in-progress / done)
-- Recent git commits
-- Known bugs
-- Last decisions
-- Git status
-
-To open it:
-
-```bash
-brainforge dashboard
-```
-
-To refresh its data:
-
-```bash
-brainforge update-dashboard
-```
-
----
-
 ## Multi-AI Compatibility
 
-BrainForge generates configuration files for every major AI tool:
+BrainForge generates config files for every major AI tool:
 
 | File | Tool |
 |------|------|
@@ -286,21 +333,14 @@ BrainForge generates configuration files for every major AI tool:
 | `OPENAI.md` | Codex / ChatGPT |
 | `AGENTS.md` | All tools (universal) |
 
-Each file tells the AI:
-- What the project is
-- What code level to use
-- How to follow the workflow
-- What files to read and update
-- Git rules (never push)
+Each file tells the AI: what the project is, what code level to use, how to follow the workflow, what files to update, and git rules (never push).
 
 ---
 
 ## Git Rules
 
-BrainForge manages git for you — safely:
-
-| Action | Allowed |
-|--------|---------|
+| Action | Status |
+|--------|--------|
 | `git init` | ✅ Auto on first init |
 | `git add` + `git commit` | ✅ Via `/checkpoint` |
 | `git push` | ❌ Never automatic |
@@ -317,24 +357,24 @@ You always control when and where you push.
 npx brainforge-ai init
 # → choose "academic-realistic" code level
 # → choose "yes" for academic project
-# → follow workflow with /start-project → /create-roadmap → phases
-# → use /professor-check before submission
-# → use /generate-report for the written report
+# → /start-project → /create-roadmap → phases
+# → /write-tests before each review
+# → /professor-check before submission
+# → /generate-report for the written report
 ```
 
 ### Personal MVP
 ```bash
 npx brainforge-ai init
 # → choose "intermediate" or "professional"
-# → define your stack and features during /start-project
-# → build phase by phase
+# → brainforge serve  ← keep the dashboard open while you build
 ```
 
 ### Learning a new stack
 ```bash
 npx brainforge-ai init
 # → choose "beginner" or "intermediate"
-# → use /explain-my-code after each phase to understand what was built
+# → /explain-my-code after each phase to understand what was built
 ```
 
 ---
@@ -358,6 +398,8 @@ npm link
 
 # Test locally
 brainforge init
+brainforge guide
+brainforge serve
 brainforge doctor
 ```
 

package/dist/cli.js

@@ -6,6 +6,8 @@ const init_1 = require("./commands/init");
 const doctor_1 = require("./commands/doctor");
 const dashboard_1 = require("./commands/dashboard");
 const updateDashboard_1 = require("./commands/updateDashboard");
+const serve_1 = require("./commands/serve");
+const help_1 = require("./commands/help");
 const program = new commander_1.Command();
 program
     .name('brainforge')
@@ -35,6 +37,19 @@ program
     .action(async () => {
     await (0, updateDashboard_1.updateDashboardCommand)();
 });
+program
+    .command('serve')
+    .description('Start a local server with live reload for the dashboard')
+    .option('-p, --port <number>', 'Port to listen on', '3000')
+    .action(async (opts) => {
+    await (0, serve_1.serveCommand)(parseInt(opts.port, 10));
+});
+program
+    .command('guide')
+    .description('Show all CLI and slash commands with project status')
+    .action(() => {
+    (0, help_1.helpCommand)();
+});
 program
     .command('version')
     .description('Show version information')

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,0CAA8C;AAC9C,8CAAkD;AAClD,oDAAwD;AACxD,gEAAoE;AAEpE,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CACV,yGAAyG,CAC1G;KACA,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gDAAgD,CAAC;KAC7D,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,kBAAW,GAAE,CAAC;AACtB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,4CAA4C,CAAC;KACzD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,sBAAa,GAAE,CAAC;AACxB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,GAAG,EAAE;IACX,IAAA,4BAAgB,GAAE,CAAC;AACrB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,mDAAmD,CAAC;KAChE,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,wCAAsB,GAAE,CAAC;AACjC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,GAAG,EAAE;IACX,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,0CAA8C;AAC9C,8CAAkD;AAClD,oDAAwD;AACxD,gEAAoE;AACpE,4CAAgD;AAChD,0CAA8C;AAE9C,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CACV,yGAAyG,CAC1G;KACA,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gDAAgD,CAAC;KAC7D,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,kBAAW,GAAE,CAAC;AACtB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,4CAA4C,CAAC;KACzD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,sBAAa,GAAE,CAAC;AACxB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,GAAG,EAAE;IACX,IAAA,4BAAgB,GAAE,CAAC;AACrB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,mDAAmD,CAAC;KAChE,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,wCAAsB,GAAE,CAAC;AACjC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,yDAAyD,CAAC;KACtE,MAAM,CAAC,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,IAAA,oBAAY,EAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,qDAAqD,CAAC;KAClE,MAAM,CAAC,GAAG,EAAE;IACX,IAAA,kBAAW,GAAE,CAAC;AAChB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,GAAG,EAAE;IACX,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/commands/help.d.ts

@@ -0,0 +1,2 @@
+export declare function helpCommand(): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAyDA,wBAAgB,WAAW,IAAI,IAAI,CAmFlC"}

package/dist/commands/help.js

@@ -0,0 +1,131 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.helpCommand = helpCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../core/config");
+const logger_1 = require("../utils/logger");
+const CLI_COMMANDS = [
+    { cmd: 'brainforge init', desc: 'Initialize BrainForge in the current directory' },
+    { cmd: 'brainforge serve', desc: 'Live dashboard on localhost:3000 (auto-reloads)' },
+    { cmd: 'brainforge dashboard', desc: 'Open the HTML dashboard in the browser' },
+    { cmd: 'brainforge update-dashboard', desc: 'Refresh dashboard data from project state' },
+    { cmd: 'brainforge doctor', desc: 'Health check — verify setup and files' },
+    { cmd: 'brainforge help', desc: 'Show this help screen' },
+    { cmd: 'brainforge version', desc: 'Show version info' },
+];
+const SLASH_COMMANDS = [
+    {
+        group: 'Project Setup',
+        commands: [
+            { cmd: '/start-project', desc: 'Document your idea and gather project info' },
+            { cmd: '/create-roadmap', desc: 'Break project into phases (Epic › Feature › Task)' },
+        ],
+    },
+    {
+        group: 'Phase Workflow',
+        commands: [
+            { cmd: '/initiate-phase N', desc: 'Research + plan phase N before any coding' },
+            { cmd: '/execute-phase N', desc: 'Code phase N following the plan exactly' },
+            { cmd: '/review-phase N', desc: 'Quality review — bugs, level check, academic check' },
+            { cmd: '/checkpoint', desc: 'Local git commit (never pushes automatically)' },
+        ],
+    },
+    {
+        group: 'Code Quality',
+        commands: [
+            { cmd: '/write-tests', desc: 'Generate tests for a file, function, or phase' },
+            { cmd: '/humanize-code', desc: 'Adapt code to match your real coding level' },
+            { cmd: '/debug-issue', desc: 'Systematic bug analysis and fix' },
+        ],
+    },
+    {
+        group: 'Student Tools',
+        commands: [
+            { cmd: '/explain-my-code', desc: 'Generate an explanation for your professor or team' },
+            { cmd: '/professor-check', desc: 'Detect code that looks suspiciously AI-generated' },
+            { cmd: '/generate-report', desc: 'Generate an academic report template' },
+        ],
+    },
+    {
+        group: 'Documentation & UI',
+        commands: [
+            { cmd: '/design-system', desc: 'Create a UI/UX design system guide' },
+            { cmd: '/generate-docs', desc: 'Generate README and docs/ folder' },
+            { cmd: '/update-dashboard', desc: 'Refresh the HTML dashboard data' },
+        ],
+    },
+];
+function helpCommand() {
+    const cwd = process.cwd();
+    const initialized = (0, config_1.configExists)(cwd);
+    console.log();
+    console.log(chalk_1.default.bold.magenta('  ⚡ BrainForge') + chalk_1.default.gray(' — structured AI development'));
+    console.log();
+    // Project status banner
+    if (initialized) {
+        try {
+            const config = (0, config_1.readConfig)(cwd);
+            const bar = progressBar(config.currentPhase, config.totalPhases);
+            console.log(chalk_1.default.gray('  Project : ') + chalk_1.default.white(config.projectName));
+            console.log(chalk_1.default.gray('  Level   : ') + chalk_1.default.cyan(config.codeLevel) +
+                chalk_1.default.gray('  ·  Stack: ') + chalk_1.default.cyan(config.stack.join(', ')));
+            console.log(chalk_1.default.gray('  Progress: ') + bar +
+                chalk_1.default.gray(` ${config.currentPhase}/${config.totalPhases} phases`));
+            console.log();
+        }
+        catch {
+            // skip if config unreadable
+        }
+    }
+    else {
+        console.log(chalk_1.default.yellow('  ⚠  Not initialized.') +
+            chalk_1.default.gray(' Run: ') + chalk_1.default.white('brainforge init'));
+        console.log();
+    }
+    // CLI Commands
+    logger_1.logger.divider();
+    console.log(chalk_1.default.bold.white('  CLI Commands\n'));
+    for (const { cmd, desc } of CLI_COMMANDS) {
+        console.log('  ' + chalk_1.default.green(cmd.padEnd(34)) + chalk_1.default.gray(desc));
+    }
+    // Slash Commands
+    console.log();
+    logger_1.logger.divider();
+    console.log(chalk_1.default.bold.white('  Slash Commands') + chalk_1.default.gray('  (paste into your AI tool)\n'));
+    for (const group of SLASH_COMMANDS) {
+        console.log(chalk_1.default.bold.yellow('  ' + group.group));
+        for (const { cmd, desc } of group.commands) {
+            console.log('    ' + chalk_1.default.cyan(cmd.padEnd(22)) + chalk_1.default.gray(desc));
+        }
+        console.log();
+    }
+    // Workflow reminder
+    logger_1.logger.divider();
+    console.log(chalk_1.default.bold.white('  Workflow\n'));
+    const steps = [
+        '/start-project',
+        '/create-roadmap',
+        '/initiate-phase N',
+        '/execute-phase N',
+        '/write-tests',
+        '/review-phase N',
+        '/checkpoint',
+    ];
+    console.log('  ' + steps.map((s) => chalk_1.default.cyan(s)).join(chalk_1.default.gray(' → ')));
+    console.log();
+    // Docs link
+    console.log(chalk_1.default.gray('  Docs: ') +
+        chalk_1.default.underline('https://github.com/MEHDImp4/brainforge-ai'));
+    console.log();
+}
+function progressBar(current, total) {
+    if (total === 0)
+        return chalk_1.default.gray('[──────────]');
+    const filled = Math.round((current / total) * 10);
+    const bar = '█'.repeat(filled) + '─'.repeat(10 - filled);
+    return chalk_1.default.green('[') + chalk_1.default.green(bar) + chalk_1.default.green(']') + ' ';
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

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

package/dist/commands/serve.d.ts

@@ -0,0 +1,2 @@
+export declare function serveCommand(port?: number): Promise<void>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAgBA,wBAAsB,YAAY,CAAC,IAAI,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA6H7D"}

package/dist/commands/serve.js

@@ -0,0 +1,162 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serveCommand = serveCommand;
+const http_1 = __importDefault(require("http"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../core/config");
+const dashboard_1 = require("../core/dashboard");
+const logger_1 = require("../utils/logger");
+const MIME = {
+    '.html': 'text/html',
+    '.css': 'text/css',
+    '.js': 'application/javascript',
+    '.json': 'application/json',
+};
+async function serveCommand(port = 3000) {
+    const cwd = process.cwd();
+    if (!(0, config_1.configExists)(cwd)) {
+        logger_1.logger.error('BrainForge not initialized. Run: brainforge init');
+        return;
+    }
+    const brainDir = (0, config_1.getBrainforgeDir)(cwd);
+    const dashDir = path_1.default.join(brainDir, 'dashboard');
+    const clients = new Set();
+    // Debounce helper so rapid file saves don't spam reloads
+    let debounceTimer = null;
+    function scheduleReload() {
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(async () => {
+            try {
+                const config = (0, config_1.readConfig)(cwd);
+                const data = await (0, dashboard_1.generateDashboardData)(config, cwd);
+                await (0, dashboard_1.writeDashboardData)(data, cwd);
+                broadcast(clients, 'reload');
+                logger_1.logger.info('Dashboard refreshed — reloading browsers…');
+            }
+            catch (err) {
+                logger_1.logger.warn('Reload failed: ' + (err instanceof Error ? err.message : String(err)));
+            }
+        }, 300);
+    }
+    // Watch the whole .brainforge/ directory recursively
+    fs_extra_1.default.watch(brainDir, { recursive: true }, (event, filename) => {
+        if (filename && filename.includes('dashboard'))
+            return; // avoid loop
+        scheduleReload();
+    });
+    const server = http_1.default.createServer(async (req, res) => {
+        const url = req.url ?? '/';
+        // SSE endpoint
+        if (url === '/events') {
+            res.writeHead(200, {
+                'Content-Type': 'text/event-stream',
+                'Cache-Control': 'no-cache',
+                Connection: 'keep-alive',
+                'Access-Control-Allow-Origin': '*',
+            });
+            res.write('data: connected\n\n');
+            clients.add(res);
+            req.on('close', () => clients.delete(res));
+            return;
+        }
+        // Static file serving
+        let filePath = url === '/' ? path_1.default.join(dashDir, 'index.html') : path_1.default.join(dashDir, url);
+        filePath = path_1.default.normalize(filePath);
+        // Security: prevent directory traversal
+        if (!filePath.startsWith(path_1.default.normalize(dashDir))) {
+            res.writeHead(403);
+            res.end('Forbidden');
+            return;
+        }
+        if (!fs_extra_1.default.existsSync(filePath)) {
+            res.writeHead(404);
+            res.end('Not found');
+            return;
+        }
+        const ext = path_1.default.extname(filePath);
+        const mime = MIME[ext] ?? 'application/octet-stream';
+        // Inject SSE client into HTML
+        if (ext === '.html') {
+            let html = fs_extra_1.default.readFileSync(filePath, 'utf-8');
+            html = injectSseClient(html);
+            res.writeHead(200, { 'Content-Type': 'text/html' });
+            res.end(html);
+            return;
+        }
+        res.writeHead(200, { 'Content-Type': mime });
+        fs_extra_1.default.createReadStream(filePath).pipe(res);
+    });
+    // Initial data generation before starting
+    try {
+        const config = (0, config_1.readConfig)(cwd);
+        const data = await (0, dashboard_1.generateDashboardData)(config, cwd);
+        await (0, dashboard_1.writeDashboardData)(data, cwd);
+    }
+    catch {
+        // non-fatal
+    }
+    server.listen(port, () => {
+        logger_1.logger.title('⚡ BrainForge Dashboard — Live');
+        logger_1.logger.divider();
+        logger_1.logger.success(`Running at http://localhost:${port}`);
+        logger_1.logger.info('Dashboard reloads automatically when .brainforge/ files change.');
+        logger_1.logger.info('Press Ctrl+C to stop.');
+        logger_1.logger.divider();
+        // Try to open browser
+        try {
+            const { execSync } = require('child_process');
+            const open = process.platform === 'win32'
+                ? `start http://localhost:${port}`
+                : process.platform === 'darwin'
+                    ? `open http://localhost:${port}`
+                    : `xdg-open http://localhost:${port}`;
+            execSync(open, { stdio: 'ignore' });
+        }
+        catch {
+            // ignore if can't open
+        }
+    });
+    server.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+            logger_1.logger.error(`Port ${port} is already in use. Try: brainforge serve --port ${port + 1}`);
+        }
+        else {
+            logger_1.logger.error(err.message);
+        }
+        process.exit(1);
+    });
+}
+function broadcast(clients, event) {
+    for (const client of clients) {
+        client.write(`event: ${event}\ndata: ${Date.now()}\n\n`);
+    }
+}
+function injectSseClient(html) {
+    const script = `
+<script>
+(function () {
+  const es = new EventSource('/events');
+  es.addEventListener('reload', () => location.reload());
+  es.addEventListener('error', () => {
+    setTimeout(() => location.reload(), 2000);
+  });
+  // Show a small indicator in the corner
+  const dot = document.createElement('div');
+  dot.title = 'BrainForge live reload active';
+  dot.style.cssText = 'position:fixed;bottom:12px;right:12px;width:10px;height:10px;border-radius:50%;background:#22c55e;box-shadow:0 0 6px #22c55e;z-index:9999;';
+  document.addEventListener('DOMContentLoaded', () => document.body.appendChild(dot));
+  es.onopen = () => { dot.style.background = '#22c55e'; dot.style.boxShadow = '0 0 6px #22c55e'; };
+  es.onerror = () => { dot.style.background = '#ef4444'; dot.style.boxShadow = '0 0 6px #ef4444'; };
+})();
+</script>`;
+    // Inject before </body> if present, otherwise append
+    return html.includes('</body>')
+        ? html.replace('</body>', script + '\n</body>')
+        : html + script;
+}
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

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

package/dist/core/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqTlF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAonBpF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgJrF"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqTlF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAytBpF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgJrF"}

package/dist/core/templates.js

@@ -917,6 +917,104 @@ brainforge update-dashboard
 
 - Updated \`.brainforge/dashboard/data.json\`
 - Message: "Dashboard updated. Open .brainforge/dashboard/index.html"
+`,
+        'write-tests.md': `# /write-tests
+
+**Objective:** Generate tests for a file, function, or entire phase.
+
+## Usage
+
+\`\`\`
+/write-tests [file or feature or phase number]
+\`\`\`
+
+Examples:
+\`\`\`
+/write-tests src/auth/login.ts
+/write-tests the login feature
+/write-tests phase 2
+\`\`\`
+
+## Context to Read First
+
+- \`.brainforge/config.json\` — stack and code level
+- \`.brainforge/memory/coding-style.md\` — test style rules
+- Target file(s) to test
+
+## Steps
+
+1. Read the target file(s) and understand the logic
+2. Identify what needs to be tested:
+   - Pure functions → unit tests
+   - API routes → integration tests
+   - UI components → component tests
+3. Choose the right test framework for the stack (see below)
+4. Write tests at **${config.codeLevel}** complexity level
+5. Place test files next to source or in a \`tests/\` folder
+6. Verify tests pass conceptually before writing
+
+## Test Framework by Stack
+
+| Stack | Framework | Command |
+|-------|-----------|---------|
+| Node.js / TypeScript | Jest or Vitest | \`npm test\` |
+| React | Vitest + Testing Library | \`npm test\` |
+| Next.js | Jest + Testing Library | \`npm test\` |
+| Python | pytest | \`pytest\` |
+| Laravel | PHPUnit | \`php artisan test\` |
+
+## What to Test (by level)
+
+### ${config.codeLevel === 'beginner' ? 'beginner' : config.codeLevel === 'academic-realistic' ? 'academic-realistic' : config.codeLevel === 'professional' ? 'professional' : 'intermediate'}
+
+${config.codeLevel === 'beginner'
+            ? `- Test the main happy path only
+- 2-3 tests per function maximum
+- Simple assertions (toBe, toEqual)
+- No mocks — test real behavior
+- Comments explaining what each test does`
+            : config.codeLevel === 'intermediate'
+                ? `- Happy path + main edge cases
+- Group tests with describe()
+- Simple mocks for external dependencies
+- Test error cases for user inputs
+- Aim for ~60% coverage on critical files`
+                : config.codeLevel === 'academic-realistic'
+                    ? `- Happy path + 2-3 edge cases per function
+- Group with describe(), use clear test names
+- Mock external services (DB, API calls)
+- Test error handling on inputs
+- Coverage enough to show you care — not 100%
+- Test names readable as plain English sentences`
+                    : `- Full happy path + all edge cases
+- Mock all external dependencies
+- Test error boundaries and failure modes
+- Aim for 80%+ coverage on business logic
+- Integration tests for API endpoints
+- Snapshot tests for stable UI components`}
+
+## Test File Naming
+
+\`\`\`
+src/auth/login.ts       → src/auth/login.test.ts
+src/utils/format.ts     → src/utils/format.test.ts
+src/pages/Home.tsx      → src/pages/Home.test.tsx
+\`\`\`
+
+## Rules
+
+- Do NOT test implementation details — test behavior
+- Do NOT write tests that always pass (useless assertions)
+- Keep test files under 150 lines — split if needed
+- Each test must have a clear, readable name
+- NEVER skip failing tests with \`.skip\` — fix them
+
+## After Writing Tests
+
+1. Add test script to \`package.json\` if missing
+2. Run the tests mentally to verify they make sense
+3. Update \`.brainforge/phases/phase-XX.md\` checklist
+4. Suggest: \`/checkpoint\` to commit the tests
 `,
     };
 }

package/dist/core/templates.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainforge-ai",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "CLI to transform a vague idea into a structured, AI-assisted project with agents, slash commands, memory, and a live dashboard",
   "keywords": [
     "ai",