Glossary: transport fault and kept call; developers run the touched packages' integration tests once per head and use the live seat list (issue 1966, ADR 0668) #533

Merged
mesh-tools merged 2 commits from agents/1966-lessons into main 2026-11-10 07:33:26 +00:00
Member

Lessons of issue 1966's night (notes 147-163) and ADR 0668 (accepted).

  • Glossary (Core): transport fault (ADR 0664 §1's classes plus a call's own deadline, ADR 0668 §1) and kept call (ADR 0668 §1-§4, §7); observer covers a kept call's caller for its call-unanswered.
  • mesh-developer definition, playbook 07 (step table, step 1 and its brief, review item 4, step 3), playbook 08 and playbooks.html: once per head reported, the developer runs the integration tests of the packages it touched and of their importers against an embedded bus (by name where the importers are many, the choice named in the report), never a whole module's or level's run (the operator's rule of 2026-10-18 stands); in mesh-sdk the whole untagged ./... (its seat-copy test); the manifest validator and catalog checks get the live seat list, read again when the head is reported; at two thirds of its context a developer writes its handover in the prepare file. Tonight a round-1 failure was missed by untagged-only runs, and stale captured seat copies hid two more.

hq's tests (records, index, cycle, words) pass at the head.

Reviewed-by: review-running-and-testing@shanks (two must findings fixed, then approved) at 78ef41e7bd
Pushed-by: lead-47@shanks

https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ

Lessons of issue 1966's night (notes 147-163) and ADR 0668 (accepted). - Glossary (Core): **transport fault** (ADR 0664 §1's classes plus a call's own deadline, ADR 0668 §1) and **kept call** (ADR 0668 §1-§4, §7); observer covers a kept call's caller for its call-unanswered. - mesh-developer definition, playbook 07 (step table, step 1 and its brief, review item 4, step 3), playbook 08 and playbooks.html: once per head reported, the developer runs the integration tests of the packages it touched and of their importers against an embedded bus (by name where the importers are many, the choice named in the report), never a whole module's or level's run (the operator's rule of 2026-10-18 stands); in mesh-sdk the whole untagged ./... (its seat-copy test); the manifest validator and catalog checks get the live seat list, read again when the head is reported; at two thirds of its context a developer writes its handover in the prepare file. Tonight a round-1 failure was missed by untagged-only runs, and stale captured seat copies hid two more. hq's tests (records, index, cycle, words) pass at the head. Reviewed-by: review-running-and-testing@shanks (two must findings fixed, then approved) at 78ef41e7bdb79dd28ff05fd7fd784b4ed5c64b62 Pushed-by: lead-47@shanks https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
mesh-tools added 2 commits 2026-11-10 05:54:06 +00:00
Issue 1966's fix group showed two gaps in how a developer checks: an integration
test the change broke went unseen because only the untagged suite ran, and a stale
seat list made the local manifest validator refuse what the running one accepts.
The developer definition and playbook 07's develop step now run the touched
packages' integration tests against an embedded bus, the whole of mesh-sdk, and
the validator against the live seat list and a fresh catalog trunk, and stop at
two thirds of the context with a handover in the prepare file. The glossary gains
transport fault (ADR 0664 §1, ADR 0668 §1) and kept call (ADR 0668).

Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
Make playbooks 07 and 08 agree on the developer's integration run, and bound it
mesh/check checking 78ef41e7bdb7 on 2ba88971cf52
mesh/delivery merged: source.main moved to novox/hq@2ba88971cf52
78ef41e7bd
The first amendment left the step table, the review's reading of integration
tests, step 3 and playbook 08 saying the opposite. The run is now once per head
reported, the touched packages and their importers in the module, by name where
the importers are many, and never a whole module or level, within the operator's
rule of 2026-10-18. The live seat list is read again when a head is reported.

Claude-Session: https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
Author
Member

Delivery novox/hq@78ef41e7bdb7 — merged since 2026-11-10T07:33:28Z

Source — source.main moved to novox/hq@2ba88971cf. Whether it reached the machines is mesh-delivery-view's, derived from source.main, the wants and the haves.

Transitions

  • 2026-11-10 05:54 (new) → proposed (announced): novox/hq#533's head announced
  • 2026-11-10 05:54 proposed → ready (accepted): a verdict names this commit and the trunk's head as its trunk commit, the gate passed or warned, and the repository's own check did not fail; or the check gates no merge (check-gates-merge false)
  • 2026-11-10 07:33 ready → merged (merged): on the trunk its modules follow: merged there

The commit's note under refs/notes/mesh-plan keeps every transition of this change up to its merge: git log --notes=mesh-plan.

<!-- mesh-delivery:view --> **Delivery** `novox/hq@78ef41e7bdb7` — **merged** since 2026-11-10T07:33:28Z **Source** — source.main moved to novox/hq@2ba88971cf52. Whether it reached the machines is `mesh-delivery-view`'s, derived from `source.main`, the wants and the haves. **Transitions** - 2026-11-10 05:54 (new) → proposed (announced): novox/hq#533's head announced - 2026-11-10 05:54 proposed → ready (accepted): a verdict names this commit and the trunk's head as its trunk commit, the gate passed or warned, and the repository's own check did not fail; or the check gates no merge (check-gates-merge false) - 2026-11-10 07:33 ready → merged (merged): on the trunk its modules follow: merged there The commit's note under `refs/notes/mesh-plan` keeps every transition of this change up to its merge: `git log --notes=mesh-plan`.
mesh-tools merged commit 2ba88971cf into main 2026-11-10 07:33:26 +00:00
mesh-tools deleted branch agents/1966-lessons 2026-11-10 07:33:27 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: novox/hq#533