grimoire-framework 1.0.9 → 1.0.10

package/.grimoire/install-manifest.yaml

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

package/bin/commands/update.js

@@ -0,0 +1,251 @@
+'use strict';
+
+/**
+ * grimoire Smart Update Command
+ * Updates grimoire-framework preserving project customizations.
+ *
+ * Strategy:
+ *  1. Check installed vs latest version on npm
+ *  2. npm install grimoire-framework@latest
+ *  3. Selectively copy framework files (agents, rules, hooks)
+ *     - OVERWRITE files that are part of the framework source
+ *     - PRESERVE files that only exist in the project (custom agents, etc.)
+ *  4. Report what was updated/preserved
+ */
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const { execSync } = require('child_process');
+
+// Framework source directories (relative to node_modules/grimoire-framework)
+const FRAMEWORK_SYNC_DIRS = [
+    { src: '.codex/agents', dest: '.codex/agents' },
+    { src: '.gemini/rules/grimoire', dest: '.gemini/rules/grimoire' },
+    { src: '.cursor/rules/agents', dest: '.cursor/rules/agents' },
+    { src: '.claude/commands/grimoire', dest: '.claude/commands/grimoire' },
+];
+
+/**
+ * Fetch latest version from npm registry
+ */
+function getLatestVersion() {
+    return new Promise((resolve) => {
+        const req = https.get(
+            'https://registry.npmjs.org/grimoire-framework/latest',
+            { timeout: 10000 },
+            (res) => {
+                let data = '';
+                res.on('data', (chunk) => { data += chunk; });
+                res.on('end', () => {
+                    try { resolve(JSON.parse(data).version || null); }
+                    catch { resolve(null); }
+                });
+            }
+        );
+        req.on('error', () => resolve(null));
+        req.on('timeout', () => { req.destroy(); resolve(null); });
+    });
+}
+
+/**
+ * Get installed version from node_modules
+ */
+function getInstalledVersion(cwd) {
+    const pkgPath = path.join(cwd, 'node_modules', 'grimoire-framework', 'package.json');
+    if (fs.existsSync(pkgPath)) {
+        try { return JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version; }
+        catch { /* ignore */ }
+    }
+    // Fallback: check project package.json dependencies
+    const projPkg = path.join(cwd, 'package.json');
+    if (fs.existsSync(projPkg)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(projPkg, 'utf8'));
+            return (pkg.dependencies || {})['grimoire-framework'] ||
+                (pkg.devDependencies || {})['grimoire-framework'] || null;
+        } catch { /* ignore */ }
+    }
+    return null;
+}
+
+/**
+ * Compare semver strings. Returns: -1 (v1<v2), 0 (equal), 1 (v1>v2)
+ */
+function compareVersions(v1, v2) {
+    const parse = (v) => v.replace(/[^0-9.]/g, '').split('.').map(Number);
+    const [a, b] = [parse(v1), parse(v2)];
+    for (let i = 0; i < 3; i++) {
+        if ((a[i] || 0) > (b[i] || 0)) return 1;
+        if ((a[i] || 0) < (b[i] || 0)) return -1;
+    }
+    return 0;
+}
+
+/**
+ * Recursively get all .md files in a directory
+ */
+function listMdFiles(dir) {
+    if (!fs.existsSync(dir)) return [];
+    const results = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) results.push(...listMdFiles(full));
+        else if (entry.name.endsWith('.md')) results.push(full);
+    }
+    return results;
+}
+
+/**
+ * Sync a directory from framework source to project destination.
+ * - Overwrites files that exist in source (framework files)
+ * - Preserves files that only exist in destination (custom files)
+ * Returns stats: { updated, preserved, added }
+ */
+function syncDir(srcDir, destDir) {
+    const stats = { updated: [], preserved: [], added: [] };
+
+    if (!fs.existsSync(srcDir)) return stats;
+    fs.mkdirSync(destDir, { recursive: true });
+
+    // Get files in both dirs
+    const srcFiles = new Set(
+        fs.readdirSync(srcDir).filter(f => f.endsWith('.md') || f.endsWith('.json') || f.endsWith('.yaml'))
+    );
+    const destFiles = new Set(
+        fs.existsSync(destDir)
+            ? fs.readdirSync(destDir).filter(f => f.endsWith('.md') || f.endsWith('.json') || f.endsWith('.yaml'))
+            : []
+    );
+
+    // Copy/overwrite source files to dest
+    for (const file of srcFiles) {
+        const srcFile = path.join(srcDir, file);
+        const destFile = path.join(destDir, file);
+        const existed = destFiles.has(file);
+        fs.copyFileSync(srcFile, destFile);
+        if (existed) stats.updated.push(file);
+        else stats.added.push(file);
+    }
+
+    // Files in dest but NOT in source = custom files → preserve (do nothing)
+    for (const file of destFiles) {
+        if (!srcFiles.has(file)) {
+            stats.preserved.push(file);
+        }
+    }
+
+    return stats;
+}
+
+/**
+ * Main run function called by the CLI
+ */
+async function run(args = []) {
+    const cwd = process.cwd();
+    const dryRun = args.includes('--dry-run') || args.includes('--check');
+    const force = args.includes('--force');
+    const verbose = args.includes('--verbose') || args.includes('-v');
+
+    console.log('\n🔮 Grimoire Smart Update\n' + '='.repeat(40));
+
+    // 1. Get versions
+    const installed = getInstalledVersion(cwd);
+    process.stdout.write('📡 Checking latest version on npm...');
+    const latest = await getLatestVersion();
+    console.log(latest ? ` v${latest}` : ' (offline)');
+
+    console.log(`📦 Installed: ${installed ? `v${installed}` : '❌ not found in node_modules'}`);
+    console.log(`📦 Latest:    ${latest ? `v${latest}` : '❌ could not fetch'}\n`);
+
+    if (!installed) {
+        console.log('⚠️  grimoire-framework not found in this project.\n   Run: npx grimoire-framework install\n');
+        return;
+    }
+
+    if (!latest) {
+        console.log('⚠️  Could not reach npm registry. Check your internet connection.\n');
+        return;
+    }
+
+    const cmp = compareVersions(installed.replace(/[\^~><=]/g, ''), latest);
+
+    if (cmp >= 0 && !force) {
+        console.log('✅ Already up to date! No update needed.\n');
+        console.log('   Use --force to reinstall anyway.\n');
+        return;
+    }
+
+    if (dryRun) {
+        console.log(`🔍 DRY RUN — would update v${installed} → v${latest}\n`);
+        console.log('   Directories that would be synced:');
+        for (const { dest } of FRAMEWORK_SYNC_DIRS) {
+            console.log(`   • ${dest}`);
+        }
+        console.log('\n   Custom files (only in project) would be PRESERVED.');
+        console.log('   Run without --dry-run to apply.\n');
+        return;
+    }
+
+    // 2. Update npm package
+    console.log(`⬇️  Updating grimoire-framework v${installed} → v${latest}...`);
+    try {
+        execSync('npm install grimoire-framework@latest', {
+            cwd,
+            stdio: verbose ? 'inherit' : 'pipe',
+            timeout: 120000,
+        });
+        console.log('✅ npm package updated.\n');
+    } catch (err) {
+        console.error(`❌ npm install failed: ${err.message}\n`);
+        return;
+    }
+
+    // 3. Sync framework files selectively
+    const frameworkRoot = path.join(cwd, 'node_modules', 'grimoire-framework');
+
+    if (!fs.existsSync(frameworkRoot)) {
+        console.log('❌ Could not find grimoire-framework in node_modules after install.\n');
+        return;
+    }
+
+    console.log('🔄 Syncing framework files...\n');
+
+    const totalStats = { updated: 0, added: 0, preserved: 0 };
+    const report = [];
+
+    for (const { src, dest } of FRAMEWORK_SYNC_DIRS) {
+        const srcPath = path.join(frameworkRoot, src);
+        const destPath = path.join(cwd, dest);
+
+        if (!fs.existsSync(srcPath)) {
+            if (verbose) console.log(`  ⏭️  Skip (not in source): ${src}`);
+            continue;
+        }
+
+        const stats = syncDir(srcPath, destPath);
+        totalStats.updated += stats.updated.length;
+        totalStats.added += stats.added.length;
+        totalStats.preserved += stats.preserved.length;
+
+        report.push({ dir: dest, stats });
+
+        if (stats.updated.length || stats.added.length || stats.preserved.length) {
+            console.log(`  📁 ${dest}`);
+            if (stats.updated.length) console.log(`     ✅ Updated:   ${stats.updated.join(', ')}`);
+            if (stats.added.length) console.log(`     ➕ Added:     ${stats.added.join(', ')}`);
+            if (stats.preserved.length) console.log(`     🔒 Preserved: ${stats.preserved.join(', ')} (custom)`);
+        }
+    }
+
+    // 4. Summary
+    console.log('\n' + '='.repeat(40));
+    console.log(`✅ Updated to v${latest}\n`);
+    console.log(`   📝 Files updated:   ${totalStats.updated}`);
+    console.log(`   ➕ Files added:     ${totalStats.added}`);
+    console.log(`   🔒 Files preserved: ${totalStats.preserved} (custom — untouched)\n`);
+    console.log('   Run: grimoire status   to verify the framework is healthy.');
+    console.log('   Run: grimoire doctor   for full diagnostics.\n');
+}
+
+module.exports = { run };

package/bin/grimoire-cli.js

@@ -33,11 +33,13 @@ async function main() {
     case 'whoami':
       handleWhoami();
       break;
+    case 'update':
+      await require('./commands/update').run(args.slice(1));
+      break;
     case 'doctor':
       handleDoctor();
       break;
     case 'install':
-    case 'update':
     case 'validate':
     case 'info':
       console.log(`Delegating ${command} to core logic...`);

package/package.json

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