grimoire-framework 1.0.3 → 1.0.4

package/packages/gemini-grimoire-extension/commands/lib/agent-launcher.js

@@ -1,147 +1,147 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-const AGENT_INFO = {
-  'grimoire-master': { icon: '🎨', role: 'Leonardo (Master Orchestrator)' },
-  analyst: { icon: '🕯️', role: 'Vermeer (Business Analyst)' },
-  architect: { icon: '🔨', role: 'Michelangelo (System Architect)' },
-  'data-engineer': { icon: '🟦', role: 'Mondrian (Data Engineer)' },
-  dev: { icon: '🖌️', role: 'Rembrandt (Developer)' },
-  devops: { icon: '🚄', role: 'Boccioni (DevOps)' },
-  pm: { icon: '📜', role: 'Raphael (Product Manager)' },
-  po: { icon: '🔍', role: 'Van Eyck (Product Owner)' },
-  qa: { icon: '📐', role: 'Dürer (QA Engineer)' },
-  sm: { icon: '🌊', role: 'Monet (Scrum Master)' },
-  'squad-creator': { icon: '🌀', role: 'Kandinsky (Squad Creator)' },
-  'ux-design-expert': { icon: '🎭', role: 'Matisse (UX Expert)' },
-  salvador: { icon: '🕰️', role: 'Salvador (Creative Engineer)' },
-  frida: { icon: '🌺', role: 'Frida (Resilience Expert)' },
-  'van-gogh': { icon: '🌻', role: 'Van Gogh (Performance Guru)' },
-  warhol: { icon: '🥫', role: 'Warhol (Documentation Expert)' },
-  caravaggio: { icon: '🔦', role: 'Caravaggio (Security Auditor)' },
-  picasso: { icon: '💠', role: 'Picasso (Refactoring Specialist)' },
-  tarsila: { icon: '🌵', role: 'Tarsila (Localization Expert)' },
-};
-
-function listAvailableAgents(projectRoot = process.cwd()) {
-  const sourceDir = path.join(projectRoot, '.grimoire', 'development', 'agents');
-  if (!fs.existsSync(sourceDir)) return [];
-  return fs
-    .readdirSync(sourceDir)
-    .filter((f) => f.endsWith('.md') && !f.startsWith('_'))
-    .map((f) => f.replace('.md', ''))
-    .sort();
-}
-
-function commandNameForAgent(agentId) {
-  if (agentId.startsWith('grimoire-')) {
-    return `/grimoire-${agentId.replace(/^grimoire-/, '')}`;
-  }
-  return `/grimoire-${agentId}`;
-}
-
-function hasAgent(projectRoot, agentId) {
-  const canonical = path.join(projectRoot, '.grimoire', 'development', 'agents', `${agentId}.md`);
-  const gemini = path.join(projectRoot, '.gemini', 'rules', 'grimoire', 'agents', `${agentId}.md`);
-  return fs.existsSync(canonical) || fs.existsSync(gemini);
-}
-
-function renderGreeting(projectRoot, agentId) {
-  const scriptPath = path.join(projectRoot, '.grimoire', 'development', 'scripts', 'generate-greeting.js');
-  if (!fs.existsSync(scriptPath)) {
-    return null;
-  }
-
-  const result = spawnSync('node', [scriptPath, agentId], {
-    cwd: projectRoot,
-    encoding: 'utf8',
-    timeout: 10000,
-  });
-
-  if (result.status !== 0) {
-    return null;
-  }
-
-  return (result.stdout || '').trim() || null;
-}
-
-function buildActivationPrompt(agentId) {
-  return [
-    `Ative o agente ${agentId} usando .grimoire/development/agents/${agentId}.md`,
-    `(fallback: .gemini/rules/grimoire/agents/${agentId}.md),`,
-    `renderize o greeting via node .grimoire/development/scripts/generate-greeting.js ${agentId}`,
-    'e mantenha a persona ate *exit.',
-  ].join(' ');
-}
-
-function runAgentLauncher(agentId, projectRoot = process.cwd()) {
-  if (!agentId) {
-    console.log('Uso: /grimoire-agent <agent-id>');
-    return 1;
-  }
-
-  if (!hasAgent(projectRoot, agentId)) {
-    const available = listAvailableAgents(projectRoot);
-    console.log(`❌ Agente não encontrado: ${agentId}`);
-    if (available.length > 0) {
-      console.log('\nAgentes disponíveis:');
-      for (const id of available) {
-        console.log(`- ${commandNameForAgent(id)}`);
-      }
-    }
-    return 1;
-  }
-
-  const info = AGENT_INFO[agentId] || { icon: '🤖', role: 'Agent' };
-  const activationPrompt = buildActivationPrompt(agentId);
-  const greeting = renderGreeting(projectRoot, agentId);
-
-  console.log(`${info.icon} grimoire Agent Selected: ${agentId}`);
-  console.log(`Role: ${info.role}`);
-  console.log('');
-  console.log('Activation Prompt (copy and send as your next message):');
-  console.log(activationPrompt);
-
-  if (greeting) {
-    console.log('\nGreeting Preview:');
-    console.log(greeting.split('\n').slice(0, 8).join('\n'));
-  }
-
-  return 0;
-}
-
-function runAgentMenu(projectRoot = process.cwd()) {
-  const agents = listAvailableAgents(projectRoot);
-
-  console.log('🤖 grimoire Quick Agent Menu (Gemini)');
-  console.log('');
-
-  if (agents.length === 0) {
-    console.log('No grimoire agents found. Run: npm run sync:ide:gemini');
-    return 1;
-  }
-
-  for (const id of agents) {
-    const info = AGENT_INFO[id] || { icon: '🤖', role: 'Agent' };
-    console.log(`${info.icon} ${commandNameForAgent(id)}  (${info.role})`);
-  }
-
-  console.log('\nTip: run /grimoire-<agent-id> to prepare activation prompt quickly.');
-  return 0;
-}
-
-module.exports = {
-  AGENT_INFO,
-  listAvailableAgents,
-  hasAgent,
-  buildActivationPrompt,
-  commandNameForAgent,
-  runAgentLauncher,
-  runAgentMenu,
-};
-
-
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const AGENT_INFO = {
+  'grimoire-master': { icon: '🎨', role: 'Leonardo (Master Orchestrator)' },
+  analyst: { icon: '🕯️', role: 'Vermeer (Business Analyst)' },
+  architect: { icon: '🔨', role: 'Michelangelo (System Architect)' },
+  'data-engineer': { icon: '🟦', role: 'Mondrian (Data Engineer)' },
+  dev: { icon: '🖌️', role: 'Rembrandt (Developer)' },
+  devops: { icon: '🚄', role: 'Boccioni (DevOps)' },
+  pm: { icon: '📜', role: 'Raphael (Product Manager)' },
+  po: { icon: '🔍', role: 'Van Eyck (Product Owner)' },
+  qa: { icon: '📐', role: 'Dürer (QA Engineer)' },
+  sm: { icon: '🌊', role: 'Monet (Scrum Master)' },
+  'squad-creator': { icon: '🌀', role: 'Kandinsky (Squad Creator)' },
+  'ux-design-expert': { icon: '🎭', role: 'Matisse (UX Expert)' },
+  salvador: { icon: '🕰️', role: 'Salvador (Creative Engineer)' },
+  frida: { icon: '🌺', role: 'Frida (Resilience Expert)' },
+  'van-gogh': { icon: '🌻', role: 'Van Gogh (Performance Guru)' },
+  warhol: { icon: '🥫', role: 'Warhol (Documentation Expert)' },
+  caravaggio: { icon: '🔦', role: 'Caravaggio (Security Auditor)' },
+  picasso: { icon: '💠', role: 'Picasso (Refactoring Specialist)' },
+  tarsila: { icon: '🌵', role: 'Tarsila (Localization Expert)' },
+};
+
+function listAvailableAgents(projectRoot = process.cwd()) {
+  const sourceDir = path.join(projectRoot, '.grimoire', 'development', 'agents');
+  if (!fs.existsSync(sourceDir)) return [];
+  return fs
+    .readdirSync(sourceDir)
+    .filter((f) => f.endsWith('.md') && !f.startsWith('_'))
+    .map((f) => f.replace('.md', ''))
+    .sort();
+}
+
+function commandNameForAgent(agentId) {
+  if (agentId.startsWith('grimoire-')) {
+    return `/grimoire-${agentId.replace(/^grimoire-/, '')}`;
+  }
+  return `/grimoire-${agentId}`;
+}
+
+function hasAgent(projectRoot, agentId) {
+  const canonical = path.join(projectRoot, '.grimoire', 'development', 'agents', `${agentId}.md`);
+  const gemini = path.join(projectRoot, '.gemini', 'rules', 'grimoire', 'agents', `${agentId}.md`);
+  return fs.existsSync(canonical) || fs.existsSync(gemini);
+}
+
+function renderGreeting(projectRoot, agentId) {
+  const scriptPath = path.join(projectRoot, '.grimoire', 'development', 'scripts', 'generate-greeting.js');
+  if (!fs.existsSync(scriptPath)) {
+    return null;
+  }
+
+  const result = spawnSync('node', [scriptPath, agentId], {
+    cwd: projectRoot,
+    encoding: 'utf8',
+    timeout: 10000,
+  });
+
+  if (result.status !== 0) {
+    return null;
+  }
+
+  return (result.stdout || '').trim() || null;
+}
+
+function buildActivationPrompt(agentId) {
+  return [
+    `Ative o agente ${agentId} usando .grimoire/development/agents/${agentId}.md`,
+    `(fallback: .gemini/rules/grimoire/agents/${agentId}.md),`,
+    `renderize o greeting via node .grimoire/development/scripts/generate-greeting.js ${agentId}`,
+    'e mantenha a persona ate *exit.',
+  ].join(' ');
+}
+
+function runAgentLauncher(agentId, projectRoot = process.cwd()) {
+  if (!agentId) {
+    console.log('Uso: /grimoire-agent <agent-id>');
+    return 1;
+  }
+
+  if (!hasAgent(projectRoot, agentId)) {
+    const available = listAvailableAgents(projectRoot);
+    console.log(`❌ Agente não encontrado: ${agentId}`);
+    if (available.length > 0) {
+      console.log('\nAgentes disponíveis:');
+      for (const id of available) {
+        console.log(`- ${commandNameForAgent(id)}`);
+      }
+    }
+    return 1;
+  }
+
+  const info = AGENT_INFO[agentId] || { icon: '🤖', role: 'Agent' };
+  const activationPrompt = buildActivationPrompt(agentId);
+  const greeting = renderGreeting(projectRoot, agentId);
+
+  console.log(`${info.icon} grimoire Agent Selected: ${agentId}`);
+  console.log(`Role: ${info.role}`);
+  console.log('');
+  console.log('Activation Prompt (copy and send as your next message):');
+  console.log(activationPrompt);
+
+  if (greeting) {
+    console.log('\nGreeting Preview:');
+    console.log(greeting.split('\n').slice(0, 8).join('\n'));
+  }
+
+  return 0;
+}
+
+function runAgentMenu(projectRoot = process.cwd()) {
+  const agents = listAvailableAgents(projectRoot);
+
+  console.log('🤖 grimoire Quick Agent Menu (Gemini)');
+  console.log('');
+
+  if (agents.length === 0) {
+    console.log('No grimoire agents found. Run: npm run sync:ide:gemini');
+    return 1;
+  }
+
+  for (const id of agents) {
+    const info = AGENT_INFO[id] || { icon: '🤖', role: 'Agent' };
+    console.log(`${info.icon} ${commandNameForAgent(id)}  (${info.role})`);
+  }
+
+  console.log('\nTip: run /grimoire-<agent-id> to prepare activation prompt quickly.');
+  return 0;
+}
+
+module.exports = {
+  AGENT_INFO,
+  listAvailableAgents,
+  hasAgent,
+  buildActivationPrompt,
+  commandNameForAgent,
+  runAgentLauncher,
+  runAgentMenu,
+};
+
+

package/packages/gemini-grimoire-extension/extension.json

@@ -145,5 +145,5 @@
     "multi-agent"
   ]
 }
-
-
+
+

package/packages/gemini-grimoire-extension/gemini-extension.json

@@ -145,5 +145,5 @@
     "multi-agent"
   ]
 }
-
-
+
+

package/packages/gemini-grimoire-extension/hooks/hooks.json

@@ -68,5 +68,5 @@
     ]
   }
 }
-
-
+
+

package/packages/grimoire-install/.releaserc.json

@@ -36,4 +36,4 @@
     "@semantic-release/github"
   ]
 }
-
+

package/packages/grimoire-install/CHANGELOG.md

@@ -30,4 +30,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ---
 
 *Generated by [semantic-release](https://github.com/semantic-release/semantic-release) and [conventional-changelog](https://github.com/conventional-changelog/conventional-changelog)*
-
+

package/packages/grimoire-install/README.md

@@ -115,5 +115,5 @@ If you have an existing grimoire installation, the installer will:
 ## License
 
 MIT
-
-
+
+

package/packages/grimoire-install/bin/edmcp.js

@@ -77,4 +77,4 @@ program.parse(process.argv);
 if (!process.argv.slice(2).length) {
   program.outputHelp();
 }
-
+

package/packages/grimoire-install/bin/grimoire-install.js

@@ -48,4 +48,4 @@ program
   });
 
 program.parse(process.argv);
-
+

package/packages/grimoire-install/jest.config.js

@@ -24,4 +24,4 @@ module.exports = {
   ],
   verbose: true,
 };
-
+

package/packages/grimoire-install/package.json

@@ -64,5 +64,5 @@
     "access": "public"
   }
 }
-
-
+
+

package/packages/grimoire-install/src/edmcp/index.js

@@ -379,4 +379,4 @@ module.exports = {
   removeMcp,
   parseMcpSource,
 };
-
+

package/packages/grimoire-install/src/installer.js

@@ -483,5 +483,5 @@ module.exports = {
   tryLoadConfigResolver,
   createUserConfigDirect,
 };
-
-
+
+

package/packages/grimoire-pro-cli/bin/grimoire-pro.js

@@ -229,5 +229,5 @@ switch (command) {
     showHelp();
     process.exit(1);
 }
-
-
+
+

package/packages/grimoire-pro-cli/package.json

@@ -34,5 +34,5 @@
     "registry": "https://registry.npmjs.org"
   }
 }
-
-
+
+

package/packages/grimoire-pro-cli/src/recover.js

@@ -98,4 +98,4 @@ async function recoverLicense() {
 }
 
 module.exports = { recoverLicense, maskEmail, promptEmail, openBrowser, RECOVERY_URL, RECOVERY_MESSAGE };
-
+

package/packages/installer/package.json

@@ -37,4 +37,4 @@
   }
 }
 
-
+

package/packages/installer/src/__tests__/performance-benchmark.js

@@ -380,5 +380,5 @@ runBenchmarks().catch((err) => {
   console.error('Benchmark failed:', err);
   process.exit(1);
 });
-
-
+
+

package/packages/installer/src/config/configure-environment.js

@@ -369,5 +369,5 @@ module.exports = {
   collectApiKeys,
   updateGitignore,
 };
-
-
+
+

package/packages/installer/src/config/ide-configs.js

@@ -157,5 +157,5 @@ module.exports = {
   isValidIDE,
   getIDEChoices,
 };
-
-
+
+

package/packages/installer/src/config/templates/core-config-template.js

@@ -195,5 +195,5 @@ function generateCoreConfig(options = {}) {
 module.exports = {
   generateCoreConfig,
 };
-
-
+
+

package/packages/installer/src/config/templates/env-template.js

@@ -268,5 +268,5 @@ module.exports = {
   generateEnvContent,
   generateEnvExample,
 };
-
-
+
+

package/packages/installer/src/config/validation/config-validator.js

@@ -241,4 +241,4 @@ module.exports = {
   validatePath,
   sanitizeInput,
 };
-
+

package/packages/installer/src/detection/detect-project-type.js

@@ -79,5 +79,5 @@ function detectProjectType(targetDir = process.cwd()) {
 
 module.exports = { detectProjectType };
 
-
-
+
+

package/packages/installer/src/installer/brownfield-upgrader.js

@@ -436,5 +436,5 @@ module.exports = {
   buildFileMap,
   isUserModified,
 };
-
-
+
+

package/packages/installer/src/installer/grimoire-core-installer.js

@@ -424,5 +424,5 @@ module.exports = {
   FOLDERS_TO_COPY,
   ROOT_FILES_TO_COPY,
 };
-
-
+
+

package/packages/installer/src/installer/manifest-signature.js

@@ -376,5 +376,5 @@ module.exports = {
   PINNED_PUBLIC_KEY,
   SignatureLimits,
 };
-
-
+
+

package/packages/installer/src/installer/post-install-validator.js

@@ -1520,5 +1520,5 @@ module.exports = {
   isPathContained,
   validateManifestEntry,
 };
-
-
+
+

package/packages/installer/src/installer/squad-installer.js

@@ -0,0 +1,109 @@
+/**
+ * Squad Installer
+ *
+ * Handles copying selected squads from the framework to the target project.
+ *
+ * @module installer/squad-installer
+ */
+
+const path = require('path');
+const fse = require('fs-extra');
+
+/**
+ * Install selected squads to the target project
+ *
+ * @param {Object} options - Installation options
+ * @param {string} options.targetDir - Target project directory
+ * @param {string[]} options.selectedSquads - List of squad IDs to install
+ * @param {Function} [options.onProgress] - Progress callback
+ * @returns {Promise<Object>} Installation result
+ */
+async function installSquads(options = {}) {
+  const {
+    targetDir = process.cwd(),
+    selectedSquads = [],
+    onProgress = () => {},
+  } = options;
+
+  if (selectedSquads.length === 0) {
+    return { success: true, installedSquads: [], skipped: true };
+  }
+
+  const results = {
+    success: true,
+    installedSquads: [],
+    errors: [],
+  };
+
+  try {
+    // 1. Locate source squads directory
+    // In framework-dev mode, it's in the root
+    // In installed mode, it's inside the package
+    const possibleSourceDirs = [
+      path.join(__dirname, '..', '..', '..', '..', 'squads'), // Root squads/
+      path.join(targetDir, '.grimoire', 'squads'), // Fallback if already there
+    ];
+
+    let sourceSquadsDir = null;
+    for (const dir of possibleSourceDirs) {
+      if (await fse.pathExists(dir)) {
+        sourceSquadsDir = dir;
+        break;
+      }
+    }
+
+    if (!sourceSquadsDir) {
+      throw new Error('Source squads directory not found');
+    }
+
+    // 2. Prepare target directory
+    const targetSquadsDir = path.join(targetDir, '.grimoire', 'squads');
+    await fse.ensureDir(targetSquadsDir);
+
+    // 3. Copy each selected squad
+    for (const squadId of selectedSquads) {
+      const sourceSquadPath = path.join(sourceSquadsDir, squadId);
+      const targetSquadPath = path.join(targetSquadsDir, squadId);
+
+      onProgress({ step: 'squad', message: `Installing squad: ${squadId}...` });
+
+      if (await fse.pathExists(sourceSquadPath)) {
+        // Guard against source === dest
+        if (path.resolve(sourceSquadPath) !== path.resolve(targetSquadPath)) {
+          await fse.copy(sourceSquadPath, targetSquadPath, {
+            overwrite: true,
+            preserveTimestamps: true,
+          });
+        }
+        results.installedSquads.push(squadId);
+      } else {
+        results.errors.push(`Squad source not found: ${squadId}`);
+      }
+    }
+
+    // 4. Copy README if it exists
+    const sourceReadme = path.join(sourceSquadsDir, 'README.md');
+    const targetReadme = path.join(targetSquadsDir, 'README.md');
+    if (await fse.pathExists(sourceReadme)) {
+      if (path.resolve(sourceReadme) !== path.resolve(targetReadme)) {
+        await fse.copy(sourceReadme, targetReadme);
+      }
+    }
+
+    if (results.errors.length > 0 && results.installedSquads.length === 0) {
+      results.success = false;
+    }
+
+    return results;
+  } catch (error) {
+    return {
+      success: false,
+      installedSquads: results.installedSquads,
+      error: error.message,
+    };
+  }
+}
+
+module.exports = {
+  installSquads,
+};

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

@@ -69,4 +69,4 @@ module.exports = {
   slugify,
   hasgrimoireMarkers,
 };
-
+

package/packages/installer/src/merger/parsers/markdown-section-parser.js

@@ -196,4 +196,4 @@ module.exports = {
   hasgrimoireMarkers,
   getgrimoireSectionIds,
 };
-
+

package/packages/installer/src/merger/strategies/env-merger.js

@@ -135,4 +135,4 @@ class EnvMerger extends BaseMerger {
 }
 
 module.exports = { EnvMerger };
-
+

package/packages/installer/src/merger/strategies/markdown-merger.js

@@ -205,4 +205,4 @@ class MarkdownMerger extends BaseMerger {
 }
 
 module.exports = { MarkdownMerger };
-
+