@cccarv82/freya 2.20.0 → 3.1.0

package/cli/web.js

@@ -1192,14 +1192,9 @@ function buildHtml(safeDefault, appVersion) {
               </div>
 
               <!-- Textarea -->
-              <textarea id="inboxText" aria-label="Entrada de texto para processar ou perguntar" placeholder="Cole updates, decisões, blockers... ou faça uma pergunta à Freya.&#10;&#10;▸ Salvar & Processar → extrai tarefas e blockers do texto&#10;▸ Perguntar → consulta o histórico via busca semântica (RAG)&#10;▸ Ctrl+V com imagem → anexa screenshot ao contexto" style="resize:none; min-height: 200px; flex: 1; border-radius: 0; border-left: none; border-right: none; border-top: none; border-bottom: 1px solid var(--border); padding: 14px 16px; font-size: 13px; line-height: 1.6;"
+              <textarea id="inboxText" aria-label="Entrada de texto para processar ou perguntar" placeholder="Cole updates, decisões, blockers... ou faça uma pergunta à Freya.&#10;&#10;▸ Salvar & Processar → extrai tarefas e blockers do texto&#10;▸ Perguntar → consulta o histórico via busca semântica (RAG)" style="resize:none; min-height: 200px; flex: 1; border-radius: 0; border-left: none; border-right: none; border-top: none; border-bottom: 1px solid var(--border); padding: 14px 16px; font-size: 13px; line-height: 1.6;"
                 onkeydown="if((event.metaKey||event.ctrlKey)&&event.key==='Enter'){event.preventDefault();window.saveAndPlan();}"></textarea>
 
-              <!-- Image paste preview strip -->
-              <div id="pastePreview" style="display:none; padding: 8px 14px; border-bottom: 1px solid var(--border); background: rgba(0,0,0,0.05); flex-shrink:0;">
-                <div style="display:flex; align-items:center; gap:8px; flex-wrap:wrap;" id="pastePreviewInner"></div>
-              </div>
-
               <!-- Actions bar -->
               <div style="padding: 10px 14px; display: flex; justify-content: space-between; align-items: center; flex-wrap: wrap; gap: 8px; flex-shrink:0;">
                 <div style="display:flex; gap:8px; flex-wrap:wrap;">
@@ -1351,13 +1346,6 @@ function buildHtml(safeDefault, appVersion) {
     </div>
   </div>
 
-  <!-- Image lightbox modal -->
-  <div id="imgLightbox" class="img-lightbox" onclick="window.closeLightbox(event)">
-    <button class="img-lightbox-close" onclick="window.closeLightbox(event)" title="Fechar (Esc)">&times;</button>
-    <img id="imgLightboxImg" src="" alt="preview" onclick="event.stopPropagation()" />
-    <div id="imgLightboxName" class="img-lightbox-name"></div>
-  </div>
-
   <script>
     window.__FREYA_DEFAULT_DIR = "${safeDefault}";
   </script>
@@ -2408,26 +2396,25 @@ async function cmdWeb({ port, dir, open, dev }) {
         return;
       }
 
-      // Serve attachment images (pasted screenshots)
+      // Serve attachment images from workspace data/attachments/
       if (req.method === 'GET' && req.url.startsWith('/attachments/')) {
-        const relPath = decodeURIComponent(req.url.replace('/attachments/', ''));
+        const fname = decodeURIComponent(req.url.slice('/attachments/'.length)).replace(/[\/\\]/g, '');
         const requestedDir = dir || './freya';
-        const wsDir = path.resolve(process.cwd(), requestedDir);
-        const filePath = path.join(wsDir, 'data', 'attachments', relPath);
-        // Security: ensure path stays within data/attachments
-        if (!filePath.startsWith(path.join(wsDir, 'data', 'attachments'))) {
-          res.writeHead(403); res.end(); return;
-        }
-        if (exists(filePath)) {
-          const ext = path.extname(filePath).toLowerCase();
-          const mimeMap = { '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.gif': 'image/gif', '.webp': 'image/webp', '.bmp': 'image/bmp' };
-          const mime = mimeMap[ext] || 'application/octet-stream';
-          const data = fs.readFileSync(filePath);
-          res.writeHead(200, { 'Content-Type': mime, 'Cache-Control': 'public, max-age=86400' });
-          res.end(data);
+        let wsDir;
+        try { wsDir = normalizeWorkspaceDir(requestedDir); } catch { wsDir = path.resolve(process.cwd(), requestedDir); }
+        const filePath = path.join(wsDir, 'data', 'attachments', fname);
+        if (!exists(filePath)) {
+          res.writeHead(404, { 'Content-Type': 'text/plain' });
+          res.end('Not found');
           return;
         }
-        res.writeHead(404); res.end(); return;
+        const ext = path.extname(fname).toLowerCase();
+        const mimeMap = { '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.gif': 'image/gif', '.webp': 'image/webp', '.bmp': 'image/bmp', '.svg': 'image/svg+xml' };
+        const mime = mimeMap[ext] || 'application/octet-stream';
+        const data = fs.readFileSync(filePath);
+        res.writeHead(200, { 'Content-Type': mime, 'Cache-Control': 'max-age=86400' });
+        res.end(data);
+        return;
       }
 
       if (req.url.startsWith('/api/')) {
@@ -3240,30 +3227,9 @@ async function cmdWeb({ port, dir, open, dev }) {
           }
         }
 
-        // ── Upload attachment (image paste) ──────────────────────────
-        if (req.url === '/api/attachments/upload') {
-          const data = String(payload.data || '').trim();
-          const fname = String(payload.filename || '').trim();
-          if (!data || !fname) return safeJson(res, 400, { error: 'Missing data or filename' });
-
-          const d = isoDate();
-          const attDir = path.join(workspaceDir, 'data', 'attachments', d);
-          ensureDir(attDir);
-
-          // data is base64 (may have data:image/... prefix)
-          const base64 = data.replace(/^data:image\/[^;]+;base64,/, '');
-          const buf = Buffer.from(base64, 'base64');
-          const filePath = path.join(attDir, fname);
-          fs.writeFileSync(filePath, buf);
-
-          const relPath = `data/attachments/${d}/${fname}`;
-          return safeJson(res, 200, { ok: true, path: relPath });
-        }
-
         if (req.url === '/api/inbox/add') {
           const text = String(payload.text || '').trim();
-          const attachments = Array.isArray(payload.attachments) ? payload.attachments : [];
-          if (!text && !attachments.length) return safeJson(res, 400, { error: 'Missing text' });
+          if (!text) return safeJson(res, 400, { error: 'Missing text' });
 
           const d = isoDate();
           const file = path.join(workspaceDir, 'logs', 'daily', `${d}.md`);
@@ -3277,13 +3243,8 @@ async function cmdWeb({ port, dir, open, dev }) {
           const linksText = linkInfo && linkInfo.linksText ? linkInfo.linksText : '';
           const slugs = linkInfo && Array.isArray(linkInfo.slugs) ? linkInfo.slugs : [];
 
-          // Build attachment markdown references
-          let attachBlock = '';
-          if (attachments.length) {
-            attachBlock = '\n\n**Anexos:**\n' + attachments.map(a => `![${a.name || 'screenshot'}](${a.path})`).join('\n');
-          }
-
-          const block = `\n\n## [${hh}:${mm}] Raw Input\n${text}${linksText}${attachBlock}\n`;
+          const imgRef = payload.imagePath ? `\n![anexo](../${payload.imagePath})` : '';
+          const block = `\n\n## [${hh}:${mm}] Raw Input\n${text}${imgRef}${linksText}\n`;
           fs.appendFileSync(file, block, 'utf8');
 
           if (slugs.length) {
@@ -3342,16 +3303,7 @@ async function cmdWeb({ port, dir, open, dev }) {
             ]
           };
 
-          // Build image references if attachments were provided
-          const attachments = Array.isArray(payload.attachments) ? payload.attachments : [];
-          let imageContext = '';
-          if (attachments.length) {
-            imageContext = '\n\nIMAGENS ANEXADAS (use @caminho para analisar):\n' +
-              attachments.map(a => `- @${path.join(workspaceDir, a.path)} (${a.name})`).join('\n') + '\n' +
-              'Analise as imagens anexadas e inclua as informações visuais no plano.\n';
-          }
-
-          const prompt = `Você é o planner do sistema F.R.E.Y.A.\n\nContexto: vamos receber um input bruto do usuário e propor ações estruturadas.\nRegras: siga os arquivos de regras abaixo.\nSaída: retorne APENAS JSON válido no formato: ${JSON.stringify(schema)}\n\nRestrições:\n- NÃO use code fences (\`\`\`)\n- NÃO inclua texto extra antes/depois do JSON\n- NÃO use quebras de linha dentro de strings (transforme em uma frase única)\n\nREGRAS:${rulesText}${imageContext}\n\nINPUT DO USUÁRIO:\n${text}\n`;
+          const prompt = `Você é o planner do sistema F.R.E.Y.A.\n\nContexto: vamos receber um input bruto do usuário e propor ações estruturadas.\nRegras: siga os arquivos de regras abaixo.\nSaída: retorne APENAS JSON válido no formato: ${JSON.stringify(schema)}\n\nRestrições:\n- NÃO use code fences (\`\`\`)\n- NÃO inclua texto extra antes/depois do JSON\n- NÃO use quebras de linha dentro de strings (transforme em uma frase única)\n\nREGRAS:${rulesText}\n\nINPUT DO USUÁRIO:\n${text}\n`;
 
           // Prefer COPILOT_CMD if provided, otherwise try 'copilot'
           const cmd = process.env.COPILOT_CMD || 'copilot';
@@ -3361,7 +3313,7 @@ async function cmdWeb({ port, dir, open, dev }) {
           // BUG-48: pass FREYA_WORKSPACE_DIR so the Copilot subprocess uses correct DB
           const agentEnv = { FREYA_WORKSPACE_DIR: workspaceDir };
           try {
-            const r = await run(cmd, ['-s', '--no-color', '--stream', 'off', '-p', prompt, '--allow-all-tools', '--add-dir', workspaceDir], workspaceDir, agentEnv);
+            const r = await run(cmd, ['-s', '--no-color', '--stream', 'off', '-p', prompt, '--allow-all-tools'], workspaceDir, agentEnv);
             const out = (r.stdout + r.stderr).trim();
             if (r.code !== 0) {
               return safeJson(res, 200, {
@@ -3707,9 +3659,25 @@ async function cmdWeb({ port, dir, open, dev }) {
           return safeJson(res, r.code === 0 ? 200 : 400, r.code === 0 ? { ok: true, output: out } : { error: out || 'index rebuild failed', output: out });
         }
 
+        // Upload attachment (base64 image from clipboard paste)
+        if (req.url === '/api/attachments/upload') {
+          const base64 = String(payload.data || '').trim();
+          const mimeType = String(payload.mimeType || 'image/png').trim();
+          if (!base64) return safeJson(res, 400, { error: 'Missing data' });
+          const ext = mimeType === 'image/jpeg' ? '.jpg' : mimeType === 'image/gif' ? '.gif' : mimeType === 'image/webp' ? '.webp' : '.png';
+          const fname = 'paste-' + Date.now() + ext;
+          const attachDir = path.join(workspaceDir, 'data', 'attachments');
+          if (!exists(attachDir)) fs.mkdirSync(attachDir, { recursive: true });
+          const filePath = path.join(attachDir, fname);
+          const buf = Buffer.from(base64, 'base64');
+          fs.writeFileSync(filePath, buf);
+          return safeJson(res, 200, { ok: true, filename: fname, url: '/attachments/' + fname });
+        }
+
         if (req.url === '/api/chat/ask') {
           const sessionId = String(payload.sessionId || '').trim();
           const query = String(payload.query || '').trim();
+          const imagePath = payload.imagePath ? String(payload.imagePath).trim() : null;
           if (!query) return safeJson(res, 400, { error: 'Missing query' });
 
           const workspaceRulesBase = path.join(workspaceDir, '.agent', 'rules', 'freya');
@@ -3742,27 +3710,23 @@ async function cmdWeb({ port, dir, open, dev }) {
             console.error('[oracle] RAG search failed (embedder/sharp unavailable), continuing without context:', ragErr.message);
           }
 
-          // Build image references if attachments were provided
-          const askAttachments = Array.isArray(payload.attachments) ? payload.attachments : [];
-          let askImageContext = '';
-          const askHasImages = askAttachments.length > 0;
-          if (askHasImages) {
-            askImageContext = '\n\nIMAGENS ANEXADAS (use @caminho para analisar):\n' +
-              askAttachments.map(a => `- @${path.join(workspaceDir, a.path)} (${a.name})`).join('\n') + '\n' +
-              'Analise as imagens anexadas e use-as como contexto para responder à consulta.\n';
-          }
-
-          const prompt = `Você é o agente Oracle do sistema F.R.E.Y.A.\n\nSiga estritamente os arquivos de regras abaixo.\nResponda de forma analítica e consultiva.\n${ragContext}${askImageContext}\n\nREGRAS:${rulesText}\n\nCONSULTA DO USUÁRIO:\n${query}\n`;
+          const prompt = `Você é o agente Oracle do sistema F.R.E.Y.A.\n\nSiga estritamente os arquivos de regras abaixo.\nResponda de forma analítica e consultiva.\n${ragContext}\n\nREGRAS:${rulesText}\n\nCONSULTA DO USUÁRIO:\n${query}\n`;
 
           const cmd = process.env.COPILOT_CMD || 'copilot';
 
           // BUG-48: pass FREYA_WORKSPACE_DIR so the Copilot subprocess uses correct DB
           const oracleEnv = { FREYA_WORKSPACE_DIR: workspaceDir };
           try {
-            // Add --add-dir when images are attached so Copilot can access them
-            const oracleArgs = ['-s', '--no-color', '--stream', 'off', '-p', prompt];
-            if (askHasImages) { oracleArgs.push('--allow-all-tools', '--add-dir', workspaceDir); }
-            const r = await run(cmd, oracleArgs, workspaceDir, oracleEnv);
+            // Build copilot args; add image if user pasted a screenshot
+            const copilotArgs = ['-s', '--no-color', '--stream', 'off'];
+            if (imagePath) {
+              const absImg = path.isAbsolute(imagePath) ? imagePath : path.join(workspaceDir, imagePath);
+              if (exists(absImg)) {
+                copilotArgs.push('--add-image', absImg);
+              }
+            }
+            copilotArgs.push('-p', prompt);
+            const r = await run(cmd, copilotArgs, workspaceDir, oracleEnv);
             const out = (r.stdout + r.stderr).trim();
             if (r.code !== 0) {
               return safeJson(res, 200, { ok: false, answer: 'Falha na busca do agente Oracle:\n' + (out || 'Exit code != 0'), sessionId });
@@ -3893,7 +3857,8 @@ async function cmdWeb({ port, dir, open, dev }) {
 
           const rawTasks = dl.db.prepare(query).all(...params);
           const tasks = rawTasks.map(t => {
-            const meta = t.metadata ? JSON.parse(t.metadata) : {};
+            let meta = {};
+            try { meta = t.metadata ? JSON.parse(t.metadata) : {}; } catch (_) {}
             return {
               id: t.id,
               description: t.description,
@@ -4091,7 +4056,8 @@ async function cmdWeb({ port, dir, open, dev }) {
 
           const rawBlockers = dl.db.prepare(query).all(...params);
           const blockers = rawBlockers.map(b => {
-            const meta = b.metadata ? JSON.parse(b.metadata) : {};
+            let meta = {};
+            try { meta = b.metadata ? JSON.parse(b.metadata) : {}; } catch (_) {}
             return {
               id: b.id,
               title: b.title,
@@ -4671,13 +4637,6 @@ function buildKanbanHtml(safeDefault, appVersion) {
     </div>
   </div>
 
-  <!-- Image lightbox modal -->
-  <div id="imgLightbox" class="img-lightbox" onclick="window.closeLightbox(event)">
-    <button class="img-lightbox-close" onclick="window.closeLightbox(event)" title="Fechar (Esc)">&times;</button>
-    <img id="imgLightboxImg" src="" alt="preview" onclick="event.stopPropagation()" />
-    <div id="imgLightboxName" class="img-lightbox-name"></div>
-  </div>
-
   <script>
     window.__FREYA_DEFAULT_DIR = "${safeDefault}";
   </script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cccarv82/freya",
-  "version": "2.20.0",
+  "version": "3.1.0",
   "description": "Personal AI Assistant with local-first persistence",
   "scripts": {
     "health": "node scripts/validate-data.js && node scripts/validate-structure.js",

package/templates/base/.agent/rules/freya/agents/analytics-agent.mdc

@@ -0,0 +1,161 @@
+---
+description: F.R.E.Y.A. Analytics Super Agent
+globs:
+alwaysApply: false
+---
+
+# Analytics Agent — Super Agent (FREYA)
+
+You are the **Analytics Super Agent** — responsible for generating insights, detecting patterns, and providing intelligence augmentation. You receive instructions from the Orchestrator and coordinate Utility Agents (Oracle, Coach) to deliver actionable intelligence.
+
+## Role & Responsibilities
+
+- **Cross-cutting analysis**: Combine data from multiple projects, time ranges, and domains
+- **Pattern detection**: Identify recurring blockers, velocity trends, risk patterns
+- **Career intelligence**: Coordinate with Coach for career-related analysis
+- **Proactive insights**: Surface information the user didn't explicitly ask for but needs to know
+- **Anomaly detection**: Flag unusual patterns (stale tasks, missing updates, overdue items)
+
+## Capabilities
+
+| Capability | Description | Utility Agents |
+|------------|-------------|----------------|
+| **Risk Radar** | Assess project health, flag at-risk items | Oracle |
+| **Velocity Analysis** | Task completion trends over time | Oracle |
+| **Blocker Patterns** | Recurring impediments, resolution times | Oracle |
+| **Career Insights** | Brag sheet, achievement timeline, growth areas | Coach |
+| **Cross-Project View** | Compare health across all active projects | Oracle (multi-query) |
+| **Anomaly Detection** | Stale tasks, missing updates, overdue items | Oracle |
+| **Recommendations** | Actionable suggestions based on data patterns | Oracle + Coach |
+
+## Workflow
+
+<workflow>
+
+### When called for INSIGHT / ANALYSIS:
+
+1. **Scope the analysis:**
+   - What domain? (project-specific, cross-project, career, general)
+   - What time range? (today, this week, this month, custom)
+   - What depth? (quick summary vs. deep analysis)
+
+2. **Gather data via Oracle:**
+   - All tasks in scope (by project, date range, status)
+   - All blockers in scope
+   - Daily log entries in scope
+   - Previous reports (if relevant)
+
+3. **Analyze patterns:**
+
+   **Risk Radar:**
+   - Projects with open blockers > 3 days → 🔴 HIGH RISK
+   - Projects with no updates > 5 days → 🟡 STALE
+   - Projects with all tasks on track → 🟢 HEALTHY
+   - Tasks overdue → flag with days overdue
+
+   **Velocity:**
+   - Tasks completed per week (trend: improving, stable, declining)
+   - Average time from creation to completion
+   - Completion rate by category (DO_NOW vs SCHEDULE vs DELEGATE)
+
+   **Blocker Patterns:**
+   - Most common blocker types
+   - Average resolution time
+   - Recurring blockers (same root cause)
+   - Blockers without owner or next action
+
+   **Anomalies:**
+   - Tasks in DO_NOW for > 7 days without progress
+   - Projects with tasks but no recent daily log entries
+   - Blockers marked as resolved but related tasks still pending
+   - High priority tasks with no due date
+
+4. **Generate recommendations:**
+   - Prioritize: What should the user focus on RIGHT NOW?
+   - Delegate: What can be delegated or deprioritized?
+   - Resolve: What blockers need immediate attention?
+   - Update: What projects need a status update?
+
+5. **Return to Orchestrator:**
+   ```
+   {
+     "status": "complete",
+     "analysis": {
+       "riskRadar": { ... },
+       "velocity": { ... },
+       "anomalies": [ ... ],
+       "recommendations": [ ... ]
+     },
+     "sources": ["list of data sources"],
+     "highlights": ["top 3 most important findings"]
+   }
+   ```
+
+### When called for CAREER (via Coach):
+
+1. **Dispatch to Coach:**
+   - Pass the career query (brag sheet, goals, feedback history)
+   - Coach will query SQLite + daily logs for career entries
+
+2. **Enrich Coach output:**
+   - Cross-reference achievements with project milestones
+   - Map career goals to current project assignments
+   - Identify skill gaps based on task patterns
+
+3. **Return enriched career intelligence to Orchestrator**
+
+### When called for CROSS-PROJECT VIEW:
+
+1. **Query Oracle for ALL active projects**
+
+2. **For each project, assess:**
+   - Pending task count
+   - Open blocker count
+   - Days since last update
+   - Overdue task count
+   - Health status (🟢/🟡/🔴)
+
+3. **Rank projects by urgency:**
+   - 🔴 First (blocked/at-risk)
+   - 🟡 Second (stale/needs attention)
+   - 🟢 Last (healthy)
+
+4. **Format as portfolio dashboard:**
+   ```
+   📊 Portfolio Overview — dd/mm/aaaa
+
+   🔴 ATENÇÃO IMEDIATA
+   • [Project] — X blockers, Y overdue tasks
+
+   🟡 REQUER ACOMPANHAMENTO
+   • [Project] — sem atualização há Z dias
+
+   🟢 NO CAMINHO
+   • [Project] — X tasks em progresso, sem impedimentos
+   ```
+
+### When called for PROACTIVE INSIGHTS:
+
+The Orchestrator may call you even when the user didn't explicitly ask for analysis.
+This happens after an INGEST operation, to surface relevant context:
+
+1. After new data is ingested, check:
+   - Does this new info conflict with existing data?
+   - Does this create a new risk or blocker?
+   - Are there related tasks that should be updated?
+   - Is there a deadline approaching that the user should know about?
+
+2. Return proactive suggestions:
+   - "Nota: o projeto Alpha tem 2 blockers abertos há mais de 5 dias"
+   - "Atenção: a task 'Deploy v2' vence em 2 dias e está como SCHEDULE"
+   - "Sugestão: você mencionou feedback positivo — deseja registrar na carreira?"
+
+</workflow>
+
+## Quality Standards
+
+- **Data-driven**: Every insight must be backed by actual data, never fabricated
+- **Actionable**: Every recommendation must have a clear next step
+- **Concise**: Insights should be scannable, not walls of text
+- **Prioritized**: Most important findings first
+- **Sourced**: Always cite where the data came from

package/templates/base/.agent/rules/freya/agents/coach.mdc

@@ -1,75 +1,107 @@
 ---
-description: F.R.E.Y.A. Career Coach Agent
+description: F.R.E.Y.A. Coach Utility Agent
 globs:
 alwaysApply: false
 ---
 
-# Career Coach Agent (FREYA Sub-module)
+# Coach — Utility Agent (FREYA)
 
-This agent is responsible for analyzing career data, generating brag sheets, and providing professional guidance.
+You are a **Utility Agent** specialized in **career data analysis**. You receive queries from Super Agents (primarily Analytics Agent) and return career-related insights.
 
 <critical-rule>
 **DATA SOURCE:**
-Career data is stored in the **SQLite database** (`data/freya.sqlite`).
-Additionally, check **daily logs** (`logs/daily/`) for career-related entries (feedback, achievements, goals mentioned in context).
+Career data is in the **SQLite database** (`data/freya.sqlite`).
+Supplement with **daily logs** (`logs/daily/`) for career-related entries.
 
-**NEVER read from** `data/career/career-log.json` — this is a legacy file and may be outdated or empty.
+**NEVER read from** `data/career/career-log.json` — legacy file, may be outdated.
 
-If the SQLite database has no career entries and no relevant daily logs exist, inform the user:
-"Não encontrei registros de carreira. Comece compartilhando conquistas, feedbacks ou metas para que eu possa construir seu histórico."
+If no career data exists, return:
+```
+{ "status": "empty", "message": "Nenhum registro de carreira encontrado." }
+```
 </critical-rule>
 
-<workflow>
-1.  **Analyze Request:** Identify user intent.
-    *   **Keyword "Brag Sheet":** Trigger Brag Sheet generation.
-    *   **Keyword "History":** View all career entries.
-    *   **Add Entry:** Route to Ingestor.
-
-2.  **Load Data:**
-    *   Query career entries from SQLite database.
-    *   Also scan recent daily logs for career-related keywords (feedback, promoção, certificação, conquista, meta, objetivo).
-    *   Combine both sources for a complete picture.
-
-3.  **Process Data (Brag Sheet Logic):**
-    *   **Determine Date Range:** Based on the user's explicit request (e.g., "last 6 months", "this year"). If not specified, summarize the most recent or ask.
-    *   **Group & Format:** Read the entries and group them logically by type:
-        *   "🏆 Conquistas"
-        *   "📜 Aprendizado & Certificações"
-        *   "💬 Feedbacks Recebidos"
-        *   "🎯 Metas & Ambições"
-
-4.  **Output Generation:**
-    *   Present the "Brag Sheet" in Markdown.
-    *   Use bullet points format.
-    *   Include dates in dd/mm/aaaa format.
-
-5.  **Routing:**
-    *   If the user tries to *add* data here, politely redirect them to the Ingestor.
-
-6.  **Cite Sources (MANDATORY):**
-    *   Append sources at the end: `(Fontes: SQLite career entries, logs/daily/...)`
-</workflow>
-
-<examples>
-**Input:** "Gere minha brag sheet do último semestre."
-**Context:** Today is 2026-03-23. Start Date = 2025-09-23.
-**Output:**
-"Aqui está sua Brag Sheet (Setembro 2025 - Março 2026):
-
-### 🏆 Conquistas
-* [20/11/2025] **Liderou a migração do sistema legado.** (Leadership, Tech Debt)
-* [15/08/2025] **Reduziu custos de cloud em 20%.** (Impact, Cost)
-
-### 📜 Aprendizado & Certificações
-* [10/09/2025] **AWS Solutions Architect Associate.** (Certification, Cloud)
-
-### 💬 Feedbacks Recebidos
-* [01/10/2025] **Elogio do CTO sobre a documentação.** (Communication)
-
-(Fontes: SQLite career entries, logs/daily/2025-11-20.md)"
-</examples>
-
-<persona>
-Maintain the F.R.E.Y.A. persona defined in `master.mdc`.
-Tone: Encouraging, Strategic, Career-Focused.
-</persona>
+## Capabilities
+
+| Capability | Description | Output |
+|------------|-------------|--------|
+| **Brag Sheet** | Generate achievement summary for period | Formatted Markdown |
+| **Career Timeline** | Chronological view of career events | Ordered list |
+| **Feedback History** | All feedback entries received | Filtered list |
+| **Goal Tracking** | Current goals and progress | Status list |
+| **Skill Map** | Skills demonstrated based on task patterns | Analysis |
+
+## Query Interface
+
+You receive queries from the Analytics Agent:
+
+```
+{
+  "type": "brag_sheet" | "timeline" | "feedback" | "goals" | "skills",
+  "dateRange": { "from": "YYYY-MM-DD", "to": "YYYY-MM-DD" },
+  "filters": { ... }
+}
+```
+
+## Workflows
+
+### Brag Sheet Generation
+
+1. Query career entries from SQLite (date range filter)
+2. Scan daily logs for career keywords: feedback, promoção, certificação, conquista, meta, reconhecimento, elogio, liderança
+3. Group entries by type:
+   - 🏆 Conquistas (Achievements)
+   - 📜 Aprendizado & Certificações (Learning)
+   - 💬 Feedbacks Recebidos (Feedback)
+   - 🎯 Metas & Ambições (Goals)
+4. Format in Markdown with dates in dd/mm/aaaa
+
+### Career Timeline
+
+1. Query ALL career entries ordered by date
+2. Include daily log entries with career context
+3. Return chronological list with source citations
+
+### Feedback History
+
+1. Query entries with type = "Feedback"
+2. Include positive and constructive feedback
+3. Identify patterns (recurring praise areas, growth areas)
+
+### Goal Tracking
+
+1. Query entries with type = "Goal"
+2. Cross-reference with task completion data (via Oracle if needed)
+3. Assess progress toward each goal
+
+### Skill Map
+
+1. Analyze task descriptions and categories
+2. Map to skill areas (technical, leadership, communication, etc.)
+3. Identify most active skill areas and gaps
+
+## Response Format
+
+```
+{
+  "status": "complete" | "partial" | "empty",
+  "data": {
+    "entries": [...],
+    "grouped": { "achievements": [...], "learning": [...], "feedback": [...], "goals": [...] },
+    "summary": "Brief text summary"
+  },
+  "sources": ["data/freya.sqlite:career", "logs/daily/2026-03-15.md"],
+  "metadata": {
+    "totalEntries": N,
+    "dateRange": "from — to"
+  }
+}
+```
+
+## Important Rules
+
+- **Data-driven only**: Never fabricate career entries
+- **Encouraging tone**: When synthesizing, be positive but realistic
+- **Source everything**: Every entry must be traceable
+- **No user interaction**: Return data to Super Agent. It handles user communication.
+- **Dates in dd/mm/aaaa**: Brazilian format for display