[v0.91.8][WP-15][unity][demo] Polish flagship Polis Observatory visual and runtime presentation

[danielbaustin]

Summary

Turn the currently functional but visually rough Unity Observatory stage into a
coherent flagship Polis control environment that can be demonstrated live to
investors and inhabitants.

Goal

Deliver an investor-ready Unity Observatory experience with strong spatial
composition, controlled lighting, readable operator surfaces, and truthful live
CSM/Polis runtime presentation.

Required Outcome

The intended FastWork Unity project opens and plays as one polished Observatory
scene whose camera, environment, lighting, UI, runtime state, and operator
interactions work together. The result must consume live runtime truth when it
is available, fail closed when it is not, and retain direct Unity proof at both
1920x1080 and 2560x1440.

Deliverables

• A composed Observatory environment with a deliberate hero camera, coherent
  circulation, terrain continuity, and no exposed staging voids.
• A restrained cinematic lighting and post-processing pass that preserves
  material detail and avoids blown cyan highlights, crushed blacks, and
  illegible emissive surfaces.
• Readable in-world and screen-space Observatory UI with clear iconography,
  hierarchy, connection state, runtime health, agent activity, events,
  governance/evidence state, and operator communication.
• Real CSM/Polis runtime binding through the repository-owned runtime contract,
  with explicit connected, degraded, disconnected, and demo-data states.
• Focused interaction for inspecting agents, runtime state, event activity, and
  operator communication without blocking the scene view.
• Retained editor/MCP identity proof, Play Mode proof, and visual evidence at
  1920x1080 and 2560x1440 from the intended project and scene.

Acceptance Criteria

• The hero view has a clear focal Observatory structure, readable foreground,
  middle ground, and background, and a composed route into the environment.
• Camera framing does not clip major architecture or expose accidental voids,
  floating terrain edges, disconnected ramps, or unfinished staging geometry.
• Lighting preserves readable materials and depth; emissive cyan is an accent,
  not the dominant exposure, and dark regions retain intentional detail.
• UI text and icons remain crisp, aligned, non-overlapping, and legible at
  1920x1080 and 2560x1440 without page-level scrolling.
• The runtime surface identifies whether data is live, degraded, disconnected,
  or demonstrative and never presents fixture data as live Polis truth.
• Live mode consumes repository-owned CSM/runtime contracts for agent, event,
  health, governance/evidence, and communication state where those contracts
  exist; unsupported fields remain explicit non-claims.
• Operator controls can select an agent or subsystem, inspect current state,
  observe event flow, and send a bounded communication through the supported
  runtime contract or fail closed with an exact reason.
• One direct Unity proof shows the intended project, loaded flagship scene, Play
  Mode result, and retained 1920x1080 and 2560x1440 captures.
• Focused validation passes without building player binaries or replacement
  owner binaries.
• Every Unity-MCP, editor, runtime, asset, or proof-tool anomaly discovered
  during execution is retained in this issue or routed to a named follow-up.

Repo Inputs

• Parent WP-15 demo convergence issue [v0.91.8][WP-15] Converge integrated ADL Runtime and C-SDLC demos #5354.
• Closed Unity tooling and proof issues [v0.91.8][WP-15][unity][tooling] Align Unity-MCP live project and port proof for deployed observatory #4739, [v0.91.8][WP-15][unity][tooling] Make Unity editor liveness and batch proof reliable for deployed observatory #4741, and [v0.91.8][WP-15][unity][tooling] Classify and fix Unity ILPP GetDomainName loop in observatory batch proof #5332.
• Current Unity project:
  /Volumes/FastWork/adl-unity-observatory/operator-provisioned-5332/unity-observatory.
• Current flagship scene: Assets/Scenes/FlagshipObservatoryStage.unity.
• Repository Unity-MCP CLI and the [v0.91.8][WP-15][unity][tooling] Align Unity-MCP live project and port proof for deployed observatory #4739 alignment probe.
• Runtime v3 and CSM Observatory contracts already integrated on current
  origin/main.
• The operator-provided current-stage screenshot and Observatory dashboard
  visual direction.

Dependencies

• [v0.91.8][WP-15][unity][tooling] Align Unity-MCP live project and port proof for deployed observatory #4739, [v0.91.8][WP-15][unity][tooling] Make Unity editor liveness and batch proof reliable for deployed observatory #4741, and [v0.91.8][WP-15][unity][tooling] Classify and fix Unity ILPP GetDomainName loop in observatory batch proof #5332 must remain merged and typed closed_out.
• The intended Unity editor and local MCP endpoint must pass the [v0.91.8][WP-15][unity][tooling] Align Unity-MCP live project and port proof for deployed observatory #4739
  alignment proof before scene claims are accepted.
• Unity child execution is independent of WP-14A [v0.91.8][WP-14A] Integrated platform acceptance and deployment #5384; [v0.91.8][WP-15] Converge integrated ADL Runtime and C-SDLC demos #5354 convergence
  consumes this final proof or exact blocker truth later.

Demo Expectations

• The first Play Mode view should already read as the Observatory, not as an
  editor staging pile.
• The scene should make the Polis visible as a living governed system through
  spatial activity, agent/runtime state, event flow, evidence, and operator
  communication.
• Visual quality should support a live investor walkthrough, while every
  runtime and readiness claim remains directly evidenced.

Non-goals

• Do not build standalone player binaries.
• Do not build replacement ADL, C-SDLC, Unity-MCP, or other owner binaries.
• Do not republish licensed asset packs or silently move multi-gigabyte asset
  payloads into Git.
• Do not absorb WP-14A platform acceptance, unrelated release-tail work, or
  v0.92 birthday claims.
• Do not claim production cloud integration, complete investor readiness, or
  runtime semantics that are not shown in direct proof.

Issue-Graph Notes

• Parent: [v0.91.8][WP-15] Converge integrated ADL Runtime and C-SDLC demos #5354.
• Consumes: [v0.91.8][WP-15][unity][tooling] Align Unity-MCP live project and port proof for deployed observatory #4739, [v0.91.8][WP-15][unity][tooling] Make Unity editor liveness and batch proof reliable for deployed observatory #4741, [v0.91.8][WP-15][unity][tooling] Classify and fix Unity ILPP GetDomainName loop in observatory batch proof #5332.
• Produces the visual/runtime Observatory proof consumed by WP-15 convergence.
• Runtime or infrastructure defects discovered here must be routed to their
  actual owner without stalling bounded visual work that can continue safely.

Tooling Notes

• Use typed C-SDLC v2 lifecycle routing for every lifecycle step.
• Work only in the issue-bound FastWork worktree and the intended Unity project.
• Create an issue-bound goal before implementation starts.
• Use Unity-MCP/editor tools for scene edits and direct proof.
• Use repository-installed binaries only and permission-safe process checks.
• Do not use raw gh, broad process scans, cloud fallback, or secret-bearing
  output.

[danielbaustin]

Tooling observations from the live Unity #5662 proof lane:

1. Unity-MCP CLI process discovery reported zero Unity processes while the approved editor PID, project-local Editor log, MCP identity response, exact project path, and active scene all agreed. The alignment wrapper passed only after the approved PID corroboration path. This is the same fail-closed discovery class tracked by [v0.91.8][WP-15][unity][tooling] Align Unity-MCP live project and port proof for deployed observatory #4739.
2. Copying a repository-owned C# source file into the operator-provisioned project did not reliably activate the new compiled assembly until an explicit AssetDatabase.Refresh(ImportAssetOptions.ForceSynchronousImport) and compile wait. Visual iteration can otherwise appear to accept source changes while Play Mode still executes the prior assembly.
3. Changing the Game View resolution after entering Play Mode left the runtime UI document laid out at the previous Free Aspect dimensions. Selecting the fixed Game View resolution before a Play Mode restart produced the correct full-frame layout at both 1920x1080 and 2560x1440.
4. The Unity-MCP CLI screenshot-camera command emits the full base64 image payload to its normal terminal output. A 1280x720 capture produced an impractically large response, so the proof lane used the local MCP HTTP response and retained-file extraction instead.

No standalone player or binary build was performed.

[danielbaustin]

Issue #5662 tooling anomaly follow-up (2026-07-24):

1. The operator-provisioned Unity project had the built-in com.unity.modules.unitywebrequest module disabled. The compiler identified the missing module; package-add through the live Unity-MCP endpoint installed com.unity.modules.unitywebrequest@1.0.0, completed domain reload, and restored compilation. The tracked project manifest now declares the module.

2. An attempted standard managed HTTP fallback remained in CONNECTING during Play Mode and did not yield usable runtime truth. The fallback was removed rather than retained. The final implementation uses Unity Web Request and deterministic aggregate classification.

3. After the Unity window was moved to another macOS desktop, Play Mode remained at frame 1 even though editor state reported playing and unpaused. This made the runtime coroutine appear hung. Setting Application.runInBackground = true resumed frame advancement and allowed the five-endpoint probe to reach DISCONNECTED against the unbound loopback endpoint. The tracked bootstrap now sets that property before creating the shell.

Focused proof:

• fresh off-screen Play Mode: runInBackground=True, frame counter advancing
• unbound loopback result: DISCONNECTED|NO RUNTIME|DISCONNECTED|0/5 CSM endpoints
• aggregate classifier: Live|Degraded|Disconnected
• final Console errors after clean launch: 0

No standalone Unity binary was built.