forjajs 1.1.6 → 1.3.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 (172) hide show
  1. package/.claude/settings.json +7 -7
  2. package/CHANGELOG.md +62 -0
  3. package/README.en.md +33 -5
  4. package/README.md +35 -4
  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/dist/bin/create-memory-nest-kit.d.ts +2 -0
  32. package/dist/bin/create-memory-nest-kit.js +110 -0
  33. package/dist/bin/forja.d.ts +13 -0
  34. package/dist/bin/forja.js +136 -0
  35. package/dist/bin/init-project.d.ts +2 -0
  36. package/dist/bin/init-project.js +516 -0
  37. package/dist/lib/audit.d.ts +67 -0
  38. package/dist/lib/audit.js +143 -0
  39. package/dist/lib/context-builder.d.ts +58 -0
  40. package/dist/lib/context-builder.js +233 -0
  41. package/dist/lib/core/checks.d.ts +91 -0
  42. package/dist/lib/core/checks.js +119 -0
  43. package/dist/lib/core/doc-graph.d.ts +60 -0
  44. package/dist/lib/core/doc-graph.js +235 -0
  45. package/dist/lib/core/health.d.ts +103 -0
  46. package/dist/lib/core/health.js +538 -0
  47. package/dist/lib/core/registry.d.ts +296 -0
  48. package/dist/lib/core/registry.js +317 -0
  49. package/dist/lib/core/release.d.ts +334 -0
  50. package/dist/lib/core/release.js +465 -0
  51. package/dist/lib/generators/memory-generator.d.ts +83 -0
  52. package/{lib → dist/lib}/generators/memory-generator.js +107 -178
  53. package/dist/lib/generators/nest-generator.d.ts +15 -0
  54. package/{lib → dist/lib}/generators/nest-generator.js +47 -71
  55. package/dist/lib/generators/readme-generator.d.ts +15 -0
  56. package/{lib → dist/lib}/generators/readme-generator.js +9 -14
  57. package/dist/lib/governance-report.d.ts +49 -0
  58. package/dist/lib/governance-report.js +170 -0
  59. package/dist/lib/templates/harness/code-intel.d.mts +2 -0
  60. package/dist/lib/templates/harness/code-intel.mjs +126 -0
  61. package/dist/lib/utils/file-helpers.d.ts +9 -0
  62. package/dist/lib/utils/file-helpers.js +34 -0
  63. package/dist/lib/validators/structure-validator.d.ts +48 -0
  64. package/dist/lib/validators/structure-validator.js +232 -0
  65. package/dist/lib/workspace.d.ts +40 -0
  66. package/dist/lib/workspace.js +174 -0
  67. package/dist/scripts/agent-harness.d.ts +2 -0
  68. package/dist/scripts/agent-harness.js +556 -0
  69. package/dist/scripts/agent-router.d.ts +30 -0
  70. package/dist/scripts/agent-router.js +208 -0
  71. package/dist/scripts/audit-query.d.ts +2 -0
  72. package/dist/scripts/audit-query.js +43 -0
  73. package/dist/scripts/audit-sync.d.ts +2 -0
  74. package/dist/scripts/audit-sync.js +19 -0
  75. package/dist/scripts/build-smart-context.d.ts +1 -0
  76. package/dist/scripts/build-smart-context.js +75 -0
  77. package/dist/scripts/check-standards.d.ts +1 -0
  78. package/dist/scripts/check-standards.js +87 -0
  79. package/dist/scripts/compress-memory.d.ts +16 -0
  80. package/dist/scripts/compress-memory.js +157 -0
  81. package/dist/scripts/compress-project-memory.d.ts +1 -0
  82. package/dist/scripts/compress-project-memory.js +48 -0
  83. package/dist/scripts/context-ops.d.ts +2 -0
  84. package/dist/scripts/context-ops.js +464 -0
  85. package/dist/scripts/dev.d.ts +96 -0
  86. package/dist/scripts/dev.js +312 -0
  87. package/dist/scripts/extract-global-knowledge.d.ts +1 -0
  88. package/dist/scripts/extract-global-knowledge.js +43 -0
  89. package/dist/scripts/generate-dashboard.d.ts +1 -0
  90. package/dist/scripts/generate-dashboard.js +48 -0
  91. package/dist/scripts/governance-dashboard.d.ts +2 -0
  92. package/dist/scripts/governance-dashboard.js +36 -0
  93. package/dist/scripts/hook-guard-paths.d.ts +17 -0
  94. package/dist/scripts/hook-guard-paths.js +68 -0
  95. package/dist/scripts/hook-post-edit.d.ts +20 -0
  96. package/dist/scripts/hook-post-edit.js +70 -0
  97. package/dist/scripts/hook-session-start.d.ts +17 -0
  98. package/dist/scripts/hook-session-start.js +108 -0
  99. package/dist/scripts/hook-user-prompt.d.ts +22 -0
  100. package/dist/scripts/hook-user-prompt.js +193 -0
  101. package/dist/scripts/memory-schema.d.ts +6 -0
  102. package/{scripts/memory-schema.mjs → dist/scripts/memory-schema.js} +27 -20
  103. package/dist/scripts/query-universal-memory.d.ts +1 -0
  104. package/dist/scripts/query-universal-memory.js +44 -0
  105. package/dist/scripts/release-check.d.ts +14 -0
  106. package/dist/scripts/release-check.js +48 -0
  107. package/dist/scripts/spec-cli.d.ts +29 -0
  108. package/dist/scripts/spec-cli.js +261 -0
  109. package/dist/scripts/sprint-manager.d.ts +1 -0
  110. package/dist/scripts/sprint-manager.js +187 -0
  111. package/dist/scripts/sync-universal-memory.d.ts +1 -0
  112. package/dist/scripts/sync-universal-memory.js +277 -0
  113. package/dist/scripts/token-benchmark.d.ts +20 -0
  114. package/dist/scripts/token-benchmark.js +181 -0
  115. package/dist/scripts/tools-doctor.d.ts +20 -0
  116. package/dist/scripts/tools-doctor.js +120 -0
  117. package/docs/personas/architect/README.md +4 -4
  118. package/docs/personas/developer/README.md +3 -3
  119. package/docs/personas/qa/README.md +3 -3
  120. package/docs/quick-reference.md +9 -9
  121. package/docs/structure.md +3 -3
  122. package/memory/90-decisions/0025-coerencia-da-documentacao.md +95 -0
  123. package/memory/90-decisions/0027-clean-arch-calibrada.md +96 -0
  124. package/memory/90-decisions/0028-governanca-visivel.md +84 -0
  125. package/package.json +60 -56
  126. package/specs/clean-arch-boilerplate/plan.md +137 -0
  127. package/specs/clean-arch-boilerplate/spec.md +121 -0
  128. package/specs/clean-arch-boilerplate/tasks.md +70 -0
  129. package/specs/coerencia-do-sistema/plan.md +155 -0
  130. package/specs/coerencia-do-sistema/spec.md +15 -14
  131. package/specs/coerencia-do-sistema/tasks.md +115 -0
  132. package/specs/governanca-visivel/plan.md +122 -0
  133. package/specs/governanca-visivel/spec.md +112 -0
  134. package/specs/governanca-visivel/tasks.md +60 -0
  135. package/specs/ts-migration/plan.md +199 -0
  136. package/specs/ts-migration/spec.md +119 -0
  137. package/specs/ts-migration/tasks.md +110 -0
  138. package/bin/create-memory-nest-kit.js +0 -125
  139. package/bin/forja.mjs +0 -143
  140. package/bin/init-project.js +0 -612
  141. package/lib/context-builder.js +0 -257
  142. package/lib/core/checks.mjs +0 -138
  143. package/lib/core/health.mjs +0 -475
  144. package/lib/core/registry.mjs +0 -289
  145. package/lib/core/release.mjs +0 -452
  146. package/lib/templates/harness/code-intel.mjs +0 -119
  147. package/lib/templates/harness/mcp.json +0 -10
  148. package/lib/utils/file-helpers.js +0 -40
  149. package/lib/validators/structure-validator.js +0 -253
  150. package/lib/workspace.mjs +0 -213
  151. package/scripts/agent-harness.mjs +0 -578
  152. package/scripts/agent-router.mjs +0 -189
  153. package/scripts/build-smart-context.js +0 -87
  154. package/scripts/check-standards.js +0 -98
  155. package/scripts/compress-memory.mjs +0 -198
  156. package/scripts/compress-project-memory.js +0 -58
  157. package/scripts/context-ops.mjs +0 -463
  158. package/scripts/dev.mjs +0 -349
  159. package/scripts/extract-global-knowledge.js +0 -52
  160. package/scripts/generate-dashboard.js +0 -59
  161. package/scripts/hook-guard-paths.mjs +0 -75
  162. package/scripts/hook-post-edit.mjs +0 -79
  163. package/scripts/hook-session-start.mjs +0 -104
  164. package/scripts/hook-user-prompt.mjs +0 -185
  165. package/scripts/pre-commit.sh +0 -102
  166. package/scripts/query-universal-memory.js +0 -50
  167. package/scripts/release-check.mjs +0 -56
  168. package/scripts/spec-cli.mjs +0 -260
  169. package/scripts/sprint-manager.js +0 -200
  170. package/scripts/sync-universal-memory.js +0 -286
  171. package/scripts/token-benchmark.mjs +0 -203
  172. package/scripts/tools-doctor.mjs +0 -132
@@ -0,0 +1,334 @@
1
+ /**
2
+ * lib/core/release.mjs — o gate do tarball.
3
+ *
4
+ * Guarda a fronteira que `health.mjs` não vê: **o repositório mente sobre o pacote**. No repo tudo
5
+ * resolve — `node_modules` tem as devDeps, todo arquivo está presente, o `cwd` é a raiz. Nada disso
6
+ * vale para quem roda `npm i -g forjajs`. Essa fronteira já cedeu três vezes (SPEC-010):
7
+ *
8
+ * ADR-0021 `better-sqlite3` como devDependency → dez comandos com ERR_MODULE_NOT_FOUND na
9
+ * instalação limpa. O `forja` sem argumentos funcionava, o que mascarava a quebra.
10
+ * v1.1.1 `otplib` e `qrcode` publicados sem jamais existirem no git — `npm publish` empacota o
11
+ * disco, não o commit.
12
+ * v1.1.3 `docs/dashboard.md` e o script publicados sem a pasta `dashboard/`.
13
+ *
14
+ * O princípio que organiza tudo aqui: **grep não prova ausência; instalação prova.** Por isso o
15
+ * gate empacota e instala de verdade, e por isso ele é lento — e tudo bem ser lento, porque roda
16
+ * antes de publicar, não a cada commit.
17
+ *
18
+ * O runner é o de `checks.mjs`, o mesmo do doctor. Uma máquina, duas fronteiras.
19
+ */
20
+ import fs from 'node:fs';
21
+ import { worstStatus } from './checks.ts';
22
+ export { worstStatus };
23
+ /**
24
+ * Empacota o repo e instala o tarball num diretório temporário isolado.
25
+ *
26
+ * Isolamento importa: um gate que enxerga o `node_modules` do repo mente verde. É justamente o
27
+ * `NODE_PATH` herdado e o `node_modules` vizinho que fariam um `import` quebrado resolver mesmo
28
+ * assim — e a quebra só apareceria na máquina do usuário.
29
+ *
30
+ * Limpa o temporário **sempre**, inclusive quando o callback lança.
31
+ *
32
+ * @template T
33
+ * @param {(ctx: { pkgDir: string, installDir: string }) => Promise<T>|T} fn
34
+ * @returns {Promise<T>}
35
+ */
36
+ export declare function withCleanInstall(fn: any, { root }?: {
37
+ root?: string | undefined;
38
+ }): Promise<any>;
39
+ /** @type {import('./checks.ts').Check[]} */
40
+ export declare const RELEASE_CHECKS: {
41
+ id: string;
42
+ title: string;
43
+ severity: string;
44
+ probe(env: any): {
45
+ status: string;
46
+ detail: string;
47
+ fix: null;
48
+ } | {
49
+ status: string;
50
+ detail: string;
51
+ fix: string;
52
+ };
53
+ }[];
54
+ export declare function defaultEnv(overrides?: {}): {
55
+ root: string;
56
+ fs: typeof fs;
57
+ registry: {
58
+ 'workspace:init': {
59
+ domain: string;
60
+ desc: string;
61
+ node: string;
62
+ args: string[];
63
+ };
64
+ 'project:new': {
65
+ domain: string;
66
+ desc: string;
67
+ node: string;
68
+ args: string[];
69
+ gates: string[];
70
+ };
71
+ 'project:list': {
72
+ domain: string;
73
+ desc: string;
74
+ node: string;
75
+ args: string[];
76
+ };
77
+ 'workspace:project:check': {
78
+ domain: string;
79
+ desc: string;
80
+ node: string;
81
+ args: string[];
82
+ gates: string[];
83
+ };
84
+ 'spec:new': {
85
+ domain: string;
86
+ desc: string;
87
+ node: string;
88
+ args: string[];
89
+ };
90
+ 'spec:plan': {
91
+ domain: string;
92
+ desc: string;
93
+ node: string;
94
+ args: string[];
95
+ };
96
+ 'spec:tasks': {
97
+ domain: string;
98
+ desc: string;
99
+ node: string;
100
+ args: string[];
101
+ };
102
+ 'spec:check': {
103
+ domain: string;
104
+ desc: string;
105
+ node: string;
106
+ args: string[];
107
+ };
108
+ 'gsd:plan': {
109
+ domain: string;
110
+ desc: string;
111
+ node: string;
112
+ args: string[];
113
+ };
114
+ 'gsd:handoff': {
115
+ domain: string;
116
+ desc: string;
117
+ node: string;
118
+ args: string[];
119
+ };
120
+ 'gsd:check': {
121
+ domain: string;
122
+ desc: string;
123
+ node: string;
124
+ args: string[];
125
+ };
126
+ 'hermes:handoff': {
127
+ domain: string;
128
+ desc: string;
129
+ node: string;
130
+ args: string[];
131
+ };
132
+ 'agent:route': {
133
+ domain: string;
134
+ desc: string;
135
+ node: string;
136
+ };
137
+ 'sprint:start': {
138
+ domain: string;
139
+ desc: string;
140
+ node: string;
141
+ args: string[];
142
+ };
143
+ 'sprint:status': {
144
+ domain: string;
145
+ desc: string;
146
+ node: string;
147
+ args: string[];
148
+ };
149
+ 'sprint:complete': {
150
+ domain: string;
151
+ desc: string;
152
+ node: string;
153
+ args: string[];
154
+ };
155
+ 'design:check': {
156
+ domain: string;
157
+ desc: string;
158
+ node: string;
159
+ args: string[];
160
+ };
161
+ 'design:select': {
162
+ domain: string;
163
+ desc: string;
164
+ node: string;
165
+ args: string[];
166
+ };
167
+ 'code:check': {
168
+ domain: string;
169
+ desc: string;
170
+ node: string;
171
+ args: string[];
172
+ };
173
+ 'code:impact': {
174
+ domain: string;
175
+ desc: string;
176
+ node: string;
177
+ args: string[];
178
+ };
179
+ 'code:index': {
180
+ domain: string;
181
+ desc: string;
182
+ bin: string;
183
+ args: string[];
184
+ };
185
+ 'code:sync': {
186
+ domain: string;
187
+ desc: string;
188
+ bin: string;
189
+ args: string[];
190
+ };
191
+ 'code:status': {
192
+ domain: string;
193
+ desc: string;
194
+ bin: string;
195
+ args: string[];
196
+ };
197
+ 'code:query': {
198
+ domain: string;
199
+ desc: string;
200
+ bin: string;
201
+ args: string[];
202
+ };
203
+ 'sync:universal': {
204
+ domain: string;
205
+ desc: string;
206
+ node: string;
207
+ gates: string[];
208
+ };
209
+ 'query:universal': {
210
+ domain: string;
211
+ desc: string;
212
+ node: string;
213
+ gates: string[];
214
+ };
215
+ 'memory:compress': {
216
+ domain: string;
217
+ desc: string;
218
+ node: string;
219
+ };
220
+ 'memory:vacuum': {
221
+ domain: string;
222
+ desc: string;
223
+ node: string;
224
+ };
225
+ 'memory:schema': {
226
+ domain: string;
227
+ desc: string;
228
+ node: string;
229
+ };
230
+ 'memory:extract': {
231
+ domain: string;
232
+ desc: string;
233
+ node: string;
234
+ };
235
+ 'context:smart': {
236
+ domain: string;
237
+ desc: string;
238
+ node: string;
239
+ gates: string[];
240
+ };
241
+ 'context:budget': {
242
+ domain: string;
243
+ desc: string;
244
+ node: string;
245
+ args: string[];
246
+ };
247
+ 'context:sprint': {
248
+ domain: string;
249
+ desc: string;
250
+ node: string;
251
+ args: string[];
252
+ };
253
+ 'agent:brief': {
254
+ domain: string;
255
+ desc: string;
256
+ node: string;
257
+ args: string[];
258
+ };
259
+ 'catalog:assets': {
260
+ domain: string;
261
+ desc: string;
262
+ node: string;
263
+ args: string[];
264
+ };
265
+ 'catalog:manifests': {
266
+ domain: string;
267
+ desc: string;
268
+ node: string;
269
+ args: string[];
270
+ };
271
+ 'token:benchmark': {
272
+ domain: string;
273
+ desc: string;
274
+ node: string;
275
+ };
276
+ 'project:check': {
277
+ domain: string;
278
+ desc: string;
279
+ node: string;
280
+ };
281
+ 'tools:doctor': {
282
+ domain: string;
283
+ desc: string;
284
+ node: string;
285
+ };
286
+ 'release:check': {
287
+ domain: string;
288
+ desc: string;
289
+ node: string;
290
+ };
291
+ 'project:dashboard': {
292
+ domain: string;
293
+ desc: string;
294
+ node: string;
295
+ };
296
+ 'audit:sync': {
297
+ domain: string;
298
+ desc: string;
299
+ node: string;
300
+ };
301
+ 'audit:query': {
302
+ domain: string;
303
+ desc: string;
304
+ node: string;
305
+ };
306
+ 'governance:dashboard': {
307
+ domain: string;
308
+ desc: string;
309
+ node: string;
310
+ };
311
+ 'init:project': {
312
+ domain: string;
313
+ desc: string;
314
+ node: string;
315
+ };
316
+ };
317
+ smokeCommands: string[][];
318
+ publish: boolean;
319
+ spawn: (cmd: any, args: any, opts: any) => {
320
+ stdout: any;
321
+ stderr: any;
322
+ };
323
+ };
324
+ /**
325
+ * Roda o gate completo: empacota, instala isolado, checa, limpa.
326
+ *
327
+ * A aprovação é **perecível** — vale para o disco naquele instante. Por isso a árvore é reconferida
328
+ * ao final: um `npm install` entre o check e o publish invalida tudo, e foi exatamente essa a causa
329
+ * da v1.1.1.
330
+ */
331
+ export declare function runReleaseChecks({ publish, env: overrides }?: {
332
+ publish?: boolean | undefined;
333
+ env?: {} | undefined;
334
+ }): Promise<any>;