All notable changes to the dfo-spec-kit Python package will be documented in
this file. The format is based on Keep a Changelog,
and this package adheres to Semantic Versioning.
- Codes
share_id_taken(409) andshare_import_not_permitted(403) onpresentation.sharesinregistries/codes.jsonand its bundled mirror, for the share import route.share_id_takencovers an id that holds another share, or the same share stored with a different write-token digest.share_import_not_permittedcovers a caller that did not send the import principal, and a deployment with no import principal set. Neither is retryable. The client contract gives them thefix_requestandrequest_scopeactions. dfo_spec_kit.unitsreads a unit ref into one typed value:Money(currency,prices,base_year,chained),UnpricedMoney(currency),Percent,CountorOther(ref). A ref that leaves prices unstated (Currency<ISO>, a bare code,USDollarand the other named twins, the UNCR_USDandCR_EUR) parses toUnpricedMoney, which raisesTypeErroron any comparison and is unhashable.complete_pricesgives it the price basis of the StatVar's measurement qualifier (Nominalcurrent,RealValueconstant) as a comparableMoney, soCurrencyUSD,USDollarandUSDare one value once completed under one qualifier. A constant-priceMoneywith no base year raises the sameTypeErroron comparison and hashing, andparse_unitreturns a new object on every call, so neither incomparable value matches by identity in a set, dict or list. Chained-dollar refs carrychained=True, so they never equal a fixed-base amount of the same base year.Moneyrefuses withValueErrorabase_yearthat is not anint(aboolincluded), apricesthat is not a string, and achainedthat is not aboolor is true for current prices. A bare ref is money only when it is an ISO 4217 code from the registry'scurrency_codes, soTEUparses asOther. A ref that scales its values (SDG_CU_USD_M,SDG_NUM_TH,PeopleInThousands) parses asOther.dfo_spec_kit.currencyholdsis_currency_code, the currency shape test the identity and the frame grammar share. It reads no data file, so importingdfo_spec_kit.identitynever loads the unit registry.registries/units.jsondeclares 29 typed refs and 176 currency codes, with a byte-identical package mirror.schemas/registry/unit-registry.schema.jsoncloses each row to its kind's members andtools/validate_unit_registry.pychecks it, the sort order, uniqueness, the prefix rule and the mirror in CI; the loader refuses a row whose members do not match its kind.vectors/units/holds 40 conformance vectors validated byschemas/vectors/unit-vector.schema.jsonandtools/validate_unit_vectors.py, which CI runs.- The identity vector
unit-request-recipe-rejectedpins the identity's unit request atcurrency,pricesandbase_year: arecipemember, which a converted frame cell may carry, refuses withunknown_member. source_code_not_held,source_code_ambiguousandsource_code_shares_variablearesearch.resolverefusals on theno_data_reasonchannel inregistries/codes.jsonand its bundled mirror. A part'ssource_codewhose series no served source can answer the part with raises the first: no served source holds the code, the part'ssourcesexclude every holder, or the code's series cannot answer the part as asked. Its detail names the cause and the sources whose codes Search holds. One held by more than one source, with none named insources, raises the second, naming each. One that shares its StatVar with other codes of the same source, where the graph does not record what separates them, raises the third, naming the codes that share the variable. The retiredcode_ambiguousis unchanged.- Code
whole_total_availableinregistries/codes.jsonand its bundled mirror: asearch.resolvewarning on the raw_text, parsed and dataset_resubmit doors. It flags an answer that lists each member of a flow side whose dataset publishes the total of that side's whole population for the answer's years ("Official Donors, Total" in DAC2a and DAC2b, "All Recipients, Total" in DAC2a from 1984), so a sum of the listed members can differ from the published figure. Its params name the total (total,total_label) and the party classes it covers (whole_of:official,privateorresidual, comma-joined). - Code
allowance_exhaustedinregistries/codes.jsonand its bundled mirror: a 429 refusal ondatasets.pin,presentation.sharesandpresentation.writeonce the caller has spent its daily allowance of pins, shares or cards. Its problem document saysretryable: false, and itsRetry-Afterheader names the reset. - Endpoint
datasets.analysisin the registry schema, with its refusals inregistries/codes.jsonand its bundled mirror: 36 new codes at 422,rolling_populations_differ,several_membersand the 34 the analysis engine serves, among themunit_heterogeneous,cross_frame_unit_mismatch,join_output_collision,rolling_anchor_unresolved,role_ambiguous,compare_no_key_matchedandsum_of_no_key_matched;timeoutat 504; and 27 existing codes at the status each has ondatasets.mint,datasets.snapshotor the platform rows, among themrequest_invalid(400),snapshot_revoked(410),over_ceiling(422),upstream_error(502) andservice_unavailable(503). - Endpoint
presentation.sharesin the registry schema, with its refusals inregistries/codes.jsonand its bundled mirror:write_token_required(403) for a replace or delete without a write token;write_token_invalid(403) for one whose token is not the share's, or that names a share created without a token;share_not_replaceable(409);payload_too_large(413) for a body larger than the share routes accept; andbinding_invalid,schema_invalid,constraint_violation,resource_exhaustedandrequest_invalid(400),not_foundandframe_unavailable(404),edit_conflict(409),internal_error(500),release_mismatchandservice_unavailable(503), andtimeout(504), at the statuses the components routes give them.
- The
$idofschemas/registry/code-registry.schema.json,schemas/registry/unit-registry.schema.json,schemas/vectors/identity-vector.schema.jsonandschemas/vectors/unit-vector.schema.jsonnow sits underhttps://raw.githubusercontent.com/DevelopmentFinanceObservatory/spec-kit/main/, with each file's path unchanged. The previous prefix named a private repository and did not resolve. - On
presentation.write, codesbinding_invalid,constraint_violationandresource_exhaustedmap at 400,frame_unavailableat 404 andrelease_mismatchat 503, the statuses the Presentation write routes serve.presentation.renderkeeps 422 for the first two and 409 for the rest.frame_unavailablecovers a frame that is not held in a state Presentation can load, and its definition names each case. A frame whose stored artifact the store fails to read is alsoframe_unavailable, served at 503 and retryable; the registry holds one status for each endpoint and channel, so it records the 404 the write routes serve for every other case. - Code
edit_conflictmaps topresentation.renderat 409, for a render of a component that has no current revision, and its definition names that case. - Codes
identity_quarantined(500),service_unavailable(503) andinternal_error(500) map todatasets.descriptionat the statuses they have ondatasets.snapshot. - Code
node_not_heldmaps tograph.membersat 404, for a node the deployment's graph does not hold. - Code
upstream_errormaps tograph.membersat 502, the status the members route answers when the read that checks whether the graph holds the node fails upstream, asgraph.nodeanswers for the same read. pin_not_permittedis retired inregistries/codes.jsonand its bundled mirror: the pin route admits every caller under its allowance, so nothing raises it. Itsdatasets.pinmapping stays.starved_axis_binding_restoredis retired inregistries/codes.jsonand its bundled mirror: Search no longer restores a starved constraint axis, so nothing raises it.- Code
query_qualifier_droppedmaps to theparseddoor ofsearch.resolveas well asraw_text, since the resolver also drops a qualifier it cannot apply on parsed requests, such as a source exclusion that removed nothing. - Code
facet_binding_unsupportedmaps todatasets.mint,datasets.definitionanddatasets.optionsat 422, the status those doors send. Itssearch.resolveandsearch.optionsmappings stay at 501. - Existing codes map onto the Datasets doors that raise them:
snapshot_revoked(410) ondatasets.definitionanddatasets.options;spec_id_mismatch(422),rate_coverage_gap(422) andcapability_unavailable(501) ondatasets.options;service_unavailable(503) ondatasets.operations;rollup_not_summable(422) ondatasets.definition; andidentity_collision(500) ondatasets.definition,datasets.optionsanddatasets.members. datasets.refreshcarries the refusalsdatasets.definitionraises, at the same statuses:snapshot_revoked(410),timeout(504),upstream_error(502),upstream_version_changed(503),identity_collision(500),members_not_held(500),spec_not_exportable(409),capability_unavailable(501), and at 422collection_probe_ceiling,default_facet_undefined,definition_not_reproducible,excluded_by_registry,facet_not_available,member_not_resolvable,over_ceiling,parquet_size_bound,role_signature_incompatible,rollup_not_summable,rate_coverage_gap,recipe_not_declaredandfacet_binding_unsupported.snapshot_revoked(410) also maps todatasets.mint.- Code
identity_quarantined(500) maps todatasets.snapshot,datasets.files,datasets.pin,datasets.observationsanddatasets.refresh, the same status it has on the other Datasets doors.
- A unit facet
valuebinding may carry"national_currency": {"role": R}, the ask for the facets whose unit is eachRentity's own currency, served as published. It mints its own id, apart from the conversion request naming the same role. A value binding carries exactly one ofref,requestandnational_currency; the member on another axis, besidereforrequest, or in asetrefusesinvalid_binding_shape, an unknown role refusesschema_violation, and a member besiderole, such asprices, refusesunknown_member.docs/identity-v1.mdstates the denotation.IDENTITY_VERSIONstays"spec1", and no existing id moves, since the member refused before. - Graph endpoints
graph.nodes,graph.members,graph.roots,graph.documentationandgraph.sources, and the Datasets endpointdatasets.description, inschemas/registry/code-registry.schema.json. Existing codes map onto them at the statuses the doors send:request_invalid(400) ongraph.nodes,graph.members,graph.documentationanddatasets.description;unsupported_schema_version(422) ongraph.nodes;service_unavailable(503) ongraph.nodes,graph.members,graph.rootsandgraph.documentation;upstream_error(502) ongraph.nodesandgraph.documentation;node_not_held(404) ongraph.documentation; andsnapshot_not_found(404),snapshot_revoked(410) andspec_not_found(404) ondatasets.description.graph.sourcescarries no permanent codes. - Code
slot_default_not_appliedinregistries/codes.jsonand its bundled mirror: asearch.resolvewarning on the raw_text, parsed and dataset_resubmit doors. It flags a shape slot default, declared per measure class, that is skipped because no member holding the default value has data at the place while another member does, so the part answers on the slot's other members. - Endpoint
datasets.filesinschemas/registry/code-registry.schema.json:GET /api/datasets/{id}/{content_version}/files/{digest}, which answers a stored artifact with a 302 redirect to its download link. It carriessnapshot_not_found(404),snapshot_revoked(410),artifact_not_found(404),artifact_expired(410),service_unavailable(503) andspec_not_found(404). - Codes
source_not_resolvedandsource_ambiguousinregistries/codes.jsonand its bundled mirror: refusals onsearch.resolve, on theno_data_reasonchannel, for a source mention whose text matched no admitted source, dataset or provenance, and for one that matched two or more unrelated sources, whose detail lists the candidates. - Codes
denominator_unverified,artifact_pair_staleandcatalogue_index_driftinregistries/codes.jsonand its bundled mirror:search.resolvewarnings on the raw_text, parsed and dataset_resubmit doors.denominator_unverifiedflags a named denominator whose series declares no denominator arc, so the ratio base is read from the series name only.artifact_pair_staleflags an origin catalogue build and a series coverage build from different graph ingestions, so the answer may lack observations ingested after the older build.catalogue_index_driftflags a variable whose catalogue schema disagrees with the packaged code index on five-tuple, constraint properties, or roles; the answer uses the catalogue's reading. - Code
members_absent_from_graphinregistries/codes.jsonand its bundled mirror: asearch.resolvewarning on the dataset_resubmit door naming the elected members the knowledge graph holds no node for, which the answer leaves out. - Endpoints
datasets.refresh(POST /api/datasets/frames/refresh),datasets.recipe(PUTandGET /api/datasets/frames/{spec_id}/{content_version}/recipe, andGET /api/datasets/recipes/replays/{replay_key}) andpresentation.render(POST /api/presentation/components/{component_id}/revisions/{revision}/renderandGET .../render/data) in the registry vocabulary (schemas/registry/code-registry.schema.jsonand its README). - Codes in
registries/codes.jsonand its bundled mirror, all refusals on theproblem_detailschannel:frame_not_refreshable(422, a derived frame named todatasets.refresh),rendering_not_recorded(422, a grouped rendering whose grouping no record states, ondatasets.refresh),refresh_not_permitted(403, a caller that is not the live-refresh principal, ondatasets.refreshandpresentation.render),render_target_mismatch(409, a target frame that is not a later state of the stored revision's frame, onpresentation.render) andrecipe_not_found(404, no recipe recorded for the named frame, or no frame stored under the named replay key, ondatasets.recipe). - Mappings of existing codes onto the new endpoints, at the statuses they
already carry. Onto
datasets.refresh:snapshot_not_found(404),spec_not_found(404),request_invalid(400),service_unavailable(503) andinternal_error(500). Ontodatasets.recipe:publish_conflict(409, a recipe that differs from the one held for the pair, or a replay key another frame holds),publish_not_permitted(403),snapshot_not_found(404, a recipe write for a pair with no stored version),request_invalid(400),service_unavailable(503) andinternal_error(500). Ontopresentation.render:not_found(404),request_invalid(400),schema_invalid(400),binding_invalid(422),constraint_violation(422),resource_exhausted(409),frame_unavailable(409),release_mismatch(409),internal_error(500),service_unavailable(503) andtimeout(504). - Endpoint
datasets.members(POST /api/datasets/{id}/members) in the registry vocabulary (schemas/registry/code-registry.schema.jsonand its README).request_invalid(400),spec_not_found(404),spec_id_mismatch(422),member_not_resolvable(422),spec_not_exportable(409),role_signature_incompatible(422),definition_not_reproducible(422),facet_not_available(422),over_ceiling(422),service_unavailable(503),upstream_error(502),timeout(504),identity_quarantined(500) andinternal_error(500) map onto it inregistries/codes.jsonand its bundled mirror, on theproblem_detailschannel. - Code
open_role_unavailableinregistries/codes.jsonand its bundled mirror: a 422 refusal onsearch.resolvefor adataset_resubmitwhose identity names an open role, when the StatVars the definition elects declare no role on that axis, so the definition cannot give one series per member. - Codes
tool_not_found,frame_ref_incomplete,frame_not_held,frame_expired,rolling_reanchor_unavailable,provenance_unavailableandlicence_not_redistributableinregistries/codes.jsonand its bundled mirror, all refusals. The first five are refusals only an MCP tool result carries, on endpointmcp.toolsand channelmcp_refusal. They cover an unknown or removed tool, a frame reference that lacks its content version, a frame not held, a frame aged out, and a rolling computation with a derived input that has no stored recipe to compute again under the shared latest period.provenance_unavailable(422) andlicence_not_redistributable(403) are ondatasets.exports, the latter also ondatasets.export_link. They cover an export of a frame whose sources and licences cannot be named, and an export whose source licence forbids redistribution. - Codes
definition_not_held,derived_input_unrecoverable,entity_not_found,frame_integrity_failed,operation_still_processing,publish_not_configured,rate_limitedandtransient_unavailableinregistries/codes.jsonand its bundled mirror, all refusals onmcp.toolsandmcp_refusal. They cover an id with no registered definition, an input frame whose period labels do not state their years, a scope name that gives no entity, a stored frame that fails an integrity check, a build unfinished when the call's wait ended, a deployment with no identity to publish a frame under, a service at a limit on calls, and a service behind the one called that failed or a lost frame not yet computable. The website proxy'sproxy-codes.jsonholds the proxy surface ofrate_limitedandtransient_unavailable. mcp.toolsmappings on the 54 existing codes the MCP servers also write, so the endpoint holds every code they write: each value of the data-mcp and analysis-mcpToolErrorCodeenums and each code presentation-mcp and the harness combined server write. Platform codes presentation-mcp only forwards stay on theirpresentation.*mappings.- Endpoint
mcp.toolsand channelmcp_refusalinschemas/registry/code-registry.schema.json, its README andtools/validate_registry.py. They describe the refusal envelope of an MCP tool result (dfo-ai data-mcp, analysis-mcp, presentation-mcp). A mapping on the endpoint carries nohttp_status,mcp_refusalis a refusal-only channel, and the schema requires each of the two for the other. - Endpoints
datasets.exportsanddatasets.export_linkinschemas/registry/code-registry.schema.jsonand its README.datasets.exportsisPOST /api/datasets/exports, which prepares an export file of a stored frame. It carriesrequest_invalid(400),spec_not_found(404),snapshot_not_found(404),snapshot_revoked(410),artifact_expired(410),identity_quarantined(500),over_ceiling(422),provenance_unavailable(422),licence_not_redistributable(403),allowance_exhausted(429),service_unavailable(503),internal_error(500),capability_unavailable(501),excel_limit(422),excel_illegal_character(422),parquet_size_bound(422) androllup_not_summable(422). A prepare that names only aspec_idresolves its newest version, which can rebuild it, so the endpoint also carries the codes a rebuild raises ondatasets.definition, at the same statuses:spec_not_exportable(409),identity_collisionandmembers_not_held(500),upstream_error(502),upstream_version_changed(503),timeout(504), andcollection_probe_ceiling,column_unknown,default_facet_undefined,definition_not_reproducible,excluded_by_registry,facet_binding_unsupported,facet_not_available,invalid_role_ref,member_not_resolvable,rate_coverage_gap,recipe_not_declared,role_incompatibleandrole_signature_incompatible(422).datasets.export_linkisGET /api/datasets/exports/{export_id}, which answers a 302 redirect to the file's download link. It carriesnot_found(404),snapshot_revoked(410),licence_not_redistributable(403),identity_quarantined(500),service_unavailable(503) andinternal_error(500). - Codes
requested_option_unavailableandconflicting_requested_optionsinregistries/codes.jsonand its bundled mirror: 422 refusals onsearch.resolvefor adataset_resubmitthat postsscope_entries.requested_option_unavailablecovers an entry that names an axis the part does not offer, an option the axis does not list, or an unavailable option.conflicting_requested_optionscovers entries that cannot all apply: two options on one axis, an option that conflicts with an entry on another axis, or entries that rule out every option of an axis. - Optional top-level identity member
open_rolesindfo_spec_kit.identity: a list of flow roles, fromoriginanddestination, whose every member the request asks for, as distinct from an absent role, which asks for the total. The projection sorts and de-duplicates it and leaves it out when empty or absent, so no existingspec_idmoves. A role also bound inentities, a role outside the set, a non-array value, and a non-emptyopen_roleson astat_varshape refuse asschema_violation. An empty list is dropped. Nineopen-roles-*vectors invectors/identity/pin it, anddocs/identity-v1.mdmoves to1.2.0with its denotation. - Code
deflator_missing_omittedinregistries/codes.jsonand its bundled mirror: a warning on the Datasets mint, definition, options and snapshot manifests and onsearch.resolvediagnostics for a constant-price conversion that left out an entity's rows in the years the deflator table holds no value for it, or all its rows when the table holds no value for it in the base year, and names those entities and years. - Mappings of
observations_preview_too_large,observations_windowed_scope_unsupportedandobservations_converted_scope_unsupportedondatasets.observationsinregistries/codes.jsonand its bundled mirror, on theobservations_omission_reasonchannel. The Datasets observations body carries the sameomittedobject as asearch.resolveSpec, and the channel description inschemas/registry/code-registry.schema.jsonsays so. The windowed-scope and converted-scope codes also gain thesearch.resolvemapping on that channel, beside theirdiagnostics_warningone, and the schema README names the three warning-classified omission reasons. - Code
observations_unavailableinregistries/codes.jsonand its bundled mirror, a 404 refusal on the newdatasets.observationsendpoint (GET /api/datasets/{id}/{content_version}/observations) for a version the observations read cannot build from. Such a version has no stored frame, a converted series without its per-series conversion record, no stored default place scope, or is a collapsed version. The same endpoint carriesartifact_expired,internal_error,service_unavailable,snapshot_not_found,snapshot_revokedandspec_not_foundwith the statuses they have ondatasets.snapshot. - Code
unit_conversion_unavailableinregistries/codes.jsonand its bundled mirror: asearch.resolvediagnostics warning for an answer in a currency served while the API's conversion catalogue is not loaded, so the answer states nounit_conversionoffer although its data may convert. - Code
currency_unmapped_omittedinregistries/codes.jsonand its bundled mirror: a warning on the Datasets mint, definition, options and snapshot manifests and onsearch.resolvediagnostics for a conversion into each entity's own currency that left out the rows of entities no single currency names throughnationalCurrencyOf, and names those entities. - Code
membership_unverifiedinregistries/codes.jsonand its bundled mirror: asearch.resolvewarning on the raw_text, parsed and dataset_resubmit doors for a role-bearing answer whose members the mint's member walk did not settle, which the response cache does not store. - Code
family_total_absentinregistries/codes.jsonand its bundled mirror: asearch.resolvewarning on the raw_text, parsed and dataset_resubmit doors for an answer whose family total has no data at the place, so it shows the closest family member by rollup instead. - A facet
valuebinding on themeasurementMethodorunitaxis may carry"ref": null, the ask for facets that declare no value on that axis. It mints its own id, apart from an unbound axis. A null ref onprovenance, as a facetsetmember, or on a slot refusesschema_violation.docs/identity-v1.mdstates the denotation.IDENTITY_VERSIONstays"spec1", and no existing id moves, since a null ref refused before. - Code
slot_defaultedinregistries/codes.jsonand its bundled mirror: asearch.resolvewarning on the raw_text, parsed and dataset_resubmit doors for a query that named a slot by its plain name, such as flow, with no value, where a declared default fixed the slot to one value. - Code
skill_frontmatter_invalidinregistries/codes.jsonand its bundled mirror: askills.listwarning for a skill left out of the catalogue because its front matter is missing, unparsable, lacks a stringnameordescription, or names a different id. - Codes
withheld_by_registry,un_system_unavailable,origin_catalogue_staleandexcluded_by_registryinregistries/codes.jsonand its bundled mirror. The first is a warning for a series left empty because every facet sits under a provenance the origin registry does not admit. The second is a warning for a UN System Data Commons that did not answer for the resolve or for reads at named places; it also reaches the datasets manifest warnings. The third is a warning for an origin catalogue more than 14 days old. The fourth is adatasets.mint,datasets.definitionanddatasets.optionsrefusal (422) for a variable whose data at the requested places sits only under provenances the registry does not admit. dfo_spec_kit.registry: typed access to the platform code registry, loaded from a mirror ofregistries/codes.jsonbundled as package data. The repo-root file stays canonical;tools/validate_registry.pyfails if the two diverge.dfo_spec_kit.identity:IDENTITY_VERSIONis now part of the public API, so a consumer can import the spec1 literal instead of spelling it.EXPORTS.md: the export manifest defining this distribution's compatibility boundary, governed bypolicies/dataset-spec.toml.- A slot binding gains a fourth state,
exact:{"state": "exact", "ref": "<dcid>"}, the deliberate parent-only ask on a hierarchical code, denoting the bound code alone rather than the code plus its subtreevaluedenotes. Carryingrefson anexactbinding refusesinvalid_binding_shape; a missingrefrefusesschema_violation;exacton a facet binding refusesschema_violation, sinceexactis a slot-binding-only state.docs/identity-v1.mdis the new normative home for what each binding state denotes.
base_not_found,base_identity_mismatchandedit_incompleteare retired inregistries/codes.jsonand its bundled mirror: adataset_resubmitidentity entry carries the whole definition, so the resubmit no longer reconstructs a base frombase_spec_idor diffs an edit against it, and nothing raises them.multi_recipient_truncated,child_places_clampedandstandard_probe_places_clampedare retired inregistries/codes.jsonand its bundled mirror: Search binds every place a request names, up to one bound, and refuses a larger set withentity_set_too_large, so no list of places is truncated or clamped and nothing raises them.skill_content_absent,skill_content_too_large,skill_content_undecodableandskills_corpus_budget_exhaustedareskills.listwarnings for a skill left out of the catalogue, and no longer map ontoskills.fetch.code_ambiguousandmembers_deduplicatedare retired inregistries/codes.jsonand its bundled mirror: Datasets no longer serves collections, source-code lookups or multi-StatVar mints, so nothing raises them.code_not_foundloses itsdatasets.mintmapping and stays the platformGET /codes/{code}miss.spec_not_foundandspec_id_mismatchno longer mention collections or member lists, andcollection_probe_ceilingdescribes a request group's facet probe.- Breaking. The normative spec1 identity vectors and worked example now use
originanddestinationflow roles (withobservationAboutretained for the observed subject) rather thanproviderandrecipient. The identity core remains role-vocabulary agnostic.IDENTITY_VERSIONremains"spec1"; every affectedspec_idmust be re-minted. - Breaking. The identity core's opaque
shape_idstring becomesshape, a closed tagged union on a requiredkind. The described arm (kind: "statvar_schema") carries up to five sparse members:population_type,measured_property,stat_type,measurement_qualifier, and ameasurement_denominatorsub-union of either{"ref": "<dcid>"}or{"unresolved": true}. An arm carrying none of the five refuses. The pinned arm (kind: "stat_var") carries one required dcididand requires an empty siblingslotsarray. A document carryingshape_idrefuses as an unknown member. IDENTITY_VERSIONstays"spec1". The scheme is redefined in place, ahead of any mintedspec_identering service. Every id computed under the previous reading of spec1 must be re-minted.- Every bare dcid inside
shapeis checked against the identity core's dcid grammar: after NFC, non-empty, within the 1,024 code-point cap, free of Unicode whitespace and of Cc/Cf characters, and carrying no:. Identity carries bare dcids, so adcid:-prefixed spelling refusesschema_violation. - Breaking. The dcid grammar above now also runs on every slot ref: a
valuebinding'sref, each member of asetbinding'srefs, and anexactbinding'sref. Adcid:-prefixed slot ref, previously accepted, now refusesschema_violation, ahead of every reader rather than left to each consumer to guard. - A slot binding in the
unboundstate is retained in the projection: the wire document and the projection carry the same slot count, every shape-declared property appearing at minimum as{"state": "unbound"}. Reprojecting an already-canonical document, unbound slots included, leaves it unchanged. - Two slots sharing a property refuse
schema_violation, whatever their binding states: the sort by property is not a total order, so an unrefused duplicate would let input order pick a winner and mint different ids for two orderings of the same slot list. (duplicate_keysstays reserved for an object repeating a key; slot entries are array members.) - The top-level
dfo_spec_kitpackage no longer re-exports names from its subpackages. Each name is public from one path only: importIDENTITY_VERSIONfromdfo_spec_kit.identityandREGISTRYfromdfo_spec_kit.registry.
- Package scaffolding (uv, ruff, ty, pytest).
dfo_spec_kit.identity: the spec1 identity implementation (strict I-JSON parse, schema validation, normalisation, JCS canonicalisation, SHA-256spec_idminting), conformance-tested against the identity vector suite.
dfo_spec_kit.identity: a unit conversion request's currency code is now matched against the full string, not just its start, so a trailing newline after an otherwise valid three-letter code is rejected asinvalid_unit_requestrather than passing validation. This deliberately corrects the reference implementation this package was extracted from.