QUERY_SPEC.md v0.1 + v0.2 amendments (informed by PQG conformance matrix)

[rdhyee]

Summary

This PR (a) introduces query-spec.qmd as the v0.1 baseline (written in a previous session but never committed) and (b) applies v0.2 amendments informed by the newly-landed PQG conformance matrix — the audit of which shipped parquet files actually carry which QUERY_SPEC dimensions.

The two changes are split across two commits for reviewer sanity:

1. Add QUERY_SPEC.md v0.1 (draft) — the baseline (context).
2. Apply QUERY_SPEC v0.2 amendments from PQG conformance matrix — the substantive changes.

Reviewers should focus on commit 2; commit 1 is context.

v0.2 amendments (9)

All amendments trace to conformance_matrix.md §5:

#	Amendment	Source row
1	Rename specimen → objectType (§2.2). Every shipped parquet uses object_type / hasSampleObjectType; adopt data-side name, keep hasSpecimenCategory as Solr alias.	§5.1, §4 naming-drift observation, §3.2
2	Drop ghosts informalClassification (§2.2) and resultTimeRange (§2.3) — Solr-era remnants, never in any shipped parquet. Also drop time_range OVERLAPS from §3.1 grammar and §5.3 Solr binding.	§5.2, §4 "ghosts in the spec", §3.2, §3.3
3	Add thumbnailURL to §2.1 (optional). Ships in wide for OpenContext today; moving to per-source sidecars (issue #131).	§5.3, §4 "ghosts in the data"
4	Update §5.1 time BETWEEN binding from "TBD" to TRY_CAST(result_time AS TIMESTAMP) BETWEEN t1 AND t2. result_time IS in lite (as VARCHAR).	§5.4, §3.3
5	Document H3 column availability in §2.4: wide_h3 has direct h3_res4/6/8 columns; h3_summary_res{4,6,8} tier files ship h3_cell + resolution (NOT h3_res{N} columns); lite has h3_res8 only; plain wide / narrow carry no H3 columns.	§5.6, §3.4
6	Pick tmodified (INTEGER epoch) over last_modified_time (VARCHAR) for sourceUpdatedTime in §2.1; alias VARCHAR as deprecated.	§5.5, §3.1 note
7	Bump draft callout version 0.1 → 0.2.	§5 preamble
8	§7 open questions: close Q2 (time filter in lite — resolved); reframe Q1 around new objectType naming.	§5.1, §5.4
9	Appendix B: add references to conformance_matrix.md and SERIALIZATIONS.md (#143).	(new)

Links

• PQG conformance matrix PR: docs: PQG conformance matrix (v0.1) pqg#22
• Board item tracking this work: isamplesorg.github.io#138

Test plan

• quarto render query-spec.qmd renders cleanly (tables, callouts, cross-refs)
• Verify v0.2 callout text and cross-references to conformance_matrix.md resolve
• Spot-check §2.2 naming note, §2.4 H3 availability callout, §5.1 time binding row
• Confirm §7 "Questions resolved in v0.2" block renders correctly

🤖 Generated with Claude Code