Portable Observatory¶

Display ≠ probe. Plate color ≠ outcome code. Deeper refinement ≠ greater truth. Complete frame ≠ successful geometry resolution. Viewport ≠ Observation Plate. Display Mode ≠ Instrument. Fixture PASS ≠ live free-roam qualification.

The Portable Observatory is the public documentation lane for reading sealed transport observations in xPRIMEray—across Godot and (where adapters exist) Project Glowing Heart—without collapsing measurement into pretty pictures.

First-run spine¶

Work in this order:

Choose a Scene — experiment context (Hermetic chamber, portal gallery, …).
Enable the Transport Lens — live or snapshot transport path that computes samples.
Choose a Display Mode — how channels or host shading are mapped to color.
Read the Observation Plate — the instrument face (mapped samples), not the full 3D world view.
Open the Inspector — context, validity, counts, dependencies.
Use the Region Probe only on qualified observations — SNAPSHOT Complete, outcome plane ready; never select from RGB alone.
Open Evidence for recipe-bound conclusions — fixtures and archived runs, not free-roam verdicts.

Scene
  → Transport Lens
    → Display Mode
      → Observation Plate
        → Inspector
          → Region Probe
            → Evidence

Ownership table¶

Layer	Owns
Scene	Experiment context (geometry, portals, shells, intended claim class).
Transport Lens	Computes transport samples under the current field/policy (`GrinFilmCamera` path).
Instruments	Define measured quantities (semantic outcomes, planned geometry/field/transport records).
Observation channels	Carry sealed measurements (`cathedral.probe.outcome`, …).
Display Modes	Color those channels or host shading for human viewing.
Observation Plate	Presents the mapping (FilmView / plate buffer).
Inspector	Explains context, validity, counts, and dependencies.
Evidence Console	Handles qualified recipes and archived results.

Implementation status (truth)¶

Sealed channels — implemented¶

Channel ID	Role
`cathedral.probe.outcome`	Per-sample `ProbeOutcomeCode`
`cathedral.probe.region_label`	Connected components on the semantic plane
`cathedral.probe.refinement_level`	Region-refinement history level

Display paths — available as presentation, not sealed raw channels¶

Display Mode	Role
RGB / host beauty path	Presentation color (not outcome authority)
NormalRGB	\(n \mapsto n\cdot0.5+0.5\) mapping
Depth	Distance / depth heatmap mapping
NdotV / TwoSidedNdotV	Facing brightness mapping

Planned channels — not yet sealed (do not speak in present tense as shipped)¶

geometry.normal, geometry.depth, geometry.ndotv
transport.final_step_count, transport.path_length, transport.boundary_crossing_count
field.magnitude, field.gradient_magnitude

Intended future mapping chain (planned):

geometry.normal  → normal_rgb.v1 mapping  → Observation Plate
geometry.depth   → depth_heatmap.v1 mapping → Observation Plate

Until those channels ship, NormalRGB/Depth remain host display paths, not portable sealed geometry instruments.

Where to go next¶

Need	Page
First doctrine	Display Is Not Probe
Glossary	Public Vocabulary
Frame anatomy	Anatomy of an Observation Frame
Outcome codes	Reading the Outcome Plane
Magenta hazard	The Great Magenta Confusion
Contact ≠ resolution	Collider Contact Is Not Semantic Resolution
Closed-box calibration	Hermetic Normal Calibration
Region effort	Tuning the Region Probe
Diagnostics levels	Diagnostics
Claim hygiene	Claim Boundaries

Historical lanes (preserved)¶

Older material keeps its own language; bridge when terms differ:

Core doctrine (compact)¶

Confuse…	With…	Correction
Observation Plate color	Outcome class	Only sealed outcome / codes
Viewport beauty	Measurement	Display path only
Display Mode	Instrument	Mapping ≠ measured channel
Region Refinement depth	Truth	More Transport Effort, not greater physics truth
Complete snapshot	Geometry solved	Completeness is lifecycle, not HitGeometry success
Fixture PASS	Live free-roam OK	Recipe-bound evidence only

Simulated transport. Numerical policy. Scene units. Policy-relative closure.