forjajs 1.1.5 → 1.2.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.
Files changed (60) hide show
  1. package/CHANGELOG.md +50 -0
  2. package/README.en.md +310 -0
  3. package/README.md +37 -6
  4. package/bin/forja.mjs +3 -3
  5. package/boilerplates/06-clean-arch/README.md +48 -0
  6. package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +42 -0
  7. package/boilerplates/06-clean-arch/backend/package.json +43 -0
  8. package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -0
  9. package/boilerplates/06-clean-arch/backend/src/main.ts +10 -0
  10. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -0
  11. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -0
  12. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -0
  13. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -0
  14. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -0
  15. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -0
  16. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -0
  17. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -0
  18. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -0
  19. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -0
  20. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -0
  21. package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -0
  22. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -0
  23. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -0
  24. package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -0
  25. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -0
  26. package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -0
  27. package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -0
  28. package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -0
  29. package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -0
  30. package/boilerplates/README.md +20 -0
  31. package/docs/personas/architect/README.md +4 -4
  32. package/docs/personas/developer/README.md +3 -3
  33. package/docs/personas/qa/README.md +3 -3
  34. package/docs/quick-reference.md +9 -9
  35. package/docs/structure.md +3 -3
  36. package/lib/core/checks.mjs +20 -3
  37. package/lib/core/doc-graph.mjs +231 -0
  38. package/lib/core/health.mjs +131 -29
  39. package/lib/core/registry.mjs +23 -0
  40. package/lib/core/release.mjs +48 -8
  41. package/lib/templates/harness/code-intel.mjs +2 -2
  42. package/memory/90-decisions/0025-coerencia-da-documentacao.md +95 -0
  43. package/memory/90-decisions/0027-clean-arch-calibrada.md +96 -0
  44. package/package.json +8 -1
  45. package/scripts/agent-harness.mjs +7 -5
  46. package/scripts/context-ops.mjs +7 -4
  47. package/scripts/dev.mjs +2 -2
  48. package/scripts/hook-guard-paths.mjs +1 -0
  49. package/scripts/hook-user-prompt.mjs +1 -1
  50. package/scripts/spec-cli.mjs +4 -3
  51. package/scripts/tools-doctor.mjs +1 -1
  52. package/specs/clean-arch-boilerplate/plan.md +137 -0
  53. package/specs/clean-arch-boilerplate/spec.md +121 -0
  54. package/specs/clean-arch-boilerplate/tasks.md +70 -0
  55. package/specs/coerencia-do-sistema/plan.md +155 -0
  56. package/specs/coerencia-do-sistema/spec.md +15 -14
  57. package/specs/coerencia-do-sistema/tasks.md +115 -0
  58. package/specs/ts-migration/plan.md +188 -0
  59. package/specs/ts-migration/spec.md +119 -0
  60. package/specs/ts-migration/tasks.md +110 -0
@@ -0,0 +1,110 @@
1
+ # Tasks: ts-migration
2
+
3
+ - **Spec**: ./spec.md
4
+ - **Plan**: ./plan.md
5
+ - **Status**: approved
6
+ - **Criado em**: 2026-07-18
7
+
8
+ > Decomposição executável. Cada task tem dono claro, critério de done e referência a arquivos.
9
+
10
+ Ordem das fases do plano §7. As Fases 0 e 1 (T1-T2) são o destravador de menor risco: provam a
11
+ arquitetura **sem** renomear nada. A renomeação (T3) só começa com elas verdes.
12
+
13
+ ---
14
+
15
+ ## T1 — Fase 0: on-ramp `checkJs`
16
+ - **Owner**: Worker
17
+ - **Estimativa**: M
18
+ - **Depende de**: —
19
+ - **Paths**: `tsconfig.json`, `lib/core/registry.mjs`, `package.json`, `.github/workflows/ci.yml`
20
+ - **Escopo**: liga o type-check sobre os `.mjs` atuais. **Nada é renomeado.** Mede o tamanho real
21
+ do problema de tipos antes de comprometer a migração.
22
+ - **Done quando**:
23
+ - [ ] `tsconfig.json`: `allowJs, checkJs, strict, noEmit, module/moduleResolution` nodenext
24
+ - [ ] `typescript` em `devDependencies` (≥ 5.7, por D6)
25
+ - [ ] `types:check` no registry (`tsc --noEmit`) e como step do CI
26
+ - [ ] Os erros de tipo apontados são **corrigidos com os arquivos ainda `.mjs`** (ou anotados com
27
+ `@ts-expect-error` pontual se `strict` for poço sem fundo — kill criteria §8)
28
+ - [ ] `npm test` verde, `types:check` verde
29
+
30
+ ## T2 — Fase 1: resolver extension-agnostic
31
+ - **Owner**: Worker
32
+ - **Estimativa**: M
33
+ - **Depende de**: T1
34
+ - **Paths**: `lib/core/registry.mjs`, `bin/forja.mjs`, `lib/core/release.mjs`, `test/forja-core.test.js`
35
+ - **Escopo**: a **única** mudança de comportamento da migração, isolada e **ainda em `.mjs`**. Se
36
+ algo quebrar aqui, é o resolver — não a renomeação.
37
+ - **Done quando**:
38
+ - [ ] Registry: `node:` sem extensão (`scripts/tools-doctor`, não `.mjs`) — D2
39
+ - [ ] Dispatch (`bin/forja.mjs`): resolve `cmd.node` tentando `.ts → .js → .mjs`, a 1ª que existe
40
+ - [ ] `registry-scripts` (release.mjs) resolve extension-agnostic também — hoje casa a extensão
41
+ - [ ] `smoke-commands` (release.mjs) usa o campo `bin` do package.json, não path fixo — D7
42
+ - [ ] Teste: um comando roda com o registry sem extensão; `test/forja-core.test.js` verde
43
+ - [ ] `npm test` + `tools:doctor` + `release:check` verdes
44
+
45
+ ## T3 — Fase 2: renomear leaf-first
46
+ - **Owner**: Worker
47
+ - **Estimativa**: G
48
+ - **Depende de**: T2
49
+ - **Paths**: `lib/`, `scripts/`, `bin/`, `.claude/settings.json`
50
+ - **Escopo**: renomear `.mjs/.js → .ts` na ordem de dependência, **verde a cada arquivo**. Migração
51
+ de tipos, não de lógica: nenhum teste muda de semântica (a rede de segurança, AC-7).
52
+ - **Ordem** (D5): `workspace → checks → registry → doc-graph → health → release → scripts/* → hooks
53
+ → bin/forja → generators`.
54
+ - **Done quando**:
55
+ - [ ] Cada módulo renomeado com imports `./x.ts` (D6); `npm test` verde após cada um
56
+ - [ ] `Check`/`Probe`/`Result`/`Env`/`Command` e o handoff de 7 campos viram tipos reais (AC-4)
57
+ - [ ] Hooks do `.claude/settings.json` apontam para `.ts` (dev roda nativo)
58
+ - [ ] Geradores: assinatura tipada; o conteúdo template-string permanece string
59
+ - [ ] Ao final: `npm test`, `tools:doctor`, `spec:check` verdes; nenhum `.mjs`/`.js` de código
60
+ remanescente em `lib`/`scripts`/`bin`
61
+
62
+ ## T4 — Fase 3: build + dist + build-fresh
63
+ - **Owner**: Worker
64
+ - **Estimativa**: M
65
+ - **Depende de**: T3
66
+ - **Paths**: `tsconfig.json`, `package.json`, `lib/core/release.ts`, `.gitignore`, CI
67
+ - **Done quando**:
68
+ - [ ] `tsconfig`: `outDir: dist`, `rootDir: .`, `declaration: true`, `rewriteRelativeImportExtensions`
69
+ - [ ] `scripts.build` = `tsc`; `dist/` espelha a árvore (`dist/bin`, `dist/lib`, `dist/scripts`)
70
+ - [ ] `package.json`: `bin`/`main`/`types`/`exports` → `dist/`; `files[]` troca código por `dist/`
71
+ - [ ] **`build-fresh`** no `RELEASE_CHECKS` (D4): recompila num temp, faz diff com `dist/` commitado,
72
+ reprova defasado com `fix: npm run build`
73
+ - [ ] `prepublishOnly` = `npm run build && release:check -- --publish` (ordem, sem recursão — D7/ADR-0024)
74
+ - [ ] Decidir e registrar: `dist/` versionado (commitado) vs gerado no publish. Se versionado, o
75
+ `build-fresh` o guarda; se gerado, o `prepublishOnly` o produz. **Um ou outro, não os dois**
76
+ - [ ] `release:check --publish` aprova; `npm publish --dry-run` monta o tarball com `dist/`
77
+
78
+ ## T5 — ADR-0026 e docs
79
+ - **Owner**: SDD Architect + Worker
80
+ - **Estimativa**: P
81
+ - **Depende de**: T2, T4
82
+ - **Paths**: `memory/90-decisions/0026-*.md`, `docs/`, `CONTRIBUTING.md`, `CLAUDE.md`
83
+ - **Done quando**:
84
+ - [ ] ADR-0026 registra D2 (registry sem extensão), D3 (runtime duplo) e D4 (`build-fresh`);
85
+ referencia ADR-0021 (NFR "roda sem build" + classe "dist mente") e ADR-0024
86
+ - [ ] `CONTRIBUTING`/`docs`: "dev roda `.ts` nativo (Node novo); publicado roda `dist/`"
87
+ - [ ] `CLAUDE.md`: comando de dev atualizado se mudou (`node bin/forja.ts`)
88
+
89
+ ## T6 — Prova final (Governance)
90
+ - **Owner**: Governance
91
+ - **Estimativa**: P
92
+ - **Depende de**: T4, T5
93
+ - **Done quando**:
94
+ - [ ] `release:check --publish` aprova o tarball com `dist/` fresco
95
+ - [ ] **Reintroduzir um `dist/` defasado** (editar `src`, não rebuildar) e confirmar que o
96
+ `build-fresh` **reprova** — o gate que nunca viu a falha que promete pegar não está testado
97
+ - [ ] O hook `SessionStart` roda **sem `dist/` e sem build** em dev (o NFR inegociável, medido)
98
+ - [ ] `npm test`, `project:check`, `tools:doctor`, `gitleaks` verdes; spec → `done`
99
+
100
+ ---
101
+
102
+ ## Nota de sequência
103
+ As Fases 0-1 (T1-T2) podem ir num PR próprio — provam a arquitetura (checkJs + resolver) sem tocar
104
+ em extensão de arquivo, e são revertíveis com baixo custo. A renomeação (T3) é o commit grande; vale
105
+ PR separado. T4 (build/publish) é o de maior risco de release — vai por último, com o `build-fresh`
106
+ como rede.
107
+
108
+ ## Handoffs entre agentes
109
+ Worker (T1-T4), SDD Architect (T5), Governance (T6). Handoff a cada fronteira via `forja agent:route`
110
+ — 7 campos (ADR-0005).