mindforge-cc 1.0.4 → 1.0.5

package/CHANGELOG.md

@@ -3,6 +3,11 @@
 All notable changes to MindForge are documented here.
 Format follows [Keep a Changelog](https://keepachangelog.com).
 
+## [1.0.5] — v1.0.5 Minimal Install Option — 2026-03-22
+
+### Added
+- `--minimal` flag to install only essential project scaffolding.
+
 ## [1.0.4] — v1.0.4 Antigravity Install Fix — 2026-03-22
 
 ### Fixed

package/README.md

@@ -47,6 +47,11 @@ Optional: add bin utilities on local install
 npx mindforge-cc@latest --claude --local --with-utils
 ```
 
+Optional: minimal project scaffolding
+```bash
+npx mindforge-cc@latest --claude --local --minimal
+```
+
 ### Both runtimes
 ```bash
 npx mindforge-cc@latest --all --global

package/bin/install.js

@@ -15,7 +15,7 @@
  * Runtime flags:    --claude | --antigravity | --all
  * Scope flags:      --global (-g) | --local (-l)
  * Action flags:     --install (default) | --update | --uninstall | --check
- * Control flags:    --skip-wizard | --dry-run | --verbose | --force | --with-utils
+ * Control flags:    --skip-wizard | --dry-run | --verbose | --force | --with-utils | --minimal
  */
 
 'use strict';
@@ -53,7 +53,7 @@ const NON_INTERACTIVE_FLAGS = [
   '--claude', '--antigravity', '--all',
   '--global', '-g', '--local', '-l',
   '--uninstall', '--update', '--check',
-  '--skip-wizard', '--dry-run', '--with-utils',
+  '--skip-wizard', '--dry-run', '--with-utils', '--minimal',
 ];
 
 const IS_NON_INTERACTIVE =
@@ -103,6 +103,7 @@ function printHelp() {
     --force           Override existing installation without backup
     --skip-wizard     Skip interactive wizard even in TTY
     --with-utils      Install local bin/ utilities (optional)
+    --minimal         Install only essential project scaffolding
     --verbose         Detailed output
     --version, -v     Print version
     --help, -h        Print this help

package/bin/installer-core.js

@@ -147,7 +147,13 @@ function verifyInstall(baseDir, cmdsDir, runtime, scope) {
 
 // ── Install single runtime ────────────────────────────────────────────────────
 async function install(runtime, scope, options = {}) {
-  const { dryRun = false, force = false, verbose = false, withUtils = false } = options;
+  const {
+    dryRun = false,
+    force = false,
+    verbose = false,
+    withUtils = false,
+    minimal = false,
+  } = options;
   const cfg     = RUNTIMES[runtime];
   const baseDir = resolveBaseDir(runtime, scope);
   const cmdsDir = norm(path.join(baseDir, cfg.commandsSubdir));
@@ -193,8 +199,29 @@ async function install(runtime, scope, options = {}) {
     const forgeSrc = src('.mindforge');
     const forgeDst = path.join(process.cwd(), '.mindforge');
     if (fsu.exists(forgeSrc)) {
-      fsu.copyDir(forgeSrc, forgeDst, { excludePatterns: SENSITIVE_EXCLUDE });
-      console.log(`  ✅  .mindforge/ (framework engine)`);
+      if (minimal) {
+        const minimalEntries = new Set([
+          'MINDFORGE-SCHEMA.json',
+          '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);
+        }
+        console.log(`  ✅  .mindforge/ (minimal core)`);
+      } else {
+        fsu.copyDir(forgeSrc, forgeDst, { excludePatterns: SENSITIVE_EXCLUDE });
+        console.log(`  ✅  .mindforge/ (framework engine)`);
+      }
     }
 
     // .planning/ — create only if it doesn't already exist (preserve project state)
@@ -202,8 +229,18 @@ async function install(runtime, scope, options = {}) {
     if (!fsu.exists(planningDst)) {
       const planningSrc = src('.planning');
       if (fsu.exists(planningSrc)) {
-        fsu.copyDir(planningSrc, planningDst, { excludePatterns: SENSITIVE_EXCLUDE });
-        console.log(`  ✅  .planning/ (state templates)`);
+        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 });
+          console.log(`  ✅  .planning/ (state templates)`);
+        }
       }
     } else {
       console.log(`  ⏭️  .planning/ already exists — preserved (run /mindforge:health to verify)`);
@@ -279,10 +316,11 @@ async function run(args) {
   const force      = args.includes('--force');
   const verbose    = args.includes('--verbose');
   const withUtils  = args.includes('--with-utils');
+  const minimal    = args.includes('--minimal');
   const isUninstall = args.includes('--uninstall');
   const isUpdate    = args.includes('--update');
   const isCheck     = args.includes('--check');
-  const options     = { dryRun, force, verbose, withUtils };
+  const options     = { dryRun, force, verbose, withUtils, minimal };
 
   console.log(`\n⚡  MindForge v${VERSION} — Enterprise Agentic Framework\n`);
 

package/bin/wizard/setup-wizard.js

@@ -232,10 +232,11 @@ async function main() {
     const runtimes = await selectRuntime(rl, env.runtimes);
     const scope = await selectScope(rl);
     const { config, credGuidance } = await configureFeatures(rl);
+    const minimal = await askYesNo(rl, 'Install minimal project scaffolding?', false);
     const withUtils = await askYesNo(rl, 'Install optional bin/ utilities?', false);
     rl.close();
 
-    await install(runtimes, scope, { withUtils });
+    await install(runtimes, scope, { withUtils, minimal });
     await generator.writeIntegrationsConfig(config);
     printNextSteps(runtimes, scope, credGuidance);
   } catch (err) {

package/docs/user-guide.md

@@ -20,6 +20,11 @@ Optional utilities:
 npx mindforge-cc@latest --claude --local --with-utils
 ```
 
+Minimal scaffolding:
+```bash
+npx mindforge-cc@latest --claude --local --minimal
+```
+
 ### Antigravity
 ```bash
 npx mindforge-cc@latest --antigravity --global

package/package.json

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