@wframe/cli

The wireframe command compiles, runs, inspects, probes, recompiles, and compares driver artifacts.

Maintenance commands

Compile a version 1 artifact with embedded training and held-out sessions:

wireframe compile mock --adapter mock --out driver.v1.json

Probe explicitly supplied traces against a live target:

wireframe probe driver.v1.json mock --sessions probes.json
wireframe probe driver.v1.json mock --sessions probes.json --max-steps 2 --json

Probe commands are sent to the target and can have side effects. The caller is responsible for supplying read-safe sessions. --max-steps limits commands per session. The probe stops each session at its first divergence.

After recording the changed flow, issue the next verified artifact:

wireframe recompile driver.v1.json --sessions drift-sessions.json --out driver.v2.json

For a legacy bare-driver JSON file, supply its original corpus when available:

wireframe recompile legacy.json --corpus original-sessions.json \
  --sessions drift-sessions.json --out driver.v2.json

Recompile writes no replacement when a gate fails. It prints the failed gates and returns exit code

1. Compare versions in CI with:

wireframe diff driver.v1.json driver.v2.json
wireframe diff driver.v1.json driver.v2.json --json

diff returns exit code 0 for a compatible interface and 1 for a breaking interface.

Session files may be a JSON Session[], { "sessions": Session[] }, or an artifact corpus object with training and heldOut arrays.