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.
- package/CHANGELOG.md +50 -0
- package/README.en.md +310 -0
- package/README.md +37 -6
- package/bin/forja.mjs +3 -3
- package/boilerplates/06-clean-arch/README.md +48 -0
- package/boilerplates/06-clean-arch/WHEN-CLEAN-WHEN-LEAN.md +42 -0
- package/boilerplates/06-clean-arch/backend/package.json +43 -0
- package/boilerplates/06-clean-arch/backend/src/app.module.ts +20 -0
- package/boilerplates/06-clean-arch/backend/src/main.ts +10 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +47 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +28 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/money.vo.ts +30 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order-status.vo.ts +36 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +85 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +17 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/order.orm-entity.ts +24 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +57 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +28 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +31 -0
- package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.http.dto.ts +30 -0
- package/boilerplates/06-clean-arch/backend/src/modules/products/product.entity.ts +20 -0
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +43 -0
- package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +11 -0
- package/boilerplates/06-clean-arch/backend/src/shared/result.ts +32 -0
- package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +46 -0
- package/boilerplates/06-clean-arch/backend/tsconfig.json +16 -0
- package/boilerplates/06-clean-arch/boilerplate.manifest.json +43 -0
- package/boilerplates/06-clean-arch/memory/30-domains/orders/context.md +39 -0
- package/boilerplates/06-clean-arch/memory/30-domains/products/context.md +23 -0
- package/boilerplates/README.md +20 -0
- package/docs/personas/architect/README.md +4 -4
- package/docs/personas/developer/README.md +3 -3
- package/docs/personas/qa/README.md +3 -3
- package/docs/quick-reference.md +9 -9
- package/docs/structure.md +3 -3
- package/lib/core/checks.mjs +20 -3
- package/lib/core/doc-graph.mjs +231 -0
- package/lib/core/health.mjs +131 -29
- package/lib/core/registry.mjs +23 -0
- package/lib/core/release.mjs +48 -8
- package/lib/templates/harness/code-intel.mjs +2 -2
- package/memory/90-decisions/0025-coerencia-da-documentacao.md +95 -0
- package/memory/90-decisions/0027-clean-arch-calibrada.md +96 -0
- package/package.json +8 -1
- package/scripts/agent-harness.mjs +7 -5
- package/scripts/context-ops.mjs +7 -4
- package/scripts/dev.mjs +2 -2
- package/scripts/hook-guard-paths.mjs +1 -0
- package/scripts/hook-user-prompt.mjs +1 -1
- package/scripts/spec-cli.mjs +4 -3
- package/scripts/tools-doctor.mjs +1 -1
- package/specs/clean-arch-boilerplate/plan.md +137 -0
- package/specs/clean-arch-boilerplate/spec.md +121 -0
- package/specs/clean-arch-boilerplate/tasks.md +70 -0
- package/specs/coerencia-do-sistema/plan.md +155 -0
- package/specs/coerencia-do-sistema/spec.md +15 -14
- package/specs/coerencia-do-sistema/tasks.md +115 -0
- package/specs/ts-migration/plan.md +188 -0
- package/specs/ts-migration/spec.md +119 -0
- 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).
|