■the fix packet · agent repair contract
The Fix Packet is the repair contract between your coding agent, axint, and Xcode.
When the build fails, your agent doesn't need an Xcode log. It needs a contract: verdict, findings, an AI-ready repair prompt, an Xcode checklist, and the full evidence trail. axint writes that file. The agent reads it. Repair runs without anyone pasting an error message into chat.
for the curious · the file your agent reads
six parts of the contract
- 01
verdict
One word the agent reads to decide whether to ship, repair, or run more tests. Not a build log, not a vibe.
- 02
confidence
How certain axint is that the verdict is final. low means runtime evidence is still pending.
- 03
findings
Each issue named precisely — the rule that fired, the file it fired in, why it matters, and the suggested direction.
- 04
ai-ready repair prompt
A pre-formatted prompt your agent can act on without any user copy-pasting. It already names the file and the change.
- 05
xcode checklist
If the user wants to fix it themselves: open this file, go to this line, change this thing, rerun this command.
- 06
artifacts
Build log, .xcresult, generated Swift, any source axint emitted. The full evidence trail, machine-readable.
.axint/fix/latest.json
fix_required{
"verdict": "fix_required",
"confidence": "high",
"duration_ms": 142000,
"findings": [
{
"code": "AX764",
"severity": "warning",
"file": "Sources/Composer/HomeComposer.swift",
"line": 142,
"message": "TextField overlay missing .allowsHitTesting(false)",
"why": "Decorative overlays steal hit-testing from the field.",
"fix": "Add .allowsHitTesting(false) to the overlay modifier."
}
],
"ai_repair_prompt": "Open HomeComposer.swift line 142. Add .allowsHitTesting(false) ...",
"xcode_checklist": [
"open HomeComposer.swift in Xcode",
"navigate to line 142",
"add .allowsHitTesting(false) to the .overlay() modifier",
"rerun axint run --only-testing testComposerAcceptsInput"
],
"artifacts": {
"swift": ".axint/run/latest.swift",
"build_log": ".axint/run/logs/build-2026-05-02T14-32.log",
"xcresult": ".axint/run/xcresults/HomeComposerUITests.xcresult"
}
}
■the loop your agent runs
No copy-paste.No chat back-and-forth.Just the next move.
$ agent reads .axint/fix/latest.json
$ agent reads ai_repair_prompt
$ agent applies edit at line 142
$ agent reruns axint run --only-testing
✓ ready_to_ship
Want the full schema, the three verdicts, the four access methods? The deep dive on the Fix Packet artifact is its own page.
read the deep dive→