contextos-agents 1.6.1 → 2.0.0-beta.2

package/bin/index.js

@@ -4,6 +4,9 @@ const fs = require('fs');
 const path = require('path');
 const { version } = require('../package.json');
 const profiles = require('../.agents/profiles.js');
+const { isKnownCommand, getStatus, formatStatusText } = require('./commands.js');
+const { detectProjectAttributes } = require('./lib/detector.js');
+const lockfileLib = require('./lib/lockfile.js');
 
 // ── CLI argument parsing ──────────────────────────────────────────────────────
 const args = process.argv.slice(2);
@@ -15,7 +18,12 @@ const flags = {
   skipCompile: args.includes('--skip-compile'),
   auto:        args.includes('--auto'),
   minimal:     args.includes('--minimal'),
+  json:        args.includes('--json'),
   withMcp:     args.includes('--with-mcp') || args.includes('--mcp'),
+  agent:       (() => {
+    const i = args.indexOf('--agent');
+    return i !== -1 ? args[i + 1] : null;
+  })(),
   profile:     (() => {
     const i = args.indexOf('--profile');
     return i !== -1 ? args[i + 1] : null;
@@ -28,7 +36,11 @@ const flags = {
 
 // ── Help / Version ────────────────────────────────────────────────────────────
 if (flags.ver) {
-  console.log(`contextos-agents v${version}`);
+  if (flags.json) {
+    console.log(JSON.stringify({ package: 'contextos-agents', version }));
+  } else {
+    console.log(`contextos-agents v${version}`);
+  }
   process.exit(0);
 }
 
@@ -38,33 +50,41 @@ contextos / contextos-agents v${version}
 Install AI assistant skills and rules into your project.
 
 Usage:
-  npx contextos [options]
+  npx contextos-agents init [options]
+  npx contextos-agents <command> [args...]
   contextos <command> [args...]
 
 Options:
   --help, -h          Show this help message
   --version, -v       Show version number
+  --json              Output machine-readable JSON format
+  --agent <name>      Target AI agent or IDE (gemini, claude, cursor, auto)
   --dry-run           Preview what will be copied without making changes
   --force             Overwrite an existing .agents/ folder
-  --minimal           Install only 5 core skills (lightweight footprint)
+  --minimal           Install only 7 core skills (lightweight footprint)
   --profile <name>    Install a specific profile (mvp, startup, enterprise, frontend, backend)
   --auto              Auto-detect tech stack and apply recommended profile
-  --with-mcp, --mcp   Install with MCP execution server enabled (.agents/mcp/ & mcp_config.json)
+  --with-mcp, --mcp   [DEPRECATED] Use the separate @contextos/mcp package instead
   --skip-compile      Skip running ctx.js export after installation
   --add-skill <ref>   Install a community plugin skill after setup
 
 Commands:
+  init                Install and configure .agents/ in target project
+  status              Display project configuration, active profile, and lockfile status
+  update              Safely update skills without overwriting custom changes
+  uninstall           Safely uninstall ContextOS files (preserves user custom skills)
   doctor              Run full project diagnostic health check
   audit               Validate local skills (alias for validate)
   validate            Validate local skills, frontmatter, and sync
+  compile             Compile skill manifests into deterministic registry v2
   profile <subcmd>    Manage profiles (list, apply, show, remove)
   export <target>     Export skills (gemini, claude, cursor, copilot, aider, zed, all)
   resolve <prompt>    Dynamically resolve minimal skills for a prompt or files
   stats               Display token context savings report
   watch               Start continuous file watcher and auto-sync daemon
-  detect              Analyze project and display detected tech stack
+  detect              Analyze project and display detected tech stack & IDE
   install-skill       Interactive skill installer (or pass <ref> / --from-repo)
-  setup-mcp           Add MCP execution server to an existing .agents/ project
+  setup-mcp           [DEPRECATED] Add MCP execution server to an existing .agents/ project
 
 Profiles:
   mvp                 Fastest shipping, minimalist monolith, excludes microservices & DDD
@@ -82,12 +102,12 @@ Plugin ref formats:
   @scope/npm-package               A scoped npm skill package
 
 Examples:
-  npx contextos                                 Install .agents/ into current project
-  npx contextos --minimal                       Install only 5 core essential skills
-  npx contextos --profile startup               Install with startup profile
-  contextos doctor                              Run project health check
-  contextos export gemini                       Compile skills for Gemini
-  contextos profile list                        List available profiles
+  npx contextos-agents init                     Install .agents/ with auto-detected stack
+  npx contextos-agents init --agent auto        Install and configure for detected stack & IDE
+  npx contextos-agents init --minimal           Install only 7 core essential skills
+  npx contextos status                          Show project configuration and lockfile status
+  npx contextos doctor                          Run project health check
+  npx contextos export gemini                   Compile skills for Gemini
 `);
   process.exit(0);
 }
@@ -95,10 +115,146 @@ Examples:
 // ── Top-level Commands & Proxy Routing ────────────────────────────────────────
 const mainCommand = args[0] && !args[0].startsWith('-') ? args[0] : null;
 
+// Unknown command check
+if (mainCommand && mainCommand !== 'init' && !isKnownCommand(mainCommand)) {
+  if (flags.json) {
+    console.error(JSON.stringify({ error: `Unknown command: ${mainCommand}`, code: 1 }));
+  } else {
+    console.error(`[ERROR] Unknown command: ${mainCommand}`);
+    console.error('        Run `npx contextos-agents --help` to view available commands.');
+  }
+  process.exit(1);
+}
+
+// Status command
+if (mainCommand === 'status') {
+  const status = getStatus(process.cwd());
+  if (flags.json) {
+    console.log(JSON.stringify(status, null, 2));
+  } else {
+    console.log(formatStatusText(status));
+  }
+  process.exit(0);
+}
+
+// Detect command
+if (mainCommand === 'detect') {
+  const { WorkspaceGraphBuilder } = require('../.agents/workspace/workspace-graph.js');
+  const scopeIdx = args.indexOf('--scope');
+  const scopeArg = scopeIdx !== -1 && args[scopeIdx + 1] && !args[scopeIdx + 1].startsWith('--')
+    ? args[scopeIdx + 1]
+    : (args.find(a => a.startsWith('--scope=')) || '').split('=')[1];
+  const explain = args.includes('--explain');
+
+  const builder = new WorkspaceGraphBuilder();
+  const graph = builder.build(process.cwd());
+
+  if (scopeArg) {
+    const nearestPkg = builder.findNearestPackage(scopeArg, graph);
+    const evidence = builder.extractPackageEvidence(scopeArg, graph);
+
+    if (flags.json) {
+      console.log(JSON.stringify({
+        scope: scopeArg,
+        nearestPackage: nearestPkg,
+        evidence,
+      }, null, 2));
+    } else {
+      console.log('\n══════════════════════════════════════════');
+      console.log('  ContextOS — Workspace Scoped Detection');
+      console.log('══════════════════════════════════════════\n');
+      console.log(`  Scope Path       : ${scopeArg}`);
+      if (nearestPkg) {
+        console.log(`  Nearest Package  : ${nearestPkg.id} (${nearestPkg.ecosystem})`);
+        console.log(`  Package Root     : ${nearestPkg.root}`);
+        console.log(`  Languages        : ${nearestPkg.languages.join(', ') || 'unspecified'}`);
+        console.log(`  Dependencies     : ${nearestPkg.dependencies.length} (${nearestPkg.dependencies.slice(0, 8).join(', ')}${nearestPkg.dependencies.length > 8 ? '...' : ''})`);
+        console.log(`  Configs          : ${nearestPkg.configs.join(', ') || 'none'}`);
+        if (nearestPkg.internalDependencies.length > 0) {
+          console.log(`  Internal Links   : ${nearestPkg.internalDependencies.join(', ')}`);
+        }
+        if (evidence.length > 0) {
+          console.log('\n  Scoped Evidence:');
+          for (const ev of evidence.slice(0, 10)) {
+            console.log(`    • [${ev.source}] ${ev.target} (+${ev.weight}) — ${ev.description}`);
+          }
+          if (evidence.length > 10) {
+            console.log(`      ... and ${evidence.length - 10} more signals`);
+          }
+        }
+      } else {
+        console.log('  Nearest Package  : (none found)');
+      }
+      console.log('\n──────────────────────────────────────────\n');
+    }
+  } else if (flags.json) {
+    const detection = detectProjectAttributes(process.cwd());
+    console.log(JSON.stringify({
+      ...detection,
+      workspaceGraph: graph,
+    }, null, 2));
+  } else if (explain) {
+    console.log('\n══════════════════════════════════════════');
+    console.log('  ContextOS — Workspace Evidence Graph');
+    console.log('══════════════════════════════════════════\n');
+    console.log(`  Repository Root  : ${graph.repositoryRoot}`);
+    console.log(`  Fingerprint      : ${graph.fingerprint}`);
+    console.log(`  Packages Found   : ${graph.packages.length} ${graph.partial ? '(partial: true)' : ''}\n`);
+    for (const pkg of graph.packages) {
+      console.log(`  • ${pkg.id} [${pkg.ecosystem}]`);
+      console.log(`    Root           : ${pkg.root}`);
+      console.log(`    Manifests      : ${pkg.manifests.join(', ')}`);
+      console.log(`    Languages      : ${pkg.languages.join(', ') || 'unspecified'}`);
+      console.log(`    Dependencies   : ${pkg.dependencies.length}`);
+      if (pkg.configs.length > 0) {
+        console.log(`    Configs        : ${pkg.configs.join(', ')}`);
+      }
+      if (pkg.internalDependencies.length > 0) {
+        console.log(`    Internal Links : ${pkg.internalDependencies.join(', ')}`);
+      }
+      console.log('');
+    }
+    console.log('──────────────────────────────────────────\n');
+  } else {
+    const detection = detectProjectAttributes(process.cwd());
+    console.log('\nContextOS — Tech Stack & Environment Detection\n');
+    console.log(`  Repository Root       : ${graph.repositoryRoot}`);
+    console.log(`  Packages Detected     : ${graph.packages.map(p => `${p.id} (${p.root})`).join(', ')}`);
+    console.log(`  Detected Technologies : ${detection.summary.technologies.join(', ')}`);
+    console.log(`  Detected Environments : ${detection.summary.ides.join(', ')}`);
+    console.log(`  Recommended Profile   : ${detection.summary.recommendedProfile}`);
+    console.log(`  Recommended Agents    : ${detection.summary.recommendedAgents.join(', ')}`);
+    console.log(`  Recommended Skills    : ${detection.summary.recommendedSkills.join(', ')}\n`);
+    console.log('  Commands:');
+    console.log('    contextos detect --scope <path>    Scope detection to a specific file/subproject');
+    console.log('    contextos detect --explain         Display full workspace evidence graph\n');
+  }
+  process.exit(0);
+}
+
+// Doctor command
+if (mainCommand === 'doctor') {
+  const doctorModule = require('../.agents/doctor.js');
+  const result = doctorModule.runDoctor(process.cwd(), {
+    json: flags.json,
+    fix: args.includes('--fix'),
+    strict: args.includes('--strict'),
+  });
+  process.exit(result && result.ok === false ? 1 : 0);
+}
+
+// Recover command
+if (mainCommand === 'recover') {
+  const recoverModule = require('./commands/recover.js');
+  recoverModule(args, flags);
+  process.exit(0);
+}
+
 // Proxy commands to .agents/ctx.js when executed in a ContextOS project
 const PROXY_COMMANDS = [
   'profile', 'export', 'validate', 'resolve', 'skill', 'index',
-  'clean-worktrees', 'doctor', 'stats', 'watch', 'init'
+  'clean-worktrees', 'stats', 'watch', 'compile', 'explain',
+  'thread'
 ];
 
 const ctxPath = path.join(process.cwd(), '.agents', 'ctx.js');
@@ -115,9 +271,21 @@ if (mainCommand && PROXY_COMMANDS.includes(mainCommand) && hasLocalCtx) {
 }
 
 // Fallbacks when running outside an initialized .agents/ directory
-if (mainCommand === 'doctor') {
-  const doctorModule = require('../.agents/doctor.js');
-  doctorModule.runDoctor(process.cwd());
+if (mainCommand === 'update') {
+  const { runUpdate } = require('./commands/update.js');
+  runUpdate(process.cwd(), {
+    dryRun: flags.dryRun,
+    skipCompile: flags.skipCompile,
+    profile: flags.profile,
+  });
+  process.exit(0);
+}
+
+if (mainCommand === 'uninstall') {
+  const { runUninstall } = require('./commands/uninstall.js');
+  runUninstall(process.cwd(), {
+    dryRun: flags.dryRun,
+  });
   process.exit(0);
 }
 
@@ -132,24 +300,7 @@ if (mainCommand === 'watch') {
   watchModule.runWatch(process.cwd());
 }
 
-if (mainCommand === 'init') {
-  console.log(`
-ContextOS — Project Setup
-
-Usage:
-  npx contextos                    Install .agents/ with auto-detected stack
-  npx contextos --profile <name>   Install with specific profile (mvp, startup, enterprise, frontend, backend)
-  npx contextos --minimal          Install only 5 core skills
-  npx contextos --with-mcp         Install with MCP execution server enabled
-
-Run:
-  contextos doctor                 Verify installation health
-  contextos stats                  Show token savings report
-`);
-  process.exit(0);
-}
-
-const PROJECT_ONLY_COMMANDS = ['profile', 'export', 'validate', 'resolve', 'skill', 'index', 'clean-worktrees'];
+const PROJECT_ONLY_COMMANDS = ['profile', 'export', 'validate', 'resolve', 'skill', 'index', 'clean-worktrees', 'compile', 'explain'];
 if (mainCommand && PROJECT_ONLY_COMMANDS.includes(mainCommand) && !hasLocalCtx) {
   console.error('[ERROR] .agents/ctx.js not found in current directory.');
   console.error('        Are you in a ContextOS project? Run `contextos` or `npx contextos-agents` first.');
@@ -170,15 +321,6 @@ if (mainCommand === 'audit') {
   process.exit(0);
 }
 
-if (mainCommand === 'detect') {
-  const stack = profiles.detectStack(process.cwd());
-  console.log('\nContextOS — Tech Stack Detection\n');
-  console.log(`  Detected Technologies : ${stack.detected.length ? stack.detected.join(', ') : 'Generic JavaScript'}`);
-  console.log(`  Recommended Profile   : ${stack.recommendedProfile}`);
-  console.log(`  Recommended Skills    : ${stack.recommendedSkills.join(', ')}\n`);
-  process.exit(0);
-}
-
 if (mainCommand === 'install-skill') {
   const ctxPath = path.join(process.cwd(), '.agents', 'ctx.js');
   if (!fs.existsSync(ctxPath)) {
@@ -288,46 +430,10 @@ if (mainCommand === 'install-skill') {
     })();
   }
 } else if (mainCommand === 'setup-mcp') {
-  const targetPath = path.join(process.cwd(), '.agents');
-  if (!fs.existsSync(targetPath)) {
-    console.error('[ERROR] .agents/ folder not found in current directory.');
-    console.error('        Run `npx contextos-agents` first or `npx contextos-agents --with-mcp`.');
-    process.exit(1);
-  }
-
-  const sourceMcp = path.join(__dirname, '..', '.agents', 'mcp');
-  const targetMcp = path.join(targetPath, 'mcp');
-  if (!fs.existsSync(sourceMcp)) {
-    console.error('[ERROR] Source MCP server bundle not found in package.');
-    process.exit(1);
-  }
-
-  try {
-    fs.cpSync(sourceMcp, targetMcp, { recursive: true, force: true });
-    console.log('[OK] Installed ContextOS MCP execution server into .agents/mcp/');
-
-    const mcpConfigPath = path.join(targetPath, 'mcp_config.json');
-    if (!fs.existsSync(mcpConfigPath) || flags.force) {
-      const defaultMcpConfig = {
-        mcpServers: {
-          "contextos": {
-            command: "node",
-            args: ["./.agents/mcp/server.mjs", "--dir", "."]
-          }
-        }
-      };
-      fs.writeFileSync(mcpConfigPath, JSON.stringify(defaultMcpConfig, null, 2));
-      console.log('[OK] Created MCP configuration (.agents/mcp_config.json)');
-    } else {
-      console.log('[INFO] Existing .agents/mcp_config.json retained.');
-    }
-    console.log('\n[SUCCESS] ContextOS MCP execution layer is configured.');
-    console.log('You can now use parallel subagents and git worktrees in your MCP-compatible IDE.\n');
-  } catch (err) {
-    console.error('[ERROR] Failed to configure MCP:', err.message);
-    process.exit(1);
-  }
-  process.exit(0);
+  console.error('[DEPRECATED] The bundled MCP server has been moved to a separate package in v2.0.');
+  console.error('             To use the MCP Bridge or execution runtime, install @contextos/mcp:');
+  console.error('             npm install @contextos/mcp --save-dev');
+  process.exit(1);
 } else {
 
 // ── Paths ─────────────────────────────────────────────────────────────────────
@@ -339,7 +445,9 @@ const MINIMAL_SKILLS = new Set([
   'ponytail-mindset',
   'gstack-roles',
   'gemini-precision',
-  'react',
+  'context-os',
+  'context-manager',
+  'security',
 ]);
 
 function uniqueSiblingPath(basePath, suffix) {
@@ -365,10 +473,8 @@ function installAtomically(source, target, options = {}) {
       force: true,
       filter: (src) => {
         const norm = src.replace(/\\/g, '/');
-        if (!options.withMcp) {
-          if (norm.endsWith('/mcp') || norm.includes('/mcp/') || norm.endsWith('/mcp_config.json')) {
-            return false;
-          }
+        if (norm.endsWith('/mcp') || norm.includes('/mcp/') || norm.endsWith('/mcp_config.json')) {
+          return false;
         }
         if (options.minimal) {
           const skillMatch = norm.match(/\/core\/skills\/([^/]+)/);
@@ -404,12 +510,18 @@ function installAtomically(source, target, options = {}) {
   }
 }
 
-// ── Stack detection ───────────────────────────────────────────────────────────
-const stackDetection = profiles.detectStack(process.cwd());
+// ── Stack & IDE detection ───────────────────────────────────────────────────
+const projectAttrs = detectProjectAttributes(process.cwd());
+const stackDetection = projectAttrs.stack;
+const ideDetection = projectAttrs.ide;
+
+const targetProfile = flags.profile || (flags.auto || flags.agent === 'auto' ? stackDetection.recommendedProfile : 'none');
+const targetAgents = (flags.agent === 'auto' || flags.auto)
+  ? ideDetection.recommendedAgents
+  : (flags.agent ? [flags.agent] : ['gemini']);
 
 // ── Dry run ───────────────────────────────────────────────────────────────────
 if (flags.dryRun) {
-  console.log('[DRY-RUN] No files will be written.\n');
   if (!fs.existsSync(sourcePath)) {
     console.error('[ERROR] Source .agents/ folder not found in package.');
     process.exit(1);
@@ -439,14 +551,34 @@ if (flags.dryRun) {
     return count;
   };
   const total = countFiles(sourcePath);
+
+  if (flags.json) {
+    console.log(JSON.stringify({
+      dryRun: true,
+      targetPath,
+      targetProfile,
+      detectedStack: stackDetection.detected,
+      detectedIde: ideDetection.detected,
+      targetAgents,
+      filesCount: total,
+      minimal: flags.minimal,
+      withMcp: flags.withMcp,
+    }, null, 2));
+    process.exit(0);
+  }
+
+  console.log('[DRY-RUN] No files will be written.\n');
   if (fs.existsSync(targetPath)) {
     console.log(`[WARN] .agents/ already exists — would be overwritten with --force.`);
   } else {
     console.log(`[OK] Would create .agents/ in: ${process.cwd()}`);
   }
   console.log(`[INFO] Detected stack: ${stackDetection.detected.length ? stackDetection.detected.join(', ') : 'Generic JavaScript'}`);
-  const targetProfile = flags.profile || (flags.auto ? stackDetection.recommendedProfile : 'none');
+  if (ideDetection.detected.length > 0) {
+    console.log(`[INFO] Detected IDEs: ${ideDetection.detected.join(', ')}`);
+  }
   console.log(`[INFO] Selected profile: ${targetProfile}`);
+  console.log(`[INFO] Target agents for export: ${targetAgents.join(', ')}`);
   if (flags.minimal) {
     console.log(`[INFO] Minimal mode: copying only 5 core essential skills`);
   }
@@ -456,7 +588,9 @@ if (flags.dryRun) {
 }
 
 // ── Main install ──────────────────────────────────────────────────────────────
-console.log('Installing AI assistant skills (.agents/)...');
+if (!flags.json) {
+  console.log('Installing AI assistant skills (.agents/)...');
+}
 
 try {
   if (!fs.existsSync(sourcePath)) {
@@ -477,64 +611,124 @@ try {
 
   installAtomically(sourcePath, targetPath, { withMcp: flags.withMcp, minimal: flags.minimal });
 
-  console.log('[OK] .agents/ successfully installed in your project!');
-  if (flags.minimal) {
-    console.log('[OK] Minimal profile: 5 core skills installed.');
-    console.log('     (engineering-workflow, ponytail-mindset, gstack-roles, gemini-precision, react)');
-    console.log('     Tip: Add more skills anytime with: contextos skill add <name>');
+  // ── Create/update lockfile for provenance & safe lifecycle ─────────────────
+  const selectedProfile = flags.profile || (flags.auto || flags.agent === 'auto' ? stackDetection.recommendedProfile : null);
+  try {
+    lockfileLib.migrateExistingInstallation(process.cwd(), sourcePath, {
+      selectedProfile: selectedProfile || 'none',
+      installedPackage: 'contextos-agents',
+      version,
+    });
+  } catch (err) {
+    if (flags.json) {
+      console.error(JSON.stringify({ success: false, error: `Could not generate lockfile: ${err.message}` }));
+    } else {
+      console.error(`[ERROR] Could not generate lockfile: ${err.message}`);
+    }
+    process.exit(1);
   }
-  if (stackDetection.detected.length > 0) {
-    console.log(`[OK] Detected project stack: ${stackDetection.detected.join(', ')}`);
+
+  if (!flags.json) {
+    console.log('[OK] .agents/ successfully installed in your project!');
+    if (flags.minimal) {
+      console.log('[OK] Minimal profile: 5 core skills installed.');
+      console.log('     (engineering-workflow, ponytail-mindset, gstack-roles, gemini-precision, react)');
+      console.log('     Tip: Add more skills anytime with: contextos skill add <name>');
+    }
+    if (stackDetection.detected.length > 0) {
+      console.log(`[OK] Detected project stack: ${stackDetection.detected.join(', ')}`);
+    }
+    if (ideDetection.detected.length > 0) {
+      console.log(`[OK] Detected developer environment: ${ideDetection.detected.join(', ')}`);
+    }
   }
 
-  // ── Create mcp_config.json only if --with-mcp ────────────────────────────────
+  // ── Deprecation warning for --with-mcp ────────────────────────────────────────────────
   if (flags.withMcp) {
-    const mcpConfigPath = path.join(targetPath, 'mcp_config.json');
-    if (!fs.existsSync(mcpConfigPath)) {
-      const defaultMcpConfig = {
-        mcpServers: {
-          "contextos": {
-            command: "node",
-            args: ["./.agents/mcp/server.mjs", "--dir", "."]
-          }
-        }
-      };
-      fs.writeFileSync(mcpConfigPath, JSON.stringify(defaultMcpConfig, null, 2));
-      console.log('[OK] Created default MCP configuration (.agents/mcp_config.json)');
-    }
+    console.warn('\n[DEPRECATED] The --with-mcp flag is no longer supported in ContextOS v2.0.');
+    console.warn('             The MCP execution runtime has been moved to a separate package.');
+    console.warn('             To enable the MCP server, run: npm install @contextos/mcp --save-dev\n');
   }
 
   // ── Apply profile if requested or auto ──────────────────────────────────────
-  const selectedProfile = flags.profile || (flags.auto ? stackDetection.recommendedProfile : null);
   if (selectedProfile) {
     try {
       const applied = profiles.applyProfile(selectedProfile, process.cwd());
-      console.log(`[OK] Applied profile '${applied.name}' (excluded: ${(applied.exclude_skills || []).join(', ') || 'none'})`);
+      if (!flags.json) console.log(`[OK] Applied profile '${applied.name}' (excluded: ${(applied.exclude_skills || []).join(', ') || 'none'})`);
     } catch (e) {
-      console.warn(`[WARN] Could not apply profile '${selectedProfile}': ${e.message}`);
+      if (flags.json) {
+        console.error(JSON.stringify({ success: false, error: `Could not apply profile '${selectedProfile}': ${e.message}` }));
+      } else {
+        console.error(`[ERROR] Could not apply profile '${selectedProfile}': ${e.message}`);
+      }
+      process.exit(1);
     }
   }
 
-  console.log('[OK] Your AI assistant now has skills and rules configured.\n');
+  if (!flags.json) {
+    console.log('[OK] Your AI assistant now has skills and rules configured.\n');
+  }
 
-  // ── Auto-compile skills ───────────────────────────────────────────────────
+  // ── Auto-compile skills for target agents ──────────────────────────────────
   if (!flags.skipCompile) {
     const ctxPath = path.join(targetPath, 'ctx.js');
     if (fs.existsSync(ctxPath)) {
-      console.log('Compiling skills for Gemini...');
+      const { execFileSync } = require('child_process');
+      for (const ag of targetAgents) {
+        if (!flags.json) console.log(`Compiling skills for ${ag}...`);
+        try {
+          execFileSync(process.execPath, [ctxPath, 'export', ag], {
+            cwd: process.cwd(),
+            stdio: flags.json ? 'ignore' : 'inherit',
+          });
+        } catch (e) {
+          if (flags.json) {
+            console.error(JSON.stringify({ success: false, error: `Skill compilation for '${ag}' failed` }));
+          } else {
+            console.error(`[ERROR] Skill compilation for '${ag}' failed — run manually: contextos export ${ag}`);
+          }
+          process.exit(1);
+        }
+      }
+    }
+  } else if (!flags.json) {
+    console.log('Tip: Run `contextos export gemini` to compile skills.');
+  }
+
+  // ── --add-skill flag ────────────────────────────────────────────────────────
+  if (flags.addSkill) {
+    const ctxPath = path.join(targetPath, 'ctx.js');
+    if (fs.existsSync(ctxPath)) {
+      if (!flags.json) console.log(`Installing plugin skill: ${flags.addSkill}`);
       try {
         const { execFileSync } = require('child_process');
-        execFileSync(process.execPath, [ctxPath, 'export', 'gemini'], {
+        execFileSync(process.execPath, [ctxPath, 'skill', 'add', flags.addSkill], {
           cwd: process.cwd(),
-          stdio: 'inherit',
+          stdio: flags.json ? 'ignore' : 'inherit',
         });
       } catch (e) {
-        console.warn('[WARN] Skill compilation failed — run manually:');
-        console.warn('       contextos export gemini');
+        if (flags.json) {
+          console.error(JSON.stringify({ success: false, error: `Skill install failed for ${flags.addSkill}` }));
+        } else {
+          console.error(`[ERROR] Skill install failed — run manually: node .agents/ctx.js skill add ${flags.addSkill}`);
+        }
+        process.exit(1);
       }
     }
-  } else {
-    console.log('Tip: Run `contextos export gemini` to compile skills.');
+  }
+
+  if (flags.json) {
+    console.log(JSON.stringify({
+      success: true,
+      package: 'contextos-agents',
+      version,
+      projectDir: process.cwd(),
+      profile: selectedProfile || 'default',
+      agents: targetAgents,
+      withMcp: flags.withMcp,
+      minimal: flags.minimal,
+    }, null, 2));
+    process.exit(0);
   }
 
   console.log('\n Next steps:');
@@ -552,32 +746,15 @@ try {
   console.log('  6. Add community skills (plugins):');
   console.log('       contextos skill add   username/my-skill');
   console.log('       contextos skill list');
-  if (!flags.withMcp) {
-    console.log('  7. Enable MCP parallel subagents & worktrees (optional):');
-    console.log('       contextos setup-mcp');
-  }
-  console.log('');
 
-  // ── --add-skill flag ────────────────────────────────────────────────────────
-  if (flags.addSkill) {
-    const ctxPath = path.join(targetPath, 'ctx.js');
-    if (fs.existsSync(ctxPath)) {
-      console.log(`Installing plugin skill: ${flags.addSkill}`);
-      try {
-        const { execFileSync } = require('child_process');
-        execFileSync(process.execPath, [ctxPath, 'skill', 'add', flags.addSkill], {
-          cwd: process.cwd(),
-          stdio: 'inherit',
-        });
-      } catch (e) {
-        console.warn(`[WARN] Skill install failed — run manually:`);
-        console.warn(`       node .agents/ctx.js skill add ${flags.addSkill}`);
-      }
-    }
-  }
+  console.log('');
 
 } catch (error) {
-  console.error('[ERROR] Installation failed:', error.message);
+  if (flags.json) {
+    console.error(JSON.stringify({ success: false, error: error.message }));
+  } else {
+    console.error('[ERROR] Installation failed:', error.message);
+  }
   process.exit(1);
 }