SCHEMA REGISTRY

Explicit record contracts for the public atlas.

SmellBook publishes a small JSON Schema registry so public catalog, evidence and changelog records can be validated without reverse-engineering page markup.

SCHEMA VERSION1.0

RECORD SCHEMAS28

STANDARD2020-12

SCHEMAS28

knowledgeGraphExport

SmellBook knowledge-graph export (/data/graph-export.json data, and every archived release)

Required fields: header, nodes, edges

graphRecord

SmellBook graph record (/data/graph/{type}/{key}.json)

Required fields: schemaVersion, generatedAt, licence, node, outgoing, incoming, corrections, boundary

learnData

SmellBook Learn data (/data/learn.json data)

Required fields: courses, safety, fieldRights, licence, boundary

releaseLedger

SmellBook release ledger (/data/release-ledger.json data)

Required fields: releases, policy

communityObservation

SmellBook community smell observation (draft)

One smell noticed at one place and time by a person or group. Community observation: never verified fact. Not submitted anywhere; contributions are not live.

namesIndex

SmellBook names index (/data/names.json data)

Required fields: counts, names, boundary

searchResults

SmellBook search results (/data/search.json data)

Required fields: query, lang, kind, total, kinds, results, boundary

datasetReleases

SmellBook dataset release history (/data/dataset-releases.json data)

Required fields: current, releases, policy, archivePolicy, unreleased

entityHistory

SmellBook entity history (/data/entity-history.json data)

Required fields: releases, entities, boundary

releaseChanges

SmellBook release change file (/data/releases/{release}/changes.json data)

Required fields: from, to, nodes, edges, apply

heritageCrosswalk

SmellBook collection crosswalk (/data/heritage-crosswalk.json data)

Required fields: from, to, smellColumns, heritageColumns, elements, lido, exports, boundary

catalogRecord

Required fields: id, slug, name, summary, type, category, descriptors, status, createdAt, updatedAt, revision, canonicalUrl, verifiedClaimIds

claimRecord

Required fields: id, slug, title, smellSlugs, sourceIds, text, scope

sourceRecord

Required fields: id, slug, kind, tier, title, publisher, date, url, topics

changelogRecord

Required fields: id, date, label, title, copy, href

provenanceRecord

Explicit public evidence relationships only; no hidden similarity or recommendation weights.

mapNode

Required fields: id, slug, name, x, y, categorySlug, typeName, descriptors

mapTopology

Deterministic public visual topology over canonical smells and explicit unweighted editorial-related links. Coordinates and path length are not similarity scores.

personalLocalContract

Public description of the browser-local Personal SmellBook data format. This schema describes the contract and does not contain user personal data.

appliedScentContract

Transparent editorial mappings for fragrance intent and space-context guidance. This contract excludes product ranking, raw-material dosing and guaranteed behavioral outcomes.

labsExperimentContract

Public experimental Labs export containing transparent representations and PREDICTED relation candidates. Experimental records do not become canonical or VERIFIED by inclusion here.

labsEvaluationContract

Descriptive Labs evaluation and reproducibility export. It does not claim model accuracy, probability, confidence or scientific validation.

labsReviewContract

Public experimental read-only review packets and deterministic challenge sets. Inspection does not record decisions or mutate canonical / VERIFIED state.

labsReviewContextContract

Public read-only Labs review context linking PREDICTED review packets to claim-specific VERIFIED context, registered sources, gap markers and provenance trails without relation verification or scoring.

labsReviewLensContract

Public deterministic review-packet lenses and descriptive category coverage matrix without ranking, scoring or relation-verification semantics.

labsChangeAuditContract

Public deterministic Labs change audit with declared SHA-256 fingerprint inputs, current artifact digests and explicit NOT_COMPARABLE semantics when historical fingerprints were not retained.

labsAuditSnapshotContract

Immutable retained Labs audit input sets beginning on 2026-09-29, preserving only public fields that were explicitly captured at release time.

labsAuditComparisonContract

Truthful release-to-release Labs audit comparison over explicitly retained input sets, with ADDED, REMOVED, CHANGED and UNCHANGED as descriptive change states only.

/data/schema.json

Machine-readable registry

JSON Schema definitions and compatibility rules.

JSON ↗