contextos-agents 1.5.0 → 1.6.1

package/bin/index.js

@@ -14,6 +14,7 @@ const flags = {
   force:       args.includes('--force'),
   skipCompile: args.includes('--skip-compile'),
   auto:        args.includes('--auto'),
+  minimal:     args.includes('--minimal'),
   withMcp:     args.includes('--with-mcp') || args.includes('--mcp'),
   profile:     (() => {
     const i = args.indexOf('--profile');
@@ -33,17 +34,19 @@ if (flags.ver) {
 
 if (flags.help) {
   console.log(`
-contextos-agents v${version}
+contextos / contextos-agents v${version}
 Install AI assistant skills and rules into your project.
 
 Usage:
-  npx contextos-agents [options]
+  npx contextos [options]
+  contextos <command> [args...]
 
 Options:
   --help, -h          Show this help message
   --version, -v       Show version number
   --dry-run           Preview what will be copied without making changes
   --force             Overwrite an existing .agents/ folder
+  --minimal           Install only 5 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)
@@ -51,7 +54,14 @@ Options:
   --add-skill <ref>   Install a community plugin skill after setup
 
 Commands:
+  doctor              Run full project diagnostic health check
   audit               Validate local skills (alias for validate)
+  validate            Validate local skills, frontmatter, and sync
+  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
   install-skill       Interactive skill installer (or pass <ref> / --from-repo)
   setup-mcp           Add MCP execution server to an existing .agents/ project
@@ -72,35 +82,82 @@ Plugin ref formats:
   @scope/npm-package               A scoped npm skill package
 
 Examples:
-  npx contextos-agents                          Install .agents/ into current project
-  npx contextos-agents --profile mvp            Install with MVP profile
-  npx contextos-agents --auto                   Auto-detect tech stack and configure
-  npx contextos-agents --dry-run                Preview files that would be copied
-  npx contextos-agents --add-skill alice/my-skill
-
-Export skills to your AI tool:
-  node .agents/ctx.js export gemini    → .agents/generated/gemini/   (Gemini / Antigravity)
-  node .agents/ctx.js export claude    → .agents/generated/claude/   (Claude Code)
-  node .agents/ctx.js export cursor    → .cursorrules & .cursor/rules (Cursor IDE)
-  node .agents/ctx.js export copilot   → .github/copilot-instructions.md
-  node .agents/ctx.js export aider     → .aider.conf.yml + CONVENTIONS.md
-  node .agents/ctx.js export zed       → .zed/rules.md & .zed/prompts/ (Zed IDE)
-  node .agents/ctx.js export all       → all of the above
-
-Profile commands (after installation):
-  node .agents/ctx.js profile list           List available profiles
-  node .agents/ctx.js profile apply <name>   Switch project profile
-  node .agents/ctx.js detect                 Detect project tech stack
+  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
 `);
   process.exit(0);
 }
 
-// ── Top-level Commands ────────────────────────────────────────────────────────
+// ── Top-level Commands & Proxy Routing ────────────────────────────────────────
 const mainCommand = args[0] && !args[0].startsWith('-') ? args[0] : null;
 
+// 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'
+];
+
+const ctxPath = path.join(process.cwd(), '.agents', 'ctx.js');
+const hasLocalCtx = fs.existsSync(ctxPath);
+
+if (mainCommand && PROXY_COMMANDS.includes(mainCommand) && hasLocalCtx) {
+  const { execFileSync } = require('child_process');
+  try {
+    execFileSync(process.execPath, [ctxPath, ...args], { stdio: 'inherit' });
+  } catch (e) {
+    process.exit(e.status || 1);
+  }
+  process.exit(0);
+}
+
+// Fallbacks when running outside an initialized .agents/ directory
+if (mainCommand === 'doctor') {
+  const doctorModule = require('../.agents/doctor.js');
+  doctorModule.runDoctor(process.cwd());
+  process.exit(0);
+}
+
+if (mainCommand === 'stats') {
+  const statsModule = require('../.agents/stats.js');
+  statsModule.runStats(process.cwd());
+  process.exit(0);
+}
+
+if (mainCommand === 'watch') {
+  const watchModule = require('../.agents/watch.js');
+  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'];
+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.');
+  process.exit(1);
+}
+
 if (mainCommand === 'audit') {
-  const ctxPath = path.join(process.cwd(), '.agents', 'ctx.js');
-  if (!fs.existsSync(ctxPath)) {
+  if (!hasLocalCtx) {
     console.error('[ERROR] .agents/ctx.js not found. Are you in a ContextOS project?');
     process.exit(1);
   }
@@ -145,10 +202,10 @@ if (mainCommand === 'install-skill') {
     }
     process.exit(0);
   } else {
-    // Interactive menu
+    // Interactive menu using standard library readline
     (async () => {
       try {
-        const inquirer = require('inquirer');
+        const readline = require('readline');
         const https = require('https');
         
         console.log('Fetching community skills from registry...');
@@ -157,33 +214,68 @@ if (mainCommand === 'install-skill') {
           https.get('https://raw.githubusercontent.com/kok-o/contextos-agents/main/registry.json', (res) => {
             let data = '';
             res.on('data', chunk => data += chunk);
-            res.on('end', () => resolve(JSON.parse(data)));
+            res.on('end', () => {
+              try {
+                resolve(JSON.parse(data));
+              } catch (err) {
+                reject(err);
+              }
+            });
           }).on('error', reject);
         });
         
         const registry = await fetchRegistry();
-        const choices = registry.skills.map(s => ({
-          name: `${s.name} - ${s.description}`,
+        const skillsList = (registry.skills || []).map((s, idx) => ({
+          idx: idx + 1,
+          name: s.name,
+          desc: s.description || '',
           value: s.github ? `${s.github}${s.path ? '/' + s.path : ''}` : s.npm
         }));
-        
-        const answers = await inquirer.prompt([
-          {
-            type: 'checkbox',
-            name: 'selectedSkills',
-            message: 'Select skills to install:',
-            choices
-          }
-        ]);
-        
-        if (!answers.selectedSkills || answers.selectedSkills.length === 0) {
-          console.log('No skills selected.');
+
+        if (skillsList.length === 0) {
+          console.log('No community skills found in registry.');
           process.exit(0);
         }
-        
+
+        console.log('\nAvailable community skills:\n');
+        for (const item of skillsList) {
+          console.log(`  [${item.idx}] ${item.name.padEnd(20)} ${item.desc}`);
+        }
+        console.log('\nEnter skill numbers to install (comma-separated, e.g. 1, 3) or press Enter to cancel:');
+
+        const rl = readline.createInterface({
+          input: process.stdin,
+          output: process.stdout,
+        });
+
+        const answer = await new Promise((resolve) => {
+          rl.question('> ', (ans) => {
+            rl.close();
+            resolve(ans.trim());
+          });
+        });
+
+        if (!answer) {
+          console.log('No skills selected. Operation cancelled.');
+          process.exit(0);
+        }
+
+        const selectedIndices = answer
+          .split(/[\s,]+/)
+          .map(n => parseInt(n, 10))
+          .filter(n => !isNaN(n) && n >= 1 && n <= skillsList.length);
+
+        const selectedSkills = selectedIndices.map(n => skillsList[n - 1].value);
+
+        if (selectedSkills.length === 0) {
+          console.log('No valid skill numbers selected.');
+          process.exit(0);
+        }
+
         const { execFileSync } = require('child_process');
-        for (const skillRef of answers.selectedSkills) {
+        for (const skillRef of selectedSkills) {
           try {
+            console.log(`\nInstalling ${skillRef}...`);
             execFileSync(process.execPath, [ctxPath, 'skill', 'add', skillRef], { stdio: 'inherit' });
           } catch (e) {
             console.error(`Failed to install ${skillRef}`);
@@ -191,9 +283,6 @@ if (mainCommand === 'install-skill') {
         }
       } catch (error) {
         console.error('Failed to run interactive installer:', error.message);
-        if (error.code === 'MODULE_NOT_FOUND' && error.message.includes('inquirer')) {
-          console.error('It seems inquirer is not installed. Did you run npm install?');
-        }
         process.exit(1);
       }
     })();
@@ -245,6 +334,14 @@ if (mainCommand === 'install-skill') {
 const sourcePath = path.join(__dirname, '..', '.agents');
 const targetPath = path.join(process.cwd(), '.agents');
 
+const MINIMAL_SKILLS = new Set([
+  'engineering-workflow',
+  'ponytail-mindset',
+  'gstack-roles',
+  'gemini-precision',
+  'react',
+]);
+
 function uniqueSiblingPath(basePath, suffix) {
   let candidate = `${basePath}.${suffix}`;
   let index = 1;
@@ -267,12 +364,22 @@ function installAtomically(source, target, options = {}) {
       recursive: true,
       force: true,
       filter: (src) => {
+        const norm = src.replace(/\\/g, '/');
         if (!options.withMcp) {
-          const norm = src.replace(/\\/g, '/');
           if (norm.endsWith('/mcp') || norm.includes('/mcp/') || norm.endsWith('/mcp_config.json')) {
             return false;
           }
         }
+        if (options.minimal) {
+          const skillMatch = norm.match(/\/core\/skills\/([^/]+)/);
+          if (skillMatch && !MINIMAL_SKILLS.has(skillMatch[1])) {
+            return false;
+          }
+          const genMatch = norm.match(/\/generated\/gemini\/skills\/([^/]+)/);
+          if (genMatch && !MINIMAL_SKILLS.has(genMatch[1])) {
+            return false;
+          }
+        }
         return true;
       },
     });
@@ -311,12 +418,22 @@ if (flags.dryRun) {
     let count = 0;
     for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
       const full = path.join(dir, entry.name);
+      const norm = full.replace(/\\/g, '/');
       if (!flags.withMcp) {
-        const norm = full.replace(/\\/g, '/');
         if (norm.endsWith('/mcp') || norm.includes('/mcp/') || norm.endsWith('/mcp_config.json')) {
           continue;
         }
       }
+      if (flags.minimal) {
+        const skillMatch = norm.match(/\/core\/skills\/([^/]+)/);
+        if (skillMatch && !MINIMAL_SKILLS.has(skillMatch[1])) {
+          continue;
+        }
+        const genMatch = norm.match(/\/generated\/gemini\/skills\/([^/]+)/);
+        if (genMatch && !MINIMAL_SKILLS.has(genMatch[1])) {
+          continue;
+        }
+      }
       count += entry.isDirectory() ? countFiles(full) : 1;
     }
     return count;
@@ -330,6 +447,9 @@ if (flags.dryRun) {
   console.log(`[INFO] Detected stack: ${stackDetection.detected.length ? stackDetection.detected.join(', ') : 'Generic JavaScript'}`);
   const targetProfile = flags.profile || (flags.auto ? stackDetection.recommendedProfile : 'none');
   console.log(`[INFO] Selected profile: ${targetProfile}`);
+  if (flags.minimal) {
+    console.log(`[INFO] Minimal mode: copying only 5 core essential skills`);
+  }
   console.log(`[INFO] ${total} files would be copied from the package.`);
   console.log('\nRun without --dry-run to apply changes.');
   process.exit(0);
@@ -355,9 +475,14 @@ try {
     process.exit(1);
   }
 
-  installAtomically(sourcePath, targetPath, { withMcp: flags.withMcp });
+  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>');
+  }
   if (stackDetection.detected.length > 0) {
     console.log(`[OK] Detected project stack: ${stackDetection.detected.join(', ')}`);
   }
@@ -405,30 +530,31 @@ try {
         });
       } catch (e) {
         console.warn('[WARN] Skill compilation failed — run manually:');
-        console.warn('       node .agents/ctx.js export gemini');
+        console.warn('       contextos export gemini');
       }
     }
   } else {
-    console.log('Tip: Run `node .agents/ctx.js export gemini` to compile skills.');
+    console.log('Tip: Run `contextos export gemini` to compile skills.');
   }
 
   console.log('\n Next steps:');
   console.log('  1. Open your project in your AI assistant');
   console.log('  2. The assistant will automatically load .agents/AGENTS.md');
-  console.log('  3. Skills are pre-compiled in .agents/generated/gemini/skills/');
+  console.log('  3. Inspect project health anytime:');
+  console.log('       contextos doctor');
   console.log('  4. Switch profiles anytime:');
-  console.log('       node .agents/ctx.js profile list');
-  console.log('       node .agents/ctx.js profile apply mvp');
+  console.log('       contextos profile list');
+  console.log('       contextos profile apply mvp');
   console.log('  5. Export to other AI tools:');
-  console.log('       node .agents/ctx.js export cursor   → .cursorrules & .cursor/rules');
-  console.log('       node .agents/ctx.js export copilot  → .github/copilot-instructions.md');
-  console.log('       node .agents/ctx.js export aider    → .aider.conf.yml + CONVENTIONS.md');
+  console.log('       contextos export cursor   → .cursorrules & .cursor/rules');
+  console.log('       contextos export copilot  → .github/copilot-instructions.md');
+  console.log('       contextos export aider    → .aider.conf.yml + CONVENTIONS.md');
   console.log('  6. Add community skills (plugins):');
-  console.log('       node .agents/ctx.js skill add   username/my-skill');
-  console.log('       node .agents/ctx.js skill list');
+  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('       npx contextos-agents setup-mcp');
+    console.log('       contextos setup-mcp');
   }
   console.log('');
 

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "contextos-agents",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "Install a .agents folder into your project to teach AI assistants best practices: UI/UX, architecture, security, and engineering workflow skills.",
   "bin": {
+    "contextos": "./bin/index.js",
     "contextos-agents": "./bin/index.js",
     "koko-contextos-agents": "./bin/index.js"
   },
@@ -17,6 +18,9 @@
     ".agents/plugins.js",
     ".agents/profiles.js",
     ".agents/resolver.js",
+    ".agents/doctor.js",
+    ".agents/stats.js",
+    ".agents/watch.js",
     ".agents/skills-index.json",
     ".agents/adapters",
     ".agents/core",
@@ -32,6 +36,9 @@
     "benchmark:live": "node benchmarks/run-live-benchmark.js",
     "benchmark:runtime": "node benchmarks/run-runtime-benchmark.js",
     "lint:md": "markdownlint README.md CONTRIBUTING.md .agents/core/skills/**/*.md --ignore .agents/generated/** --config .markdownlint.json",
+    "check:secrets": "node scripts/check-secrets.js --all",
+    "setup:hooks": "node scripts/install-hooks.js",
+    "watch": "node .agents/watch.js",
     "test": "node --test --test-concurrency=1 tests/install.test.js tests/export.test.js tests/skills.test.js tests/validate.test.js tests/plugins.test.js tests/benchmark.test.js tests/profile.test.js tests/resolver.test.js",
     "prepublishOnly": "npm run validate && cd contextos-mcp && npm install && npm run build:bundle && cd .. && npm run build"
   },
@@ -59,12 +66,10 @@
     "url": "https://github.com/kok-o/contextos-agents/issues"
   },
   "engines": {
-    "node": ">=16.7.0"
+    "node": ">=18.0.0"
   },
   "devDependencies": {
     "markdownlint-cli": "^0.43.0"
   },
-  "dependencies": {
-    "inquirer": "^8.2.7"
-  }
+  "dependencies": {}
 }