Step 11 · Observability · Observability · Cockpit web, TUI e doctor ENPT
Alembic Complete Visual Course

Cockpit web, TUI e doctor

Observe e verifique execuções e ambiente Alembic sem sair do terminal ou navegador.

Read the plain version, or open the technical layer on any section.
1

Veja o que está acontecendo


@alembic/web serve um dashboard autocontido que lista runs, transmite events.jsonl via SSE e permite aprovar tarefas T4 estacionadas. @alembic/tui desenha a mesma informação como swimlanes ASCII no terminal.

alembic doctor sonda o ambiente local: Node, pnpm, git, CLI Higgsfield, diretório de dados e gateway LLM. Ele reporta OK / WARN / FAIL para cada check.

Pense assim… o cockpit de um avião: instrumentos dizem velocidade, altitude e avisos; você decide se continua.

Under the hood

O cockpit web faz polling de arquivos JSONL append-only e usa server-sent events para atualizações ao vivo. A TUI usa funções de render puras para ser testável sem terminal. doctor usa which e comandos de versão para binários, fs.access para o diretório de dados e uma sonda HTTP para o gateway.

2

In one picture


alembic doctor Web cockpit TUI Run directory: index.json, events.jsonl, t4-parked.jsonl, approvals.jsonl Both cockpit and TUI read the same append-only journals
Doctor sonda pré-requisitos; cockpit e TUI observam o mesmo diretório de run.
3

In the code


# verifique ambiente
alembic doctor --json

# assista uma execução no terminal
alembic tui <run-id>

# stream eventos recentes
alembic tail <run-id> --follow

Implementation notes

alembic tailevents.jsonl e imprime linhas no formato swimlane. Com --follow faz polling a cada 500 ms. A TUI usa raw terminal mode para que keystrokes simples como q saiam imediatamente.

4

Try it


Execute um comando Forge-scope curto, depois rode alembic tui <run-id> e alembic tail <run-id> em terminais separados.

Compare: Quando você preferiria a TUI em vez do cockpit web?
5

Quick check


Qual comando reporta saúde do ambiente como JSON?