@esquadrao/cli 0.0.0-stage → 1.6.0

package/src/commands/role.js

@@ -0,0 +1,119 @@
+// CLI command: esquadrao role [list|info|prompt|matrix]
+import { listRoles, getRole, READ_ONLY_ROLES, FORBIDDEN_COMMAND_PATTERNS } from '../roles/index.js';
+
+export async function run({ positionals = [], flags = {} } = {}) {
+  const sub = positionals[0] || 'list';
+
+  if (flags.help || sub === 'help') {
+    console.log(`Esquadrão Roles Command
+
+Usage:
+  esquadrao role [subcommand] [arguments] [options]
+
+Subcommands:
+  list              List all standard industry engineering roles (default)
+  info <id>         Display role specification, capabilities, and authority
+  prompt <id>       Generate calibrated prompt for an agent role
+  matrix            Display structural authority matrix and permission boundaries
+
+Options:
+  --json            Output results in JSON format
+  -h, --help        Show this help message`);
+    return;
+  }
+
+  if (sub === 'list') {
+    const roles = listRoles();
+    if (flags.json) {
+      console.log(JSON.stringify(roles, null, 2));
+      return;
+    }
+    console.log('Roles Matrix:\n');
+    for (const r of roles) {
+      const roTag = r.readOnly ? '[READ-ONLY]' : '[READ/WRITE]';
+      console.log(`  ${r.id.padEnd(22)} ${roTag.padEnd(14)} ${r.title}`);
+      console.log(`    Description:  ${r.description}`);
+      console.log(`    Capabilities: ${r.requiredCapabilities.join(', ')}`);
+      if (r.formerName) console.log(`    Former name:  ${r.formerName}`);
+      console.log('');
+    }
+    return;
+  }
+
+  if (sub === 'info') {
+    const target = positionals[1];
+    if (!target) {
+      console.error('Error: Missing role identifier. Usage: esquadrao role info <role_id>');
+      process.exit(1);
+    }
+    const roleMod = getRole(target);
+    if (!roleMod) {
+      console.error(`Error: Unknown role '${target}'. Run 'esquadrao role list' to see available roles.`);
+      process.exit(1);
+    }
+    if (flags.json) {
+      console.log(JSON.stringify(roleMod.definition, null, 2));
+      return;
+    }
+    const def = roleMod.definition;
+    console.log(`Role Specification: ${def.title} (${def.id})`);
+    console.log(`--------------------------------------------------`);
+    console.log(`Category:        ${def.category}`);
+    console.log(`Access:          ${def.readOnly ? 'Strictly Read-Only' : 'Read/Write'}`);
+    console.log(`Capabilities:    ${def.requiredCapabilities.join(', ')}`);
+    console.log(`Allowed Outputs: ${def.allowedOutputPrefixes.join(', ')}`);
+    if (def.formerName) console.log(`Former Alias:    ${def.formerName}`);
+    console.log(`\nDescription:\n  ${def.description}`);
+    return;
+  }
+
+  if (sub === 'prompt') {
+    const target = positionals[1];
+    if (!target) {
+      console.error('Error: Missing role identifier. Usage: esquadrao role prompt <role_id> [intent]');
+      process.exit(1);
+    }
+    const roleMod = getRole(target);
+    if (!roleMod) {
+      console.error(`Error: Unknown role '${target}'.`);
+      process.exit(1);
+    }
+    const intent = positionals.slice(2).join(' ') || 'Fulfill the primary engineering task.';
+    const prompt = roleMod.buildPrompt({ intent, objective: intent });
+    if (flags.json) {
+      console.log(JSON.stringify({ role: roleMod.definition.id, prompt }, null, 2));
+      return;
+    }
+    console.log(prompt);
+    return;
+  }
+
+  if (sub === 'matrix') {
+    const matrix = {
+      readOnlyRoles: Array.from(READ_ONLY_ROLES),
+      forbiddenPatterns: FORBIDDEN_COMMAND_PATTERNS.map((p) => p.source),
+      roles: listRoles().map((r) => ({
+        id: r.id,
+        title: r.title,
+        readOnly: r.readOnly,
+        allowedPrefixes: r.allowedOutputPrefixes,
+      })),
+    };
+    if (flags.json) {
+      console.log(JSON.stringify(matrix, null, 2));
+      return;
+    }
+    console.log('Structural Authority Matrix:\n');
+    console.log(`Read-Only Roles: ${matrix.readOnlyRoles.join(', ')}`);
+    console.log(`Forbidden Command Patterns:\n${matrix.forbiddenPatterns.map((p) => `  - ${p}`).join('\n')}\n`);
+    for (const r of matrix.roles) {
+      console.log(`- ${r.id.padEnd(20)} ${r.readOnly ? 'RO' : 'RW'} (Outputs: ${r.allowedPrefixes.join(', ')})`);
+    }
+    return;
+  }
+
+  console.error(`Unknown subcommand '${sub}'. Run 'esquadrao role --help' for usage.`);
+  process.exit(1);
+}
+
+export default run;

package/src/commands/setup.js

@@ -0,0 +1,174 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { execSync } from 'node:child_process';
+
+function checkBinary(name) {
+  try {
+    const cmd = process.platform === 'win32' ? `where ${name}` : `which ${name}`;
+    execSync(cmd, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function tryAutoInstallFfmpeg() {
+  if (checkBinary('ffmpeg') && checkBinary('ffprobe')) return true;
+  try {
+    if (process.platform === 'darwin') {
+      execSync('brew install ffmpeg', { stdio: 'ignore', timeout: 60000 });
+    } else if (process.platform === 'win32') {
+      execSync('winget install Gyan.FFmpeg --accept-package-agreements --accept-source-agreements', { stdio: 'ignore', timeout: 60000 });
+    } else {
+      execSync('which apt-get && (apt-get update -qq && apt-get install -y -qq ffmpeg) || sudo apt-get update -qq && sudo apt-get install -y -qq ffmpeg', { stdio: 'ignore', timeout: 60000 });
+    }
+    return checkBinary('ffmpeg') && checkBinary('ffprobe');
+  } catch {
+    return false;
+  }
+}
+
+const SKILLS = [
+  'skill-orchestrate',
+  'skill-pipeline',
+  'skill-review',
+  'skill-audit',
+  'skill-context',
+  'skill-ui',
+  'skill-product-manager',
+  'skill-system-analyst',
+  'skill-software-architect',
+  'skill-tech-lead',
+  'skill-security-engineer',
+  'skill-software-engineer',
+  'skill-code-reviewer',
+  'skill-sre-engineer',
+  'skill-qa-engineer',
+  'skill-technical-writer',
+  'skill-engineering-manager',
+  'skill-media-producer',
+];
+
+// ponytail: synchronous copy; upgrade to async workers when syncing >50 skills
+export async function run({ positionals = [], flags = {} } = {}) {
+  if (flags?.help) {
+    console.log('Usage: esquadrao setup [--dest <path>] [--json]');
+    return;
+  }
+
+  const rootDir = fileURLToPath(new URL('../../', import.meta.url));
+  const cwd = process.cwd();
+  const destArg = typeof flags?.dest === 'string' ? flags.dest : (positionals[0] || null);
+  const destDir = destArg || path.join(cwd, '.agents', 'skills');
+
+  fs.mkdirSync(destDir, { recursive: true });
+  const installed = [];
+  for (const item of [...SKILLS, 'scripts']) {
+    const src = path.join(rootDir, item);
+    if (fs.existsSync(src)) {
+      fs.cpSync(src, path.join(destDir, item), { recursive: true });
+      installed.push(item);
+    }
+  }
+
+  const harnesses = [];
+
+  // If a custom destination was not explicitly passed, configure local project harnesses
+  if (!destArg) {
+    // 1. Grok Build / Agent Skills
+    if (fs.existsSync(path.join(cwd, '.agents'))) {
+      harnesses.push('.agents');
+    }
+
+    // 2. Claude Code
+    const claudeDir = path.join(cwd, '.claude');
+    if (fs.existsSync(claudeDir)) {
+      harnesses.push('.claude');
+      const claudeSkillsDir = path.join(claudeDir, 'skills');
+      fs.mkdirSync(claudeSkillsDir, { recursive: true });
+      for (const item of [...SKILLS, 'scripts']) {
+        const src = path.join(rootDir, item);
+        if (fs.existsSync(src)) {
+          fs.cpSync(src, path.join(claudeSkillsDir, item), { recursive: true });
+        }
+      }
+    }
+
+    // 3. Codex CLI (detects .codex or ~/.codex or AGENTS.md)
+    const codexDir = path.join(cwd, '.codex');
+    const userCodex = path.join(os.homedir(), '.codex');
+    if (fs.existsSync(codexDir) || fs.existsSync(userCodex) || fs.existsSync(path.join(cwd, 'AGENTS.md'))) {
+      harnesses.push('.codex');
+      const codexSkillsDir = path.join(codexDir, 'skills');
+      fs.mkdirSync(codexSkillsDir, { recursive: true });
+      for (const item of [...SKILLS, 'scripts']) {
+        const src = path.join(rootDir, item);
+        if (fs.existsSync(src)) {
+          fs.cpSync(src, path.join(codexSkillsDir, item), { recursive: true });
+        }
+      }
+
+      // Ensure AGENTS.md references the skills
+      const agentsMdPath = path.join(cwd, 'AGENTS.md');
+      if (!fs.existsSync(agentsMdPath)) {
+        fs.writeFileSync(
+          agentsMdPath,
+          '# Agent Instructions\n\nSkills are installed in `.codex/skills/` and `.agents/skills/`.\n'
+        );
+      }
+    }
+
+    // 4. Cursor Rules (.cursor/rules/*.mdc)
+    const cursorDir = path.join(cwd, '.cursor');
+    if (fs.existsSync(cursorDir)) {
+      harnesses.push('.cursor');
+      const rulesDir = path.join(cursorDir, 'rules');
+      fs.mkdirSync(rulesDir, { recursive: true });
+      fs.writeFileSync(
+        path.join(rulesDir, 'esquadrao.mdc'),
+        '---\ndescription: Esquadrao Skills Rules\nglobs: *\n---\nUse esquadrao tools and CLI.\n'
+      );
+    }
+
+    // 5. VS Code
+    if (fs.existsSync(path.join(cwd, '.vscode'))) harnesses.push('.vscode');
+
+    // 6. Hermes
+    if (fs.existsSync(path.join(os.homedir(), '.hermes'))) harnesses.push('.hermes');
+  }
+
+  const nodeMajor = parseInt(process.versions.node.split('.')[0], 10);
+  const nodeOk = nodeMajor >= 18;
+
+  let hasFfmpeg = checkBinary('ffmpeg') && checkBinary('ffprobe');
+  let autoInstalledFfmpeg = false;
+  if (!hasFfmpeg) {
+    autoInstalledFfmpeg = tryAutoInstallFfmpeg();
+    hasFfmpeg = checkBinary('ffmpeg') && checkBinary('ffprobe');
+  }
+
+  const report = {
+    status: nodeOk ? 'ok' : 'degraded',
+    prerequisites: {
+      node: { version: process.version, valid: nodeOk },
+      ffmpeg: { valid: hasFfmpeg, auto_installed: autoInstalledFfmpeg }
+    },
+    installation: { destination: destDir, installed },
+    harnesses,
+  };
+
+  if (flags?.json) {
+    console.log(JSON.stringify(report));
+  } else {
+    console.log(`Esquadrão Setup: ${report.status.toUpperCase()}`);
+    console.log(`- Node.js: ${process.version} (${nodeOk ? 'OK' : 'Requires >= 18'})`);
+    console.log(`- FFmpeg & ffprobe: ${hasFfmpeg ? (autoInstalledFfmpeg ? 'Instalado automaticamente com sucesso!' : 'OK') : 'Pendente (peça ao seu agente de IA: "instale o ffmpeg para mim")'}`);
+    console.log(`- Installed ${installed.length} items to ${destDir}`);
+    if (harnesses.length) console.log(`- Harnesses detected: ${harnesses.join(', ')}`);
+  }
+  return report;
+}
+
+export default run;