mindforge-cc 2.2.0 → 2.3.5

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',
@@ -104,6 +119,31 @@ function generateEntryContent(runtime, sourceContent) {
   return sourceContent;
 }
 
+/**
+ * Extract an enterprise-grade description from command markdown.
+ * Prioritizes YAML frontmatter 'description' field, then falls back to first non-empty text.
+ */
+function getCommandDescription(content) {
+  // Check for YAML frontmatter
+  const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
+  if (frontmatterMatch) {
+    const frontmatter = frontmatterMatch[1];
+    const descMatch = frontmatter.match(/^description:\s*(.*)$/m);
+    if (descMatch) return descMatch[1].trim();
+  }
+
+  // Fallback to first non-empty, non-header line
+  const lines = content.split('\n');
+  for (let line of lines) {
+    line = line.trim();
+    if (line && !line.startsWith('#') && !line.startsWith('---')) {
+      return line.length > 100 ? line.substring(0, 97) + '...' : line;
+    }
+  }
+
+  return 'No description available';
+}
+
 // ── File system utilities ─────────────────────────────────────────────────────
 const fsu = {
   exists:     p  => fs.existsSync(p),
@@ -112,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 =>
@@ -124,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);
+      }
     }
   },
 };
@@ -173,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);
@@ -271,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)}`);
@@ -288,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;
@@ -350,40 +438,59 @@ async function install(runtime, scope, options = {}) {
   }
 
   // ── 2. Install commands ─────────────────────────────────────────────────────
-  const cmdSrc = runtime === 'claude'
-    ? src('.claude', 'commands', 'mindforge')
-    : src('.agent', 'mindforge');
+  const cmdSources = [
+    { src: src('.agent', 'mindforge'), namespace: 'mindforge' },
+    { src: src('.agent', 'forge'),     namespace: 'forge' }
+  ];
 
-  if (fsu.exists(cmdSrc)) {
+  if (runtime === 'claude') {
+    // Claude Code specifically looks in .claude/commands/mindforge
+    cmdSources.length = 0;
+    cmdSources.push({ src: src('.claude', 'commands', 'mindforge'), namespace: 'mindforge' });
+  }
+
+  let totalCount = 0;
+  cmdSources.forEach(source => {
+    if (!fsu.exists(source.src)) return;
+
+    const files = fsu.listFiles(source.src).filter(f => f.endsWith('.md'));
+    totalCount += files.length;
     fsu.ensureDir(cmdsDir);
-    const files = fsu.listFiles(cmdSrc).filter(f => f.endsWith('.md'));
-    // Install for specific runtime
+
     files.forEach(f => {
-      const targetName = runtime === 'antigravity' ? `mindforge:${f}` : f;
-      const srcPath = path.join(cmdSrc, f);
+      // Logic for naming: antigravity uses namespace:prefix, others use just the file name
+      const targetName = runtime === 'antigravity' ? `${source.namespace}:${f}` : f;
+      const srcPath = path.join(source.src, f);
       const dstPath = path.join(cmdsDir, targetName);
 
       if (runtime === 'antigravity') {
         const content = fsu.read(srcPath);
-        const firstLine = content.split('\n')[0].trim();
-        // Mandatory Antigravity frontmatter metadata
-        const metadata = `---\ndescription: ${firstLine}\n---\n`;
-        fsu.write(dstPath, metadata + content);
+        const description = getCommandDescription(content);
+        const metadata = `---\ndescription: ${description}\n---\n`;
+        
+        // Strip existing frontmatter from source when injecting into Antigravity
+        const cleanContent = content.replace(/^---\s*\n[\s\S]*?\n---\s*\n/, '');
+        fsu.write(dstPath, metadata + cleanContent);
       } else {
         fsu.copy(srcPath, dstPath);
       }
     });
 
-    // ✨ STANDARD: Mirror to .claude/commands for cross-IDE compatibility (Cursor/Windsurf/Claude Code)
+    // Mirror to .claude/commands for cross-IDE compatibility (Cursor/Windsurf/Claude Code)
     if (scope === 'local' && runtime !== 'claude' && !selfInstall) {
-      const standardCmdDir = path.join(process.cwd(), '.claude', 'commands', 'mindforge');
+      const standardCmdDir = path.join(process.cwd(), '.claude', 'commands', source.namespace);
       fsu.ensureDir(standardCmdDir);
       files.forEach(f => {
-        fsu.copy(path.join(cmdSrc, f), path.join(standardCmdDir, f));
+        fsu.copy(path.join(source.src, f), path.join(standardCmdDir, f));
       });
-      Theme.printResolved(`${c.bold(files.length)} commands (Mirrored to .claude/commands/mindforge/)`);
+    }
+  });
+
+  if (totalCount > 0) {
+    if (scope === 'local' && runtime !== 'claude' && !selfInstall) {
+      Theme.printResolved(`${c.bold(totalCount)} commands (Mirrored to .claude/commands/)`);
     } else {
-      Theme.printResolved(`${c.bold(files.length)} commands`);
+      Theme.printResolved(`${c.bold(totalCount)} commands`);
     }
   }
 
@@ -392,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)`);
       }
     });
   }
@@ -413,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
@@ -529,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');
@@ -552,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

@@ -59,7 +59,7 @@ const Theme = {
    */
   printBrandManifest() {
     console.log(`  ${this.colors.dim('│')}`);
-    console.log(`  ${this.colors.dim('│')}  ${this.colors.green('🎉 V2.2.0 IS HERE!')} Welcome to MindForge V2!`);
+    console.log(`  ${this.colors.dim('│')}  ${this.colors.green('🎉 V2.3.0 IS HERE!')} Welcome to MindForge V2!`);
     console.log(`  ${this.colors.dim('│')}`);
     console.log(`  ${this.colors.dim('│')}  ${this.colors.bold('THE PLATFORM VISION:')}`);
     console.log(`  ${this.colors.dim('│')}    - Unified Enterprise Agentic Ecosystem`);
@@ -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.2.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"
-}