forjajs 1.2.0 → 1.3.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.
Files changed (132) hide show
  1. package/.claude/settings.json +7 -7
  2. package/CHANGELOG.md +41 -0
  3. package/README.en.md +5 -0
  4. package/README.md +5 -0
  5. package/dist/bin/create-memory-nest-kit.d.ts +2 -0
  6. package/dist/bin/create-memory-nest-kit.js +110 -0
  7. package/dist/bin/forja.d.ts +13 -0
  8. package/dist/bin/forja.js +136 -0
  9. package/dist/bin/init-project.d.ts +2 -0
  10. package/dist/bin/init-project.js +516 -0
  11. package/dist/lib/audit.d.ts +67 -0
  12. package/dist/lib/audit.js +143 -0
  13. package/dist/lib/context-builder.d.ts +58 -0
  14. package/dist/lib/context-builder.js +233 -0
  15. package/dist/lib/core/checks.d.ts +91 -0
  16. package/dist/lib/core/checks.js +119 -0
  17. package/dist/lib/core/doc-graph.d.ts +60 -0
  18. package/dist/lib/core/doc-graph.js +235 -0
  19. package/dist/lib/core/health.d.ts +103 -0
  20. package/dist/lib/core/health.js +538 -0
  21. package/dist/lib/core/registry.d.ts +296 -0
  22. package/dist/lib/core/registry.js +317 -0
  23. package/dist/lib/core/release.d.ts +334 -0
  24. package/dist/lib/core/release.js +465 -0
  25. package/dist/lib/generators/memory-generator.d.ts +83 -0
  26. package/{lib → dist/lib}/generators/memory-generator.js +107 -178
  27. package/dist/lib/generators/nest-generator.d.ts +15 -0
  28. package/{lib → dist/lib}/generators/nest-generator.js +47 -71
  29. package/dist/lib/generators/readme-generator.d.ts +15 -0
  30. package/{lib → dist/lib}/generators/readme-generator.js +9 -14
  31. package/dist/lib/governance-report.d.ts +49 -0
  32. package/dist/lib/governance-report.js +170 -0
  33. package/dist/lib/templates/harness/code-intel.d.mts +2 -0
  34. package/dist/lib/templates/harness/code-intel.mjs +126 -0
  35. package/dist/lib/utils/file-helpers.d.ts +9 -0
  36. package/dist/lib/utils/file-helpers.js +34 -0
  37. package/dist/lib/validators/structure-validator.d.ts +48 -0
  38. package/dist/lib/validators/structure-validator.js +232 -0
  39. package/dist/lib/workspace.d.ts +40 -0
  40. package/dist/lib/workspace.js +174 -0
  41. package/dist/scripts/agent-harness.d.ts +2 -0
  42. package/dist/scripts/agent-harness.js +556 -0
  43. package/dist/scripts/agent-router.d.ts +30 -0
  44. package/dist/scripts/agent-router.js +208 -0
  45. package/dist/scripts/audit-query.d.ts +2 -0
  46. package/dist/scripts/audit-query.js +43 -0
  47. package/dist/scripts/audit-sync.d.ts +2 -0
  48. package/dist/scripts/audit-sync.js +19 -0
  49. package/dist/scripts/build-smart-context.d.ts +1 -0
  50. package/dist/scripts/build-smart-context.js +75 -0
  51. package/dist/scripts/check-standards.d.ts +1 -0
  52. package/dist/scripts/check-standards.js +87 -0
  53. package/dist/scripts/compress-memory.d.ts +16 -0
  54. package/dist/scripts/compress-memory.js +157 -0
  55. package/dist/scripts/compress-project-memory.d.ts +1 -0
  56. package/dist/scripts/compress-project-memory.js +48 -0
  57. package/dist/scripts/context-ops.d.ts +2 -0
  58. package/dist/scripts/context-ops.js +464 -0
  59. package/dist/scripts/dev.d.ts +96 -0
  60. package/dist/scripts/dev.js +312 -0
  61. package/dist/scripts/extract-global-knowledge.d.ts +1 -0
  62. package/dist/scripts/extract-global-knowledge.js +43 -0
  63. package/dist/scripts/generate-dashboard.d.ts +1 -0
  64. package/dist/scripts/generate-dashboard.js +48 -0
  65. package/dist/scripts/governance-dashboard.d.ts +2 -0
  66. package/dist/scripts/governance-dashboard.js +36 -0
  67. package/dist/scripts/hook-guard-paths.d.ts +17 -0
  68. package/dist/scripts/hook-guard-paths.js +68 -0
  69. package/dist/scripts/hook-post-edit.d.ts +20 -0
  70. package/dist/scripts/hook-post-edit.js +70 -0
  71. package/dist/scripts/hook-session-start.d.ts +17 -0
  72. package/dist/scripts/hook-session-start.js +108 -0
  73. package/dist/scripts/hook-user-prompt.d.ts +22 -0
  74. package/dist/scripts/hook-user-prompt.js +193 -0
  75. package/dist/scripts/memory-schema.d.ts +6 -0
  76. package/{scripts/memory-schema.mjs → dist/scripts/memory-schema.js} +27 -20
  77. package/dist/scripts/query-universal-memory.d.ts +1 -0
  78. package/dist/scripts/query-universal-memory.js +44 -0
  79. package/dist/scripts/release-check.d.ts +14 -0
  80. package/dist/scripts/release-check.js +48 -0
  81. package/dist/scripts/spec-cli.d.ts +29 -0
  82. package/dist/scripts/spec-cli.js +261 -0
  83. package/dist/scripts/sprint-manager.d.ts +1 -0
  84. package/dist/scripts/sprint-manager.js +187 -0
  85. package/dist/scripts/sync-universal-memory.d.ts +1 -0
  86. package/dist/scripts/sync-universal-memory.js +277 -0
  87. package/dist/scripts/token-benchmark.d.ts +20 -0
  88. package/dist/scripts/token-benchmark.js +181 -0
  89. package/dist/scripts/tools-doctor.d.ts +20 -0
  90. package/dist/scripts/tools-doctor.js +120 -0
  91. package/memory/90-decisions/0028-governanca-visivel.md +84 -0
  92. package/package.json +54 -56
  93. package/specs/governanca-visivel/plan.md +122 -0
  94. package/specs/governanca-visivel/spec.md +112 -0
  95. package/specs/governanca-visivel/tasks.md +60 -0
  96. package/specs/ts-migration/plan.md +24 -13
  97. package/bin/create-memory-nest-kit.js +0 -125
  98. package/bin/forja.mjs +0 -143
  99. package/bin/init-project.js +0 -612
  100. package/lib/context-builder.js +0 -257
  101. package/lib/core/checks.mjs +0 -155
  102. package/lib/core/doc-graph.mjs +0 -231
  103. package/lib/core/health.mjs +0 -577
  104. package/lib/core/registry.mjs +0 -312
  105. package/lib/core/release.mjs +0 -492
  106. package/lib/templates/harness/code-intel.mjs +0 -119
  107. package/lib/templates/harness/mcp.json +0 -10
  108. package/lib/utils/file-helpers.js +0 -40
  109. package/lib/validators/structure-validator.js +0 -253
  110. package/lib/workspace.mjs +0 -213
  111. package/scripts/agent-harness.mjs +0 -580
  112. package/scripts/agent-router.mjs +0 -189
  113. package/scripts/build-smart-context.js +0 -87
  114. package/scripts/check-standards.js +0 -98
  115. package/scripts/compress-memory.mjs +0 -198
  116. package/scripts/compress-project-memory.js +0 -58
  117. package/scripts/context-ops.mjs +0 -466
  118. package/scripts/dev.mjs +0 -349
  119. package/scripts/extract-global-knowledge.js +0 -52
  120. package/scripts/generate-dashboard.js +0 -59
  121. package/scripts/hook-guard-paths.mjs +0 -76
  122. package/scripts/hook-post-edit.mjs +0 -79
  123. package/scripts/hook-session-start.mjs +0 -104
  124. package/scripts/hook-user-prompt.mjs +0 -185
  125. package/scripts/pre-commit.sh +0 -102
  126. package/scripts/query-universal-memory.js +0 -50
  127. package/scripts/release-check.mjs +0 -56
  128. package/scripts/spec-cli.mjs +0 -261
  129. package/scripts/sprint-manager.js +0 -200
  130. package/scripts/sync-universal-memory.js +0 -286
  131. package/scripts/token-benchmark.mjs +0 -203
  132. 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>;