@cccarv82/freya 1.0.3

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

@@ -0,0 +1,102 @@
+---
+description: F.R.E.Y.A. Oracle Agent
+globs: 
+alwaysApply: false
+---
+
+# Oracle Agent (FREYA Sub-module)
+
+This agent is responsible for retrieving information from the local knowledge base and synthesizing answers.
+
+<critical-rule>
+**ANTI-HALLUCINATION:**
+You must ONLY answer based on the content of the JSON files you read.
+If you cannot find the file or the data is missing, say "I have no records for this project."
+Do not invent status updates.
+</critical-rule>
+
+<workflow>
+1.  **Analyze Query:** Identify the target entity (Project, Client, Career topic, or Task).
+    *   *Example:* "Status do projeto Vivo 5G" -> Target: "Vivo", "5G".
+    *   *Example:* "O que tenho pra fazer?" -> Target: "Tasks", Filter: "DO_NOW".
+
+2.  **Route Search:**
+    *   **If Task Query:**
+        *   **Keywords:** "Tarefa", "Task", "To-Do", "Fazer", "Agenda", "Delegado".
+        *   **Target File:** `data/tasks/task-log.json`.
+        *   **Action:** Read file directly.
+    *   **If Project Query:**
+        *   Proceed to Project Lookup (Glob search).
+        *   **Strategy:** Search recursively in `data/Clients`.
+        *   **Pattern:** `data/Clients/**/*{keyword}*/**/status.json` (Case insensitive if possible, or try multiple variations).
+        *   **Tool:** Use `Glob` to find matching paths.
+    *   *Example:* For "Vivo", glob `data/Clients/**/*vivo*/**/status.json`.
+
+3.  **Read Data & Synthesize:**
+    *   **Task Logic:**
+        *   Read `task-log.json`.
+        *   Accept either format `{ tasks: [...] }` or `{ schemaVersion: 1, tasks: [...] }`.
+        *   **Filter Logic:**
+            *   "Fazer" / "Tasks" / "To-Do" -> `category == DO_NOW` AND `status == PENDING`.
+            *   "Agenda" / "Schedule" -> `category == SCHEDULE` AND `status == PENDING`.
+            *   "Delegado" / "Delegate" -> `category == DELEGATE` AND `status == PENDING`.
+            *   "Tudo" / "All" -> All `PENDING` tasks.
+        *   **Sort:** By priority (High > Medium > Low) then Date.
+        *   **Output Structure:**
+            *   **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."
+
+    *   **Project Logic:**
+        *   If matches found: Read the `status.json` file(s).
+        *   If multiple matches: Ask user to clarify OR summarize all if they seem related.
+        *   If no matches: Return "I have no records for this project." (or prompt to list all clients).
+
+4.  **Synthesize Answer (Summarization - Project Only):**
+    *   **Goal:** Provide an executive summary, not a JSON dump.
+    *   **Parsing Logic:**
+        1.  Extract `currentStatus` (or `currentStatus.summary` if object).
+        2.  Check `active` flag.
+        3.  **Archival Check:**
+            *   If `active` is `false`:
+                *   **Check Intent:** Does the query contain words like "history", "archive", "antigo", "histórico", "passado", "old"?
+                *   **If NO:** Return "This project is archived. Ask explicitly for 'history' to view details."
+                *   **If YES:** Proceed to extraction, but mark as `[ARCHIVED]`.
+        4.  Extract the last 3 entries from the `history` array.
+    *   **No Data Case:** If `history` is empty, state: "Project initialized but no updates recorded yet."
+    *   **Output Structure:**
+        *   **Context:** One sentence confirming what is being shown. **Prefix with `[ARCHIVED]` if the project is inactive.** (e.g., "[ARCHIVED] Analisei o histórico do projeto...").
+        *   **Current Status:** The value of `currentStatus`.
+        *   **Recent Updates:** Bullet points of the last 3 entries.
+            *   Format: `* **YYYY-MM-DD:** {Content}`
+
+5.  **Cite Sources (MANDATORY):**
+    *   At the very end of the response, append the file path used.
+    *   Format: `(Source: {filepath})`
+</workflow>
+
+<examples>
+**Input:** "Como está o projeto 5G?"
+**Data Found:** `status.json` with 50 entries.
+**Output:**
+"Contexto compreendido. Aqui está o status atual do projeto 5G.
+
+**Status Atual:**
+Em atraso devido a condições climáticas.
+
+**Últimas Atualizações:**
+*   **2025-12-12:** Atraso reportado por chuva na infraestrutura.
+*   **2025-12-10:** Reunião de alinhamento com stakeholders.
+*   **2025-12-08:** Início da fase de testes.
+
+(Source: data/Clients/vivo/5g/status.json)"
+</examples>
+
+<persona>
+Maintain the F.R.E.Y.A. persona defined in `master.mdc`.
+Tone: Analytical, Precise, Data-Driven.
+Signature:
+— FREYA
+Assistente Responsiva com Otimização Aprimorada
+</persona>

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

@@ -0,0 +1,31 @@
+---
+description: F.R.E.Y.A. Entry Point
+globs: 
+alwaysApply: false
+---
+
+# F.R.E.Y.A. - AI Agent System
+
+To invoke the assistant, simply type: `@freya`
+
+<agent-entry>
+1. **Trigger:** User types `@freya` or mentions `@freya`.
+2. **Action:** Load `@.agent/rules/freya/agents/master.mdc`.
+3. **Behavior:** The Master Agent (FREYA) will interpret the request and route to the appropriate sub-module or answer directly.
+</agent-entry>
+
+<menu-display>
+If the user just types `@freya` or asks for help, display:
+
+```
+— F.R.E.Y.A. —
+Assistente Responsiva com Otimização Aprimorada
+
+Como posso ajudar você hoje?
+
+[1] Ingest Log (Status, Blockers, Career) -> Triggers @.agent/rules/freya/agents/ingestor.mdc
+[2] Oracle Query (Project History, Decisions) -> Triggers @.agent/rules/freya/agents/oracle.mdc
+[3] Career Coach (Brag Sheet, Goals) -> Triggers @.agent/rules/freya/agents/coach.mdc
+[4] General Assistance
+```
+</menu-display>

package/templates/base/README.md

@@ -0,0 +1,50 @@
+# F.R.E.Y.A. - Fully Responsive Enhanced Yield Assistant
+
+> **Sua Assistente de Produtividade Local-First para sua IDE.**
+
+F.R.E.Y.A. é um sistema de agentes de IA projetado para organizar seu trabalho, gerenciar status de projetos, rastrear tarefas e registrar sua evolução de carreira, tudo através de uma interface de chat simples e direta.
+
+## 🌟 Principais Recursos
+
+*   **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?").
+*   **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.
+*   **Saúde do Sistema:** Valide a integridade dos seus dados locais com um comando.
+*   **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.
+
+## 🚀 Como Usar
+
+1.  Abra esta pasta na **sua IDE**.
+2.  No chat da IDE (ex: Ctrl+L / Cmd+L), digite:
+    > `@freya Ajuda`
+3.  Siga as instruções da assistente.
+
+### Comandos Rápidos
+Você pode pedir para a FREYA executar estas tarefas diretamente no chat, ou rodar via terminal:
+
+*   **Checar integridade:** "Verifique a saúde do sistema" (ou `npm run health`)
+*   **Migrar dados (se necessário):** `npm run migrate` (adiciona `schemaVersion` em logs antigos)
+*   **Relatório Profissional (Executivo):** "Gere o status report" (ou `npm run status`)
+*   **Relatório Scrum Master (semanal):** `npm run sm-weekly`
+*   **Relatório de blockers:** `npm run blockers`
+*   **Relatório semanal (legado):** "Gere o relatório semanal" (ou `npm run report`)
+*   **Resumo daily (legado):** "Gere o daily" (ou `npm run daily`)
+
+## 📘 Documentação Completa
+
+Para um guia detalhado de comandos e exemplos, consulte o **[Guia do Usuário](USER_GUIDE.md)** incluído nesta pasta.
+
+## Estrutura de Pastas
+
+*   `.agent/`: O "cérebro" da IA (Regras e Personas).
+*   `data/`: O "banco de dados" (JSONs dos seus projetos, tarefas e carreira).
+*   `logs/`: O "diário" (Histórico bruto de tudo que você digitou).
+*   `docs/reports/`: Relatórios gerados automaticamente.
+*   `scripts/`: Ferramentas de automação e validação.
+
+---
+*F.R.E.Y.A. v1.0 - Release 2025-12-13*

package/templates/base/USER_GUIDE.md

@@ -0,0 +1,160 @@
+# Guia do Usuário F.R.E.Y.A. v1.0
+
+Bem-vindo à F.R.E.Y.A. (Fully Responsive Enhanced Yield Assistant).
+Este sistema foi projetado para ser seu assistente pessoal de produtividade, operando diretamente no seu ambiente de desenvolvimento (IDE), com foco total em privacidade (Local-First) e eficiência.
+
+## 🚀 Como Iniciar
+
+Para interagir com a assistente, basta chamá-la no chat da sua IDE:
+
+> `@freya [sua mensagem]`
+
+A FREYA adotará uma persona calma, analítica e proativa para ajudá-lo.
+
+---
+
+## 📝 Funcionalidades Principais
+
+### 1. Ingestão Universal (Logging)
+Fale naturalmente. A FREYA entende contextos misturados e organiza tudo para você.
+
+*   **Atualização de Projeto:**
+    > "Reunião com o cliente Vivo, o projeto 5G vai atrasar por causa da chuva."
+    *   *Resultado:* Atualiza `data/Clients/vivo/5g/status.json`.
+
+*   **Registro de Carreira:**
+    > "Recebi um feedback incrível do CTO sobre a apresentação de ontem."
+    *   *Resultado:* Salva em `data/career/career-log.json` com a tag "Feedback".
+
+*   **Blockers:**
+    > "Estou travado na API de pagamento do Itaú."
+    *   *Resultado:* Registra um blocker no projeto correspondente.
+
+**Nota de Segurança:** Tudo o que você digita é salvo imediatamente em `logs/daily/YYYY-MM-DD.md` antes de qualquer processamento, garantindo que você nunca perca uma anotação.
+
+### 2. O Oráculo (Consulta de Status)
+Recupere o contexto de qualquer projeto instantaneamente.
+
+*   **Status Rápido:**
+    > "Como está o projeto Vivo 5G?"
+    *   *Resultado:* Resumo executivo do status atual e das últimas 3 atualizações.
+
+*   **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.
+
+### 3. Career Coach & Brag Sheets
+Gerencie sua evolução profissional sem sair do editor.
+
+*   **Gerar Brag Sheet:**
+    > "Gere minha brag sheet do último semestre."
+    *   *Resultado:* Uma lista formatada de suas conquistas, aprendizados e feedbacks, pronta para copiar e colar na sua autoavaliação.
+
+### 4. Gestão de Ciclo de Vida (Arquivamento)
+Mantenha seu foco limpo arquivando projetos antigos.
+
+*   **Arquivar Projeto:**
+    > "Arquivar o projeto Vivo Legado."
+    *   *Resultado:* O projeto para de aparecer nas buscas diárias.
+
+*   **Busca Histórica:**
+    > "O que fizemos no projeto antigo da Vivo?"
+    *   *Resultado:* A FREYA busca nos arquivos mortos (identificados com `[ARCHIVED]`).
+
+### 5. Gestão de Tarefas
+Organize seu dia-a-dia com um sistema de tarefas integrado.
+
+*   **Criar Tarefa:**
+    > "Lembre-me de revisar o PR #123 amanhã."
+    *   *Resultado:* Cria uma nova tarefa pendente em `data/tasks/task-log.json`.
+
+*   **Listar Tarefas:**
+    > "Quais são minhas tarefas pendentes?"
+    *   *Resultado:* Lista suas tarefas abertas, priorizando as urgentes (`DO_NOW`).
+
+*   **Concluir Tarefa:**
+    > "Terminei a revisão do PR #123."
+    *   *Resultado:* Marca a tarefa como `COMPLETED` e registra a data de conclusão.
+
+### 6. Relatórios Automatizados
+Transforme seus logs em relatórios úteis sem esforço. Peça à FREYA no chat e ela executará os scripts para você.
+
+*   **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.
+    *   *Manual:* `npm run status -- --period [daily|weekly]`
+
+*   **Relatório Scrum Master (Semanal):**
+    > "Gerar relatório SM" ou "Relatório Scrum Master"
+    *   *Resultado:* Gera um report semanal focado em resumo, wins, blockers/riscos e foco da próxima semana.
+    *   *Manual:* `npm run sm-weekly`
+
+*   **Relatório de Blockers (priorizado por severidade):**
+    > "Gerar relatório de blockers"
+    *   *Resultado:* Lista blockers abertos ordenados por severidade e idade, pra ficar fácil priorizar.
+    *   *Manual:* `npm run blockers`
+
+*   **Relatório Semanal (Legado):**
+    > "Gerar relatório semanal"
+    *   *Resultado:* A FREYA executa o script e avisa onde o arquivo Markdown foi salvo em `docs/reports/`, exibindo um resumo.
+    *   *Manual:* `npm run report`
+
+*   **Resumo Daily (Legado):**
+    > "Gerar daily" ou "Resumo diário"
+    *   *Resultado:* A FREYA gera e exibe o texto "Ontem / Hoje / Bloqueios" diretamente no chat.
+    *   *Manual:* `npm run daily`
+
+### 7. Migração de Dados (schemaVersion)
+Se você atualizou a FREYA e tem logs antigos, rode a migração para padronizar os JSONs.
+
+*   **Migrar dados:**
+    > `npm run migrate`
+    *   *Resultado:* adiciona `schemaVersion` aos arquivos conhecidos (`task-log.json`, `career-log.json`, `blocker-log.json`).
+    *   *Segurança:* se algum JSON estiver corrompido, ele é movido para quarentena (não é perdido).
+
+### 8. Saúde do Sistema
+Garanta que seus dados locais estão íntegros.
+
+*   **Health Check:**
+    > "Checar saúde do sistema" ou "Verificar integridade"
+    *   *Resultado:* A FREYA roda o diagnóstico e reporta se todos os JSONs estão válidos ou se há erros para corrigir.
+    *   *Manual:* `npm run health`
+
+### 9. Git Automation
+Deixe a Freya cuidar do versionamento básico do seu código.
+
+*   **Auto-Commit:**
+    > "Salvar alterações", "Gerar commit" ou "Commitar"
+    *   *Resultado:* A Freya executa `git status`, analisa o `git diff` para entender o que mudou, gera uma mensagem de commit semântica e realiza o commit (`git add .` + `git commit`).
+    *   *Nota:* Ela sempre pedirá confirmação ou avisará se não houver mudanças.
+
+### 10. Detecção Implícita de Tarefas
+A Freya agora entende suas intenções futuras sem precisar de comandos explícitos.
+
+*   **Detecção Inteligente:**
+    > "O projeto X atrasou porque *preciso configurar o servidor*."
+    *   *Resultado:* A Freya cria automaticamente a tarefa "Configurar o servidor" e a vincula ao projeto X.
+    *   *Palavras-chave:* "preciso", "tenho que", "falta", "vou", "pendente".
+
+---
+
+## 💡 Dicas de Uso
+
+1.  **Seja Específico:** Mencionar o nome do Cliente ou Projeto ajuda a FREYA a categorizar corretamente.
+2.  **Múltiplos Contextos:** Você pode misturar assuntos:
+    > "O projeto Alpha está verde, mas preciso estudar Kubernetes para minha certificação."
+    (Ela vai atualizar o projeto Alpha E adicionar uma meta de estudo no seu log de carreira).
+3.  **Idioma:** A FREYA responde nativamente em **Português (Brasil)**. Se precisar de inglês, basta pedir: "Switch to English please".
+
+---
+
+## 📂 Onde estão meus dados?
+
+Tudo fica no seu computador, dentro da pasta do projeto:
+*   `data/Clients/`: Histórico dos projetos.
+*   `data/career/`: Seu log de carreira.
+*   `data/tasks/`: Seu log de tarefas.
+*   `logs/daily/`: Log bruto diário (Markdown).
+*   `docs/reports/`: Relatórios gerados.
+
+---
+*F.R.E.Y.A. — Assistente Responsiva com Otimização Aprimorada*

package/templates/base/data/blockers/blocker-log.json

@@ -0,0 +1,4 @@
+{
+  "schemaVersion": 1,
+  "blockers": []
+}

package/templates/base/data/career/career-log.json

@@ -0,0 +1,4 @@
+{
+  "schemaVersion": 1,
+  "entries": []
+}

package/templates/base/data/schemas.md

@@ -0,0 +1,66 @@
+# F.R.E.Y.A. Data Schemas
+
+This document defines the JSON structure for the local knowledge base.
+
+## Career Log (`data/career/career-log.json`)
+
+Stores professional achievements, feedback, and certifications.
+
+```json
+{
+  "entries": [
+    {
+      "id": "uuid-v4",
+      "date": "YYYY-MM-DD",
+      "type": "Achievement" | "Feedback" | "Certification" | "Goal",
+      "description": "Text description of the item.",
+      "tags": ["tag1", "tag2"],
+      "source": "Optional origin (e.g. 'Meeting with X')"
+    }
+  ]
+}
+```
+
+## Project Status (`data/Clients/{client_slug}/{project_slug}/status.json`)
+
+Stores the ongoing status and history of a project.
+
+```json
+{
+  "client": "String (Display Name, e.g., 'Vivo')",
+  "project": "String (Display Name, e.g., '5G')",
+  "active": true,
+  "archivedAt": "YYYY-MM-DD (Optional, present if active=false)",
+  "currentStatus": "String (Latest status summary)",
+  "lastUpdated": "YYYY-MM-DD",
+  "history": [
+    {
+      "date": "YYYY-MM-DD",
+      "type": "Status" | "Decision" | "Risk" | "Blocker",
+      "content": "String (The update details)",
+      "tags": ["String"]
+    }
+  ]
+}
+```
+
+## Task Log (`data/tasks/task-log.json`)
+
+Centralized storage for personal tasks and to-dos.
+
+```json
+{
+  "tasks": [
+    {
+      "id": "String (UUID or timestamp-slug)",
+      "description": "String",
+      "category": "DO_NOW" | "SCHEDULE" | "DELEGATE" | "IGNORE",
+      "status": "PENDING" | "COMPLETED" | "ARCHIVED",
+      "createdAt": "YYYY-MM-DDTHH:mm:ssZ",
+      "completedAt": "YYYY-MM-DDTHH:mm:ssZ (Optional)",
+      "projectSlug": "String (Optional, link to project)",
+      "priority": "high" | "medium" | "low" (Optional)
+    }
+  ]
+}
+```

package/templates/base/data/tasks/task-log.json

@@ -0,0 +1,4 @@
+{
+  "schemaVersion": 1,
+  "tasks": []
+}

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

@@ -0,0 +1,215 @@
+const fs = require('fs');
+const path = require('path');
+
+const { toIsoDate, safeParseToMs, isWithinRange } = require('./lib/date-utils');
+
+const BLOCKERS_FILE = path.join(__dirname, '../data/blockers/blocker-log.json');
+const REPORT_DIR = path.join(__dirname, '../docs/reports');
+
+const SEVERITY_ORDER = {
+  CRITICAL: 0,
+  HIGH: 1,
+  MEDIUM: 2,
+  LOW: 3,
+};
+
+const RESOLVED_STATUSES = new Set(['RESOLVED', 'CLOSED', 'DONE', 'FIXED']);
+
+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 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 getBlockerTitle(blocker) {
+  return (
+    blocker.title ||
+    blocker.summary ||
+    blocker.description ||
+    blocker.content ||
+    blocker.text ||
+    'Untitled blocker'
+  );
+}
+
+function formatAgeDays(createdMs, nowMs) {
+  if (!Number.isFinite(createdMs)) return null;
+  const ageMs = Math.max(0, nowMs - createdMs);
+  return Math.floor(ageMs / (24 * 60 * 60 * 1000));
+}
+
+function ensureReportDir() {
+  if (!fs.existsSync(REPORT_DIR)) {
+    fs.mkdirSync(REPORT_DIR, { recursive: true });
+  }
+}
+
+function loadBlockers() {
+  if (!fs.existsSync(BLOCKERS_FILE)) {
+    return [];
+  }
+  try {
+    const raw = fs.readFileSync(BLOCKERS_FILE, 'utf8');
+    const data = JSON.parse(raw);
+    return Array.isArray(data.blockers) ? data.blockers : [];
+  } catch (err) {
+    console.error(`Error reading blockers file: ${err.message}`);
+    return [];
+  }
+}
+
+function generateReport() {
+  const now = new Date();
+  const nowMs = now.getTime();
+  const reportDate = toIsoDate(now);
+  const blockers = loadBlockers();
+
+  const statusCounts = new Map();
+  blockers.forEach(blocker => {
+    const status = normalizeStatus(blocker);
+    statusCounts.set(status, (statusCounts.get(status) || 0) + 1);
+  });
+
+  const openBlockers = blockers.filter(isOpen);
+  openBlockers.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 ageA = getCreatedAt(a);
+    const ageB = getCreatedAt(b);
+    const msA = Number.isFinite(ageA) ? ageA : Number.MAX_SAFE_INTEGER;
+    const msB = Number.isFinite(ageB) ? ageB : Number.MAX_SAFE_INTEGER;
+    return msA - msB;
+  });
+
+  const sevenDaysAgo = new Date(nowMs - 7 * 24 * 60 * 60 * 1000);
+  const resolvedRecent = blockers.filter(blocker => {
+    const resolvedAt = getResolvedAt(blocker);
+    if (!Number.isFinite(resolvedAt)) return false;
+    return isWithinRange(resolvedAt, sevenDaysAgo, now);
+  });
+  resolvedRecent.sort((a, b) => {
+    const msA = getResolvedAt(a);
+    const msB = getResolvedAt(b);
+    return msB - msA;
+  });
+
+  let report = `# Blockers Report - ${reportDate}\n\n`;
+  report += '## Summary\n';
+  report += `- Total blockers: ${blockers.length}\n`;
+  if (statusCounts.size === 0) {
+    report += '- Status counts: None\n\n';
+  } else {
+    report += '- Status counts:\n';
+    const statuses = Array.from(statusCounts.keys()).sort();
+    statuses.forEach(status => {
+      report += `  - ${status}: ${statusCounts.get(status)}\n`;
+    });
+    report += '\n';
+  }
+
+  report += '## Open Blockers\n';
+  if (openBlockers.length === 0) {
+    report += 'None.\n\n';
+  } else {
+    openBlockers.forEach(blocker => {
+      const title = getBlockerTitle(blocker);
+      const status = normalizeStatus(blocker);
+      const severity = normalizeSeverity(blocker);
+      const createdMs = getCreatedAt(blocker);
+      const createdDate = Number.isFinite(createdMs) ? toIsoDate(createdMs) : 'Unknown';
+      const ageDays = formatAgeDays(createdMs, nowMs);
+      const project = blocker.project || blocker.projectName || blocker.projectSlug;
+      const client = blocker.client || blocker.clientName || blocker.clientSlug;
+      const metaParts = [
+        `Status: ${status}`,
+        project ? `Project: ${project}` : null,
+        client ? `Client: ${client}` : null,
+        `Created: ${createdDate}`,
+        ageDays === null ? null : `Age: ${ageDays}d`,
+      ].filter(Boolean);
+      report += `- [${severity}] ${title} (${metaParts.join('; ')})\n`;
+    });
+    report += '\n';
+  }
+
+  report += '## Resolved Blockers (Last 7 Days)\n';
+  if (resolvedRecent.length === 0) {
+    report += 'None.\n';
+  } else {
+    resolvedRecent.forEach(blocker => {
+      const title = getBlockerTitle(blocker);
+      const severity = normalizeSeverity(blocker);
+      const resolvedMs = getResolvedAt(blocker);
+      const resolvedDate = Number.isFinite(resolvedMs) ? toIsoDate(resolvedMs) : 'Unknown';
+      const project = blocker.project || blocker.projectName || blocker.projectSlug;
+      const client = blocker.client || blocker.clientName || blocker.clientSlug;
+      const metaParts = [
+        project ? `Project: ${project}` : null,
+        client ? `Client: ${client}` : null,
+        `Resolved: ${resolvedDate}`,
+      ].filter(Boolean);
+      report += `- [${severity}] ${title} (${metaParts.join('; ')})\n`;
+    });
+  }
+
+  ensureReportDir();
+  const outputPath = path.join(REPORT_DIR, `blockers-${reportDate}.md`);
+  fs.writeFileSync(outputPath, report);
+  console.log(report);
+}
+
+generateReport();