@cccarv82/freya 1.0.52 → 1.0.54

package/.agent/rules/freya/agents/oracle.mdc

@@ -25,6 +25,12 @@ Do not invent status updates.
         *   **Keywords:** "Tarefa", "Task", "To-Do", "Fazer", "Agenda", "Delegado".
         *   **Target File:** `data/tasks/task-log.json`.
         *   **Action:** Read file directly.
+    *   **If Daily Log Query:**
+        *   **Keywords:** "log diário", "diário", "daily log", "anotações", "o que anotei", "ontem", "hoje", "semana passada".
+        *   **Target Folder:** `logs/daily/`.
+        *   **If date provided:** Read `logs/daily/YYYY-MM-DD.md`.
+        *   **If date is relative (hoje/ontem):** Resolve to an exact date and read the matching file.
+        *   **If no specific date or file missing:** Route to **Search** across `logs/daily/` (or ask the user to refine the date). If Search is unavailable, say you have no records for that date and offer to list available log dates.
     *   **If Project Query:**
         *   Proceed to Project Lookup (Glob search).
         *   **Strategy:** Search recursively in `data/Clients`.
@@ -46,7 +52,13 @@ Do not invent status updates.
             *   **Context:** "Aqui estão suas tarefas pendentes [{Category}]:"
             *   **List:** Bullet points.
                 *   Format: `* [ID-Short] {Description} ({Priority})`
-            *   **Empty:** "Você não tem tarefas pendentes nesta categoria."
+        *   **Empty:** "Você não tem tarefas pendentes nesta categoria."
+
+    *   **Daily Log Logic:**
+        *   Read the Markdown file from `logs/daily/YYYY-MM-DD.md`.
+        *   Return a concise excerpt (first few meaningful lines or bullet points).
+        *   If the file is empty, say: "Log registrado sem detalhes para essa data."
+        *   If the file does not exist: "Não encontrei log diário para esta data."
 
     *   **Project Logic:**
         *   If matches found: Read the `status.json` file(s).

package/README.md

@@ -8,7 +8,7 @@ F.R.E.Y.A. é um sistema de agentes de IA projetado para organizar seu trabalho,
 
 *   **Ingestão Universal:** Registre updates, blockers e notas mentais em linguagem natural.
 *   **Gestão de Tarefas:** Crie, liste e conclua tarefas ("Lembre-me de fazer X", "Minhas tarefas", "Terminei X").
-*   **Oráculo:** Pergunte sobre o status de qualquer projeto ("Como está o projeto X?").
+*   **Oráculo:** Pergunte sobre o status de qualquer projeto ("Como está o projeto X?") e recupere logs diários ("O que anotei ontem?").
 *   **Career Coach:** Gere "Brag Sheets" automáticas para suas avaliações de desempenho.
 *   **Relatórios Automatizados:** Gere resumos semanais, dailies, relatório de Scrum Master e relatórios executivos.
 *   **Blockers & Riscos:** Gere um relatório rápido de blockers priorizados por severidade.

package/cli/web.js

@@ -30,6 +30,12 @@ function escapeHtml(str) {
 
 const APP_VERSION = readAppVersion();
 
+const CHAT_ID_PATTERNS = [
+  /\bPTI\d{4,}-\d+\b/gi,
+  /\bINC\d+\b/gi,
+  /\bCHG\d+\b/gi
+];
+
 function guessNpmCmd() {
   // We'll execute via cmd.exe on Windows for reliability.
   return process.platform === 'win32' ? 'npm' : 'npm';
@@ -637,6 +643,61 @@ function isAllowedChatSearchPath(relPath) {
   return relPath.startsWith('data/') || relPath.startsWith('logs/') || relPath.startsWith('docs/');
 }
 
+function extractChatIds(text) {
+  const tokens = new Set();
+  const q = String(text || '');
+  for (const re of CHAT_ID_PATTERNS) {
+    const matches = q.match(re);
+    if (matches) {
+      for (const m of matches) tokens.add(m.toUpperCase());
+    }
+  }
+  return Array.from(tokens);
+}
+
+function extractProjectToken(text) {
+  const raw = String(text || '');
+  const m = raw.match(/project\s*[:=]\s*([A-Za-z0-9_\/-]+)/i);
+  if (m && m[1]) return m[1].trim();
+  const m2 = raw.match(/project\s*\(([^)]+)\)/i);
+  if (m2 && m2[1]) return m2[1].trim();
+  return '';
+}
+
+function projectFromPath(relPath) {
+  const p = String(relPath || '');
+  const m = p.match(/data\/Clients\/([^/]+)\/([^/]+)/i);
+  if (m && m[1] && m[2]) return `${m[1]}/${m[2]}`;
+  return '';
+}
+
+function matchKey(m) {
+  const ids = extractChatIds(`${m.file || ''} ${m.snippet || ''}`);
+  if (ids.length) return `id:${ids[0]}`;
+  const proj = projectFromPath(m.file) || extractProjectToken(`${m.file || ''} ${m.snippet || ''}`);
+  if (proj) return `proj:${proj.toLowerCase()}`;
+  return `file:${m.file || ''}`;
+}
+
+function mergeMatches(primary, secondary, limit = 8) {
+  const list = [];
+  const seen = new Set();
+  const push = (m) => {
+    if (!m || !m.file || !isAllowedChatSearchPath(m.file)) return;
+    const key = matchKey(m);
+    if (seen.has(key)) return;
+    seen.add(key);
+    list.push(m);
+  };
+
+  (primary || []).forEach(push);
+  (secondary || []).forEach(push);
+
+  const total = list.length;
+  const trimmed = list.slice(0, Math.max(1, Math.min(20, limit)));
+  return { matches: trimmed, total };
+}
+
 async function copilotSearch(workspaceDir, query, opts = {}) {
   const q = String(query || '').trim();
   if (!q) return { ok: false, error: 'Missing query' };
@@ -723,8 +784,8 @@ async function copilotSearch(workspaceDir, query, opts = {}) {
   return { ok: true, answer, matches, evidence };
 }
 
-function buildChatAnswer(query, matches, summary, evidence, answer) {
-  const count = matches.length;
+function buildChatAnswer(query, matches, summary, evidence, answer, totalCount) {
+  const count = typeof totalCount === 'number' ? totalCount : matches.length;
   let summaryText = String(summary || '').trim();
   let answerText = String(answer || '').trim();
   if (!answerText) {
@@ -740,7 +801,7 @@ function buildChatAnswer(query, matches, summary, evidence, answer) {
 
   const lines = [];
   lines.push(`Encontrei ${count} registro(s).`);
-  lines.push(`Resumo: ${answerText}`);
+  lines.push(`Resposta curta: ${answerText}`);
 
   const evidences = Array.isArray(evidence) && evidence.length
     ? evidence
@@ -749,15 +810,15 @@ function buildChatAnswer(query, matches, summary, evidence, answer) {
   if (!evidences.length) return lines.join('\n');
 
   lines.push('');
-  lines.push('Principais evidências:');
+  lines.push('Detalhes:');
   for (const m of evidences.slice(0, 5)) {
-    const parts = [];
-    if (m.date) parts.push(`**${m.date}**`);
-    if (m.file) parts.push('`' + m.file + '`');
-    const prefix = parts.length ? parts.join(' — ') + ':' : '';
     const detail = (m.detail || m.snippet || '').toString().trim();
     if (!detail) continue;
-    lines.push(`- ${prefix} ${detail}`);
+    const meta = [];
+    if (m.file) meta.push(m.file);
+    if (m.date) meta.push(m.date);
+    const suffix = meta.length ? ` (${meta.join(' · ')})` : '';
+    lines.push(`- ${detail}${suffix}`);
   }
 
   return lines.join('\n');
@@ -1781,24 +1842,27 @@ async function cmdWeb({ port, dir, open, dev }) {
           if (!query) return safeJson(res, 400, { error: 'Missing query' });
 
           const copilotResult = await copilotSearch(workspaceDir, query, { limit: 8 });
+          const indexMatches = searchIndex(workspaceDir, query, { limit: 12 });
+          const baseMatches = indexMatches.length
+            ? indexMatches
+            : searchWorkspace(workspaceDir, query, { limit: 12 });
+
           if (copilotResult.ok) {
-            const matches = copilotResult.matches || [];
+            const merged = mergeMatches(copilotResult.matches || [], baseMatches, 8);
             const answer = buildChatAnswer(
               query,
-              matches,
+              merged.matches,
               copilotResult.summary,
               copilotResult.evidence,
-              copilotResult.answer
+              copilotResult.answer,
+              merged.total
             );
-            return safeJson(res, 200, { ok: true, sessionId, answer, matches });
+            return safeJson(res, 200, { ok: true, sessionId, answer, matches: merged.matches });
           }
 
-          const indexMatches = searchIndex(workspaceDir, query, { limit: 8 });
-          const matches = indexMatches.length
-            ? indexMatches
-            : searchWorkspace(workspaceDir, query, { limit: 8 });
-          const answer = buildChatAnswer(query, matches, '');
-          return safeJson(res, 200, { ok: true, sessionId, answer, matches });
+          const merged = mergeMatches(baseMatches, [], 8);
+          const answer = buildChatAnswer(query, merged.matches, '', [], '', merged.total);
+          return safeJson(res, 200, { ok: true, sessionId, answer, matches: merged.matches });
         }
 
         // Chat persistence (per session)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cccarv82/freya",
-  "version": "1.0.52",
+  "version": "1.0.54",
   "description": "Personal AI Assistant with local-first persistence",
   "scripts": {
     "health": "node scripts/validate-data.js",
@@ -13,7 +13,7 @@
     "export-obsidian": "node scripts/export-obsidian.js",
     "build-index": "node scripts/index/build-index.js",
     "update-index": "node scripts/index/update-index.js",
-    "test": "node tests/unit/test-package-config.js && node tests/unit/test-cli-init.js && node tests/unit/test-cli-web-help.js && node tests/unit/test-web-static-assets.js && node tests/unit/test-fs-utils.js && node tests/unit/test-search-utils.js && node tests/unit/test-index-utils.js && node tests/unit/test-task-schema.js && node tests/unit/test-daily-generation.js && node tests/unit/test-report-generation.js && node tests/unit/test-oracle-retrieval.js && node tests/unit/test-task-completion.js && node tests/unit/test-migrate-data.js && node tests/unit/test-blockers-validation.js && node tests/unit/test-blockers-report.js && node tests/unit/test-sm-weekly-report.js && node tests/integration/test-ingestor-task.js"
+    "test": "node tests/unit/test-package-config.js && node tests/unit/test-cli-init.js && node tests/unit/test-cli-web-help.js && node tests/unit/test-web-static-assets.js && node tests/unit/test-fs-utils.js && node tests/unit/test-search-utils.js && node tests/unit/test-index-utils.js && node tests/unit/test-task-schema.js && node tests/unit/test-daily-generation.js && node tests/unit/test-report-generation.js && node tests/unit/test-executive-report-logs.js && node tests/unit/test-oracle-retrieval.js && node tests/unit/test-task-completion.js && node tests/unit/test-migrate-data.js && node tests/unit/test-blockers-validation.js && node tests/unit/test-blockers-report.js && node tests/unit/test-sm-weekly-report.js && node tests/integration/test-ingestor-task.js"
   },
   "keywords": [],
   "author": "",

package/scripts/generate-executive-report.js

@@ -9,7 +9,7 @@
 const fs = require('fs');
 const path = require('path');
 
-const { toIsoDate, isWithinRange } = require('./lib/date-utils');
+const { toIsoDate, isWithinRange, safeParseToMs } = require('./lib/date-utils');
 const { safeReadJson, quarantineCorruptedFile } = require('./lib/fs-utils');
 
 // --- Configuration ---
@@ -17,6 +17,15 @@ const DATA_DIR = path.join(__dirname, '../data');
 const LOGS_DIR = path.join(__dirname, '../logs/daily');
 const OUTPUT_DIR = path.join(__dirname, '../docs/reports');
 const TASKS_FILE = path.join(DATA_DIR, 'tasks/task-log.json');
+const BLOCKERS_FILE = path.join(DATA_DIR, 'blockers/blocker-log.json');
+
+const RESOLVED_STATUSES = new Set(['RESOLVED', 'CLOSED', 'DONE', 'FIXED']);
+const SEVERITY_ORDER = {
+    CRITICAL: 0,
+    HIGH: 1,
+    MEDIUM: 2,
+    LOW: 3
+};
 
 // --- Helpers ---
 function getDateRange(period) {
@@ -152,6 +161,135 @@ function getDailyLogs(start, end) {
     return relevantLogs;
 }
 
+function summarizeLogContent(content, maxLines = 3, maxChars = 280) {
+    if (!content) return null;
+    const lines = content
+        .split('\n')
+        .map(line => line.trim())
+        .filter(line => line && !line.startsWith('#'));
+
+    const highlights = [];
+    for (const line of lines) {
+        const cleaned = line.replace(/^[-*]\s+/, '').replace(/^>\s+/, '').trim();
+        if (!cleaned) continue;
+        highlights.push(cleaned);
+        if (highlights.length >= maxLines) break;
+    }
+
+    if (highlights.length === 0) return null;
+    let summary = highlights.join('; ');
+    if (summary.length > maxChars) {
+        summary = summary.slice(0, Math.max(0, maxChars - 3)).trim() + '...';
+    }
+    return summary;
+}
+
+function normalizeStatus(blocker) {
+    const raw = blocker.status || blocker.state || blocker.currentStatus;
+    if (!raw) return 'UNKNOWN';
+    return String(raw).trim().toUpperCase();
+}
+
+function normalizeSeverity(blocker) {
+    const raw = blocker.severity || blocker.priority || blocker.level;
+    if (!raw) return 'UNSPECIFIED';
+    const value = String(raw).trim().toUpperCase();
+    if (value.includes('CRIT')) return 'CRITICAL';
+    if (value.includes('HIGH')) return 'HIGH';
+    if (value.includes('MED')) return 'MEDIUM';
+    if (value.includes('LOW')) return 'LOW';
+    return value;
+}
+
+function getBlockerTitle(blocker) {
+    return (
+        blocker.title ||
+        blocker.summary ||
+        blocker.description ||
+        blocker.content ||
+        blocker.text ||
+        'Untitled blocker'
+    );
+}
+
+function getCreatedAt(blocker) {
+    const candidates = [
+        blocker.createdAt,
+        blocker.created_at,
+        blocker.openedAt,
+        blocker.opened_at,
+        blocker.reportedAt,
+        blocker.reported_at,
+        blocker.date,
+        blocker.loggedAt
+    ];
+    for (const value of candidates) {
+        const ms = safeParseToMs(value);
+        if (Number.isFinite(ms)) return ms;
+    }
+    return NaN;
+}
+
+function getResolvedAt(blocker) {
+    const candidates = [
+        blocker.resolvedAt,
+        blocker.resolved_at,
+        blocker.closedAt,
+        blocker.closed_at,
+        blocker.completedAt
+    ];
+    for (const value of candidates) {
+        const ms = safeParseToMs(value);
+        if (Number.isFinite(ms)) return ms;
+    }
+    return NaN;
+}
+
+function isOpen(blocker) {
+    const status = normalizeStatus(blocker);
+    if (RESOLVED_STATUSES.has(status)) return false;
+    const resolvedAt = getResolvedAt(blocker);
+    return !Number.isFinite(resolvedAt);
+}
+
+function loadBlockers() {
+    if (!fs.existsSync(BLOCKERS_FILE)) return [];
+    const result = safeReadJson(BLOCKERS_FILE);
+    if (!result.ok) {
+        const relativePath = path.relative(DATA_DIR, BLOCKERS_FILE);
+        if (result.error.type === 'parse') {
+            quarantineCorruptedFile(BLOCKERS_FILE, result.error.message);
+            console.warn(`⚠️ [${relativePath}] JSON parse failed; quarantined to _corrupted.`);
+        } else {
+            console.error(`Error reading blockers: ${result.error.message}`);
+        }
+        return [];
+    }
+    return Array.isArray(result.json.blockers) ? result.json.blockers : [];
+}
+
+function getBlockers(start, end) {
+    const blockers = loadBlockers();
+    const open = blockers.filter(isOpen);
+    open.sort((a, b) => {
+        const severityA = normalizeSeverity(a);
+        const severityB = normalizeSeverity(b);
+        const rankA = SEVERITY_ORDER[severityA] ?? 99;
+        const rankB = SEVERITY_ORDER[severityB] ?? 99;
+        if (rankA !== rankB) return rankA - rankB;
+        const createdA = getCreatedAt(a);
+        const createdB = getCreatedAt(b);
+        const msA = Number.isFinite(createdA) ? createdA : Number.MAX_SAFE_INTEGER;
+        const msB = Number.isFinite(createdB) ? createdB : Number.MAX_SAFE_INTEGER;
+        return msA - msB;
+    });
+
+    const openedRecent = blockers.filter(blocker => isWithinRange(getCreatedAt(blocker), start, end));
+    const resolvedRecent = blockers.filter(blocker => isWithinRange(getResolvedAt(blocker), start, end));
+
+    return { open, openedRecent, resolvedRecent };
+}
+
 // --- Report Generation ---
 
 function generateReport(period) {
@@ -162,7 +300,8 @@ function generateReport(period) {
 
     const tasks = getTasks(start, end);
     const projects = getProjectUpdates(start, end);
-    // const logs = getDailyLogs(start, end); // Maybe too verbose to include raw logs, let's stick to summarized data
+    const logs = getDailyLogs(start, end);
+    const blockers = getBlockers(start, end);
 
     let md = `# Relatório de Status Profissional - ${dateStr}\n`;
     md += `**Período:** ${formatDate(start)} a ${formatDate(end)}\n\n`;
@@ -171,9 +310,25 @@ function generateReport(period) {
     md += `## 📋 Resumo Executivo\n`;
     const totalDone = tasks.completed.length;
     const activeProjects = projects.length;
-    md += `Neste período, foram concluídas **${totalDone}** entregas focais. Atualmente há **${activeProjects}** projetos com atualizações recentes.\n\n`;
+    const logCount = logs.length;
+    const openBlockers = blockers.open.length;
+    md += `Neste período, foram concluídas **${totalDone}** entregas focais. Atualmente há **${activeProjects}** projetos com atualizações recentes. Foram registrados **${logCount}** logs diários e existem **${openBlockers}** blockers em aberto.\n\n`;
+
+    // 2. Contexto dos Logs Diários
+    md += `## 📝 Contexto dos Logs Diários\n`;
+    if (logs.length === 0) {
+        md += `*Sem logs diários no período.*\n\n`;
+    } else {
+        logs
+            .sort((a, b) => a.date.localeCompare(b.date))
+            .forEach(log => {
+                const summary = summarizeLogContent(log.content) || 'Log registrado sem destaques.';
+                md += `- **${log.date}:** ${summary}\n`;
+            });
+        md += `\n`;
+    }
 
-    // 2. Principais Entregas
+    // 3. Principais Entregas
     md += `## ✅ Principais Entregas\n`;
     if (tasks.completed.length === 0) {
         md += `*Nenhuma entrega registrada no período.*\n`;
@@ -185,7 +340,7 @@ function generateReport(period) {
     }
     md += `\n`;
 
-    // 3. Status dos Projetos
+    // 4. Status dos Projetos
     md += `## 🏗️ Status dos Projetos\n`;
     if (projects.length === 0) {
         md += `*Sem atualizações de projeto recentes.*\n`;
@@ -204,7 +359,41 @@ function generateReport(period) {
         });
     }
 
-    // 4. Próximos Passos
+    // 5. Bloqueios
+    md += `## 🚧 Bloqueios\n`;
+    if (blockers.open.length === 0) {
+        md += `*Nenhum blocker em aberto registrado.*\n`;
+    } else {
+        md += `**Em aberto:**\n`;
+        blockers.open.forEach(blocker => {
+            const title = getBlockerTitle(blocker);
+            const severity = normalizeSeverity(blocker);
+            const createdAt = getCreatedAt(blocker);
+            const createdDate = Number.isFinite(createdAt) ? toIsoDate(createdAt) : 'Unknown';
+            const project = blocker.project || blocker.projectName || blocker.projectSlug;
+            const client = blocker.client || blocker.clientName || blocker.clientSlug;
+            const metaParts = [
+                `Severidade: ${severity}`,
+                project ? `Projeto: ${project}` : null,
+                client ? `Cliente: ${client}` : null,
+                `Aberto: ${createdDate}`
+            ].filter(Boolean);
+            md += `- ${title} (${metaParts.join('; ')})\n`;
+        });
+    }
+
+    if (blockers.resolvedRecent.length > 0) {
+        md += `\n**Resolvidos no período:**\n`;
+        blockers.resolvedRecent.forEach(blocker => {
+            const title = getBlockerTitle(blocker);
+            const resolvedAt = getResolvedAt(blocker);
+            const resolvedDate = Number.isFinite(resolvedAt) ? toIsoDate(resolvedAt) : 'Unknown';
+            md += `- ${title} (Resolvido: ${resolvedDate})\n`;
+        });
+    }
+    md += `\n\n`;
+
+    // 6. Próximos Passos
     md += `## 🚀 Próximos Passos\n`;
     if (tasks.pending.length === 0) {
         md += `*Sem itens prioritários na fila.*\n`;

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

@@ -25,6 +25,12 @@ Do not invent status updates.
         *   **Keywords:** "Tarefa", "Task", "To-Do", "Fazer", "Agenda", "Delegado".
         *   **Target File:** `data/tasks/task-log.json`.
         *   **Action:** Read file directly.
+    *   **If Daily Log Query:**
+        *   **Keywords:** "log diário", "diário", "daily log", "anotações", "o que anotei", "ontem", "hoje", "semana passada".
+        *   **Target Folder:** `logs/daily/`.
+        *   **If date provided:** Read `logs/daily/YYYY-MM-DD.md`.
+        *   **If date is relative (hoje/ontem):** Resolve to an exact date and read the matching file.
+        *   **If no specific date or file missing:** Route to **Search** across `logs/daily/` (or ask the user to refine the date). If Search is unavailable, say you have no records for that date and offer to list available log dates.
     *   **If Project Query:**
         *   Proceed to Project Lookup (Glob search).
         *   **Strategy:** Search recursively in `data/Clients`.
@@ -46,7 +52,13 @@ Do not invent status updates.
             *   **Context:** "Aqui estão suas tarefas pendentes [{Category}]:"
             *   **List:** Bullet points.
                 *   Format: `* [ID-Short] {Description} ({Priority})`
-            *   **Empty:** "Você não tem tarefas pendentes nesta categoria."
+        *   **Empty:** "Você não tem tarefas pendentes nesta categoria."
+
+    *   **Daily Log Logic:**
+        *   Read the Markdown file from `logs/daily/YYYY-MM-DD.md`.
+        *   Return a concise excerpt (first few meaningful lines or bullet points).
+        *   If the file is empty, say: "Log registrado sem detalhes para essa data."
+        *   If the file does not exist: "Não encontrei log diário para esta data."
 
     *   **Project Logic:**
         *   If matches found: Read the `status.json` file(s).
@@ -96,6 +108,7 @@ Em atraso devido a condições climáticas.
 <persona>
 Maintain the F.R.E.Y.A. persona defined in `master.mdc`.
 Tone: Analytical, Precise, Data-Driven.
+Obsidian: Quando citar projetos/notas, prefira nomes e links em formato Obsidian (wikilinks `[[...]]`) quando aplicável.
 Signature:
 — FREYA
 Assistente Responsiva com Otimização Aprimorada

package/templates/base/README.md

@@ -8,7 +8,7 @@ F.R.E.Y.A. é um sistema de agentes de IA projetado para organizar seu trabalho,
 
 *   **Ingestão Universal:** Registre updates, blockers e notas mentais em linguagem natural.
 *   **Gestão de Tarefas:** Crie, liste e conclua tarefas ("Lembre-me de fazer X", "Minhas tarefas", "Terminei X").
-*   **Oráculo:** Pergunte sobre o status de qualquer projeto ("Como está o projeto X?").
+*   **Oráculo:** Pergunte sobre o status de qualquer projeto ("Como está o projeto X?") e recupere logs diários ("O que anotei ontem?").
 *   **Career Coach:** Gere "Brag Sheets" automáticas para suas avaliações de desempenho.
 *   **Relatórios Automatizados:** Gere resumos semanais, dailies, relatório de Scrum Master e relatórios executivos.
 *   **Blockers & Riscos:** Gere um relatório rápido de blockers priorizados por severidade.
@@ -16,9 +16,68 @@ F.R.E.Y.A. é um sistema de agentes de IA projetado para organizar seu trabalho,
 *   **Git Automation:** Gere commits inteligentes automaticamente. A Freya analisa suas mudanças e escreve a mensagem para você.
 *   **Privacidade Total:** Seus dados (JSON e Markdown) ficam 100% locais na sua máquina.
 
+## 📦 Instalação (CLI)
+
+Você pode usar a FREYA como um CLI para **inicializar uma workspace** completa (agents + scripts + data) em qualquer diretório.
+
+## 🚢 Publicação no npm (maintainers)
+
+Este repositório suporta publicação automática via GitHub Actions.
+
+### Pré-requisitos
+1) Ter permissão de publish no pacote `@cccarv82/freya` no npm.
+2) Criar o secret no GitHub: `NPM_TOKEN` (Automation token do npm com permissão de publish).
+
+### Como publicar
+1) Atualize a versão e crie uma tag `vX.Y.Z`:
+```bash
+npm version patch
+# ou minor/major
+
+git push --follow-tags
+```
+2) A Action `npm-publish` roda no push da tag e executa `npm publish --access public`.
+
+### Via npx (recomendado)
+```bash
+npx @cccarv82/freya init
+# cria ./freya
+```
+
+### Via instalação global
+```bash
+npm i -g @cccarv82/freya
+freya init
+# cria ./freya
+```
+
+### Modos do `init`
+```bash
+freya init              # cria ./freya
+freya init meu-projeto  # cria ./meu-projeto
+freya init --here       # instala no diretório atual
+```
+
+### Atualizar uma workspace existente (sem perder dados)
+Por padrão, ao rodar `init` em uma pasta existente, o CLI **preserva**:
+- `data/**`
+- `logs/**`
+
+E atualiza/instala normalmente:
+- `.agent/**`
+- `scripts/**`
+- `README.md`, `USER_GUIDE.md`
+- `package.json` (merge de scripts)
+
+Flags (use com cuidado):
+```bash
+freya init --here --force-data   # permite sobrescrever data/
+freya init --here --force-logs   # permite sobrescrever logs/
+```
+
 ## 🚀 Como Usar
 
-1.  Abra esta pasta na **sua IDE**.
+1.  Abra a pasta da workspace gerada (ex.: `./freya`) na **sua IDE**.
 2.  No chat da IDE (ex: Ctrl+L / Cmd+L), digite:
     > `@freya Ajuda`
 3.  Siga as instruções da assistente.

package/templates/base/USER_GUIDE.md

@@ -5,6 +5,39 @@ Este sistema foi projetado para ser seu assistente pessoal de produtividade, ope
 
 ## 🚀 Como Iniciar
 
+### 1) Criar uma workspace (CLI)
+Você pode inicializar uma workspace completa (agents + scripts + data) em qualquer diretório.
+
+**Via npx (recomendado):**
+```bash
+npx @cccarv82/freya init
+# cria ./freya
+```
+
+**Via instalação global:**
+```bash
+npm i -g @cccarv82/freya
+freya init
+# cria ./freya
+```
+
+**Modos do init:**
+```bash
+freya init              # cria ./freya
+freya init meu-projeto  # cria ./meu-projeto
+freya init --here       # instala no diretório atual
+```
+
+**Upgrade sem perder dados (recomendado):**
+Ao rodar `init` em uma pasta já existente, o CLI **preserva automaticamente** `data/**` e `logs/**` (se não estiverem vazios) e atualiza o restante.
+
+Se você quiser sobrescrever explicitamente:
+```bash
+freya init --here --force-data
+freya init --here --force-logs
+```
+
+### 2) Interagir no chat da IDE
 Para interagir com a assistente, basta chamá-la no chat da sua IDE:
 
 > `@freya [sua mensagem]`
@@ -39,6 +72,10 @@ Recupere o contexto de qualquer projeto instantaneamente.
     > "Como está o projeto Vivo 5G?"
     *   *Resultado:* Resumo executivo do status atual e das últimas 3 atualizações.
 
+*   **Consulta de Logs Diários:**
+    > "O que anotei ontem?"
+    *   *Resultado:* Retorna um trecho do log diário em `logs/daily/YYYY-MM-DD.md` (ou direciona para busca quando a data não estiver clara).
+
 *   **Anti-Alucinação:**
     A FREYA sempre citará a fonte da informação (ex: `(Source: data/Clients/vivo/5g/status.json)`). Se ela não souber, ela dirá explicitamente.
 
@@ -80,7 +117,7 @@ Transforme seus logs em relatórios úteis sem esforço. Peça à FREYA no chat
 
 *   **Relatório de Status Profissional (Executivo):**
     > "Gerar status report", "Relatório Executivo"
-    *   *Resultado:* Gera um relatório Markdown completo com Resumo Executivo, Entregas, Status de Projetos e Bloqueios. Ideal para enviar stakeholders.
+    *   *Resultado:* Gera um relatório Markdown completo com Resumo Executivo, Contexto dos Logs Diários, Entregas, Status de Projetos e Bloqueios. Ideal para enviar stakeholders.
     *   *Manual:* `npm run status -- --period [daily|weekly]`
 
 *   **Relatório Scrum Master (Semanal):**

package/templates/base/scripts/generate-executive-report.js

@@ -9,7 +9,7 @@
 const fs = require('fs');
 const path = require('path');
 
-const { toIsoDate, isWithinRange } = require('./lib/date-utils');
+const { toIsoDate, isWithinRange, safeParseToMs } = require('./lib/date-utils');
 const { safeReadJson, quarantineCorruptedFile } = require('./lib/fs-utils');
 
 // --- Configuration ---
@@ -17,6 +17,15 @@ const DATA_DIR = path.join(__dirname, '../data');
 const LOGS_DIR = path.join(__dirname, '../logs/daily');
 const OUTPUT_DIR = path.join(__dirname, '../docs/reports');
 const TASKS_FILE = path.join(DATA_DIR, 'tasks/task-log.json');
+const BLOCKERS_FILE = path.join(DATA_DIR, 'blockers/blocker-log.json');
+
+const RESOLVED_STATUSES = new Set(['RESOLVED', 'CLOSED', 'DONE', 'FIXED']);
+const SEVERITY_ORDER = {
+    CRITICAL: 0,
+    HIGH: 1,
+    MEDIUM: 2,
+    LOW: 3
+};
 
 // --- Helpers ---
 function getDateRange(period) {
@@ -152,6 +161,135 @@ function getDailyLogs(start, end) {
     return relevantLogs;
 }
 
+function summarizeLogContent(content, maxLines = 3, maxChars = 280) {
+    if (!content) return null;
+    const lines = content
+        .split('\n')
+        .map(line => line.trim())
+        .filter(line => line && !line.startsWith('#'));
+
+    const highlights = [];
+    for (const line of lines) {
+        const cleaned = line.replace(/^[-*]\s+/, '').replace(/^>\s+/, '').trim();
+        if (!cleaned) continue;
+        highlights.push(cleaned);
+        if (highlights.length >= maxLines) break;
+    }
+
+    if (highlights.length === 0) return null;
+    let summary = highlights.join('; ');
+    if (summary.length > maxChars) {
+        summary = summary.slice(0, Math.max(0, maxChars - 3)).trim() + '...';
+    }
+    return summary;
+}
+
+function normalizeStatus(blocker) {
+    const raw = blocker.status || blocker.state || blocker.currentStatus;
+    if (!raw) return 'UNKNOWN';
+    return String(raw).trim().toUpperCase();
+}
+
+function normalizeSeverity(blocker) {
+    const raw = blocker.severity || blocker.priority || blocker.level;
+    if (!raw) return 'UNSPECIFIED';
+    const value = String(raw).trim().toUpperCase();
+    if (value.includes('CRIT')) return 'CRITICAL';
+    if (value.includes('HIGH')) return 'HIGH';
+    if (value.includes('MED')) return 'MEDIUM';
+    if (value.includes('LOW')) return 'LOW';
+    return value;
+}
+
+function getBlockerTitle(blocker) {
+    return (
+        blocker.title ||
+        blocker.summary ||
+        blocker.description ||
+        blocker.content ||
+        blocker.text ||
+        'Untitled blocker'
+    );
+}
+
+function getCreatedAt(blocker) {
+    const candidates = [
+        blocker.createdAt,
+        blocker.created_at,
+        blocker.openedAt,
+        blocker.opened_at,
+        blocker.reportedAt,
+        blocker.reported_at,
+        blocker.date,
+        blocker.loggedAt
+    ];
+    for (const value of candidates) {
+        const ms = safeParseToMs(value);
+        if (Number.isFinite(ms)) return ms;
+    }
+    return NaN;
+}
+
+function getResolvedAt(blocker) {
+    const candidates = [
+        blocker.resolvedAt,
+        blocker.resolved_at,
+        blocker.closedAt,
+        blocker.closed_at,
+        blocker.completedAt
+    ];
+    for (const value of candidates) {
+        const ms = safeParseToMs(value);
+        if (Number.isFinite(ms)) return ms;
+    }
+    return NaN;
+}
+
+function isOpen(blocker) {
+    const status = normalizeStatus(blocker);
+    if (RESOLVED_STATUSES.has(status)) return false;
+    const resolvedAt = getResolvedAt(blocker);
+    return !Number.isFinite(resolvedAt);
+}
+
+function loadBlockers() {
+    if (!fs.existsSync(BLOCKERS_FILE)) return [];
+    const result = safeReadJson(BLOCKERS_FILE);
+    if (!result.ok) {
+        const relativePath = path.relative(DATA_DIR, BLOCKERS_FILE);
+        if (result.error.type === 'parse') {
+            quarantineCorruptedFile(BLOCKERS_FILE, result.error.message);
+            console.warn(`⚠️ [${relativePath}] JSON parse failed; quarantined to _corrupted.`);
+        } else {
+            console.error(`Error reading blockers: ${result.error.message}`);
+        }
+        return [];
+    }
+    return Array.isArray(result.json.blockers) ? result.json.blockers : [];
+}
+
+function getBlockers(start, end) {
+    const blockers = loadBlockers();
+    const open = blockers.filter(isOpen);
+    open.sort((a, b) => {
+        const severityA = normalizeSeverity(a);
+        const severityB = normalizeSeverity(b);
+        const rankA = SEVERITY_ORDER[severityA] ?? 99;
+        const rankB = SEVERITY_ORDER[severityB] ?? 99;
+        if (rankA !== rankB) return rankA - rankB;
+        const createdA = getCreatedAt(a);
+        const createdB = getCreatedAt(b);
+        const msA = Number.isFinite(createdA) ? createdA : Number.MAX_SAFE_INTEGER;
+        const msB = Number.isFinite(createdB) ? createdB : Number.MAX_SAFE_INTEGER;
+        return msA - msB;
+    });
+
+    const openedRecent = blockers.filter(blocker => isWithinRange(getCreatedAt(blocker), start, end));
+    const resolvedRecent = blockers.filter(blocker => isWithinRange(getResolvedAt(blocker), start, end));
+
+    return { open, openedRecent, resolvedRecent };
+}
+
 // --- Report Generation ---
 
 function generateReport(period) {
@@ -162,7 +300,8 @@ function generateReport(period) {
 
     const tasks = getTasks(start, end);
     const projects = getProjectUpdates(start, end);
-    // const logs = getDailyLogs(start, end); // Maybe too verbose to include raw logs, let's stick to summarized data
+    const logs = getDailyLogs(start, end);
+    const blockers = getBlockers(start, end);
 
     let md = `# Relatório de Status Profissional - ${dateStr}\n`;
     md += `**Período:** ${formatDate(start)} a ${formatDate(end)}\n\n`;
@@ -171,9 +310,25 @@ function generateReport(period) {
     md += `## 📋 Resumo Executivo\n`;
     const totalDone = tasks.completed.length;
     const activeProjects = projects.length;
-    md += `Neste período, foram concluídas **${totalDone}** entregas focais. Atualmente há **${activeProjects}** projetos com atualizações recentes.\n\n`;
+    const logCount = logs.length;
+    const openBlockers = blockers.open.length;
+    md += `Neste período, foram concluídas **${totalDone}** entregas focais. Atualmente há **${activeProjects}** projetos com atualizações recentes. Foram registrados **${logCount}** logs diários e existem **${openBlockers}** blockers em aberto.\n\n`;
+
+    // 2. Contexto dos Logs Diários
+    md += `## 📝 Contexto dos Logs Diários\n`;
+    if (logs.length === 0) {
+        md += `*Sem logs diários no período.*\n\n`;
+    } else {
+        logs
+            .sort((a, b) => a.date.localeCompare(b.date))
+            .forEach(log => {
+                const summary = summarizeLogContent(log.content) || 'Log registrado sem destaques.';
+                md += `- **${log.date}:** ${summary}\n`;
+            });
+        md += `\n`;
+    }
 
-    // 2. Principais Entregas
+    // 3. Principais Entregas
     md += `## ✅ Principais Entregas\n`;
     if (tasks.completed.length === 0) {
         md += `*Nenhuma entrega registrada no período.*\n`;
@@ -185,7 +340,7 @@ function generateReport(period) {
     }
     md += `\n`;
 
-    // 3. Status dos Projetos
+    // 4. Status dos Projetos
     md += `## 🏗️ Status dos Projetos\n`;
     if (projects.length === 0) {
         md += `*Sem atualizações de projeto recentes.*\n`;
@@ -204,7 +359,41 @@ function generateReport(period) {
         });
     }
 
-    // 4. Próximos Passos
+    // 5. Bloqueios
+    md += `## 🚧 Bloqueios\n`;
+    if (blockers.open.length === 0) {
+        md += `*Nenhum blocker em aberto registrado.*\n`;
+    } else {
+        md += `**Em aberto:**\n`;
+        blockers.open.forEach(blocker => {
+            const title = getBlockerTitle(blocker);
+            const severity = normalizeSeverity(blocker);
+            const createdAt = getCreatedAt(blocker);
+            const createdDate = Number.isFinite(createdAt) ? toIsoDate(createdAt) : 'Unknown';
+            const project = blocker.project || blocker.projectName || blocker.projectSlug;
+            const client = blocker.client || blocker.clientName || blocker.clientSlug;
+            const metaParts = [
+                `Severidade: ${severity}`,
+                project ? `Projeto: ${project}` : null,
+                client ? `Cliente: ${client}` : null,
+                `Aberto: ${createdDate}`
+            ].filter(Boolean);
+            md += `- ${title} (${metaParts.join('; ')})\n`;
+        });
+    }
+
+    if (blockers.resolvedRecent.length > 0) {
+        md += `\n**Resolvidos no período:**\n`;
+        blockers.resolvedRecent.forEach(blocker => {
+            const title = getBlockerTitle(blocker);
+            const resolvedAt = getResolvedAt(blocker);
+            const resolvedDate = Number.isFinite(resolvedAt) ? toIsoDate(resolvedAt) : 'Unknown';
+            md += `- ${title} (Resolvido: ${resolvedDate})\n`;
+        });
+    }
+    md += `\n\n`;
+
+    // 6. Próximos Passos
     md += `## 🚀 Próximos Passos\n`;
     if (tasks.pending.length === 0) {
         md += `*Sem itens prioritários na fila.*\n`;