edit_condition
Adjust an existing takeoff condition's quantity settings — waste percentage, multiplier, wall height, drop/rise, or roll-goods setup — to correct net order quantities and export both net and gross figures accurately.
Instructions
Set a condition's quantity knobs — waste %, multiplier, height_ft (the H knob measure_surface quantifies against), and/or roll_setup (the roll-goods opt-in: seams and order footage figured from the committed rooms, #147). takeoff_summary emits waste-adjusted *_net order quantities and a per-condition multiplier, and every export carries both, but conditions minted through the measure tools start at waste 0 / multiplier 1 — without this tool an agent's takeoff always ships net === gross (#131). waste_pct is the estimator's cut-waste percentage (carpet commonly 5–10); multiplier scales every quantity on the condition (×N identical floors — takeoff_summary applies it before waste). condition must resolve to an EXISTING finish tag — a typo'd tag errors rather than minting an empty condition (the edit_materials remove/patch rule, not its add rule: these knobs mean nothing on a condition that doesn't exist yet). No review gate — quantity config, not traced geometry; undo_last reverses a call in one step (both knobs snapshotted together, restored verbatim).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| drop_ft | No | Drop and Rise (#441): the vertical leg DOWN, in feet, every linear run of this condition adds to its plan length. Re-flows existing runs that do not carry their own drop_ft. 0 turns it off | |
| rise_ft | No | Drop and Rise (#441): the vertical leg UP, in feet, every linear run of this condition adds to its plan length (LF = plan + rise + drop). Re-flows existing runs that do not carry their own rise_ft; derived base/transitions never take a leg. 0 turns it off | |
| condition | Yes | Finish tag of an existing condition, e.g. 'CPT-1' | |
| height_ft | No | Wall height in feet — the canvas's H knob; measure_surface quantifies traced LF × this | |
| waste_pct | No | Waste percentage applied to net order quantities, e.g. 10 for 10% | |
| multiplier | No | Quantity multiplier (×N identical areas). Note: the canvas treats 0 as 1, so 0 is rejected here rather than silently meaning 'off' | |
| roll_setup | No | Roll-goods opt-in (#147): presence of a setup is what makes the condition roll goods — seams figured, cuts packed, order footage beside the measured quantities. Same-material partial edits patch the existing setup; null opts out. The reply echoes the figured order (cuts, order_lf, rolls, order_qty) whenever floor shapes exist on scaled sheets, and export_report's roll_goods block carries the same rows |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| roll | No | The figured order (same row export_report's roll_goods carries) — present when the roll-goods condition has floor shapes on scaled sheets | |
| drop_ft | No | The condition's default drop for its linear runs after this write — present once set (#441) | |
| rise_ft | No | The condition's default rise for its linear runs after this write — present once set (#441) | |
| condition | Yes | The finish tag passed in | |
| height_ft | No | The condition's wall height after this write — present once set (measure_surface multiplies traced LF by it) | |
| waste_pct | Yes | The condition's waste % after this write | |
| multiplier | Yes | The condition's quantity multiplier after this write | |
| roll_setup | No | The condition's roll-goods setup after this write — present while opted in | |
| condition_id | Yes |