jarvis-ai-framework 5.6.0 → 5.7.0

package/AGENTS.md

@@ -199,6 +199,7 @@ jarvis list                                         # Listar agents, skills e wo
 jarvis install-rtk                                  # Instalar RTK (token killer — economia 60-90% em tokens de shell)
 jarvis tokens    [--hub X --position Y --area Z --squad W] [--rtk] [--json]   # Estimar o que carrega no início da sessão (perfil do ENV.md se sem flags)
 jarvis map       <nome> [--depth N] [--reverse]      # Mapa de chamadas de um workflow, skill ou agente (lê só as tabelas padronizadas)
+jarvis daily-report [--days N] [--json]             # Junta os daily.md das sessões por dia (usado pelo /eng.daily-report)
 ```
 
 Quando atuar em um projeto alvo, detectar comandos em:

package/bin/commands/daily-report.js

@@ -0,0 +1,90 @@
+import { isAbsolute, join, relative } from "node:path";
+import { scanSessions, parseDays } from "../lib/core/session-scan.js";
+import { resolveEnvPath, loadEnv } from "../lib/env-loader.js";
+import { logger } from "../lib/utils/logger.js";
+import { GREEN, YELLOW, CYAN, DIM, NC } from "../lib/utils/ui.js";
+
+const USAGE = "Uso: jarvis daily-report [--days 1|3|7|15|30|60] [--json]";
+const DEFAULTS = {
+  DOCS_FOLDER: "docs",
+  JARVIS_DOCS: "$DOCS_FOLDER/jarvis",
+  ENG_DOCS: "$JARVIS_DOCS/engineering",
+  SESSIONS_DIR: ".jarvis/sessions",
+};
+
+/** Expande `$VAR` com os valores do ENV (e os padrões acima), em até 5 passadas. */
+export function expandVars(value, env) {
+  let out = value;
+  for (let i = 0; i < 5 && /\$[A-Z_]+/.test(out); i++) {
+    out = out.replace(/\$([A-Z_][A-Z0-9_]*)/g, (m, name) => env[name] ?? DEFAULTS[name] ?? m);
+  }
+  return out;
+}
+
+function resolveDir(root, value) {
+  return isAbsolute(value) ? value : join(root, value);
+}
+
+/**
+ * Lê as sessões do workspace e devolve o JSON do relatório. Separado de `dailyReport` para ser testável.
+ * @param {Record<string, unknown>} flags - `days`, `ide`, `env-file`
+ * @param {string} [cwd]
+ * @param {Date} [now]
+ * @returns {{ code: number, json?: object, lines?: string[] }}
+ */
+export function runDailyReport(flags = {}, cwd = process.cwd(), now = new Date()) {
+  const parsed = parseDays(flags.days);
+  if (parsed.error) return { code: 1, lines: [`❌ ${parsed.error}`, USAGE] };
+
+  let envPath;
+  let root;
+  try {
+    ({ path: envPath, root } = resolveEnvPath(cwd, flags));
+  } catch (err) {
+    return { code: 1, lines: [`❌ ${err.message}`, USAGE] };
+  }
+  root = root || cwd;
+  const env = { ...DEFAULTS, ...loadEnv(cwd, envPath) };
+
+  const sessionsDir = join(resolveDir(root, expandVars(env.SESSIONS_DIR, env)), "eng");
+  const reportsDir = join(resolveDir(root, expandVars(env.ENG_DOCS, env)), "daily-reports");
+
+  const result = scanSessions(sessionsDir, { days: parsed.days, now });
+  const reportPathAbs = join(reportsDir, result.fileName);
+  return {
+    code: 0,
+    json: {
+      ...result,
+      workspace: root,
+      sessionsDir: relative(root, sessionsDir) || ".",
+      reportPath: relative(root, reportPathAbs),
+      reportPathAbs,
+    },
+  };
+}
+
+export async function dailyReport(flags) {
+  const { code, json, lines } = runDailyReport(flags);
+  if (code !== 0) {
+    for (const line of lines) logger.error(line);
+    process.exit(code);
+  }
+
+  if (flags.json) {
+    process.stdout.write(`${JSON.stringify(json, null, 2)}\n`);
+    return;
+  }
+
+  logger.info(`${CYAN}🗓️  Registros dos últimos ${json.days} dia(s)${NC}`);
+  logger.info(`${DIM}Janela: ${json.window.from} a ${json.window.to} (fuso local)${NC}`);
+  logger.info(
+    `Sessões lidas: ${json.sessionsScanned} · na janela: ${json.sessionsInWindow} · dias com registro: ${json.byDate.length}`
+  );
+  logger.info(
+    json.alerts.length
+      ? `${YELLOW}⚠️  ${json.alerts.length} sessão(ões) sem daily.md: ${json.alerts.map((a) => a.key).join(", ")}${NC}`
+      : `${GREEN}✅ Todas as sessões da janela têm daily.md${NC}`
+  );
+  for (const w of json.warnings) logger.info(`${DIM}aviso: ${w}${NC}`);
+  logger.info(`${DIM}Relatório (escrito pelo /eng.daily-report): ${json.reportPath}${NC}`);
+}

package/bin/lib/cli/program.js

@@ -26,6 +26,7 @@ import { qaSignoff } from "../../commands/qa-signoff.js";
 import { installRtk } from "../../commands/install-rtk.js";
 import { tokens } from "../../commands/tokens.js";
 import { map } from "../../commands/map.js";
+import { dailyReport } from "../../commands/daily-report.js";
 import { runCreateMerge } from "../vcs/create-merge.js";
 import { runCreateIssue } from "../vcs/create-issue.js";
 import { runComment } from "../tasks/comment.js";
@@ -187,6 +188,14 @@ export function buildProgram() {
     .option("--reverse", "Mostra quem chama, em vez do que é chamado")
     .action((name, options) => map(toLegacyFlags(options, { _: [name].filter(Boolean) })));
 
+  cmd(program, "daily-report")
+    .description("Junta os daily.md das sessões por dia (base do /eng.daily-report)")
+    .option("--days <n>", "Janela em dias: 1, 3, 7, 15, 30 ou 60 (padrão: 7)")
+    .option("--json", "Saída em JSON")
+    .option("--ide <ide>")
+    .option("--env-file <path>")
+    .action((options) => dailyReport(toLegacyFlags(options)));
+
   const vcs = cmd(program, "vcs").description("Adapters de Git host (GitLab/GitHub/Bitbucket)");
 
   cmd(vcs, "create-merge")

package/bin/lib/core/session-scan.js

@@ -0,0 +1,266 @@
+// Varredura das sessões de engenharia para o /eng.daily-report: junta as seções `## AAAA-MM-DD`
+// dos `daily.md` por dia e aponta as sessões que deveriam ter `daily.md` e não têm.
+// Só lê: não escreve nas sessões nem cria o relatório (quem escreve é o workflow).
+// As datas são sempre do calendário LOCAL (o `.timestamp_start` é gravado em UTC).
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+
+export const ALLOWED_DAYS = [1, 3, 7, 15, 30, 60];
+export const DEFAULT_DAYS = 7;
+
+// Dia em que o `daily.md` passou a existir (gerado pelo eng.pr). Sessões sem `daily.md` que
+// começaram antes disso só geram alerta se chegaram ao eng.pr (têm `pull-request.md`).
+export const DAILY_SINCE = "2026-10-15";
+
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const EMAIL_RE = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g;
+
+/** Valida a janela. Sem valor: o padrão (7). */
+export function parseDays(value) {
+  if (value === undefined || value === null || value === "" || value === true)
+    return { days: DEFAULT_DAYS };
+  const n = Number(String(value).trim());
+  if (!ALLOWED_DAYS.includes(n)) {
+    return {
+      error: `Janela inválida: ${value}. Valores aceitos: ${ALLOWED_DAYS.join(", ")}`,
+    };
+  }
+  return { days: n };
+}
+
+/** `AAAA-MM-DD` no fuso local (sem `toISOString`, que é UTC). */
+export function localDate(date) {
+  const y = date.getFullYear();
+  const m = String(date.getMonth() + 1).padStart(2, "0");
+  const d = String(date.getDate()).padStart(2, "0");
+  return `${y}-${m}-${d}`;
+}
+
+/** Hoje e os `days - 1` dias anteriores, do mais recente para o mais antigo. */
+export function buildWindow(days, now = new Date()) {
+  const dates = [];
+  for (let i = 0; i < days; i++) {
+    dates.push(localDate(new Date(now.getFullYear(), now.getMonth(), now.getDate() - i)));
+  }
+  return { from: dates[dates.length - 1], to: dates[0], dates };
+}
+
+export function reportFileName(today, days) {
+  return `daily-report-${today}-${days}d.md`;
+}
+
+export function redactEmails(text) {
+  return typeof text === "string" ? text.replace(EMAIL_RE, "[e-mail removido]") : text;
+}
+
+function readText(path) {
+  try {
+    return readFileSync(path, "utf8");
+  } catch {
+    return null;
+  }
+}
+
+function unquote(value) {
+  const v = value.trim();
+  return /^(["']).*\1$/.test(v) ? v.slice(1, -1) : v;
+}
+
+/** Frontmatter `chave: valor` simples (ignora comentários). */
+function parseFrontmatter(text) {
+  const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  const data = {};
+  if (!m) return { data, body: text };
+  for (const line of m[1].split(/\r?\n/)) {
+    if (/^\s*#/.test(line)) continue;
+    const kv = line.match(/^([A-Za-z_][\w-]*):\s*(.*)$/);
+    if (kv) data[kv[1]] = unquote(kv[2]);
+  }
+  return { data, body: text.slice(m[0].length) };
+}
+
+/** Primeira linha não vazia depois de `### Timesheet`, sem crases nem cercas de código. */
+function extractTimesheet(section) {
+  const m = section.match(/^###\s+Timesheet\s*$([\s\S]*?)(?=^###?\s|(?![\s\S]))/m);
+  if (!m) return null;
+  const line = m[1]
+    .split(/\r?\n/)
+    .map((l) => l.trim())
+    .find((l) => l && !/^```/.test(l));
+  return line ? line.replace(/^`+|`+$/g, "").trim() : null;
+}
+
+function extractDescription(section) {
+  const m = section.match(/^###\s+Descrição detalhada\s*$([\s\S]*?)(?=^###\s|(?![\s\S]))/m);
+  return m ? m[1].trim() : "";
+}
+
+/**
+ * Lê um `daily.md`: frontmatter (`task_key`, `card_url`, `pr`, `branch`) e uma entrada por
+ * seção `## AAAA-MM-DD`, com a descrição detalhada e a linha de timesheet.
+ */
+export function parseDaily(text) {
+  const { data, body } = parseFrontmatter(text);
+  const sections = [];
+  const parts = body.split(/^##\s+(\d{4}-\d{2}-\d{2})\s*$/m);
+  for (let i = 1; i < parts.length; i += 2) {
+    sections.push({
+      date: parts[i],
+      description: redactEmails(extractDescription(parts[i + 1])),
+      timesheet: redactEmails(extractTimesheet(parts[i + 1])),
+    });
+  }
+  return {
+    taskKey: data.task_key || null,
+    cardUrl: data.card_url || null,
+    pr: data.pr || null,
+    branch: data.branch || null,
+    sections,
+  };
+}
+
+function firstHeading(text) {
+  const m = text && text.match(/^#\s+(.+)$/m);
+  return m ? m[1].trim() : null;
+}
+
+/** Linha `Issue:` do cabeçalho do architecture.md (com ou sem negrito e `>`). */
+function issueLine(text) {
+  const m = text && text.match(/^[>\s]*\**Issue:\**\s*(.+?)\s*$/m);
+  return m ? m[1].trim() : null;
+}
+
+function prNumberFrom(text) {
+  if (!text) return null;
+  const m = text.match(/\/(?:pull|merge_requests)\/(\d+)/) || text.match(/\b(?:PR|MR)\s*#(\d+)/);
+  return m ? `#${m[1]}` : null;
+}
+
+/**
+ * Data e atividade de uma sessão sem `daily.md`, só com fontes locais (o vendor fica com o
+ * workflow). Ordem da data: `Criado em:` > `.timestamp_start` (UTC → local) > modificação da pasta.
+ */
+export function sessionInfo(dir) {
+  const arch = readText(join(dir, "architecture.md"));
+  const plan = readText(join(dir, "plan.md"));
+  const pr = readText(join(dir, "pull-request.md"));
+
+  let date = null;
+  let dateSource = null;
+  const created = arch && arch.match(/Criado em:\**\s*(\d{4}-\d{2}-\d{2})/);
+  if (created) {
+    date = created[1];
+    dateSource = "architecture";
+  }
+  if (!date) {
+    const ts = (readText(join(dir, ".timestamp_start")) || "").trim();
+    const parsed = ts ? new Date(ts) : null;
+    if (parsed && !Number.isNaN(parsed.getTime())) {
+      date = localDate(parsed);
+      dateSource = "timestamp_start";
+    }
+  }
+  if (!date) {
+    date = localDate(statSync(dir).mtime);
+    dateSource = "mtime";
+  }
+
+  const issue = issueLine(arch);
+  const issueKey = issue ? (issue.match(/#\d+|\b[A-Z][A-Z0-9]+-\d+\b/) || [null])[0] : null;
+  const issueTitle = issue ? (issue.match(/\s[—–-]\s+(.+)$/) || [null, null])[1] : null;
+  const archTitle = firstHeading(arch);
+  const usefulArchTitle =
+    archTitle && !/^architecture(\.md)?\s*[:—-]?\s*[#\w-]*$/i.test(archTitle) ? archTitle : null;
+
+  const activity = issueTitle || firstHeading(plan) || firstHeading(pr) || usefulArchTitle || null;
+
+  return {
+    date,
+    dateSource,
+    activity: redactEmails(activity),
+    issueKey,
+    prNumber: prNumberFrom(pr),
+    hasPullRequest: pr !== null,
+  };
+}
+
+/** Sessão sem `daily.md` gera alerta se chegou ao eng.pr ou começou depois do `daily.md` existir. */
+export function needsAlert({ hasDaily, hasPullRequest, date }) {
+  if (hasDaily) return false;
+  return hasPullRequest || date >= DAILY_SINCE;
+}
+
+const byKey = (a, b) => a.key.localeCompare(b.key, "pt-BR", { numeric: true });
+
+/**
+ * Varre `sessionsDir` (o `$SESSIONS_DIR/eng`) e devolve o que entra na janela.
+ * @param {string} sessionsDir
+ * @param {{ days?: number, now?: Date }} [options]
+ */
+export function scanSessions(sessionsDir, { days = DEFAULT_DAYS, now = new Date() } = {}) {
+  const window = buildWindow(days, now);
+  const inWindow = new Set(window.dates);
+  const warnings = [];
+  const perDate = new Map();
+  const alerts = [];
+  const touched = new Set();
+
+  let keys = [];
+  if (existsSync(sessionsDir)) {
+    keys = readdirSync(sessionsDir, { withFileTypes: true })
+      .filter((e) => e.isDirectory() && !e.name.startsWith("."))
+      .map((e) => e.name);
+  } else {
+    warnings.push(`pasta de sessões não encontrada: ${sessionsDir}`);
+  }
+
+  for (const key of keys) {
+    const dir = join(sessionsDir, key);
+    const dailyText = readText(join(dir, "daily.md"));
+
+    if (dailyText !== null) {
+      const daily = parseDaily(dailyText);
+      for (const s of daily.sections) {
+        if (!DATE_RE.test(s.date) || !inWindow.has(s.date)) continue;
+        if (!perDate.has(s.date)) perDate.set(s.date, []);
+        perDate.get(s.date).push({
+          key,
+          taskKey: daily.taskKey,
+          cardUrl: daily.cardUrl,
+          pr: daily.pr,
+          branch: daily.branch,
+          description: s.description,
+          timesheet: s.timesheet,
+        });
+        touched.add(key);
+      }
+      continue;
+    }
+
+    const info = sessionInfo(dir);
+    if (!inWindow.has(info.date)) continue;
+    if (!needsAlert({ hasDaily: false, hasPullRequest: info.hasPullRequest, date: info.date }))
+      continue;
+    if (info.dateSource === "mtime")
+      warnings.push(`sessão ${key}: data tirada da modificação da pasta (sem outra fonte)`);
+    alerts.push({ key, ...info });
+    touched.add(key);
+  }
+
+  const byDate = [...perDate.entries()]
+    .sort(([a], [b]) => (a < b ? 1 : -1))
+    .map(([date, tasks]) => ({ date, tasks: tasks.sort(byKey) }));
+  alerts.sort((a, b) => (a.date === b.date ? byKey(a, b) : a.date < b.date ? 1 : -1));
+
+  return {
+    days,
+    today: window.to,
+    window: { from: window.from, to: window.to },
+    fileName: reportFileName(window.to, days),
+    sessionsScanned: keys.length,
+    sessionsInWindow: touched.size,
+    byDate,
+    alerts,
+    warnings,
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jarvis-ai-framework",
-  "version": "5.6.0",
+  "version": "5.7.0",
   "description": "Jarvis framework",
   "type": "module",
   "bin": {
@@ -11,7 +11,7 @@
     "prepublishOnly": "echo 'Publishing jarvis-framework...'",
     "publish:gitlab": "npm publish",
     "test:comandos": "node test/comandos-docs.test.js",
-    "test:filtro": "node --test test/profile-filter.test.js test/token-report.test.js test/flow-map.test.js test/env-loader.test.js test/sync-engine.test.js test/vcs-api.test.js test/fetch-file.test.js test/publish-file.test.js test/docs-storage.test.js test/env-upgrade.test.js test/docs-migrate.test.js test/init-upgrade.test.js test/workspace-mode.test.js test/stale-skills.test.js",
+    "test:filtro": "node --test test/profile-filter.test.js test/token-report.test.js test/flow-map.test.js test/env-loader.test.js test/sync-engine.test.js test/vcs-api.test.js test/fetch-file.test.js test/publish-file.test.js test/docs-storage.test.js test/env-upgrade.test.js test/docs-migrate.test.js test/init-upgrade.test.js test/workspace-mode.test.js test/stale-skills.test.js test/session-scan.test.js",
     "lint": "eslint bin/ test/",
     "lint:fix": "eslint bin/ test/ --fix",
     "format": "prettier --write bin/ test/",

package/rules-on-demand/engineering/eng.transitions-rules.md

@@ -18,12 +18,12 @@ Lida pelos workflows `eng.start`, `eng.plan`, `eng.work`, `eng.pre-pr` e `eng.pr
 2. **Formato:** `AskUserQuestion`, uma pergunta por decisão, no máximo 4 opções. **Não liste "Outros"**: o `AskUserQuestion` já o acrescenta sozinho para o texto livre, e listá-lo gasta uma das 4 vagas. Sem `AskUserQuestion`, use a tabela de opções de `prod-rules.md`.
 3. **A resposta é a aprovação.** "Aprovar e seguir" ou "Aprovar e parar aqui" valem como a aprovação explícita que as rules de cada comando exigem. Sem uma dessas respostas, nada avança.
 4. **Seguir para o próximo comando:** se a IDE permite chamar outro comando (no Claude Code, pelo Skill tool), chame-o com o mesmo `{TASK_MANAGER_KEY}`; senão, mostre o comando pronto para colar.
-5. **Consolidado de links, acumulado a cada etapa.** Ao terminar e antes de cada pergunta que depende de um arquivo, cada comando mostra o bloco "📄 Arquivos da sessão" com **todos** os arquivos que já existem na sessão, e não só os da etapa, para que a lista fique sempre visível até o `eng.spec-consolidate`:
+5. **Consolidado de links, acumulado a cada etapa.** Ao terminar e antes de **cada pergunta de transição** (todas as da tabela "Transições", inclusive as do início, como "O que fazer com o PR?", e mesmo quando a pergunta é repetida), cada comando mostra o bloco "📄 Arquivos da sessão" com **todos** os arquivos que já existem na sessão, e não só os da etapa, para que a lista fique sempre visível até o `eng.spec-consolidate`:
    - Ordem do ciclo: `context.md`, `architecture.md`, `plan.md`, `gate-checklist.md`, `pull-request.md`, `daily.md`, as versões `{nome}.public.md` (se houver) e os arquivos de `consolidation/` (do `eng.spec-consolidate`). Só entra o que existe.
    - Cada item é um link markdown com caminho relativo ao workspace (ex.: `[architecture.md](.jarvis/sessions/eng/TASK-123/architecture.md)`), seguido de uma **nota curta de estado** entre parênteses: `novo` ou `atualizado` quando foi gerado ou alterado nesta etapa, mais o que mudou ou o que o arquivo contém (ex.: `plan.md (atualizado, com comentários por fase)`, `architecture.md (aprovado; 5 questões decididas)`, `daily.md (novo; aprovado, com timesheet)`). Os arquivos que não mudaram na etapa aparecem sem nota ou com o estado em que ficaram.
    - A lista é **reimpressa inteira** a cada etapa, sem esconder os arquivos anteriores.
    - Logo abaixo, "🔗 Links" com o card/issue e, quando existir, o PR/MR.
-   - **Antes de cada pergunta que depende de um arquivo** (`architecture.md`, `plan.md`, `gate-checklist.md`, `pull-request.md`, `daily.md`), escreva primeiro essa mensagem em markdown, com o resumo, e só então abra o `AskUserQuestion`. A pergunta fica curta, só com a decisão e o nome do arquivo em texto simples; ela espera a resposta enquanto a pessoa abre e lê com calma. Não dependa do link dentro do `AskUserQuestion`.
+   - **Antes de cada pergunta de transição**, escreva primeiro essa mensagem em markdown, com o resumo, e só então abra o `AskUserQuestion`. Isso vale também para as perguntas que não dependem de um arquivo: a lista é o mapa de onde a tarefa está no ponto de decisão. Na pergunta que depende de um arquivo (`architecture.md`, `plan.md`, `gate-checklist.md`, `pull-request.md`, `daily.md`), o resumo é o desse arquivo. A pergunta fica curta, só com a decisão e o nome do arquivo em texto simples; ela espera a resposta enquanto a pessoa abre e lê com calma. Não dependa do link dentro do `AskUserQuestion`.
 6. **Limites que nenhuma escolha dispensa:** `MAX_AI_EXECUTION_PERCENTAGE`, testes e lint passando, e a parada em questão nova em aberto.
 
 ### Proibido

package/templates/engineering/architecture-template.md

@@ -251,10 +251,11 @@ graph TD
 > Tudo que for **diferente do código ou ambíguo no card** vira uma questão aqui, detalhada a ponto de outro agente entendê-la sem reconstruir a análise. No mínimo 3 opções, mais a **4 — Outra**.
 > **Com Advisor** (cabeçalho), a sugestão do Advisor prevalece e é a decisão adotada; o agente principal não a substitui nem contesta. **Sem Advisor**, "Sugestão do Sub-Agent (Advisor)" e "Divergência" ficam "N/A (Advisor não utilizado)", a regra em destaque é omitida e a decisão é a do usuário ao revisar o documento.
 > Questão levantada depois do `eng.start` (consulta por exceção) entra aqui, numerada em sequência, marcada "levantada no `eng.plan`" ou "no `eng.work`". Sem questão em aberto, escreva "Nenhuma" e o motivo em uma frase.
+> **Marcação para leitura rápida:** decidida a questão, a opção escolhida ganha ✅ e "(escolhida)" no título, e as demais ganham ❌, inclusive a **4 — Outra**. A coluna "Opção escolhida" da tabela repete a escolha (`✅ {n} — {nome curto}`). Enquanto a questão estiver 🔄 Aberta, as opções ficam sem marcação e a coluna fica "—".
 
-| ID | Questão                      | Responsável                 | Deadline | Status                     |
-| -- | ---------------------------- | --------------------------- | -------- | -------------------------- |
-| Q1 | {resumo objetivo da questão} | {Advisor \| nome do usuário} | {— \| data} | {✅ Decidida \| 🔄 Aberta} |
+| ID | Questão                      | Opção escolhida                     | Responsável                 | Deadline | Status                     |
+| -- | ---------------------------- | ----------------------------------- | --------------------------- | -------- | -------------------------- |
+| Q1 | {resumo objetivo da questão} | {✅ {n} — {nome curto} \| —}        | {Advisor \| nome do usuário} | {— \| data} | {✅ Decidida \| 🔄 Aberta} |
 
 ### Q1 — {Título da questão}
 
@@ -269,17 +270,17 @@ graph TD
 
 **Opções:**
 
-**1. {Opção 1}**
+**✅ 1. {Opção 1} (escolhida)**
 * Como funciona: {descrição}
 * Vantagens: {vantagens}
 * Desvantagens: {desvantagens}
 * Impacto: {impacto}
 
-**2. {Opção 2}** (mesmo formato)
+**❌ 2. {Opção 2}** (mesmo formato)
 
-**3. {Opção 3}** (mesmo formato)
+**❌ 3. {Opção 3}** (mesmo formato)
 
-**4. Outra**
+**❌ 4. Outra**
 * Alternativa adicional identificada pelo Sub-Agent/Advisor, detalhada caso ele entenda que nenhuma das opções anteriores é a melhor abordagem.
 
 **Sugestão do Agente Principal (Architect):**
@@ -289,7 +290,7 @@ graph TD
 {recomendação independente do Advisor + justificativa técnica}
 
 **Decisão adotada:**
-**{recomendação do Sub-Agent/Advisor}**
+✅ **{n} — {recomendação do Sub-Agent/Advisor}**
 
 > **Regra:** a recomendação do Advisor sempre prevalece e deve ser adotada na implementação, independentemente de ser igual ou diferente da recomendação do Agente Principal.
 

package/templates/engineering/daily-template.md

@@ -30,7 +30,7 @@ updated_at: {YYYY-MM-DD}
 
 # Daily — {TASK_KEY}
 
-> Registro pessoal do esforço: narrativa auditável e linha pronta para o timesheet. Fica só na sessão, nunca é publicado. Uma seção por data (`## AAAA-MM-DD`), no formato abaixo, para um comando futuro juntar os registros de um dia.
+> Registro pessoal do esforço: narrativa auditável e linha pronta para o timesheet. Fica só na sessão, nunca é publicado. Uma seção por data (`## AAAA-MM-DD`), no formato abaixo, para o `/eng.daily-report` juntar os registros por dia.
 
 ## {AAAA-MM-DD}
 

package/workflows/engineering/eng.daily-report.md

@@ -0,0 +1,131 @@
+---
+description: Junta os daily.md das sessões em um relatório por dia (mapa mental), com alertas das sessões sem daily.md
+auto_execution_mode: 3
+recommended_model: sonnet
+model_tier: medium
+model_justification: Leitura de poucos arquivos e síntese curta; a janela, as datas e os alertas já vêm prontos do CLI
+---
+
+# Relatório dos daily.md
+
+Este comando junta o que foi feito nos últimos `N` dias, lendo os `daily.md` que o `/eng.pr` grava em cada sessão. O resultado é um relatório em markdown, do dia mais recente para o mais antigo, em lista aninhada (tarefa > frentes de trabalho > detalhes), com a linha de timesheet de cada tarefa e um bloco de **alertas** das sessões que deveriam ter `daily.md` e não têm.
+
+> 🔒 **Privado**: o relatório reaproveita a narrativa e o timesheet pessoais do `daily.md`. Ele fica em `$ENG_DOCS/daily-reports/` (dentro de `docs/jarvis/`, fora do versionamento) e **nunca** é publicado: nem no Central docs, nem no card.
+
+### Skills invocados durante o workflow
+
+| Passo | Skill | Condição |
+|-------|-------|----------|
+| — | Nenhuma — workflow autocontido | — |
+
+---
+
+## Argumento
+
+<arguments>
+$ARGUMENTS
+</arguments>
+
+`{N}` é a janela em dias: **1, 3, 7, 15, 30 ou 60** (padrão **7**). A janela é do calendário local e inclui hoje: `1` = só hoje; `7` = hoje e os 6 dias anteriores.
+
+---
+
+## Passo 1: Ler as sessões
+
+Rode o helper do CLI (ele lê o `ENV.md` do workspace, mesmo se você estiver dentro de um repositório filho):
+
+```bash
+jarvis daily-report --days {N} --json
+```
+
+- **Saída com erro** (código 1, por exemplo `N` inválido): mostre a mensagem, que já lista os valores aceitos, e **pare**. Não crie arquivo.
+- **Saída JSON**: use os campos abaixo e não refaça as contas (janela, fuso, ordem e alertas já estão certos).
+
+| Campo | O que é |
+|---|---|
+| `days`, `window.from`, `window.to`, `today` | Janela pedida, no calendário local |
+| `sessionsScanned`, `sessionsInWindow` | Sessões lidas em `$SESSIONS_DIR/eng/` e quantas entram na janela |
+| `byDate[]` | Um item por dia com registro, do mais recente para o mais antigo; em cada um, `tasks[]` com `key`, `taskKey`, `cardUrl`, `pr`, `description` e `timesheet` (seção `## AAAA-MM-DD` do `daily.md`) |
+| `alerts[]` | Sessões sem `daily.md` que deveriam ter (chegaram ao `eng.pr` ou começaram a partir de 2026-10-15), com `date`, `dateSource`, `activity`, `issueKey`, `prNumber` |
+| `warnings[]` | Avisos (por exemplo, data tirada da modificação da pasta) |
+| `reportPath`, `reportPathAbs` | Onde escrever o relatório |
+
+Os textos já vêm sem e-mails.
+
+---
+
+## Passo 2: Completar os alertas pelo vendor
+
+Para cada item de `alerts` com `prNumber` ou `issueKey`, consulte o vendor de `VERSION_CONTROL`/`TASK_MANAGER` (no GitHub: `gh pr view {n} --json title,createdAt` e `gh issue view {n} --json title`):
+
+- **Título:** use o do vendor quando `activity` vier vazia.
+- **Data:** se houver PR, a data de criação dele (em fuso local) vale mais que a data local do helper. Se ela cair fora da janela, tire o alerta.
+- Sem vendor, sem acesso ou com falha: siga com o que veio do helper, sem perguntar.
+- Sem nenhuma fonte de atividade: escreva "não identificada", só com o ID da sessão.
+
+---
+
+## Passo 3: Escrever o relatório
+
+Crie a pasta de `reportPathAbs`, se não existir, e escreva o arquivo. Se já existir um relatório com a mesma janela no mesmo dia, ele é **sobrescrito**. Janelas diferentes no mesmo dia convivem.
+
+```markdown
+# Daily report — {window.from} a {window.to} ({N} dias)
+
+> Gerado em {AAAA-MM-DD HH:MM} · {sessionsScanned} sessões lidas · {sessionsInWindow} na janela · privado, não publicar
+
+## ⚠️ Alertas: sessões sem daily.md
+
+| Data | ID da sessão | Atividade | Status |
+|---|---|---|---|
+| {date} | {key} | {activity} ({issueKey}, PR {prNumber}) | sem daily.md{; data pela modificação da pasta, se dateSource = mtime} |
+
+## {AAAA-MM-DD} ({dia da semana})
+
+- **{taskKey} — {título curto}** ([card]({cardUrl}), [PR {n}]({url do PR}))
+  - {frente de trabalho 1}
+    - {detalhe}
+  - {frente de trabalho 2}
+    - {detalhe}
+  - 🕒 `{timesheet}`
+```
+
+- **Alertas** vêm antes dos dias. Sem alertas, troque a tabela por "✅ Todas as sessões da janela têm `daily.md`."
+- **Um bloco `##` por data de `byDate`, na mesma ordem** (decrescente). Dia sem registro não aparece.
+- **Síntese por tarefa:** de 3 a 5 frentes de trabalho, cada uma com detalhes curtos, tirados **só** da `description` (contexto, o que foi feito, decisões; *post mortem* quando houver). Não acrescente fatos. O título curto vem da linha de timesheet ou do card.
+- **Timesheet literal:** a linha `timesheet` entra sem alteração, para copiar.
+- Links: `cardUrl` e o PR de `pr` (o campo traz `#n` e a URL). Faltando, omita o link.
+
+---
+
+## Passo 4: Mostrar o resultado
+
+Mostre, em markdown:
+
+```
+✅ Relatório gerado: [{nome do arquivo}]({reportPath})
+
+🗓️ Janela: {window.from} a {window.to} ({N} dias)
+📚 Sessões: {sessionsScanned} lidas · {sessionsInWindow} na janela · {dias com registro} dias com registro
+⚠️ Alertas: {quantidade} ({IDs}) — rode o /eng.pr nessas sessões (Fase 7.2) para gerar o daily.md
+```
+
+O link usa o caminho relativo ao workspace (`reportPath`).
+
+---
+
+## Regras
+
+### ✅ Faça
+
+- Use o JSON do `jarvis daily-report` como fonte da janela, das datas, da ordem e dos alertas
+- Mantenha a linha de timesheet literal
+- Sobrescreva o relatório da mesma janela no mesmo dia
+
+### ⛔ Não faça
+
+- Não publique o relatório (Central docs, card, PR) nem o copie para fora de `docs/jarvis/`
+- Não inclua e-mails, tokens nem valores de variáveis do `ENV.md`
+- Não acrescente fatos além do `daily.md` e do vendor
+- Não altere os `daily.md` nem outros arquivos das sessões
+- Não gere arquivo quando a janela for inválida