@polymorphism-tech/morph-spec 4.10.9 → 4.10.10

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 (114) hide show
  1. package/CLAUDE.md +3 -3
  2. package/LICENSE +71 -71
  3. package/README.md +2 -2
  4. package/bin/morph-spec.js +22 -0
  5. package/claude-plugin.json +1 -1
  6. package/docs/CHEATSHEET.md +1 -1
  7. package/docs/QUICKSTART.md +1 -1
  8. package/framework/agents/README.md +14 -14
  9. package/framework/agents/architecture/standards-architect.md +159 -159
  10. package/framework/agents/infrastructure/azure-architect.md +149 -149
  11. package/framework/agents/infrastructure/infra-architect.md +48 -48
  12. package/framework/hooks/README.md +204 -204
  13. package/framework/hooks/shared/phase-utils.js +139 -139
  14. package/framework/rules/csharp-standards.md +13 -13
  15. package/framework/rules/frontend-standards.md +13 -13
  16. package/framework/rules/infrastructure-standards.md +16 -16
  17. package/framework/rules/testing-standards.md +14 -14
  18. package/framework/skills/level-0-meta/morph-code-review-nextjs/references/review-example-nextjs.md +254 -254
  19. package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md +1 -1
  20. package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md +1 -1
  21. package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +1 -1
  22. package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json +38 -0
  23. package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md +1 -1
  24. package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +1 -1
  25. package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md +1 -1
  26. package/framework/skills/level-1-workflows/morph-phase-tasks/.morph/logs/activity.json +14 -0
  27. package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md +1 -1
  28. package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md +1 -1
  29. package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +1 -1
  30. package/framework/standards/STANDARDS.json +2338 -2041
  31. package/framework/standards/frontend/nextjs/nextjs-patterns.md +17 -17
  32. package/framework/standards/infrastructure/supabase/supabase-custom-jwt.md +206 -0
  33. package/framework/templates/.idea/morph-templates.xml +92 -0
  34. package/framework/templates/.vscode/morph-templates.code-snippets +186 -0
  35. package/framework/templates/README.md +814 -814
  36. package/framework/templates/code/dotnet/contracts/Commands.cs +74 -74
  37. package/framework/templates/code/dotnet/contracts/Entities.cs +25 -25
  38. package/framework/templates/code/dotnet/contracts/Queries.cs +74 -74
  39. package/framework/templates/code/dotnet/contracts/README.md +74 -74
  40. package/framework/templates/code/dotnet/contracts/api-contracts.cs +173 -173
  41. package/framework/templates/code/dotnet/frontend/component.razor +239 -239
  42. package/framework/templates/code/dotnet/jobs/agent.cs +163 -163
  43. package/framework/templates/code/dotnet/jobs/job.cs +171 -171
  44. package/framework/templates/code/dotnet/test.cs +239 -239
  45. package/framework/templates/code/sql/rls-policy.sql +57 -57
  46. package/framework/templates/code/sql/supabase-migration.sql +100 -100
  47. package/framework/templates/code/sql/supabase-migration.template.sql +113 -113
  48. package/framework/templates/code/typescript/contracts.ts +168 -168
  49. package/framework/templates/context/CONTEXT.md +181 -181
  50. package/framework/templates/docs/proposal.md +182 -182
  51. package/framework/templates/docs/user-stories.md +34 -34
  52. package/framework/templates/examples/design-system-examples.md +357 -357
  53. package/framework/templates/examples/spec-examples.md +90 -90
  54. package/framework/templates/feature/decisions.md +187 -187
  55. package/framework/templates/feature/recap.md +146 -146
  56. package/framework/templates/feature/tasks.md +199 -199
  57. package/framework/templates/infrastructure/azure/README.md +286 -286
  58. package/framework/templates/infrastructure/azure/deploy-checklist.md +426 -426
  59. package/framework/templates/infrastructure/azure/parameters.dev.json +29 -29
  60. package/framework/templates/infrastructure/azure/parameters.prod.json +29 -29
  61. package/framework/templates/infrastructure/azure/parameters.staging.json +29 -29
  62. package/framework/templates/infrastructure/docker/docker-compose.template.yml +67 -67
  63. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  64. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  65. package/framework/templates/infrastructure/docker/easypanel.template.json +54 -54
  66. package/package.json +1 -1
  67. package/src/commands/agents/dispatch-agents.js +17 -0
  68. package/src/commands/agents/index.js +13 -13
  69. package/src/commands/agents/project-metrics.js +74 -0
  70. package/src/commands/project/install-plugin-cmd.js +28 -28
  71. package/src/commands/project/setup-infra-cmd.js +12 -12
  72. package/src/commands/standards/context-budget.js +89 -0
  73. package/src/commands/tasks/index.js +4 -4
  74. package/src/commands/templates/index.js +5 -5
  75. package/src/commands/utils/index.js +3 -3
  76. package/src/commands/validation/index.js +4 -4
  77. package/src/core/state/phase-state-machine.js +217 -217
  78. package/src/lib/agents/metrics-aggregator.js +56 -0
  79. package/src/lib/generators/design-system-generator.js +298 -298
  80. package/src/lib/generators/index.js +10 -10
  81. package/src/lib/generators/metadata-extractor.js +387 -387
  82. package/src/lib/stack-filter.js +65 -65
  83. package/src/lib/standards/digest-builder.js +57 -3
  84. package/src/lib/standards/index.js +7 -7
  85. package/src/lib/standards/standards-context-injector.js +302 -302
  86. package/src/lib/validators/architecture/architecture-validator.js +387 -387
  87. package/src/lib/validators/architecture/index.js +7 -7
  88. package/src/lib/validators/blazor/blazor-concurrency-analyzer.js +316 -316
  89. package/src/lib/validators/blazor/blazor-state-validator.js +279 -279
  90. package/src/lib/validators/blazor/blazor-validator.js +369 -369
  91. package/src/lib/validators/blazor/index.js +9 -9
  92. package/src/lib/validators/content/content-validator.js +287 -287
  93. package/src/lib/validators/content/index.js +7 -7
  94. package/src/lib/validators/contracts/index.js +7 -7
  95. package/src/lib/validators/css/css-validator.js +352 -352
  96. package/src/lib/validators/css/index.js +7 -7
  97. package/src/lib/validators/design-system/design-system-validator.js +231 -231
  98. package/src/lib/validators/design-system/index.js +7 -7
  99. package/src/lib/validators/nextjs/index.js +6 -6
  100. package/src/lib/validators/nextjs/next-component-validator.js +183 -183
  101. package/src/lib/validators/packages/index.js +7 -7
  102. package/src/lib/validators/packages/package-validator.js +360 -360
  103. package/src/lib/validators/shared/index.js +12 -12
  104. package/src/lib/validators/shared/issue-counter.js +18 -18
  105. package/src/lib/validators/shared/result-formatter.js +124 -124
  106. package/src/lib/validators/ui/index.js +7 -7
  107. package/src/lib/validators/ui/ui-contrast-validator.js +422 -422
  108. package/src/scripts/global-install.js +58 -58
  109. package/src/scripts/install-plugin.js +126 -126
  110. package/src/utils/claude-md-injector.js +90 -90
  111. package/src/utils/file-copier.js +200 -200
  112. package/src/utils/logger.js +32 -32
  113. package/src/utils/skills-installer.js +178 -178
  114. package/src/utils/version-checker.js +175 -175
@@ -1,171 +1,171 @@
1
- // ============================================================
2
- // HANGFIRE JOB TEMPLATE
3
- // Generated by MORPH Framework
4
- // ============================================================
5
-
6
- using Hangfire;
7
- using Microsoft.Extensions.Logging;
8
-
9
- namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Jobs;
10
-
11
- /// <summary>
12
- /// Background job for processing {{pascalCase FEATURE_NAME}}.
13
- /// Uses Hangfire for scheduling and retry handling.
14
- /// </summary>
15
- public class {{pascalCase FEATURE_NAME}}ProcessorJob(
16
- I{{pascalCase FEATURE_NAME}}Service service,
17
- I{{pascalCase FEATURE_NAME}}AnalyzerAgent analyzer,
18
- ILogger<{{pascalCase FEATURE_NAME}}ProcessorJob> logger) : I{{pascalCase FEATURE_NAME}}ProcessorJob
19
- {
20
- /// <summary>
21
- /// Executes the {{pascalCase FEATURE_NAME}} processing job.
22
- /// </summary>
23
- /// <param name="id">The {{pascalCase FEATURE_NAME}} ID to process</param>
24
- /// <param name="cancellationToken">Cancellation token</param>
25
- [AutomaticRetry(Attempts = 3, DelaysInSeconds = new[] { 60, 300, 900 })]
26
- [Queue("default")]
27
- [JobDisplayName("{{pascalCase FEATURE_NAME}} Processing - ID: {0}")]
28
- public async Task ExecuteAsync(int id, CancellationToken cancellationToken)
29
- {
30
- logger.LogInformation("Starting {{pascalCase FEATURE_NAME}} processing for ID {Id}", id);
31
-
32
- try
33
- {
34
- // Get the entity
35
- var item = await service.GetByIdAsync(id, cancellationToken);
36
- if (item is null)
37
- {
38
- logger.LogWarning("{{pascalCase FEATURE_NAME}} with ID {Id} not found, skipping", id);
39
- return;
40
- }
41
-
42
- // Check if already processed
43
- if (item.Status == {{pascalCase FEATURE_NAME}}Status.Completed)
44
- {
45
- logger.LogInformation("{{pascalCase FEATURE_NAME}} {Id} already completed, skipping", id);
46
- return;
47
- }
48
-
49
- // Perform analysis (if applicable)
50
- var analysisData = new {{pascalCase FEATURE_NAME}}Data(item.Name);
51
- var analysis = await analyzer.AnalyzeAsync(analysisData, cancellationToken);
52
-
53
- logger.LogInformation(
54
- "{{pascalCase FEATURE_NAME}} {Id} analyzed. Confidence: {Confidence:P0}",
55
- id, analysis.ConfidenceScore);
56
-
57
- // Update status
58
- // Note: You might need to add a method to update with analysis results
59
- // await service.CompleteWithAnalysisAsync(id, analysis, cancellationToken);
60
-
61
- logger.LogInformation("Completed {{pascalCase FEATURE_NAME}} processing for ID {Id}", id);
62
- }
63
- catch (Exception ex)
64
- {
65
- logger.LogError(ex, "Failed to process {{pascalCase FEATURE_NAME}} {Id}", id);
66
- throw; // Re-throw to trigger Hangfire retry
67
- }
68
- }
69
- }
70
-
71
- // ============================================================
72
- // RECURRING JOB CONFIGURATION
73
- // ============================================================
74
- //
75
- // For scheduled/recurring jobs, configure in Program.cs:
76
- //
77
- // // Run every hour
78
- // RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
79
- // "{{kebabCase FEATURE_NAME}}-processor",
80
- // job => job.ExecuteAsync(0, CancellationToken.None),
81
- // Cron.Hourly);
82
- //
83
- // // Run daily at midnight
84
- // RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
85
- // "{{kebabCase FEATURE_NAME}}-daily-processor",
86
- // job => job.ExecuteAsync(0, CancellationToken.None),
87
- // Cron.Daily);
88
- //
89
- // // Custom cron expression (every 15 minutes)
90
- // RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
91
- // "{{kebabCase FEATURE_NAME}}-frequent-processor",
92
- // job => job.ExecuteAsync(0, CancellationToken.None),
93
- // "*/15 * * * *");
94
- //
95
- // ============================================================
96
-
97
- // ============================================================
98
- // BATCH JOB TEMPLATE
99
- // ============================================================
100
-
101
- /// <summary>
102
- /// Batch job for processing multiple {{pascalCase FEATURE_NAME}}s.
103
- /// </summary>
104
- public class {{pascalCase FEATURE_NAME}}BatchProcessorJob(
105
- I{{pascalCase FEATURE_NAME}}Service service,
106
- I{{pascalCase FEATURE_NAME}}ProcessorJob itemProcessor,
107
- ILogger<{{pascalCase FEATURE_NAME}}BatchProcessorJob> logger)
108
- {
109
- /// <summary>
110
- /// Processes all pending {{pascalCase FEATURE_NAME}}s.
111
- /// </summary>
112
- [AutomaticRetry(Attempts = 1)]
113
- [Queue("batch")]
114
- [JobDisplayName("{{pascalCase FEATURE_NAME}} Batch Processing")]
115
- public async Task ProcessAllPendingAsync(CancellationToken cancellationToken)
116
- {
117
- logger.LogInformation("Starting batch processing for pending {{pascalCase FEATURE_NAME}}s");
118
-
119
- var items = await service.GetAllAsync(cancellationToken);
120
- var pending = items.Where(x => x.Status == {{pascalCase FEATURE_NAME}}Status.Pending).ToList();
121
-
122
- logger.LogInformation("Found {Count} pending {{pascalCase FEATURE_NAME}}s to process", pending.Count);
123
-
124
- foreach (var item in pending)
125
- {
126
- // Enqueue individual processing jobs
127
- BackgroundJob.Enqueue<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
128
- job => job.ExecuteAsync(item.Id, CancellationToken.None));
129
- }
130
-
131
- logger.LogInformation("Enqueued {Count} processing jobs", pending.Count);
132
- }
133
- }
134
-
135
- // ============================================================
136
- // HANGFIRE CONFIGURATION
137
- // ============================================================
138
- //
139
- // In Program.cs:
140
- //
141
- // // Add Hangfire services
142
- // builder.Services.AddHangfire(config => config
143
- // .SetDataCompatibilityLevel(CompatibilityLevel.Version_180)
144
- // .UseSimpleAssemblyNameTypeSerializer()
145
- // .UseRecommendedSerializerSettings()
146
- // .UseSqlServerStorage(connectionString, new SqlServerStorageOptions
147
- // {
148
- // CommandBatchMaxTimeout = TimeSpan.FromMinutes(5),
149
- // SlidingInvisibilityTimeout = TimeSpan.FromMinutes(5),
150
- // QueuePollInterval = TimeSpan.Zero,
151
- // UseRecommendedIsolationLevel = true,
152
- // DisableGlobalLocks = true
153
- // }));
154
- //
155
- // builder.Services.AddHangfireServer(options =>
156
- // {
157
- // options.Queues = new[] { "default", "batch" };
158
- // options.WorkerCount = Environment.ProcessorCount * 2;
159
- // });
160
- //
161
- // // Register jobs
162
- // builder.Services.AddScoped<I{{pascalCase FEATURE_NAME}}ProcessorJob, {{pascalCase FEATURE_NAME}}ProcessorJob>();
163
- // builder.Services.AddScoped<{{pascalCase FEATURE_NAME}}BatchProcessorJob>();
164
- //
165
- // // In app pipeline
166
- // app.UseHangfireDashboard("/hangfire", new DashboardOptions
167
- // {
168
- // Authorization = new[] { new HangfireAuthorizationFilter() }
169
- // });
170
- //
171
- // ============================================================
1
+ // ============================================================
2
+ // HANGFIRE JOB TEMPLATE
3
+ // Generated by MORPH Framework
4
+ // ============================================================
5
+
6
+ using Hangfire;
7
+ using Microsoft.Extensions.Logging;
8
+
9
+ namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Jobs;
10
+
11
+ /// <summary>
12
+ /// Background job for processing {{pascalCase FEATURE_NAME}}.
13
+ /// Uses Hangfire for scheduling and retry handling.
14
+ /// </summary>
15
+ public class {{pascalCase FEATURE_NAME}}ProcessorJob(
16
+ I{{pascalCase FEATURE_NAME}}Service service,
17
+ I{{pascalCase FEATURE_NAME}}AnalyzerAgent analyzer,
18
+ ILogger<{{pascalCase FEATURE_NAME}}ProcessorJob> logger) : I{{pascalCase FEATURE_NAME}}ProcessorJob
19
+ {
20
+ /// <summary>
21
+ /// Executes the {{pascalCase FEATURE_NAME}} processing job.
22
+ /// </summary>
23
+ /// <param name="id">The {{pascalCase FEATURE_NAME}} ID to process</param>
24
+ /// <param name="cancellationToken">Cancellation token</param>
25
+ [AutomaticRetry(Attempts = 3, DelaysInSeconds = new[] { 60, 300, 900 })]
26
+ [Queue("default")]
27
+ [JobDisplayName("{{pascalCase FEATURE_NAME}} Processing - ID: {0}")]
28
+ public async Task ExecuteAsync(int id, CancellationToken cancellationToken)
29
+ {
30
+ logger.LogInformation("Starting {{pascalCase FEATURE_NAME}} processing for ID {Id}", id);
31
+
32
+ try
33
+ {
34
+ // Get the entity
35
+ var item = await service.GetByIdAsync(id, cancellationToken);
36
+ if (item is null)
37
+ {
38
+ logger.LogWarning("{{pascalCase FEATURE_NAME}} with ID {Id} not found, skipping", id);
39
+ return;
40
+ }
41
+
42
+ // Check if already processed
43
+ if (item.Status == {{pascalCase FEATURE_NAME}}Status.Completed)
44
+ {
45
+ logger.LogInformation("{{pascalCase FEATURE_NAME}} {Id} already completed, skipping", id);
46
+ return;
47
+ }
48
+
49
+ // Perform analysis (if applicable)
50
+ var analysisData = new {{pascalCase FEATURE_NAME}}Data(item.Name);
51
+ var analysis = await analyzer.AnalyzeAsync(analysisData, cancellationToken);
52
+
53
+ logger.LogInformation(
54
+ "{{pascalCase FEATURE_NAME}} {Id} analyzed. Confidence: {Confidence:P0}",
55
+ id, analysis.ConfidenceScore);
56
+
57
+ // Update status
58
+ // Note: You might need to add a method to update with analysis results
59
+ // await service.CompleteWithAnalysisAsync(id, analysis, cancellationToken);
60
+
61
+ logger.LogInformation("Completed {{pascalCase FEATURE_NAME}} processing for ID {Id}", id);
62
+ }
63
+ catch (Exception ex)
64
+ {
65
+ logger.LogError(ex, "Failed to process {{pascalCase FEATURE_NAME}} {Id}", id);
66
+ throw; // Re-throw to trigger Hangfire retry
67
+ }
68
+ }
69
+ }
70
+
71
+ // ============================================================
72
+ // RECURRING JOB CONFIGURATION
73
+ // ============================================================
74
+ //
75
+ // For scheduled/recurring jobs, configure in Program.cs:
76
+ //
77
+ // // Run every hour
78
+ // RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
79
+ // "{{kebabCase FEATURE_NAME}}-processor",
80
+ // job => job.ExecuteAsync(0, CancellationToken.None),
81
+ // Cron.Hourly);
82
+ //
83
+ // // Run daily at midnight
84
+ // RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
85
+ // "{{kebabCase FEATURE_NAME}}-daily-processor",
86
+ // job => job.ExecuteAsync(0, CancellationToken.None),
87
+ // Cron.Daily);
88
+ //
89
+ // // Custom cron expression (every 15 minutes)
90
+ // RecurringJob.AddOrUpdate<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
91
+ // "{{kebabCase FEATURE_NAME}}-frequent-processor",
92
+ // job => job.ExecuteAsync(0, CancellationToken.None),
93
+ // "*/15 * * * *");
94
+ //
95
+ // ============================================================
96
+
97
+ // ============================================================
98
+ // BATCH JOB TEMPLATE
99
+ // ============================================================
100
+
101
+ /// <summary>
102
+ /// Batch job for processing multiple {{pascalCase FEATURE_NAME}}s.
103
+ /// </summary>
104
+ public class {{pascalCase FEATURE_NAME}}BatchProcessorJob(
105
+ I{{pascalCase FEATURE_NAME}}Service service,
106
+ I{{pascalCase FEATURE_NAME}}ProcessorJob itemProcessor,
107
+ ILogger<{{pascalCase FEATURE_NAME}}BatchProcessorJob> logger)
108
+ {
109
+ /// <summary>
110
+ /// Processes all pending {{pascalCase FEATURE_NAME}}s.
111
+ /// </summary>
112
+ [AutomaticRetry(Attempts = 1)]
113
+ [Queue("batch")]
114
+ [JobDisplayName("{{pascalCase FEATURE_NAME}} Batch Processing")]
115
+ public async Task ProcessAllPendingAsync(CancellationToken cancellationToken)
116
+ {
117
+ logger.LogInformation("Starting batch processing for pending {{pascalCase FEATURE_NAME}}s");
118
+
119
+ var items = await service.GetAllAsync(cancellationToken);
120
+ var pending = items.Where(x => x.Status == {{pascalCase FEATURE_NAME}}Status.Pending).ToList();
121
+
122
+ logger.LogInformation("Found {Count} pending {{pascalCase FEATURE_NAME}}s to process", pending.Count);
123
+
124
+ foreach (var item in pending)
125
+ {
126
+ // Enqueue individual processing jobs
127
+ BackgroundJob.Enqueue<I{{pascalCase FEATURE_NAME}}ProcessorJob>(
128
+ job => job.ExecuteAsync(item.Id, CancellationToken.None));
129
+ }
130
+
131
+ logger.LogInformation("Enqueued {Count} processing jobs", pending.Count);
132
+ }
133
+ }
134
+
135
+ // ============================================================
136
+ // HANGFIRE CONFIGURATION
137
+ // ============================================================
138
+ //
139
+ // In Program.cs:
140
+ //
141
+ // // Add Hangfire services
142
+ // builder.Services.AddHangfire(config => config
143
+ // .SetDataCompatibilityLevel(CompatibilityLevel.Version_180)
144
+ // .UseSimpleAssemblyNameTypeSerializer()
145
+ // .UseRecommendedSerializerSettings()
146
+ // .UseSqlServerStorage(connectionString, new SqlServerStorageOptions
147
+ // {
148
+ // CommandBatchMaxTimeout = TimeSpan.FromMinutes(5),
149
+ // SlidingInvisibilityTimeout = TimeSpan.FromMinutes(5),
150
+ // QueuePollInterval = TimeSpan.Zero,
151
+ // UseRecommendedIsolationLevel = true,
152
+ // DisableGlobalLocks = true
153
+ // }));
154
+ //
155
+ // builder.Services.AddHangfireServer(options =>
156
+ // {
157
+ // options.Queues = new[] { "default", "batch" };
158
+ // options.WorkerCount = Environment.ProcessorCount * 2;
159
+ // });
160
+ //
161
+ // // Register jobs
162
+ // builder.Services.AddScoped<I{{pascalCase FEATURE_NAME}}ProcessorJob, {{pascalCase FEATURE_NAME}}ProcessorJob>();
163
+ // builder.Services.AddScoped<{{pascalCase FEATURE_NAME}}BatchProcessorJob>();
164
+ //
165
+ // // In app pipeline
166
+ // app.UseHangfireDashboard("/hangfire", new DashboardOptions
167
+ // {
168
+ // Authorization = new[] { new HangfireAuthorizationFilter() }
169
+ // });
170
+ //
171
+ // ============================================================