@polymorphism-tech/morph-spec 4.12.0 → 4.13.0

package/framework/standards/observability/monitoring.md

@@ -1,114 +0,0 @@
-# Observability Standard: Monitoring
-
-## Overview
-Application Insights configuration and KQL query patterns for production monitoring.
-
-## Application Insights Setup
-
-### Connection String (not Instrumentation Key)
-```csharp
-// appsettings.json — use connection string, not key
-{
-  "ApplicationInsights": {
-    "ConnectionString": "InstrumentationKey=..." // from Key Vault
-  }
-}
-
-// Program.cs
-builder.Services.AddApplicationInsightsTelemetry(
-    builder.Configuration["ApplicationInsights:ConnectionString"]);
-```
-
-### Sampling Configuration
-```csharp
-builder.Services.Configure<TelemetryConfiguration>(config =>
-{
-    var sampler = new AdaptiveSamplingTelemetryProcessor(null!);
-    sampler.MaxTelemetryItemsPerSecond = 5; // Limit volume
-    sampler.ExcludedTypes = "Request"; // Don't sample requests
-    config.TelemetryProcessorChainBuilder.Use(_ => sampler).Build();
-});
-```
-
-### Dependency Tracking
-```csharp
-// Auto-tracked: HTTP, SQL, Azure SDK calls
-// Manual tracking for custom operations:
-using var operation = telemetryClient.StartOperation<DependencyTelemetry>("ServiceBus.Send");
-operation.Telemetry.Type = "Azure Service Bus";
-operation.Telemetry.Target = queueName;
-try
-{
-    await sender.SendMessageAsync(message);
-    operation.Telemetry.Success = true;
-}
-catch (Exception ex)
-{
-    operation.Telemetry.Success = false;
-    telemetryClient.TrackException(ex);
-    throw;
-}
-```
-
-## KQL Queries — Common Scenarios
-
-### Request Success Rate (last 24h)
-```kql
-requests
-| where timestamp > ago(24h)
-| summarize
-    total = count(),
-    failed = countif(success == false),
-    successRate = round(100.0 * countif(success == true) / count(), 2)
-| project total, failed, successRate
-```
-
-### Slow Requests (> 2s)
-```kql
-requests
-| where duration > 2000 and timestamp > ago(1h)
-| project timestamp, name, url, duration, resultCode, cloud_RoleInstance
-| order by duration desc
-| take 20
-```
-
-### Exception Summary
-```kql
-exceptions
-| where timestamp > ago(24h)
-| summarize count() by type, outerMessage
-| order by count_ desc
-| take 10
-```
-
-### Dependency Failures
-```kql
-dependencies
-| where success == false and timestamp > ago(1h)
-| project timestamp, name, type, target, duration, resultCode, data
-| order by timestamp desc
-```
-
-### User Activity Heatmap
-```kql
-customEvents
-| where timestamp > ago(7d)
-| summarize events = count() by bin(timestamp, 1h), name
-| render timechart
-```
-
-## Alerting Rules
-
-| Alert | Condition | Severity |
-|-------|-----------|----------|
-| High error rate | `requests` failure rate > 5% for 5 min | Critical |
-| Slow response | P95 latency > 3s for 10 min | Warning |
-| Exception spike | Exception count > 100/min | Critical |
-| Dependency failure | Any dependency > 10 failures/min | Warning |
-
-## Dashboard Required Sections
-- Request volume + success rate (1h/24h/7d)
-- Top slow endpoints
-- Exception breakdown by type
-- Dependency health grid
-- Active user count

package/framework/standards/observability/tracing.md

@@ -1,132 +0,0 @@
-# Observability Standard: Distributed Tracing
-
-## Overview
-OpenTelemetry distributed tracing for cross-service correlation and performance analysis.
-
-## OpenTelemetry Setup
-
-### Packages
-```xml
-<PackageReference Include="OpenTelemetry.Extensions.Hosting" Version="1.*" />
-<PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.*" />
-<PackageReference Include="OpenTelemetry.Instrumentation.Http" Version="1.*" />
-<PackageReference Include="OpenTelemetry.Instrumentation.SqlClient" Version="1.*" />
-<PackageReference Include="Azure.Monitor.OpenTelemetry.AspNetCore" Version="1.*" />
-```
-
-### Program.cs Configuration
-```csharp
-builder.Services.AddOpenTelemetry()
-    .WithTracing(tracing =>
-    {
-        tracing
-            .AddAspNetCoreInstrumentation(opts =>
-            {
-                opts.RecordException = true;
-                opts.Filter = ctx => !ctx.Request.Path.StartsWithSegments("/health");
-            })
-            .AddHttpClientInstrumentation()
-            .AddSqlClientInstrumentation(opts => opts.SetDbStatementForText = true)
-            .AddSource(ActivitySource.Name) // Custom activities
-            .AddAzureMonitorTraceExporter(opts =>
-            {
-                opts.ConnectionString = config["ApplicationInsights:ConnectionString"];
-            });
-    });
-
-// Custom ActivitySource for domain operations
-public static class Telemetry
-{
-    public static readonly ActivitySource ActivitySource = new("MyApp", "1.0.0");
-}
-```
-
-## Custom Span Creation
-
-### Service Method Tracing
-```csharp
-public async Task<Order> ProcessOrderAsync(CreateOrderCommand command)
-{
-    using var activity = Telemetry.ActivitySource.StartActivity("ProcessOrder");
-    activity?.SetTag("order.userId", command.UserId.ToString());
-    activity?.SetTag("order.itemCount", command.Items.Count.ToString());
-
-    try
-    {
-        var order = await _repository.CreateAsync(command);
-        activity?.SetTag("order.id", order.Id.ToString());
-        activity?.SetStatus(ActivityStatusCode.Ok);
-        return order;
-    }
-    catch (Exception ex)
-    {
-        activity?.SetStatus(ActivityStatusCode.Error, ex.Message);
-        activity?.RecordException(ex);
-        throw;
-    }
-}
-```
-
-### Baggage (Cross-Service Context)
-```csharp
-// Set correlation ID in baggage (propagates across HTTP calls)
-Activity.Current?.SetBaggage("correlationId", correlationId);
-Activity.Current?.SetBaggage("userId", userId.ToString());
-
-// Read baggage downstream
-var correlationId = Activity.Current?.GetBaggageItem("correlationId");
-```
-
-## Trace Context Propagation
-
-### HTTP Client (auto-propagated)
-```csharp
-// HttpClient automatically propagates W3C trace context
-// Configure in DI:
-builder.Services.AddHttpClient("ExternalApi")
-    .AddOpenTelemetryInstrumentation();
-```
-
-### Service Bus (manual propagation)
-```csharp
-// Sender: inject trace context into message properties
-var message = new ServiceBusMessage(body);
-var activity = Activity.Current;
-if (activity != null)
-{
-    message.ApplicationProperties["traceparent"] = activity.Id;
-    message.ApplicationProperties["tracestate"] = activity.TraceStateString;
-}
-
-// Receiver: restore trace context from message
-if (message.ApplicationProperties.TryGetValue("traceparent", out var traceparent))
-{
-    using var linkedActivity = Telemetry.ActivitySource.StartActivity(
-        "ProcessMessage",
-        ActivityKind.Consumer,
-        parentId: traceparent.ToString()!);
-    await ProcessAsync(message);
-}
-```
-
-## Trace Sampling Strategy
-
-| Environment | Strategy | Rate |
-|-------------|----------|------|
-| Development | Always | 100% |
-| Staging | Adaptive | 10% + errors |
-| Production | Adaptive | 5% + errors |
-
-```csharp
-// Production adaptive sampling (errors always sampled)
-.AddAspNetCoreInstrumentation(opts =>
-{
-    opts.Enrich = (activity, eventName, obj) =>
-    {
-        if (obj is HttpResponse response && response.StatusCode >= 400)
-        {
-            activity.SetSampled(true); // Always sample errors
-        }
-    };
-})
-```

package/framework/standards/workflows/parallel-execution.md

@@ -1,112 +0,0 @@
-# Workflow Standard: Parallel Execution
-
-## When to Use Parallel Execution
-
-| Condition | Decision |
-|-----------|----------|
-| 5+ independent tasks | Use P-Threads |
-| Multi-domain (backend + frontend + infra) | Use P-Threads with squad templates |
-| 15+ files to create | Use P-Threads |
-| Tasks have zero dependency overlap | Use P-Threads |
-| Tasks share file scope | Do NOT parallelize |
-| Sequential data flow required | Do NOT parallelize |
-
-## Parallelization Planning
-
-### Step 1: Dependency Analysis
-```bash
-morph-spec detect-workflow user-auth
-
-# Identifies: parallelizable tasks, sequential chains, waves
-```
-
-### Step 2: File Scope Assignment
-Assign exclusive file ownership to each parallel worker:
-
-```
-Worker A (Backend):    Entities/, Services/, Controllers/, DTOs/
-Worker B (Frontend):   Pages/, Components/, CSS/
-Worker C (Infra):      infra/bicep/, .github/workflows/
-```
-
-No overlap allowed. If overlap is unavoidable, make it sequential.
-
-### Step 3: Choose Squad Template
-```bash
-morph-spec squad-template use full-stack --feature=user-auth
-
-# Creates execution plan based on full-stack.json template:
-# - dotnet-senior (backend lead)
-# - blazor-builder (frontend lead)
-# - bicep-architect (infra lead)
-# - thread-orchestrator (coordinator)
-```
-
-## Execution Flow
-
-```
-Orchestrator
-    │
-    ├── spawn parallel: Worker A (files: Entities/, Services/)
-    ├── spawn parallel: Worker B (files: Pages/, Components/)
-    └── spawn parallel: Worker C (files: infra/)
-    │
-    │   [Workers execute concurrently — no interaction]
-    │
-    ├── wait-all (poll or explicit sync)
-    │
-    ├── merge results (check for conflicts)
-    ├── run integration validation
-    └── report consolidated output
-```
-
-## Conflict Resolution
-
-### File Conflicts (two workers wrote same file)
-```bash
-# This should NOT happen if scopes are properly defined
-# If it does:
-morph-spec agents review aggregate user-auth \
-  --agents=dotnet-senior,blazor-builder \
-  --strategy=best-of-n
-```
-
-### Interface Mismatches (A expects contract B didn't fulfill)
-- Document the mismatch in the coordinator report
-- Fix in post-merge sequential step
-- Update contracts.cs to reflect actual implementation
-
-## Fusion vs Parallel
-
-| Aspect | Parallel (P-Thread) | Fusion (F-Thread) |
-|--------|--------------------|--------------------|
-| Goal | Divide scope | Compete on same scope |
-| Output | Different files | Same files, best one wins |
-| Workers collaborate? | No | No |
-| Merge | Combine all files | Select best implementation |
-| Use case | Large features | Design decisions, quality optimization |
-
-## Configuration
-```json
-// llm-interaction.json
-{
-  "parallelExecution": {
-    "enabled": true,
-    "maxConcurrent": 3,
-    "defaultStrategy": "best-of-n"
-  }
-}
-```
-
-## Squad Templates
-
-Pre-defined squad configurations in `framework/squad-templates/`:
-- `full-stack.json` — Backend + Frontend + Infra (6 agents)
-- `backend-only.json` — Backend specialists only (4 agents)
-- `frontend-only.json` — Frontend specialists only (3 agents)
-
-```bash
-morph-spec squad-template list
-morph-spec squad-template show full-stack
-morph-spec squad-template use full-stack --feature=user-auth
-```

package/framework/standards/workflows/thread-management.md

@@ -1,113 +0,0 @@
-# Workflow Standard: Thread Management
-
-## Thread Types
-
-| Type | Code | Purpose | Lifecycle |
-|------|------|---------|-----------|
-| Base | B-Thread | Default implementation thread | Bounded by feature phase |
-| Parallel | P-Thread | Concurrent isolated execution | Short (1 task scope) |
-| Fusion | F-Thread | Best-of-N competing implementations | Short (1 prompt scope) |
-| Long-Running | L-Thread | Multi-session persistent work | Days/weeks |
-| Zero-Touch | Z-Thread | Fully autonomous execution | Bounded by trust level |
-
-## Thread Lifecycle
-
-```
-pending → running → completed
-                  → failed → (retry) → running
-                           → killed
-```
-
-## Creating Threads
-```bash
-# Create a base thread (default)
-morph-spec threads status morph-next-gen
-
-# Create parallel threads for feature
-morph-spec spawn-team morph-next-gen --parallel backend,frontend,infra
-
-# Create fusion thread
-morph-spec agents fuse \
-  --prompt "Implement caching strategy for UserService" \
-  --count=3 \
-  --strategy=best-of-n \
-  --feature=morph-next-gen
-```
-
-## Thread State in state.json
-```json
-{
-  "threads": {
-    "thread-abc12345": {
-      "id": "thread-abc12345",
-      "type": "parallel",
-      "agent": "dotnet-senior",
-      "feature": "user-auth",
-      "status": "running",
-      "startedAt": "2026-02-19T00:00:00Z",
-      "events": [
-        { "type": "started", "timestamp": "..." },
-        { "type": "checkpoint_passed", "timestamp": "...", "checkpointNum": 1 }
-      ],
-      "metrics": {
-        "tasksCompleted": 3,
-        "checkpointsPassed": 1,
-        "errors": 0
-      }
-    }
-  }
-}
-```
-
-## Parallel Execution Rules (P-Threads)
-
-1. **File scope isolation**: Each P-Thread has exclusive write access to its files
-2. **No cross-thread dependencies**: P-Thread tasks are self-contained
-3. **Shared read access**: All P-Threads can read spec.md, standards, contracts
-4. **Merge on completion**: Coordinator merges results after all P-Threads complete
-5. **Max concurrent**: Default 3, max 5 (configurable in llm-interaction.json)
-
-## Dependency Analysis
-```bash
-# Analyze task dependencies for parallel opportunities
-morph-spec detect-workflow morph-next-gen
-
-# Output:
-# Parallelizable tasks: T001, T002, T003 (no dependencies)
-# Sequential: T004 (depends on T001), T005 (depends on T002)
-# Execution plan:
-#   Wave 1: [T001, T002, T003] (parallel)
-#   Wave 2: [T004, T005] (parallel, after wave 1)
-#   Wave 3: [T006] (sequential)
-```
-
-## Long-Running Threads (L-Threads)
-
-### Stop Hooks
-L-Threads run periodic stop hooks every 30 minutes:
-```json
-// llm-interaction.json
-{
-  "stopHooks": {
-    "enabled": true,
-    "interval": 30,
-    "maxRetries": 5,
-    "hooks": ["validate-and-continue", "validate-checkpoints"]
-  }
-}
-```
-
-### Resume Pattern
-```bash
-# Resume L-Thread from bundle
-morph-spec bundle load morph-next-gen
-# Load resume context, continue from checkpoint
-```
-
-## Monitoring
-```bash
-morph-spec threads list morph-next-gen
-morph-spec threads analytics morph-next-gen
-morph-spec threads wait-all morph-next-gen
-morph-spec threads wait-any morph-next-gen
-```

package/framework/templates/code/dotnet/backend/service.cs

@@ -1,139 +0,0 @@
-// ============================================================
-// SERVICE TEMPLATE
-// Generated by MORPH Framework
-// ============================================================
-
-using Microsoft.Extensions.Logging;
-
-namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Services;
-
-/// <summary>
-/// Service for managing {{pascalCase FEATURE_NAME}} operations.
-/// </summary>
-public class {{pascalCase FEATURE_NAME}}Service(
-    I{{pascalCase FEATURE_NAME}}Repository repository,
-    ILogger<{{pascalCase FEATURE_NAME}}Service> logger) : I{{pascalCase FEATURE_NAME}}Service
-{
-    /// <inheritdoc />
-    public async Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default)
-    {
-        logger.LogDebug("Getting {{pascalCase FEATURE_NAME}} with ID {Id}", id);
-
-        var entity = await repository.GetByIdAsync(id, cancellationToken);
-        if (entity is null)
-        {
-            logger.LogWarning("{{pascalCase FEATURE_NAME}} with ID {Id} not found", id);
-            return null;
-        }
-
-        return MapToDto(entity);
-    }
-
-    /// <inheritdoc />
-    public async Task<List<{{pascalCase FEATURE_NAME}}Dto>> GetAllAsync(CancellationToken cancellationToken = default)
-    {
-        logger.LogDebug("Getting all {{pascalCase FEATURE_NAME}}s");
-
-        var entities = await repository.GetAllAsync(cancellationToken);
-        return entities.Select(MapToDto).ToList();
-    }
-
-    /// <inheritdoc />
-    public async Task<{{pascalCase FEATURE_NAME}}Dto> CreateAsync(
-        Create{{pascalCase FEATURE_NAME}}Request request,
-        CancellationToken cancellationToken = default)
-    {
-        logger.LogInformation("Creating new {{pascalCase FEATURE_NAME}}: {Name}", request.Name);
-
-        // Validate
-        await ValidateCreateAsync(request, cancellationToken);
-
-        // Create entity
-        var entity = Domain.Entities.{{pascalCase FEATURE_NAME}}.Create(request.Name);
-
-        // Save
-        await repository.AddAsync(entity, cancellationToken);
-        await repository.SaveChangesAsync(cancellationToken);
-
-        logger.LogInformation("Created {{pascalCase FEATURE_NAME}} with ID {Id}", entity.Id);
-
-        return MapToDto(entity);
-    }
-
-    /// <inheritdoc />
-    public async Task UpdateAsync(
-        int id,
-        Update{{pascalCase FEATURE_NAME}}Request request,
-        CancellationToken cancellationToken = default)
-    {
-        logger.LogInformation("Updating {{pascalCase FEATURE_NAME}} {Id}", id);
-
-        var entity = await repository.GetByIdAsync(id, cancellationToken)
-            ?? throw new {{pascalCase FEATURE_NAME}}NotFoundException(id);
-
-        // Validate
-        await ValidateUpdateAsync(entity, request, cancellationToken);
-
-        // Update entity
-        entity.UpdateName(request.Name);
-
-        // Save
-        repository.Update(entity);
-        await repository.SaveChangesAsync(cancellationToken);
-
-        logger.LogInformation("Updated {{pascalCase FEATURE_NAME}} {Id}", id);
-    }
-
-    /// <inheritdoc />
-    public async Task DeleteAsync(int id, CancellationToken cancellationToken = default)
-    {
-        logger.LogInformation("Deleting {{pascalCase FEATURE_NAME}} {Id}", id);
-
-        var entity = await repository.GetByIdAsync(id, cancellationToken)
-            ?? throw new {{pascalCase FEATURE_NAME}}NotFoundException(id);
-
-        // Soft delete or remove
-        repository.Remove(entity);
-        await repository.SaveChangesAsync(cancellationToken);
-
-        logger.LogInformation("Deleted {{pascalCase FEATURE_NAME}} {Id}", id);
-    }
-
-    #region Private Methods
-
-    private static {{pascalCase FEATURE_NAME}}Dto MapToDto(Domain.Entities.{{pascalCase FEATURE_NAME}} entity)
-    {
-        return new {{pascalCase FEATURE_NAME}}Dto(
-            entity.Id,
-            entity.Name,
-            entity.Status,
-            entity.CreatedAt,
-            entity.UpdatedAt
-        );
-    }
-
-    private async Task ValidateCreateAsync(
-        Create{{pascalCase FEATURE_NAME}}Request request,
-        CancellationToken cancellationToken)
-    {
-        // Add validation logic here
-        // Example: Check for duplicates
-        // var existing = await repository.FindByNameAsync(request.Name, cancellationToken);
-        // if (existing is not null)
-        //     throw new ValidationException("Name already exists");
-
-        await Task.CompletedTask;
-    }
-
-    private async Task ValidateUpdateAsync(
-        Domain.Entities.{{pascalCase FEATURE_NAME}} entity,
-        Update{{pascalCase FEATURE_NAME}}Request request,
-        CancellationToken cancellationToken)
-    {
-        // Add validation logic here
-
-        await Task.CompletedTask;
-    }
-
-    #endregion
-}

package/framework/templates/code/dotnet/contracts/Commands.cs

@@ -1,74 +0,0 @@
-// ============================================================================
-// {{titleCase FEATURE_NAME}} - Commands (CQRS)
-// Generated by MORPH-SPEC Framework
-// ============================================================================
-
-using MediatR;
-
-namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Commands;
-
-// ============================================================================
-// Create Command
-// ============================================================================
-
-/// <summary>
-/// Command to create a new {{titleCase FEATURE_NAME}}
-/// </summary>
-public record Create{{pascalCase FEATURE_NAME}}Command : IRequest<Create{{pascalCase FEATURE_NAME}}Result>
-{
-    // TODO: Add required properties
-    // public required string Name { get; init; }
-}
-
-public record Create{{pascalCase FEATURE_NAME}}Result
-{
-    public bool IsSuccess { get; init; }
-    public int? Id { get; init; }
-    public string? Error { get; init; }
-
-    public static Create{{pascalCase FEATURE_NAME}}Result Success(int id) => new() { IsSuccess = true, Id = id };
-    public static Create{{pascalCase FEATURE_NAME}}Result Failure(string error) => new() { IsSuccess = false, Error = error };
-}
-
-// ============================================================================
-// Update Command
-// ============================================================================
-
-/// <summary>
-/// Command to update an existing {{titleCase FEATURE_NAME}}
-/// </summary>
-public record Update{{pascalCase FEATURE_NAME}}Command : IRequest<Update{{pascalCase FEATURE_NAME}}Result>
-{
-    public required int Id { get; init; }
-    // TODO: Add updatable properties
-}
-
-public record Update{{pascalCase FEATURE_NAME}}Result
-{
-    public bool IsSuccess { get; init; }
-    public string? Error { get; init; }
-
-    public static Update{{pascalCase FEATURE_NAME}}Result Success() => new() { IsSuccess = true };
-    public static Update{{pascalCase FEATURE_NAME}}Result Failure(string error) => new() { IsSuccess = false, Error = error };
-}
-
-// ============================================================================
-// Delete Command
-// ============================================================================
-
-/// <summary>
-/// Command to delete a {{titleCase FEATURE_NAME}}
-/// </summary>
-public record Delete{{pascalCase FEATURE_NAME}}Command : IRequest<Delete{{pascalCase FEATURE_NAME}}Result>
-{
-    public required int Id { get; init; }
-}
-
-public record Delete{{pascalCase FEATURE_NAME}}Result
-{
-    public bool IsSuccess { get; init; }
-    public string? Error { get; init; }
-
-    public static Delete{{pascalCase FEATURE_NAME}}Result Success() => new() { IsSuccess = true };
-    public static Delete{{pascalCase FEATURE_NAME}}Result Failure(string error) => new() { IsSuccess = false, Error = error };
-}