Mapa de readiness 0.8.0 — agents-lab / pi-stack
Última revisão: 2026-06-11
Status: mapa público de readiness
Escopo: agents-lab, @aretw0/pi-stack, GitHub Pages e CI
Leitura executiva
O estado atual para 0.8.0 é:
- Base publicada: CI e GitHub Pages estão verdes em
mainna revisão desta página. - Base local: desenvolvimento usa
pnpm, devcontainer,lab pi, gates locais epi:devcom capacidades frias por padrão. - Base de produto:
@aretw0/pi-stackdeve continuarstrict-curatedpor default; capacidades caras ficam opt-in. - Fronteira protegida: publish npm, provider routing, remote/offload, GitHub Actions como executor e automação forte exigem intenção explícita do operador.
- Release readiness:
agent-run-driver-gateestá verde;board-release-clearestá verde;target-version-readyestá verde para0.8.0. A cadeiarelease:evidence:refreshrecompõe canaries locais, readiness, draft preview, cut preview auditado, artifact audit e final gate;release:evidence:statusresume a evidência já materializada sem executar canários ou ações protegidas. O estado esperado édecision=pass,finalGateDecision=pass,blockers=[]eprotectedActionsAllowed=false. O relatório versionado também expõeagentRunDrivers.providerProtectedBoardPlanEvidencecom plano protected-board provider fanout em modoready-for-operator-decision, três workers preparados edispatchAllowed=false. - Roadmap canônico: direção macro fica em ROADMAP.md; este arquivo registra readiness e evidência selecionada.
Pronto
| Área | Estado | Evidência |
|---|---|---|
| CI local e GitHub Actions | verde | pnpm run ci:local:parity; workflow CI passa em main |
| GitHub Pages | publicado | pages-build-deployment passou; fonte main /docs |
| README público | enxuto | README reduzido e alinhado ao perfil strict-curated |
| Licença | alinhada | LICENSE raiz e pacotes @aretw0/* usam MIT |
| Discurso público | auditado | repo:discourse:audit cobre README, guias, primitives, architecture e research promovido |
| Instalação padrão | conservadora | npx @aretw0/pi-stack instala perfil strict-curated |
| Fronteira de engine | protegida | engine:boundary:audit mantém core portable e Pi em surfaces/adapters |
| Driver agent-run agnóstico | verde | test:agent-run:drivers cobre driver-step, pi-driver, payload emitido, canários read-only/mutation e suite agregada de canários |
| Board de release | verde para 0.8.0 | release:readiness:v0.8.0 reporta board-release-clear está verde, sem P0 aberto, sem tarefas em progresso/bloqueadas e releaseBlockers: none; release:evidence:refresh materializa .artifacts/release-cut/v0.8.0-evidence-refresh.json, .artifacts/release-cut/v0.8.0-preview.json, .artifacts/release-cut/v0.8.0-artifact-audit.json e .artifacts/release-cut/v0.8.0-final-gate.json com finalGateDecision=pass antes de qualquer ação protegida; as influências TASK-BUD-480, TASK-BUD-521 e TASK-BUD-676 seguem parked/protected para pesquisa futura, com plano agnóstico em agentRunDrivers.providerProtectedBoardPlanEvidence (source=protected-board, workerCount=3, selectedTaskIds, dispatchAllowed=false, processStartAllowed=false, batchExecutionAllowed=false). O JSON versionado (schemaVersion=1) expõe generatedAt, decision, markdown, versions, workflows, gates, worktree, agentRunDrivers.canarySuiteHeadMatches, agentRunDrivers.providerProtectedBoardPlanEvidence, userSurface, checklist[*].kind, releaseBlockers, operatorDecisions, nextActionCode, nextActions, automationPermissions, releaseDecisionReady, board.*Rows e board.evidenceCandidateRows para agentes/automação local |
Preparado, mas ainda protegido
| Área | Por que importa | Próximo passo seguro |
|---|---|---|
| Publish npm | afeta usuários e provenance | release por changesets/tag semver; Publish só em condição de release |
| GitHub Packages | muda registry, visibilidade e rota de consumo | manter not-configured-opt-in até decisão explícita e smoke dedicado |
| GitHub Actions como executor | muda fronteira local-first | manter report-only até existir task protegida explícita |
| Provider routing | pode gastar quota e trocar modelo real | canários bounded, rollback e decisão do operador |
| Monitor runtime amplo | pode adicionar ruído/custo | calibrar com evidência e regressões antes de ampliar default |
| Delegação/long-run | pode acelerar trabalho, mas aumenta superfície de falha | promover por packets report-only e gates de rollback |
| Versionamento 0.8.0 | transforma readiness em release real | bump/tag só após decisão explícita e revisão de release notes/changelog |
Parked para médio/longo prazo
| Item | Motivo de park |
|---|---|
Influências externas adicionais (hermes-agent, sandcastle, claude-mem) |
agora têm canários local-safe versionados; a decisão restante é assimilação/park explícito, não pesquisa aberta automática |
| Colônias antigas | reconciliadas como telemetria histórica; não devem voltar como blockers sem candidate novo e evidência verificável |
| Remote/offload/GitHub Actions como executor | protegido; só depois de maturidade local e contrato de cancelamento/rollback claro |
| Publish/release 0.8.0 | readiness local está verde; tag, draft, workflow dispatch e publish continuam protegidos por revisão/approval explícito |
| Ajustes agressivos de provider routing | dependem de canário, quota, rollback e decisão do operador |
Próximas Fatias
| Fatia | Validação |
|---|---|
| Revisar release notes/changelog | confirmar mudanças desde v0.7.0, riscos e rollback antes de tag |
| Revisar protected-board provider plan | usar agentRunDrivers.providerProtectedBoardPlanEvidence para ver o plano de workers protegidos sem executar provider real; qualquer execução continua exigindo approval estruturado |
| Revisar draft/cut preview | preferir release:evidence:refresh; ele gera draft preview, final gate e prompts protegidos. release-draft-preview e release-cut-preview continuam disponíveis para inspeção focal e devem ficar ready-for-operator-review com tagAllowed=false, publishAllowed=false, workflowDispatchAllowed=false e processStartAllowed=false |
| Revalidar instalação limpa | release:package:smoke, docs:package:check, install/smoke em ambiente limpo; GitHub Packages deve continuar opt-in se não aprovado |
| Manter acoplamentos de engine sob controle | engine:boundary:audit, sem dependências Pi em core portable |
Critério de parada
Parar e pedir decisão quando:
- a fatia exigir mutação protegida;
- a evidência apontar conflito real de produto;
- a validação falhar e a correção não for local-safe óbvia;
- o próximo passo aumentaria autonomia operacional em vez de apenas preparar readiness report-only;
- a próxima ação for bump/tag/publish/release.
Critérios mínimos para 0.8.0
- instala e opera com defaults curados;
- mantém board/handoff/rollback auditáveis;
- reduz ruído e custo de monitores;
- não surpreende o usuário com CI, providers, publish, remote ou automação forte;
- prepara delegação/long-run apenas com gates report-only e rollback definido;
- incorpora influências externas apenas como padrões pequenos e mensuráveis;
- mantém colônias antigas fora do caminho de release quando não há candidate verificável;
- funciona bem em contextos variados de usuário sem depender do laboratório.
Regra Editorial
Este mapa deve conter apenas estado verificável e próximos passos acionáveis. Snapshots históricos, IDs de board antigos e falhas já resolvidas devem ficar em research não promovido ou no board, não na página pública.