Step 15 · End-to-end · End-to-end · Comandos CLI e fluxos end-to-end ENPT
Alembic Complete Visual Course

Comandos CLI e fluxos end-to-end

Juntando todos os pacotes através da superfície de comando humana.

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

A superfície de comando

A CLI alembic agrupa comandos por propósito:

  • Plano e escopo: plan, forge
  • Dados: ingest, distill, marketing
  • Executar: run, runs, propose, approve, reject, replay
  • Observar: status, serve, cockpit, tui, tail, doctor
  • Publicar: docs, publish gate do Forge

A maioria dos comandos aceita --offline, --data-dir e --json.

Pense assim… o painel de controle de uma fábrica: cada botão mapeia para um subsistema, mas a mesma maquinaria subjacente os executa todos.

Under the hood

apps/cli conecta cada pacote. runDistill usa @alembic/harness e @alembic/etl. runIngest usa @alembic/ingestion. runGoalPlan usa @alembic/forge, @alembic/vm, @alembic/swarm, @alembic/coda e @alembic/loop-engineering. Comandos retornam objetos Result tipados e renderizam texto ou JSON.

2

In one picture

alembic CLI plan, forge docs, doctor distill, ingest marketing run, runs propose, approve, reject, replay serve, cockpit, tui, tail status
Comandos CLI agrupados por propósito: plan, data, execute, observe, publish.
3

In the code

# ciclo offline completo
alembic doctor
alembic plan "Add a /health endpoint"
alembic forge "Add a /health endpoint" --offline
alembic run --goal GOAL.md --plan alembic.plan.ts --yes --offline
alembic docs ./docs ./site

Implementation notes

A CLI usa util.parseArgs do Node e Zod para parsing de argumentos. Expande ~ para $HOME, respeita ALEMBIC_OFFLINE e retorna códigos de saída não-zero em falha. Cada comando é testado contra o registro offline para que a suite de testes permaneça hermética.

4

Try it

Escolha uma tarefa pequena e execute o ciclo offline completo: doctor → plan → forge → run. Verifique se o diretório de run contém todos os artefatos esperados.

Map: Qual comando CLI exercita a maioria dos pacotes em uma única invocação?
5

Quick check

Qual flag força execução hermética offline?