Skip to content

docs(onboarding): close the three post-sweep gaps - #233

Merged
ivanball merged 1 commit into
mainfrom
docs/onboarding-gaps-20261002
Oct 2, 2026
Merged

ivanball merged 1 commit into
mainfrom
docs/onboarding-gaps-20261002

Conversation

@ivanball

@ivanball ivanball commented Oct 2, 2026

Copy link
Copy Markdown
Owner

Summary

Follow-up to #232, closing its three known gaps.

  1. MMCA.Store cites are now checked and correct. verify.ps1 previously skipped every Store citation. With Store included it found 65 full-path cites to moved or past-end files plus 3 short-form failures. 54 were re-located by a unique text match against the file's last pre-move version; the rest were read against source (15 relocated, 5 rewritten). Two sentences now describe current code: Store's CustomerErasedHandler replaces the deleted ProductVariantAddedHandler, and the address max lengths come from Common's OwnsAddress. The devops-aspire scoring-telemetry paragraph is rewritten for the MMCA.Common.AI meter.
  2. Testing-chapter family sections are whole again. The 14 families split across write units were a plan.ps1 packing defect (fixed-size chunks), now fixed in the harness (family-aware packing). The resulting 265 section moves stay inside group-28-testing-infrastructure.md; a sorted-line comparison against the published chapter shows no content change beyond the next item. The dead IsAuthenticatedAuthorizationService section (type deleted in MMCA.Common #453) is removed, and the sentence that cited it now describes DefaultAuthorizationService.
  3. Index wording: the G07, G08, G09, G13, G15 and G28 rows name what the sweep added.

Verification

  • verify.ps1 exit 0: 0 missing, rubric 34/34, 0 rollup, 0 citation failures (8,343 full-path cites, Store included), 0 anchor failures, 0 short-cite failures (14,755).
  • Harness tests: test-verify.ps1 40/40, test-repack.ps1 20/20 (the new R4 fails against the old repack.ps1).
  • npm run build: dead cross-links none.

Remaining limit

The gates prove a cite lands inside a real file, not that it is the right line. Store cites that were in range were read by an agent (33) or matched by text (54); other in-range cites keep only the range guarantee.

🤖 Generated with Claude Code

https://claude.ai/code/session_017sM9CaoknTbrWYz8tFcb1S

- MMCA.Store cites: every Store citation now resolves and points at the
  described code. 54 cites to moved Store files were re-located by
  unique text match, 15 more relocated or rewritten after reading
  source, and two sentences now describe current code (Store's
  CustomerErasedHandler replaces the deleted ProductVariantAddedHandler;
  the address max lengths come from Common's OwnsAddress). The
  devops-aspire scoring-telemetry paragraph is rewritten for the
  MMCA.Common.AI meter.
- Testing chapter family sections: 14 families split across write units
  are whole again (family-aware unit packing; content unchanged, only
  section order within the chapter moves). The dead
  IsAuthenticatedAuthorizationService section is removed (type deleted
  in MMCA.Common #453) and the sentence citing it now describes
  DefaultAuthorizationService.
- 00-index.md: G07, G08, G09, G13, G15 and G28 rows name what the sweep
  added (per-engine strategy, AuthSessionIssuer, shared-store cache
  read, GrpcWireFormat, the same-origin proxy, the LoadTests tier).

verify.ps1 exit 0, now including Store: 8,343 full-path and 14,755
short-form cites checked, 0 failures.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017sM9CaoknTbrWYz8tFcb1S
@ivanball
ivanball merged commit 6ca60e6 into main Oct 2, 2026
4 checks passed
@ivanball
ivanball deleted the docs/onboarding-gaps-20261002 branch October 2, 2026 11:53
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