ma-agents 2.19.2 → 2.20.0

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/menu-triggers/trigger-with-spaces.agent.yaml

@@ -0,0 +1,25 @@
+# Test: Trigger with spaces
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.menu[0].trigger
+# Error message: agent.menu[].trigger must be kebab-case (lowercase words separated by hyphen)
+
+agent:
+  metadata:
+    id: spaces-trigger
+    name: Spaces Trigger
+    title: Spaces
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: list tasks
+      description: Invalid trigger with spaces
+      action: list_tasks

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/metadata/empty-module-string.agent.yaml

@@ -0,0 +1,26 @@
+# Test: Module field with whitespace only
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.metadata.module
+# Error message: agent.metadata.module must be a non-empty string
+# Path context: src/modules/bmm/agents/empty-module-string.agent.yaml
+
+agent:
+  metadata:
+    id: empty-module
+    name: Empty Module String
+    title: Empty Module
+    icon: ❌
+    module: "   "
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/metadata/empty-name.agent.yaml

@@ -0,0 +1,24 @@
+# Test: Empty string in metadata.name field
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.metadata.name
+# Error message: agent.metadata.name must be a non-empty string
+
+agent:
+  metadata:
+    id: empty-name-test
+    name: "   "
+    title: Empty Name Test
+    icon: ❌
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/metadata/extra-metadata-fields.agent.yaml

@@ -0,0 +1,27 @@
+# Test: Extra unknown fields in metadata
+# Expected: FAIL
+# Error code: unrecognized_keys
+# Error path: agent.metadata
+# Error keys: ["unknown_field", "another_extra"]
+
+agent:
+  metadata:
+    id: extra-fields
+    name: Extra Fields
+    title: Extra Fields
+    icon: ❌
+    hasSidecar: false
+    unknown_field: This is not allowed
+    another_extra: Also invalid
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/metadata/missing-id.agent.yaml

@@ -0,0 +1,23 @@
+# Test: Missing required metadata.id field
+# Expected: FAIL
+# Error code: invalid_type
+# Error path: agent.metadata.id
+# Error expected: string
+
+agent:
+  metadata:
+    name: Missing ID Agent
+    title: Missing ID
+    icon: ❌
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/persona/empty-principles-array.agent.yaml

@@ -0,0 +1,24 @@
+# Test: Empty principles array
+# Expected: FAIL
+# Error code: too_small
+# Error path: agent.persona.principles
+# Error minimum: 1
+
+agent:
+  metadata:
+    id: empty-principles
+    name: Empty Principles
+    title: Empty Principles
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles: []
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/persona/empty-string-in-principles.agent.yaml

@@ -0,0 +1,27 @@
+# Test: Empty string in principles array
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.persona.principles[1]
+# Error message: agent.persona.principles[] must be a non-empty string
+
+agent:
+  metadata:
+    id: empty-principle-string
+    name: Empty Principle String
+    title: Empty Principle
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Valid principle
+      - "   "
+      - Another valid principle
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/persona/extra-persona-fields.agent.yaml

@@ -0,0 +1,27 @@
+# Test: Extra unknown fields in persona
+# Expected: FAIL
+# Error code: unrecognized_keys
+# Error path: agent.persona
+# Error keys: ["extra_field", "another_extra"]
+
+agent:
+  metadata:
+    id: extra-persona-fields
+    name: Extra Persona Fields
+    title: Extra Persona
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+    extra_field: Not allowed
+    another_extra: Also invalid
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/persona/missing-role.agent.yaml

@@ -0,0 +1,24 @@
+# Test: Missing required persona.role field
+# Expected: FAIL
+# Error code: invalid_type
+# Error path: agent.persona.role
+# Error expected: string
+
+agent:
+  metadata:
+    id: missing-role
+    name: Missing Role
+    title: Missing Role
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/prompts/empty-content.agent.yaml

@@ -0,0 +1,29 @@
+# Test: Prompt with empty content string
+# Expected: FAIL
+# Error code: custom
+# Error path: agent.prompts[0].content
+# Error message: agent.prompts[].content must be a non-empty string
+
+agent:
+  metadata:
+    id: empty-content
+    name: Empty Content
+    title: Empty Content
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  prompts:
+    - id: prompt1
+      content: "   "
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/prompts/extra-prompt-fields.agent.yaml

@@ -0,0 +1,31 @@
+# Test: Extra unknown fields in prompts
+# Expected: FAIL
+# Error code: unrecognized_keys
+# Error path: agent.prompts[0]
+# Error keys: ["extra_field"]
+
+agent:
+  metadata:
+    id: extra-prompt-fields
+    name: Extra Prompt Fields
+    title: Extra Fields
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  prompts:
+    - id: prompt1
+      content: Valid content
+      description: Valid description
+      extra_field: Not allowed
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/prompts/missing-content.agent.yaml

@@ -0,0 +1,28 @@
+# Test: Prompt missing required content field
+# Expected: FAIL
+# Error code: invalid_type
+# Error path: agent.prompts[0].content
+# Error expected: string
+
+agent:
+  metadata:
+    id: prompt-missing-content
+    name: Prompt Missing Content
+    title: Missing Content
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  prompts:
+    - id: prompt1
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/prompts/missing-id.agent.yaml

@@ -0,0 +1,28 @@
+# Test: Prompt missing required id field
+# Expected: FAIL
+# Error code: invalid_type
+# Error path: agent.prompts[0].id
+# Error expected: string
+
+agent:
+  metadata:
+    id: prompt-missing-id
+    name: Prompt Missing ID
+    title: Missing ID
+    icon: ❌
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  prompts:
+    - content: Prompt without ID
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/top-level/empty-file.agent.yaml

@@ -0,0 +1,5 @@
+# Test: Empty YAML file
+# Expected: FAIL
+# Error code: invalid_type
+# Error path:
+# Error expected: object

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/top-level/extra-top-level-keys.agent.yaml

@@ -0,0 +1,28 @@
+# Test: Extra top-level keys beyond 'agent'
+# Expected: FAIL
+# Error code: unrecognized_keys
+# Error path: 
+# Error keys: ["extra_key", "another_extra"]
+
+agent:
+  metadata:
+    id: extra-test
+    name: Extra Test Agent
+    title: Extra Test
+    icon: 🧪
+    hasSidecar: false
+
+  persona:
+    role: Test agent
+    identity: Test identity
+    communication_style: Test style
+    principles:
+      - Test principle
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help
+
+extra_key: This should not be allowed
+another_extra: Also invalid

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/top-level/missing-agent-key.agent.yaml

@@ -0,0 +1,11 @@
+# Test: Missing required 'agent' top-level key
+# Expected: FAIL
+# Error code: invalid_type
+# Error path: agent
+# Error expected: object
+
+metadata:
+  id: bad-test
+  name: Bad Test Agent
+  title: Bad Test
+  icon: ❌

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/yaml-errors/invalid-indentation.agent.yaml

@@ -0,0 +1,19 @@
+# Test: Invalid YAML structure with inconsistent indentation
+# Expected: FAIL - YAML parse error
+
+agent:
+  metadata:
+  id: invalid-indent
+    name: Invalid Indentation
+    title: Invalid
+    icon: ❌
+  persona:
+    role: Test
+    identity: Test
+    communication_style: Test
+    principles:
+      - Test
+  menu:
+    - trigger: help
+      description: Help
+      action: help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/invalid/yaml-errors/malformed-yaml.agent.yaml

@@ -0,0 +1,18 @@
+# Test: Malformed YAML with syntax errors
+# Expected: FAIL - YAML parse error
+
+agent:
+  metadata:
+    id: malformed
+    name: Malformed YAML
+    title: [Malformed
+    icon: 🧪
+  persona:
+    role: Test
+    identity: Test
+    communication_style: Test
+    principles:
+      - Test
+  menu:
+    - trigger: help
+      description: Help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/valid/critical-actions/empty-critical-actions.agent.yaml

@@ -0,0 +1,24 @@
+# Test: Empty critical_actions array
+# Expected: PASS - empty array is valid for optional field
+
+agent:
+  metadata:
+    id: empty-critical-actions
+    name: Empty Critical Actions
+    title: Empty Critical Actions
+    icon: 🧪
+    hasSidecar: false
+
+  persona:
+    role: Test agent with empty critical actions
+    identity: I am a test agent with empty critical actions array.
+    communication_style: Clear
+    principles:
+      - Test empty arrays
+
+  critical_actions: []
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/valid/critical-actions/no-critical-actions.agent.yaml

@@ -0,0 +1,22 @@
+# Test: No critical_actions field (optional)
+# Expected: PASS
+
+agent:
+  metadata:
+    id: no-critical-actions
+    name: No Critical Actions
+    title: No Critical Actions
+    icon: 🧪
+    hasSidecar: false
+
+  persona:
+    role: Test agent without critical actions
+    identity: I am a test agent without critical actions.
+    communication_style: Clear
+    principles:
+      - Test optional fields
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/valid/critical-actions/valid-critical-actions.agent.yaml

@@ -0,0 +1,27 @@
+# Test: critical_actions with valid strings
+# Expected: PASS
+
+agent:
+  metadata:
+    id: valid-critical-actions
+    name: Valid Critical Actions
+    title: Valid Critical Actions
+    icon: 🧪
+    hasSidecar: false
+
+  persona:
+    role: Test agent with critical actions
+    identity: I am a test agent with valid critical actions.
+    communication_style: Clear
+    principles:
+      - Test valid arrays
+
+  critical_actions:
+    - Load configuration from disk
+    - Initialize user context
+    - Set communication preferences
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/valid/menu/multiple-menu-items.agent.yaml

@@ -0,0 +1,31 @@
+# Test: Menu with multiple valid items using different command types
+# Expected: PASS
+
+agent:
+  metadata:
+    id: multiple-menu
+    name: Multiple Menu Items
+    title: Multiple Menu
+    icon: 🧪
+    hasSidecar: false
+
+  persona:
+    role: Test agent with multiple menu items
+    identity: I am a test agent with diverse menu commands.
+    communication_style: Clear
+    principles:
+      - Test multiple menu items
+
+  menu:
+    - trigger: help
+      description: Show help
+      action: display_help
+    - trigger: start-workflow
+      description: Start a workflow
+      workflow: path/to/workflow
+    - trigger: execute
+      description: Execute command
+      exec: npm test
+    - trigger: use-template
+      description: Use template
+      tmpl: path/to/template

package/lib/bmad-cache/tea/test/fixtures/agent-schema/valid/menu/single-menu-item.agent.yaml

@@ -0,0 +1,22 @@
+# Test: Menu with single valid item
+# Expected: PASS
+
+agent:
+  metadata:
+    id: single-menu
+    name: Single Menu Item
+    title: Single Menu
+    icon: 🧪
+    hasSidecar: false
+
+  persona:
+    role: Test agent with single menu item
+    identity: I am a test agent.
+    communication_style: Clear
+    principles:
+      - Test minimal menu
+
+  menu:
+    - trigger: help
+      description: Show help information
+      action: display_help

package/lib/bmad-cache/tea/test/fixtures/agent-schema/valid/menu-commands/all-command-types.agent.yaml

@@ -0,0 +1,38 @@
+# Test: Menu items with all valid command target types
+# Expected: PASS
+
+agent:
+  metadata:
+    id: all-commands
+    name: All Command Types
+    title: All Commands
+    icon: 🧪
+    hasSidecar: false
+
+  persona:
+    role: Test agent with all command types
+    identity: I test all available command target types.
+    communication_style: Clear
+    principles:
+      - Test all command types
+
+  menu:
+    - trigger: workflow-test
+      description: Test workflow command
+      workflow: path/to/workflow
+    - trigger: validate-test
+      description: Test validate-workflow command
+      validate-workflow: path/to/validation
+    - trigger: exec-test
+      description: Test exec command
+      exec: npm test
+    - trigger: action-test
+      description: Test action command
+      action: perform_action
+    - trigger: tmpl-test
+      description: Test tmpl command
+      tmpl: path/to/template
+    - trigger: data-test
+      description: Test data command
+      data: path/to/data
+  

package/lib/bmad-cache/tea/test/fixtures/agent-schema/valid/menu-commands/multiple-commands.agent.yaml

@@ -0,0 +1,24 @@
+# Test: Menu item with multiple command targets
+# Expected: PASS - multiple targets are allowed
+
+agent:
+  metadata:
+    id: multiple-commands
+    name: Multiple Commands
+    title: Multiple Commands
+    icon: 🧪
+    hasSidecar: false
+
+  persona:
+    role: Test agent with multiple command targets
+    identity: I test multiple command targets per menu item.
+    communication_style: Clear
+    principles:
+      - Test multiple targets
+
+  menu:
+    - trigger: multi-command
+      description: Menu item with multiple command targets
+      workflow: path/to/workflow
+      exec: npm test
+      action: perform_action

package/lib/bmad-cache/tea/test/fixtures/agent-schema/valid/menu-triggers/compound-triggers.agent.yaml

@@ -0,0 +1,31 @@
+# Test: Valid compound triggers
+# Expected: PASS
+
+agent:
+  metadata:
+    id: compound-triggers
+    name: Compound Triggers
+    title: Compound Triggers Test
+    icon: 🧪
+    hasSidecar: false
+
+  persona:
+    role: Test agent with compound triggers
+    identity: I test compound trigger validation.
+    communication_style: Clear
+    principles:
+      - Test compound format
+
+  menu:
+    - trigger: TS or fuzzy match on tech-spec
+      description: "[TS] Two-word compound trigger"
+      action: tech_spec
+    - trigger: DS or fuzzy match on dev-story
+      description: "[DS] Another two-word compound trigger"
+      action: dev_story
+    - trigger: WI or fuzzy match on workflow-init-process
+      description: "[WI] Three-word compound trigger (uses first 2 words for shortcut)"
+      action: workflow_init
+    - trigger: H or fuzzy match on help
+      description: "[H] Single-word compound trigger (1-letter shortcut)"
+      action: help