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
@@ -1,125 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * create-memory-nest-kit v0.6.0
4
- * Orquestrador de geração de projetos com memória hierárquica
5
- *
6
- * Refatoração modular:
7
- * - lib/generators/memory-generator.js
8
- * - lib/generators/nest-generator.js
9
- * - lib/generators/readme-generator.js
10
- * - lib/validators/structure-validator.js
11
- * - lib/utils/file-helpers.js
12
- */
13
-
14
- import path from 'node:path';
15
- import process from 'node:process';
16
- import { fileURLToPath } from 'node:url';
17
- import { generateMemoryStructure } from '../lib/generators/memory-generator.js';
18
- import { generateNestStructure } from '../lib/generators/nest-generator.js';
19
- import { generateReadme } from '../lib/generators/readme-generator.js';
20
- import { validateProjectStructure, printValidationReport } from '../lib/validators/structure-validator.js';
21
- import { ensureDir, logSuccess, logError } from '../lib/utils/file-helpers.js';
22
-
23
- const __filename = fileURLToPath(import.meta.url);
24
- const __dirname = path.dirname(__filename);
25
-
26
- // Parse arguments
27
- const args = process.argv.slice(2);
28
- const showHelp = args.includes('--help') || args.includes('-h');
29
-
30
- if (showHelp) {
31
- console.log(`
32
- create-memory-nest-kit v0.6.0
33
-
34
- Uso:
35
- create-memory-nest-kit [diretorio] [opcoes]
36
-
37
- Opcoes:
38
- --force Sobrescreve arquivos existentes
39
- --only-memory Gera apenas estrutura de memoria/agents/skills
40
- --no-gitkeep Nao cria .gitkeep em diretorios vazios
41
- --no-validate Pula validacao apos geracao
42
- -h, --help Mostra esta ajuda
43
-
44
- Exemplos:
45
- node bin/create-memory-nest-kit.js meu-projeto
46
- node bin/create-memory-nest-kit.js meu-projeto --force
47
- node bin/create-memory-nest-kit.js meu-projeto --only-memory
48
- `);
49
- process.exit(0);
50
- }
51
-
52
- const options = {
53
- force: args.includes('--force'),
54
- noGitkeep: args.includes('--no-gitkeep'),
55
- onlyMemory: args.includes('--only-memory'),
56
- noValidate: args.includes('--no-validate'),
57
- };
58
-
59
- const rawTarget = args.find((a) => !a.startsWith('-')) || '.';
60
- const targetDir = path.resolve(process.cwd(), rawTarget);
61
- const projectName = path.basename(targetDir);
62
-
63
- /**
64
- * Orquestrador principal
65
- */
66
- async function run() {
67
- try {
68
- console.log(`\n📦 create-memory-nest-kit v0.6.0`);
69
- console.log(`📁 Projeto: ${projectName}`);
70
- console.log(`📍 Diretório: ${targetDir}\n`);
71
-
72
- // Passo 1: Garantir diretório
73
- console.log('🔨 Criando estrutura de diretórios...');
74
- ensureDir(targetDir);
75
-
76
- // Passo 2: Gerar memória
77
- console.log('📚 Gerando estrutura de memória...');
78
- const memoryResult = generateMemoryStructure(targetDir, options);
79
- console.log(` ✅ ${memoryResult.filesWritten} arquivos | ${memoryResult.emptyDirsCreated} diretórios`);
80
-
81
- // Passo 3: Gerar NestJS (se não for --only-memory)
82
- if (!options.onlyMemory) {
83
- console.log('🎭 Gerando backend NestJS...');
84
- const nestResult = generateNestStructure(targetDir, projectName, options);
85
- console.log(` ✅ ${nestResult.filesWritten} arquivos | ${nestResult.emptyDirsCreated} diretórios`);
86
- }
87
-
88
- // Passo 4: Gerar README
89
- console.log('📖 Gerando README.md...');
90
- const readmeResult = generateReadme(targetDir, projectName, options);
91
- console.log(` ✅ ${Math.round(readmeResult.size / 1024)}KB`);
92
-
93
- // Passo 5: Validar (se não for --no-validate)
94
- if (!options.noValidate) {
95
- console.log('\n🔍 Validando estrutura...');
96
- const validation = validateProjectStructure(targetDir, { includeNest: !options.onlyMemory });
97
- printValidationReport(validation);
98
-
99
- if (!validation.isValid) {
100
- logError('Falhas detectadas na validação');
101
- process.exit(1);
102
- }
103
- }
104
-
105
- // Sucesso!
106
- logSuccess(`Estrutura v0.6.0 criada com sucesso`);
107
- console.log(`\n➡️ Próximos passos:`);
108
- console.log(` 1) cd ${path.relative(process.cwd(), targetDir) || '.'}`);
109
- console.log(` 2) node scripts/build-context-pack.mjs`);
110
- if (!options.onlyMemory) {
111
- console.log(` 3) cd backend && npm install`);
112
- console.log(` 4) npm run start:dev`);
113
- }
114
- console.log('');
115
-
116
- } catch (error) {
117
- logError(error.message);
118
- if (process.env.DEBUG) {
119
- console.error(error.stack);
120
- }
121
- process.exit(1);
122
- }
123
- }
124
-
125
- run();
package/bin/forja.mjs DELETED
@@ -1,143 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * bin/forja.mjs — core executivo do Forja (ADR-0020).
5
- *
6
- * Ponto de entrada único dos comandos de processo:
7
- * forja <comando> [args]
8
- *
9
- * Responsabilidades transversais:
10
- * 1. Roteamento via lib/core/registry.mjs (declarativo).
11
- * 2. Gates antes do alvo (workspace, ADR-0019).
12
- * 3. Trilha de auditoria append-only em .context/forja-runs.jsonl.
13
- */
14
-
15
- import fs from 'node:fs';
16
- import path from 'node:path';
17
- import { spawnSync } from 'node:child_process';
18
- import { fileURLToPath } from 'node:url';
19
- import { COMMANDS, DOMAINS } from '../lib/core/registry.mjs';
20
- import { getWorkspaceInfo, getWorkspaceContextDir } from '../lib/workspace.mjs';
21
-
22
- const __dirname = path.dirname(fileURLToPath(import.meta.url));
23
- const root = path.resolve(__dirname, '..');
24
-
25
- function printHelp() {
26
- console.log('Forja — core executivo (ADR-0020)');
27
- console.log('Uso: forja <comando> [args]\n');
28
- const byDomain = new Map();
29
- for (const [name, cmd] of Object.entries(COMMANDS)) {
30
- if (!byDomain.has(cmd.domain)) byDomain.set(cmd.domain, []);
31
- byDomain.get(cmd.domain).push([name, cmd.desc]);
32
- }
33
- for (const [domain, label] of Object.entries(DOMAINS)) {
34
- const entries = byDomain.get(domain);
35
- if (!entries) continue;
36
- console.log(`${label}:`);
37
- for (const [name, desc] of entries) {
38
- console.log(` ${name.padEnd(24)} ${desc}`);
39
- }
40
- console.log('');
41
- }
42
- console.log('Toda execução é auditada em .context/forja-runs.jsonl (workspace, se existir).');
43
- }
44
-
45
- function suggest(input) {
46
- const names = Object.keys(COMMANDS);
47
- const prefix = input.split(':')[0];
48
- const near = names.filter((n) => n.startsWith(prefix) || n.includes(input));
49
- return near.slice(0, 5);
50
- }
51
-
52
- // Gates transversais (ADR-0020). Retorna lista de erros bloqueantes.
53
- function runGates(cmd) {
54
- const errors = [];
55
- for (const gate of cmd.gates || []) {
56
- if (gate === 'workspace' || gate === 'workspace-warn') {
57
- const info = getWorkspaceInfo();
58
- if (!info.exists) {
59
- const msg = `Workspace não encontrado em ${info.root} (fonte: ${info.source}).`;
60
- if (gate === 'workspace') {
61
- errors.push(`${msg}\n Corrija com: forja workspace:init`);
62
- } else {
63
- console.error(`Aviso: ${msg} Alguns dados podem cair no repo do framework.`);
64
- }
65
- }
66
- }
67
- }
68
- return errors;
69
- }
70
-
71
- // Auditoria nunca bloqueia o comando (NFR da SPEC-025).
72
- function audit(entry) {
73
- try {
74
- const info = getWorkspaceInfo();
75
- const dir = info.exists ? getWorkspaceContextDir() : path.join(root, '.context');
76
- fs.mkdirSync(dir, { recursive: true });
77
- fs.appendFileSync(path.join(dir, 'forja-runs.jsonl'), JSON.stringify(entry) + '\n', 'utf8');
78
- } catch (error) {
79
- console.error(`Aviso: auditoria indisponível (${error.message}).`);
80
- }
81
- }
82
-
83
- const [name, ...rest] = process.argv.slice(2);
84
-
85
- if (!name || name === 'help' || name === '--help' || name === '-h') {
86
- printHelp();
87
- process.exit(0);
88
- }
89
-
90
- const cmd = COMMANDS[name];
91
- if (!cmd) {
92
- console.error(`Comando desconhecido: ${name}`);
93
- const near = suggest(name);
94
- if (near.length) {
95
- console.error(`Você quis dizer: ${near.join(', ')}?`);
96
- }
97
- console.error('Liste tudo com: forja help');
98
- process.exit(1);
99
- }
100
-
101
- const gateErrors = runGates(cmd);
102
- if (gateErrors.length) {
103
- console.error(`Gate reprovado para ${name}:`);
104
- for (const err of gateErrors) console.error(`- ${err}`);
105
- audit({
106
- ts: new Date().toISOString(),
107
- cmd: name,
108
- args: rest,
109
- exitCode: 1,
110
- durationMs: 0,
111
- gate: 'blocked',
112
- });
113
- process.exit(1);
114
- }
115
-
116
- const started = Date.now();
117
- let result;
118
- if (cmd.node) {
119
- const script = path.join(root, cmd.node);
120
- result = spawnSync('node', [script, ...(cmd.args || []), ...rest], {
121
- cwd: root,
122
- stdio: 'inherit',
123
- });
124
- } else {
125
- result = spawnSync(cmd.bin, [...(cmd.args || []), ...rest], {
126
- cwd: root,
127
- stdio: 'inherit',
128
- });
129
- if (result.error && result.error.code === 'ENOENT') {
130
- console.error(`Binário não encontrado no PATH: ${cmd.bin}. Veja: forja tools:doctor`);
131
- result.status = 127;
132
- }
133
- }
134
-
135
- const exitCode = result.status ?? 1;
136
- audit({
137
- ts: new Date().toISOString(),
138
- cmd: name,
139
- args: rest,
140
- exitCode,
141
- durationMs: Date.now() - started,
142
- });
143
- process.exit(exitCode);