rollout-v2.3.md — httui

httui

acme payments rollout-v2.3.md

local

staging

prod

Search blocks, vars, schema… ⌘K

RMT

main

Run all

Files

runbooks

payments

rollout-v2.3.md

rollback.md

incident-2026-03-19.md

onboarding

data-fixes.md

scratch

ad-hoc.md

shared / team

Connections

pg · payments@staging 18ms

pg · payments@prod PROD 41ms

mongo · audit 22ms

redis · cache 88ms

API · payments 142ms

Variables — staging

BASE_URL https://api.staging.acme.dev

TENANT_ID tnt_8f2a91

ADMIN_TOKEN ••••••••••••mB9k

PG_DSN postgres://app@db-staging…

rollout-v2.3.md

rollback.md

ad-hoc.md

runbooks / payments / rollout-v2.3.md · edited há 4 min by rafael 10 blocks · 4 ran · 1 pending · auto-capture

runbooks / payments / rollout-v2.3.md draft · 4 unsaved edits

Rollout — Payments v2.3 → staging

R rafael · edited há 4 min · 10 blocks · main +3 ~1 · last run 14:23 — all green

Deploy do novo provider de cartão (stripe_v2) para o tenant acme-payments em staging. Antes de promover para prod, validar que a config foi propagada, que payments_route não tem rotas órfãs, e que a latência do stream de captura fica abaixo de 800ms.

PRÉ-FLIGHT — 4 itens

config do tenant atualizada em tenants.config

0 registros órfãos em payments_route

subscrever stream WS por 30s

rollout_pct ≤ 25 antes de prod

Markdown que executa.

Cada bloco é executável: requisições HTTP e SQL (PostgreSQL, MySQL, SQLite). Capturas de um bloco viram variáveis do próximo, encadeando todo o fluxo dentro de um único .md.

— Capturas encadeadas — reutilize um valor de uma resposta como {{login.body.token}} no próximo bloco.
— Asserções — uma seção # expect: com linhas como time < 500ms falha o runbook em regressão.
— Variáveis e segredos referenciados por chave. O valor nunca vai pro git.

1. Verify shadow traffic

Confirm payments-router is mirroring 5% of requests in staging.

POST {{api}}/v2/payments ● 201 · 218ms

{

"id": "pay_01H8XK...",

"provider": "stripe_v2",

"shadow": true

}

captured: payment_id = pay_01H8XK…

SQL pg · payments@staging ● 1 row · 14ms

SELECT status, provider FROM payments

WHERE id = {{payment_id}}

Nativo de banco

Schema explorer ao lado do editor.

Conecta PostgreSQL, MySQL e SQLite. Navega tabelas com foreign keys, índices e row count. EXPLAIN ANALYZE em árvore mostra onde sua query gasta tempo.

— Multi-banco em um único runbook — consulte PostgreSQL e depois MySQL sem trocar de janela.
— Mutation guard — SQL destrutivo (UPDATE / DELETE) avisa antes de rodar.
— EXPLAIN ANALYZE em formato árvore, com seq scans lentos destacados.

SCHEMA · payments

▾ public 4 tables

▸ payments 84.2k

▾ payments_route 4.3k

id uuid

provider_key text

tenant_id uuid

active bool

created_at timestamptz

▸ payment_provider 12

▸ tenants 284

▾ analytics 1 table

▸ events 12.4M

Result · 3 rows · 14ms EXPLAIN

#	id	provider_key	tenant	active	created_at
1	rt_4f2a	stripe_v2	acme	true	2026-04-24 14:08
2	rt_7ce1	stripe_v2	acme	true	2026-04-24 13:51
3	rt_b08d	adyen_v1	acme	false	2026-04-23 09:12

EXPLAIN ANALYZE

↳ Index Scan using idx_route_provider · 0.42..18.7 · 3 rows · 0.21ms

Nativo de git · diffável

Versionado. Revisável. Compartilhável.

Runbooks são .md no seu repo. Revisão por pull request igual qualquer código. Diff entre execuções mostra o que mudou na resposta.

— Code review de runbooks no GitHub ou GitLab.
— Diff entre runs — compare a execução de hoje com a de ontem em dois cliques.
— Compartilhe a URL do repo — HTTPS, SSH ou web — pra qualquer runbook em um clique.

main · 3 changes · runbooks/payments/rollout-v2.3.md +18 −4

@@ -42,7 +42,11 @@ ## 3. Verify latency

- ```http GET {{api}}/v2/health

- expect: status === 200

- ```

+ ```http POST {{api}}/v2/payments

+ Authorization: Bearer {{user_token}}

+ Content-Type: application/json

+ { "amount": 1200, "currency": "BRL" }

+ expect: status === 201

+ expect: time < 500ms

+ capture: payment_id = $.id

+ ```

httui-lang · LSP

Use em qualquer lugar.

O formato dos blocos .httui é uma linguagem de verdade com grammar tree-sitter e servidor LSP. Runbooks ganham autocomplete, hover e go-to-definition pra referências — dentro de qualquer editor que fale LSP.

VS CodeNeovimZedHelixIntelliJSublime

Embutido no app desktop · binário standalone pra terminais · publique a grammar em qualquer registry de pacotes.

smoke-test.httui

# Smoke test
http alias=login timeout=5000
POST https://api.example.com/auth/login
Content-Type: application/json

{ "user": "alice", "pwd": "{{SECRET}}" }

http alias=me
GET https://api.example.com/me
Authorization: Bearer {{login.body.token}}

# expect:
#   status == 200
#   time < 500ms

Instalar

De graça pra sempre. Seu pra fazer fork.

Uma linha. Sem cadastro, sem cartão, sem telemetria.

~/projects · zsh

$ curl -fsSL https://httui.com/install.sh | sh

✓ baixando a última release…

✓ httui instalado → /Applications/httui.app

$ open /Applications/httui.app

Homebrew

brew tap httuicom/httui

brew install --cask httui

▣ GitHub Releases

.dmg · .msi · .exe

.deb · .rpm · .AppImage

{ } Pelo código

make install-deps

cargo tauri build

Builds GUI pra macOS · Linux · Windows em GitHub releases. O build de macOS não é assinado — o script de install e o cask do Homebrew limpam a quarentena do Gatekeeper; o auto-update interno mantém atualizado.

Debugue suas APIs e bancos em um único arquivo markdown.

Rollout — Payments v2.3 → staging

Markdown que executa.

Schema explorer ao lado do editor.

Versionado. Revisável. Compartilhável.

Use em qualquer lugar.

De graça pra sempre. Seu pra fazer fork.

Pare de debugar em cinco abas.
Comece a escrever runbooks no lugar.

Debugue suas APIs e bancos em um único arquivo markdown.

Rollout — Payments v2.3 → staging

Markdown que executa.

Schema explorer ao lado do editor.

Versionado. Revisável. Compartilhável.

Use em qualquer lugar.

Pare de debugar em cinco abas. Comece a escrever runbooks no lugar.

Pare de debugar em cinco abas.
Comece a escrever runbooks no lugar.