forjajs 1.2.0 → 1.3.1

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 +41 -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,464 @@
1
+ #!/usr/bin/env node
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import Database from 'better-sqlite3';
5
+ import { fileURLToPath } from 'node:url';
6
+ import { ensureSchema, getDbPath } from "./memory-schema.js";
7
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
8
+ const root = path.resolve(__dirname, '..');
9
+ const outDir = path.join(root, '.context');
10
+ const defaultLimit = readTokenLimit();
11
+ function estimateTokens(content) {
12
+ return Math.ceil(content.length / 4);
13
+ }
14
+ function readTokenLimit() {
15
+ const configPath = path.join(root, '.memoryrc.json');
16
+ if (!fs.existsSync(configPath))
17
+ return 8000;
18
+ try {
19
+ const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
20
+ return Number(config?.tokenLimits?.task) || 8000;
21
+ }
22
+ catch {
23
+ return 8000;
24
+ }
25
+ }
26
+ function ensureOutDir() {
27
+ fs.mkdirSync(outDir, { recursive: true });
28
+ }
29
+ function readIfExists(relPath, maxChars = 12000) {
30
+ const full = path.join(root, relPath);
31
+ if (!fs.existsSync(full))
32
+ return '';
33
+ return fs.readFileSync(full, 'utf8').slice(0, maxChars);
34
+ }
35
+ function firstHeading(content, fallback) {
36
+ const match = content.match(/^#\s+(.+)$/m);
37
+ return match ? match[1].trim() : fallback;
38
+ }
39
+ function specStatus(content) {
40
+ const match = content.match(/-\s+\*\*Status\*\*:\s+([^\n]+)/);
41
+ return match ? match[1].trim() : 'unknown';
42
+ }
43
+ function extractSection(content, heading, maxChars = 2200) {
44
+ const escaped = heading.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
45
+ const re = new RegExp(`^##\\s+${escaped}\\s*\\n([\\s\\S]*?)(?=^##\\s+|$)`, 'm');
46
+ const match = content.match(re);
47
+ return match ? match[1].trim().slice(0, maxChars) : '';
48
+ }
49
+ function listSpecs() {
50
+ const specsDir = path.join(root, 'specs');
51
+ if (!fs.existsSync(specsDir))
52
+ return [];
53
+ return fs.readdirSync(specsDir, { withFileTypes: true })
54
+ .filter((entry) => entry.isDirectory() && !entry.name.startsWith('_'))
55
+ .map((entry) => {
56
+ const slug = entry.name;
57
+ const specPath = path.join(specsDir, slug, 'spec.md');
58
+ const planPath = path.join(specsDir, slug, 'plan.md');
59
+ const tasksPath = path.join(specsDir, slug, 'tasks.md');
60
+ const spec = fs.existsSync(specPath) ? fs.readFileSync(specPath, 'utf8') : '';
61
+ return {
62
+ slug,
63
+ title: spec ? firstHeading(spec, slug) : slug,
64
+ status: spec ? specStatus(spec) : 'missing',
65
+ hasPlan: fs.existsSync(planPath),
66
+ hasTasks: fs.existsSync(tasksPath),
67
+ path: path.relative(root, specPath),
68
+ };
69
+ });
70
+ }
71
+ function openDb() {
72
+ ensureSchema({ silent: true });
73
+ return new Database(getDbPath(), { timeout: 5000 });
74
+ }
75
+ /** @param {number|null} [limitTokens] */
76
+ function recordContextRun(kind, slug, filePath, content, limitTokens = null) {
77
+ const db = openDb();
78
+ const tokens = estimateTokens(content);
79
+ const status = limitTokens && tokens > limitTokens ? 'over_budget' : 'ok';
80
+ db.prepare(`
81
+ INSERT INTO context_runs (created_at, kind, slug, path, bytes, estimated_tokens, limit_tokens, status)
82
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?)
83
+ `).run(new Date().toISOString(), kind, slug || null, path.relative(root, filePath), content.length, tokens, limitTokens, status);
84
+ db.close();
85
+ }
86
+ function upsertSpecSummary(slug, content) {
87
+ const db = openDb();
88
+ const title = firstHeading(content, slug);
89
+ const status = specStatus(content);
90
+ const problem = extractSection(content, '1. Problema', 900);
91
+ const value = extractSection(content, '2. Proposta de valor', 700);
92
+ const ac = extractSection(content, '4. Criterios de aceite', 1200) || extractSection(content, '4. Critérios de aceite', 1200);
93
+ const summary = [`## Problema\n${problem}`, `## Valor\n${value}`, `## AC\n${ac}`]
94
+ .filter((part) => !part.endsWith('\n'))
95
+ .join('\n\n')
96
+ .slice(0, 3500);
97
+ db.prepare(`
98
+ INSERT INTO spec_summaries (slug, status, title, summary, source_path, updated_at)
99
+ VALUES (?, ?, ?, ?, ?, ?)
100
+ ON CONFLICT(slug) DO UPDATE SET
101
+ status=excluded.status,
102
+ title=excluded.title,
103
+ summary=excluded.summary,
104
+ source_path=excluded.source_path,
105
+ updated_at=excluded.updated_at
106
+ `).run(slug, status, title, summary, `specs/${slug}/spec.md`, new Date().toISOString());
107
+ db.close();
108
+ }
109
+ function getOpenHandoffs(slug = null) {
110
+ if (!fs.existsSync(getDbPath()))
111
+ return [];
112
+ const db = openDb();
113
+ let rows;
114
+ try {
115
+ rows = slug
116
+ ? db.prepare("SELECT id, created_at, from_agent, to_agent, intent, status, context, acceptance FROM handoffs WHERE spec_slug = ? AND status != 'archived' ORDER BY id DESC LIMIT 10").all(slug)
117
+ : db.prepare("SELECT id, created_at, from_agent, to_agent, intent, status, spec_slug, context, acceptance FROM handoffs WHERE status = 'open' ORDER BY id DESC LIMIT 20").all();
118
+ }
119
+ catch {
120
+ rows = [];
121
+ }
122
+ db.close();
123
+ return rows;
124
+ }
125
+ function latestAdrs() {
126
+ const dir = path.join(root, 'memory', '90-decisions');
127
+ if (!fs.existsSync(dir))
128
+ return [];
129
+ return fs.readdirSync(dir)
130
+ .filter((file) => file.endsWith('.md') && file !== '_template.md')
131
+ .sort()
132
+ .slice(-6)
133
+ .map((file) => {
134
+ const rel = path.join('memory/90-decisions', file);
135
+ const content = readIfExists(rel, 1500);
136
+ return { rel, title: firstHeading(content, file) };
137
+ });
138
+ }
139
+ function cmdBudget([target, limitArg]) {
140
+ if (!target) {
141
+ console.error('Uso: context-ops budget <slug|arquivo> [limite_tokens]');
142
+ process.exit(1);
143
+ }
144
+ const limit = Number(limitArg) || defaultLimit;
145
+ const candidates = [
146
+ target,
147
+ `.context/gsd-${target}.md`,
148
+ `.context/agent-brief-${target}.md`,
149
+ `.context/context-task.md`,
150
+ ];
151
+ const file = candidates.map((candidate) => path.resolve(root, candidate)).find((candidate) => fs.existsSync(candidate));
152
+ if (!file || !file.startsWith(root)) {
153
+ console.error(`Arquivo ou slug nao encontrado: ${target}`);
154
+ process.exit(1);
155
+ }
156
+ const content = fs.readFileSync(file, 'utf8');
157
+ const tokens = estimateTokens(content);
158
+ const status = tokens <= limit ? 'OK' : 'FAIL';
159
+ recordContextRun('budget', path.basename(target), file, content, limit);
160
+ console.log(`${status} ${path.relative(root, file)}: ${tokens} tokens estimados / limite ${limit}`);
161
+ if (tokens > limit)
162
+ process.exit(1);
163
+ }
164
+ function cmdSprintPack() {
165
+ ensureOutDir();
166
+ const sprint = readIfExists('memory/40-delivery/current-sprint.md', 6000) || 'Nenhuma sprint ativa.';
167
+ const activeSpecs = listSpecs()
168
+ .filter((spec) => ['approved', 'implementing', 'review'].includes(spec.status))
169
+ .slice(0, 12);
170
+ const handoffs = getOpenHandoffs();
171
+ const adrs = latestAdrs();
172
+ let md = `# Sprint Pack\n\n`;
173
+ md += `- **Gerado em**: ${new Date().toISOString()}\n`;
174
+ md += `- **Budget alvo**: ${defaultLimit} tokens\n\n`;
175
+ md += `## Sprint Atual\n\n${sprint}\n\n`;
176
+ md += `## Specs Ativas\n\n`;
177
+ md += activeSpecs.length
178
+ ? activeSpecs.map((spec) => `- ${spec.slug}: ${spec.status}; plan=${spec.hasPlan ? 'sim' : 'nao'}; tasks=${spec.hasTasks ? 'sim' : 'nao'}; ${spec.path}`).join('\n')
179
+ : '- Nenhuma spec ativa encontrada.';
180
+ md += `\n\n## Handoffs Abertos\n\n`;
181
+ md += handoffs.length
182
+ ? handoffs.map((h) => `- #${h.id} ${h.from_agent} -> ${h.to_agent} (${h.intent}) ${h.spec_slug || ''}: ${String(h.context).slice(0, 180)}`).join('\n')
183
+ : '- Nenhum handoff aberto.';
184
+ md += `\n\n## ADRs Recentes\n\n`;
185
+ md += adrs.length ? adrs.map((adr) => `- ${adr.rel}: ${adr.title}`).join('\n') : '- Nenhuma ADR encontrada.';
186
+ md += `\n\n## Proximo Uso\n\n`;
187
+ md += `- Para tarefa especifica: \`npm run agent:brief -- <role> <slug>\`\n`;
188
+ md += `- Para budget: \`npm run context:budget -- .context/sprint-pack.md\`\n`;
189
+ const outFile = path.join(outDir, 'sprint-pack.md');
190
+ fs.writeFileSync(outFile, md, 'utf8');
191
+ recordContextRun('sprint-pack', null, outFile, md, defaultLimit);
192
+ console.log(`Sprint pack gerado: ${path.relative(root, outFile)} (${estimateTokens(md)} tokens estimados)`);
193
+ }
194
+ function cmdAgentBrief([role, slug]) {
195
+ if (!role || !slug) {
196
+ console.error('Uso: context-ops agent-brief <role> <slug>');
197
+ process.exit(1);
198
+ }
199
+ ensureOutDir();
200
+ const spec = readIfExists(`specs/${slug}/spec.md`, 12000);
201
+ if (!spec) {
202
+ console.error(`Spec nao encontrada: specs/${slug}/spec.md`);
203
+ process.exit(1);
204
+ }
205
+ upsertSpecSummary(slug, spec);
206
+ const plan = readIfExists(`specs/${slug}/plan.md`, 7000);
207
+ const tasks = readIfExists(`specs/${slug}/tasks.md`, 7000);
208
+ const gsd = readIfExists(`.context/gsd-${slug}.md`, 5000);
209
+ const handoffs = getOpenHandoffs(slug);
210
+ const sections = [
211
+ ['Problema', extractSection(spec, '1. Problema', 1200)],
212
+ ['Valor', extractSection(spec, '2. Proposta de valor', 900)],
213
+ ['Aceite', extractSection(spec, '4. Criterios de aceite', 1600) || extractSection(spec, '4. Critérios de aceite', 1600)],
214
+ ['Plano tecnico', extractSection(plan, '1. Abordagem tecnica', 1400) || extractSection(plan, '1. Abordagem técnica', 1400)],
215
+ ['Contratos', extractSection(plan, '4. Contratos', 1200)],
216
+ ['Tasks', tasks.split('\n').filter((line) => /^## T\d+/.test(line) || line.includes('- **Paths**') || line.includes('- **Done quando**')).slice(0, 40).join('\n')],
217
+ ['GSD', gsd.split('\n').filter((line) => line.includes('- [ ]') || line.includes('- [x]') || line.includes('Objetivo')).slice(0, 30).join('\n')],
218
+ ];
219
+ let md = `# Agent Brief: ${role} / ${slug}\n\n`;
220
+ md += `- **Role**: ${role}\n`;
221
+ md += `- **Spec status**: ${specStatus(spec)}\n`;
222
+ md += `- **Gerado em**: ${new Date().toISOString()}\n`;
223
+ md += `- **Fonte primaria**: specs/${slug}/spec.md\n\n`;
224
+ for (const [title, body] of sections) {
225
+ if (body)
226
+ md += `## ${title}\n\n${body}\n\n`;
227
+ }
228
+ md += `## Handoffs Relevantes\n\n`;
229
+ md += handoffs.length
230
+ ? handoffs.map((h) => `- #${h.id} [${h.status}] ${h.from_agent} -> ${h.to_agent} (${h.intent}); aceite: ${String(h.acceptance).slice(0, 220)}`).join('\n')
231
+ : '- Nenhum handoff registrado para este slug.';
232
+ md += `\n\n## Comandos de Validacao\n\n`;
233
+ md += `\`\`\`bash\nnpm run gsd:check -- ${slug}\nnpm run spec:check -- ${slug}\nnpm run project:check\n\`\`\`\n`;
234
+ const outFile = path.join(outDir, `agent-brief-${role}-${slug}.md`);
235
+ fs.writeFileSync(outFile, md, 'utf8');
236
+ recordContextRun('agent-brief', slug, outFile, md, defaultLimit);
237
+ console.log(`Agent brief gerado: ${path.relative(root, outFile)} (${estimateTokens(md)} tokens estimados)`);
238
+ }
239
+ function summarizeReadme(relPath) {
240
+ const content = readIfExists(relPath, 2500);
241
+ const title = firstHeading(content, path.basename(path.dirname(relPath)));
242
+ const lines = content.split('\n')
243
+ .filter((line) => line.trim() && !line.startsWith('```'))
244
+ .slice(0, 10)
245
+ .join(' ')
246
+ .replace(/\s+/g, ' ')
247
+ .slice(0, 450);
248
+ return { title, summary: lines };
249
+ }
250
+ function keywordTags(text, candidates) {
251
+ const lower = text.toLowerCase();
252
+ return candidates.filter((tag) => lower.includes(tag.toLowerCase()));
253
+ }
254
+ function inferBoilerplateManifest(name, relPath) {
255
+ const readme = readIfExists(relPath, 8000);
256
+ const lower = `${name} ${readme}`.toLowerCase();
257
+ const stack = keywordTags(lower, ['NestJS', 'Next.js', 'React', 'Docker', 'Turborepo', 'RabbitMQ', 'JWT', 'SQLite', 'Postgres']);
258
+ const useCases = keywordTags(lower, ['API REST', 'SaaS', 'E-Commerce', 'Microserviços', 'Monorepo', 'Dashboard', 'Admin', 'Billing', 'Auth']);
259
+ const commands = ['npm install'];
260
+ if (lower.includes('start:dev'))
261
+ commands.push('npm run start:dev');
262
+ if (lower.includes('docker-compose') || lower.includes('docker compose'))
263
+ commands.push('docker compose up -d');
264
+ if (lower.includes('test'))
265
+ commands.push('npm test');
266
+ return {
267
+ schemaVersion: '1.0',
268
+ type: 'boilerplate',
269
+ name,
270
+ title: firstHeading(readme, name),
271
+ path: path.dirname(relPath),
272
+ readme: relPath,
273
+ stack,
274
+ useCases,
275
+ commands,
276
+ gates: ['npm run spec:check', 'npm test', 'npm run project:check'],
277
+ tokenPolicy: {
278
+ firstRead: ['boilerplate.manifest.json', 'README.md'],
279
+ avoidLoadingByDefault: ['node_modules', 'dist', 'coverage'],
280
+ },
281
+ };
282
+ }
283
+ function inferDesignManifest(name, relPath) {
284
+ const readme = readIfExists(relPath, 8000);
285
+ const lower = `${name} ${readme}`.toLowerCase();
286
+ const surfaces = [];
287
+ if (['linear.app', 'cursor', 'raycast', 'sentry', 'posthog', 'claude'].includes(name))
288
+ surfaces.push('agent-console', 'ops');
289
+ if (['stripe', 'linear.app', 'posthog', 'sentry', 'supabase'].includes(name))
290
+ surfaces.push('dashboard');
291
+ if (['mintlify', 'stripe', 'vercel', 'resend', 'hashicorp'].includes(name))
292
+ surfaces.push('docs');
293
+ if (['figma', 'miro', 'notion', 'raycast'].includes(name))
294
+ surfaces.push('tool');
295
+ if (['wise', 'revolut', 'coinbase', 'kraken'].includes(name))
296
+ surfaces.push('fintech');
297
+ if (['apple', 'bmw', 'ferrari', 'tesla', 'lamborghini'].includes(name))
298
+ surfaces.push('premium');
299
+ return {
300
+ schemaVersion: '1.0',
301
+ type: 'design-reference',
302
+ name,
303
+ title: firstHeading(readme, name),
304
+ path: path.dirname(relPath),
305
+ readme: relPath,
306
+ surfaces: [...new Set(surfaces)],
307
+ traits: keywordTags(lower, ['dashboard', 'docs', 'developer', 'ai', 'agent', 'collaboration', 'fintech', 'observability', 'premium', 'crm']),
308
+ tokenHints: {
309
+ density: lower.includes('dashboard') || lower.includes('ops') ? 'high' : 'medium',
310
+ useWhen: 'Escolha quando a superficie e o tom baterem com MATRIX.md.',
311
+ avoidWhen: 'Evite copiar identidade proprietaria ou carregar README inteiro sem necessidade.',
312
+ },
313
+ };
314
+ }
315
+ function readJsonIfExists(relPath) {
316
+ const full = path.join(root, relPath);
317
+ if (!fs.existsSync(full))
318
+ return null;
319
+ try {
320
+ return JSON.parse(fs.readFileSync(full, 'utf8'));
321
+ }
322
+ catch {
323
+ return null;
324
+ }
325
+ }
326
+ function cmdGenerateManifests() {
327
+ let written = 0;
328
+ const boilerRoot = path.join(root, 'boilerplates');
329
+ if (fs.existsSync(boilerRoot)) {
330
+ for (const entry of fs.readdirSync(boilerRoot, { withFileTypes: true })) {
331
+ if (!entry.isDirectory())
332
+ continue;
333
+ const rel = path.join('boilerplates', entry.name, 'README.md');
334
+ if (!fs.existsSync(path.join(root, rel)))
335
+ continue;
336
+ const manifest = inferBoilerplateManifest(entry.name, rel);
337
+ const outFile = path.join(root, 'boilerplates', entry.name, 'boilerplate.manifest.json');
338
+ fs.writeFileSync(outFile, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
339
+ written++;
340
+ }
341
+ }
342
+ const designRoot = path.join(root, 'design-md');
343
+ if (fs.existsSync(designRoot)) {
344
+ for (const entry of fs.readdirSync(designRoot, { withFileTypes: true })) {
345
+ if (!entry.isDirectory())
346
+ continue;
347
+ const rel = path.join('design-md', entry.name, 'README.md');
348
+ if (!fs.existsSync(path.join(root, rel)))
349
+ continue;
350
+ const manifest = inferDesignManifest(entry.name, rel);
351
+ const outFile = path.join(root, 'design-md', entry.name, 'design.manifest.json');
352
+ fs.writeFileSync(outFile, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
353
+ written++;
354
+ }
355
+ }
356
+ console.log(`Manifests gerados: ${written}`);
357
+ }
358
+ function cmdAssetCatalog() {
359
+ ensureOutDir();
360
+ const assets = [];
361
+ const boilerRoot = path.join(root, 'boilerplates');
362
+ if (fs.existsSync(boilerRoot)) {
363
+ for (const entry of fs.readdirSync(boilerRoot, { withFileTypes: true })) {
364
+ if (!entry.isDirectory())
365
+ continue;
366
+ const rel = path.join('boilerplates', entry.name, 'README.md');
367
+ if (fs.existsSync(path.join(root, rel))) {
368
+ const data = summarizeReadme(rel);
369
+ const manifest = readJsonIfExists(path.join('boilerplates', entry.name, 'boilerplate.manifest.json'));
370
+ assets.push({
371
+ type: 'boilerplate',
372
+ name: entry.name,
373
+ path: rel,
374
+ ...data,
375
+ tags: manifest ? [...(manifest.stack || []), ...(manifest.useCases || [])].join(',') : data.title,
376
+ manifest,
377
+ });
378
+ }
379
+ }
380
+ }
381
+ const designRoot = path.join(root, 'design-md');
382
+ if (fs.existsSync(designRoot)) {
383
+ for (const entry of fs.readdirSync(designRoot, { withFileTypes: true })) {
384
+ if (!entry.isDirectory())
385
+ continue;
386
+ const rel = path.join('design-md', entry.name, 'README.md');
387
+ if (fs.existsSync(path.join(root, rel))) {
388
+ const data = summarizeReadme(rel);
389
+ const manifest = readJsonIfExists(path.join('design-md', entry.name, 'design.manifest.json'));
390
+ assets.push({
391
+ type: 'design-reference',
392
+ name: entry.name,
393
+ path: rel,
394
+ ...data,
395
+ tags: manifest ? [...(manifest.surfaces || []), ...(manifest.traits || [])].join(',') : data.title,
396
+ manifest,
397
+ });
398
+ }
399
+ }
400
+ }
401
+ const db = openDb();
402
+ const now = new Date().toISOString();
403
+ const stmt = db.prepare(`
404
+ INSERT INTO asset_catalog (type, name, path, summary, tags, updated_at)
405
+ VALUES (?, ?, ?, ?, ?, ?)
406
+ ON CONFLICT(path) DO UPDATE SET
407
+ type=excluded.type,
408
+ name=excluded.name,
409
+ summary=excluded.summary,
410
+ tags=excluded.tags,
411
+ updated_at=excluded.updated_at
412
+ `);
413
+ for (const asset of assets) {
414
+ stmt.run(asset.type, asset.name, asset.path, asset.summary, asset.tags || asset.title, now);
415
+ }
416
+ db.close();
417
+ let md = `# Asset Catalog\n\n- **Gerado em**: ${now}\n- **Total**: ${assets.length}\n\n`;
418
+ for (const type of ['boilerplate', 'design-reference']) {
419
+ md += `## ${type}\n\n`;
420
+ for (const asset of assets.filter((item) => item.type === type)) {
421
+ const tags = asset.tags ? ` [${asset.tags}]` : '';
422
+ md += `- **${asset.name}**${tags}: ${asset.path} — ${asset.summary}\n`;
423
+ }
424
+ md += '\n';
425
+ }
426
+ const outFile = path.join(outDir, 'asset-catalog.md');
427
+ fs.writeFileSync(outFile, md, 'utf8');
428
+ recordContextRun('asset-catalog', null, outFile, md, defaultLimit);
429
+ console.log(`Asset catalog gerado: ${path.relative(root, outFile)} (${assets.length} assets)`);
430
+ }
431
+ function help() {
432
+ console.log(`Uso: node scripts/context-ops.mjs <command> [args]
433
+
434
+ Comandos:
435
+ budget <slug|arquivo> [limite] Mede tokens e falha se passar do limite
436
+ sprint-pack Gera .context/sprint-pack.md
437
+ agent-brief <role> <slug> Gera brief compacto por papel/feature
438
+ asset-catalog Cataloga boilerplates e design-md
439
+ manifests Gera manifests JSON para boilerplates/design-md
440
+ `);
441
+ }
442
+ const [cmd, ...rest] = process.argv.slice(2);
443
+ /** dispatch heterogêneo: cada cmd consome os args do seu jeito (Fase 1) */
444
+ const args = rest;
445
+ switch (cmd) {
446
+ case 'budget':
447
+ cmdBudget(args);
448
+ break;
449
+ case 'sprint-pack':
450
+ cmdSprintPack();
451
+ break;
452
+ case 'agent-brief':
453
+ cmdAgentBrief(args);
454
+ break;
455
+ case 'asset-catalog':
456
+ cmdAssetCatalog();
457
+ break;
458
+ case 'manifests':
459
+ cmdGenerateManifests();
460
+ break;
461
+ default:
462
+ help();
463
+ process.exit(cmd ? 1 : 0);
464
+ }
@@ -0,0 +1,96 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Dev Workflow CLI - Orchestrador Unificado de Comandos
4
+ *
5
+ * Unifica todos os commands de desenvolvimento em uma interface única:
6
+ * - context:build → Gerar contexto inteligente
7
+ * - memory:vacuum → Comprimir e limpar memória
8
+ * - memory:sync → Sincronizar índices
9
+ * - project:health → Validar saúde do projeto
10
+ * - project:init → Inicializar novo projeto
11
+ *
12
+ * Uso: npm run dev -- <command> [args]
13
+ * node scripts/dev.mjs context:build global my-project
14
+ */
15
+ declare const COMMANDS: {
16
+ 'context:build': {
17
+ desc: string;
18
+ handler: typeof contextBuild;
19
+ example: string;
20
+ };
21
+ 'memory:vacuum': {
22
+ desc: string;
23
+ handler: typeof memoryVacuum;
24
+ example: string;
25
+ };
26
+ 'memory:sync': {
27
+ desc: string;
28
+ handler: typeof memorySync;
29
+ example: string;
30
+ };
31
+ 'project:health': {
32
+ desc: string;
33
+ handler: typeof projectHealth;
34
+ example: string;
35
+ };
36
+ 'project:init': {
37
+ desc: string;
38
+ handler: typeof projectInit;
39
+ example: string;
40
+ };
41
+ 'design:select': {
42
+ desc: string;
43
+ handler: (args?: string[]) => Promise<void>;
44
+ example: string;
45
+ };
46
+ 'design:check': {
47
+ desc: string;
48
+ handler: (args?: string[]) => Promise<void>;
49
+ example: string;
50
+ };
51
+ 'hermes:handoff': {
52
+ desc: string;
53
+ handler: (args?: string[]) => Promise<void>;
54
+ example: string;
55
+ };
56
+ 'gsd:plan': {
57
+ desc: string;
58
+ handler: (args?: string[]) => Promise<void>;
59
+ example: string;
60
+ };
61
+ 'gsd:handoff': {
62
+ desc: string;
63
+ handler: (args?: string[]) => Promise<void>;
64
+ example: string;
65
+ };
66
+ 'gsd:check': {
67
+ desc: string;
68
+ handler: (args?: string[]) => Promise<void>;
69
+ example: string;
70
+ };
71
+ };
72
+ /**
73
+ * Run subprocess
74
+ */
75
+ declare function runScript(scriptPath: any, args?: string[]): Promise<void>;
76
+ /**
77
+ * Context Build Handler
78
+ */
79
+ declare function contextBuild([mode, project, keyword]?: [any?, any?, any?]): Promise<void>;
80
+ /**
81
+ * Memory Vacuum Handler
82
+ */
83
+ declare function memoryVacuum(): Promise<void>;
84
+ /**
85
+ * Memory Sync Handler
86
+ */
87
+ declare function memorySync([project]?: [any?]): Promise<void>;
88
+ /**
89
+ * Project Health Check
90
+ */
91
+ declare function projectHealth(): Promise<void>;
92
+ /**
93
+ * Project Init Handler
94
+ */
95
+ declare function projectInit([projectName, ...flags]?: string[]): Promise<void>;
96
+ export { COMMANDS, runScript };