Commit 8417145
docs(do): warn that the harness checkout isn't isolated under a live flow (#130)
Per-cycle worktree isolation (#94) keeps a cycle's Do/Check off the *target*
repo, but the *harness* checkout — which holds results/issue_<id>/ state and the
pdca_harness code a running flow imports — has no equivalent protection. Running
ordinary git maintenance there during a live `pdca flow` silently corrupts
in-flight state: `git stash -u` sweeps the untracked bundle into a stale
snapshot, and a branch switch / `copier update` rewrites src/pdca_harness/*.py
under subprocesses the flow spawns (a mixed-version cycle).
Document the discipline in the worktree-isolation section of docs/04-do.md: do
harness-repo maintenance in a separate git worktree of the harness repo, never
branch-switch / copier update / git stash the live checkout while a flow runs —
#94's own principle turned on the harness repo. Note the advisory flow-lock as a
planned follow-up.
Docs-only by design (the cheapest mitigation); the acceptance is "documented as
unsupported with the worktree-based alternative spelled out."
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>1 parent 2c6bd2f commit 8417145
1 file changed
Lines changed: 25 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
35 | 35 | | |
36 | 36 | | |
37 | 37 | | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
38 | 63 | | |
39 | 64 | | |
40 | 65 | | |
| |||
0 commit comments