forjajs 4.1.0 → 4.1.1

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/CHANGELOG.md CHANGED
@@ -2,12 +2,71 @@
2
2
 
3
3
  Histórico consolidado das mudanças estruturais do framework. Para decisões arquiteturais com rationale, ver `memory/90-decisions/`.
4
4
 
5
+ ### Como escrever uma entrada de versão
6
+
7
+ Toda versão nova (ao tagear / publicar) abre com uma subseção **`### O que melhorou`** em
8
+ linguagem de produto: o diff observável em relação à versão anterior — o que o usuário passa a
9
+ conseguir fazer, o que para de dar errado, o que fica mais simples. Só depois vêm as seções
10
+ técnicas (`Adicionado`, `Alterado`, `Mudança de contrato`, `Notas…`). A nota de release do
11
+ GitHub reusa esse bloco. O README também é reconciliado na mesma entrega — ver
12
+ [`docs/publishing.md`](docs/publishing.md).
13
+
5
14
  ---
6
15
 
7
16
  ## [Unreleased]
8
17
 
18
+ ### O que melhorou
19
+
20
+ _(preencher a cada release: diff de produto vs. a versão anterior, antes das seções técnicas)_
21
+
22
+ ## [4.1.1] — 2026-09-08 — Disciplina de release: README + "O que melhorou" acompanham toda versão
23
+
24
+ ### O que melhorou
25
+
26
+ - **Toda versão nova passa a dizer, em linguagem de produto, o que melhorou.** Cada entrada do
27
+ `CHANGELOG.md` abre por uma subseção `### O que melhorou` — o diff observável vs. a versão
28
+ anterior — antes das seções técnicas. É esse bloco que vira a nota de release no GitHub.
29
+ - **O README não fica mais para trás.** Reconciliar `README.md` e `README.pt-BR.md` com o
30
+ comportamento da versão virou passo obrigatório do runbook de release, não um "se lembrar".
31
+
32
+ ### Alterado
33
+
34
+ - `CHANGELOG.md` ganha a seção **"Como escrever uma entrada de versão"** e um esqueleto em
35
+ `[Unreleased]`; a entrada da 4.1.0 foi retroalimentada com sua subseção `### O que melhorou`.
36
+ - `docs/publishing.md` — "Preparar uma versão" reescrito como checklist de 6 passos: reconciliar
37
+ README (passo 2) e escrever o `### O que melhorou` (passo 3) são explícitos; a etapa de tag no
38
+ GitHub aponta para esse bloco como corpo da release.
39
+ - `docs/agent-operating-contract.md` (§Entrega) e `CLAUDE.md` (§Convenções → Releases) registram
40
+ a regra: README reconciliado + subseção `### O que melhorou` são parte da entrega de qualquer
41
+ bump de versão / tag / publicação.
42
+ - `README.md` / `README.pt-BR.md` — nova convenção **Releases** / **Releases**.
43
+
44
+ ### Notas
45
+
46
+ - Sem mudança de código nem de contrato de CLI. Nenhum comando, flag ou saída `--json` muda.
47
+
9
48
  ## [4.1.0] — 2026-09-08 — Roadmap v4.1: menos erros, mais intuitivo, mais funcional com LLMs
10
49
 
50
+ ### O que melhorou
51
+
52
+ - **Menos erros na CLI.** `--json` agora sempre devolve um único objeto com chave `status`
53
+ (`ok`/`error`/`rejected`) e exit codes previsíveis (0/1/2/127); comando com argumento
54
+ obrigatório faltando imprime o `Uso:` e falha limpo, sem stack trace; `simulate` com
55
+ recomendação `discard` passa a sinalizar rejeição (exit 2) em vez de fingir sucesso.
56
+ - **Operação mais intuitiva.** `forja help <comando>` (e `--help`) explica uso, exemplos e
57
+ próximos passos; `forja setup` cobre o primeiro uso num comando; `forja status` dá o retrato
58
+ único do estado e `forja next` diz a próxima ação e o comando exato; erro de digitação
59
+ (`forja plan`) sugere o comando certo (`spec:plan`); o `help` sem argumento mostra só o núcleo,
60
+ agrupado por domínio.
61
+ - **Mais funcional com LLMs.** Adaptador **Claude** com retomada de sessão (`llm:run --resume`,
62
+ `llm:sessions`), paridade com o Codex; `llm:run --engineer` injeta o contexto de engenharia no
63
+ prompt; `llm:recommend` passa a pesar latência e custo com evidência por candidato; `llm:eval`
64
+ reporta p50/p95 e custo por tarefa aceita; o fluxo SDD roda por MCP (cobertura 6 → 18 comandos).
65
+ - **Gerador de projeto mais confiável.** `project:smoke --ai <lista>` exercita o caminho real
66
+ multi-IA (memória + instruções nativas por IA) e o CI roda isso em matriz a cada PR.
67
+ - **Drift sentinel utilizável.** `forja drift:check --all` roda o sentinela uma vez por projeto
68
+ do workspace — o modo lote para retomar projetos parados há meses (SPEC-030 fecha em `done`).
69
+
11
70
  **Roadmap v4.1 concluído** ([`docs/roadmap-v4.1.md`](docs/roadmap-v4.1.md)): as 12 workstreams
12
71
  (W1–W12) — menos erros, operação mais intuitiva, mais funcional com LLMs — foram implementadas
13
72
  pelo pipeline SDD do próprio Forja e merjadas em `main` (PRs #61–#69). Specs SPEC-043 a SPEC-050
package/README.md CHANGED
@@ -365,6 +365,9 @@ output, code, and ADRs are readable regardless of language.
365
365
  - **CLI-first** — sprints, SDD, GSD, handoffs, and governance by command; the UI is never a gate.
366
366
  - **ADRs** — every structural decision becomes `memory/90-decisions/NNNN-title.md`.
367
367
  - **Handoffs** — 7 required fields (ADR-0005), stored in SQLite (ADR-0008).
368
+ - **Releases** — every new version reconciles the README with its behavior and opens its
369
+ `CHANGELOG.md` entry with a `### O que melhorou` section (product-language diff vs. the previous
370
+ version, reused as the GitHub release note). Runbook: [`docs/publishing.md`](docs/publishing.md).
368
371
  - **pt-BR** — communication and documentation in Portuguese.
369
372
 
370
373
  ## Roadmap
package/README.pt-BR.md CHANGED
@@ -293,6 +293,9 @@ projects/ LEGADO — não usar; projetos vivem no workspace externo
293
293
  - **CLI-first** — sprints, SDD, GSD, handoffs e governança por comando; o front nunca é gate.
294
294
  - **ADRs** — toda decisão estrutural vira `memory/90-decisions/NNNN-titulo.md`.
295
295
  - **Handoffs** — 7 campos obrigatórios (ADR-0005), gravados no SQLite (ADR-0008).
296
+ - **Releases** — toda versão nova reconcilia o README com o seu comportamento e abre a entrada do
297
+ `CHANGELOG.md` por uma seção `### O que melhorou` (diff em linguagem de produto vs. a versão
298
+ anterior, reusada como nota de release no GitHub). Runbook: [`docs/publishing.md`](docs/publishing.md).
296
299
  - **pt-BR** — comunicação e documentação em português.
297
300
 
298
301
  ## Roadmap
@@ -24,3 +24,5 @@ Separe `executionStatus` de `validationStatus`. Schema comprova formato; checks
24
24
 
25
25
  ## Entrega
26
26
  Informe o que mudou, arquivos relevantes, comandos executados e resultados, limitações e pendências. Diferencie validado localmente, CI aprovado, push realizado e pacote publicado. Registre commit e link quando existirem. Antes de publicação autorizada, rode `npm run release:check -- --publish` em checkout limpo; não declare publicação sem confirmação do destino.
27
+
28
+ Toda versão nova (bump de versão, tag ou publicação) inclui, como parte da entrega: o `README` reconciliado com o comportamento da versão e a entrada no `CHANGELOG.md` abrindo pela subseção `### O que melhorou` (diff de produto vs. a versão anterior). Runbook: [`docs/publishing.md`](publishing.md).
@@ -5,10 +5,17 @@ package.json define o conteúdo distribuído. O workspace de produtos fica fora
5
5
 
6
6
  ## Preparar uma versão
7
7
 
8
- 1. Revisar mudanças, atualizar versão em package.json e package-lock.json e escrever o changelog.
9
- 2. Executar tipos, testes e governança pelo core do Forja.
10
- 3. Commitar a entrega. O modo de publicação exige árvore Git limpa.
11
- 4. Executar doctor e o gate estrito do tarball na revisão que será publicada.
8
+ 1. Revisar mudanças e atualizar versão em package.json e package-lock.json.
9
+ 2. **Reconciliar o README** (`README.md` e `README.pt-BR.md`): tabelas de comandos e de pilares,
10
+ listas de features e exemplos que a versão mudou. Nenhuma tag sai com o README descrevendo o
11
+ comportamento anterior.
12
+ 3. **Escrever a entrada da versão no `CHANGELOG.md`** começando pela subseção `### O que melhorou`
13
+ — o diff em linguagem de produto vs. a versão anterior (o que passa a funcionar, o que para de
14
+ dar errado, o que fica mais simples) — e só então as seções técnicas. Esse bloco é o texto da
15
+ release note do GitHub.
16
+ 4. Executar tipos, testes e governança pelo core do Forja.
17
+ 5. Commitar a entrega. O modo de publicação exige árvore Git limpa.
18
+ 6. Executar doctor e o gate estrito do tarball na revisão que será publicada.
12
19
 
13
20
  ```bash
14
21
  npm run types:check
@@ -37,7 +44,8 @@ Se a sessão expirou, o mantenedor renova o login com `npm login`. Se o npm exig
37
44
  adicional, concluir o fluxo oficial. Não contornar o gate com ignore-scripts.
38
45
 
39
46
  Enviar o commit para o GitHub, aguardar o CI e criar a tag/release correspondente à versão
40
- publicada. Não mover uma tag existente nem republicar uma versão imutável.
47
+ publicada. O corpo da release no GitHub é a subseção `### O que melhorou` daquela versão no
48
+ `CHANGELOG.md`. Não mover uma tag existente nem republicar uma versão imutável.
41
49
 
42
50
  ## Conteúdo e compatibilidade
43
51
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "forjajs",
3
- "version": "4.1.0",
3
+ "version": "4.1.1",
4
4
  "description": "ForjaJS é uma plataforma local-first para memória, contexto, governança e execução supervisionada de agentes de desenvolvimento",
5
5
  "type": "module",
6
6
  "main": "index.js",