@luanpdd/kit-mcp 1.29.0 → 1.30.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (331) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +168 -168
  3. package/gates/agent-no-recursive-dispatch.md +82 -82
  4. package/kit/COMANDOS.md +138 -138
  5. package/kit/README.md +76 -76
  6. package/kit/agents/advisor-researcher.md +106 -106
  7. package/kit/agents/assumptions-analyzer.md +107 -107
  8. package/kit/agents/audit-log-implementer.md +313 -313
  9. package/kit/agents/auditor-consistencia-isolamento.md +413 -413
  10. package/kit/agents/b2b-saas-architect.md +156 -156
  11. package/kit/agents/cascading-failures-auditor.md +298 -298
  12. package/kit/agents/codebase-mapper.md +768 -768
  13. package/kit/agents/crm-pipeline-implementer.md +256 -256
  14. package/kit/agents/debugger.md +813 -813
  15. package/kit/agents/detector-tenant-quente.md +337 -337
  16. package/kit/agents/evolution-go-integrator.md +200 -200
  17. package/kit/agents/example-reviewer.md +21 -21
  18. package/kit/agents/executor.md +564 -564
  19. package/kit/agents/integration-checker.md +200 -200
  20. package/kit/agents/invite-flow-implementer.md +189 -189
  21. package/kit/agents/legacy-characterizer.md +368 -368
  22. package/kit/agents/lgpd-compliance-auditor.md +295 -295
  23. package/kit/agents/multi-tenant-isolation-auditor.md +253 -253
  24. package/kit/agents/multi-tenant-rls-writer.md +340 -340
  25. package/kit/agents/nyquist-auditor.md +178 -178
  26. package/kit/agents/observability-coverage-auditor.md +315 -315
  27. package/kit/agents/org-onboarding-implementer.md +223 -223
  28. package/kit/agents/payload-capture-instrumenter.md +273 -273
  29. package/kit/agents/phase-researcher.md +696 -696
  30. package/kit/agents/plan-checker.md +272 -272
  31. package/kit/agents/planner.md +922 -922
  32. package/kit/agents/project-researcher.md +652 -652
  33. package/kit/agents/refactor-safety-auditor.md +404 -404
  34. package/kit/agents/research-synthesizer.md +245 -245
  35. package/kit/agents/roadmapper.md +677 -677
  36. package/kit/agents/seam-finder.md +359 -359
  37. package/kit/agents/shotgun-surgery-detector.md +349 -349
  38. package/kit/agents/supabase-branching-architect.md +562 -562
  39. package/kit/agents/supabase-cicd-pipeline-implementer.md +777 -777
  40. package/kit/agents/supabase-column-privileges-writer.md +399 -399
  41. package/kit/agents/supabase-edge-fn-tester.md +287 -0
  42. package/kit/agents/supabase-edge-fn-writer.md +239 -210
  43. package/kit/agents/supabase-migration-writer.md +385 -385
  44. package/kit/agents/supabase-rbac-implementer.md +392 -392
  45. package/kit/agents/supabase-realtime-implementer.md +363 -267
  46. package/kit/agents/supabase-rls-hardener.md +521 -521
  47. package/kit/agents/supabase-rls-writer.md +323 -323
  48. package/kit/agents/supabase-roles-implementer.md +355 -355
  49. package/kit/agents/super-admin-implementer.md +281 -281
  50. package/kit/agents/ui-auditor.md +437 -437
  51. package/kit/agents/ui-checker.md +302 -302
  52. package/kit/agents/ui-researcher.md +355 -355
  53. package/kit/agents/user-profiler.md +175 -175
  54. package/kit/agents/validador-evolucao-schema.md +335 -335
  55. package/kit/agents/verifier.md +728 -728
  56. package/kit/commands/adicionar-backlog.md +75 -75
  57. package/kit/commands/adicionar-fase.md +42 -42
  58. package/kit/commands/adicionar-tarefa.md +45 -45
  59. package/kit/commands/adicionar-testes.md +41 -41
  60. package/kit/commands/ajuda.md +21 -21
  61. package/kit/commands/atualizar.md +37 -37
  62. package/kit/commands/auditar-cascading.md +111 -111
  63. package/kit/commands/auditar-marco.md +179 -179
  64. package/kit/commands/auditar-observabilidade-cobertura.md +183 -183
  65. package/kit/commands/auditar-refactor.md +219 -219
  66. package/kit/commands/auditar-release.md +109 -109
  67. package/kit/commands/auditar-uat.md +23 -23
  68. package/kit/commands/autonomo.md +40 -40
  69. package/kit/commands/branch-pr.md +24 -24
  70. package/kit/commands/burn-rate-status.md +408 -408
  71. package/kit/commands/capturar-payloads.md +193 -193
  72. package/kit/commands/caracterizar.md +212 -212
  73. package/kit/commands/concluir-marco.md +247 -247
  74. package/kit/commands/configuracoes.md +36 -36
  75. package/kit/commands/dados-distribuidos.md +188 -188
  76. package/kit/commands/definir-perfil.md +10 -10
  77. package/kit/commands/depurar.md +190 -190
  78. package/kit/commands/detectar-duplicacao.md +197 -197
  79. package/kit/commands/discutir-fase.md +131 -131
  80. package/kit/commands/encontrar-seams.md +136 -136
  81. package/kit/commands/entrar-discord.md +17 -17
  82. package/kit/commands/estatisticas.md +18 -18
  83. package/kit/commands/example-greeting.md +33 -33
  84. package/kit/commands/executar-fase.md +58 -58
  85. package/kit/commands/expresso.md +56 -56
  86. package/kit/commands/fase-ui.md +34 -34
  87. package/kit/commands/fazer.md +57 -57
  88. package/kit/commands/fio.md +125 -125
  89. package/kit/commands/fluxos-trabalho.md +64 -64
  90. package/kit/commands/forense.md +176 -176
  91. package/kit/commands/gerenciador.md +38 -38
  92. package/kit/commands/inserir-fase.md +31 -31
  93. package/kit/commands/legacy.md +263 -263
  94. package/kit/commands/limpeza.md +17 -17
  95. package/kit/commands/listar-hipoteses-fase.md +45 -45
  96. package/kit/commands/listar-workspaces.md +18 -18
  97. package/kit/commands/load-shedding.md +117 -117
  98. package/kit/commands/mapear-codebase.md +70 -70
  99. package/kit/commands/multi-tenant.md +163 -163
  100. package/kit/commands/nota.md +33 -33
  101. package/kit/commands/novo-marco.md +43 -43
  102. package/kit/commands/novo-projeto.md +41 -41
  103. package/kit/commands/novo-workspace.md +43 -43
  104. package/kit/commands/pausar-trabalho.md +37 -37
  105. package/kit/commands/perfil-usuario.md +45 -45
  106. package/kit/commands/pesquisar-fase.md +195 -195
  107. package/kit/commands/planejar-fase.md +67 -67
  108. package/kit/commands/planejar-lacunas.md +33 -33
  109. package/kit/commands/plantar-ideia.md +25 -25
  110. package/kit/commands/progresso.md +24 -24
  111. package/kit/commands/proximo.md +30 -30
  112. package/kit/commands/publicar.md +490 -490
  113. package/kit/commands/rapido.md +35 -35
  114. package/kit/commands/reaplicar-patches.md +124 -124
  115. package/kit/commands/refactor-seguro.md +321 -321
  116. package/kit/commands/relatorio-sessao.md +19 -19
  117. package/kit/commands/remover-fase.md +31 -31
  118. package/kit/commands/remover-workspace.md +26 -26
  119. package/kit/commands/resumo-marco.md +50 -50
  120. package/kit/commands/retomar-trabalho.md +40 -40
  121. package/kit/commands/revisar-backlog.md +60 -60
  122. package/kit/commands/revisar-ui.md +32 -32
  123. package/kit/commands/revisar.md +37 -37
  124. package/kit/commands/saude.md +21 -21
  125. package/kit/commands/setup-notion.md +93 -93
  126. package/kit/commands/storytelling.md +179 -179
  127. package/kit/commands/supabase.md +30 -7
  128. package/kit/commands/sync-main.md +68 -68
  129. package/kit/commands/validar-fase.md +35 -35
  130. package/kit/commands/verificar-tarefas.md +44 -44
  131. package/kit/commands/verificar-trabalho.md +64 -64
  132. package/kit/file-manifest.json +15 -8
  133. package/kit/framework/bin/lib/commands.cjs +959 -959
  134. package/kit/framework/bin/lib/config.cjs +442 -442
  135. package/kit/framework/bin/lib/core.cjs +1230 -1230
  136. package/kit/framework/bin/lib/frontmatter.cjs +336 -336
  137. package/kit/framework/bin/lib/init.cjs +1442 -1442
  138. package/kit/framework/bin/lib/milestone.cjs +252 -252
  139. package/kit/framework/bin/lib/model-profiles.cjs +68 -68
  140. package/kit/framework/bin/lib/phase.cjs +888 -888
  141. package/kit/framework/bin/lib/profile-output.cjs +952 -952
  142. package/kit/framework/bin/lib/profile-pipeline.cjs +539 -539
  143. package/kit/framework/bin/lib/roadmap.cjs +329 -329
  144. package/kit/framework/bin/lib/security.cjs +382 -382
  145. package/kit/framework/bin/lib/state.cjs +1031 -1031
  146. package/kit/framework/bin/lib/template.cjs +222 -222
  147. package/kit/framework/bin/lib/uat.cjs +282 -282
  148. package/kit/framework/bin/lib/verify.cjs +888 -888
  149. package/kit/framework/bin/lib/workstream.cjs +491 -491
  150. package/kit/framework/bin/tools.cjs +918 -918
  151. package/kit/framework/commands/workstreams.md +63 -63
  152. package/kit/framework/references/checkpoints.md +778 -778
  153. package/kit/framework/references/continuation-format.md +249 -249
  154. package/kit/framework/references/decimal-phase-calculation.md +64 -64
  155. package/kit/framework/references/git-integration.md +295 -295
  156. package/kit/framework/references/git-planning-commit.md +38 -38
  157. package/kit/framework/references/model-profile-resolution.md +36 -36
  158. package/kit/framework/references/model-profiles.md +139 -139
  159. package/kit/framework/references/phase-argument-parsing.md +61 -61
  160. package/kit/framework/references/planning-config.md +202 -202
  161. package/kit/framework/references/questioning.md +162 -162
  162. package/kit/framework/references/tdd.md +263 -263
  163. package/kit/framework/references/ui-brand.md +160 -160
  164. package/kit/framework/references/user-profiling.md +657 -657
  165. package/kit/framework/references/verification-patterns.md +612 -612
  166. package/kit/framework/references/workstream-flag.md +58 -58
  167. package/kit/framework/templates/DEBUG.md +164 -164
  168. package/kit/framework/templates/UAT.md +265 -265
  169. package/kit/framework/templates/UI-SPEC.md +100 -100
  170. package/kit/framework/templates/VALIDATION.md +76 -76
  171. package/kit/framework/templates/claude-md.md +122 -122
  172. package/kit/framework/templates/codebase/architecture.md +185 -185
  173. package/kit/framework/templates/codebase/concerns.md +205 -205
  174. package/kit/framework/templates/codebase/conventions.md +204 -204
  175. package/kit/framework/templates/codebase/integrations.md +192 -192
  176. package/kit/framework/templates/codebase/stack.md +158 -158
  177. package/kit/framework/templates/codebase/structure.md +199 -199
  178. package/kit/framework/templates/codebase/testing.md +301 -301
  179. package/kit/framework/templates/config.json +44 -44
  180. package/kit/framework/templates/context.md +352 -352
  181. package/kit/framework/templates/continue-here.md +78 -78
  182. package/kit/framework/templates/copilot-instructions.md +7 -7
  183. package/kit/framework/templates/debug-subagent-prompt.md +91 -91
  184. package/kit/framework/templates/dev-preferences.md +20 -20
  185. package/kit/framework/templates/discovery.md +146 -146
  186. package/kit/framework/templates/discussion-log.md +63 -63
  187. package/kit/framework/templates/milestone-archive.md +123 -123
  188. package/kit/framework/templates/milestone.md +115 -115
  189. package/kit/framework/templates/phase-prompt.md +610 -610
  190. package/kit/framework/templates/planner-subagent-prompt.md +117 -117
  191. package/kit/framework/templates/project.md +186 -186
  192. package/kit/framework/templates/requirements.md +231 -231
  193. package/kit/framework/templates/research-project/ARCHITECTURE.md +204 -204
  194. package/kit/framework/templates/research-project/FEATURES.md +147 -147
  195. package/kit/framework/templates/research-project/PITFALLS.md +200 -200
  196. package/kit/framework/templates/research-project/STACK.md +120 -120
  197. package/kit/framework/templates/research-project/SUMMARY.md +170 -170
  198. package/kit/framework/templates/research.md +419 -419
  199. package/kit/framework/templates/retrospective.md +54 -54
  200. package/kit/framework/templates/roadmap.md +202 -202
  201. package/kit/framework/templates/state.md +176 -176
  202. package/kit/framework/templates/summary-complex.md +59 -59
  203. package/kit/framework/templates/summary-minimal.md +41 -41
  204. package/kit/framework/templates/summary-standard.md +48 -48
  205. package/kit/framework/templates/summary.md +209 -209
  206. package/kit/framework/templates/user-profile.md +146 -146
  207. package/kit/framework/templates/user-setup.md +256 -256
  208. package/kit/framework/templates/verification-report.md +258 -258
  209. package/kit/framework/workflows/add-phase.md +112 -112
  210. package/kit/framework/workflows/add-tests.md +351 -351
  211. package/kit/framework/workflows/add-todo.md +158 -158
  212. package/kit/framework/workflows/audit-milestone.md +340 -340
  213. package/kit/framework/workflows/audit-uat.md +109 -109
  214. package/kit/framework/workflows/autonomous.md +891 -891
  215. package/kit/framework/workflows/check-todos.md +177 -177
  216. package/kit/framework/workflows/cleanup.md +152 -152
  217. package/kit/framework/workflows/complete-milestone.md +696 -696
  218. package/kit/framework/workflows/diagnose-issues.md +231 -231
  219. package/kit/framework/workflows/discovery-phase.md +289 -289
  220. package/kit/framework/workflows/discuss-phase-assumptions.md +653 -653
  221. package/kit/framework/workflows/discuss-phase.md +784 -784
  222. package/kit/framework/workflows/do.md +104 -104
  223. package/kit/framework/workflows/execute-phase.md +838 -838
  224. package/kit/framework/workflows/execute-plan.md +510 -510
  225. package/kit/framework/workflows/fast.md +102 -102
  226. package/kit/framework/workflows/forensics.md +265 -265
  227. package/kit/framework/workflows/health.md +181 -181
  228. package/kit/framework/workflows/help.md +619 -619
  229. package/kit/framework/workflows/insert-phase.md +130 -130
  230. package/kit/framework/workflows/list-phase-assumptions.md +178 -178
  231. package/kit/framework/workflows/list-workspaces.md +56 -56
  232. package/kit/framework/workflows/manager.md +362 -362
  233. package/kit/framework/workflows/map-codebase.md +377 -377
  234. package/kit/framework/workflows/milestone-summary.md +223 -223
  235. package/kit/framework/workflows/new-milestone.md +486 -486
  236. package/kit/framework/workflows/new-project.md +1159 -1159
  237. package/kit/framework/workflows/new-workspace.md +237 -237
  238. package/kit/framework/workflows/next.md +97 -97
  239. package/kit/framework/workflows/node-repair.md +92 -92
  240. package/kit/framework/workflows/note.md +156 -156
  241. package/kit/framework/workflows/pause-work.md +176 -176
  242. package/kit/framework/workflows/plan-milestone-gaps.md +273 -273
  243. package/kit/framework/workflows/plan-phase.md +765 -765
  244. package/kit/framework/workflows/plant-seed.md +169 -169
  245. package/kit/framework/workflows/pr-branch.md +129 -129
  246. package/kit/framework/workflows/profile-user.md +450 -450
  247. package/kit/framework/workflows/progress.md +507 -507
  248. package/kit/framework/workflows/quick.md +757 -757
  249. package/kit/framework/workflows/remove-phase.md +155 -155
  250. package/kit/framework/workflows/remove-workspace.md +90 -90
  251. package/kit/framework/workflows/research-phase.md +82 -82
  252. package/kit/framework/workflows/resume-project.md +326 -326
  253. package/kit/framework/workflows/review.md +228 -228
  254. package/kit/framework/workflows/session-report.md +146 -146
  255. package/kit/framework/workflows/settings.md +283 -283
  256. package/kit/framework/workflows/ship.md +228 -228
  257. package/kit/framework/workflows/stats.md +60 -60
  258. package/kit/framework/workflows/transition.md +671 -671
  259. package/kit/framework/workflows/ui-phase.md +302 -302
  260. package/kit/framework/workflows/ui-review.md +165 -165
  261. package/kit/framework/workflows/update.md +323 -323
  262. package/kit/framework/workflows/validate-phase.md +174 -174
  263. package/kit/framework/workflows/verify-phase.md +252 -252
  264. package/kit/framework/workflows/verify-work.md +637 -637
  265. package/kit/hooks/check-update.js +118 -118
  266. package/kit/hooks/context-monitor.js +163 -163
  267. package/kit/hooks/kit-attribution-reminder.cjs +98 -0
  268. package/kit/hooks/prompt-guard.js +103 -103
  269. package/kit/hooks/statusline.js +125 -125
  270. package/kit/hooks/workflow-guard.js +101 -101
  271. package/kit/settings.json +45 -45
  272. package/kit/skills/_shared-supabase/glossary.md +17 -0
  273. package/kit/skills/ai-prompt-characterization/SKILL.md +335 -335
  274. package/kit/skills/armadilhas-sistemas-distribuidos/SKILL.md +447 -447
  275. package/kit/skills/audit-log-multi-tenant/SKILL.md +340 -340
  276. package/kit/skills/b2b-saas-architecture/SKILL.md +300 -300
  277. package/kit/skills/consistencia-leitura-replica/SKILL.md +385 -385
  278. package/kit/skills/crm-lead-pipeline-patterns/SKILL.md +343 -343
  279. package/kit/skills/escolha-modelo-consistencia/SKILL.md +494 -494
  280. package/kit/skills/evolucao-schema-compativel/SKILL.md +448 -448
  281. package/kit/skills/evolution-go-whatsapp-integration/SKILL.md +322 -322
  282. package/kit/skills/example-skill/SKILL.md +42 -42
  283. package/kit/skills/legacy-api-only-applications/SKILL.md +358 -358
  284. package/kit/skills/legacy-characterization-tests/SKILL.md +330 -330
  285. package/kit/skills/legacy-effect-analysis/SKILL.md +331 -331
  286. package/kit/skills/legacy-extract-class/SKILL.md +203 -203
  287. package/kit/skills/legacy-programming-by-difference/SKILL.md +252 -252
  288. package/kit/skills/legacy-seams-and-test-harness/SKILL.md +460 -460
  289. package/kit/skills/legacy-shotgun-surgery/SKILL.md +286 -286
  290. package/kit/skills/legacy-sprout-wrap-techniques/SKILL.md +434 -434
  291. package/kit/skills/legacy-storytelling-naked-crc/SKILL.md +270 -270
  292. package/kit/skills/lgpd-multi-tenant-compliance/SKILL.md +340 -340
  293. package/kit/skills/member-invite-flow/SKILL.md +305 -305
  294. package/kit/skills/member-management-react-shadcn/SKILL.md +328 -328
  295. package/kit/skills/multi-tenant-performance-scaling/SKILL.md +316 -316
  296. package/kit/skills/multi-tenant-rls-hierarchy/SKILL.md +342 -342
  297. package/kit/skills/org-onboarding-flow/SKILL.md +257 -257
  298. package/kit/skills/org-switcher-react-pattern/SKILL.md +349 -349
  299. package/kit/skills/permission-gate-react-pattern/SKILL.md +271 -271
  300. package/kit/skills/postgres-isolamento-concorrencia/SKILL.md +552 -552
  301. package/kit/skills/pre-refactor-characterization/SKILL.md +421 -421
  302. package/kit/skills/rbac-permissions-matrix-supabase/SKILL.md +338 -338
  303. package/kit/skills/streams-eventos-cdc/SKILL.md +711 -711
  304. package/kit/skills/supabase-branching-workflow/SKILL.md +544 -544
  305. package/kit/skills/supabase-ci-cd-github-actions/SKILL.md +880 -880
  306. package/kit/skills/supabase-column-level-security/SKILL.md +426 -426
  307. package/kit/skills/supabase-config-toml-remotes/SKILL.md +807 -807
  308. package/kit/skills/supabase-custom-claims-rbac/SKILL.md +472 -472
  309. package/kit/skills/supabase-edge-functions/SKILL.md +229 -141
  310. package/kit/skills/supabase-edge-functions-auth/SKILL.md +309 -0
  311. package/kit/skills/supabase-edge-functions-limits/SKILL.md +302 -0
  312. package/kit/skills/supabase-edge-functions-mcp-server/SKILL.md +279 -0
  313. package/kit/skills/supabase-edge-functions-testing/SKILL.md +277 -0
  314. package/kit/skills/supabase-edge-runtime-builtins/SKILL.md +357 -0
  315. package/kit/skills/supabase-migration-repair/SKILL.md +823 -823
  316. package/kit/skills/supabase-migrations/SKILL.md +297 -297
  317. package/kit/skills/supabase-pgtap-testing/SKILL.md +1053 -1053
  318. package/kit/skills/supabase-postgres-roles/SKILL.md +392 -392
  319. package/kit/skills/supabase-realtime/SKILL.md +460 -236
  320. package/kit/skills/supabase-rls-defense-in-depth/SKILL.md +418 -418
  321. package/kit/skills/supabase-rls-policies/SKILL.md +635 -635
  322. package/kit/skills/super-admin-platform-pattern/SKILL.md +326 -326
  323. package/kit/skills/tenant-quente-mitigacao/SKILL.md +605 -605
  324. package/kit/skills/whatsapp-conversation-state-machine/SKILL.md +287 -287
  325. package/package.json +1 -1
  326. package/src/core/kit.js +216 -216
  327. package/src/core/reflect.js +247 -247
  328. package/src/core/reverse-sync.js +372 -372
  329. package/src/core/sync.js +418 -418
  330. package/src/core/watch.js +121 -121
  331. package/src/mcp-server/index.js +715 -693
@@ -1,408 +1,408 @@
1
- ---
2
- name: burn-rate-status
3
- description: Tabela de burn rate dual-window por SLO consumindo .planning/slos/*.yml + .planning/metrics/snapshots/.
4
- argument-hint: "[<slo_name>] [--fast-baseline 1h] [--slow-baseline 6h] [--format table|json]"
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Glob
9
- ---
10
-
11
- <objective>
12
- Snapshot de burn rate **dual-window** (1h fast + 6h slow) para 1 SLO (se especificado) ou TODOS os SLOs definidos em `.planning/slos/*.yml`. Aplica skill [`burn-rate-alerting`](../skills/burn-rate-alerting/SKILL.md) — fórmula canônica `burn_rate = error_rate / (1 - target)`, com lookahead/baseline obedecendo o **fator 4×** (page-tier: lookahead 1h ≤ 4× baseline 5m equivalente operacional; ticket-tier: lookahead 6h ≤ 4× baseline 30m). Status combinado segue o canonical Google SRE: PAGE quando ambas as janelas críticas, TICKET quando apenas slow erosion sustained, WARN para spike-only ou mild burn, OK quando ambas as janelas em estado saudável.
13
-
14
- **Lê:** `.planning/slos/*.yml` (definição com `alert_thresholds.page` + `.ticket`) + `.planning/metrics/snapshots/*.json` (eventos persistidos via `metrics.persistSnapshot()` — Phase 99 + Phase 102 auto-snapshot).
15
-
16
- **Cria/Atualiza:** nada — comando read-only.
17
-
18
- **Após:** o user vê tabela com colunas `fast_burn`, `slow_burn`, `combined` (status PAGE / TICKET / WARN / OK) e pode escolher invocar `/investigar-producao` se há burn ativo, ou aguardar mais snapshots se ambas janelas estão `no_data`.
19
- </objective>
20
-
21
- <context>
22
- **Argumentos:** `$ARGUMENTS` — opcional `<slo_name>` para 1 SLO; sem args = todos.
23
-
24
- **Flags (defaults dual-window — Phase 103):**
25
- - `--fast-baseline <duration>` — janela fast (page-tier). Default: `1h`.
26
- - `--slow-baseline <duration>` — janela slow (ticket-tier). Default: `6h`.
27
- - `--format <table|json>` — output format. Default: `table`.
28
-
29
- **Combinações canônicas (skill burn-rate-alerting):**
30
- - **Fast (page-tier):** lookahead 1h, baseline 5m, multiplier 14.4× — esgota ~2% do budget mensal em 1h.
31
- - **Slow (ticket-tier):** lookahead 6h, baseline 30m, multiplier 6× — esgota ~10% do budget mensal em 6h.
32
-
33
- **Fator 4×:** lookahead ≤ 4× baseline para extrapolação confiável (skill rule). 1h ≤ 4× 15m e 6h ≤ 4× 90m são ambos respeitados; defaults operacionais são page (1h baseline) + ticket (6h baseline) — a janela `lookahead` propriamente dita está embutida nos `alert_thresholds.{page,ticket}.lookahead` do YAML do SLO.
34
-
35
- **Phase 99 + 102 wiring:** este comando consome dados persistidos automaticamente pelo handler MCP `metrics-snapshot` (Phase 102 OBS-20-01 — auto-persist via `persistSnapshot()` em cada call com throttle 1s). Sem snapshots na janela, o comando emite "no_data" para o SLO em vez de inventar números.
36
-
37
- **Cross-reference:** este comando é a implementação do pattern "dashboard de burn rate" canônico documentado em [`kit/skills/burn-rate-alerting/SKILL.md`](../skills/burn-rate-alerting/SKILL.md). A skill é a SSOT da fórmula e dos thresholds; este comando é o renderer.
38
- </context>
39
-
40
- <process>
41
-
42
- ## 1. Parsear argumentos
43
-
44
- Bash:
45
- ```bash
46
- SLO_NAME=$(echo "$ARGUMENTS" | awk '{for(i=1;i<=NF;i++) if($i !~ /^--/) {print $i; exit}}')
47
- FAST_BASELINE=$(echo "$ARGUMENTS" | grep -oE -- '--fast-baseline [^ ]+' | awk '{print $2}')
48
- SLOW_BASELINE=$(echo "$ARGUMENTS" | grep -oE -- '--slow-baseline [^ ]+' | awk '{print $2}')
49
- FORMAT=$(echo "$ARGUMENTS" | grep -oE -- '--format [^ ]+' | awk '{print $2}')
50
-
51
- [ -z "$FAST_BASELINE" ] && FAST_BASELINE="1h"
52
- [ -z "$SLOW_BASELINE" ] && SLOW_BASELINE="6h"
53
- [ -z "$FORMAT" ] && FORMAT="table"
54
- ```
55
-
56
- Convert duration to ms (helper):
57
- ```bash
58
- to_ms() {
59
- local d="$1"
60
- case "$d" in
61
- *h) echo $(( ${d%h} * 3600000 ));;
62
- *m) echo $(( ${d%m} * 60000 ));;
63
- *s) echo $(( ${d%s} * 1000 ));;
64
- *d) echo $(( ${d%d} * 86400000 ));;
65
- *) echo 0 ;;
66
- esac
67
- }
68
- FAST_BASELINE_MS=$(to_ms "$FAST_BASELINE")
69
- SLOW_BASELINE_MS=$(to_ms "$SLOW_BASELINE")
70
- ```
71
-
72
- ## 2. Listar SLOs (FIX Phase 99: extension `.yml`, não `.md`)
73
-
74
- ```bash
75
- if [ -n "$SLO_NAME" ]; then
76
- SLO_FILES=(".planning/slos/${SLO_NAME}.yml")
77
- else
78
- SLO_FILES=(.planning/slos/*.yml)
79
- fi
80
-
81
- # Filtra entradas inexistentes (caso o glob não tenha match).
82
- EXISTING_SLOS=()
83
- for f in "${SLO_FILES[@]}"; do
84
- [ -f "$f" ] && EXISTING_SLOS+=("$f")
85
- done
86
-
87
- if [ ${#EXISTING_SLOS[@]} -eq 0 ]; then
88
- echo "Nenhum SLO definido em .planning/slos/. Rode /definir-slo <feature> primeiro."
89
- exit 0
90
- fi
91
- ```
92
-
93
- ## 3. Para cada SLO, carregar metadata + calcular SLI dual-window
94
-
95
- Para cada `SLO_FILE` em `EXISTING_SLOS`:
96
-
97
- ### 3.1 Extrair campos canônicos do YAML via regex
98
-
99
- Os SLOs do projeto seguem schema fixo (validado por `test/unit/slo-schema.test.js`). Sem `js-yaml` — regex sobre os keys conhecidos:
100
-
101
- ```bash
102
- SLO_NAME=$(grep -oE '^\s+name:\s*\S+' "$SLO_FILE" | head -1 | awk '{print $2}')
103
- SERVICE=$(grep -oE '^\s+service:\s*\S+' "$SLO_FILE" | head -1 | awk '{print $2}')
104
- SLO_TYPE=$(grep -oE '^\s+type:\s*\S+' "$SLO_FILE" | head -1 | awk '{print $2}')
105
-
106
- # Availability SLO: target = ratio decimal (e.g. 0.995)
107
- TARGET_RATIO=$(grep -oE '^target:\s*[0-9.]+' "$SLO_FILE" | awk '{print $2}')
108
- # Latency SLO: target_ms + percentile
109
- TARGET_MS=$(grep -oE '^target_ms:\s*[0-9]+' "$SLO_FILE" | awk '{print $2}')
110
- PERCENTILE=$(grep -oE '^\s+percentile:\s*[0-9]+' "$SLO_FILE" | awk '{print $2}')
111
- ```
112
-
113
- ### 3.2 Extrair `alert_thresholds.page` (fast) + `.ticket` (slow) do YAML
114
-
115
- Phase 103 (OBS-20-02) — leitura dos dois blocos via awk com state machine. Cada bloco tem `lookahead`, `baseline`, `burn_rate_multiplier`. Defaults canônicos aplicados se ausentes (defensive default — ver fallback abaixo).
116
-
117
- ```bash
118
- # alert_thresholds.page (fast / page-tier)
119
- FAST_LOOKAHEAD=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*page:/){p=1;next}else if(p && /^\s+lookahead:/){print $2;exit}else if(p && /^\s*ticket:/){exit}}' "$SLO_FILE")
120
- FAST_BASELINE_YAML=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*page:/){p=1;next}else if(p && /^\s+baseline:/){print $2;exit}else if(p && /^\s*ticket:/){exit}}' "$SLO_FILE")
121
- FAST_MULTIPLIER=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*page:/){p=1;next}else if(p && /^\s+burn_rate_multiplier:/){print $2;exit}else if(p && /^\s*ticket:/){exit}}' "$SLO_FILE")
122
-
123
- # alert_thresholds.ticket (slow / ticket-tier)
124
- SLOW_LOOKAHEAD=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*ticket:/){t=1;next}else if(t && /^\s+lookahead:/){print $2;exit}}' "$SLO_FILE")
125
- SLOW_BASELINE_YAML=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*ticket:/){t=1;next}else if(t && /^\s+baseline:/){print $2;exit}}' "$SLO_FILE")
126
- SLOW_MULTIPLIER=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*ticket:/){t=1;next}else if(t && /^\s+burn_rate_multiplier:/){print $2;exit}}' "$SLO_FILE")
127
-
128
- # Defensive defaults — fator 4× canonical Google SRE values.
129
- # Se um SLO YAML antigo / parcial não declarar alert_thresholds, aplicamos
130
- # os defaults da skill burn-rate-alerting verbatim:
131
- # page: 14.4× / lookahead 1h / baseline 5m
132
- # ticket: 6× / lookahead 6h / baseline 30m
133
- [ -z "$FAST_MULTIPLIER" ] && FAST_MULTIPLIER="14.4"
134
- [ -z "$SLOW_MULTIPLIER" ] && SLOW_MULTIPLIER="6"
135
- [ -z "$FAST_LOOKAHEAD" ] && FAST_LOOKAHEAD="1h"
136
- [ -z "$SLOW_LOOKAHEAD" ] && SLOW_LOOKAHEAD="6h"
137
- ```
138
-
139
- ### 3.3 Carregar snapshots para AMBAS as janelas
140
-
141
- Use a API `loadSnapshots()` (Phase 99) com duas chamadas — uma para fast (1h), uma para slow (6h). Inline node script:
142
-
143
- ```bash
144
- DUAL_SNAPS=$(node --input-type=module -e "
145
- import { loadSnapshots } from './src/core/metrics.js';
146
- const fast = await loadSnapshots(process.cwd(), $FAST_BASELINE_MS);
147
- const slow = await loadSnapshots(process.cwd(), $SLOW_BASELINE_MS);
148
- console.log(JSON.stringify({fast, slow, fastCount: fast.length, slowCount: slow.length}));
149
- ")
150
- FAST_COUNT=$(echo "$DUAL_SNAPS" | node -e "console.log(JSON.parse(require('fs').readFileSync(0,'utf8')).fastCount)")
151
- SLOW_COUNT=$(echo "$DUAL_SNAPS" | node -e "console.log(JSON.parse(require('fs').readFileSync(0,'utf8')).slowCount)")
152
- ```
153
-
154
- **no_data conservative semantics:** se EITHER janela tem < 2 snapshots (availability) ou < 1 (latency), o `combined_status` final é `no_data` — preferimos não inventar números a falsamente reportar OK. Isso preserva o contrato "graceful no_data" da Phase 99.
155
-
156
- ```bash
157
- # A regra exata é aplicada dentro do node script de combinação (3.5),
158
- # mas o early-out aqui evita trabalho desnecessário no caso comum.
159
- if [ "$FAST_COUNT" -lt 2 ] && [ "$SLOW_COUNT" -lt 2 ]; then
160
- echo "SLO $SLO_NAME: insufficient snapshots in BOTH windows (fast=$FAST_COUNT, slow=$SLOW_COUNT)"
161
- echo "Generate data: invocações ao MCP tool 'metrics-snapshot' agora auto-persistem (Phase 102 OBS-20-01)."
162
- COMBINED_STATUS="no_data"
163
- continue
164
- fi
165
- ```
166
-
167
- ### 3.4 Calcular SLI por tipo de SLO (fast E slow independentes)
168
-
169
- **Availability (`type: event-based`):**
170
-
171
- Inline node — primeiro vs último snapshot **dentro de cada janela**. Delta de counters dá good/bad events:
172
-
173
- ```bash
174
- DUAL_SLI=$(node --input-type=module -e "
175
- import { loadSnapshots } from './src/core/metrics.js';
176
- const fastSnaps = await loadSnapshots(process.cwd(), $FAST_BASELINE_MS);
177
- const slowSnaps = await loadSnapshots(process.cwd(), $SLOW_BASELINE_MS);
178
-
179
- function sliFromSnaps(snaps) {
180
- if (snaps.length < 2) return {sli: null, errorRate: 0, good: 0, total: 0, error: 'no_data'};
181
- const first = snaps[0];
182
- const last = snaps[snaps.length - 1];
183
- let goodFirst = 0, goodLast = 0, totalFirst = 0, totalLast = 0;
184
- for (const [k,v] of Object.entries(first.counters)) {
185
- if (k.endsWith(':ok')) goodFirst += v;
186
- totalFirst += v;
187
- }
188
- for (const [k,v] of Object.entries(last.counters)) {
189
- if (k.endsWith(':ok')) goodLast += v;
190
- totalLast += v;
191
- }
192
- const good = goodLast - goodFirst;
193
- const total = totalLast - totalFirst;
194
- const sli = total > 0 ? good / total : null;
195
- const errorRate = total > 0 ? (total - good) / total : 0;
196
- return {sli, errorRate, good, total};
197
- }
198
-
199
- const fastSli = sliFromSnaps(fastSnaps);
200
- const slowSli = sliFromSnaps(slowSnaps);
201
- console.log(JSON.stringify({fast: fastSli, slow: slowSli}));
202
- ")
203
- ```
204
-
205
- **Latency (`type: percentile`):**
206
-
207
- Para latency, p95 do último snapshot em CADA janela. SLI = fração de samples NOT acima de target_ms.
208
-
209
- ```bash
210
- DUAL_SLI=$(node --input-type=module -e "
211
- import { loadSnapshots } from './src/core/metrics.js';
212
- const target = $TARGET_MS;
213
- const fastSnaps = await loadSnapshots(process.cwd(), $FAST_BASELINE_MS);
214
- const slowSnaps = await loadSnapshots(process.cwd(), $SLOW_BASELINE_MS);
215
-
216
- function latencySli(snaps) {
217
- if (snaps.length < 1) return {sli: null, errorRate: 0, totalSamples: 0, slowSamples: 0, error: 'no_data'};
218
- const last = snaps[snaps.length - 1];
219
- let totalSamples = 0, slowSamples = 0;
220
- for (const lat of Object.values(last.latency)) {
221
- totalSamples += lat.count;
222
- if (lat.p95 > target) slowSamples += Math.round(lat.count * 0.05);
223
- }
224
- const sli = totalSamples > 0 ? 1 - (slowSamples / totalSamples) : null;
225
- const errorRate = totalSamples > 0 ? slowSamples / totalSamples : 0;
226
- return {sli, errorRate, totalSamples, slowSamples};
227
- }
228
-
229
- console.log(JSON.stringify({fast: latencySli(fastSnaps), slow: latencySli(slowSnaps)}));
230
- ")
231
- ```
232
-
233
- ### 3.5 Calcular burn rate + status COMBINADO (dual-window)
234
-
235
- Aplicar fórmula canônica + status enum dual-window (skill `burn-rate-alerting` — fator 4× canonical):
236
-
237
- ```bash
238
- DUAL_STATUS=$(node --input-type=module -e "
239
- const dual = $DUAL_SLI;
240
- const target = $TARGET_RATIO || (1 - 0.05); // latency: 1 - ratio_above_target (5%)
241
- const fastMult = $FAST_MULTIPLIER;
242
- const slowMult = $SLOW_MULTIPLIER;
243
-
244
- function burnFromSli(sli, target) {
245
- if (sli.error) return {burnRate: null, error: sli.error};
246
- const slack = 1 - target;
247
- const burnRate = slack > 0 ? sli.errorRate / slack : 0;
248
- return {burnRate, errorRate: sli.errorRate};
249
- }
250
-
251
- // Combined status — canonical dual-window logic per skill burn-rate-alerting (fator 4×):
252
- // PAGE = ambos críticos (fast ≥ 14.4 E slow ≥ 6) → page on-call AGORA
253
- // TICKET = slow erosion sustained (slow ≥ 6, fast OK) → ticket de investigação
254
- // WARN = fast spike isolado (fast ≥ 14.4 sozinho) — monitor, NÃO page (alarm flap risk)
255
- // WARN = mild burn em qualquer janela (≥ 1.0×) — sustained drains budget no horizonte
256
- // OK = ambos < 1.0× — saudável
257
- // no_data = qualquer janela com snapshots insuficientes (conservative)
258
- function combinedStatus(fastBurn, fastMult, slowBurn, slowMult) {
259
- if (fastBurn === null || slowBurn === null) return 'no_data';
260
- const fastTriggered = fastBurn >= fastMult;
261
- const slowTriggered = slowBurn >= slowMult;
262
- if (fastTriggered && slowTriggered) return 'PAGE';
263
- if (slowTriggered) return 'TICKET';
264
- if (fastTriggered) return 'WARN';
265
- if (fastBurn >= 1.0 || slowBurn >= 1.0) return 'WARN';
266
- return 'OK';
267
- }
268
-
269
- const fastBurn = burnFromSli(dual.fast, target);
270
- const slowBurn = burnFromSli(dual.slow, target);
271
- const combined = combinedStatus(fastBurn.burnRate, fastMult, slowBurn.burnRate, slowMult);
272
-
273
- let action;
274
- switch (combined) {
275
- case 'PAGE':
276
- action = 'Page on-call NOW — invoke /investigar-producao';
277
- break;
278
- case 'TICKET':
279
- action = 'Open ticket — slow erosion sustained, investigate before budget exhausted';
280
- break;
281
- case 'WARN':
282
- action = 'Monitor — burn rate ≥1× either window, sustained drains budget';
283
- break;
284
- case 'no_data':
285
- action = '— (await more snapshots; auto-persist via metrics-snapshot tool — Phase 102)';
286
- break;
287
- default:
288
- action = '—';
289
- }
290
-
291
- // ETA exhaustion (predictive). Use slow window (more stable signal for budget extrapolation).
292
- // For burn=0 (no errors), ETA is ∞.
293
- const slowBurnRate = slowBurn.burnRate;
294
- const baselineHours = $SLOW_BASELINE_MS / 3600000;
295
- const eta = (slowBurnRate !== null && slowBurnRate > 0)
296
- ? (1 / slowBurnRate) * 30 * 24 / baselineHours
297
- : null;
298
- const etaStr = eta === null ? '—' : (eta < 24 ? eta.toFixed(1) + 'h' : (eta/24).toFixed(1) + 'd');
299
-
300
- const fastBurnFmt = fastBurn.burnRate === null ? '—' : fastBurn.burnRate.toFixed(2) + '×';
301
- const slowBurnFmt = slowBurn.burnRate === null ? '—' : slowBurn.burnRate.toFixed(2) + '×';
302
-
303
- // fast_status / slow_status são derivados em isolation (informativo na tabela);
304
- // combined_status é o veredito operacional.
305
- function singleStatus(burn, mult) {
306
- if (burn === null) return 'no_data';
307
- if (burn >= mult) return mult === parseFloat('$FAST_MULTIPLIER') ? 'PAGE-FAST' : 'TICKET-SLOW';
308
- if (burn >= 1.0) return 'WARN';
309
- return 'OK';
310
- }
311
- const fastStatus = singleStatus(fastBurn.burnRate, fastMult);
312
- const slowStatus = singleStatus(slowBurn.burnRate, slowMult);
313
-
314
- console.log(JSON.stringify({
315
- fast_burn: fastBurnFmt,
316
- slow_burn: slowBurnFmt,
317
- fast_status: fastStatus,
318
- slow_status: slowStatus,
319
- combined_status: combined,
320
- action: action,
321
- eta: etaStr,
322
- }));
323
- ")
324
- ```
325
-
326
- ### 3.6 Acumular linha da tabela (colunas dual-window)
327
-
328
- ```bash
329
- SLO_ROWS+=("| $SLO_NAME | ${TARGET_RATIO:-${TARGET_MS}ms p$PERCENTILE} | ${FAST_BURN} | ${SLOW_BURN} | **${COMBINED_STATUS}** | $ETA | $ACTION |")
330
- ```
331
-
332
- ## 4. Renderizar tabela mestra (Phase 103 dual-window)
333
-
334
- ```text
335
- ═══════════════════════════════════════════════════════════
336
- framework ▸ BURN-RATE-STATUS (dual-window) ▸ {timestamp}
337
- fast_baseline=$FAST_BASELINE slow_baseline=$SLOW_BASELINE
338
- fast_multiplier=$FAST_MULTIPLIER (page) slow_multiplier=$SLOW_MULTIPLIER (ticket)
339
- snapshots fast=$FAST_COUNT slow=$SLOW_COUNT
340
- ═══════════════════════════════════════════════════════════
341
-
342
- | SLO | Target | Fast (1h) | Slow (6h) | Combined | ETA exhaustão | Ação |
343
- |---|---|---|---|---|---|---|
344
- {$SLO_ROWS}
345
- ```
346
-
347
- **Exemplo concreto:**
348
-
349
- ```markdown
350
- | SLO | Target | Fast (1h) | Slow (6h) | Combined | ETA exhaustão | Ação |
351
- |---|---|---|---|---|---|---|
352
- | mcp-tool-availability | 99.5% | 0.42× OK | 0.18× OK | **OK** | — | — |
353
- | mcp-tool-latency | 200ms p95 | 16.0× PAGE-FAST | 8.5× TICKET-SLOW | **PAGE** | 4.2h | Page on-call NOW — invoke /investigar-producao |
354
- ```
355
-
356
- ## 5. Sugerir próximas ações
357
-
358
- ```bash
359
- # Contar status counts
360
- PAGE_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*PAGE\*\*" || echo 0)
361
- TICKET_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*TICKET\*\*" || echo 0)
362
- WARN_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*WARN\*\*" || echo 0)
363
- NO_DATA_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*no_data\*\*" || echo 0)
364
- ```
365
-
366
- Output:
367
- ```text
368
- ## Próximas ações
369
-
370
- {Se PAGE_COUNT > 0:}
371
- ⚠ {PAGE_COUNT} SLO(s) em PAGE (ambas janelas críticas) — invocar /investigar-producao "<slo_name> dual-window burn"
372
-
373
- {Se TICKET_COUNT > 0:}
374
- ☐ {TICKET_COUNT} SLO(s) em TICKET (slow erosion sustained) — abrir issue, investigar antes do budget esgotar
375
-
376
- {Se WARN_COUNT > 0:}
377
- ⓘ {WARN_COUNT} SLO(s) em WARN — fast spike isolado ou mild burn ≥ 1× (não page; monitor)
378
-
379
- {Se NO_DATA_COUNT > 0:}
380
- ⊘ {NO_DATA_COUNT} SLO(s) sem dados em pelo menos uma janela — Phase 102 auto-persist deve popular .planning/metrics/snapshots/ automaticamente em chamadas ao MCP tool 'metrics-snapshot'
381
- ```
382
-
383
- ## 6. Modo `/loop` (idempotência)
384
-
385
- Se chamado dentro de `/loop`, comportamento idempotente:
386
- - Snapshot fresh em cada invocação (não acumular state).
387
- - Output curto se `combined_status` não mudou (apenas linha-resumo; sem repetir tabela completa).
388
- - Acionar AskUserQuestion APENAS quando algum SLO transiciona OK → WARN/TICKET/PAGE no `combined_status`.
389
-
390
- </process>
391
-
392
- <success_criteria>
393
- - [ ] $ARGUMENTS parseados (SLO opcional + flags --fast-baseline/--slow-baseline/--format)
394
- - [ ] SLOs descobertos via glob `.planning/slos/*.yml` (FIX Phase 99: extension `.yml`, não `.md`)
395
- - [ ] alert_thresholds.page (fast) + alert_thresholds.ticket (slow) extraídos via awk com state machine
396
- - [ ] Defensive defaults aplicados (14.4 / 6 / 1h / 6h) se YAML omitir blocos
397
- - [ ] Snapshots carregados via `loadSnapshots()` em DUAS chamadas (fast + slow)
398
- - [ ] SLI calculado por tipo (event-based ratio para availability, percentile para latency) em CADA janela
399
- - [ ] Burn rate calculado pela fórmula `error_rate / (1 - target)` (skill [`burn-rate-alerting`](../skills/burn-rate-alerting/SKILL.md)) para fast E slow independentemente
400
- - [ ] Status combinado dual-window: **PAGE** (ambos críticos) / **TICKET** (slow only) / **WARN** (fast only OR mild ≥ 1×) / **OK** (ambos < 1×) / **no_data** (qualquer janela com snapshots insuficientes)
401
- - [ ] Tabela markdown agregada com colunas Fast (1h) / Slow (6h) / Combined explícitas
402
- - [ ] ETA exhaustão computada (predictive forecast — usa slow window por estabilidade)
403
- - [ ] Sugestões de próximas ações contextualizadas pelo combined_status
404
- - [ ] Idempotente em /loop (sem acúmulo de state; transição combined_status dispara AskUserQuestion)
405
- - [ ] no_data graceful — Phase 102 auto-persist mencionado como solução
406
- - [ ] Skill burn-rate-alerting cross-referenced no objective + inline no node script + inline na tabela de fallback (3 hits ≥ 2 mínimo)
407
- - [ ] Fator 4× explícito no contexto (canonical Google SRE)
408
- </success_criteria>
1
+ ---
2
+ name: burn-rate-status
3
+ description: Tabela de burn rate dual-window por SLO consumindo .planning/slos/*.yml + .planning/metrics/snapshots/.
4
+ argument-hint: "[<slo_name>] [--fast-baseline 1h] [--slow-baseline 6h] [--format table|json]"
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - Glob
9
+ ---
10
+
11
+ <objective>
12
+ Snapshot de burn rate **dual-window** (1h fast + 6h slow) para 1 SLO (se especificado) ou TODOS os SLOs definidos em `.planning/slos/*.yml`. Aplica skill [`burn-rate-alerting`](../skills/burn-rate-alerting/SKILL.md) — fórmula canônica `burn_rate = error_rate / (1 - target)`, com lookahead/baseline obedecendo o **fator 4×** (page-tier: lookahead 1h ≤ 4× baseline 5m equivalente operacional; ticket-tier: lookahead 6h ≤ 4× baseline 30m). Status combinado segue o canonical Google SRE: PAGE quando ambas as janelas críticas, TICKET quando apenas slow erosion sustained, WARN para spike-only ou mild burn, OK quando ambas as janelas em estado saudável.
13
+
14
+ **Lê:** `.planning/slos/*.yml` (definição com `alert_thresholds.page` + `.ticket`) + `.planning/metrics/snapshots/*.json` (eventos persistidos via `metrics.persistSnapshot()` — Phase 99 + Phase 102 auto-snapshot).
15
+
16
+ **Cria/Atualiza:** nada — comando read-only.
17
+
18
+ **Após:** o user vê tabela com colunas `fast_burn`, `slow_burn`, `combined` (status PAGE / TICKET / WARN / OK) e pode escolher invocar `/investigar-producao` se há burn ativo, ou aguardar mais snapshots se ambas janelas estão `no_data`.
19
+ </objective>
20
+
21
+ <context>
22
+ **Argumentos:** `$ARGUMENTS` — opcional `<slo_name>` para 1 SLO; sem args = todos.
23
+
24
+ **Flags (defaults dual-window — Phase 103):**
25
+ - `--fast-baseline <duration>` — janela fast (page-tier). Default: `1h`.
26
+ - `--slow-baseline <duration>` — janela slow (ticket-tier). Default: `6h`.
27
+ - `--format <table|json>` — output format. Default: `table`.
28
+
29
+ **Combinações canônicas (skill burn-rate-alerting):**
30
+ - **Fast (page-tier):** lookahead 1h, baseline 5m, multiplier 14.4× — esgota ~2% do budget mensal em 1h.
31
+ - **Slow (ticket-tier):** lookahead 6h, baseline 30m, multiplier 6× — esgota ~10% do budget mensal em 6h.
32
+
33
+ **Fator 4×:** lookahead ≤ 4× baseline para extrapolação confiável (skill rule). 1h ≤ 4× 15m e 6h ≤ 4× 90m são ambos respeitados; defaults operacionais são page (1h baseline) + ticket (6h baseline) — a janela `lookahead` propriamente dita está embutida nos `alert_thresholds.{page,ticket}.lookahead` do YAML do SLO.
34
+
35
+ **Phase 99 + 102 wiring:** este comando consome dados persistidos automaticamente pelo handler MCP `metrics-snapshot` (Phase 102 OBS-20-01 — auto-persist via `persistSnapshot()` em cada call com throttle 1s). Sem snapshots na janela, o comando emite "no_data" para o SLO em vez de inventar números.
36
+
37
+ **Cross-reference:** este comando é a implementação do pattern "dashboard de burn rate" canônico documentado em [`kit/skills/burn-rate-alerting/SKILL.md`](../skills/burn-rate-alerting/SKILL.md). A skill é a SSOT da fórmula e dos thresholds; este comando é o renderer.
38
+ </context>
39
+
40
+ <process>
41
+
42
+ ## 1. Parsear argumentos
43
+
44
+ Bash:
45
+ ```bash
46
+ SLO_NAME=$(echo "$ARGUMENTS" | awk '{for(i=1;i<=NF;i++) if($i !~ /^--/) {print $i; exit}}')
47
+ FAST_BASELINE=$(echo "$ARGUMENTS" | grep -oE -- '--fast-baseline [^ ]+' | awk '{print $2}')
48
+ SLOW_BASELINE=$(echo "$ARGUMENTS" | grep -oE -- '--slow-baseline [^ ]+' | awk '{print $2}')
49
+ FORMAT=$(echo "$ARGUMENTS" | grep -oE -- '--format [^ ]+' | awk '{print $2}')
50
+
51
+ [ -z "$FAST_BASELINE" ] && FAST_BASELINE="1h"
52
+ [ -z "$SLOW_BASELINE" ] && SLOW_BASELINE="6h"
53
+ [ -z "$FORMAT" ] && FORMAT="table"
54
+ ```
55
+
56
+ Convert duration to ms (helper):
57
+ ```bash
58
+ to_ms() {
59
+ local d="$1"
60
+ case "$d" in
61
+ *h) echo $(( ${d%h} * 3600000 ));;
62
+ *m) echo $(( ${d%m} * 60000 ));;
63
+ *s) echo $(( ${d%s} * 1000 ));;
64
+ *d) echo $(( ${d%d} * 86400000 ));;
65
+ *) echo 0 ;;
66
+ esac
67
+ }
68
+ FAST_BASELINE_MS=$(to_ms "$FAST_BASELINE")
69
+ SLOW_BASELINE_MS=$(to_ms "$SLOW_BASELINE")
70
+ ```
71
+
72
+ ## 2. Listar SLOs (FIX Phase 99: extension `.yml`, não `.md`)
73
+
74
+ ```bash
75
+ if [ -n "$SLO_NAME" ]; then
76
+ SLO_FILES=(".planning/slos/${SLO_NAME}.yml")
77
+ else
78
+ SLO_FILES=(.planning/slos/*.yml)
79
+ fi
80
+
81
+ # Filtra entradas inexistentes (caso o glob não tenha match).
82
+ EXISTING_SLOS=()
83
+ for f in "${SLO_FILES[@]}"; do
84
+ [ -f "$f" ] && EXISTING_SLOS+=("$f")
85
+ done
86
+
87
+ if [ ${#EXISTING_SLOS[@]} -eq 0 ]; then
88
+ echo "Nenhum SLO definido em .planning/slos/. Rode /definir-slo <feature> primeiro."
89
+ exit 0
90
+ fi
91
+ ```
92
+
93
+ ## 3. Para cada SLO, carregar metadata + calcular SLI dual-window
94
+
95
+ Para cada `SLO_FILE` em `EXISTING_SLOS`:
96
+
97
+ ### 3.1 Extrair campos canônicos do YAML via regex
98
+
99
+ Os SLOs do projeto seguem schema fixo (validado por `test/unit/slo-schema.test.js`). Sem `js-yaml` — regex sobre os keys conhecidos:
100
+
101
+ ```bash
102
+ SLO_NAME=$(grep -oE '^\s+name:\s*\S+' "$SLO_FILE" | head -1 | awk '{print $2}')
103
+ SERVICE=$(grep -oE '^\s+service:\s*\S+' "$SLO_FILE" | head -1 | awk '{print $2}')
104
+ SLO_TYPE=$(grep -oE '^\s+type:\s*\S+' "$SLO_FILE" | head -1 | awk '{print $2}')
105
+
106
+ # Availability SLO: target = ratio decimal (e.g. 0.995)
107
+ TARGET_RATIO=$(grep -oE '^target:\s*[0-9.]+' "$SLO_FILE" | awk '{print $2}')
108
+ # Latency SLO: target_ms + percentile
109
+ TARGET_MS=$(grep -oE '^target_ms:\s*[0-9]+' "$SLO_FILE" | awk '{print $2}')
110
+ PERCENTILE=$(grep -oE '^\s+percentile:\s*[0-9]+' "$SLO_FILE" | awk '{print $2}')
111
+ ```
112
+
113
+ ### 3.2 Extrair `alert_thresholds.page` (fast) + `.ticket` (slow) do YAML
114
+
115
+ Phase 103 (OBS-20-02) — leitura dos dois blocos via awk com state machine. Cada bloco tem `lookahead`, `baseline`, `burn_rate_multiplier`. Defaults canônicos aplicados se ausentes (defensive default — ver fallback abaixo).
116
+
117
+ ```bash
118
+ # alert_thresholds.page (fast / page-tier)
119
+ FAST_LOOKAHEAD=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*page:/){p=1;next}else if(p && /^\s+lookahead:/){print $2;exit}else if(p && /^\s*ticket:/){exit}}' "$SLO_FILE")
120
+ FAST_BASELINE_YAML=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*page:/){p=1;next}else if(p && /^\s+baseline:/){print $2;exit}else if(p && /^\s*ticket:/){exit}}' "$SLO_FILE")
121
+ FAST_MULTIPLIER=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*page:/){p=1;next}else if(p && /^\s+burn_rate_multiplier:/){print $2;exit}else if(p && /^\s*ticket:/){exit}}' "$SLO_FILE")
122
+
123
+ # alert_thresholds.ticket (slow / ticket-tier)
124
+ SLOW_LOOKAHEAD=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*ticket:/){t=1;next}else if(t && /^\s+lookahead:/){print $2;exit}}' "$SLO_FILE")
125
+ SLOW_BASELINE_YAML=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*ticket:/){t=1;next}else if(t && /^\s+baseline:/){print $2;exit}}' "$SLO_FILE")
126
+ SLOW_MULTIPLIER=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*ticket:/){t=1;next}else if(t && /^\s+burn_rate_multiplier:/){print $2;exit}}' "$SLO_FILE")
127
+
128
+ # Defensive defaults — fator 4× canonical Google SRE values.
129
+ # Se um SLO YAML antigo / parcial não declarar alert_thresholds, aplicamos
130
+ # os defaults da skill burn-rate-alerting verbatim:
131
+ # page: 14.4× / lookahead 1h / baseline 5m
132
+ # ticket: 6× / lookahead 6h / baseline 30m
133
+ [ -z "$FAST_MULTIPLIER" ] && FAST_MULTIPLIER="14.4"
134
+ [ -z "$SLOW_MULTIPLIER" ] && SLOW_MULTIPLIER="6"
135
+ [ -z "$FAST_LOOKAHEAD" ] && FAST_LOOKAHEAD="1h"
136
+ [ -z "$SLOW_LOOKAHEAD" ] && SLOW_LOOKAHEAD="6h"
137
+ ```
138
+
139
+ ### 3.3 Carregar snapshots para AMBAS as janelas
140
+
141
+ Use a API `loadSnapshots()` (Phase 99) com duas chamadas — uma para fast (1h), uma para slow (6h). Inline node script:
142
+
143
+ ```bash
144
+ DUAL_SNAPS=$(node --input-type=module -e "
145
+ import { loadSnapshots } from './src/core/metrics.js';
146
+ const fast = await loadSnapshots(process.cwd(), $FAST_BASELINE_MS);
147
+ const slow = await loadSnapshots(process.cwd(), $SLOW_BASELINE_MS);
148
+ console.log(JSON.stringify({fast, slow, fastCount: fast.length, slowCount: slow.length}));
149
+ ")
150
+ FAST_COUNT=$(echo "$DUAL_SNAPS" | node -e "console.log(JSON.parse(require('fs').readFileSync(0,'utf8')).fastCount)")
151
+ SLOW_COUNT=$(echo "$DUAL_SNAPS" | node -e "console.log(JSON.parse(require('fs').readFileSync(0,'utf8')).slowCount)")
152
+ ```
153
+
154
+ **no_data conservative semantics:** se EITHER janela tem < 2 snapshots (availability) ou < 1 (latency), o `combined_status` final é `no_data` — preferimos não inventar números a falsamente reportar OK. Isso preserva o contrato "graceful no_data" da Phase 99.
155
+
156
+ ```bash
157
+ # A regra exata é aplicada dentro do node script de combinação (3.5),
158
+ # mas o early-out aqui evita trabalho desnecessário no caso comum.
159
+ if [ "$FAST_COUNT" -lt 2 ] && [ "$SLOW_COUNT" -lt 2 ]; then
160
+ echo "SLO $SLO_NAME: insufficient snapshots in BOTH windows (fast=$FAST_COUNT, slow=$SLOW_COUNT)"
161
+ echo "Generate data: invocações ao MCP tool 'metrics-snapshot' agora auto-persistem (Phase 102 OBS-20-01)."
162
+ COMBINED_STATUS="no_data"
163
+ continue
164
+ fi
165
+ ```
166
+
167
+ ### 3.4 Calcular SLI por tipo de SLO (fast E slow independentes)
168
+
169
+ **Availability (`type: event-based`):**
170
+
171
+ Inline node — primeiro vs último snapshot **dentro de cada janela**. Delta de counters dá good/bad events:
172
+
173
+ ```bash
174
+ DUAL_SLI=$(node --input-type=module -e "
175
+ import { loadSnapshots } from './src/core/metrics.js';
176
+ const fastSnaps = await loadSnapshots(process.cwd(), $FAST_BASELINE_MS);
177
+ const slowSnaps = await loadSnapshots(process.cwd(), $SLOW_BASELINE_MS);
178
+
179
+ function sliFromSnaps(snaps) {
180
+ if (snaps.length < 2) return {sli: null, errorRate: 0, good: 0, total: 0, error: 'no_data'};
181
+ const first = snaps[0];
182
+ const last = snaps[snaps.length - 1];
183
+ let goodFirst = 0, goodLast = 0, totalFirst = 0, totalLast = 0;
184
+ for (const [k,v] of Object.entries(first.counters)) {
185
+ if (k.endsWith(':ok')) goodFirst += v;
186
+ totalFirst += v;
187
+ }
188
+ for (const [k,v] of Object.entries(last.counters)) {
189
+ if (k.endsWith(':ok')) goodLast += v;
190
+ totalLast += v;
191
+ }
192
+ const good = goodLast - goodFirst;
193
+ const total = totalLast - totalFirst;
194
+ const sli = total > 0 ? good / total : null;
195
+ const errorRate = total > 0 ? (total - good) / total : 0;
196
+ return {sli, errorRate, good, total};
197
+ }
198
+
199
+ const fastSli = sliFromSnaps(fastSnaps);
200
+ const slowSli = sliFromSnaps(slowSnaps);
201
+ console.log(JSON.stringify({fast: fastSli, slow: slowSli}));
202
+ ")
203
+ ```
204
+
205
+ **Latency (`type: percentile`):**
206
+
207
+ Para latency, p95 do último snapshot em CADA janela. SLI = fração de samples NOT acima de target_ms.
208
+
209
+ ```bash
210
+ DUAL_SLI=$(node --input-type=module -e "
211
+ import { loadSnapshots } from './src/core/metrics.js';
212
+ const target = $TARGET_MS;
213
+ const fastSnaps = await loadSnapshots(process.cwd(), $FAST_BASELINE_MS);
214
+ const slowSnaps = await loadSnapshots(process.cwd(), $SLOW_BASELINE_MS);
215
+
216
+ function latencySli(snaps) {
217
+ if (snaps.length < 1) return {sli: null, errorRate: 0, totalSamples: 0, slowSamples: 0, error: 'no_data'};
218
+ const last = snaps[snaps.length - 1];
219
+ let totalSamples = 0, slowSamples = 0;
220
+ for (const lat of Object.values(last.latency)) {
221
+ totalSamples += lat.count;
222
+ if (lat.p95 > target) slowSamples += Math.round(lat.count * 0.05);
223
+ }
224
+ const sli = totalSamples > 0 ? 1 - (slowSamples / totalSamples) : null;
225
+ const errorRate = totalSamples > 0 ? slowSamples / totalSamples : 0;
226
+ return {sli, errorRate, totalSamples, slowSamples};
227
+ }
228
+
229
+ console.log(JSON.stringify({fast: latencySli(fastSnaps), slow: latencySli(slowSnaps)}));
230
+ ")
231
+ ```
232
+
233
+ ### 3.5 Calcular burn rate + status COMBINADO (dual-window)
234
+
235
+ Aplicar fórmula canônica + status enum dual-window (skill `burn-rate-alerting` — fator 4× canonical):
236
+
237
+ ```bash
238
+ DUAL_STATUS=$(node --input-type=module -e "
239
+ const dual = $DUAL_SLI;
240
+ const target = $TARGET_RATIO || (1 - 0.05); // latency: 1 - ratio_above_target (5%)
241
+ const fastMult = $FAST_MULTIPLIER;
242
+ const slowMult = $SLOW_MULTIPLIER;
243
+
244
+ function burnFromSli(sli, target) {
245
+ if (sli.error) return {burnRate: null, error: sli.error};
246
+ const slack = 1 - target;
247
+ const burnRate = slack > 0 ? sli.errorRate / slack : 0;
248
+ return {burnRate, errorRate: sli.errorRate};
249
+ }
250
+
251
+ // Combined status — canonical dual-window logic per skill burn-rate-alerting (fator 4×):
252
+ // PAGE = ambos críticos (fast ≥ 14.4 E slow ≥ 6) → page on-call AGORA
253
+ // TICKET = slow erosion sustained (slow ≥ 6, fast OK) → ticket de investigação
254
+ // WARN = fast spike isolado (fast ≥ 14.4 sozinho) — monitor, NÃO page (alarm flap risk)
255
+ // WARN = mild burn em qualquer janela (≥ 1.0×) — sustained drains budget no horizonte
256
+ // OK = ambos < 1.0× — saudável
257
+ // no_data = qualquer janela com snapshots insuficientes (conservative)
258
+ function combinedStatus(fastBurn, fastMult, slowBurn, slowMult) {
259
+ if (fastBurn === null || slowBurn === null) return 'no_data';
260
+ const fastTriggered = fastBurn >= fastMult;
261
+ const slowTriggered = slowBurn >= slowMult;
262
+ if (fastTriggered && slowTriggered) return 'PAGE';
263
+ if (slowTriggered) return 'TICKET';
264
+ if (fastTriggered) return 'WARN';
265
+ if (fastBurn >= 1.0 || slowBurn >= 1.0) return 'WARN';
266
+ return 'OK';
267
+ }
268
+
269
+ const fastBurn = burnFromSli(dual.fast, target);
270
+ const slowBurn = burnFromSli(dual.slow, target);
271
+ const combined = combinedStatus(fastBurn.burnRate, fastMult, slowBurn.burnRate, slowMult);
272
+
273
+ let action;
274
+ switch (combined) {
275
+ case 'PAGE':
276
+ action = 'Page on-call NOW — invoke /investigar-producao';
277
+ break;
278
+ case 'TICKET':
279
+ action = 'Open ticket — slow erosion sustained, investigate before budget exhausted';
280
+ break;
281
+ case 'WARN':
282
+ action = 'Monitor — burn rate ≥1× either window, sustained drains budget';
283
+ break;
284
+ case 'no_data':
285
+ action = '— (await more snapshots; auto-persist via metrics-snapshot tool — Phase 102)';
286
+ break;
287
+ default:
288
+ action = '—';
289
+ }
290
+
291
+ // ETA exhaustion (predictive). Use slow window (more stable signal for budget extrapolation).
292
+ // For burn=0 (no errors), ETA is ∞.
293
+ const slowBurnRate = slowBurn.burnRate;
294
+ const baselineHours = $SLOW_BASELINE_MS / 3600000;
295
+ const eta = (slowBurnRate !== null && slowBurnRate > 0)
296
+ ? (1 / slowBurnRate) * 30 * 24 / baselineHours
297
+ : null;
298
+ const etaStr = eta === null ? '—' : (eta < 24 ? eta.toFixed(1) + 'h' : (eta/24).toFixed(1) + 'd');
299
+
300
+ const fastBurnFmt = fastBurn.burnRate === null ? '—' : fastBurn.burnRate.toFixed(2) + '×';
301
+ const slowBurnFmt = slowBurn.burnRate === null ? '—' : slowBurn.burnRate.toFixed(2) + '×';
302
+
303
+ // fast_status / slow_status são derivados em isolation (informativo na tabela);
304
+ // combined_status é o veredito operacional.
305
+ function singleStatus(burn, mult) {
306
+ if (burn === null) return 'no_data';
307
+ if (burn >= mult) return mult === parseFloat('$FAST_MULTIPLIER') ? 'PAGE-FAST' : 'TICKET-SLOW';
308
+ if (burn >= 1.0) return 'WARN';
309
+ return 'OK';
310
+ }
311
+ const fastStatus = singleStatus(fastBurn.burnRate, fastMult);
312
+ const slowStatus = singleStatus(slowBurn.burnRate, slowMult);
313
+
314
+ console.log(JSON.stringify({
315
+ fast_burn: fastBurnFmt,
316
+ slow_burn: slowBurnFmt,
317
+ fast_status: fastStatus,
318
+ slow_status: slowStatus,
319
+ combined_status: combined,
320
+ action: action,
321
+ eta: etaStr,
322
+ }));
323
+ ")
324
+ ```
325
+
326
+ ### 3.6 Acumular linha da tabela (colunas dual-window)
327
+
328
+ ```bash
329
+ SLO_ROWS+=("| $SLO_NAME | ${TARGET_RATIO:-${TARGET_MS}ms p$PERCENTILE} | ${FAST_BURN} | ${SLOW_BURN} | **${COMBINED_STATUS}** | $ETA | $ACTION |")
330
+ ```
331
+
332
+ ## 4. Renderizar tabela mestra (Phase 103 dual-window)
333
+
334
+ ```text
335
+ ═══════════════════════════════════════════════════════════
336
+ framework ▸ BURN-RATE-STATUS (dual-window) ▸ {timestamp}
337
+ fast_baseline=$FAST_BASELINE slow_baseline=$SLOW_BASELINE
338
+ fast_multiplier=$FAST_MULTIPLIER (page) slow_multiplier=$SLOW_MULTIPLIER (ticket)
339
+ snapshots fast=$FAST_COUNT slow=$SLOW_COUNT
340
+ ═══════════════════════════════════════════════════════════
341
+
342
+ | SLO | Target | Fast (1h) | Slow (6h) | Combined | ETA exhaustão | Ação |
343
+ |---|---|---|---|---|---|---|
344
+ {$SLO_ROWS}
345
+ ```
346
+
347
+ **Exemplo concreto:**
348
+
349
+ ```markdown
350
+ | SLO | Target | Fast (1h) | Slow (6h) | Combined | ETA exhaustão | Ação |
351
+ |---|---|---|---|---|---|---|
352
+ | mcp-tool-availability | 99.5% | 0.42× OK | 0.18× OK | **OK** | — | — |
353
+ | mcp-tool-latency | 200ms p95 | 16.0× PAGE-FAST | 8.5× TICKET-SLOW | **PAGE** | 4.2h | Page on-call NOW — invoke /investigar-producao |
354
+ ```
355
+
356
+ ## 5. Sugerir próximas ações
357
+
358
+ ```bash
359
+ # Contar status counts
360
+ PAGE_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*PAGE\*\*" || echo 0)
361
+ TICKET_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*TICKET\*\*" || echo 0)
362
+ WARN_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*WARN\*\*" || echo 0)
363
+ NO_DATA_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*no_data\*\*" || echo 0)
364
+ ```
365
+
366
+ Output:
367
+ ```text
368
+ ## Próximas ações
369
+
370
+ {Se PAGE_COUNT > 0:}
371
+ ⚠ {PAGE_COUNT} SLO(s) em PAGE (ambas janelas críticas) — invocar /investigar-producao "<slo_name> dual-window burn"
372
+
373
+ {Se TICKET_COUNT > 0:}
374
+ ☐ {TICKET_COUNT} SLO(s) em TICKET (slow erosion sustained) — abrir issue, investigar antes do budget esgotar
375
+
376
+ {Se WARN_COUNT > 0:}
377
+ ⓘ {WARN_COUNT} SLO(s) em WARN — fast spike isolado ou mild burn ≥ 1× (não page; monitor)
378
+
379
+ {Se NO_DATA_COUNT > 0:}
380
+ ⊘ {NO_DATA_COUNT} SLO(s) sem dados em pelo menos uma janela — Phase 102 auto-persist deve popular .planning/metrics/snapshots/ automaticamente em chamadas ao MCP tool 'metrics-snapshot'
381
+ ```
382
+
383
+ ## 6. Modo `/loop` (idempotência)
384
+
385
+ Se chamado dentro de `/loop`, comportamento idempotente:
386
+ - Snapshot fresh em cada invocação (não acumular state).
387
+ - Output curto se `combined_status` não mudou (apenas linha-resumo; sem repetir tabela completa).
388
+ - Acionar AskUserQuestion APENAS quando algum SLO transiciona OK → WARN/TICKET/PAGE no `combined_status`.
389
+
390
+ </process>
391
+
392
+ <success_criteria>
393
+ - [ ] $ARGUMENTS parseados (SLO opcional + flags --fast-baseline/--slow-baseline/--format)
394
+ - [ ] SLOs descobertos via glob `.planning/slos/*.yml` (FIX Phase 99: extension `.yml`, não `.md`)
395
+ - [ ] alert_thresholds.page (fast) + alert_thresholds.ticket (slow) extraídos via awk com state machine
396
+ - [ ] Defensive defaults aplicados (14.4 / 6 / 1h / 6h) se YAML omitir blocos
397
+ - [ ] Snapshots carregados via `loadSnapshots()` em DUAS chamadas (fast + slow)
398
+ - [ ] SLI calculado por tipo (event-based ratio para availability, percentile para latency) em CADA janela
399
+ - [ ] Burn rate calculado pela fórmula `error_rate / (1 - target)` (skill [`burn-rate-alerting`](../skills/burn-rate-alerting/SKILL.md)) para fast E slow independentemente
400
+ - [ ] Status combinado dual-window: **PAGE** (ambos críticos) / **TICKET** (slow only) / **WARN** (fast only OR mild ≥ 1×) / **OK** (ambos < 1×) / **no_data** (qualquer janela com snapshots insuficientes)
401
+ - [ ] Tabela markdown agregada com colunas Fast (1h) / Slow (6h) / Combined explícitas
402
+ - [ ] ETA exhaustão computada (predictive forecast — usa slow window por estabilidade)
403
+ - [ ] Sugestões de próximas ações contextualizadas pelo combined_status
404
+ - [ ] Idempotente em /loop (sem acúmulo de state; transição combined_status dispara AskUserQuestion)
405
+ - [ ] no_data graceful — Phase 102 auto-persist mencionado como solução
406
+ - [ ] Skill burn-rate-alerting cross-referenced no objective + inline no node script + inline na tabela de fallback (3 hits ≥ 2 mínimo)
407
+ - [ ] Fator 4× explícito no contexto (canonical Google SRE)
408
+ </success_criteria>