brainforge-ai 1.2.0 → 1.2.1

package/dist/cli.js

@@ -9,6 +9,12 @@ const updateDashboard_1 = require("./commands/updateDashboard");
 const serve_1 = require("./commands/serve");
 const help_1 = require("./commands/help");
 const update_1 = require("./commands/update");
+const status_1 = require("./commands/status");
+const simplify_1 = require("./commands/simplify");
+const professorCheck_1 = require("./commands/professorCheck");
+const study_1 = require("./commands/study");
+const difficulty_1 = require("./commands/difficulty");
+const defensePack_1 = require("./commands/defensePack");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../package.json');
 const program = new commander_1.Command();
@@ -19,8 +25,10 @@ program
 program
     .command('init')
     .description('Initialize BrainForge in the current directory')
-    .action(async () => {
-    await (0, init_1.initCommand)();
+    .option('-y, --yes', 'Skip prompts and use defaults (non-interactive)')
+    .option('--preset <name>', 'Use a preset configuration: student')
+    .action(async (opts) => {
+    await (0, init_1.initCommand)(opts);
 });
 program
     .command('doctor')
@@ -59,6 +67,43 @@ program
     .action(() => {
     (0, help_1.helpCommand)();
 });
+program
+    .command('status')
+    .description('Show a compact summary of the current BrainForge project')
+    .action(async () => {
+    await (0, status_1.statusCommand)();
+});
+program
+    .command('simplify')
+    .description('Generate a prompt to simplify code to match the project code level')
+    .action(() => {
+    (0, simplify_1.simplifyCommand)();
+});
+program
+    .command('professor-check')
+    .description('Generate a prompt to detect suspiciously AI-generated code patterns')
+    .action(() => {
+    (0, professorCheck_1.professorCheckCommand)();
+});
+program
+    .command('study')
+    .description('Initialize Study Mode files to help understand and explain the project')
+    .action(async () => {
+    await (0, study_1.studyCommand)();
+});
+program
+    .command('difficulty')
+    .alias('analyze-difficulty')
+    .description('Generate a difficulty analysis workflow for studying important files')
+    .action(async () => {
+    await (0, difficulty_1.difficultyCommand)();
+});
+program
+    .command('defense-pack')
+    .description('Generate an oral defense and presentation preparation workflow')
+    .action(async () => {
+    await (0, defensePack_1.defensePackCommand)();
+});
 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;AACpE,4CAAgD;AAChD,0CAA8C;AAC9C,8CAAkD;AAClD,8DAA8D;AAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CACV,yGAAyG,CAC1G;KACA,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExB,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,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,4BAAgB,GAAE,CAAC;AAC3B,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,QAAQ,CAAC;KACjB,WAAW,CAAC,0FAA0F,CAAC;KACvG,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,sBAAa,GAAE,CAAC;AACxB,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,kBAAkB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,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":"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"}

package/dist/commands/defensePack.d.ts

@@ -0,0 +1,2 @@
+export declare function defensePackCommand(): Promise<void>;
+//# sourceMappingURL=defensePack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defensePack.d.ts","sourceRoot":"","sources":["../../src/commands/defensePack.ts"],"names":[],"mappings":"AAMA,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4DxD"}

package/dist/commands/defensePack.js

@@ -0,0 +1,269 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defensePackCommand = defensePackCommand;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../core/config");
+const logger_1 = require("../utils/logger");
+async function defensePackCommand() {
+    const cwd = process.cwd();
+    if (!(0, config_1.configExists)(cwd)) {
+        logger_1.logger.error('BrainForge not initialized. Run: brainforge init');
+        return;
+    }
+    const config = (0, config_1.readConfig)(cwd);
+    const brainDir = (0, config_1.getBrainforgeDir)(cwd);
+    const studyDir = path_1.default.join(brainDir, 'study');
+    logger_1.logger.title('⚡ BrainForge Defense Pack');
+    logger_1.logger.divider();
+    logger_1.logger.info(`Project: ${chalk_1.default.white(config.projectName)}`);
+    console.log();
+    await fs_extra_1.default.ensureDir(path_1.default.join(brainDir, 'reports'));
+    await fs_extra_1.default.ensureDir(studyDir);
+    const reportPath = path_1.default.join(brainDir, 'reports', 'defense-pack.md');
+    const commandPath = path_1.default.join(brainDir, 'commands', 'defense-pack.md');
+    const oralPath = path_1.default.join(studyDir, 'oral-defense.md');
+    if (!fs_extra_1.default.existsSync(reportPath)) {
+        await fs_extra_1.default.writeFile(reportPath, generateDefensePackTemplate(config.projectName));
+        console.log(chalk_1.default.green('  ✔ Created: ') + chalk_1.default.gray('.brainforge/reports/defense-pack.md'));
+    }
+    else {
+        console.log(chalk_1.default.gray('  ○ Exists:  ') + chalk_1.default.gray('.brainforge/reports/defense-pack.md'));
+    }
+    if (!fs_extra_1.default.existsSync(oralPath)) {
+        await fs_extra_1.default.writeFile(oralPath, generateOralDefenseTemplate());
+        console.log(chalk_1.default.green('  ✔ Created: ') + chalk_1.default.gray('.brainforge/study/oral-defense.md'));
+    }
+    else {
+        console.log(chalk_1.default.gray('  ○ Exists:  ') + chalk_1.default.gray('.brainforge/study/oral-defense.md'));
+    }
+    await fs_extra_1.default.writeFile(commandPath, generateDefensePackCommand(config));
+    console.log(chalk_1.default.green('  ✔ Written: ') + chalk_1.default.gray('.brainforge/commands/defense-pack.md'));
+    console.log();
+    logger_1.logger.divider();
+    logger_1.logger.success('Defense Pack workflow ready.');
+    console.log();
+    console.log(chalk_1.default.bold.white('  Paste this prompt into your AI tool:'));
+    console.log();
+    console.log(chalk_1.default.yellow('  ────────────────────────────────────────────────────────'));
+    console.log(chalk_1.default.white('  /defense-pack'));
+    console.log(chalk_1.default.gray(''));
+    console.log(chalk_1.default.gray('  Read .brainforge/commands/defense-pack.md for full instructions.'));
+    console.log(chalk_1.default.yellow('  ────────────────────────────────────────────────────────'));
+    console.log();
+    console.log(chalk_1.default.gray('  The AI will generate:'));
+    console.log(chalk_1.default.gray('  - 30-second / 1-minute / 5-minute project explanations'));
+    console.log(chalk_1.default.gray('  - Architecture explanation in simple terms'));
+    console.log(chalk_1.default.gray('  - Professor questions with suggested answers'));
+    console.log(chalk_1.default.gray('  - Demo script for presentation'));
+    console.log(chalk_1.default.gray('  - Final presentation checklist'));
+    console.log();
+}
+function generateDefensePackTemplate(projectName) {
+    return `# Defense Pack — ${projectName}
+
+_Generated by \`brainforge defense-pack\`. Run \`/defense-pack\` in your AI tool to fill this in._
+
+## Project summary
+
+### 30-second explanation
+
+_To be filled._
+
+### 1-minute explanation
+
+_To be filled._
+
+### 5-minute explanation
+
+_To be filled._
+
+## Problem and solution
+
+_To be filled._
+
+## Main features
+
+_To be filled._
+
+## Architecture explained simply
+
+_To be filled._
+
+## Folder structure explained
+
+_To be filled._
+
+## Database / API / UI explanation
+
+_Only sections relevant to the project stack._
+
+## What each important file does
+
+| File | Role | How to explain it |
+|------|------|------------------|
+| _To be filled_ | | |
+
+## Difficult parts to revise
+
+| Topic | Why it is difficult | How to explain simply |
+|-------|-------------------|----------------------|
+| _To be filled_ | | |
+
+## Professor questions and answers
+
+| Question | Suggested answer |
+|----------|-----------------|
+| _To be filled_ | |
+
+## Demo script
+
+_To be filled._
+
+## What to say if asked "Did you use AI?"
+
+_To be filled._
+
+## Final checklist before presentation
+
+- [ ] I can explain the project goal
+- [ ] I can explain the architecture
+- [ ] I can explain the important files
+- [ ] I can run the project
+- [ ] I can answer likely questions
+`;
+}
+function generateOralDefenseTemplate() {
+    return `# Oral Defense Preparation
+
+## 30-second project explanation
+
+_To be filled by /defense-pack._
+
+## 1-minute project explanation
+
+_To be filled._
+
+## 5-minute project explanation
+
+_To be filled._
+
+## Architecture explanation
+
+_To be filled._
+
+## Main features
+
+_To be filled._
+
+## What I built myself
+
+_To be filled._
+
+## What I should be ready to explain
+
+_To be filled._
+`;
+}
+function generateDefensePackCommand(config) {
+    return `# /defense-pack
+
+**Objective:** Generate a complete presentation and oral defense preparation document.
+
+## Context to Read First
+
+Read these files (skip gracefully if they don't exist):
+
+- \`.brainforge/brain.md\`
+- \`.brainforge/project.md\`
+- \`.brainforge/roadmap.md\`
+- \`.brainforge/phases/\` (all phase files)
+- \`.brainforge/memory/architecture.md\`
+- \`.brainforge/memory/learning-notes.md\`
+- \`.brainforge/reports/difficulty-report.md\`
+- \`.brainforge/reports/professor-check.md\`
+
+## Project Info
+
+- **Project:** ${config.projectName}
+- **Stack:** ${config.stack.join(', ')}
+- **Code level:** ${config.codeLevel}
+- **User level:** ${config.userLevel}
+- **Academic:** ${config.isAcademic ? 'Yes' : 'No'}
+
+## Steps
+
+1. Read all available context files
+2. Generate all sections of the Defense Pack
+3. Write results to \`.brainforge/reports/defense-pack.md\`
+4. Update \`.brainforge/study/oral-defense.md\` with the 30s / 1min / 5min explanations
+
+## Output Format
+
+Write to \`.brainforge/reports/defense-pack.md\`:
+
+\`\`\`md
+# Defense Pack — ${config.projectName}
+
+## Project summary
+
+### 30-second explanation
+[One clear sentence anyone can understand]
+
+### 1-minute explanation
+[3-4 sentences: problem, solution, main features, tech used]
+
+### 5-minute explanation
+[Full story: context, problem, solution, architecture, features, demo flow]
+
+## Problem and solution
+[What problem does the project solve? For whom?]
+
+## Main features
+[Bullet list of core features]
+
+## Architecture explained simply
+[Simple diagram or description — no jargon]
+
+## Folder structure explained
+[Each folder and what it contains]
+
+## Database / API / UI explanation
+[Only sections relevant to: ${config.stack.join(', ')}]
+
+## What each important file does
+| File | Role | How to explain it |
+
+## Difficult parts to revise
+| Topic | Why it is difficult | How to explain simply |
+
+## Professor questions and answers
+| Question | Suggested answer |
+
+## Demo script
+Step 1: [Show...]
+Step 2: [Navigate to...]
+Step 3: [Demonstrate...]
+
+## What to say if asked "Did you use AI?"
+Give an honest, ethical answer:
+- AI was used as an assistant for structure, review, and learning
+- The student understands the code and can defend the choices
+- Do not encourage lying
+- Example: "Yes, I used AI as a tool to help structure my work and review my code,
+  similar to how a developer uses Stack Overflow. I wrote and understand all the code."
+
+## Final checklist before presentation
+- [ ] I can explain the project goal
+- [ ] I can explain the architecture
+- [ ] I can explain every important file
+- [ ] I can run the project without errors
+- [ ] I can answer the professor questions above
+\`\`\`
+`;
+}
+//# sourceMappingURL=defensePack.js.map

package/dist/commands/defensePack.js.map

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

package/dist/commands/difficulty.d.ts

@@ -0,0 +1,2 @@
+export declare function difficultyCommand(): Promise<void>;
+//# sourceMappingURL=difficulty.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"difficulty.d.ts","sourceRoot":"","sources":["../../src/commands/difficulty.ts"],"names":[],"mappings":"AAMA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiDvD"}

package/dist/commands/difficulty.js

@@ -0,0 +1,177 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.difficultyCommand = difficultyCommand;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../core/config");
+const logger_1 = require("../utils/logger");
+async function difficultyCommand() {
+    const cwd = process.cwd();
+    if (!(0, config_1.configExists)(cwd)) {
+        logger_1.logger.error('BrainForge not initialized. Run: brainforge init');
+        return;
+    }
+    const config = (0, config_1.readConfig)(cwd);
+    const brainDir = (0, config_1.getBrainforgeDir)(cwd);
+    logger_1.logger.title('⚡ BrainForge Difficulty Analysis');
+    logger_1.logger.divider();
+    logger_1.logger.info(`Project: ${chalk_1.default.white(config.projectName)}`);
+    console.log();
+    await fs_extra_1.default.ensureDir(path_1.default.join(brainDir, 'reports'));
+    const reportPath = path_1.default.join(brainDir, 'reports', 'difficulty-report.md');
+    const commandPath = path_1.default.join(brainDir, 'commands', 'analyze-difficulty.md');
+    if (!fs_extra_1.default.existsSync(reportPath)) {
+        await fs_extra_1.default.writeFile(reportPath, generateDifficultyReportTemplate(config.projectName));
+        console.log(chalk_1.default.green('  ✔ Created: ') + chalk_1.default.gray('.brainforge/reports/difficulty-report.md'));
+    }
+    else {
+        console.log(chalk_1.default.gray('  ○ Exists:  ') + chalk_1.default.gray('.brainforge/reports/difficulty-report.md'));
+    }
+    await fs_extra_1.default.writeFile(commandPath, generateAnalyzeDifficultyCommand(config));
+    console.log(chalk_1.default.green('  ✔ Written: ') + chalk_1.default.gray('.brainforge/commands/analyze-difficulty.md'));
+    console.log();
+    logger_1.logger.divider();
+    logger_1.logger.success('Difficulty analysis workflow ready.');
+    console.log();
+    console.log(chalk_1.default.bold.white('  Paste this prompt into your AI tool:'));
+    console.log();
+    console.log(chalk_1.default.yellow('  ────────────────────────────────────────────────────────'));
+    console.log(chalk_1.default.white('  /analyze-difficulty'));
+    console.log(chalk_1.default.gray(''));
+    console.log(chalk_1.default.gray('  Read .brainforge/commands/analyze-difficulty.md for full instructions.'));
+    console.log(chalk_1.default.yellow('  ────────────────────────────────────────────────────────'));
+    console.log();
+    console.log(chalk_1.default.gray('  The AI will:'));
+    console.log(chalk_1.default.gray('  - Score every important file from 1–10'));
+    console.log(chalk_1.default.gray('  - Flag concepts you need to review'));
+    console.log(chalk_1.default.gray('  - Update .brainforge/study/file-map.md'));
+    console.log(chalk_1.default.gray('  - Update .brainforge/memory/learning-notes.md'));
+    console.log();
+}
+function generateDifficultyReportTemplate(projectName) {
+    return `# Difficulty Report — ${projectName}
+
+_Generated by \`brainforge difficulty\`. Run \`/analyze-difficulty\` in your AI tool to fill this in._
+
+## Summary
+
+- **Overall difficulty:** _To be filled_
+- **Risk for oral defense:** _To be filled_
+
+## File Difficulty Map
+
+| File | Difficulty /10 | Reason | Concepts needed | Defense risk |
+|------|---------------:|--------|-----------------|-------------|
+| _To be filled_ | | | | |
+
+## Top files to study first
+
+1. _To be filled_
+2.
+3.
+
+## Too advanced patterns
+
+| File | Pattern | Why difficult | Simpler alternative |
+|------|---------|--------------|-------------------|
+| _To be filled_ | | | |
+
+## Concepts to review
+
+| Concept | Files | Priority |
+|---------|-------|----------|
+| _To be filled_ | | |
+
+## Recommended study plan
+
+1. _To be filled_
+2.
+3.
+`;
+}
+function generateAnalyzeDifficultyCommand(config) {
+    return `# /analyze-difficulty
+
+**Objective:** Scan the project codebase, score file complexity, and produce a difficulty report.
+
+## Context to Read First
+
+- \`.brainforge/brain.md\`
+- \`.brainforge/memory/coding-style.md\`
+- \`.brainforge/memory/architecture.md\`
+
+## Project Info
+
+- **Project:** ${config.projectName}
+- **Stack:** ${config.stack.join(', ')}
+- **Code level:** ${config.codeLevel}
+- **User level:** ${config.userLevel}
+
+## Steps
+
+1. Scan all source files in the project (exclude node_modules, dist, .git)
+2. For each file, compute a difficulty score 1–10 using the criteria below
+3. Identify patterns that would be hard to explain to a professor
+4. Generate a recommended study plan
+5. Write results to \`.brainforge/reports/difficulty-report.md\`
+6. Update \`.brainforge/study/file-map.md\`
+7. Update \`.brainforge/study/concepts-to-review.md\`
+8. Update \`.brainforge/memory/learning-notes.md\` with files to understand
+
+## Difficulty Scoring Criteria
+
+Score each file from 1 (trivial) to 10 (very hard):
+
+| Factor | Points |
+|--------|--------|
+| Multiple responsibilities in one file | +1-2 |
+| Async / database / API logic | +1 |
+| Authentication / session / security logic | +1-2 |
+| Advanced TypeScript (generics, utility types) | +1-2 |
+| Complex state management | +1 |
+| Hidden side effects | +1 |
+| External services integration | +1 |
+| Testing / mocking complexity | +1 |
+| Architecture patterns (middleware, DI, etc.) | +1-2 |
+| Large file (>200 lines) | +1 |
+
+## Output Format
+
+Write to \`.brainforge/reports/difficulty-report.md\`:
+
+\`\`\`md
+## Summary
+Overall difficulty: beginner | intermediate | advanced | professional
+Risk for oral defense: low | medium | high
+
+## File Difficulty Map
+| File | Difficulty /10 | Reason | Concepts needed | Defense risk |
+
+## Top files to study first
+1.
+2.
+3.
+
+## Too advanced patterns
+| File | Pattern | Why difficult | Simpler alternative |
+
+## Concepts to review
+| Concept | Files | Priority |
+
+## Recommended study plan
+1.
+2.
+3.
+\`\`\`
+
+Also update:
+- \`.brainforge/study/file-map.md\` — add each file with difficulty and must-understand flag
+- \`.brainforge/study/concepts-to-review.md\` — add key concepts
+- \`.brainforge/memory/learning-notes.md\` — add files to understand section
+`;
+}
+//# sourceMappingURL=difficulty.js.map

package/dist/commands/difficulty.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAaA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAkFnD"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAaA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA6InD"}

package/dist/commands/doctor.js

@@ -43,7 +43,7 @@ async function doctorCommand() {
             checks.push({ label: 'config.json valid', ok: false, detail: String(e) });
         }
         // Required directories
-        const dirs = ['memory', 'phases', 'agents', 'commands', 'dashboard'];
+        const dirs = ['memory', 'phases', 'agents', 'commands', 'dashboard', 'reports'];
         for (const dir of dirs) {
             const exists = fs_extra_1.default.existsSync(path_1.default.join(cwd, '.brainforge', dir));
             checks.push({ label: `.brainforge/${dir}/`, ok: exists });
@@ -60,6 +60,58 @@ async function doctorCommand() {
             const exists = fs_extra_1.default.existsSync(path_1.default.join(cwd, f));
             checks.push({ label: `${f} in root`, ok: exists });
         }
+        // Extended memory files
+        const extMemoryFiles = [
+            'memory/project-context.md',
+            'memory/constraints.md',
+            'memory/learning-notes.md',
+        ];
+        for (const f of extMemoryFiles) {
+            const exists = fs_extra_1.default.existsSync(path_1.default.join(cwd, '.brainforge', f));
+            checks.push({ label: `.brainforge/${f}`, ok: exists });
+        }
+        // Reports README
+        checks.push({
+            label: '.brainforge/reports/README.md',
+            ok: fs_extra_1.default.existsSync(path_1.default.join(cwd, '.brainforge', 'reports', 'README.md')),
+        });
+        // v1.2 — Router agent
+        checks.push({
+            label: '.brainforge/agents/brainforge-router.md',
+            ok: fs_extra_1.default.existsSync(path_1.default.join(cwd, '.brainforge', 'agents', 'brainforge-router.md')),
+            detail: fs_extra_1.default.existsSync(path_1.default.join(cwd, '.brainforge', 'agents', 'brainforge-router.md'))
+                ? undefined
+                : 'Run: brainforge update',
+        });
+        // v1.2 — Agents README
+        checks.push({
+            label: '.brainforge/agents/README.md',
+            ok: fs_extra_1.default.existsSync(path_1.default.join(cwd, '.brainforge', 'agents', 'README.md')),
+            detail: fs_extra_1.default.existsSync(path_1.default.join(cwd, '.brainforge', 'agents', 'README.md'))
+                ? undefined
+                : 'Run: brainforge update',
+        });
+        // v1.2 — Study mode (recommended, not required)
+        const studyEnabled = fs_extra_1.default.existsSync(path_1.default.join(cwd, '.brainforge', 'study'));
+        checks.push({
+            label: '.brainforge/study/ (Study Mode)',
+            ok: studyEnabled,
+            detail: studyEnabled ? undefined : 'Recommended: brainforge study',
+        });
+        // v1.2 — Defense pack report (recommended)
+        const defenseExists = fs_extra_1.default.existsSync(path_1.default.join(cwd, '.brainforge', 'reports', 'defense-pack.md'));
+        checks.push({
+            label: '.brainforge/reports/defense-pack.md',
+            ok: defenseExists,
+            detail: defenseExists ? undefined : 'Recommended: brainforge defense-pack',
+        });
+        // v1.2 — Difficulty report (recommended)
+        const diffExists = fs_extra_1.default.existsSync(path_1.default.join(cwd, '.brainforge', 'reports', 'difficulty-report.md'));
+        checks.push({
+            label: '.brainforge/reports/difficulty-report.md',
+            ok: diffExists,
+            detail: diffExists ? undefined : 'Recommended: brainforge difficulty',
+        });
     }
     // Git repo
     const hasGit = await (0, git_1.isGitRepo)(cwd);

package/dist/commands/doctor.js.map

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

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

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