Canonical response domains and arbitrary observation dimensions

[AlexanderFengler]

Purpose

• establish a cumulative draft sink for HSSM's canonical per-column response domains
• keep the generic capability on main, independent of JEAM and experimental dev
• freeze the compatibility and complexity boundaries before implementation begins

Closes #1265 when the complete sink is ready and merged.

Planned rolling stack

Only this sink and one child PR will be open at a time. Each child starts from the
current sink head, targets this branch, and is merged/deleted before the next begins.

1. canonical domains plus per-column validation
2. observation width plus predictive mechanics
3. dependency-free lifecycle proof, simplification, and public docs

Complexity contract

• one internal typed spec, one pure resolver, and one validation loop
• one threaded observation width and at most one private predictive helper
• zero new production abstractions in the proof/docs slice
• no model-name branches or parallel canonical/legacy state
• prefer deleting fixed-width branches over wrapping them

Each child PR will include a small complexity ledger covering production LOC, new public
symbols/helpers/branches, duplicate paths removed, and retained compatibility debt.

Current change

• add only the durable internal design contract in design/response_domains.md
• define Config.response as the ordered physical DataFrame columns and
  response_domains as annotations keyed by those exact non-RT names
• preserve response for established single-response data and require one distinct
  scalar column per coordinate for multidimensional responses
• add no semantic alias/rename layer, package code, dependencies, workflows, MkDocs
  navigation, or public support claim

Verification

• python scripts/check_docs_weight.py
• git diff --check origin/main..HEAD
• exact scope audit: one design file, zero production/workflow changes

Deferred

• JEAM and PSDM evidence or execution
• ssm-simulators metadata projection and dependency-floor changes
• real SDM/HSDM/PHSDM registration
• plotting, KDE/training, and legacy simulator generalization
• final ancestry-preserving main -> dev integration

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}