@polymorphism-tech/morph-spec 7.7.3 โ†’ 7.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (187) hide show
  1. package/README.md +2 -2
  2. package/bin/validate.js +379 -379
  3. package/claude-plugin.json +1 -1
  4. package/docs/CHEATSHEET.md +1 -1
  5. package/docs/QUICKSTART.md +1 -1
  6. package/framework/CLAUDE.md +1 -1
  7. package/framework/MORPH.md +3 -2
  8. package/framework/agents.json +1 -1
  9. package/framework/commands/commit.md +166 -166
  10. package/framework/commands/morph-infra.md +215 -215
  11. package/framework/commands/morph-preflight.md +205 -205
  12. package/framework/commands/morph-troubleshoot.md +124 -124
  13. package/framework/evals/scenarios/dotnet-crud.yaml +1 -1
  14. package/framework/hooks/claude-code/statusline.py +679 -679
  15. package/framework/hooks/claude-code/statusline.sh +11 -11
  16. package/framework/hooks/git/commit-msg/conventional-commits.sh +33 -33
  17. package/framework/hooks/git/pre-commit/agents.sh +25 -25
  18. package/framework/hooks/git/pre-commit/orchestrator.sh +64 -64
  19. package/framework/hooks/git/pre-commit/specs.sh +50 -50
  20. package/framework/hooks/git/pre-push/run-tests.sh +44 -44
  21. package/framework/hooks/shared/activity-logger.js +160 -160
  22. package/framework/hooks/shared/hook-response.js +45 -45
  23. package/framework/hooks/shared/payload-utils.js +78 -78
  24. package/framework/hooks/shared/stdin-reader.js +26 -26
  25. package/framework/rubrics/backend.json +41 -41
  26. package/framework/rules/ai-agents-standards.md +45 -45
  27. package/framework/rules/dotnet-templates.md +86 -87
  28. package/framework/rules/frontend-standards.md +13 -13
  29. package/framework/rules/infrastructure-standards.md +27 -27
  30. package/framework/rules/neon-standards.md +25 -25
  31. package/framework/rules/nextjs-standards.md +20 -20
  32. package/framework/rules/nextjs-templates.md +40 -40
  33. package/framework/skills/core/create-umbraco-lp/SKILL.md +1 -1
  34. package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md +1 -1
  35. package/framework/skills/core/morph-apply/SKILL.md +1 -1
  36. package/framework/skills/core/morph-brainstorming/SKILL.md +9 -5
  37. package/framework/skills/core/morph-eval/SKILL.md +1 -1
  38. package/framework/skills/core/morph-implement/SKILL.md +1 -1
  39. package/framework/skills/core/morph-plan/SKILL.md +11 -6
  40. package/framework/skills/core/morph-proposal/SKILL.md +1 -1
  41. package/framework/skills/core/morph-review/SKILL.md +13 -7
  42. package/framework/skills/core/morph-stack-scan/SKILL.md +5 -5
  43. package/framework/skills/core/morph-standards/SKILL.md +1 -1
  44. package/framework/standards/STANDARDS.json +1 -1
  45. package/framework/standards/ai-agents/agent-session.md +160 -160
  46. package/framework/standards/ai-agents/batching.md +193 -193
  47. package/framework/standards/ai-agents/context-providers.md +188 -188
  48. package/framework/standards/ai-agents/mcp-server.md +250 -250
  49. package/framework/standards/ai-agents/mcp-tools.md +197 -197
  50. package/framework/standards/ai-agents/middleware-patterns.md +207 -207
  51. package/framework/standards/ai-agents/modalities-image-gen.md +173 -173
  52. package/framework/standards/ai-agents/modalities-speech-to-text.md +171 -171
  53. package/framework/standards/ai-agents/modalities-text-to-speech.md +181 -181
  54. package/framework/standards/ai-agents/modalities-vision.md +201 -201
  55. package/framework/standards/ai-agents/multi-agent-patterns.md +155 -155
  56. package/framework/standards/ai-agents/production.md +275 -275
  57. package/framework/standards/ai-agents/prompts-in-db.md +214 -214
  58. package/framework/standards/ai-agents/providers/model-registry.md +158 -158
  59. package/framework/standards/ai-agents/service-tier-flex.md +135 -135
  60. package/framework/standards/ai-agents/structured-output.md +249 -249
  61. package/framework/standards/ai-agents/sweet-spot.md +109 -109
  62. package/framework/standards/architecture/vertical-slice/vertical-slice.md +34 -35
  63. package/framework/standards/backend/api/validation.md +2 -2
  64. package/framework/standards/backend/dotnet/scrutor.md +1 -3
  65. package/framework/standards/backend/dotnet/vsa-handler-patterns.md +42 -37
  66. package/framework/standards/data/nosql/cache/redis.md +2 -2
  67. package/framework/templates/CLAUDE.md.core.template +1 -1
  68. package/framework/templates/IDE-SNIPPETS.md +262 -262
  69. package/framework/templates/README.md +0 -1
  70. package/framework/templates/REGISTRY.json +0 -21
  71. package/framework/templates/code/dotnet/abstractions/api-endpoint.cs +7 -7
  72. package/framework/templates/code/dotnet/abstractions/handler.cs +0 -3
  73. package/framework/templates/code/dotnet/ai-agents/AgentBootstrap.cs.template +39 -39
  74. package/framework/templates/code/dotnet/ai-agents/EmbeddingService.cs.template +68 -68
  75. package/framework/templates/code/dotnet/ai-agents/ModelRegistry.cs.template +117 -117
  76. package/framework/templates/code/dotnet/ai-agents/PromptRepository.cs.template +95 -95
  77. package/framework/templates/code/dotnet/ai-agents/ResilientToolMiddleware.cs.template +61 -61
  78. package/framework/templates/code/dotnet/ai-agents/VectorSearchTool.cs.template +107 -107
  79. package/framework/templates/code/dotnet/ai-agents/model-registry.json.template +58 -58
  80. package/framework/templates/code/dotnet/constants/api-tags.cs +1 -1
  81. package/framework/templates/code/dotnet/contracts/contracts-vsa.cs +281 -282
  82. package/framework/templates/code/dotnet/database/migration.cs +83 -83
  83. package/framework/templates/code/dotnet/feature/endpoint.cs.hbs +21 -21
  84. package/framework/templates/code/dotnet/feature/handler.cs.hbs +23 -24
  85. package/framework/templates/code/dotnet/feature/request.cs.hbs +4 -4
  86. package/framework/templates/code/dotnet/feature/response.cs.hbs +4 -4
  87. package/framework/templates/code/dotnet/feature/validator.cs.hbs +15 -15
  88. package/framework/templates/code/dotnet/jobs/job.cs +15 -15
  89. package/framework/templates/code/dotnet/test.cs +72 -101
  90. package/framework/templates/code/sql/ai-agents/agent-prompts-migration.sql.template +58 -58
  91. package/framework/templates/code/sql/ai-agents/pgvector-embeddings-migration.sql.template +91 -91
  92. package/framework/templates/code/typescript/contracts.ts +167 -167
  93. package/framework/templates/docs/clarifications.md +253 -253
  94. package/framework/templates/docs/schema-analysis.md +119 -119
  95. package/framework/templates/docs/ui-components.md +52 -52
  96. package/framework/templates/docs/ui-design-system.md +76 -76
  97. package/framework/templates/docs/ui-flows.md +167 -167
  98. package/framework/templates/docs/ui-mockups.md +98 -98
  99. package/framework/templates/feature/decisions.md +122 -122
  100. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -43
  101. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -26
  102. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -32
  103. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -56
  104. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -22
  105. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -26
  106. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -54
  107. package/framework/templates/infrastructure/docker/Dockerfile.template +58 -58
  108. package/framework/templates/infrastructure/docker/docker-compose.template.yml +50 -50
  109. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  110. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  111. package/framework/templates/infrastructure/github/README.md +56 -56
  112. package/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -45
  113. package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -27
  114. package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -59
  115. package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -39
  116. package/framework/templates/integrations/asaas-client.cs +387 -387
  117. package/framework/templates/integrations/asaas-webhook.cs +351 -351
  118. package/framework/templates/meta-prompts/fusion/fusion-agent.md +76 -76
  119. package/framework/templates/meta-prompts/fusion/fusion-aggregator.md +100 -100
  120. package/framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md +113 -113
  121. package/framework/templates/meta-prompts/validators/pre-commit-validator.md +95 -95
  122. package/framework/templates/project/validate.js +120 -120
  123. package/framework/templates/state.template.json +17 -17
  124. package/framework/templates/ui/design-system.css +226 -226
  125. package/package.json +1 -1
  126. package/src/commands/dashboard/dashboard.js +53 -53
  127. package/src/commands/index.js +13 -13
  128. package/src/commands/mcp/mcp-setup.js +519 -519
  129. package/src/commands/project/checkpoint.js +209 -209
  130. package/src/commands/project/update.js +7 -4
  131. package/src/core/state/phase-state-machine.js +197 -197
  132. package/src/core/templates/template-renderer.js +477 -477
  133. package/src/dashboard/app/components/DetailPanel.jsx +11 -11
  134. package/src/dashboard/app/components/FlowGraph.jsx +17 -17
  135. package/src/dashboard/app/components/SearchFilter.jsx +22 -22
  136. package/src/dashboard/app/hooks/useDetailPanel.js +15 -15
  137. package/src/dashboard/app/main.jsx +13 -13
  138. package/src/dashboard/app/pages/AgentMap.jsx +370 -370
  139. package/src/dashboard/app/pages/HookInspector.jsx +418 -418
  140. package/src/dashboard/app/pages/LiveState.jsx +239 -239
  141. package/src/dashboard/app/pages/PhasePipeline.jsx +408 -408
  142. package/src/dashboard/app/pages/RulesMap.jsx +273 -273
  143. package/src/dashboard/app/pages/SkillsLibrary.jsx +366 -366
  144. package/src/dashboard/app/pages/Standards.jsx +332 -332
  145. package/src/dashboard/app/styles/index.css +47 -47
  146. package/src/dashboard/index.html +12 -12
  147. package/src/dashboard/package.json +24 -24
  148. package/src/dashboard/scanner/hooks-scanner.js +41 -41
  149. package/src/dashboard/scanner/phases-scanner.js +15 -15
  150. package/src/dashboard/scanner/rubrics-scanner.js +12 -12
  151. package/src/dashboard/scanner/rules-scanner.js +37 -37
  152. package/src/dashboard/scanner/skills-scanner.js +43 -43
  153. package/src/dashboard/scanner/squads-scanner.js +13 -13
  154. package/src/dashboard/scanner/standards-scanner.js +26 -26
  155. package/src/dashboard/vite-plugin-morph-data.js +17 -17
  156. package/src/dashboard/vite.config.js +24 -24
  157. package/src/lib/agents/metrics-aggregator.js +56 -56
  158. package/src/lib/agents/metrics-calculator.js +125 -125
  159. package/src/lib/agents/output-collector.js +73 -73
  160. package/src/lib/detectors/claude-config-detector.js +152 -152
  161. package/src/lib/detectors/design-system-detector.js +231 -231
  162. package/src/lib/detectors/index.js +217 -217
  163. package/src/lib/generators/architecture-scanner.js +639 -639
  164. package/src/lib/generators/design-system-generator.js +508 -508
  165. package/src/lib/generators/index.js +13 -13
  166. package/src/lib/generators/settings-generator.js +209 -209
  167. package/src/lib/hooks/hook-executor.js +167 -167
  168. package/src/lib/installers/mcp-installer.js +719 -719
  169. package/src/lib/tasks/task-classifier.js +30 -30
  170. package/src/lib/tasks/task-parser.js +209 -209
  171. package/src/lib/tasks/test-runner.js +81 -81
  172. package/src/lib/validators/architecture/architecture-validator.js +259 -259
  173. package/src/lib/validators/checkpoint-persistence.js +39 -39
  174. package/src/lib/validators/contracts/contract-compliance-validator.js +274 -274
  175. package/src/lib/validators/css/css-validator.js +340 -340
  176. package/src/lib/validators/packages/package-validator.js +347 -347
  177. package/src/lib/validators/shared/emit-validator-dispatch.js +14 -14
  178. package/src/lib/validators/shared/issue-counter.js +14 -14
  179. package/src/lib/validators/validation-runner.js +349 -349
  180. package/src/scripts/setup-infra.js +383 -383
  181. package/src/utils/agent-id-mapper.js +11 -11
  182. package/src/utils/banner.js +52 -43
  183. package/src/utils/claude-settings-manager.js +300 -300
  184. package/src/utils/skills-installer.js +172 -172
  185. package/framework/templates/.idea/morph-templates.xml +0 -92
  186. package/framework/templates/.vscode/morph-templates.code-snippets +0 -186
  187. package/framework/templates/code/dotnet/backend/repository.cs +0 -141
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "morph-spec",
3
- "version": "7.7.3",
3
+ "version": "7.8.1",
4
4
  "displayName": "MORPH-SPEC Framework",
5
5
  "description": "Spec-driven development with 38 agents and 8-phase workflow for .NET/Blazor/Next.js/Azure",
6
6
  "publisher": "polymorphism-tech",
@@ -196,4 +196,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
196
196
 
197
197
  ---
198
198
 
199
- *morph-spec v7.7.3 by Polymorphism Tech*
199
+ *morph-spec v7.8.1 by Polymorphism Tech*
@@ -197,4 +197,4 @@ morph-spec doctor
197
197
 
198
198
  ---
199
199
 
200
- *morph-spec v7.7.3 by Polymorphism Tech*
200
+ *morph-spec v7.8.1 by Polymorphism Tech*
@@ -17,7 +17,7 @@ Se nรฃo houver feature ativa, pergunte ao usuรกrio qual feature trabalhar.
17
17
  - Modificar o contrato do plano depois do Gate 2: `spec.md`, `mandate.md`, e os campos de plano de `tasks.json` (`title`, `description`, `dependencies`, `effort`, `doneCriteria`, `group`) estรฃo congelados.
18
18
  - Tocar os campos de contrato do plano em `tasks.json` apรณs o Gate 2 (`title`, `description`, `dependencies`, `effort`, `doneCriteria`, `group`) โ€” o hook `protect-spec-files` faz diff semรขntico e bloqueia mudanรงas neles, seja via `Write` ou `Edit`. (Os campos mutรกveis `status`/`outputs`/`notes` continuam gravรกveis por `Write` ou `Edit` โ€” ver SEMPRE.)
19
19
  - Listar perguntas em texto simples โ€” sempre use a tool `AskUserQuestion` (1-4 perguntas por chamada).
20
- - Usar `Guid.NewGuid()`, classes nรฃo-sealed sem justificativa, exceptions como fluxo de controle, camada de Service/Manager entre handler e dados, ou SQL cru sem justificativa.
20
+ - Usar `Guid.NewGuid()`, classes nรฃo-sealed sem justificativa, exceptions como fluxo de controle, camada de Service/Manager entre handler e dados, repository genรฉrico (`IRepository<T>`/`IUnitOfWork`), ou SQL cru sem justificativa.
21
21
 
22
22
  **SEMPRE:**
23
23
  - Auto-advance entre tarefas durante a fase implement โ€” nรฃo pause sem ambiguidade bloqueante.
@@ -48,10 +48,11 @@ Padrรตes proibidos automaticamente injetados no mandate:
48
48
  - `Guid.NewGuid()` โ†’ `Guid.CreateVersion7()`
49
49
  - Classes nรฃo-sealed sem justificativa
50
50
  - Exceptions como fluxo de controle
51
- - Camada de Service/Manager entre handler e dados โ€” o handler fala com `IRepository<T>` ou `DbContext`, nunca com um service
51
+ - Camada de Service/Manager entre handler e dados โ€” o handler fala com o `ApplicationDbContext` direto, nunca com um service
52
+ - Repository genรฉrico (`IRepository<T>`/`IUnitOfWork`) โ€” redundante sobre EF Core: `DbSet<T>` jรก รฉ repository, `DbContext` jรก รฉ unit of work
52
53
  - SQL cru (`FromSqlRaw`, `ExecuteQuery(string)`) sem justificativa em `decisions.md` โ€” use LINQ
53
54
 
54
- Acesso a dados em VSA รฉ hรญbrido: `IRepository<T>` + `IUnitOfWork` para CRUD simples; `ApplicationDbContext` injetado direto no slice quando a query for especรญfica (joins, projeรงรฃo, paginaรงรฃo, filtros compostos).
55
+ Acesso a dados em VSA: o handler injeta `ApplicationDbContext` direto no slice โ€” `DbSet<T>` jรก รฉ repository, `DbContext` jรก รฉ unit of work. Para concorrรชncia ou SQL especรญfico, crie um store dedicado hand-written com justificativa em `decisions.md`. NUNCA camada de Service/Manager; NUNCA repository genรฉrico.
55
56
 
56
57
  ---
57
58
 
@@ -22,7 +22,7 @@
22
22
  "backend-dotnet-fluent-validation-vsa"
23
23
  ],
24
24
  "mcp": ["context7"],
25
- "persona": "Vocรช รฉ um engenheiro .NET sรชnior. Pensa em VSA com handlers diretos, result pattern, sealed classes, Guid.CreateVersion7(). Acesso a dados hรญbrido: IRepository<T> + IUnitOfWork para CRUD, DbContext direto no slice para queries especรญficas; nunca uma camada de Service/Manager. Nรฃo usa exceptions como fluxo. Consulta o standard antes de escrever cada slice. Nomeia tudo em PascalCase para tipos, camelCase para parรขmetros."
25
+ "persona": "Vocรช รฉ um engenheiro .NET sรชnior. Pensa em VSA com handlers diretos, result pattern, sealed classes, Guid.CreateVersion7(). Acesso a dados: ApplicationDbContext injetado direto no slice (DbSet<T> jรก รฉ repository, DbContext jรก รฉ unit of work); para concorrรชncia ou SQL especรญfico, store dedicado hand-written com justificativa em decisions.md; nunca uma camada de Service/Manager; nunca repository genรฉrico (IRepository<T>/IUnitOfWork). Nรฃo usa exceptions como fluxo. Consulta o standard antes de escrever cada slice. Nomeia tudo em PascalCase para tipos, camelCase para parรขmetros."
26
26
  },
27
27
  "ef-modeler": {
28
28
  "title": "EF Core / Database Modeler",
@@ -1,166 +1,166 @@
1
- ---
2
- allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*), Bash(git diff:*), Bash(git log:*)
3
- argument-hint: [message] | --no-verify | --amend
4
- description: Create well-formatted commits with conventional commit format and emoji
5
- ---
6
-
7
- # Smart Git Commit
8
-
9
- Create well-formatted commit: $ARGUMENTS
10
-
11
- ## Current Repository State
12
-
13
- - Git status: !git status --porcelain
14
- - Current branch: !git branch --show-current
15
- - Staged changes: !git diff --cached --stat
16
- - Unstaged changes: !git diff --stat
17
- - Recent commits: !git log --oneline -5
18
-
19
- ## What This Command Does
20
-
21
- 1. Unless specified with --no-verify, automatically runs pre-commit checks:
22
- - pnpm lint to ensure code quality
23
- - pnpm build to verify the build succeeds
24
- - pnpm generate:docs to update documentation
25
- 2. Checks which files are staged with git status
26
- 3. If 0 files are staged, automatically adds all modified and new files with git add
27
- 4. Performs a git diff to understand what changes are being committed
28
- 5. Analyzes the diff to determine if multiple distinct logical changes are present
29
- 6. If multiple distinct changes are detected, suggests breaking the commit into multiple smaller commits
30
- 7. For each commit (or the single commit if not split), creates a commit message using emoji conventional commit format
31
-
32
- ## Best Practices for Commits
33
-
34
- - **Verify before committing**: Ensure code is linted, builds correctly, and documentation is updated
35
- - **Atomic commits**: Each commit should contain related changes that serve a single purpose
36
- - **Split large changes**: If changes touch multiple concerns, split them into separate commits
37
- - **Conventional commit format**: Use the format <type>: <description> where type is one of:
38
- - feat: A new feature
39
- - fix: A bug fix
40
- - docs: Documentation changes
41
- - style: Code style changes (formatting, etc)
42
- - refactor: Code changes that neither fix bugs nor add features
43
- - perf: Performance improvements
44
- - test: Adding or fixing tests
45
- - chore: Changes to the build process, tools, etc.
46
- - **Present tense, imperative mood**: Write commit messages as commands (e.g., "add feature" not "added feature")
47
- - **Concise first line**: Keep the first line under 72 characters
48
- - **Emoji**: Each commit type is paired with an appropriate emoji:
49
- - โœจ feat: New feature
50
- - ๐Ÿ› fix: Bug fix
51
- - ๐Ÿ“ docs: Documentation
52
- - ๐Ÿ’„ style: Formatting/style
53
- - โ™ป๏ธ refactor: Code refactoring
54
- - โšก๏ธ perf: Performance improvements
55
- - โœ… test: Tests
56
- - ๐Ÿ”ง chore: Tooling, configuration
57
- - ๐Ÿš€ ci: CI/CD improvements
58
- - ๐Ÿ—‘๏ธ revert: Reverting changes
59
- - ๐Ÿงช test: Add a failing test
60
- - ๐Ÿšจ fix: Fix compiler/linter warnings
61
- - ๐Ÿ”’๏ธ fix: Fix security issues
62
- - ๐Ÿ‘ฅ chore: Add or update contributors
63
- - ๐Ÿšš refactor: Move or rename resources
64
- - ๐Ÿ—๏ธ refactor: Make architectural changes
65
- - ๐Ÿ”€ chore: Merge branches
66
- - ๐Ÿ“ฆ๏ธ chore: Add or update compiled files or packages
67
- - โž• chore: Add a dependency
68
- - โž– chore: Remove a dependency
69
- - ๐ŸŒฑ chore: Add or update seed files
70
- - ๐Ÿง‘โ€๐Ÿ’ป chore: Improve developer experience
71
- - ๐Ÿงต feat: Add or update code related to multithreading or concurrency
72
- - ๐Ÿ”๏ธ feat: Improve SEO
73
- - ๐Ÿท๏ธ feat: Add or update types
74
- - ๐Ÿ’ฌ feat: Add or update text and literals
75
- - ๐ŸŒ feat: Internationalization and localization
76
- - ๐Ÿ‘” feat: Add or update business logic
77
- - ๐Ÿ“ฑ feat: Work on responsive design
78
- - ๐Ÿšธ feat: Improve user experience / usability
79
- - ๐Ÿฉน fix: Simple fix for a non-critical issue
80
- - ๐Ÿฅ… fix: Catch errors
81
- - ๐Ÿ‘ฝ๏ธ fix: Update code due to external API changes
82
- - ๐Ÿ”ฅ fix: Remove code or files
83
- - ๐ŸŽจ style: Improve structure/format of the code
84
- - ๐Ÿš‘๏ธ fix: Critical hotfix
85
- - ๐ŸŽ‰ chore: Begin a project
86
- - ๐Ÿ”– chore: Release/Version tags
87
- - ๐Ÿšง wip: Work in progress
88
- - ๐Ÿ’š fix: Fix CI build
89
- - ๐Ÿ“Œ chore: Pin dependencies to specific versions
90
- - ๐Ÿ‘ท ci: Add or update CI build system
91
- - ๐Ÿ“ˆ feat: Add or update analytics or tracking code
92
- - โœ๏ธ fix: Fix typos
93
- - โช๏ธ revert: Revert changes
94
- - ๐Ÿ“„ chore: Add or update license
95
- - ๐Ÿ’ฅ feat: Introduce breaking changes
96
- - ๐Ÿฑ assets: Add or update assets
97
- - โ™ฟ๏ธ feat: Improve accessibility
98
- - ๐Ÿ’ก docs: Add or update comments in source code
99
- - ๐Ÿ—ƒ๏ธ db: Perform database related changes
100
- - ๐Ÿ”Š feat: Add or update logs
101
- - ๐Ÿ”‡ fix: Remove logs
102
- - ๐Ÿคก test: Mock things
103
- - ๐Ÿฅš feat: Add or update an easter egg
104
- - ๐Ÿ™ˆ chore: Add or update .gitignore file
105
- - ๐Ÿ“ธ test: Add or update snapshots
106
- - โš—๏ธ experiment: Perform experiments
107
- - ๐Ÿšฉ feat: Add, update, or remove feature flags
108
- - ๐Ÿ’ซ ui: Add or update animations and transitions
109
- - โšฐ๏ธ refactor: Remove dead code
110
- - ๐Ÿฆบ feat: Add or update code related to validation
111
- - โœˆ๏ธ feat: Improve offline support
112
-
113
- ## Guidelines for Splitting Commits
114
-
115
- When analyzing the diff, consider splitting commits based on these criteria:
116
-
117
- 1. **Different concerns**: Changes to unrelated parts of the codebase
118
- 2. **Different types of changes**: Mixing features, fixes, refactoring, etc.
119
- 3. **File patterns**: Changes to different types of files (e.g., source code vs documentation)
120
- 4. **Logical grouping**: Changes that would be easier to understand or review separately
121
- 5. **Size**: Very large changes that would be clearer if broken down
122
-
123
- ## Examples
124
-
125
- Good commit messages:
126
- - โœจ feat: add user authentication system
127
- - ๐Ÿ› fix: resolve memory leak in rendering process
128
- - ๐Ÿ“ docs: update API documentation with new endpoints
129
- - โ™ป๏ธ refactor: simplify error handling logic in parser
130
- - ๐Ÿšจ fix: resolve linter warnings in component files
131
- - ๐Ÿง‘โ€๐Ÿ’ป chore: improve developer tooling setup process
132
- - ๐Ÿ‘” feat: implement business logic for transaction validation
133
- - ๐Ÿฉน fix: address minor styling inconsistency in header
134
- - ๐Ÿš‘๏ธ fix: patch critical security vulnerability in auth flow
135
- - ๐ŸŽจ style: reorganize component structure for better readability
136
- - ๐Ÿ”ฅ fix: remove deprecated legacy code
137
- - ๐Ÿฆบ feat: add input validation for user registration form
138
- - ๐Ÿ’š fix: resolve failing CI pipeline tests
139
- - ๐Ÿ“ˆ feat: implement analytics tracking for user engagement
140
- - ๐Ÿ”’๏ธ fix: strengthen authentication password requirements
141
- - โ™ฟ๏ธ feat: improve form accessibility for screen readers
142
-
143
- Example of splitting commits:
144
- - First commit: โœจ feat: add new solc version type definitions
145
- - Second commit: ๐Ÿ“ docs: update documentation for new solc versions
146
- - Third commit: ๐Ÿ”ง chore: update package.json dependencies
147
- - Fourth commit: ๐Ÿท๏ธ feat: add type definitions for new API endpoints
148
- - Fifth commit: ๐Ÿงต feat: improve concurrency handling in worker threads
149
- - Sixth commit: ๐Ÿšจ fix: resolve linting issues in new code
150
- - Seventh commit: โœ… test: add unit tests for new solc version features
151
- - Eighth commit: ๐Ÿ”’๏ธ fix: update dependencies with security vulnerabilities
152
-
153
- ## Command Options
154
-
155
- - --no-verify: Skip running the pre-commit checks (lint, build, generate:docs)
156
-
157
- ## Important Notes
158
-
159
- - By default, pre-commit checks (pnpm lint, pnpm build, pnpm generate:docs) will run to ensure code quality
160
- - If these checks fail, you'll be asked if you want to proceed with the commit anyway or fix the issues first
161
- - If specific files are already staged, the command will only commit those files
162
- - If no files are staged, it will automatically stage all modified and new files
163
- - The commit message will be constructed based on the changes detected
164
- - Before committing, the command will review the diff to identify if multiple commits would be more appropriate
165
- - If suggesting multiple commits, it will help you stage and commit the changes separately
166
- - Always reviews the commit diff to ensure the message matches the changes
1
+ ---
2
+ allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*), Bash(git diff:*), Bash(git log:*)
3
+ argument-hint: [message] | --no-verify | --amend
4
+ description: Create well-formatted commits with conventional commit format and emoji
5
+ ---
6
+
7
+ # Smart Git Commit
8
+
9
+ Create well-formatted commit: $ARGUMENTS
10
+
11
+ ## Current Repository State
12
+
13
+ - Git status: !git status --porcelain
14
+ - Current branch: !git branch --show-current
15
+ - Staged changes: !git diff --cached --stat
16
+ - Unstaged changes: !git diff --stat
17
+ - Recent commits: !git log --oneline -5
18
+
19
+ ## What This Command Does
20
+
21
+ 1. Unless specified with --no-verify, automatically runs pre-commit checks:
22
+ - pnpm lint to ensure code quality
23
+ - pnpm build to verify the build succeeds
24
+ - pnpm generate:docs to update documentation
25
+ 2. Checks which files are staged with git status
26
+ 3. If 0 files are staged, automatically adds all modified and new files with git add
27
+ 4. Performs a git diff to understand what changes are being committed
28
+ 5. Analyzes the diff to determine if multiple distinct logical changes are present
29
+ 6. If multiple distinct changes are detected, suggests breaking the commit into multiple smaller commits
30
+ 7. For each commit (or the single commit if not split), creates a commit message using emoji conventional commit format
31
+
32
+ ## Best Practices for Commits
33
+
34
+ - **Verify before committing**: Ensure code is linted, builds correctly, and documentation is updated
35
+ - **Atomic commits**: Each commit should contain related changes that serve a single purpose
36
+ - **Split large changes**: If changes touch multiple concerns, split them into separate commits
37
+ - **Conventional commit format**: Use the format <type>: <description> where type is one of:
38
+ - feat: A new feature
39
+ - fix: A bug fix
40
+ - docs: Documentation changes
41
+ - style: Code style changes (formatting, etc)
42
+ - refactor: Code changes that neither fix bugs nor add features
43
+ - perf: Performance improvements
44
+ - test: Adding or fixing tests
45
+ - chore: Changes to the build process, tools, etc.
46
+ - **Present tense, imperative mood**: Write commit messages as commands (e.g., "add feature" not "added feature")
47
+ - **Concise first line**: Keep the first line under 72 characters
48
+ - **Emoji**: Each commit type is paired with an appropriate emoji:
49
+ - โœจ feat: New feature
50
+ - ๐Ÿ› fix: Bug fix
51
+ - ๐Ÿ“ docs: Documentation
52
+ - ๐Ÿ’„ style: Formatting/style
53
+ - โ™ป๏ธ refactor: Code refactoring
54
+ - โšก๏ธ perf: Performance improvements
55
+ - โœ… test: Tests
56
+ - ๐Ÿ”ง chore: Tooling, configuration
57
+ - ๐Ÿš€ ci: CI/CD improvements
58
+ - ๐Ÿ—‘๏ธ revert: Reverting changes
59
+ - ๐Ÿงช test: Add a failing test
60
+ - ๐Ÿšจ fix: Fix compiler/linter warnings
61
+ - ๐Ÿ”’๏ธ fix: Fix security issues
62
+ - ๐Ÿ‘ฅ chore: Add or update contributors
63
+ - ๐Ÿšš refactor: Move or rename resources
64
+ - ๐Ÿ—๏ธ refactor: Make architectural changes
65
+ - ๐Ÿ”€ chore: Merge branches
66
+ - ๐Ÿ“ฆ๏ธ chore: Add or update compiled files or packages
67
+ - โž• chore: Add a dependency
68
+ - โž– chore: Remove a dependency
69
+ - ๐ŸŒฑ chore: Add or update seed files
70
+ - ๐Ÿง‘โ€๐Ÿ’ป chore: Improve developer experience
71
+ - ๐Ÿงต feat: Add or update code related to multithreading or concurrency
72
+ - ๐Ÿ”๏ธ feat: Improve SEO
73
+ - ๐Ÿท๏ธ feat: Add or update types
74
+ - ๐Ÿ’ฌ feat: Add or update text and literals
75
+ - ๐ŸŒ feat: Internationalization and localization
76
+ - ๐Ÿ‘” feat: Add or update business logic
77
+ - ๐Ÿ“ฑ feat: Work on responsive design
78
+ - ๐Ÿšธ feat: Improve user experience / usability
79
+ - ๐Ÿฉน fix: Simple fix for a non-critical issue
80
+ - ๐Ÿฅ… fix: Catch errors
81
+ - ๐Ÿ‘ฝ๏ธ fix: Update code due to external API changes
82
+ - ๐Ÿ”ฅ fix: Remove code or files
83
+ - ๐ŸŽจ style: Improve structure/format of the code
84
+ - ๐Ÿš‘๏ธ fix: Critical hotfix
85
+ - ๐ŸŽ‰ chore: Begin a project
86
+ - ๐Ÿ”– chore: Release/Version tags
87
+ - ๐Ÿšง wip: Work in progress
88
+ - ๐Ÿ’š fix: Fix CI build
89
+ - ๐Ÿ“Œ chore: Pin dependencies to specific versions
90
+ - ๐Ÿ‘ท ci: Add or update CI build system
91
+ - ๐Ÿ“ˆ feat: Add or update analytics or tracking code
92
+ - โœ๏ธ fix: Fix typos
93
+ - โช๏ธ revert: Revert changes
94
+ - ๐Ÿ“„ chore: Add or update license
95
+ - ๐Ÿ’ฅ feat: Introduce breaking changes
96
+ - ๐Ÿฑ assets: Add or update assets
97
+ - โ™ฟ๏ธ feat: Improve accessibility
98
+ - ๐Ÿ’ก docs: Add or update comments in source code
99
+ - ๐Ÿ—ƒ๏ธ db: Perform database related changes
100
+ - ๐Ÿ”Š feat: Add or update logs
101
+ - ๐Ÿ”‡ fix: Remove logs
102
+ - ๐Ÿคก test: Mock things
103
+ - ๐Ÿฅš feat: Add or update an easter egg
104
+ - ๐Ÿ™ˆ chore: Add or update .gitignore file
105
+ - ๐Ÿ“ธ test: Add or update snapshots
106
+ - โš—๏ธ experiment: Perform experiments
107
+ - ๐Ÿšฉ feat: Add, update, or remove feature flags
108
+ - ๐Ÿ’ซ ui: Add or update animations and transitions
109
+ - โšฐ๏ธ refactor: Remove dead code
110
+ - ๐Ÿฆบ feat: Add or update code related to validation
111
+ - โœˆ๏ธ feat: Improve offline support
112
+
113
+ ## Guidelines for Splitting Commits
114
+
115
+ When analyzing the diff, consider splitting commits based on these criteria:
116
+
117
+ 1. **Different concerns**: Changes to unrelated parts of the codebase
118
+ 2. **Different types of changes**: Mixing features, fixes, refactoring, etc.
119
+ 3. **File patterns**: Changes to different types of files (e.g., source code vs documentation)
120
+ 4. **Logical grouping**: Changes that would be easier to understand or review separately
121
+ 5. **Size**: Very large changes that would be clearer if broken down
122
+
123
+ ## Examples
124
+
125
+ Good commit messages:
126
+ - โœจ feat: add user authentication system
127
+ - ๐Ÿ› fix: resolve memory leak in rendering process
128
+ - ๐Ÿ“ docs: update API documentation with new endpoints
129
+ - โ™ป๏ธ refactor: simplify error handling logic in parser
130
+ - ๐Ÿšจ fix: resolve linter warnings in component files
131
+ - ๐Ÿง‘โ€๐Ÿ’ป chore: improve developer tooling setup process
132
+ - ๐Ÿ‘” feat: implement business logic for transaction validation
133
+ - ๐Ÿฉน fix: address minor styling inconsistency in header
134
+ - ๐Ÿš‘๏ธ fix: patch critical security vulnerability in auth flow
135
+ - ๐ŸŽจ style: reorganize component structure for better readability
136
+ - ๐Ÿ”ฅ fix: remove deprecated legacy code
137
+ - ๐Ÿฆบ feat: add input validation for user registration form
138
+ - ๐Ÿ’š fix: resolve failing CI pipeline tests
139
+ - ๐Ÿ“ˆ feat: implement analytics tracking for user engagement
140
+ - ๐Ÿ”’๏ธ fix: strengthen authentication password requirements
141
+ - โ™ฟ๏ธ feat: improve form accessibility for screen readers
142
+
143
+ Example of splitting commits:
144
+ - First commit: โœจ feat: add new solc version type definitions
145
+ - Second commit: ๐Ÿ“ docs: update documentation for new solc versions
146
+ - Third commit: ๐Ÿ”ง chore: update package.json dependencies
147
+ - Fourth commit: ๐Ÿท๏ธ feat: add type definitions for new API endpoints
148
+ - Fifth commit: ๐Ÿงต feat: improve concurrency handling in worker threads
149
+ - Sixth commit: ๐Ÿšจ fix: resolve linting issues in new code
150
+ - Seventh commit: โœ… test: add unit tests for new solc version features
151
+ - Eighth commit: ๐Ÿ”’๏ธ fix: update dependencies with security vulnerabilities
152
+
153
+ ## Command Options
154
+
155
+ - --no-verify: Skip running the pre-commit checks (lint, build, generate:docs)
156
+
157
+ ## Important Notes
158
+
159
+ - By default, pre-commit checks (pnpm lint, pnpm build, pnpm generate:docs) will run to ensure code quality
160
+ - If these checks fail, you'll be asked if you want to proceed with the commit anyway or fix the issues first
161
+ - If specific files are already staged, the command will only commit those files
162
+ - If no files are staged, it will automatically stage all modified and new files
163
+ - The commit message will be constructed based on the changes detected
164
+ - Before committing, the command will review the diff to identify if multiple commits would be more appropriate
165
+ - If suggesting multiple commits, it will help you stage and commit the changes separately
166
+ - Always reviews the commit diff to ensure the message matches the changes