Summary

This PR adds a controlled “Simulation Mode” (no API key, no network) and a trace-driven toolchain to go from run output → workflow generation + coverage.

What’s included

• Simulation mode:

  • AIFLOW_MODE=sim (also supports legacy AIFLOW_MOCK_LLM=1)
  • Deterministic outputs via AIFLOW_SEED
  • Deterministic trace timestamps (no wall-clock) for stable diffs
  • Optional SIM overrides to hit specific branches:
    • AIFLOW_SIM_TICKET_TYPE=technical|billing|general
    • AIFLOW_SIM_SOLUTION_FOUND=true|false

• Trace → Workflow generator:

  • runtime/cli/traceToAiflow.mts
  • Observed-only mode (safe executable logic)
  • Full-graph mode adds coverage metadata into flow.__generator.rules

• Coverage tooling:

  • runtime/cli/traceCoverage.mts (per-run coverage report)
  • runtime/cli/coverageSweep.mts (union coverage)
    • --auto derives SIM scenarios from missed edges using existing overrides only (no scope creep)

• One-command design pipeline:

  • runtime/cli/designToolchain.mts:
    • baseline sim run → observed/full generated .aiflow → auto sweep → artifacts directory

How to test (local)

unset API_KEY GEMINI_API_KEY
AIFLOW_MODE=sim AIFLOW_SEED=42 node runtime/cli/runAiflow.mts examples/CustomerSupportFlow/CustomerSupportFlow_v1.0.0.aiflow

node runtime/cli/coverageSweep.mts examples/CustomerSupportFlow/CustomerSupportFlow_v1.0.0.aiflow --seed 42 --auto

node runtime/cli/designToolchain.mts examples/CustomerSupportFlow/CustomerSupportFlow_v1.0.0.aiflow --seed 42 --auto --out-dir /tmp/aiflow-next-artifacts