mindforge-cc 2.3.0 → 2.3.5

package/.mindforge/memory/knowledge-base.jsonl

@@ -0,0 +1,11 @@
+{"id":"34a7925f-7361-4836-91eb-916495033861","timestamp":"2026-03-22T17:25:37.659Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9,"tags":["ui","css"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
+{"id":"34a7925f-7361-4836-91eb-916495033861","timestamp":"2026-03-22T17:25:37.659Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9500000000000001,"tags":["ui","css"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-22T17:25:37.665Z","deprecated":false,"deprecated_by":null}
+{"id":"34a7925f-7361-4836-91eb-916495033861","timestamp":"2026-03-22T17:25:37.659Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9500000000000001,"tags":["ui","css"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-22T17:25:37.665Z","deprecated":true,"deprecated_by":null,"deprecated_reason":"Switching to Vanilla CSS","deprecated_at":"2026-03-22T17:25:37.666Z"}
+{"id":"a2d4b3a6-fdaa-4c9a-b654-286d9ea133e2","timestamp":"2026-03-22T17:25:37.670Z","type":"domain_knowledge","topic":"Auth with JWT","content":"Secure JWT with httpOnly cookies.","source":"manual","project":"[Project Name]","confidence":0.8,"tags":["auth"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
+{"id":"6c1f0f31-3903-4b95-bae8-5473ffbec9eb","timestamp":"2026-03-22T17:25:37.671Z","type":"domain_knowledge","topic":"Database SQL","content":"Use indexed columns for fast queries.","source":"manual","project":"[Project Name]","confidence":0.7,"tags":["db"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
+{"id":"a9878977-cb7c-4dcf-8161-760ffd5e7de9","timestamp":"2026-03-22T17:25:37.673Z","type":"code_pattern","topic":"React Memo","content":"Use React.memo to prevent re-renders.","source":"manual","project":"[Project Name]","confidence":0.6,"tags":["ui"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
+{"id":"739dcb0a-9c4b-40d2-846b-535b7e4cb274","timestamp":"2026-03-22T17:25:51.782Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9,"tags":["ui","css"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
+{"id":"739dcb0a-9c4b-40d2-846b-535b7e4cb274","timestamp":"2026-03-22T17:25:51.782Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9500000000000001,"tags":["ui","css"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-25T17:42:57.286Z","deprecated":false,"deprecated_by":null}
+{"id":"a9878977-cb7c-4dcf-8161-760ffd5e7de9","timestamp":"2026-03-22T17:25:37.673Z","type":"code_pattern","topic":"React Memo","content":"Use React.memo to prevent re-renders.","source":"manual","project":"[Project Name]","confidence":0.65,"tags":["ui"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-25T17:42:57.297Z","deprecated":false,"deprecated_by":null}
+{"id":"a2d4b3a6-fdaa-4c9a-b654-286d9ea133e2","timestamp":"2026-03-22T17:25:37.670Z","type":"domain_knowledge","topic":"Auth with JWT","content":"Secure JWT with httpOnly cookies.","source":"manual","project":"[Project Name]","confidence":0.8500000000000001,"tags":["auth"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-25T17:42:57.298Z","deprecated":false,"deprecated_by":null}
+{"id":"6c1f0f31-3903-4b95-bae8-5473ffbec9eb","timestamp":"2026-03-22T17:25:37.671Z","type":"domain_knowledge","topic":"Database SQL","content":"Use indexed columns for fast queries.","source":"manual","project":"[Project Name]","confidence":0.75,"tags":["db"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-25T17:42:57.299Z","deprecated":false,"deprecated_by":null}

package/.mindforge/memory/pattern-library.jsonl

@@ -0,0 +1,2 @@
+{"id":"a9878977-cb7c-4dcf-8161-760ffd5e7de9","timestamp":"2026-03-22T17:25:37.673Z","type":"code_pattern","topic":"React Memo","content":"Use React.memo to prevent re-renders.","source":"manual","project":"[Project Name]","confidence":0.6,"tags":["ui"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
+{"id":"a9878977-cb7c-4dcf-8161-760ffd5e7de9","timestamp":"2026-03-22T17:25:37.673Z","type":"code_pattern","topic":"React Memo","content":"Use React.memo to prevent re-renders.","source":"manual","project":"[Project Name]","confidence":0.65,"tags":["ui"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-25T17:42:57.297Z","deprecated":false,"deprecated_by":null}

package/.mindforge/memory/team-preferences.jsonl

@@ -0,0 +1,5 @@
+{"id":"34a7925f-7361-4836-91eb-916495033861","timestamp":"2026-03-22T17:25:37.659Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9,"tags":["ui","css"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
+{"id":"34a7925f-7361-4836-91eb-916495033861","timestamp":"2026-03-22T17:25:37.659Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9500000000000001,"tags":["ui","css"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-22T17:25:37.665Z","deprecated":false,"deprecated_by":null}
+{"id":"34a7925f-7361-4836-91eb-916495033861","timestamp":"2026-03-22T17:25:37.659Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9500000000000001,"tags":["ui","css"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-22T17:25:37.665Z","deprecated":true,"deprecated_by":null,"deprecated_reason":"Switching to Vanilla CSS","deprecated_at":"2026-03-22T17:25:37.666Z"}
+{"id":"739dcb0a-9c4b-40d2-846b-535b7e4cb274","timestamp":"2026-03-22T17:25:51.782Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9,"tags":["ui","css"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
+{"id":"739dcb0a-9c4b-40d2-846b-535b7e4cb274","timestamp":"2026-03-22T17:25:51.782Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9500000000000001,"tags":["ui","css"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-25T17:42:57.286Z","deprecated":false,"deprecated_by":null}

package/.planning/AUDIT.jsonl

@@ -1 +1 @@
-{"timestamp":"2026-03-22T20:52:21.691Z","event":"skill_installed","skill_name":"security-owasp","skill_version":"1.2.0","tier":2,"source":"cli-system","validation_passed":true}
+{"event":"INIT","date":"2026-03-25T00:00:00Z","summary":"MindForge Project Initialized"}

package/.planning/HANDOFF.json

@@ -1,28 +1,8 @@
 {
-  "schema_version": "1.0.0",
-  "project": null,
-  "phase": null,
-  "plan": null,
-  "plan_step": null,
-  "last_completed_task": {
-    "description": null,
-    "commit_sha": null,
-    "verified": null
-  },
-  "next_task": "Run /mindforge:init-project",
-  "in_progress": {
-    "file": null,
-    "intent": null,
-    "completed_steps": [],
-    "remaining_steps": []
-  },
-  "blockers": [],
-  "decisions_needed": [],
-  "context_refs": [],
-  "agent_notes": "",
-  "session_summary": "",
-  "recent_files": [],
-  "recent_commits": [],
-  "updated_at": null,
-  "_warning": "Never store secrets, tokens, or passwords in this file. It is tracked in git."
+  "_warning": "DO NOT ADD SECRETS OR SENSITIVE DATA TO THIS FILE. IT IS SYNCED ACROSS SESSIONS.",
+  "schema_type": "HANDOFF",
+  "schema_version": "2.0.0",
+  "handoffs": [],
+  "current_context": "",
+  "last_updated": "2026-03-25T00:00:00Z"
 }

package/.planning/ROADMAP.md

@@ -1,5 +1,6 @@
+# MindForge Roadmap
 
-### Phase 1: Migrate GSD to MindForge
+### Phase 1: MindForge Enterprise Stabilization
 
 **Goal:** [To be planned]
 **Requirements**: TBD
@@ -7,4 +8,5 @@
 **Plans:** 0 plans
 
 Plans:
+
 - [ ] TBD (run /mindforge-plan-phase 1 to break down)

package/.planning/jira-sync.json

@@ -1,9 +1,5 @@
 {
-  "schema_version": "1.0.0",
-  "last_sync": null,
-  "project_key": null,
-  "phase_mappings": {},
-  "transition_cache": {},
-  "security_bugs": [],
-  "_warning": "Do not store credentials in this file."
+  "sync_status": "idle",
+  "last_sync": "",
+  "mappings": []
 }

package/.planning/slack-threads.json

@@ -1,6 +1,3 @@
 {
-  "schema_version": "1.0.0",
-  "channel_id": null,
-  "threads": {},
-  "_warning": "Do not store tokens in this file."
+  "threads": []
 }

package/CHANGELOG.md

@@ -1,27 +1,86 @@
 # Changelog
 
+## [2.3.5] — Intelligent Asset Sync & Merge — 2026-03-26
+
+🚀 **MindForge v2.3.5 — Intelligent Asset Sync & Merge**
+
+This release transforms the installation engine from a static "skip if exists" model to an intelligent "Merge & Sync" system, ensuring all framework assets, documentation, and advanced modules are correctly deployed even into existing project environments.
+
+### Added (v2.3.5)
+
+- **Intelligent Merging**: Refactored `copyDir` to support `noOverwrite` mode, allowing the installer to add missing subfolders and templates without disrupting user-customized files.
+- **Advanced Module Sync**: Added explicit path mapping for `memory`, `plugins`, `intelligence`, and `dashboard` modules into the standard installation payload.
+- **Expanded Asset Types**: Upgraded runtime definitions to include `memorySubdir` and `pluginsSubdir` for all supported IDE environments.
+
+### Fixed (v2.3.5)
+
+- **Sync Gating**: Removed restrictive directory existence checks that caused the installer to skip entire asset categories if the parent folder already existed.
+- **Documentation Parity**: Hardened the documentation sync logic to ensure `references/` and `templates/` always reach the `.agents/docs/` target.
+
+## [2.3.4] — Architectural Sync & Zero-GSD Purge — 2026-03-25
+
+### Added (v2.3.4)
+
+- **Comprehensive Planning Sync**: Expanded `.planning` deployment to include `ROADMAP.md`, `ARCHITECTURE.md`, `REQUIREMENTS.md`, and `RELEASE-CHECKLIST.md` by default.
+- **Zero-GSD Standard**: Completed the removal of all "GSD" instances from the installer logic and internal system identifiers.
+
+### Fixed (v2.3.4)
+
+- **Documentation Payload**: Fixed a discrepancy in the path-mapping for documentation subdirectories (`references/`, `templates/`) ensuring they correctly sync into `.agents/docs/`.
+- **Directory Persistence**: Ensured that empty planning subdirectories correctly persist with `.gitkeep` during fresh installations.
+
+## [2.3.3] — Payload Cleanup & Enterprise Pruning — 2026-03-25
+
+🚀 **MindForge v2.3.3 — Payload Cleanup & Enterprise Pruning**
+
+This release strictly prunes the installation payload to remove legacy GSD artifacts, project-specific state, and development-only folders, ensuring a clean "out-of-the-box" enterprise experience.
+
+### Fixed (v2.3.3)
+
+- **Installation Payload**: Removed legacy migration folders (`01-migrate-legacy-to-mindforge`, `day1`, `day2`, `day3`).
+- **State Leakage**: Excluded project-specific state files (`AUDIT.jsonl`, `HANDOFF.json`, `jira-sync.json`, `slack-threads.json`) from distribution.
+- **Enterprise Pruning**: Updated `installer-core.js` to automatically filter out development-only framework folders (e.g., `distribution`, `monorepo`, `production`).
+
+## [2.3.2] — Asset Sync Repair — 2026-03-25
+
+🚀 **MindForge v2.3.2 — Asset Sync Repair**
+
+This release fixes documentation asset synchronization and repairs logic corruption in the installer core.
+
+### Added (v2.3.2)
+
+- **Docs & Templates Sync**: Integrated `docs/references` and `docs/templates` into the standard installation payload.
+- **Recursive Counting**: Implemented deep directory file counting for accurate manifest reporting.
+
+### Fixed (v2.3.2)
+
+- **Installer Logic**: Repaired syntax corruption and removed duplicated code blocks in `installer-core.js`.
+
 ## [2.1.2] — Beast Mode Branding & CI Fix — 2026-03-25
 
 🚀 **MindForge v2.1.2 — Beast Mode Branding & CI Fix**
 
 This release transforms the MindForge installation experience with a high-impact "Beast Mode" CLI interface and resolves critical CI/CD integration issues.
 
-### Added
+### Added (v2.1.2)
+
 - **Beast Mode CLI Branding**: New ultra-blocky ASCII "MINDFORGE" branding and high-contrast "Digital Architect" design system.
 - **Payload Manifest Summary**: Architectural summary screen displaying dynamic counts of deployed Personas, Skills, and Integrations.
 - **"TRY IT NOW" Utility**: Boxed terminal widget providing immediate post-install command guidance.
 - **Enhanced Status Reporting**: Unified architectural status grid for environment detection.
 
-### Fixed
+### Fixed (v2.1.2)
+
 - **CI/CD Permissions**: Resolved `RequestError [HttpError]: GitHub Actions is not permitted to create or approve pull requests` by adding `contents: write` to `auto-pr.yml`.
 
 ## [2.1.1] — Core Migration Finalization — 2026-03-25
 
 🧩 **MindForge v2.1.1 — Core Migration Finalization**
 
-This release completes the structural rebranding and migration of the GSD framework into MindForge. It finalizes the path alignment for all 120+ assets, hardens the core configuration management, and fully integrates the expanded persona ecosystem.
+This release completes the structural rebranding and migration of the MindForge framework into MindForge. It finalizes the path alignment for all 120+ assets, hardens the core configuration management, and fully integrates the expanded persona ecosystem.
+
+### Added (v2.1.1)
 
-### Added
 - **Finalized Path Mapping**: All framework assets (skills, workflows, bin) now reside in a unified, flat `.agent/` structure for cross-IDE compatibility.
 - **32-Persona Ecosystem**: Full integration of 32 specialized engineering personas with defined tool permissions and capability matrices.
 - **Unified 4-Pillar Workflow**: Hardened `plan`, `execute`, `verify`, and `ship` logic with project-level `.agent/` integrity.
@@ -29,8 +88,9 @@ This release completes the structural rebranding and migration of the GSD framew
 - **Consolidated Configuration**: Unified framework settings and project-level governance in `.mindforge/` and `.agent/`.
 - **Rebranded Lifecycle Hooks**: 5 new high-performance hooks for context monitoring, prompt guarding, and real-time status updates.
 
-### Changed
-- **Zero-Watermark Integrity**: 100% elimination of residual "GSD" and "get-shit-done" identifiers from codebase, documentation, and metadata.
+### Changed (v2.1.1)
+
+- **Zero-Watermark Integrity**: 100% elimination of residual "MindForge" and "get-shit-done" identifiers from codebase, documentation, and metadata.
 - **Documentation Overhaul**: Modernized the entire documentation suite, including Architecture, Personas, Skills Authoring, and Command References.
 - **Hardened Settings**: `settings.json` now features dynamic hook pathing for increased portability across system environments.
 
@@ -38,7 +98,7 @@ This release completes the structural rebranding and migration of the GSD framew
 
 🧩 **MindForge v2.1.0 — The Specialized Expansion**
 
-This release significantly expands the MindForge persona ecosystem, integrating 18+ high-performance specialized agents from the GSD framework. This expansion doubles the framework's baseline capabilities in research, architecture, execution, and quality assurance.
+This release significantly expands the MindForge persona ecosystem, integrating 18+ high-performance specialized agents from the MindForge framework. This expansion doubles the framework's baseline capabilities in research, architecture, execution, and quality assurance.
 
 ### Added
 - **18+ New Specialized Personas**: Integration of advanced agents including `nyquist-auditor`, `user-profiler`, `advisor-researcher`, `ui-auditor`, and more.
@@ -48,7 +108,7 @@ This release significantly expands the MindForge persona ecosystem, integrating
 
 ### Changed
 - **Documentation Overhaul**: Complete update of `PERSONAS.md` and `Master-Context.md` to reflect the expanded ecosystem.
-- **Branding Alignment**: All integrated GSD personas rebranded and fully sanitized for MindForge native use.
+- **Branding Alignment**: All integrated MindForge personas rebranded and fully sanitized for MindForge native use.
 
 ---
 
@@ -65,7 +125,7 @@ This major release transforms MindForge from a Claude-centric framework into a u
 - **Unified Migration Engine (v2.0.0)**: Additive schema upgrades for `AUDIT.jsonl` (runtime/agent_id) and `token-usage.jsonl` (model_group).
 - **Hardened Self-Building Skills**: Automated skill capture from documentation and phase outputs.
 - **7-Dimension Quality Scorer**: Enhanced static analysis for skill authoring.
-- **GSD Integration**: 10 new advanced commands for design-first planning, zero-friction capture, and smart routing.
+- **MindForge Integration**: 10 new advanced commands for design-first planning, zero-friction capture, and smart routing.
 - **`/mindforge:do`**: Smart natural language dispatcher that routes intent to the correct command.
 - **`/mindforge:ui-phase` & `/mindforge:ui-review`**: Tier-1 visual design contract and visual audit engine.
 - **`/mindforge:note`**: Instant idea capture with todo promotion.

package/README.md

@@ -319,7 +319,7 @@ See `.mindforge/production/token-optimiser.md`.
 
 ## What's new in v2.1.1
 - **Unified 4-Pillar Workflow**: `plan`, `execute`, `verify`, `ship` now hardened with `.agent/` structural integrity.
-- **Expanded Persona Ecosystem**: 32+ specialized engineering personas integrated from the GSD core.
+- **Expanded Persona Ecosystem**: 32+ specialized engineering personas integrated from the MindForge core.
 - **Real-time Dashboard**: `/mindforge:dashboard` and high-performance web-based observability.
 - **Persistent Knowledge Graph**: `/mindforge:remember` and long-term project memory.
 - **Multi-Model Intelligence Layer**: `/mindforge:cross-review`, `/mindforge:research`, and `/mindforge:costs`.

package/RELEASENOTES.md

@@ -2,7 +2,7 @@
 
 ## Top Summary
 
-MindForge v2.1.1 is a major structural update that finalizes the migration of the GSD framework into the MindForge ecosystem. This release establishes a unified `.agent/` asset structure, expands the persona count from 8 to 32+, and hardens the 4-pillar workflow (`plan`, `execute`, `verify`, `ship`) for enterprise-scale AI orchestration.
+MindForge v2.1.1 is a major structural update that finalizes the migration of the MindForge framework into the MindForge ecosystem. This release establishes a unified `.agent/` asset structure, expands the persona count from 8 to 32+, and hardens the 4-pillar workflow (`plan`, `execute`, `verify`, `ship`) for enterprise-scale AI orchestration.
 
 ## Highlights
 

package/bin/installer-core.js

@@ -25,6 +25,9 @@ const RUNTIMES = {
     skillsSubdir:   'skills',
     hooksSubdir:    'hooks',
     personasSubdir: 'personas',
+    docsSubdir:     'docs',
+    memorySubdir:   'memory',
+    pluginsSubdir:  'plugins',
   },
   antigravity: {
     displayName:    'Antigravity',
@@ -36,6 +39,9 @@ const RUNTIMES = {
     skillsSubdir:   'skills',
     hooksSubdir:    'hooks',
     personasSubdir: 'personas',
+    docsSubdir:     'docs',
+    memorySubdir:   'memory',
+    pluginsSubdir:  'plugins',
   },
   cursor: {
     displayName:    'Cursor',
@@ -47,6 +53,9 @@ const RUNTIMES = {
     skillsSubdir:   'skills',
     hooksSubdir:    'hooks',
     personasSubdir: 'personas',
+    docsSubdir:     'docs',
+    memorySubdir:   'memory',
+    pluginsSubdir:  'plugins',
   },
   opencode: {
     displayName:    'OpenCode',
@@ -58,6 +67,9 @@ const RUNTIMES = {
     skillsSubdir:   'skills',
     hooksSubdir:    'hooks',
     personasSubdir: 'personas',
+    docsSubdir:     'docs',
+    memorySubdir:   'memory',
+    pluginsSubdir:  'plugins',
   },
   gemini: {
     displayName:    'Gemini CLI',
@@ -69,6 +81,9 @@ const RUNTIMES = {
     skillsSubdir:   'skills',
     hooksSubdir:    'hooks',
     personasSubdir: 'personas',
+    docsSubdir:     'docs',
+    memorySubdir:   'memory',
+    pluginsSubdir:  'plugins',
   },
   copilot: {
     displayName:    'GitHub Copilot',
@@ -137,9 +152,19 @@ const fsu = {
   ensureDir:  p  => { if (!fs.existsSync(p)) fs.mkdirSync(p, { recursive: true }); },
   copy:       (src, dst) => { fsu.ensureDir(path.dirname(dst)); fs.copyFileSync(src, dst); },
   listFiles:  p  => fs.existsSync(p) ? fs.readdirSync(p) : [],
+  listFilesRecursive: (p, ext = '.md') => {
+    if (!fs.existsSync(p)) return [];
+    let results = [];
+    for (const entry of fs.readdirSync(p, { withFileTypes: true })) {
+      const full = path.join(p, entry.name);
+      if (entry.isDirectory()) results = results.concat(fsu.listFilesRecursive(full, ext));
+      else if (entry.name.endsWith(ext)) results.push(full);
+    }
+    return results;
+  },
 
   copyDir(src, dst, options = {}) {
-    const { excludePatterns = [] } = options;
+    const { excludePatterns = [], noOverwrite = false } = options;
     fsu.ensureDir(dst);
     for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
       const skip = excludePatterns.some(pat =>
@@ -149,7 +174,12 @@ const fsu = {
 
       const s = path.join(src, entry.name);
       const d = path.join(dst, entry.name);
-      entry.isDirectory() ? fsu.copyDir(s, d, options) : fsu.copy(s, d);
+      if (entry.isDirectory()) {
+        fsu.copyDir(s, d, options);
+      } else {
+        if (noOverwrite && fsu.exists(d)) continue;
+        fsu.copy(s, d);
+      }
     }
   },
 };
@@ -198,11 +228,38 @@ const src         = (...parts) => path.join(SOURCE_ROOT, ...parts);
 const SENSITIVE_EXCLUDE = [
   '.env',        // exact filename match
   /^\.env\..*/,  // .env.local, .env.production, etc.
-  /\.key$/,      // anything ending in .key (previous glob was incorrect)
-  /\.pem$/,      // anything ending in .pem (previous glob was incorrect)
+  /\.key$/i,     // anything ending in .key
+  /\.pem$/i,     // anything ending in .pem
   'secrets',     // exact directory name
   '.secrets',    // exact directory name
-  /^secrets$/,   // exact match at directory level
+  /^secrets$/i,  // exact match at directory level
+  'node_modules',
+  '.git',
+  '.DS_Store',
+  'browser-daemon.log',
+  /audit\.jsonl/i,
+  /handoff\.json/i,
+  /jira-sync\.json/i,
+  /slack-threads\.json/i,
+  // Specific legacy or project-private folders
+  '01-migrate-legacy-to-mindforge',
+  'day1',
+  'day2',
+  'day3',
+  'research',
+  'screenshots',
+];
+
+// Special-case folders in .mindforge that are development-only
+const MINDFORGE_DEV_EXCLUDE = [
+  'distribution',
+  'monorepo',
+  'production',
+  'pr-review',
+  'skills-builder',
+  'ci',
+  'browser',
+  'audit'
 ];
 
 const norm = p => path.normalize(p);
@@ -296,7 +353,7 @@ async function install(runtime, scope, options = {}) {
   const baseDir = resolveBaseDir(runtime, scope);
   const cmdsDir = norm(path.join(baseDir, cfg.commandsSubdir));
   const selfInstall = isSelfInstall();
-  const targetDir = baseDir; // Define targetDir for the new printStatus line
+  const targetDir = baseDir;
 
   Theme.printPrompt(`Runtime : ${c.cyan(runtime)}`);
   Theme.printPrompt(`Scope   : ${c.dim(scope)} → ${c.bold(targetDir)}`);
@@ -313,15 +370,21 @@ async function install(runtime, scope, options = {}) {
     const assetMappings = [
       { key: 'skillsSubdir',   src: src('.agent', 'skills'),      label: 'skills' },
       { key: 'hooksSubdir',    src: src('.agent', 'hooks'),       label: 'hooks' },
-      { key: 'personasSubdir', src: src('.mindforge', 'personas'), label: 'personas' }
+      { key: 'personasSubdir', src: src('.mindforge', 'personas'), label: 'personas' },
+      { key: 'docsSubdir',     src: src('docs', 'references'),    label: 'references' },
+      { key: 'docsSubdir',     src: src('docs', 'templates'),     label: 'templates' }
     ];
 
     assetMappings.forEach(asset => {
       const subDir = cfg[asset.key];
       if (subDir && fsu.exists(asset.src)) {
-        const count = fsu.listFiles(asset.src).length;
-        const countStr = `${count} ${asset.label}`.padEnd(12);
-        console.log(`    ${countStr} → ${path.join(baseDir, subDir)}`);
+        if (asset.label === 'references' || asset.label === 'templates') {
+          console.log(`    ${asset.label.padEnd(12)} → ${path.join(baseDir, subDir, asset.label)}`);
+        } else {
+          const count = fsu.listFiles(asset.src).length;
+          const countStr = `${count} ${asset.label}`.padEnd(12);
+          console.log(`    ${countStr} → ${path.join(baseDir, subDir)}`);
+        }
       }
     });
     return;
@@ -436,17 +499,25 @@ async function install(runtime, scope, options = {}) {
     const assetTypes = [
       { key: 'skillsSubdir',   src: src('.agent', 'skills'),      label: 'skills' },
       { key: 'hooksSubdir',    src: src('.agent', 'hooks'),       label: 'hooks' },
-      { key: 'personasSubdir', src: src('.mindforge', 'personas'), label: 'personas' }
+      { key: 'personasSubdir', src: src('.mindforge', 'personas'), label: 'personas' },
+      { key: 'docsSubdir',     src: src('docs', 'references'),    label: 'references' },
+      { key: 'docsSubdir',     src: src('docs', 'templates'),     label: 'templates' },
+      { key: 'memorySubdir',   src: src('.mindforge', 'memory'),   label: 'memory' },
+      { key: 'pluginsSubdir',  src: src('.mindforge', 'plugins'),  label: 'plugins' }
     ];
 
     assetTypes.forEach(asset => {
       const subDir = cfg[asset.key];
       if (subDir && fsu.exists(asset.src)) {
-        const dstDir = path.join(baseDir, subDir);
+        let dstDir = path.join(baseDir, subDir);
+        // Documentation and templates go into subdirectories of their own
+        if (asset.label === 'references' || asset.label === 'templates') {
+          dstDir = path.join(dstDir, asset.label);
+        }
         fsu.ensureDir(dstDir);
         // Use copyDir for the whole directory
-        fsu.copyDir(asset.src, dstDir, { excludePatterns: SENSITIVE_EXCLUDE });
-        Theme.printResolved(`${c.bold(asset.label.padEnd(10))} (Enterprise sync)`);
+        fsu.copyDir(asset.src, dstDir, { excludePatterns: SENSITIVE_EXCLUDE, noOverwrite: !force });
+        Theme.printResolved(`${c.bold(asset.label.padEnd(12))} (Enterprise sync)`);
       }
     });
   }
@@ -457,51 +528,69 @@ async function install(runtime, scope, options = {}) {
     const forgeSrc = src('.mindforge');
     const forgeDst = path.join(process.cwd(), '.mindforge');
     if (fsu.exists(forgeSrc)) {
+      // Define all required enterprise framework folders
+      const standardFrameworkFolders = [
+        'engine', 'org', 'governance', 'integrations', 'personas', 'skills', 
+        'team', 'intelligence', 'memory', 'metrics', 'models', 'plugins', 'dashboard'
+      ];
+
       if (minimal) {
         const minimalEntries = new Set([
           'MINDFORGE-SCHEMA.json',
-          'engine',
-          'org',
-          'governance',
-          'integrations',
-          'personas',
-          'skills',
-          'team',
+          'engine', 'org', 'governance', 'integrations', 'personas', 'skills', 'team'
         ]);
         fsu.ensureDir(forgeDst);
         for (const entry of fs.readdirSync(forgeSrc, { withFileTypes: true })) {
           if (!minimalEntries.has(entry.name)) continue;
           const s = path.join(forgeSrc, entry.name);
           const d = path.join(forgeDst, entry.name);
-          entry.isDirectory() ? fsu.copyDir(s, d, { excludePatterns: SENSITIVE_EXCLUDE }) : fsu.copy(s, d);
+          if (entry.isDirectory()) {
+            fsu.copyDir(s, d, { excludePatterns: SENSITIVE_EXCLUDE, noOverwrite: true });
+          } else {
+            if (!fsu.exists(d) || force) fsu.copy(s, d);
+          }
         }
-        Theme.printResolved(`${c.bold('.mindforge/')} (minimal core)`);
+        Theme.printResolved(`${c.bold('.mindforge/')} (minimal sync)`);
       } else {
-        fsu.copyDir(forgeSrc, forgeDst, { excludePatterns: SENSITIVE_EXCLUDE });
-        Theme.printResolved(`${c.bold('.mindforge/')} (framework engine)`);
+        // Standard merge: Ensure missing folders are added, but don't overwrite existing user configs
+        fsu.copyDir(forgeSrc, forgeDst, { 
+          excludePatterns: [...SENSITIVE_EXCLUDE, ...MINDFORGE_DEV_EXCLUDE],
+          noOverwrite: !force 
+        });
+        Theme.printResolved(`${c.bold('.mindforge/')} (synchronized framework)`);
       }
     }
 
-    // .planning/ — create only if it doesn't already exist (preserve project state)
+    // .planning/ — merge templates but preserve existing state
     const planningDst = path.join(process.cwd(), '.planning');
-    if (!fsu.exists(planningDst)) {
-      const planningSrc = src('.planning');
-      if (fsu.exists(planningSrc)) {
-        if (minimal) {
-          fsu.ensureDir(planningDst);
-          ['STATE.md', 'HANDOFF.json', 'PROJECT.md'].forEach((name) => {
-            const s = path.join(planningSrc, name);
-            const d = path.join(planningDst, name);
-            if (fsu.exists(s)) fsu.copy(s, d);
-          });
-          console.log('  ✅  .planning/ (minimal state)');
-        } else {
-          fsu.copyDir(planningSrc, planningDst, { excludePatterns: SENSITIVE_EXCLUDE });
-          Theme.printResolved(`${c.bold('.planning/')} (state templates)`);
-        }
+    const planningSrc = src('.planning');
+    if (fsu.exists(planningSrc)) {
+      fsu.ensureDir(planningDst);
+      
+      // Define standard planning templates that must exist
+      const standardPlanningFiles = [
+        'STATE.md', 'HANDOFF.json', 'PROJECT.md', 
+        'ROADMAP.md', 'ARCHITECTURE.md', 'REQUIREMENTS.md', 
+        'RELEASE-CHECKLIST.md'
+      ];
+
+      // Always ensure top-level standard templates are copied if missing
+      standardPlanningFiles.forEach((name) => {
+        const s = path.join(planningSrc, name);
+        const d = path.join(planningDst, name);
+        if (fsu.exists(s) && (!fsu.exists(d) || force)) fsu.copy(s, d);
+      });
+
+      if (!minimal) {
+        // Merge subdirectories (empty ones persist via .gitkeep)
+        fsu.copyDir(planningSrc, planningDst, { 
+          excludePatterns: SENSITIVE_EXCLUDE,
+          noOverwrite: true 
+        });
+        Theme.printResolved(`${c.bold('.planning/')} (merged templates)`);
+      } else {
+        Theme.printResolved(`${c.bold('.planning/')} (minimal sync)`);
       }
-    } else {
-      Theme.printPrompt(c.dim('.planning/ already exists — preserved (run /mindforge:health to verify)'));
     }
 
     // MINDFORGE.md — create only if it doesn't already exist
@@ -573,17 +662,25 @@ function collectManifestStats() {
     skills: 0,
     governance: 0,
     integrations: 0,
-    actions: 0
+    actions: 0,
+    docs: 0,
+    templates: 0
   };
 
   try {
     const forgeSrc = src('.mindforge');
     if (fsu.exists(forgeSrc)) {
       stats.personas = fsu.listFiles(path.join(forgeSrc, 'personas')).filter(f => f.endsWith('.md')).length;
-      stats.skills = fsu.listFiles(path.join(forgeSrc, 'skills')).length;
+      stats.skills = fsu.listFiles(path.join(SOURCE_ROOT, '.agent', 'skills')).length;
       stats.governance = fsu.listFiles(path.join(forgeSrc, 'governance')).filter(f => f.endsWith('.md')).length;
       stats.integrations = fsu.listFiles(path.join(forgeSrc, 'integrations')).filter(f => f.endsWith('.md')).length;
     }
+
+    // Docs & Templates count
+    const refSrc = src('docs', 'references');
+    const tmpSrc = src('docs', 'templates');
+    if (fsu.exists(refSrc)) stats.docs = fsu.listFiles(refSrc).filter(f => f.endsWith('.md')).length;
+    if (fsu.exists(tmpSrc)) stats.templates = fsu.listFilesRecursive(tmpSrc).length;
     
     // Commands count
     const claudeCmdSrc = src('.claude', 'commands', 'mindforge');
@@ -596,7 +693,7 @@ function collectManifestStats() {
     }
   } catch (e) {
     // Fallback to default values if counting fails
-    return { personas: 32, skills: 10, governance: 4, integrations: 6, actions: 60 };
+    return { personas: 32, skills: 10, governance: 4, integrations: 6, actions: 60, docs: 12, templates: 5 };
   }
 
   return stats;

package/bin/wizard/theme.js

@@ -121,7 +121,7 @@ const Theme = {
    * Print Manifest (Hardened for V2)
    */
   printManifest(stats = {}) {
-    const { personas = 32, skills = 12, governance = 4, integrations = 7, actions = 60 } = stats;
+    const { personas = 32, skills = 12, governance = 4, integrations = 7, actions = 60, docs = 12, templates = 8 } = stats;
     
     console.log(`  ${this.colors.bold('PAYLOAD MANIFEST')}`);
     console.log(`  ${this.colors.dim('┌' + '─'.repeat(74) + '┐')}`);
@@ -131,6 +131,8 @@ const Theme = {
       ['SKILLS', skills, 'Enterprise-grade skill packs'],
       ['GOVERNANCE', governance, 'Compliance and safety modules'],
       ['INTEGRATIONS', integrations, 'Multi-platform connector suite'],
+      ['REFERENCES', docs, 'Standardized architecture references'],
+      ['TEMPLATES', templates, 'Engineering and planning templates'],
       ['ACTIONS', actions, 'Total autonomous commands deployed'],
     ];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindforge-cc",
-  "version": "2.3.0",
+  "version": "2.3.5",
   "description": "MindForge - Enterprise Agentic Framework for Claude Code and Antigravity",
   "bin": {
     "mindforge-cc": "bin/install.js"

package/.planning/approvals/v2-architecture-approval.json

@@ -1,15 +0,0 @@
-{
-  "id": "MF-AUTH-V2-001",
-  "project": "MindForge",
-  "version": "2.0.0-alpha.2",
-  "tier": 3,
-  "approved_by": "Antigravity (Agentic AI)",
-  "timestamp": "2026-03-22T20:28:00Z",
-  "scope": [
-    ".github/workflows/*",
-    "bin/mindforge-cli.js",
-    "bin/change-classifier.js"
-  ],
-  "reason": "Implementation of 5-Layer Plane Architecture and standardized CLI routing.",
-  "signature": "sha256:d8e8fca2dc0f896fd7cb4cb0031ba249"
-}