grimoire-framework 1.0.6 → 1.0.9

package/.grimoire/install-manifest.yaml

@@ -7,8 +7,8 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.0.6
-generated_at: "2026-02-22T10:58:33.442Z"
+version: 1.0.9
+generated_at: "2026-02-22T12:01:52.134Z"
 generator: scripts/generate-install-manifest.js
 file_count: 1011
 files:

package/bin/grimoire-cli.js

@@ -27,8 +27,14 @@ async function main() {
     case 'agents':
       handleAgents(args.slice(1));
       break;
+    case 'status':
+      handleStatus();
+      break;
+    case 'whoami':
+      handleWhoami();
+      break;
     case 'doctor':
-      console.log('🏥 Grimoire Doctor: Everything looks good!');
+      handleDoctor();
       break;
     case 'install':
     case 'update':
@@ -92,6 +98,14 @@ function handleAgents(args) {
   const fallbackDir = path.join(baseDir, 'node_modules', 'grimoire-framework', '.codex', 'agents');
   const dir = fs.existsSync(agentsDir) ? agentsDir : fs.existsSync(fallbackDir) ? fallbackDir : null;
 
+  // Agent name map (id -> art persona)
+  const agentNames = {
+    'dev': 'Da Vinci', 'qa': 'Dürer', 'sm': 'Monet', 'devops': 'Boccioni',
+    'ux-design-expert': 'Matisse', 'grimoire-master': 'Michelangelo',
+    'analyst': 'Vermeer', 'architect': 'Gaudí', 'data-engineer': 'Escher',
+    'pm': 'Raphael', 'po': 'Velázquez', 'squad-creator': 'Rodin',
+  };
+
   if (sub === 'list' || !sub) {
     if (!dir) {
       console.log('\n⚠️  No agents found. Run "npx grimoire-framework install" first.');
@@ -101,26 +115,214 @@ function handleAgents(args) {
       .filter(f => f.endsWith('.md'))
       .map(f => f.replace('.md', ''));
     console.log('\n🧙 Grimoire Agents:');
-    list.forEach(a => console.log(`  - ${a}`));
-    console.log(`\n  Total: ${list.length} agents`);
+    list.forEach(a => {
+      const persona = agentNames[a] ? ` (${agentNames[a]})` : '';
+      console.log(`  @${a}${persona}`);
+    });
+    console.log(`\n  Total: ${list.length} agents | Invoke with @agentname in your IDE chat`);
   } else {
     console.log('Usage: grimoire agents list');
   }
 }
 
+function handleStatus() {
+  const cwd = process.cwd();
+  const check = (p) => fs.existsSync(p);
+  const icon = (v) => v ? '✅' : '❌';
+
+  // Detect project root (has .codex or .grimoire)
+  const hasCodex = check(path.join(cwd, '.codex'));
+  const hasGrimoire = check(path.join(cwd, '.grimoire'));
+  const hasGemini = check(path.join(cwd, '.gemini'));
+  const hasCursor = check(path.join(cwd, '.cursor'));
+  const hasClaude = check(path.join(cwd, '.claude'));
+
+  // Hooks check
+  const settingsPath = path.join(cwd, '.gemini', 'settings.json');
+  let hooks = [];
+  let hooksActive = false;
+  if (check(settingsPath)) {
+    try {
+      const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+      const h = settings.hooks || {};
+      hooks = Object.values(h).flat().filter(hook => hook && hook.command).map(h => h.command);
+      hooksActive = hooks.length > 0;
+    } catch (e) { /* ignore */ }
+  }
+
+  // Agents count
+  const agentsDir = path.join(cwd, '.codex', 'agents');
+  const agentCount = check(agentsDir)
+    ? fs.readdirSync(agentsDir).filter(f => f.endsWith('.md')).length
+    : 0;
+
+  // Memory check
+  const memDir = path.join(cwd, '.grimoire', 'memory');
+  const hasMemory = check(memDir);
+
+  // Session log (last agent used)
+  const sessionLog = path.join(cwd, '.grimoire', 'logs', 'session.log');
+  let lastAgent = null;
+  if (check(sessionLog)) {
+    try {
+      const lines = fs.readFileSync(sessionLog, 'utf8').trim().split('\n');
+      const last = lines.filter(l => l.includes('agent:')).pop();
+      if (last) lastAgent = last.split('agent:')[1]?.trim();
+    } catch (e) { /* ignore */ }
+  }
+
+  console.log(`
+🔮 Grimoire Framework Status
+${'='.repeat(40)}
+📎  Version:   v${packageJson.version}
+📁  Project:   ${cwd}
+
+🔧 Core
+  ${icon(hasCodex)}  .codex         (agents & config)
+  ${icon(hasGrimoire)}  .grimoire      (memory & metrics)
+  ${icon(agentCount > 0)}  Agents:   ${agentCount} loaded
+
+🪝 Hooks (Gemini CLI)
+  ${icon(check(settingsPath))}  settings.json
+  ${icon(hooksActive)}  Hooks active:   ${hooksActive ? hooks.length + ' configured' : 'none found'}
+
+💻 IDE Integration
+  ${icon(hasGemini)}  .gemini        (Gemini CLI rules)
+  ${icon(hasCursor)}  .cursor        (Cursor rules)
+  ${icon(hasClaude)}  .claude        (Claude commands)
+
+💾 Memory Layer
+  ${icon(hasMemory)}  Memory store   ${hasMemory ? '(active)' : '(not initialized)'}
+${lastAgent ? `
+🧙 Last Agent:  @${lastAgent}` : ''}
+
+  Run 'grimoire agents list' to see all agents.
+  Run 'grimoire whoami'     to see session context.
+`);
+}
+
+function handleWhoami() {
+  const cwd = process.cwd();
+
+  // Detect IDE from environment
+  const inCursor = process.env.CURSOR_TRACE_ID || process.env.VSCODE_PID;
+  const inVSCode = process.env.VSCODE_PID && !inCursor;
+  const inGemini = process.env.GEMINI_CLI || process.env.CLOUD_SHELL;
+  const inClaude = process.env.CLAUDE_AGENT;
+  let ide = 'Unknown IDE';
+  if (inCursor) ide = 'Cursor';
+  else if (inVSCode) ide = 'VS Code';
+  else if (inGemini) ide = 'Gemini CLI';
+  else if (inClaude) ide = 'Claude';
+
+  // Detect project name
+  const projectPkg = path.join(cwd, 'package.json');
+  let projectName = path.basename(cwd);
+  if (fs.existsSync(projectPkg)) {
+    try { projectName = JSON.parse(fs.readFileSync(projectPkg, 'utf8')).name || projectName; } catch (e) { }
+  }
+
+  // Read grimoire config if exists
+  const configPath = path.join(cwd, '.grimoire', 'config.json');
+  let config = {};
+  if (fs.existsSync(configPath)) {
+    try { config = JSON.parse(fs.readFileSync(configPath, 'utf8')); } catch (e) { }
+  }
+
+  // Available agents with personas
+  const agentNames = {
+    'dev': 'Da Vinci', 'qa': 'Dürer', 'sm': 'Monet', 'devops': 'Boccioni',
+    'ux-design-expert': 'Matisse', 'grimoire-master': 'Michelangelo',
+    'analyst': 'Vermeer', 'architect': 'Gaudí', 'data-engineer': 'Escher',
+    'pm': 'Raphael', 'po': 'Velázquez', 'squad-creator': 'Rodin',
+  };
+
+  const agentsDir = path.join(cwd, '.codex', 'agents');
+  const availableAgents = fs.existsSync(agentsDir)
+    ? fs.readdirSync(agentsDir).filter(f => f.endsWith('.md')).map(f => f.replace('.md', ''))
+    : [];
+
+  const agentList = availableAgents
+    .map(a => agentNames[a] ? `@${a} (${agentNames[a]})` : `@${a}`)
+    .join(', ');
+
+  console.log(`
+🧙 Grimoire — Who Am I?
+${'='.repeat(40)}
+📌  You are:      ${process.env.USER || process.env.USERNAME || 'unknown user'}
+📂  Project:      ${projectName}
+📍  Directory:    ${cwd}
+💻  IDE:          ${ide}
+🔮  Framework:    Grimoire v${packageJson.version}
+${config.squad ? `👥  Squad:        ${config.squad}` : ''}
+
+🧙 Available Agents:
+  ${agentList || '(none found — run grimoire install)'}
+
+💡 How to activate an agent:
+  In your IDE chat, type:  @dev  or  @qa  or  @grimoire-master
+  The agent will greet you by their persona name (Da Vinci, Dürer, etc.)
+
+🔧 Framework vs CLI:
+  CLI commands  → Run in terminal:    grimoire status | grimoire agents list
+  Agent chat    → Activate in IDE:    @agentname (e.g. @dev, @qa)
+  These are DIFFERENT interfaces — the CLI manages the framework,
+  agents respond inside your IDE's AI chat window.
+`);
+}
+
+function handleDoctor() {
+  const cwd = process.cwd();
+  const check = (p) => fs.existsSync(p);
+  const ok = (v, msg) => console.log(`  ${v ? '✅' : '❌'}  ${msg}`);
+
+  console.log('\n🏥 Grimoire Doctor\n' + '='.repeat(40));
+
+  ok(check(path.join(cwd, '.codex', 'agents')), '.codex/agents directory exists');
+  ok(check(path.join(cwd, '.grimoire')), '.grimoire directory exists');
+  ok(check(path.join(cwd, '.gemini', 'settings.json')), '.gemini/settings.json (hooks configured)');
+  ok(check(path.join(cwd, '.gemini', 'rules')), '.gemini/rules (agent rules installed)');
+  ok(check(path.join(cwd, '.cursor', 'rules')), '.cursor/rules (Cursor integration)');
+
+  // Check package.json has grimoire
+  const pkgPath = path.join(cwd, 'package.json');
+  if (check(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+      ok(!!deps['grimoire-framework'], 'grimoire-framework in package.json');
+    } catch (e) { ok(false, 'package.json readable'); }
+  } else {
+    ok(false, 'package.json found');
+  }
+
+  console.log('\n  Run \'grimoire status\' for full framework state.\n');
+}
+
 function showHelp() {
   console.log(`
-📊 Grimoire Pro CLI v${packageJson.version}
+🔮 Grimoire Framework CLI v${packageJson.version}
+
+  The CLI manages your framework. Agents live in your IDE chat.
+  (These are DIFFERENT — CLI = terminal, Agents = @agentname in IDE chat)
 
 USAGE:
+  grimoire status           # ✨ Framework health & what's active
+  grimoire whoami           # 🧙 Session context & how to use agents
   grimoire install          # Install/Reset setup
-  grimoire agents list      # List available agents
+  grimoire agents list      # List available agents (with personas)
   grimoire squads list      # List installed squads
   grimoire memory [sub]     # Manage persistent memory
   grimoire metrics          # View productivity metrics
-  grimoire doctor           # Run diagnostics
+  grimoire doctor           # Run diagnostics (checks + tips)
   grimoire --version        # Show version
   grimoire --help           # Show this help
+
+QUICK START:
+  npx grimoire-framework install    # Set up in a new project
+  grimoire status                   # Check everything is working
+  grimoire whoami                   # See available agents
+  Then in your IDE chat: @dev  or  @qa  or  @grimoire-master
 `);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grimoire-framework",
-  "version": "1.0.6",
+  "version": "1.0.9",
   "description": "Grimoire: AI-Orchestrated System for Full Stack Development - Core Framework",
   "publishConfig": {
     "access": "public"