@defai.digital/cli 13.4.4 → 13.4.7

package/bundled/workflows/contract-first-project.yaml

@@ -0,0 +1,356 @@
+workflowId: contract-first-project
+version: "1.0.0"
+name: Contract-First Project Scaffold
+description: Generate a complete contract-first project structure with schemas, invariants, domain packages, and guard policies
+
+metadata:
+  category: scaffold
+  tags:
+    - contract-first
+    - scaffold
+    - architecture
+    - ddd
+    - domain-modeling
+  requiredAbilities:
+    - contract-first
+    - domain-modeling
+    - invariant-writing
+  estimatedDuration: 180
+  complexity: high
+
+steps:
+  - stepId: gather-requirements
+    name: Gather Domain Requirements
+    description: Analyze input to identify bounded context, entities, and business rules
+    type: prompt
+    timeout: 120000
+    config:
+      agentId: contract-architect
+      prompt: |
+        Analyze the domain requirements and identify:
+
+        ## 1. Bounded Context
+        - What is the core domain?
+        - What problem does it solve?
+        - Who are the main actors/users?
+
+        ## 2. Entity Discovery
+        - What are the main entities?
+        - Which entities are **aggregate roots**?
+        - What are the entity relationships?
+
+        ## 3. Value Objects
+        - What immutable value types exist?
+        - What are their validation rules?
+
+        ## 4. Domain Events
+        - What state transitions occur?
+        - What events should be emitted?
+
+        ## 5. Business Invariants
+        - What rules must ALWAYS hold?
+        - What constraints exist?
+
+        Input: {{input}}
+
+  - stepId: design-schemas
+    name: Design Zod Schemas
+    description: Generate complete Zod schemas for all entities and value objects
+    type: tool
+    timeout: 60000
+    dependencies:
+      - gather-requirements
+    config:
+      tool: design_schema
+      passContext: true
+
+  - stepId: enhance-schemas
+    name: Enhance Schema Design
+    description: Add validation rules, refinements, and type exports
+    type: prompt
+    timeout: 90000
+    dependencies:
+      - design-schemas
+    config:
+      agentId: contract-architect
+      prompt: |
+        Enhance the generated schemas with:
+
+        1. **Validation Rules**:
+           - String patterns (regex)
+           - Number ranges (min/max)
+           - Array constraints
+           - Custom refinements
+
+        2. **Type Exports**:
+           - Export all inferred types
+           - Create validation functions
+           - Add factory functions
+
+        3. **Documentation**:
+           - JSDoc comments for all schemas
+           - Reference invariants in comments
+
+        Base Schema:
+        {{steps.design-schemas.output}}
+
+        Requirements Context:
+        {{steps.gather-requirements.output}}
+
+  - stepId: write-invariants
+    name: Write Invariant Documentation
+    description: Create comprehensive invariants.md with all behavioral guarantees
+    type: prompt
+    timeout: 90000
+    dependencies:
+      - enhance-schemas
+    config:
+      agentId: contract-architect
+      prompt: |
+        Create a complete invariants.md file for this domain.
+
+        ## Format
+
+        ```markdown
+        # {{domain_name}} Domain Invariants
+
+        ## Schema Invariants
+        [Invariants enforced by Zod schema validation]
+
+        ### INV-XXX-001: [Name]
+        [Description]
+        - **Enforcement**: schema
+        - **Test**: [Zod validation rule]
+
+        ## Runtime Invariants
+        [Invariants enforced by application code]
+
+        ### INV-XXX-010: [Name]
+        [Description]
+        - **Enforcement**: runtime
+        - **Test**: [Code assertion]
+
+        ## Business Invariants
+        [Invariants enforced by tests and reviews]
+
+        ### INV-XXX-020: [Name]
+        [Description]
+        - **Enforcement**: test
+        - **Test**: [Test case description]
+        ```
+
+        Requirements:
+        {{steps.gather-requirements.output}}
+
+        Schema:
+        {{steps.enhance-schemas.output}}
+
+  - stepId: design-package-structure
+    name: Design Package Structure
+    description: Define the complete package and file structure
+    type: prompt
+    timeout: 60000
+    dependencies:
+      - write-invariants
+    config:
+      agentId: contract-architect
+      prompt: |
+        Design the complete package structure:
+
+        ```
+        packages/
+        ├── contracts/src/{{domain}}/v1/
+        │   ├── schema.ts          # Zod schemas
+        │   ├── invariants.md      # Behavioral guarantees
+        │   └── index.ts           # Public exports
+        ├── core/{{domain}}-domain/
+        │   ├── src/
+        │   │   ├── index.ts       # Public API
+        │   │   ├── types.ts       # Internal types
+        │   │   ├── errors.ts      # Domain errors
+        │   │   └── {{entity}}.ts  # Entity logic
+        │   ├── package.json
+        │   └── tsconfig.json
+        └── tests/
+            ├── contract/{{domain}}.test.ts
+            └── core/{{domain}}-domain.test.ts
+        ```
+
+        For each file, provide:
+        1. Purpose
+        2. Key exports
+        3. Dependencies
+
+  - stepId: generate-guard-policy
+    name: Generate Guard Policy
+    description: Create guard policy YAML for governance
+    type: prompt
+    timeout: 30000
+    dependencies:
+      - design-package-structure
+    config:
+      agentId: contract-architect
+      prompt: |
+        Generate a guard policy YAML:
+
+        ```yaml
+        policy_id: {{domain}}-development
+
+        allowed_paths:
+          - packages/contracts/src/{{domain}}/**
+          - packages/core/{{domain}}-domain/**
+          - tests/contract/{{domain}}.test.ts
+          - tests/core/{{domain}}-domain.test.ts
+
+        forbidden_paths:
+          - packages/cli/**
+          - packages/mcp-server/**
+          - packages/contracts/src/*/v1/schema.ts  # Other domains
+
+        required_contracts: []
+
+        gates:
+          - path_violation
+          - dependency
+          - change_radius
+          - contract_tests
+
+        change_radius_limit: 2
+        ```
+
+        Customize based on domain complexity and dependencies.
+
+  - stepId: generate-test-scaffolds
+    name: Generate Test Scaffolds
+    description: Create test file scaffolds for contracts and domain
+    type: prompt
+    timeout: 60000
+    dependencies:
+      - enhance-schemas
+    config:
+      agentId: quality
+      prompt: |
+        Generate test scaffolds for the domain:
+
+        ## 1. Contract Tests (tests/contract/{{domain}}.test.ts)
+
+        ```typescript
+        import { describe, it, expect } from 'vitest';
+        import { {{Schema}}Schema, validate{{Schema}} } from '@pkg/contracts';
+
+        describe('{{domain}} contracts', () => {
+          describe('{{Schema}}Schema', () => {
+            it('should validate valid input', () => {
+              // Test valid data
+            });
+
+            it('should reject invalid input', () => {
+              // Test invalid data
+            });
+
+            // Invariant tests
+            it('should enforce INV-XXX-001', () => {
+              // Test invariant
+            });
+          });
+        });
+        ```
+
+        ## 2. Domain Tests (tests/core/{{domain}}-domain.test.ts)
+
+        ```typescript
+        import { describe, it, expect } from 'vitest';
+        import { {{Entity}} } from '@pkg/{{domain}}-domain';
+
+        describe('{{domain}} domain', () => {
+          describe('{{Entity}}', () => {
+            it('should create valid entity', () => {
+              // Test creation
+            });
+
+            it('should handle state transitions', () => {
+              // Test behavior
+            });
+          });
+        });
+        ```
+
+        Schema Context:
+        {{steps.enhance-schemas.output}}
+
+  - stepId: generate-summary
+    name: Generate Implementation Summary
+    description: Create comprehensive summary with all artifacts ready to copy
+    type: prompt
+    timeout: 90000
+    dependencies:
+      - generate-guard-policy
+      - generate-test-scaffolds
+    config:
+      agentId: writer
+      prompt: |
+        Create a comprehensive implementation summary.
+
+        # {{domain}} Domain - Contract-First Scaffold
+
+        ## Overview
+        [Brief description from requirements]
+
+        ## Generated Artifacts
+
+        ### 1. Schema (packages/contracts/src/{{domain}}/v1/schema.ts)
+        ```typescript
+        [Complete schema code from enhance-schemas]
+        ```
+
+        ### 2. Invariants (packages/contracts/src/{{domain}}/v1/invariants.md)
+        ```markdown
+        [Complete invariants from write-invariants]
+        ```
+
+        ### 3. Package Structure
+        [File tree from design-package-structure]
+
+        ### 4. Guard Policy (packages/guard/policies/{{domain}}.yaml)
+        ```yaml
+        [Policy from generate-guard-policy]
+        ```
+
+        ### 5. Test Scaffolds
+        [Tests from generate-test-scaffolds]
+
+        ## Implementation Checklist
+
+        - [ ] Create contract package directory
+        - [ ] Add schema.ts with Zod schemas
+        - [ ] Add invariants.md documentation
+        - [ ] Create domain package
+        - [ ] Implement domain logic
+        - [ ] Add guard policy
+        - [ ] Write contract tests
+        - [ ] Write domain tests
+        - [ ] Run `ax guard check --policy {{domain}}-development`
+
+        ## Commands
+
+        ```bash
+        # Verify agent is available
+        ax agent list | grep contract-architect
+
+        # Run guard check after implementation
+        ax guard check --policy {{domain}}-development --paths packages/contracts/src/{{domain}} packages/core/{{domain}}-domain
+        ```
+
+        Compile ALL outputs from previous steps into this summary.
+
+  - stepId: store-result
+    name: Store Scaffold Result
+    description: Persist the scaffold result in memory for future reference
+    type: tool
+    timeout: 10000
+    dependencies:
+      - generate-summary
+    config:
+      tool: memory_store
+      namespace: scaffold
+      key: "{{domain}}/{{timestamp}}"

package/bundled/workflows/debugger.yaml

@@ -0,0 +1,107 @@
+workflowId: debugger
+version: "1.0.0"
+name: Bug Investigation Workflow
+description: Systematic bug investigation and resolution
+
+steps:
+  - stepId: gather-context
+    type: prompt
+    name: Gather Bug Context
+    timeout: 60000
+    config:
+      agentId: researcher
+      prompt: |
+        Gather information about the bug:
+        1. Error messages and stack traces
+        2. Steps to reproduce
+        3. Environment details
+        4. Recent changes that might be related
+        5. Affected user count and severity
+
+  - stepId: analyze-logs
+    type: tool
+    name: Analyze Logs
+    timeout: 60000
+    config:
+      tool: trace_analyze
+      args:
+        timeRange: 24h
+        filters:
+          level: error
+
+  - stepId: identify-root-cause
+    type: prompt
+    name: Identify Root Cause
+    timeout: 120000
+    config:
+      agentId: backend
+      prompt: |
+        Based on the evidence:
+        1. Form hypotheses about root cause
+        2. Trace code execution path
+        3. Identify the exact failure point
+        4. Determine if it's a regression
+
+  - stepId: scan-related-bugs
+    type: tool
+    name: Scan for Related Issues
+    timeout: 60000
+    config:
+      tool: bugfix_scan
+      args:
+        categories:
+          - null-reference
+          - type-error
+          - logic-error
+          - resource-leak
+        maxFiles: 50
+
+  - stepId: develop-fix
+    type: prompt
+    name: Develop Fix
+    timeout: 180000
+    config:
+      agentId: backend
+      prompt: |
+        Develop the fix:
+        1. Write the minimal fix
+        2. Add defensive checks
+        3. Write regression test
+        4. Verify fix doesn't break other tests
+
+  - stepId: verify-fix
+    type: tool
+    name: Verify Fix
+    timeout: 120000
+    retryPolicy:
+      maxAttempts: 2
+      backoffMs: 3000
+    config:
+      tool: guard_check
+      args:
+        policyId: test-pass
+        runTests: true
+
+  - stepId: document-resolution
+    type: prompt
+    name: Document Resolution
+    timeout: 30000
+    config:
+      agentId: writer
+      prompt: |
+        Document the bug resolution:
+        1. Root cause summary
+        2. Fix description
+        3. Prevention recommendations
+        4. Post-mortem notes if severe
+
+metadata:
+  category: maintenance
+  tags:
+    - debugging
+    - bug-fix
+    - investigation
+  requiredAbilities:
+    - debugging
+    - error-handling
+    - testing-strategy

package/bundled/workflows/designer.yaml

@@ -0,0 +1,113 @@
+workflowId: designer
+version: "1.0.0"
+name: System Design Workflow
+description: Technical system design and architecture planning
+
+steps:
+  - stepId: gather-requirements
+    type: prompt
+    name: Gather Requirements
+    timeout: 60000
+    config:
+      agentId: product
+      prompt: |
+        Gather system requirements:
+        1. Functional requirements
+        2. Non-functional requirements (scale, performance, security)
+        3. Constraints and limitations
+        4. Integration needs
+
+  - stepId: analyze-scope
+    type: prompt
+    name: Analyze Scope
+    timeout: 60000
+    config:
+      agentId: architecture
+      prompt: |
+        Analyze the system scope:
+        1. Identify major components
+        2. Define system boundaries
+        3. Map external dependencies
+        4. Estimate complexity
+
+  - stepId: design-architecture
+    type: tool
+    name: Design Architecture
+    timeout: 120000
+    config:
+      tool: design_architecture
+      args:
+        style: component-diagram
+        includeInteractions: true
+
+  - stepId: design-api
+    type: tool
+    name: Design API Contracts
+    timeout: 90000
+    config:
+      tool: design_api
+      args:
+        format: openapi
+        version: "3.0"
+
+  - stepId: design-data-model
+    type: tool
+    name: Design Data Model
+    timeout: 90000
+    config:
+      tool: design_schema
+      args:
+        type: database
+        normalize: true
+
+  - stepId: security-review
+    type: prompt
+    name: Security Review
+    timeout: 60000
+    config:
+      agentId: security
+      prompt: |
+        Review security aspects:
+        1. Authentication and authorization
+        2. Data protection
+        3. Network security
+        4. Compliance requirements
+
+  - stepId: scalability-review
+    type: prompt
+    name: Scalability Review
+    timeout: 60000
+    config:
+      agentId: architecture
+      prompt: |
+        Review scalability:
+        1. Identify bottlenecks
+        2. Plan horizontal scaling
+        3. Define caching strategy
+        4. Plan for growth
+
+  - stepId: create-documentation
+    type: prompt
+    name: Create Design Documentation
+    timeout: 120000
+    config:
+      agentId: writer
+      prompt: |
+        Create design documentation:
+        1. Architecture overview
+        2. Component descriptions
+        3. API documentation
+        4. Data model documentation
+        5. Deployment guide
+
+metadata:
+  category: architecture
+  tags:
+    - system-design
+    - architecture
+    - planning
+  requiredAbilities:
+    - system-design
+    - api-design
+    - db-modeling
+    - security

package/bundled/workflows/developer.yaml

@@ -0,0 +1,105 @@
+workflowId: developer
+version: "1.0.0"
+name: Feature Development Workflow
+description: End-to-end feature development from requirements to implementation
+
+steps:
+  - stepId: understand-requirements
+    type: prompt
+    name: Understand Requirements
+    timeout: 60000
+    config:
+      agentId: product
+      prompt: |
+        Analyze the feature request:
+        1. Identify user stories and acceptance criteria
+        2. Define success metrics
+        3. List dependencies and blockers
+        4. Estimate complexity
+
+  - stepId: design-solution
+    type: prompt
+    name: Design Solution
+    timeout: 120000
+    config:
+      agentId: architecture
+      prompt: |
+        Design the technical solution:
+        1. Propose architecture changes
+        2. Define API contracts
+        3. Identify affected components
+        4. Plan database changes
+        5. Consider security implications
+
+  - stepId: create-plan
+    type: tool
+    name: Create Implementation Plan
+    timeout: 30000
+    config:
+      tool: task_create
+      args:
+        type: implementation
+        breakdown: true
+
+  - stepId: implement-backend
+    type: prompt
+    name: Implement Backend
+    timeout: 300000
+    config:
+      agentId: backend
+      prompt: |
+        Implement the backend components:
+        1. Create/modify API endpoints
+        2. Implement business logic
+        3. Add database migrations
+        4. Write unit tests
+
+  - stepId: implement-frontend
+    type: prompt
+    name: Implement Frontend
+    timeout: 300000
+    config:
+      agentId: frontend
+      prompt: |
+        Implement the frontend components:
+        1. Create/modify UI components
+        2. Connect to API endpoints
+        3. Handle loading and error states
+        4. Write component tests
+
+  - stepId: integration-test
+    type: tool
+    name: Run Integration Tests
+    timeout: 120000
+    retryPolicy:
+      maxAttempts: 3
+      backoffMs: 5000
+    config:
+      tool: guard_check
+      args:
+        policyId: test-coverage
+        threshold: 80
+
+  - stepId: documentation
+    type: prompt
+    name: Update Documentation
+    timeout: 60000
+    config:
+      agentId: writer
+      prompt: |
+        Update documentation:
+        1. API documentation
+        2. User guide updates
+        3. Changelog entry
+        4. Architecture diagrams
+
+metadata:
+  category: development
+  tags:
+    - feature
+    - full-stack
+    - implementation
+  requiredAbilities:
+    - code-generation
+    - api-design
+    - testing-strategy