Every ticket as the root of its provenance graph — goal, patch, approval, runs and (as the ticket-class build lands) mandate, manifestations, guarantees, journey, artifacts and children. Rendered through the <<<TicketGraphList>>> tag.
RFC: no STALE CHECKOUTS + no EDITABLE installs — build->commit->clean re-checkout, proper module installs only
goal
TWO standing build policies, grounded in observed failures this session.
POLICY 1 — NO STALE CHECKOUTS: when a build is done, code is committed 100% of the time, and the repo is then RE-CHECKED-OUT clean afterwards — the working tree must always exactly match the committed ref, never drift. (This session repeatedly fought working trees that had drifted from HEAD.) So the flow is invariant: build -> commit (always) -> clean checkout of that commit. No leftover build artifacts, no uncommitted drift, no 'works in my dirty tree' state.
POLICY 2 — NO EDITABLE INSTALLS: python packages may NO LONGER be installed as editable modules (pip install -e). They MUST be installed as PROPER modules (pip install .) that ship the code into site-packages, DECOUPLED from the source tree. EVIDENCE: editable installs of kokoro/brainstorm this session produced a dead venv whose scripts had absolute shebangs into a moved source path -> everything broke. Editable couples installed behavior to a mutable/movable source tree. THE ONE EXCEPTION: a module MAY be installed editable ONLY during the INITIAL development phase where a substantial, sustained round of debugging is anticipated — and it must be explicitly marked as such (a dev-phase flag), and re-installed proper before it is considered done/committed. Spawns the enforcement build tickets. Amends the refactor standard #200 (installable = PROPER install).
patch
none
approval
unapproved
runs
no runs recorded
mandate (clauses)
not yet recorded — lands with the ticket-class build
manifestations
not yet recorded — lands with the ticket-class build
guarantees
not yet recorded — lands with the ticket-class build
journey (blunders & successes)
not yet recorded — lands with the ticket-class build
artifacts (forge)
not yet recorded — lands with the ticket-class build