dhurandhar 1.0.0

package/src/core/schemas/design-module-schema.yaml

@@ -0,0 +1,995 @@
+# Design Module Schema - Engineering-First Blueprint
+# Defines the structure and validation rules for Dhurandhar design modules
+# Focus: Technical specifications, not business justifications
+
+schema_version: "2.0"
+name: "design-module"
+description: "Engineering-first schema for system architecture blueprints"
+
+# Required fields - minimal, technical only
+required:
+  - code
+  - name
+  - version
+  - description
+  - tech_stack
+
+# Field definitions
+fields:
+  code:
+    type: string
+    pattern: "^[a-z0-9-]+$"
+    description: "Unique module identifier (lowercase, alphanumeric, hyphens only)"
+    examples:
+      - "my-module"
+      - "web-app-design"
+
+  name:
+    type: string
+    min_length: 3
+    max_length: 100
+    description: "Human-readable module name"
+    examples:
+      - "My Design Module"
+      - "Web Application Architecture"
+
+  version:
+    type: string
+    pattern: "^\\d+\\.\\d+\\.\\d+$"
+    description: "Semantic version number"
+    examples:
+      - "1.0.0"
+      - "0.1.0"
+
+  description:
+    type: string
+    min_length: 10
+    max_length: 500
+    description: "Technical description - what it does, not why"
+
+  tech_stack:
+    type: object
+    description: "Required technology stack specifications"
+    required:
+      - primary_language
+    properties:
+      primary_language:
+        type: string
+        description: "Primary programming language"
+        examples: ["Go", "TypeScript", "Python", "Rust"]
+      frameworks:
+        type: array
+        item_type: string
+        optional: true
+        description: "Frameworks in use"
+        examples: [["Echo", "GORM"], ["Express", "Prisma"]]
+      databases:
+        type: array
+        item_type: string
+        optional: true
+        description: "Database systems"
+        examples: [["PostgreSQL", "Redis"], ["MongoDB"]]
+      infrastructure:
+        type: array
+        item_type: string
+        optional: true
+        description: "Infrastructure components"
+        examples: [["Docker", "Kubernetes"], ["AWS Lambda"]]
+  
+  author:
+    type: string
+    optional: true
+    description: "Module author or organization"
+  
+  license:
+    type: string
+    optional: true
+    default: "MIT"
+    description: "License identifier"
+    examples:
+      - "MIT"
+      - "Apache-2.0"
+      - "GPL-3.0"
+  
+  tags:
+    type: array
+    item_type: string
+    optional: true
+    description: "Module tags for categorization"
+  
+  dependencies:
+    type: array
+    item_type: string
+    optional: true
+    default: []
+    description: "List of required module codes"
+
+  # NEW: User Types - Define who interacts with the system
+  user_types:
+    type: array
+    optional: true
+    description: "User roles and permissions (technical definition)"
+    items:
+      type: object
+      required:
+        - role
+        - permissions
+      properties:
+        role:
+          type: string
+          description: "Role identifier (e.g., admin, user, api_client)"
+        permissions:
+          type: array
+          item_type: string
+          description: "List of permission codes"
+          examples: [["read:users", "write:users"], ["read:public"]]
+        attributes:
+          type: object
+          optional: true
+          description: "Role-specific attributes (JWT claims, session data)"
+        authentication:
+          type: string
+          optional: true
+          enum: ["jwt", "session", "api_key", "oauth2", "none"]
+          description: "Authentication mechanism for this role"
+
+  # NEW: Entities & Relationships - ERD-like structure
+  entities:
+    type: array
+    optional: true
+    description: "Database entities with attributes and relationships"
+    items:
+      type: object
+      required:
+        - name
+        - attributes
+      properties:
+        name:
+          type: string
+          pattern: "^[A-Z][a-zA-Z0-9]*$"
+          description: "Entity name (PascalCase, e.g., User, BlogPost)"
+        table_name:
+          type: string
+          optional: true
+          description: "Database table name (defaults to snake_case of name)"
+        attributes:
+          type: array
+          description: "Entity attributes/columns"
+          items:
+            type: object
+            required:
+              - name
+              - type
+            properties:
+              name:
+                type: string
+                description: "Attribute name"
+              type:
+                type: string
+                description: "Data type (int, varchar, uuid, timestamp, etc.)"
+              constraints:
+                type: array
+                item_type: string
+                optional: true
+                description: "Constraints (primary_key, unique, not_null, indexed)"
+              default:
+                type: any
+                optional: true
+                description: "Default value"
+        relationships:
+          type: array
+          optional: true
+          description: "Relationships with other entities"
+          items:
+            type: object
+            required:
+              - type
+              - target
+            properties:
+              type:
+                type: string
+                enum: ["one_to_one", "one_to_many", "many_to_one", "many_to_many"]
+                description: "Relationship cardinality"
+              target:
+                type: string
+                description: "Target entity name"
+              foreign_key:
+                type: string
+                optional: true
+                description: "Foreign key column name"
+              through:
+                type: string
+                optional: true
+                description: "Junction table for many_to_many"
+              cascade:
+                type: string
+                optional: true
+                enum: ["delete", "nullify", "restrict"]
+                description: "Cascade behavior on delete"
+  
+  # NEW: Service Architecture - Microservices with tech stack
+  services:
+    type: array
+    optional: true
+    description: "Microservice definitions with mandatory tech specs"
+    items:
+      type: object
+      required:
+        - name
+        - scope
+        - tech_stack
+      properties:
+        name:
+          type: string
+          pattern: "^[a-z0-9-]+$"
+          description: "Service name (kebab-case, e.g., auth-service, user-service)"
+        scope:
+          type: string
+          description: "Technical scope - what this service does (1-2 sentences max)"
+          examples:
+            - "Handles JWT authentication and session management"
+            - "CRUD operations for user profiles and preferences"
+        tech_stack:
+          type: object
+          required:
+            - language
+            - framework
+          properties:
+            language:
+              type: string
+              description: "Programming language"
+              examples: ["Go", "TypeScript", "Python", "Rust", "Java"]
+            framework:
+              type: string
+              description: "Web framework"
+              examples: ["Echo", "Express", "FastAPI", "Actix", "Spring"]
+            database:
+              type: string
+              optional: true
+              description: "Primary database"
+              examples: ["PostgreSQL", "MongoDB", "Redis"]
+            orm:
+              type: string
+              optional: true
+              description: "ORM/Database library"
+              examples: ["GORM", "Prisma", "SQLAlchemy", "Diesel"]
+        api:
+          type: object
+          optional: true
+          description: "API boundary definition"
+          properties:
+            type:
+              type: string
+              enum: ["rest", "grpc", "graphql", "websocket"]
+              default: "rest"
+            base_path:
+              type: string
+              description: "API base path"
+              examples: ["/api/v1/auth", "/api/v1/users"]
+            port:
+              type: integer
+              optional: true
+              description: "Service port"
+            endpoints:
+              type: array
+              optional: true
+              description: "Key endpoints (optional, for documentation)"
+              items:
+                type: object
+                properties:
+                  method:
+                    type: string
+                    enum: ["GET", "POST", "PUT", "PATCH", "DELETE"]
+                  path:
+                    type: string
+                  description:
+                    type: string
+        dependencies:
+          type: array
+          item_type: string
+          optional: true
+          description: "Other services this depends on"
+        data_access:
+          type: array
+          item_type: string
+          optional: true
+          description: "Entities this service has access to"
+        environment:
+          type: object
+          optional: true
+          description: "Required environment variables (keys only, no values)"
+          properties:
+            required:
+              type: array
+              item_type: string
+              description: "Required env vars"
+              examples: [["DATABASE_URL", "JWT_SECRET"]]
+            optional:
+              type: array
+              item_type: string
+              optional: true
+              description: "Optional env vars"
+
+  design_components:
+    type: array
+    optional: true
+    description: "Legacy - prefer 'services' for new designs"
+    items:
+      type: object
+      required:
+        - name
+        - type
+      properties:
+        name:
+          type: string
+          pattern: "^[a-z0-9-]+$"
+        type:
+          type: string
+          enum: ["application", "service", "datastore", "infrastructure", "external"]
+        description:
+          type: string
+          optional: true
+        properties:
+          type: object
+          optional: true
+  
+  relationships:
+    type: array
+    optional: true
+    description: "Relationships between components"
+    items:
+      type: object
+      required:
+        - from
+        - to
+        - type
+      properties:
+        from:
+          type: string
+          description: "Source component name"
+        to:
+          type: string
+          description: "Target component name"
+        type:
+          type: string
+          description: "Relationship type"
+        description:
+          type: string
+          optional: true
+  
+  build_processes:
+    type: array
+    optional: true
+    description: "Build and deployment processes"
+    items:
+      type: object
+      required:
+        - name
+        - steps
+      properties:
+        name:
+          type: string
+        description:
+          type: string
+          optional: true
+        steps:
+          type: array
+          item_type: string
+
+  # NEW: Technical Decision Registry - Bmad-inspired "Stock of Decisions"
+  decision_registry:
+    type: object
+    optional: true
+    description: "Centralized registry of all technical decisions and standards"
+    properties:
+      naming_conventions:
+        type: object
+        optional: true
+        description: "Naming standards across the codebase"
+        properties:
+          case_styles:
+            type: object
+            optional: true
+            description: "Case style rules for different code elements"
+            properties:
+              classes:
+                type: string
+                enum: ["PascalCase", "camelCase", "snake_case", "kebab-case"]
+                description: "Class and type naming"
+              functions:
+                type: string
+                enum: ["PascalCase", "camelCase", "snake_case", "kebab-case"]
+                description: "Function and method naming"
+              variables:
+                type: string
+                enum: ["PascalCase", "camelCase", "snake_case", "kebab-case"]
+                description: "Variable naming"
+              constants:
+                type: string
+                enum: ["SCREAMING_SNAKE_CASE", "PascalCase", "camelCase"]
+                description: "Constant naming"
+              database_tables:
+                type: string
+                enum: ["snake_case", "PascalCase", "camelCase"]
+                description: "Database table naming"
+              database_columns:
+                type: string
+                enum: ["snake_case", "camelCase", "PascalCase"]
+                description: "Database column naming"
+              api_endpoints:
+                type: string
+                enum: ["kebab-case", "snake_case", "camelCase"]
+                description: "API endpoint path naming"
+
+          file_patterns:
+            type: object
+            optional: true
+            description: "File naming patterns"
+            properties:
+              components:
+                type: string
+                description: "e.g., 'ComponentName.jsx', 'component-name.vue'"
+              services:
+                type: string
+                description: "e.g., 'UserService.ts', 'user_service.py'"
+              models:
+                type: string
+                description: "e.g., 'User.model.ts', 'user.go'"
+              tests:
+                type: string
+                description: "e.g., 'User.test.ts', 'user_test.go'"
+
+          prefixes_suffixes:
+            type: object
+            optional: true
+            description: "Mandatory prefixes or suffixes"
+            properties:
+              interfaces:
+                type: string
+                description: "e.g., 'I' prefix (IUserService)"
+              abstract_classes:
+                type: string
+                description: "e.g., 'Abstract' prefix or 'Base' prefix"
+              test_functions:
+                type: string
+                description: "e.g., 'test_' prefix, 'should_' prefix"
+              private_methods:
+                type: string
+                description: "e.g., '_' prefix"
+
+      design_patterns:
+        type: object
+        optional: true
+        description: "Mandatory architectural patterns as implementation constraints"
+        properties:
+          data_access:
+            type: string
+            enum: ["repository_pattern", "active_record", "data_mapper", "direct_queries"]
+            description: "How services access data"
+          service_layer:
+            type: string
+            enum: ["service_classes", "function_modules", "handlers_only"]
+            description: "Service layer organization"
+          dependency_injection:
+            type: string
+            enum: ["constructor_injection", "property_injection", "service_locator", "none"]
+            description: "DI pattern"
+          validation:
+            type: string
+            enum: ["dto_validation", "middleware_validation", "domain_validation"]
+            description: "Where validation occurs"
+          cqrs:
+            type: boolean
+            optional: true
+            description: "Use CQRS pattern (separate read/write models)"
+          event_sourcing:
+            type: boolean
+            optional: true
+            description: "Use event sourcing for state"
+          domain_driven_design:
+            type: boolean
+            optional: true
+            description: "Apply DDD principles"
+
+          service_specific_patterns:
+            type: array
+            item_type: object
+            optional: true
+            description: "Patterns mandated for specific services"
+            item_properties:
+              service:
+                type: string
+                description: "Service name"
+              pattern:
+                type: string
+                description: "Pattern to apply (e.g., 'CQRS', 'Saga Pattern')"
+              rationale:
+                type: string
+                optional: true
+                description: "Why this pattern for this service"
+
+      error_response_standards:
+        type: object
+        optional: true
+        description: "Standardized error handling and response formats"
+        properties:
+          error_code_mapping:
+            type: object
+            optional: true
+            description: "Internal error codes to HTTP status mapping"
+            properties:
+              validation_error:
+                type: integer
+                description: "HTTP status for validation errors (e.g., 400)"
+              authentication_error:
+                type: integer
+                description: "HTTP status for auth errors (e.g., 401)"
+              authorization_error:
+                type: integer
+                description: "HTTP status for permission errors (e.g., 403)"
+              not_found_error:
+                type: integer
+                description: "HTTP status for not found (e.g., 404)"
+              conflict_error:
+                type: integer
+                description: "HTTP status for conflicts (e.g., 409)"
+              internal_error:
+                type: integer
+                description: "HTTP status for server errors (e.g., 500)"
+
+          response_envelope:
+            type: object
+            optional: true
+            description: "Standardized JSON response structure"
+            properties:
+              success_format:
+                type: string
+                description: "e.g., '{\"data\": {}, \"meta\": {}}'"
+              error_format:
+                type: string
+                description: "e.g., '{\"error\": {\"code\": \"\", \"message\": \"\", \"details\": []}}'"
+              include_request_id:
+                type: boolean
+                description: "Include request ID in all responses"
+              include_timestamp:
+                type: boolean
+                description: "Include timestamp in all responses"
+
+          error_detail_level:
+            type: string
+            enum: ["minimal", "standard", "verbose", "debug_only"]
+            optional: true
+            description: "How much error detail to expose to clients"
+
+      observability_standards:
+        type: object
+        optional: true
+        description: "Logging, tracing, and metrics standards"
+        properties:
+          logging:
+            type: object
+            optional: true
+            description: "Logging standards"
+            properties:
+              levels:
+                type: array
+                item_type: string
+                description: "Allowed log levels (e.g., ['DEBUG', 'INFO', 'WARN', 'ERROR'])"
+              structured_logging:
+                type: boolean
+                description: "Use structured JSON logging"
+              mandatory_fields:
+                type: array
+                item_type: string
+                description: "Fields required in every log (e.g., ['trace_id', 'service_name', 'timestamp'])"
+              sensitive_data_masking:
+                type: boolean
+                description: "Mask sensitive data in logs"
+
+          tracing:
+            type: object
+            optional: true
+            description: "Distributed tracing standards"
+            properties:
+              trace_id_header:
+                type: string
+                description: "HTTP header for trace ID (e.g., 'X-Trace-ID')"
+              correlation_id_header:
+                type: string
+                description: "HTTP header for correlation ID (e.g., 'X-Correlation-ID')"
+              span_naming_format:
+                type: string
+                description: "Format for span names (e.g., 'service.operation')"
+
+          metrics:
+            type: object
+            optional: true
+            description: "Metrics and monitoring standards"
+            properties:
+              naming_format:
+                type: string
+                description: "Metric naming format (e.g., 'service_name_metric_name_unit')"
+              mandatory_labels:
+                type: array
+                item_type: string
+                description: "Labels required on all metrics (e.g., ['service', 'environment', 'version'])"
+              latency_buckets:
+                type: array
+                item_type: number
+                description: "Histogram buckets for latency metrics"
+
+      api_standards:
+        type: object
+        optional: true
+        description: "API design and versioning standards"
+        properties:
+          versioning_strategy:
+            type: string
+            enum: ["url_path", "header", "query_param", "content_negotiation"]
+            description: "How APIs are versioned"
+          version_format:
+            type: string
+            description: "Version format (e.g., 'v1', '1.0', '2023-01-01')"
+          pagination:
+            type: object
+            optional: true
+            description: "Pagination standards"
+            properties:
+              style:
+                type: string
+                enum: ["offset_limit", "cursor", "page_number"]
+              default_page_size:
+                type: integer
+              max_page_size:
+                type: integer
+
+          rate_limiting:
+            type: object
+            optional: true
+            description: "Rate limiting standards"
+            properties:
+              enabled:
+                type: boolean
+              default_limit:
+                type: integer
+                description: "Requests per window"
+              window:
+                type: string
+                description: "Time window (e.g., '1m', '1h')"
+
+      code_quality_standards:
+        type: object
+        optional: true
+        description: "Code quality and testing standards"
+        properties:
+          test_coverage_minimum:
+            type: integer
+            description: "Minimum code coverage percentage"
+          documentation_required:
+            type: boolean
+            description: "Require documentation for public APIs"
+          linting_rules:
+            type: string
+            description: "Linting configuration (e.g., 'eslint:recommended', 'golangci-lint')"
+          code_review_required:
+            type: boolean
+            description: "Require code review before merge"
+
+  # NEW: Technical Strategies - Pluggable Architectural Patterns
+  technical_strategies:
+    type: object
+    optional: true
+    description: "Pluggable architectural patterns and constraints"
+    properties:
+      persistence:
+        type: object
+        optional: true
+        description: "Data persistence strategy"
+        properties:
+          model:
+            type: string
+            enum: ["database_per_service", "shared_database", "hybrid", "event_sourcing"]
+            description: "Data isolation pattern"
+          constraints:
+            type: array
+            item_type: string
+            optional: true
+            description: "Technical constraints (e.g., 'no_cross_service_queries', 'eventual_consistency')"
+          database_assignments:
+            type: object
+            optional: true
+            description: "Service-to-database mappings for database_per_service"
+
+      state_management:
+        type: object
+        optional: true
+        description: "Caching and state distribution strategy"
+        properties:
+          caching_layer:
+            type: string
+            enum: ["distributed_redis", "local_in_memory", "sidecar_cache", "cdn_edge", "none"]
+            description: "Caching architecture"
+          session_storage:
+            type: string
+            enum: ["redis_distributed", "database", "jwt_stateless", "sticky_sessions"]
+            description: "Session management approach"
+          cache_invalidation:
+            type: string
+            enum: ["ttl_based", "event_driven", "manual", "write_through"]
+            optional: true
+
+      communication:
+        type: object
+        optional: true
+        description: "Service-to-service communication pattern"
+        properties:
+          primary_pattern:
+            type: string
+            enum: ["synchronous_rest", "asynchronous_events", "hybrid", "grpc_streaming", "graphql_federation"]
+            description: "Primary inter-service communication"
+          event_bus:
+            type: object
+            optional: true
+            description: "Event-driven infrastructure"
+            properties:
+              technology:
+                type: string
+                enum: ["kafka", "rabbitmq", "aws_sns_sqs", "redis_streams", "nats"]
+              topics_or_queues:
+                type: array
+                item_type: string
+                optional: true
+              message_format:
+                type: string
+                enum: ["json", "avro", "protobuf"]
+                optional: true
+          api_gateway:
+            type: object
+            optional: true
+            properties:
+              technology:
+                type: string
+                enum: ["nginx", "kong", "aws_api_gateway", "envoy", "custom"]
+              features:
+                type: array
+                item_type: string
+                optional: true
+                description: "e.g., rate_limiting, auth, load_balancing"
+
+      deployment:
+        type: object
+        optional: true
+        description: "Deployment and orchestration strategy"
+        properties:
+          orchestration:
+            type: string
+            enum: ["kubernetes", "docker_swarm", "ecs", "nomad", "serverless"]
+          scaling_strategy:
+            type: string
+            enum: ["horizontal_pod_autoscaling", "vertical_scaling", "manual", "serverless_auto"]
+            optional: true
+          service_mesh:
+            type: object
+            optional: true
+            properties:
+              enabled:
+                type: boolean
+              technology:
+                type: string
+                enum: ["istio", "linkerd", "consul", "none"]
+
+      observability:
+        type: object
+        optional: true
+        description: "Monitoring and observability strategy"
+        properties:
+          logging:
+            type: string
+            enum: ["centralized_elk", "cloudwatch", "datadog", "splunk", "loki"]
+          metrics:
+            type: string
+            enum: ["prometheus", "datadog", "cloudwatch", "grafana_cloud"]
+          tracing:
+            type: string
+            enum: ["jaeger", "zipkin", "aws_xray", "datadog_apm", "none"]
+          distributed_tracing:
+            type: boolean
+            optional: true
+
+      security:
+        type: object
+        optional: true
+        description: "Security architecture patterns"
+        properties:
+          authentication:
+            type: string
+            enum: ["jwt_centralized", "oauth2_delegated", "mtls", "api_keys", "hybrid"]
+          authorization:
+            type: string
+            enum: ["rbac", "abac", "policy_engine_opa", "service_level"]
+          secrets_management:
+            type: string
+            enum: ["vault", "aws_secrets_manager", "kubernetes_secrets", "env_vars"]
+
+      resilience:
+        type: object
+        optional: true
+        description: "Fault tolerance and resilience patterns"
+        properties:
+          circuit_breaker:
+            type: boolean
+            description: "Enable circuit breaker pattern"
+          retry_strategy:
+            type: string
+            enum: ["exponential_backoff", "fixed_delay", "none"]
+            optional: true
+          timeout_policy:
+            type: string
+            enum: ["aggressive_5s", "moderate_30s", "lenient_60s", "custom"]
+            optional: true
+          bulkhead_isolation:
+            type: boolean
+            optional: true
+
+  # NEW: Agile Blueprint - Test-First Epic-Story-Task Hierarchy
+  agile_blueprint:
+    type: object
+    optional: true
+    description: "Test-first agile decomposition for contract-driven development"
+    properties:
+      epics:
+        type: array
+        description: "High-level system capabilities"
+        items:
+          type: object
+          required:
+            - id
+            - name
+            - stories
+          properties:
+            id:
+              type: string
+              pattern: "^EPIC-[0-9]+$"
+              description: "Epic identifier (e.g., EPIC-001)"
+            name:
+              type: string
+              description: "System capability (e.g., 'User Authentication & Authorization')"
+            description:
+              type: string
+              optional: true
+              description: "Technical overview of capability"
+            acceptance_criteria:
+              type: array
+              item_type: string
+              optional: true
+              description: "Technical acceptance criteria (not business value)"
+            stories:
+              type: array
+              description: "User journeys within this epic"
+              items:
+                type: object
+                required:
+                  - id
+                  - name
+                  - interaction_boundary
+                properties:
+                  id:
+                    type: string
+                    pattern: "^STORY-[0-9]+$"
+                    description: "Story identifier (e.g., STORY-001)"
+                  name:
+                    type: string
+                    description: "User journey (e.g., 'OAuth2 Social Login Flow')"
+                  interaction_boundary:
+                    type: object
+                    required:
+                      - service
+                      - api_endpoint
+                      - method
+                    description: "Technical API contract"
+                    properties:
+                      service:
+                        type: string
+                        description: "Target service name"
+                      api_endpoint:
+                        type: string
+                        description: "API path (e.g., /api/v1/auth/login)"
+                      method:
+                        type: string
+                        enum: ["GET", "POST", "PUT", "PATCH", "DELETE", "WEBSOCKET"]
+                      request_contract:
+                        type: object
+                        optional: true
+                        description: "Request schema"
+                      response_contract:
+                        type: object
+                        optional: true
+                        description: "Response schema"
+                      error_states:
+                        type: array
+                        optional: true
+                        description: "Expected error responses (400, 401, 404, 500, etc.)"
+                  technical_acceptance:
+                    type: array
+                    item_type: string
+                    optional: true
+                    description: "Technical validation criteria (not business goals)"
+                  tasks:
+                    type: array
+                    description: "Granular implementation tasks"
+                    items:
+                      type: object
+                      required:
+                        - id
+                        - description
+                        - type
+                      properties:
+                        id:
+                          type: string
+                          pattern: "^TASK-[0-9]+$"
+                        description:
+                          type: string
+                          description: "Technical task (e.g., 'Implement JWT rotation in Auth Service')"
+                        type:
+                          type: string
+                          enum: ["test", "implementation", "infrastructure", "migration"]
+                        linked_to:
+                          type: object
+                          optional: true
+                          description: "Link to service/entity/infrastructure"
+                          properties:
+                            type:
+                              type: string
+                              enum: ["service", "entity", "infrastructure"]
+                            name:
+                              type: string
+                        status:
+                          type: string
+                          enum: ["not_started", "in_progress", "complete", "blocked"]
+                          default: "not_started"
+                        test_coverage:
+                          type: object
+                          optional: true
+                          description: "Test status for this task"
+                          properties:
+                            test_file:
+                              type: string
+                            standard_flows:
+                              type: boolean
+                            error_states:
+                              type: boolean
+                            edge_cases:
+                              type: boolean
+
+      test_suite_status:
+        type: object
+        optional: true
+        description: "Overall test coverage tracking"
+        properties:
+          total_stories:
+            type: integer
+          tested_stories:
+            type: integer
+          coverage_percentage:
+            type: number
+          last_test_run:
+            type: string
+            description: "ISO timestamp"
+
+  exports:
+    type: object
+    optional: true
+    description: "Module exports (templates, utilities, schemas)"
+    properties:
+      templates:
+        type: array
+        item_type: string
+        optional: true
+      utilities:
+        type: array
+        item_type: string
+        optional: true
+      schemas:
+        type: array
+        item_type: string
+        optional: true