00 / 00

BOOKCASE

5 MIN READfindings

Observatory Room Stabilization

Slice 18 — The inspection layer of the Forge Triforce.

>

Between Runtime (what happened) and Ecology (why it felt that way), the Observatory reads furnace output, compares manuscripts, identifies drift, and preserves findings.


Architecture

The Observatory room is composed of two layers:

1. Library Layer — forge/src/lib/observatory-room/

Pure types and constants. No runtime logic, no side effects, no persistence, no provider coupling, no autonomous execution.

| Module | Contents | |---|---| | types.ts | 18 type definitions: ObservatoryConcept, InspectionLens, LensReading, DriftSignal, DriftSummary, ComparisonField, ComparisonResult, ManuscriptComparison, InstructionSurvival, AtmospherePreservation, CorrectionRecord, CorrectionSummary, FurnaceTrace, OperatorNote, Finding, ReentryClarity, ObservatoryRoomState | | primer.ts | 10 ObservatoryConcept entries (Inspection, Drift Detection, Manuscript Comparison, Instruction Survival, Atmosphere Preservation, Correction-Load Review, Furnace Trace Reading, Operator Notes, Findings Extraction, Re-entry Clarity) + markdown renderer | | inspection-lenses.ts | 8 InspectionLens entries (Fidelity, Coherence, Atmosphere, Drift, Correction, Trace, Comparison, Re-entry) + 2 sample lens readings + lookup helpers | | drift-signals.ts | 6 sample drift signals + drift summary + buildDriftSummary() helper | | comparison-fields.ts | 8 comparison fields (Structure, Instruction Survival, Atmosphere, Ward Integrity, Scope Boundaries, Continuity Anchors, Precision, Voice & Register) + sample comparison with 6 results | | sample-observations.ts | 4 survival samples, 2 atmosphere samples, 5 correction records, 2 furnace traces, 3 operator notes, 4 findings, 1 re-entry clarity | | index.ts | Barrel export for all types and constants |

2. Page Layer — forge/src/app/observatory/page.tsx

Full manuscript-style inspection room with 12 sections:

  1. Banner — Room identity, Triforce relationship, caveat
  2. Observatory Primer — 10 concept cards with description, significance, operator focus
  3. Inspection Lenses — 8 lens cards with reveals, obscures, expandable questions
  4. Lens Readings — 2 sample readings with observations, signals, assessment
  5. Drift Signals — Summary grid + 6 drift cards with severity, detection, correction status
  6. Manuscript Comparison — Table with 6 comparison rows (field, delta, significance, interpretation)
  7. Instruction Survival — 4 survival cards with preserved/degraded/transformed categories
  8. Atmosphere Preservation — 2 atmosphere cards with preservers/degraders
  9. Correction Load — Table with 5 correction rows (target, reason, effort, resolved)
  10. Furnace Traces — 2 trace cards with input/output artifacts, observations
  11. Operator Notes — 3 note cards with observation, interpretation, tags
  12. Findings Extraction — 4 finding cards with evidence, cross-reference status
  13. Re-entry Clarity — Clarity score, clear/unclear/aids columns, assessment

3. CSS Layer — forge/src/app/globals.css

~500 lines of observatory-specific styles following the same pattern as ecology-room styles:

  • observatory-* prefixed classes
  • Monochrome, restrained, breathable spacing
  • Desktop-first, long-session readable
  • No charts, no KPI cards, no dashboard elements
  • Severity/effort/status color classes for semantic signals

Design Decisions

1. Observatory is NOT analytics

The Observatory does not measure, score, or rank. It inspects. The distinction is critical:

  • Analytics asks "how much" and "how fast"
  • The Observatory asks "what survived" and "what shifted"

2. Sample data, not real measurements

All data in the library and page is illustrative. Real observations come from furnace trials. The samples demonstrate the kind of data the Observatory produces, not actual measurements.

3. Lenses over metrics

Instead of numerical scores, the Observatory uses inspection lenses — each framing the artifact differently. The operator chooses which lens to apply. This preserves operator judgment as the primary evaluation mechanism.

4. Drift as primary signal

Drift (meaning shift between intent and output) is the most common failure mode in semantic shaping. The Observatory treats drift detection as its primary function, with dedicated types, signals, and summary structures.

5. Manuscript comparison as core operation

Comparing two artifacts side by side reveals what changed, what survived, and what was lost. The comparison table is the Observatory's most important analytical tool.

6. Findings as stable output

Findings are what survive multiple readings and multiple furnace passes. They feed the Ecology layer and inform future trials. The confidence system (speculative → tentative → established → canonical) prevents premature certainty.

7. Re-entry clarity as closing ritual

Every inspection session ends with a re-entry clarity assessment — how clear the path forward is. This determines whether the next session builds on the last or starts from zero.


Relationship to Existing Observatory Foundation

The existing forge/src/lib/observatory/ (Slice 04) is the Dashboard-facing observatory foundation with types for dimensions, annotations, runs, drift, cost, and pantry. It is used by Dashboard components (EngineReadPanel, ObservationDriftPanel, RecentRunsPanel, RitualCostPanel).

The new forge/src/lib/observatory-room/ is the Triforce Observatory room library — conceptually distinct. It is the inspection layer between Runtime and Ecology, focused on manuscript comparison, drift detection, and operator judgment.

They are different layers serving different purposes:

  • observatory/ → Dashboard instrumentation
  • observatory-room/ → Triforce inspection room

Triforce Relationship

Runtime ──→ Observatory ──→ Ecology
  │              │               │
  │        inspects what     interprets why
  │        happened          it felt that way
  │              │               │
  records      reads          understands

The Observatory is the middle layer — it reads Runtime records and produces findings that Ecology interprets. Without the Observatory, Runtime data is raw and Ecology has nothing to work with.


What Was Avoided

  • KPI cards, colorful dashboards, charts-first layouts
  • Automated scoring theater, benchmark leaderboard aesthetics
  • Agent language, orchestration, autonomous execution
  • Provider-specific assumptions, fake precision metrics
  • Persistence infrastructure, API routes, server actions
  • SaaS surface inflation, accounts, authentication

Next After Slice 18

The Triforce is now operationally complete:

  • Runtime — what happened (Slice 09)
  • Observatory — how we inspect what happened (Slice 18)
  • Ecology — why the interaction felt coherent or incoherent (Slice 17)

The next logical direction remains Furnace Trials — running real prompts through external cognition engines and using the Observatory to inspect the results.


Written 2026-05-21. Slice 18 complete. Triforce operational.