docs(subsystems): live-e2e 页把 --evidence 的拒绝范围写宽了，与 nightly 自相矛盾 #1180

Activity

1. Birfy

   added

   documentationImprovements or additions to documentationImprovements or additions to documentation

   area:docsDocumentationDocumentation

   agent-readyMaintainer-approved spec: an agent may take it. Only maintainers set this; never in a templateMaintainer-approved spec: an agent may take it. Only maintainers set this; never in a template

   on Oct 25, 2026
2. Birfy commented on Oct 25, 2026

   

   Birfy

   on Oct 25, 2026

   CollaboratorAuthor

   More actions

   Written-by: Triage

   Re-triaged at main 6d75f648. Confirmed on the tree: docs/subsystems/live-e2e.md:36 says “a bench home (or --evidence directory) inside the checkout” is refused, :49 repeats it — while dev/live-e2e/README.md:36 already draws the line correctly (home outside the checkout and never under ~/.dsh; --evidence refused only inside dev/live-e2e/), and nightly passes --evidence evidence, which is inside the checkout and outside dev/live-e2e/. So the page would fail its own documented command.

   Fix: :36 and :49 become “a bench home inside the checkout, or an --evidence directory under dev/live-e2e/”, wording matched to the README path table; guardRunand the nightly workflow are not touched. Checks that must stay green:arch-docs` and the markdown link check on that page.

   Owner: Dev4 — one docs PR together with #1184, both under docs/subsystems/. Reviewer: must not be Dev4.
3. Birfy commented on Oct 25, 2026

   

   Birfy

   on Oct 25, 2026

   CollaboratorAuthor

   More actions

   Claimed by Dev4 — branch dev4/docs/1184-1180-doc-matches-code, cut from 6d75f648 (live main). One docs PR for #1184 + #1180, no code change: #1194 (tip 2785b5d4).

   • docs/subsystems/core-host.md: one paragraph says a write-back report is only taken while pending and then that a late one is taken #1184: docs/subsystems/core-host.md:187 — "only while the comment is pending" → "pending or unconfirmed" (tasks.js:401 takes both).
   • docs(subsystems): live-e2e 页把 --evidence 的拒绝范围写宽了，与 nightly 自相矛盾 #1180: docs/subsystems/live-e2e.md:35-38 — "a bench home (or --evidence directory) inside the checkout" → "a bench home inside this checkout, or an --evidence directory under dev/live-e2e/" (report.mjs:71), matching the invariant at :49-50 and dev/live-e2e/README.md:36.

   Both close with the same merge (Fixes lines are separate, one per issue) so neither is left with an orphan branch.
4. Birfy

   added

   agent-workingAn agent has claimed this issue (the claim comment names the branch)An agent has claimed this issue (the claim comment names the branch)

   and removed

   agent-readyMaintainer-approved spec: an agent may take it. Only maintainers set this; never in a templateMaintainer-approved spec: an agent may take it. Only maintainers set this; never in a template

   on Oct 25, 2026
5. Birfy

   closed this as completedin #1194on Oct 25, 2026
6. Birfy

   removed

   agent-workingAn agent has claimed this issue (the claim comment names the branch)An agent has claimed this issue (the claim comment names the branch)

   on Oct 25, 2026
7. Birfy commented on Oct 25, 2026

   

   Birfy

   on Oct 25, 2026

   CollaboratorAuthor

   More actions

   Same PR, same merge: done — 7fae84e25779308d1d1d1c4ea33fb3c9e393b8ac. The wrap-up evidence (merge-commit file list, byte-identical blobs, the sentence on main vs report.mjs:71, labels) is written once on #1184: #1184 (comment)
8. HugoXK

   added 2 commits that reference this issue on Oct 25, 2026

   docs: say what the write-back and evidence guards actually do (ThinkF…

   ...

   7fae84e

   docs: say signing is shipped and not enabled (ThinkFlowLab#1195) (Thi…

   ...

   8fbd78a