freeharness 0.4.1

package/canonical/skills/report-formatting/scripts/example_build_ExecutiveReport_docx.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Template: Executive report (.docx, Claro theme).
+ *
+ * For leadership readers with little time and no technical background. Goal:
+ * high-level storytelling (tension -> evidence -> resolution), statistics
+ * translated into business language, a decision panel, and a one-page closing.
+ * Copy this file, rename (build-<slug>.js), and fill `children` with the real
+ * content using the ./theme-claro.js helpers. Content placeholders are PT-BR
+ * (client-facing); comments are English.
+ *
+ * Usage:
+ *   node example_build_ExecutiveReport_docx.js                 # ./out/Relatorio_Executivo.docx
+ *   node example_build_ExecutiveReport_docx.js /path/out.docx
+ */
+const fs = require("fs");
+const path = require("path");
+const { Packer, AlignmentType } = require("docx");
+const T = require("./theme-claro");
+
+const children = [];
+
+// ---- COVER (rich) ----
+children.push(...T.coverBlock({
+  title: "Título Executivo — uma frase que vende a história",
+  subtitle: "STT — Claro (Projeto Speech-to-Text)",
+  tagline: "O que mudou, por que importa, e a decisão que pedimos",
+  org: "Projeto STT — Claro  |  DADOS & IA",
+  metaLines: ["Para: Diretoria / Liderança", "Data: 22/06/2026"],
+}));
+children.push(T.spacer(240));
+
+// ---- EXECUTIVE SUMMARY (the whole story in 8 lines) ----
+children.push(T.h1("Resumo executivo"));
+children.push(T.body([
+  T.t("Em uma frase: ", { size: 22, bold: true }),
+  T.t("a tese central, dita como impacto de negócio, não como detalhe técnico.", { size: 22, color: T.C.body }),
+]));
+children.push(T.statCards([
+  { value: "+38%", label: "ganho que importa", color: T.C.green, fill: T.C.successFill },
+  { value: "R$ X", label: "custo evitado / mês", color: T.C.deepRed, fill: "FFEDED" },
+  { value: "2 sem", label: "prazo para a decisão", color: T.C.amber, fill: T.C.noteFill },
+]));
+children.push(T.spacer(140));
+children.push(T.bullet([T.t("Mensagem-âncora 1. ", { size: 22, bold: true }), T.t("em linguagem de negócio.", { size: 22, color: T.C.body })]));
+children.push(T.bullet([T.t("Mensagem-âncora 2. ", { size: 22, bold: true }), T.t("o risco, traduzido.", { size: 22, color: T.C.body })]));
+children.push(T.calloutLine("Decisão que pedimos:", "a ação principal, em uma frase, com o prazo.", "success"));
+children.push(T.spacer(200));
+
+// ---- NARRATIVE (tension -> evidence -> resolution) ----
+children.push(T.h1("1. O problema (tensão)"));
+children.push(T.body("O contexto e o que estava em risco, sem jargão. Por que isto chegou à mesa da liderança."));
+children.push(T.calloutLine("Leitura executiva:", "o que isso significava para o negócio se nada mudasse.", "danger"));
+children.push(T.spacer(140));
+
+children.push(T.h1("2. O que descobrimos (evidência)"));
+children.push(T.body("A evidência central, com 1-2 números traduzidos. Estatística vira frase de negócio."));
+children.push(T.makeTable(
+  [4200, 2200, 3240],
+  ["Indicador", "Antes / Depois", "O que significa"],
+  [
+    [{ runs: "Métrica-chave" }, { runs: [T.t("X → Y", { size: 20, bold: true, color: T.C.green })], align: AlignmentType.RIGHT }, { runs: "tradução em 1 linha" }],
+    [{ runs: "Custo / risco" }, { runs: "Z", align: AlignmentType.RIGHT }, { runs: [T.t("impacto direto", { size: 20, color: T.C.deepRed })] }],
+  ]
+));
+children.push(T.caption("Tabela 1 – Só os números que mudam a decisão."));
+children.push(T.spacer(140));
+
+children.push(T.h1("3. O caminho (resolução)"));
+children.push(T.body("A recomendação e o plano em poucos passos, com o ganho esperado e o que é preciso da liderança."));
+
+// ---- DECISION PANEL (semaphore) ----
+children.push(T.h2("Painel de decisão"));
+children.push(T.makeTable(
+  [4600, 2000, 3040],
+  ["Decisão", "Status", "Próximo passo"],
+  [
+    [{ runs: "Aprovar X" }, { runs: [T.t("Recomendado", { size: 20, bold: true, color: T.C.green })], fill: T.C.successFill }, { runs: "quem / quando" }],
+    [{ runs: "Avaliar Y" }, { runs: [T.t("Atenção", { size: 20, color: T.C.amber })], fill: T.C.noteFill }, { runs: "dado a validar" }],
+    [{ runs: "Não fazer Z" }, { runs: [T.t("Bloqueado", { size: 20, color: T.C.deepRed })], fill: T.C.dangerFill }, { runs: "motivo" }],
+  ]
+));
+children.push(T.spacer(160));
+
+// ---- ONE-PAGE CLOSING ----
+children.push(T.h1("Em uma página para a diretoria"));
+children.push(T.callout([
+  T.body([T.t("O essencial: ", { size: 22, bold: true }), T.t("a história em 3 frases — situação, ação, ganho.", { size: 22, color: T.C.body })]),
+  T.bullet([T.t("Pedimos: ", { size: 22, bold: true }), T.t("a decisão.", { size: 22, color: T.C.body })]),
+  T.bullet([T.t("Ganho: ", { size: 22, bold: true }), T.t("o resultado de negócio.", { size: 22, color: T.C.body })]),
+  T.bullet([T.t("Prazo: ", { size: 22, bold: true }), T.t("a janela.", { size: 22, color: T.C.body })]),
+], "info"));
+
+// ---- AUTHORSHIP ----
+children.push(...T.authorBlock({
+  name: "André Negrelli",
+  role: "Tech Lead — AI Data Engineer",
+  area: "DADOS & IA  |  Tech Dados & IA — Aquisição e Transformação de Dados & IA",
+  project: "Projeto STT — Claro  ·  22/06/2026",
+}));
+
+const doc = T.buildDocument({
+  children,
+  headerText: "Relatório Executivo  |  STT Claro",
+  footerAuthor: "André Negrelli — DADOS & IA",
+});
+
+const outPath = process.argv[2] || path.join(process.cwd(), "out", "Relatorio_Executivo.docx");
+fs.mkdirSync(path.dirname(outPath), { recursive: true });
+Packer.toBuffer(doc).then((buf) => {
+  fs.writeFileSync(outPath, buf);
+  console.log("Gerado:", outPath, `(${buf.length} bytes)`);
+});

package/canonical/skills/report-formatting/scripts/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "report-formatting-skill",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Theme library and scripts (default theme: Claro) to generate .docx reports.",
+  "scripts": {
+    "check": "node check-env.js",
+    "example": "node example-build.js"
+  },
+  "dependencies": {
+    "docx": "^9.0.0",
+    "image-size": "^1.1.1"
+  },
+  "optionalDependencies": {
+    "@mermaid-js/mermaid-cli": "^11.0.0"
+  }
+}

package/canonical/skills/report-formatting/scripts/pptx/example_build_StatusReport_pptx.py

@@ -0,0 +1,223 @@
+#!/usr/bin/env python3
+"""Template: Status Report deck (.pptx, Claro theme).
+
+Base template for the STT-style status report. Copy this file, rename
+(build_<slug>.py), and fill the data dicts with the real period content, using
+the theme_claro_pptx helpers. Also a smoke test of the pptx track.
+
+Usage:
+  python example_build_StatusReport_pptx.py                 # ./out/Status_Report_exemplo.pptx
+  python example_build_StatusReport_pptx.py /path/out.pptx
+
+Note on timelines: the rich "Status até DD/MM" timeline slides are NOT rebuilt
+here — they are cloned from the original Claro template and edited via lxml (see
+reference/PPTX.md). This template builds the python-pptx slides: cover, summary,
+Gantt, heatmap, ROAM. Content is PT-BR (client-facing); instructions are English.
+
+Reusable, refined blocks: `status_report_blocks.py` provides build_heatmap
+(período × estágio status grid with a Parcial category + optional data column +
+full legend) and build_gantt (Claro red/dark header, per-row accent + category
+chip + priority bar). Both CLEAR and rebuild a given slide — prefer them over the
+simplified build_heatmap/build_gantt below for status-report decks.
+"""
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+import theme_claro_pptx as T  # noqa: E402
+from pptx import Presentation  # noqa: E402
+from pptx.util import Inches  # noqa: E402
+from pptx.enum.text import PP_ALIGN  # noqa: E402
+
+prs = Presentation()
+prs.slide_width = Inches(13.333)
+prs.slide_height = Inches(7.5)
+BLANK = prs.slide_layouts[6]
+TOTAL = 5
+
+
+def new_slide():
+    """Add a blank slide to the deck and return it."""
+    return prs.slides.add_slide(BLANK)
+
+
+def build_cover(period_label):
+    """Add the cover slide with logo, title, subtitle, and period.
+
+    Args:
+        period_label: Reporting-period caption shown under the subtitle.
+    """
+    s = new_slide()
+    T.add_logo(s, x=Inches(0.5), y=Inches(0.7), height=Inches(1.3))
+    T.add_rect(s, Inches(0.5), Inches(2.6), Inches(0.9), Inches(0.12), T.CLARO_RED)
+    T.add_text(s, Inches(0.5), Inches(2.8), Inches(12), Inches(1.0),
+               "Status Report — Pipeline STT", size=34, bold=True, color=T.DARK_GRAY)
+    T.add_text(s, Inches(0.5), Inches(3.7), Inches(12), Inches(0.5),
+               "Dados & IA — Projeto Speech-to-Text (Claro)", size=16,
+               color=T.MID_GRAY, italic=True)
+    T.add_text(s, Inches(0.5), Inches(4.25), Inches(12), Inches(0.4),
+               period_label, size=13, color=T.MID_GRAY)
+
+
+def build_summary(rows):
+    """Add the deliveries-summary slide (one table row per delivery).
+
+    Args:
+        rows: List of dicts with keys theme, subtitle, deliveries, maturity,
+            maturity_color, maturity_detail, impact.
+    """
+    s = new_slide()
+    T.add_page_header(s, "Resumo | Entregas do Período",
+                      "Principais realizações do período")
+    headers = ["Entrega estratégica", "Principais entregues",
+               "Maturidade", "Impacto no negócio"]
+    widths = [Inches(3.0), Inches(3.8), Inches(2.6), Inches(3.0)]
+    xs = [Inches(0.45)]
+    for w in widths[:-1]:
+        xs.append(xs[-1] + w)
+    hy, hh = Inches(1.45), Inches(0.42)
+    for i, h in enumerate(headers):
+        T.add_filled_text(s, xs[i], hy, widths[i], hh, h, fill=T.CLARO_RED, size=11)
+    ry, rh, gap = hy + hh + Inches(0.08), Inches(1.5), Inches(0.12)
+    for ri, row in enumerate(rows):
+        y = ry + ri * (rh + gap)
+        T.add_rect(s, xs[0], y, Inches(0.08), rh, T.CLARO_RED)
+        T.add_rect(s, xs[0] + Inches(0.08), y, widths[0] - Inches(0.08), rh, T.VERY_LIGHT_GRAY)
+        T.add_text(s, xs[0] + Inches(0.2), y + Inches(0.1), widths[0] - Inches(0.3),
+                   Inches(0.45), row["theme"], size=13, bold=True, color=T.CLARO_RED_DARK)
+        T.add_text(s, xs[0] + Inches(0.2), y + Inches(0.55), widths[0] - Inches(0.3),
+                   Inches(0.85), row["subtitle"], size=10, color=T.MID_GRAY, italic=True)
+        T.add_rect(s, xs[1], y, widths[1], rh, T.VERY_LIGHT_GRAY)
+        T.build_bullet_list(s, xs[1] + Inches(0.1), y + Inches(0.08),
+                            widths[1] - Inches(0.2), rh - Inches(0.16), row["deliveries"])
+        T.add_rect(s, xs[2], y, widths[2], rh, T.VERY_LIGHT_GRAY)
+        T.add_filled_text(s, xs[2] + Inches(0.15), y + Inches(0.15), widths[2] - Inches(0.3),
+                          Inches(0.35), row["maturity"], fill=row["maturity_color"], size=9, corner=True)
+        T.add_text(s, xs[2] + Inches(0.15), y + Inches(0.6), widths[2] - Inches(0.3),
+                   Inches(0.8), row["maturity_detail"], size=9, color=T.DARK_GRAY)
+        T.add_rect(s, xs[3], y, widths[3], rh, T.VERY_LIGHT_GRAY)
+        T.build_bullet_list(s, xs[3] + Inches(0.1), y + Inches(0.08),
+                            widths[3] - Inches(0.2), rh - Inches(0.16), row["impact"])
+    T.add_page_footer(s, 2, TOTAL)
+
+
+def build_gantt(activities, weeks):
+    """Add a simplified gantt slide (one bar per activity).
+
+    Args:
+        activities: List of {name, cat, start, end, priority}; start/end are
+            1-based week indices.
+        weeks: Number of week columns.
+    """
+    s = new_slide()
+    T.add_page_header(s, "Cronograma de Execução", "Próximos passos por semana")
+    x0, y0 = Inches(3.6), Inches(1.55)
+    col_w = (Inches(13.333) - x0 - Inches(0.45)) / weeks
+    for w in range(weeks):
+        T.add_text(s, x0 + col_w * w, y0, col_w, Inches(0.3), f"S{w + 1}",
+                   size=9, bold=True, color=T.MID_GRAY, align=PP_ALIGN.CENTER)
+    ry, rh = y0 + Inches(0.35), Inches(0.42)
+    for i, a in enumerate(activities):
+        y = ry + i * (rh + Inches(0.08))
+        color = T.CAT_COLOR.get(a["cat"], T.STATUS_BACKLOG)
+        T.add_rect(s, Inches(0.45), y, Inches(0.08), rh, color)
+        T.add_text(s, Inches(0.6), y, Inches(2.0), rh, a["name"], size=9, color=T.DARK_GRAY)
+        bx = x0 + col_w * (a["start"] - 1)
+        bw = col_w * (a["end"] - a["start"] + 1)
+        T.add_filled_text(s, bx, y + Inches(0.05), bw, rh - Inches(0.1),
+                          f"Prioridade {a['priority']}", fill=color, size=8, corner=True)
+    T.add_page_footer(s, 3, TOTAL)
+
+
+def build_heatmap(periods, stages):
+    """Add a simplified period × stage status heatmap slide.
+
+    Args:
+        periods: List of (label, [status_key per stage]).
+        stages: Column captions.
+    """
+    s = new_slide()
+    T.add_page_header(s, "Cronograma de Processamento", "Status por período x estágio")
+    x0, y0 = Inches(2.0), Inches(1.6)
+    cw, ch = Inches(2.4), Inches(0.42)
+    for j, st in enumerate(stages):
+        T.add_text(s, x0 + cw * j, y0, cw, Inches(0.3), st, size=9, bold=True,
+                   color=T.MID_GRAY, align=PP_ALIGN.CENTER)
+    for i, (label, statuses) in enumerate(periods):
+        y = y0 + Inches(0.35) + i * (ch + Inches(0.06))
+        T.add_text(s, Inches(0.45), y, Inches(1.5), ch, label, size=9, color=T.DARK_GRAY)
+        for j, key in enumerate(statuses):
+            cfg = T.STATUS_CFG.get(key, T.STATUS_CFG["backlog"])
+            T.add_filled_text(s, x0 + cw * j, y, cw - Inches(0.1), ch, cfg[3],
+                              fill=cfg[1], tcolor=cfg[2], size=12)
+    T.add_page_footer(s, 4, TOTAL)
+
+
+def build_roam(risks):
+    """Add the ROAM risk-map slide (one row per risk).
+
+    Args:
+        risks: List of dicts with keys theme, risk, roam, impact, owner,
+            action, due.
+    """
+    s = new_slide()
+    T.add_page_header(s, "Mapa de Riscos (ROAM)", "Resolved / Owned / Accepted / Mitigated")
+    cols = ["Tema", "Risco", "ROAM", "Impacto", "Responsável", "Ação", "Prazo"]
+    widths = [Inches(1.6), Inches(3.0), Inches(0.9), Inches(1.4), Inches(1.6), Inches(2.6), Inches(1.1)]
+    xs = [Inches(0.45)]
+    for w in widths[:-1]:
+        xs.append(xs[-1] + w)
+    hy, hh = Inches(1.5), Inches(0.4)
+    for i, c in enumerate(cols):
+        T.add_filled_text(s, xs[i], hy, widths[i], hh, c, fill=T.CLARO_RED, size=9)
+    ROAM = {"R": T.STATUS_DONE, "O": T.CAT_COLOR["Pipeline"], "A": T.STATUS_INPROGRESS, "M": T.CAT_COLOR["Data Core"]}
+    ry, rh = hy + hh + Inches(0.06), Inches(0.6)
+    for ri, r in enumerate(risks):
+        y = ry + ri * (rh + Inches(0.06))
+        fill = T.WHITE if ri % 2 else T.VERY_LIGHT_GRAY
+        for j in range(len(cols)):
+            T.add_rect(s, xs[j], y, widths[j], rh, fill)
+        T.add_text(s, xs[0] + Inches(0.05), y, widths[0], rh, r["theme"], size=8, color=T.DARK_GRAY)
+        T.add_text(s, xs[1] + Inches(0.05), y, widths[1], rh, r["risk"], size=8, color=T.DARK_GRAY)
+        T.add_filled_text(s, xs[2] + Inches(0.25), y + Inches(0.12), Inches(0.4), Inches(0.36),
+                          r["roam"], fill=ROAM.get(r["roam"], T.STATUS_BACKLOG), size=10, corner=True)
+        T.add_text(s, xs[3] + Inches(0.05), y, widths[3], rh, r["impact"], size=8, color=T.DARK_GRAY)
+        T.add_text(s, xs[4] + Inches(0.05), y, widths[4], rh, r["owner"], size=8, color=T.DARK_GRAY)
+        T.add_text(s, xs[5] + Inches(0.05), y, widths[5], rh, r["action"], size=8, color=T.DARK_GRAY)
+        T.add_text(s, xs[6] + Inches(0.05), y, widths[6], rh, r["due"], size=8, color=T.CLARO_RED_DARK)
+    T.add_page_footer(s, 5, TOTAL)
+
+
+# ---- example data (replace with real period content) ----
+build_cover("Status até 22/06/2026")
+build_summary([
+    {"theme": "Pipeline D-0", "subtitle": "Estabilização do ciclo horário",
+     "deliveries": ["Circuit breaker", "Idle sentinel"], "maturity": "Produção",
+     "maturity_color": T.STATUS_DONE, "maturity_detail": "Em operação estável",
+     "impact": ["Menos incidentes", "Recuperação automática"]},
+    {"theme": "Backlog histórico", "subtitle": "Processamento mensal",
+     "deliveries": ["10/16 períodos"], "maturity": "Em andamento",
+     "maturity_color": T.STATUS_INPROGRESS, "maturity_detail": "62% concluído",
+     "impact": ["Cobertura crescente"]},
+])
+build_gantt([
+    {"name": "Deploy pipeline", "cat": "Pipeline", "start": 1, "end": 2, "priority": "Alta"},
+    {"name": "Backlog jan-mar", "cat": "Backlog", "start": 2, "end": 5, "priority": "Média"},
+    {"name": "Doc arquitetura", "cat": "Documentação", "start": 3, "end": 4, "priority": "Baixa"},
+], weeks=6)
+build_heatmap([
+    ("Jan/2026", ["done", "done", "done", "done"]),
+    ("Fev/2026", ["done", "done", "inprogress", "pending"]),
+    ("Mar/2026", ["done", "inprogress", "backlog", "backlog"]),
+], ["Download", "Transcrição", "Carga", "Validação"])
+build_roam([
+    {"theme": "WhisperX", "risk": "Fila GPU saturada", "roam": "M", "impact": "Atraso",
+     "owner": "HubGPU", "action": "Nova QUEUE dedicada", "due": "30/06"},
+    {"theme": "Data Core", "risk": "Schema ADW", "roam": "O", "impact": "Médio",
+     "owner": "Data Core", "action": "Alinhar contrato", "due": "15/07"},
+])
+
+out = sys.argv[1] if len(sys.argv) > 1 else os.path.join(os.getcwd(), "out", "Status_Report_exemplo.pptx")
+os.makedirs(os.path.dirname(out), exist_ok=True)
+prs.save(out)
+print("Gerado:", out)

package/canonical/skills/report-formatting/scripts/pptx/example_build_WeeklyStatus_pptx.py

@@ -0,0 +1,245 @@
+#!/usr/bin/env python3
+"""Template: Weekly Status deck (.pptx, Claro theme).
+
+Lighter, weekly variant of the status report: one short deck the squad sends every
+Friday. Six slides: cover, week highlights (done / in progress / blocked), processing
+heatmap, execution Gantt, ROAM risks, next week. The heatmap and Gantt slides are
+built by the refined, reusable builders in status_report_blocks.py (build_heatmap,
+build_gantt), which clear and rebuild the slide they receive. Copy this file, rename
+(build_<slug>.py), and fill the data at the bottom with the real week content.
+Content is PT-BR (client-facing); instructions and docstrings are English.
+
+Usage:
+  python example_build_WeeklyStatus_pptx.py                 # ./out/Weekly_Status_exemplo.pptx
+  python example_build_WeeklyStatus_pptx.py /path/out.pptx
+
+Compared with example_build_StatusReport_pptx.py (biweekly/monthly): no deliverables
+summary table and no cloned timeline slides; highlights replace the summary, and a
+"next week" slide replaces the long-range plan.
+"""
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+import theme_claro_pptx as T  # noqa: E402
+import status_report_blocks as B  # noqa: E402
+from pptx import Presentation  # noqa: E402
+from pptx.util import Inches  # noqa: E402
+from pptx.enum.text import PP_ALIGN, MSO_ANCHOR  # noqa: E402
+
+prs = Presentation()
+prs.slide_width = Inches(13.333)
+prs.slide_height = Inches(7.5)
+BLANK = prs.slide_layouts[6]
+TOTAL = 6
+
+# Highlight lanes: key -> (caption, fill color).
+LANES = {
+    "done": ("Entregue na semana", T.STATUS_DONE),
+    "inprogress": ("Em andamento", T.STATUS_INPROGRESS),
+    "blocked": ("Bloqueado / precisa de decisão", T.STATUS_RISK),
+}
+ROAM_COLOR = {
+    "R": T.STATUS_DONE,
+    "O": T.CAT_COLOR["Pipeline"],
+    "A": T.STATUS_INPROGRESS,
+    "M": T.CAT_COLOR["Data Core"],
+}
+
+
+def new_slide():
+    """Add a blank slide to the deck and return it."""
+    return prs.slides.add_slide(BLANK)
+
+
+def build_cover(project, week_label, squad):
+    """Add the cover slide with logo, title, project line, and the week caption.
+
+    Args:
+        project: Project title shown under the accent bar.
+        week_label: Week caption, e.g. "Semana 36 — 31/08 a 04/09/2026".
+        squad: Team / area line shown in italics.
+    """
+    s = new_slide()
+    T.add_logo(s, x=Inches(0.5), y=Inches(0.7), height=Inches(1.3))
+    T.add_rect(s, Inches(0.5), Inches(2.6), Inches(0.9), Inches(0.12), T.CLARO_RED)
+    T.add_text(s, Inches(0.5), Inches(2.8), Inches(12), Inches(1.0),
+               f"Weekly Status — {project}", size=34, bold=True, color=T.DARK_GRAY)
+    T.add_text(s, Inches(0.5), Inches(3.7), Inches(12), Inches(0.5),
+               squad, size=16, color=T.MID_GRAY, italic=True)
+    T.add_text(s, Inches(0.5), Inches(4.25), Inches(12), Inches(0.4),
+               week_label, size=13, color=T.MID_GRAY)
+
+
+def build_highlights(week_label, lanes):
+    """Add the week-highlights slide: three columns (done / in progress / blocked).
+
+    Args:
+        week_label: Subtitle caption with the week range.
+        lanes: Dict key -> list of short bullet strings; keys are LANES keys.
+    """
+    s = new_slide()
+    T.add_page_header(s, "Destaques da Semana", week_label)
+    keys = list(LANES.keys())
+    x0, y0 = Inches(0.45), Inches(1.5)
+    gap = Inches(0.2)
+    col_w = (Inches(13.333) - x0 * 2 - gap * (len(keys) - 1)) / len(keys)
+    hh, body_h = Inches(0.42), Inches(4.6)
+    for i, key in enumerate(keys):
+        caption, fill = LANES[key]
+        x = x0 + (col_w + gap) * i
+        T.add_filled_text(s, x, y0, col_w, hh, caption, fill=fill, size=11, bold=True)
+        T.add_rect(s, x, y0 + hh, col_w, body_h, T.VERY_LIGHT_GRAY)
+        items = lanes.get(key) or ["—"]
+        T.build_bullet_list(s, x + Inches(0.15), y0 + hh + Inches(0.15),
+                            col_w - Inches(0.3), body_h - Inches(0.3), items, size=11)
+        T.add_filled_text(s, x + col_w - Inches(0.7), y0 + hh + body_h - Inches(0.45),
+                          Inches(0.55), Inches(0.3), str(len(lanes.get(key) or [])),
+                          fill=fill, size=10, corner=True)
+    T.add_page_footer(s, 2, TOTAL)
+
+
+def build_heatmap_slide(rows, stages, banner):
+    """Add the processing heatmap slide via status_report_blocks.build_heatmap.
+
+    Args:
+        rows: List of (label, [status_key per stage], data_str|None).
+        stages: Column captions, one per stage.
+        banner: Banner strip text below the header.
+    """
+    s = new_slide()
+    B.build_heatmap(s, title="Cronograma de Processamento",
+                    subtitle="Status por período x estágio", banner=banner,
+                    rows=rows, stages=stages, page=3, total=TOTAL)
+
+
+def build_gantt_slide(activities, week_labels):
+    """Add the execution Gantt slide via status_report_blocks.build_gantt.
+
+    Args:
+        activities: List of {name, cat, start, end, prio}; cat is a T.CAT_COLOR
+            key, start/end are 1-based week indices, prio in {Alta, Média, Baixa}.
+        week_labels: One label per week column (use "Mes\\nSn").
+    """
+    s = new_slide()
+    B.build_gantt(s, title="Cronograma de Execução",
+                  subtitle="Semana atual e as próximas", activities=activities,
+                  week_labels=week_labels, page=4, total=TOTAL)
+
+
+def build_roam(risks):
+    """Add the ROAM risk slide (one row per risk).
+
+    Args:
+        risks: List of dicts with keys theme, risk, roam, impact, owner, action, due.
+    """
+    s = new_slide()
+    T.add_page_header(s, "Riscos da Semana (ROAM)", "Resolved / Owned / Accepted / Mitigated")
+    cols = ["Tema", "Risco", "ROAM", "Impacto", "Responsável", "Ação", "Prazo"]
+    widths = [Inches(1.6), Inches(3.0), Inches(0.9), Inches(1.4), Inches(1.6), Inches(2.6), Inches(1.1)]
+    xs = [Inches(0.45)]
+    for w in widths[:-1]:
+        xs.append(xs[-1] + w)
+    hy, hh = Inches(1.5), Inches(0.4)
+    for i, c in enumerate(cols):
+        T.add_filled_text(s, xs[i], hy, widths[i], hh, c, fill=T.CLARO_RED, size=9)
+    ry, rh = hy + hh + Inches(0.06), Inches(0.6)
+    for ri, r in enumerate(risks):
+        y = ry + ri * (rh + Inches(0.06))
+        fill = T.WHITE if ri % 2 else T.VERY_LIGHT_GRAY
+        for j in range(len(cols)):
+            T.add_rect(s, xs[j], y, widths[j], rh, fill)
+        for j, key in enumerate(["theme", "risk"]):
+            T.add_text(s, xs[j] + Inches(0.05), y, widths[j], rh, r[key], size=8,
+                       color=T.DARK_GRAY, anchor=MSO_ANCHOR.MIDDLE)
+        T.add_filled_text(s, xs[2] + Inches(0.25), y + Inches(0.12), Inches(0.4), Inches(0.36),
+                          r["roam"], fill=ROAM_COLOR.get(r["roam"], T.STATUS_BACKLOG),
+                          size=10, corner=True)
+        for j, key in zip((3, 4, 5), ("impact", "owner", "action")):
+            T.add_text(s, xs[j] + Inches(0.05), y, widths[j], rh, r[key], size=8,
+                       color=T.DARK_GRAY, anchor=MSO_ANCHOR.MIDDLE)
+        T.add_text(s, xs[6] + Inches(0.05), y, widths[6], rh, r["due"], size=8,
+                   color=T.CLARO_RED_DARK, anchor=MSO_ANCHOR.MIDDLE)
+    T.add_page_footer(s, 5, TOTAL)
+
+
+def build_next_week(items, decisions):
+    """Add the closing slide: next-week plan on the left, decisions needed on the right.
+
+    Args:
+        items: List of {what, owner, due} for next week.
+        decisions: List of short strings the squad needs from the audience.
+    """
+    s = new_slide()
+    T.add_page_header(s, "Próxima Semana", "Plano e decisões necessárias")
+    x_left, x_right = Inches(0.45), Inches(8.2)
+    y0 = Inches(1.5)
+    w_left = x_right - x_left - Inches(0.25)
+    w_right = Inches(13.333) - x_right - Inches(0.45)
+    T.add_filled_text(s, x_left, y0, w_left, Inches(0.42), "Plano da semana",
+                      fill=T.CLARO_RED, size=11, bold=True, align=PP_ALIGN.LEFT)
+    rh = Inches(0.5)
+    for i, it in enumerate(items):
+        y = y0 + Inches(0.5) + i * (rh + Inches(0.06))
+        T.add_rect(s, x_left, y, w_left, rh, T.WHITE if i % 2 else T.VERY_LIGHT_GRAY)
+        T.add_rect(s, x_left, y, Inches(0.08), rh, T.CLARO_RED)
+        T.add_text(s, x_left + Inches(0.2), y, w_left - Inches(3.2), rh, it["what"],
+                   size=10, color=T.DARK_GRAY, anchor=MSO_ANCHOR.MIDDLE)
+        T.add_text(s, x_left + w_left - Inches(3.0), y, Inches(1.9), rh, it["owner"],
+                   size=9, color=T.MID_GRAY, anchor=MSO_ANCHOR.MIDDLE)
+        T.add_text(s, x_left + w_left - Inches(1.0), y, Inches(0.95), rh, it["due"],
+                   size=9, bold=True, color=T.CLARO_RED_DARK, anchor=MSO_ANCHOR.MIDDLE,
+                   align=PP_ALIGN.RIGHT)
+    T.add_filled_text(s, x_right, y0, w_right, Inches(0.42), "Decisões necessárias",
+                      fill=T.DARK_GRAY, size=11, bold=True, align=PP_ALIGN.LEFT)
+    T.add_rect(s, x_right, y0 + Inches(0.42), w_right, Inches(4.0), T.VERY_LIGHT_GRAY)
+    T.build_bullet_list(s, x_right + Inches(0.15), y0 + Inches(0.6), w_right - Inches(0.3),
+                        Inches(3.7), decisions or ["Nenhuma decisão pendente."], size=11)
+    T.add_page_footer(s, 6, TOTAL)
+
+
+# ---- example data (replace with the real week content) ----
+WEEK = "Semana 36 — 31/08 a 04/09/2026"
+build_cover("Pipeline STT", WEEK, "Dados & IA — Projeto Speech-to-Text (Claro)")
+build_highlights(WEEK, {
+    "done": ["Circuit breaker em produção", "Backlog Fev/2026 carregado"],
+    "inprogress": ["Transcrição Mar/2026 (62%)", "Doc de arquitetura v2"],
+    "blocked": ["Schema ADW aguardando Data Core"],
+})
+build_heatmap_slide(
+    rows=[
+        ("Jan/2026", ["done", "done", "done", "done"], "0"),
+        ("Fev/2026", ["done", "done", "done", "parcial"], "1.2k"),
+        ("Mar/2026", ["done", "inprogress", "backlog", "backlog"], "8.4k"),
+    ],
+    stages=["Download Áudio", "Transcrição", "Carga LakeHouse", "Validação"],
+    banner="Semana 36: Fev/2026 concluído; Mar/2026 em transcrição",
+)
+build_gantt_slide(
+    activities=[
+        {"name": "Deploy pipeline D-0", "cat": "Pipeline", "start": 1, "end": 1, "prio": "Alta"},
+        {"name": "Backlog Mar/2026", "cat": "Backlog", "start": 1, "end": 3, "prio": "Média"},
+        {"name": "Contrato ADW", "cat": "Data Core", "start": 2, "end": 3, "prio": "Alta"},
+        {"name": "Doc arquitetura v2", "cat": "Documentação", "start": 2, "end": 4, "prio": "Baixa"},
+    ],
+    week_labels=["Set\nS36", "Set\nS37", "Set\nS38", "Set\nS39"],
+)
+build_roam([
+    {"theme": "WhisperX", "risk": "Fila GPU saturada no pico", "roam": "M", "impact": "Atraso 1 sem",
+     "owner": "HubGPU", "action": "Fila dedicada", "due": "11/09"},
+    {"theme": "Data Core", "risk": "Schema ADW sem contrato", "roam": "O", "impact": "Bloqueia carga",
+     "owner": "Data Core", "action": "Alinhar contrato", "due": "09/09"},
+])
+build_next_week(
+    items=[
+        {"what": "Concluir transcrição Mar/2026", "owner": "Squad STT", "due": "11/09"},
+        {"what": "Fechar contrato ADW com Data Core", "owner": "Tech Lead", "due": "09/09"},
+        {"what": "Revisar doc de arquitetura v2", "owner": "Arquitetura", "due": "12/09"},
+    ],
+    decisions=["Aprovar fila GPU dedicada (custo mensal)", "Definir dono do schema ADW"],
+)
+
+out = sys.argv[1] if len(sys.argv) > 1 else os.path.join(os.getcwd(), "out", "Weekly_Status_exemplo.pptx")
+os.makedirs(os.path.dirname(out), exist_ok=True)
+prs.save(out)
+print("Gerado:", out)