Skip to content

docs(TAP-011): record round failure semantics and ingress validation as open work - #216

Draft
NovusEdge wants to merge 4 commits into
The-AI-Alliance:developfrom
NovusEdge:tap-011-round-failure-semantics
Draft

docs(TAP-011): record round failure semantics and ingress validation as open work#216
NovusEdge wants to merge 4 commits into
The-AI-Alliance:developfrom
NovusEdge:tap-011-round-failure-semantics

Conversation

@NovusEdge

@NovusEdge NovusEdge commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #165, which @deanwampler invited on merge. Writes up the three points from my 07-21 review there against the merged text.

All three land in Consequences and Acceptance criteria as open work. Nothing here touches the sizing call or the governance framing settled on #165.

  • Round checkpoint semantics. Durable LinkState persists infrastructure state, not training-round state, so it does not answer what a round writes per phase, how a mid-merge failure resumes, or how a node learns its round after a coordinator restart. Design deferred to [EPIC] M1 consortium training #183.
  • Straggler policy at the sync barrier. Undefined today, and the substrate default is a silent indefinite wait. Records that dropping a contribution is governance-adjacent rather than a timeout constant.
  • Mutually-authenticated ingress. Required by item 5 but never exercised; the only Tapestry deployment of the transport ran --insecure. Also notes Flower's node-key auth is a different mechanism from the AWS reference's client-certificate mTLS.

Plus acceptance criteria 7 through 9, the supporting Basis-table rows and references, and a note on criterion 6 about SQLite state on NFS-class storage.

…as open work

Follow-up to The-AI-Alliance#165, at @deanwampler's request on merge.

Adds three items the merged ADR leaves open, scoped as open work rather
than as new decisions:

- Durable LinkState persists infrastructure state, not training-round
  state. Names what a round still has to define (phase checkpoints,
  mid-merge resume, round identity after a coordinator restart) and
  defers the design to The-AI-Alliance#183.
- The sync FedAvg barrier has no straggler policy, and the substrate
  default is a silent indefinite wait. Notes that dropping a
  contribution is governance-adjacent, not a timeout constant.
- The mutually-authenticated ingress is asserted but never exercised;
  the only Tapestry deployment of the transport ran --insecure. Also
  notes Flower's node-key auth is a different mechanism from the AWS
  reference's client-certificate mTLS.

Adds acceptance criteria 7-9 and the supporting Basis-table rows and
references.

Signed-off-by: NovusEdge <novusedge0@gmail.com>
@NovusEdge
NovusEdge marked this pull request as draft August 4, 2026 16:20

@deanwampler deanwampler left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the submission. It is marked "Draft". Is it ready for review and merging?

I think you can drop the references to the WAN spike and M0, which are more transient "states". I.e., you could reword that content to be more forward looking towards our "permanent" solution, which we'll get closer to in M1. These ADRs are intended to have a long horizon viewpoint.

I'll also ask the Flower team to comment where they are mentioned.

@deanwampler

Copy link
Copy Markdown
Member

@niclane7 your feedback is welcome...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants