@julioventura/opensquad 0.1.17

package/src/agents-cli.js

@@ -0,0 +1,158 @@
+import { createInterface } from 'node:readline';
+import { stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { listInstalled, installAgent, removeAgent, getAgentMeta, getLocalizedDescription } from './agents.js';
+import { loadLocale, t, getLocaleCode } from './i18n.js';
+import { loadSavedLocale } from './init.js';
+import { logEvent } from './logger.js';
+
+async function confirm(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase());
+    });
+  });
+}
+
+export async function agentsCli(subcommand, args, targetDir) {
+  // Require initialized project
+  try {
+    await stat(join(targetDir, '_opensquad'));
+  } catch {
+    await loadLocale('English');
+    console.log(`\n  ${t('agentsNotInitialized')}\n`);
+    return { success: false };
+  }
+
+  await loadSavedLocale(targetDir);
+
+  try {
+    if (subcommand === 'list' || !subcommand) {
+      await runList(targetDir);
+    } else if (subcommand === 'install') {
+      const installed = await runInstall(args[0], targetDir);
+      if (installed === false) return { success: false };
+    } else if (subcommand === 'remove') {
+      const removed = await runRemove(args[0], targetDir);
+      if (removed === false) return { success: false };
+    } else if (subcommand === 'update') {
+      await runUpdate(targetDir);
+    } else if (subcommand === 'update-one') {
+      await runUpdateOne(args[0], targetDir);
+    } else {
+      console.log(`\n  ${t('agentsUnknownCommand', { cmd: subcommand })}\n`);
+      return { success: false };
+    }
+  } catch (err) {
+    console.log(`\n  ${t('agentsError', { message: err.message })}\n`);
+    return { success: false };
+  }
+
+  return { success: true };
+}
+
+async function runList(targetDir) {
+  console.log(`\n  Opensquad Agents\n`);
+
+  const installed = await listInstalled(targetDir);
+
+  if (installed.length > 0) {
+    console.log(`  ${t('agentsInstalledHeader')}`);
+    for (const id of installed) {
+      const meta = await getAgentMeta(id);
+      if (meta) {
+        const desc = getLocalizedDescription(meta, getLocaleCode());
+        const parts = [meta.name];
+        if (meta.icon) parts.unshift(meta.icon);
+        if (meta.category) parts.push(`(${meta.category})`);
+        parts.push(`- ${desc.split('.')[0]}`);
+        console.log(`    ${parts.join(' ')}`);
+      } else {
+        console.log(`    ${id}`);
+      }
+    }
+  } else {
+    console.log(`  ${t('agentsNoneInstalled')}`);
+  }
+
+  console.log(`\n  Browse available agents at: https://github.com/julioventura/opensquad/tree/main/agents\n`);
+}
+
+async function runInstall(id, targetDir) {
+  if (!id) {
+    console.log('\n  Usage: opensquad agents install <id>\n');
+    return false;
+  }
+
+  const installed = await listInstalled(targetDir);
+  if (installed.includes(id)) {
+    const answer = await confirm(`\n  ${t('agentsAlreadyInstalled', { id })}`);
+    // Accept 'y' (English) or 's' (Portuguese "sim") as affirmative answers
+    if (answer !== 'y' && answer !== 's') return false;
+    console.log(`  ${t('agentsInstalling', { id })}`);
+    await installAgent(id, targetDir);
+    console.log(`  ${t('agentsReinstalled', { id })}\n`);
+    await logEvent('agent:install', { name: id, reinstall: true }, targetDir);
+    return;
+  }
+
+  console.log(`\n  ${t('agentsInstalling', { id })}`);
+  await installAgent(id, targetDir);
+  console.log(`  ${t('agentsInstalled', { id })}\n`);
+  await logEvent('agent:install', { name: id }, targetDir);
+}
+
+async function runRemove(id, targetDir) {
+  if (!id) {
+    console.log('\n  Usage: opensquad agents remove <id>\n');
+    return false;
+  }
+
+  const installed = await listInstalled(targetDir);
+  if (!installed.includes(id)) {
+    console.log(`\n  ${t('agentsNotInstalled', { id })}\n`);
+    return;
+  }
+
+  console.log(`\n  ${t('agentsRemoving', { id })}`);
+  await removeAgent(id, targetDir);
+  await logEvent('agent:remove', { name: id }, targetDir);
+  console.log(`  ${t('agentsRemoved', { id })}\n`);
+}
+
+async function runUpdate(targetDir) {
+  const installed = await listInstalled(targetDir);
+  if (installed.length === 0) {
+    console.log(`\n  ${t('agentsUpdateNone')}\n`);
+    return;
+  }
+
+  console.log(`\n  ${t('agentsUpdating')}`);
+  for (const id of installed) {
+    console.log(`  ${t('agentsInstalling', { id })}`);
+    await installAgent(id, targetDir);
+    console.log(`  ${t('agentsInstalled', { id })}`);
+  }
+  await logEvent('agent:update', { count: installed.length }, targetDir);
+  console.log(`\n  ${t('agentsUpdateDone', { count: installed.length })}\n`);
+}
+
+async function runUpdateOne(id, targetDir) {
+  if (!id) {
+    console.log('\n  Usage: opensquad update <name>\n');
+    return;
+  }
+
+  const installed = await listInstalled(targetDir);
+  if (!installed.includes(id)) {
+    console.log(`\n  ${t('agentsNotInstalled', { id })}\n`);
+    return;
+  }
+
+  console.log(`\n  ${t('agentsInstalling', { id })}`);
+  await installAgent(id, targetDir);
+  await logEvent('agent:update', { name: id }, targetDir);
+  console.log(`  ${t('agentsInstalled', { id })}\n`);
+}

package/src/agents.js

@@ -0,0 +1,134 @@
+import { copyFile, mkdir, readdir, readFile, rm } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const BUNDLED_AGENTS_DIR = join(__dirname, '..', 'agents');
+
+const metaCache = new Map();
+
+export async function listInstalled(targetDir) {
+  try {
+    const agentsDir = join(targetDir, 'agents');
+    const entries = await readdir(agentsDir, { withFileTypes: true });
+    return entries
+      .filter((e) => e.isFile() && e.name.endsWith('.agent.md'))
+      .map((e) => e.name.replace(/\.agent\.md$/, ''));
+  } catch (err) {
+    if (err.code === 'ENOENT') return [];
+    throw err;
+  }
+}
+
+export async function listAvailable() {
+  try {
+    const entries = await readdir(BUNDLED_AGENTS_DIR, { withFileTypes: true });
+    return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+  } catch {
+    return [];
+  }
+}
+
+export async function getAgentMeta(id) {
+  if (metaCache.has(id)) return metaCache.get(id);
+  try {
+    const raw = await readFile(join(BUNDLED_AGENTS_DIR, id, 'AGENT.md'), 'utf-8');
+    const content = raw.replace(/\r\n/g, '\n');
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!fmMatch) return { name: id, description: '', descriptions: {}, category: '', icon: '', version: '' };
+
+    const fm = fmMatch[1];
+    const name = fm.match(/^name:\s*(.+)$/m)?.[1]?.trim() || id;
+    const category = fm.match(/^category:\s*(.+)$/m)?.[1]?.trim() || '';
+    const icon = fm.match(/^icon:\s*(.+)$/m)?.[1]?.trim() || '';
+    const version = fm.match(/^version:\s*(.+)$/m)?.[1]?.trim() || '';
+
+    // description may use YAML folded scalar (>)
+    let description = '';
+    const descBlock = fm.match(/^description:\s*>\s*\n((?:\s{2,}.+\n?)+)/m);
+    if (descBlock) {
+      description = descBlock[1].replace(/\n\s*/g, ' ').trim();
+    } else {
+      const descInline = fm.match(/^description:\s*(.+)$/m);
+      if (descInline) description = descInline[1].trim();
+    }
+
+    // localized descriptions: description_pt-BR, description_es, etc.
+    const descriptions = {};
+    for (const code of ['pt-BR', 'es']) {
+      const key = `description_${code}`;
+      // folded scalar
+      const blockMatch = fm.match(new RegExp(`^${key}:\\s*>\\s*\\n((?:\\s{2,}.+\\n?)+)`, 'm'));
+      if (blockMatch) {
+        descriptions[code] = blockMatch[1].replace(/\n\s*/g, ' ').trim();
+      } else {
+        // inline
+        const inlineMatch = fm.match(new RegExp(`^${key}:\\s*(.+)$`, 'm'));
+        if (inlineMatch) descriptions[code] = inlineMatch[1].trim();
+      }
+    }
+
+    const result = { name, description, descriptions, category, icon, version };
+    metaCache.set(id, result);
+    return result;
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      metaCache.set(id, null);
+      return null;
+    }
+    throw err;
+  }
+}
+
+function validateAgentId(id) {
+  if (!/^[a-z0-9][a-z0-9-]*$/.test(id)) {
+    throw new Error(`Invalid agent id: '${id}'`);
+  }
+}
+
+export async function installAgent(id, targetDir) {
+  validateAgentId(id);
+  const srcFile = join(BUNDLED_AGENTS_DIR, id, 'AGENT.md');
+  try {
+    await readFile(srcFile);
+  } catch (err) {
+    if (err.code === 'ENOENT') throw new Error(`Agent '${id}' not found in registry`, { cause: err });
+    throw err;
+  }
+  const destDir = join(targetDir, 'agents');
+  await mkdir(destDir, { recursive: true });
+  await copyFile(srcFile, join(destDir, `${id}.agent.md`));
+  metaCache.delete(id);
+}
+
+export async function removeAgent(id, targetDir) {
+  validateAgentId(id);
+  const agentFile = join(targetDir, 'agents', `${id}.agent.md`);
+  await rm(agentFile, { force: true });
+  metaCache.delete(id);
+}
+
+export function clearMetaCache() {
+  metaCache.clear();
+}
+
+export async function getAgentVersion(id, targetDir) {
+  try {
+    const agentPath = join(targetDir, 'agents', `${id}.agent.md`);
+    const content = await readFile(agentPath, 'utf-8');
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!fmMatch) return null;
+    const versionMatch = fmMatch[1].match(/^version:\s*(.+)$/m);
+    return versionMatch ? versionMatch[1].trim() : null;
+  } catch (err) {
+    if (err.code === 'ENOENT') return null;
+    throw err;
+  }
+}
+
+export function getLocalizedDescription(meta, localeCode) {
+  if (localeCode && localeCode !== 'en' && meta.descriptions?.[localeCode]) {
+    return meta.descriptions[localeCode];
+  }
+  return meta.description;
+}

package/src/i18n.js

@@ -0,0 +1,48 @@
+import { readFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const LOCALES_DIR = join(__dirname, 'locales');
+
+const LANG_MAP = {
+  'Português (Brasil)': 'pt-BR',
+  'English': 'en',
+  'Español': 'es',
+};
+
+let strings = {};
+let fallback = {};
+let currentCode = 'en';
+
+export async function loadLocale(langLabel) {
+  const code = LANG_MAP[langLabel] || 'en';
+  currentCode = code;
+
+  const enPath = join(LOCALES_DIR, 'en.json');
+  fallback = JSON.parse(await readFile(enPath, 'utf-8'));
+
+  if (code === 'en') {
+    strings = fallback;
+    return;
+  }
+
+  try {
+    const localePath = join(LOCALES_DIR, `${code}.json`);
+    strings = JSON.parse(await readFile(localePath, 'utf-8'));
+  } catch {
+    strings = fallback;
+  }
+}
+
+export function getLocaleCode() {
+  return currentCode;
+}
+
+export function t(key, vars = {}) {
+  let str = strings[key] ?? fallback[key] ?? key;
+  for (const [k, v] of Object.entries(vars)) {
+    str = str.replaceAll(`{${k}}`, v);
+  }
+  return str;
+}