2.1 KiB
Step 17 — Implementation Detail
Built on 2026-10-07. app/tools/workspace.py keeps a working copy in the Deliverable's working memory, which the Execution already checkpoints and returns on every attempt.
Files (working["files"]), for the Deliverable whose working_copy is its own kind (deployment guidance):
write_file,edit_file(replaces the one placeoldmatches, and refuses when it matches none or several),read_file(one file, or the list) anddelete_file.terraform_fmt,terraform_validateandterraform_planrun on the Terraform files in the working copy and take nofilesargument.terraform_fmtformats in place and returns the names it changed. Files passed anyway are written to the working copy first, so a model that ignores the instruction still works.submit_deliverableattaches the working copy; a file passed as an attachment replaces its copy. The submitted files become the working copy, so a Revision starts from them, and the task context lists them underworking_copy.
The validator's working_copy is deployment guidance: its tools are given a fresh copy of the submitted files on every attempt, it has no write tools, and nothing from the copy is attached to its Deliverable.
Graph (working["graph"]), for the Target architecture:
graph_putadds items or replaces those with the same id,graph_removeremoves by id,graph_readreturns the graph. The submitted graph becomes the working graph.submit_deliverableattaches the working graph when notarget-architecture.jsonis passed.render_tableswrites the Elements, Relationships, Checks and not-applicable tables from the graph, and the engine appends them to the content on submission. The contract's sections are nowDesign rationalealone. This closes the duplicate output iteration 6 left: the architect no longer writes the graph twice.
Unmeasured: no evaluation has run, so the fall in requests, tokens and time is expected, not shown. The mechanism is what is tested.
Tests: tests/execution/test_working_copy.py (21), including an Execution in which the validator validates the submitted code with no files passed.