@polymorphism-tech/morph-spec 8.1.0 โ†’ 8.1.2

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 (165) 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/commands/commit.md +166 -166
  7. package/framework/commands/morph-infra.md +215 -215
  8. package/framework/commands/morph-preflight.md +205 -205
  9. package/framework/commands/morph-troubleshoot.md +124 -124
  10. package/framework/hooks/claude-code/core/validate-completion.js +2 -1
  11. package/framework/hooks/claude-code/statusline.py +679 -679
  12. package/framework/hooks/claude-code/statusline.sh +11 -11
  13. package/framework/hooks/git/commit-msg/conventional-commits.sh +33 -33
  14. package/framework/hooks/git/pre-commit/agents.sh +25 -25
  15. package/framework/hooks/git/pre-commit/orchestrator.sh +64 -64
  16. package/framework/hooks/git/pre-commit/specs.sh +50 -50
  17. package/framework/hooks/git/pre-push/run-tests.sh +44 -44
  18. package/framework/hooks/shared/activity-logger.js +160 -160
  19. package/framework/hooks/shared/build-check.js +97 -24
  20. package/framework/hooks/shared/stdin-reader.js +26 -26
  21. package/framework/rubrics/backend.json +41 -41
  22. package/framework/rules/ai-agents-standards.md +45 -45
  23. package/framework/rules/dotnet-templates.md +86 -86
  24. package/framework/rules/frontend-standards.md +13 -13
  25. package/framework/rules/infrastructure-standards.md +27 -27
  26. package/framework/rules/neon-standards.md +25 -25
  27. package/framework/rules/nextjs-standards.md +20 -20
  28. package/framework/rules/nextjs-templates.md +40 -40
  29. package/framework/skills/core/create-umbraco-lp/SKILL.md +1 -1
  30. package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md +1 -1
  31. package/framework/skills/core/morph-apply/SKILL.md +1 -1
  32. package/framework/skills/core/morph-brainstorming/SKILL.md +1 -1
  33. package/framework/skills/core/morph-eval/SKILL.md +1 -1
  34. package/framework/skills/core/morph-hotfix/SKILL.md +1 -1
  35. package/framework/skills/core/morph-implement/SKILL.md +1 -1
  36. package/framework/skills/core/morph-plan/SKILL.md +1 -1
  37. package/framework/skills/core/morph-proposal/SKILL.md +1 -1
  38. package/framework/skills/core/morph-review/SKILL.md +1 -1
  39. package/framework/skills/core/morph-stack-scan/SKILL.md +1 -1
  40. package/framework/skills/core/morph-standards/SKILL.md +1 -1
  41. package/framework/standards/ai-agents/agent-session.md +160 -160
  42. package/framework/standards/ai-agents/batching.md +193 -193
  43. package/framework/standards/ai-agents/context-providers.md +188 -188
  44. package/framework/standards/ai-agents/mcp-server.md +250 -250
  45. package/framework/standards/ai-agents/mcp-tools.md +197 -197
  46. package/framework/standards/ai-agents/middleware-patterns.md +207 -207
  47. package/framework/standards/ai-agents/modalities-image-gen.md +173 -173
  48. package/framework/standards/ai-agents/modalities-speech-to-text.md +171 -171
  49. package/framework/standards/ai-agents/modalities-text-to-speech.md +181 -181
  50. package/framework/standards/ai-agents/modalities-vision.md +201 -201
  51. package/framework/standards/ai-agents/multi-agent-patterns.md +155 -155
  52. package/framework/standards/ai-agents/production.md +275 -275
  53. package/framework/standards/ai-agents/prompts-in-db.md +214 -214
  54. package/framework/standards/ai-agents/providers/model-registry.md +158 -158
  55. package/framework/standards/ai-agents/service-tier-flex.md +135 -135
  56. package/framework/standards/ai-agents/structured-output.md +249 -249
  57. package/framework/standards/ai-agents/sweet-spot.md +109 -109
  58. package/framework/templates/IDE-SNIPPETS.md +262 -262
  59. package/framework/templates/code/dotnet/abstractions/api-endpoint.cs +7 -7
  60. package/framework/templates/code/dotnet/ai-agents/AgentBootstrap.cs.template +39 -39
  61. package/framework/templates/code/dotnet/ai-agents/EmbeddingService.cs.template +68 -68
  62. package/framework/templates/code/dotnet/ai-agents/ModelRegistry.cs.template +117 -117
  63. package/framework/templates/code/dotnet/ai-agents/PromptRepository.cs.template +95 -95
  64. package/framework/templates/code/dotnet/ai-agents/ResilientToolMiddleware.cs.template +61 -61
  65. package/framework/templates/code/dotnet/ai-agents/VectorSearchTool.cs.template +107 -107
  66. package/framework/templates/code/dotnet/ai-agents/model-registry.json.template +58 -58
  67. package/framework/templates/code/dotnet/contracts/contracts-vsa.cs +281 -281
  68. package/framework/templates/code/dotnet/database/migration.cs +83 -83
  69. package/framework/templates/code/dotnet/feature/endpoint.cs.hbs +21 -21
  70. package/framework/templates/code/dotnet/feature/request.cs.hbs +4 -4
  71. package/framework/templates/code/dotnet/feature/response.cs.hbs +4 -4
  72. package/framework/templates/code/dotnet/feature/validator.cs.hbs +15 -15
  73. package/framework/templates/code/sql/ai-agents/agent-prompts-migration.sql.template +58 -58
  74. package/framework/templates/code/sql/ai-agents/pgvector-embeddings-migration.sql.template +91 -91
  75. package/framework/templates/code/typescript/contracts.ts +167 -167
  76. package/framework/templates/docs/clarifications.md +253 -253
  77. package/framework/templates/docs/schema-analysis.md +119 -119
  78. package/framework/templates/docs/ui-components.md +52 -52
  79. package/framework/templates/docs/ui-design-system.md +76 -76
  80. package/framework/templates/docs/ui-flows.md +167 -167
  81. package/framework/templates/docs/ui-mockups.md +98 -98
  82. package/framework/templates/feature/decisions.md +122 -122
  83. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -43
  84. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -26
  85. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -32
  86. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -56
  87. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -22
  88. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -26
  89. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -54
  90. package/framework/templates/infrastructure/docker/Dockerfile.template +58 -58
  91. package/framework/templates/infrastructure/docker/docker-compose.template.yml +50 -50
  92. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  93. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  94. package/framework/templates/infrastructure/github/README.md +56 -56
  95. package/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -45
  96. package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -27
  97. package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -59
  98. package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -39
  99. package/framework/templates/integrations/asaas-client.cs +387 -387
  100. package/framework/templates/integrations/asaas-webhook.cs +351 -351
  101. package/framework/templates/meta-prompts/fusion/fusion-agent.md +76 -76
  102. package/framework/templates/meta-prompts/fusion/fusion-aggregator.md +100 -100
  103. package/framework/templates/meta-prompts/validators/pre-commit-validator.md +95 -95
  104. package/framework/templates/project/validate.js +120 -120
  105. package/framework/templates/state.template.json +17 -17
  106. package/framework/templates/ui/design-system.css +226 -226
  107. package/package.json +1 -1
  108. package/src/commands/dashboard/dashboard.js +53 -53
  109. package/src/commands/index.js +13 -13
  110. package/src/commands/mcp/mcp-setup.js +519 -519
  111. package/src/commands/project/checkpoint.js +209 -209
  112. package/src/commands/project/worktree.js +83 -1
  113. package/src/core/state/phase-state-machine.js +197 -197
  114. package/src/core/templates/template-renderer.js +477 -477
  115. package/src/dashboard/app/components/DetailPanel.jsx +11 -11
  116. package/src/dashboard/app/components/FlowGraph.jsx +17 -17
  117. package/src/dashboard/app/components/SearchFilter.jsx +22 -22
  118. package/src/dashboard/app/hooks/useDetailPanel.js +15 -15
  119. package/src/dashboard/app/main.jsx +13 -13
  120. package/src/dashboard/app/pages/AgentMap.jsx +370 -370
  121. package/src/dashboard/app/pages/HookInspector.jsx +418 -418
  122. package/src/dashboard/app/pages/PhasePipeline.jsx +408 -408
  123. package/src/dashboard/app/pages/RulesMap.jsx +273 -273
  124. package/src/dashboard/app/pages/SkillsLibrary.jsx +366 -366
  125. package/src/dashboard/app/pages/Standards.jsx +332 -332
  126. package/src/dashboard/app/styles/index.css +47 -47
  127. package/src/dashboard/index.html +12 -12
  128. package/src/dashboard/package.json +24 -24
  129. package/src/dashboard/scanner/hooks-scanner.js +41 -41
  130. package/src/dashboard/scanner/phases-scanner.js +15 -15
  131. package/src/dashboard/scanner/rubrics-scanner.js +12 -12
  132. package/src/dashboard/scanner/rules-scanner.js +37 -37
  133. package/src/dashboard/scanner/skills-scanner.js +43 -43
  134. package/src/dashboard/scanner/squads-scanner.js +13 -13
  135. package/src/dashboard/scanner/standards-scanner.js +26 -26
  136. package/src/dashboard/vite-plugin-morph-data.js +17 -17
  137. package/src/dashboard/vite.config.js +24 -24
  138. package/src/lib/agents/metrics-aggregator.js +56 -56
  139. package/src/lib/agents/metrics-calculator.js +125 -125
  140. package/src/lib/agents/output-collector.js +73 -73
  141. package/src/lib/detectors/claude-config-detector.js +152 -152
  142. package/src/lib/detectors/design-system-detector.js +231 -231
  143. package/src/lib/detectors/index.js +217 -217
  144. package/src/lib/generators/architecture-scanner.js +639 -639
  145. package/src/lib/generators/design-system-generator.js +508 -508
  146. package/src/lib/generators/index.js +13 -13
  147. package/src/lib/generators/settings-generator.js +209 -209
  148. package/src/lib/hooks/hook-executor.js +167 -167
  149. package/src/lib/installers/mcp-installer.js +719 -719
  150. package/src/lib/tasks/task-classifier.js +30 -30
  151. package/src/lib/tasks/task-parser.js +209 -209
  152. package/src/lib/validators/architecture/architecture-validator.js +259 -259
  153. package/src/lib/validators/checkpoint-persistence.js +39 -39
  154. package/src/lib/validators/contracts/contract-compliance-validator.js +274 -274
  155. package/src/lib/validators/css/css-validator.js +340 -340
  156. package/src/lib/validators/packages/package-validator.js +347 -347
  157. package/src/lib/validators/shared/emit-validator-dispatch.js +14 -14
  158. package/src/lib/validators/shared/issue-counter.js +14 -14
  159. package/src/lib/validators/validation-runner.js +349 -349
  160. package/src/lib/validators/verify-runner.js +24 -7
  161. package/src/utils/agent-id-mapper.js +11 -11
  162. package/src/utils/claude-settings-manager.js +300 -300
  163. package/src/utils/skills-installer.js +174 -174
  164. package/framework/templates/.idea/morph-templates.xml +0 -92
  165. package/framework/templates/.vscode/morph-templates.code-snippets +0 -186
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "morph-spec",
3
- "version": "8.1.0",
3
+ "version": "8.1.2",
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",
@@ -237,4 +237,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
237
237
 
238
238
  ---
239
239
 
240
- *morph-spec v8.1.0 by Polymorphism Tech*
240
+ *morph-spec v8.1.2 by Polymorphism Tech*
@@ -256,4 +256,4 @@ morph-spec doctor
256
256
 
257
257
  ---
258
258
 
259
- *morph-spec v8.1.0 by Polymorphism Tech*
259
+ *morph-spec v8.1.2 by Polymorphism Tech*
@@ -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