@polymorphism-tech/morph-spec 4.3.4 → 4.3.5

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 (164) hide show
  1. package/.morph/.morphversion +5 -0
  2. package/.morph/config/agents.json +948 -0
  3. package/.morph/config/config.json +9 -9
  4. package/.morph/project/context/README.md +17 -0
  5. package/.morph/project/context/detection-log.md +16 -0
  6. package/.morph/project/standards/inferred.md +59 -0
  7. package/.morph/standards/ai-agents/blazor-ui.md +364 -0
  8. package/.morph/standards/ai-agents/production.md +415 -0
  9. package/.morph/standards/ai-agents/setup.md +418 -0
  10. package/.morph/standards/ai-agents/team-orchestration.md +479 -0
  11. package/.morph/standards/ai-agents/workflows.md +354 -0
  12. package/.morph/standards/architecture/ddd/aggregates.md +120 -0
  13. package/.morph/standards/architecture/ddd/entities.md +99 -0
  14. package/.morph/standards/architecture/ddd/value-objects.md +124 -0
  15. package/.morph/standards/backend/api/minimal-api.md +494 -0
  16. package/.morph/standards/backend/api/rest.md +492 -0
  17. package/.morph/standards/backend/api/validation.md +88 -0
  18. package/.morph/standards/backend/authentication/passkeys.md +428 -0
  19. package/.morph/standards/backend/database/ef-core.md +199 -0
  20. package/.morph/standards/backend/database/migrations.md +393 -0
  21. package/.morph/standards/backend/database/postgresql/database.md +352 -0
  22. package/.morph/standards/backend/database/repository-patterns.md +528 -0
  23. package/.morph/standards/backend/database/vector-search-rag.md +541 -0
  24. package/.morph/standards/backend/dotnet/async.md +366 -0
  25. package/.morph/standards/backend/dotnet/core.md +117 -0
  26. package/.morph/standards/backend/dotnet/di.md +439 -0
  27. package/.morph/standards/backend/dotnet/program-cs-checklist.md +92 -0
  28. package/.morph/standards/backend/integrations/asaas/asaas-api.md +216 -0
  29. package/.morph/standards/backend/integrations/clerk/clerk-auth.md +290 -0
  30. package/.morph/standards/backend/integrations/hangfire/hangfire-jobs.md +350 -0
  31. package/.morph/standards/backend/integrations/resend/resend-email.md +385 -0
  32. package/.morph/standards/context/analytics.md +96 -0
  33. package/.morph/standards/context/bundles.md +110 -0
  34. package/.morph/standards/context/priming.md +78 -0
  35. package/.morph/standards/core/architecture.md +185 -0
  36. package/.morph/standards/core/coding.md +214 -0
  37. package/.morph/standards/core/git-branching-strategy.md +403 -0
  38. package/.morph/standards/core/git.md +185 -0
  39. package/.morph/standards/core/testing.md +295 -0
  40. package/.morph/standards/data/nosql/blob-storage.md +102 -0
  41. package/.morph/standards/data/nosql/cache/redis.md +97 -0
  42. package/.morph/standards/data/nosql/cosmos-db.md +118 -0
  43. package/.morph/standards/data/vector-search/azure-ai-search.md +121 -0
  44. package/.morph/standards/data/vector-search/rag-chunking.md +104 -0
  45. package/.morph/standards/frontend/blazor/design-checklist.md +222 -0
  46. package/.morph/standards/frontend/blazor/fluent-ui-setup.md +595 -0
  47. package/.morph/standards/frontend/blazor/fluent-ui.md +137 -0
  48. package/.morph/standards/frontend/blazor/html-conversion.md +184 -0
  49. package/.morph/standards/frontend/blazor/lifecycle.md +195 -0
  50. package/.morph/standards/frontend/blazor/pitfalls.md +198 -0
  51. package/.morph/standards/frontend/blazor/state.md +191 -0
  52. package/.morph/standards/frontend/design-system/animations.md +151 -0
  53. package/.morph/standards/frontend/design-system/naming.md +64 -0
  54. package/.morph/standards/frontend/nextjs/nextjs-patterns.md +198 -0
  55. package/.morph/standards/infrastructure/azure/azure.md +624 -0
  56. package/.morph/standards/infrastructure/azure/bicep/bicep-patterns.md +422 -0
  57. package/.morph/standards/infrastructure/azure/devops/azure-devops-setup.md +516 -0
  58. package/.morph/standards/infrastructure/azure/devops/local-development.md +520 -0
  59. package/.morph/standards/infrastructure/azure/services/functions.md +486 -0
  60. package/.morph/standards/infrastructure/azure/services/service-bus.md +459 -0
  61. package/.morph/standards/infrastructure/azure/services/storage.md +407 -0
  62. package/.morph/standards/infrastructure/docker/easypanel-deploy.md +196 -0
  63. package/.morph/standards/infrastructure/supabase/mcp-setup.md +252 -0
  64. package/.morph/standards/infrastructure/supabase/supabase-auth.md +176 -0
  65. package/.morph/standards/infrastructure/supabase/supabase-pgvector.md +169 -0
  66. package/.morph/standards/infrastructure/supabase/supabase-rls.md +184 -0
  67. package/.morph/standards/infrastructure/supabase/supabase-storage.md +153 -0
  68. package/.morph/standards/integration/api/graphql.md +91 -0
  69. package/.morph/standards/integration/api/grpc.md +114 -0
  70. package/.morph/standards/integration/api/rest-design.md +95 -0
  71. package/.morph/standards/integration/event-driven/cqrs.md +101 -0
  72. package/.morph/standards/integration/event-driven/event-sourcing.md +124 -0
  73. package/.morph/standards/integration/event-driven/service-bus.md +95 -0
  74. package/.morph/standards/observability/logging.md +131 -0
  75. package/.morph/standards/observability/metrics.md +121 -0
  76. package/.morph/standards/observability/monitoring.md +114 -0
  77. package/.morph/standards/observability/tracing.md +132 -0
  78. package/.morph/standards/workflows/parallel-execution.md +112 -0
  79. package/.morph/standards/workflows/thread-management.md +113 -0
  80. package/.morph/templates/.idea/morph-templates.xml +92 -0
  81. package/.morph/templates/.vscode/morph-templates.code-snippets +186 -0
  82. package/.morph/templates/IDE-SNIPPETS.md +266 -0
  83. package/.morph/templates/README.md +814 -0
  84. package/.morph/templates/REGISTRY.json +1677 -0
  85. package/.morph/templates/code/dotnet/backend/repository.cs +141 -0
  86. package/.morph/templates/code/dotnet/backend/service.cs +139 -0
  87. package/.morph/templates/code/dotnet/contracts/Commands.cs +74 -0
  88. package/.morph/templates/code/dotnet/contracts/Entities.cs +25 -0
  89. package/.morph/templates/code/dotnet/contracts/Queries.cs +74 -0
  90. package/.morph/templates/code/dotnet/contracts/README.md +74 -0
  91. package/.morph/templates/code/dotnet/contracts/api-contracts.cs +173 -0
  92. package/.morph/templates/code/dotnet/contracts/contracts.cs +217 -0
  93. package/.morph/templates/code/dotnet/database/migration.cs +83 -0
  94. package/.morph/templates/code/dotnet/frontend/component.razor +239 -0
  95. package/.morph/templates/code/dotnet/jobs/agent.cs +163 -0
  96. package/.morph/templates/code/dotnet/jobs/job.cs +171 -0
  97. package/.morph/templates/code/dotnet/test.cs +239 -0
  98. package/.morph/templates/code/sql/rls-policy.sql +57 -0
  99. package/.morph/templates/code/sql/supabase-migration.sql +100 -0
  100. package/.morph/templates/code/sql/supabase-migration.template.sql +113 -0
  101. package/.morph/templates/code/typescript/contracts.ts +168 -0
  102. package/.morph/templates/context/CONTEXT-FEATURE.md +276 -0
  103. package/.morph/templates/context/CONTEXT.md +181 -0
  104. package/.morph/templates/docs/proposal.md +182 -0
  105. package/.morph/templates/docs/spec.md +149 -0
  106. package/.morph/templates/examples/design-system-examples.md +357 -0
  107. package/.morph/templates/examples/spec-examples.md +90 -0
  108. package/.morph/templates/feature/decisions.md +187 -0
  109. package/.morph/templates/feature/recap.md +146 -0
  110. package/.morph/templates/feature/tasks.md +199 -0
  111. package/.morph/templates/infrastructure/azure/Dockerfile.example +82 -0
  112. package/.morph/templates/infrastructure/azure/README.md +286 -0
  113. package/.morph/templates/infrastructure/azure/app-insights.bicep +63 -0
  114. package/.morph/templates/infrastructure/azure/app-service.bicep +164 -0
  115. package/.morph/templates/infrastructure/azure/container-app-env.bicep +49 -0
  116. package/.morph/templates/infrastructure/azure/container-app.bicep +156 -0
  117. package/.morph/templates/infrastructure/azure/deploy-checklist.md +426 -0
  118. package/.morph/templates/infrastructure/azure/deploy.ps1 +229 -0
  119. package/.morph/templates/infrastructure/azure/deploy.sh +208 -0
  120. package/.morph/templates/infrastructure/azure/key-vault.bicep +91 -0
  121. package/.morph/templates/infrastructure/azure/main.bicep +189 -0
  122. package/.morph/templates/infrastructure/azure/parameters.dev.json +29 -0
  123. package/.morph/templates/infrastructure/azure/parameters.prod.json +29 -0
  124. package/.morph/templates/infrastructure/azure/parameters.staging.json +29 -0
  125. package/.morph/templates/infrastructure/azure/sql-database.bicep +103 -0
  126. package/.morph/templates/infrastructure/azure/storage.bicep +106 -0
  127. package/.morph/templates/infrastructure/docker/Dockerfile.template +58 -0
  128. package/.morph/templates/infrastructure/docker/docker-compose.template.yml +67 -0
  129. package/.morph/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -0
  130. package/.morph/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -0
  131. package/.morph/templates/infrastructure/docker/easypanel.template.json +54 -0
  132. package/.morph/templates/infrastructure/github/README.md +593 -0
  133. package/.morph/templates/infrastructure/github/actions/azure-auth/action.yml.hbs +22 -0
  134. package/.morph/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -0
  135. package/.morph/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -0
  136. package/.morph/templates/infrastructure/github/workflows/deploy-azure-app-service.yml.hbs +61 -0
  137. package/.morph/templates/infrastructure/github/workflows/deploy-easypanel.yml.hbs +31 -0
  138. package/.morph/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -0
  139. package/.morph/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -0
  140. package/.morph/templates/integrations/asaas-client.cs +387 -0
  141. package/.morph/templates/integrations/asaas-webhook.cs +351 -0
  142. package/.morph/templates/integrations/azure-identity-config.cs +288 -0
  143. package/.morph/templates/integrations/clerk-config.cs +258 -0
  144. package/.morph/templates/meta-prompts/fusion/fusion-agent.md +76 -0
  145. package/.morph/templates/meta-prompts/fusion/fusion-aggregator.md +100 -0
  146. package/.morph/templates/meta-prompts/hops/hop-retry.md +78 -0
  147. package/.morph/templates/meta-prompts/hops/hop-validation.md +97 -0
  148. package/.morph/templates/meta-prompts/hops/hop-wrapper.md +36 -0
  149. package/.morph/templates/meta-prompts/parallel-workers/parallel-coordinator.md +113 -0
  150. package/.morph/templates/meta-prompts/parallel-workers/parallel-worker.md +80 -0
  151. package/.morph/templates/meta-prompts/squad-leaders/backend-squad.md +90 -0
  152. package/.morph/templates/meta-prompts/squad-leaders/frontend-squad.md +126 -0
  153. package/.morph/templates/meta-prompts/squad-leaders/squad-leader.md +43 -0
  154. package/.morph/templates/meta-prompts/validators/checkpoint-validator.md +107 -0
  155. package/.morph/templates/meta-prompts/validators/pre-commit-validator.md +95 -0
  156. package/.morph/templates/saas/subscription.cs +347 -0
  157. package/.morph/templates/saas/tenant.cs +338 -0
  158. package/.morph/templates/state.template.json +17 -0
  159. package/.morph/templates/ui/FluentDesignTheme.cs +149 -0
  160. package/.morph/templates/ui/MudTheme.cs +281 -0
  161. package/.morph/templates/ui/design-system.css +226 -0
  162. package/bin/morph-spec.js +1 -1
  163. package/package.json +1 -1
  164. package/src/commands/project/update.js +100 -13
@@ -0,0 +1,132 @@
1
+ # Observability Standard: Distributed Tracing
2
+
3
+ ## Overview
4
+ OpenTelemetry distributed tracing for cross-service correlation and performance analysis.
5
+
6
+ ## OpenTelemetry Setup
7
+
8
+ ### Packages
9
+ ```xml
10
+ <PackageReference Include="OpenTelemetry.Extensions.Hosting" Version="1.*" />
11
+ <PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.*" />
12
+ <PackageReference Include="OpenTelemetry.Instrumentation.Http" Version="1.*" />
13
+ <PackageReference Include="OpenTelemetry.Instrumentation.SqlClient" Version="1.*" />
14
+ <PackageReference Include="Azure.Monitor.OpenTelemetry.AspNetCore" Version="1.*" />
15
+ ```
16
+
17
+ ### Program.cs Configuration
18
+ ```csharp
19
+ builder.Services.AddOpenTelemetry()
20
+ .WithTracing(tracing =>
21
+ {
22
+ tracing
23
+ .AddAspNetCoreInstrumentation(opts =>
24
+ {
25
+ opts.RecordException = true;
26
+ opts.Filter = ctx => !ctx.Request.Path.StartsWithSegments("/health");
27
+ })
28
+ .AddHttpClientInstrumentation()
29
+ .AddSqlClientInstrumentation(opts => opts.SetDbStatementForText = true)
30
+ .AddSource(ActivitySource.Name) // Custom activities
31
+ .AddAzureMonitorTraceExporter(opts =>
32
+ {
33
+ opts.ConnectionString = config["ApplicationInsights:ConnectionString"];
34
+ });
35
+ });
36
+
37
+ // Custom ActivitySource for domain operations
38
+ public static class Telemetry
39
+ {
40
+ public static readonly ActivitySource ActivitySource = new("MyApp", "1.0.0");
41
+ }
42
+ ```
43
+
44
+ ## Custom Span Creation
45
+
46
+ ### Service Method Tracing
47
+ ```csharp
48
+ public async Task<Order> ProcessOrderAsync(CreateOrderCommand command)
49
+ {
50
+ using var activity = Telemetry.ActivitySource.StartActivity("ProcessOrder");
51
+ activity?.SetTag("order.userId", command.UserId.ToString());
52
+ activity?.SetTag("order.itemCount", command.Items.Count.ToString());
53
+
54
+ try
55
+ {
56
+ var order = await _repository.CreateAsync(command);
57
+ activity?.SetTag("order.id", order.Id.ToString());
58
+ activity?.SetStatus(ActivityStatusCode.Ok);
59
+ return order;
60
+ }
61
+ catch (Exception ex)
62
+ {
63
+ activity?.SetStatus(ActivityStatusCode.Error, ex.Message);
64
+ activity?.RecordException(ex);
65
+ throw;
66
+ }
67
+ }
68
+ ```
69
+
70
+ ### Baggage (Cross-Service Context)
71
+ ```csharp
72
+ // Set correlation ID in baggage (propagates across HTTP calls)
73
+ Activity.Current?.SetBaggage("correlationId", correlationId);
74
+ Activity.Current?.SetBaggage("userId", userId.ToString());
75
+
76
+ // Read baggage downstream
77
+ var correlationId = Activity.Current?.GetBaggageItem("correlationId");
78
+ ```
79
+
80
+ ## Trace Context Propagation
81
+
82
+ ### HTTP Client (auto-propagated)
83
+ ```csharp
84
+ // HttpClient automatically propagates W3C trace context
85
+ // Configure in DI:
86
+ builder.Services.AddHttpClient("ExternalApi")
87
+ .AddOpenTelemetryInstrumentation();
88
+ ```
89
+
90
+ ### Service Bus (manual propagation)
91
+ ```csharp
92
+ // Sender: inject trace context into message properties
93
+ var message = new ServiceBusMessage(body);
94
+ var activity = Activity.Current;
95
+ if (activity != null)
96
+ {
97
+ message.ApplicationProperties["traceparent"] = activity.Id;
98
+ message.ApplicationProperties["tracestate"] = activity.TraceStateString;
99
+ }
100
+
101
+ // Receiver: restore trace context from message
102
+ if (message.ApplicationProperties.TryGetValue("traceparent", out var traceparent))
103
+ {
104
+ using var linkedActivity = Telemetry.ActivitySource.StartActivity(
105
+ "ProcessMessage",
106
+ ActivityKind.Consumer,
107
+ parentId: traceparent.ToString()!);
108
+ await ProcessAsync(message);
109
+ }
110
+ ```
111
+
112
+ ## Trace Sampling Strategy
113
+
114
+ | Environment | Strategy | Rate |
115
+ |-------------|----------|------|
116
+ | Development | Always | 100% |
117
+ | Staging | Adaptive | 10% + errors |
118
+ | Production | Adaptive | 5% + errors |
119
+
120
+ ```csharp
121
+ // Production adaptive sampling (errors always sampled)
122
+ .AddAspNetCoreInstrumentation(opts =>
123
+ {
124
+ opts.Enrich = (activity, eventName, obj) =>
125
+ {
126
+ if (obj is HttpResponse response && response.StatusCode >= 400)
127
+ {
128
+ activity.SetSampled(true); // Always sample errors
129
+ }
130
+ };
131
+ })
132
+ ```
@@ -0,0 +1,112 @@
1
+ # Workflow Standard: Parallel Execution
2
+
3
+ ## When to Use Parallel Execution
4
+
5
+ | Condition | Decision |
6
+ |-----------|----------|
7
+ | 5+ independent tasks | Use P-Threads |
8
+ | Multi-domain (backend + frontend + infra) | Use P-Threads with squad templates |
9
+ | 15+ files to create | Use P-Threads |
10
+ | Tasks have zero dependency overlap | Use P-Threads |
11
+ | Tasks share file scope | Do NOT parallelize |
12
+ | Sequential data flow required | Do NOT parallelize |
13
+
14
+ ## Parallelization Planning
15
+
16
+ ### Step 1: Dependency Analysis
17
+ ```bash
18
+ morph-spec detect-workflow user-auth
19
+
20
+ # Identifies: parallelizable tasks, sequential chains, waves
21
+ ```
22
+
23
+ ### Step 2: File Scope Assignment
24
+ Assign exclusive file ownership to each parallel worker:
25
+
26
+ ```
27
+ Worker A (Backend): Entities/, Services/, Controllers/, DTOs/
28
+ Worker B (Frontend): Pages/, Components/, CSS/
29
+ Worker C (Infra): infra/bicep/, .github/workflows/
30
+ ```
31
+
32
+ No overlap allowed. If overlap is unavoidable, make it sequential.
33
+
34
+ ### Step 3: Choose Squad Template
35
+ ```bash
36
+ morph-spec squad-template use full-stack --feature=user-auth
37
+
38
+ # Creates execution plan based on full-stack.json template:
39
+ # - dotnet-senior (backend lead)
40
+ # - blazor-builder (frontend lead)
41
+ # - bicep-architect (infra lead)
42
+ # - thread-orchestrator (coordinator)
43
+ ```
44
+
45
+ ## Execution Flow
46
+
47
+ ```
48
+ Orchestrator
49
+
50
+ ├── spawn parallel: Worker A (files: Entities/, Services/)
51
+ ├── spawn parallel: Worker B (files: Pages/, Components/)
52
+ └── spawn parallel: Worker C (files: infra/)
53
+
54
+ │ [Workers execute concurrently — no interaction]
55
+
56
+ ├── wait-all (poll or explicit sync)
57
+
58
+ ├── merge results (check for conflicts)
59
+ ├── run integration validation
60
+ └── report consolidated output
61
+ ```
62
+
63
+ ## Conflict Resolution
64
+
65
+ ### File Conflicts (two workers wrote same file)
66
+ ```bash
67
+ # This should NOT happen if scopes are properly defined
68
+ # If it does:
69
+ morph-spec agents review aggregate user-auth \
70
+ --agents=dotnet-senior,blazor-builder \
71
+ --strategy=best-of-n
72
+ ```
73
+
74
+ ### Interface Mismatches (A expects contract B didn't fulfill)
75
+ - Document the mismatch in the coordinator report
76
+ - Fix in post-merge sequential step
77
+ - Update contracts.cs to reflect actual implementation
78
+
79
+ ## Fusion vs Parallel
80
+
81
+ | Aspect | Parallel (P-Thread) | Fusion (F-Thread) |
82
+ |--------|--------------------|--------------------|
83
+ | Goal | Divide scope | Compete on same scope |
84
+ | Output | Different files | Same files, best one wins |
85
+ | Workers collaborate? | No | No |
86
+ | Merge | Combine all files | Select best implementation |
87
+ | Use case | Large features | Design decisions, quality optimization |
88
+
89
+ ## Configuration
90
+ ```json
91
+ // llm-interaction.json
92
+ {
93
+ "parallelExecution": {
94
+ "enabled": true,
95
+ "maxConcurrent": 3,
96
+ "defaultStrategy": "best-of-n"
97
+ }
98
+ }
99
+ ```
100
+
101
+ ## Squad Templates
102
+
103
+ Pre-defined squad configurations in `framework/squad-templates/`:
104
+ - `full-stack.json` — Backend + Frontend + Infra (6 agents)
105
+ - `backend-only.json` — Backend specialists only (4 agents)
106
+ - `frontend-only.json` — Frontend specialists only (3 agents)
107
+
108
+ ```bash
109
+ morph-spec squad-template list
110
+ morph-spec squad-template show full-stack
111
+ morph-spec squad-template use full-stack --feature=user-auth
112
+ ```
@@ -0,0 +1,113 @@
1
+ # Workflow Standard: Thread Management
2
+
3
+ ## Thread Types
4
+
5
+ | Type | Code | Purpose | Lifecycle |
6
+ |------|------|---------|-----------|
7
+ | Base | B-Thread | Default implementation thread | Bounded by feature phase |
8
+ | Parallel | P-Thread | Concurrent isolated execution | Short (1 task scope) |
9
+ | Fusion | F-Thread | Best-of-N competing implementations | Short (1 prompt scope) |
10
+ | Long-Running | L-Thread | Multi-session persistent work | Days/weeks |
11
+ | Zero-Touch | Z-Thread | Fully autonomous execution | Bounded by trust level |
12
+
13
+ ## Thread Lifecycle
14
+
15
+ ```
16
+ pending → running → completed
17
+ → failed → (retry) → running
18
+ → killed
19
+ ```
20
+
21
+ ## Creating Threads
22
+ ```bash
23
+ # Create a base thread (default)
24
+ morph-spec threads status morph-next-gen
25
+
26
+ # Create parallel threads for feature
27
+ morph-spec spawn-team morph-next-gen --parallel backend,frontend,infra
28
+
29
+ # Create fusion thread
30
+ morph-spec agents fuse \
31
+ --prompt "Implement caching strategy for UserService" \
32
+ --count=3 \
33
+ --strategy=best-of-n \
34
+ --feature=morph-next-gen
35
+ ```
36
+
37
+ ## Thread State in state.json
38
+ ```json
39
+ {
40
+ "threads": {
41
+ "thread-abc12345": {
42
+ "id": "thread-abc12345",
43
+ "type": "parallel",
44
+ "agent": "dotnet-senior",
45
+ "feature": "user-auth",
46
+ "status": "running",
47
+ "startedAt": "2026-02-19T00:00:00Z",
48
+ "events": [
49
+ { "type": "started", "timestamp": "..." },
50
+ { "type": "checkpoint_passed", "timestamp": "...", "checkpointNum": 1 }
51
+ ],
52
+ "metrics": {
53
+ "tasksCompleted": 3,
54
+ "checkpointsPassed": 1,
55
+ "errors": 0
56
+ }
57
+ }
58
+ }
59
+ }
60
+ ```
61
+
62
+ ## Parallel Execution Rules (P-Threads)
63
+
64
+ 1. **File scope isolation**: Each P-Thread has exclusive write access to its files
65
+ 2. **No cross-thread dependencies**: P-Thread tasks are self-contained
66
+ 3. **Shared read access**: All P-Threads can read spec.md, standards, contracts
67
+ 4. **Merge on completion**: Coordinator merges results after all P-Threads complete
68
+ 5. **Max concurrent**: Default 3, max 5 (configurable in llm-interaction.json)
69
+
70
+ ## Dependency Analysis
71
+ ```bash
72
+ # Analyze task dependencies for parallel opportunities
73
+ morph-spec detect-workflow morph-next-gen
74
+
75
+ # Output:
76
+ # Parallelizable tasks: T001, T002, T003 (no dependencies)
77
+ # Sequential: T004 (depends on T001), T005 (depends on T002)
78
+ # Execution plan:
79
+ # Wave 1: [T001, T002, T003] (parallel)
80
+ # Wave 2: [T004, T005] (parallel, after wave 1)
81
+ # Wave 3: [T006] (sequential)
82
+ ```
83
+
84
+ ## Long-Running Threads (L-Threads)
85
+
86
+ ### Stop Hooks
87
+ L-Threads run periodic stop hooks every 30 minutes:
88
+ ```json
89
+ // llm-interaction.json
90
+ {
91
+ "stopHooks": {
92
+ "enabled": true,
93
+ "interval": 30,
94
+ "maxRetries": 5,
95
+ "hooks": ["validate-and-continue", "validate-checkpoints"]
96
+ }
97
+ }
98
+ ```
99
+
100
+ ### Resume Pattern
101
+ ```bash
102
+ # Resume L-Thread from bundle
103
+ morph-spec bundle load morph-next-gen
104
+ # Load resume context, continue from checkpoint
105
+ ```
106
+
107
+ ## Monitoring
108
+ ```bash
109
+ morph-spec threads list morph-next-gen
110
+ morph-spec threads analytics morph-next-gen
111
+ morph-spec threads wait-all morph-next-gen
112
+ morph-spec threads wait-any morph-next-gen
113
+ ```
@@ -0,0 +1,92 @@
1
+ <templateSet group="MORPH Templates">
2
+ <template name="morph-pascal" value="{{pascalCase $FEATURE_NAME$}}" description="Convert to PascalCase (UserAuth)" toReformat="false" toShortenFQNames="true">
3
+ <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
4
+ <context>
5
+ <option name="OTHER" value="true" />
6
+ </context>
7
+ </template>
8
+
9
+ <template name="morph-camel" value="{{camelCase $FEATURE_NAME$}}" description="Convert to camelCase (userAuth)" toReformat="false" toShortenFQNames="true">
10
+ <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
11
+ <context>
12
+ <option name="OTHER" value="true" />
13
+ </context>
14
+ </template>
15
+
16
+ <template name="morph-snake" value="{{snakeCase $FEATURE_NAME$}}" description="Convert to snake_case (user_auth)" toReformat="false" toShortenFQNames="true">
17
+ <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
18
+ <context>
19
+ <option name="OTHER" value="true" />
20
+ </context>
21
+ </template>
22
+
23
+ <template name="morph-title" value="{{titleCase $FEATURE_NAME$}}" description="Convert to Title Case (User Auth)" toReformat="false" toShortenFQNames="true">
24
+ <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
25
+ <context>
26
+ <option name="OTHER" value="true" />
27
+ </context>
28
+ </template>
29
+
30
+ <template name="morph-kebab" value="{{kebabCase $FEATURE_NAME$}}" description="Convert to kebab-case (user-auth)" toReformat="false" toShortenFQNames="true">
31
+ <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
32
+ <context>
33
+ <option name="OTHER" value="true" />
34
+ </context>
35
+ </template>
36
+
37
+ <template name="morph-if" value="{{#if $CONDITION$}}&#10; $END$&#10;{{/if}}" description="Handlebars if block" toReformat="false" toShortenFQNames="true">
38
+ <variable name="CONDITION" expression="" defaultValue="&quot;condition&quot;" alwaysStopAt="true" />
39
+ <context>
40
+ <option name="OTHER" value="true" />
41
+ </context>
42
+ </template>
43
+
44
+ <template name="morph-if-else" value="{{#if $CONDITION$}}&#10; $TRUE_BRANCH$&#10;{{else}}&#10; $FALSE_BRANCH$&#10;{{/if}}" description="Handlebars if-else block" toReformat="false" toShortenFQNames="true">
45
+ <variable name="CONDITION" expression="" defaultValue="&quot;condition&quot;" alwaysStopAt="true" />
46
+ <variable name="TRUE_BRANCH" expression="" defaultValue="&quot;&quot;" alwaysStopAt="true" />
47
+ <variable name="FALSE_BRANCH" expression="" defaultValue="&quot;&quot;" alwaysStopAt="true" />
48
+ <context>
49
+ <option name="OTHER" value="true" />
50
+ </context>
51
+ </template>
52
+
53
+ <template name="morph-each" value="{{#each $ITEMS$}}&#10; {{this.$PROPERTY$}}&#10;{{/each}}" description="Handlebars each loop" toReformat="false" toShortenFQNames="true">
54
+ <variable name="ITEMS" expression="" defaultValue="&quot;items&quot;" alwaysStopAt="true" />
55
+ <variable name="PROPERTY" expression="" defaultValue="&quot;name&quot;" alwaysStopAt="true" />
56
+ <context>
57
+ <option name="OTHER" value="true" />
58
+ </context>
59
+ </template>
60
+
61
+ <template name="morph-service" value="namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Services;&#10;&#10;public class {{pascalCase FEATURE_NAME}}Service(&#10; I{{pascalCase FEATURE_NAME}}Repository repository,&#10; ILogger&lt;{{pascalCase FEATURE_NAME}}Service&gt; logger) : I{{pascalCase FEATURE_NAME}}Service&#10;{&#10; public async Task&lt;{{pascalCase FEATURE_NAME}}Dto?&gt; GetByIdAsync(int id, CancellationToken cancellationToken = default)&#10; {&#10; $END$&#10; }&#10;}" description="MORPH .NET Service class template" toReformat="false" toShortenFQNames="true">
62
+ <context>
63
+ <option name="C_SHARP" value="true" />
64
+ </context>
65
+ </template>
66
+
67
+ <template name="morph-repository" value="public class {{pascalCase FEATURE_NAME}}Repository(AppDbContext context) : I{{pascalCase FEATURE_NAME}}Repository&#10;{&#10; private readonly DbSet&lt;{{pascalCase FEATURE_NAME}}&gt; _dbSet = context.Set&lt;{{pascalCase FEATURE_NAME}}&gt;();&#10;&#10; public async Task&lt;{{pascalCase FEATURE_NAME}}?&gt; GetByIdAsync(int id, CancellationToken cancellationToken = default)&#10; {&#10; $END$&#10; }&#10;}" description="MORPH .NET Repository class template" toReformat="false" toShortenFQNames="true">
68
+ <context>
69
+ <option name="C_SHARP" value="true" />
70
+ </context>
71
+ </template>
72
+
73
+ <template name="morph-component" value="@page &quot;/{{kebabCase FEATURE_NAME}}&quot;&#10;@inject I{{pascalCase FEATURE_NAME}}Service {{pascalCase FEATURE_NAME}}Service&#10;@inject ILogger&lt;{{pascalCase FEATURE_NAME}}Page&gt; Logger&#10;&#10;&lt;PageTitle&gt;{{pascalCase FEATURE_NAME}}&lt;/PageTitle&gt;&#10;&#10;&lt;div class=&quot;container-fluid&quot;&gt;&#10; $END$&#10;&lt;/div&gt;&#10;&#10;@code {&#10;&#10;}" description="MORPH Blazor component template" toReformat="false" toShortenFQNames="true">
74
+ <context>
75
+ <option name="HTML" value="true" />
76
+ </context>
77
+ </template>
78
+
79
+ <template name="morph-migration" value="public partial class Add{{pascalCase FEATURE_NAME}} : Migration&#10;{&#10; protected override void Up(MigrationBuilder migrationBuilder)&#10; {&#10; migrationBuilder.CreateTable(&#10; name: &quot;{{pascalCase FEATURE_NAME}}s&quot;,&#10; columns: table =&gt; new&#10; {&#10; Id = table.Column&lt;int&gt;(type: &quot;int&quot;, nullable: false)&#10; .Annotation(&quot;SqlServer:Identity&quot;, &quot;1, 1&quot;),&#10; $END$&#10; },&#10; constraints: table =&gt;&#10; {&#10; table.PrimaryKey(&quot;PK_{{pascalCase FEATURE_NAME}}s&quot;, x =&gt; x.Id);&#10; });&#10; }&#10;&#10; protected override void Down(MigrationBuilder migrationBuilder)&#10; {&#10; migrationBuilder.DropTable(name: &quot;{{pascalCase FEATURE_NAME}}s&quot;);&#10; }&#10;}" description="MORPH EF Core migration template" toReformat="false" toShortenFQNames="true">
80
+ <context>
81
+ <option name="C_SHARP" value="true" />
82
+ </context>
83
+ </template>
84
+
85
+ <template name="morph-ts-contract" value="export interface {{pascalCase FEATURE_NAME}} {&#10; id: number;&#10; $FIELD1$&#10;}&#10;&#10;export interface Create{{pascalCase FEATURE_NAME}}Request {&#10; $FIELD2$&#10;}&#10;&#10;export interface Update{{pascalCase FEATURE_NAME}}Request {&#10; $END$&#10;}" description="MORPH TypeScript contract template" toReformat="false" toShortenFQNames="true">
86
+ <variable name="FIELD1" expression="" defaultValue="&quot;&quot;" alwaysStopAt="true" />
87
+ <variable name="FIELD2" expression="" defaultValue="&quot;&quot;" alwaysStopAt="true" />
88
+ <context>
89
+ <option name="TypeScript" value="true" />
90
+ </context>
91
+ </template>
92
+ </templateSet>
@@ -0,0 +1,186 @@
1
+ {
2
+ "MORPH Template - PascalCase": {
3
+ "prefix": "morph-pascal",
4
+ "body": ["{{pascalCase ${1:FEATURE_NAME}}}"],
5
+ "description": "Convert to PascalCase (UserAuth)"
6
+ },
7
+ "MORPH Template - camelCase": {
8
+ "prefix": "morph-camel",
9
+ "body": ["{{camelCase ${1:FEATURE_NAME}}}"],
10
+ "description": "Convert to camelCase (userAuth)"
11
+ },
12
+ "MORPH Template - snake_case": {
13
+ "prefix": "morph-snake",
14
+ "body": ["{{snakeCase ${1:FEATURE_NAME}}}"],
15
+ "description": "Convert to snake_case (user_auth)"
16
+ },
17
+ "MORPH Template - Title Case": {
18
+ "prefix": "morph-title",
19
+ "body": ["{{titleCase ${1:FEATURE_NAME}}}"],
20
+ "description": "Convert to Title Case (User Auth)"
21
+ },
22
+ "MORPH Template - kebab-case": {
23
+ "prefix": "morph-kebab",
24
+ "body": ["{{kebabCase ${1:FEATURE_NAME}}}"],
25
+ "description": "Convert to kebab-case (user-auth)"
26
+ },
27
+ "MORPH Template - UPPER_SNAKE_CASE": {
28
+ "prefix": "morph-upper-snake",
29
+ "body": ["{{upperSnakeCase ${1:FEATURE_NAME}}}"],
30
+ "description": "Convert to UPPER_SNAKE_CASE (USER_AUTH)"
31
+ },
32
+ "MORPH Template - Conditional If": {
33
+ "prefix": "morph-if",
34
+ "body": [
35
+ "{{#if ${1:condition}}}",
36
+ " $2",
37
+ "{{/if}}"
38
+ ],
39
+ "description": "Handlebars if block"
40
+ },
41
+ "MORPH Template - Conditional If-Else": {
42
+ "prefix": "morph-if-else",
43
+ "body": [
44
+ "{{#if ${1:condition}}}",
45
+ " $2",
46
+ "{{else}}",
47
+ " $3",
48
+ "{{/if}}"
49
+ ],
50
+ "description": "Handlebars if-else block"
51
+ },
52
+ "MORPH Template - Each Loop": {
53
+ "prefix": "morph-each",
54
+ "body": [
55
+ "{{#each ${1:items}}}",
56
+ " {{this.$2}}",
57
+ "{{/each}}"
58
+ ],
59
+ "description": "Handlebars each loop"
60
+ },
61
+ "MORPH Template - Unless": {
62
+ "prefix": "morph-unless",
63
+ "body": [
64
+ "{{#unless ${1:condition}}}",
65
+ " $2",
66
+ "{{/unless}}"
67
+ ],
68
+ "description": "Handlebars unless block"
69
+ },
70
+ "MORPH Template - .NET Service Class": {
71
+ "prefix": "morph-service",
72
+ "body": [
73
+ "namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Services;",
74
+ "",
75
+ "public class {{pascalCase FEATURE_NAME}}Service(",
76
+ " I{{pascalCase FEATURE_NAME}}Repository repository,",
77
+ " ILogger<{{pascalCase FEATURE_NAME}}Service> logger) : I{{pascalCase FEATURE_NAME}}Service",
78
+ "{",
79
+ " public async Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default)",
80
+ " {",
81
+ " $1",
82
+ " }",
83
+ "}"
84
+ ],
85
+ "description": "MORPH .NET Service class template"
86
+ },
87
+ "MORPH Template - .NET Repository Class": {
88
+ "prefix": "morph-repository",
89
+ "body": [
90
+ "public class {{pascalCase FEATURE_NAME}}Repository(AppDbContext context) : I{{pascalCase FEATURE_NAME}}Repository",
91
+ "{",
92
+ " private readonly DbSet<{{pascalCase FEATURE_NAME}}> _dbSet = context.Set<{{pascalCase FEATURE_NAME}}>();",
93
+ "",
94
+ " public async Task<{{pascalCase FEATURE_NAME}}?> GetByIdAsync(int id, CancellationToken cancellationToken = default)",
95
+ " {",
96
+ " $1",
97
+ " }",
98
+ "}"
99
+ ],
100
+ "description": "MORPH .NET Repository class template"
101
+ },
102
+ "MORPH Template - Blazor Component": {
103
+ "prefix": "morph-component",
104
+ "body": [
105
+ "@page \"/{{kebabCase FEATURE_NAME}}\"",
106
+ "@inject I{{pascalCase FEATURE_NAME}}Service {{pascalCase FEATURE_NAME}}Service",
107
+ "@inject ILogger<{{pascalCase FEATURE_NAME}}Page> Logger",
108
+ "",
109
+ "<PageTitle>{{pascalCase FEATURE_NAME}}</PageTitle>",
110
+ "",
111
+ "<div class=\"container-fluid\">",
112
+ " $1",
113
+ "</div>",
114
+ "",
115
+ "@code {",
116
+ " $2",
117
+ "}"
118
+ ],
119
+ "description": "MORPH Blazor component template"
120
+ },
121
+ "MORPH Template - EF Core Migration": {
122
+ "prefix": "morph-migration",
123
+ "body": [
124
+ "public partial class Add{{pascalCase FEATURE_NAME}} : Migration",
125
+ "{",
126
+ " protected override void Up(MigrationBuilder migrationBuilder)",
127
+ " {",
128
+ " migrationBuilder.CreateTable(",
129
+ " name: \"{{pascalCase FEATURE_NAME}}s\",",
130
+ " columns: table => new",
131
+ " {",
132
+ " Id = table.Column<int>(type: \"int\", nullable: false)",
133
+ " .Annotation(\"SqlServer:Identity\", \"1, 1\"),",
134
+ " $1",
135
+ " },",
136
+ " constraints: table =>",
137
+ " {",
138
+ " table.PrimaryKey(\"PK_{{pascalCase FEATURE_NAME}}s\", x => x.Id);",
139
+ " });",
140
+ " }",
141
+ "",
142
+ " protected override void Down(MigrationBuilder migrationBuilder)",
143
+ " {",
144
+ " migrationBuilder.DropTable(name: \"{{pascalCase FEATURE_NAME}}s\");",
145
+ " }",
146
+ "}"
147
+ ],
148
+ "description": "MORPH EF Core migration template"
149
+ },
150
+ "MORPH Template - Hangfire Job": {
151
+ "prefix": "morph-job",
152
+ "body": [
153
+ "public class {{pascalCase FEATURE_NAME}}ProcessorJob(",
154
+ " I{{pascalCase FEATURE_NAME}}Service service,",
155
+ " ILogger<{{pascalCase FEATURE_NAME}}ProcessorJob> logger) : I{{pascalCase FEATURE_NAME}}ProcessorJob",
156
+ "{",
157
+ " [AutomaticRetry(Attempts = 3, DelaysInSeconds = new[] { 60, 300, 900 })]",
158
+ " [Queue(\"default\")]",
159
+ " [JobDisplayName(\"{{pascalCase FEATURE_NAME}} Processing - ID: {0}\")]",
160
+ " public async Task ExecuteAsync(int id, CancellationToken cancellationToken)",
161
+ " {",
162
+ " $1",
163
+ " }",
164
+ "}"
165
+ ],
166
+ "description": "MORPH Hangfire job template"
167
+ },
168
+ "MORPH Template - TypeScript Contract": {
169
+ "prefix": "morph-ts-contract",
170
+ "body": [
171
+ "export interface {{pascalCase FEATURE_NAME}} {",
172
+ " id: number;",
173
+ " $1",
174
+ "}",
175
+ "",
176
+ "export interface Create{{pascalCase FEATURE_NAME}}Request {",
177
+ " $2",
178
+ "}",
179
+ "",
180
+ "export interface Update{{pascalCase FEATURE_NAME}}Request {",
181
+ " $3",
182
+ "}"
183
+ ],
184
+ "description": "MORPH TypeScript contract template"
185
+ }
186
+ }