@polymorphism-tech/morph-spec 4.10.9 → 4.11.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 (145) hide show
  1. package/CLAUDE.md +3 -3
  2. package/LICENSE +71 -71
  3. package/README.md +5 -11
  4. package/bin/morph-spec.js +23 -1
  5. package/bin/task-manager.js +5 -5
  6. package/claude-plugin.json +1 -1
  7. package/docs/CHEATSHEET.md +1 -1
  8. package/docs/QUICKSTART.md +2 -8
  9. package/framework/agents/README.md +14 -14
  10. package/framework/agents/architecture/standards-architect.md +159 -159
  11. package/framework/agents/frontend/css-specialist.md +1 -1
  12. package/framework/agents/infrastructure/azure-architect.md +149 -149
  13. package/framework/agents/infrastructure/azure-deploy-specialist.md +4 -4
  14. package/framework/agents/infrastructure/infra-architect.md +48 -48
  15. package/framework/commands/morph-apply.md +18 -18
  16. package/framework/commands/morph-preflight.md +3 -3
  17. package/framework/commands/morph-proposal.md +15 -15
  18. package/framework/commands/morph-status.md +3 -3
  19. package/framework/commands/morph-troubleshoot.md +1 -1
  20. package/framework/hooks/README.md +204 -204
  21. package/framework/hooks/claude-code/pre-tool-use/task-tracking-guard.js +2 -2
  22. package/framework/hooks/claude-code/session-start/inject-morph-context.js +1 -1
  23. package/framework/hooks/claude-code/teammate-idle/teammate-idle.js +3 -3
  24. package/framework/hooks/claude-code/user-prompt/enrich-prompt.js +2 -2
  25. package/framework/hooks/git/pre-commit/agents.sh +1 -1
  26. package/framework/hooks/shared/phase-utils.js +139 -139
  27. package/framework/rules/csharp-standards.md +13 -13
  28. package/framework/rules/frontend-standards.md +13 -13
  29. package/framework/rules/infrastructure-standards.md +16 -16
  30. package/framework/rules/testing-standards.md +14 -14
  31. package/framework/skills/level-0-meta/morph-brainstorming/SKILL.md +8 -8
  32. package/framework/skills/level-0-meta/morph-checklist/SKILL.md +3 -3
  33. package/framework/skills/level-0-meta/morph-code-review-nextjs/references/review-example-nextjs.md +254 -254
  34. package/framework/skills/level-0-meta/morph-frontend-review/SKILL.md +1 -1
  35. package/framework/skills/level-0-meta/morph-init/SKILL.md +11 -11
  36. package/framework/skills/level-0-meta/morph-post-implementation/SKILL.md +3 -3
  37. package/framework/skills/level-0-meta/morph-replicate/SKILL.md +1 -1
  38. package/framework/skills/level-0-meta/morph-simulation-checklist/SKILL.md +4 -4
  39. package/framework/skills/level-0-meta/morph-tool-usage-guide/references/tools-per-phase.md +25 -25
  40. package/framework/skills/level-0-meta/morph-verification-before-completion/SKILL.md +8 -8
  41. package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md +7 -7
  42. package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md +4 -4
  43. package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +23 -23
  44. package/framework/skills/level-1-workflows/morph-phase-design/references/architecture-analysis-guide.md +1 -1
  45. package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json +38 -0
  46. package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md +29 -29
  47. package/framework/skills/level-1-workflows/morph-phase-implement/prompts/implementer-prompt.md +4 -4
  48. package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +9 -9
  49. package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md +17 -17
  50. package/framework/skills/level-1-workflows/morph-phase-tasks/.morph/logs/activity.json +14 -0
  51. package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md +12 -12
  52. package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md +16 -16
  53. package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +5 -5
  54. package/framework/standards/STANDARDS.json +2338 -2041
  55. package/framework/standards/frontend/nextjs/nextjs-patterns.md +17 -17
  56. package/framework/standards/infrastructure/supabase/supabase-custom-jwt.md +206 -0
  57. package/framework/templates/.idea/morph-templates.xml +92 -0
  58. package/framework/templates/.vscode/morph-templates.code-snippets +186 -0
  59. package/framework/templates/README.md +814 -814
  60. package/framework/templates/code/dotnet/contracts/Commands.cs +74 -74
  61. package/framework/templates/code/dotnet/contracts/Entities.cs +25 -25
  62. package/framework/templates/code/dotnet/contracts/Queries.cs +74 -74
  63. package/framework/templates/code/dotnet/contracts/README.md +74 -74
  64. package/framework/templates/code/dotnet/contracts/api-contracts.cs +173 -173
  65. package/framework/templates/code/dotnet/frontend/component.razor +239 -239
  66. package/framework/templates/code/dotnet/jobs/agent.cs +163 -163
  67. package/framework/templates/code/dotnet/jobs/job.cs +171 -171
  68. package/framework/templates/code/dotnet/test.cs +239 -239
  69. package/framework/templates/code/sql/rls-policy.sql +57 -57
  70. package/framework/templates/code/sql/supabase-migration.sql +100 -100
  71. package/framework/templates/code/sql/supabase-migration.template.sql +113 -113
  72. package/framework/templates/code/typescript/contracts.ts +168 -168
  73. package/framework/templates/context/CONTEXT.md +181 -181
  74. package/framework/templates/docs/proposal.md +182 -182
  75. package/framework/templates/docs/user-stories.md +34 -34
  76. package/framework/templates/examples/design-system-examples.md +357 -357
  77. package/framework/templates/examples/spec-examples.md +90 -90
  78. package/framework/templates/feature/decisions.md +187 -187
  79. package/framework/templates/feature/recap.md +146 -146
  80. package/framework/templates/feature/tasks.md +199 -199
  81. package/framework/templates/infrastructure/azure/README.md +286 -286
  82. package/framework/templates/infrastructure/azure/deploy-checklist.md +426 -426
  83. package/framework/templates/infrastructure/azure/parameters.dev.json +29 -29
  84. package/framework/templates/infrastructure/azure/parameters.prod.json +29 -29
  85. package/framework/templates/infrastructure/azure/parameters.staging.json +29 -29
  86. package/framework/templates/infrastructure/docker/docker-compose.template.yml +67 -67
  87. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  88. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  89. package/framework/templates/infrastructure/docker/easypanel.template.json +54 -54
  90. package/framework/workflows/README.md +18 -18
  91. package/framework/workflows/docs/enforcement-pipeline.md +1 -1
  92. package/framework/workflows/docs/full-morph.md +2 -2
  93. package/package.json +1 -1
  94. package/src/commands/agents/dispatch-agents.js +17 -0
  95. package/src/commands/agents/index.js +13 -13
  96. package/src/commands/agents/project-metrics.js +74 -0
  97. package/src/commands/project/doctor.js +3 -4
  98. package/src/commands/project/install-plugin-cmd.js +28 -28
  99. package/src/commands/project/setup-infra-cmd.js +12 -12
  100. package/src/commands/project/status.js +8 -1
  101. package/src/commands/scope/escalate.js +5 -3
  102. package/src/commands/standards/context-budget.js +89 -0
  103. package/src/commands/tasks/index.js +4 -4
  104. package/src/commands/templates/index.js +5 -5
  105. package/src/commands/utils/index.js +3 -3
  106. package/src/commands/validation/index.js +4 -4
  107. package/src/commands/validation/validate-feature.js +32 -3
  108. package/src/core/state/phase-state-machine.js +217 -217
  109. package/src/lib/agents/metrics-aggregator.js +56 -0
  110. package/src/lib/generators/design-system-generator.js +298 -298
  111. package/src/lib/generators/index.js +10 -10
  112. package/src/lib/generators/metadata-extractor.js +387 -387
  113. package/src/lib/stack-filter.js +65 -65
  114. package/src/lib/standards/digest-builder.js +57 -3
  115. package/src/lib/standards/index.js +7 -7
  116. package/src/lib/standards/standards-context-injector.js +302 -302
  117. package/src/lib/validators/architecture/architecture-validator.js +387 -387
  118. package/src/lib/validators/architecture/index.js +7 -7
  119. package/src/lib/validators/blazor/blazor-concurrency-analyzer.js +316 -316
  120. package/src/lib/validators/blazor/blazor-state-validator.js +279 -279
  121. package/src/lib/validators/blazor/blazor-validator.js +369 -369
  122. package/src/lib/validators/blazor/index.js +9 -9
  123. package/src/lib/validators/content/content-validator.js +287 -287
  124. package/src/lib/validators/content/index.js +7 -7
  125. package/src/lib/validators/contracts/index.js +7 -7
  126. package/src/lib/validators/css/css-validator.js +352 -352
  127. package/src/lib/validators/css/index.js +7 -7
  128. package/src/lib/validators/design-system/design-system-validator.js +231 -231
  129. package/src/lib/validators/design-system/index.js +7 -7
  130. package/src/lib/validators/nextjs/index.js +6 -6
  131. package/src/lib/validators/nextjs/next-component-validator.js +183 -183
  132. package/src/lib/validators/packages/index.js +7 -7
  133. package/src/lib/validators/packages/package-validator.js +360 -360
  134. package/src/lib/validators/shared/index.js +12 -12
  135. package/src/lib/validators/shared/issue-counter.js +18 -18
  136. package/src/lib/validators/shared/result-formatter.js +124 -124
  137. package/src/lib/validators/ui/index.js +7 -7
  138. package/src/lib/validators/ui/ui-contrast-validator.js +422 -422
  139. package/src/scripts/global-install.js +112 -58
  140. package/src/scripts/install-plugin.js +126 -126
  141. package/src/utils/claude-md-injector.js +90 -90
  142. package/src/utils/file-copier.js +200 -200
  143. package/src/utils/logger.js +32 -32
  144. package/src/utils/skills-installer.js +178 -178
  145. package/src/utils/version-checker.js +169 -175
@@ -1,182 +1,182 @@
1
- # Feature Proposal: {{titleCase FEATURE_NAME}}
2
-
3
- > Proposal for a new feature. This document describes WHAT and WHY.
4
- > For technical details, see `spec.md`.
5
-
6
- ## Metadata
7
-
8
- | Field | Value |
9
- |-------|-------|
10
- | **Proposed** | {{DATE}} |
11
- | **Author** | {{AUTHOR}} |
12
- | **Status** | Draft / Under Review / Approved / Rejected |
13
- | **Priority** | High / Medium / Low |
14
- {{#if STACK}}| **Stack** | {{STACK}} |{{/if}}
15
-
16
- ---
17
-
18
- ## Overview
19
-
20
- {Brief 2-3 sentence summary of the feature}
21
-
22
- ---
23
-
24
- ## Problem Statement
25
-
26
- ### What is the problem?
27
-
28
- {Describe the problem this feature solves. Be specific.}
29
-
30
- ### Who is affected?
31
-
32
- {Who suffers from this problem? End users? Developers? Operations?}
33
-
34
- ### What is the impact?
35
-
36
- {What is the impact of NOT solving this problem?}
37
- - User productivity loss: {X}
38
- - Revenue/Cost impact: {X}
39
- - User satisfaction: {X}
40
-
41
- ---
42
-
43
- ## Proposed Solution
44
-
45
- ### Overview
46
-
47
- {Describe the proposed solution in 2-3 paragraphs}
48
-
49
- ### Key Features
50
-
51
- 1. **{Feature 1}** - {brief description}
52
- 2. **{Feature 2}** - {brief description}
53
- 3. **{Feature 3}** - {brief description}
54
-
55
- {{#if (eq STACK "nextjs-supabase")}}
56
- ### Technical Approach
57
-
58
- | Layer | Technology | Role |
59
- |-------|-----------|------|
60
- | **Database** | Supabase (PostgreSQL + RLS) | {tables, policies, storage} |
61
- | **Backend API** | .NET 10 Minimal API | {endpoints, business logic} |
62
- | **Frontend** | Next.js 15 (App Router) | {pages, components, auth} |
63
- | **Infra** | EasyPanel + Docker | {deployment, SSL} |
64
- {{/if}}
65
-
66
- ### User Journey
67
-
68
- ```
69
- 1. User {initial action}
70
- 2. System {response}
71
- 3. User {next action}
72
- 4. System {final result}
73
- ```
74
-
75
- ---
76
-
77
- {{#if (eq STACK "nextjs-supabase")}}
78
- ## Cost Estimate
79
-
80
- | Resource | Provider | Monthly Cost | Notes |
81
- |----------|----------|-------------|-------|
82
- | Supabase | Free / Pro | $0 - $25 | {DB, Auth, Storage, Realtime} |
83
- | VPS (EasyPanel) | {provider} | ${X} | {API + Web containers} |
84
- | External APIs | {provider} | ${X} | {if applicable} |
85
- | **Total** | | **${X}/month** | |
86
-
87
- ---
88
-
89
- {{/if}}
90
- ## Success Metrics
91
-
92
- How will we know this feature is successful?
93
-
94
- | Metric | Current | Target |
95
- |--------|---------|--------|
96
- | {Metric 1} | {X} | {Y} |
97
- | {Metric 2} | {X} | {Y} |
98
-
99
- ---
100
-
101
- ## Scope
102
-
103
- ### In Scope
104
-
105
- - {Item 1 that is included}
106
- - {Item 2 that is included}
107
- - {Item 3 that is included}
108
-
109
- ### Out of Scope
110
-
111
- - {Item 1 that is NOT included}
112
- - {Item 2 that is NOT included}
113
-
114
- ### Future Considerations
115
-
116
- - {Item that could be added later}
117
-
118
- ---
119
-
120
- ## Risks & Concerns
121
-
122
- | Risk | Likelihood | Impact | Mitigation |
123
- |------|------------|--------|------------|
124
- | {Risk 1} | High/Med/Low | High/Med/Low | {mitigation strategy} |
125
- | {Risk 2} | High/Med/Low | High/Med/Low | {mitigation strategy} |
126
-
127
- ---
128
-
129
- ## Dependencies
130
-
131
- - [ ] {Dependency 1} - {status}
132
- - [ ] {Dependency 2} - {status}
133
-
134
- ---
135
-
136
- ## Estimated Effort
137
-
138
- | Phase | Estimate |
139
- |-------|----------|
140
- | Design & Spec | {X}h |
141
- {{#if (eq STACK "nextjs-supabase")}}| Database & Migrations | {X}h |
142
- | Backend API | {X}h |
143
- | Frontend | {X}h |
144
- {{else}}| Implementation | {X}h |
145
- {{/if}}| Testing | {X}h |
146
- | **Total** | **{X}h** |
147
-
148
- ---
149
-
150
- ## Questions & Clarifications
151
-
152
- 1. {Question 1 that needs answering}
153
- 2. {Question 2 that needs answering}
154
-
155
- ---
156
-
157
- {{#if (eq STACK "blazor-azure")}}
158
- ## Approval
159
-
160
- | Role | Name | Decision | Date |
161
- |------|------|----------|------|
162
- | Product Owner | | Pending | |
163
- | Tech Lead | | Pending | |
164
-
165
- ---
166
-
167
- {{/if}}
168
- ## Next Steps
169
-
170
- Once approved:
171
- 1. Create detailed `spec.md` with technical design
172
- {{#if (eq STACK "nextjs-supabase")}}2. Define contracts (`contracts.cs` + `contracts.ts`)
173
- 3. Record decisions in `decisions.md`
174
- 4. Break down into `tasks.md`
175
- 5. Begin implementation
176
- {{else}}2. Break down into `tasks.md`
177
- 3. Begin implementation
178
- {{/if}}
179
-
180
- ---
181
-
182
- *Created with MORPH Framework*
1
+ # Feature Proposal: {{titleCase FEATURE_NAME}}
2
+
3
+ > Proposal for a new feature. This document describes WHAT and WHY.
4
+ > For technical details, see `spec.md`.
5
+
6
+ ## Metadata
7
+
8
+ | Field | Value |
9
+ |-------|-------|
10
+ | **Proposed** | {{DATE}} |
11
+ | **Author** | {{AUTHOR}} |
12
+ | **Status** | Draft / Under Review / Approved / Rejected |
13
+ | **Priority** | High / Medium / Low |
14
+ {{#if STACK}}| **Stack** | {{STACK}} |{{/if}}
15
+
16
+ ---
17
+
18
+ ## Overview
19
+
20
+ {Brief 2-3 sentence summary of the feature}
21
+
22
+ ---
23
+
24
+ ## Problem Statement
25
+
26
+ ### What is the problem?
27
+
28
+ {Describe the problem this feature solves. Be specific.}
29
+
30
+ ### Who is affected?
31
+
32
+ {Who suffers from this problem? End users? Developers? Operations?}
33
+
34
+ ### What is the impact?
35
+
36
+ {What is the impact of NOT solving this problem?}
37
+ - User productivity loss: {X}
38
+ - Revenue/Cost impact: {X}
39
+ - User satisfaction: {X}
40
+
41
+ ---
42
+
43
+ ## Proposed Solution
44
+
45
+ ### Overview
46
+
47
+ {Describe the proposed solution in 2-3 paragraphs}
48
+
49
+ ### Key Features
50
+
51
+ 1. **{Feature 1}** - {brief description}
52
+ 2. **{Feature 2}** - {brief description}
53
+ 3. **{Feature 3}** - {brief description}
54
+
55
+ {{#if (eq STACK "nextjs-supabase")}}
56
+ ### Technical Approach
57
+
58
+ | Layer | Technology | Role |
59
+ |-------|-----------|------|
60
+ | **Database** | Supabase (PostgreSQL + RLS) | {tables, policies, storage} |
61
+ | **Backend API** | .NET 10 Minimal API | {endpoints, business logic} |
62
+ | **Frontend** | Next.js 15 (App Router) | {pages, components, auth} |
63
+ | **Infra** | EasyPanel + Docker | {deployment, SSL} |
64
+ {{/if}}
65
+
66
+ ### User Journey
67
+
68
+ ```
69
+ 1. User {initial action}
70
+ 2. System {response}
71
+ 3. User {next action}
72
+ 4. System {final result}
73
+ ```
74
+
75
+ ---
76
+
77
+ {{#if (eq STACK "nextjs-supabase")}}
78
+ ## Cost Estimate
79
+
80
+ | Resource | Provider | Monthly Cost | Notes |
81
+ |----------|----------|-------------|-------|
82
+ | Supabase | Free / Pro | $0 - $25 | {DB, Auth, Storage, Realtime} |
83
+ | VPS (EasyPanel) | {provider} | ${X} | {API + Web containers} |
84
+ | External APIs | {provider} | ${X} | {if applicable} |
85
+ | **Total** | | **${X}/month** | |
86
+
87
+ ---
88
+
89
+ {{/if}}
90
+ ## Success Metrics
91
+
92
+ How will we know this feature is successful?
93
+
94
+ | Metric | Current | Target |
95
+ |--------|---------|--------|
96
+ | {Metric 1} | {X} | {Y} |
97
+ | {Metric 2} | {X} | {Y} |
98
+
99
+ ---
100
+
101
+ ## Scope
102
+
103
+ ### In Scope
104
+
105
+ - {Item 1 that is included}
106
+ - {Item 2 that is included}
107
+ - {Item 3 that is included}
108
+
109
+ ### Out of Scope
110
+
111
+ - {Item 1 that is NOT included}
112
+ - {Item 2 that is NOT included}
113
+
114
+ ### Future Considerations
115
+
116
+ - {Item that could be added later}
117
+
118
+ ---
119
+
120
+ ## Risks & Concerns
121
+
122
+ | Risk | Likelihood | Impact | Mitigation |
123
+ |------|------------|--------|------------|
124
+ | {Risk 1} | High/Med/Low | High/Med/Low | {mitigation strategy} |
125
+ | {Risk 2} | High/Med/Low | High/Med/Low | {mitigation strategy} |
126
+
127
+ ---
128
+
129
+ ## Dependencies
130
+
131
+ - [ ] {Dependency 1} - {status}
132
+ - [ ] {Dependency 2} - {status}
133
+
134
+ ---
135
+
136
+ ## Estimated Effort
137
+
138
+ | Phase | Estimate |
139
+ |-------|----------|
140
+ | Design & Spec | {X}h |
141
+ {{#if (eq STACK "nextjs-supabase")}}| Database & Migrations | {X}h |
142
+ | Backend API | {X}h |
143
+ | Frontend | {X}h |
144
+ {{else}}| Implementation | {X}h |
145
+ {{/if}}| Testing | {X}h |
146
+ | **Total** | **{X}h** |
147
+
148
+ ---
149
+
150
+ ## Questions & Clarifications
151
+
152
+ 1. {Question 1 that needs answering}
153
+ 2. {Question 2 that needs answering}
154
+
155
+ ---
156
+
157
+ {{#if (eq STACK "blazor-azure")}}
158
+ ## Approval
159
+
160
+ | Role | Name | Decision | Date |
161
+ |------|------|----------|------|
162
+ | Product Owner | | Pending | |
163
+ | Tech Lead | | Pending | |
164
+
165
+ ---
166
+
167
+ {{/if}}
168
+ ## Next Steps
169
+
170
+ Once approved:
171
+ 1. Create detailed `spec.md` with technical design
172
+ {{#if (eq STACK "nextjs-supabase")}}2. Define contracts (`contracts.cs` + `contracts.ts`)
173
+ 3. Record decisions in `decisions.md`
174
+ 4. Break down into `tasks.md`
175
+ 5. Begin implementation
176
+ {{else}}2. Break down into `tasks.md`
177
+ 3. Begin implementation
178
+ {{/if}}
179
+
180
+ ---
181
+
182
+ *Created with MORPH Framework*
@@ -1,34 +1,34 @@
1
- # User Stories: {{featureName}}
2
-
3
- > Generated: {{date}} | Feature: {{featureName}} | Status: Draft
4
-
5
- ---
6
-
7
- ## Story 1: [Actor] [Action]
8
-
9
- **Feature:** {{featureName}}
10
- **Priority:** High / Medium / Low
11
-
12
- ### Optimal Path
13
- 1. [Step 1]
14
- 2. [Step 2]
15
- 3. [Step 3 — success state]
16
-
17
- ### Edge Cases
18
- - [Edge case] → [Expected behavior]
19
- - [Error condition] → [Expected error handling]
20
-
21
- ### Acceptance Criteria
22
- - [ ] [Measurable criterion 1]
23
- - [ ] [Measurable criterion 2]
24
- - [ ] Edge: [edge case criterion]
25
-
26
- ---
27
-
28
- ## Story 2: [Actor] [Action]
29
-
30
- [Repeat structure above]
31
-
32
- ---
33
-
34
- *Generated by MORPH-SPEC — complete before implementation begins*
1
+ # User Stories: {{featureName}}
2
+
3
+ > Generated: {{date}} | Feature: {{featureName}} | Status: Draft
4
+
5
+ ---
6
+
7
+ ## Story 1: [Actor] [Action]
8
+
9
+ **Feature:** {{featureName}}
10
+ **Priority:** High / Medium / Low
11
+
12
+ ### Optimal Path
13
+ 1. [Step 1]
14
+ 2. [Step 2]
15
+ 3. [Step 3 — success state]
16
+
17
+ ### Edge Cases
18
+ - [Edge case] → [Expected behavior]
19
+ - [Error condition] → [Expected error handling]
20
+
21
+ ### Acceptance Criteria
22
+ - [ ] [Measurable criterion 1]
23
+ - [ ] [Measurable criterion 2]
24
+ - [ ] Edge: [edge case criterion]
25
+
26
+ ---
27
+
28
+ ## Story 2: [Actor] [Action]
29
+
30
+ [Repeat structure above]
31
+
32
+ ---
33
+
34
+ *Generated by MORPH-SPEC — complete before implementation begins*