mindforge-cc 1.0.2 → 1.0.4

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.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
+- Local Antigravity installs now target `agents/` by default (legacy `.agent/` detected and supported).
+
 ## [1.0.2] — v1.0.2 CLI Bin Fix — 2026-03-22
 
 ### Fixed

package/README.md

@@ -40,6 +40,13 @@ npx mindforge-cc@latest --claude --local
 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
+```
+
 ### 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
  */
 
 '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',
 ];
 
 const IS_NON_INTERACTIVE =
@@ -85,7 +85,7 @@ function printHelp() {
 
   RUNTIMES (pick one or use --all)
     --claude          Claude Code  (~/.claude or .claude/)
-    --antigravity     Antigravity  (~/.gemini/antigravity or .agent/)
+    --antigravity     Antigravity  (~/.gemini/antigravity or agents/; .agent/ legacy)
     --all             Both runtimes
 
   SCOPE
@@ -102,6 +102,7 @@ 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)
     --verbose         Detailed output
     --version, -v     Print version
     --help, -h        Print this help

package/bin/installer-core.js

@@ -20,7 +20,7 @@ const RUNTIMES = {
   },
   antigravity: {
     globalDir:      path.join(os.homedir(), '.gemini', 'antigravity'),
-    localDir:       '.agents',
+    localDir:       'agents',
     commandsSubdir: 'mindforge',
     entryFile:      'CLAUDE.md',
   },
@@ -79,6 +79,24 @@ const SENSITIVE_EXCLUDE = [
 
 const norm = p => path.normalize(p);
 
+function resolveBaseDir(runtime, scope) {
+  const cfg = RUNTIMES[runtime];
+  if (scope === 'global') return norm(cfg.globalDir);
+
+  if (runtime === 'antigravity') {
+    const agentsDir = norm(path.join(process.cwd(), 'agents'));
+    const legacyAgentDir = norm(path.join(process.cwd(), '.agent'));
+    if (fsu.exists(agentsDir)) return agentsDir;
+    if (fsu.exists(legacyAgentDir)) {
+      console.log(`  ℹ️  Detected legacy .agent/ — installing there for compatibility`);
+      return legacyAgentDir;
+    }
+    return agentsDir;
+  }
+
+  return norm(path.join(process.cwd(), cfg.localDir));
+}
+
 // ── CLAUDE.md safe copy ───────────────────────────────────────────────────────
 function safeCopyClaude(src, dst, options = {}) {
   const { force = false, verbose = false } = options;
@@ -129,9 +147,9 @@ 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 } = options;
   const cfg     = RUNTIMES[runtime];
-  const baseDir = norm(scope === 'global' ? cfg.globalDir : path.join(process.cwd(), cfg.localDir));
+  const baseDir = resolveBaseDir(runtime, scope);
   const cmdsDir = norm(path.join(baseDir, cfg.commandsSubdir));
   const selfInstall = isSelfInstall();
 
@@ -150,7 +168,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 });
@@ -160,7 +178,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);
@@ -199,13 +217,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 ──────────────────────────────────────────────────
@@ -217,7 +240,7 @@ async function install(runtime, scope, options = {}) {
 async function uninstall(runtime, scope, options = {}) {
   const { dryRun = false } = options;
   const cfg     = RUNTIMES[runtime];
-  const baseDir = norm(scope === 'global' ? cfg.globalDir : path.join(process.cwd(), cfg.localDir));
+  const baseDir = resolveBaseDir(runtime, scope);
   const cmdsDir = norm(path.join(baseDir, cfg.commandsSubdir));
   const claudeMd = norm(path.join(baseDir, 'CLAUDE.md'));
 
@@ -255,10 +278,11 @@ 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 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 };
 
   console.log(`\n⚡  MindForge v${VERSION} — Enterprise Agentic Framework\n`);
 

package/bin/wizard/environment-detector.js

@@ -26,7 +26,13 @@ async function detect() {
 
   const runtimes = [];
   if (fs.existsSync(path.join(home, '.claude')) || fs.existsSync(path.join(cwd, '.claude'))) runtimes.push('claude');
-  if (fs.existsSync(path.join(home, '.gemini', 'antigravity')) || fs.existsSync(path.join(cwd, '.agent'))) runtimes.push('antigravity');
+  if (
+    fs.existsSync(path.join(home, '.gemini', 'antigravity')) ||
+    fs.existsSync(path.join(cwd, '.agent')) ||
+    fs.existsSync(path.join(cwd, 'agents'))
+  ) {
+    runtimes.push('antigravity');
+  }
 
   let projectType = 'unknown';
   const pkgPath = path.join(cwd, 'package.json');

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,10 @@ async function main() {
     const runtimes = await selectRuntime(rl, env.runtimes);
     const scope = await selectScope(rl);
     const { config, credGuidance } = await configureFeatures(rl);
+    const withUtils = await askYesNo(rl, 'Install optional bin/ utilities?', false);
     rl.close();
 
-    await install(runtimes, scope);
+    await install(runtimes, scope, { withUtils });
     await generator.writeIntegrationsConfig(config);
     printNextSteps(runtimes, scope, credGuidance);
   } catch (err) {

package/docs/user-guide.md

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

package/package.json

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