forjajs 4.0.1 → 4.1.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 (95) hide show
  1. package/CHANGELOG.md +111 -7
  2. package/DOC-MAP.md +1 -0
  3. package/README.md +7 -2
  4. package/dist/apps/cli/src/index.d.ts +18 -1
  5. package/dist/apps/cli/src/index.js +161 -26
  6. package/dist/apps/cli/src/params.d.ts +44 -0
  7. package/dist/apps/cli/src/params.js +123 -0
  8. package/dist/bin/forja.js +234 -13
  9. package/dist/bin/init-project.js +11 -62
  10. package/dist/lib/cli-output.d.ts +29 -0
  11. package/dist/lib/cli-output.js +39 -0
  12. package/dist/lib/core/checks.d.ts +1 -1
  13. package/dist/lib/core/health.d.ts +9 -0
  14. package/dist/lib/core/health.js +9 -0
  15. package/dist/lib/core/project-smoke.d.ts +6 -2
  16. package/dist/lib/core/project-smoke.js +83 -7
  17. package/dist/lib/core/registry.d.ts +38 -571
  18. package/dist/lib/core/registry.js +174 -25
  19. package/dist/lib/core/release.d.ts +1 -571
  20. package/dist/lib/core/release.js +0 -3
  21. package/dist/lib/handoffs-index.d.ts +16 -0
  22. package/dist/lib/handoffs-index.js +29 -0
  23. package/dist/lib/llm/claude-output.d.ts +8 -0
  24. package/dist/lib/llm/claude-output.js +54 -0
  25. package/dist/lib/llm/context.d.ts +22 -0
  26. package/dist/lib/llm/context.js +39 -0
  27. package/dist/lib/llm/session.d.ts +6 -1
  28. package/dist/lib/llm/session.js +12 -2
  29. package/dist/lib/multi-ai-instructions.d.ts +28 -0
  30. package/dist/lib/multi-ai-instructions.js +83 -0
  31. package/dist/lib/orchestrate.d.ts +5 -0
  32. package/dist/lib/orchestrate.js +18 -0
  33. package/dist/lib/specs-index.d.ts +20 -0
  34. package/dist/lib/specs-index.js +51 -0
  35. package/dist/lib/sprint-index.d.ts +15 -0
  36. package/dist/lib/sprint-index.js +34 -0
  37. package/dist/lib/status-model.d.ts +64 -0
  38. package/dist/lib/status-model.js +180 -0
  39. package/dist/packages/evals/src/index.d.ts +2 -0
  40. package/dist/packages/evals/src/index.js +21 -0
  41. package/dist/packages/llm/src/index.d.ts +24 -3
  42. package/dist/packages/llm/src/index.js +51 -5
  43. package/dist/scripts/cost-economy.js +12 -10
  44. package/dist/scripts/drift-check.d.ts +2 -0
  45. package/dist/scripts/drift-check.js +57 -1
  46. package/dist/scripts/engineer.js +7 -4
  47. package/dist/scripts/forja-setup.d.ts +14 -0
  48. package/dist/scripts/forja-setup.js +58 -0
  49. package/dist/scripts/forja-status.d.ts +11 -0
  50. package/dist/scripts/forja-status.js +70 -0
  51. package/dist/scripts/hook-session-start.js +20 -46
  52. package/dist/scripts/llm-fit.js +113 -8
  53. package/dist/scripts/project-smoke.js +13 -3
  54. package/dist/scripts/simulate.js +18 -6
  55. package/dist/scripts/token-economy.js +34 -28
  56. package/dist/scripts/tools-doctor.js +14 -6
  57. package/docs/2x/CLI-CAPABILITIES.md +34 -10
  58. package/docs/agent-operating-contract.md +1 -1
  59. package/docs/cli-first-operacao.md +17 -0
  60. package/docs/contrato-saida-cli.md +79 -0
  61. package/docs/llm-evolution.md +2 -1
  62. package/docs/llm-fit-loop.md +74 -2
  63. package/docs/publishing.md +0 -11
  64. package/docs/quick-reference.md +13 -0
  65. package/docs/roadmap-v4.1.md +199 -0
  66. package/memory/90-decisions/0082-contrato-saida-cli.md +95 -0
  67. package/memory/90-decisions/0083-mcp-cobertura-declarativa.md +103 -0
  68. package/memory/90-decisions/0084-drift-sentinel-fecha.md +79 -0
  69. package/memory/90-decisions/0085-adaptador-claude-paridade.md +85 -0
  70. package/package.json +4 -1
  71. package/specs/cli-intuitiva-v1/plan.md +169 -0
  72. package/specs/cli-intuitiva-v1/spec.md +163 -0
  73. package/specs/cli-intuitiva-v1/tasks.md +224 -0
  74. package/specs/contrato-saida-cli/plan.md +162 -0
  75. package/specs/contrato-saida-cli/spec.md +157 -0
  76. package/specs/contrato-saida-cli/tasks.md +153 -0
  77. package/specs/drift-sentinel/spec.md +17 -8
  78. package/specs/forja-status-caminho-feliz/plan.md +149 -0
  79. package/specs/forja-status-caminho-feliz/spec.md +158 -0
  80. package/specs/forja-status-caminho-feliz/tasks.md +175 -0
  81. package/specs/llm-adaptador-claude/plan.md +117 -0
  82. package/specs/llm-adaptador-claude/spec.md +144 -0
  83. package/specs/llm-adaptador-claude/tasks.md +100 -0
  84. package/specs/llm-benchmark-recomendacao/plan.md +121 -0
  85. package/specs/llm-benchmark-recomendacao/spec.md +141 -0
  86. package/specs/llm-benchmark-recomendacao/tasks.md +88 -0
  87. package/specs/llm-contexto-e-sessoes/plan.md +143 -0
  88. package/specs/llm-contexto-e-sessoes/spec.md +139 -0
  89. package/specs/llm-contexto-e-sessoes/tasks.md +127 -0
  90. package/specs/mcp-cobertura-nucleo/plan.md +158 -0
  91. package/specs/mcp-cobertura-nucleo/spec.md +161 -0
  92. package/specs/mcp-cobertura-nucleo/tasks.md +169 -0
  93. package/specs/projeto-gerado-confiavel/plan.md +148 -0
  94. package/specs/projeto-gerado-confiavel/spec.md +142 -0
  95. package/specs/projeto-gerado-confiavel/tasks.md +139 -0
@@ -36,574 +36,41 @@ export declare const DOMAINS: {
36
36
  governanca: string;
37
37
  geracao: string;
38
38
  };
39
- export declare const COMMANDS: {
40
- 'workspace:init': {
41
- domain: string;
42
- desc: string;
43
- node: string;
44
- args: string[];
45
- };
46
- 'project:new': {
47
- domain: string;
48
- desc: string;
49
- node: string;
50
- args: string[];
51
- gates: string[];
52
- };
53
- 'project:list': {
54
- domain: string;
55
- desc: string;
56
- node: string;
57
- args: string[];
58
- };
59
- 'project:upgrade': {
60
- domain: string;
61
- desc: string;
62
- node: string;
63
- };
64
- 'workspace:project:check': {
65
- domain: string;
66
- desc: string;
67
- node: string;
68
- args: string[];
69
- gates: string[];
70
- };
71
- 'spec:new': {
72
- domain: string;
73
- desc: string;
74
- node: string;
75
- args: string[];
76
- };
77
- 'spec:plan': {
78
- domain: string;
79
- desc: string;
80
- node: string;
81
- args: string[];
82
- };
83
- 'spec:tasks': {
84
- domain: string;
85
- desc: string;
86
- node: string;
87
- args: string[];
88
- };
89
- 'spec:check': {
90
- domain: string;
91
- desc: string;
92
- node: string;
93
- args: string[];
94
- };
95
- 'gsd:plan': {
96
- domain: string;
97
- desc: string;
98
- node: string;
99
- args: string[];
100
- };
101
- 'gsd:handoff': {
102
- domain: string;
103
- desc: string;
104
- node: string;
105
- args: string[];
106
- };
107
- 'gsd:check': {
108
- domain: string;
109
- desc: string;
110
- node: string;
111
- args: string[];
112
- };
113
- orchestrate: {
114
- domain: string;
115
- desc: string;
116
- node: string;
117
- args: string[];
118
- };
119
- 'orchestrate:status': {
120
- domain: string;
121
- desc: string;
122
- node: string;
123
- args: string[];
124
- };
125
- 'orchestrate:advance': {
126
- domain: string;
127
- desc: string;
128
- node: string;
129
- args: string[];
130
- };
131
- 'hermes:handoff': {
132
- domain: string;
133
- desc: string;
134
- node: string;
135
- args: string[];
136
- };
137
- 'agent:route': {
138
- domain: string;
139
- desc: string;
140
- node: string;
141
- };
142
- 'sprint:start': {
143
- domain: string;
144
- desc: string;
145
- node: string;
146
- args: string[];
147
- };
148
- 'sprint:status': {
149
- domain: string;
150
- desc: string;
151
- node: string;
152
- args: string[];
153
- };
154
- 'sprint:complete': {
155
- domain: string;
156
- desc: string;
157
- node: string;
158
- args: string[];
159
- };
160
- 'design:check': {
161
- domain: string;
162
- desc: string;
163
- node: string;
164
- args: string[];
165
- };
166
- 'design:select': {
167
- domain: string;
168
- desc: string;
169
- node: string;
170
- args: string[];
171
- };
172
- 'code:check': {
173
- domain: string;
174
- desc: string;
175
- node: string;
176
- args: string[];
177
- };
178
- 'code:impact': {
179
- domain: string;
180
- desc: string;
181
- node: string;
182
- args: string[];
183
- };
184
- 'graph:sync': {
185
- domain: string;
186
- desc: string;
187
- capability: string;
188
- gates: string[];
189
- };
190
- 'drift:check': {
191
- domain: string;
192
- desc: string;
193
- node: string;
194
- gates: string[];
195
- };
196
- 'adr:list': {
197
- domain: string;
198
- desc: string;
199
- node: string;
200
- args: string[];
201
- gates: string[];
202
- };
203
- 'adr:show': {
204
- domain: string;
205
- desc: string;
206
- node: string;
207
- args: string[];
208
- gates: string[];
209
- };
210
- 'adr:impact': {
211
- domain: string;
212
- desc: string;
213
- node: string;
214
- args: string[];
215
- gates: string[];
216
- };
217
- 'adr:graph': {
218
- domain: string;
219
- desc: string;
220
- node: string;
221
- args: string[];
222
- gates: string[];
223
- };
224
- 'architecture:compile': {
225
- domain: string;
226
- desc: string;
227
- node: string;
228
- args: string[];
229
- };
230
- 'architecture:check': {
231
- domain: string;
232
- desc: string;
233
- node: string;
234
- args: string[];
235
- gates: string[];
236
- };
237
- 'architecture:status': {
238
- domain: string;
239
- desc: string;
240
- node: string;
241
- args: string[];
242
- };
243
- 'architecture:explain': {
244
- domain: string;
245
- desc: string;
246
- node: string;
247
- args: string[];
248
- };
249
- 'architecture:approve': {
250
- domain: string;
251
- desc: string;
252
- node: string;
253
- args: string[];
254
- };
255
- 'risk:assess': {
256
- domain: string;
257
- desc: string;
258
- node: string;
259
- args: string[];
260
- gates: string[];
261
- };
262
- 'risk:explain': {
263
- domain: string;
264
- desc: string;
265
- node: string;
266
- args: string[];
267
- };
268
- 'evidence:show': {
269
- domain: string;
270
- desc: string;
271
- node: string;
272
- args: string[];
273
- gates: string[];
274
- };
275
- engineer: {
276
- domain: string;
277
- desc: string;
278
- node: string;
279
- gates: string[];
280
- };
281
- 'agent:register': {
282
- domain: string;
283
- desc: string;
284
- node: string;
285
- args: string[];
286
- gates: string[];
287
- };
288
- 'agent:list': {
289
- domain: string;
290
- desc: string;
291
- node: string;
292
- args: string[];
293
- gates: string[];
294
- };
295
- 'agent:show': {
296
- domain: string;
297
- desc: string;
298
- node: string;
299
- args: string[];
300
- gates: string[];
301
- };
302
- 'agent:score': {
303
- domain: string;
304
- desc: string;
305
- node: string;
306
- args: string[];
307
- gates: string[];
308
- };
309
- 'agent:history': {
310
- domain: string;
311
- desc: string;
312
- node: string;
313
- args: string[];
314
- gates: string[];
315
- };
316
- 'agent:recommend': {
317
- domain: string;
318
- desc: string;
319
- node: string;
320
- args: string[];
321
- gates: string[];
322
- };
323
- 'agent:monitor': {
324
- domain: string;
325
- desc: string;
326
- node: string;
327
- args: string[];
328
- gates: string[];
329
- };
330
- 'incident:record': {
331
- domain: string;
332
- desc: string;
333
- node: string;
334
- args: string[];
335
- gates: string[];
336
- };
337
- 'incident:list': {
338
- domain: string;
339
- desc: string;
340
- node: string;
341
- args: string[];
342
- gates: string[];
343
- };
344
- 'incident:similar': {
345
- domain: string;
346
- desc: string;
347
- node: string;
348
- args: string[];
349
- gates: string[];
350
- };
351
- simulate: {
352
- domain: string;
353
- desc: string;
354
- node: string;
355
- gates: string[];
356
- };
357
- 'provenance:record': {
358
- domain: string;
359
- desc: string;
360
- node: string;
361
- args: string[];
362
- gates: string[];
363
- };
364
- blame: {
365
- domain: string;
366
- desc: string;
367
- node: string;
368
- args: string[];
369
- gates: string[];
370
- };
371
- sbom: {
372
- domain: string;
373
- desc: string;
374
- node: string;
375
- args: string[];
376
- gates: string[];
377
- };
378
- 'code:context': {
379
- domain: string;
380
- desc: string;
381
- node: string;
382
- };
383
- 'code:index': {
384
- domain: string;
385
- desc: string;
386
- bin: string;
387
- args: string[];
388
- };
389
- 'code:sync': {
390
- domain: string;
391
- desc: string;
392
- bin: string;
393
- args: string[];
394
- };
395
- 'code:status': {
396
- domain: string;
397
- desc: string;
398
- bin: string;
399
- args: string[];
400
- };
401
- 'code:query': {
402
- domain: string;
403
- desc: string;
404
- bin: string;
405
- args: string[];
406
- };
407
- 'sync:universal': {
408
- domain: string;
409
- desc: string;
410
- node: string;
411
- gates: string[];
412
- };
413
- 'query:universal': {
414
- domain: string;
415
- desc: string;
416
- node: string;
417
- gates: string[];
418
- };
419
- 'memory:compress': {
420
- domain: string;
421
- desc: string;
422
- node: string;
423
- };
424
- 'memory:vacuum': {
425
- domain: string;
426
- desc: string;
427
- node: string;
428
- };
429
- 'memory:schema': {
430
- domain: string;
431
- desc: string;
432
- node: string;
433
- };
434
- 'memory:extract': {
435
- domain: string;
436
- desc: string;
437
- node: string;
438
- };
439
- 'memory:audit': {
440
- domain: string;
441
- desc: string;
442
- node: string;
443
- };
444
- 'context:smart': {
445
- domain: string;
446
- desc: string;
447
- node: string;
448
- gates: string[];
449
- };
450
- 'context:budget': {
451
- domain: string;
452
- desc: string;
453
- node: string;
454
- args: string[];
455
- };
456
- 'context:sprint': {
457
- domain: string;
458
- desc: string;
459
- node: string;
460
- args: string[];
461
- };
462
- 'agent:brief': {
463
- domain: string;
464
- desc: string;
465
- node: string;
466
- args: string[];
467
- };
468
- 'catalog:assets': {
469
- domain: string;
470
- desc: string;
471
- node: string;
472
- args: string[];
473
- };
474
- 'catalog:manifests': {
475
- domain: string;
476
- desc: string;
477
- node: string;
478
- args: string[];
479
- };
480
- 'token:benchmark': {
481
- domain: string;
482
- desc: string;
483
- node: string;
484
- };
485
- 'token:economy': {
486
- domain: string;
487
- desc: string;
488
- node: string;
489
- };
490
- 'benchmark:context': {
491
- domain: string;
492
- desc: string;
493
- node: string;
494
- };
495
- 'spec:set-status': {
496
- domain: string;
497
- desc: string;
498
- node: string;
499
- args: string[];
500
- };
501
- 'llm:profiles:init': {
502
- domain: string;
503
- desc: string;
504
- node: string;
505
- args: string[];
506
- gates: string[];
507
- };
508
- 'llm:doctor': {
509
- domain: string;
510
- desc: string;
511
- node: string;
512
- args: string[];
513
- gates: string[];
514
- };
515
- 'llm:probe': {
516
- domain: string;
517
- desc: string;
518
- node: string;
519
- args: string[];
520
- gates: string[];
521
- };
522
- 'llm:recommend': {
523
- domain: string;
524
- desc: string;
525
- node: string;
526
- args: string[];
527
- gates: string[];
528
- };
529
- 'llm:run': {
530
- domain: string;
531
- desc: string;
532
- node: string;
533
- args: string[];
534
- gates: string[];
535
- };
536
- 'llm:eval': {
537
- domain: string;
538
- desc: string;
539
- node: string;
540
- args: string[];
541
- gates: string[];
542
- };
543
- 'cost:economy': {
544
- domain: string;
545
- desc: string;
546
- node: string;
547
- gates: string[];
548
- };
549
- 'project:check': {
550
- domain: string;
551
- desc: string;
552
- node: string;
553
- };
554
- 'tools:doctor': {
555
- domain: string;
556
- desc: string;
557
- node: string;
558
- };
559
- 'demo:autonomy': {
560
- domain: string;
561
- desc: string;
562
- node: string;
563
- };
564
- 'demo:workspace': {
565
- domain: string;
566
- desc: string;
567
- node: string;
568
- };
569
- 'release:check': {
570
- domain: string;
571
- desc: string;
572
- node: string;
573
- };
574
- 'project:smoke': {
575
- domain: string;
576
- desc: string;
577
- node: string;
578
- };
579
- 'check:all': {
580
- domain: string;
581
- desc: string;
582
- node: string;
583
- };
584
- 'project:dashboard': {
585
- domain: string;
586
- desc: string;
587
- node: string;
588
- };
589
- 'audit:sync': {
590
- domain: string;
591
- desc: string;
592
- node: string;
593
- };
594
- 'audit:query': {
595
- domain: string;
596
- desc: string;
597
- node: string;
598
- };
599
- 'governance:dashboard': {
600
- domain: string;
601
- desc: string;
602
- node: string;
603
- };
604
- 'init:project': {
605
- domain: string;
606
- desc: string;
607
- node: string;
608
- };
609
- };
39
+ export interface CommandArg {
40
+ readonly name: string;
41
+ readonly required: boolean;
42
+ readonly desc: string;
43
+ }
44
+ /**
45
+ * SPEC-043 — campos que tornam a CLI descobrível por ela mesma.
46
+ *
47
+ * `domain`/`desc` e os alvos de execução (`node`/`bin`/`capability` + `args`/`gates`) são o
48
+ * contrato antigo. Tudo abaixo de `usage` é **opcional e aditivo**: um comando sem nenhum desses
49
+ * campos continua válido e é tratado como `tier: 'advanced'`. `forja help` (curto) mostra só
50
+ * `tier: 'core'`; `forja help <cmd>` renderiza `usage`/`cliArgs`/`examples`/`next`/`spec`.
51
+ */
52
+ export interface CommandSpec {
53
+ readonly domain: keyof typeof DOMAINS;
54
+ readonly desc: string;
55
+ readonly node?: string;
56
+ readonly bin?: string;
57
+ readonly capability?: string;
58
+ readonly args?: readonly string[];
59
+ readonly gates?: readonly string[];
60
+ /** Linha de uso, ex.: `forja spec:new <slug>`. */
61
+ readonly usage?: string;
62
+ /** Args POSICIONAIS do comando — distinto de `args` (prefixo fixo repassado ao script). */
63
+ readonly cliArgs?: readonly CommandArg[];
64
+ /** Cada exemplo começa com `forja ` e cita um comando existente. */
65
+ readonly examples?: readonly string[];
66
+ /** Comandos que costumam vir depois (nomes do registry). */
67
+ readonly next?: readonly string[];
68
+ /** SPEC/ADR de origem, ex.: `SPEC-021`. Antes ficava embutido em `desc`. */
69
+ readonly spec?: string;
70
+ readonly readonly?: boolean;
71
+ /** Reservado para o contrato de saída (W5). Só declarado nesta versão. */
72
+ readonly json?: boolean;
73
+ /** `core` aparece em `forja help`; ausente ou `advanced` só em `forja help --all`. */
74
+ readonly tier?: 'core' | 'advanced';
75
+ }
76
+ export declare const COMMANDS: Record<string, CommandSpec>;