Typed contract reference

Generated by python scripts/generate_reference.py from frozen Pydantic contracts. JSON Schemas below are generated artifacts, not a second hand-maintained specification. The schema defines structure; deterministic validators and scientific review add constraints.

Contract	Purpose / fields	Source	JSON Schema
ScientificRequest	question, support, modalities, variables, track	contracts.py	schema
SourceResource	semantics, source_id, dataset, asset_id, version, uri, modality, variables, support, metadata, rights, checksum, checksum_scope, retrieved_at, provenance	contracts.py	schema
DiscoveryResult	request, candidates, warnings	contracts.py	schema
SemanticMapping	source_asset, source_variable, target, relationship, evidence, confidence, review_status, novel, disagreement	contracts.py	schema
HarmonizationRecipe	recipe_id, version, scope, track, core_recipe, mappings, operations, proposals, status, author, agent_review, execution_identity, backend_operations, backend_context_digest	contracts.py	schema
HarmonizedObservation	observation_id, variable, value, unit, biological_entity, measurement_method, longitude, latitude, spatial_support, crs, datetime_start, datetime_end, temporal_support, dataset, source, source_variable, source_version, modality, uncertainty, quality_flag, ontology_id, semantic_relationships, track, provenance	contracts.py	schema
Representation	representation_id, observation_ids, modality, vector, encoder, encoder_version, preprocessing, dimensionality, track, provenance	contracts.py	schema
ProvenanceRecord	source, source_records, recipe, qa, human, parent_observations, parent_lineage, context_sources, related_sources, related_records, executor, execution_identity	contracts.py	schema
HumanDecision	recipe_digest, status, reviewer, rationale, timestamp, fixture	contracts.py	schema
SemanticEvidence	source_field, evidence_type, evidence_location, source_label, source_definition, source_vocabulary, source_concept_id, source_concept_uri, standard_name, standard_name_scheme, unit, unit_scheme, quantity_kind, entity_hint, property_hint, matrix_hint, context_hint, taxon_identifier, taxon_scheme, method, protocol, sensor, platform, spatial_resolution, spatial_resolution_unit, spatial_support, temporal_resolution, temporal_support, source_documentation, confidence, band, scale, offset, nodata, native_crs, processing_level, processing_baseline	contracts.py	schema
ConceptCandidate	identifier, label, ontology, definition, match_basis, evidence, confidence	contracts.py	schema
SourceSemantics	schema_version, evidence, candidates, extractor, source_metadata_digest	contracts.py	schema
BackendOperation	operation_id, operation_version, backend, backend_version, parameters	contracts.py	schema
ResourceGuards	max_input_bytes, max_output_bytes, max_chunks, max_tasks, max_axis, max_time_seconds	cube_contracts.py	schema
CubeInput	resource_ids, variable_units, crs, spatial_resolution, spatial_support, temporal_resolution_seconds, temporal_support, interval_seconds, mask_definition, stage	cube_contracts.py	schema
CubeConfiguration	version, inputs, variable, window, months, allowed_quality_classes, target_temporal_support, target_temporal_resolution_seconds, target_spatial_support, evidence, scientific_justification, materialize, guards	cube_contracts.py	schema
TransformationChanges	values, units, crs, spatial_resolution, spatial_support, temporal_resolution, temporal_support, extent, biological_level, aggregation	cube_contracts.py	schema
TransformationResult	operation_id, operation_version, input_resource_ids, output_resource_id, backend, backend_version, dependency_versions, parameters, resolved_parameters, input_metadata, output_metadata, changes, lazy, materialized, status, validation_results, provenance	cube_contracts.py	schema
CubeCapabilitySpace	context_digest, base_recipe_digest, options	cube_contracts.py	schema
OperationDefinition	operation_id, legacy_name, name, version, description, input_contract, output_contract, parameter_schema, implementation_reference, scientific_assumptions, preconditions, postconditions, allowed_units, allowed_quantity_kinds, backend, backend_version, upstream_api, changes_values, changes_units, changes_spatial_resolution, changes_temporal_resolution, changes_crs, changes_extent, lazy_or_eager, changes_spatial_support, changes_temporal_support, changes_biological_level, requires_human_approval, tests, provenance	operations.py	schema
BlobReference	sha256, bytes, name, media_type	management_contracts.py	schema
ArtifactRecord	schema_version, artifact_id, kind, title, fixture, visibility, track, parents, payload, blobs, created_at	management_contracts.py	schema
ProductDefinition	track, name, state, observation_unit, scientific_scope_status	management_contracts.py	schema
ServiceDefinition	name, boundary, capability, host, endpoint, limitation	management_contracts.py	schema
AllocationPlan	provider, resource, unit, requested, status, period, evidence_uri, verified_at, limitation	management_contracts.py	schema
WorkspaceDefinition	group_id, cohort, years, quota_bytes, quota_status, dataset_ids, retention	management_contracts.py	schema
UsageMeasurement	activity, metric, value, scope, evidence_kind, provider_billing	management_contracts.py	schema
FeedbackIssue	target_id, group_id, category, summary, detail, state, permission	management_contracts.py	schema
DatasetEntry	records, dimensions, dtype, encoder_identity, context_digest, fixture, manifest, scientific_validation	management_contracts.py	schema
ReleaseEntry	dataset_id, verification_id, state, scientific_approval, persistent_identifier, limitation	management_contracts.py	schema
PreservationResult	snapshot_digest, records, blobs, bytes, verification, retention_agreement, remote_deposit	management_contracts.py	schema
ScaleProbe	generated_records, scope, write_seconds, page_query_seconds, database_bytes, limitation	management_contracts.py	schema
SelectDecision	authority, operation_id, operation_version, option_id	decision_ir.py	schema
ParameterizeDecision	authority, operation_id, operation_version, option_id, target_unit, scale_source, offset_source	decision_ir.py	schema
SemanticMappingProposal	authority, source_evidence_id, candidate_ids, relationship, evidence, confidence, status	decision_ir.py	schema
RecipeDecision	ir_version, capability_digest, status, steps, rationale	decision_ir.py	schema
CapabilitySpace	schema_version, source_digest, mapping_digest, registry_digest, options	decision_ir.py	schema
DecisionRecipeDraft	bindings, rationale, responds_to	decision_ir.py	schema
ExecutionResult	status, reasons, recipe, output_count, evidence_kind, execution_identity, proposal_digest, model_provenance, human_decision_digest	decision_ir.py	schema
ModelDecisionProvenance	model, model_version, prompt_version, timestamp, input_evidence_references, structured_output_digest, confidence, evidence_kind	decision_ir.py	schema
Evidence	evidence_id, domain, kind, source, statement, content_digest	review_contracts.py	schema
ReviewFinding	schema_version, finding_id, reviewer_domain, status, claim, evidence, source, severity, required_action, confidence, supporting_reviewers, references, supports	review_contracts.py	schema
SpecialistReview	reviewer_domain, recipe_content_digest, findings	review_contracts.py	schema
ReviewReport	schema_version, recipe_content_digest, source_digest, reviews, evidence, unique_findings, resolved_findings, unresolved_findings, required_domains, missing_domains, model_consensus, qa_decision, qa_finding_ids, human_approval, execution_authorized	review_contracts.py	schema
RunManifest	schema_version, run_id, stage, status, code_digest, input_digest, artifacts, fixture, source_data_read, notes	review_contracts.py	schema
SemanticResource	assessment_id, resource_id, name, acronym, resource_type, domain, era, first_release_or_origin, maintainer, status, canonical_uri, documentation_uri, license, coverage, key_contribution, historical_role, problem_originally_addressed, relationship_to_prior_work, current_relevance, project_role, core_candidate, domain_candidate, interoperability_only, historical_precedent, machine_access, format, resolvable_identifiers, api_available, imports_or_dependencies, known_crosswalks, overlaps, limitations, notes, evidence_source, last_verified, verification_scope	semantic_resources.py	schema
ResourceAssessment	assessment_id, resource_id, assessment, reviewer, date, evidence, confidence, notes, expert_reviewed	semantic_resources.py	schema
ConceptRecord	identifier, label, ontology, definition, domain, source_uri, relationships, fixture	semantic_resources.py	schema
NamespaceBinding	resource_id, exact, prefixes, evidence	semantic_resources.py	schema
BenchmarkConfig	schema_version, portfolio_budget, max_resources, max_datasets, score_kind	semantic_benchmark.py	schema
ReviewBundle	recipe, sources, source_digest, intended_operation, evidence, fixture	scoped_review.py	schema
QASynthesis	recommended_checks, finding_ids, decision, summary, execution_authorized	scoped_review.py	schema
StreamPlan	version, question, reader, bindings, encoder, batch_size, persist_raw_data, persist_harmonized_data, raster_layout_json, access_policy	stream_contracts.py	schema
EncoderSpec	method, encoder, version, dimensionality, preprocessing, purpose, configuration_json	stream_contracts.py	schema
ConsensusReport	status, plan_digest, recipe_content_digest, rounds, votes, unresolved, human_review_required, data_read_during_planning	stream_contracts.py	schema
MOSAIKSSpec	algorithm, input_dtype, channels, units, features, kernel_size, seed, bias, input_scale, zca_bias, calibration_tiles, filters_per_tile, max_tile_side, filter_batch	mosaiks.py	schema
RasterContext	plan, recipe, human, consensus, evidence_review, cube_configuration	harmonized_rasters.py	schema
RasterLayout	side, grid, split_policy	mosaiks_pipeline.py	schema

ReviewReport eligibility is separate from HumanDecision. RunManifest is an available stage contract; existing historical runs keep their original artifact formats. The new scoped-review runner writes a RunManifest plus exact role outputs and traces. Streaming plans forbid raw/harmonized persistence. See review boundaries and MOSAIKS input contracts.