* test(6): reproduce W007 + phaseVariants + W006 drift between CJS verify and SDK validate Adds tests/6-validate-cjs-drift-regression.test.cjs with 5 RED tests covering the three drift items from issue #6 between verify.cjs (Check 8) and validate.ts (Check 8): 1. W007 activeDiskPhases — verify.cjs uses diskPhases (includes archived) for W007; archived phase "1" absent from current ROADMAP fires false W007. validate.ts: activeDiskPhases (active phasesDir only) correctly excludes archives. 2. phaseVariants() normalization — ROADMAP says "01A", disk has "1A-foo". verify.cjs parseInt("01A")=1 → padded "01" (drops letter suffix) → miss. validate.ts phaseVariants("01A") = {"01A","1A","01A"} → "1A" matched. Both W006 and W007 fire as false positives in verify.cjs. 3. W006 letter-suffix padding mismatch — ROADMAP says "3B", disk has "03B-foo". verify.cjs parseInt("3B")=3 → padded "03" (drops "B") → diskPhases.has("03B") missed. W006 and W007 fire as false positives. All 5 tests RED on origin/main. Will turn GREEN after generator + verify.cjs migration. References: - Issue #6 (open-gsd/get-shit-done-redux) — maintainer acceptance criteria: "Port all three items to verify.cjs; add parity tests confirming identical output for all three cases on both paths" - ADR-3524 (docs/adr/3524-cjs-sdk-hard-seam.md) - PR #154 (issue #4) — precedent for the generator pattern Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore(6): add sdk/scripts/gen-validate.mjs generator Extracts phaseVariants() from sdk/dist/query/validate.js via brace-balanced source-text parsing (phaseVariants is a closure inside validateHealth, not a module export, so Function.prototype.toString() is unavailable). Emits get-shit-done/bin/lib/validate.generated.cjs with three pure helpers: - phaseVariants(phase): normalized Set of padded/unpadded/letter-suffix variants - buildRoadmapPhaseVariants(content): {roadmapPhases, roadmapPhaseVariants} - buildNotStartedPhaseVariants(content): Set of unchecked-phase variants These three helpers directly address the three drift items in issue #6. Follows the gen-phase-lifecycle-policy.mjs extraction pattern from PR #154. References: - Issue #6 (open-gsd/get-shit-done-redux) - ADR-3524 (docs/adr/3524-cjs-sdk-hard-seam.md) - PR #154 (issue #4) — generator pattern precedent Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore(6): add sdk/scripts/check-validate-fresh.mjs freshness check Mirrors check-phase-lifecycle-policy-fresh.mjs from PR #154: imports buildValidateCjs() directly, regenerates in-memory, and diffs against the committed validate.generated.cjs. Exits 1 if stale (CI gate). References: - Issue #6 (open-gsd/get-shit-done-redux) - ADR-3524 (docs/adr/3524-cjs-sdk-hard-seam.md) - PR #154 (issue #4) — precedent Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore(6): emit validate.generated.cjs from validate.ts Generated by: node sdk/scripts/gen-validate.mjs Exports three pure helpers extracted from sdk/src/query/validate.ts Check 8: - phaseVariants(phase): Set of normalized variants {"01A","1A"} etc. - buildRoadmapPhaseVariants(content): {roadmapPhases, roadmapPhaseVariants} - buildNotStartedPhaseVariants(content): Set of unchecked-phase variants Freshness check: node sdk/scripts/check-validate-fresh.mjs → FRESH References: - Issue #6 (open-gsd/get-shit-done-redux) - ADR-3524 (docs/adr/3524-cjs-sdk-hard-seam.md) - PR #154 (issue #4) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix(6): migrate verify.cjs to consume validate.generated.cjs helpers (GREEN) Check 8 in verify.cjs now uses three generated helpers from validate.generated.cjs: 1. buildRoadmapPhaseVariants(roadmapContent) — replaces hand-rolled roadmapPhases Set. Produces both roadmapPhases (raw, for W006 message) and roadmapPhaseVariants (all variants, for W007 membership check). Fixes false W007 for letter-suffix phases with padding mismatch. 2. activeDiskPhases — now uses collectDiskPhases() WITHOUT forEachArchivedPhaseToken. W007 iterates activeDiskPhases, not diskPhases, so archived phases absent from current ROADMAP no longer trigger false W007. 3. buildNotStartedPhaseVariants(roadmapContent) — replaces raw+parseInt-padded notStartedPhases population. Uses phaseVariants() expansion so zero-padded letter-suffix unchecked entries (e.g. "03B") correctly suppress W006 for their un-padded counterpart ("3B") and vice versa. 4. phaseVariants() in W006 loop — replaces parseInt-padded disk-existence check. "3B" now matches disk dir "03B-foo" via variant expansion. Also updates test fixture for drift item 1 to use two milestone archives (v1.0 + v1.1), accurately reproducing the scenario where forEachArchivedPhaseToken walks ALL archives while getActiveMilestoneArchiveDir returns only the most recent one. All 5 tests GREEN. Confirmed RED on pre-fix code (git stash test). References: - Issue #6 (open-gsd/get-shit-done-redux) — maintainer acceptance criteria: "Port all three items to verify.cjs; add parity tests confirming identical output" - ADR-3524 (docs/adr/3524-cjs-sdk-hard-seam.md) - PR #154 (issue #4) — generator pattern precedent Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * ci(6): wire validate freshness check into test workflow Adds 'SDK generated validate artifact drift check' step to .github/workflows/test.yml, mirroring the pattern used by all PR #154 generator freshness checks. Runs on ubuntu-latest/node-24 only (same as other artifact drift checks). Placement: after workstream-name-policy check, before Shared Module hand-sync drift check. References: - Issue #6 (open-gsd/get-shit-done-redux) - ADR-3524 (docs/adr/3524-cjs-sdk-hard-seam.md) - PR #154 (issue #4) — precedent Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore(6): wire gen:validate into sdk/package.json, root package.json, and allowlist sdk/package.json: adds gen:validate and check:validate-fresh npm scripts. package.json: adds check:validate-fresh script (mirrors other check:*-fresh entries). scripts/shared-module-handsync-allowlist.json: updates verify.cjs justification to note that Check 8 W006/W007 helpers are now generated from validate.ts via gen-validate.mjs (issue #6), with freshness check at check-validate-fresh.mjs. References: - Issue #6 (open-gsd/get-shit-done-redux) - ADR-3524 (docs/adr/3524-cjs-sdk-hard-seam.md) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs(6): amend ADR-3524 — validate.ts now uses generator pattern Adds 2026-05-23 amendment section to docs/adr/3524-cjs-sdk-hard-seam.md documenting: - Generator/artifact/freshness-check/CI paths - Three drift items resolved (W007 activeDiskPhases, phaseVariants normalization, W006 unchecked-phase variant skip) - phaseVariants extraction technique (brace-balanced source-text parsing) - Parity test coverage (5 tests, RED→GREEN) - Allowlist classification preserved (cooperating-sibling) References: - Issue #6 (open-gsd/get-shit-done-redux) - ADR-3524 (docs/adr/3524-cjs-sdk-hard-seam.md) - PR #154 (issue #4) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore(6): add changeset fragment for validate.ts/verify.cjs generator migration Touches get-shit-done/bin/lib/validate.generated.cjs and verify.cjs which match USER_FACING_PREFIXES. Required by the fix-template checklist + the changeset-lint CI workflow. Refs #6 #156 * docs(6): register validate.generated.cjs in INVENTORY + manifest INVENTORY parity test demanded a row for the new generated CJS surface and a matching entry in INVENTORY-MANIFEST.json. Headline count bumped from 74 → 75. Refs #6 --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
18 KiB
CJS↔SDK hard seam — one source of truth per Shared Module
- Status: Proposed
- Date: 2026-05-14
- Tracking issue: #3524
- Related PRD:
docs/prd/3524-cjs-sdk-hard-seam.md - Extends: ADR-0005 (seam map) — adds the Shared-Module Source Policy to the seam family
- Defers to: ADR-0001 (Dispatch Policy Module), ADR-0003 (Model Catalog Module), ADR-0004 (Planning Workspace Module), ADR-0006 (Planning Path Projection Module), ADR-0009 (Shell Command Projection Module — post-Phase 3–4, also subsuming superseded ADR-0010)
We decided to harden the boundary between the CJS tooling layer (get-shit-done/bin/lib/*.cjs) and the SDK (sdk/src/**/*.ts) by making every Module that is conceptually shared between the two runtimes have exactly one hand-authored source of truth and at most one generated artifact per runtime. The trigger is the recurring drift bug class — #1535, #1542, #2047/#2052, #2638/#2655, #2653/#2670, #2687/#2706, #2798/#2816, #3055/#3116, #3523 — each of which was a fix landing on one side without the other.
The precedent shape is already in the repo. sdk/scripts/gen-command-aliases.ts emits sdk/src/query/command-aliases.generated.ts and get-shit-done/bin/lib/command-aliases.generated.cjs from one TypeScript source. sdk/scripts/check-command-aliases-fresh.mjs is the CI freshness gate. The two consuming sides are pure Adapters over the generated artifact. This ADR generalizes that pattern to the other Shared Modules and forbids the hand-synced-pair anti-pattern that produced #3523.
Decision
1. Shared-Module Source Policy
A Shared Module is any Module whose Interface is consumed identically by both the CJS toolset and the SDK. The CONTEXT.md domain glossary already calls these out — e.g. STATE.md Document Module is explicitly typed as "Shared CJS/SDK pure transform Module."
For every Shared Module:
- Exactly one hand-authored source of truth. Lives at
sdk/src/<module-name>/as TypeScript when the Module has behavior, orsdk/shared/<module-name>.manifest.jsonwhen the Module is pure data. - Generated artifacts only. The CJS-side file is
get-shit-done/bin/lib/<module-name>.generated.cjsand is emitted mechanically. It is never hand-edited. - Per-Module freshness check. A CI script
sdk/scripts/check-<module>-fresh.mjsre-runs the generator and fails if the emitted artifact differs from the committed one. Precedent:check-command-aliases-fresh.mjs. - Per-Module drift lint (when the source is data, not a generator output). Precedent:
scripts/lint-shell-command-projection-drift.cjs. The lint asserts the canonical-owner invariants that aren't captured by file-equality. - Hand-synced pairs are forbidden. A pre-merge
lint-shared-module-handsync.cjsgrepsget-shit-done/bin/lib/for non-.generated.*files whose basename matches asdk/src/query/<same-name>.tssource and fails the build unless the pair is explicitly allow-listed.
2. Module-indexed canonical-owner table
The table below indexes by Module, not by physical layer. Each row names the source of truth, the emitted artifacts, the Adapter sites, and either the new ADR section that defines the Module or the existing ADR that already owns it.
| Module | Status | Source of truth | Generated artifacts | Adapters |
|---|---|---|---|---|
| STATE.md Document Module | New under this ADR (Phase 1) — see CONTEXT.md "STATE.md Document Module" | sdk/src/state-document/index.ts (promoted from sdk/src/query/state-document.ts) |
sdk/src/query/state-document.generated.ts, get-shit-done/bin/lib/state-document.generated.cjs |
bin/lib/state.cjs and sdk/src/query/state*.ts import the generated form |
| Configuration Module | New under this ADR (Phase 2) — definition added to CONTEXT.md as part of Phase 2 | sdk/src/configuration/index.ts plus data manifests sdk/shared/config-schema.manifest.json and sdk/shared/config-defaults.manifest.json |
sdk/src/query/config-schema.generated.ts, get-shit-done/bin/lib/config-schema.generated.cjs, get-shit-done/bin/lib/configuration.generated.cjs |
bin/lib/config.cjs, bin/lib/core.cjs:loadConfig, sdk/src/config.ts |
| Workstream Inventory Module (Builder) | Amended under this ADR (Phase 3) — Builder split documented in CONTEXT.md update | sdk/src/workstream-inventory/builder.ts (pure projection from directory entries + STATE.md text + plan scan results → typed inventory) |
sdk/src/query/workstream-inventory-builder.generated.ts, get-shit-done/bin/lib/workstream-inventory-builder.generated.cjs |
Per-side fs Readers (workstream-inventory.cjs sync, workstream-inventory.ts async) call the Builder. Readers stay hand-authored because the fs idiom legitimately differs. |
| Project-Root Resolution Module | New under this ADR (Phase 4) — short CONTEXT.md entry, behavior already de-facto shared | sdk/src/project-root/index.ts |
get-shit-done/bin/lib/project-root.generated.cjs |
bin/lib/core.cjs (findProjectRoot, findEffectiveRoot), sdk/src/helpers.ts |
| Frontmatter Module | Conditional (Phase 3, only if drift catalogue confirms pair duplication) | sdk/src/frontmatter/index.ts |
get-shit-done/bin/lib/frontmatter.generated.cjs |
Existing handler call sites |
| Plan Scan Module | Conditional (Phase 3 or later) | sdk/src/plan-scan/index.ts |
get-shit-done/bin/lib/plan-scan.generated.cjs |
Phase/roadmap routers |
| CJS Command Router Adapter Module | Amended under this ADR (Phase 5). Existing Module (per CONTEXT.md) is extended so the per-family handlers map delegates to the SDK runtime bridge in-process instead of to parallel CJS handler implementations. |
sdk/src/query-runtime-bridge.ts (already exists) + per-family delegate emitter |
get-shit-done/bin/lib/cjs-command-router-adapter.cjs (existing, ~40 lines) plus per-family handlers maps that require('../../sdk/dist/query-runtime-bridge.cjs') and call QueryRuntimeBridge.execute() |
bin/gsd-tools.cjs and the seven bin/lib/*-command-router.cjs files are the consumers. Per-family CJS handler files (state.cjs, verify.cjs, init.cjs, etc.) shrink to delegates or are deleted once the SDK handler is the only implementation. |
| Command-Alias Module | Already sealed by this pattern's precedent — sdk/scripts/gen-command-aliases.ts + check-command-aliases-fresh.mjs |
No change | No change | No change |
| Dispatch Policy Module | Defer — see ADR-0001 (and its 2026-05-05 SDK Runtime Bridge amendment) | n/a | n/a | n/a |
| Model Catalog Module | Defer — see ADR-0003; the sdk/shared/model-catalog.json manifest already follows the source-of-truth policy |
n/a | n/a | n/a |
| Planning Workspace Module | Defer — see ADR-0004; withPlanningLock, workstream pointer policy, lock semantics stay where they are |
n/a | n/a | n/a |
| Planning Path Projection Module | Defer — see ADR-0006; SDK is canonical, CJS path resolution converges via Phase 4 if any divergence is found | n/a | n/a | n/a |
| Shell Command Projection Module (incl. platform fs + subprocess after Phase 3–4 expansion) | Defer — see ADR-0009; this Module is the canonical owner for platformWriteSync, platformReadSync, platformEnsureDir, execGit, execNpm, execTool, probeTty, normalizeContent |
n/a | n/a | n/a |
| Skill Surface Budget Module | Defer — see ADR-0011 (accepted, not the 0011-superseded draft) | n/a | n/a | n/a |
3. Out-of-seam Modules (per-runtime, no shared source)
These remain CJS-only. Drift cannot occur because there is no SDK counterpart. If any later needs an SDK port, that port is a new enhancement, not a parallel implementation.
bin/lib/graphify.cjsbin/lib/gsd2-import.cjsbin/lib/schema-detect.cjsbin/lib/fallow-runner.cjsbin/lib/intel.cjsbin/lib/drift.cjsbin/lib/installer-migrations.cjs(installer runtime is CJS-native; SDK consumes viasdk-package-compatibility.tsAdapter)
4. Per-side I/O Adapters legitimately differ
The per-side state Adapter, verify Adapter, and similar handlers are not in the Shared-Module table. CJS callers use synchronous fs/exec; SDK callers use async I/O and the SDK observability decorators. The pure transforms behind them (parsing, projection, normalization) are extracted into Shared Modules per the table above; the I/O remains per-side. Golden parity tests in sdk/src/golden/ pin observable behavior across the seam.
5. Enforcement (per existing repo precedents, not new conventions)
Drift is blocked at three layers, each modeled on an existing in-repo script:
- Per-Module freshness check —
sdk/scripts/check-<module>-fresh.mjs, one per Shared Module in the table. Precedent:check-command-aliases-fresh.mjs. - Per-Module drift lint (when invariants are not pure file-equality) —
scripts/lint-<module>-drift.cjs, one per data-manifest-backed Module. Precedent:lint-shell-command-projection-drift.cjs. - Hand-sync pair lint —
scripts/lint-shared-module-handsync.cjsrejects any pair of files atget-shit-done/bin/lib/<name>.cjsandsdk/src/query/<name>.ts(orsdk/src/<name>.ts) that are neither generated artifacts nor on an explicit allow-list. This blocks the #3523 anti-pattern at PR time.
CODEOWNERS extends to sdk/src/<module>/ for each Shared Module. Architecture-team review is required for changes to a source of truth.
A top-of-file banner is auto-inserted by each generator into the emitted .generated.cjs / .generated.ts files. Banner pattern follows the existing command-aliases.generated.* files: a header noting "GENERATED FILE — Source: …". No additional banner tooling is introduced.
6. New CONTEXT.md entries added by this ADR's phases
- Configuration Module (added during Phase 2): Module owning config load, legacy-key normalization, defaults merge, and explicit on-disk migration for
.planning/config.json. Interface:loadConfig(cwd) → MergedConfig(pure read, no disk write);normalizeLegacyKeys(parsed) → { parsed, normalizations[] }(idempotent, returns the list of normalizations applied for migration logging);mergeDefaults(parsed) → MergedConfig;migrateOnDisk(cwd) → MigrationReport(explicit, opt-in, called only by the installer and bygsd-tools migrate-config). Invariants: never mutates disk insideloadConfig; legacy top-level keys (branching_strategy,sub_repos,multiRepo,depth) are normalized into their canonical nested locations in the returned value; defaults come from the sharedconfig-defaults.manifest.json. - Project-Root Resolution Module (added during Phase 4): Module owning project-root and effective-root resolution heuristics including own-
.planningdetection, parent-sub_repostraversal, legacymultiRepo, and.git-ancestor fallback. - Workstream Inventory Module — Builder split (CONTEXT.md amendment during Phase 3): the existing Module entry gains a sub-paragraph noting that the pure projection logic is the source of truth and the per-side Reader Adapters are hand-authored over the generated Builder.
- CJS Command Router Adapter Module — runtime-bridge delegation (CONTEXT.md amendment during Phase 5): the existing Module entry gains a paragraph noting that the per-family
handlersmap delegates toQueryRuntimeBridge.execute()in-process viarequire('../../sdk/dist/query-runtime-bridge.cjs'). Per-side CJS handler files (state.cjs,verify.cjs, etc.) that previously held parallel implementations are reduced to delegates or deleted once their SDK counterpart is the only remaining implementation. CJS-only Module handlers (graphify, gsd2-import, schema-detect, fallow-runner, intel, drift) keep their in-process CJS implementations because no SDK counterpart exists.
Consequences
- The hand-synced-pair anti-pattern that produced #3523 becomes impossible to merge. The
lint-shared-module-handsync.cjsgate rejects any new pair that is not generated. Thecheck-<module>-fresh.mjsgates reject any edit to a generated file that is out of sync with its source. - The seam vocabulary stays inside the existing CONTEXT.md / LANGUAGE.md frame. No new layer labels ("shared core", "shared data"); the unit of seam ownership is the Module, as it already is everywhere else in this repo.
- No new build tooling is introduced. The generator pattern is the existing
gen-command-aliases.tsshape. No dual CJS+ESM bundler, nopackage.jsonexportssubpath change, notsup/rollupdecision. - Each phase ships one Shared Module. The smallest phase (STATE.md Document Module) ships first because both files are already character-identical — the deletion test passes on contact. The trigger bug class (#3523) is closed in Phase 2 by the Configuration Module. The seam becomes a real wall in Phase 5 when the CJS routers stop holding parallel handler implementations.
- CJS dispatch collapses onto the SDK runtime bridge. Once Phase 5 lands, every canonical command running via
gsd-toolsexecutes the same SDK handler thatgsd-sdk queryexecutes — in-process, not subprocess. The per-side state/verify/init/phase/roadmap/validate handler implementations in CJS are replaced by thin delegates overQueryRuntimeBridge.execute(). The result-shape contract is preserved ({ exitCode, stdoutChunks, stderrLines }per the Query CLI Output Module, ADR-0001). - Existing ADRs are deferred to, not restated. Planning Path Projection (ADR-0006), Model Catalog (ADR-0003), Planning Workspace (ADR-0004), Dispatch Policy (ADR-0001), Shell Command Projection (ADR-0009) remain authoritative for their domains. The new ADR adds Shared-Module Source Policy, the per-Module entries above, and the CJS Command Router Adapter Module amendment.
- Per-side I/O Adapter divergence is preserved at the runtime-bridge boundary. The CJS router's sync execution model is preserved:
QueryRuntimeBridge.execute()exposes a sync entry point for CJS callers (or, when the underlying SDK handler is async, the bridge runs an in-process event loop step). No subprocess hop is added. Async SDK call sites continue to use the async bridge directly. - Enforcement reuses existing scripts. Three new lint/check primitives, all modeled on scripts already in
scripts/andsdk/scripts/. CI wiring follows the existing precedent.
Out of scope
- Migrating CJS-only Modules (graphify, gsd2-import, schema-detect, fallow-runner, intel, drift) to SDK handlers — each is its own enhancement.
- Sync→async migration of CJS state/verify Adapters — leaves the per-side Adapter shape intact, which is the point.
- Defining a Verify Module before the verify surface has a shared Interface — that is precondition work for a future enhancement, not this one.
Amendments
(Append-only. Use a dated header when the decision evolves.)
2026-05-23 — validate.ts → verify.cjs generator pattern (issue #6)
Three pure helpers from sdk/src/query/validate.ts Check 8 are now generated into
get-shit-done/bin/lib/validate.generated.cjs via sdk/scripts/gen-validate.mjs,
following the same I/O adapter pattern established by PR #154 (issue #4):
Generator: sdk/scripts/gen-validate.mjs
Artifact: get-shit-done/bin/lib/validate.generated.cjs
Freshness check: sdk/scripts/check-validate-fresh.mjs
CI: .github/workflows/test.yml — "SDK generated validate artifact drift check"
Three drift items resolved (issue #6):
-
W007
activeDiskPhases—verify.cjsCheck 8 previously iterateddiskPhases(which includes archived milestone phases viaforEachArchivedPhaseToken) for the W007 check. Archived phases absent from the current ROADMAP produced false W007 warnings. Fix: W007 now iteratesactiveDiskPhases(fromcollectDiskPhases()only, withoutforEachArchivedPhaseToken), matchingvalidate.tsCheck 8 behavior. -
phaseVariants()normalization —verify.cjsCheck 8 usedparseInt(p).padStart(2,'0')for disk-existence and roadmap-membership checks, which drops letter suffixes (e.g. "3B" → "03" instead of "03B"). Phase dirs with letter-suffix padding mismatches (ROADMAP "3B", disk "03B-foo") produced false W006 and W007. Fix: both checks now usephaseVariants(p)from the generated module, which returns the full normalized Set including letter-suffix forms. -
W006 unchecked-phase variant skip —
verify.cjsCheck 8 builtnotStartedPhaseswith raw +parseInt-padded forms (drops letter suffix).phaseVariants()is now used instead, so unchecked entries like "3B" correctly suppress W006 for "03B" (and vice versa).
phaseVariants extraction note: phaseVariants is defined as a closure inside validateHealth
in the compiled output (not a module-level export). It is extracted via brace-balanced source-text
parsing from sdk/dist/query/validate.js, the same technique used for escapeRegex extraction in
gen-phase-lifecycle-policy.mjs. The function is deterministic and pure: no closures over external
state, no side effects.
Parity tests: tests/6-validate-cjs-drift-regression.test.cjs — 5 tests (all GREEN after fix,
all RED on pre-fix origin/main). Covers each drift item with concrete fixtures:
- Drift 1: two milestone archives (v1.0 old, v1.1 active); v1.0 phase absent from ROADMAP.
- Drift 2: ROADMAP "01A", disk "1A-foo" — padding mismatch.
- Drift 3: ROADMAP "3B", disk "03B-foo" — zero-padded letter-suffix mismatch.
Allowlist: scripts/shared-module-handsync-allowlist.json — verify.cjs entry updated to
reference the generator and freshness check. Classification remains cooperating-sibling (verify.cjs
is still a full implementation; only Check 8 helpers are generated).