· ENPT-BR
Grok Build para Alembic · Evidência e seleção

Reconhecimento: mapeie antes de importar

Veja o Grok Build como várias superfícies — não um bloco único — e localize a única lacuna que o Alembic deve assumir.

Fonte primária
README fixado do Grok Build

Commit upstream fixado: b189869b7755d2b482969acf6c92da3ecfeffd36

A camada Simples se sustenta sozinha; abra Técnico para contratos exatos e edge cases.
Ao final, você consegue
  • Nomear as superfícies upstream sem reduzi-las a “o CLI”.
  • Localizar os donos existentes no Alembic para runtime, tools, workspaces e UI.
  • Defender a costura de provider como a menor adoção útil.
1

A grande ideia

O Grok Build reúne interface terminal, modo headless para scripts, superfície ACP para editores, runtime de agente, ferramentas, workspace e sessões persistentes. O Alembic já é dono da maior parte desses trabalhos. O movimento útil não é portar o produto; é conectar o CLI publicado pela costura estreita de provider da Factory.

Pense como… Trate o repositório upstream como um aeroporto completo. O Alembic não precisa de uma segunda pista, torre e esteira de bagagem; precisa de um portão compatível onde um voo Grok possa acoplar. A analogia quebra porque a propriedade do software é imposta por interfaces e testes, não por concreto e placas.

O README fixado nomeia quatro crates Rust principais: pager/TUI, runtime shell e entry points, tools e workspace/checkpoints. Também documenta três superfícies de consumo: TUI, headless e ACP. Essa decomposição é a unidade de análise; cada superfície recebe seu próprio veredito de sobreposição.

O código upstream de primeira parte usa Apache-2.0, enquanto o repositório identifica separadamente ports vendorizados e avisos. O adapter TypeScript da fase um é clean-room contra contratos observáveis do CLI; não copia Rust nem cria um segundo dono de runtime.

Evidência: README fixado do Grok Build

TUIheadlessACPpagershell Seguro: um adapter é dono do comando + tradução de eventos.
Veja o Grok Build como várias superfícies — não um bloco único — e localize a única lacuna que o Alembic deve assumir.
2

Compare as fronteiras

Seguro
Seguro: um adapter é dono do comando + tradução de eventos.
Arriscado
Arriscado: copiar runtime Rust, tools e engine de sessão para o Alembic.
SuperfícieUpstreamAlembicVeredito
TUI / cockpitProduto terminal em tela cheiaTUI, web e cockpit já existemALREADY
Agent runtime / toolsLoop Rust mais tools internasHarness, VM, Factory e adaptersALREADY
Headless CLI protocolFronteira estável de processo externoFaltava provider Grok de primeira classeADOPT

O código upstream de primeira parte usa Apache-2.0, enquanto o repositório identifica separadamente ports vendorizados e avisos. O adapter TypeScript da fase um é clean-room contra contratos observáveis do CLI; não copia Rust nem cria um segundo dono de runtime.

3

Código e comandos reais

/tmp/alembic-grok-build-20260716 @ b189869…
git -C /tmp/alembic-grok-build-20260716 rev-parse HEAD
# b189869b7755d2b482969acf6c92da3ecfeffd36

rg -n "Repository layout|Headless|ACP|License" \
  /tmp/alembic-grok-build-20260716/README.md
Como chegar lá
sed -n '1,150p' /tmp/alembic-grok-build-20260716/README.md

Evidência: RESOURCES.md

4

Atlas visual

entradaprovaTUI
Trace a fronteira: TUI.
superfíciecosturadonoheadless
Localize o dono: headless.
afirmaçãosem gateevidênciana fronteiravsACP
Compare afirmação e evidência: ACP.
aprenderexecutarverificarpager
Leia a sequência: pager.
completo?sim / nãoshell
Encontre o gate de decisão: shell.
entradaprovaferramentas
Trace a fronteira: ferramentas.
superfíciecosturadonoworkspace
Localize o dono: workspace.
afirmaçãosem gateevidênciana fronteiravssessões
Compare afirmação e evidência: sessões.
aprenderexecutarverificarhooks
Leia a sequência: hooks.
completo?sim / nãoplugins
Encontre o gate de decisão: plugins.
entradaprovasandbox
Trace a fronteira: sandbox.
superfíciecosturadonoworktrees
Localize o dono: worktrees.
afirmaçãosem gateevidênciana fronteiravsFactory
Compare afirmação e evidência: Factory.
aprenderexecutarverificarAgentProvider
Leia a sequência: AgentProvider.
5

Prática e feedback

Preveja antes de revelar

Se o Alembic já possui orchestration e tools, qual superfície upstream tem a menor sobreposição?

O protocolo de processo headless: conecta um agente real sem importar seus componentes internos.

Cartões de recuperação

Cartões de recuperaçãoPagerClique ou pressione Enter para virar
PagerA superfície TUI em tela cheia.
Cartões de recuperaçãoShellClique ou pressione Enter para virar
ShellRuntime mais entry points headless/stdio.
Cartões de recuperaçãoProvider seamClique ou pressione Enter para virar
Provider seamA fronteira de tradução comando/evento da Factory.
Cartões de recuperaçãoClean-roomClique ou pressione Enter para virar
Clean-roomImplementar comportamento documentado sem copiar Rust.
O Grok Build reúne interface terminal, modo headless para scripts, superfície ACP para editores, runtime de agente, ferramentas, workspace e sessões persistentes. O Alembic já é dono da maior parte desses trabalhos. O movimento útil não é portar o produto; é conectar o CLI publicado pela costura estreita de provider da Factory.
O README fixado nomeia quatro crates Rust principais: pager/TUI, runtime shell e entry points, tools e workspace/checkpoints. Também documenta três superfícies de consumo: TUI, headless e ACP. Essa decomposição é a unidade de análise; cada superfície recebe seu próprio veredito de sobreposição.

Explore a superfície upstream

Escolha uma superfície e leia o veredito de propriedade.

Veredito

Resumo em quatro slides

Pager

A superfície TUI em tela cheia.

Shell

Runtime mais entry points headless/stdio.

Provider seam

A fronteira de tradução comando/evento da Factory.

Clean-room

Implementar comportamento documentado sem copiar Rust.

Teste seu modelo

Revisão espaçada

Qual é a unidade de adoção da fase um?

O provider preenche uma costura verificada. Runtime e TUI já têm donos no Alembic.
6

Fontes e próximo movimento

README fixado do Grok Buildb189869b7755 · readmeGuia fixado do modo headlessb189869b7755 · headlessGuia fixado de gerenciamento de sessõesb189869b7755 · sessionsRESOURCES.mdGrok Build para Alembic
Peça ao seu professor para desafiar um veredito, repetir um evento ou revisar uma unidade futura com a mesma disciplina de prova.