Skip to content

docs(release): polish CONNECTOR_RELEASE_CONTRACT.md round-2 review patches (Story 44.4 follow-up)#68

Merged
ALLiDoizCode merged 1 commit intomainfrom
docs/release-contract-polish-followup
May 9, 2026
Merged

docs(release): polish CONNECTOR_RELEASE_CONTRACT.md round-2 review patches (Story 44.4 follow-up)#68
ALLiDoizCode merged 1 commit intomainfrom
docs/release-contract-polish-followup

Conversation

@ALLiDoizCode
Copy link
Copy Markdown
Collaborator

Summary

Six small content fixes deferred from Story 44.4's round-2 review cycle (connector#67 merged before these could be pushed). All fixes were verified body-clean during the original review (local diff returned empty against the patched mirror); shipping them now bundled into one connector PR + one sibling town mirror PR.

Tracked in townhouse repo at _bmad-output/implementation-artifacts/deferred-work.md (post-merge re-strategy section for Story 44.4) and surfaced in the Epic 44 retrospective at _bmad-output/implementation-artifacts/epic-44-retro-2026-05-08.md.

Patches

ID Section Fix
P3 ## Artifacts line 14 PR #62PR #63 (matches the multi-arch sentence two lines below + the connector#63/#64/#65 series in sprint-status)
P4 ## Supply-chain signing opener "Starting from the first release after PR #66" → "Starting from `v3.6.0` (cut after PR #66 merged)" — concrete pin removes ambiguity vs. Story 44.3 close note
P5 ## Verification lede + items 1-3 "Two mechanisms" → "Three mechanisms" + remove blank line so item 3 renders contiguously with items 1-2
P6 ## References Add [Interledger Protocol V4 (RFC 0027)] for the ILP packet wire-format MAJOR-bump rule (Story 44.4 Dev Notes promised this cross-link; published doc did not include it)
P7 ## Staying current `gh api` fenced block opens with ```bash to match every other code block in the doc
Q1 ## Verification item 3 Anchor cwd ("from the `toon-protocol/connector` repo root, with `toon-protocol/town` cloned as `../town`") and replace unrunnable `/path/to/town/...` placeholder with `../town/packages/sdk/CONNECTOR_RELEASE_CONTRACT.md`

Sibling town mirror PR

A sibling PR will land in toon-protocol/town to mirror this body-identical content into packages/sdk/CONNECTOR_RELEASE_CONTRACT.md. Both PRs should land same-day to keep the body-equivalence diff clean:

```bash
diff CONNECTOR_RELEASE_CONTRACT.md \
<(tail -n +4 ../town/packages/sdk/CONNECTOR_RELEASE_CONTRACT.md)

Expected: empty

```

Commit type

`docs(release): ...` — semantic-release maps this to no version bump, which is correct (these are doc-only polish fixes; the contract itself was already published in v3.6.0+ via PR #67).

Test plan

  • Six fixes applied to CONNECTOR_RELEASE_CONTRACT.md
  • CHANGELOG [Unreleased] entry added under ### Documentation
  • Pre-commit hooks green
  • Body-equivalence diff against town mirror PR returns empty after both merge
  • Reviewer eyeball check: no other content drift introduced

🤖 Generated with Claude Code

…tches

Six small content fixes deferred from Story 44.4's round-2 review cycle
(connector#67 merged before these could be pushed):

- P3: line 14 PR #62#63 (matches the multi-arch sentence two lines below
  and the connector#63/#64/#65 series in sprint-status)
- P4: pin cosign opener to "v3.6.0 (cut after PR #66 merged)" instead of
  the ambiguous "first release after PR #66" wording
- P5: ## Verification lede "Two mechanisms" → "Three mechanisms" + remove
  blank line so item 3 renders contiguously with items 1-2
- P6: add RFC-0027 reference for the ILP packet wire-format MAJOR-bump rule
  (Story 44.4 Dev Notes promised this cross-link but the published doc
  did not include it)
- P7: ## Staying current gh CLI fenced block opens with ```bash to match
  every other code block in the doc
- Q1: ## Verification item 3 anchors cwd ("from the toon-protocol/connector
  repo root, with toon-protocol/town cloned as ../town") and replaces the
  unrunnable /path/to/town/... placeholder with ../town/packages/sdk/...

Sibling town mirror PR will land in lock-step to keep the body-equivalence
diff clean.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@ALLiDoizCode ALLiDoizCode merged commit c75ae97 into main May 9, 2026
17 checks passed
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.

1 participant