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,253 +0,0 @@
1
- /**
2
- * Structure Validator - Valida integridade da estrutura gerada
3
- * Garante que todos os diretórios e arquivos críticos foram criados
4
- */
5
-
6
- import fs from 'node:fs';
7
- import path from 'node:path';
8
-
9
- /**
10
- * Lista dos arquivos críticos que devem existir
11
- */
12
- const CRITICAL_FILES = [
13
- 'memory/00-global/mission.md',
14
- 'memory/00-global/standards.md',
15
- 'memory/10-product/vision.md',
16
- 'memory/20-architecture/backend.md',
17
- 'memory/40-delivery/current-sprint.md',
18
- 'memory/50-orchestration/topology.md',
19
- 'AGENTS.md',
20
- '.memoryrc.json',
21
- ];
22
-
23
- /**
24
- * Lista de diretórios críticos
25
- */
26
- const CRITICAL_DIRS = [
27
- 'memory',
28
- 'memory/00-global',
29
- 'memory/10-product',
30
- 'memory/20-architecture',
31
- 'memory/30-domains',
32
- 'memory/40-delivery',
33
- 'memory/50-orchestration',
34
- 'memory/60-runs',
35
- 'memory/70-summaries',
36
- 'agents',
37
- 'skills',
38
- 'prompts',
39
- '.memory/sqlite',
40
- ];
41
-
42
- /**
43
- * Validações específicas do NestJS backend
44
- */
45
- const NEST_CRITICAL_FILES = [
46
- 'backend/package.json',
47
- 'backend/src/main.ts',
48
- 'backend/src/app.module.ts',
49
- 'backend/src/app.controller.ts',
50
- 'backend/src/app.service.ts',
51
- 'backend/tsconfig.json',
52
- ];
53
-
54
- const NEST_CRITICAL_DIRS = [
55
- 'backend/src',
56
- 'backend/src/modules/ops',
57
- 'backend/test',
58
- 'backend/scripts',
59
- ];
60
-
61
- /**
62
- * Valida estrutura de memória
63
- * @param {string} baseDir - Diretório base
64
- * @returns {Object} Resultado da validação
65
- */
66
- export function validateMemoryStructure(baseDir) {
67
- const errors = [];
68
- const warnings = [];
69
-
70
- // Validar arquivos críticos
71
- for (const filePath of CRITICAL_FILES) {
72
- const abs = path.join(baseDir, filePath);
73
- if (!fs.existsSync(abs)) {
74
- errors.push(`Arquivo crítico não encontrado: ${filePath}`);
75
- }
76
- }
77
-
78
- // Validar diretórios críticos
79
- for (const dirPath of CRITICAL_DIRS) {
80
- const abs = path.join(baseDir, dirPath);
81
- if (!fs.existsSync(abs)) {
82
- errors.push(`Diretório crítico não encontrado: ${dirPath}`);
83
- } else if (!fs.statSync(abs).isDirectory()) {
84
- errors.push(`Não é um diretório: ${dirPath}`);
85
- }
86
- }
87
-
88
- // Validar conteúdo de mission.md
89
- const missionPath = path.join(baseDir, 'memory/00-global/mission.md');
90
- if (fs.existsSync(missionPath)) {
91
- const content = fs.readFileSync(missionPath, 'utf8');
92
- if (!content.includes('Missao') && !content.includes('Missão')) {
93
- warnings.push('mission.md parece estar vazio ou incorreto');
94
- }
95
- }
96
-
97
- // Validar .memoryrc.json é JSON válido
98
- const memoryrcPath = path.join(baseDir, '.memoryrc.json');
99
- if (fs.existsSync(memoryrcPath)) {
100
- try {
101
- const content = fs.readFileSync(memoryrcPath, 'utf8');
102
- JSON.parse(content);
103
- } catch (e) {
104
- errors.push('.memoryrc.json é JSON inválido');
105
- }
106
- }
107
-
108
- return {
109
- isValid: errors.length === 0,
110
- errors,
111
- warnings,
112
- checklist: {
113
- memoryStructure: CRITICAL_DIRS.length,
114
- memoryFiles: CRITICAL_FILES.length,
115
- },
116
- };
117
- }
118
-
119
- /**
120
- * Valida estrutura NestJS
121
- * @param {string} baseDir - Diretório base
122
- * @returns {Object} Resultado da validação
123
- */
124
- export function validateNestStructure(baseDir) {
125
- const errors = [];
126
- const warnings = [];
127
-
128
- // Validar arquivos críticos do NestJS
129
- for (const filePath of NEST_CRITICAL_FILES) {
130
- const abs = path.join(baseDir, filePath);
131
- if (!fs.existsSync(abs)) {
132
- errors.push(`Arquivo NestJS não encontrado: ${filePath}`);
133
- }
134
- }
135
-
136
- // Validar diretórios críticos do NestJS
137
- for (const dirPath of NEST_CRITICAL_DIRS) {
138
- const abs = path.join(baseDir, dirPath);
139
- if (!fs.existsSync(abs)) {
140
- errors.push(`Diretório NestJS não encontrado: ${dirPath}`);
141
- }
142
- }
143
-
144
- // Validar package.json
145
- const pkgPath = path.join(baseDir, 'backend/package.json');
146
- if (fs.existsSync(pkgPath)) {
147
- try {
148
- const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
149
- if (!pkg.dependencies['@nestjs/common']) {
150
- errors.push('package.json não contém @nestjs/common');
151
- }
152
- } catch (e) {
153
- errors.push('backend/package.json é JSON inválido');
154
- }
155
- }
156
-
157
- // Validar tsconfig.json
158
- const tsconfigPath = path.join(baseDir, 'backend/tsconfig.json');
159
- if (fs.existsSync(tsconfigPath)) {
160
- try {
161
- JSON.parse(fs.readFileSync(tsconfigPath, 'utf8'));
162
- } catch (e) {
163
- errors.push('backend/tsconfig.json é JSON inválido');
164
- }
165
- }
166
-
167
- return {
168
- isValid: errors.length === 0,
169
- errors,
170
- warnings,
171
- checklist: {
172
- nestDirectories: NEST_CRITICAL_DIRS.length,
173
- nestFiles: NEST_CRITICAL_FILES.length,
174
- },
175
- };
176
- }
177
-
178
- /**
179
- * Valida estrutura completa do projeto
180
- * @param {string} baseDir - Diretório base
181
- * @param {Object} options - Opções { includeNest: boolean }
182
- * @returns {Object} Resultado completo
183
- */
184
- export function validateProjectStructure(baseDir, options = {}) {
185
- const { includeNest = false } = options;
186
-
187
- const memoryResult = validateMemoryStructure(baseDir);
188
- const results = { memory: memoryResult };
189
-
190
- if (includeNest) {
191
- results.nest = validateNestStructure(baseDir);
192
- }
193
-
194
- const allErrors = [
195
- ...memoryResult.errors,
196
- ...(results.nest?.errors || []),
197
- ];
198
-
199
- return {
200
- isValid: allErrors.length === 0,
201
- errors: allErrors,
202
- warnings: [
203
- ...memoryResult.warnings,
204
- ...(results.nest?.warnings || []),
205
- ],
206
- results,
207
- summary: {
208
- totalErrors: allErrors.length,
209
- hasNest: includeNest,
210
- timestamp: new Date().toISOString(),
211
- },
212
- };
213
- }
214
-
215
- /**
216
- * Imprime relatório de validação de forma amigável
217
- * @param {Object} report - Resultado de validateProjectStructure
218
- */
219
- export function printValidationReport(report) {
220
- if (report.isValid) {
221
- console.log('✅ Estrutura do projeto é válida!');
222
- } else {
223
- console.log('❌ Estrutura do projeto tem problemas:');
224
- console.log('');
225
- for (const error of report.errors) {
226
- console.log(` ❌ ${error}`);
227
- }
228
- }
229
-
230
- if (report.warnings.length > 0) {
231
- console.log('');
232
- console.log('⚠️ Avisos:');
233
- for (const warning of report.warnings) {
234
- console.log(` ⚠️ ${warning}`);
235
- }
236
- }
237
-
238
- if (report.summary) {
239
- console.log('');
240
- console.log(`📊 Verificado em: ${report.summary.timestamp}`);
241
- }
242
- }
243
-
244
- export default {
245
- validateProjectStructure,
246
- validateMemoryStructure,
247
- validateNestStructure,
248
- printValidationReport,
249
- CRITICAL_FILES,
250
- CRITICAL_DIRS,
251
- NEST_CRITICAL_FILES,
252
- NEST_CRITICAL_DIRS,
253
- };
package/lib/workspace.mjs DELETED
@@ -1,213 +0,0 @@
1
- /**
2
- * lib/workspace.mjs
3
- *
4
- * Centraliza a resolução de caminhos do workspace Forja.
5
- *
6
- * Regras de prioridade para descobrir o workspace:
7
- * 1. Variável de ambiente FORJA_WORKSPACE
8
- * 2. Arquivo ~/.forjarc.json (campo workspaceRoot)
9
- * 3. Default: ~/forja-workspace
10
- *
11
- * O workspace é o "canto fixo" onde projetos de produto vivem:
12
- * ~/forja-workspace/
13
- * projects/ # projetos gerados
14
- * memory/ # memória universal do workspace
15
- * sqlite/universal.db # SQLite FTS5
16
- * 30-projects/ # fichas de projetos
17
- * specs/ # specs de produto
18
- * .context/ # runbooks GSD de produto
19
- * .forjarc.json # config local do workspace (opcional)
20
- */
21
-
22
- import fs from 'node:fs';
23
- import path from 'node:path';
24
- import os from 'node:os';
25
- import { fileURLToPath } from 'node:url';
26
-
27
- const __filename = fileURLToPath(import.meta.url);
28
- const __dirname = path.dirname(__filename);
29
-
30
- const DEFAULT_WORKSPACE_NAME = 'forja-workspace';
31
-
32
- function getHomeDir() {
33
- return os.homedir();
34
- }
35
-
36
- function readJsonSafe(filePath) {
37
- try {
38
- const raw = fs.readFileSync(filePath, 'utf8');
39
- return JSON.parse(raw);
40
- } catch {
41
- return null;
42
- }
43
- }
44
-
45
- export function getUserConfigPath() {
46
- return path.join(getHomeDir(), '.forjarc.json');
47
- }
48
-
49
- export function getWorkspaceRoot() {
50
- if (process.env.FORJA_WORKSPACE) {
51
- return path.resolve(process.env.FORJA_WORKSPACE);
52
- }
53
-
54
- const userConfig = readJsonSafe(getUserConfigPath());
55
- if (userConfig?.workspaceRoot) {
56
- return path.resolve(userConfig.workspaceRoot);
57
- }
58
-
59
- return path.join(getHomeDir(), DEFAULT_WORKSPACE_NAME);
60
- }
61
-
62
- export function getWorkspaceInfo() {
63
- const root = getWorkspaceRoot();
64
- return {
65
- root,
66
- source: process.env.FORJA_WORKSPACE
67
- ? 'FORJA_WORKSPACE'
68
- : fs.existsSync(getUserConfigPath())
69
- ? '~/.forjarc.json'
70
- : 'default',
71
- exists: fs.existsSync(root),
72
- };
73
- }
74
-
75
- export function getProjectsDir() {
76
- return path.join(getWorkspaceRoot(), 'projects');
77
- }
78
-
79
- export function getWorkspaceMemoryDir() {
80
- return path.join(getWorkspaceRoot(), 'memory');
81
- }
82
-
83
- export function getWorkspaceDbDir() {
84
- return path.join(getWorkspaceMemoryDir(), 'sqlite');
85
- }
86
-
87
- export function getWorkspaceDbPath() {
88
- return path.join(getWorkspaceDbDir(), 'universal.db');
89
- }
90
-
91
- export function getWorkspaceProjectsMemoryDir() {
92
- return path.join(getWorkspaceMemoryDir(), '30-projects');
93
- }
94
-
95
- export function getWorkspaceSpecsDir() {
96
- return path.join(getWorkspaceRoot(), 'specs');
97
- }
98
-
99
- export function getWorkspaceContextDir() {
100
- return path.join(getWorkspaceRoot(), '.context');
101
- }
102
-
103
- export function resolveProject(name) {
104
- if (!name || typeof name !== 'string') {
105
- throw new Error('Nome do projeto é obrigatório');
106
- }
107
- const safe = name.toLowerCase().replace(/[^a-z0-9._-]+/g, '-');
108
- if (!safe) {
109
- throw new Error(`Nome de projeto inválido: ${name}`);
110
- }
111
- return path.join(getProjectsDir(), safe);
112
- }
113
-
114
- export function listProjects() {
115
- const dir = getProjectsDir();
116
- if (!fs.existsSync(dir)) return [];
117
- return fs
118
- .readdirSync(dir, { withFileTypes: true })
119
- .filter((entry) => entry.isDirectory())
120
- .map((entry) => entry.name);
121
- }
122
-
123
- export function ensureDir(dir) {
124
- if (!fs.existsSync(dir)) {
125
- fs.mkdirSync(dir, { recursive: true });
126
- }
127
- return dir;
128
- }
129
-
130
- export function initWorkspace() {
131
- const root = ensureDir(getWorkspaceRoot());
132
- ensureDir(getProjectsDir());
133
- ensureDir(getWorkspaceMemoryDir());
134
- ensureDir(getWorkspaceDbDir());
135
- ensureDir(getWorkspaceProjectsMemoryDir());
136
- ensureDir(getWorkspaceSpecsDir());
137
- ensureDir(getWorkspaceContextDir());
138
-
139
- // Cria README de convenção no workspace
140
- const readmePath = path.join(root, 'README.md');
141
- if (!fs.existsSync(readmePath)) {
142
- fs.writeFileSync(
143
- readmePath,
144
- `# Forja Workspace
145
-
146
- Este é o workspace de produção do Forja. Aqui vivem projetos gerados, memória universal e specs de produto.
147
-
148
- ## Estrutura
149
-
150
- - \`projects/\` — projetos gerados pelo Forja.
151
- - \`memory/sqlite/universal.db\` — memória universal indexada (SQLite + FTS5).
152
- - \`memory/30-projects/\` — fichas dos projetos.
153
- - \`specs/\` — specs de produto.
154
- - \`.context/\` — runbooks GSD de produto.
155
-
156
- ## Configuração
157
-
158
- O caminho do workspace é resolvido por prioridade:
159
-
160
- 1. Variável \`FORJA_WORKSPACE\`
161
- 2. Campo \`workspaceRoot\` em \`~/.forjarc.json\`
162
- 3. Padrão: \`~/forja-workspace\`
163
-
164
- ## Comandos úteis
165
-
166
- - \`npm run dev -- workspace:init\` — recria estrutura base.
167
- - \`npm run dev -- project:new <nome>\` — cria novo projeto.
168
- - \`npm run dev -- project:list\` — lista projetos.
169
- - \`npm run dev -- project:check <nome>\` — valida padrões.
170
- `,
171
- 'utf8'
172
- );
173
- }
174
-
175
- // Cria .forjarc.json local apenas se não houver config global
176
- const localConfigPath = path.join(root, '.forjarc.json');
177
- if (!fs.existsSync(localConfigPath) && !fs.existsSync(getUserConfigPath()) && !process.env.FORJA_WORKSPACE) {
178
- fs.writeFileSync(
179
- localConfigPath,
180
- JSON.stringify({ workspaceRoot: root }, null, 2) + '\n',
181
- 'utf8'
182
- );
183
- }
184
-
185
- // Cria README em 30-projects
186
- const projectsMemoryReadme = path.join(getWorkspaceProjectsMemoryDir(), 'README.md');
187
- if (!fs.existsSync(projectsMemoryReadme)) {
188
- fs.writeFileSync(
189
- projectsMemoryReadme,
190
- `# Projetos do Workspace
191
-
192
- Fichas de projetos gerados pelo Forja. Cada arquivo representa um produto ativo ou arquivado.
193
- `,
194
- 'utf8'
195
- );
196
- }
197
-
198
- return root;
199
- }
200
-
201
- export function isInsideFrameworkRepo(filePath) {
202
- const frameworkRoot = path.resolve(__dirname, '..');
203
- const resolved = path.resolve(filePath);
204
- return resolved === frameworkRoot || resolved.startsWith(frameworkRoot + path.sep);
205
- }
206
-
207
- export function assertOutsideFrameworkRepo(filePath, operation = 'operacao') {
208
- if (isInsideFrameworkRepo(filePath)) {
209
- throw new Error(
210
- `${operation} não pode ser executada dentro do repositório do framework Forja. Use o workspace externo (~/forja-workspace).`
211
- );
212
- }
213
- }