Data contract

Field-level contract for Packrift packingsolver fixture data.

This page gives maintainers, dataset reviewers, and agents a precise map of the published fixture tables: required fields, semantic types, row schemas, CSVW metadata, Croissant metadata, validation checks, and claim boundaries. It strengthens the public dataset package without claiming solver optimality, real orders, live pricing, live inventory, freight approval, or third-party endorsement.

Contract JSON CSVW Metadata Croissant JSON-LD

passvalidation status

120candidate cartons

803order lines

350scenario file sets

Machine-readable files

Contracts and metadata

data-contract.jsonComplete contract, validation, and boundaries data-contract.csvFlat field dictionary for reviewers csvw-metadata.jsonW3C CSV on the Web table metadata fixture-croissant.jsonldMLCommons Croissant 1.1-style dataset metadata fixture_cartons.schema.jsonJSON Schema 2020-12 row contract fixture_orders.schema.jsonJSON Schema 2020-12 row contract fixture_order_summaries.schema.jsonJSON Schema 2020-12 row contract instance_index.schema.jsonJSON Schema 2020-12 row contract

Validation Checks

Status	Check
pass	CSV headers match the published data contract
pass	Required fields are populated
pass	Numeric fields parse as numbers
pass	All target cartons resolve to candidate carton SKUs
pass	All generated packingsolver file-set URLs exist locally
pass	Scenario order, summary, and instance-index keys reconcile
pass	No customer, freight, live-price, live-inventory, or optimal-solution claim is introduced

Count Boundary

These files are Packrift-owned public URL/mention corpus entries.
They are not third-party backlinks, referring-domain wins, or search-tool-visible proof.
They are intended to make Zenodo, Dataverse, Hugging Face, Figshare, OSF, Kaggle, and maintainer review cleaner once a human handles auth and license decisions.

Field dictionary

Published table fields

Table	Field	Type	Required	Description
fixture_cartons	carton_id	string	true	Stable generated carton row identifier.
fixture_cartons	sku	string	true	Packrift source SKU for the carton candidate.
fixture_cartons	title	string	true	Public product title used for review.
fixture_cartons	length_in	number	true	Parsed internal length in inches.
fixture_cartons	width_in	number	true	Parsed internal width in inches.
fixture_cartons	height_in	number	true	Parsed internal height in inches.
fixture_cartons	volume_cuin	number	true	Length x width x height in cubic inches.
fixture_cartons	family	enum	true	Source Packrift family.
fixture_cartons	quality_score	integer	true	Source quality score from the benchmark quality ledger.
fixture_cartons	source_product_url	url	true	Public Packrift product URL used as source evidence.
fixture_cartons	carton_role	enum	true	Fixture role for the row.
fixture_orders	order_id	string	true	Generated scenario identifier.
fixture_orders	scenario_family	enum	true	Generated review scenario family.
fixture_orders	scenario_note	string	true	Plain-English scenario description.
fixture_orders	target_carton_sku	string	true	Scenario anchor carton SKU, not an optimal solution claim.
fixture_orders	target_carton_title	string	true	Target carton public title.
fixture_orders	item_sku	string	true	Packrift source item SKU.
fixture_orders	item_title	string	true	Public item title used for review.
fixture_orders	item_family	enum	true	Source item family.
fixture_orders	item_length_in	number	true	Parsed item length in inches.
fixture_orders	item_width_in	number	true	Parsed item width in inches.
fixture_orders	item_height_in	number	true	Parsed item height in inches.
fixture_orders	item_count	integer	true	Generated item quantity for the scenario line.
fixture_orders	estimated_item_volume_cuin	number	true	Line-level estimated cube in cubic inches.
fixture_orders	source_product_url	url	true	Public Packrift product URL used as source evidence.
fixture_orders	source_basis	string	true	Boundary statement for source and scenario generation.
fixture_order_summaries	order_id	string	true	Generated scenario identifier.
fixture_order_summaries	scenario_family	enum	true	Generated review scenario family.
fixture_order_summaries	target_carton_sku	string	true	Scenario anchor carton SKU.
fixture_order_summaries	target_carton_volume_cuin	number	true	Target carton cube in cubic inches.
fixture_order_summaries	line_count	integer	true	Number of order lines in fixture_orders.
fixture_order_summaries	estimated_total_item_volume_cuin	number	true	Sum of generated line cube.
fixture_order_summaries	estimated_cube_utilization	number	true	Estimated item cube divided by target carton cube.
instance_index	order_id	string	true	Generated scenario identifier.
instance_index	scenario_family	enum	true	Generated review scenario family.
instance_index	scenario_note	string	true	Plain-English scenario description.
instance_index	target_carton_sku	string	true	Scenario anchor carton SKU.
instance_index	line_count	integer	true	Number of source item lines.
instance_index	estimated_total_item_volume_cuin	number	true	Total estimated item cube.
instance_index	estimated_cube_utilization	number	true	Estimated cube utilization.
instance_index	item_families	string	true	Pipe-delimited source families present in the scenario.
instance_index	source_product_url_count	integer	true	Unique Packrift product URLs used by the scenario.
instance_index	bins_csv_url	url	true	Public bins.csv URL for the generated packingsolver input.
instance_index	items_csv_url	url	true	Public items.csv URL for the generated packingsolver input.
instance_index	parameters_csv_url	url	true	Public parameters.csv URL for the generated packingsolver input.
instance_index	file_set_present	boolean-string	true	Whether all three generated input files are present.

Standards Used

The contract uses JSON Schema Draft 2020-12 for row-level object validation, W3C CSVW metadata for CSV table descriptions, and Croissant 1.1-style JSON-LD metadata for dataset discoverability and agent-readable provenance. The generated files remain conservative: no license grant, customer-order claim, solver-result claim, or external endorsement is implied.