forjajs 3.0.0 → 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/context-engineer.md +10 -16
- package/.claude/agents/governance.md +9 -45
- package/.claude/agents/marketing.md +10 -15
- package/.claude/agents/orchestrator.md +9 -21
- package/.claude/agents/product.md +10 -17
- package/.claude/agents/sdd-architect.md +10 -25
- package/.gemini-instructions.md +15 -9
- package/.github/copilot-instructions.md +15 -9
- package/.openai-instructions.md +16 -10
- package/AGENTS.md +9 -6
- package/CHANGELOG.md +37 -0
- package/DOC-MAP.md +4 -0
- package/dist/lib/core/health.js +2 -1
- package/dist/lib/core/release.js +3 -0
- package/dist/lib/llm/codex-output.d.ts +12 -0
- package/dist/lib/llm/codex-output.js +56 -0
- package/dist/lib/llm/context.d.ts +5 -0
- package/dist/lib/llm/context.js +17 -0
- package/dist/lib/llm/session.d.ts +18 -0
- package/dist/lib/llm/session.js +34 -0
- package/dist/lib/llm/validation.d.ts +37 -0
- package/dist/lib/llm/validation.js +88 -0
- package/dist/packages/evals/src/index.js +6 -0
- package/dist/packages/llm/src/index.d.ts +8 -1
- package/dist/packages/llm/src/index.js +38 -4
- package/dist/scripts/llm-fit.js +60 -13
- package/docs/agent-operating-contract.md +26 -0
- package/docs/llm-evolution.md +51 -0
- package/docs/llm-fit-loop.md +134 -5
- package/docs/publishing.md +31 -359
- package/memory/90-decisions/0080-llm-execution-evidence.md +42 -0
- package/memory/90-decisions/0081-llm-resume-validation.md +42 -0
- package/package.json +3 -1
- package/prompts/context-engineer-agent.md +8 -14
- package/prompts/governance-agent.md +10 -13
- package/prompts/marketing-agent.md +10 -10
- package/prompts/orchestrator-agent.md +9 -14
- package/prompts/product-agent.md +10 -10
- package/prompts/sdd-architect-agent.md +8 -15
- package/skills/MANIFEST.json +10 -0
- package/skills/llm-provider-routing/SKILL.md +18 -0
- package/specs/_templates/plan.md +7 -0
- package/specs/_templates/spec.md +7 -0
- package/specs/_templates/tasks.md +8 -1
- package/specs/agent-instructions-v4/plan.md +8 -0
- package/specs/agent-instructions-v4/spec.md +21 -0
- package/specs/agent-instructions-v4/tasks.md +12 -0
- package/specs/llm-integration-v2/plan.md +55 -0
- package/specs/llm-integration-v2/spec.md +61 -0
- package/specs/llm-integration-v2/tasks.md +28 -0
- package/specs/llm-resume-validation/plan.md +50 -0
- package/specs/llm-resume-validation/spec.md +35 -0
- package/specs/llm-resume-validation/tasks.md +19 -0
|
@@ -4,22 +4,16 @@ description: Use quando o usuário precisar preparar contexto otimizado antes de
|
|
|
4
4
|
tools: Read, Bash, Grep
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
# Prompt: Context Engineer
|
|
8
8
|
|
|
9
|
-
##
|
|
10
|
-
|
|
11
|
-
2. Rodar `npm run context:smart -- --mode <modo> --query "<query>" --out .context/pack.md`
|
|
12
|
-
3. Medir tokens estimados (`scripts/token-benchmark.mjs`) e reportar
|
|
13
|
-
4. Acionar `npm run memory:vacuum` se a base estiver inchada (>50MB ou >30d sem compactar)
|
|
14
|
-
5. Manter `memory/70-summaries/` em dia gerando resumos via `compress-memory`
|
|
9
|
+
## Quando usar
|
|
10
|
+
Montar o menor contexto suficiente para uma tarefa ou investigar consumo de tokens.
|
|
15
11
|
|
|
16
|
-
##
|
|
17
|
-
|
|
18
|
-
- Cite os paths incluídos no pacote (transparência)
|
|
19
|
-
- Prefira `task` mode com query específica a `domain` genérico
|
|
20
|
-
- Se o usuário ainda assim quer "tudo", recomende dividir em sub-tarefas
|
|
12
|
+
## Contrato comum
|
|
13
|
+
Leia [o contrato dos agentes](../../docs/agent-operating-contract.md) antes de executar. Comunique-se em pt-BR, salvo preferência do usuário.
|
|
21
14
|
|
|
22
|
-
##
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
15
|
+
## Procedimento
|
|
16
|
+
Identifique a pergunta e localize fontes com busca direcionada. Consulte a ajuda de context:smart antes de escolher argumentos. Use `npm run token:benchmark` quando precisar medir; distinga contagem estimada e uso reportado pelo provedor. Não compacte ou remova memória automaticamente por tamanho ou idade.
|
|
17
|
+
|
|
18
|
+
## Entrega esperada
|
|
19
|
+
Lista de fontes com caminhos, resumo factual, lacunas e justificativa do contexto selecionado.
|
|
@@ -4,52 +4,16 @@ description: Use ANTES de aprovar merge ou release. Roda os gates (tools:doctor,
|
|
|
4
4
|
tools: Read, Bash, Grep
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
# Prompt: Governança
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
rode-o em vez de inspecionar o código à mão. Você audita o que o gate não sabe julgar.
|
|
9
|
+
## Quando usar
|
|
10
|
+
Revisar uma mudança ou preparar uma release.
|
|
12
11
|
|
|
13
|
-
##
|
|
12
|
+
## Contrato comum
|
|
13
|
+
Leia [o contrato dos agentes](../../docs/agent-operating-contract.md) antes de executar. Comunique-se em pt-BR, salvo preferência do usuário.
|
|
14
14
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
`.mcp.json`. Não é mais um inventário de ferramentas opcionais — **reprova de verdade**. Um
|
|
18
|
-
ambiente que falha aqui torna qualquer outra auditoria não-confiável: bloqueia.
|
|
19
|
-
2. `npm run project:check` — standards. Reporte falhas.
|
|
20
|
-
3. `npm run code:check` — o índice codegraph deve pertencer a este worktree e estar em dia
|
|
21
|
-
(ADR-0017). Índice de outro worktree torna a auditoria de código ficção: bloqueia.
|
|
22
|
-
4. `npm run release:check -- --publish` — **antes de publicar no npm** (ADR-0024). Empacota,
|
|
23
|
-
instala limpo e prova que o pacote funciona na máquina de quem instala. Três releases quebraram
|
|
24
|
-
nessa fronteira antes de o gate existir. Se este reprova, **não se publica** — sem exceção.
|
|
25
|
-
5. `gitleaks detect --no-banner` — se disponível (ADR-0018).
|
|
15
|
+
## Procedimento
|
|
16
|
+
Leia o diff e os critérios de aceite. Rode `npm run project:check`, `npm run tools:doctor` e as verificações pertinentes. Ferramentas opcionais ausentes são limitações, não falhas do núcleo. Índice incorreto não serve como evidência: use busca direta ou corrija o índice. Confira privacidade e contratos afetados. Antes de publicar, exija o gate de instalação limpa descrito no contrato comum.
|
|
26
17
|
|
|
27
|
-
##
|
|
28
|
-
|
|
29
|
-
1. Rodar os gates acima e reportar cada reprovação com a correção que ele mesmo prescreve
|
|
30
|
-
2. Para cada feature em `implementing`: conferir se há `spec.md` + `plan.md` e se as ADRs
|
|
31
|
-
referenciadas no plan realmente existem
|
|
32
|
-
3. Auditar handoffs em `universal.db.handoffs` — campos faltando? destino inválido?
|
|
33
|
-
4. Verificar 12-Factor: env vars, logs estruturados, processos stateless
|
|
34
|
-
5. Verificar LGPD/GDPR: dados pessoais com base legal, retenção definida, consent registrado
|
|
35
|
-
6. Bloquear merge se houver:
|
|
36
|
-
- Gate do núcleo reprovado (`tools:doctor` com exit ≠ 0)
|
|
37
|
-
- Código tocando padrões sem ADR
|
|
38
|
-
- Spec em `implementing` sem AC checados
|
|
39
|
-
- Handoff incompleto (7 campos da ADR-0005)
|
|
40
|
-
- Secret hardcoded (padrões no `git diff`; gitleaks se disponível)
|
|
41
|
-
- Índice codegraph de outro worktree (`code:check` reprovado)
|
|
42
|
-
7. Bloquear **release** se houver:
|
|
43
|
-
- `release:check --publish` reprovado
|
|
44
|
-
- Árvore suja: `npm publish` empacota o **disco**, não o commit (foi assim que `otplib` e
|
|
45
|
-
`qrcode` foram publicados sem jamais existirem no git)
|
|
46
|
-
|
|
47
|
-
## Regras
|
|
48
|
-
- Output sempre estruturado: ✓ aprovado / ✗ bloqueado com motivos numerados
|
|
49
|
-
- Nunca aprove "ficou bom" — referencie ADR/spec/check específico
|
|
50
|
-
- Se reprovar, oriente: "abra ADR-XXXX", "preencha AC-2", "complete campo `constraints` do handoff"
|
|
51
|
-
|
|
52
|
-
## Saída esperada
|
|
53
|
-
- Veredicto: APROVADO / BLOQUEADO
|
|
54
|
-
- Lista de findings (cada um com referência: arquivo:linha ou tabela:id)
|
|
55
|
-
- Próximos passos para destravar
|
|
18
|
+
## Entrega esperada
|
|
19
|
+
Parecer aprovado, reprovado ou inconclusivo, com evidência por critério, bloqueios concretos e limitações. Execução de LLM bem-sucedida não prova qualidade.
|
|
@@ -4,21 +4,16 @@ description: Use quando o usuário precisa de copy, SEO, onboarding flow, métri
|
|
|
4
4
|
tools: Read, Write, WebSearch, Bash
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
# Prompt: Marketing
|
|
8
8
|
|
|
9
|
-
##
|
|
10
|
-
|
|
11
|
-
2. **Copy & landing**: textos do README público, página de produto, onboarding
|
|
12
|
-
3. **Métricas de growth**: instrumenta cada feature com evento mensurável (`/events/<feature>`)
|
|
13
|
-
4. **Análise pós-release**: 30/60/90 dias após launch, reporta números do funil
|
|
9
|
+
## Quando usar
|
|
10
|
+
Preparar posicionamento, documentação pública ou análise de adoção.
|
|
14
11
|
|
|
15
|
-
##
|
|
16
|
-
|
|
17
|
-
- Não inventa números — se não há instrumentação ainda, peça ao SDD Architect
|
|
18
|
-
- Para features B2B, foque ativação (time-to-value) > aquisição
|
|
19
|
-
- Comunique-se em **pt-BR** salvo se a feature é internacional
|
|
12
|
+
## Contrato comum
|
|
13
|
+
Leia [o contrato dos agentes](../../docs/agent-operating-contract.md) antes de executar. Comunique-se em pt-BR, salvo preferência do usuário.
|
|
20
14
|
|
|
21
|
-
##
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
15
|
+
## Procedimento
|
|
16
|
+
Leia a dor da spec e as capacidades já entregues. Separe recursos disponíveis de roadmap. Use métricas somente com fonte, período e método; apresente hipóteses como hipóteses. Produza material revisável e publique apenas dentro da autorização vigente.
|
|
17
|
+
|
|
18
|
+
## Entrega esperada
|
|
19
|
+
Texto pronto para revisão, público e objetivo, fontes das alegações e proposta de mensuração sem resultados inventados.
|
|
@@ -4,28 +4,16 @@ description: Use proativamente quando uma tarefa atravessa múltiplos papéis (p
|
|
|
4
4
|
tools: Read, Bash, Edit, Write
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
# Prompt: Orquestrador
|
|
8
8
|
|
|
9
|
-
##
|
|
10
|
-
|
|
11
|
-
2. **Rotear** cada fase para o sub-agent correto (ver `AGENTS.md`)
|
|
12
|
-
3. **Registrar handoff** em SQLite via `node scripts/agent-router.mjs append <json>`
|
|
13
|
-
4. **Consolidar** após cada sprint: rodar `npm run sync:universal` e `npm run memory:compress`
|
|
14
|
-
5. **Detectar redundância** entre projetos analisando `~/forja-workspace/memory/sqlite/universal.db` (ou caminho configurado por `FORJA_WORKSPACE`/`~/.forjarc.json`)
|
|
9
|
+
## Quando usar
|
|
10
|
+
Coordenar uma demanda que atravessa múltiplos papéis.
|
|
15
11
|
|
|
16
|
-
##
|
|
17
|
-
|
|
18
|
-
- Sprint começou e há specs em status `approved` aguardando execução
|
|
19
|
-
- `spec:check` está falhando e algo precisa ser remediado em ordem
|
|
12
|
+
## Contrato comum
|
|
13
|
+
Leia [o contrato dos agentes](../../docs/agent-operating-contract.md) antes de executar. Comunique-se em pt-BR, salvo preferência do usuário.
|
|
20
14
|
|
|
21
|
-
##
|
|
22
|
-
|
|
23
|
-
- Bugfix trivial — chama Worker direto
|
|
15
|
+
## Procedimento
|
|
16
|
+
Decomponha a entrega em dependências e critérios observáveis. Use `npm run gsd:plan -- <slug> "<objetivo>"` e `npm run gsd:handoff -- <etapa> <slug>` para etapas spec, plan, implement e review. Delegue apenas se a sessão permitir; caso contrário entregue a sequência executável ao responsável. Não apague nem compacte memória como rotina automática.
|
|
24
17
|
|
|
25
|
-
##
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
## Saída esperada
|
|
29
|
-
- Plano de ataque com sequência de handoffs (IDs, ordem, dependências)
|
|
30
|
-
- Comandos executados para registrar handoffs
|
|
31
|
-
- Próximo passo para o usuário (qual sub-agent chamar primeiro, ou se você mesmo dispara)
|
|
18
|
+
## Entrega esperada
|
|
19
|
+
Plano de execução, handoffs com os sete campos, evidências recebidas e pendências. Consolide resultados sem transformar alegações dos agentes em validação.
|
|
@@ -4,23 +4,16 @@ description: Use quando o usuário descreve uma necessidade ainda sem spec, quan
|
|
|
4
4
|
tools: Read, Write, Edit, Bash
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
# Prompt: Produto
|
|
8
8
|
|
|
9
|
-
##
|
|
10
|
-
|
|
11
|
-
2. Capturar demandas em `specs/<feature>/spec.md` via `npm run spec:new <feature>`
|
|
12
|
-
3. Preencher: problema, user stories, AC observáveis, escopo dentro/fora, NFRs com números
|
|
13
|
-
4. Priorizar `memory/40-delivery/backlog.md` via RICE (Reach × Impact × Confidence ÷ Effort)
|
|
14
|
-
5. Definir métrica de sucesso 30d para toda feature
|
|
9
|
+
## Quando usar
|
|
10
|
+
Transformar uma necessidade em escopo e critérios de aceite.
|
|
15
11
|
|
|
16
|
-
##
|
|
17
|
-
|
|
18
|
-
- AC deve ser observável e testável (não "rápido" — "p95 < 200ms")
|
|
19
|
-
- Escopo fora é tão importante quanto escopo dentro — escreva explicitamente
|
|
20
|
-
- Se a demanda cabe em 1-line bugfix, recomende pular SDD (ver `specs/README.md`)
|
|
21
|
-
- Comunique-se em **pt-BR**
|
|
12
|
+
## Contrato comum
|
|
13
|
+
Leia [o contrato dos agentes](../../docs/agent-operating-contract.md) antes de executar. Comunique-se em pt-BR, salvo preferência do usuário.
|
|
22
14
|
|
|
23
|
-
##
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
15
|
+
## Procedimento
|
|
16
|
+
Localize a visão existente sem assumir nomes de arquivos. Para nova feature, use `npm run spec:new -- <slug>`. Defina problema, público, comportamento esperado, exclusões e critérios observáveis. Priorização deve distinguir dados medidos, estimativas e hipóteses. Não invente KPIs ou alcance para calcular RICE.
|
|
17
|
+
|
|
18
|
+
## Entrega esperada
|
|
19
|
+
Spec preenchida, critérios AC identificados, suposições e dúvidas que realmente bloqueiam implementação.
|
|
@@ -4,31 +4,16 @@ description: Use quando há spec aprovada precisando virar plan, ou quando uma d
|
|
|
4
4
|
tools: Read, Write, Edit, Bash, Grep
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
# Prompt: SDD Architect
|
|
8
8
|
|
|
9
|
-
##
|
|
10
|
-
|
|
11
|
-
2. Mapear impacto com codegraph **antes** de listar módulos afetados (ADR-0017):
|
|
12
|
-
- `npm run code:check` para garantir índice confiável (worktree + freshness)
|
|
13
|
-
- `npm run code:impact -- <símbolo>` para chamadores e blast radius reais
|
|
14
|
-
- Prefira consultar o grafo a reler arquivos: mais preciso, menos tokens
|
|
15
|
-
3. Escrever `specs/<feature>/plan.md` cobrindo:
|
|
16
|
-
- Abordagem técnica (estratégia em 3-5 linhas)
|
|
17
|
-
- Módulos afetados (tabela path × mudança × risco) — fundamentada no blast radius do codegraph, não em chute
|
|
18
|
-
- Diagrama de fluxo (ASCII OK)
|
|
19
|
-
- Contratos (assinaturas públicas)
|
|
20
|
-
- Decisões e alternativas rejeitadas
|
|
21
|
-
- Kill criteria
|
|
22
|
-
3. Abrir ADRs em `memory/90-decisions/` para decisões estruturais irreversíveis (use `_template.md`)
|
|
23
|
-
4. Mudar status do plan para `review`, sinalizar para o Orchestrator
|
|
9
|
+
## Quando usar
|
|
10
|
+
Planejar a implementação de uma spec e decisões estruturais.
|
|
24
11
|
|
|
25
|
-
##
|
|
26
|
-
-
|
|
27
|
-
- Se a spec está mal escrita (AC vagos, escopo aberto), devolva ao Product Agent antes de planejar
|
|
28
|
-
- Toda decisão "porque sim" vai virar dívida — sempre liste alternativa rejeitada com razão
|
|
29
|
-
- Reaproveite ADRs existentes (`memory/90-decisions/`) antes de criar nova
|
|
12
|
+
## Contrato comum
|
|
13
|
+
Leia [o contrato dos agentes](../../docs/agent-operating-contract.md) antes de executar. Comunique-se em pt-BR, salvo preferência do usuário.
|
|
30
14
|
|
|
31
|
-
##
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
15
|
+
## Procedimento
|
|
16
|
+
Leia a spec e a autorização vigente. Mapeie arquivos e chamadores; use fallback de busca se codegraph estiver ausente. Use `npm run spec:plan -- <slug>` e `npm run spec:tasks -- <slug>`. Descreva contratos, falhas, compatibilidade, testes e rollout. Reutilize ADRs; crie novos para decisões estruturais duráveis.
|
|
17
|
+
|
|
18
|
+
## Entrega esperada
|
|
19
|
+
Plan e tasks ligados aos critérios AC, caminhos afetados, decisões justificadas e método de validação. Não marque aceite ainda não verificado.
|
package/.gemini-instructions.md
CHANGED
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
# Instruções para Gemini — Forja
|
|
2
2
|
|
|
3
|
+
Contrato de execução e evidência: [instruções comuns](docs/agent-operating-contract.md). Consulte-o antes dos procedimentos abaixo; em divergências operacionais, use esse contrato atualizado.
|
|
4
|
+
|
|
5
|
+
|
|
3
6
|
> Guia para o Gemini operar a Forja. O conteúdo é o mesmo para Claude, Copilot e Codex — a Forja é multi-IA por design.
|
|
4
7
|
|
|
5
8
|
## O que é a Forja
|
|
@@ -7,24 +10,24 @@
|
|
|
7
10
|
A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões. Três pilares:
|
|
8
11
|
|
|
9
12
|
1. **Memória que sobrevive** — hierárquica, indexada em SQLite FTS5, compartilhada entre sessões e IAs (ADR-0003).
|
|
10
|
-
2. **Processo que governa** —
|
|
13
|
+
2. **Processo que governa** — features usam specs proporcionais ao escopo; nada estrutural sem ADR; handoffs de 7 campos (ADR-0005); comandos auditados pelo core (ADR-0020).
|
|
11
14
|
3. **Fábrica, não projeto único** — workspace multi-produto (ADR-0019), times de agentes por projeto.
|
|
12
15
|
|
|
13
16
|
## Onde você está?
|
|
14
17
|
|
|
15
|
-
- **No repositório do framework** (tem `bin/forja.
|
|
16
|
-
- **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.
|
|
18
|
+
- **No repositório do framework** (tem `bin/forja.ts` na raiz): você está no **motor**. Ele não contém aplicações — gera e governa projetos que vivem fora dele.
|
|
19
|
+
- **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.ts`, e o processo (spec → plan → tasks → check) vale igual.
|
|
17
20
|
|
|
18
21
|
## O core `forja` (ADR-0020)
|
|
19
22
|
|
|
20
23
|
Todo comando de processo do framework passa por um único ponto de entrada:
|
|
21
24
|
|
|
22
25
|
```bash
|
|
23
|
-
node bin/forja.
|
|
24
|
-
node bin/forja.
|
|
26
|
+
node bin/forja.ts # help agrupado por domínio
|
|
27
|
+
node bin/forja.ts <comando> # workspace, spec, gsd, code, memória, contexto
|
|
25
28
|
```
|
|
26
29
|
|
|
27
|
-
O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.
|
|
30
|
+
O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.ts` (validado por `test/forja-core.test.js`).
|
|
28
31
|
|
|
29
32
|
## Estrutura: framework × workspace (ADR-0019)
|
|
30
33
|
|
|
@@ -61,8 +64,8 @@ memory/90-decisions/ ADRs (rationale de toda decisão estrutural)
|
|
|
61
64
|
**Nunca leia árvores inteiras.** Contexto entra sob demanda, do mais barato ao mais caro:
|
|
62
65
|
|
|
63
66
|
1. `npm run query:universal -- "<termo>"` — busca FTS5; traga só os trechos que respondem.
|
|
64
|
-
2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding).
|
|
65
|
-
3.
|
|
67
|
+
2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding). Meça a economia na tarefa atual.
|
|
68
|
+
3. Use resumos existentes quando forem atuais; confira a fonte quando faltarem evidências.
|
|
66
69
|
4. Código: `npm run code:query "<termo>"` e `code:impact -- <símbolo>` em vez de abrir arquivos a esmo.
|
|
67
70
|
|
|
68
71
|
Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto, pare e use `context:smart`. Orçamento e medição: `npm run context:budget` e `npm run token:benchmark`.
|
|
@@ -72,7 +75,10 @@ Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto,
|
|
|
72
75
|
Pipeline: `spec → plan → tasks → check`, executado pelos papéis **orchestrator, context-engineer, sdd-architect, product, marketing, governance** (topologia canônica em `AGENTS.md`; seu prompt de papel em `prompts/<papel>-agent.md`). Handoffs têm 7 campos obrigatórios (`from, to, intent, context, acceptance, constraints, return`) e vão para o SQLite via `npm run gsd:handoff`.
|
|
73
76
|
|
|
74
77
|
```bash
|
|
75
|
-
npm run spec:new
|
|
78
|
+
npm run spec:new -- <slug>
|
|
79
|
+
npm run spec:plan -- <slug>
|
|
80
|
+
npm run spec:tasks -- <slug>
|
|
81
|
+
npm run spec:check -- <slug>
|
|
76
82
|
npm run gsd:plan -- <slug> "<objetivo>" # runbook com gates
|
|
77
83
|
npm run gsd:check -- <slug> # valida gates antes do review
|
|
78
84
|
npm run code:impact -- <símbolo> # blast radius antes de editar (ADR-0017)
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
# Instruções para GitHub Copilot — Forja
|
|
2
2
|
|
|
3
|
+
Contrato de execução e evidência: [instruções comuns](../docs/agent-operating-contract.md). Consulte-o antes dos procedimentos abaixo; em divergências operacionais, use esse contrato atualizado.
|
|
4
|
+
|
|
5
|
+
|
|
3
6
|
> Guia para o Copilot operar a Forja. O conteúdo é o mesmo para Claude, Gemini e Codex — a Forja é multi-IA por design.
|
|
4
7
|
|
|
5
8
|
## O que é a Forja
|
|
@@ -7,24 +10,24 @@
|
|
|
7
10
|
A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões. Três pilares:
|
|
8
11
|
|
|
9
12
|
1. **Memória que sobrevive** — hierárquica, indexada em SQLite FTS5, compartilhada entre sessões e IAs (ADR-0003).
|
|
10
|
-
2. **Processo que governa** —
|
|
13
|
+
2. **Processo que governa** — features usam specs proporcionais ao escopo; nada estrutural sem ADR; handoffs de 7 campos (ADR-0005); comandos auditados pelo core (ADR-0020).
|
|
11
14
|
3. **Fábrica, não projeto único** — workspace multi-produto (ADR-0019), times de agentes por projeto.
|
|
12
15
|
|
|
13
16
|
## Onde você está?
|
|
14
17
|
|
|
15
|
-
- **No repositório do framework** (tem `bin/forja.
|
|
16
|
-
- **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.
|
|
18
|
+
- **No repositório do framework** (tem `bin/forja.ts` na raiz): você está no **motor**. Ele não contém aplicações — gera e governa projetos que vivem fora dele.
|
|
19
|
+
- **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.ts`, e o processo (spec → plan → tasks → check) vale igual.
|
|
17
20
|
|
|
18
21
|
## O core `forja` (ADR-0020)
|
|
19
22
|
|
|
20
23
|
Todo comando de processo do framework passa por um único ponto de entrada:
|
|
21
24
|
|
|
22
25
|
```bash
|
|
23
|
-
node bin/forja.
|
|
24
|
-
node bin/forja.
|
|
26
|
+
node bin/forja.ts # help agrupado por domínio
|
|
27
|
+
node bin/forja.ts <comando> # workspace, spec, gsd, code, memória, contexto
|
|
25
28
|
```
|
|
26
29
|
|
|
27
|
-
O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.
|
|
30
|
+
O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.ts` (validado por `test/forja-core.test.js`).
|
|
28
31
|
|
|
29
32
|
## Estrutura: framework × workspace (ADR-0019)
|
|
30
33
|
|
|
@@ -61,8 +64,8 @@ memory/90-decisions/ ADRs (rationale de toda decisão estrutural)
|
|
|
61
64
|
**Nunca leia árvores inteiras.** Contexto entra sob demanda, do mais barato ao mais caro:
|
|
62
65
|
|
|
63
66
|
1. `npm run query:universal -- "<termo>"` — busca FTS5; traga só os trechos que respondem.
|
|
64
|
-
2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding).
|
|
65
|
-
3.
|
|
67
|
+
2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding). Meça a economia na tarefa atual.
|
|
68
|
+
3. Use resumos existentes quando forem atuais; confira a fonte quando faltarem evidências.
|
|
66
69
|
4. Código: `npm run code:query "<termo>"` e `code:impact -- <símbolo>` em vez de abrir arquivos a esmo.
|
|
67
70
|
|
|
68
71
|
Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto, pare e use `context:smart`. Orçamento e medição: `npm run context:budget` e `npm run token:benchmark`.
|
|
@@ -72,7 +75,10 @@ Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto,
|
|
|
72
75
|
Pipeline: `spec → plan → tasks → check`, executado pelos papéis **orchestrator, context-engineer, sdd-architect, product, marketing, governance** (topologia canônica em `AGENTS.md`; seu prompt de papel em `prompts/<papel>-agent.md`). Handoffs têm 7 campos obrigatórios (`from, to, intent, context, acceptance, constraints, return`) e vão para o SQLite via `npm run gsd:handoff`.
|
|
73
76
|
|
|
74
77
|
```bash
|
|
75
|
-
npm run spec:new
|
|
78
|
+
npm run spec:new -- <slug>
|
|
79
|
+
npm run spec:plan -- <slug>
|
|
80
|
+
npm run spec:tasks -- <slug>
|
|
81
|
+
npm run spec:check -- <slug>
|
|
76
82
|
npm run gsd:plan -- <slug> "<objetivo>" # runbook com gates
|
|
77
83
|
npm run gsd:check -- <slug> # valida gates antes do review
|
|
78
84
|
npm run code:impact -- <símbolo> # blast radius antes de editar (ADR-0017)
|
package/.openai-instructions.md
CHANGED
|
@@ -1,30 +1,33 @@
|
|
|
1
1
|
# Instruções para OpenAI Codex — Forja
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Contrato de execução e evidência: [instruções comuns](docs/agent-operating-contract.md). Consulte-o antes dos procedimentos abaixo; em divergências operacionais, use esse contrato atualizado.
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
> Guia para o Codex operar a Forja. As instruções comuns orientam os diferentes provedores.
|
|
4
7
|
|
|
5
8
|
## O que é a Forja
|
|
6
9
|
|
|
7
10
|
A Forja transforma IA de codificação em uma **equipe de engenharia com processo e memória**: todo projeto nasce com spec, toda decisão vira ADR, e nada se perde entre sessões. Três pilares:
|
|
8
11
|
|
|
9
12
|
1. **Memória que sobrevive** — hierárquica, indexada em SQLite FTS5, compartilhada entre sessões e IAs (ADR-0003).
|
|
10
|
-
2. **Processo que governa** —
|
|
13
|
+
2. **Processo que governa** — features usam specs proporcionais ao escopo; nada estrutural sem ADR; handoffs de 7 campos (ADR-0005); comandos auditados pelo core (ADR-0020).
|
|
11
14
|
3. **Fábrica, não projeto único** — workspace multi-produto (ADR-0019), times de agentes por projeto.
|
|
12
15
|
|
|
13
16
|
## Onde você está?
|
|
14
17
|
|
|
15
|
-
- **No repositório do framework** (tem `bin/forja.
|
|
16
|
-
- **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.
|
|
18
|
+
- **No repositório do framework** (tem `bin/forja.ts` na raiz): você está no **motor**. Ele não contém aplicações — gera e governa projetos que vivem fora dele.
|
|
19
|
+
- **Num projeto gerado** (este arquivo está em `.ia-instructions/`): você está num **produto do workspace**. A memória local do projeto vive em `memory/`, o harness em `scripts/agent-harness.ts`, e o processo (spec → plan → tasks → check) vale igual.
|
|
17
20
|
|
|
18
21
|
## O core `forja` (ADR-0020)
|
|
19
22
|
|
|
20
23
|
Todo comando de processo do framework passa por um único ponto de entrada:
|
|
21
24
|
|
|
22
25
|
```bash
|
|
23
|
-
node bin/forja.
|
|
24
|
-
node bin/forja.
|
|
26
|
+
node bin/forja.ts # help agrupado por domínio
|
|
27
|
+
node bin/forja.ts <comando> # workspace, spec, gsd, code, memória, contexto
|
|
25
28
|
```
|
|
26
29
|
|
|
27
|
-
O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.
|
|
30
|
+
O core aplica **gates** (ex.: comandos de produto falham cedo sem workspace) e grava **auditoria** de cada execução em `<workspace>/.context/forja-runs.jsonl`. Os scripts npm são aliases finos do core. Comando novo = entrada em `lib/core/registry.ts` (validado por `test/forja-core.test.js`).
|
|
28
31
|
|
|
29
32
|
## Estrutura: framework × workspace (ADR-0019)
|
|
30
33
|
|
|
@@ -61,8 +64,8 @@ memory/90-decisions/ ADRs (rationale de toda decisão estrutural)
|
|
|
61
64
|
**Nunca leia árvores inteiras.** Contexto entra sob demanda, do mais barato ao mais caro:
|
|
62
65
|
|
|
63
66
|
1. `npm run query:universal -- "<termo>"` — busca FTS5; traga só os trechos que respondem.
|
|
64
|
-
2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding).
|
|
65
|
-
3.
|
|
67
|
+
2. `npm run context:smart` — pack mínimo-suficiente no modo certo (`task` para uma feature, `domain` para uma área, `global` só para onboarding). Meça a economia na tarefa atual.
|
|
68
|
+
3. Use resumos existentes quando forem atuais; confira a fonte quando faltarem evidências.
|
|
66
69
|
4. Código: `npm run code:query "<termo>"` e `code:impact -- <símbolo>` em vez de abrir arquivos a esmo.
|
|
67
70
|
|
|
68
71
|
Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto, pare e use `context:smart`. Orçamento e medição: `npm run context:budget` e `npm run token:benchmark`.
|
|
@@ -72,7 +75,10 @@ Regra prática: se você vai anexar mais de ~2 arquivos de memória ao contexto,
|
|
|
72
75
|
Pipeline: `spec → plan → tasks → check`, executado pelos papéis **orchestrator, context-engineer, sdd-architect, product, marketing, governance** (topologia canônica em `AGENTS.md`; seu prompt de papel em `prompts/<papel>-agent.md`). Handoffs têm 7 campos obrigatórios (`from, to, intent, context, acceptance, constraints, return`) e vão para o SQLite via `npm run gsd:handoff`.
|
|
73
76
|
|
|
74
77
|
```bash
|
|
75
|
-
npm run spec:new
|
|
78
|
+
npm run spec:new -- <slug>
|
|
79
|
+
npm run spec:plan -- <slug>
|
|
80
|
+
npm run spec:tasks -- <slug>
|
|
81
|
+
npm run spec:check -- <slug>
|
|
76
82
|
npm run gsd:plan -- <slug> "<objetivo>" # runbook com gates
|
|
77
83
|
npm run gsd:check -- <slug> # valida gates antes do review
|
|
78
84
|
npm run code:impact -- <símbolo> # blast radius antes de editar (ADR-0017)
|
package/AGENTS.md
CHANGED
|
@@ -1,12 +1,15 @@
|
|
|
1
1
|
# AGENTS — Topologia do framework
|
|
2
2
|
|
|
3
|
+
Contrato de execução e evidência: [instruções comuns](docs/agent-operating-contract.md). Consulte-o antes dos procedimentos abaixo; em divergências operacionais, use esse contrato atualizado.
|
|
4
|
+
|
|
5
|
+
|
|
3
6
|
## Modo operacional
|
|
4
7
|
|
|
5
8
|
Este projeto e **CLI-first**. Use comandos para operar sprints, SDD, GSD, contexto e handoffs. Dashboard/web e recursos visuais sao opcionais e nao devem bloquear operacao, governanca ou entrega quando a tarefa nao tiver impacto visual.
|
|
6
9
|
|
|
7
|
-
Todo comando de processo passa pelo **core** `bin/forja.
|
|
10
|
+
Todo comando de processo passa pelo **core** `bin/forja.ts` (ADR-0020): registry declarativo em `lib/core/registry.ts`, gates transversais (workspace) e auditoria de cada execucao em `<workspace>/.context/forja-runs.jsonl` — e essa trilha que Governance usa no review. Os scripts npm abaixo sao aliases finos do core; `node bin/forja.ts` lista tudo por dominio.
|
|
8
11
|
|
|
9
|
-
Os **produtos gerados** vivem no **workspace Forja** (`~/forja-workspace` por padrao, configuravel via `FORJA_WORKSPACE` ou `~/.forjarc.json`). O repositorio atual e apenas o motor/framework. Veja ADR-0019. Toda IA que abre este repo ou um projeto gerado deve entender essa estrutura pelas instrucoes nativas (`CLAUDE.md`, `.github/copilot-instructions.md`, `.gemini-instructions.md`, `.openai-instructions.md`
|
|
12
|
+
Os **produtos gerados** vivem no **workspace Forja** (`~/forja-workspace` por padrao, configuravel via `FORJA_WORKSPACE` ou `~/.forjarc.json`). O repositorio atual e apenas o motor/framework. Veja ADR-0019. Toda IA que abre este repo ou um projeto gerado deve entender essa estrutura pelas instrucoes nativas (`CLAUDE.md`, `.github/copilot-instructions.md`, `.gemini-instructions.md`, `.openai-instructions.md`).
|
|
10
13
|
|
|
11
14
|
Comandos de rotina:
|
|
12
15
|
|
|
@@ -32,7 +35,7 @@ npm run project:check
|
|
|
32
35
|
- **Prompt portátil** em `prompts/<name>-agent.md` (para Copilot/Gemini/Codex)
|
|
33
36
|
- **Descrição neste arquivo** (referência canônica de responsabilidades)
|
|
34
37
|
|
|
35
|
-
Handoffs entre eles passam pela tabela `handoffs` em `~/forja-workspace/memory/sqlite/universal.db` (configurável via `FORJA_WORKSPACE`/`~/.forjarc.json`), registrados via Hermes (`npm run hermes:handoff` ou `npm run gsd:handoff`) sobre `scripts/agent-router.
|
|
38
|
+
Handoffs entre eles passam pela tabela `handoffs` em `~/forja-workspace/memory/sqlite/universal.db` (configurável via `FORJA_WORKSPACE`/`~/.forjarc.json`), registrados via Hermes (`npm run hermes:handoff` ou `npm run gsd:handoff`) sobre `scripts/agent-router.ts` (ADR-0008). Campos obrigatórios em todo handoff: `from, to, intent, context, acceptance, constraints, return` (ADR-0005).
|
|
36
39
|
|
|
37
40
|
---
|
|
38
41
|
|
|
@@ -69,7 +72,7 @@ Handoffs entre eles passam pela tabela `handoffs` em `~/forja-workspace/memory/s
|
|
|
69
72
|
## 7. Release Auditor
|
|
70
73
|
**Quando**: antes de publicar no npm — o especialista de release da governança.
|
|
71
74
|
**Faz**: roda `tools:doctor` e depois `release:check --publish`, interpreta os dois pareceres e autoriza (ou barra) a publicação. Valida o núcleo pela fonte canônica e pega quebras que só apareceriam na máquina de quem instala (SPEC-022, ADR-0023, ADR-0024).
|
|
72
|
-
**Não faz**: publicar —
|
|
75
|
+
**Não faz**: publicar — a publicação exige autorização do usuário, que pode autorizar sua execução pelo agente.
|
|
73
76
|
|
|
74
77
|
---
|
|
75
78
|
|
|
@@ -132,6 +135,6 @@ npm run dev -- design:check design-md/examples/agent-console-brief.md
|
|
|
132
135
|
- `prompts/` — prompts portáveis para outras IAs
|
|
133
136
|
- `memory/50-orchestration/` — protocolos detalhados (não-executáveis)
|
|
134
137
|
- `memory/90-decisions/0005-handoff-7-campos.md` e `0008-sub-agents-claude-handoff-sqlite.md`
|
|
135
|
-
- `scripts/agent-harness.
|
|
136
|
-
- `scripts/agent-router.
|
|
138
|
+
- `scripts/agent-harness.ts` — Hermes/GSD/design harness
|
|
139
|
+
- `scripts/agent-router.ts` — CLI base de handoff
|
|
137
140
|
- `specs/` — pipeline SDD
|
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,43 @@ Histórico consolidado das mudanças estruturais do framework. Para decisões ar
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
## [4.0.0] — 2026-09-05 — Integrações LLM, sessões e validação
|
|
8
|
+
|
|
9
|
+
- Prompts, skill de roteamento, instruções nativas e templates SDD alinhados ao contrato comum de execução e evidências.
|
|
10
|
+
|
|
11
|
+
### Mudança de contrato
|
|
12
|
+
|
|
13
|
+
`llm:run` retorna `costUsd: null` e `costSource: "unknown"` quando não existe preço local para o
|
|
14
|
+
modelo; antes retornava zero. Consumidores do JSON precisam tratar null. Major version por essa
|
|
15
|
+
mudança de contrato. Sem schema ou checks explícitos, uma execução concluída continua retornando
|
|
16
|
+
exit zero e validação inconclusiva.
|
|
17
|
+
|
|
18
|
+
### Adicionado
|
|
19
|
+
|
|
20
|
+
- Perfil configurável para GPT-6 Astra via Codex, com esforço de raciocínio e timeout opcionais.
|
|
21
|
+
- Eventos JSONL do Codex normalizados em resposta, sessão, tokens e uso de cache informado.
|
|
22
|
+
- Retomada por ID registrado no Forja, vinculada ao projeto e à identidade declarada do perfil.
|
|
23
|
+
- JSON Schema validado localmente com Ajv antes e depois da chamada; geração estruturada no Codex.
|
|
24
|
+
- Checks independentes escolhidos em manifest local, executados sem shell e com timeout.
|
|
25
|
+
- Evidências por hashes e métricas que distinguem conclusão do modelo de resultado aprovado.
|
|
26
|
+
- Visão de produto, specs e ADRs para as duas etapas entregues.
|
|
27
|
+
|
|
28
|
+
### Corrigido
|
|
29
|
+
|
|
30
|
+
- Arquivos de contexto selecionados são enviados ao modelo e cobertos pelo hash do prompt.
|
|
31
|
+
- Argumentos posicionais preservam ordem, flags repetidas e espaços.
|
|
32
|
+
- Aprovação do Codex usa configuração compatível com exec; prompt enviado por stdin.
|
|
33
|
+
- Falhas de protocolo ou provedor não são tratadas como sucesso por terem exit zero.
|
|
34
|
+
|
|
35
|
+
### Validação e limites
|
|
36
|
+
|
|
37
|
+
472 testes locais aprovados, tipos e build aprovados. Integrações testadas por executáveis fixture,
|
|
38
|
+
sem chamadas reais a LLM. Acesso ao GPT-6 depende da conta autenticada no provedor. Retomada não
|
|
39
|
+
oferece garantia de exactly-once no agente. Validação aprova somente os checks configurados.
|
|
40
|
+
Veja [guia de integração](docs/llm-fit-loop.md) para comandos e migração.
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
7
44
|
## [3.0.0] — 2026-09-01 — Engineering Control Plane
|
|
8
45
|
|
|
9
46
|
Fundação inteira da visão ForjaJS 3.0 (ADR-0078): a Forja passa a responder, de forma estruturada
|
package/DOC-MAP.md
CHANGED
|
@@ -59,6 +59,8 @@ Ponto de entrada por papel. Para histórico de fases ver `CHANGELOG.md`; para de
|
|
|
59
59
|
| Decisões arquiteturais | `memory/90-decisions/` |
|
|
60
60
|
| Glossário | `docs/glossary.md` |
|
|
61
61
|
| Otimização de tokens | `docs/token-optimization.md` |
|
|
62
|
+
| Integrações LLM e perfil GPT-6 | `docs/llm-fit-loop.md` |
|
|
63
|
+
| Visão e roadmap de evolução LLM | `docs/llm-evolution.md` |
|
|
62
64
|
| Capacidades externas (codegraph/harness/ai-engineering) | `docs/capacidades-externas.md` |
|
|
63
65
|
| Workflow de dev | `docs/dev-workflow.md` |
|
|
64
66
|
| Publicação npm | `docs/publishing.md` |
|
|
@@ -72,3 +74,5 @@ Ponto de entrada por papel. Para histórico de fases ver `CHANGELOG.md`; para de
|
|
|
72
74
|
## Histórico
|
|
73
75
|
|
|
74
76
|
Relatórios de fases anteriores estão em `docs/archive/`. Não edite — referenciar via `CHANGELOG.md` ou ADRs apropriadas.
|
|
77
|
+
|
|
78
|
+
- [Contrato dos agentes](docs/agent-operating-contract.md): contexto mínimo, autorização, execução e evidências para prompts e skills.
|
package/dist/lib/core/health.js
CHANGED
|
@@ -474,7 +474,8 @@ const docsCommands = {
|
|
|
474
474
|
if (!isFrameworkRepo(env)) {
|
|
475
475
|
return { status: 'ok', detail: 'fora do repo do framework — não se aplica', fix: null };
|
|
476
476
|
}
|
|
477
|
-
const
|
|
477
|
+
const pkg = JSON.parse(env.fs.readFileSync(path.join(env.root, 'package.json'), 'utf8'));
|
|
478
|
+
const known = new Set([...Object.keys(COMMANDS), ...CLI_INTERFACE_COMMANDS, ...projectCommands(env), ...Object.keys(pkg.scripts || {})]);
|
|
478
479
|
const ghosts = scanCommands(env).filter((c) => !known.has(c.command));
|
|
479
480
|
if (ghosts.length) {
|
|
480
481
|
const amostra = ghosts.slice(0, 5).map((g) => `${g.command} (${g.file}:${g.line})`).join(', ');
|
package/dist/lib/core/release.js
CHANGED
|
@@ -62,6 +62,9 @@ export async function withCleanInstall(fn, { root = repoRoot } = {}) {
|
|
|
62
62
|
if (key.startsWith('npm_'))
|
|
63
63
|
delete env[key];
|
|
64
64
|
}
|
|
65
|
+
// Usa um cache descartável para não depender das permissões ou do estado do
|
|
66
|
+
// cache global. O finally também remove esse cache ao terminar o gate.
|
|
67
|
+
env.npm_config_cache = path.join(dir, '.npm-cache');
|
|
65
68
|
const npm = (args, cwd) => {
|
|
66
69
|
try {
|
|
67
70
|
const command = process.platform === 'win32' ? process.execPath : 'npm';
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { LlmExecutionResult } from '../../packages/llm/src/index.ts';
|
|
2
|
+
export interface LlmUsage {
|
|
3
|
+
readonly inputTokens: number;
|
|
4
|
+
readonly outputTokens: number;
|
|
5
|
+
readonly cachedInputTokens?: number;
|
|
6
|
+
}
|
|
7
|
+
export interface NormalizedLlmResult extends LlmExecutionResult {
|
|
8
|
+
readonly sessionId?: string;
|
|
9
|
+
readonly usage?: LlmUsage;
|
|
10
|
+
}
|
|
11
|
+
/** Parse only known metadata/final messages. Never return raw event logs as the model's answer. */
|
|
12
|
+
export declare function normalizeCodexResult(result: LlmExecutionResult): NormalizedLlmResult;
|