grimoire-framework 1.0.15 → 1.0.17

package/.grimoire/install-manifest.yaml

@@ -7,8 +7,8 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.0.15
-generated_at: "2026-02-22T12:55:59.388Z"
+version: 1.0.17
+generated_at: "2026-02-22T13:53:52.136Z"
 generator: scripts/generate-install-manifest.js
 file_count: 1011
 files:

package/bin/commands/update.js

@@ -29,6 +29,7 @@ const FRAMEWORK_SYNC_DIRS = [
 // Single files to sync (framework root → project root)
 const FRAMEWORK_SYNC_FILES = [
     { src: 'GEMINI.md', dest: 'GEMINI.md' },
+    { src: '.grimoire/product/templates/ide-rules/gemini-rules.md', dest: path.join('.gemini', 'rules.md') },
 ];
 
 /**

package/bin/grimoire-cli.js

@@ -132,12 +132,22 @@ function handleStatus() {
   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'));
+  const hasGeminiMd = check(path.join(cwd, 'GEMINI.md'));
+  const hasGeminiRules = check(path.join(cwd, '.gemini', 'rules.md'));
+
+  // Check GEMINI.md has correct persona
+  let geminiPersonaOk = false;
+  if (hasGeminiMd) {
+    try {
+      const content = fs.readFileSync(path.join(cwd, 'GEMINI.md'), 'utf8');
+      geminiPersonaOk = content.includes('Michelangelo');
+    } catch (e) { /* ignore */ }
+  }
 
   // Hooks check
   const settingsPath = path.join(cwd, '.gemini', 'settings.json');
@@ -162,44 +172,41 @@ function handleStatus() {
   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 */ }
+  // Installed version vs package.json
+  const installedPkgPath = path.join(cwd, 'node_modules', 'grimoire-framework', 'package.json');
+  let installedVersion = null;
+  if (check(installedPkgPath)) {
+    try { installedVersion = JSON.parse(fs.readFileSync(installedPkgPath, 'utf8')).version; } catch (e) { }
   }
+  const versionMatch = installedVersion === packageJson.version;
 
   console.log(`
 🔮 Grimoire Framework Status
 ${'='.repeat(40)}
-📎  Version:   v${packageJson.version}
-📁  Project:   ${cwd}
+📎  Version:   v${packageJson.version}${installedVersion && !versionMatch ? ` (project has v${installedVersion})` : ''}
+📁  Project:   ${path.basename(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(hasGeminiMd)}  GEMINI.md      (Gemini CLI — primary config)
+  ${icon(geminiPersonaOk)}  Michelangelo persona active
+  ${icon(hasGeminiRules)}  .gemini/rules.md  (compatibility fallback)
   ${icon(hasCursor)}  .cursor        (Cursor rules)
   ${icon(hasClaude)}  .claude        (Claude commands)
 
+🪝 Hooks (Gemini CLI)
+  ${icon(check(settingsPath))}  settings.json
+  ${icon(hooksActive)}  Hooks:   ${hooksActive ? hooks.length + ' configured' : 'none'}
+
 💾 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.
+${!hasGeminiMd || !geminiPersonaOk ? '⚠️  Run: npx grimoire-framework update --force    to fix missing files\n' : ''}  Run 'grimoire agents list' to see all agents.
+  Run 'grimoire doctor'     for diagnostics with tips.
 `);
 }
 
@@ -276,29 +283,95 @@ ${config.squad ? `👥  Squad:        ${config.squad}` : ''}
 function handleDoctor() {
   const cwd = process.cwd();
   const check = (p) => fs.existsSync(p);
-  const ok = (v, msg) => console.log(`  ${v ? '✅' : '❌'}  ${msg}`);
+  const ok = (v, msg, hint) => {
+    console.log(`  ${v ? '✅' : '❌'}  ${msg}`);
+    if (!v && hint) console.log(`       💡 ${hint}`);
+  };
+  const warn = (v, msg, hint) => {
+    console.log(`  ${v ? '✅' : '⚠️ '}  ${msg}`);
+    if (!v && hint) console.log(`       💡 ${hint}`);
+  };
 
   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)');
+  // ── Gemini CLI Integration ──────────────────────────────────────
+  console.log('\n💻 Gemini CLI Integration:');
+  const geminiMdPath = path.join(cwd, 'GEMINI.md');
+  const rulesPath = path.join(cwd, '.gemini', 'rules.md');
+  const hasGeminiMd = check(geminiMdPath);
+  const hasRulesMd = check(rulesPath);
+
+  ok(hasGeminiMd, 'GEMINI.md (primary config for modern Gemini CLI)',
+    'Run: npx grimoire-framework update --force');
+  warn(hasRulesMd, '.gemini/rules.md (compatibility fallback)',
+    'Run: npx grimoire-framework update --force');
 
-  // Check package.json has grimoire
+  if (hasGeminiMd) {
+    try {
+      const content = fs.readFileSync(geminiMdPath, 'utf8');
+      ok(content.includes('Michelangelo'), 'Michelangelo persona in GEMINI.md',
+        'GEMINI.md may be outdated — run: npx grimoire-framework update --force');
+      ok(content.includes('@dev'), 'Agent roster in GEMINI.md',
+        'GEMINI.md is missing the agent roster');
+    } catch (e) { ok(false, 'GEMINI.md readable'); }
+  }
+
+  // ── Agents ─────────────────────────────────────────────────────
+  console.log('\n🤖 Agents:');
+  const agentsDir = path.join(cwd, '.codex', 'agents');
+  ok(check(agentsDir), '.codex/agents directory', 'Run: npx grimoire-framework update --force');
+  if (check(agentsDir)) {
+    const agents = fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'));
+    ok(agents.length >= 10, `Core agents installed (${agents.length} found, need ≥10)`,
+      'Run: npx grimoire-framework update --force');
+
+    const requiredAgents = ['grimoire-master.md', 'dev.md', 'qa.md', 'architect.md', 'pm.md'];
+    for (const a of requiredAgents) {
+      warn(agents.includes(a), `Agent: ${a.replace('.md', '')}`);
+    }
+
+    // Check grimoire-master has Michelangelo
+    const masterPath = path.join(agentsDir, 'grimoire-master.md');
+    if (check(masterPath)) {
+      try {
+        const content = fs.readFileSync(masterPath, 'utf8');
+        ok(content.includes('Michelangelo'), 'grimoire-master has Michelangelo persona',
+          'Outdated agent — run: npx grimoire-framework update --force');
+      } catch (e) { }
+    }
+  }
+
+  // ── Framework Package ──────────────────────────────────────────
+  console.log('\n📦 Package:');
   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');
+      ok(!!deps['grimoire-framework'], 'grimoire-framework in package.json',
+        'Run: npm install grimoire-framework');
+
+      // Check installed version vs latest
+      const installedPkgPath = path.join(cwd, 'node_modules', 'grimoire-framework', 'package.json');
+      if (check(installedPkgPath)) {
+        try {
+          const installedVer = JSON.parse(fs.readFileSync(installedPkgPath, 'utf8')).version;
+          const declaredVer = (deps['grimoire-framework'] || '').replace(/[^0-9.]/g, '');
+          ok(true, `Installed version: v${installedVer}`);
+        } catch (e) { }
+      }
     } catch (e) { ok(false, 'package.json readable'); }
   } else {
     ok(false, 'package.json found');
   }
 
-  console.log('\n  Run \'grimoire status\' for full framework state.\n');
+  // ── Other IDEs ────────────────────────────────────────────────
+  console.log('\n🔗 Other IDE Integration:');
+  warn(check(path.join(cwd, '.cursor', 'rules')), '.cursor/rules (Cursor)');
+  warn(check(path.join(cwd, '.claude')), '.claude/ (Claude Code)');
+
+  console.log('\n  Run \'grimoire status\' for full framework state.');
+  console.log('  Run \'npx grimoire-framework update --force\' to resync all files.\n');
 }
 
 function showHelp() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grimoire-framework",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "Grimoire: AI-Orchestrated System for Full Stack Development - Core Framework",
   "publishConfig": {
     "access": "public"
@@ -77,7 +77,7 @@
     "validate:semantic-lint": "node scripts/semantic-lint.js",
     "manifest:ensure": "node scripts/ensure-manifest.js",
     "sync:ide:cursor": "node .grimoire/infrastructure/scripts/ide-sync/index.js sync --ide cursor",
-    "prepublishOnly": "npm run generate:manifest && npm run validate:manifest",
+    "prepublishOnly": "node scripts/pre-publish-check.js && npm run generate:manifest && npm run validate:manifest",
     "prepare": "husky"
   },
   "dependencies": {

package/packages/installer/src/updater/index.js

@@ -5,6 +5,10 @@
  * @module packages/installer/src/updater
  * @story Epic 7 - CLI Update Command
  * @version 1.0.0
+ * @deprecated Use bin/commands/update.js instead.
+ *   The new smart update command (grimoire-framework@1.0.10+) replaces this class.
+ *   This file is kept for backwards compatibility of the installer wizard only.
+ *   DO NOT add new update logic here — use bin/commands/update.js.
  *
  * Features:
  * - Detects installed version vs latest available

package/scripts/pre-publish-check.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * pre-publish-check.js
+ * Validates that all critical files are included in the npm package before publish.
+ * Run: node scripts/pre-publish-check.js
+ * 
+ * Bloqueia o publish se arquivos críticos estiverem faltando.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const ROOT = path.resolve(__dirname, '..');
+const PASS = '✅';
+const FAIL = '❌';
+const WARN = '⚠️ ';
+
+let hasErrors = false;
+
+function check(label, condition, errorMsg) {
+    if (condition) {
+        console.log(`  ${PASS} ${label}`);
+    } else {
+        console.log(`  ${FAIL} ${label}`);
+        console.log(`     → ${errorMsg}`);
+        hasErrors = true;
+    }
+}
+
+function warn(label, condition, warnMsg) {
+    if (condition) {
+        console.log(`  ${PASS} ${label}`);
+    } else {
+        console.log(`  ${WARN} ${label}`);
+        console.log(`     → ${warnMsg}`);
+    }
+}
+
+console.log('\n🔍 Grimoire Framework — Pre-Publish Quality Gate\n' + '='.repeat(50));
+
+// ── 1. Critical root files ─────────────────────────────────────────────────
+console.log('\n📄 Critical root files:');
+check('GEMINI.md exists', fs.existsSync(path.join(ROOT, 'GEMINI.md')), 'GEMINI.md is required for Gemini CLI integration');
+check('README.md exists', fs.existsSync(path.join(ROOT, 'README.md')), 'README.md missing');
+check('LICENSE exists', fs.existsSync(path.join(ROOT, 'LICENSE')), 'LICENSE file missing');
+
+// ── 2. package.json files[] validation ────────────────────────────────────
+console.log('\n📦 package.json files[] field:');
+const pkg = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8'));
+const files = pkg.files || [];
+
+const requiredInFiles = [
+    'GEMINI.md',
+    '.codex/',
+    '.gemini/',
+    '.cursor/',
+    '.grimoire/',
+    'bin/',
+];
+
+for (const required of requiredInFiles) {
+    check(
+        `files[] includes "${required}"`,
+        files.some(f => f === required || f.startsWith(required.replace('/', ''))),
+        `Add "${required}" to the "files" array in package.json`
+    );
+}
+
+// ── 3. Binary entry points ─────────────────────────────────────────────────
+console.log('\n⚙️  Binary entry points (bin/):');
+const binEntries = pkg.bin || {};
+const CORRECT_CLI = 'bin/grimoire-cli.js';
+
+for (const [name, script] of Object.entries(binEntries)) {
+    if (name === 'grimoire-minimal') continue; // known exception
+    check(
+        `"${name}" → ${script}`,
+        script === CORRECT_CLI,
+        `Binary "${name}" points to "${script}" but should point to "${CORRECT_CLI}"`
+    );
+}
+
+// ── 4. .codex/agents presence ─────────────────────────────────────────────
+console.log('\n🤖 Agents (.codex/agents):');
+const agentsDir = path.join(ROOT, '.codex', 'agents');
+const requiredAgents = [
+    'grimoire-master.md', 'dev.md', 'qa.md', 'architect.md',
+    'pm.md', 'po.md', 'sm.md', 'devops.md',
+    'data-engineer.md', 'analyst.md', 'ux-design-expert.md', 'squad-creator.md',
+];
+
+if (fs.existsSync(agentsDir)) {
+    const existingAgents = fs.readdirSync(agentsDir);
+    check(
+        `At least ${requiredAgents.length} core agents exist (found ${existingAgents.length})`,
+        existingAgents.length >= requiredAgents.length,
+        `Expected ${requiredAgents.length} agents, found ${existingAgents.length}`
+    );
+    for (const agent of requiredAgents) {
+        check(
+            `Agent: ${agent}`,
+            existingAgents.includes(agent),
+            `Missing required agent file: .codex/agents/${agent}`
+        );
+    }
+} else {
+    check('.codex/agents/ directory exists', false, '.codex/agents/ directory is missing');
+}
+
+// ── 5. GEMINI.md content validation ───────────────────────────────────────
+console.log('\n📝 GEMINI.md content:');
+const geminiMd = path.join(ROOT, 'GEMINI.md');
+if (fs.existsSync(geminiMd)) {
+    const content = fs.readFileSync(geminiMd, 'utf8');
+    check('Contains Michelangelo persona', content.includes('Michelangelo'), 'GEMINI.md must define Michelangelo as default agent');
+    check('Contains agent roster', content.includes('@dev'), 'GEMINI.md should include agent roster');
+    check('Non-empty (>500 chars)', content.length > 500, 'GEMINI.md seems too short, may be incomplete');
+}
+
+// ── 6. bin/grimoire-cli.js entry point ────────────────────────────────────
+console.log('\n🚀 CLI entry point:');
+const cliPath = path.join(ROOT, 'bin', 'grimoire-cli.js');
+if (fs.existsSync(cliPath)) {
+    const cliContent = fs.readFileSync(cliPath, 'utf8');
+    check('commands/update.js is used (not grimoireUpdater)',
+        cliContent.includes("require('./commands/update')"),
+        'grimoire-cli.js should delegate update to commands/update.js'
+    );
+    check('No direct reference to old updater',
+        !cliContent.includes('grimoireUpdater'),
+        'grimoire-cli.js still references old grimoireUpdater'
+    );
+}
+
+// ── 7. npm pack dry-run to count files ────────────────────────────────────
+console.log('\n📦 npm pack dry-run:');
+try {
+    const packOutput = execSync('npm pack --dry-run 2>&1', { cwd: ROOT, encoding: 'utf8' });
+    const fileCount = (packOutput.match(/npm notice \d+\.\d+[kBMG]B/g) || []).length;
+    warn(
+        `Package contains files (detected ~${fileCount} size entries)`,
+        fileCount > 10,
+        'Very few files detected in package — check the files[] field'
+    );
+
+    const hasGeminiMd = packOutput.includes('GEMINI.md');
+    check('GEMINI.md is in the published package', hasGeminiMd, 'GEMINI.md not found in npm pack output — add to files[]');
+
+    const hasCodex = packOutput.includes('.codex/');
+    check('.codex/ agents are in the published package', hasCodex, '.codex/ not found in npm pack output — add to files[]');
+} catch (err) {
+    warn('npm pack dry-run', false, `Could not run npm pack: ${err.message}`);
+}
+
+// ── Summary ────────────────────────────────────────────────────────────────
+console.log('\n' + '='.repeat(50));
+if (hasErrors) {
+    console.log('❌ Pre-publish check FAILED — fix the errors above before publishing.\n');
+    process.exit(1);
+} else {
+    console.log('✅ All checks passed — safe to publish!\n');
+    process.exit(0);
+}