forjajs 4.1.1 → 5.0.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 (181) hide show
  1. package/.claude/settings.json +2 -2
  2. package/.gemini-instructions.md +1 -1
  3. package/.github/copilot-instructions.md +1 -1
  4. package/.openai-instructions.md +1 -1
  5. package/CHANGELOG.md +125 -0
  6. package/DOC-MAP.md +2 -2
  7. package/README.md +62 -10
  8. package/README.pt-BR.md +46 -7
  9. package/boilerplates/01-api-rest/README.md +1 -1
  10. package/boilerplates/06-clean-arch/README.md +5 -3
  11. package/boilerplates/06-clean-arch/backend/.oxlintrc.json +10 -0
  12. package/boilerplates/06-clean-arch/backend/nest-cli.json +8 -0
  13. package/boilerplates/06-clean-arch/backend/package.json +22 -24
  14. package/boilerplates/06-clean-arch/backend/src/app.module.ts +4 -4
  15. package/boilerplates/06-clean-arch/backend/src/main.ts +2 -2
  16. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/place-order.usecase.ts +4 -4
  17. package/boilerplates/06-clean-arch/backend/src/modules/orders/application/ship-order.usecase.ts +2 -2
  18. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.entity.ts +3 -3
  19. package/boilerplates/06-clean-arch/backend/src/modules/orders/domain/order.repository.ts +1 -1
  20. package/boilerplates/06-clean-arch/backend/src/modules/orders/infrastructure/typeorm-order.repository.ts +5 -5
  21. package/boilerplates/06-clean-arch/backend/src/modules/orders/orders.module.ts +6 -6
  22. package/boilerplates/06-clean-arch/backend/src/modules/orders/presentation/orders.controller.ts +3 -3
  23. package/boilerplates/06-clean-arch/backend/src/modules/products/products.controller.ts +1 -1
  24. package/boilerplates/06-clean-arch/backend/src/modules/products/products.module.ts +2 -2
  25. package/boilerplates/06-clean-arch/backend/test/orders/place-order.spec.ts +2 -2
  26. package/boilerplates/06-clean-arch/backend/tsconfig.build.json +15 -0
  27. package/boilerplates/06-clean-arch/backend/tsconfig.json +24 -10
  28. package/boilerplates/06-clean-arch/backend/vitest.config.ts +11 -0
  29. package/boilerplates/06-clean-arch/boilerplate.manifest.json +6 -5
  30. package/boilerplates/README.md +24 -44
  31. package/dist/apps/cli/src/index.js +6 -6
  32. package/dist/apps/dashboard/next.config.d.mts +5 -5
  33. package/dist/apps/server/src/app.module.js +1 -1
  34. package/dist/apps/server/src/forja-nest.module.js +1 -1
  35. package/dist/apps/server/src/index.js +1 -1
  36. package/dist/apps/server/src/main.js +20 -20
  37. package/dist/apps/worker/src/main.js +4 -4
  38. package/dist/bin/create-memory-nest-kit.js +5 -5
  39. package/dist/bin/forja.js +28 -14
  40. package/dist/bin/init-project.d.ts +4 -9
  41. package/dist/bin/init-project.js +126 -182
  42. package/dist/lib/audit.js +1 -1
  43. package/dist/lib/context-builder.d.ts +6 -1
  44. package/dist/lib/context-builder.js +21 -12
  45. package/dist/lib/core/architecture-gate.js +2 -4
  46. package/dist/lib/core/checks.d.ts +1 -1
  47. package/dist/lib/core/drift-gate.js +2 -4
  48. package/dist/lib/core/gates.js +5 -5
  49. package/dist/lib/core/health.d.ts +0 -1
  50. package/dist/lib/core/health.js +33 -7
  51. package/dist/lib/core/journey.d.ts +30 -0
  52. package/dist/lib/core/journey.js +142 -0
  53. package/dist/lib/core/model-pricing.js +3 -5
  54. package/dist/lib/core/project-smoke.d.ts +6 -2
  55. package/dist/lib/core/project-smoke.js +60 -61
  56. package/dist/lib/core/registry.d.ts +1 -12
  57. package/dist/lib/core/registry.js +42 -32
  58. package/dist/lib/core/release.d.ts +1 -1
  59. package/dist/lib/core/release.js +31 -3
  60. package/dist/lib/core/risk-collect.js +4 -4
  61. package/dist/lib/drift-sentinel.js +1 -1
  62. package/dist/lib/generators/memory-generator.d.ts +30 -30
  63. package/dist/lib/generators/memory-generator.js +19 -8
  64. package/dist/lib/generators/nest-generator.js +192 -275
  65. package/dist/lib/generators/readme-generator.js +1 -1
  66. package/dist/lib/governance-report.js +4 -4
  67. package/dist/lib/handoffs-index.d.ts +16 -2
  68. package/dist/lib/handoffs-index.js +32 -5
  69. package/dist/lib/llm/session.js +1 -1
  70. package/dist/lib/llm/validation.js +1 -1
  71. package/dist/lib/memory-audit.js +1 -1
  72. package/dist/lib/paths.d.ts +39 -0
  73. package/dist/lib/paths.js +73 -0
  74. package/dist/lib/project-wiring.d.ts +54 -0
  75. package/dist/lib/project-wiring.js +391 -0
  76. package/dist/lib/specs-index.d.ts +1 -0
  77. package/dist/lib/specs-index.js +22 -3
  78. package/dist/lib/status-model.js +24 -8
  79. package/dist/lib/templates.d.ts +24 -0
  80. package/dist/lib/templates.js +77 -0
  81. package/dist/lib/validators/structure-validator.js +0 -1
  82. package/dist/lib/workspace.d.ts +7 -0
  83. package/dist/lib/workspace.js +33 -3
  84. package/dist/packages/adapter-git/src/index.js +2 -2
  85. package/dist/packages/context/src/index.js +1 -1
  86. package/dist/packages/core/src/index.js +1 -1
  87. package/dist/packages/evals/src/index.js +1 -1
  88. package/dist/packages/events/src/index.js +1 -1
  89. package/dist/packages/graph/src/index.js +1 -1
  90. package/dist/packages/mcp/src/index.d.ts +1 -1
  91. package/dist/packages/observability/src/index.js +1 -1
  92. package/dist/packages/orchestration/src/index.js +1 -1
  93. package/dist/packages/planner/src/index.js +1 -1
  94. package/dist/packages/policy/src/index.js +1 -1
  95. package/dist/packages/runtime/src/index.js +1 -1
  96. package/dist/packages/sandbox/src/index.js +1 -1
  97. package/dist/packages/validator/src/index.js +1 -1
  98. package/dist/scripts/adr.js +4 -4
  99. package/dist/scripts/agent-harness.js +30 -23
  100. package/dist/scripts/agent-router.js +22 -5
  101. package/dist/scripts/agent.js +5 -5
  102. package/dist/scripts/architecture.js +6 -6
  103. package/dist/scripts/audit-query.js +1 -1
  104. package/dist/scripts/audit-sync.js +1 -1
  105. package/dist/scripts/build-smart-context.d.ts +19 -1
  106. package/dist/scripts/build-smart-context.js +84 -68
  107. package/dist/scripts/check-standards.js +8 -3
  108. package/dist/scripts/code-context.js +1 -1
  109. package/dist/scripts/compress-memory.js +3 -2
  110. package/dist/scripts/compress-project-memory.js +2 -2
  111. package/dist/scripts/context-ops.js +13 -5
  112. package/dist/scripts/cost-economy.js +4 -4
  113. package/dist/scripts/demo-autonomy.js +11 -11
  114. package/dist/scripts/demo-workspace.js +12 -4
  115. package/dist/scripts/dev.js +8 -7
  116. package/dist/scripts/drift-check.js +5 -5
  117. package/dist/scripts/engineer.js +11 -11
  118. package/dist/scripts/evidence.js +4 -4
  119. package/dist/scripts/extract-global-knowledge.js +6 -4
  120. package/dist/scripts/forja-setup.js +2 -1
  121. package/dist/scripts/forja-status.d.ts +1 -1
  122. package/dist/scripts/forja-status.js +31 -3
  123. package/dist/scripts/gates.js +1 -1
  124. package/dist/scripts/generate-dashboard.js +6 -4
  125. package/dist/scripts/governance-dashboard.js +2 -2
  126. package/dist/scripts/hook-session-start.js +18 -9
  127. package/dist/scripts/hook-user-prompt.js +3 -2
  128. package/dist/scripts/incident.js +4 -4
  129. package/dist/scripts/llm-fit.js +11 -11
  130. package/dist/scripts/memory-audit.js +1 -1
  131. package/dist/scripts/memory-schema.js +3 -2
  132. package/dist/scripts/orchestrate.js +4 -5
  133. package/dist/scripts/project-smoke.js +13 -2
  134. package/dist/scripts/project-templates.d.ts +1 -0
  135. package/dist/scripts/project-templates.js +20 -0
  136. package/dist/scripts/project-upgrade.d.ts +13 -0
  137. package/dist/scripts/project-upgrade.js +107 -40
  138. package/dist/scripts/project-wire.d.ts +8 -0
  139. package/dist/scripts/project-wire.js +55 -0
  140. package/dist/scripts/provenance.js +3 -3
  141. package/dist/scripts/query-universal-memory.js +7 -4
  142. package/dist/scripts/release-check.js +1 -1
  143. package/dist/scripts/risk.js +4 -4
  144. package/dist/scripts/simulate.js +9 -9
  145. package/dist/scripts/spec-cli.d.ts +1 -0
  146. package/dist/scripts/spec-cli.js +25 -5
  147. package/dist/scripts/sprint-manager.js +21 -8
  148. package/dist/scripts/sync-universal-memory.js +50 -27
  149. package/dist/scripts/token-benchmark.js +4 -3
  150. package/dist/scripts/token-economy.js +4 -3
  151. package/dist/scripts/tools-doctor.d.ts +1 -1
  152. package/dist/scripts/tools-doctor.js +25 -3
  153. package/docs/GUIA-ONBOARDING-EXECUTIVO.md +1 -2
  154. package/docs/GUIA-ONBOARDING-OPERACIONAL-PAPEIS.md +5 -6
  155. package/docs/GUIA-ONBOARDING-PROJETO.md +7 -9
  156. package/docs/glossary.md +4 -4
  157. package/docs/init-project.md +88 -444
  158. package/docs/manual-operacional-cli-sdd-gsd.md +1 -1
  159. package/docs/modos-de-operacao.md +1 -1
  160. package/docs/processo-projeto.md +14 -11
  161. package/docs/produto/roteiro-demo.md +15 -18
  162. package/docs/publishing.md +5 -0
  163. package/docs/quick-reference.md +15 -23
  164. package/docs/structure.md +16 -30
  165. package/lib/core/model-pricing.json +19 -0
  166. package/memory/30-projects/README.md +1 -1
  167. package/memory/90-decisions/0022-congelar-dashboard-web.md +1 -1
  168. package/memory/90-decisions/0086-projeto-conectado-e-jornada-como-gate.md +95 -0
  169. package/memory/90-decisions/0087-remover-dashboard-legado.md +35 -0
  170. package/memory/90-decisions/0088-templates-validados.md +55 -0
  171. package/package.json +25 -25
  172. package/templates/project/AGENTS.md +75 -0
  173. package/templates/project/CLAUDE.md +9 -0
  174. package/templates/project/agents/context-engineer.md +15 -0
  175. package/templates/project/agents/governance.md +15 -0
  176. package/templates/project/agents/marketing.md +15 -0
  177. package/templates/project/agents/orchestrator.md +15 -0
  178. package/templates/project/agents/product.md +15 -0
  179. package/templates/project/agents/sdd-architect.md +15 -0
  180. package/dist/lib/multi-ai-instructions.d.ts +0 -28
  181. package/dist/lib/multi-ai-instructions.js +0 -83
@@ -3,129 +3,167 @@
3
3
  * Extraído de create-memory-nest-kit.js para modularização
4
4
  */
5
5
  import path from 'node:path';
6
- import { writeFileSafe, ensureDir, maybeGitkeep } from "../utils/file-helpers.js";
6
+ import { writeFileSafe, ensureDir, maybeGitkeep } from '../utils/file-helpers.js';
7
7
  /**
8
8
  * Factory de templates NestJS dinâmicos
9
9
  * Recebe projectName para interpolar em package.json
10
10
  */
11
11
  function createNestTemplates(projectName) {
12
12
  return {
13
+ // Backend alinhado ao `nest new` do NestJS 12 (ESM + nodenext, Vitest, oxlint). O Nest 12 é
14
+ // ESM-only: o template CommonJS + Jest anterior compilava, mas `npm test` não carregava.
13
15
  'backend/package.json': `{
14
16
  "name": "${projectName}-api",
15
17
  "version": "0.1.0",
16
18
  "private": true,
19
+ "type": "module",
17
20
  "scripts": {
18
21
  "build": "nest build",
19
22
  "start": "nest start",
20
23
  "start:dev": "nest start --watch",
21
24
  "start:prod": "node dist/main",
22
- "lint": "eslint \\"src/**/*.ts\\" --max-warnings=0",
23
25
  "format": "prettier --write \\"src/**/*.ts\\" \\"test/**/*.ts\\"",
24
- "test": "jest",
25
- "test:watch": "jest --watch",
26
- "test:cov": "jest --coverage",
27
- "memory:db:init": "node scripts/memory-db-init.mjs",
28
- "memory:db:sync": "node scripts/memory-db-sync.mjs",
29
- "memory:db:query": "node scripts/memory-db-query.mjs",
26
+ "lint": "oxlint --type-aware src/ test/",
27
+ "test": "vitest run",
28
+ "test:watch": "vitest",
29
+ "test:cov": "vitest run --coverage",
30
+ "test:e2e": "vitest run --config ./vitest.config.e2e.ts",
31
+ "memory:db:sync": "cd .. && forja sync:universal",
32
+ "memory:db:query": "cd .. && forja query:universal",
30
33
  "memory:watch": "node ../scripts/memory-watcher.mjs"
31
34
  },
32
- "jest": {
33
- "moduleFileExtensions": ["js", "json", "ts"],
34
- "rootDir": "src",
35
- "testRegex": ".*\\\\.spec\\\\.ts$",
36
- "transform": {
37
- "^.+\\\\.(t|j)s$": "ts-jest"
38
- },
39
- "collectCoverageFrom": ["**/*.(t|j)s"],
40
- "coverageDirectory": "../coverage",
41
- "testEnvironment": "node"
42
- },
43
35
  "dependencies": {
44
- "@nestjs/common": "^11.0.0",
45
- "@nestjs/core": "^11.0.0",
46
- "@nestjs/platform-express": "^11.0.0",
47
- "better-sqlite3": "^12.11.1",
36
+ "@nestjs/common": "^12.1.2",
37
+ "@nestjs/core": "^12.1.2",
38
+ "@nestjs/platform-express": "^12.1.2",
39
+ "better-sqlite3": "^13.0.3",
48
40
  "reflect-metadata": "^0.2.2",
49
- "rxjs": "^7.8.1"
41
+ "rxjs": "^7.8.2"
50
42
  },
51
43
  "devDependencies": {
52
- "@nestjs/cli": "^11.0.0",
53
- "@nestjs/schematics": "^11.0.0",
54
- "@nestjs/testing": "^11.0.0",
55
- "@types/express": "^5.0.1",
56
- "@types/better-sqlite3": "^7.6.13",
57
- "@types/jest": "^29.5.14",
58
- "@types/node": "^22.10.2",
59
- "@types/supertest": "^6.0.2",
60
- "eslint": "^9.16.0",
61
- "eslint-config-prettier": "^9.1.0",
62
- "jest": "^29.7.0",
63
- "prettier": "^3.4.2",
64
- "supertest": "^7.0.0",
65
- "ts-jest": "^29.2.5",
66
- "ts-loader": "^9.5.1",
67
- "ts-node": "^10.9.2",
68
- "tsconfig-paths": "^4.2.0",
69
- "typescript": "^5.7.2"
44
+ "@nestjs/cli": "^12.0.8",
45
+ "@nestjs/schematics": "^12.0.6",
46
+ "@nestjs/testing": "^12.1.2",
47
+ "@types/better-sqlite3": "^9.6.0",
48
+ "@types/express": "^5.0.6",
49
+ "@types/node": "^26.6.4",
50
+ "@types/supertest": "^7.2.1",
51
+ "@vitest/coverage-v8": "^5.0.3",
52
+ "oxlint": "^1.87.0",
53
+ "oxlint-tsgolint": "^7.0.2003",
54
+ "prettier": "^3.9.9",
55
+ "source-map-support": "^0.5.21",
56
+ "supertest": "^7.3.1",
57
+ "typescript": "^6.0.3",
58
+ "vite-tsconfig-paths": "^6.1.1",
59
+ "vitest": "^5.0.3"
70
60
  }
71
61
  }
72
62
  `,
73
63
  'backend/nest-cli.json': `{
64
+ "$schema": "https://json.schemastore.org/nest-cli",
74
65
  "collection": "@nestjs/schematics",
75
- "sourceRoot": "src"
66
+ "sourceRoot": "src",
67
+ "compilerOptions": {
68
+ "deleteOutDir": true
69
+ }
76
70
  }
77
71
  `,
78
72
  'backend/tsconfig.json': `{
79
73
  "compilerOptions": {
80
- "module": "commonjs",
74
+ "module": "nodenext",
75
+ "moduleResolution": "nodenext",
76
+ "resolvePackageJsonExports": true,
77
+ "esModuleInterop": true,
78
+ "isolatedModules": true,
81
79
  "declaration": true,
82
80
  "removeComments": true,
83
81
  "emitDecoratorMetadata": true,
84
82
  "experimentalDecorators": true,
85
83
  "allowSyntheticDefaultImports": true,
86
- "target": "es2021",
84
+ "target": "ES2023",
87
85
  "sourceMap": true,
88
86
  "outDir": "./dist",
89
- "baseUrl": "./",
87
+ "rootDir": ".",
90
88
  "incremental": true,
89
+ "skipLibCheck": true,
91
90
  "strict": true,
92
- "skipLibCheck": true
91
+ "strictPropertyInitialization": false,
92
+ "types": ["vitest/globals", "node"]
93
93
  }
94
94
  }
95
95
  `,
96
96
  'backend/tsconfig.build.json': `{
97
97
  "extends": "./tsconfig.json",
98
+ "compilerOptions": {
99
+ "rootDir": "./src"
100
+ },
101
+ "include": ["src"],
98
102
  "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
99
103
  }
104
+ `,
105
+ 'backend/vitest.config.ts': `import { defineConfig } from 'vitest/config';
106
+ import tsconfigPaths from 'vite-tsconfig-paths';
107
+
108
+ export default defineConfig({
109
+ plugins: [tsconfigPaths()],
110
+ test: {
111
+ globals: true,
112
+ root: './',
113
+ include: ['src/**/*.spec.ts'],
114
+ },
115
+ });
116
+ `,
117
+ 'backend/vitest.config.e2e.ts': `import { defineConfig } from 'vitest/config';
118
+ import tsconfigPaths from 'vite-tsconfig-paths';
119
+
120
+ export default defineConfig({
121
+ plugins: [tsconfigPaths()],
122
+ test: {
123
+ globals: true,
124
+ root: './',
125
+ include: ['test/**/*.e2e-spec.ts'],
126
+ },
127
+ });
128
+ `,
129
+ 'backend/.oxlintrc.json': `{
130
+ "$schema": "./node_modules/oxlint/configuration_schema.json",
131
+ "rules": {
132
+ "typescript/no-explicit-any": "off",
133
+ "typescript/no-floating-promises": "error"
134
+ },
135
+ "env": {
136
+ "node": true
137
+ }
138
+ }
100
139
  `,
101
140
  'backend/src/main.ts': `import { NestFactory } from '@nestjs/core';
102
- import { AppModule } from './app.module';
141
+ import { AppModule } from './app.module.js';
103
142
 
104
143
  async function bootstrap(): Promise<void> {
105
144
  const app = await NestFactory.create(AppModule);
106
145
  app.setGlobalPrefix('api');
107
- // Lets Nest call each provider's onModuleDestroy (e.g. OpsService closing its sqlite handle)
108
- // on SIGINT/SIGTERM instead of the process exiting with the database handle left open.
146
+ // Chama o onModuleDestroy de cada provider (ex.: OpsService fechando o SQLite) em SIGINT/SIGTERM.
109
147
  app.enableShutdownHooks();
110
148
  await app.listen(process.env.PORT ? Number(process.env.PORT) : 3000);
111
149
  }
112
150
 
113
- void bootstrap();
151
+ await bootstrap();
114
152
  `,
115
- 'backend/src/app.module.ts': `import { Module } from "@nestjs/common";
116
- import { AppController } from "./app.controller";
117
- import { AppService } from "./app.service";
118
- import { OpsModule } from "./modules/ops/ops.module";
153
+ 'backend/src/app.module.ts': `import { Module } from '@nestjs/common';
154
+ import { AppController } from './app.controller.js';
155
+ import { AppService } from './app.service.js';
156
+ import { OpsModule } from './modules/ops/ops.module.js';
119
157
 
120
158
  @Module({
121
159
  imports: [OpsModule],
122
160
  controllers: [AppController],
123
- providers: [AppService]
161
+ providers: [AppService],
124
162
  })
125
163
  export class AppModule {}
126
164
  `,
127
165
  'backend/src/app.controller.ts': `import { Controller, Get } from '@nestjs/common';
128
- import { AppService } from './app.service';
166
+ import { AppService } from './app.service.js';
129
167
 
130
168
  @Controller()
131
169
  export class AppController {
@@ -146,142 +184,122 @@ export class AppService {
146
184
  }
147
185
  }
148
186
  `,
187
+ // Painel operacional ligado à memória do Forja (memory/sqlite/universal.db do projeto): specs,
188
+ // handoffs e memória indexada. Antes lia um .memory/sqlite/context.db que nunca existia e o
189
+ // backend lançava ao subir.
149
190
  'backend/src/modules/ops/ops.service.ts': `import { Injectable, OnModuleDestroy } from '@nestjs/common';
150
- import * as Database from 'better-sqlite3';
151
- import * as path from 'node:path';
191
+ import Database from 'better-sqlite3';
192
+ import { existsSync } from 'node:fs';
193
+ import { resolve } from 'node:path';
194
+
195
+ export interface OpsStats {
196
+ readonly indexed: boolean;
197
+ readonly specs: { slug: string; status: string; title: string }[];
198
+ readonly handoffs: { id: number; from_agent: string; to_agent: string; intent: string; status: string; created_at: string }[];
199
+ readonly memory: { kind: string; count: number }[];
200
+ }
201
+
202
+ const EMPTY: OpsStats = { indexed: false, specs: [], handoffs: [], memory: [] };
152
203
 
153
204
  @Injectable()
154
205
  export class OpsService implements OnModuleDestroy {
155
- private db: any;
206
+ private readonly db: Database.Database | null;
156
207
 
157
208
  constructor() {
158
- const dbPath = path.resolve(process.cwd(), '..', '.memory', 'sqlite', 'context.db');
159
- this.db = new (Database as any)(dbPath, { readonly: true });
209
+ // O backend roda em <projeto>/backend; a memória do projeto fica em <projeto>/memory/sqlite.
210
+ const dbPath = process.env.FORJA_DB ?? resolve(process.cwd(), '..', 'memory', 'sqlite', 'universal.db');
211
+ this.db = existsSync(dbPath) ? new Database(dbPath, { readonly: true, fileMustExist: true }) : null;
160
212
  }
161
213
 
162
- getStats() {
163
- const agents = this.db.prepare('SELECT agent_name, status, current_task FROM agent_sessions').all();
164
- const tasks = this.db.prepare('SELECT status, COUNT(*) as count FROM tasks GROUP BY status').all();
165
- const handoffs = this.db.prepare('SELECT from_agent, to_agent, title, created_at FROM handoffs ORDER BY created_at DESC LIMIT 5').all();
214
+ private all<T>(sql: string): T[] {
215
+ try {
216
+ return (this.db?.prepare(sql).all() as T[]) ?? [];
217
+ } catch {
218
+ return []; // tabela ainda não criada (ex.: nenhum handoff registrado)
219
+ }
220
+ }
166
221
 
167
- return { agents, tasks, handoffs };
222
+ getStats(): OpsStats {
223
+ if (!this.db) return EMPTY;
224
+ return {
225
+ indexed: true,
226
+ specs: this.all('SELECT slug, status, title FROM spec_summaries ORDER BY slug'),
227
+ handoffs: this.all("SELECT id, from_agent, to_agent, intent, status, created_at FROM handoffs WHERE status IN ('open','in_progress') ORDER BY id DESC LIMIT 10"),
228
+ memory: this.all('SELECT kind, COUNT(*) AS count FROM memory_nodes GROUP BY kind ORDER BY count DESC'),
229
+ };
168
230
  }
169
231
 
170
- // Closes the sqlite handle on SIGINT/SIGTERM (via app.enableShutdownHooks() in main.ts),
171
- // rather than leaving it open for the process to exit around.
172
- onModuleDestroy() {
173
- this.db.close();
232
+ onModuleDestroy(): void {
233
+ this.db?.close();
174
234
  }
175
235
  }
176
236
  `,
177
- 'backend/src/modules/ops/ops.controller.ts': `import { Controller, Get } from '@nestjs/common';
178
- import { OpsService } from './ops.service';
237
+ 'backend/src/modules/ops/ops.controller.ts': `import { Controller, Get, Header } from '@nestjs/common';
238
+ import { OpsService, type OpsStats } from './ops.service.js';
179
239
 
180
- /** Escapa HTML para evitar XSS refletido/armazenado via agent_name/current_task/status/title etc. (dados livres vindos do SQLite). */
240
+ /** Escapa HTML: os dados vêm de arquivos e handoffs livres. */
181
241
  function esc(value: unknown): string {
182
242
  return String(value).replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' } as Record<string, string>)[c]);
183
243
  }
184
244
 
245
+ function list<T>(items: T[], empty: string, row: (item: T) => string): string {
246
+ return items.length ? items.map(row).join('') : \`<li class="muted">\${empty}</li>\`;
247
+ }
248
+
249
+ export function renderOps(stats: OpsStats): string {
250
+ const body = stats.indexed
251
+ ? \`<section><h2>Specs</h2><ul>\${list(stats.specs, 'nenhuma spec — forja spec:new <slug>', (s) => \`<li><b>\${esc(s.slug)}</b> <span class="tag">\${esc(s.status)}</span> \${esc(s.title)}</li>\`)}</ul></section>
252
+ <section><h2>Handoffs em aberto</h2><ul>\${list(stats.handoffs, 'nenhum handoff em aberto', (h) => \`<li>#\${esc(h.id)} \${esc(h.from_agent)} → \${esc(h.to_agent)} <span class="tag">\${esc(h.intent)}</span></li>\`)}</ul></section>
253
+ <section><h2>Memória indexada</h2><ul>\${list(stats.memory, 'memória vazia', (m) => \`<li>\${esc(m.kind)}: \${esc(m.count)}</li>\`)}</ul></section>\`
254
+ : '<p class="muted">Memória ainda não indexada. Rode <code>forja sync:universal</code> na raiz do projeto.</p>';
255
+ return \`<!DOCTYPE html>
256
+ <html lang="pt-BR">
257
+ <head>
258
+ <meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">
259
+ <meta http-equiv="refresh" content="30">
260
+ <title>Ops — Forja</title>
261
+ <style>
262
+ body { font-family: system-ui, sans-serif; background: #0f172a; color: #e2e8f0; margin: 0; padding: 2rem; }
263
+ main { max-width: 960px; margin: 0 auto; display: grid; gap: 1.5rem; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); }
264
+ h1 { max-width: 960px; margin: 0 auto 1.5rem; font-size: 1.5rem; }
265
+ section { background: #1e293b; border-radius: 12px; padding: 1rem 1.25rem; }
266
+ h2 { font-size: 1rem; margin-top: 0; } ul { list-style: none; padding: 0; margin: 0; } li { padding: .35rem 0; border-bottom: 1px solid #334155; }
267
+ .tag { background: #334155; border-radius: 6px; padding: 0 .4rem; font-size: .8rem; } .muted { color: #94a3b8; }
268
+ </style>
269
+ </head>
270
+ <body><h1>Ops do projeto</h1><main>\${body}</main></body>
271
+ </html>\`;
272
+ }
273
+
185
274
  @Controller('ops')
186
275
  export class OpsController {
187
276
  constructor(private readonly opsService: OpsService) {}
188
277
 
189
278
  @Get('stats')
190
- getStats() {
279
+ getStats(): OpsStats {
191
280
  return this.opsService.getStats();
192
281
  }
193
282
 
194
283
  @Get()
195
- renderDashboard() {
196
- const stats = this.opsService.getStats();
197
-
198
- return \`
199
- <!DOCTYPE html>
200
- <html lang="pt-BR">
201
- <head>
202
- <meta charset="UTF-8">
203
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
204
- <title>Agentes Ops Dashboard</title>
205
- <script src="https://cdn.tailwindcss.com"><\/script>
206
- <meta http-equiv="refresh" content="30">
207
- </head>
208
- <body class="bg-gray-900 text-gray-100 font-sans p-8">
209
- <div class="max-w-6xl mx-auto">
210
- <header class="flex justify-between items-center mb-12">
211
- <h1 class="text-3xl font-bold text-blue-400">🚀 Agentes Operacionais</h1>
212
- <div class="text-sm text-gray-400">Sincronizado via SQLite</div>
213
- </header>
214
-
215
- <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
216
- <!-- Agentes -->
217
- <section class="bg-gray-800 p-6 rounded-xl border border-gray-700">
218
- <h2 class="text-xl font-semibold mb-4 flex items-center">
219
- <span class="mr-2">🤖</span> Status dos Agentes
220
- </h2>
221
- <div class="space-y-4">
222
- \${stats.agents.map((a: any) => \`
223
- <div class="p-3 bg-gray-900 rounded-lg border-l-4 \${a.status === 'IDLE' ? 'border-green-500' : 'border-yellow-500'}">
224
- <div class="font-bold">\${esc(a.agent_name)}</div>
225
- <div class="text-xs text-gray-400">\${esc(a.status)} \${a.current_task ? ' - ' + esc(a.current_task) : ''}</div>
226
- </div>
227
- \`).join('')}
228
- </div>
229
- </section>
230
-
231
- <!-- Tarefas -->
232
- <section class="bg-gray-800 p-6 rounded-xl border border-gray-700">
233
- <h2 class="text-xl font-semibold mb-4 flex items-center">
234
- <span class="mr-2">📊</span> Backlog & Progresso
235
- </h2>
236
- <div class="space-y-4">
237
- \${stats.tasks.map((t: any) => \`
238
- <div class="flex justify-between items-center">
239
- <span class="capitalize">\${esc(t.status)}</span>
240
- <span class="bg-blue-600 px-2 py-1 rounded text-xs">\${esc(t.count)}</span>
241
- </div>
242
- \`).join('')}
243
- </div>
244
- </section>
245
-
246
- <!-- Handoffs -->
247
- <section class="bg-gray-800 p-6 rounded-xl border border-gray-700">
248
- <h2 class="text-xl font-semibold mb-4 flex items-center">
249
- <span class="mr-2">🤝</span> Últimos Handoffs
250
- </h2>
251
- <div class="space-y-3">
252
- \${stats.handoffs.map((h: any) => \`
253
- <div class="text-xs border-b border-gray-700 pb-2">
254
- <div class="text-blue-300 font-medium">\${esc(h.from_agent)} → \${esc(h.to_agent)}</div>
255
- <div class="text-gray-400 truncate">\${esc(h.title)}</div>
256
- </div>
257
- \`).join('')}
258
- </div>
259
- </section>
260
- </div>
261
-
262
- <footer class="mt-12 text-center text-gray-500 text-xs">
263
- Atualizado em: \${new Date().toLocaleString('pt-BR')} | create-memory-nest-kit v0.5.0
264
- </footer>
265
- </div>
266
- </body>
267
- </html>
268
- \`;
284
+ @Header('Content-Type', 'text/html; charset=utf-8')
285
+ renderDashboard(): string {
286
+ return renderOps(this.opsService.getStats());
269
287
  }
270
288
  }
271
289
  `,
272
290
  'backend/src/modules/ops/ops.module.ts': `import { Module } from '@nestjs/common';
273
- import { OpsController } from './ops.controller';
274
- import { OpsService } from './ops.service';
291
+ import { OpsController } from './ops.controller.js';
292
+ import { OpsService } from './ops.service.js';
275
293
 
276
294
  @Module({
277
295
  controllers: [OpsController],
278
- providers: [OpsService]
296
+ providers: [OpsService],
279
297
  })
280
298
  export class OpsModule {}
281
299
  `,
282
300
  'backend/src/app.controller.spec.ts': `import { Test, TestingModule } from '@nestjs/testing';
283
- import { AppController } from './app.controller';
284
- import { AppService } from './app.service';
301
+ import { AppController } from './app.controller.js';
302
+ import { AppService } from './app.service.js';
285
303
 
286
304
  describe('AppController', () => {
287
305
  let controller: AppController;
@@ -289,7 +307,7 @@ describe('AppController', () => {
289
307
  beforeEach(async () => {
290
308
  const module: TestingModule = await Test.createTestingModule({
291
309
  controllers: [AppController],
292
- providers: [AppService]
310
+ providers: [AppService],
293
311
  }).compile();
294
312
 
295
313
  controller = module.get<AppController>(AppController);
@@ -303,59 +321,35 @@ describe('AppController', () => {
303
321
  'backend/test/app.e2e-spec.ts': `import { Test, TestingModule } from '@nestjs/testing';
304
322
  import { INestApplication } from '@nestjs/common';
305
323
  import request from 'supertest';
306
- import { AppModule } from '../src/app.module';
324
+ import { App } from 'supertest/types.js';
325
+ import { AppModule } from '../src/app.module.js';
307
326
 
308
- describe('AppController (e2e)', () => {
309
- let app: INestApplication;
327
+ describe('API (e2e)', () => {
328
+ let app: INestApplication<App>;
310
329
 
311
330
  beforeEach(async () => {
312
331
  const moduleFixture: TestingModule = await Test.createTestingModule({
313
- imports: [AppModule]
332
+ imports: [AppModule],
314
333
  }).compile();
315
334
 
316
335
  app = moduleFixture.createNestApplication();
336
+ app.setGlobalPrefix('api');
317
337
  await app.init();
318
338
  });
319
339
 
340
+ afterEach(async () => {
341
+ await app.close();
342
+ });
343
+
320
344
  it('/api/health (GET)', async () => {
321
- await request(app.getHttpServer())
322
- .get('/api/health')
323
- .expect(200)
324
- .expect({ status: 'ok' });
345
+ await request(app.getHttpServer()).get('/api/health').expect(200).expect({ status: 'ok' });
346
+ });
347
+
348
+ it('/api/ops/stats (GET) responde mesmo sem memória indexada', async () => {
349
+ const res = await request(app.getHttpServer()).get('/api/ops/stats').expect(200);
350
+ expect(res.body).toHaveProperty('indexed');
325
351
  });
326
352
  });
327
- `,
328
- 'backend/jest-e2e.json': `{
329
- "moduleFileExtensions": ["js", "json", "ts"],
330
- "rootDir": ".",
331
- "testEnvironment": "node",
332
- "testRegex": ".e2e-spec.ts$",
333
- "transform": {
334
- "^.+\\\\.(t|j)s$": "ts-jest"
335
- }
336
- }
337
- `,
338
- 'backend/.eslintrc.json': `{
339
- "parser": "@typescript-eslint/parser",
340
- "parserOptions": {
341
- "project": "tsconfig.json",
342
- "sourceType": "module"
343
- },
344
- "plugins": ["@typescript-eslint/eslint-plugin"],
345
- "extends": ["plugin:@typescript-eslint/recommended", "prettier"],
346
- "root": true,
347
- "env": {
348
- "node": true,
349
- "jest": true
350
- },
351
- "ignorePatterns": [".eslintrc.js"],
352
- "rules": {
353
- "@typescript-eslint/interface-name-prefix": "off",
354
- "@typescript-eslint/explicit-function-return-type": "off",
355
- "@typescript-eslint/explicit-module-boundary-types": "off",
356
- "@typescript-eslint/no-explicit-any": "off"
357
- }
358
- }
359
353
  `,
360
354
  'backend/.prettierrc': `{
361
355
  "singleQuote": true,
@@ -367,85 +361,6 @@ describe('AppController (e2e)', () => {
367
361
  `,
368
362
  };
369
363
  }
370
- /**
371
- * Templates dos scripts de banco de dados (estáticos)
372
- */
373
- const databaseScriptTemplates = {
374
- 'backend/scripts/memory-db-schema.sql': `PRAGMA journal_mode = WAL;
375
- PRAGMA foreign_keys = ON;
376
-
377
- CREATE TABLE IF NOT EXISTS documents (
378
- id INTEGER PRIMARY KEY AUTOINCREMENT,
379
- path TEXT NOT NULL UNIQUE,
380
- kind TEXT NOT NULL,
381
- title TEXT,
382
- content_hash TEXT NOT NULL,
383
- content TEXT NOT NULL,
384
- updated_at TEXT NOT NULL
385
- );
386
-
387
- CREATE TABLE IF NOT EXISTS document_chunks (
388
- id INTEGER PRIMARY KEY AUTOINCREMENT,
389
- document_id INTEGER NOT NULL,
390
- chunk_index INTEGER NOT NULL,
391
- content TEXT NOT NULL,
392
- token_estimate INTEGER NOT NULL DEFAULT 0,
393
- FOREIGN KEY(document_id) REFERENCES documents(id) ON DELETE CASCADE
394
- );
395
-
396
- CREATE UNIQUE INDEX IF NOT EXISTS idx_document_chunks_unique
397
- ON document_chunks (document_id, chunk_index);
398
-
399
- CREATE TABLE IF NOT EXISTS handoffs (
400
- id INTEGER PRIMARY KEY AUTOINCREMENT,
401
- file_path TEXT NOT NULL UNIQUE,
402
- from_agent TEXT,
403
- to_agent TEXT,
404
- title TEXT,
405
- created_at TEXT NOT NULL,
406
- status TEXT NOT NULL DEFAULT 'open'
407
- );
408
-
409
- CREATE TABLE IF NOT EXISTS adrs (
410
- id INTEGER PRIMARY KEY AUTOINCREMENT,
411
- adr_code TEXT NOT NULL UNIQUE,
412
- title TEXT NOT NULL,
413
- file_path TEXT NOT NULL UNIQUE,
414
- status TEXT NOT NULL DEFAULT 'accepted',
415
- updated_at TEXT NOT NULL
416
- );
417
-
418
- CREATE TABLE IF NOT EXISTS summaries (
419
- id INTEGER PRIMARY KEY AUTOINCREMENT,
420
- scope TEXT NOT NULL,
421
- scope_key TEXT NOT NULL,
422
- file_path TEXT NOT NULL UNIQUE,
423
- summary TEXT NOT NULL,
424
- updated_at TEXT NOT NULL
425
- );
426
-
427
- CREATE UNIQUE INDEX IF NOT EXISTS idx_summaries_scope
428
- ON summaries (scope, scope_key);
429
-
430
- CREATE TABLE IF NOT EXISTS tasks (
431
- id INTEGER PRIMARY KEY AUTOINCREMENT,
432
- task_key TEXT NOT NULL UNIQUE,
433
- title TEXT NOT NULL,
434
- status TEXT NOT NULL DEFAULT 'open',
435
- owner_agent TEXT,
436
- source_file TEXT NOT NULL,
437
- updated_at TEXT NOT NULL
438
- );
439
-
440
- CREATE TABLE IF NOT EXISTS agent_sessions (
441
- id INTEGER PRIMARY KEY AUTOINCREMENT,
442
- agent_name TEXT NOT NULL UNIQUE,
443
- status TEXT NOT NULL DEFAULT 'IDLE',
444
- current_task TEXT,
445
- updated_at TEXT NOT NULL
446
- );
447
- `,
448
- };
449
364
  /**
450
365
  * Gera estrutura completa do NestJS backend
451
366
  * @param {string} baseDir - Diretório base
@@ -454,7 +369,9 @@ CREATE TABLE IF NOT EXISTS agent_sessions (
454
369
  */
455
370
  export function generateNestStructure(baseDir, projectName, options = {}) {
456
371
  const dynamicTemplates = createNestTemplates(projectName);
457
- const allTemplates = { ...dynamicTemplates, ...databaseScriptTemplates };
372
+ // A memória do projeto é a universal do Forja (forja sync:universal); o banco paralelo do backend
373
+ // (memory-db-*.mjs) nunca foi gerado e seus scripts apontavam para o vazio — removido na v5.
374
+ const allTemplates = { ...dynamicTemplates };
458
375
  // Escrever todos os arquivos
459
376
  for (const [relativePath, content] of Object.entries(allTemplates)) {
460
377
  writeFileSafe(path.join(baseDir, relativePath), content, options);
@@ -2,7 +2,7 @@
2
2
  * README Generator - Gera README.md para novo projeto
3
3
  */
4
4
  import path from 'node:path';
5
- import { writeFileSafe } from "../utils/file-helpers.js";
5
+ import { writeFileSafe } from '../utils/file-helpers.js';
6
6
  /**
7
7
  * Factory para README dinâmico
8
8
  */
@@ -12,8 +12,8 @@
12
12
  import fs from 'node:fs';
13
13
  import path from 'node:path';
14
14
  import { fileURLToPath } from 'node:url';
15
- import { COMMANDS } from "./core/registry.js";
16
- import { auditSummary, lastExit, defaultEnv as auditEnv } from "./audit.js";
15
+ import { COMMANDS } from './core/registry.js';
16
+ import { auditSummary, lastExit, defaultEnv as auditEnv } from './audit.js';
17
17
  const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
18
18
  const STATUS_RE = /-\s*\*\*Status\*\*:\s*([a-z]+)/i;
19
19
  const NUCLEO = ['native-abi', 'memory-db', 'memory-fresh', 'workspace', 'node-engines', 'runtime-deps', 'mcp-json'];
@@ -65,8 +65,8 @@ function countAdrs(env) {
65
65
  async function collectGates(env) {
66
66
  // Importa os catálogos como dados. Cada check: { id, title, severity }.
67
67
  const [{ CHECKS }, { RELEASE_CHECKS }] = await Promise.all([
68
- import("./core/health.js"),
69
- import("./core/release.js"),
68
+ import('./core/health.js'),
69
+ import('./core/release.js'),
70
70
  ]);
71
71
  const pick = (ids) => CHECKS.filter((c) => ids.includes(c.id)).map((c) => ({ id: c.id, severity: c.severity }));
72
72
  // Estado = último exit do comando na auditoria (não reexecuta — D4). Degrada para "?" sem audit.