@polymorphism-tech/morph-spec 2.2.0 → 2.4.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 (251) hide show
  1. package/CLAUDE.md +314 -1673
  2. package/LICENSE +72 -72
  3. package/README.md +515 -516
  4. package/bin/detect-agents.js +225 -225
  5. package/bin/morph-spec.js +358 -173
  6. package/bin/render-template.js +302 -302
  7. package/bin/semantic-detect-agents.js +246 -246
  8. package/bin/task-manager.js +429 -0
  9. package/bin/validate-agents-skills.js +251 -251
  10. package/bin/validate-agents.js +69 -69
  11. package/bin/validate-phase.js +263 -263
  12. package/bin/validate.js +369 -0
  13. package/content/.azure/README.md +293 -293
  14. package/content/.azure/docs/azure-devops-setup.md +454 -454
  15. package/content/.azure/docs/branch-strategy.md +398 -398
  16. package/content/.azure/docs/local-development.md +515 -515
  17. package/content/.azure/pipelines/pipeline-variables.yml +34 -34
  18. package/content/.azure/pipelines/prod-pipeline.yml +319 -319
  19. package/content/.azure/pipelines/staging-pipeline.yml +234 -234
  20. package/content/.azure/pipelines/templates/build-dotnet.yml +75 -75
  21. package/content/.azure/pipelines/templates/deploy-app-service.yml +94 -94
  22. package/content/.azure/pipelines/templates/deploy-container-app.yml +120 -120
  23. package/content/.azure/pipelines/templates/infra-deploy.yml +90 -90
  24. package/content/.claude/commands/morph-apply.md +221 -158
  25. package/content/.claude/commands/morph-archive.md +79 -79
  26. package/content/.claude/commands/morph-infra.md +209 -209
  27. package/content/.claude/commands/morph-preflight.md +227 -0
  28. package/content/.claude/commands/morph-proposal.md +122 -101
  29. package/content/.claude/commands/morph-status.md +86 -86
  30. package/content/.claude/commands/morph-troubleshoot.md +122 -0
  31. package/content/.claude/settings.local.json +15 -15
  32. package/content/.claude/skills/checklists/code-review.md +226 -0
  33. package/content/.claude/skills/checklists/morph-checklist.md +117 -0
  34. package/content/.claude/skills/checklists/simulation-checklist.md +77 -0
  35. package/content/.claude/skills/infra/bicep-architect.md +126 -419
  36. package/content/.claude/skills/infra/container-specialist.md +131 -437
  37. package/content/.claude/skills/infra/devops-engineer.md +119 -405
  38. package/content/.claude/skills/integrations/asaas-financial.md +130 -333
  39. package/content/.claude/skills/integrations/azure-identity.md +142 -309
  40. package/content/.claude/skills/integrations/clerk-auth.md +108 -290
  41. package/content/.claude/skills/integrations/resend-email.md +119 -0
  42. package/content/.claude/skills/specialists/ai-system-architect.md +192 -604
  43. package/content/.claude/skills/specialists/azure-architect.md +142 -142
  44. package/content/.claude/skills/specialists/code-analyzer.md +235 -0
  45. package/content/.claude/skills/specialists/dotnet-senior.md +287 -0
  46. package/content/.claude/skills/specialists/ef-modeler.md +113 -200
  47. package/content/.claude/skills/specialists/hangfire-orchestrator.md +126 -245
  48. package/content/.claude/skills/specialists/ms-agent-expert.md +109 -263
  49. package/content/.claude/skills/specialists/po-pm-advisor.md +197 -197
  50. package/content/.claude/skills/specialists/standards-architect.md +156 -78
  51. package/content/.claude/skills/specialists/testing-specialist.md +126 -0
  52. package/content/.claude/skills/specialists/ui-ux-designer.md +191 -1060
  53. package/content/.claude/skills/stacks/dotnet-blazor.md +210 -588
  54. package/content/.claude/skills/stacks/dotnet-nextjs.md +154 -402
  55. package/content/.claude/skills/workflows/morph-replicate.md +213 -0
  56. package/content/.claude/{commands/morph-clarify.md → skills/workflows/phase-clarify.md} +5 -58
  57. package/content/.claude/{commands/morph-design.md → skills/workflows/phase-design.md} +16 -86
  58. package/content/.claude/{commands/morph-setup.md → skills/workflows/phase-setup.md} +9 -17
  59. package/content/.claude/skills/workflows/phase-tasks.md +164 -0
  60. package/content/.claude/{commands/morph-uiux.md → skills/workflows/phase-uiux.md} +15 -88
  61. package/content/.morph/.morphversion +5 -5
  62. package/content/.morph/archive/.gitkeep +25 -25
  63. package/content/.morph/config/agents.json +378 -242
  64. package/content/.morph/config/config.template.json +89 -108
  65. package/content/.morph/docs/STORY-DRIVEN-DEVELOPMENT.md +392 -392
  66. package/content/.morph/docs/workflows/design-impl.md +37 -0
  67. package/content/.morph/docs/workflows/fast-track.md +29 -0
  68. package/content/.morph/docs/workflows/full-morph.md +76 -0
  69. package/content/.morph/docs/workflows/standard.md +44 -0
  70. package/content/.morph/docs/workflows/ui-refresh.md +39 -0
  71. package/content/.morph/examples/api-nextjs/README.md +241 -241
  72. package/content/.morph/examples/api-nextjs/contracts.ts +307 -307
  73. package/content/.morph/examples/api-nextjs/spec.md +399 -399
  74. package/content/.morph/examples/api-nextjs/tasks.md +168 -168
  75. package/content/.morph/examples/micro-saas/README.md +125 -125
  76. package/content/.morph/examples/micro-saas/contracts.cs +358 -358
  77. package/content/.morph/examples/micro-saas/decisions.md +246 -246
  78. package/content/.morph/examples/micro-saas/spec.md +236 -236
  79. package/content/.morph/examples/micro-saas/tasks.md +150 -150
  80. package/content/.morph/examples/multi-agent/README.md +309 -309
  81. package/content/.morph/examples/multi-agent/contracts.cs +433 -433
  82. package/content/.morph/examples/multi-agent/spec.md +479 -479
  83. package/content/.morph/examples/multi-agent/tasks.md +185 -185
  84. package/content/.morph/examples/scheduled-reports/decisions.md +158 -0
  85. package/content/.morph/examples/scheduled-reports/proposal.md +95 -0
  86. package/content/.morph/examples/scheduled-reports/spec.md +267 -0
  87. package/content/.morph/examples/state-v3.json +188 -0
  88. package/content/.morph/features/.gitkeep +25 -25
  89. package/content/.morph/hooks/README.md +190 -239
  90. package/content/.morph/hooks/pre-commit-agents.sh +24 -24
  91. package/content/.morph/hooks/pre-commit-all.sh +48 -48
  92. package/content/.morph/hooks/pre-commit-specs.sh +49 -49
  93. package/content/.morph/hooks/pre-commit-tests.sh +60 -60
  94. package/content/.morph/project.md +160 -160
  95. package/content/.morph/schemas/agent.schema.json +296 -296
  96. package/content/.morph/schemas/tasks.schema.json +220 -0
  97. package/content/.morph/specs/.gitkeep +20 -20
  98. package/content/.morph/standards/agent-framework-blazor-ui.md +359 -0
  99. package/content/.morph/standards/agent-framework-production.md +410 -0
  100. package/content/.morph/standards/agent-framework-setup.md +413 -453
  101. package/content/.morph/standards/agent-framework-workflows.md +349 -0
  102. package/content/.morph/standards/architecture.md +325 -325
  103. package/content/.morph/standards/azure.md +605 -379
  104. package/content/.morph/standards/coding.md +377 -377
  105. package/content/.morph/standards/dotnet10-migration.md +520 -494
  106. package/content/.morph/standards/fluent-ui-setup.md +590 -590
  107. package/content/.morph/standards/migration-guide.md +514 -514
  108. package/content/.morph/standards/passkeys-auth.md +423 -423
  109. package/content/.morph/standards/vector-search-rag.md +536 -536
  110. package/content/.morph/state.json +17 -17
  111. package/content/.morph/templates/FluentDesignTheme.cs +149 -149
  112. package/content/.morph/templates/MudTheme.cs +281 -281
  113. package/content/.morph/templates/agent.cs +163 -172
  114. package/content/.morph/templates/clarify-questions.md +159 -0
  115. package/content/.morph/templates/component.razor +239 -239
  116. package/content/.morph/templates/contracts/Commands.cs +74 -0
  117. package/content/.morph/templates/contracts/Entities.cs +25 -0
  118. package/content/.morph/templates/contracts/Queries.cs +74 -0
  119. package/content/.morph/templates/contracts/README.md +74 -0
  120. package/content/.morph/templates/contracts.cs +217 -217
  121. package/content/.morph/templates/decisions.md +123 -106
  122. package/content/.morph/templates/design-system.css +226 -226
  123. package/content/.morph/templates/infra/.dockerignore.example +89 -89
  124. package/content/.morph/templates/infra/Dockerfile.example +82 -82
  125. package/content/.morph/templates/infra/README.md +286 -286
  126. package/content/.morph/templates/infra/app-insights.bicep +63 -63
  127. package/content/.morph/templates/infra/app-service.bicep +164 -164
  128. package/content/.morph/templates/infra/container-app-env.bicep +49 -49
  129. package/content/.morph/templates/infra/container-app.bicep +156 -156
  130. package/content/.morph/templates/infra/deploy-checklist.md +426 -0
  131. package/content/.morph/templates/infra/deploy.ps1 +229 -229
  132. package/content/.morph/templates/infra/deploy.sh +208 -208
  133. package/content/.morph/templates/infra/key-vault.bicep +91 -91
  134. package/content/.morph/templates/infra/main.bicep +189 -189
  135. package/content/.morph/templates/infra/parameters.dev.json +29 -29
  136. package/content/.morph/templates/infra/parameters.prod.json +29 -29
  137. package/content/.morph/templates/infra/parameters.staging.json +29 -29
  138. package/content/.morph/templates/infra/sql-database.bicep +103 -103
  139. package/content/.morph/templates/infra/storage.bicep +106 -106
  140. package/content/.morph/templates/integrations/asaas-client.cs +387 -387
  141. package/content/.morph/templates/integrations/asaas-webhook.cs +351 -351
  142. package/content/.morph/templates/integrations/azure-identity-config.cs +288 -288
  143. package/content/.morph/templates/integrations/clerk-config.cs +258 -258
  144. package/content/.morph/templates/job.cs +171 -171
  145. package/content/.morph/templates/migration.cs +83 -83
  146. package/content/.morph/templates/proposal.md +141 -155
  147. package/content/.morph/templates/recap.md +94 -105
  148. package/content/.morph/templates/repository.cs +141 -141
  149. package/content/.morph/templates/saas/subscription.cs +347 -347
  150. package/content/.morph/templates/saas/tenant.cs +338 -338
  151. package/content/.morph/templates/service.cs +139 -139
  152. package/content/.morph/templates/simulation.md +353 -0
  153. package/content/.morph/templates/spec.md +149 -148
  154. package/content/.morph/templates/sprint-status.yaml +68 -68
  155. package/content/.morph/templates/state.template.json +222 -222
  156. package/content/.morph/templates/story.md +143 -143
  157. package/content/.morph/templates/tasks.md +257 -235
  158. package/content/.morph/templates/test.cs +239 -239
  159. package/content/.morph/templates/ui-components.md +362 -276
  160. package/content/.morph/templates/ui-design-system.md +286 -286
  161. package/content/.morph/templates/ui-flows.md +336 -336
  162. package/content/.morph/templates/ui-mockups.md +133 -133
  163. package/content/.morph/test-infra/example.bicep +59 -59
  164. package/content/CLAUDE.md +150 -442
  165. package/content/README.md +79 -79
  166. package/detectors/config-detector.js +223 -223
  167. package/detectors/conversation-analyzer.js +163 -163
  168. package/detectors/index.js +84 -84
  169. package/detectors/standards-generator.js +275 -275
  170. package/detectors/structure-detector.js +245 -250
  171. package/docs/README.md +144 -149
  172. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.svg +977 -977
  173. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.svg +1048 -1048
  174. package/docs/api/scripts/collapse.js +38 -38
  175. package/docs/api/scripts/commonNav.js +28 -28
  176. package/docs/api/scripts/linenumber.js +25 -25
  177. package/docs/api/scripts/nav.js +12 -12
  178. package/docs/api/scripts/polyfill.js +3 -3
  179. package/docs/api/scripts/prettify/Apache-License-2.0.txt +202 -202
  180. package/docs/api/scripts/prettify/lang-css.js +2 -2
  181. package/docs/api/scripts/prettify/prettify.js +28 -28
  182. package/docs/api/scripts/search.js +98 -98
  183. package/docs/api/styles/jsdoc.css +776 -776
  184. package/docs/api/styles/prettify.css +80 -80
  185. package/docs/examples.md +328 -328
  186. package/docs/getting-started.md +301 -302
  187. package/docs/installation.md +361 -361
  188. package/docs/templates.md +418 -418
  189. package/docs/validation-checklist.md +265 -266
  190. package/package.json +80 -80
  191. package/scripts/postinstall.js +132 -132
  192. package/src/commands/advance-phase.js +183 -0
  193. package/src/commands/analyze-blazor-concurrency.js +193 -0
  194. package/src/commands/create-story.js +351 -351
  195. package/src/commands/detect-agents.js +139 -0
  196. package/src/commands/detect.js +104 -104
  197. package/src/commands/doctor.js +356 -280
  198. package/src/commands/generate.js +149 -149
  199. package/src/commands/init.js +258 -245
  200. package/src/commands/lint-fluent.js +352 -0
  201. package/src/commands/rollback-phase.js +185 -0
  202. package/src/commands/session-summary.js +291 -0
  203. package/src/commands/shard-spec.js +224 -224
  204. package/src/commands/sprint-status.js +250 -250
  205. package/src/commands/state.js +333 -333
  206. package/src/commands/sync.js +167 -167
  207. package/src/commands/task.js +78 -0
  208. package/src/commands/troubleshoot.js +222 -0
  209. package/src/commands/update.js +192 -159
  210. package/src/commands/validate-blazor-state.js +210 -0
  211. package/src/commands/validate-blazor.js +156 -0
  212. package/src/commands/validate-css.js +84 -0
  213. package/src/commands/validate-phase.js +221 -0
  214. package/src/lib/blazor-concurrency-analyzer.js +288 -0
  215. package/src/lib/blazor-state-validator.js +291 -0
  216. package/src/lib/blazor-validator.js +374 -0
  217. package/src/lib/complexity-analyzer.js +441 -292
  218. package/src/lib/continuous-validator.js +421 -0
  219. package/src/lib/css-validator.js +352 -0
  220. package/src/lib/decision-constraint-loader.js +109 -0
  221. package/src/lib/design-system-generator.js +298 -298
  222. package/src/lib/learning-system.js +520 -0
  223. package/src/lib/mockup-generator.js +366 -0
  224. package/src/lib/recap-generator.js +205 -0
  225. package/src/lib/state-manager.js +397 -340
  226. package/src/lib/troubleshoot-grep.js +194 -0
  227. package/src/lib/troubleshoot-index.js +144 -0
  228. package/src/lib/ui-detector.js +350 -0
  229. package/src/lib/validation-runner.js +231 -0
  230. package/src/lib/validators/architecture-validator.js +387 -0
  231. package/src/lib/validators/contract-compliance-validator.js +273 -0
  232. package/src/lib/validators/package-validator.js +360 -0
  233. package/src/lib/validators/ui-contrast-validator.js +422 -0
  234. package/src/utils/file-copier.js +179 -139
  235. package/src/utils/logger.js +32 -32
  236. package/src/utils/version-checker.js +175 -175
  237. package/content/.claude/commands/morph-costs.md +0 -206
  238. package/content/.claude/commands/morph-tasks.md +0 -319
  239. package/content/.claude/skills/specialists/cost-guardian.md +0 -110
  240. package/content/.claude/skills/stacks/shopify.md +0 -445
  241. package/content/.morph/config/azure-pricing.json +0 -70
  242. package/content/.morph/config/azure-pricing.schema.json +0 -50
  243. package/content/.morph/hooks/pre-commit-costs.sh +0 -91
  244. package/docs/api/cost-calculator.js.html +0 -513
  245. package/docs/api/design-system-generator.js.html +0 -382
  246. package/docs/api/global.html +0 -5263
  247. package/docs/api/index.html +0 -96
  248. package/docs/api/state-manager.js.html +0 -423
  249. package/src/commands/cost.js +0 -181
  250. package/src/commands/update-pricing.js +0 -206
  251. package/src/lib/cost-calculator.js +0 -429
@@ -1,225 +1,225 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * MORPH-SPEC Agent Detection CLI
5
- *
6
- * Detecta automaticamente quais agentes devem ser ativados baseado
7
- * em keywords no input do usuário.
8
- *
9
- * Uso:
10
- * node bin/detect-agents.js "implementar jobs agendados"
11
- * node bin/detect-agents.js --verbose "criar dashboard com charts"
12
- * node bin/detect-agents.js --json "adicionar background tasks"
13
- */
14
-
15
- import { readFileSync } from 'fs';
16
- import { join, dirname } from 'path';
17
- import { fileURLToPath } from 'url';
18
-
19
- const __dirname = dirname(fileURLToPath(import.meta.url));
20
- const AGENTS_CONFIG_PATH = join(__dirname, '../content/.morph/config/agents.json');
21
-
22
- // Cores para output no terminal
23
- const colors = {
24
- reset: '\x1b[0m',
25
- bright: '\x1b[1m',
26
- green: '\x1b[32m',
27
- yellow: '\x1b[33m',
28
- blue: '\x1b[34m',
29
- cyan: '\x1b[36m',
30
- gray: '\x1b[90m'
31
- };
32
-
33
- function log(message, color = 'reset') {
34
- console.log(`${colors[color]}${message}${colors.reset}`);
35
- }
36
-
37
- /**
38
- * Carrega configuração de agentes
39
- * @returns {Object} Configuração de agentes
40
- */
41
- function loadAgentsConfig() {
42
- try {
43
- const content = readFileSync(AGENTS_CONFIG_PATH, 'utf8');
44
- return JSON.parse(content);
45
- } catch (err) {
46
- console.error(`ERROR: Failed to load agents config: ${err.message}`);
47
- process.exit(1);
48
- }
49
- }
50
-
51
- /**
52
- * Detecta agentes baseado em user input
53
- * @param {string} userInput - Input do usuário
54
- * @param {Object} config - Configuração de agentes
55
- * @returns {Object} Resultado da detecção { core, specialists, all, matches }
56
- */
57
- function detectAgents(userInput, config) {
58
- const input = userInput.toLowerCase();
59
- const coreAgents = config.agents.core || [];
60
- const specialists = config.agents.specialists || [];
61
-
62
- // Core agents sempre ativos
63
- const coreIds = coreAgents.map(a => a.id);
64
-
65
- // Detectar specialists por keyword matching
66
- const specialistMatches = [];
67
-
68
- for (const agent of specialists) {
69
- const keywords = agent.autoActivation?.keywords || [];
70
- const matchedKeywords = [];
71
-
72
- for (const keyword of keywords) {
73
- if (input.includes(keyword.toLowerCase())) {
74
- matchedKeywords.push(keyword);
75
- }
76
- }
77
-
78
- if (matchedKeywords.length > 0) {
79
- specialistMatches.push({
80
- id: agent.id,
81
- name: agent.name,
82
- emoji: agent.emoji,
83
- matchedKeywords: matchedKeywords,
84
- matchCount: matchedKeywords.length
85
- });
86
- }
87
- }
88
-
89
- // Ordenar por número de matches (mais relevante primeiro)
90
- specialistMatches.sort((a, b) => b.matchCount - a.matchCount);
91
-
92
- const specialistIds = specialistMatches.map(m => m.id);
93
- const allIds = [...new Set([...coreIds, ...specialistIds])];
94
-
95
- return {
96
- core: coreIds,
97
- specialists: specialistIds,
98
- all: allIds,
99
- matches: specialistMatches,
100
- input: userInput
101
- };
102
- }
103
-
104
- /**
105
- * Formata output em modo verbose
106
- * @param {Object} result - Resultado da detecção
107
- */
108
- function formatVerbose(result) {
109
- log('\n╔════════════════════════════════════════════════════════════════╗', 'cyan');
110
- log('║ AGENT DETECTION RESULT ║', 'cyan');
111
- log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
112
- log(`║ Input: ${result.input.substring(0, 54).padEnd(54)} ║`, 'bright');
113
- log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
114
- log('║ CORE AGENTS (always active) ║', 'cyan');
115
- log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
116
-
117
- result.core.forEach(id => {
118
- log(`║ ✓ ${id.padEnd(58)}║`, 'green');
119
- });
120
-
121
- if (result.specialists.length > 0) {
122
- log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
123
- log('║ SPECIALIST AGENTS (keyword matched) ║', 'cyan');
124
- log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
125
-
126
- result.matches.forEach(match => {
127
- const line = `${match.emoji} ${match.name} (${match.matchCount} matches)`;
128
- log(`║ ${line.padEnd(61)}║`, 'yellow');
129
- const keywords = match.matchedKeywords.join(', ');
130
- const keywordLine = `Keywords: ${keywords}`;
131
- // Quebrar em múltiplas linhas se necessário
132
- if (keywordLine.length > 58) {
133
- const chunks = keywordLine.match(/.{1,58}/g) || [];
134
- chunks.forEach((chunk, i) => {
135
- log(`║ ${chunk.padEnd(59)}║`, 'gray');
136
- });
137
- } else {
138
- log(`║ ${keywordLine.padEnd(59)}║`, 'gray');
139
- }
140
- });
141
- } else {
142
- log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
143
- log('║ No specialist agents matched ║', 'gray');
144
- }
145
-
146
- log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
147
- log(`║ TOTAL: ${result.all.length} agents activated ║`, 'bright');
148
- log('╚════════════════════════════════════════════════════════════════╝\n', 'cyan');
149
- }
150
-
151
- /**
152
- * Formata output em modo simples (apenas IDs)
153
- * @param {Object} result - Resultado da detecção
154
- */
155
- function formatSimple(result) {
156
- result.all.forEach(id => console.log(id));
157
- }
158
-
159
- /**
160
- * Formata output em modo JSON
161
- * @param {Object} result - Resultado da detecção
162
- */
163
- function formatJSON(result) {
164
- console.log(JSON.stringify(result, null, 2));
165
- }
166
-
167
- // ============================================================================
168
- // MAIN
169
- // ============================================================================
170
-
171
- function main() {
172
- const args = process.argv.slice(2);
173
-
174
- // Parse flags
175
- const hasVerbose = args.includes('--verbose') || args.includes('-v');
176
- const hasJSON = args.includes('--json') || args.includes('-j');
177
- const hasHelp = args.includes('--help') || args.includes('-h');
178
- const hasIdsOnly = args.includes('--ids-only') || args.includes('-i');
179
-
180
- // Remove flags para pegar user input
181
- const userInput = args
182
- .filter(arg => !arg.startsWith('--') && !arg.startsWith('-'))
183
- .join(' ');
184
-
185
- if (hasHelp || args.length === 0) {
186
- log('\nMORPH-SPEC Agent Detection CLI', 'bright');
187
- log('\nUsage:', 'cyan');
188
- log(' node bin/detect-agents.js [options] "<user input>"', 'gray');
189
- log('\nOptions:', 'cyan');
190
- log(' -v, --verbose Show detailed detection results', 'gray');
191
- log(' -j, --json Output full result as JSON', 'gray');
192
- log(' -i, --ids-only Output only agent IDs (one per line)', 'gray');
193
- log(' -h, --help Show this help', 'gray');
194
- log('\nExamples:', 'cyan');
195
- log(' node bin/detect-agents.js "criar dashboard com charts"', 'gray');
196
- log(' node bin/detect-agents.js --verbose "implementar jobs agendados"', 'gray');
197
- log(' node bin/detect-agents.js --json "adicionar RAG pipeline"', 'gray');
198
- log(' node bin/detect-agents.js --ids-only "background tasks"\n', 'gray');
199
- process.exit(0);
200
- }
201
-
202
- if (!userInput) {
203
- console.error('ERROR: User input is required');
204
- console.error('Run with --help for usage information');
205
- process.exit(1);
206
- }
207
-
208
- // Carregar config e detectar agentes
209
- const config = loadAgentsConfig();
210
- const result = detectAgents(userInput, config);
211
-
212
- // Formatar output
213
- if (hasJSON) {
214
- formatJSON(result);
215
- } else if (hasVerbose) {
216
- formatVerbose(result);
217
- } else if (hasIdsOnly) {
218
- formatSimple(result);
219
- } else {
220
- // Default: JSON compact (só all array)
221
- console.log(JSON.stringify(result.all));
222
- }
223
- }
224
-
225
- main();
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * MORPH-SPEC Agent Detection CLI
5
+ *
6
+ * Detecta automaticamente quais agentes devem ser ativados baseado
7
+ * em keywords no input do usuário.
8
+ *
9
+ * Uso:
10
+ * node bin/detect-agents.js "implementar jobs agendados"
11
+ * node bin/detect-agents.js --verbose "criar dashboard com charts"
12
+ * node bin/detect-agents.js --json "adicionar background tasks"
13
+ */
14
+
15
+ import { readFileSync } from 'fs';
16
+ import { join, dirname } from 'path';
17
+ import { fileURLToPath } from 'url';
18
+
19
+ const __dirname = dirname(fileURLToPath(import.meta.url));
20
+ const AGENTS_CONFIG_PATH = join(__dirname, '../content/.morph/config/agents.json');
21
+
22
+ // Cores para output no terminal
23
+ const colors = {
24
+ reset: '\x1b[0m',
25
+ bright: '\x1b[1m',
26
+ green: '\x1b[32m',
27
+ yellow: '\x1b[33m',
28
+ blue: '\x1b[34m',
29
+ cyan: '\x1b[36m',
30
+ gray: '\x1b[90m'
31
+ };
32
+
33
+ function log(message, color = 'reset') {
34
+ console.log(`${colors[color]}${message}${colors.reset}`);
35
+ }
36
+
37
+ /**
38
+ * Carrega configuração de agentes
39
+ * @returns {Object} Configuração de agentes
40
+ */
41
+ function loadAgentsConfig() {
42
+ try {
43
+ const content = readFileSync(AGENTS_CONFIG_PATH, 'utf8');
44
+ return JSON.parse(content);
45
+ } catch (err) {
46
+ console.error(`ERROR: Failed to load agents config: ${err.message}`);
47
+ process.exit(1);
48
+ }
49
+ }
50
+
51
+ /**
52
+ * Detecta agentes baseado em user input
53
+ * @param {string} userInput - Input do usuário
54
+ * @param {Object} config - Configuração de agentes
55
+ * @returns {Object} Resultado da detecção { core, specialists, all, matches }
56
+ */
57
+ function detectAgents(userInput, config) {
58
+ const input = userInput.toLowerCase();
59
+ const coreAgents = config.agents.core || [];
60
+ const specialists = config.agents.specialists || [];
61
+
62
+ // Core agents sempre ativos
63
+ const coreIds = coreAgents.map(a => a.id);
64
+
65
+ // Detectar specialists por keyword matching
66
+ const specialistMatches = [];
67
+
68
+ for (const agent of specialists) {
69
+ const keywords = agent.autoActivation?.keywords || [];
70
+ const matchedKeywords = [];
71
+
72
+ for (const keyword of keywords) {
73
+ if (input.includes(keyword.toLowerCase())) {
74
+ matchedKeywords.push(keyword);
75
+ }
76
+ }
77
+
78
+ if (matchedKeywords.length > 0) {
79
+ specialistMatches.push({
80
+ id: agent.id,
81
+ name: agent.name,
82
+ emoji: agent.emoji,
83
+ matchedKeywords: matchedKeywords,
84
+ matchCount: matchedKeywords.length
85
+ });
86
+ }
87
+ }
88
+
89
+ // Ordenar por número de matches (mais relevante primeiro)
90
+ specialistMatches.sort((a, b) => b.matchCount - a.matchCount);
91
+
92
+ const specialistIds = specialistMatches.map(m => m.id);
93
+ const allIds = [...new Set([...coreIds, ...specialistIds])];
94
+
95
+ return {
96
+ core: coreIds,
97
+ specialists: specialistIds,
98
+ all: allIds,
99
+ matches: specialistMatches,
100
+ input: userInput
101
+ };
102
+ }
103
+
104
+ /**
105
+ * Formata output em modo verbose
106
+ * @param {Object} result - Resultado da detecção
107
+ */
108
+ function formatVerbose(result) {
109
+ log('\n╔════════════════════════════════════════════════════════════════╗', 'cyan');
110
+ log('║ AGENT DETECTION RESULT ║', 'cyan');
111
+ log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
112
+ log(`║ Input: ${result.input.substring(0, 54).padEnd(54)} ║`, 'bright');
113
+ log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
114
+ log('║ CORE AGENTS (always active) ║', 'cyan');
115
+ log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
116
+
117
+ result.core.forEach(id => {
118
+ log(`║ ✓ ${id.padEnd(58)}║`, 'green');
119
+ });
120
+
121
+ if (result.specialists.length > 0) {
122
+ log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
123
+ log('║ SPECIALIST AGENTS (keyword matched) ║', 'cyan');
124
+ log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
125
+
126
+ result.matches.forEach(match => {
127
+ const line = `${match.emoji} ${match.name} (${match.matchCount} matches)`;
128
+ log(`║ ${line.padEnd(61)}║`, 'yellow');
129
+ const keywords = match.matchedKeywords.join(', ');
130
+ const keywordLine = `Keywords: ${keywords}`;
131
+ // Quebrar em múltiplas linhas se necessário
132
+ if (keywordLine.length > 58) {
133
+ const chunks = keywordLine.match(/.{1,58}/g) || [];
134
+ chunks.forEach((chunk, i) => {
135
+ log(`║ ${chunk.padEnd(59)}║`, 'gray');
136
+ });
137
+ } else {
138
+ log(`║ ${keywordLine.padEnd(59)}║`, 'gray');
139
+ }
140
+ });
141
+ } else {
142
+ log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
143
+ log('║ No specialist agents matched ║', 'gray');
144
+ }
145
+
146
+ log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
147
+ log(`║ TOTAL: ${result.all.length} agents activated ║`, 'bright');
148
+ log('╚════════════════════════════════════════════════════════════════╝\n', 'cyan');
149
+ }
150
+
151
+ /**
152
+ * Formata output em modo simples (apenas IDs)
153
+ * @param {Object} result - Resultado da detecção
154
+ */
155
+ function formatSimple(result) {
156
+ result.all.forEach(id => console.log(id));
157
+ }
158
+
159
+ /**
160
+ * Formata output em modo JSON
161
+ * @param {Object} result - Resultado da detecção
162
+ */
163
+ function formatJSON(result) {
164
+ console.log(JSON.stringify(result, null, 2));
165
+ }
166
+
167
+ // ============================================================================
168
+ // MAIN
169
+ // ============================================================================
170
+
171
+ function main() {
172
+ const args = process.argv.slice(2);
173
+
174
+ // Parse flags
175
+ const hasVerbose = args.includes('--verbose') || args.includes('-v');
176
+ const hasJSON = args.includes('--json') || args.includes('-j');
177
+ const hasHelp = args.includes('--help') || args.includes('-h');
178
+ const hasIdsOnly = args.includes('--ids-only') || args.includes('-i');
179
+
180
+ // Remove flags para pegar user input
181
+ const userInput = args
182
+ .filter(arg => !arg.startsWith('--') && !arg.startsWith('-'))
183
+ .join(' ');
184
+
185
+ if (hasHelp || args.length === 0) {
186
+ log('\nMORPH-SPEC Agent Detection CLI', 'bright');
187
+ log('\nUsage:', 'cyan');
188
+ log(' node bin/detect-agents.js [options] "<user input>"', 'gray');
189
+ log('\nOptions:', 'cyan');
190
+ log(' -v, --verbose Show detailed detection results', 'gray');
191
+ log(' -j, --json Output full result as JSON', 'gray');
192
+ log(' -i, --ids-only Output only agent IDs (one per line)', 'gray');
193
+ log(' -h, --help Show this help', 'gray');
194
+ log('\nExamples:', 'cyan');
195
+ log(' node bin/detect-agents.js "criar dashboard com charts"', 'gray');
196
+ log(' node bin/detect-agents.js --verbose "implementar jobs agendados"', 'gray');
197
+ log(' node bin/detect-agents.js --json "adicionar RAG pipeline"', 'gray');
198
+ log(' node bin/detect-agents.js --ids-only "background tasks"\n', 'gray');
199
+ process.exit(0);
200
+ }
201
+
202
+ if (!userInput) {
203
+ console.error('ERROR: User input is required');
204
+ console.error('Run with --help for usage information');
205
+ process.exit(1);
206
+ }
207
+
208
+ // Carregar config e detectar agentes
209
+ const config = loadAgentsConfig();
210
+ const result = detectAgents(userInput, config);
211
+
212
+ // Formatar output
213
+ if (hasJSON) {
214
+ formatJSON(result);
215
+ } else if (hasVerbose) {
216
+ formatVerbose(result);
217
+ } else if (hasIdsOnly) {
218
+ formatSimple(result);
219
+ } else {
220
+ // Default: JSON compact (só all array)
221
+ console.log(JSON.stringify(result.all));
222
+ }
223
+ }
224
+
225
+ main();