brainforge-ai 1.2.1 → 1.2.2

package/dist/commands/defensePack.js

@@ -64,206 +64,206 @@ async function defensePackCommand() {
     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
+    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._
+    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
-\`\`\`
+    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/difficulty.js

@@ -53,125 +53,125 @@ async function difficultyCommand() {
     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.
+    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
+    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