Add iPhone dogfood receipt runbook

2026-06-21 05:44:10 +02:00
parent 8658f7cc95
commit f5c81155ea
2 changed files with 61 additions and 0 deletions
@@ -44,6 +44,11 @@ Canonical server install verification for a selected profile:
 zig build --prefix /tmp/mim-install verify-install-code
 ```

+Canonical v1 dogfood receipt:
+
+- Use `DOGFOOD.md` for the real iPhone SSH session checklist and #41 receipt template.
+- Do not close #41 from fixture/headless evidence alone; it requires a real iPhone SSH edit receipt unless the tracker acceptance is explicitly changed.
+

 ## Work tracking

@@ -0,0 +1,56 @@
+# v1 iPhone SSH dogfood receipt
+
+Use this when closing #41. Do not mark the dogfood complete unless the edit was made from a real iPhone SSH terminal session.
+
+## Before the iPhone session
+
+On the target SSH server, from a fresh checkout:
+
+```sh
+zig build test
+zig build v1-smoke
+zig build --prefix "$HOME/.local" verify-install-code
+```
+
+Start the dogfood session from the iPhone SSH client and use the installed binary:
+
+```sh
+cd /path/to/a/small/real/repo
+"$HOME/.local/bin/mim" --version
+"$HOME/.local/bin/mim"
+```
+
+## Task constraints
+
+Pick one small real repository fix that can be judged without a desktop IDE:
+
+- a typo or docs fix;
+- a tiny test/source correction;
+- a small config/example correction.
+
+Do not use this receipt for a simulated fixture-only edit, a desktop terminal edit, or an edit made outside the iPhone SSH session.
+
+## Receipt to paste into #41
+
+```text
+DOGFOOD RECEIPT
+- Date:
+- Device/client: iPhone + <SSH app/name>
+- Server OS/arch:
+- mim commit:
+- Installed profile: coding (`mim-code` as bin/mim)
+- Repository/task:
+- Starting command:
+- Actual edit made from iPhone SSH:
+- Verification run after edit:
+- Blockers found:
+  - fixed now:
+  - deferred with reason:
+- Diagnostics encountered:
+- PRODUCT.md proof met? yes/no
+- Would choose mim over Neovim for this small iPhone SSH fix? yes/no + why:
+```
+
+## Close rule
+
+Close #41 only when the pasted receipt confirms a real iPhone SSH edit and any blocking v1 findings are either fixed in committed code or explicitly deferred as non-blocking for PRODUCT.md v1 proof.