Files
proffesor-for-testing__agen…/docs/implementation/specs/SPEC-041-B-workflow-automation.md
Profa 2253d05618 feat: flatten project structure — archive v2, promote v3 to root
Remove the nested v3/ subdirectory by moving all active source code,
tests, configs, and assets directly to the project root. Archive v2/
(dead code, 847MB) to v2-archive.tar.gz.

Key changes:
- Move v3/src/ → src/, v3/tests/ → tests/, v3/packages/ → packages/
- Move v3/tsconfig.json, v3/vitest.config.ts to root
- Merge v3/package.json into root package.json (ESM, scripts, deps, exports)
- Merge v3/scripts/ into scripts/, v3/implementation/ into docs/implementation/
- Update all CI workflows to remove "cd v3 &&" and v3/ path prefixes
- Fix all init installer path resolution (3-level-up → 2-level-up)
- Fix hooks to use "node ./dist/cli/bundle.js" instead of bare "aqe"
- Update settings.json ADR/DDD directories to docs/implementation/
- Fix helper scripts (statusline, adr-compliance, ddd-tracker, guidance-hooks)
- Update 58 agent definitions: aqe/v3/ → aqe/ memory namespaces
- Update 15 guidance shards: v3/src/ → src/ path references
- Fix sync interfaces: remove v3/ and v2/ path references
- Fix test path calculations (process.cwd() + '..' no longer needed)
- Fix flaky perf test threshold (500ms → 1000ms for CI environments)
- Fix complexity-analyzer test to match ADR-051 keyword-based eligibility

Build passes, 17,901 tests pass, CLI and MCP bundles verified.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 11:35:41 +00:00

2.9 KiB

SPEC-041-B: Workflow Automation

Field Value
Specification ID SPEC-041-B
Parent ADR ADR-041
Version 1.0
Status Implemented
Last Updated 2026-01-14
Author Claude Code

Overview

This specification defines the workflow automation system including YAML pipeline definitions, scheduled execution, and event triggers.


Workflow Definition Schema

# qe-pipeline.yaml
name: daily-qe-pipeline
schedule: "0 2 * * *"  # 2 AM daily

stages:
  - name: test-generation
    command: aqe test generate
    params:
      target: src/
      coverage-goal: 90
      ai-enhanced: true

  - name: parallel-execution
    command: aqe test execute
    params:
      parallel: 8
      retry: 3
      timeout: 300

  - name: coverage-analysis
    command: aqe coverage analyze
    params:
      gap-detection: true
      report-format: html

  - name: quality-gate
    command: aqe quality gate
    params:
      fail-threshold: 80
      coverage-min: 85

triggers:
  - event: push
    branches: [main, develop]
  - event: pull_request
    types: [opened, synchronize]

CLI Commands

# Run workflow
aqe workflow run qe-pipeline.yaml

# Schedule workflow
aqe workflow schedule qe-pipeline.yaml

# List scheduled workflows
aqe workflow list --scheduled

# Cancel scheduled workflow
aqe workflow cancel <workflow-id>

Configuration

const QE_CLI_CONFIG = {
  streaming: {
    enabled: true,
    bufferSize: 100,
    updateIntervalMs: 50
  }
};

Security Constraints

Constraint Value Reason
YAML max lines 10,000 Prevent DoS
JSON max size 10 MB Memory protection
Allowed scheduler paths home, cwd, tmp Path traversal prevention

Implementation Files

File LOC Description
workflow-parser.ts ~300 YAML workflow parser
persistent-scheduler.ts ~400 Cron-based scheduler

Test Coverage

  • 26 tests for workflow automation
  • Schedule parsing verified
  • Trigger conditions tested

Validation Rules

Rule ID Description Severity
SPEC-041-B-001 Workflow YAML must be valid Error
SPEC-041-B-002 Schedule must be valid cron expression Error
SPEC-041-B-003 Stage commands must be whitelisted Error

Changelog

Version Date Author Changes
1.0 2026-01-14 Claude Code Initial specification

References