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-toolsmerged 2 commits from agents/1966-lessons into main2026-11-10 07:33:26 +00:00
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
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
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
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
Deliverynovox/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`.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Lessons of issue 1966's night (notes 147-163) and ADR 0668 (accepted).
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
78ef41e7bdPushed-by: lead-47@shanks
https://claude.ai/code/session_01JG73KEq4zoDfM9WtYpcQgZ
Delivery
novox/hq@78ef41e7bdb7— merged since 2026-11-10T07:33:28ZSource — source.main moved to novox/hq@2ba88971cf. Whether it reached the machines is
mesh-delivery-view's, derived fromsource.main, the wants and the haves.Transitions
The commit's note under
refs/notes/mesh-plankeeps every transition of this change up to its merge:git log --notes=mesh-plan.