Documentation
¶
Overview ¶
Command envelope-shape compares the result envelopes that two adapters wrote for the same QuickAgent run, and says where they disagree.
go run ./scripts/envelope-shape <a.json> <b.json>
Every adapter must write one envelope shape: the same keys at every depth, and the same values wherever the value is a fact about the QuickAgent, the policy or the run's outcome rather than about the harness or the model. So the comparison is of the whole tree, with three exceptions:
- fields that belong to one run (its id, times, folders, usage, the model's answer, the harness's own description) are left out;
- fields whose value differs by design between adapters or between any two runs (the result file's path, a deliverable's title, bytes, digest and whether the agent marked it, the receipt lines that describe the harness's own container) are compared by presence and JSON kind only;
- everything else is compared exactly.
It prints one line per difference and exits 1 when there is any, 2 on a usage or read error.
Click to show internal directories.
Click to hide internal directories.