conectese 0.1.14

package/skills/template-designer/SKILL.md

@@ -0,0 +1,201 @@
+---
+name: template-designer
+description: Visual template selection for image design agents. Generates template variations, renders them as images for user review, and saves the approved visual identity.
+type: prompt
+version: "2.0.0"
+categories: [design, visual, templates]
+---
+
+# Template Designer
+
+Visual template selection and refinement for squad creation and editing.
+
+## When to Use
+
+- During squad creation: when the Design phase identifies an image design agent and the user opts to choose a template
+- During squad editing: when the user asks to define, edit, or change the visual identity / template of a design agent
+- Trigger: presence of `image-creator` skill (or similar image-producing skill) in the squad's skill list
+
+## Prerequisites
+
+- A squad with a design agent that produces images (uses `image-creator` skill)
+- Squad's `_build/` directory must exist (created during Discovery/Design phases)
+- `image-creator` skill installed (for rendering HTML to PNG)
+
+## How It Works
+
+1. You read context and base templates
+2. You generate 3 adapted HTML template variations
+3. You render each as a PNG image using the `image-creator` skill
+4. You present the image file paths to the user for review
+5. You iterate with feedback until approval
+6. You save the approved template as HTML reference + structured style rules
+
+## Generating Templates
+
+### Step 0: Read Design Guidelines (MANDATORY)
+
+Before generating any template, read and internalize the design best practices:
+- `_conectese/core/best-practices/image-design.md` — **REQUIRED reading**. Contains platform-specific minimum font sizes, typography rules, spacing guidelines, color palette constraints, contrast requirements, and layout methodology. Every template you generate MUST comply with these rules.
+
+Key rules to always follow:
+- **Font sizes**: Hero 58px, Heading 43px, Body 34px, Caption 24px minimum for Instagram carousel (1080x1440). Absolute minimum 20px for any readable text on any platform.
+- **Font weight**: 500 or higher for body text and above.
+- **Colors**: Maximum 5 colors per design system (primary, secondary, accent, background, text).
+- **Contrast**: WCAG AA minimum 4.5:1 for all text against background.
+- **Layout**: CSS Grid or Flexbox only. No absolute positioning for primary content.
+- **Self-contained HTML**: Inline CSS only. Only Google Fonts @import allowed as external resource.
+- **No slide counters**: Never include "1/7" or similar. Instagram has native navigation.
+
+You should also apply general web design best practices: proper white space, visual hierarchy through scale and weight, consistent spacing rhythm, and balanced composition.
+
+### HARD RULES — Dimensions and Typography
+
+These rules are NON-NEGOTIABLE. Every template must comply:
+
+**Fixed Dimensions (never use height: auto or flexible height):**
+- Instagram Carousel: `width: 1080px; height: 1440px` (3:4 portrait)
+- Instagram Story/Reel: `width: 1080px; height: 1920px` (9:16 portrait)
+- Instagram Post: `width: 1080px; height: 1080px` (1:1 square)
+- LinkedIn Post: `width: 1200px; height: 627px` (1.91:1 horizontal)
+
+The root container of every template MUST set explicit `width` and `height` in pixels. The template must render at exactly these dimensions — no overflow, no scrolling, no flexible height.
+
+**Minimum Font Sizes (Instagram at 1080px width):**
+- Hero/Title: **58px** minimum
+- Heading: **43px** minimum
+- Body text: **34px** minimum
+- Caption/small text: **24px** minimum
+- Absolute minimum for ANY readable text on ANY platform: **20px**
+
+**Font Weight:** 500 or higher for body text and above. Never use font-weight below 400 for any visible text.
+
+Templates that violate these rules are rejected — no exceptions.
+
+### Step 1: Read Context
+
+Read these files to understand the squad:
+- `squads/{code}/_build/discovery.yaml` — platform, domain, tone, language
+- `squads/{code}/_build/design.yaml` — agents, purpose, skills
+- `squads/{code}/_investigations/consolidated-analysis.md` (if exists) — visual patterns from reference profiles
+- `_conectese/_memory/company.md` — company name, brand, industry, target audience
+- `_conectese/_memory/preferences.md` — user preferences (language, style, tone)
+
+Use the company context and user preferences to adapt template content: example text should reflect the company's domain and audience, colors should align with brand if available, and language should match the user's Output Language preference.
+
+### Step 2: Read Base Templates
+
+Read the 3 base templates from `skills/template-designer/base-templates/`:
+- `model-a.html`
+- `model-b.html`
+- `model-c.html`
+
+### Step 3: Generate Adapted Variations
+
+For each base template, create an adapted version:
+- Adjust colors to match the squad's domain/brand (use Sherlock palette if available, company brand colors from company.md if available)
+- Adjust typography following the platform-specific minimum font sizes from `image-design.md`
+- Replace example content with domain-relevant content that reflects the company's industry, audience, and language
+- Set the root container to the exact fixed dimensions from HARD RULES above. Never use percentage heights or auto heights.
+- Add any visual elements that match the squad's personality
+- Apply proper white space, visual hierarchy, and spacing rhythm per `image-design.md` methodology
+
+Write each adapted template as a **complete, self-contained HTML file** (with `<!DOCTYPE html>`, inline CSS, and Google Fonts imports if needed).
+
+Save to:
+- `squads/{code}/_build/template-a.html`
+- `squads/{code}/_build/template-b.html`
+- `squads/{code}/_build/template-c.html`
+
+### Step 4: Render as Images
+
+Use the `image-creator` skill to render each HTML template as a PNG image:
+
+1. Read `skills/image-creator/SKILL.md` for rendering instructions
+2. Render each template HTML to PNG using the image-creator workflow
+3. Save rendered images to:
+   - `squads/{code}/_build/template-a.png`
+   - `squads/{code}/_build/template-b.png`
+   - `squads/{code}/_build/template-c.png`
+
+### Step 5: Present to User
+
+Present the 3 template options to the user using **clickable markdown links with absolute file paths** so they can open and review:
+
+> "Here are 3 template options for your squad's visual identity:
+>
+> - [preview-a.png]({absolute_path}/squads/{code}/_build/template-a.png) — Template A
+> - [preview-b.png]({absolute_path}/squads/{code}/_build/template-b.png) — Template B
+> - [preview-c.png]({absolute_path}/squads/{code}/_build/template-c.png) — Template C
+>
+> Click the links above to open each image. Tell me which one you prefer. I can also mix elements from different templates or adjust colors, fonts, and layout."
+
+**Important:** Always use the full absolute path (e.g., `d:\Coding Projects\conectese\squads\my-squad\_build\template-a.png`) inside the markdown link — relative paths are not clickable in the IDE.
+
+## Iteration Loop
+
+1. Present template images with clickable markdown links using absolute file paths
+2. Wait for user feedback in terminal
+3. Generate new version based on feedback — save as `template-v2.html`, render as `template-v2.png`, etc.
+4. Present updated image with clickable markdown link using absolute file path
+5. Repeat until user approves
+
+## Saving the Approved Template
+
+When the user approves, create two files:
+
+### 1. Template Reference HTML
+
+Save to: `squads/{code}/pipeline/data/template-reference.html`
+
+The complete, self-contained HTML/CSS of the approved template at full resolution (e.g., 1080x1440). This is the literal example the design agent will use.
+
+### 2. Visual Identity Rules
+
+Save to: `squads/{code}/pipeline/data/visual-identity.md`
+
+Extract structured rules from the approved template:
+
+~~~markdown
+# Visual Identity
+
+## Color Palette
+- **Primary:** #HEXCODE — usage description
+- **Secondary:** #HEXCODE — usage description
+- **Background:** #HEXCODE
+- **Text:** #HEXCODE
+- **Accent:** #HEXCODE — usage description
+
+## Typography
+- **Headings:** Font Family, weight, size range
+- **Body:** Font Family, weight, size range
+- **Caption:** Font Family, weight, size range
+- **Minimum sizes:** body 32px, caption 24px, heading 48px
+
+## Layout
+- **Viewport:** WIDTHxHEIGHT px
+- **Padding:** value
+- **Grid:** description
+- **Spacing rules:** description
+
+## Composition Rules
+- Logo/profile placement: description
+- Image treatment: description
+- Visual hierarchy: description
+- Footer/CTA pattern: description
+
+## Adaptation Rules
+- How to handle different viewport sizes
+- What stays fixed vs. what adapts
+- Color usage rules (when to use primary vs accent)
+~~~
+
+### 3. Update Squad Files
+
+If the squad is being created (Build phase hasn't run yet):
+- The design.yaml context now includes the template data — Build will pick it up
+
+If the squad already exists (editing flow):
+- Add `pipeline/data/template-reference.html` and `pipeline/data/visual-identity.md` to `squad.yaml` `data:` list
+- Update the design agent's `.agent.md` to reference both files
+- Update the design agent's tasks to include the rule: "always follow visual-identity.md and use template-reference.html as the base model"

package/skills/template-designer/base-templates/model-a.html

@@ -0,0 +1,27 @@
+<!-- Model A: Twitter Editorial — approved 2026-03-28 -->
+<!-- Style: Black background, tweet-style layout with avatar, verified badge, editorial text, contextual image -->
+<!-- Fonts: Inter (body), weight 400-700 -->
+<!-- Colors: #000 bg, #fff text, #1D9BF0 verified, #71767B muted, #2a2a2a borders/avatar, #1a1a2e image gradient -->
+<div style="width:1080px;height:1440px;background:#000;color:#fff;font-family:'Inter',sans-serif;display:flex;flex-direction:column;padding:72px;gap:0;position:relative;overflow:hidden;">
+  <!-- Tweet header -->
+  <div style="display:flex;gap:24px;align-items:center;">
+    <div style="width:80px;height:80px;border-radius:50%;background:#2a2a2a;flex-shrink:0;"></div>
+    <div>
+      <div style="display:flex;align-items:center;gap:8px;">
+        <span style="font-weight:700;font-size:34px;">Nome Sobrenome</span>
+        <svg width="28" height="28" viewBox="0 0 24 24" fill="#1D9BF0"><path d="M22.25 12c0-1.43-.88-2.67-2.19-3.34.46-1.39.2-2.9-.81-3.91s-2.52-1.27-3.91-.81c-.66-1.31-1.91-2.19-3.34-2.19s-2.67.88-3.34 2.19c-1.39-.46-2.9-.2-3.91.81s-1.27 2.52-.81 3.91C2.63 9.33 1.75 10.57 1.75 12s.88 2.67 2.19 3.34c-.46 1.39-.2 2.9.81 3.91s2.52 1.27 3.91.81c.66 1.31 1.91 2.19 3.34 2.19s2.67-.88 3.34-2.19c1.39.46 2.9.2 3.91-.81s1.27-2.52.81-3.91c1.31-.67 2.19-1.91 2.19-3.34zm-11.08 4.71c-.22.22-.58.22-.8 0L7.4 13.74c-.22-.22-.22-.58 0-.8.22-.22.58-.22.8 0l2.57 2.57 6.03-6.03c.22-.22.58-.22.8 0 .22.22.22.58 0 .8l-6.43 6.43z"/></svg>
+      </div>
+      <span style="font-size:28px;color:#71767B;">@username</span>
+    </div>
+  </div>
+  <!-- Tweet text -->
+  <div style="font-size:38px;line-height:1.45;font-weight:400;margin-top:48px;">
+    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium.
+    <br><br>
+    Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit. Neque porro quisquam est qui dolorem.
+  </div>
+  <!-- Image -->
+  <div style="width:100%;height:35%;background:linear-gradient(180deg,#1a1a2e,#0d0d0d);border-radius:24px;display:flex;align-items:center;justify-content:center;border:1px solid #2a2a2a;flex-shrink:0;margin-top:auto;">
+    <span style="color:#555;font-size:34px;">Imagem contextual</span>
+  </div>
+</div>

package/skills/template-designer/base-templates/model-b.html

@@ -0,0 +1,31 @@
+<!-- Model B: Clean Visual — approved 2026-03-28 -->
+<!-- Style: Warm cream background, bold uppercase title, numbered cards with warm gradient progression -->
+<!-- Fonts: Montserrat 900 (title), Inter 500-700 (body) -->
+<!-- Colors: #FDF6EE bg, #E85D2A primary orange, #D4742A/#C05A1A/#A04010 gradient steps, #FFF5E6-#D07030 card backgrounds -->
+<div style="width:1080px;height:1440px;background:#FDF6EE;color:#111;font-family:'Inter',sans-serif;display:flex;flex-direction:column;padding:72px;justify-content:center;gap:48px;position:relative;overflow:hidden;">
+  <!-- Title -->
+  <div style="text-align:center;">
+    <h1 style="font-size:58px;font-weight:900;line-height:1.15;margin:0;text-transform:uppercase;font-family:'Montserrat',sans-serif;">
+      <span style="color:#E85D2A;">LOREM IPSUM</span> DOLOR SIT AMET CONSECTETUR
+    </h1>
+  </div>
+  <!-- Items -->
+  <div style="display:flex;flex-direction:column;gap:20px;">
+    <div style="display:flex;align-items:center;gap:28px;background:#FFF5E6;border-radius:20px;padding:28px 32px;">
+      <div style="width:64px;height:64px;border-radius:50%;border:3px solid #E85D2A;display:flex;align-items:center;justify-content:center;font-size:28px;font-weight:800;color:#E85D2A;flex-shrink:0;">1</div>
+      <div><div style="font-size:34px;font-weight:700;">Proin tempus vehicula</div><div style="font-size:26px;color:#888;font-weight:500;">Sed ut perspiciatis unde omnis iste natus error.</div></div>
+    </div>
+    <div style="display:flex;align-items:center;gap:28px;background:linear-gradient(90deg,#FDEBD0,#F5C89A);border-radius:20px;padding:28px 32px;">
+      <div style="width:64px;height:64px;border-radius:50%;border:3px solid #D4742A;display:flex;align-items:center;justify-content:center;font-size:28px;font-weight:800;color:#D4742A;flex-shrink:0;">2</div>
+      <div><div style="font-size:34px;font-weight:700;">Vestibulum ante ipsum</div><div style="font-size:26px;color:#666;font-weight:500;">Nemo enim ipsam voluptatem quia voluptas sit.</div></div>
+    </div>
+    <div style="display:flex;align-items:center;gap:28px;background:linear-gradient(90deg,#F5C89A,#E8A065);border-radius:20px;padding:28px 32px;">
+      <div style="width:64px;height:64px;border-radius:50%;border:3px solid #C05A1A;display:flex;align-items:center;justify-content:center;font-size:28px;font-weight:800;color:#C05A1A;flex-shrink:0;">3</div>
+      <div><div style="font-size:34px;font-weight:700;">Maecenas dignissim justo</div><div style="font-size:26px;color:#555;font-weight:500;">Ut enim ad minima veniam nostrum exercitationem.</div></div>
+    </div>
+    <div style="display:flex;align-items:center;gap:28px;background:linear-gradient(90deg,#E8A065,#D07030);border-radius:20px;padding:28px 32px;">
+      <div style="width:64px;height:64px;border-radius:50%;border:3px solid #A04010;display:flex;align-items:center;justify-content:center;font-size:28px;font-weight:800;color:#A04010;flex-shrink:0;">4</div>
+      <div><div style="font-size:34px;font-weight:700;color:#fff;">Curabitur pretium tincidunt</div><div style="font-size:26px;color:#ffffffcc;font-weight:500;">Quis autem vel eum iure reprehenderit voluptate.</div></div>
+    </div>
+  </div>
+</div>

package/skills/template-designer/base-templates/model-c.html

@@ -0,0 +1,42 @@
+<!-- Model C: Data Dashboard — approved 2026-03-28 -->
+<!-- Style: Purple-dark gradient, data metric cards, decorative glow effects -->
+<!-- Fonts: Montserrat 900 (title, metrics), Inter 500 (body, labels) -->
+<!-- Colors: gradient #0f0326-#1a0a3e-#0d0d0d bg, #F59E0B yellow, #EC4899 pink, #7C3AED purple, #4ADE80 green accents -->
+<div style="width:1080px;height:1440px;background:linear-gradient(160deg,#0f0326,#1a0a3e 40%,#0d0d0d);color:#fff;font-family:'Inter',sans-serif;display:flex;flex-direction:column;padding:72px;position:relative;overflow:hidden;">
+  <!-- Glow effects -->
+  <div style="position:absolute;top:-120px;right:-120px;width:480px;height:480px;background:radial-gradient(circle,#7C3AED33,transparent 70%);pointer-events:none;"></div>
+  <div style="position:absolute;bottom:-100px;left:-100px;width:400px;height:400px;background:radial-gradient(circle,#F59E0B22,transparent 70%);pointer-events:none;"></div>
+  <!-- Tag + Title -->
+  <div style="position:relative;z-index:1;">
+    <div style="display:inline-block;background:#F59E0B33;border-radius:8px;padding:8px 20px;font-size:24px;color:#F59E0B;font-weight:800;text-transform:uppercase;letter-spacing:3px;margin-bottom:28px;">Lorem Ipsum</div>
+    <h1 style="font-size:52px;font-weight:900;line-height:1.2;margin:0 0 24px 0;font-family:'Montserrat',sans-serif;">
+      Sed ut perspiciatis <span style="background:linear-gradient(90deg,#F59E0B,#EC4899);-webkit-background-clip:text;-webkit-text-fill-color:transparent;">unde omnis</span> iste natus error sit
+    </h1>
+    <p style="font-size:34px;color:#bbb;line-height:1.55;margin:0;font-weight:500;letter-spacing:0.01em;">Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores.</p>
+  </div>
+  <!-- Data cards -->
+  <div style="position:relative;z-index:1;display:flex;flex-direction:column;gap:16px;margin:40px 0;flex:1;justify-content:center;">
+    <div style="background:#ffffff08;border:1px solid #ffffff10;border-radius:16px;padding:28px 32px;display:flex;justify-content:space-between;align-items:center;">
+      <span style="font-size:28px;color:#888;font-weight:500;">Lorem ipsum</span>
+      <span style="font-size:40px;font-weight:800;color:#F59E0B;font-family:'Montserrat',sans-serif;">U$3.4B</span>
+    </div>
+    <div style="background:#ffffff08;border:1px solid #ffffff10;border-radius:16px;padding:28px 32px;display:flex;justify-content:space-between;align-items:center;">
+      <span style="font-size:28px;color:#888;font-weight:500;">Dolor sit amet</span>
+      <span style="font-size:40px;font-weight:800;color:#EC4899;font-family:'Montserrat',sans-serif;">-U$5B</span>
+    </div>
+    <div style="background:#ffffff08;border:1px solid #ffffff10;border-radius:16px;padding:28px 32px;display:flex;justify-content:space-between;align-items:center;">
+      <span style="font-size:28px;color:#888;font-weight:500;">Consectetur</span>
+      <span style="font-size:40px;font-weight:800;color:#7C3AED;font-family:'Montserrat',sans-serif;">U$157B</span>
+    </div>
+    <div style="background:#ffffff08;border:1px solid #ffffff10;border-radius:16px;padding:28px 32px;display:flex;justify-content:space-between;align-items:center;">
+      <span style="font-size:28px;color:#888;font-weight:500;">Adipiscing elit</span>
+      <span style="font-size:40px;font-weight:800;color:#4ADE80;font-family:'Montserrat',sans-serif;">3.500+</span>
+    </div>
+  </div>
+  <!-- Footer -->
+  <div style="position:relative;z-index:1;display:flex;align-items:center;gap:20px;padding-top:24px;border-top:1px solid #ffffff12;">
+    <div style="width:48px;height:48px;border-radius:50%;background:linear-gradient(135deg,#F59E0B,#EC4899);"></div>
+    <span style="font-size:24px;color:#777;">@username</span>
+    <span style="margin-left:auto;font-size:24px;color:#555;">ARRASTE →</span>
+  </div>
+</div>

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, '_conectese'));
+  } 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  Conectese 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/renatoasse/conectese/tree/main/agents\n`);
+}
+
+async function runInstall(id, targetDir) {
+  if (!id) {
+    console.log('\n  Usage: conectese 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: conectese 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: conectese 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;
+}