forjajs 1.2.0 → 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 (132) hide show
  1. package/.claude/settings.json +7 -7
  2. package/CHANGELOG.md +25 -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,296 @@
1
+ /**
2
+ * lib/core/registry.mjs
3
+ *
4
+ * Registry declarativo do core Forja (ADR-0020).
5
+ * Cada comando declara: domínio, descrição, alvo de execução e gates.
6
+ *
7
+ * Alvos:
8
+ * - node: script do repo executado com `node <script> [...args]`
9
+ * - bin: binário externo no PATH (ex.: codegraph)
10
+ *
11
+ * Gates (aplicados por bin/forja.mjs antes do alvo):
12
+ * - workspace bloqueia se o workspace (ADR-0019) não existir
13
+ * - workspace-warn avisa se o workspace não existir, mas segue
14
+ */
15
+ /**
16
+ * Resolve o `node:` de um comando para o arquivo real, **agnóstico de extensão** (SPEC-012 D2).
17
+ * Tenta `.ts → .js → .mjs`: em dev acha a fonte `.ts`; no pacote publicado, o `.js` sob `dist/`.
18
+ * Desacopla o registry do runtime — a entrada pode manter `.mjs` que este resolver ainda acha o
19
+ * `.ts` renomeado. Sem isto, renomear um script quebraria o dispatch.
20
+ *
21
+ * @param {string} root Raiz onde os scripts vivem (repo em dev, `dist/` no publicado).
22
+ * @param {string} node Caminho do registry, com ou sem extensão.
23
+ * @returns {string} Caminho absoluto do arquivo que existe (ou o candidato original, que falha visível).
24
+ */
25
+ export declare function resolveScript(root: any, node: any): string;
26
+ export declare const DOMAINS: {
27
+ workspace: string;
28
+ sdd: string;
29
+ gsd: string;
30
+ design: string;
31
+ code: string;
32
+ memoria: string;
33
+ contexto: string;
34
+ governanca: string;
35
+ geracao: string;
36
+ };
37
+ export declare const COMMANDS: {
38
+ 'workspace:init': {
39
+ domain: string;
40
+ desc: string;
41
+ node: string;
42
+ args: string[];
43
+ };
44
+ 'project:new': {
45
+ domain: string;
46
+ desc: string;
47
+ node: string;
48
+ args: string[];
49
+ gates: string[];
50
+ };
51
+ 'project:list': {
52
+ domain: string;
53
+ desc: string;
54
+ node: string;
55
+ args: string[];
56
+ };
57
+ 'workspace:project:check': {
58
+ domain: string;
59
+ desc: string;
60
+ node: string;
61
+ args: string[];
62
+ gates: string[];
63
+ };
64
+ 'spec:new': {
65
+ domain: string;
66
+ desc: string;
67
+ node: string;
68
+ args: string[];
69
+ };
70
+ 'spec:plan': {
71
+ domain: string;
72
+ desc: string;
73
+ node: string;
74
+ args: string[];
75
+ };
76
+ 'spec:tasks': {
77
+ domain: string;
78
+ desc: string;
79
+ node: string;
80
+ args: string[];
81
+ };
82
+ 'spec:check': {
83
+ domain: string;
84
+ desc: string;
85
+ node: string;
86
+ args: string[];
87
+ };
88
+ 'gsd:plan': {
89
+ domain: string;
90
+ desc: string;
91
+ node: string;
92
+ args: string[];
93
+ };
94
+ 'gsd:handoff': {
95
+ domain: string;
96
+ desc: string;
97
+ node: string;
98
+ args: string[];
99
+ };
100
+ 'gsd:check': {
101
+ domain: string;
102
+ desc: string;
103
+ node: string;
104
+ args: string[];
105
+ };
106
+ 'hermes:handoff': {
107
+ domain: string;
108
+ desc: string;
109
+ node: string;
110
+ args: string[];
111
+ };
112
+ 'agent:route': {
113
+ domain: string;
114
+ desc: string;
115
+ node: string;
116
+ };
117
+ 'sprint:start': {
118
+ domain: string;
119
+ desc: string;
120
+ node: string;
121
+ args: string[];
122
+ };
123
+ 'sprint:status': {
124
+ domain: string;
125
+ desc: string;
126
+ node: string;
127
+ args: string[];
128
+ };
129
+ 'sprint:complete': {
130
+ domain: string;
131
+ desc: string;
132
+ node: string;
133
+ args: string[];
134
+ };
135
+ 'design:check': {
136
+ domain: string;
137
+ desc: string;
138
+ node: string;
139
+ args: string[];
140
+ };
141
+ 'design:select': {
142
+ domain: string;
143
+ desc: string;
144
+ node: string;
145
+ args: string[];
146
+ };
147
+ 'code:check': {
148
+ domain: string;
149
+ desc: string;
150
+ node: string;
151
+ args: string[];
152
+ };
153
+ 'code:impact': {
154
+ domain: string;
155
+ desc: string;
156
+ node: string;
157
+ args: string[];
158
+ };
159
+ 'code:index': {
160
+ domain: string;
161
+ desc: string;
162
+ bin: string;
163
+ args: string[];
164
+ };
165
+ 'code:sync': {
166
+ domain: string;
167
+ desc: string;
168
+ bin: string;
169
+ args: string[];
170
+ };
171
+ 'code:status': {
172
+ domain: string;
173
+ desc: string;
174
+ bin: string;
175
+ args: string[];
176
+ };
177
+ 'code:query': {
178
+ domain: string;
179
+ desc: string;
180
+ bin: string;
181
+ args: string[];
182
+ };
183
+ 'sync:universal': {
184
+ domain: string;
185
+ desc: string;
186
+ node: string;
187
+ gates: string[];
188
+ };
189
+ 'query:universal': {
190
+ domain: string;
191
+ desc: string;
192
+ node: string;
193
+ gates: string[];
194
+ };
195
+ 'memory:compress': {
196
+ domain: string;
197
+ desc: string;
198
+ node: string;
199
+ };
200
+ 'memory:vacuum': {
201
+ domain: string;
202
+ desc: string;
203
+ node: string;
204
+ };
205
+ 'memory:schema': {
206
+ domain: string;
207
+ desc: string;
208
+ node: string;
209
+ };
210
+ 'memory:extract': {
211
+ domain: string;
212
+ desc: string;
213
+ node: string;
214
+ };
215
+ 'context:smart': {
216
+ domain: string;
217
+ desc: string;
218
+ node: string;
219
+ gates: string[];
220
+ };
221
+ 'context:budget': {
222
+ domain: string;
223
+ desc: string;
224
+ node: string;
225
+ args: string[];
226
+ };
227
+ 'context:sprint': {
228
+ domain: string;
229
+ desc: string;
230
+ node: string;
231
+ args: string[];
232
+ };
233
+ 'agent:brief': {
234
+ domain: string;
235
+ desc: string;
236
+ node: string;
237
+ args: string[];
238
+ };
239
+ 'catalog:assets': {
240
+ domain: string;
241
+ desc: string;
242
+ node: string;
243
+ args: string[];
244
+ };
245
+ 'catalog:manifests': {
246
+ domain: string;
247
+ desc: string;
248
+ node: string;
249
+ args: string[];
250
+ };
251
+ 'token:benchmark': {
252
+ domain: string;
253
+ desc: string;
254
+ node: string;
255
+ };
256
+ 'project:check': {
257
+ domain: string;
258
+ desc: string;
259
+ node: string;
260
+ };
261
+ 'tools:doctor': {
262
+ domain: string;
263
+ desc: string;
264
+ node: string;
265
+ };
266
+ 'release:check': {
267
+ domain: string;
268
+ desc: string;
269
+ node: string;
270
+ };
271
+ 'project:dashboard': {
272
+ domain: string;
273
+ desc: string;
274
+ node: string;
275
+ };
276
+ 'audit:sync': {
277
+ domain: string;
278
+ desc: string;
279
+ node: string;
280
+ };
281
+ 'audit:query': {
282
+ domain: string;
283
+ desc: string;
284
+ node: string;
285
+ };
286
+ 'governance:dashboard': {
287
+ domain: string;
288
+ desc: string;
289
+ node: string;
290
+ };
291
+ 'init:project': {
292
+ domain: string;
293
+ desc: string;
294
+ node: string;
295
+ };
296
+ };
@@ -0,0 +1,317 @@
1
+ /**
2
+ * lib/core/registry.mjs
3
+ *
4
+ * Registry declarativo do core Forja (ADR-0020).
5
+ * Cada comando declara: domínio, descrição, alvo de execução e gates.
6
+ *
7
+ * Alvos:
8
+ * - node: script do repo executado com `node <script> [...args]`
9
+ * - bin: binário externo no PATH (ex.: codegraph)
10
+ *
11
+ * Gates (aplicados por bin/forja.mjs antes do alvo):
12
+ * - workspace bloqueia se o workspace (ADR-0019) não existir
13
+ * - workspace-warn avisa se o workspace não existir, mas segue
14
+ */
15
+ import fs from 'node:fs';
16
+ import path from 'node:path';
17
+ /**
18
+ * Resolve o `node:` de um comando para o arquivo real, **agnóstico de extensão** (SPEC-012 D2).
19
+ * Tenta `.ts → .js → .mjs`: em dev acha a fonte `.ts`; no pacote publicado, o `.js` sob `dist/`.
20
+ * Desacopla o registry do runtime — a entrada pode manter `.mjs` que este resolver ainda acha o
21
+ * `.ts` renomeado. Sem isto, renomear um script quebraria o dispatch.
22
+ *
23
+ * @param {string} root Raiz onde os scripts vivem (repo em dev, `dist/` no publicado).
24
+ * @param {string} node Caminho do registry, com ou sem extensão.
25
+ * @returns {string} Caminho absoluto do arquivo que existe (ou o candidato original, que falha visível).
26
+ */
27
+ export function resolveScript(root, node) {
28
+ const direct = path.join(root, node);
29
+ if (fs.existsSync(direct))
30
+ return direct;
31
+ const base = direct.replace(/\.(mjs|cjs|js|ts)$/, '');
32
+ for (const ext of ['.ts', '.js', '.ts']) {
33
+ if (fs.existsSync(base + ext))
34
+ return base + ext;
35
+ }
36
+ return direct;
37
+ }
38
+ export const DOMAINS = {
39
+ workspace: 'Workspace & projetos',
40
+ sdd: 'Pipeline SDD (spec → plan → tasks → check)',
41
+ gsd: 'GSD & handoffs',
42
+ design: 'Design',
43
+ code: 'Code intelligence (codegraph)',
44
+ memoria: 'Memória',
45
+ contexto: 'Contexto & token economy',
46
+ governanca: 'Governança & qualidade',
47
+ geracao: 'Geração de projetos',
48
+ };
49
+ export const COMMANDS = {
50
+ // --- Workspace & projetos ---------------------------------------------
51
+ 'workspace:init': {
52
+ domain: 'workspace',
53
+ desc: 'Cria a estrutura base do workspace (~/forja-workspace)',
54
+ node: 'scripts/agent-harness.ts',
55
+ args: ['workspace:init'],
56
+ },
57
+ 'project:new': {
58
+ domain: 'workspace',
59
+ desc: 'Cria projeto no workspace e registra ficha em 30-projects/',
60
+ node: 'scripts/agent-harness.ts',
61
+ args: ['project:new'],
62
+ gates: ['workspace'],
63
+ },
64
+ 'project:list': {
65
+ domain: 'workspace',
66
+ desc: 'Lista projetos do workspace',
67
+ node: 'scripts/agent-harness.ts',
68
+ args: ['project:list'],
69
+ },
70
+ 'workspace:project:check': {
71
+ domain: 'workspace',
72
+ desc: 'Valida padrões em um projeto do workspace',
73
+ node: 'scripts/agent-harness.ts',
74
+ args: ['project:check'],
75
+ gates: ['workspace'],
76
+ },
77
+ // --- Pipeline SDD -------------------------------------------------------
78
+ 'spec:new': {
79
+ domain: 'sdd',
80
+ desc: 'Cria specs/<slug>/spec.md a partir do template',
81
+ node: 'scripts/spec-cli.ts',
82
+ args: ['new'],
83
+ },
84
+ 'spec:plan': {
85
+ domain: 'sdd',
86
+ desc: 'Deriva plan.md de uma spec',
87
+ node: 'scripts/spec-cli.ts',
88
+ args: ['plan'],
89
+ },
90
+ 'spec:tasks': {
91
+ domain: 'sdd',
92
+ desc: 'Decompõe plan.md em tasks.md',
93
+ node: 'scripts/spec-cli.ts',
94
+ args: ['tasks'],
95
+ },
96
+ 'spec:check': {
97
+ domain: 'sdd',
98
+ desc: 'Valida completude da spec (gate de governança)',
99
+ node: 'scripts/spec-cli.ts',
100
+ args: ['check'],
101
+ },
102
+ // --- GSD & handoffs ------------------------------------------------------
103
+ 'gsd:plan': {
104
+ domain: 'gsd',
105
+ desc: 'Cria runbook GSD em .context/',
106
+ node: 'scripts/agent-harness.ts',
107
+ args: ['gsd:plan'],
108
+ },
109
+ 'gsd:handoff': {
110
+ domain: 'gsd',
111
+ desc: 'Registra handoff GSD padronizado (ADR-0005)',
112
+ node: 'scripts/agent-harness.ts',
113
+ args: ['gsd:handoff'],
114
+ },
115
+ 'gsd:check': {
116
+ domain: 'gsd',
117
+ desc: 'Valida gates básicos do runbook GSD',
118
+ node: 'scripts/agent-harness.ts',
119
+ args: ['gsd:check'],
120
+ },
121
+ 'hermes:handoff': {
122
+ domain: 'gsd',
123
+ desc: 'Registra handoff ADR-0005 bruto via agent-router',
124
+ node: 'scripts/agent-harness.ts',
125
+ args: ['hermes:handoff'],
126
+ },
127
+ 'agent:route': {
128
+ domain: 'gsd',
129
+ desc: 'Roteia/inspeciona handoffs (agent-router)',
130
+ node: 'scripts/agent-router.ts',
131
+ },
132
+ 'sprint:start': {
133
+ domain: 'gsd',
134
+ desc: 'Inicia sprint',
135
+ node: 'scripts/sprint-manager.js',
136
+ args: ['start'],
137
+ },
138
+ 'sprint:status': {
139
+ domain: 'gsd',
140
+ desc: 'Status da sprint atual',
141
+ node: 'scripts/sprint-manager.js',
142
+ args: ['status'],
143
+ },
144
+ 'sprint:complete': {
145
+ domain: 'gsd',
146
+ desc: 'Encerra sprint',
147
+ node: 'scripts/sprint-manager.js',
148
+ args: ['complete'],
149
+ },
150
+ // --- Design ---------------------------------------------------------------
151
+ 'design:check': {
152
+ domain: 'design',
153
+ desc: 'Valida brief visual antes do handoff',
154
+ node: 'scripts/agent-harness.ts',
155
+ args: ['design:check'],
156
+ },
157
+ 'design:select': {
158
+ domain: 'design',
159
+ desc: 'Sugere referências design-md por superfície',
160
+ node: 'scripts/agent-harness.ts',
161
+ args: ['design:select'],
162
+ },
163
+ // --- Code intelligence ------------------------------------------------------
164
+ 'code:check': {
165
+ domain: 'code',
166
+ desc: 'Valida índice codegraph (worktree + freshness)',
167
+ node: 'scripts/agent-harness.ts',
168
+ args: ['code:check'],
169
+ },
170
+ 'code:impact': {
171
+ domain: 'code',
172
+ desc: 'Chamadores + blast radius de um símbolo',
173
+ node: 'scripts/agent-harness.ts',
174
+ args: ['code:impact'],
175
+ },
176
+ 'code:index': {
177
+ domain: 'code',
178
+ desc: 'Inicializa índice codegraph',
179
+ bin: 'codegraph',
180
+ args: ['init'],
181
+ },
182
+ 'code:sync': {
183
+ domain: 'code',
184
+ desc: 'Sincroniza índice codegraph',
185
+ bin: 'codegraph',
186
+ args: ['sync'],
187
+ },
188
+ 'code:status': {
189
+ domain: 'code',
190
+ desc: 'Status do índice codegraph',
191
+ bin: 'codegraph',
192
+ args: ['status'],
193
+ },
194
+ 'code:query': {
195
+ domain: 'code',
196
+ desc: 'Consulta o índice codegraph',
197
+ bin: 'codegraph',
198
+ args: ['query'],
199
+ },
200
+ // --- Memória -----------------------------------------------------------------
201
+ 'sync:universal': {
202
+ domain: 'memoria',
203
+ desc: 'Reindexa a memória universal (SQLite FTS5)',
204
+ node: 'scripts/sync-universal-memory.js',
205
+ gates: ['workspace-warn'],
206
+ },
207
+ 'query:universal': {
208
+ domain: 'memoria',
209
+ desc: 'Busca FTS5 na memória universal',
210
+ node: 'scripts/query-universal-memory.js',
211
+ gates: ['workspace-warn'],
212
+ },
213
+ 'memory:compress': {
214
+ domain: 'memoria',
215
+ desc: 'Arquiva runs antigos e compacta memória de projeto',
216
+ node: 'scripts/compress-project-memory.js',
217
+ },
218
+ 'memory:vacuum': {
219
+ domain: 'memoria',
220
+ desc: 'Comprime e limpa memória (archive + VACUUM)',
221
+ node: 'scripts/compress-memory.ts',
222
+ },
223
+ 'memory:schema': {
224
+ domain: 'memoria',
225
+ desc: 'Garante schema do SQLite de memória',
226
+ node: 'scripts/memory-schema.ts',
227
+ },
228
+ 'memory:extract': {
229
+ domain: 'memoria',
230
+ desc: 'Extrai conhecimento global da memória',
231
+ node: 'scripts/extract-global-knowledge.js',
232
+ },
233
+ // --- Contexto & token economy ---------------------------------------------
234
+ 'context:smart': {
235
+ domain: 'contexto',
236
+ desc: 'Gera smart-context (3 modos, ADR-0003)',
237
+ node: 'scripts/build-smart-context.js',
238
+ gates: ['workspace-warn'],
239
+ },
240
+ 'context:budget': {
241
+ domain: 'contexto',
242
+ desc: 'Orçamento de tokens do contexto',
243
+ node: 'scripts/context-ops.ts',
244
+ args: ['budget'],
245
+ },
246
+ 'context:sprint': {
247
+ domain: 'contexto',
248
+ desc: 'Pacote de contexto da sprint',
249
+ node: 'scripts/context-ops.ts',
250
+ args: ['sprint-pack'],
251
+ },
252
+ 'agent:brief': {
253
+ domain: 'contexto',
254
+ desc: 'Brief de contexto para um agente',
255
+ node: 'scripts/context-ops.ts',
256
+ args: ['agent-brief'],
257
+ },
258
+ 'catalog:assets': {
259
+ domain: 'contexto',
260
+ desc: 'Catálogo de assets do repo',
261
+ node: 'scripts/context-ops.ts',
262
+ args: ['asset-catalog'],
263
+ },
264
+ 'catalog:manifests': {
265
+ domain: 'contexto',
266
+ desc: 'Catálogo de manifests',
267
+ node: 'scripts/context-ops.ts',
268
+ args: ['manifests'],
269
+ },
270
+ 'token:benchmark': {
271
+ domain: 'contexto',
272
+ desc: 'Benchmark de consumo de tokens',
273
+ node: 'scripts/token-benchmark.ts',
274
+ },
275
+ // --- Governança & qualidade ---------------------------------------------------
276
+ 'project:check': {
277
+ domain: 'governanca',
278
+ desc: 'Standards check do framework (pre-commit)',
279
+ node: 'scripts/check-standards.js',
280
+ },
281
+ 'tools:doctor': {
282
+ domain: 'governanca',
283
+ desc: 'Raio-x do núcleo (gate, exit 1) + ferramentas de processo (ADR-0023, ADR-0018)',
284
+ node: 'scripts/tools-doctor.ts',
285
+ },
286
+ 'release:check': {
287
+ domain: 'governanca',
288
+ desc: 'Gate do tarball: instala limpo e prova que o pacote funciona (ADR-0024). --publish para o modo estrito',
289
+ node: 'scripts/release-check.ts',
290
+ },
291
+ 'project:dashboard': {
292
+ domain: 'governanca',
293
+ desc: 'Gera dashboard estático de status',
294
+ node: 'scripts/generate-dashboard.js',
295
+ },
296
+ 'audit:sync': {
297
+ domain: 'governanca',
298
+ desc: 'Projeta a trilha de auditoria (.jsonl) numa tabela consultável (SPEC-014)',
299
+ node: 'scripts/audit-sync.ts',
300
+ },
301
+ 'audit:query': {
302
+ domain: 'governanca',
303
+ desc: 'Consulta a auditoria: --failed, --cmd <x>, --since 7d',
304
+ node: 'scripts/audit-query.ts',
305
+ },
306
+ 'governance:dashboard': {
307
+ domain: 'governanca',
308
+ desc: 'Gera um painel HTML estático de governança (gates, SDD, auditoria) — leitura, sem servidor',
309
+ node: 'scripts/governance-dashboard.ts',
310
+ },
311
+ // --- Geração ----------------------------------------------------------------------
312
+ 'init:project': {
313
+ domain: 'geracao',
314
+ desc: 'Gera projeto direto num path (prefira project:new)',
315
+ node: 'bin/init-project.js',
316
+ },
317
+ };