mindforge-cc 1.0.3 → 1.0.5

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 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
+- Antigravity local install now correctly copies commands and CLAUDE.md into `agents/`.
+
 ## [1.0.3] — v1.0.3 Antigravity Agents Folder — 2026-03-22
 
 ### Changed

package/README.md

@@ -42,6 +42,16 @@ npx mindforge-cc@latest --antigravity --global
 
 Local installs use `agents/` by default. Legacy `.agent/` is supported for existing projects.
 
+Optional: add bin utilities on local install
+```bash
+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
+ * 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',
+  '--skip-wizard', '--dry-run', '--with-utils', '--minimal',
 ];
 
 const IS_NON_INTERACTIVE =
@@ -102,6 +102,8 @@ function printHelp() {
     --dry-run         Show what would happen without making changes
     --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 } = 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));
@@ -168,7 +174,7 @@ async function install(runtime, scope, options = {}) {
   // ── 1. Install CLAUDE.md ────────────────────────────────────────────────────
   const claudeSrc = runtime === 'claude'
     ? src('.claude', 'CLAUDE.md')
-    : src('.agents', 'CLAUDE.md');
+    : src('.agent', 'CLAUDE.md');
 
   if (fsu.exists(claudeSrc)) {
     safeCopyClaude(claudeSrc, path.join(baseDir, 'CLAUDE.md'), { force, verbose });
@@ -178,7 +184,7 @@ async function install(runtime, scope, options = {}) {
   // ── 2. Install commands ─────────────────────────────────────────────────────
   const cmdSrc = runtime === 'claude'
     ? src('.claude', 'commands', 'mindforge')
-    : src('.agents', 'mindforge');
+    : src('.agent', 'mindforge');
 
   if (fsu.exists(cmdSrc)) {
     fsu.ensureDir(cmdsDir);
@@ -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)`);
@@ -217,13 +254,18 @@ async function install(runtime, scope, options = {}) {
       console.log(`  ✅  MINDFORGE.md (project constitution)`);
     }
 
-    // bin/ utilities (validate-config, wizard)
-    const binDst = path.join(process.cwd(), 'bin');
-    const binSrc = src('bin');
-    if (fsu.exists(binSrc) && !fsu.exists(binDst)) {
-      fsu.copyDir(binSrc, binDst, { excludePatterns: SENSITIVE_EXCLUDE });
-      console.log(`  ✅  bin/ (utilities)`);
+    // bin/ utilities (optional)
+    if (withUtils) {
+      const binDst = path.join(process.cwd(), 'bin');
+      const binSrc = src('bin');
+      if (fsu.exists(binSrc) && !fsu.exists(binDst)) {
+        fsu.copyDir(binSrc, binDst, { excludePatterns: SENSITIVE_EXCLUDE });
+        console.log(`  ✅  bin/ (utilities)`);
+      } else if (fsu.exists(binDst)) {
+        console.log(`  ⏭️  bin/ already exists — preserved`);
+      }
     }
+
   }
 
   // ── 4. Verify installation ──────────────────────────────────────────────────
@@ -273,10 +315,12 @@ async function run(args) {
   const dryRun     = args.includes('--dry-run');
   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 };
+  const options     = { dryRun, force, verbose, withUtils, minimal };
 
   console.log(`\n⚡  MindForge v${VERSION} — Enterprise Agentic Framework\n`);
 

package/bin/wizard/setup-wizard.js

@@ -48,6 +48,16 @@ function askChoice(rl, q, choices, defaultIdx = 0) {
   });
 }
 
+function askYesNo(rl, q, defaultYes = false) {
+  const def = defaultYes ? 'y' : 'n';
+  return new Promise((resolve) => {
+    rl.question(`${q} [${def}]: `, (answer) => {
+      const val = (answer.trim() || def).toLowerCase();
+      resolve(val === 'y' || val === 'yes');
+    });
+  });
+}
+
 function askMultiChoice(rl, q, choices) {
   console.log(`\n${q}`);
   choices.forEach((choice, i) => console.log(`  ${i + 1}) ${choice}`));
@@ -149,11 +159,11 @@ async function configureFeatures(rl) {
   return { config, credGuidance };
 }
 
-async function install(runtimes, scope) {
+async function install(runtimes, scope, options = {}) {
   const installer = require('../installer-core');
   if (!installer || typeof installer.install !== 'function') return;
   for (const runtime of runtimes) {
-    await installer.install(runtime, scope);
+    await installer.install(runtime, scope, options);
   }
 }
 
@@ -222,9 +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);
+    await install(runtimes, scope, { withUtils, minimal });
     await generator.writeIntegrationsConfig(config);
     printNextSteps(runtimes, scope, credGuidance);
   } catch (err) {

package/docs/user-guide.md

@@ -15,6 +15,16 @@ npx mindforge-cc@latest --claude --global
 npx mindforge-cc@latest --claude --local
 ```
 
+Optional utilities:
+```bash
+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.3",
+  "version": "1.0.5",
   "description": "MindForge - Enterprise Agentic Framework for Claude Code and Antigravity",
   "bin": {
     "mindforge-cc": "bin/install.js"