[jonathanprozzi]

Important

@kamescg — review ready. Base is #36; retarget to update/v1.1.0-alpha once #36 lands. This is the biggest ledger movement in the series; read the conformance/known-divergences.ts diff first.

To ratify here: (1) the declarative spec shape stays canonical, extended only by optional commonName and atomCategory; (2) the four schema-context values (three Ethereum classifications → https://schemas.intuition.systems/v1, social-media-account → https://schema.org/); (3) podcast feed normalization lives in the IID interpreter's podcast-guid source, so every entry point derives one GUID per feed.

Receipt: 28 ledger entries retired because both sides now agree (book, company, music-album, person ladders plus the two podcast cases); harness 1027 pass / 0 fail.

Child PR of the v1.1.0-alpha umbrella (#15). Part of the parity series: each PR in the series makes a train package behave exactly as the reference implementation's in-tree copy does today, so the published packages can replace those copies without a behaviour change.

Current (train)

@0xintuition/classifications carried an older catalogue than the reference implementation: identity ladders differed for several classifications (Wikidata subtype slugs, rung order, the podcast feed recipe), four schema contexts pointed at a Pages-hosted schema or the wrong vocabulary, the person spec required a family name, and consumer helpers the reference exports (lookups by type, label and derived-identifier helpers, search text, visibility presets, native types, aliases, discover groups) were missing. The podcast feed GUID was also derived from the raw feed URL when a ladder was passed straight to the IID engine, but from the normalized URL through the classification helper, so one feed could get two identities.

Need

The catalogue, the identity data and the helpers equal to the reference's, one derivation path for podcast feeds, and the conformance ledger moved to match.

Reconciliation

• Catalogue and identity data (src/generated/specs/*, src/classifications.ts and the ported helpers): every ladder, schema type and context equals the reference. The four context changes: ethereum-account, ethereum-erc20, ethereum-smart-contract → https://schemas.intuition.systems/v1; social-media-account → https://schema.org/. ClassificationSpec gains optional commonName and atomCategory; creation profiles regenerated.
• Six Wikidata ladders stay slugless (brand, local-business, location, event, thing, music-group), as in the reference; the ladder already refuses a bare Wikidata value unless explicitly allowed, so no refusal change was needed.
• packages/primitives tests: eight expectations follow the data (contexts, person mononym, the polymorphic example moved from movie to brand).
• packages/iid derive.ts: the podcast-guid value source normalizes scheme and host case before hashing, so identityLadderFor('podcast-series') passed to the engine, the classification helper and the primitives anchor builder derive the same GUID. The adapter-side normalization is removed. Regressions in iid and classifications pin the exported-ladder path.
• Conformance ledger: 28 entries retired in conformance/known-divergences.ts because the public side now equals the reference: the two podcast feed-host entries (anchor and ladder) and 26 ladder cases across book (wd:written-work, 6), company (wd:organization, 8), music-album (wd:album, 6), person (olid and the OpenLibrary author case, 5) and the person ladder structure. No actualHash re-pinned, no expectedHash or vector touched; the README enumeration moves to 33/25 for the anchor proof and 410/44 for the ladder proof (765 agreements, 70 divergences overall).

Parity

Matches the reference implementation's classifications package at its current development tip (catalogue, identity ladders, helpers) and its podcast feed normalization. Remaining differences are the ones the ledger still carries after this PR, each with its reason.

Held out

• No version bump; the release PR freezes versions for the whole family at once.

Evidence

• packages/classifications: typecheck, lint, build green; 257 tests (catalogue, label and ladder parity oracles inlined from the reference; helper equivalence; the exported-ladder podcast regression). classifications:check-creation-profiles up to date.
• packages/iid 275 tests, packages/primitives 140, packages/iid-ladder 139, packages/iid-registry 49; root registry:check (14 packages), guard:supply-chain, pack:dry-run pass.
• Conformance harness on top of test(integration): reconcile merged conformance gates and enforce them in CI #36: 1027 pass, 23 todo, 0 fail.
• Independent review: the conformance pass and the adversarial pass each found the same single finding, the podcast interpreter gap, now fixed; the adversarial pass confirmed the parity oracles go red under mutation, helper equivalence on edge inputs, consumer builds for every classification, context bytes and the person mononym rule.

Review notes

Base fix/pr15-integration-gates (#36) so the conformance gate runs on this diff; retarget to the train branch once #36 lands. Read the ledger diff first (it is the parity receipt), then src/generated/specs/ for the data, then packages/iid/src/derive.ts for the podcast change.