Engineering Mandate Completion Notes (2026-07-03)
Companion to 2026-07-03-engineering-mandate.md. All 3 tasks shipped; the gate
is live in the deploy path (proven end-to-end: gated ship dad18cf deployed to
staging, health 200, agents healthy).
What shipped
scripts/check-conventions.mjs+ rootpnpm check(294946a) — three rules
(BOUNDARY, ON-PREM, MUTATION-GUARD), each proven to fail on a deliberate
violation and pass clean.build-and-ship.shgate wiring + pytest in both agent images (084a451).- CLAUDE.md "Engineering mandate" section (bc4e200).
Deviations from the plan
- pytest deps under
uv pip sync— sync treats requirements.txt as an
exact set and does NOT resolve dependencies; barepytest>=8,<9produced
No module named 'pluggy'in-image. Fix:pluggy>=1.5,<2+iniconfig>=2
added alongside (packaging was already pinned). - Scratch Postgres for in-image tests — the policy suites connect to
Postgres at import time (onlytest_embedder.pyis hermetic), so the plain
docker run … pytestfrom the spec cannot work. The gate now spins up a
throwawaypgvector/pgvector:pg17(ahu-gate-pg, user/pass/db = ai) on a
tempahu-gatenetwork, points tests at it viaDB_HOST, and tears it
down. Both agents: 23 passed each, ~4s. - Ship inbox moved (dad18cf) — first gated ship failed at scp:
/tmp/ahu-imageson Server 2 was obert-owned and /tmp's sticky bit blocked
efran. Inbox now/home/efran/ahu-ai-staging/inbox; tarballs are deleted
afterdocker load(the old inbox had accumulated 1.2 GB; removed via
obert).
Gotcha for future sessions
docker run … | tail swallows the container's exit code — the first
"successful" pytest proof was actually a masked failure. The gate itself pipes
nothing; when probing manually, use set -o pipefail.