grimoire-framework 1.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 (1174) hide show
  1. package/.claude/CLAUDE.md +318 -0
  2. package/.claude/hooks/README.md +170 -0
  3. package/.claude/hooks/enforce-architecture-first.py +198 -0
  4. package/.claude/hooks/install-hooks.sh +43 -0
  5. package/.claude/hooks/mind-clone-governance.py +192 -0
  6. package/.claude/hooks/pre-commit-version-check.sh +157 -0
  7. package/.claude/hooks/precompact-session-digest.js +47 -0
  8. package/.claude/hooks/read-protection.py +153 -0
  9. package/.claude/hooks/slug-validation.py +176 -0
  10. package/.claude/hooks/sql-governance.py +182 -0
  11. package/.claude/hooks/synapse-engine.js +77 -0
  12. package/.claude/hooks/write-path-validation.py +196 -0
  13. package/.claude/rules/mcp-usage.md +177 -0
  14. package/.grimoire/cli/commands/config/index.js +609 -0
  15. package/.grimoire/cli/commands/generate/index.js +222 -0
  16. package/.grimoire/cli/commands/manifest/index.js +47 -0
  17. package/.grimoire/cli/commands/manifest/regenerate.js +97 -0
  18. package/.grimoire/cli/commands/manifest/validate.js +66 -0
  19. package/.grimoire/cli/commands/mcp/add.js +235 -0
  20. package/.grimoire/cli/commands/mcp/index.js +77 -0
  21. package/.grimoire/cli/commands/mcp/link.js +218 -0
  22. package/.grimoire/cli/commands/mcp/setup.js +165 -0
  23. package/.grimoire/cli/commands/mcp/status.js +184 -0
  24. package/.grimoire/cli/commands/metrics/cleanup.js +91 -0
  25. package/.grimoire/cli/commands/metrics/index.js +66 -0
  26. package/.grimoire/cli/commands/metrics/record.js +154 -0
  27. package/.grimoire/cli/commands/metrics/seed.js +127 -0
  28. package/.grimoire/cli/commands/metrics/show.js +209 -0
  29. package/.grimoire/cli/commands/migrate/analyze.js +355 -0
  30. package/.grimoire/cli/commands/migrate/backup.js +354 -0
  31. package/.grimoire/cli/commands/migrate/execute.js +294 -0
  32. package/.grimoire/cli/commands/migrate/index.js +443 -0
  33. package/.grimoire/cli/commands/migrate/rollback.js +325 -0
  34. package/.grimoire/cli/commands/migrate/update-imports.js +398 -0
  35. package/.grimoire/cli/commands/migrate/validate.js +454 -0
  36. package/.grimoire/cli/commands/pro/index.js +705 -0
  37. package/.grimoire/cli/commands/qa/index.js +57 -0
  38. package/.grimoire/cli/commands/qa/run.js +163 -0
  39. package/.grimoire/cli/commands/qa/status.js +195 -0
  40. package/.grimoire/cli/commands/validate/index.js +431 -0
  41. package/.grimoire/cli/commands/workers/formatters/info-formatter.js +275 -0
  42. package/.grimoire/cli/commands/workers/formatters/list-table.js +265 -0
  43. package/.grimoire/cli/commands/workers/formatters/list-tree.js +160 -0
  44. package/.grimoire/cli/commands/workers/index.js +57 -0
  45. package/.grimoire/cli/commands/workers/info.js +195 -0
  46. package/.grimoire/cli/commands/workers/list.js +215 -0
  47. package/.grimoire/cli/commands/workers/search-filters.js +185 -0
  48. package/.grimoire/cli/commands/workers/search-keyword.js +310 -0
  49. package/.grimoire/cli/commands/workers/search-semantic.js +294 -0
  50. package/.grimoire/cli/commands/workers/search.js +155 -0
  51. package/.grimoire/cli/commands/workers/utils/pagination.js +102 -0
  52. package/.grimoire/cli/index.js +150 -0
  53. package/.grimoire/cli/utils/output-formatter-cli.js +233 -0
  54. package/.grimoire/cli/utils/score-calculator.js +221 -0
  55. package/.grimoire/constitution.md +172 -0
  56. package/.grimoire/core/README.md +231 -0
  57. package/.grimoire/core/code-intel/code-intel-client.js +280 -0
  58. package/.grimoire/core/code-intel/code-intel-enricher.js +160 -0
  59. package/.grimoire/core/code-intel/index.js +137 -0
  60. package/.grimoire/core/code-intel/providers/code-graph-provider.js +201 -0
  61. package/.grimoire/core/code-intel/providers/provider-interface.js +108 -0
  62. package/.grimoire/core/config/config-cache.js +233 -0
  63. package/.grimoire/core/config/config-loader.js +281 -0
  64. package/.grimoire/core/config/config-resolver.js +609 -0
  65. package/.grimoire/core/config/env-interpolator.js +122 -0
  66. package/.grimoire/core/config/merge-utils.js +101 -0
  67. package/.grimoire/core/config/migrate-config.js +293 -0
  68. package/.grimoire/core/config/schemas/framework-config.schema.json +19 -0
  69. package/.grimoire/core/config/schemas/local-config.schema.json +20 -0
  70. package/.grimoire/core/config/schemas/project-config.schema.json +32 -0
  71. package/.grimoire/core/config/schemas/user-config.schema.json +33 -0
  72. package/.grimoire/core/config/templates/user-config.yaml +24 -0
  73. package/.grimoire/core/docs/SHARD-TRANSLATION-GUIDE.md +337 -0
  74. package/.grimoire/core/docs/component-creation-guide.md +459 -0
  75. package/.grimoire/core/docs/session-update-pattern.md +316 -0
  76. package/.grimoire/core/docs/template-syntax.md +267 -0
  77. package/.grimoire/core/docs/troubleshooting-guide.md +626 -0
  78. package/.grimoire/core/elicitation/agent-elicitation.js +272 -0
  79. package/.grimoire/core/elicitation/elicitation-engine.js +486 -0
  80. package/.grimoire/core/elicitation/session-manager.js +322 -0
  81. package/.grimoire/core/elicitation/task-elicitation.js +281 -0
  82. package/.grimoire/core/elicitation/workflow-elicitation.js +349 -0
  83. package/.grimoire/core/events/dashboard-emitter.js +369 -0
  84. package/.grimoire/core/events/index.js +17 -0
  85. package/.grimoire/core/events/types.js +52 -0
  86. package/.grimoire/core/execution/autonomous-build-loop.js +1068 -0
  87. package/.grimoire/core/execution/build-orchestrator.js +1055 -0
  88. package/.grimoire/core/execution/build-state-manager.js +1530 -0
  89. package/.grimoire/core/execution/context-injector.js +537 -0
  90. package/.grimoire/core/execution/parallel-executor.js +292 -0
  91. package/.grimoire/core/execution/parallel-monitor.js +429 -0
  92. package/.grimoire/core/execution/rate-limit-manager.js +314 -0
  93. package/.grimoire/core/execution/result-aggregator.js +486 -0
  94. package/.grimoire/core/execution/semantic-merge-engine.js +1736 -0
  95. package/.grimoire/core/execution/subagent-dispatcher.js +848 -0
  96. package/.grimoire/core/execution/wave-executor.js +397 -0
  97. package/.grimoire/core/health-check/base-check.js +224 -0
  98. package/.grimoire/core/health-check/check-registry.js +253 -0
  99. package/.grimoire/core/health-check/checks/deployment/build-config.js +111 -0
  100. package/.grimoire/core/health-check/checks/deployment/ci-config.js +125 -0
  101. package/.grimoire/core/health-check/checks/deployment/deployment-readiness.js +152 -0
  102. package/.grimoire/core/health-check/checks/deployment/docker-config.js +122 -0
  103. package/.grimoire/core/health-check/checks/deployment/env-file.js +111 -0
  104. package/.grimoire/core/health-check/checks/deployment/index.js +29 -0
  105. package/.grimoire/core/health-check/checks/index.js +56 -0
  106. package/.grimoire/core/health-check/checks/local/disk-space.js +214 -0
  107. package/.grimoire/core/health-check/checks/local/environment-vars.js +136 -0
  108. package/.grimoire/core/health-check/checks/local/git-install.js +158 -0
  109. package/.grimoire/core/health-check/checks/local/ide-detection.js +148 -0
  110. package/.grimoire/core/health-check/checks/local/index.js +35 -0
  111. package/.grimoire/core/health-check/checks/local/memory.js +138 -0
  112. package/.grimoire/core/health-check/checks/local/network.js +170 -0
  113. package/.grimoire/core/health-check/checks/local/npm-install.js +149 -0
  114. package/.grimoire/core/health-check/checks/local/shell-environment.js +120 -0
  115. package/.grimoire/core/health-check/checks/project/agent-config.js +167 -0
  116. package/.grimoire/core/health-check/checks/project/dependencies.js +150 -0
  117. package/.grimoire/core/health-check/checks/project/framework-config.js +133 -0
  118. package/.grimoire/core/health-check/checks/project/grimoire-directory.js +143 -0
  119. package/.grimoire/core/health-check/checks/project/index.js +35 -0
  120. package/.grimoire/core/health-check/checks/project/node-version.js +163 -0
  121. package/.grimoire/core/health-check/checks/project/package-json.js +107 -0
  122. package/.grimoire/core/health-check/checks/project/task-definitions.js +192 -0
  123. package/.grimoire/core/health-check/checks/project/workflow-dependencies.js +214 -0
  124. package/.grimoire/core/health-check/checks/repository/branch-protection.js +107 -0
  125. package/.grimoire/core/health-check/checks/repository/commit-history.js +144 -0
  126. package/.grimoire/core/health-check/checks/repository/conflicts.js +152 -0
  127. package/.grimoire/core/health-check/checks/repository/git-repo.js +159 -0
  128. package/.grimoire/core/health-check/checks/repository/git-status.js +149 -0
  129. package/.grimoire/core/health-check/checks/repository/gitignore.js +194 -0
  130. package/.grimoire/core/health-check/checks/repository/index.js +35 -0
  131. package/.grimoire/core/health-check/checks/repository/large-files.js +183 -0
  132. package/.grimoire/core/health-check/checks/repository/lockfile-integrity.js +144 -0
  133. package/.grimoire/core/health-check/checks/services/api-endpoints.js +168 -0
  134. package/.grimoire/core/health-check/checks/services/claude-code.js +139 -0
  135. package/.grimoire/core/health-check/checks/services/gemini-cli.js +241 -0
  136. package/.grimoire/core/health-check/checks/services/github-cli.js +117 -0
  137. package/.grimoire/core/health-check/checks/services/index.js +29 -0
  138. package/.grimoire/core/health-check/checks/services/mcp-integration.js +125 -0
  139. package/.grimoire/core/health-check/engine.js +407 -0
  140. package/.grimoire/core/health-check/healers/backup-manager.js +340 -0
  141. package/.grimoire/core/health-check/healers/index.js +330 -0
  142. package/.grimoire/core/health-check/index.js +370 -0
  143. package/.grimoire/core/health-check/reporters/console.js +331 -0
  144. package/.grimoire/core/health-check/reporters/index.js +117 -0
  145. package/.grimoire/core/health-check/reporters/json.js +301 -0
  146. package/.grimoire/core/health-check/reporters/markdown.js +323 -0
  147. package/.grimoire/core/ideation/ideation-engine.js +834 -0
  148. package/.grimoire/core/ids/README.md +123 -0
  149. package/.grimoire/core/ids/circuit-breaker.js +156 -0
  150. package/.grimoire/core/ids/framework-governor.js +567 -0
  151. package/.grimoire/core/ids/gates/g1-epic-creation.js +101 -0
  152. package/.grimoire/core/ids/gates/g2-story-creation.js +133 -0
  153. package/.grimoire/core/ids/gates/g3-story-validation.js +166 -0
  154. package/.grimoire/core/ids/gates/g4-dev-context.js +155 -0
  155. package/.grimoire/core/ids/incremental-decision-engine.js +651 -0
  156. package/.grimoire/core/ids/index.js +157 -0
  157. package/.grimoire/core/ids/registry-healer.js +868 -0
  158. package/.grimoire/core/ids/registry-loader.js +281 -0
  159. package/.grimoire/core/ids/registry-updater.js +703 -0
  160. package/.grimoire/core/ids/verification-gate.js +306 -0
  161. package/.grimoire/core/index.esm.js +44 -0
  162. package/.grimoire/core/index.js +90 -0
  163. package/.grimoire/core/manifest/manifest-generator.js +388 -0
  164. package/.grimoire/core/manifest/manifest-validator.js +431 -0
  165. package/.grimoire/core/mcp/config-migrator.js +341 -0
  166. package/.grimoire/core/mcp/global-config-manager.js +370 -0
  167. package/.grimoire/core/mcp/index.js +34 -0
  168. package/.grimoire/core/mcp/os-detector.js +189 -0
  169. package/.grimoire/core/mcp/symlink-manager.js +415 -0
  170. package/.grimoire/core/memory/__tests__/active-modules.verify.js +254 -0
  171. package/.grimoire/core/memory/gotchas-memory.js +1154 -0
  172. package/.grimoire/core/migration/migration-config.yaml +85 -0
  173. package/.grimoire/core/migration/module-mapping.yaml +91 -0
  174. package/.grimoire/core/orchestration/agent-invoker.js +612 -0
  175. package/.grimoire/core/orchestration/bob-orchestrator.js +1032 -0
  176. package/.grimoire/core/orchestration/bob-status-writer.js +482 -0
  177. package/.grimoire/core/orchestration/bob-surface-criteria.yaml +272 -0
  178. package/.grimoire/core/orchestration/brownfield-handler.js +741 -0
  179. package/.grimoire/core/orchestration/checklist-runner.js +328 -0
  180. package/.grimoire/core/orchestration/cli-commands.js +581 -0
  181. package/.grimoire/core/orchestration/condition-evaluator.js +379 -0
  182. package/.grimoire/core/orchestration/context-manager.js +616 -0
  183. package/.grimoire/core/orchestration/dashboard-integration.js +520 -0
  184. package/.grimoire/core/orchestration/data-lifecycle-manager.js +357 -0
  185. package/.grimoire/core/orchestration/epic-context-accumulator.js +396 -0
  186. package/.grimoire/core/orchestration/execution-profile-resolver.js +107 -0
  187. package/.grimoire/core/orchestration/executor-assignment.js +413 -0
  188. package/.grimoire/core/orchestration/executors/epic-3-executor.js +223 -0
  189. package/.grimoire/core/orchestration/executors/epic-4-executor.js +269 -0
  190. package/.grimoire/core/orchestration/executors/epic-5-executor.js +329 -0
  191. package/.grimoire/core/orchestration/executors/epic-6-executor.js +265 -0
  192. package/.grimoire/core/orchestration/executors/epic-executor.js +237 -0
  193. package/.grimoire/core/orchestration/executors/index.js +86 -0
  194. package/.grimoire/core/orchestration/gate-evaluator.js +495 -0
  195. package/.grimoire/core/orchestration/gemini-model-selector.js +161 -0
  196. package/.grimoire/core/orchestration/greenfield-handler.js +890 -0
  197. package/.grimoire/core/orchestration/index.js +323 -0
  198. package/.grimoire/core/orchestration/lock-manager.js +327 -0
  199. package/.grimoire/core/orchestration/master-orchestrator.js +1544 -0
  200. package/.grimoire/core/orchestration/message-formatter.js +279 -0
  201. package/.grimoire/core/orchestration/parallel-executor.js +225 -0
  202. package/.grimoire/core/orchestration/recovery-handler.js +721 -0
  203. package/.grimoire/core/orchestration/session-state.js +876 -0
  204. package/.grimoire/core/orchestration/skill-dispatcher.js +364 -0
  205. package/.grimoire/core/orchestration/subagent-prompt-builder.js +370 -0
  206. package/.grimoire/core/orchestration/surface-checker.js +403 -0
  207. package/.grimoire/core/orchestration/task-complexity-classifier.js +123 -0
  208. package/.grimoire/core/orchestration/tech-stack-detector.js +599 -0
  209. package/.grimoire/core/orchestration/terminal-spawner.js +1044 -0
  210. package/.grimoire/core/orchestration/workflow-executor.js +1182 -0
  211. package/.grimoire/core/orchestration/workflow-orchestrator.js +907 -0
  212. package/.grimoire/core/permissions/__tests__/permission-mode.test.js +293 -0
  213. package/.grimoire/core/permissions/index.js +140 -0
  214. package/.grimoire/core/permissions/operation-guard.js +395 -0
  215. package/.grimoire/core/permissions/permission-mode.js +271 -0
  216. package/.grimoire/core/quality-gates/base-layer.js +134 -0
  217. package/.grimoire/core/quality-gates/checklist-generator.js +329 -0
  218. package/.grimoire/core/quality-gates/focus-area-recommender.js +361 -0
  219. package/.grimoire/core/quality-gates/human-review-orchestrator.js +530 -0
  220. package/.grimoire/core/quality-gates/layer1-precommit.js +336 -0
  221. package/.grimoire/core/quality-gates/layer2-pr-automation.js +331 -0
  222. package/.grimoire/core/quality-gates/layer3-human-review.js +350 -0
  223. package/.grimoire/core/quality-gates/notification-manager.js +551 -0
  224. package/.grimoire/core/quality-gates/quality-gate-config.yaml +87 -0
  225. package/.grimoire/core/quality-gates/quality-gate-manager.js +603 -0
  226. package/.grimoire/core/registry/README.md +181 -0
  227. package/.grimoire/core/registry/build-registry.js +454 -0
  228. package/.grimoire/core/registry/registry-loader.js +331 -0
  229. package/.grimoire/core/registry/registry-schema.json +168 -0
  230. package/.grimoire/core/registry/service-registry.json +6468 -0
  231. package/.grimoire/core/registry/validate-registry.js +341 -0
  232. package/.grimoire/core/session/context-detector.js +233 -0
  233. package/.grimoire/core/session/context-loader.js +443 -0
  234. package/.grimoire/core/synapse/context/context-builder.js +34 -0
  235. package/.grimoire/core/synapse/context/context-tracker.js +190 -0
  236. package/.grimoire/core/synapse/diagnostics/collectors/consistency-collector.js +168 -0
  237. package/.grimoire/core/synapse/diagnostics/collectors/hook-collector.js +129 -0
  238. package/.grimoire/core/synapse/diagnostics/collectors/manifest-collector.js +82 -0
  239. package/.grimoire/core/synapse/diagnostics/collectors/output-analyzer.js +134 -0
  240. package/.grimoire/core/synapse/diagnostics/collectors/pipeline-collector.js +75 -0
  241. package/.grimoire/core/synapse/diagnostics/collectors/quality-collector.js +252 -0
  242. package/.grimoire/core/synapse/diagnostics/collectors/relevance-matrix.js +174 -0
  243. package/.grimoire/core/synapse/diagnostics/collectors/safe-read-json.js +31 -0
  244. package/.grimoire/core/synapse/diagnostics/collectors/session-collector.js +102 -0
  245. package/.grimoire/core/synapse/diagnostics/collectors/timing-collector.js +126 -0
  246. package/.grimoire/core/synapse/diagnostics/collectors/uap-collector.js +83 -0
  247. package/.grimoire/core/synapse/diagnostics/report-formatter.js +485 -0
  248. package/.grimoire/core/synapse/diagnostics/synapse-diagnostics.js +95 -0
  249. package/.grimoire/core/synapse/domain/domain-loader.js +322 -0
  250. package/.grimoire/core/synapse/engine.js +380 -0
  251. package/.grimoire/core/synapse/layers/l0-constitution.js +80 -0
  252. package/.grimoire/core/synapse/layers/l1-global.js +102 -0
  253. package/.grimoire/core/synapse/layers/l2-agent.js +94 -0
  254. package/.grimoire/core/synapse/layers/l3-workflow.js +94 -0
  255. package/.grimoire/core/synapse/layers/l4-task.js +83 -0
  256. package/.grimoire/core/synapse/layers/l5-squad.js +244 -0
  257. package/.grimoire/core/synapse/layers/l6-keyword.js +154 -0
  258. package/.grimoire/core/synapse/layers/l7-star-command.js +169 -0
  259. package/.grimoire/core/synapse/layers/layer-processor.js +82 -0
  260. package/.grimoire/core/synapse/memory/memory-bridge.js +246 -0
  261. package/.grimoire/core/synapse/output/formatter.js +561 -0
  262. package/.grimoire/core/synapse/runtime/hook-runtime.js +61 -0
  263. package/.grimoire/core/synapse/scripts/generate-constitution.js +205 -0
  264. package/.grimoire/core/synapse/session/session-manager.js +403 -0
  265. package/.grimoire/core/synapse/utils/paths.js +57 -0
  266. package/.grimoire/core/synapse/utils/tokens.js +25 -0
  267. package/.grimoire/core/ui/index.js +43 -0
  268. package/.grimoire/core/ui/observability-panel.js +394 -0
  269. package/.grimoire/core/ui/panel-renderer.js +337 -0
  270. package/.grimoire/core/utils/output-formatter.js +299 -0
  271. package/.grimoire/core/utils/security-utils.js +336 -0
  272. package/.grimoire/core/utils/yaml-validator.js +416 -0
  273. package/.grimoire/core-config.yaml +357 -0
  274. package/.grimoire/data/agent-config-requirements.yaml +409 -0
  275. package/.grimoire/data/entity-registry.yaml +9219 -0
  276. package/.grimoire/data/grimoire-kb.md +918 -0
  277. package/.grimoire/data/learned-patterns.yaml +3 -0
  278. package/.grimoire/data/tech-presets/_template.md +259 -0
  279. package/.grimoire/data/tech-presets/nextjs-react.md +933 -0
  280. package/.grimoire/data/technical-preferences.md +85 -0
  281. package/.grimoire/data/workflow-patterns.yaml +836 -0
  282. package/.grimoire/data/workflow-state-schema.yaml +203 -0
  283. package/.grimoire/development/README.md +143 -0
  284. package/.grimoire/development/agent-teams/team-all.yaml +16 -0
  285. package/.grimoire/development/agent-teams/team-fullstack.yaml +19 -0
  286. package/.grimoire/development/agent-teams/team-ide-minimal.yaml +10 -0
  287. package/.grimoire/development/agent-teams/team-no-ui.yaml +14 -0
  288. package/.grimoire/development/agent-teams/team-qa-focused.yaml +155 -0
  289. package/.grimoire/development/agents/analyst.md +261 -0
  290. package/.grimoire/development/agents/architect.md +461 -0
  291. package/.grimoire/development/agents/caravaggio.md +31 -0
  292. package/.grimoire/development/agents/data-engineer.md +482 -0
  293. package/.grimoire/development/agents/dev.md +548 -0
  294. package/.grimoire/development/agents/devops.md +500 -0
  295. package/.grimoire/development/agents/frida.md +31 -0
  296. package/.grimoire/development/agents/grimoire-master.md +447 -0
  297. package/.grimoire/development/agents/picasso.md +31 -0
  298. package/.grimoire/development/agents/pm.md +365 -0
  299. package/.grimoire/development/agents/po.md +323 -0
  300. package/.grimoire/development/agents/qa.md +437 -0
  301. package/.grimoire/development/agents/salvador.md +31 -0
  302. package/.grimoire/development/agents/sm.md +275 -0
  303. package/.grimoire/development/agents/squad-creator.md +330 -0
  304. package/.grimoire/development/agents/tarsila.md +31 -0
  305. package/.grimoire/development/agents/ux-design-expert.md +482 -0
  306. package/.grimoire/development/agents/van-gogh.md +31 -0
  307. package/.grimoire/development/agents/warhol.md +31 -0
  308. package/.grimoire/development/checklists/agent-quality-gate.md +560 -0
  309. package/.grimoire/development/checklists/brownfield-compatibility-checklist.md +116 -0
  310. package/.grimoire/development/checklists/self-critique-checklist.md +274 -0
  311. package/.grimoire/development/data/decision-heuristics-framework.md +622 -0
  312. package/.grimoire/development/data/quality-dimensions-framework.md +427 -0
  313. package/.grimoire/development/data/tier-system-framework.md +476 -0
  314. package/.grimoire/development/scripts/activation-runtime.js +64 -0
  315. package/.grimoire/development/scripts/agent-assignment-resolver.js +231 -0
  316. package/.grimoire/development/scripts/agent-config-loader.js +628 -0
  317. package/.grimoire/development/scripts/agent-exit-hooks.js +97 -0
  318. package/.grimoire/development/scripts/apply-inline-greeting-all-agents.js +147 -0
  319. package/.grimoire/development/scripts/approval-workflow.js +643 -0
  320. package/.grimoire/development/scripts/audit-agent-config.js +382 -0
  321. package/.grimoire/development/scripts/backlog-manager.js +409 -0
  322. package/.grimoire/development/scripts/backup-manager.js +607 -0
  323. package/.grimoire/development/scripts/batch-update-agents-session-context.js +97 -0
  324. package/.grimoire/development/scripts/branch-manager.js +390 -0
  325. package/.grimoire/development/scripts/code-quality-improver.js +1312 -0
  326. package/.grimoire/development/scripts/commit-message-generator.js +850 -0
  327. package/.grimoire/development/scripts/conflict-resolver.js +675 -0
  328. package/.grimoire/development/scripts/decision-context.js +229 -0
  329. package/.grimoire/development/scripts/decision-log-generator.js +294 -0
  330. package/.grimoire/development/scripts/decision-log-indexer.js +285 -0
  331. package/.grimoire/development/scripts/decision-recorder.js +169 -0
  332. package/.grimoire/development/scripts/dependency-analyzer.js +639 -0
  333. package/.grimoire/development/scripts/dev-context-loader.js +298 -0
  334. package/.grimoire/development/scripts/diff-generator.js +352 -0
  335. package/.grimoire/development/scripts/elicitation-engine.js +385 -0
  336. package/.grimoire/development/scripts/elicitation-session-manager.js +300 -0
  337. package/.grimoire/development/scripts/generate-greeting.js +109 -0
  338. package/.grimoire/development/scripts/git-wrapper.js +462 -0
  339. package/.grimoire/development/scripts/greeting-builder.js +1406 -0
  340. package/.grimoire/development/scripts/greeting-config-cli.js +86 -0
  341. package/.grimoire/development/scripts/greeting-preference-manager.js +170 -0
  342. package/.grimoire/development/scripts/manifest-preview.js +245 -0
  343. package/.grimoire/development/scripts/metrics-tracker.js +776 -0
  344. package/.grimoire/development/scripts/migrate-task-to-v2.js +379 -0
  345. package/.grimoire/development/scripts/modification-validator.js +555 -0
  346. package/.grimoire/development/scripts/pattern-learner.js +1225 -0
  347. package/.grimoire/development/scripts/performance-analyzer.js +758 -0
  348. package/.grimoire/development/scripts/populate-entity-registry.js +281 -0
  349. package/.grimoire/development/scripts/refactoring-suggester.js +1139 -0
  350. package/.grimoire/development/scripts/rollback-handler.js +532 -0
  351. package/.grimoire/development/scripts/security-checker.js +359 -0
  352. package/.grimoire/development/scripts/skill-validator.js +343 -0
  353. package/.grimoire/development/scripts/squad/README.md +114 -0
  354. package/.grimoire/development/scripts/squad/index.js +124 -0
  355. package/.grimoire/development/scripts/squad/squad-analyzer.js +638 -0
  356. package/.grimoire/development/scripts/squad/squad-designer.js +1010 -0
  357. package/.grimoire/development/scripts/squad/squad-downloader.js +511 -0
  358. package/.grimoire/development/scripts/squad/squad-extender.js +872 -0
  359. package/.grimoire/development/scripts/squad/squad-generator.js +1406 -0
  360. package/.grimoire/development/scripts/squad/squad-loader.js +359 -0
  361. package/.grimoire/development/scripts/squad/squad-migrator.js +628 -0
  362. package/.grimoire/development/scripts/squad/squad-publisher.js +630 -0
  363. package/.grimoire/development/scripts/squad/squad-validator.js +857 -0
  364. package/.grimoire/development/scripts/story-index-generator.js +339 -0
  365. package/.grimoire/development/scripts/story-manager.js +375 -0
  366. package/.grimoire/development/scripts/story-update-hook.js +259 -0
  367. package/.grimoire/development/scripts/task-identifier-resolver.js +145 -0
  368. package/.grimoire/development/scripts/template-engine.js +240 -0
  369. package/.grimoire/development/scripts/template-validator.js +279 -0
  370. package/.grimoire/development/scripts/test-generator.js +844 -0
  371. package/.grimoire/development/scripts/test-greeting-system.js +143 -0
  372. package/.grimoire/development/scripts/transaction-manager.js +591 -0
  373. package/.grimoire/development/scripts/unified-activation-pipeline.js +796 -0
  374. package/.grimoire/development/scripts/usage-tracker.js +675 -0
  375. package/.grimoire/development/scripts/validate-filenames.js +228 -0
  376. package/.grimoire/development/scripts/validate-task-v2.js +320 -0
  377. package/.grimoire/development/scripts/verify-workflow-gaps.js +1034 -0
  378. package/.grimoire/development/scripts/version-tracker.js +527 -0
  379. package/.grimoire/development/scripts/workflow-navigator.js +328 -0
  380. package/.grimoire/development/scripts/workflow-state-manager.js +652 -0
  381. package/.grimoire/development/scripts/workflow-validator.js +697 -0
  382. package/.grimoire/development/scripts/yaml-validator.js +397 -0
  383. package/.grimoire/development/tasks/add-mcp.md +437 -0
  384. package/.grimoire/development/tasks/advanced-elicitation.md +320 -0
  385. package/.grimoire/development/tasks/analyst-facilitate-brainstorming.md +343 -0
  386. package/.grimoire/development/tasks/analyze-brownfield.md +458 -0
  387. package/.grimoire/development/tasks/analyze-cross-artifact.md +358 -0
  388. package/.grimoire/development/tasks/analyze-framework.md +698 -0
  389. package/.grimoire/development/tasks/analyze-performance.md +639 -0
  390. package/.grimoire/development/tasks/analyze-project-structure.md +623 -0
  391. package/.grimoire/development/tasks/apply-qa-fixes.md +342 -0
  392. package/.grimoire/development/tasks/architect-analyze-impact.md +828 -0
  393. package/.grimoire/development/tasks/audit-codebase.md +431 -0
  394. package/.grimoire/development/tasks/audit-tailwind-config.md +272 -0
  395. package/.grimoire/development/tasks/audit-utilities.md +360 -0
  396. package/.grimoire/development/tasks/blocks/README.md +180 -0
  397. package/.grimoire/development/tasks/blocks/agent-prompt-template.md +117 -0
  398. package/.grimoire/development/tasks/blocks/context-loading.md +110 -0
  399. package/.grimoire/development/tasks/blocks/execution-pattern.md +122 -0
  400. package/.grimoire/development/tasks/blocks/finalization.md +123 -0
  401. package/.grimoire/development/tasks/bootstrap-shadcn-library.md +288 -0
  402. package/.grimoire/development/tasks/brownfield-create-epic.md +533 -0
  403. package/.grimoire/development/tasks/brownfield-create-story.md +358 -0
  404. package/.grimoire/development/tasks/build-autonomous.md +186 -0
  405. package/.grimoire/development/tasks/build-component.md +480 -0
  406. package/.grimoire/development/tasks/build-resume.md +125 -0
  407. package/.grimoire/development/tasks/build-status.md +155 -0
  408. package/.grimoire/development/tasks/build.md +142 -0
  409. package/.grimoire/development/tasks/calculate-roi.md +457 -0
  410. package/.grimoire/development/tasks/check-docs-links.md +114 -0
  411. package/.grimoire/development/tasks/ci-cd-configuration.md +766 -0
  412. package/.grimoire/development/tasks/cleanup-utilities.md +672 -0
  413. package/.grimoire/development/tasks/cleanup-worktrees.md +39 -0
  414. package/.grimoire/development/tasks/collaborative-edit.md +1110 -0
  415. package/.grimoire/development/tasks/compose-molecule.md +286 -0
  416. package/.grimoire/development/tasks/consolidate-patterns.md +416 -0
  417. package/.grimoire/development/tasks/correct-course.md +281 -0
  418. package/.grimoire/development/tasks/create-agent.md +1199 -0
  419. package/.grimoire/development/tasks/create-brownfield-story.md +728 -0
  420. package/.grimoire/development/tasks/create-deep-research-prompt.md +500 -0
  421. package/.grimoire/development/tasks/create-doc.md +318 -0
  422. package/.grimoire/development/tasks/create-next-story.md +776 -0
  423. package/.grimoire/development/tasks/create-service.md +393 -0
  424. package/.grimoire/development/tasks/create-suite.md +285 -0
  425. package/.grimoire/development/tasks/create-task.md +391 -0
  426. package/.grimoire/development/tasks/create-workflow.md +429 -0
  427. package/.grimoire/development/tasks/create-worktree.md +439 -0
  428. package/.grimoire/development/tasks/db-analyze-hotpaths.md +574 -0
  429. package/.grimoire/development/tasks/db-apply-migration.md +383 -0
  430. package/.grimoire/development/tasks/db-bootstrap.md +644 -0
  431. package/.grimoire/development/tasks/db-domain-modeling.md +695 -0
  432. package/.grimoire/development/tasks/db-dry-run.md +295 -0
  433. package/.grimoire/development/tasks/db-env-check.md +262 -0
  434. package/.grimoire/development/tasks/db-explain.md +633 -0
  435. package/.grimoire/development/tasks/db-impersonate.md +497 -0
  436. package/.grimoire/development/tasks/db-load-csv.md +595 -0
  437. package/.grimoire/development/tasks/db-policy-apply.md +655 -0
  438. package/.grimoire/development/tasks/db-rls-audit.md +413 -0
  439. package/.grimoire/development/tasks/db-rollback.md +741 -0
  440. package/.grimoire/development/tasks/db-run-sql.md +615 -0
  441. package/.grimoire/development/tasks/db-schema-audit.md +1013 -0
  442. package/.grimoire/development/tasks/db-seed.md +392 -0
  443. package/.grimoire/development/tasks/db-smoke-test.md +353 -0
  444. package/.grimoire/development/tasks/db-snapshot.md +571 -0
  445. package/.grimoire/development/tasks/db-squad-integration.md +665 -0
  446. package/.grimoire/development/tasks/db-supabase-setup.md +714 -0
  447. package/.grimoire/development/tasks/db-verify-order.md +517 -0
  448. package/.grimoire/development/tasks/deprecate-component.md +958 -0
  449. package/.grimoire/development/tasks/dev-apply-qa-fixes.md +320 -0
  450. package/.grimoire/development/tasks/dev-backlog-debt.md +471 -0
  451. package/.grimoire/development/tasks/dev-develop-story.md +912 -0
  452. package/.grimoire/development/tasks/dev-improve-code-quality.md +874 -0
  453. package/.grimoire/development/tasks/dev-optimize-performance.md +1035 -0
  454. package/.grimoire/development/tasks/dev-suggest-refactoring.md +872 -0
  455. package/.grimoire/development/tasks/dev-validate-next-story.md +350 -0
  456. package/.grimoire/development/tasks/document-gotchas.md +479 -0
  457. package/.grimoire/development/tasks/document-project.md +554 -0
  458. package/.grimoire/development/tasks/environment-bootstrap.md +1391 -0
  459. package/.grimoire/development/tasks/execute-checklist.md +303 -0
  460. package/.grimoire/development/tasks/execute-epic-plan.md +887 -0
  461. package/.grimoire/development/tasks/export-design-tokens-dtcg.md +276 -0
  462. package/.grimoire/development/tasks/extend-pattern.md +271 -0
  463. package/.grimoire/development/tasks/extract-patterns.md +399 -0
  464. package/.grimoire/development/tasks/extract-tokens.md +469 -0
  465. package/.grimoire/development/tasks/facilitate-brainstorming-session.md +520 -0
  466. package/.grimoire/development/tasks/generate-ai-frontend-prompt.md +262 -0
  467. package/.grimoire/development/tasks/generate-documentation.md +286 -0
  468. package/.grimoire/development/tasks/generate-migration-strategy.md +524 -0
  469. package/.grimoire/development/tasks/generate-shock-report.md +503 -0
  470. package/.grimoire/development/tasks/github-devops-github-pr-automation.md +666 -0
  471. package/.grimoire/development/tasks/github-devops-pre-push-quality-gate.md +791 -0
  472. package/.grimoire/development/tasks/github-devops-repository-cleanup.md +376 -0
  473. package/.grimoire/development/tasks/github-devops-version-management.md +485 -0
  474. package/.grimoire/development/tasks/gotcha.md +138 -0
  475. package/.grimoire/development/tasks/gotchas.md +155 -0
  476. package/.grimoire/development/tasks/health-check.yaml +227 -0
  477. package/.grimoire/development/tasks/ids-governor.md +96 -0
  478. package/.grimoire/development/tasks/ids-health.md +91 -0
  479. package/.grimoire/development/tasks/ids-query.md +156 -0
  480. package/.grimoire/development/tasks/improve-self.md +824 -0
  481. package/.grimoire/development/tasks/index-docs.md +389 -0
  482. package/.grimoire/development/tasks/init-project-status.md +508 -0
  483. package/.grimoire/development/tasks/integrate-squad.md +316 -0
  484. package/.grimoire/development/tasks/kb-mode-interaction.md +285 -0
  485. package/.grimoire/development/tasks/learn-patterns.md +902 -0
  486. package/.grimoire/development/tasks/list-mcps.md +33 -0
  487. package/.grimoire/development/tasks/list-worktrees.md +344 -0
  488. package/.grimoire/development/tasks/mcp-workflow.md +438 -0
  489. package/.grimoire/development/tasks/merge-worktree.md +42 -0
  490. package/.grimoire/development/tasks/modify-agent.md +399 -0
  491. package/.grimoire/development/tasks/modify-task.md +442 -0
  492. package/.grimoire/development/tasks/modify-workflow.md +511 -0
  493. package/.grimoire/development/tasks/next.md +327 -0
  494. package/.grimoire/development/tasks/orchestrate-resume.md +60 -0
  495. package/.grimoire/development/tasks/orchestrate-status.md +64 -0
  496. package/.grimoire/development/tasks/orchestrate-stop.md +55 -0
  497. package/.grimoire/development/tasks/orchestrate.md +66 -0
  498. package/.grimoire/development/tasks/patterns.md +336 -0
  499. package/.grimoire/development/tasks/plan-create-context.md +812 -0
  500. package/.grimoire/development/tasks/plan-create-implementation.md +797 -0
  501. package/.grimoire/development/tasks/plan-execute-subtask.md +962 -0
  502. package/.grimoire/development/tasks/po-backlog-add.md +372 -0
  503. package/.grimoire/development/tasks/po-close-story.md +428 -0
  504. package/.grimoire/development/tasks/po-manage-story-backlog.md +525 -0
  505. package/.grimoire/development/tasks/po-pull-story-from-clickup.md +542 -0
  506. package/.grimoire/development/tasks/po-pull-story.md +318 -0
  507. package/.grimoire/development/tasks/po-stories-index.md +353 -0
  508. package/.grimoire/development/tasks/po-sync-story-to-clickup.md +459 -0
  509. package/.grimoire/development/tasks/po-sync-story.md +305 -0
  510. package/.grimoire/development/tasks/pr-automation.md +703 -0
  511. package/.grimoire/development/tasks/propose-modification.md +844 -0
  512. package/.grimoire/development/tasks/publish-npm.md +259 -0
  513. package/.grimoire/development/tasks/qa-after-creation.md +519 -0
  514. package/.grimoire/development/tasks/qa-backlog-add-followup.md +427 -0
  515. package/.grimoire/development/tasks/qa-browser-console-check.md +343 -0
  516. package/.grimoire/development/tasks/qa-create-fix-request.md +625 -0
  517. package/.grimoire/development/tasks/qa-evidence-requirements.md +314 -0
  518. package/.grimoire/development/tasks/qa-false-positive-detection.md +374 -0
  519. package/.grimoire/development/tasks/qa-fix-issues.md +686 -0
  520. package/.grimoire/development/tasks/qa-gate.md +375 -0
  521. package/.grimoire/development/tasks/qa-generate-tests.md +1176 -0
  522. package/.grimoire/development/tasks/qa-library-validation.md +497 -0
  523. package/.grimoire/development/tasks/qa-migration-validation.md +584 -0
  524. package/.grimoire/development/tasks/qa-nfr-assess.md +559 -0
  525. package/.grimoire/development/tasks/qa-review-build.md +1225 -0
  526. package/.grimoire/development/tasks/qa-review-proposal.md +1159 -0
  527. package/.grimoire/development/tasks/qa-review-story.md +684 -0
  528. package/.grimoire/development/tasks/qa-risk-profile.md +568 -0
  529. package/.grimoire/development/tasks/qa-run-tests.md +279 -0
  530. package/.grimoire/development/tasks/qa-security-checklist.md +552 -0
  531. package/.grimoire/development/tasks/qa-test-design.md +389 -0
  532. package/.grimoire/development/tasks/qa-trace-requirements.md +478 -0
  533. package/.grimoire/development/tasks/release-management.md +754 -0
  534. package/.grimoire/development/tasks/remove-mcp.md +35 -0
  535. package/.grimoire/development/tasks/remove-worktree.md +435 -0
  536. package/.grimoire/development/tasks/run-design-system-pipeline.md +642 -0
  537. package/.grimoire/development/tasks/run-workflow-engine.md +861 -0
  538. package/.grimoire/development/tasks/run-workflow.md +389 -0
  539. package/.grimoire/development/tasks/search-mcp.md +309 -0
  540. package/.grimoire/development/tasks/security-audit.md +556 -0
  541. package/.grimoire/development/tasks/security-scan.md +792 -0
  542. package/.grimoire/development/tasks/session-resume.md +193 -0
  543. package/.grimoire/development/tasks/setup-database.md +743 -0
  544. package/.grimoire/development/tasks/setup-design-system.md +464 -0
  545. package/.grimoire/development/tasks/setup-github.md +876 -0
  546. package/.grimoire/development/tasks/setup-llm-routing.md +231 -0
  547. package/.grimoire/development/tasks/setup-mcp-docker.md +628 -0
  548. package/.grimoire/development/tasks/setup-project-docs.md +442 -0
  549. package/.grimoire/development/tasks/shard-doc.md +539 -0
  550. package/.grimoire/development/tasks/sm-create-next-story.md +482 -0
  551. package/.grimoire/development/tasks/spec-assess-complexity.md +461 -0
  552. package/.grimoire/development/tasks/spec-critique.md +595 -0
  553. package/.grimoire/development/tasks/spec-gather-requirements.md +545 -0
  554. package/.grimoire/development/tasks/spec-research-dependencies.md +446 -0
  555. package/.grimoire/development/tasks/spec-write-spec.md +531 -0
  556. package/.grimoire/development/tasks/squad-creator-analyze.md +318 -0
  557. package/.grimoire/development/tasks/squad-creator-create.md +314 -0
  558. package/.grimoire/development/tasks/squad-creator-design.md +335 -0
  559. package/.grimoire/development/tasks/squad-creator-download.md +169 -0
  560. package/.grimoire/development/tasks/squad-creator-extend.md +413 -0
  561. package/.grimoire/development/tasks/squad-creator-list.md +226 -0
  562. package/.grimoire/development/tasks/squad-creator-migrate.md +245 -0
  563. package/.grimoire/development/tasks/squad-creator-publish.md +231 -0
  564. package/.grimoire/development/tasks/squad-creator-sync-grimoire.md +317 -0
  565. package/.grimoire/development/tasks/squad-creator-sync-ide-command.md +403 -0
  566. package/.grimoire/development/tasks/squad-creator-validate.md +160 -0
  567. package/.grimoire/development/tasks/story-checkpoint.md +361 -0
  568. package/.grimoire/development/tasks/sync-documentation.md +866 -0
  569. package/.grimoire/development/tasks/tailwind-upgrade.md +296 -0
  570. package/.grimoire/development/tasks/test-as-user.md +623 -0
  571. package/.grimoire/development/tasks/test-validation-task.md +172 -0
  572. package/.grimoire/development/tasks/undo-last.md +348 -0
  573. package/.grimoire/development/tasks/update-grimoire.md +153 -0
  574. package/.grimoire/development/tasks/update-manifest.md +411 -0
  575. package/.grimoire/development/tasks/update-source-tree.md +138 -0
  576. package/.grimoire/development/tasks/ux-create-wireframe.md +619 -0
  577. package/.grimoire/development/tasks/ux-ds-scan-artifact.md +674 -0
  578. package/.grimoire/development/tasks/ux-user-research.md +561 -0
  579. package/.grimoire/development/tasks/validate-agents.md +117 -0
  580. package/.grimoire/development/tasks/validate-next-story.md +456 -0
  581. package/.grimoire/development/tasks/validate-tech-preset.md +187 -0
  582. package/.grimoire/development/tasks/validate-workflow.md +323 -0
  583. package/.grimoire/development/tasks/verify-subtask.md +237 -0
  584. package/.grimoire/development/tasks/waves.md +206 -0
  585. package/.grimoire/development/tasks/yolo-toggle.md +115 -0
  586. package/.grimoire/development/templates/grimoire-doc-template.md +496 -0
  587. package/.grimoire/development/templates/research-prompt-tmpl.md +486 -0
  588. package/.grimoire/development/templates/service-template/README.md.hbs +159 -0
  589. package/.grimoire/development/templates/service-template/__tests__/index.test.ts.hbs +238 -0
  590. package/.grimoire/development/templates/service-template/client.ts.hbs +404 -0
  591. package/.grimoire/development/templates/service-template/errors.ts.hbs +183 -0
  592. package/.grimoire/development/templates/service-template/index.ts.hbs +121 -0
  593. package/.grimoire/development/templates/service-template/jest.config.js +89 -0
  594. package/.grimoire/development/templates/service-template/package.json.hbs +88 -0
  595. package/.grimoire/development/templates/service-template/tsconfig.json +45 -0
  596. package/.grimoire/development/templates/service-template/types.ts.hbs +146 -0
  597. package/.grimoire/development/templates/squad/agent-template.md +69 -0
  598. package/.grimoire/development/templates/squad/checklist-template.md +82 -0
  599. package/.grimoire/development/templates/squad/data-template.yaml +105 -0
  600. package/.grimoire/development/templates/squad/script-template.js +179 -0
  601. package/.grimoire/development/templates/squad/task-template.md +125 -0
  602. package/.grimoire/development/templates/squad/template-template.md +98 -0
  603. package/.grimoire/development/templates/squad/tool-template.js +103 -0
  604. package/.grimoire/development/templates/squad/workflow-template.yaml +108 -0
  605. package/.grimoire/development/templates/squad-template/LICENSE +21 -0
  606. package/.grimoire/development/templates/squad-template/README.md +37 -0
  607. package/.grimoire/development/templates/squad-template/agents/example-agent.yaml +36 -0
  608. package/.grimoire/development/templates/squad-template/package.json +20 -0
  609. package/.grimoire/development/templates/squad-template/squad.yaml +26 -0
  610. package/.grimoire/development/templates/squad-template/tasks/example-task.yaml +46 -0
  611. package/.grimoire/development/templates/squad-template/templates/example-template.md +24 -0
  612. package/.grimoire/development/templates/squad-template/tests/example-agent.test.js +54 -0
  613. package/.grimoire/development/templates/squad-template/workflows/example-workflow.yaml +54 -0
  614. package/.grimoire/development/templates/subagent-step-prompt.md +122 -0
  615. package/.grimoire/development/workflows/README.md +82 -0
  616. package/.grimoire/development/workflows/auto-worktree.yaml +423 -0
  617. package/.grimoire/development/workflows/brownfield-discovery.yaml +933 -0
  618. package/.grimoire/development/workflows/brownfield-fullstack.yaml +369 -0
  619. package/.grimoire/development/workflows/brownfield-service.yaml +246 -0
  620. package/.grimoire/development/workflows/brownfield-ui.yaml +260 -0
  621. package/.grimoire/development/workflows/design-system-build-quality.yaml +228 -0
  622. package/.grimoire/development/workflows/development-cycle.yaml +427 -0
  623. package/.grimoire/development/workflows/epic-orchestration.yaml +328 -0
  624. package/.grimoire/development/workflows/greenfield-fullstack.yaml +386 -0
  625. package/.grimoire/development/workflows/greenfield-service.yaml +278 -0
  626. package/.grimoire/development/workflows/greenfield-ui.yaml +284 -0
  627. package/.grimoire/development/workflows/qa-loop.yaml +444 -0
  628. package/.grimoire/development/workflows/spec-pipeline.yaml +577 -0
  629. package/.grimoire/development/workflows/story-development-cycle.yaml +285 -0
  630. package/.grimoire/docs/standards/AGENT-PERSONALIZATION-STANDARD-V1.md +574 -0
  631. package/.grimoire/docs/standards/EXECUTOR-DECISION-TREE.md +698 -0
  632. package/.grimoire/docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md +513 -0
  633. package/.grimoire/docs/standards/QUALITY-GATES-SPECIFICATION.md +558 -0
  634. package/.grimoire/docs/standards/STANDARDS-INDEX.md +212 -0
  635. package/.grimoire/docs/standards/STORY-TEMPLATE-V2-SPECIFICATION.md +551 -0
  636. package/.grimoire/docs/standards/TASK-FORMAT-SPECIFICATION-V1.md +1415 -0
  637. package/.grimoire/docs/standards/grimoire-COLOR-PALETTE-QUICK-REFERENCE.md +186 -0
  638. package/.grimoire/docs/standards/grimoire-COLOR-PALETTE-V2.1.md +354 -0
  639. package/.grimoire/docs/standards/grimoire-LIVRO-DE-OURO-V2.1-COMPLETE.md +839 -0
  640. package/.grimoire/docs/standards/grimoire-LIVRO-DE-OURO-V2.2-SUMMARY.md +1341 -0
  641. package/.grimoire/elicitation/agent-elicitation.js +272 -0
  642. package/.grimoire/elicitation/task-elicitation.js +281 -0
  643. package/.grimoire/elicitation/workflow-elicitation.js +315 -0
  644. package/.grimoire/framework-config.yaml +152 -0
  645. package/.grimoire/hooks/gemini/after-tool.js +78 -0
  646. package/.grimoire/hooks/gemini/before-agent.js +80 -0
  647. package/.grimoire/hooks/gemini/before-tool.js +115 -0
  648. package/.grimoire/hooks/gemini/rewind-handler.js +69 -0
  649. package/.grimoire/hooks/gemini/session-end.js +91 -0
  650. package/.grimoire/hooks/gemini/session-start.js +91 -0
  651. package/.grimoire/hooks/ids-post-commit.js +118 -0
  652. package/.grimoire/hooks/ids-pre-push.js +125 -0
  653. package/.grimoire/hooks/unified/README.md +309 -0
  654. package/.grimoire/hooks/unified/hook-interface.js +161 -0
  655. package/.grimoire/hooks/unified/hook-registry.js +143 -0
  656. package/.grimoire/hooks/unified/index.js +36 -0
  657. package/.grimoire/hooks/unified/runners/precompact-runner.js +98 -0
  658. package/.grimoire/index.esm.js +17 -0
  659. package/.grimoire/index.js +17 -0
  660. package/.grimoire/infrastructure/README.md +128 -0
  661. package/.grimoire/infrastructure/contracts/compatibility/grimoire-4.0.4.yaml +46 -0
  662. package/.grimoire/infrastructure/index.js +200 -0
  663. package/.grimoire/infrastructure/integrations/ai-providers/README.md +103 -0
  664. package/.grimoire/infrastructure/integrations/ai-providers/ai-provider-factory.js +286 -0
  665. package/.grimoire/infrastructure/integrations/ai-providers/ai-provider.js +145 -0
  666. package/.grimoire/infrastructure/integrations/ai-providers/claude-provider.js +170 -0
  667. package/.grimoire/infrastructure/integrations/ai-providers/gemini-provider.js +365 -0
  668. package/.grimoire/infrastructure/integrations/ai-providers/index.js +45 -0
  669. package/.grimoire/infrastructure/integrations/gemini-extensions/cloudrun-adapter.js +129 -0
  670. package/.grimoire/infrastructure/integrations/gemini-extensions/index.js +41 -0
  671. package/.grimoire/infrastructure/integrations/gemini-extensions/policy-sync.js +74 -0
  672. package/.grimoire/infrastructure/integrations/gemini-extensions/security-adapter.js +159 -0
  673. package/.grimoire/infrastructure/integrations/gemini-extensions/supabase-adapter.js +88 -0
  674. package/.grimoire/infrastructure/integrations/gemini-extensions/workspace-adapter.js +100 -0
  675. package/.grimoire/infrastructure/integrations/pm-adapters/README.md +60 -0
  676. package/.grimoire/infrastructure/integrations/pm-adapters/clickup-adapter.js +345 -0
  677. package/.grimoire/infrastructure/integrations/pm-adapters/github-adapter.js +393 -0
  678. package/.grimoire/infrastructure/integrations/pm-adapters/jira-adapter.js +449 -0
  679. package/.grimoire/infrastructure/integrations/pm-adapters/local-adapter.js +176 -0
  680. package/.grimoire/infrastructure/schemas/agent-v3-schema.json +160 -0
  681. package/.grimoire/infrastructure/schemas/build-state.schema.json +158 -0
  682. package/.grimoire/infrastructure/schemas/task-v3-schema.json +152 -0
  683. package/.grimoire/infrastructure/scripts/approach-manager.js +1005 -0
  684. package/.grimoire/infrastructure/scripts/approval-workflow.js +644 -0
  685. package/.grimoire/infrastructure/scripts/asset-inventory.js +622 -0
  686. package/.grimoire/infrastructure/scripts/atomic-layer-classifier.js +309 -0
  687. package/.grimoire/infrastructure/scripts/backup-manager.js +607 -0
  688. package/.grimoire/infrastructure/scripts/batch-creator.js +609 -0
  689. package/.grimoire/infrastructure/scripts/branch-manager.js +391 -0
  690. package/.grimoire/infrastructure/scripts/capability-analyzer.js +535 -0
  691. package/.grimoire/infrastructure/scripts/changelog-generator.js +554 -0
  692. package/.grimoire/infrastructure/scripts/cicd-discovery.js +1269 -0
  693. package/.grimoire/infrastructure/scripts/clickup-helpers.js +227 -0
  694. package/.grimoire/infrastructure/scripts/code-quality-improver.js +1312 -0
  695. package/.grimoire/infrastructure/scripts/codebase-mapper.js +1288 -0
  696. package/.grimoire/infrastructure/scripts/codex-skills-sync/index.js +184 -0
  697. package/.grimoire/infrastructure/scripts/codex-skills-sync/validate.js +174 -0
  698. package/.grimoire/infrastructure/scripts/commit-message-generator.js +850 -0
  699. package/.grimoire/infrastructure/scripts/component-generator.js +738 -0
  700. package/.grimoire/infrastructure/scripts/component-metadata.js +628 -0
  701. package/.grimoire/infrastructure/scripts/component-search.js +278 -0
  702. package/.grimoire/infrastructure/scripts/config-cache.js +322 -0
  703. package/.grimoire/infrastructure/scripts/config-loader.js +351 -0
  704. package/.grimoire/infrastructure/scripts/conflict-resolver.js +675 -0
  705. package/.grimoire/infrastructure/scripts/coverage-analyzer.js +882 -0
  706. package/.grimoire/infrastructure/scripts/dashboard-status-writer.js +310 -0
  707. package/.grimoire/infrastructure/scripts/dependency-analyzer.js +639 -0
  708. package/.grimoire/infrastructure/scripts/dependency-impact-analyzer.js +704 -0
  709. package/.grimoire/infrastructure/scripts/diff-generator.js +129 -0
  710. package/.grimoire/infrastructure/scripts/documentation-integrity/brownfield-analyzer.js +502 -0
  711. package/.grimoire/infrastructure/scripts/documentation-integrity/config-generator.js +369 -0
  712. package/.grimoire/infrastructure/scripts/documentation-integrity/deployment-config-loader.js +309 -0
  713. package/.grimoire/infrastructure/scripts/documentation-integrity/doc-generator.js +331 -0
  714. package/.grimoire/infrastructure/scripts/documentation-integrity/gitignore-generator.js +314 -0
  715. package/.grimoire/infrastructure/scripts/documentation-integrity/index.js +75 -0
  716. package/.grimoire/infrastructure/scripts/documentation-integrity/mode-detector.js +391 -0
  717. package/.grimoire/infrastructure/scripts/documentation-synchronizer.js +1432 -0
  718. package/.grimoire/infrastructure/scripts/framework-analyzer.js +763 -0
  719. package/.grimoire/infrastructure/scripts/git-config-detector.js +293 -0
  720. package/.grimoire/infrastructure/scripts/git-hooks/post-commit.js +75 -0
  721. package/.grimoire/infrastructure/scripts/git-wrapper.js +444 -0
  722. package/.grimoire/infrastructure/scripts/gotchas-documenter.js +1296 -0
  723. package/.grimoire/infrastructure/scripts/grimoire-validator.js +295 -0
  724. package/.grimoire/infrastructure/scripts/ide-sync/README.md +220 -0
  725. package/.grimoire/infrastructure/scripts/ide-sync/agent-parser.js +295 -0
  726. package/.grimoire/infrastructure/scripts/ide-sync/gemini-commands.js +207 -0
  727. package/.grimoire/infrastructure/scripts/ide-sync/index.js +540 -0
  728. package/.grimoire/infrastructure/scripts/ide-sync/redirect-generator.js +179 -0
  729. package/.grimoire/infrastructure/scripts/ide-sync/transformers/antigravity.js +107 -0
  730. package/.grimoire/infrastructure/scripts/ide-sync/transformers/claude-code.js +86 -0
  731. package/.grimoire/infrastructure/scripts/ide-sync/transformers/cursor.js +96 -0
  732. package/.grimoire/infrastructure/scripts/ide-sync/validator.js +273 -0
  733. package/.grimoire/infrastructure/scripts/improvement-engine.js +758 -0
  734. package/.grimoire/infrastructure/scripts/improvement-validator.js +710 -0
  735. package/.grimoire/infrastructure/scripts/llm-routing/install-llm-routing.js +282 -0
  736. package/.grimoire/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +129 -0
  737. package/.grimoire/infrastructure/scripts/llm-routing/templates/claude-free-tracked.sh +108 -0
  738. package/.grimoire/infrastructure/scripts/llm-routing/templates/claude-free.cmd +80 -0
  739. package/.grimoire/infrastructure/scripts/llm-routing/templates/claude-free.sh +62 -0
  740. package/.grimoire/infrastructure/scripts/llm-routing/templates/claude-max.cmd +26 -0
  741. package/.grimoire/infrastructure/scripts/llm-routing/templates/claude-max.sh +18 -0
  742. package/.grimoire/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +73 -0
  743. package/.grimoire/infrastructure/scripts/llm-routing/templates/deepseek-proxy.sh +65 -0
  744. package/.grimoire/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +53 -0
  745. package/.grimoire/infrastructure/scripts/llm-routing/templates/deepseek-usage.sh +16 -0
  746. package/.grimoire/infrastructure/scripts/llm-routing/usage-tracker/index.js +551 -0
  747. package/.grimoire/infrastructure/scripts/migrate-agent.js +528 -0
  748. package/.grimoire/infrastructure/scripts/modification-risk-assessment.js +970 -0
  749. package/.grimoire/infrastructure/scripts/modification-validator.js +555 -0
  750. package/.grimoire/infrastructure/scripts/output-formatter.js +298 -0
  751. package/.grimoire/infrastructure/scripts/path-analyzer.js +476 -0
  752. package/.grimoire/infrastructure/scripts/pattern-extractor.js +1563 -0
  753. package/.grimoire/infrastructure/scripts/performance-analyzer.js +758 -0
  754. package/.grimoire/infrastructure/scripts/performance-and-error-resolver.js +258 -0
  755. package/.grimoire/infrastructure/scripts/performance-optimizer.js +1902 -0
  756. package/.grimoire/infrastructure/scripts/performance-tracker.js +454 -0
  757. package/.grimoire/infrastructure/scripts/plan-tracker.js +922 -0
  758. package/.grimoire/infrastructure/scripts/pm-adapter-factory.js +182 -0
  759. package/.grimoire/infrastructure/scripts/pm-adapter.js +134 -0
  760. package/.grimoire/infrastructure/scripts/pr-review-ai.js +1062 -0
  761. package/.grimoire/infrastructure/scripts/project-status-loader.js +850 -0
  762. package/.grimoire/infrastructure/scripts/qa-loop-orchestrator.js +1264 -0
  763. package/.grimoire/infrastructure/scripts/qa-report-generator.js +1154 -0
  764. package/.grimoire/infrastructure/scripts/recovery-tracker.js +965 -0
  765. package/.grimoire/infrastructure/scripts/refactoring-suggester.js +1139 -0
  766. package/.grimoire/infrastructure/scripts/repository-detector.js +66 -0
  767. package/.grimoire/infrastructure/scripts/rollback-manager.js +734 -0
  768. package/.grimoire/infrastructure/scripts/sandbox-tester.js +618 -0
  769. package/.grimoire/infrastructure/scripts/security-checker.js +359 -0
  770. package/.grimoire/infrastructure/scripts/spot-check-validator.js +149 -0
  771. package/.grimoire/infrastructure/scripts/status-mapper.js +116 -0
  772. package/.grimoire/infrastructure/scripts/story-worktree-hooks.js +426 -0
  773. package/.grimoire/infrastructure/scripts/stuck-detector.js +1251 -0
  774. package/.grimoire/infrastructure/scripts/subtask-verifier.js +793 -0
  775. package/.grimoire/infrastructure/scripts/template-engine.js +240 -0
  776. package/.grimoire/infrastructure/scripts/template-validator.js +279 -0
  777. package/.grimoire/infrastructure/scripts/test-discovery.js +1259 -0
  778. package/.grimoire/infrastructure/scripts/test-generator.js +845 -0
  779. package/.grimoire/infrastructure/scripts/test-quality-assessment.js +1082 -0
  780. package/.grimoire/infrastructure/scripts/test-utilities-fast.js +126 -0
  781. package/.grimoire/infrastructure/scripts/test-utilities.js +201 -0
  782. package/.grimoire/infrastructure/scripts/tool-resolver.js +362 -0
  783. package/.grimoire/infrastructure/scripts/transaction-manager.js +590 -0
  784. package/.grimoire/infrastructure/scripts/usage-analytics.js +636 -0
  785. package/.grimoire/infrastructure/scripts/validate-agents.js +527 -0
  786. package/.grimoire/infrastructure/scripts/validate-claude-integration.js +103 -0
  787. package/.grimoire/infrastructure/scripts/validate-codex-integration.js +143 -0
  788. package/.grimoire/infrastructure/scripts/validate-gemini-integration.js +153 -0
  789. package/.grimoire/infrastructure/scripts/validate-output-pattern.js +213 -0
  790. package/.grimoire/infrastructure/scripts/validate-parity.js +357 -0
  791. package/.grimoire/infrastructure/scripts/validate-paths.js +144 -0
  792. package/.grimoire/infrastructure/scripts/validate-user-profile.js +251 -0
  793. package/.grimoire/infrastructure/scripts/visual-impact-generator.js +1056 -0
  794. package/.grimoire/infrastructure/scripts/worktree-manager.js +704 -0
  795. package/.grimoire/infrastructure/scripts/yaml-validator.js +397 -0
  796. package/.grimoire/infrastructure/templates/coderabbit.yaml.template +280 -0
  797. package/.grimoire/infrastructure/templates/core-config/core-config-brownfield.tmpl.yaml +177 -0
  798. package/.grimoire/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml +169 -0
  799. package/.grimoire/infrastructure/templates/github-workflows/README.md +110 -0
  800. package/.grimoire/infrastructure/templates/github-workflows/ci.yml.template +170 -0
  801. package/.grimoire/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -0
  802. package/.grimoire/infrastructure/templates/github-workflows/release.yml.template +197 -0
  803. package/.grimoire/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +20 -0
  804. package/.grimoire/infrastructure/templates/gitignore/gitignore-grimoire-base.tmpl +65 -0
  805. package/.grimoire/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -0
  806. package/.grimoire/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -0
  807. package/.grimoire/infrastructure/templates/grimoire-sync.yaml.template +183 -0
  808. package/.grimoire/infrastructure/templates/project-docs/coding-standards-tmpl.md +347 -0
  809. package/.grimoire/infrastructure/templates/project-docs/source-tree-tmpl.md +179 -0
  810. package/.grimoire/infrastructure/templates/project-docs/tech-stack-tmpl.md +269 -0
  811. package/.grimoire/infrastructure/tests/project-status-loader.test.js +569 -0
  812. package/.grimoire/infrastructure/tests/regression-suite-v2.md +622 -0
  813. package/.grimoire/infrastructure/tests/validate-module.js +98 -0
  814. package/.grimoire/infrastructure/tests/worktree-manager.test.js +620 -0
  815. package/.grimoire/infrastructure/tools/README.md +224 -0
  816. package/.grimoire/infrastructure/tools/cli/github-cli.yaml +200 -0
  817. package/.grimoire/infrastructure/tools/cli/llm-routing.yaml +128 -0
  818. package/.grimoire/infrastructure/tools/cli/railway-cli.yaml +260 -0
  819. package/.grimoire/infrastructure/tools/cli/supabase-cli.yaml +224 -0
  820. package/.grimoire/infrastructure/tools/local/ffmpeg.yaml +261 -0
  821. package/.grimoire/infrastructure/tools/mcp/21st-dev-magic.yaml +127 -0
  822. package/.grimoire/infrastructure/tools/mcp/browser.yaml +103 -0
  823. package/.grimoire/infrastructure/tools/mcp/clickup.yaml +535 -0
  824. package/.grimoire/infrastructure/tools/mcp/context7.yaml +78 -0
  825. package/.grimoire/infrastructure/tools/mcp/desktop-commander.yaml +180 -0
  826. package/.grimoire/infrastructure/tools/mcp/exa.yaml +103 -0
  827. package/.grimoire/infrastructure/tools/mcp/google-workspace.yaml +930 -0
  828. package/.grimoire/infrastructure/tools/mcp/n8n.yaml +551 -0
  829. package/.grimoire/infrastructure/tools/mcp/supabase.yaml +808 -0
  830. package/.grimoire/install-manifest.yaml +4058 -0
  831. package/.grimoire/local-config.yaml.template +73 -0
  832. package/.grimoire/manifests/schema/manifest-schema.json +191 -0
  833. package/.grimoire/monitor/hooks/lib/__init__.py +2 -0
  834. package/.grimoire/monitor/hooks/lib/enrich.py +59 -0
  835. package/.grimoire/monitor/hooks/lib/send_event.py +48 -0
  836. package/.grimoire/monitor/hooks/notification.py +30 -0
  837. package/.grimoire/monitor/hooks/post_tool_use.py +46 -0
  838. package/.grimoire/monitor/hooks/pre_compact.py +30 -0
  839. package/.grimoire/monitor/hooks/pre_tool_use.py +41 -0
  840. package/.grimoire/monitor/hooks/stop.py +30 -0
  841. package/.grimoire/monitor/hooks/subagent_stop.py +30 -0
  842. package/.grimoire/monitor/hooks/user_prompt_submit.py +39 -0
  843. package/.grimoire/package.json +104 -0
  844. package/.grimoire/presets/README.md +359 -0
  845. package/.grimoire/product/README.md +57 -0
  846. package/.grimoire/product/checklists/accessibility-wcag-checklist.md +80 -0
  847. package/.grimoire/product/checklists/architect-checklist.md +444 -0
  848. package/.grimoire/product/checklists/change-checklist.md +183 -0
  849. package/.grimoire/product/checklists/component-quality-checklist.md +74 -0
  850. package/.grimoire/product/checklists/database-design-checklist.md +119 -0
  851. package/.grimoire/product/checklists/dba-predeploy-checklist.md +97 -0
  852. package/.grimoire/product/checklists/dba-rollback-checklist.md +99 -0
  853. package/.grimoire/product/checklists/migration-readiness-checklist.md +75 -0
  854. package/.grimoire/product/checklists/pattern-audit-checklist.md +88 -0
  855. package/.grimoire/product/checklists/pm-checklist.md +376 -0
  856. package/.grimoire/product/checklists/po-master-checklist.md +442 -0
  857. package/.grimoire/product/checklists/pre-push-checklist.md +108 -0
  858. package/.grimoire/product/checklists/release-checklist.md +122 -0
  859. package/.grimoire/product/checklists/self-critique-checklist.md +387 -0
  860. package/.grimoire/product/checklists/story-dod-checklist.md +102 -0
  861. package/.grimoire/product/checklists/story-draft-checklist.md +216 -0
  862. package/.grimoire/product/data/atomic-design-principles.md +108 -0
  863. package/.grimoire/product/data/brainstorming-techniques.md +37 -0
  864. package/.grimoire/product/data/consolidation-algorithms.md +142 -0
  865. package/.grimoire/product/data/database-best-practices.md +182 -0
  866. package/.grimoire/product/data/design-token-best-practices.md +107 -0
  867. package/.grimoire/product/data/elicitation-methods.md +135 -0
  868. package/.grimoire/product/data/integration-patterns.md +207 -0
  869. package/.grimoire/product/data/migration-safety-guide.md +329 -0
  870. package/.grimoire/product/data/mode-selection-best-practices.md +471 -0
  871. package/.grimoire/product/data/postgres-tuning-guide.md +300 -0
  872. package/.grimoire/product/data/rls-security-patterns.md +333 -0
  873. package/.grimoire/product/data/roi-calculation-guide.md +142 -0
  874. package/.grimoire/product/data/supabase-patterns.md +330 -0
  875. package/.grimoire/product/data/test-levels-framework.md +149 -0
  876. package/.grimoire/product/data/test-priorities-matrix.md +175 -0
  877. package/.grimoire/product/data/wcag-compliance-guide.md +267 -0
  878. package/.grimoire/product/templates/activation-instructions-inline-greeting.yaml +64 -0
  879. package/.grimoire/product/templates/activation-instructions-template.md +260 -0
  880. package/.grimoire/product/templates/adr.hbs +126 -0
  881. package/.grimoire/product/templates/agent-template.yaml +122 -0
  882. package/.grimoire/product/templates/architecture-tmpl.yaml +651 -0
  883. package/.grimoire/product/templates/brainstorming-output-tmpl.yaml +156 -0
  884. package/.grimoire/product/templates/brownfield-architecture-tmpl.yaml +476 -0
  885. package/.grimoire/product/templates/brownfield-prd-tmpl.yaml +280 -0
  886. package/.grimoire/product/templates/brownfield-risk-report-tmpl.yaml +278 -0
  887. package/.grimoire/product/templates/changelog-template.md +134 -0
  888. package/.grimoire/product/templates/command-rationalization-matrix.md +154 -0
  889. package/.grimoire/product/templates/competitor-analysis-tmpl.yaml +293 -0
  890. package/.grimoire/product/templates/component-react-tmpl.tsx +98 -0
  891. package/.grimoire/product/templates/current-approach-tmpl.md +56 -0
  892. package/.grimoire/product/templates/dbdr.hbs +242 -0
  893. package/.grimoire/product/templates/design-story-tmpl.yaml +588 -0
  894. package/.grimoire/product/templates/ds-artifact-analysis.md +70 -0
  895. package/.grimoire/product/templates/engine/elicitation.js +298 -0
  896. package/.grimoire/product/templates/engine/index.js +310 -0
  897. package/.grimoire/product/templates/engine/loader.js +232 -0
  898. package/.grimoire/product/templates/engine/renderer.js +343 -0
  899. package/.grimoire/product/templates/engine/schemas/adr.schema.json +102 -0
  900. package/.grimoire/product/templates/engine/schemas/dbdr.schema.json +205 -0
  901. package/.grimoire/product/templates/engine/schemas/epic.schema.json +175 -0
  902. package/.grimoire/product/templates/engine/schemas/pmdr.schema.json +175 -0
  903. package/.grimoire/product/templates/engine/schemas/prd-v2.schema.json +300 -0
  904. package/.grimoire/product/templates/engine/schemas/prd.schema.json +152 -0
  905. package/.grimoire/product/templates/engine/schemas/story.schema.json +222 -0
  906. package/.grimoire/product/templates/engine/schemas/task.schema.json +154 -0
  907. package/.grimoire/product/templates/engine/validator.js +295 -0
  908. package/.grimoire/product/templates/epic.hbs +213 -0
  909. package/.grimoire/product/templates/eslintrc-security.json +32 -0
  910. package/.grimoire/product/templates/front-end-architecture-tmpl.yaml +206 -0
  911. package/.grimoire/product/templates/front-end-spec-tmpl.yaml +349 -0
  912. package/.grimoire/product/templates/fullstack-architecture-tmpl.yaml +805 -0
  913. package/.grimoire/product/templates/gemini/settings.json +81 -0
  914. package/.grimoire/product/templates/github-actions-cd.yml +213 -0
  915. package/.grimoire/product/templates/github-actions-ci.yml +173 -0
  916. package/.grimoire/product/templates/github-pr-template.md +68 -0
  917. package/.grimoire/product/templates/gordon-mcp.yaml +141 -0
  918. package/.grimoire/product/templates/grimoire-ai-config.yaml +107 -0
  919. package/.grimoire/product/templates/ide-rules/antigravity-rules.md +117 -0
  920. package/.grimoire/product/templates/ide-rules/claude-rules.md +233 -0
  921. package/.grimoire/product/templates/ide-rules/codex-rules.md +67 -0
  922. package/.grimoire/product/templates/ide-rules/copilot-rules.md +94 -0
  923. package/.grimoire/product/templates/ide-rules/cursor-rules.md +116 -0
  924. package/.grimoire/product/templates/ide-rules/gemini-rules.md +89 -0
  925. package/.grimoire/product/templates/index-strategy-tmpl.yaml +53 -0
  926. package/.grimoire/product/templates/market-research-tmpl.yaml +252 -0
  927. package/.grimoire/product/templates/mcp-workflow.js +273 -0
  928. package/.grimoire/product/templates/migration-plan-tmpl.yaml +1022 -0
  929. package/.grimoire/product/templates/migration-strategy-tmpl.md +524 -0
  930. package/.grimoire/product/templates/personalized-agent-template.md +260 -0
  931. package/.grimoire/product/templates/personalized-checklist-template.md +341 -0
  932. package/.grimoire/product/templates/personalized-task-template-v2.md +907 -0
  933. package/.grimoire/product/templates/personalized-task-template.md +345 -0
  934. package/.grimoire/product/templates/personalized-template-file.yaml +323 -0
  935. package/.grimoire/product/templates/personalized-workflow-template.yaml +461 -0
  936. package/.grimoire/product/templates/pmdr.hbs +187 -0
  937. package/.grimoire/product/templates/prd-tmpl.yaml +202 -0
  938. package/.grimoire/product/templates/prd-v2.0.hbs +217 -0
  939. package/.grimoire/product/templates/prd.hbs +202 -0
  940. package/.grimoire/product/templates/project-brief-tmpl.yaml +221 -0
  941. package/.grimoire/product/templates/qa-gate-tmpl.yaml +240 -0
  942. package/.grimoire/product/templates/qa-report-tmpl.md +235 -0
  943. package/.grimoire/product/templates/rls-policies-tmpl.yaml +1203 -0
  944. package/.grimoire/product/templates/schema-design-tmpl.yaml +428 -0
  945. package/.grimoire/product/templates/shock-report-tmpl.html +502 -0
  946. package/.grimoire/product/templates/spec-tmpl.md +235 -0
  947. package/.grimoire/product/templates/state-persistence-tmpl.yaml +219 -0
  948. package/.grimoire/product/templates/statusline/statusline-script.js +190 -0
  949. package/.grimoire/product/templates/statusline/track-agent.sh +70 -0
  950. package/.grimoire/product/templates/story-tmpl.yaml +369 -0
  951. package/.grimoire/product/templates/story.hbs +264 -0
  952. package/.grimoire/product/templates/task-execution-report.md +496 -0
  953. package/.grimoire/product/templates/task-template.md +123 -0
  954. package/.grimoire/product/templates/task.hbs +171 -0
  955. package/.grimoire/product/templates/tmpl-comment-on-examples.sql +158 -0
  956. package/.grimoire/product/templates/tmpl-migration-script.sql +91 -0
  957. package/.grimoire/product/templates/tmpl-rls-granular-policies.sql +104 -0
  958. package/.grimoire/product/templates/tmpl-rls-kiss-policy.sql +10 -0
  959. package/.grimoire/product/templates/tmpl-rls-roles.sql +135 -0
  960. package/.grimoire/product/templates/tmpl-rls-simple.sql +77 -0
  961. package/.grimoire/product/templates/tmpl-rls-tenant.sql +152 -0
  962. package/.grimoire/product/templates/tmpl-rollback-script.sql +77 -0
  963. package/.grimoire/product/templates/tmpl-seed-data.sql +140 -0
  964. package/.grimoire/product/templates/tmpl-smoke-test.sql +16 -0
  965. package/.grimoire/product/templates/tmpl-staging-copy-merge.sql +139 -0
  966. package/.grimoire/product/templates/tmpl-stored-proc.sql +140 -0
  967. package/.grimoire/product/templates/tmpl-trigger.sql +152 -0
  968. package/.grimoire/product/templates/tmpl-view-materialized.sql +133 -0
  969. package/.grimoire/product/templates/tmpl-view.sql +177 -0
  970. package/.grimoire/product/templates/token-exports-css-tmpl.css +240 -0
  971. package/.grimoire/product/templates/token-exports-tailwind-tmpl.js +395 -0
  972. package/.grimoire/product/templates/tokens-schema-tmpl.yaml +305 -0
  973. package/.grimoire/product/templates/workflow-template.yaml +152 -0
  974. package/.grimoire/project-config.yaml +166 -0
  975. package/.grimoire/quality/metrics-collector.js +601 -0
  976. package/.grimoire/quality/metrics-hook.js +261 -0
  977. package/.grimoire/quality/schemas/quality-metrics.schema.json +234 -0
  978. package/.grimoire/quality/seed-metrics.js +336 -0
  979. package/.grimoire/schemas/README.md +405 -0
  980. package/.grimoire/schemas/agent-v3-schema.json +395 -0
  981. package/.grimoire/schemas/squad-design-schema.json +300 -0
  982. package/.grimoire/schemas/squad-schema.json +187 -0
  983. package/.grimoire/schemas/task-v3-schema.json +354 -0
  984. package/.grimoire/schemas/validate-v3-schema.js +431 -0
  985. package/.grimoire/scripts/README.md +124 -0
  986. package/.grimoire/scripts/batch-migrate-phase1.ps1 +37 -0
  987. package/.grimoire/scripts/batch-migrate-phase2.ps1 +89 -0
  988. package/.grimoire/scripts/batch-migrate-phase3.ps1 +46 -0
  989. package/.grimoire/scripts/command-execution-hook.js +202 -0
  990. package/.grimoire/scripts/diagnostics/diagnose-installation.js +276 -0
  991. package/.grimoire/scripts/diagnostics/diagnose-npx-issue.ps1 +98 -0
  992. package/.grimoire/scripts/diagnostics/health-dashboard/README.md +123 -0
  993. package/.grimoire/scripts/diagnostics/health-dashboard/index.html +14 -0
  994. package/.grimoire/scripts/diagnostics/health-dashboard/package-lock.json +5262 -0
  995. package/.grimoire/scripts/diagnostics/health-dashboard/package.json +25 -0
  996. package/.grimoire/scripts/diagnostics/health-dashboard/public/favicon.svg +10 -0
  997. package/.grimoire/scripts/diagnostics/health-dashboard/src/App.jsx +22 -0
  998. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/AutoFixLog.css +122 -0
  999. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/AutoFixLog.jsx +72 -0
  1000. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/DomainCard.css +121 -0
  1001. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/DomainCard.jsx +116 -0
  1002. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/HealthScore.css +80 -0
  1003. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/HealthScore.jsx +81 -0
  1004. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/IssuesList.css +184 -0
  1005. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/IssuesList.jsx +145 -0
  1006. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/TechDebtList.css +114 -0
  1007. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/TechDebtList.jsx +72 -0
  1008. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/index.js +9 -0
  1009. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/shared/Card.css +44 -0
  1010. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/shared/Card.jsx +25 -0
  1011. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/shared/Chart.css +14 -0
  1012. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/shared/Chart.jsx +138 -0
  1013. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/shared/Header.css +54 -0
  1014. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/shared/Header.jsx +22 -0
  1015. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/shared/StatusBadge.css +77 -0
  1016. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/shared/StatusBadge.jsx +45 -0
  1017. package/.grimoire/scripts/diagnostics/health-dashboard/src/components/shared/index.js +4 -0
  1018. package/.grimoire/scripts/diagnostics/health-dashboard/src/hooks/index.js +2 -0
  1019. package/.grimoire/scripts/diagnostics/health-dashboard/src/hooks/useAutoRefresh.js +89 -0
  1020. package/.grimoire/scripts/diagnostics/health-dashboard/src/hooks/useHealthData.js +308 -0
  1021. package/.grimoire/scripts/diagnostics/health-dashboard/src/main.jsx +13 -0
  1022. package/.grimoire/scripts/diagnostics/health-dashboard/src/pages/Dashboard.css +238 -0
  1023. package/.grimoire/scripts/diagnostics/health-dashboard/src/pages/Dashboard.jsx +154 -0
  1024. package/.grimoire/scripts/diagnostics/health-dashboard/src/pages/DomainDetail.css +259 -0
  1025. package/.grimoire/scripts/diagnostics/health-dashboard/src/pages/DomainDetail.jsx +164 -0
  1026. package/.grimoire/scripts/diagnostics/health-dashboard/src/pages/index.js +2 -0
  1027. package/.grimoire/scripts/diagnostics/health-dashboard/src/styles/App.css +19 -0
  1028. package/.grimoire/scripts/diagnostics/health-dashboard/src/styles/index.css +67 -0
  1029. package/.grimoire/scripts/diagnostics/health-dashboard/vite.config.js +23 -0
  1030. package/.grimoire/scripts/diagnostics/quick-diagnose.cmd +86 -0
  1031. package/.grimoire/scripts/diagnostics/quick-diagnose.ps1 +118 -0
  1032. package/.grimoire/scripts/grimoire-doc-template.md +326 -0
  1033. package/.grimoire/scripts/migrate-framework-docs.sh +302 -0
  1034. package/.grimoire/scripts/pm.sh +455 -0
  1035. package/.grimoire/scripts/session-context-loader.js +46 -0
  1036. package/.grimoire/scripts/test-template-system.js +942 -0
  1037. package/.grimoire/scripts/update-grimoire.sh +176 -0
  1038. package/.grimoire/scripts/validate-phase1.ps1 +36 -0
  1039. package/.grimoire/scripts/workflow-management.md +70 -0
  1040. package/.grimoire/user-guide.md +1411 -0
  1041. package/.grimoire/utils/format-duration.js +95 -0
  1042. package/.grimoire/utils/grimoire-validator.js +27 -0
  1043. package/.grimoire/workflow-intelligence/__tests__/confidence-scorer.test.js +334 -0
  1044. package/.grimoire/workflow-intelligence/__tests__/integration.test.js +339 -0
  1045. package/.grimoire/workflow-intelligence/__tests__/suggestion-engine.test.js +437 -0
  1046. package/.grimoire/workflow-intelligence/__tests__/wave-analyzer.test.js +447 -0
  1047. package/.grimoire/workflow-intelligence/__tests__/workflow-registry.test.js +302 -0
  1048. package/.grimoire/workflow-intelligence/engine/confidence-scorer.js +306 -0
  1049. package/.grimoire/workflow-intelligence/engine/output-formatter.js +299 -0
  1050. package/.grimoire/workflow-intelligence/engine/suggestion-engine.js +798 -0
  1051. package/.grimoire/workflow-intelligence/engine/wave-analyzer.js +683 -0
  1052. package/.grimoire/workflow-intelligence/index.js +330 -0
  1053. package/.grimoire/workflow-intelligence/learning/capture-hook.js +148 -0
  1054. package/.grimoire/workflow-intelligence/learning/gotcha-registry.js +654 -0
  1055. package/.grimoire/workflow-intelligence/learning/index.js +306 -0
  1056. package/.grimoire/workflow-intelligence/learning/pattern-capture.js +330 -0
  1057. package/.grimoire/workflow-intelligence/learning/pattern-store.js +497 -0
  1058. package/.grimoire/workflow-intelligence/learning/pattern-validator.js +310 -0
  1059. package/.grimoire/workflow-intelligence/learning/qa-feedback.js +586 -0
  1060. package/.grimoire/workflow-intelligence/learning/semantic-search.js +521 -0
  1061. package/.grimoire/workflow-intelligence/registry/workflow-registry.js +357 -0
  1062. package/.grimoire/working-in-the-brownfield.md +362 -0
  1063. package/LICENSE +25 -0
  1064. package/README.md +59 -0
  1065. package/bin/grimoire-ids.js +560 -0
  1066. package/bin/grimoire-init.js +1232 -0
  1067. package/bin/grimoire-minimal.js +40 -0
  1068. package/bin/grimoire.js +1118 -0
  1069. package/bin/modules/env-config.js +436 -0
  1070. package/bin/modules/mcp-installer.js +384 -0
  1071. package/bin/utils/install-errors.js +340 -0
  1072. package/bin/utils/install-transaction.js +447 -0
  1073. package/bin/utils/pro-detector.js +110 -0
  1074. package/package.json +158 -0
  1075. package/packages/gemini-grimoire-extension/README.md +55 -0
  1076. package/packages/gemini-grimoire-extension/commands/grimoire-agent.js +7 -0
  1077. package/packages/gemini-grimoire-extension/commands/grimoire-agents.js +51 -0
  1078. package/packages/gemini-grimoire-extension/commands/grimoire-analyst.js +6 -0
  1079. package/packages/gemini-grimoire-extension/commands/grimoire-architect.js +6 -0
  1080. package/packages/gemini-grimoire-extension/commands/grimoire-data-engineer.js +6 -0
  1081. package/packages/gemini-grimoire-extension/commands/grimoire-dev.js +6 -0
  1082. package/packages/gemini-grimoire-extension/commands/grimoire-devops.js +6 -0
  1083. package/packages/gemini-grimoire-extension/commands/grimoire-master.js +7 -0
  1084. package/packages/gemini-grimoire-extension/commands/grimoire-menu.js +6 -0
  1085. package/packages/gemini-grimoire-extension/commands/grimoire-pm.js +6 -0
  1086. package/packages/gemini-grimoire-extension/commands/grimoire-po.js +6 -0
  1087. package/packages/gemini-grimoire-extension/commands/grimoire-qa.js +6 -0
  1088. package/packages/gemini-grimoire-extension/commands/grimoire-sm.js +6 -0
  1089. package/packages/gemini-grimoire-extension/commands/grimoire-squad-creator.js +6 -0
  1090. package/packages/gemini-grimoire-extension/commands/grimoire-status.js +68 -0
  1091. package/packages/gemini-grimoire-extension/commands/grimoire-ux-design-expert.js +6 -0
  1092. package/packages/gemini-grimoire-extension/commands/grimoire-validate.js +35 -0
  1093. package/packages/gemini-grimoire-extension/commands/lib/agent-launcher.js +147 -0
  1094. package/packages/gemini-grimoire-extension/extension.json +149 -0
  1095. package/packages/gemini-grimoire-extension/gemini-extension.json +149 -0
  1096. package/packages/gemini-grimoire-extension/hooks/hooks.json +72 -0
  1097. package/packages/grimoire-install/.releaserc.json +39 -0
  1098. package/packages/grimoire-install/CHANGELOG.md +33 -0
  1099. package/packages/grimoire-install/README.md +119 -0
  1100. package/packages/grimoire-install/bin/edmcp.js +80 -0
  1101. package/packages/grimoire-install/bin/grimoire-install.js +51 -0
  1102. package/packages/grimoire-install/jest.config.js +27 -0
  1103. package/packages/grimoire-install/package.json +68 -0
  1104. package/packages/grimoire-install/src/dep-checker.js +306 -0
  1105. package/packages/grimoire-install/src/edmcp/index.js +382 -0
  1106. package/packages/grimoire-install/src/installer.js +487 -0
  1107. package/packages/grimoire-install/src/os-detector.js +280 -0
  1108. package/packages/grimoire-pro-cli/bin/grimoire-pro.js +233 -0
  1109. package/packages/grimoire-pro-cli/package.json +38 -0
  1110. package/packages/grimoire-pro-cli/src/recover.js +101 -0
  1111. package/packages/installer/package.json +40 -0
  1112. package/packages/installer/src/__tests__/performance-benchmark.js +384 -0
  1113. package/packages/installer/src/config/configure-environment.js +373 -0
  1114. package/packages/installer/src/config/ide-configs.js +161 -0
  1115. package/packages/installer/src/config/templates/core-config-template.js +199 -0
  1116. package/packages/installer/src/config/templates/env-template.js +272 -0
  1117. package/packages/installer/src/config/validation/config-validator.js +244 -0
  1118. package/packages/installer/src/detection/detect-project-type.js +83 -0
  1119. package/packages/installer/src/installer/brownfield-upgrader.js +440 -0
  1120. package/packages/installer/src/installer/dependency-installer.js +335 -0
  1121. package/packages/installer/src/installer/file-hasher.js +234 -0
  1122. package/packages/installer/src/installer/grimoire-core-installer.js +428 -0
  1123. package/packages/installer/src/installer/manifest-signature.js +380 -0
  1124. package/packages/installer/src/installer/post-install-validator.js +1524 -0
  1125. package/packages/installer/src/merger/index.js +72 -0
  1126. package/packages/installer/src/merger/parsers/env-parser.js +153 -0
  1127. package/packages/installer/src/merger/parsers/markdown-section-parser.js +199 -0
  1128. package/packages/installer/src/merger/strategies/base-merger.js +61 -0
  1129. package/packages/installer/src/merger/strategies/env-merger.js +138 -0
  1130. package/packages/installer/src/merger/strategies/index.js +105 -0
  1131. package/packages/installer/src/merger/strategies/markdown-merger.js +208 -0
  1132. package/packages/installer/src/merger/strategies/replace-merger.js +68 -0
  1133. package/packages/installer/src/merger/types.js +72 -0
  1134. package/packages/installer/src/pro/pro-scaffolder.js +387 -0
  1135. package/packages/installer/src/updater/index.js +814 -0
  1136. package/packages/installer/src/utils/grimoire-colors.js +235 -0
  1137. package/packages/installer/src/wizard/feedback.js +232 -0
  1138. package/packages/installer/src/wizard/i18n.js +230 -0
  1139. package/packages/installer/src/wizard/ide-config-generator.js +993 -0
  1140. package/packages/installer/src/wizard/ide-selector.js +86 -0
  1141. package/packages/installer/src/wizard/index.js +831 -0
  1142. package/packages/installer/src/wizard/pro-setup.js +1223 -0
  1143. package/packages/installer/src/wizard/questions.js +336 -0
  1144. package/packages/installer/src/wizard/validation/index.js +121 -0
  1145. package/packages/installer/src/wizard/validation/report-generator.js +254 -0
  1146. package/packages/installer/src/wizard/validation/troubleshooting-system.js +348 -0
  1147. package/packages/installer/src/wizard/validation/validators/config-validator.js +364 -0
  1148. package/packages/installer/src/wizard/validation/validators/dependency-validator.js +333 -0
  1149. package/packages/installer/src/wizard/validation/validators/file-structure-validator.js +175 -0
  1150. package/packages/installer/src/wizard/validation/validators/mcp-health-checker.js +310 -0
  1151. package/packages/installer/src/wizard/validators.js +274 -0
  1152. package/packages/installer/src/wizard/wizard.js +246 -0
  1153. package/packages/installer/tests/integration/environment-configuration.test.js +331 -0
  1154. package/packages/installer/tests/integration/wizard-detection.test.js +353 -0
  1155. package/packages/installer/tests/unit/config-validator.test.js +316 -0
  1156. package/packages/installer/tests/unit/detection/detect-project-type.test.js +403 -0
  1157. package/packages/installer/tests/unit/env-template.test.js +189 -0
  1158. package/packages/installer/tests/unit/merger/env-merger.test.js +192 -0
  1159. package/packages/installer/tests/unit/merger/markdown-merger.test.js +262 -0
  1160. package/packages/installer/tests/unit/merger/strategies.test.js +153 -0
  1161. package/scripts/check-markdown-links.py +353 -0
  1162. package/scripts/code-intel-health-check.js +344 -0
  1163. package/scripts/dashboard-parallel-dev.sh +184 -0
  1164. package/scripts/dashboard-parallel-phase3.sh +130 -0
  1165. package/scripts/dashboard-parallel-phase4.sh +131 -0
  1166. package/scripts/ensure-manifest.js +59 -0
  1167. package/scripts/generate-install-manifest.js +368 -0
  1168. package/scripts/install-monitor-hooks.sh +83 -0
  1169. package/scripts/package-synapse.js +325 -0
  1170. package/scripts/semantic-lint.js +191 -0
  1171. package/scripts/sign-manifest.ps1 +132 -0
  1172. package/scripts/sign-manifest.sh +122 -0
  1173. package/scripts/validate-manifest.js +267 -0
  1174. package/scripts/validate-package-completeness.js +319 -0
@@ -0,0 +1,1902 @@
1
+ /**
2
+ * grimoire Performance Optimizer
3
+ *
4
+ * Analyzes code for performance bottlenecks and suggests optimizations
5
+ * to improve runtime performance, memory usage, and scalability.
6
+ */
7
+
8
+ const fs = require('fs').promises;
9
+ const path = require('path');
10
+ const { EventEmitter } = require('events');
11
+ const parser = require('@babel/parser');
12
+ const traverse = require('@babel/traverse').default;
13
+ const t = require('@babel/types');
14
+ const { performance } = require('perf_hooks');
15
+
16
+ class PerformanceOptimizer extends EventEmitter {
17
+ constructor(options = {}) {
18
+ super();
19
+ this.rootPath = options.rootPath || process.cwd();
20
+ this.optimizationPatterns = new Map();
21
+ this.performanceMetrics = new Map();
22
+ this.optimizationHistory = [];
23
+ this.options = {
24
+ enableProfiling: options.enableProfiling !== false,
25
+ profileDuration: options.profileDuration || 5000, // 5 seconds
26
+ memoryThreshold: options.memoryThreshold || 100 * 1024 * 1024, // 100MB
27
+ timeThreshold: options.timeThreshold || 1000, // 1 second
28
+ complexityThreshold: options.complexityThreshold || 10,
29
+ ...options,
30
+ };
31
+
32
+ this.initializeOptimizationPatterns();
33
+ }
34
+
35
+ initializeOptimizationPatterns() {
36
+ // Algorithm optimizations
37
+ this.optimizationPatterns.set('algorithm_complexity', {
38
+ name: 'Algorithm Complexity',
39
+ description: 'Optimize algorithms with high time complexity',
40
+ detector: this.detectHighComplexityAlgorithms.bind(this),
41
+ optimizer: this.suggestAlgorithmOptimizations.bind(this),
42
+ impact: 'high',
43
+ category: 'algorithm',
44
+ });
45
+
46
+ // Loop optimizations
47
+ this.optimizationPatterns.set('loop_optimization', {
48
+ name: 'Loop Optimization',
49
+ description: 'Optimize nested loops and inefficient iterations',
50
+ detector: this.detectIneffientLoops.bind(this),
51
+ optimizer: this.suggestLoopOptimizations.bind(this),
52
+ impact: 'high',
53
+ category: 'algorithm',
54
+ });
55
+
56
+ // Memory optimizations
57
+ this.optimizationPatterns.set('memory_usage', {
58
+ name: 'Memory Usage',
59
+ description: 'Reduce memory consumption and prevent leaks',
60
+ detector: this.detectMemoryIssues.bind(this),
61
+ optimizer: this.suggestMemoryOptimizations.bind(this),
62
+ impact: 'medium',
63
+ category: 'memory',
64
+ });
65
+
66
+ // Async optimizations
67
+ this.optimizationPatterns.set('async_operations', {
68
+ name: 'Async Operations',
69
+ description: 'Optimize async/await patterns and Promise usage',
70
+ detector: this.detectAsyncIssues.bind(this),
71
+ optimizer: this.suggestAsyncOptimizations.bind(this),
72
+ impact: 'high',
73
+ category: 'async',
74
+ });
75
+
76
+ // Caching opportunities
77
+ this.optimizationPatterns.set('caching', {
78
+ name: 'Caching Opportunities',
79
+ description: 'Identify opportunities for memoization and caching',
80
+ detector: this.detectCachingOpportunities.bind(this),
81
+ optimizer: this.suggestCachingStrategies.bind(this),
82
+ impact: 'medium',
83
+ category: 'caching',
84
+ });
85
+
86
+ // Database query optimizations
87
+ this.optimizationPatterns.set('database_queries', {
88
+ name: 'Database Query Optimization',
89
+ description: 'Optimize database queries and reduce N+1 problems',
90
+ detector: this.detectDatabaseIssues.bind(this),
91
+ optimizer: this.suggestDatabaseOptimizations.bind(this),
92
+ impact: 'high',
93
+ category: 'database',
94
+ });
95
+
96
+ // Bundle size optimizations
97
+ this.optimizationPatterns.set('bundle_size', {
98
+ name: 'Bundle Size',
99
+ description: 'Reduce JavaScript bundle size',
100
+ detector: this.detectBundleSizeIssues.bind(this),
101
+ optimizer: this.suggestBundleOptimizations.bind(this),
102
+ impact: 'medium',
103
+ category: 'bundle',
104
+ });
105
+
106
+ // React-specific optimizations
107
+ this.optimizationPatterns.set('react_performance', {
108
+ name: 'React Performance',
109
+ description: 'Optimize React component rendering',
110
+ detector: this.detectReactIssues.bind(this),
111
+ optimizer: this.suggestReactOptimizations.bind(this),
112
+ impact: 'medium',
113
+ category: 'framework',
114
+ });
115
+
116
+ // String operation optimizations
117
+ this.optimizationPatterns.set('string_operations', {
118
+ name: 'String Operations',
119
+ description: 'Optimize string concatenation and manipulation',
120
+ detector: this.detectStringIssues.bind(this),
121
+ optimizer: this.suggestStringOptimizations.bind(this),
122
+ impact: 'low',
123
+ category: 'algorithm',
124
+ });
125
+
126
+ // Object operation optimizations
127
+ this.optimizationPatterns.set('object_operations', {
128
+ name: 'Object Operations',
129
+ description: 'Optimize object creation and manipulation',
130
+ detector: this.detectObjectIssues.bind(this),
131
+ optimizer: this.suggestObjectOptimizations.bind(this),
132
+ impact: 'medium',
133
+ category: 'memory',
134
+ });
135
+ }
136
+
137
+ async analyzePerformance(filePath, options = {}) {
138
+ const startTime = performance.now();
139
+ const analysis = {
140
+ filePath,
141
+ timestamp: new Date().toISOString(),
142
+ issues: [],
143
+ suggestions: [],
144
+ metrics: {},
145
+ };
146
+
147
+ try {
148
+ const content = await fs.readFile(filePath, 'utf-8');
149
+
150
+ // Parse the code
151
+ const ast = parser.parse(content, {
152
+ sourceType: 'module',
153
+ plugins: ['jsx', 'typescript', 'decorators-legacy'],
154
+ errorRecovery: true,
155
+ });
156
+
157
+ // Run static analysis
158
+ await this.performStaticAnalysis(ast, analysis, content);
159
+
160
+ // Run pattern detection
161
+ const patterns = options.patterns || Array.from(this.optimizationPatterns.keys());
162
+
163
+ for (const patternName of patterns) {
164
+ const pattern = this.optimizationPatterns.get(patternName);
165
+ if (!pattern) continue;
166
+
167
+ try {
168
+ const issues = await pattern.detector(ast, content, filePath);
169
+
170
+ if (issues && issues.length > 0) {
171
+ for (const issue of issues) {
172
+ const suggestion = await pattern.optimizer(issue, ast, content);
173
+
174
+ analysis.issues.push({
175
+ pattern: patternName,
176
+ category: pattern.category,
177
+ impact: pattern.impact,
178
+ ...issue,
179
+ });
180
+
181
+ if (suggestion) {
182
+ analysis.suggestions.push({
183
+ pattern: patternName,
184
+ issueId: issue.id || `${patternName}-${analysis.issues.length}`,
185
+ ...suggestion,
186
+ });
187
+ }
188
+ }
189
+ }
190
+ } catch (error) {
191
+ console.warn(`Pattern detection failed for ${patternName}:`, error);
192
+ }
193
+ }
194
+
195
+ // Calculate performance score
196
+ analysis.metrics.performanceScore = this.calculatePerformanceScore(analysis);
197
+ analysis.metrics.analysisTime = performance.now() - startTime;
198
+
199
+ // Run runtime profiling if enabled and applicable
200
+ if (this.options.enableProfiling && this.isExecutable(filePath)) {
201
+ const runtimeMetrics = await this.profileRuntime(filePath);
202
+ analysis.metrics.runtime = runtimeMetrics;
203
+ }
204
+
205
+ this.emit('analyzed', analysis);
206
+ return analysis;
207
+
208
+ } catch (error) {
209
+ analysis.error = error.message;
210
+ this.emit('error', { phase: 'analysis', error, filePath });
211
+ return analysis;
212
+ }
213
+ }
214
+
215
+ async performStaticAnalysis(ast, analysis, content) {
216
+ const metrics = {
217
+ complexity: 0,
218
+ functionCount: 0,
219
+ loopDepth: 0,
220
+ asyncOperations: 0,
221
+ stringOperations: 0,
222
+ objectOperations: 0,
223
+ arrayOperations: 0,
224
+ domOperations: 0,
225
+ fileSize: content.length,
226
+ lineCount: content.split('\n').length,
227
+ };
228
+
229
+ let currentLoopDepth = 0;
230
+ let maxLoopDepth = 0;
231
+
232
+ traverse(ast, {
233
+ FunctionDeclaration(path) {
234
+ metrics.functionCount++;
235
+ metrics.complexity += calculateCyclomaticComplexity(path.node);
236
+ },
237
+ FunctionExpression(path) {
238
+ metrics.functionCount++;
239
+ metrics.complexity += calculateCyclomaticComplexity(path.node);
240
+ },
241
+ ArrowFunctionExpression(path) {
242
+ metrics.functionCount++;
243
+ metrics.complexity += calculateCyclomaticComplexity(path.node);
244
+ },
245
+ 'ForStatement|WhileStatement|DoWhileStatement|ForInStatement|ForOfStatement': {
246
+ enter() {
247
+ currentLoopDepth++;
248
+ maxLoopDepth = Math.max(maxLoopDepth, currentLoopDepth);
249
+ metrics.loopDepth = maxLoopDepth;
250
+ },
251
+ exit() {
252
+ currentLoopDepth--;
253
+ },
254
+ },
255
+ AwaitExpression() {
256
+ metrics.asyncOperations++;
257
+ },
258
+ BinaryExpression(path) {
259
+ if (path.node.operator === '+' &&
260
+ (t.isStringLiteral(path.node.left) || t.isStringLiteral(path.node.right))) {
261
+ metrics.stringOperations++;
262
+ }
263
+ },
264
+ TemplateLiteral() {
265
+ metrics.stringOperations++;
266
+ },
267
+ ObjectExpression() {
268
+ metrics.objectOperations++;
269
+ },
270
+ ArrayExpression() {
271
+ metrics.arrayOperations++;
272
+ },
273
+ CallExpression(path) {
274
+ const callee = path.node.callee;
275
+
276
+ // Check for DOM operations
277
+ if (t.isMemberExpression(callee)) {
278
+ const object = callee.object;
279
+ const property = callee.property;
280
+
281
+ if (t.isIdentifier(object, { name: 'document' }) ||
282
+ (t.isIdentifier(property) && ['querySelector', 'getElementById', 'getElementsBy'].some(m => property.name.startsWith(m)))) {
283
+ metrics.domOperations++;
284
+ }
285
+ }
286
+ },
287
+ });
288
+
289
+ analysis.metrics.static = metrics;
290
+
291
+ function calculateCyclomaticComplexity(node) {
292
+ let complexity = 1;
293
+
294
+ traverse(node, {
295
+ 'IfStatement|ConditionalExpression|SwitchCase|WhileStatement|DoWhileStatement|ForStatement': {
296
+ enter() {
297
+ complexity++;
298
+ },
299
+ },
300
+ LogicalExpression(path) {
301
+ if (path.node.operator === '&&' || path.node.operator === '||') {
302
+ complexity++;
303
+ }
304
+ },
305
+ }, null, { noScope: true });
306
+
307
+ return complexity;
308
+ }
309
+ }
310
+
311
+ async detectHighComplexityAlgorithms(ast, content) {
312
+ const issues = [];
313
+ const self = this;
314
+
315
+ traverse(ast, {
316
+ FunctionDeclaration: checkFunction,
317
+ FunctionExpression: checkFunction,
318
+ ArrowFunctionExpression: checkFunction,
319
+ });
320
+
321
+ function checkFunction(path) {
322
+ const complexity = calculateTimeComplexity(path.node);
323
+
324
+ if (complexity.score > self.options.complexityThreshold) {
325
+ issues.push({
326
+ type: 'high_complexity',
327
+ location: {
328
+ start: path.node.loc?.start,
329
+ end: path.node.loc?.end,
330
+ },
331
+ functionName: path.node.id?.name || '<anonymous>',
332
+ complexity: complexity,
333
+ description: `Function has high time complexity: ${complexity.notation}`,
334
+ severity: complexity.score > 15 ? 'critical' : 'warning',
335
+ });
336
+ }
337
+ }
338
+
339
+ function calculateTimeComplexity(node) {
340
+ let loopDepth = 0;
341
+ let maxLoopDepth = 0;
342
+ let recursiveCall = false;
343
+ let exponentialPatterns = 0;
344
+
345
+ traverse(node, {
346
+ 'ForStatement|WhileStatement|DoWhileStatement|ForInStatement|ForOfStatement': {
347
+ enter(path) {
348
+ loopDepth++;
349
+ maxLoopDepth = Math.max(maxLoopDepth, loopDepth);
350
+
351
+ // Check for exponential patterns
352
+ if (loopDepth > 1 && isNestedLoopOverSameData(path)) {
353
+ exponentialPatterns++;
354
+ }
355
+ },
356
+ exit() {
357
+ loopDepth--;
358
+ },
359
+ },
360
+ CallExpression(path) {
361
+ // Check for recursive calls
362
+ if (t.isIdentifier(path.node.callee) &&
363
+ path.node.callee.name === node.id?.name) {
364
+ recursiveCall = true;
365
+ }
366
+
367
+ // Check for expensive operations
368
+ if (t.isMemberExpression(path.node.callee)) {
369
+ const property = path.node.callee.property;
370
+ if (t.isIdentifier(property) &&
371
+ ['sort', 'reverse', 'includes', 'indexOf'].includes(property.name)) {
372
+ // These can be expensive in loops
373
+ if (loopDepth > 0) exponentialPatterns++;
374
+ }
375
+ }
376
+ },
377
+ }, null, { noScope: true });
378
+
379
+ // Calculate complexity score and notation
380
+ let score = maxLoopDepth * 5;
381
+ let notation = 'O(1)';
382
+
383
+ if (recursiveCall) {
384
+ score += 10;
385
+ notation = exponentialPatterns > 0 ? 'O(2^n)' : 'O(n)';
386
+ } else if (maxLoopDepth === 1) {
387
+ notation = 'O(n)';
388
+ } else if (maxLoopDepth === 2) {
389
+ notation = exponentialPatterns > 0 ? 'O(n³)' : 'O(n²)';
390
+ } else if (maxLoopDepth >= 3) {
391
+ notation = `O(n^${maxLoopDepth})`;
392
+ }
393
+
394
+ if (exponentialPatterns > 0) {
395
+ score += exponentialPatterns * 5;
396
+ }
397
+
398
+ return { score, notation, loopDepth: maxLoopDepth, hasRecursion: recursiveCall };
399
+ }
400
+
401
+ function isNestedLoopOverSameData(path) {
402
+ // Simplified check - would need more sophisticated analysis
403
+ return false;
404
+ }
405
+
406
+ return issues;
407
+ }
408
+
409
+ async suggestAlgorithmOptimizations(issue, ast, content) {
410
+ const suggestions = [];
411
+
412
+ if (issue.complexity.loopDepth >= 2) {
413
+ suggestions.push({
414
+ type: 'algorithm_optimization',
415
+ description: 'Consider using a more efficient algorithm',
416
+ recommendations: [
417
+ 'Use hash maps/Set for lookups instead of nested loops',
418
+ 'Consider sorting data first if searching frequently',
419
+ 'Use dynamic programming for overlapping subproblems',
420
+ 'Consider using binary search for sorted data',
421
+ ],
422
+ example: this.generateOptimizationExample(issue.complexity),
423
+ });
424
+ }
425
+
426
+ if (issue.complexity.hasRecursion) {
427
+ suggestions.push({
428
+ type: 'recursion_optimization',
429
+ description: 'Optimize recursive algorithm',
430
+ recommendations: [
431
+ 'Add memoization to cache results',
432
+ 'Convert to iterative approach if possible',
433
+ 'Implement tail recursion optimization',
434
+ 'Add base case optimization',
435
+ ],
436
+ });
437
+ }
438
+
439
+ return {
440
+ optimizations: suggestions,
441
+ estimatedImprovement: this.estimatePerformanceImprovement(issue),
442
+ priority: issue.severity === 'critical' ? 'high' : 'medium',
443
+ };
444
+ }
445
+
446
+ async detectIneffientLoops(ast, content) {
447
+ const issues = [];
448
+
449
+ traverse(ast, {
450
+ 'ForStatement|WhileStatement|DoWhileStatement|ForInStatement|ForOfStatement'(path) {
451
+ // Check for array operations in loops
452
+ const loopIssues = [];
453
+
454
+ path.traverse({
455
+ CallExpression(innerPath) {
456
+ if (t.isMemberExpression(innerPath.node.callee)) {
457
+ const property = innerPath.node.callee.property;
458
+
459
+ // Check for inefficient array methods in loops
460
+ if (t.isIdentifier(property)) {
461
+ if (['push', 'unshift'].includes(property.name)) {
462
+ loopIssues.push({
463
+ type: 'array_growth_in_loop',
464
+ method: property.name,
465
+ description: 'Growing array in loop can cause performance issues',
466
+ });
467
+ }
468
+
469
+ if (['concat', 'slice'].includes(property.name)) {
470
+ loopIssues.push({
471
+ type: 'array_copy_in_loop',
472
+ method: property.name,
473
+ description: 'Creating array copies in loop is inefficient',
474
+ });
475
+ }
476
+
477
+ if (['find', 'filter', 'map', 'reduce'].includes(property.name)) {
478
+ // Check if this is nested iteration
479
+ const parentLoop = innerPath.findParent(p =>
480
+ p.isForStatement() || p.isWhileStatement() || p.isDoWhileStatement(),
481
+ );
482
+
483
+ if (parentLoop && parentLoop !== path) {
484
+ loopIssues.push({
485
+ type: 'nested_iteration',
486
+ method: property.name,
487
+ description: 'Nested iteration can lead to O(n²) complexity',
488
+ });
489
+ }
490
+ }
491
+ }
492
+ }
493
+ },
494
+ BinaryExpression(innerPath) {
495
+ // Check for string concatenation in loops
496
+ if (innerPath.node.operator === '+' &&
497
+ innerPath.isAncestor(path) &&
498
+ (t.isStringLiteral(innerPath.node.left) || t.isStringLiteral(innerPath.node.right))) {
499
+ loopIssues.push({
500
+ type: 'string_concatenation_in_loop',
501
+ description: 'String concatenation in loop is inefficient',
502
+ });
503
+ }
504
+ },
505
+ });
506
+
507
+ if (loopIssues.length > 0) {
508
+ issues.push({
509
+ type: 'inefficient_loop',
510
+ location: {
511
+ start: path.node.loc?.start,
512
+ end: path.node.loc?.end,
513
+ },
514
+ problems: loopIssues,
515
+ description: 'Loop contains inefficient operations',
516
+ });
517
+ }
518
+ },
519
+ });
520
+
521
+ return issues;
522
+ }
523
+
524
+ async suggestLoopOptimizations(issue) {
525
+ const optimizations = [];
526
+
527
+ for (const problem of issue.problems) {
528
+ switch (problem.type) {
529
+ case 'array_growth_in_loop':
530
+ optimizations.push({
531
+ type: 'preallocate_array',
532
+ description: 'Preallocate array with known size',
533
+ code: 'const result = new Array(knownSize);',
534
+ improvement: 'Avoids dynamic array resizing',
535
+ });
536
+ break;
537
+
538
+ case 'array_copy_in_loop':
539
+ optimizations.push({
540
+ type: 'avoid_copies',
541
+ description: 'Work with original array or use single copy',
542
+ improvement: 'Reduces memory allocation and copying',
543
+ });
544
+ break;
545
+
546
+ case 'nested_iteration':
547
+ optimizations.push({
548
+ type: 'use_lookup',
549
+ description: 'Use Set or Map for O(1) lookups',
550
+ code: 'const lookup = new Set(array2);\nfor (const item of array1) {\n if (lookup.has(item)) { ... }\n}',
551
+ improvement: 'Reduces complexity from O(n²) to O(n)',
552
+ });
553
+ break;
554
+
555
+ case 'string_concatenation_in_loop':
556
+ optimizations.push({
557
+ type: 'use_array_join',
558
+ description: 'Use array push and join',
559
+ code: 'const parts = [];\nfor (...) { parts.push(str); }\nconst result = parts.join(\'\');',
560
+ improvement: 'Avoids creating intermediate strings',
561
+ });
562
+ break;
563
+ }
564
+ }
565
+
566
+ return {
567
+ optimizations,
568
+ priority: issue.problems.some(p => p.type === 'nested_iteration') ? 'high' : 'medium',
569
+ };
570
+ }
571
+
572
+ async detectMemoryIssues(ast, content) {
573
+ const issues = [];
574
+
575
+ traverse(ast, {
576
+ VariableDeclarator(path) {
577
+ // Check for potential memory leaks
578
+ if (t.isIdentifier(path.node.id)) {
579
+ const binding = path.scope.getBinding(path.node.id.name);
580
+
581
+ // Check if variable holds large data
582
+ if (t.isArrayExpression(path.node.init) &&
583
+ path.node.init.elements.length > 1000) {
584
+ issues.push({
585
+ type: 'large_array',
586
+ variableName: path.node.id.name,
587
+ size: path.node.init.elements.length,
588
+ location: path.node.loc,
589
+ description: 'Large array allocation',
590
+ });
591
+ }
592
+
593
+ // Check for potential closures holding references
594
+ if (binding && !binding.referenced) {
595
+ path.traverse({
596
+ FunctionExpression(innerPath) {
597
+ if (innerPath.node.id?.name || innerPath.parent.type === 'VariableDeclarator') {
598
+ issues.push({
599
+ type: 'potential_closure_leak',
600
+ variableName: path.node.id.name,
601
+ location: innerPath.node.loc,
602
+ description: 'Closure may retain reference to large object',
603
+ });
604
+ }
605
+ },
606
+ });
607
+ }
608
+ }
609
+ },
610
+ CallExpression(path) {
611
+ // Check for common memory-intensive operations
612
+ if (t.isMemberExpression(path.node.callee)) {
613
+ const object = path.node.callee.object;
614
+ const property = path.node.callee.property;
615
+
616
+ // Check for potential memory issues
617
+ if (t.isIdentifier(property)) {
618
+ if (property.name === 'slice' && path.node.arguments.length === 0) {
619
+ issues.push({
620
+ type: 'unnecessary_copy',
621
+ method: 'slice',
622
+ location: path.node.loc,
623
+ description: 'Creating unnecessary array copy',
624
+ });
625
+ }
626
+
627
+ if (property.name === 'concat' && isInLoop(path)) {
628
+ issues.push({
629
+ type: 'concat_in_loop',
630
+ location: path.node.loc,
631
+ description: 'Concatenating arrays in loop creates many intermediate arrays',
632
+ });
633
+ }
634
+ }
635
+ }
636
+ },
637
+ });
638
+
639
+ function isInLoop(path) {
640
+ return path.findParent(p =>
641
+ p.isForStatement() || p.isWhileStatement() || p.isDoWhileStatement(),
642
+ );
643
+ }
644
+
645
+ return issues;
646
+ }
647
+
648
+ async suggestMemoryOptimizations(issue) {
649
+ const optimizations = [];
650
+
651
+ switch (issue.type) {
652
+ case 'large_array':
653
+ optimizations.push({
654
+ type: 'lazy_loading',
655
+ description: 'Consider lazy loading or pagination',
656
+ recommendation: 'Load data in chunks as needed',
657
+ });
658
+ optimizations.push({
659
+ type: 'typed_array',
660
+ description: 'Use TypedArray for numeric data',
661
+ code: `const data = new Float32Array(${issue.size});`,
662
+ improvement: 'More memory efficient for numbers',
663
+ });
664
+ break;
665
+
666
+ case 'potential_closure_leak':
667
+ optimizations.push({
668
+ type: 'cleanup_references',
669
+ description: 'Clear references when no longer needed',
670
+ code: `${issue.variableName} = null; // Clear reference`,
671
+ improvement: 'Allows garbage collection',
672
+ });
673
+ break;
674
+
675
+ case 'unnecessary_copy':
676
+ optimizations.push({
677
+ type: 'avoid_copy',
678
+ description: 'Use original array if not modifying',
679
+ improvement: 'Saves memory and copying time',
680
+ });
681
+ break;
682
+
683
+ case 'concat_in_loop':
684
+ optimizations.push({
685
+ type: 'use_push_spread',
686
+ description: 'Use push with spread operator',
687
+ code: 'result.push(...newItems);',
688
+ improvement: 'Modifies array in place',
689
+ });
690
+ break;
691
+ }
692
+
693
+ return {
694
+ optimizations,
695
+ estimatedMemorySaving: this.estimateMemorySaving(issue),
696
+ };
697
+ }
698
+
699
+ async detectAsyncIssues(ast, content) {
700
+ const issues = [];
701
+
702
+ traverse(ast, {
703
+ AwaitExpression(path) {
704
+ // Check for sequential awaits that could be parallelized
705
+ const parent = path.getFunctionParent();
706
+ if (!parent) return;
707
+
708
+ const awaits = [];
709
+ parent.traverse({
710
+ AwaitExpression(innerPath) {
711
+ awaits.push(innerPath);
712
+ },
713
+ });
714
+
715
+ // Check for sequential independent awaits
716
+ if (awaits.length > 1) {
717
+ const sequentialAwaits = this.findSequentialAwaits(awaits);
718
+ if (sequentialAwaits.length > 1) {
719
+ issues.push({
720
+ type: 'sequential_awaits',
721
+ count: sequentialAwaits.length,
722
+ location: parent.node.loc,
723
+ description: 'Sequential awaits could be parallelized',
724
+ });
725
+ }
726
+ }
727
+ },
728
+ CallExpression(path) {
729
+ // Check for Promise anti-patterns
730
+ if (t.isMemberExpression(path.node.callee)) {
731
+ const property = path.node.callee.property;
732
+
733
+ if (t.isIdentifier(property, { name: 'forEach' })) {
734
+ // Check if forEach contains async operations
735
+ const callback = path.node.arguments[0];
736
+ if (t.isArrowFunctionExpression(callback) && callback.async) {
737
+ issues.push({
738
+ type: 'async_foreach',
739
+ location: path.node.loc,
740
+ description: 'forEach does not wait for async operations',
741
+ });
742
+ }
743
+ }
744
+ }
745
+
746
+ // Check for Promise constructor anti-pattern
747
+ if (t.isNewExpression(path.node) &&
748
+ t.isIdentifier(path.node.callee, { name: 'Promise' })) {
749
+ const executor = path.node.arguments[0];
750
+ if (t.isFunctionExpression(executor) || t.isArrowFunctionExpression(executor)) {
751
+ let hasAsyncOperation = false;
752
+
753
+ path.traverse({
754
+ AwaitExpression() {
755
+ hasAsyncOperation = true;
756
+ },
757
+ });
758
+
759
+ if (hasAsyncOperation) {
760
+ issues.push({
761
+ type: 'promise_constructor_antipattern',
762
+ location: path.node.loc,
763
+ description: 'Avoid using async/await in Promise constructor',
764
+ });
765
+ }
766
+ }
767
+ }
768
+ },
769
+ });
770
+
771
+ return issues;
772
+ }
773
+
774
+ findSequentialAwaits(awaits) {
775
+ // Simplified check - would need data flow analysis for accuracy
776
+ const sequential = [];
777
+
778
+ for (let i = 0; i < awaits.length - 1; i++) {
779
+ const current = awaits[i];
780
+ const next = awaits[i + 1];
781
+
782
+ // Check if they're in the same block and sequential
783
+ if (current.parent === next.parent) {
784
+ sequential.push(current);
785
+ if (i === awaits.length - 2) {
786
+ sequential.push(next);
787
+ }
788
+ }
789
+ }
790
+
791
+ return sequential;
792
+ }
793
+
794
+ async suggestAsyncOptimizations(issue) {
795
+ const optimizations = [];
796
+
797
+ switch (issue.type) {
798
+ case 'sequential_awaits':
799
+ optimizations.push({
800
+ type: 'parallel_execution',
801
+ description: 'Use Promise.all for parallel execution',
802
+ code: 'const [result1, result2] = await Promise.all([\n asyncOperation1(),\n asyncOperation2()\n]);',
803
+ improvement: `Execute ${issue.count} operations in parallel`,
804
+ });
805
+ break;
806
+
807
+ case 'async_foreach':
808
+ optimizations.push({
809
+ type: 'use_for_of',
810
+ description: 'Use for...of loop for sequential async operations',
811
+ code: 'for (const item of items) {\n await processItem(item);\n}',
812
+ });
813
+ optimizations.push({
814
+ type: 'use_promise_all',
815
+ description: 'Use Promise.all for parallel async operations',
816
+ code: 'await Promise.all(items.map(item => processItem(item)));',
817
+ });
818
+ break;
819
+
820
+ case 'promise_constructor_antipattern':
821
+ optimizations.push({
822
+ type: 'use_async_function',
823
+ description: 'Use async function instead of Promise constructor',
824
+ code: 'async function operation() {\n const result = await asyncCall();\n return result;\n}',
825
+ });
826
+ break;
827
+ }
828
+
829
+ return {
830
+ optimizations,
831
+ priority: issue.type === 'sequential_awaits' ? 'high' : 'medium',
832
+ };
833
+ }
834
+
835
+ async detectCachingOpportunities(ast, content) {
836
+ const issues = [];
837
+ const functionCalls = new Map();
838
+
839
+ traverse(ast, {
840
+ CallExpression(path) {
841
+ // Track repeated function calls
842
+ const callSignature = this.getFunctionCallSignature(path.node);
843
+ if (callSignature) {
844
+ if (!functionCalls.has(callSignature)) {
845
+ functionCalls.set(callSignature, []);
846
+ }
847
+ functionCalls.get(callSignature).push(path);
848
+ }
849
+
850
+ // Check for expensive operations without caching
851
+ if (t.isMemberExpression(path.node.callee)) {
852
+ const property = path.node.callee.property;
853
+
854
+ if (t.isIdentifier(property)) {
855
+ // Check for repeated expensive operations
856
+ if (['filter', 'map', 'reduce', 'sort'].includes(property.name)) {
857
+ const parent = path.getFunctionParent();
858
+ if (parent) {
859
+ // Count similar operations in same function
860
+ let count = 0;
861
+ parent.traverse({
862
+ CallExpression(innerPath) {
863
+ if (this.isSimilarCall(path.node, innerPath.node)) {
864
+ count++;
865
+ }
866
+ },
867
+ });
868
+
869
+ if (count > 1) {
870
+ issues.push({
871
+ type: 'repeated_computation',
872
+ operation: property.name,
873
+ count,
874
+ location: path.node.loc,
875
+ description: `${property.name} called ${count} times with similar data`,
876
+ });
877
+ }
878
+ }
879
+ }
880
+ }
881
+ }
882
+ },
883
+ FunctionDeclaration(path) {
884
+ // Check for pure functions that could benefit from memoization
885
+ if (this.isPureFunction(path)) {
886
+ const complexity = this.calculateComplexity(path.node);
887
+ if (complexity > 5) {
888
+ issues.push({
889
+ type: 'memoization_candidate',
890
+ functionName: path.node.id?.name,
891
+ complexity,
892
+ location: path.node.loc,
893
+ description: 'Pure function with high complexity could benefit from memoization',
894
+ });
895
+ }
896
+ }
897
+ },
898
+ });
899
+
900
+ // Check for repeated function calls
901
+ for (const [signature, calls] of functionCalls) {
902
+ if (calls.length > 2) {
903
+ issues.push({
904
+ type: 'repeated_calls',
905
+ signature,
906
+ count: calls.length,
907
+ location: calls[0].node.loc,
908
+ description: `Function called ${calls.length} times with same signature`,
909
+ });
910
+ }
911
+ }
912
+
913
+ return issues;
914
+ }
915
+
916
+ getFunctionCallSignature(node) {
917
+ if (t.isIdentifier(node.callee)) {
918
+ return node.callee.name;
919
+ } else if (t.isMemberExpression(node.callee)) {
920
+ const object = node.callee.object;
921
+ const property = node.callee.property;
922
+
923
+ if (t.isIdentifier(object) && t.isIdentifier(property)) {
924
+ return `${object.name}.${property.name}`;
925
+ }
926
+ }
927
+ return null;
928
+ }
929
+
930
+ isSimilarCall(call1, call2) {
931
+ // Simplified comparison
932
+ return this.getFunctionCallSignature(call1) === this.getFunctionCallSignature(call2);
933
+ }
934
+
935
+ isPureFunction(path) {
936
+ const isPure = true;
937
+ let hasSideEffects = false;
938
+
939
+ path.traverse({
940
+ AssignmentExpression(innerPath) {
941
+ // Check if assignment is to external variable
942
+ if (t.isIdentifier(innerPath.node.left)) {
943
+ const binding = innerPath.scope.getBinding(innerPath.node.left.name);
944
+ if (!binding || binding.scope !== path.scope) {
945
+ hasSideEffects = true;
946
+ }
947
+ }
948
+ },
949
+ CallExpression(innerPath) {
950
+ // Check for console.log, DOM manipulation, etc.
951
+ const callee = innerPath.node.callee;
952
+ if (t.isMemberExpression(callee)) {
953
+ const object = callee.object;
954
+ if (t.isIdentifier(object) &&
955
+ ['console', 'document', 'window'].includes(object.name)) {
956
+ hasSideEffects = true;
957
+ }
958
+ }
959
+ },
960
+ UpdateExpression() {
961
+ hasSideEffects = true;
962
+ },
963
+ });
964
+
965
+ return !hasSideEffects;
966
+ }
967
+
968
+ calculateComplexity(node) {
969
+ let complexity = 1;
970
+
971
+ traverse(node, {
972
+ 'IfStatement|ConditionalExpression|SwitchCase': {
973
+ enter() {
974
+ complexity++;
975
+ },
976
+ },
977
+ 'ForStatement|WhileStatement|DoWhileStatement': {
978
+ enter() {
979
+ complexity += 2;
980
+ },
981
+ },
982
+ CallExpression() {
983
+ complexity++;
984
+ },
985
+ }, null, { noScope: true });
986
+
987
+ return complexity;
988
+ }
989
+
990
+ async suggestCachingStrategies(issue) {
991
+ const strategies = [];
992
+
993
+ switch (issue.type) {
994
+ case 'repeated_computation':
995
+ strategies.push({
996
+ type: 'cache_result',
997
+ description: 'Cache computation result',
998
+ code: `const cached${issue.operation} = data.${issue.operation}(...);\n// Use cached result instead of recomputing`,
999
+ improvement: `Avoid ${issue.count - 1} redundant computations`,
1000
+ });
1001
+ break;
1002
+
1003
+ case 'memoization_candidate':
1004
+ strategies.push({
1005
+ type: 'add_memoization',
1006
+ description: 'Add memoization to function',
1007
+ code: `const memoized${issue.functionName} = memoize(${issue.functionName});`,
1008
+ improvement: 'Cache results for repeated calls with same arguments',
1009
+ });
1010
+ break;
1011
+
1012
+ case 'repeated_calls':
1013
+ strategies.push({
1014
+ type: 'cache_calls',
1015
+ description: 'Cache function call results',
1016
+ code: 'const cache = new Map();\nfunction getCached(key) {\n if (!cache.has(key)) {\n cache.set(key, expensiveOperation(key));\n }\n return cache.get(key);\n}',
1017
+ improvement: `Reduce ${issue.count} calls to 1 + cache lookups`,
1018
+ });
1019
+ break;
1020
+ }
1021
+
1022
+ return {
1023
+ strategies,
1024
+ estimatedImprovement: this.estimateCachingImprovement(issue),
1025
+ };
1026
+ }
1027
+
1028
+ async detectDatabaseIssues(ast, content) {
1029
+ const issues = [];
1030
+
1031
+ traverse(ast, {
1032
+ CallExpression(path) {
1033
+ // Look for database query patterns
1034
+ const callee = path.node.callee;
1035
+
1036
+ // Check for ORM/database methods
1037
+ if (t.isMemberExpression(callee)) {
1038
+ const property = callee.property;
1039
+
1040
+ if (t.isIdentifier(property)) {
1041
+ // Check for N+1 query patterns
1042
+ if (['find', 'findOne', 'findById', 'query', 'get'].includes(property.name)) {
1043
+ const inLoop = path.findParent(p =>
1044
+ p.isForStatement() || p.isWhileStatement() ||
1045
+ p.isDoWhileStatement() ||
1046
+ (p.isCallExpression() && t.isMemberExpression(p.node.callee) &&
1047
+ ['forEach', 'map', 'filter'].includes(p.node.callee.property?.name)),
1048
+ );
1049
+
1050
+ if (inLoop) {
1051
+ issues.push({
1052
+ type: 'n_plus_one',
1053
+ method: property.name,
1054
+ location: path.node.loc,
1055
+ description: 'Database query inside loop (N+1 problem)',
1056
+ });
1057
+ }
1058
+ }
1059
+
1060
+ // Check for missing indexes
1061
+ if (property.name === 'find' || property.name === 'findOne') {
1062
+ const args = path.node.arguments;
1063
+ if (args.length > 0 && t.isObjectExpression(args[0])) {
1064
+ const fields = args[0].properties.map(p =>
1065
+ t.isIdentifier(p.key) ? p.key.name : null,
1066
+ ).filter(Boolean);
1067
+
1068
+ if (fields.length > 0) {
1069
+ issues.push({
1070
+ type: 'potential_missing_index',
1071
+ fields,
1072
+ location: path.node.loc,
1073
+ description: `Query on fields: ${fields.join(', ')}`,
1074
+ });
1075
+ }
1076
+ }
1077
+ }
1078
+ }
1079
+ }
1080
+
1081
+ // Check for inefficient query patterns
1082
+ if (t.isIdentifier(callee) || t.isMemberExpression(callee)) {
1083
+ // Look for multiple sequential queries
1084
+ const parent = path.getFunctionParent();
1085
+ if (parent) {
1086
+ const queries = [];
1087
+ parent.traverse({
1088
+ CallExpression(innerPath) {
1089
+ if (this.isDatabaseQuery(innerPath.node)) {
1090
+ queries.push(innerPath);
1091
+ }
1092
+ },
1093
+ });
1094
+
1095
+ if (queries.length > 3) {
1096
+ issues.push({
1097
+ type: 'multiple_queries',
1098
+ count: queries.length,
1099
+ location: parent.node.loc,
1100
+ description: `${queries.length} database queries in single function`,
1101
+ });
1102
+ }
1103
+ }
1104
+ }
1105
+ },
1106
+ });
1107
+
1108
+ return issues;
1109
+ }
1110
+
1111
+ isDatabaseQuery(node) {
1112
+ // Simplified check - would need to identify actual database libraries
1113
+ if (t.isMemberExpression(node.callee)) {
1114
+ const property = node.callee.property;
1115
+ if (t.isIdentifier(property)) {
1116
+ return ['find', 'findOne', 'findById', 'query', 'select', 'insert', 'update', 'delete']
1117
+ .includes(property.name);
1118
+ }
1119
+ }
1120
+ return false;
1121
+ }
1122
+
1123
+ async suggestDatabaseOptimizations(issue) {
1124
+ const optimizations = [];
1125
+
1126
+ switch (issue.type) {
1127
+ case 'n_plus_one':
1128
+ optimizations.push({
1129
+ type: 'use_join',
1130
+ description: 'Use JOIN or populate to fetch related data',
1131
+ code: 'const results = await Model.find().populate(\'relatedField\');',
1132
+ improvement: 'Reduce N+1 queries to single query',
1133
+ });
1134
+ optimizations.push({
1135
+ type: 'batch_loading',
1136
+ description: 'Load all data upfront',
1137
+ code: 'const ids = items.map(item => item.id);\nconst related = await RelatedModel.find({ id: { $in: ids } });',
1138
+ improvement: 'Single query instead of N queries',
1139
+ });
1140
+ break;
1141
+
1142
+ case 'potential_missing_index':
1143
+ optimizations.push({
1144
+ type: 'add_index',
1145
+ description: `Consider adding index on: ${issue.fields.join(', ')}`,
1146
+ code: `db.collection.createIndex({ ${issue.fields.map(f => `${f}: 1`).join(', ')} });`,
1147
+ improvement: 'Faster query execution',
1148
+ });
1149
+ break;
1150
+
1151
+ case 'multiple_queries':
1152
+ optimizations.push({
1153
+ type: 'aggregate_queries',
1154
+ description: 'Combine multiple queries using aggregation',
1155
+ improvement: `Reduce ${issue.count} queries to fewer operations`,
1156
+ });
1157
+ optimizations.push({
1158
+ type: 'use_transactions',
1159
+ description: 'Use database transactions for consistency',
1160
+ code: 'const session = await mongoose.startSession();\nawait session.withTransaction(async () => {\n // Multiple operations\n});',
1161
+ });
1162
+ break;
1163
+ }
1164
+
1165
+ return {
1166
+ optimizations,
1167
+ priority: issue.type === 'n_plus_one' ? 'critical' : 'high',
1168
+ };
1169
+ }
1170
+
1171
+ async detectBundleSizeIssues(ast, content) {
1172
+ const issues = [];
1173
+ const imports = new Map();
1174
+
1175
+ traverse(ast, {
1176
+ ImportDeclaration(path) {
1177
+ const source = path.node.source.value;
1178
+
1179
+ // Track imports
1180
+ if (!imports.has(source)) {
1181
+ imports.set(source, []);
1182
+ }
1183
+
1184
+ // Check for large library imports
1185
+ if (this.isLargeLibrary(source)) {
1186
+ const specifiers = path.node.specifiers;
1187
+
1188
+ if (specifiers.some(s => t.isImportNamespaceSpecifier(s))) {
1189
+ issues.push({
1190
+ type: 'namespace_import',
1191
+ library: source,
1192
+ location: path.node.loc,
1193
+ description: `Importing entire ${source} library`,
1194
+ });
1195
+ } else if (specifiers.some(s => t.isImportDefaultSpecifier(s))) {
1196
+ issues.push({
1197
+ type: 'default_import',
1198
+ library: source,
1199
+ location: path.node.loc,
1200
+ description: `Default import from ${source} may include unnecessary code`,
1201
+ });
1202
+ }
1203
+ }
1204
+
1205
+ // Check for duplicate imports
1206
+ imports.get(source).push(path.node);
1207
+ },
1208
+ CallExpression(path) {
1209
+ // Check for dynamic imports
1210
+ if (t.isImport(path.node.callee)) {
1211
+ issues.push({
1212
+ type: 'dynamic_import',
1213
+ location: path.node.loc,
1214
+ description: 'Dynamic import found - ensure it\'s necessary',
1215
+ });
1216
+ }
1217
+
1218
+ // Check for require() in browser code
1219
+ if (t.isIdentifier(path.node.callee, { name: 'require' })) {
1220
+ issues.push({
1221
+ type: 'commonjs_require',
1222
+ location: path.node.loc,
1223
+ description: 'CommonJS require may not tree-shake well',
1224
+ });
1225
+ }
1226
+ },
1227
+ });
1228
+
1229
+ // Check for duplicate imports
1230
+ for (const [source, importNodes] of imports) {
1231
+ if (importNodes.length > 1) {
1232
+ issues.push({
1233
+ type: 'duplicate_imports',
1234
+ source,
1235
+ count: importNodes.length,
1236
+ description: `${source} imported ${importNodes.length} times`,
1237
+ });
1238
+ }
1239
+ }
1240
+
1241
+ return issues;
1242
+ }
1243
+
1244
+ isLargeLibrary(source) {
1245
+ const largeLibraries = [
1246
+ 'lodash',
1247
+ 'moment',
1248
+ 'rxjs',
1249
+ 'd3',
1250
+ 'three',
1251
+ 'antd',
1252
+ 'material-ui',
1253
+ '@material-ui/core',
1254
+ ];
1255
+
1256
+ return largeLibraries.some(lib => source.includes(lib));
1257
+ }
1258
+
1259
+ async suggestBundleOptimizations(issue) {
1260
+ const optimizations = [];
1261
+
1262
+ switch (issue.type) {
1263
+ case 'namespace_import':
1264
+ optimizations.push({
1265
+ type: 'named_imports',
1266
+ description: 'Use named imports instead of namespace import',
1267
+ code: `import { specificFunction } from '${issue.library}';`,
1268
+ improvement: 'Enable tree-shaking to reduce bundle size',
1269
+ });
1270
+ break;
1271
+
1272
+ case 'default_import':
1273
+ if (issue.library.includes('lodash')) {
1274
+ optimizations.push({
1275
+ type: 'modular_import',
1276
+ description: 'Import specific lodash modules',
1277
+ code: 'import debounce from \'lodash/debounce\';',
1278
+ improvement: 'Import only what you need',
1279
+ });
1280
+ }
1281
+ break;
1282
+
1283
+ case 'duplicate_imports':
1284
+ optimizations.push({
1285
+ type: 'consolidate_imports',
1286
+ description: 'Combine duplicate imports',
1287
+ code: `import { func1, func2, func3 } from '${issue.source}';`,
1288
+ improvement: 'Cleaner code and potential optimization',
1289
+ });
1290
+ break;
1291
+
1292
+ case 'commonjs_require':
1293
+ optimizations.push({
1294
+ type: 'use_esm',
1295
+ description: 'Use ES modules for better tree-shaking',
1296
+ code: 'import module from \'module-name\';',
1297
+ improvement: 'Better optimization and tree-shaking',
1298
+ });
1299
+ break;
1300
+ }
1301
+
1302
+ return {
1303
+ optimizations,
1304
+ estimatedSizeReduction: this.estimateBundleSizeReduction(issue),
1305
+ };
1306
+ }
1307
+
1308
+ async detectReactIssues(ast, content) {
1309
+ const issues = [];
1310
+
1311
+ // Only run React checks if React is imported
1312
+ const hasReact = content.includes('react') || content.includes('React');
1313
+ if (!hasReact) return issues;
1314
+
1315
+ traverse(ast, {
1316
+ CallExpression(path) {
1317
+ // Check for setState in loops
1318
+ if (t.isMemberExpression(path.node.callee) &&
1319
+ t.isThisExpression(path.node.callee.object) &&
1320
+ t.isIdentifier(path.node.callee.property, { name: 'setState' })) {
1321
+
1322
+ const inLoop = path.findParent(p =>
1323
+ p.isForStatement() || p.isWhileStatement() || p.isDoWhileStatement(),
1324
+ );
1325
+
1326
+ if (inLoop) {
1327
+ issues.push({
1328
+ type: 'setState_in_loop',
1329
+ location: path.node.loc,
1330
+ description: 'Multiple setState calls in loop cause unnecessary re-renders',
1331
+ });
1332
+ }
1333
+ }
1334
+
1335
+ // Check for missing React.memo
1336
+ if (t.isIdentifier(path.node.callee) || t.isMemberExpression(path.node.callee)) {
1337
+ const funcParent = path.getFunctionParent();
1338
+ if (funcParent && this.isReactComponent(funcParent)) {
1339
+ const componentName = this.getComponentName(funcParent);
1340
+
1341
+ // Check if component is wrapped in React.memo
1342
+ const hasReactMemo = funcParent.parent?.callee?.property?.name === 'memo';
1343
+
1344
+ if (!hasReactMemo && this.shouldMemoize(funcParent)) {
1345
+ issues.push({
1346
+ type: 'missing_memo',
1347
+ componentName,
1348
+ location: funcParent.node.loc,
1349
+ description: 'Component could benefit from React.memo',
1350
+ });
1351
+ }
1352
+ }
1353
+ }
1354
+ },
1355
+ JSXElement(path) {
1356
+ // Check for inline function props
1357
+ const openingElement = path.node.openingElement;
1358
+
1359
+ for (const attr of openingElement.attributes) {
1360
+ if (t.isJSXAttribute(attr) && t.isJSXExpressionContainer(attr.value)) {
1361
+ const expression = attr.value.expression;
1362
+
1363
+ if (t.isArrowFunctionExpression(expression) || t.isFunctionExpression(expression)) {
1364
+ issues.push({
1365
+ type: 'inline_function_prop',
1366
+ propName: attr.name.name,
1367
+ location: attr.loc,
1368
+ description: 'Inline function prop causes unnecessary re-renders',
1369
+ });
1370
+ }
1371
+ }
1372
+ }
1373
+ },
1374
+ });
1375
+
1376
+ return issues;
1377
+ }
1378
+
1379
+ isReactComponent(path) {
1380
+ // Check if it's a React component
1381
+ const node = path.node;
1382
+
1383
+ // Function component
1384
+ if (t.isFunctionDeclaration(node) || t.isArrowFunctionExpression(node)) {
1385
+ // Check if returns JSX
1386
+ let returnsJSX = false;
1387
+
1388
+ path.traverse({
1389
+ ReturnStatement(returnPath) {
1390
+ if (t.isJSXElement(returnPath.node.argument) ||
1391
+ t.isJSXFragment(returnPath.node.argument)) {
1392
+ returnsJSX = true;
1393
+ }
1394
+ },
1395
+ });
1396
+
1397
+ return returnsJSX;
1398
+ }
1399
+
1400
+ return false;
1401
+ }
1402
+
1403
+ getComponentName(path) {
1404
+ if (t.isFunctionDeclaration(path.node)) {
1405
+ return path.node.id?.name;
1406
+ } else if (t.isVariableDeclarator(path.parent)) {
1407
+ return path.parent.id?.name;
1408
+ }
1409
+ return '<Component>';
1410
+ }
1411
+
1412
+ shouldMemoize(componentPath) {
1413
+ // Simple heuristic - component with props and no side effects
1414
+ let hasProps = false;
1415
+ let hasSideEffects = false;
1416
+
1417
+ // Check for props parameter
1418
+ const params = componentPath.node.params;
1419
+ if (params.length > 0) {
1420
+ hasProps = true;
1421
+ }
1422
+
1423
+ // Check for side effects
1424
+ componentPath.traverse({
1425
+ CallExpression(path) {
1426
+ const callee = path.node.callee;
1427
+ if (t.isMemberExpression(callee)) {
1428
+ const object = callee.object;
1429
+ if (t.isIdentifier(object) &&
1430
+ ['console', 'document', 'window'].includes(object.name)) {
1431
+ hasSideEffects = true;
1432
+ }
1433
+ }
1434
+ },
1435
+ });
1436
+
1437
+ return hasProps && !hasSideEffects;
1438
+ }
1439
+
1440
+ async suggestReactOptimizations(issue) {
1441
+ const optimizations = [];
1442
+
1443
+ switch (issue.type) {
1444
+ case 'setState_in_loop':
1445
+ optimizations.push({
1446
+ type: 'batch_state_updates',
1447
+ description: 'Batch state updates outside loop',
1448
+ code: 'const updates = [];\nfor (...) {\n updates.push(...);\n}\nthis.setState({ items: updates });',
1449
+ improvement: 'Single re-render instead of multiple',
1450
+ });
1451
+ break;
1452
+
1453
+ case 'missing_memo':
1454
+ optimizations.push({
1455
+ type: 'add_react_memo',
1456
+ description: 'Wrap component in React.memo',
1457
+ code: `const ${issue.componentName} = React.memo(function ${issue.componentName}(props) {\n // component code\n});`,
1458
+ improvement: 'Prevent unnecessary re-renders',
1459
+ });
1460
+ break;
1461
+
1462
+ case 'inline_function_prop':
1463
+ optimizations.push({
1464
+ type: 'use_callback',
1465
+ description: 'Use useCallback for function props',
1466
+ code: `const handle${issue.propName} = useCallback(() => {\n // handler code\n}, [dependencies]);`,
1467
+ improvement: 'Stable function reference',
1468
+ });
1469
+ break;
1470
+ }
1471
+
1472
+ return {
1473
+ optimizations,
1474
+ priority: 'medium',
1475
+ };
1476
+ }
1477
+
1478
+ async detectStringIssues(ast, content) {
1479
+ const issues = [];
1480
+
1481
+ traverse(ast, {
1482
+ BinaryExpression(path) {
1483
+ // Check for string concatenation in loops
1484
+ if (path.node.operator === '+') {
1485
+ const inLoop = path.findParent(p =>
1486
+ p.isForStatement() || p.isWhileStatement() || p.isDoWhileStatement(),
1487
+ );
1488
+
1489
+ if (inLoop && (t.isStringLiteral(path.node.left) || t.isStringLiteral(path.node.right))) {
1490
+ issues.push({
1491
+ type: 'string_concat_in_loop',
1492
+ location: path.node.loc,
1493
+ description: 'String concatenation in loop is inefficient',
1494
+ });
1495
+ }
1496
+ }
1497
+ },
1498
+ CallExpression(path) {
1499
+ if (t.isMemberExpression(path.node.callee)) {
1500
+ const property = path.node.callee.property;
1501
+
1502
+ if (t.isIdentifier(property)) {
1503
+ // Check for repeated string operations
1504
+ if (['split', 'replace', 'substring', 'substr'].includes(property.name)) {
1505
+ const parent = path.getFunctionParent();
1506
+ if (parent) {
1507
+ // Count similar operations
1508
+ let count = 0;
1509
+ parent.traverse({
1510
+ CallExpression(innerPath) {
1511
+ if (t.isMemberExpression(innerPath.node.callee) &&
1512
+ innerPath.node.callee.property?.name === property.name) {
1513
+ count++;
1514
+ }
1515
+ },
1516
+ });
1517
+
1518
+ if (count > 2) {
1519
+ issues.push({
1520
+ type: 'repeated_string_operation',
1521
+ operation: property.name,
1522
+ count,
1523
+ location: path.node.loc,
1524
+ description: `${property.name} called ${count} times`,
1525
+ });
1526
+ }
1527
+ }
1528
+ }
1529
+ }
1530
+ }
1531
+ },
1532
+ });
1533
+
1534
+ return issues;
1535
+ }
1536
+
1537
+ async suggestStringOptimizations(issue) {
1538
+ const optimizations = [];
1539
+
1540
+ switch (issue.type) {
1541
+ case 'string_concat_in_loop':
1542
+ optimizations.push({
1543
+ type: 'use_array_join',
1544
+ description: 'Use array and join for string building',
1545
+ code: 'const parts = [];\nfor (...) {\n parts.push(stringPart);\n}\nconst result = parts.join(\'\');',
1546
+ improvement: 'More efficient string concatenation',
1547
+ });
1548
+ break;
1549
+
1550
+ case 'repeated_string_operation':
1551
+ optimizations.push({
1552
+ type: 'cache_result',
1553
+ description: `Cache ${issue.operation} result`,
1554
+ code: `const processed = str.${issue.operation}(...);\n// Reuse processed instead of calling again`,
1555
+ improvement: `Avoid ${issue.count - 1} redundant operations`,
1556
+ });
1557
+ break;
1558
+ }
1559
+
1560
+ return {
1561
+ optimizations,
1562
+ priority: 'low',
1563
+ };
1564
+ }
1565
+
1566
+ async detectObjectIssues(ast, content) {
1567
+ const issues = [];
1568
+
1569
+ traverse(ast, {
1570
+ ObjectExpression(path) {
1571
+ // Check for large object literals
1572
+ if (path.node.properties.length > 50) {
1573
+ issues.push({
1574
+ type: 'large_object_literal',
1575
+ size: path.node.properties.length,
1576
+ location: path.node.loc,
1577
+ description: 'Large object literal may impact performance',
1578
+ });
1579
+ }
1580
+ },
1581
+ MemberExpression(path) {
1582
+ // Check for deep property access
1583
+ let depth = 0;
1584
+ let current = path.node;
1585
+
1586
+ while (t.isMemberExpression(current)) {
1587
+ depth++;
1588
+ current = current.object;
1589
+ }
1590
+
1591
+ if (depth > 3) {
1592
+ issues.push({
1593
+ type: 'deep_property_access',
1594
+ depth,
1595
+ location: path.node.loc,
1596
+ description: `Deep property access (${depth} levels)`,
1597
+ });
1598
+ }
1599
+ },
1600
+ CallExpression(path) {
1601
+ // Check for Object.keys/values/entries in loops
1602
+ if (t.isMemberExpression(path.node.callee)) {
1603
+ const object = path.node.callee.object;
1604
+ const property = path.node.callee.property;
1605
+
1606
+ if (t.isIdentifier(object, { name: 'Object' }) &&
1607
+ t.isIdentifier(property) &&
1608
+ ['keys', 'values', 'entries'].includes(property.name)) {
1609
+
1610
+ const inLoop = path.findParent(p =>
1611
+ p.isForStatement() || p.isWhileStatement() || p.isDoWhileStatement(),
1612
+ );
1613
+
1614
+ if (inLoop) {
1615
+ issues.push({
1616
+ type: 'object_iteration_in_loop',
1617
+ method: property.name,
1618
+ location: path.node.loc,
1619
+ description: `Object.${property.name} in loop creates intermediate array`,
1620
+ });
1621
+ }
1622
+ }
1623
+ }
1624
+ },
1625
+ });
1626
+
1627
+ return issues;
1628
+ }
1629
+
1630
+ async suggestObjectOptimizations(issue) {
1631
+ const optimizations = [];
1632
+
1633
+ switch (issue.type) {
1634
+ case 'large_object_literal':
1635
+ optimizations.push({
1636
+ type: 'use_map',
1637
+ description: 'Consider using Map for large key-value stores',
1638
+ code: 'const map = new Map([\n [\'key1\', value1],\n [\'key2\', value2]\n]);',
1639
+ improvement: 'Better performance for frequent updates',
1640
+ });
1641
+ break;
1642
+
1643
+ case 'deep_property_access':
1644
+ optimizations.push({
1645
+ type: 'cache_reference',
1646
+ description: 'Cache intermediate references',
1647
+ code: 'const intermediate = obj.level1.level2;\nconst value = intermediate.level3.level4;',
1648
+ improvement: 'Reduce property lookup overhead',
1649
+ });
1650
+ optimizations.push({
1651
+ type: 'flatten_structure',
1652
+ description: 'Consider flattening data structure',
1653
+ improvement: 'Simpler and faster access',
1654
+ });
1655
+ break;
1656
+
1657
+ case 'object_iteration_in_loop':
1658
+ optimizations.push({
1659
+ type: 'cache_iteration',
1660
+ description: `Cache Object.${issue.method} result`,
1661
+ code: `const ${issue.method} = Object.${issue.method}(obj);\nfor (...) {\n // Use cached ${issue.method}\n}`,
1662
+ improvement: 'Avoid creating array multiple times',
1663
+ });
1664
+ break;
1665
+ }
1666
+
1667
+ return {
1668
+ optimizations,
1669
+ priority: issue.type === 'large_object_literal' ? 'medium' : 'low',
1670
+ };
1671
+ }
1672
+
1673
+ generateOptimizationExample(complexity) {
1674
+ if (complexity.loopDepth >= 2) {
1675
+ return '// Instead of nested loops O(n²):\nfor (const item1 of array1) {\n for (const item2 of array2) {\n if (item1.id === item2.id) { ... }\n }\n}\n\n// Use a Map for O(n):\nconst map = new Map(array2.map(item => [item.id, item]));\nfor (const item1 of array1) {\n const item2 = map.get(item1.id);\n if (item2) { ... }\n}';
1676
+ }
1677
+ return '';
1678
+ }
1679
+
1680
+ estimatePerformanceImprovement(issue) {
1681
+ const improvements = {
1682
+ high_complexity: {
1683
+ 'O(n²)': '10-100x faster for large datasets',
1684
+ 'O(n³)': '100-1000x faster for large datasets',
1685
+ 'O(2^n)': 'Exponential improvement',
1686
+ },
1687
+ };
1688
+
1689
+ if (issue.type === 'high_complexity' && issue.complexity.notation) {
1690
+ return improvements.high_complexity[issue.complexity.notation] || 'Significant improvement';
1691
+ }
1692
+
1693
+ return 'Performance improvement depends on data size';
1694
+ }
1695
+
1696
+ estimateMemorySaving(issue) {
1697
+ const savings = {
1698
+ large_array: `~${(issue.size * 8 / 1024 / 1024).toFixed(1)}MB`,
1699
+ concat_in_loop: 'Reduces intermediate array allocations',
1700
+ unnecessary_copy: 'Saves memory equal to array size',
1701
+ };
1702
+
1703
+ return savings[issue.type] || 'Memory savings depend on data size';
1704
+ }
1705
+
1706
+ estimateCachingImprovement(issue) {
1707
+ if (issue.type === 'repeated_calls') {
1708
+ return `${((issue.count - 1) / issue.count * 100).toFixed(0)}% reduction in computation`;
1709
+ }
1710
+ return 'Significant for repeated operations';
1711
+ }
1712
+
1713
+ estimateBundleSizeReduction(issue) {
1714
+ const reductions = {
1715
+ namespace_import: {
1716
+ lodash: '~500KB to ~5KB per function',
1717
+ moment: '~300KB to ~50KB with date-fns',
1718
+ rxjs: '~200KB to ~20KB with proper imports',
1719
+ },
1720
+ default_import: {
1721
+ lodash: '~70KB to ~5KB per function',
1722
+ },
1723
+ };
1724
+
1725
+ if (reductions[issue.type]?.[issue.library]) {
1726
+ return reductions[issue.type][issue.library];
1727
+ }
1728
+
1729
+ return 'Size reduction depends on usage';
1730
+ }
1731
+
1732
+ calculatePerformanceScore(analysis) {
1733
+ let score = 100;
1734
+
1735
+ // Deduct points for issues based on impact
1736
+ for (const issue of analysis.issues) {
1737
+ switch (issue.impact) {
1738
+ case 'critical':
1739
+ score -= 20;
1740
+ break;
1741
+ case 'high':
1742
+ score -= 10;
1743
+ break;
1744
+ case 'medium':
1745
+ score -= 5;
1746
+ break;
1747
+ case 'low':
1748
+ score -= 2;
1749
+ break;
1750
+ }
1751
+ }
1752
+
1753
+ // Factor in static metrics
1754
+ const metrics = analysis.metrics.static;
1755
+ if (metrics) {
1756
+ if (metrics.complexity > 20) score -= 10;
1757
+ if (metrics.loopDepth > 3) score -= 15;
1758
+ if (metrics.fileSize > 50000) score -= 5;
1759
+ }
1760
+
1761
+ return Math.max(0, Math.min(100, score));
1762
+ }
1763
+
1764
+ isExecutable(filePath) {
1765
+ // Check if file is a script that can be profiled
1766
+ return filePath.endsWith('.js') && !filePath.includes('.test.') && !filePath.includes('.spec.');
1767
+ }
1768
+
1769
+ async profileRuntime(filePath) {
1770
+ // This would require actual runtime profiling
1771
+ // For now, return placeholder metrics
1772
+ return {
1773
+ executionTime: 0,
1774
+ memoryUsage: 0,
1775
+ cpuUsage: 0,
1776
+ };
1777
+ }
1778
+
1779
+ async applyOptimization(filePath, optimization) {
1780
+ // Apply specific optimization to file
1781
+ const result = {
1782
+ success: false,
1783
+ changes: [],
1784
+ error: null,
1785
+ };
1786
+
1787
+ try {
1788
+ const content = await fs.readFile(filePath, 'utf-8');
1789
+
1790
+ // Parse and transform based on optimization type
1791
+ // This would involve AST transformation
1792
+
1793
+ result.success = true;
1794
+ result.changes.push({
1795
+ type: optimization.type,
1796
+ description: optimization.description,
1797
+ });
1798
+
1799
+ this.optimizationHistory.push({
1800
+ filePath,
1801
+ optimization,
1802
+ timestamp: new Date().toISOString(),
1803
+ result,
1804
+ });
1805
+
1806
+ } catch (error) {
1807
+ result.error = error.message;
1808
+ }
1809
+
1810
+ return result;
1811
+ }
1812
+
1813
+ async generateOptimizationReport() {
1814
+ const report = {
1815
+ timestamp: new Date().toISOString(),
1816
+ summary: {
1817
+ filesAnalyzed: this.performanceMetrics.size,
1818
+ totalIssues: 0,
1819
+ criticalIssues: 0,
1820
+ optimizationsApplied: this.optimizationHistory.length,
1821
+ },
1822
+ byCategory: {},
1823
+ topIssues: [],
1824
+ recommendations: [],
1825
+ };
1826
+
1827
+ // Aggregate metrics
1828
+ for (const [file, metrics] of this.performanceMetrics) {
1829
+ report.summary.totalIssues += metrics.issues.length;
1830
+ report.summary.criticalIssues += metrics.issues.filter(i => i.severity === 'critical').length;
1831
+
1832
+ // Group by category
1833
+ for (const issue of metrics.issues) {
1834
+ const category = issue.category || 'other';
1835
+ if (!report.byCategory[category]) {
1836
+ report.byCategory[category] = {
1837
+ count: 0,
1838
+ issues: [],
1839
+ };
1840
+ }
1841
+ report.byCategory[category].count++;
1842
+ report.byCategory[category].issues.push({
1843
+ file: file.replace(this.rootPath, '.'),
1844
+ ...issue,
1845
+ });
1846
+ }
1847
+ }
1848
+
1849
+ // Top issues
1850
+ const allIssues = [];
1851
+ for (const [file, metrics] of this.performanceMetrics) {
1852
+ allIssues.push(...metrics.issues.map(i => ({
1853
+ file: file.replace(this.rootPath, '.'),
1854
+ ...i,
1855
+ })));
1856
+ }
1857
+
1858
+ report.topIssues = allIssues
1859
+ .sort((a, b) => {
1860
+ const impactScore = { critical: 3, high: 2, medium: 1, low: 0 };
1861
+ return (impactScore[b.impact] || 0) - (impactScore[a.impact] || 0);
1862
+ })
1863
+ .slice(0, 10);
1864
+
1865
+ // General recommendations
1866
+ report.recommendations = this.generateRecommendations(report);
1867
+
1868
+ return report;
1869
+ }
1870
+
1871
+ generateRecommendations(report) {
1872
+ const recommendations = [];
1873
+
1874
+ if (report.byCategory.algorithm?.count > 5) {
1875
+ recommendations.push({
1876
+ category: 'algorithm',
1877
+ recommendation: 'Consider algorithm optimization training for the team',
1878
+ priority: 'high',
1879
+ });
1880
+ }
1881
+
1882
+ if (report.byCategory.async?.count > 10) {
1883
+ recommendations.push({
1884
+ category: 'async',
1885
+ recommendation: 'Review async/await patterns and consider using Promise.all',
1886
+ priority: 'medium',
1887
+ });
1888
+ }
1889
+
1890
+ if (report.byCategory.memory?.count > 0) {
1891
+ recommendations.push({
1892
+ category: 'memory',
1893
+ recommendation: 'Implement memory profiling in development',
1894
+ priority: 'medium',
1895
+ });
1896
+ }
1897
+
1898
+ return recommendations;
1899
+ }
1900
+ }
1901
+
1902
+ module.exports = PerformanceOptimizer;