Eve library

Remote Creative Control Plane Implementation Tracker

Guide

Revision 1

On this page

Last updated: 2026-07-04

This tracker is the operational source for Phase 180 execution evidence. The canonical checklist remains TODOS/phase-180.md; this file records ownership, status, changed files, verification, hardware evidence, and blockers for every 180.C item.

Ground Rules#

  1. Do not skip stages. Downstream stages may start only when the prior stage is checked off in TODOS/phase-180.md or explicitly marked blocked in this tracker with a concrete reason, owner, and unblock path.
  2. Definition of checked. An item can be marked checked only after the code/docs for that item are merged, all relevant verification passes, and the item itself is updated from [ ] to [x] in TODOS/phase-180.md.
  3. Hardware blockers. macOS, Blender, Unreal, and WebRTC tasks must include manual or hardware evidence before being checked whenever CI cannot verify the behavior directly.
  4. No hidden privileged path. Arbitrary shell execution, arbitrary Blender Python, Unreal console commands, desktop control, and real browser profile access must not be implemented before policy, approval, and audit primitives are complete.
  5. Deep integration first. Blender, Unreal, and browser tasks must use typed adapters before desktop fallback is allowed.
  6. Localhost adapters. Blender, Unreal, and browser debug/control ports must remain localhost-only and must never be exposed directly to LAN or internet.
  7. Single source of truth. Command schemas live in libs/bellona/remote-protocol and are imported by gateway, host, MCP, adapters, tests, and docs.

Update Procedure#

For each item, update the matching progress-table row with the owner, status, changed files, exact verification command, hardware evidence or a documented "not applicable" note, and any follow-up blockers. Keep future rows as Not started until their stage is eligible under the do-not-skip rule. When an item is complete, update its checkbox in TODOS/phase-180.md, run the relevant verification commands, then commit and push the tracker and checklist changes with the implementation work.

2026-07-03 Stage 37 Audit Note#

Stage 180.C.37 now has a deterministic local roll-up gate in apps/bellona/remote-host/src/linux-host-support.ts, exported as evaluateLinuxHostStageGate. The gate requires concrete item-scoped Linux evidence for 180.C.37.01 through 180.C.37.09, separate Linux build-node validation, and final 180.C.37.10 first-class-node acceptance from a concrete operator:linux-acceptance: identity. It rejects placeholder runner/operator/ artifact suffixes, stale or non-canonical UTC timestamps, duplicate evidence artifacts, wrong Linux runner classes, package-signing evidence that predates package-distribution evidence, fleet evidence that predates the capability records it summarizes, and final acceptance that is not newer than every prerequisite.

The same change adds first-class Linux build-node candidate and command-gating helpers beside the existing Linux render-node APIs in apps/bellona/remote-host/src/linux-render-node-role.ts. Focused verification: pnpm nx test @bellona/remote-host -- linux-host-support.test.ts linux-render-node-role.test.ts --reporter=verbose passed with 2 files / 28 tests.

2026-07-03 Final GA Platform Gate Hardening#

The final GA evaluator in testing/bellona/remote-control/final-ga-release-gate.ts now requires conditional Windows/Linux completion to pass both layers of evidence: the final-GA conditional-platform record and the matching remote-host roll-up gate (evaluateWindowsHostStageGate for 180.C.36, evaluateLinuxHostStageGate for 180.C.37). This prevents a generic platform bundle from satisfying GA when the Windows parity gate, Linux build-node prerequisite, or any other Stage 36/37 stage-gate evidence is missing or incomplete. Accepted macOS-only scope waivers still satisfy out-of-scope conditional platforms.

Focused verification: pnpm exec vitest run --config vitest.config.ts tests/final-ga-release-gate.test.ts --reporter=verbose passed from testing/bellona/remote-control with 1 file / 36 tests.

Initial Verification Command List#

Run the relevant subset for each item, expanding as packages are introduced:

  • Markdown format check: pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md
  • Affected lint: pnpm lint:affected
  • Affected typecheck: pnpm typecheck:affected
  • Affected tests: pnpm test:affected
  • Protocol tests, once libs/bellona/remote-protocol exists: pnpm nx test bellona-remote-protocol
  • Gateway tests, once apps/bellona/remote-gateway exists: pnpm nx test @bellona/remote-gateway
  • Host tests, once apps/bellona/remote-host exists: pnpm nx test bellona-remote-host
  • Adapter tests, once libs/bellona/remote-adapters exists: pnpm nx test bellona-remote-adapters
  • Control Room Playwright tests, once apps/bellona/control-room exists: pnpm nx e2e bellona-control-room-e2e

Stage 180.C.02 Audit Notes#

180.C.02.01 libs/bellona/bridge-core#

Audit date: 2026-04-21

Files reviewed:

  • libs/bellona/bridge-core/src/index.ts
  • libs/bellona/bridge-core/src/index.test.ts
  • libs/bellona/bridge-core/project.json
  • libs/bellona/bridge-core/package.json
  • Existing consumers in apps/bellona/bridge-blender, apps/bellona/bridge-unreal, apps/bellona/bridge-godot, and apps/bellona/bridge-unity

Reusable behavior:

  • Protocol envelope: BridgeMessage, BridgeRequest, BridgeResponse, and BridgeEvent already provide typed TypeScript envelopes with message IDs, command type strings, timestamps, payloads, replyTo, success, and error fields. These are useful implementation precedents, but Phase 180 schemas must move the canonical contract into libs/bellona/remote-protocol.
  • Connection model: ConnectionInfo tracks connection ID, state, connected time, last activity, metadata, client type, and client version. The handshake command mutates this metadata and emits a typed handshake event.
  • Server lifecycle: BridgeServer supports standalone WebSocket startup, attachment to an existing HTTP server, max-connection rejection, graceful shutdown, connection/disconnection/message/command/response/error events, and connection inspection.
  • Request/response: both server and client maintain pending request maps keyed by message ID, enforce request timeouts, clear timers on response, resolve successful responses, reject failed responses, and reject pending work on shutdown or disconnect.
  • Heartbeat: server-side heartbeat uses periodic ping, updates activity on pong, and disconnects connections whose lastActivityAt exceeds connectionTimeout. The exported pingCommand is available as an application-level keepalive command.
  • Reconnection: BridgeClient has opt-out reconnect behavior with reconnectInterval, maxReconnectAttempts, and linear backoff capped at five intervals. It rejects pending requests on explicit disconnect.
  • Validation hook: CommandDefinition.validate allows per-command runtime payload guards before invoking handlers. Existing engine bridges register commands through registerCommand and registerCommands.

Remote-control reuse decision:

  • Reuse the lifecycle, event naming, pending-request, timeout, heartbeat, and reconnect patterns as implementation guidance for gateway-host transport.
  • Do not expose bridge-core envelopes as the Phase 180 source of truth; use remote-protocol schemas for device, session, command, audit, approval, stream, and adapter contracts, then adapt to bridge-core only where legacy engine bridges are reused.
  • Keep localhost binding as the default. Existing engine bridges already default their host to localhost, which matches the Phase 180 localhost adapter rule.

Gaps and risks to address before privileged remote use:

  • No authentication, pairing, authorization, approval, or audit primitives.
  • No JSON Schema/OpenAPI/Proto generation and no runtime envelope validation beyond optional command-specific guards.
  • No idempotency keys, command priority, cancellation, progress events, resumable streams, audit hashes, or policy result metadata.
  • Request IDs use timestamp plus random strings rather than a protocol-level ID policy.
  • Reconnect behavior is client-side only and does not preserve session identity, resume commands, or replay missed events.
  • Tests currently cover handshake metadata only; heartbeat, timeout, request/response, reconnect, validation failure, and disconnect cleanup need dedicated remote-control tests in later stages.

180.C.02.02 Blender Bridge and Library#

Audit date: 2026-04-21

Files reviewed:

  • apps/bellona/bridge-blender/src/main.ts
  • apps/bellona/bridge-blender/src/phase-8-completion.test.ts
  • apps/bellona/bridge-blender/project.json
  • libs/bellona/blender/src/bridge/index.ts
  • libs/bellona/blender/src/scene/index.ts
  • libs/bellona/blender/src/assets/index.ts
  • libs/bellona/blender/src/animation/index.ts
  • libs/bellona/blender/src/rendering/index.ts
  • libs/bellona/blender/src/types.ts
  • libs/bellona/blender/python/bellona_addon/handlers.py
  • libs/bellona/blender/python/bellona_addon/server.py

Current command surfaces:

  • apps/bellona/bridge-blender registers six bridge-core commands: blender:get-scene-info, blender:create-object, blender:import-asset, blender:export-asset, blender:set-frame, and blender:render.
  • Those six commands are forwarding shims. They call BridgeServer.request() against a connected engine client and do not execute Blender operations in the Node bridge process.
  • No in-repo Blender engine client was found that implements the six blender:* bridge-core command names. The only references outside apps/bellona/bridge-blender are documentation/spec entries.
  • libs/bellona/blender exposes a much larger TypeScript client/manager API over a separate addon protocol. Its client sends dot-command names such as scene.list, object.create_primitive, file.import, and render.render to the Python addon on localhost port 9876.
  • The Python addon currently registers 42 dot-command handlers. These are the only Blender operations that appear executable from the bundled addon without arbitrary Python.

Real addon-backed handlers:

  • Scene: scene.list, scene.get, scene.create, scene.delete, scene.set_active.
  • Object: object.list, object.get, object.create_primitive, object.delete, object.select, object.deselect_all, object.set_transform, object.duplicate.
  • Material: material.list, material.get, material.create, material.delete, material.assign.
  • Animation: animation.set_frame, animation.get_frame, animation.insert_keyframe, animation.delete_keyframe, animation.play, animation.stop.
  • Render: render.render, render.render_animation, render.set_engine, render.set_settings.
  • Collection: collection.list, collection.create, collection.delete, collection.link_object, collection.unlink_object.
  • File: file.save, file.save_as, file.open, file.import, file.export.
  • Modifier/state: modifier.add, modifier.remove, modifier.apply, get_state.

Stubbed, mismatched, or incomplete behavior:

  • The bridge app's six blender:* commands are not proven end to end because they require an external engine client that was not found in the repo.
  • The bridge app command schemas are local TypeScript interfaces only; they do not import shared schemas, validators, policy metadata, approval metadata, or audit contracts.
  • blender:create-object accepts broad object types, but the bundled addon has a real handler only for object.create_primitive; camera, light, empty, armature, curve, text, and generic object creation are not covered by the registered addon handlers.
  • blender:set-frame maps conceptually to animation.set_frame, but no adapter maps between the bridge-core command name and the addon command name.
  • blender:import-asset and blender:export-asset map conceptually to file.import and file.export, but the payload names differ (filepath/selectedOnly vs. path/selection), and no adapter normalizes them today.
  • The TypeScript managers expose 278 distinct client.send() command names, while the addon registers 42 handlers. The missing set includes most advanced action, driver, geometry nodes, image, shader node, material-parameter, render-device, viewport, collection-query, object-parenting, and world/HDRI operations.

Unsafe for remote operation until Phase 180 policy, approval, and audit exist:

  • execute_python and execute_python_file in the addon server execute arbitrary Python and arbitrary local files.
  • file.open, file.save, file.save_as, file.import, and file.export access local paths without project-root grants or path policy.
  • object.delete, scene.delete, collection.delete, material.delete, modifier.apply, render execution, animation playback, and file overwrite commands mutate state without undo checkpoints, approvals, or evidence capture.
  • Import/export handlers invoke Blender operators directly and rely on file extension/format checks only; they do not verify file hashes, source grants, output destinations, or artifact registration.

Remote-control reuse decision:

  • Use the Python addon's real dot-command handlers as the first implementation target for the Phase 180 Blender read-only and safe-mutation MVPs.
  • Treat the existing apps/bellona/bridge-blender six-command surface as a legacy forwarding facade until an adapter maps Phase 180 blender.scene.info and blender.object.create_primitive schemas onto the addon protocol.
  • Do not enable arbitrary Python, file open/save, destructive deletes, render jobs, or import/export through the remote host until remote-protocol schemas, path grants, policy, approval, audit, and evidence capture are complete.

180.C.02.03 Blender Addon Startup and Threading#

Audit date: 2026-04-21

Files reviewed:

  • libs/bellona/blender/python/bellona_addon/__init__.py
  • libs/bellona/blender/python/bellona_addon/server.py
  • libs/bellona/blender/python/bellona_addon/handlers.py
  • libs/bellona/blender/python/bellona_addon/events.py

Startup behavior:

  • register() registers Blender preferences, operators, panels, command handlers, and event handlers.
  • The server does not auto-start by default because auto_start defaults to False.
  • If auto-start is enabled, startup is delayed through bpy.app.timers.register and only proceeds when onboarding is complete or safe mode is disabled.
  • Operators provide manual start, stop, connection test, session refresh, reconnect, diagnostics, recovery, and support-bundle workflows.
  • The configured endpoint defaults to localhost:9876, matching the Phase 180 localhost adapter rule.

Threading and lifecycle:

  • server.start() creates a daemon threading.Thread that owns a new asyncio event loop and runs a websockets.serve() WebSocket server.
  • server.stop() flips _running, schedules async shutdown on the server loop, closes client sockets, waits for wait_closed(), and joins the thread with a five-second timeout.
  • server.broadcast_event() uses asyncio.run_coroutine_threadsafe() to send subscribed events from Blender handlers/timers back onto the WebSocket loop.
  • Command execution is marshalled back onto Blender's main thread with bpy.app.timers.register(..., first_interval=0.0) and an asyncio polling loop that waits for a threading.Event.
  • Event registration hooks into depsgraph, frame-change, render, load/save, undo/redo handlers, plus a persistent timer polling selection every 100 ms.

Handler registration and dependencies:

  • handlers.register() registers 42 command handlers on the global server instance.
  • The addon requires Blender's bpy runtime and the optional Python websockets package. If websockets is unavailable, startup returns False and diagnostics report the missing dependency.
  • The connection probe uses the same WebSocket endpoint and sends handshake and ping messages, optionally adding an Authorization header when an auth token is configured.
  • The server records recent message snippets for diagnostics with configurable history length and support-bundle export helpers.

Main-thread and remote-control risks:

  • There is no timeout around the main-thread threading.Event wait; a handler that never completes can leave the coroutine waiting indefinitely.
  • Long operations such as render, import/export, file open, and modifier apply execute on Blender's main thread and can block UI responsiveness.
  • The auth token preference and probe header exist, but the server handshake and command path do not validate Authorization headers today.
  • Handlers accept raw dict payloads without schema validation, policy checks, approvals, undo checkpoints, or audit emission.
  • execute_python and execute_python_file bypass handler registration and run arbitrary code on the Blender main thread.
  • The event system can generate high-volume depsgraph and selection events; the remote gateway will need backpressure, filtering, and audit-safe redaction before live streaming those events.

Remote-control reuse decision:

  • Reuse the delayed auto-start pattern, localhost default, explicit diagnostics, and main-thread marshalling approach.
  • Add Phase 180 wrappers before remote use: command timeout/cancellation, schema validation, policy/approval/audit hooks, project-root path grants, undo/evidence capture for mutations, and an authenticated localhost-only adapter connection.

180.C.02.04 Unreal Bridge and Library#

Audit date: 2026-04-21

Files reviewed:

  • apps/bellona/bridge-unreal/src/main.ts
  • apps/bellona/bridge-unreal/src/phase-8-completion.test.ts
  • apps/bellona/bridge-unreal/project.json
  • libs/bellona/unreal/src/bridge/unreal-bridge.ts
  • libs/bellona/unreal/src/bridge/unreal-launcher.ts
  • libs/bellona/unreal/src/bridge/version-discovery.ts
  • libs/bellona/unreal/src/types.ts
  • libs/bellona/unreal/src/phase-8-completion.test.ts

Current command surfaces:

  • apps/bellona/bridge-unreal registers 11 bridge-core forwarding commands: unreal:get-world-info, unreal:spawn-actor, unreal:destroy-actor, unreal:set-actor-property, unreal:call-blueprint-function, unreal:load-level, unreal:unload-level, unreal:set-material-parameter, unreal:sequencer-control, unreal:execute-console-command, and unreal:take-screenshot.
  • Those app bridge commands are forwarding shims. They require a connected engine client that identifies as unreal-plugin or unreal during the bridge-core handshake.
  • No in-repo .uplugin, Unreal C++ module, Unreal Python bridge, or TypeScript engine client was found that implements the 11 unreal:* command names.
  • libs/bellona/unreal exposes a separate Remote Control-style client on localhost port 30010 by default. Its high-level API issues 132 dot-command names, including actor, blueprint, asset, level, editor, PIE, build/cook, console, material, sequencer, plugin, debug, world-partition, live-coding, Niagara, texture, mesh, audio, project-settings, MetaHuman, and Live Link operations.

Unreal-side plugin gaps:

  • There is no checked-in Unreal Editor plugin, Remote Control preset, endpoint manifest, command dispatcher, or command schema that proves any apps/bellona/bridge-unreal command reaches Unreal.
  • The library assumes a WebSocket transport and Remote Control API availability, but the command names are Bellona-specific and not mapped to Unreal Remote Control routes in this repo.
  • The app bridge and library use different command namespaces (unreal:spawn-actor vs. actor.spawn, unreal:execute-console-command vs. console.execute) with no adapter mapping between them.
  • There is no plugin installation/repair flow, plugin version handshake, capability discovery, project-open validation, editor-state validation, or permission model for Unreal Editor.

Command coverage assessment:

  • Read-only-ish coverage exists as client intent only for world/level/actor queries in the library (level.getLevels, actor.get, actor.find, editor.getSelection, plugin info, version discovery).
  • Mutation coverage is broad but unproven: actor spawn/destroy/property writes, blueprint creation/compile, asset import/save/delete/move, level open/save, PIE controls, build/cook/package, material edits, sequencer edits/render, plugin enable/disable, debug controls, world partition load/unload, live coding, Niagara creation, mesh/audio/texture imports, project settings, and MetaHuman operations.
  • unreal:take-screenshot is present in the app bridge, but the library command inventory does not expose a matching screenshot wrapper in the audited command list.

Version support:

  • Version discovery searches launcher and source-build paths for Windows, macOS, and Linux, parses Build.version, infers directory versions, and reads Epic Launcher LauncherInstalled.dat.
  • Launcher support can add -RemoteControl and -RemoteControlPort for UE5+ editor launches. UE4 executable names are partially considered during discovery, but Remote Control launch flags are gated to UE5+.
  • Types include Unreal target platforms for Win64, Mac, Linux, LinuxArm64, Android, IOS, TVOS, PS4, PS5, XboxOne, XSX, Switch, and HoloLens.

Unsafe for remote operation until Phase 180 policy, approval, and audit exist:

  • unreal:execute-console-command / console.execute, live coding, debug evaluation, plugin enable/disable, project setting writes, build/cook/package, asset delete/move/import, level open/save, actor destroy, Blueprint function calls, and PIE controls are privileged and potentially destructive.
  • File and asset operations lack project-root grants, artifact registration, hash validation, source approval, output approval, and rollback evidence.
  • Editor mutation commands lack transactions/undo checkpoints, viewport or screenshot evidence, policy result metadata, and audit hashes.

Test constraints:

  • Existing app and library tests are surface tests that verify exports or a stopped bridge object. They do not connect to Unreal Editor, Remote Control, an Unreal plugin, or a fixture project.
  • Hardware or editor-in-the-loop verification will be required before checking any future Unreal behavior that cannot be proven by mocks.
  • The first Phase 180 Unreal implementation should start with read-only unreal.project.info and unreal.world.query mocks and only then add a localhost authenticated editor plugin/adapter.

Remote-control reuse decision:

  • Reuse version discovery, launcher argument generation, state/event shapes, and library command naming as design input.
  • Do not expose any Unreal mutation, console, live-coding, plugin, build, file, or project-setting operation remotely until remote-protocol schemas, policy/approval/audit, artifact evidence, path grants, and an actual Unreal adapter/plugin contract exist.

180.C.02.05 Psyche Computer Use#

Audit date: 2026-04-21

Files reviewed:

  • services/psyche/computer-use/README.md
  • services/psyche/computer-use/project.json
  • services/psyche/computer-use/pyproject.toml
  • services/psyche/computer-use/src/computer_use/vision/screenshot.py
  • services/psyche/computer-use/src/computer_use/vision/ocr.py
  • services/psyche/computer-use/src/computer_use/vision/accessibility.py
  • services/psyche/computer-use/src/computer_use/vision/ui_detection.py
  • services/psyche/computer-use/src/computer_use/actions/input.py
  • services/psyche/computer-use/src/computer_use/actions/files.py
  • services/psyche/computer-use/src/computer_use/actions/browser.py
  • services/psyche/computer-use/src/computer_use/actions/types.py
  • services/psyche/computer-use/src/computer_use/screen_sharing/capture.py
  • services/psyche/computer-use/src/computer_use/screen_sharing/types.py
  • services/psyche/computer-use/src/computer_use/screen_sharing/encoding.py
  • services/psyche/computer-use/src/computer_use/screen_sharing/streaming.py
  • Representative unit tests for clipboard, file operations, multi-monitor input, OCR, UI detection, screen sharing, and recovery.

Reusable primitives for macOS fallback:

  • Data contracts: Screenshot, BoundingBox, UIElement, OCRResult, ScreenAnalysis, Action, ActionResult, ActionType, CaptureConfig, Frame, EncodedFrame, and stream stats are portable enough to inform libs/psyche/desktop-fallback and Bellona remote-protocol schemas.
  • OCR and image analysis: OCREngine, Tesseract/EasyOCR/PaddleOCR providers, OCR domain tuning, Pillow preprocessing, UI detection, icon detection, progress detection, semantic screen understanding, and UI pattern recognition are reusable once a macOS backend supplies screenshot bytes and screen geometry.
  • Accessibility conversion: AccessibilityNode, AccessibilityTree, and ui_elements_from_accessibility_tree() are reusable as the neutral tree and UI-element mapping layer. The current provider is AT-SPI-only, so macOS needs a new AX/UIAutomation provider that emits the same neutral shape.
  • File fallback: FileController already enforces allowed roots, relative path resolution, read-size/write-size limits, atomic overwrite, append, directory listing, text/binary reads, and CSV/JSON conversion. This is reusable as a local-file fallback only after Phase 180 path grants, policy, approval, and audit wrapping exist.
  • Browser fallback: the high-level browser actions for launch, navigate, tab management, refresh, back/forward, form fill, page scroll, find, download watching, extension inventory, and cookie helpers are useful as behavior inventory. For Bellona, deterministic Playwright/CDP adapters should be preferred; this keyboard-driven browser controller is fallback-only.
  • Screen sharing: frame buffers, frame metadata, changed-pixel estimation, multi-screen composition, region/window capture concepts, encoders, overlays, RTP packetization, NACK/FEC, bandwidth estimation, quality control, and screen-share coordination are reusable design pieces for the live Control Room stream.

Platform-specific pieces that are not directly reusable on macOS:

  • Screenshot capture is X11/Linux-specific. ScreenshotCapture tries scrot, ImageMagick import, and xwd; streaming capture uses ffmpeg x11grab, scrot, and import.
  • Input is X11/Linux-specific. Mouse, key, drag, gesture, monitor, cursor, and clipboard operations depend on xdotool, xrandr, xclip, and xsel.
  • Accessibility extraction is Linux desktop-specific through pyatspi/AT-SPI.
  • Browser profile paths default to Linux Chrome/Chromium locations and direct SQLite cookie edits; real profile access is credential-sensitive and must not be exposed remotely before policy, approval, and audit controls exist.
  • The service runtime is an Xvfb/Docker-oriented FastAPI application. It does not include a native macOS host, TCC permission workflow, Screen Recording permission probe, Accessibility permission probe, signed helper, or launch agent.

Remote-control reuse decision:

  • Create the future macOS fallback as a provider-based adapter around Psyche's portable data models and analysis pipeline, not by reusing X11 controllers.
  • Required macOS providers: screen capture through ScreenCaptureKit or screencapture fallback, accessibility tree through macOS AX APIs, input through native CGEvent/AX actions, clipboard through NSPasteboard or pbcopy/pbpaste, window/app inventory through AX/NSWorkspace, and browser control through Playwright/CDP before keyboard fallback.
  • Keep desktop fallback behind Bellona adapter policy. Blender, Unreal, and browser operations must still use typed deep adapters first, with screenshot, click, and key fallback only when a deterministic API path is unavailable.

Risks and blockers before macOS remote use:

  • ActionExecutor exposes arbitrary bash and editor actions; those cannot be carried into Bellona until remote-protocol risk classes, explicit approvals, command allowlists, audit hashes, and evidence capture are complete.
  • Input and file operations lack command idempotency, policy result metadata, human approval linkage, artifact registration, and rollback/evidence hooks.
  • Hardware/manual verification will be required for macOS TCC prompts, Accessibility control, Screen Recording capture, multi-display coordinate mapping, WebRTC stream quality, and intervention/takeover behavior.

Verification fixes made during audit:

  • Accessibility-only analysis now tolerates invalid or empty screenshot bytes so accessibility-derived UI elements and pattern recognition can still be evaluated without a decodable image payload.
  • Screenshot post-processing now returns the original screenshot unchanged when Pillow cannot decode the captured bytes instead of failing the capture path.
  • Progress detection now handles NumPy RGB pixel arrays as multi-channel pixels, matching the detector's intended list/tuple behavior.

Verification closure:

  • pnpm nx test psyche-computer-use passes after the fixes above.
  • pnpm nx lint psyche-computer-use runs in the package's declared Poetry environment and now passes after service-wide Ruff cleanup, annotation modernization, dynamic-backend typing, and strict mypy fixes across services/psyche/computer-use/src.

180.C.02.06 Psyche Orchestrator and API Gateway#

Audit date: 2026-04-21

Files reviewed:

  • services/psyche/orchestrator/README.md
  • services/psyche/orchestrator/project.json
  • services/psyche/orchestrator/pyproject.toml
  • services/psyche/orchestrator/src/orchestrator/session/types.py
  • services/psyche/orchestrator/src/orchestrator/session/lifecycle.py
  • services/psyche/orchestrator/src/orchestrator/session/state.py
  • services/psyche/orchestrator/src/orchestrator/pipeline/types.py
  • services/psyche/orchestrator/src/orchestrator/pipeline/router.py
  • services/psyche/orchestrator/src/orchestrator/pipeline/communication.py
  • services/psyche/orchestrator/src/orchestrator/multiparty/types.py
  • services/psyche/orchestrator/src/orchestrator/multiparty/participants.py
  • services/psyche/orchestrator/src/orchestrator/multiparty/turns.py
  • services/psyche/orchestrator/src/orchestrator/multiparty/sync.py
  • services/psyche/orchestrator/tests/test_session_state_store_resolution.py
  • services/psyche/api-gateway/README.md
  • services/psyche/api-gateway/project.json
  • services/psyche/api-gateway/pyproject.toml
  • services/psyche/api-gateway/src/api_gateway/app.py
  • services/psyche/api-gateway/src/api_gateway/config.py
  • services/psyche/api-gateway/src/api_gateway/models/sessions.py
  • services/psyche/api-gateway/src/api_gateway/routers/sessions.py
  • services/psyche/api-gateway/src/api_gateway/websocket/models.py
  • services/psyche/api-gateway/src/api_gateway/websocket/manager.py
  • services/psyche/api-gateway/src/api_gateway/websocket/handlers.py
  • services/psyche/api-gateway/src/api_gateway/routers/websocket.py
  • services/psyche/api-gateway/src/api_gateway/models/webhooks.py
  • services/psyche/api-gateway/src/api_gateway/services/webhooks.py
  • services/psyche/api-gateway/src/api_gateway/routers/webhooks.py
  • services/psyche/api-gateway/src/api_gateway/core/middleware.py

Reusable orchestrator patterns:

  • Session vocabulary: SessionStatus, SessionConfig, SessionState, ToolState, ScreenShareState, Participant, SessionEvent, and SessionHandoff provide a useful inventory for Bellona remote-session schemas, especially the separation between lifecycle status, participant state, tool state, and screen-share control state.
  • Lifecycle shape: SessionLifecycleManager has the right high-level phases for create, start, pause, resume, terminate, timeout warning, timeout, and handoff. Bellona should reuse that state-machine vocabulary, but implement it behind durable command/session records.
  • Durable state gate: create_state_store_from_env() and resolve_state_store() explicitly reject memory-backed session state in production and support Redis TTL-backed state. This guard is reusable for the Remote Gateway and Remote Host.
  • State synchronization concepts: state_version, timestamps, checkpoints, hash computation, latest-wins/merge synchronization, and typed state-change events are useful for Bellona session reconciliation and UI updates.
  • Pipeline vocabulary: PipelineMessage, StreamType, MessageType, EventMessage, audio/video frame sequence numbers, priority queues, bounded buffers, quality levels, and latency stats are useful design inputs for the future WebRTC/control/event channels.
  • Multi-party concepts: participant roles, permissions, presence, turn-taking, hand raise, interruption policy, delta sync, full-state sync, annotations, delivery acknowledgements, and conflict resolution are useful for Control Room collaboration and human takeover semantics.

Reusable API gateway patterns:

  • FastAPI application factory, lifespan hook, router partitioning, request ID propagation, response timing, structured logging, and CORS/header exposure are good baseline service patterns for a Bellona Remote Gateway.
  • Pydantic models for session lifecycle, WebSocket messages, command correlation IDs, acknowledgements, pings/pongs, event type enums, transcript chunks, metrics events, and error messages are useful protocol inventory for Bellona's remote protocol.
  • ConnectionManager cleanly separates connection lifecycle, subscription tracking, event filtering, session-scoped broadcasts, direct connection sends, acknowledgements, errors, and pong responses. The shape is reusable, with a durable/distributed backing implementation.
  • Webhook signing and retry concepts are reusable: HMAC signatures with timestamp tolerance, delivery IDs, exponential backoff with jitter, attempt records, and a dead-letter path belong in the remote-control event/export story.

Patterns to avoid or rewrite for Bellona:

  • API gateway session routes use process-local _sessions and _session_counter state. They do not call the orchestrator, do not persist through restart, do not enforce valid state transitions, and are not safe as remote-control session authority.
  • API gateway WebSocket endpoints accept an optional token query parameter but only record that one was provided. They do not authenticate, authorize, bind tenant/user/session scopes, validate subscriptions, or enforce command policy.
  • API gateway WebSocket command handlers mostly simulate effects by broadcasting events and returning acknowledgements. tool.execute sleeps and emits completed status without dispatching a real tool. Bellona commands must go through protocol validation, policy, approval, idempotency, execution, audit, and evidence hooks before an ack claims success.
  • API gateway WebSocket and webhook managers are process-local. They are useful for single-process tests but must be replaced or backed by durable pub/sub for multiple gateway workers, reconnect resume, replay, and horizontal scaling.
  • API gateway lifespan contains placeholder database and Redis initialization; it should not be treated as an implemented persistence lifecycle.
  • api_gateway.config.Settings.orchestrator_url defaults to http://localhost:8003, while the orchestrator project serves on port 8007. Any future coupling must make service discovery/configuration explicit and tested.
  • Orchestrator lifecycle and event managers use process-local singletons, callback lists, in-memory handoffs, in-memory checkpoints, and background tasks. They also swallow callback exceptions in several paths. Bellona should keep the vocabulary, not the durability/error-handling behavior.
  • Orchestrator communication classes simulate gRPC and WebSocket delivery. GRPCStreamManager, WebSocketMultiplexer, and EventBroadcaster are useful sketches, but not transport implementations for privileged remote control.
  • Orchestrator pipeline queues and multiplexers drop or hide failures in some timeout/full-queue paths. Bellona must expose backpressure, cancellation, command failure reasons, audit records, and operator-visible degraded state.
  • Multi-party and state-sync managers are in-memory and do not cryptographically bind participant identity, command authorization, or delivery acknowledgements.

Remote-control reuse decision:

  • Use Psyche orchestrator and API gateway code as a source of names, state transitions, event categories, and service boundaries.
  • Do not import the current API gateway session/WebSocket command handlers as the Bellona Remote Gateway authority. Build Bellona's gateway around libs/bellona/remote-protocol, durable session/command/event records, policy evaluation, explicit approval state, auditable command outcomes, and replay-safe subscriptions.
  • Reuse the production state-store guard pattern immediately: no process-local session, command, approval, or WebSocket subscription state is acceptable for production remote control unless it is explicitly a cache over durable state.
  • Preserve the separation between deep adapters and desktop fallback: lifecycle and WebSocket routing can be shared concepts, but Blender, Unreal, browser, and desktop operations must still execute through typed Bellona adapters or a policy-gated fallback provider.

Risks and blockers before remote use:

  • Authentication, authorization, tenant/session scoping, command policy, approval, audit, evidence capture, idempotency, replay protection, reconnect resume, and durable event logs are absent from the current Psyche gateway.
  • Hardware/manual verification will be required later for WebRTC media/data channels, same-LAN discovery, gateway/host reconnect behavior, Control Room takeover, and live remote-session latency/degraded-state handling.

Verification closure:

  • pnpm nx lint psyche-orchestrator passes in the declared Poetry environment.
  • pnpm nx test psyche-orchestrator passes in the declared Poetry environment.
  • pnpm nx lint psyche-api-gateway passes in the declared Poetry environment.
  • pnpm nx test psyche-api-gateway passes in the declared Poetry environment.

180.C.02.07 Yemaya Studio Web and Desktop#

Audit date: 2026-04-21

Files reviewed:

  • apps/yemaya/studio-web/project.json
  • apps/yemaya/studio-web/package.json
  • apps/yemaya/studio-web/playwright.config.ts
  • apps/yemaya/studio-web/src/App.tsx
  • apps/yemaya/studio-web/src/lib/lazy.tsx
  • apps/yemaya/studio-web/src/lib/api.ts
  • apps/yemaya/studio-web/src/components/Layout.tsx
  • apps/yemaya/studio-web/src/components/Sidebar.tsx
  • apps/yemaya/studio-web/src/components/guards/AuthGuard.tsx
  • apps/yemaya/studio-web/src/pages/ProjectPage.tsx
  • apps/yemaya/studio-web/src/pages/SettingsPage.tsx
  • apps/yemaya/studio-web/src/stores/bellonaStore.ts
  • apps/yemaya/studio-web/src/stores/collaborationStore.ts
  • apps/yemaya/studio-web/e2e/studio-web.smoke.spec.ts
  • apps/yemaya/studio-desktop/project.json
  • apps/yemaya/studio-desktop/package.json
  • apps/yemaya/studio-desktop/src/main/index.ts
  • apps/yemaya/studio-desktop/src/main/bellona-bridge.ts
  • apps/yemaya/studio-desktop/src/main/file-permissions.ts
  • apps/yemaya/studio-desktop/src/main/native-integrations.ts
  • apps/yemaya/studio-desktop/src/main/protocol-handler.ts
  • apps/yemaya/studio-desktop/src/main/fullscreen.ts
  • apps/yemaya/studio-desktop/src/main/window-layouts.ts
  • apps/yemaya/studio-desktop/src/main/multi-monitor.ts
  • apps/yemaya/studio-desktop/src/main/picture-in-picture.ts
  • apps/yemaya/studio-desktop/src/preload/index.ts
  • apps/yemaya/studio-desktop/src/shared/ipc-types.ts
  • apps/yemaya/studio-desktop/src/renderer/App.tsx
  • apps/yemaya/studio-desktop/src/renderer/components/Layout.tsx
  • apps/yemaya/studio-desktop/src/renderer/components/Sidebar.tsx
  • apps/yemaya/studio-desktop/src/renderer/hooks/useBellona.ts
  • apps/yemaya/studio-desktop/src/renderer/pages/WelcomePage.tsx
  • apps/yemaya/studio-desktop/src/renderer/pages/ProjectPage.tsx

Existing studio-web implementation:

  • studio-web is a React/Vite PWA with lazy route loading, auth/role guards, a reusable app shell, protected routes, API helper auth header injection, Zustand stores, and Playwright coverage across desktop and mobile viewports.
  • The web app already depends on @oshun/bellona-client and has a bellonaStore for engine registration, status, sync, exports, builds, and polling against VITE_BELLONA_API_URL/http://localhost:3500.
  • The existing Bellona web store is engine-sync oriented. It does not model remote devices, host pairing, session lifecycle, stream descriptors, command timelines, approvals, takeover, evidence, replay, or emergency stop.
  • collaborationStore has useful operator-experience vocabulary: presence, rooms, participant media state, screen sharing flags, document sync, conflict state, chat, notifications, and panel visibility.
  • The current route/sidebar shape is project-production focused: projects, scripts, storyboards, assets, settings, and permissions. Control Room would be a privileged operations surface rather than another production workspace page.

Existing studio-desktop implementation:

  • studio-desktop is an Electron app with secure defaults in the main window: sandboxed preload, context isolation, no Node integration in the renderer, and explicit IPC through preload and shared/ipc-types.ts.
  • The desktop main process already owns native concerns that matter for a final operator app: menus, tray, global shortcuts, notifications, drag/drop, recent files, file permissions, file watching, deep links, app updates, window state, multi-monitor support, layouts, fullscreen, picture-in-picture, and native packaging/signing scripts.
  • The desktop Bellona bridge discovers local Blender/Unreal/Godot/Unity installs, connects over local engine bridge protocols, emits IPC events, supports asset sync/export, and simulates live-link viewport events. This is useful evidence for local engine UX, but it is not the remote-control host or gateway contract.
  • The renderer is a local project workspace. Its useBellona hooks are scoped to local engine discovery, local engine connection, asset sync, export, and live-link state, not remote device/session/timeline control.
  • No reviewed desktop code provides WebRTC session viewing, gateway-backed host pairing, policy-gated command approval, audit replay, remote emergency stop, or remote session authority.

MVP placement decision:

  • The MVP Control Room should live in a Bellona-owned app/view, apps/bellona/control-room, when the checklist reaches Control Room scaffolding. It should not be implemented as the primary surface inside apps/yemaya/studio-web or apps/yemaya/studio-desktop.
  • Reuse studio-web patterns, not its product shell: React/Vite routing, lazy-loaded routes, auth guard shape, API helper conventions, Zustand store structure, Playwright desktop/mobile setup, and the Bellona client integration style are good implementation references.
  • Keep the MVP browser-first and gateway-backed: device list, session list, command timeline, approvals, live stream state, takeover, degraded/offline states, and emergency stop should be served by the Remote Gateway and protocol schemas, not by Yemaya project stores or Electron IPC.
  • Yemaya Studio Web can later deep-link into the Bellona Control Room with project context, but it should not become the authority for remote-control sessions, privileged commands, approvals, stream state, or audit logs.

Final-product placement decision:

  • The final product should keep Control Room as a Bellona-owned, standalone web surface with a shared UI/domain package that can be embedded by other shells. That preserves a clear security/audit boundary while allowing Yemaya production workflows to attach project context, reviews, renders, and assets.
  • studio-desktop should be treated as the native operator distribution path and optional wrapper for the Bellona Control Room, not the canonical Control Room implementation. Its native layer can provide packaging, updates, deep links, native menus, multi-window layouts, multi-monitor/fullscreen/PiP affordances, and OS permission diagnostics.
  • Native host authority belongs in the Bellona Remote Host/mac-host runtime, not in the Yemaya renderer. Any desktop shell must call the Remote Gateway or host protocol and must preserve policy, approval, audit, evidence, and replay semantics.
  • Yemaya integration should be additive: "open this remote session for this project", "attach this render/evidence to review", and "show command output in the production timeline" are appropriate integration points after the Bellona Control Room has its own protocol-backed core.

Patterns to reuse:

  • studio-web route guards, lazy loading, API auth header injection, Zustand store conventions, PWA/mobile viewport testing, and Playwright config.
  • studio-web collaboration concepts for presence, participant media state, screen-sharing flags, notifications, and panel visibility.
  • studio-desktop secure Electron defaults, explicit typed IPC inventory, deep-link handling, native update/signing path, window/fullscreen/PiP affordances, and permission/file-grant UX patterns.
  • Desktop useBellona hooks as a reference for event-driven React state over engine status, progress, conflicts, and live-link telemetry.

Patterns to avoid:

  • Do not couple privileged remote-control state to Yemaya project state, production pages, or local-only desktop engine IPC.
  • Do not fork the Control Room UI into separate web and desktop implementations. Build one protocol-backed Bellona UI core and wrap/embed it where needed.
  • Do not treat the current bellonaStore or desktop Bellona bridge as a remote-control implementation. They are engine sync/live-link precedents, not the Phase 180 session, command, approval, stream, or audit authority.
  • Do not expose Electron native capabilities directly to a Control Room renderer for remote actions. The renderer should request protocol commands; the gateway/host/policy/audit path decides and records execution.

Risks and blockers before Control Room implementation:

  • libs/bellona/remote-protocol, Remote Gateway, Remote Host, policy, approval, audit, and stream schemas must exist before the Control Room can render durable session/timeline state.
  • Playwright coverage for Control Room must include loading, empty, offline/degraded, connected, streaming, approval pending, takeover, failed-command, replay, and redaction states once the app/view exists.
  • Hardware/manual verification will still be required later for live WebRTC streams, desktop fallback permissions, multi-monitor behavior, real engine adapters, and native desktop wrapper behavior.

Verification repair notes:

  • studio-web typecheck exposed missing typings for Vite PWA's virtual React module plus browser APIs used by service-worker notifications and web-vitals observers. Added src/types/browser-compat.d.ts so the existing PWA, notification, and performance code typechecks without weakening the project compiler settings.
  • studio-desktop lint exposed duplicate import errors in Electron, electron-updater, and local project modules. Merged those value/type imports while leaving the existing warning-level desktop lint debt unchanged.

Verification closure:

  • pnpm nx lint @yemaya/studio-web passes.
  • pnpm nx typecheck @yemaya/studio-web passes.
  • pnpm nx test @yemaya/studio-web passes.
  • pnpm nx e2e @yemaya/studio-web passes.
  • pnpm nx lint @yemaya/studio-desktop passes.
  • pnpm nx typecheck @yemaya/studio-desktop passes.
  • pnpm nx test @yemaya/studio-desktop passes.

180.C.02.08 Standalone Gateway and Host ADR#

Decision date: 2026-04-21

Files created:

  • docs/domains/bellona/extras/remote-control/adr/ADR-0001-standalone-remote-gateway-and-host.md

Existing implementations analyzed:

  • libs/bellona/bridge-core request/response, lifecycle, heartbeat, reconnect, timeout, and validation patterns.
  • apps/bellona/bridge-blender, libs/bellona/blender, apps/bellona/bridge-unreal, and libs/bellona/unreal as local engine adapter precedents.
  • services/psyche/computer-use as the source for reusable desktop fallback primitives.
  • services/psyche/orchestrator and services/psyche/api-gateway as lifecycle and WebSocket vocabulary references, not as remote-control authority.
  • apps/yemaya/studio-web and apps/yemaya/studio-desktop as future Control Room UI/native-shell references, not as session authority.

Decision summary:

  • Accepted a standalone Bellona Remote Gateway plus standalone Bellona Remote Host as the authoritative Phase 180 architecture.
  • The gateway owns device identity, pairing, sessions, command intake/routing, approvals, policy integration, audit emission, subscriptions, MCP access, and WebRTC/WebSocket signaling.
  • The host runs on the controlled MacBook, connects outbound to the gateway, reports capabilities and health, manages local adapters, executes authorized command lifecycles, and returns evidence/results.
  • libs/bellona/remote-protocol remains the single source of truth for command and event schemas before gateway, host, MCP, adapters, tests, docs, and Control Room UI depend on concrete contracts.
  • Bellona bridge-core, Blender, and Unreal code are reusable only behind host-local typed adapter boundaries with policy and audit semantics.
  • Psyche computer-use code is reusable as fallback primitive logic, expected later under libs/psyche/desktop-fallback, but Psyche services do not become the privileged remote-control authority.

Risks and blockers before implementation:

  • Protocol schemas, compatibility rules, external implementation research, and the Phase 180 threat model must be completed before privileged implementation stages rely on this architecture.
  • Production gateway state must be durable; memory-only state remains limited to tests and clearly marked development harnesses.
  • Hardware/manual evidence will be required later for real macOS permissions, Blender/Unreal adapter execution, browser profile access, WebRTC streaming, and cross-network host operation.

Verification closure:

  • pnpm exec prettier --check docs/domains/bellona/extras/remote-control/adr/ADR-0001-standalone-remote-gateway-and-host.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md passes.
  • git diff --check passes.

180.C.02.09 Compatibility Matrix#

Matrix date: 2026-04-21

Files created:

  • docs/domains/bellona/extras/remote-control/compatibility-matrix.md

Existing implementations and configuration analyzed:

  • Root package.json and pnpm-workspace.yaml for Node, pnpm, TypeScript, Nx, Vite, Vitest, Playwright, WebSocket, and workspace baselines.
  • services/psyche/computer-use/pyproject.toml, services/psyche/orchestrator/pyproject.toml, and services/psyche/api-gateway/pyproject.toml for Python 3.11, Poetry-backed service targets, Playwright, WebSockets, OCR, aiortc, and av dependency signals.
  • Bellona domain docs and audited bridge code for existing Blender 3.6-4.0, Blender >=4.0, Unreal 5.0-5.3, Unreal >=5.3, localhost bridge port, and adapter command-surface signals.
  • Yemaya desktop/web docs and package files for Electron/native wrapper, macOS 13+, Node 20+, pnpm 10+, Playwright, Vite, and browser-first Control Room implementation references.
  • Official upstream docs for current lifecycle reality: Node.js releases, Blender 4.5 LTS, Unreal Engine 5.6 macOS/Xcode requirements, Chrome remote debugging profile rules, Playwright browser support, Apple capture permissions, WebRTC ICE/STUN/TURN, and Python 3.11 schedule.

Matrix summary:

  • Established macOS 14 on Apple Silicon as the Remote Host MVP baseline, with macOS 13 limited to transitional operator-wrapper compatibility and macOS 15 as a future advanced-capture candidate.
  • Established Blender 4.0.x and Unreal Engine 5.3 as first adapter baselines because they align with the repo's existing Bellona docs without overclaiming support for newer upstream versions.
  • Recorded Blender 4.2/4.5 LTS and Unreal 5.4/5.5/5.6 as supported candidates that require adapter tests and hardware evidence before being advertised as supported.
  • Established isolated Playwright Chromium or isolated Chrome/Chromium profiles as the browser automation baseline; real profiles, credential/cookie access, and default-profile CDP are blocked.
  • Established Node 22 LTS as the preferred first target for new Phase 180 TypeScript packages while preserving compatibility with the repo's >=20 root engine, and added Node 24 LTS as a CI candidate once packages exist.
  • Established Python 3.11 as the fallback-runtime baseline and explicitly kept package-manager migration from Poetry to uv out of this matrix's scope.
  • Defined same-LAN, cloud gateway, offline fixture, and direct-adapter network mode compatibility, with direct adapter exposure blocked by the localhost adapter rule.

Risks and blockers before implementation:

  • Version ranges must become protocol capability metadata in libs/bellona/remote-protocol; gateway/host handshakes must reject or degrade unsupported combinations.
  • Real macOS TCC, Blender, Unreal, Chrome app/profile, WebRTC, same-LAN, and cross-network operation require manual/hardware evidence before later implementation items are checked.
  • Candidate engine/runtime versions must not be enabled as production-supported until fixture tests, adapter tests, and hardware evidence exist.

Verification closure:

  • pnpm exec prettier --check docs/domains/bellona/extras/remote-control/compatibility-matrix.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md passes.
  • git diff --check passes.

180.C.02.10 External Implementation Research#

Research date: 2026-04-21

Files created:

  • docs/domains/bellona/extras/remote-control/external-implementation-research-2026-04-21.md

External sources analyzed:

  • Model Context Protocol authorization, security, and OpenAI Docs MCP guidance.
  • Chrome DevTools Protocol, Chrome remote debugging security changes, and Chrome debugger extension docs.
  • Playwright browser support, CDP attachment, and Playwright MCP automation docs.
  • Browser Use open-source docs and GitHub project.
  • OpenAI Computer Use guidance, OpenAI Codex CLI repository, Anthropic Computer Use tool docs, and Anthropic's computer-use announcement.
  • MDN WebRTC connectivity/protocol docs and coturn TURN server docs.
  • Apple media capture authorization, ScreenCaptureKit, Accessibility trust, and notarization/hardened-runtime docs.
  • Blender add-on, Python API, timer, handler, and threading docs.
  • Unreal Python editor scripting, Remote Control API HTTP/WebSocket, plugin, and Unreal 5.6 docs.
  • NIST and CISA remote access security guidance plus Tailscale, WireGuard, Cloudflare Tunnel, and ngrok tunnel docs.

Research summary:

  • MCP should expose Bellona gateway-backed tools over Streamable HTTP/OAuth-like authorization; stdio remains local-fixture only, and token passthrough is rejected.
  • CDP is powerful enough to expose page/storage/network state and must remain a localhost-only host adapter surface using isolated profiles.
  • Playwright is the preferred deterministic browser-test and isolated browser automation harness; CDP attach is a lower-fidelity special case.
  • Browser Use is useful for browser-agent UX vocabulary, but its profile sync and remote browser provider patterns are blocked unless a future ADR accepts that data boundary.
  • Codex, Claude, and other Computer Use agents should call the Bellona Gateway or MCP tools as clients; they must not receive direct desktop authority.
  • WebRTC requires gateway-authorized signaling, same-LAN direct paths only as optimizations, and TURN for reliable cross-NAT/cloud media.
  • macOS TCC, signing, notarization, helper separation, and permission diagnostics are host-runtime requirements rather than UI afterthoughts.
  • Blender and Unreal editor scripting/control APIs must remain behind host-local adapters with protocol risk classes, policy, approval, evidence, and audit.
  • Remote desktop and cloud tunnel patterns are useful security references and network underlays, but they do not replace the standalone Bellona Gateway and outbound Remote Host architecture accepted in ADR-0001.

Risks and blockers before implementation:

  • External research confirmed that privileged browser, desktop, engine scripting and remote media paths can expose credentials, project data, local files, and editor state unless policy/audit/redaction boundaries are implemented first.
  • Later tasks must still define threat-model controls, protocol schemas, compatibility metadata, adapter capability reports, approval gates, and hardware evidence before enabling these surfaces.

Verification closure:

  • pnpm exec prettier --check docs/domains/bellona/extras/remote-control/external-implementation-research-2026-04-21.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md passes.
  • git diff --check passes.

180.C.02.11 Threat-Model ADR#

Decision date: 2026-04-21

Files created:

  • docs/domains/bellona/extras/remote-control/adr/ADR-0002-remote-control-threat-model.md

Existing implementation and research inputs analyzed:

  • docs/domains/bellona/extras/remote-control/adr/ADR-0001-standalone-remote-gateway-and-host.md for the standalone gateway/host trust boundary.
  • docs/domains/bellona/extras/remote-control/compatibility-matrix.md for macOS, Blender, Unreal, Chrome/Chromium, Node, Python, WebRTC, same-LAN, and cloud-mode support boundaries.
  • docs/domains/bellona/extras/remote-control/external-implementation-research-2026-04-21.md for MCP, CDP, Playwright, Browser Use, Computer Use, WebRTC/TURN, macOS TCC, Blender, Unreal, remote desktop security, and tunnel research.
  • Microsoft STRIDE threat-model references, OWASP LLM prompt-injection guidance, NIST/CISA remote access guidance, Chrome remote debugging security guidance, and MCP security guidance.

Decision summary:

  • Accepted a STRIDE-style threat-model ADR as a mandatory gate for later Phase 180 implementation work.
  • Defined trust boundaries for actor-to-gateway, gateway-to-host, host-to-local adapters, agent-to-untrusted-content, Control Room-to-gateway, WebRTC media-to-command-bus, and build/update-to-runtime paths.
  • Covered spoofing, tampering, repudiation, information disclosure, denial of service, and elevation-of-privilege threats with mandatory controls.
  • Added explicit controls for prompt injection, browser credential exposure, malicious web pages, compromised gateway, compromised host, compromised agent, local network attacker, replay attacks, and supply-chain tampering.
  • Reaffirmed non-negotiable prohibitions: no direct LAN/internet engine/CDP/ desktop ports, no production memory-only authority, no real browser profiles by default, and no arbitrary shell/script/console/desktop fallback before protocol risk classes, policy, approvals, audit, evidence, and kill switch exist.

Risks and blockers before implementation:

  • Later protocol, gateway, host, adapter, browser, desktop fallback, MCP, and Control Room tasks must translate the ADR controls into schemas, services, tests, and hardware evidence before they can be checked.
  • Threat controls must stay host-enforced where possible so a compromised gateway or compromised agent cannot become sufficient to execute privileged local actions.

Verification closure:

  • pnpm exec prettier --check docs/domains/bellona/extras/remote-control/adr/ADR-0002-remote-control-threat-model.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md passes.
  • git diff --check passes.

180.C.02.12 Stage Closure#

Closure date: 2026-04-21

Files updated:

  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Closure evidence:

  • TODOS/phase-180.md has 180.C.02.01 through 180.C.02.11 checked before this item was checked.
  • The tracker progress table marks 180.C.02.01 through 180.C.02.11 as complete with owner, changed files, verification, hardware evidence notes, and blockers/follow-up notes.
  • The remote-control documentation set for this stage is present: docs/domains/bellona/extras/remote-control/implementation-tracker.md, docs/domains/bellona/extras/remote-control/adr/ADR-0001-standalone-remote-gateway-and-host.md, docs/domains/bellona/extras/remote-control/compatibility-matrix.md, docs/domains/bellona/extras/remote-control/external-implementation-research-2026-04-21.md, and docs/domains/bellona/extras/remote-control/adr/ADR-0002-remote-control-threat-model.md.
  • No premature implementation package paths existed at closure time: apps/bellona/remote-host, apps/bellona/remote-gateway, apps/bellona/control-room, libs/bellona/remote-protocol, libs/bellona/remote-adapters, libs/bellona/mcp-gateway, libs/bellona/mac-host-runtime, libs/psyche/desktop-fallback, and testing/bellona/remote-control were all absent.

Decision summary:

  • Stage 180.C.02 is complete and eligible to hand off to the next stage in the same phase.
  • No implementation package was created during the audit/architecture stage.
  • Future work must continue with 180.C.03 Remote Protocol Package and must not skip protocol, mock harness, gateway, host, policy, adapter, fallback, and Control Room sequencing.

Verification closure:

  • pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md passes.
  • git diff --check passes.

Stage 180.C.03 Remote Protocol Notes#

180.C.03.01 Remote Protocol Package Scaffold#

Implementation date: 2026-04-21

Files created:

  • libs/bellona/remote-protocol/project.json
  • libs/bellona/remote-protocol/package.json
  • libs/bellona/remote-protocol/tsconfig.json
  • libs/bellona/remote-protocol/tsconfig.lib.json
  • libs/bellona/remote-protocol/vitest.config.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/index.test.ts
  • libs/bellona/remote-protocol/README.md

Existing implementation patterns analyzed:

  • libs/bellona/bridge-core for @nx/js:tsc build, Vite tests, package metadata, and infrastructure library tagging.
  • libs/bellona/adapters for Bellona domain library package exports, build assets, strict TypeScript config, Vite tests, and package metadata shape.
  • libs/bellona/interchange-models for explicit typecheck target precedent and schema/model ownership language.
  • Root tsconfig.base.json and pnpm-workspace.yaml for the existing @bellona/* path alias and libs/bellona/* workspace discovery.

Implementation summary:

  • Created @bellona/remote-protocol under libs/bellona/remote-protocol using the repo's Nx project discovery and package workspace patterns.
  • Added scope:bellona, layer:protocol, type:lib, and surface:remote-control tags so the package is distinguishable as protocol ownership code rather than gateway, host, adapter, or UI implementation.
  • Added build, typecheck, lint, and test targets.
  • Added a minimal descriptor export that declares the package as the authoritative Bellona remote-control protocol boundary while intentionally leaving concrete schemas for later sequential 180.C.03 tasks.
  • Added smoke tests proving the descriptor and metadata exports are stable.
  • Added a README documenting current scope, near-term schema ownership, and guardrails against putting gateway/host/adapter authority in this package.

Verification closure:

  • pnpm nx show project @bellona/remote-protocol discovers the project.
  • pnpm nx build @bellona/remote-protocol passes.
  • pnpm nx typecheck @bellona/remote-protocol passes.
  • pnpm nx lint @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol passes.

180.C.03.02 Device, Capability, Adapter, and Permission Schemas#

Implementation date: 2026-04-21

Files changed:

  • libs/bellona/remote-protocol/package.json
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/src/common.ts
  • libs/bellona/remote-protocol/src/device.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/device.test.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/index.test.ts
  • pnpm-lock.yaml

Existing implementation patterns analyzed:

  • Bellona action-schema packages use typed schema descriptors and targeted schema tests, but no existing relevant Bellona package provided a reusable Zod convention.
  • The root workspace catalog already pins zod, so @bellona/remote-protocol uses the catalog dependency rather than creating an ad hoc validator.

Implementation summary:

  • Added shared protocol primitives for protocol IDs, semantic versions, timestamp strings, and bounded metadata.
  • Added Zod-backed runtime schemas and inferred TypeScript types for RemoteDevice, RemoteCapability, RemoteAdapter, RemotePermission, and RemotePermissionScope.
  • Restricted local adapter endpoints to localhost, 127.0.0.1, or ::1, preserving the Phase 180 localhost-adapter rule at the contract layer.
  • Added device graph validation so capabilities must reference declared adapters, adapter/capability permission scopes must have matching permission records, and nested adapter, capability, and permission IDs cannot duplicate.
  • Added fixtures for a same-LAN Studio MacBook Air host with Blender read-only capability and blocked desktop fallback capability.
  • Updated package metadata tests to reflect that the protocol package now owns its first concrete schema slice.
  • Added the protocol package importer entry to pnpm-lock.yaml for the new catalog-backed zod dependency.

Verification closure:

  • pnpm nx build @bellona/remote-protocol passes.
  • pnpm nx typecheck @bellona/remote-protocol passes.
  • pnpm nx lint @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol passes.

180.C.03.03 Session, Participant, Surface, and Lifecycle Schemas#

Implementation date: 2026-04-21

Files changed:

  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/src/session.ts
  • libs/bellona/remote-protocol/src/session.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/index.test.ts

Existing implementation patterns analyzed:

  • services/psyche/orchestrator/src/orchestrator/session/types.py for session status, participant, screen-share, state, and lifecycle vocabulary.
  • services/psyche/orchestrator/src/orchestrator/session/lifecycle.py for create, start, pause, resume, timeout, handoff, and terminate phases.
  • services/psyche/orchestrator/src/orchestrator/multiparty/types.py and participants.py for participant role, status, presence, permission, and connection-quality concepts.
  • services/psyche/api-gateway/src/api_gateway/models/sessions.py and websocket/models.py for Pydantic session status and real-time event naming precedents.

Implementation summary:

  • Added Zod-backed runtime schemas and inferred TypeScript types for RemoteSession, RemoteSessionStatus, RemoteParticipant, RemoteSurface, and RemoteSessionLifecycleEvent.
  • Added participant roles/statuses, surface kinds/states/dimensions, and lifecycle event type names without introducing gateway, host, adapter, or UI authority.
  • Added session graph validation so creators, surface owners, event actors, event targets, and event surfaces must reference declared session objects.
  • Added lifecycle validation for duplicate IDs, duplicate event sequences, same-device surfaces, started timestamps for non-initial sessions, paused timestamps for paused sessions, and ended timestamps for terminal sessions.
  • Extended fixtures with an active Studio remote-control session containing an operator participant, Bellona agent participant, Control Room surface, Blender viewport surface, and ordered lifecycle event history.

Verification closure:

  • pnpm nx build @bellona/remote-protocol passes.
  • pnpm nx typecheck @bellona/remote-protocol passes.
  • pnpm nx lint @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol passes.

180.C.03.04 Command Envelope, Priority, Timeout, Risk, and Target Schemas#

Implementation date: 2026-04-21

Files changed:

  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/src/command.ts
  • libs/bellona/remote-protocol/src/command.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/index.test.ts

Existing implementation patterns analyzed:

  • libs/bellona/bridge-core/src/index.ts for existing bridge message IDs, command type strings, payload envelopes, request/reply correlation, and command validation hooks.
  • services/psyche/api-gateway/src/api_gateway/websocket/models.py for command type naming, session-scoped command correlation, acknowledgements, and WebSocket control-message shape.
  • Remote-control ADRs and audit notes for required idempotency keys, replay controls, command envelope validation, risk classes, approval gating, and adapter target metadata.

Implementation summary:

  • Added Zod-backed runtime schemas and inferred TypeScript types for RemoteCommandEnvelope, RemoteCommandPriority, RemoteCommandTimeoutClass, RemoteCommandRiskClass, and RemoteCommandTarget.
  • Added recursive JSON command-argument validation so command arguments remain structured data and reject undefined or non-JSON values.
  • Added target validation requiring command names to match their declared namespace, preserving deterministic routing before adapters exist.
  • Added timeout-class maximums for interactive, short, standard, long-running, and background commands.
  • Added risk-class validation so destructive and privileged commands require an explicit approval flag and non-required approvals cannot carry approval request IDs.
  • Extended fixtures with a read-only Blender scene query command and a privileged desktop input command that is approval-gated and policy-blocked by later stages.

Verification closure:

  • pnpm nx build @bellona/remote-protocol passes.
  • pnpm nx typecheck @bellona/remote-protocol passes.
  • pnpm nx lint @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol passes.

180.C.03.05 Command Result, Progress, Error, Warning, Retry, and Idempotency Schemas#

Implementation date: 2026-04-21

Files changed:

  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/src/result.ts
  • libs/bellona/remote-protocol/src/result.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/index.test.ts

Existing implementation patterns analyzed:

  • libs/bellona/bridge-core/src/index.ts for the existing success/error response envelope precedent.
  • services/psyche/tool-framework/src/tool_framework/router/types.py and router.py for retry strategy, retry config, retryable errors, and attempt handling patterns.
  • services/psyche/api-gateway/src/api_gateway/services/webhooks.py for exponential backoff, retry status, retry scheduling, idempotency/dedupe, and delivery-result vocabulary.
  • services/psyche/tavus-integration/src/tavus_integration/api/client.py and api/webhooks.py for retry-after, rate-limit retry, progress, and handler result patterns.

Implementation summary:

  • Added Zod-backed runtime schemas and inferred TypeScript types for RemoteCommandResult, RemoteCommandProgress, RemoteErrorCode, RemoteWarning, retry strategy metadata, and idempotency status metadata.
  • Added structured warning objects with severity, timestamp, and JSON details.
  • Added retry metadata with attempt/max-attempt validation and a guard against scheduling retries for non-retryable outcomes.
  • Added progress validation for queued, accepted, running, approval-waiting, retrying, cancelling, completed, failed, cancelled, and timed-out states, including a completed-percent invariant.
  • Added result validation so succeeded results cannot contain errors, while failed, timed-out, and denied results must contain a typed error code.
  • Extended fixtures with Blender scene-query progress/result data and an approval-required desktop input denial result.

Verification closure:

  • pnpm nx build @bellona/remote-protocol passes.
  • pnpm nx typecheck @bellona/remote-protocol passes.
  • pnpm nx lint @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol passes.

180.C.03.06 Audit, Evidence, Artifact, Approval Request, and Approval Decision Schemas#

Implementation date: 2026-04-21

Files changed:

  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/src/audit.ts
  • libs/bellona/remote-protocol/src/audit.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/index.test.ts

Existing implementation patterns analyzed:

  • libs/oshun/analytics/src/types.ts for Studio audit event naming and approval-flow telemetry precedents.
  • services/psyche/computer-use/src/computer_use/agent/loop.py for human approval timeout, approval memory, and approval-denial behavior.
  • services/psyche/computer-use/src/computer_use/benchmark/types.py and runner.py for artifact directory/report output patterns.
  • Remote-control ADRs and compatibility notes for evidence hashes, artifact registration, durable audit, approval signer/timestamp, and replay-resistant audit records.

Implementation summary:

  • Added Zod-backed runtime schemas and inferred TypeScript types for RemoteAuditEntry, RemoteAuditEvidence, RemoteArtifact, RemoteApprovalRequest, and RemoteApprovalDecision.
  • Added artifact kind/redaction-status enums, SHA-256 hash validation, and artifact metadata for command/session/device binding.
  • Added evidence records for command envelopes, command results, screenshots, videos, logs, artifacts, approvals, policy decisions, and host state.
  • Added approval request validation for risk class, required permission scopes, evidence IDs, requested/expiry timestamps, and expiry-after-request ordering.
  • Added approval decision validation that requires denied decisions to include a reason.
  • Added audit entry validation with entry hashes, previous hashes for non-initial entries, evidence IDs, artifact IDs, actor, device, command, and session references.

Verification closure:

  • pnpm nx build @bellona/remote-protocol passes.
  • pnpm nx typecheck @bellona/remote-protocol passes.
  • pnpm nx lint @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol passes.

180.C.03.07 Stream Descriptor, Source, State, and WebRTC Signaling Schemas#

Implementation date: 2026-04-21

Files changed:

  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/src/stream.ts
  • libs/bellona/remote-protocol/src/stream.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/index.test.ts

Existing implementation patterns analyzed:

  • docs/domains/bellona/extras/remote-control/external-implementation-research-2026-04-21.md for gateway-authorized WebRTC signaling, ICE candidate exchange, same-LAN direct paths as optimizations, TURN as a cross-NAT/cloud requirement, and the requirement that command/control delivery remains independent from media.
  • docs/domains/bellona/extras/remote-control/compatibility-matrix.md for WebRTC media/data, same-LAN, cloud gateway, and offline-fixture compatibility boundaries.
  • docs/domains/bellona/extras/remote-control/adr/ADR-0002-remote-control-threat-model.md for WebRTC media trust boundaries, local-network attacker controls, replay controls, and degraded-state requirements.
  • services/psyche/computer-use/src/computer_use/screen_sharing/types.py and streaming.py for screen-share quality, bitrate, jitter, RTT, packet-loss, NACK/FEC, and WebRTC streaming-stat vocabulary.
  • services/psyche/orchestrator/src/orchestrator/pipeline/types.py and communication.py for stream type, quality, bidirectional stream, latency, and stream identifier precedents.

Implementation summary:

  • Added Zod-backed runtime schemas and inferred TypeScript types for RemoteStreamDescriptor, RemoteStreamSource, RemoteStreamState, WebRTC SDP, ICE candidate, ICE server reference, health, quality, media kind, source kind, and signaling metadata contracts.
  • Added stream-source validation for source kind, media kinds, permission scopes, content hints, redaction requirements, adapter/surface references, and required capture dimensions for desktop-region sources.
  • Added signaling validation for offer/answer SDP payloads, ICE candidate payloads, timestamp expiry ordering, duplicate signaling sequence detection, same-session/same-stream binding, and teardown/renegotiation payload limits.
  • Added TURN/cloud safeguards so cloud signaling requires TURN compatibility and TURN-required signaling must use relay ICE transport policy.
  • Added stream-descriptor validation for same-device source binding, active and terminal timestamp invariants, bitrate range ordering, stream health stats, codec preferences, dimensions, and ordered signaling metadata.
  • Extended fixtures with a Blender viewport stream descriptor backed by the existing Studio MacBook Air, Blender viewport surface, fake WebRTC offer, answer, ICE candidate, and deterministic stream-health metadata.

Verification closure:

  • pnpm nx build @bellona/remote-protocol passes.
  • pnpm nx typecheck @bellona/remote-protocol passes.
  • pnpm nx lint @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol passes.

180.C.03.08 Command Namespace Constants#

Implementation date: 2026-04-21

Files changed:

  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/src/namespaces.ts
  • libs/bellona/remote-protocol/src/namespaces.test.ts
  • libs/bellona/remote-protocol/src/device.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/index.test.ts

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/device.ts for the existing RemoteCapabilityNamespaceSchema enum and command-name regex that requires dotted lowercase names.
  • libs/bellona/remote-protocol/src/command.ts for target validation requiring command names to start with their declared namespace.
  • libs/bellona/remote-protocol/src/fixtures.ts for existing blender.scene.query and desktop.input.perform command fixtures.
  • TODOS/phase-180.md later-stage command inventory for canonical future command names including device.list, session.start, session.stop, stream.*, blender.scene.info, blender.object.create_primitive, browser.navigate, browser.snapshot, desktop.screenshot, unreal.project.info, and unreal.world.query.
  • The Phase 180 audit notes for legacy Bellona bridge command namespace mismatches (blender:* / unreal:* vs. dot-command names) and the decision to keep Phase 180 command names dotted and protocol-owned.

Implementation summary:

  • Added REMOTE_COMMAND_NAMESPACE constants for device, session, stream, blender, unreal, browser, desktop, file, process, approval, and diagnostic.
  • Added ordered REMOTE_COMMAND_NAMESPACE_VALUES and wildcard REMOTE_COMMAND_NAMESPACE_PATTERN / REMOTE_COMMAND_NAMESPACE_PATTERNS constants for device.*, session.*, stream.*, blender.*, unreal.*, browser.*, desktop.*, file.*, process.*, approval.*, and diagnostic.*.
  • Added RemoteCommandNamespace and RemoteCommandNamespacePattern types plus helpers for namespace recognition, namespace extraction, and command-name membership checks.
  • Wired RemoteCapabilityNamespaceSchema to the exported namespace constants so capability schemas and command-target validation share one namespace source of truth.
  • Added schema tests proving constants are complete, wildcard patterns match, schema options are sourced from the constants, unsupported prefixes are rejected, and each namespace can validate a matching command target.

Verification closure:

  • pnpm nx build @bellona/remote-protocol passes.
  • pnpm nx typecheck @bellona/remote-protocol passes.
  • pnpm nx lint @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol passes.

180.C.03.09 Generated Contract Artifacts and Drift Check#

Implementation date: 2026-04-21

Files changed:

  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/package.json
  • libs/bellona/remote-protocol/project.json
  • libs/bellona/remote-protocol/tsconfig.lib.json
  • libs/bellona/remote-protocol/scripts/generate-contract-artifacts.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/index.test.ts
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json

Existing implementation patterns analyzed:

  • Root contract scripts in package.json for existing OpenAPI, proto, schema, and combined contract drift gates.
  • docs/reference/api-contracts.md for the repo pattern of checking generated OpenAPI, proto, and JSON Schema artifacts into source control and failing review/CI when generated contracts drift.
  • scripts/isis/generate_generation_api_openapi.mjs and related Isis contract check scripts for deterministic generate/check command split.
  • The current @bellona/remote-protocol Zod schema files and package Nx targets for build, lint, typecheck, and test integration.
  • Installed Zod 4 JSON Schema conversion support, avoiding a new dependency for this protocol package.

Implementation summary:

  • Added REMOTE_PROTOCOL_SCHEMA_REGISTRY as the single enumerable list of current protocol Zod schemas, grouped by common, device, session, command, result, audit, and stream areas.
  • Added registry tests proving schema names/exports are unique, all current areas are represented, top-level protocol contracts are present, and every registered schema can convert to JSON Schema.
  • Added a deterministic artifact generator that emits a JSON Schema bundle, OpenAPI 3.1 component bundle, and proto-ready manifest with package version, schema status, namespace constants, schema refs, source exports, and protocol areas.
  • Added Nx targets contracts:generate and contracts:check; check mode fails if any generated artifact is missing or differs from generator output.
  • Added generated contract artifacts to package files and build assets so the package can carry the machine-readable contracts downstream.

Verification closure:

  • pnpm nx contracts:generate @bellona/remote-protocol passes.
  • pnpm nx contracts:check @bellona/remote-protocol passes.
  • pnpm nx build @bellona/remote-protocol passes.
  • pnpm nx typecheck @bellona/remote-protocol passes.
  • pnpm nx lint @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol passes.

180.C.03.10 Protocol Version Negotiation#

Implementation date: 2026-04-21

Files changed:

  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/src/version.ts
  • libs/bellona/remote-protocol/src/version.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/index.test.ts
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/common.ts for strict MAJOR.MINOR.PATCH protocol version syntax.
  • libs/bellona/remote-protocol/src/device.ts for existing host runtime and protocol-version metadata on RemoteDevice.
  • libs/bellona/bridge-core/src/index.ts for the current WebSocket handshake metadata pattern with connection client type and client version.
  • docs/domains/bellona/extras/remote-control/compatibility-matrix.md for the requirement that gateway/host handshakes reject unsupported major protocol versions and report degraded candidate support.
  • docs/domains/bellona/extras/remote-control/adr/ADR-0002-remote-control-threat-model.md for handshake identity, replay, and downgrade-risk controls.

Implementation summary:

  • Added protocol peer, compatibility policy, compatibility rule, deprecation policy, and version negotiation schemas.
  • Added deterministic version comparison and selection helpers that pick the highest shared supported host/gateway protocol version.
  • Enforced minimum host and gateway runtime/protocol version checks, rejected unsupported protocol candidates, and required explicit compatibility rules for downgrades.
  • Added deprecation-policy validation for sunset dates and replacement versions, and required deprecated selected versions to be surfaced as accepted-with-deprecation or degraded.
  • Added fixtures and schema tests for old-host/new-gateway and new-host/old-gateway behavior, both downgrading to the transitional deprecated 0.1.0 protocol.
  • Registered the version schemas in generated JSON Schema/OpenAPI/proto-ready artifacts so contract drift catches future negotiation changes.

Verification closure:

  • pnpm nx contracts:generate @bellona/remote-protocol passes.
  • pnpm nx contracts:check @bellona/remote-protocol passes.
  • pnpm nx build @bellona/remote-protocol passes.
  • pnpm nx typecheck @bellona/remote-protocol passes.
  • pnpm nx lint @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol passes.

180.C.03.11 Remote Protocol Stage Closure#

Implementation date: 2026-04-21

Files changed:

  • libs/bellona/remote-protocol/README.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/project.json for the package build, typecheck, lint, test, contract generation, and contract drift-check targets.
  • libs/bellona/remote-protocol/package.json for the published package surface, generated contract artifact inclusion, and dependency boundary.
  • libs/bellona/remote-protocol/README.md for schema ownership language and downstream import guardrails.
  • Prior 180.C.03.01 through 180.C.03.10 tracker entries for the completed schema slices and verification evidence.

Implementation summary:

  • Updated the protocol package README with an explicit 180.C.03.11 closure note naming the package as the owner of all protocol schemas introduced in 180.C.03.
  • Recorded the closure verification commands for generated contract drift, build, typecheck, lint, and unit/schema tests.
  • Marked 180.C.03.11 complete in the phase TODO and progress table after the protocol verification suite passed.

Verification closure:

  • pnpm nx contracts:generate @bellona/remote-protocol passes.
  • pnpm nx contracts:check @bellona/remote-protocol passes.
  • pnpm nx build @bellona/remote-protocol passes.
  • pnpm nx typecheck @bellona/remote-protocol passes.
  • pnpm nx lint @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol passes.

180.C.03.12 Structured Error Remediation#

Implementation date: 2026-04-22

Files changed:

  • libs/bellona/remote-protocol/src/result.ts
  • libs/bellona/remote-protocol/src/result.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/README.md
  • apps/bellona/remote-host/src/command-executor.ts
  • apps/bellona/remote-host/src/policy-preflight.ts
  • apps/bellona/remote-host/src/gateway-connection.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • testing/bellona/remote-control/fixtures.ts
  • testing/bellona/remote-control/fake-gateway-transport.ts
  • testing/bellona/remote-control/fake-host-adapter.ts
  • testing/bellona/remote-control/tests/audit-emission-paths.test.ts
  • testing/bellona/remote-control/tests/command-negative-paths.test.ts
  • testing/bellona/remote-control/tests/fake-host-adapter.test.ts
  • generated protocol contract artifacts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/result.ts for the existing error code, result, progress, retry, and idempotency schema boundary.
  • apps/bellona/remote-host/src/command-executor.ts, apps/bellona/remote-host/src/policy-preflight.ts, and apps/bellona/remote-host/src/gateway-connection.ts for production host error creation paths.
  • testing/bellona/remote-control/fake-gateway-transport.ts, testing/bellona/remote-control/fake-host-adapter.ts, and the remote-control test fixtures for in-memory gateway, host, policy, approval, timeout, cancellation, and audit error paths.
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts for gateway command-error and failed-result contract assertions.

Implementation summary:

  • Added required RemoteCommandErrorRemediation data to every RemoteCommandError, including human remediation text, an optional machine-parseable suggested next command template, and an autoRetrySafe boolean.
  • Added RemoteSuggestedNextCommandTemplate, createRemoteCommandError(), and createRemoteCommandErrorRemediation() so downstream code can populate conservative remediation defaults from a single protocol helper.
  • Updated host, gateway test, and remote-control testing harness error paths to emit schema-valid remediation on command cancellation, timeout, policy deny, adapter unavailable, internal failure, host offline, approval, and validation paths.
  • Regenerated JSON Schema and OpenAPI protocol contract artifacts so contract drift checks enforce the new error shape.

Verification closure:

  • pnpm nx contracts:generate @bellona/remote-protocol passes.
  • pnpm nx contracts:check @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol --verbose passes.
  • pnpm nx typecheck @bellona/remote-protocol --verbose passes.
  • pnpm nx lint @bellona/remote-protocol --verbose passes.
  • pnpm nx build @bellona/remote-protocol --skip-nx-cache --verbose passes.
  • pnpm nx test @bellona/remote-host --verbose passes.
  • pnpm nx typecheck @bellona/remote-host --verbose passes.
  • pnpm nx lint @bellona/remote-host --verbose passes.
  • pnpm nx build @bellona/remote-host --skip-nx-cache --verbose passes.
  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • pnpm nx typecheck @bellona/remote-gateway --verbose passes.
  • pnpm nx lint @bellona/remote-gateway --verbose passes.
  • pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose passes.
  • pnpm nx test @bellona/remote-control-testing --verbose passes.
  • pnpm nx typecheck @bellona/remote-control-testing --verbose passes.
  • pnpm nx lint @bellona/remote-control-testing --verbose passes.
  • pnpm nx build @bellona/remote-control-testing --skip-nx-cache --verbose passes.
  • pnpm exec prettier --check ... passes for touched source, generated contract, README, tracker, and TODO files.
  • git diff --check passes.

180.C.03.13 Remote Actor Delegation Chains#

Implementation date: 2026-04-22

Files changed:

  • libs/bellona/remote-protocol/src/actor.ts
  • libs/bellona/remote-protocol/src/actor.test.ts
  • libs/bellona/remote-protocol/src/command.ts
  • libs/bellona/remote-protocol/src/command.test.ts
  • libs/bellona/remote-protocol/src/audit.ts
  • libs/bellona/remote-protocol/src/audit.test.ts
  • libs/bellona/remote-protocol/src/session.ts
  • libs/bellona/remote-protocol/src/session.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • apps/bellona/remote-gateway/src/audit-log.ts
  • apps/bellona/remote-gateway/src/approval-service.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • apps/bellona/remote-gateway/src/persistent-store.ts
  • apps/bellona/remote-gateway/src/session-lifecycle.ts
  • testing/bellona/remote-control/fake-gateway-transport.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • RemoteParticipant.actorId, RemoteCommandEnvelope.issuedByParticipantId, RemoteAuditEntry.actorParticipantId, RemoteApprovalRequest, and RemoteSessionLifecycleEvent for the participant-only attribution model.
  • Gateway audit, approval, command-dispatch, persistent-store, and session-lifecycle emitters for all production paths that materialize those protocol records.
  • Remote-control fake gateway audit emission for the in-memory command, policy, approval, timeout, cancellation, and disconnect test paths.

Implementation summary:

  • Added RemoteActor, RemoteActorKind, and RemoteActorChain schemas with stable actor IDs, ordered delegation validation, duplicate actor/stable-ID rejection, and adapter actor validation.
  • Threaded required actor chains through RemoteCommandEnvelope, RemoteApprovalRequest, RemoteAuditEntry, and RemoteSessionLifecycleEvent.
  • Added protocol fixtures modeling a full human operator to orchestrator agent to specialist agent to adapter chain, plus focused chain fixtures for operator-only and operator-to-agent flows.
  • Updated gateway audit, approval, command-dispatch, persistent-store, and session-lifecycle code to preserve or derive actor chains when emitting protocol records.
  • Updated the fake gateway transport so in-memory audit paths emit schema-valid actor chains.

Verification closure:

  • pnpm nx contracts:generate @bellona/remote-protocol passes.
  • pnpm nx contracts:check @bellona/remote-protocol passes.
  • pnpm nx test @bellona/remote-protocol --verbose passes.
  • pnpm nx typecheck @bellona/remote-protocol --verbose passes.
  • pnpm nx lint @bellona/remote-protocol --verbose passes.
  • pnpm nx build @bellona/remote-protocol --skip-nx-cache --verbose passes.
  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • pnpm nx typecheck @bellona/remote-gateway --verbose passes.
  • pnpm nx lint @bellona/remote-gateway --verbose passes.
  • pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose passes.
  • pnpm nx test @bellona/remote-control-testing --verbose passes.
  • pnpm nx typecheck @bellona/remote-control-testing --verbose passes.
  • pnpm nx lint @bellona/remote-control-testing --verbose passes.
  • pnpm nx build @bellona/remote-control-testing --skip-nx-cache --verbose passes.
  • pnpm exec prettier --check ... passes for touched source, generated contract, README, tracker, and TODO files.
  • git diff --check passes.

180.C.03.14 Command Rollback Strategy Metadata#

Implementation date: 2026-04-22

Files changed:

  • libs/bellona/remote-protocol/src/command.ts
  • libs/bellona/remote-protocol/src/command.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/policy.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • apps/bellona/remote-gateway/src/approval-service.test.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.ts
  • testing/bellona/remote-control/fixtures.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • RemoteCommandEnvelope risk-class validation, approval gating, timeout limits, metadata defaults, and target namespace validation.
  • RemoteProtocolMetadata value constraints to keep rollback metadata compatible with the existing primitive command metadata model.
  • getRemoteCommandRequiredPermissionScopes() and policy tests that parse command envelopes before scope inference.
  • Remote protocol fixture and schema-registry generation patterns used by the generated JSON Schema, OpenAPI, and proto-ready manifest artifacts.

Implementation summary:

  • Added RemoteRollbackStrategy with undo_stack, snapshot_restore, compensating_action, and manual_remediation_only.
  • Added RemoteCommandMetadata so metadata.rollbackStrategy, when present, must match the rollback strategy enum while preserving generic metadata extension values.
  • Updated RemoteCommandEnvelope validation so safe-mutation, destructive, and privileged commands must declare metadata.rollbackStrategy.
  • Updated mutating protocol fixtures and policy tests to carry rollback metadata before validation.
  • Updated the remote-control command fixture factory so synthesized mutating test commands carry rollback metadata by default.
  • Regenerated protocol contract artifacts and documented the rollback metadata requirement in the remote-protocol README.

Verification closure:

  • pnpm nx contracts:generate @bellona/remote-protocol passes.
  • pnpm nx contracts:check @bellona/remote-protocol passes.
  • pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway,@bellona/remote-control-testing -t test,typecheck,lint,build --verbose passes.
  • pnpm exec prettier --check ... passes for touched source, generated contract, README, tracker, and TODO files.
  • git diff --check passes.

180.C.03.15 Agent Readiness and Dynamic State Snapshot Commands#

Implementation date: 2026-04-22

Files changed:

  • libs/bellona/remote-protocol/src/state.ts
  • libs/bellona/remote-protocol/src/state.test.ts
  • libs/bellona/remote-protocol/src/namespaces.ts
  • libs/bellona/remote-protocol/src/namespaces.test.ts
  • libs/bellona/remote-protocol/src/device.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • RemoteCommandEnvelope, RemoteCommandTarget, namespace validation, command argument defaults, and read-only risk-class behavior.
  • Static RemoteCapability reports and fixture device graphs so dynamic readiness commands are advertised alongside existing capability reports.
  • RemoteCommandResult.output and result fixtures, which intentionally carry generic JSON-shaped output while command-specific schemas validate nested payloads.
  • Existing gateway readiness, device-registry snapshots, remote-control snapshot fixtures, and Bellona agent scene/readiness patterns for fields that agents need before deciding whether to act.

Implementation summary:

  • Added agent.* and state.* command namespaces required by agent.readiness and state.snapshot.
  • Added read-only RemoteAgentReadinessCommandName, RemoteStateSnapshotCommandName, command argument schemas, and typed output schemas for RemoteAgentReadiness and RemoteStateSnapshot.
  • Modeled modal dialogs, shader compile counts, project-root read-only policy, running jobs, disk pressure, and memory pressure with strict schemas and invariant tests.
  • Advertised agent.readiness and state.snapshot through protocol fixture capabilities and added command/result fixtures that parse through both the generic result schema and the command-specific output schemas.
  • Registered all new schemas for JSON Schema, OpenAPI, and proto-ready contract generation.

Verification closure:

  • pnpm nx contracts:generate @bellona/remote-protocol passes.
  • pnpm nx contracts:check @bellona/remote-protocol passes.
  • pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway,@bellona/remote-control-testing -t test,typecheck,lint,build --verbose passes.
  • pnpm exec prettier --check ... passes for touched source, generated contract, README, tracker, and TODO files.
  • git diff --check passes.

180.C.03.16 Dry-Run Plan Schema and High-Risk Support#

Implementation date: 2026-04-22

Files changed:

  • libs/bellona/remote-protocol/src/dry-run.ts
  • libs/bellona/remote-protocol/src/dry-run.test.ts
  • libs/bellona/remote-protocol/src/command.ts
  • libs/bellona/remote-protocol/src/command.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/policy.ts
  • libs/bellona/remote-protocol/src/policy.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • testing/bellona/remote-control/fixtures.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • RemoteCommandEnvelope metadata validation, risk-class gating, approval requirements, and mutating-command rollback strategy checks.
  • The 180.C.07.06 policy evaluator's inferred high-risk permission scopes: project/file writes, desktop input, real browser profiles, arbitrary code, shell execution, publishing, financial actions, destructive execution, and privileged command classes.
  • Blender and Unity transaction-layer dry-run behavior, including preview-only execution, preflight context, permission results, warnings, undo/snapshot context, and the guarantee that dry-runs do not dispatch mutating RPC calls.
  • Schema-registry and generated-contract patterns used by prior remote-protocol slices so JSON Schema, OpenAPI, and proto-ready manifests remain the exported contract surface.

Implementation summary:

  • Added RemoteDryRunPlan with strict sub-schemas for predicted changes, cost estimates, time estimates, reversibility assessments, impact summaries, assumptions, warnings, generation timestamps, expiration, and required high-risk classes.
  • Added RemoteDryRunRequiredRiskClass values covering destructive, privileged, project_write, file_write, desktop_control, real_browser_profile, arbitrary_code, shell, publishing, and financial.
  • Extended command metadata with dryRunSupported and dryRunPlanId, and made destructive and privileged command envelopes reject when either dry-run support marker is missing.
  • Extended the policy evaluator with getRemoteCommandDryRunRequirement() and RemoteCommandPolicyEvaluation.dryRunRequired / dryRunRequiredRiskClasses, denying high-risk commands that do not advertise dry-run support.
  • Updated remote-gateway policy-denial and approval test paths so hand-built policy evaluations include dry-run requirement metadata and fail-closed errors are not masked by schema parsing.
  • Added desktop-input dry-run fixtures and updated remote-control command fixture generation so synthesized destructive/privileged test commands include dry-run support metadata by default.
  • Registered all dry-run schemas for generated JSON Schema, OpenAPI, and proto-ready contract output.

Verification closure:

  • pnpm nx contracts:generate @bellona/remote-protocol passes.
  • pnpm nx contracts:check @bellona/remote-protocol passes.
  • pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway,@bellona/remote-control-testing -t test,typecheck,lint,build --verbose passes.
  • pnpm exec prettier --check ... passes for touched source, generated contract, README, tracker, and TODO files.
  • git diff --check passes.

180.C.04.01 Mock Harness Scaffolding#

Implementation date: 2026-04-21

Files changed:

  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/fixtures.ts
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/mocks.ts
  • testing/bellona/remote-control/package.json
  • testing/bellona/remote-control/project.json
  • testing/bellona/remote-control/tests/mock-harness.test.ts
  • testing/bellona/remote-control/tsconfig.json
  • testing/bellona/remote-control/tsconfig.lib.json
  • testing/bellona/remote-control/vitest.config.ts
  • testing/tsconfig.json
  • tsconfig.base.json
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • testing/project.json, testing/package.json, testing/tsconfig.json, and testing/fixtures/index.ts for the existing shared testing package shape and scope tags.
  • libs/shared/testing/src/fixtures/index.ts and libs/aphrodite/testing/src/fixtures/index.ts for local fixture factory conventions.
  • libs/aphrodite/testing/project.json and libs/aphrodite/testing/src/index.ts for domain-specific testing library project layout.
  • libs/bellona/remote-protocol/src/device.ts, libs/bellona/remote-protocol/src/command.ts, libs/bellona/remote-protocol/src/audit.ts, and libs/bellona/remote-protocol/src/fixtures.ts for canonical schema imports and cross-reference-safe fixture values.
  • The 180.C.04.01 task scope in TODOS/phase-180.md and prior 180.C.03 tracker entries to keep the harness limited to mock utilities, not real gateway, host, MCP, adapter, desktop, browser, Blender, Unreal, or WebRTC behavior.

Implementation summary:

  • Created @bellona/remote-control-testing as a Bellona-scoped Nx test library under testing/bellona/remote-control.
  • Added protocol-valid fixture factories for mock remote adapters, capabilities, permissions, devices, command envelopes, and audit entries.
  • Added in-memory mock adapter, device, host, and gateway utilities that model capability reports, command support checks, connect/disconnect lifecycle events, device listing, and command/audit fixture creation without opening network sockets or invoking privileged local surfaces.
  • Added focused Vitest coverage proving the fixture factories validate against @bellona/remote-protocol schemas, preserve device/adapter/capability references, clone lifecycle events, and allow the gateway mock to register/list/unregister hosts.
  • Kept the root @oshun/testing-infra package shared-scope clean by excluding the Bellona-specific nested project from its TypeScript include set.

Verification closure:

  • pnpm nx show project @bellona/remote-control-testing passes.
  • pnpm nx build @bellona/remote-control-testing passes.
  • pnpm nx typecheck @bellona/remote-control-testing passes.
  • pnpm nx lint @bellona/remote-control-testing passes.
  • pnpm nx test @bellona/remote-control-testing passes.
  • pnpm nx build @oshun/testing-infra passes.
  • pnpm nx lint @oshun/testing-infra passes with existing warnings unrelated to this Bellona harness.

180.C.04.02 Fake Host Adapter#

Implementation date: 2026-04-21

Files changed:

  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/fake-host-adapter.ts
  • testing/bellona/remote-control/fixtures.ts
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/tests/fake-host-adapter.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • testing/bellona/remote-control/mocks.ts for the existing mock adapter, device, host, and gateway factory style introduced in 180.C.04.01.
  • testing/bellona/remote-control/tests/mock-harness.test.ts for schema-backed harness test conventions.
  • libs/bellona/remote-protocol/src/command.ts for command envelope target, idempotency key, timeout, risk, and approval validation rules.
  • libs/bellona/remote-protocol/src/result.ts and libs/bellona/remote-protocol/src/fixtures.ts for progress/result statuses, error requirements, warning/retry fields, and canonical fixture values.
  • libs/bellona/bridge-core/src/index.ts and existing Bellona bridge apps for connection/disconnection lifecycle precedents without copying their WebSocket/network behavior into this in-memory harness.

Implementation summary:

  • Added FakeHostAdapter, a protocol-backed in-memory host-side adapter that can register one or more capabilities, report capabilities, receive commands, track received command history, emit progress events, return success/failure RemoteCommandResult values, and disconnect/reconnect without network or privileged surface access.
  • Added command handler injection so tests can force success, failure, custom output, custom progress steps, warnings, errors, durations, and metadata while still validating all emitted progress and result objects through @bellona/remote-protocol.
  • Added failure paths for unsupported commands and disconnected adapters using canonical adapter.unavailable and adapter.offline error codes.
  • Added createRemoteControlProgressFixture and createRemoteControlResultFixture helpers so future gateway, host, adapter, MCP, policy, timeout, cancellation, and audit tests can produce protocol-valid progress/result values without duplicating schema boilerplate.
  • Added focused Vitest coverage for capability registration, successful command execution, custom handler failure, unsupported commands, disconnect behavior, progress schema validation, and result schema validation.

Verification closure:

  • pnpm nx build @bellona/remote-control-testing passes.
  • pnpm nx typecheck @bellona/remote-control-testing passes.
  • pnpm nx lint @bellona/remote-control-testing passes.
  • pnpm nx test @bellona/remote-control-testing passes.

180.C.04.03 Fake Gateway Transport#

Implementation date: 2026-04-21

Files changed:

  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/fake-gateway-transport.ts
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/tests/fake-gateway-transport.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • testing/bellona/remote-control/fake-host-adapter.ts for the host-side fake adapter command receipt, progress, result, and disconnect behavior added in 180.C.04.02.
  • testing/bellona/remote-control/mocks.ts for the lighter MockRemoteGateway host registration and device-listing precedent.
  • libs/bellona/bridge-core/src/index.ts for connection/disconnection event naming, pending request cleanup, and command dispatch flow, while preserving this harness as network-free.
  • libs/bellona/remote-protocol/src/command.ts, libs/bellona/remote-protocol/src/device.ts, and libs/bellona/remote-protocol/src/result.ts for canonical command routing, device report, and result/error schemas.

Implementation summary:

  • Added FakeGatewayTransport, an in-memory gateway transport that accepts outbound host connections by composing FakeHostAdapter capability reports into protocol-valid online RemoteDevice snapshots.
  • Added network-free command dispatch from gateway to the selected fake host adapter, including command dispatch records, progress-event aggregation, and command completion/failure events.
  • Added gateway-level transport failure results for missing/offline hosts and unavailable adapters using canonical host.offline and adapter.unavailable error codes.
  • Added host disconnect handling that marks the connection/device offline and disconnects all attached fake adapters.
  • Added focused Vitest coverage for outbound host connection acceptance, connected device listing, successful command dispatch, progress aggregation, adapter-unavailable failures, and host-offline failures.

Verification closure:

  • pnpm nx build @bellona/remote-control-testing passes.
  • pnpm nx typecheck @bellona/remote-control-testing passes.
  • pnpm nx lint @bellona/remote-control-testing passes.
  • pnpm nx test @bellona/remote-control-testing passes.

180.C.04.04 Fake MCP Client Transport#

Implementation date: 2026-04-21

Files changed:

  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/fake-mcp-client-transport.ts
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/tests/fake-mcp-client-transport.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/iris/mcp/src/types.ts and libs/iris/mcp/src/mcp-client.ts for MCP-shaped tool definitions, tools/list, tools/call, connection state, and client call-result conventions.
  • libs/iris/memory/tools/src/tool-executor.ts for the local formatToolsForMCP output shape of { name, description, inputSchema }.
  • services/psyche/tool-framework/README.md for the in-repo convention that MCP endpoints expose tools/list and tools/call.
  • testing/bellona/remote-control/fake-gateway-transport.ts for the gateway mock API that the fake MCP client must call without adding network dependencies.

Implementation summary:

  • Added FakeMcpClientTransport, a local MCP-shaped client transport with explicit connect/disconnect state, listTools, callTool, callCommandTool, and call-history inspection.
  • Exposed a generic remote.command.dispatch tool for full RemoteCommandEnvelope dispatch through FakeGatewayTransport.
  • Exposed dynamic remote.command.<commandName> tools for connected fake gateway device capabilities, with MCP-style input schemas and annotations for read-only/dangerous capability hints.
  • Added MCP-shaped text results with structured content for command results and deterministic error payloads for unknown tools, invalid arguments, and execution errors.
  • Added focused Vitest coverage for tool listing, dynamic command tool calls, generic command dispatch, unknown/invalid tool errors, disconnected-client behavior, gateway dispatch history, and fake adapter command receipt.

Verification closure:

  • pnpm nx build @bellona/remote-control-testing passes.
  • pnpm nx typecheck @bellona/remote-control-testing passes.
  • pnpm nx lint @bellona/remote-control-testing passes.
  • pnpm nx test @bellona/remote-control-testing passes.

180.C.04.05 Command Negative Paths#

Implementation date: 2026-04-21

Files changed:

  • testing/bellona/remote-control/fake-gateway-transport.ts
  • testing/bellona/remote-control/tests/command-negative-paths.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/command.ts and libs/bellona/remote-protocol/src/result.ts for validation failure, timeout, cancellation, duplicate idempotency, and host-offline error codes and result status requirements.
  • testing/bellona/remote-control/fake-host-adapter.ts for handler-injected progress/result behavior and adapter disconnect failure behavior.
  • testing/bellona/remote-control/fake-gateway-transport.ts for gateway dispatch records, host disconnect, command failure events, and gateway-level transport failure results.
  • libs/bellona/bridge-core/src/index.ts for existing timeout and pending request cleanup precedents.

Implementation summary:

  • Added dispatchCommandInput to FakeGatewayTransport so tests can submit unknown/raw command payloads and receive protocol-valid validation.failed command results instead of runtime throws.
  • Added fake gateway idempotency tracking so duplicate idempotency keys return a protocol-valid duplicate-idempotency-key failure without dispatching to the host adapter a second time.
  • Added focused negative-path tests for command validation failure, command timeout, command cancellation, duplicate idempotency key, and host disconnect.
  • Verified timeout and cancellation tests produce canonical progress statuses and RemoteCommandResult schema-valid outputs.
  • Verified host disconnect returns host.offline from the gateway and does not call the disconnected adapter.

Verification closure:

  • pnpm nx build @bellona/remote-control-testing passes.
  • pnpm nx typecheck @bellona/remote-control-testing passes.
  • pnpm nx lint @bellona/remote-control-testing passes.
  • pnpm nx test @bellona/remote-control-testing passes.

180.C.04.06 Policy and Approval Paths#

Implementation date: 2026-04-21

Files changed:

  • testing/bellona/remote-control/fake-gateway-transport.ts
  • testing/bellona/remote-control/tests/policy-approval-paths.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/audit.ts for approval request and decision schemas, audit event naming, and approval state vocabulary.
  • libs/bellona/remote-protocol/src/device.ts for policy decision and device permission scope schema patterns.
  • libs/bellona/remote-protocol/src/command.ts for privileged command approval requirements and risk-class metadata.
  • libs/bellona/remote-protocol/src/result.ts for canonical denied, timed-out, failed, and succeeded result statuses.
  • libs/bellona/remote-protocol/src/fixtures.ts for protocol-valid approval request, approval decision, command, progress, and result fixtures.
  • testing/bellona/remote-control/fake-gateway-transport.ts for existing dispatch, idempotency, transport failure, and event capture behavior.

Implementation summary:

  • Added an explicit gateway policy hook that can simulate allowed, denied, approval-required, approval-granted, approval-denied, and approval-timeout paths without network or UI dependencies.
  • Added policy and approval event types so tests can assert allowed decisions, denied decisions, approval requests, and approval decisions from the fake gateway event stream.
  • Ensured policy denials and unresolved or negative approvals block adapter dispatch before the host receives the command.
  • Ensured approval-granted commands continue through normal host dispatch and still leave approval request and approval decision evidence.
  • Added focused tests proving every policy and approval outcome produces a protocol-valid RemoteCommandResult.

Verification closure:

  • pnpm nx build @bellona/remote-control-testing passes.
  • pnpm nx typecheck @bellona/remote-control-testing passes.
  • pnpm nx lint @bellona/remote-control-testing passes.
  • pnpm nx test @bellona/remote-control-testing passes.

180.C.04.07 Audit Emission Paths#

Implementation date: 2026-04-21

Files changed:

  • testing/bellona/remote-control/fake-gateway-transport.ts
  • testing/bellona/remote-control/tests/audit-emission-paths.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/audit.ts for canonical audit entry types, required hash chaining, approval audit vocabulary, and session.ended semantics.
  • libs/bellona/remote-protocol/src/fixtures.ts and testing/bellona/remote-control/fixtures.ts for schema-valid audit fixture construction and previous-hash requirements.
  • testing/bellona/remote-control/fake-gateway-transport.ts for gateway event, dispatch, policy, approval, idempotency, and disconnect behavior.
  • testing/bellona/remote-control/fake-host-adapter.ts for success, failure, cancellation, timeout, and result-status simulation.
  • Existing negative-path and policy/approval tests for command outcome coverage and protocol-valid result assertions.

Implementation summary:

  • Added a protocol-valid audit log to the fake gateway with deterministic SHA-256 entry hashes and previous-hash chaining.
  • Exposed getAuditEntries() with optional audit-type filtering so contract tests can assert emitted audit entries without coupling to transport events.
  • Emitted command.received, command.dispatched, command.completed, command.failed, policy.denied, approval.requested, approval.decided, and session.ended audit entries from the gateway paths that already model command execution and host lifecycle behavior.
  • Added focused tests for audit emission on success, host failure, policy deny, approval grant, cancellation, timeout, and host disconnect.
  • Verified every emitted audit entry is schema-valid and that multi-entry logs preserve sequence numbers and hash linkage.

Verification closure:

  • pnpm nx build @bellona/remote-control-testing passes.
  • pnpm nx typecheck @bellona/remote-control-testing passes.
  • pnpm nx lint @bellona/remote-control-testing passes.
  • pnpm nx test @bellona/remote-control-testing passes.

180.C.04.08 Snapshot Fixtures#

Implementation date: 2026-04-21

Files changed:

  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/snapshot-fixtures.ts
  • testing/bellona/remote-control/tests/snapshot-fixtures.test.ts
  • testing/bellona/remote-control/tests/__snapshots__/snapshot-fixtures.test.ts.snap
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/fixtures.ts for canonical device, session, command result, and stream descriptor fixture data.
  • libs/bellona/remote-protocol/src/session.ts and libs/bellona/remote-protocol/src/stream.ts for lifecycle timeline and WebRTC stream descriptor schema constraints.
  • testing/bellona/remote-control/fixtures.ts for local fixture factory patterns and protocol schema validation.
  • testing/bellona/remote-control/mocks.ts and testing/bellona/remote-control/fake-host-adapter.ts for capability report shape and adapter/device report composition.
  • Existing repo snapshot tests using Vitest toMatchSnapshot() and checked-in __snapshots__ files.

Implementation summary:

  • Added an exported snapshot-fixtures.ts module with a single typed fixture set covering device capability reports, session timelines, Blender scene query output, browser page query output, and stream descriptors.
  • Reused canonical remote-protocol fixtures for protocol-owned device, session, lifecycle, and stream data, then wrapped Blender/browser query outputs as protocol-valid RemoteCommandResult fixtures.
  • Added schema validation tests for every protocol-backed fixture slice and a Vitest snapshot that freezes the complete downstream contract shape.
  • Exported createRemoteControlSnapshotFixtureSet() from the test harness index and documented it in the package README.

Verification closure:

  • pnpm nx build @bellona/remote-control-testing passes.
  • pnpm nx typecheck @bellona/remote-control-testing passes.
  • pnpm nx lint @bellona/remote-control-testing passes.
  • pnpm nx test @bellona/remote-control-testing passes.

180.C.04.09 Mock Harness Verification Commands#

Implementation date: 2026-04-21

Files changed:

  • package.json
  • testing/bellona/remote-control/README.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • .github/workflows/ci.yml for affected Nx lint, typecheck, build, format, and Bellona-domain unit test coverage.
  • package.json scripts for repo-level Nx verification command naming.
  • testing/bellona/remote-control/project.json for the mock harness build, typecheck, lint, and test targets already exposed to Nx.
  • testing/bellona/remote-control/README.md for existing package-local verification documentation.

Implementation summary:

  • Added pnpm bellona:remote-control:verify as the repo-level local gate for the remote-control mock harness.
  • Documented that the package is tagged scope:bellona, so the existing affected Nx CI jobs cover its build, typecheck, lint, and test targets when the harness or its protocol dependency changes.
  • Expanded the package README with the combined local verification command and retained the individual target commands for focused troubleshooting.

Verification closure:

  • pnpm bellona:remote-control:verify passes.

180.C.04.10 Mock Harness Stage Closure#

Implementation date: 2026-04-21

Files changed:

  • testing/bellona/remote-control/README.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • All prior Stage 180.C.04 tracker entries and TODO checkboxes to confirm the mock harness, fake host adapter, fake gateway transport, fake MCP client, negative-path tests, policy/approval tests, audit tests, snapshot fixtures, and verification command are complete before closing the stage.
  • testing/bellona/remote-control/index.ts and package README exports to confirm downstream gateway, host, MCP, and adapter tasks can import the reusable harness surfaces.
  • testing/bellona/remote-control/tests/* to confirm the reusable surfaces are covered by protocol-valid tests instead of only existing as untested helpers.

Implementation summary:

  • Closed the mock-harness stage after confirming every prior 180.C.04 item is checked and committed.
  • Added README reuse guidance for future gateway, host/adapter, MCP, and contract/snapshot test work.
  • Confirmed the harness exposes reusable fake transports, adapter helpers, protocol fixture factories, policy/approval hooks, audit emission, negative paths, snapshot fixtures, and a combined local verification gate.

Verification closure:

  • pnpm bellona:remote-control:verify passes.

180.C.04.11 Record-And-Replay Sandbox#

Implementation date: 2026-04-22

Files changed:

  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/record-replay-sandbox.ts
  • testing/bellona/remote-control/tests/record-replay-sandbox.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • testing/bellona/remote-control/fake-host-adapter.ts for adapter capability registration, command receipt, generated progress events, success/failure outcomes, and handler injection.
  • testing/bellona/remote-control/fake-gateway-transport.ts for connected-host snapshots, dispatch records, protocol-valid results, progress aggregation, and audit/event capture.
  • testing/bellona/remote-control/snapshot-fixtures.ts for deterministic downstream fixtures that wrap protocol-owned data without introducing new protocol authority.
  • libs/bellona/remote-protocol/src/command.ts, libs/bellona/remote-protocol/src/result.ts, and generated fixtures for the canonical command envelope, progress, result, idempotency, warning, and remediation constraints that replay cassettes must preserve.

Implementation summary:

  • Added RemoteControlRecordReplaySandbox, a test-only cassette recorder that captures direct live-adapter responses or existing FakeGatewayTransport dispatches into protocol-valid replay entries.
  • Added deterministic command matching by command namespace/name plus structured arguments, with stricter target-and-arguments modes available when tests must bind to a specific adapter or capability.
  • Added checksumed RemoteControlReplayCassette serialization/parsing so captured live responses can be stored as offline fixtures and tamper detection fails closed before replay.
  • Added deterministic replay remapping for command ID, session ID, idempotency key, result ID, progress IDs, progress sequences, timestamps, metadata, and recorded result/progress provenance.
  • Added a createReplayHandler() bridge so FakeHostAdapter can serve recorded responses to offline gateway, MCP, adapter, and agent regression tests without requiring a live Blender, Unreal, Chrome, or host process.
  • Covered success, failure, progress, direct live-adapter capture, fake-gateway capture, deterministic repeated replay, missing cassette keys, and checksum tampering with focused Vitest tests.

Verification closure:

  • pnpm nx build @bellona/remote-control-testing passes.
  • pnpm nx typecheck @bellona/remote-control-testing passes.
  • pnpm nx lint @bellona/remote-control-testing passes.
  • pnpm nx test @bellona/remote-control-testing passes.
  • pnpm exec prettier --check ... passes for touched harness, tracker, and TODO files.
  • git diff --check passes.

180.C.04.12 Protocol Fuzzing Harness#

Implementation date: 2026-04-22

Files changed:

  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/protocol-fuzzing-harness.ts
  • testing/bellona/remote-control/tests/protocol-fuzzing-harness.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/yemaya/core/__tests__/property-based.test.ts for existing fast-check-style property coverage and dependency usage outside Bellona.
  • libs/neith/testing/src/unit/property.ts for the repo's lightweight custom property-test helper pattern.
  • testing/bellona/remote-control/fake-gateway-transport.ts and testing/bellona/remote-control/fixtures.ts for deterministic protocol-valid command fixtures and policy test device construction.
  • libs/bellona/remote-protocol/src/command.ts and libs/bellona/remote-protocol/src/policy.ts for canonical envelope parsing, high-risk dry-run requirements, approval requirements, and policy-denial behavior that the fuzzer must treat as release-blocking.

Implementation summary:

  • Added runRemoteControlProtocolFuzzingHarness, a deterministic test-only fuzz runner that evaluates fuzz inputs against RemoteCommandEnvelopeSchema and the remote command policy evaluator.
  • Added a default fuzz corpus covering malformed envelopes, undeclared fields, oversized IDs and idempotency keys, RTL marks, decomposed Unicode, surrogate pairs, schema-downgrade payloads, and bounded deeply nested JSON structures.
  • Added policy-bypass fuzz cases for project file writes, shell execution, real browser profile access, and destructive approval downgrades so known high-risk denial paths fail closed.
  • Added structured release-blocking findings for schema/parser crashes, unexpected schema acceptance, unexpected control rejection, policy bypasses, and policy evaluator crashes.
  • Exported the harness and documented reuse points so future protocol, gateway, host, adapter, and release-gate tests can extend the baseline corpus without adding live Blender, Unreal, Chrome, desktop, or WebRTC dependencies.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts --reporter=verbose passes in testing/bellona/remote-control.
  • pnpm bellona:remote-control:verify passes.
  • pnpm exec prettier --check ... passes for touched harness, tracker, and TODO files.
  • git diff --check passes.

180.C.04.13 Envelope Invariant Property Tests#

Implementation date: 2026-04-22

Files changed:

  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/tests/envelope-invariants.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/yemaya/core/__tests__/property-based.test.ts for the repo's existing fast-check usage and assertion style.
  • libs/neith/testing/src/unit/property.ts for the repo's lightweight seeded property-runner pattern, which avoids adding package dependencies when a deterministic equivalent is sufficient.
  • libs/bellona/remote-protocol/src/command.ts for command envelope invariants: priority values, timeout-class maximums, risk-class approval/rollback/dry-run requirements, target namespace matching, and idempotency-key constraints.
  • libs/bellona/remote-protocol/src/actor.ts for actor-chain ordering, duplicate actor/stable ID rejection, root/terminal binding, and delegation well-formedness.

Implementation summary:

  • Added a deterministic property-test suite that generates command envelope and actor-chain cases with a fixed seed and counterexample reporting.
  • Covered idempotency-key determinism by proving stable JSON normalization keeps keys identical for semantically equivalent argument objects and changes keys for changed semantics while preserving protocol-valid key shape.
  • Covered priority ordering with generated command batches sorted by critical, high, normal, then low priority, followed by timestamp and command ID tie-breaks.
  • Covered timeout-class monotonicity by proving class ceilings never decrease as timeout classes widen and generated envelopes are accepted or rejected at the canonical class limits.
  • Covered risk-class escalation by proving read-only, safe-mutation, destructive, and privileged commands monotonically add approval, rollback, and dry-run requirements.
  • Covered actor-chain well-formedness by generating valid chains and rejecting duplicate actor IDs, root mismatches, terminal mismatches, self-delegation, and broken delegation order.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts --reporter=verbose passes in testing/bellona/remote-control.
  • pnpm nx typecheck @bellona/remote-control-testing --verbose passes.
  • pnpm nx lint @bellona/remote-control-testing --verbose passes.
  • pnpm bellona:remote-control:verify passes.
  • pnpm exec prettier --check ... passes for touched harness, tracker, and TODO files.
  • git diff --check passes.

180.C.07.10 Mutating Adapter Policy And Audit Closure#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/command-dispatcher.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • apps/bellona/remote-gateway/src/host-connections.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-gateway/src/command-dispatcher.ts for command schema parsing, policy evaluation, approval continuation, audit emission, telemetry, and host dispatch ordering.
  • apps/bellona/remote-gateway/src/host-connections.ts for the host WebSocket send path and connected-device dispatch target selection.
  • apps/bellona/remote-gateway/src/audit-log.ts for hash-chained audit append behavior and failure propagation.
  • libs/bellona/remote-protocol/src/policy.ts for inferred high-risk scopes, dry-run requirements, capability checks, and permission-denial decisions.
  • Existing gateway command-dispatcher tests for policy denial, approval request/decision, host-result auditing, idempotency replay, and missing-device fail-closed behavior.

Implementation summary:

  • Split host command sending into dispatch reservation and reserved send steps. The dispatcher now reserves the connected host target, writes the command.dispatched audit entry with policy metadata, then sends the host WebSocket message.
  • Preserved direct sendCommand() behavior for host-connection callers by implementing it as reservation plus reserved send.
  • Added a regression test proving an allowed safe-mutation command with project write and dry-run metadata is not sent to the host when the dispatch audit append fails.
  • Documented the audit-before-send guarantee in the remote-gateway README and checked off the stage closure item after prior policy, approval, and audit slices were already complete.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • pnpm nx typecheck @bellona/remote-gateway --verbose passes.
  • pnpm nx lint @bellona/remote-gateway --verbose passes.
  • pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose passes.
  • pnpm exec prettier --check ... passes for touched gateway, tracker, and TODO files.
  • git diff --check passes.

180.C.08.01 Append-Only Audit Service Fields#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/audit-log.ts
  • apps/bellona/remote-gateway/src/audit-log.test.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-gateway/src/audit-log.ts for append-only sequencing, hash chaining, persistence callbacks, and rollback on append failure.
  • apps/bellona/remote-gateway/src/persistent-store.ts for stored audit entry sequence/hash validation on snapshot load.
  • apps/bellona/remote-gateway/src/command-dispatcher.ts for command receipt, dispatch, policy denial, approval continuation, host result, and host error audit emission points.
  • libs/bellona/remote-protocol/src/audit.ts for canonical audit entry fields and metadata value constraints.
  • Existing remote-gateway tests for audit hash chaining, policy metadata, command dispatch, host result routing, and store validation.

Implementation summary:

  • Added stable audit payload hashing for command and result payloads using key-sorted JSON before SHA-256 hashing.
  • Extended gateway audit entry input with correlation ID, command hash, result hash, policy decision, policy ID, and required permission scopes.
  • Normalized audit metadata so command-related entries carry correlation, session, command, actor, device, command hash, result hash, and policy fields while preserving protocol-valid RemoteAuditEntry records.
  • Threaded command hashes through command receipt, dispatch, policy denial, host error, and host result audit entries; threaded result hashes through host result audit entries.
  • Updated audit and command-dispatcher tests to prove enriched fields are emitted, hash chained, protocol-valid, and clone-protected.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • pnpm nx run-many -p @bellona/remote-gateway -t test,typecheck,lint,build --skip-nx-cache --verbose passes.
  • pnpm exec prettier --check ... passes for touched gateway, tracker, and TODO files.
  • git diff --check passes.

180.C.08.02 Timeline Query API and Service#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/app.ts
  • apps/bellona/remote-gateway/src/app.test.ts
  • apps/bellona/remote-gateway/src/index.ts
  • apps/bellona/remote-gateway/src/timeline.ts
  • apps/bellona/remote-gateway/src/timeline.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-gateway/src/session-lifecycle.ts for protocol-valid session lifecycle events, ordering, and persistence callbacks.
  • apps/bellona/remote-gateway/src/command-dispatcher.ts and apps/bellona/remote-gateway/src/persistent-store.ts for command dispatch, progress, result, and error event persistence.
  • apps/bellona/remote-gateway/src/approval-service.ts for approval request and decision storage semantics.
  • apps/bellona/remote-gateway/src/audit-log.ts and libs/bellona/remote-protocol/src/audit.ts for audit-backed stream and artifact records before dedicated stores exist.
  • Existing app endpoint and gateway test patterns for HTTP query coverage.

Implementation summary:

  • Added RemoteGatewayTimelineService with validated query/result schemas, event kinds for session, command, approval, stream, and artifact, deterministic timestamp/source/sequence ordering, pagination, and filters for session, command, device, actor, stream, artifact, approval request, kind, type, and time windows.
  • Merged session lifecycle events, stored command client events, stored approval requests/decisions, and audit-backed stream/artifact events into one ordered timeline result.
  • Added GET /v1/timeline with query-string parsing for the same timeline filters and structured invalid_timeline_query errors for rejected filters.
  • Documented the endpoint and the first-stage stream/artifact derivation model, where stream events currently come from evidence.captured audit entries with streamId metadata and artifact events come from artifact.registered or artifact-linked evidence entries.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • pnpm nx typecheck @bellona/remote-gateway --verbose passes.
  • Full run-many, lint, build, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.08.03 Artifact Metadata Registration#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/app.ts
  • apps/bellona/remote-gateway/src/app.test.ts
  • apps/bellona/remote-gateway/src/artifact-registry.ts
  • apps/bellona/remote-gateway/src/artifact-registry.test.ts
  • apps/bellona/remote-gateway/src/index.ts
  • apps/bellona/remote-gateway/src/persistent-store.ts
  • apps/bellona/remote-gateway/src/persistent-store.test.ts
  • apps/bellona/remote-gateway/src/timeline.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/audit.ts for the existing RemoteArtifact, artifact kind, redaction status, and artifact.registered audit schemas.
  • libs/bellona/remote-protocol/src/fixtures.ts for existing artifact and audit fixtures.
  • apps/bellona/remote-gateway/src/persistent-store.ts for first-stage JSON persistence, duplicate-id validation, and clone-protected getters.
  • apps/bellona/remote-gateway/src/audit-log.ts for append-only audit emission and hash chaining.
  • apps/bellona/remote-gateway/src/timeline.ts for how registered artifacts should surface in ordered session timelines.

Implementation summary:

  • Extended the gateway first-stage persistent store with validated RemoteArtifact metadata records, duplicate artifact-id rejection, clone-protected getArtifact, filtered listArtifacts, and registerArtifact APIs.
  • Added RemoteGatewayArtifactRegistry for screenshot, render, log, browser-trace, export, and diagnostic-bundle registrations. Export metadata maps to the protocol audit-export kind, while diagnostic bundles map to file with artifactPurpose metadata.
  • Added POST /v1/artifacts registration and GET /v1/artifacts listing with session, command, device, kind, and redaction-status filters.
  • Emitted artifact.registered audit entries with artifact id, purpose, kind, URI, media type, byte size, SHA-256, redaction status, evidence ids, command, session, device, and actor metadata.
  • Updated the timeline service so registered artifacts are returned from the artifact store as artifact.registered timeline events while stream events remain audit-backed until the stream store arrives.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • pnpm nx typecheck @bellona/remote-gateway --verbose passes.
  • Full run-many, lint, build, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.08.04 Redaction Utilities#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/index.ts
  • apps/bellona/remote-gateway/src/redaction.ts
  • apps/bellona/remote-gateway/src/redaction.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/blender/python/bellona_addon/__init__.py for existing operator-facing prompt and path redaction behavior in Blender logs.
  • libs/bellona/blender/src/addon-preferences.ts for the current Blender preference toggles controlling prompt and path log redaction.
  • docs/domains/bellona/extras/remote-control/adr/ADR-0002-remote-control-threat-model.md for credential, browser, path, and active-window disclosure risks that gateway redaction must reduce before audit/export retention.
  • libs/bellona/remote-protocol/src/metadata.ts and existing remote-gateway entrypoint/test patterns for metadata-compatible utility exports.

Implementation summary:

  • Added gateway-native redaction utilities for free-form text, structured JSON values, protocol metadata maps, and active window titles.
  • Redacts bearer tokens, Bellona host tokens, JWT-shaped tokens, OpenAI/API key assignments, password assignments, browser cookie headers or cookie-valued metadata, macOS/Linux/Windows personal paths, and operator-denied window titles.
  • Returns structured redaction findings with kind, path, and replacement labels so later audit, artifact, log, and export code can retain redaction evidence without storing the sensitive source text.
  • Exported the utilities from the remote-gateway package entrypoint and documented the intended gateway/host call sites.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • pnpm nx typecheck @bellona/remote-gateway --verbose passes.
  • Full run-many, lint, build, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.08.05 Structured Gateway and Host Logging#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/app.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • apps/bellona/remote-gateway/src/host-connections.ts
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/app.ts
  • apps/bellona/remote-host/src/command-executor.ts
  • apps/bellona/remote-host/src/command-executor.test.ts
  • apps/bellona/remote-host/src/gateway-connection.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/logging.ts
  • libs/bellona/remote-protocol/src/logging.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/shared/logging/src/logger.ts and libs/shared/logging/src/types.ts for the existing @oshun/logging logger, child context, Pino redaction, and method signatures already used by both remote packages.
  • Existing gateway RemoteGatewayTelemetryFields and command/audit correlation fields for the command-level identifiers logs must preserve.
  • Existing gateway host-connection, command-dispatcher, app lifecycle, and host gateway-connection/command-executor log call sites.
  • Remote protocol command envelope fields for the shared correlation source of truth.

Implementation summary:

  • Added shared protocol helpers for compact command and connection structured log fields with stable serviceRole, eventType, correlationId, sessionId, commandId, deviceId, connectionId, actorParticipantId, idempotencyKey, and command-target field names.
  • Updated gateway command dispatch, policy rejection, host send/receive, connection, HTTP request, startup, shutdown, and heartbeat timeout logs to use those shared fields while keeping metrics and audit records separate.
  • Updated host gateway connection, command execution, identity, HTTP request, startup, and shutdown logs to use the same field names, and avoided logging signed host tokens or local identity file paths.
  • Added protocol helper tests, gateway command log-field assertions, and host command lifecycle log-field assertions.

Verification closure:

  • Focused protocol, gateway, and host tests pass.
  • Full run-many, lint, build, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.08.06 Basic Metrics Counters and Timers#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/app.ts
  • apps/bellona/remote-gateway/src/approval-service.ts
  • apps/bellona/remote-gateway/src/approval-service.test.ts
  • apps/bellona/remote-gateway/src/audit-log.ts
  • apps/bellona/remote-gateway/src/audit-log.test.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • apps/bellona/remote-gateway/src/host-connections.ts
  • apps/bellona/remote-gateway/src/host-connections.test.ts
  • apps/bellona/remote-gateway/src/telemetry.ts
  • apps/bellona/remote-gateway/src/telemetry.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-gateway/src/telemetry.ts for existing typed in-memory metric event storage, field validation, and clone-protected reads.
  • apps/bellona/remote-gateway/src/command-dispatcher.ts for existing command received, dispatched, completed, failed, and telemetry recording boundaries.
  • apps/bellona/remote-gateway/src/host-connections.ts for host handshake, disconnect, heartbeat timeout, and reconnect-observable boundaries.
  • apps/bellona/remote-gateway/src/approval-service.ts for approval request and decision timestamps used to calculate latency.
  • apps/bellona/remote-gateway/src/audit-log.ts for append callback rollback behavior when persistent audit writes fail.

Implementation summary:

  • Extended gateway metric names with basic counters/timers/state metrics for command count, command duration, command failure count, host online state, host reconnect count, approval latency, and audit write failure count.
  • Recorded command count on command receipt, command duration from host result durationMs, and command failure count for policy rejection, host command errors, and non-succeeded host results.
  • Recorded host online state on accepted handshakes and disconnects, and counted reconnects when a device completes more than one accepted host handshake.
  • Recorded approval latency from request requestedAt to decision decidedAt, including expired deny-by-default decisions.
  • Recorded audit write failure metrics when audit append callbacks throw, preserving rollback behavior and surfacing the failure for future metrics exporters.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • Full run-many, lint, build, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.08.07 Audit Before/After Command Execution Tests#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • Existing command dispatcher WebSocket test harness for fake host command dispatch, result, and command error flows.
  • Existing audit hash-chain assertions for command received, dispatched, completed, failed, policy denied, approval requested, and approval decided entries.
  • Existing approval continuation test for requires-approval command dispatch after an operator approval decision.

Implementation summary:

  • Added an allowed-command audit ordering test that proves command.received and command.dispatched are written before the host result, then command.completed is written after the result.
  • Strengthened failed-command coverage to assert the pre-result audit state and final command.failed entry after a failed host result.
  • Retained and documented denied-command coverage proving the host never receives a policy-denied command and the audit trail stops at policy.denied.
  • Strengthened approved-command coverage to prove approval.requested is written before dispatch, approval.decided and command.dispatched are written after approval, and command.completed is written after the approved host result.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • Full run-many, lint, build, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.08.08 Session Timeline and Audit Bundle Documentation#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • docs/domains/bellona/extras/remote-control/session-timeline-and-audit-bundle.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-gateway/src/timeline.ts for query filters, event source ordering, event kinds, and stream/artifact derivation behavior.
  • apps/bellona/remote-gateway/src/app.ts and app.test.ts for the GET /v1/timeline, GET /v1/artifacts, and POST /v1/artifacts HTTP surfaces.
  • apps/bellona/remote-gateway/src/audit-log.ts, artifact-registry.ts, and persistent-store.ts for hash-chained audit entries, export artifact registration, and first-stage JSON store snapshot structure.

Implementation summary:

  • Added a dedicated operator runbook for reading session timelines through GET /v1/timeline and interpreting event kind, source, ordering, correlation IDs, command states, approval states, stream evidence, and artifact evidence.
  • Documented the current audit-bundle export procedure without inventing an unsupported endpoint: export from the durable first-stage store snapshot, capture the review timeline, create checksums, ZIP the bundle, and register it through POST /v1/artifacts with purpose: "export".
  • Documented current limitations around missing public audit export APIs, metadata-only artifact registration, stream-store deferral, and manual redaction responsibility.
  • Linked the runbook from the remote gateway README.

Verification closure:

  • Documentation-only verification recorded in the progress table for the completed item.

180.C.08.09 Audit-Store Failure Command Gating#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/command-dispatcher.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • Existing command dispatcher audit ordering and host-reservation behavior, including the prior command.dispatched audit-failure test that blocks host sends before mutating adapter work reaches the host.
  • apps/bellona/remote-gateway/src/audit-log.ts rollback behavior and remote_gateway.audit.write_failure.count telemetry on append callback failures.
  • @bellona/remote-protocol policy evaluation, diagnostic adapter fixtures, and read-only agent.readiness / state.snapshot command contracts.

Implementation summary:

  • Added a fail-closed audit-unavailable path in the gateway command dispatcher: if the initial command.received audit write fails or no audit log is configured, the dispatcher blocks all commands unless they are explicitly safe diagnostics.
  • Defined the safe diagnostic exception narrowly: agent.readiness and state.snapshot, read-only, no approval, no dry-run, allowed by policy, advertised by an available diagnostic adapter/capability, and limited to device.read, adapter.inspect, and command.execute.readonly scopes.
  • Preserved the pre-send audit gate for normal command dispatch while allowing degraded safe diagnostics to route host results back to the client even when repeated audit writes fail.
  • Added tests for privileged-command blocking, non-diagnostic read-only blocking, safe diagnostic allowance, and audit/telemetry behavior during the degraded path.
  • Documented the audit-store outage behavior in the remote gateway README.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • Full run-many, lint, build, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.08.10 Command Path Timeline and Audit Closure#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-gateway/src/command-dispatcher.ts for the current allowed, denied, failed result, host error, approval continuation, and audit-unavailable command paths.
  • apps/bellona/remote-gateway/src/timeline.ts for how audit log, command store, approval store, artifact store, and session lifecycle sources merge into queryable timeline events.
  • Existing command dispatcher tests added by 180.C.08.07 and 180.C.08.09 for audit order, policy denial, approval continuation, host errors, and audit-store outage behavior.

Implementation summary:

  • Added command timeline assertions to the existing gateway command-dispatcher integration tests so healthy allowed, progress/result, failed-result, host-error, policy-denied, and approved command paths must surface through both audit entries and timeline events.
  • Verified command result/progress/error timeline events come from the command store while command receipt, dispatch, completion/failure, and policy denial come from the audit log.
  • Verified approval request and decision visibility comes from the approval store while the approved command's execution path remains visible through audit and command-store timeline sources.
  • Recorded the 180.C.08.09 audit-unavailable diagnostic path as a deliberate outage exception: it is allowed only because the audit store is unavailable, and repeated audit write failures are logged/metriced instead of represented as successful audit entries.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • Full run-many, lint, build, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.08.11 Stored-Data Schema Migration Framework#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/persistent-store.ts
  • apps/bellona/remote-gateway/src/persistent-store.test.ts
  • docs/domains/bellona/extras/remote-control/session-timeline-and-audit-bundle.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-gateway/src/persistent-store.ts for the current first-stage JSON store schema, strict Zod validation, duplicate-reference checks, audit hash-chain verification, and atomic file persistence.
  • apps/bellona/remote-gateway/src/persistent-store.test.ts for durable gateway-state fixtures and tamper-rejection coverage.
  • libs/bellona/remote-protocol/src/common.ts and src/index.ts for canonical protocol-version parsing and the current protocol version stamp.

Implementation summary:

  • Promoted the gateway first-stage persistent store to schema version 3 and added record-set version stamps for device, session, command, approval, and audit records without mutating hash-chained audit entry payloads.
  • Added forward migrations from schema 1 to 2 and 2 to 3, plus backward migrations from 3 to 2 and 2 to 1 through the exported migrateRemoteGatewayPersistentStoreSnapshot helper.
  • Migrated legacy file-store snapshots during load, then rewrote migrated snapshots with the current schema after validation so future starts do not repeatedly run the same migrations.
  • Added tests that load full legacy fixtures from prior protocol versions 0.0.1 and 0.0.2, verify migration history and version stamps, and prove downgraded snapshots can be remigrated without losing device, session, command, approval, artifact, or audit data.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • Full run-many, lint, build, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.08.12 Audit Actor Delegation Attribution#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/app.test.ts
  • apps/bellona/remote-gateway/src/approval-service.ts
  • apps/bellona/remote-gateway/src/approval-service.test.ts
  • apps/bellona/remote-gateway/src/artifact-registry.ts
  • apps/bellona/remote-gateway/src/artifact-registry.test.ts
  • apps/bellona/remote-gateway/src/audit-log.ts
  • apps/bellona/remote-gateway/src/audit-log.test.ts
  • apps/bellona/remote-gateway/src/device-revocation.ts
  • apps/bellona/remote-gateway/src/device-revocation.test.ts
  • apps/bellona/remote-gateway/src/pairing-exchange.ts
  • apps/bellona/remote-gateway/src/persistent-store.test.ts
  • docs/domains/bellona/extras/remote-control/session-timeline-and-audit-bundle.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/actor.ts for RemoteActor and ordered RemoteActorChain validation.
  • libs/bellona/remote-protocol/src/audit.ts and src/command.ts for the required actor-chain fields already present on protocol audit entries, approval requests, and command envelopes.
  • Gateway audit producers in command dispatch, approvals, artifacts, session lifecycle, pairing, device revocation, and tests to find call sites that still relied on audit-log fallback attribution.

Implementation summary:

  • Made gateway audit append inputs require an explicit RemoteActorChain instead of synthesizing a fallback inside the audit log.
  • Normalized actor attribution into audit metadata with actorChainId, actorRootActorId, actorTerminalActorId, actorIds, actorStableIds, and actorKinds so exported audit records remain searchable by every delegated human, orchestrator, specialist, and adapter actor.
  • Threaded explicit actor chains through approval decisions, artifact registration, device revocation, pairing completion, persistent-store tests, and app tests; system-owned events now use concrete gateway/operator actor chains at their source.
  • Added assertions covering full command actor chains, approval decision actors, gateway policy timeout actors, device revocation actors, and pairing service actors.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose passes.
  • Full run-many, lint, build, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.09.01 Blender Loopback Adapter Discovery#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/blender-adapter.ts
  • apps/bellona/remote-host/src/blender-adapter.test.ts
  • apps/bellona/remote-host/src/index.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/blender/python/bellona_addon/server.py and libs/bellona/blender/python/bellona_addon/__init__.py for the local Blender addon WebSocket endpoint, defaulting to localhost:9876.
  • libs/bellona/blender/src/bridge/index.ts for the TypeScript Blender bridge client defaults, also using local loopback connectivity.
  • apps/bellona/bridge-blender/src/main.ts for the legacy bridge-blender service configuration and its BLENDER_BRIDGE_HOST/BLENDER_BRIDGE_PORT loopback defaults of localhost:9001/blender.
  • libs/bellona/remote-protocol/src/device.ts and libs/bellona/remote-protocol/src/fixtures.ts for the canonical localhost endpoint schema and the existing adapter:blender-local fixture.
  • apps/bellona/remote-host/src/adapter-registry.ts for the in-memory adapter registration, health, and command routing behavior used by host diagnostics.

Implementation summary:

  • Added a Remote Host Blender discovery module that produces protocol-valid adapter and capability registrations from the existing addon or bridge candidates.
  • Enforced loopback-only discovery with an exported guard that accepts only localhost, 127.0.0.1, or ::1; public wildcard, LAN, and internet hosts are rejected before registration.
  • Preserved the walking-skeleton fake adapter defaults while exposing createRemoteHostBlenderAdapterRegistration() for the real loopback registration path.
  • Registered the discovered adapter as degraded until 180.C.09.02 adds active health probing, so diagnostics can see the local candidate without claiming live command availability.
  • Added tests covering protocol validation, registry insertion, command-route refusal while degraded, loopback acceptance, public-host rejection, and the documented addon/bridge implementation candidates.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose passes.
  • Full run-many, lint, build, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.09.02 Blender Adapter Health Command#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/blender-adapter.ts
  • apps/bellona/remote-host/src/blender-adapter.test.ts
  • apps/bellona/remote-host/src/index.ts
  • libs/bellona/blender/python/bellona_addon/handlers.py
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/blender/python/bellona_addon/server.py for the addon WebSocket handshake response that already reports version, protocol, and blender_version.
  • libs/bellona/blender/python/bellona_addon/handlers.py for the existing read-only get_state handler and command registration pattern.
  • libs/bellona/blender/python/bellona_addon/__init__.py for addon version, diagnostics, and active-file-path helpers already used by the Blender UI.
  • libs/bellona/blender/src/bridge/index.ts for the TypeScript addon client WebSocket framing and heartbeat behavior.
  • libs/bellona/bridge-core/src/index.ts and apps/bellona/bridge-blender/src/main.ts for the bridge-core handshake shape used by the bridge-blender service.

Implementation summary:

  • Added blender.adapter.health as a Remote Host command capability on the Blender adapter while keeping scene-query degraded until the scene-info route exists.
  • Implemented host-side health probing for Blender executable discovery, loopback WebSocket connection state, addon or bridge availability, Blender version, addon or bridge version, and active file path when the addon reports it.
  • Added a safe read-only Blender addon diagnostic.health handler that returns addon installed state, addon version, Blender version, server running state, client count, connection state, and active .blend path without executing arbitrary Python or mutating Blender state.
  • Added tests with a loopback mock Blender addon endpoint plus registry command routing coverage proving the health command is available while scene-query remains unavailable.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose passes.
  • Full run-many, Python compile, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.09.03 Blender Scene Info Protocol Schema#

Implementation date: 2026-04-22

Files changed:

  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • libs/bellona/remote-protocol/src/blender.ts
  • libs/bellona/remote-protocol/src/blender.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/state.ts for command argument defaults, top-level snapshot objects, parser helpers, and duplicate-id validation.
  • libs/bellona/remote-protocol/src/schema-registry.ts plus scripts/generate-contract-artifacts.ts for keeping TypeScript, JSON Schema, OpenAPI, and Proto-ready manifests in sync.
  • libs/bellona/remote-protocol/src/fixtures.ts for canonical fixture shape and command result output conventions.
  • libs/bellona/blender/python/bellona_addon/handlers.py for the existing scene, object, material, collection, camera, light, frame, and render data the later adapter mapping can normalize.

Implementation summary:

  • Added canonical blender.scene.info schemas to remote-protocol, covering command arguments and the read-only scene snapshot output.
  • Modeled scenes, collections, objects, materials, cameras, lights, frame range, selected objects, render engine, active scene, active file path, Blender version, and addon version.
  • Added validation for duplicate Blender data-block ids, invalid frame ranges, unknown selected objects, and broken scene/collection/object/material/camera and light references.
  • Added a full scene-info fixture, parser helper, schema-registry entries, and generated JSON Schema/OpenAPI/Proto-ready contract artifacts.

Verification closure:

  • pnpm nx test @bellona/remote-protocol --verbose passes.
  • Full run-many, contract generation/check, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.09.04 Host-To-Blender Scene Info Route#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/blender-adapter.ts
  • apps/bellona/remote-host/src/blender-adapter.test.ts
  • apps/bellona/remote-host/src/index.ts
  • libs/bellona/blender/python/bellona_addon/handlers.py
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/blender/python/bellona_addon/handlers.py for existing read-only scene, object, collection, material, frame, and render state handlers plus command registration.
  • apps/bellona/remote-host/src/blender-adapter.ts for loopback-only WebSocket probing, adapter registration, host command routing, and degraded scene-query behavior.
  • libs/bellona/remote-protocol/src/blender.ts and fixture data from 180.C.09.03 for the canonical RemoteBlenderSceneInfo output contract.

Implementation summary:

  • Added a blender.scene.info host command capability that validates live addon output with RemoteBlenderSceneInfoSchema.
  • Added a safe read-only addon scene.info command that normalizes scenes, collections, objects, materials, cameras, lights, frame range, selected objects, render engine, active file path, Blender version, and addon version.
  • Kept legacy blender.scene.query degraded while the new protocol-backed blender.scene.info route is available.
  • Added fallback behavior returning the protocol mock scene-info fixture with fallback metadata when Blender/addon routing is unavailable.
  • Added tests for registry routing, mock addon scene-info routing, schema validation, and unavailable-Blender fallback behavior.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose passes.
  • Full remote-host run-many, Python compile, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.09.05 Scene Info Schema And Adapter Mapping Tests#

Implementation date: 2026-04-22

Files changed:

  • libs/bellona/remote-protocol/src/blender.test.ts
  • apps/bellona/remote-host/src/blender-adapter.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/blender.test.ts for existing scene-info fixture parsing, duplicate-id, frame-range, and broken-reference tests.
  • apps/bellona/remote-host/src/blender-adapter.test.ts for existing adapter registration, registry routing, mock addon health, mock scene-info, and unavailable-Blender fallback tests.
  • apps/bellona/remote-host/src/blender-adapter.ts for command handler mapping, read-only capability metadata, addon payload construction, and bridge fallback behavior.

Implementation summary:

  • Added protocol unit coverage for strict command argument parsing, invalid argument bounds, mutation-shaped argument rejection, and minimal scene-info payload defaults.
  • Strengthened broken-reference assertions with issue-path checks across selected objects, cameras, lights, materials, collections, and objects.
  • Added host adapter unit coverage proving blender.scene.info maps to a read-only capability, forwards the exact command envelope to the provider, sends target ids and arguments to the addon scene.info payload, and maps non-addon bridge discovery to the protocol mock fallback.

Verification closure:

  • Full remote-protocol and remote-host run-many, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.09.06 Mocked Blender Addon Integration Tests#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/src/blender-scene-info.integration.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/command-executor.test.ts for command lifecycle, result schema parsing, and event sequence assertions.
  • apps/bellona/remote-host/src/blender-adapter.test.ts for mock addon WebSocket handling and scene-info command fixtures.
  • apps/bellona/remote-host/src/gateway-connection.test.ts for local WebSocket test-server lifecycle and message capture conventions.

Implementation summary:

  • Added an integration-style test that runs a mock Blender addon WebSocket endpoint, registers the real Blender adapter against that endpoint, and executes blender.scene.info through the host command executor and adapter registry.
  • Validated command lifecycle events, command result schema parsing, RemoteBlenderSceneInfoSchema parsing, mesh/render-engine output, and the exact addon scene.info payload target and argument mapping.
  • Added a malformed mocked addon response case proving the host returns the protocol mock fallback through the same command executor path.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache passes with 10 test files and 58 tests.
  • Full remote-host run-many, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.09.07 Optional Headless Blender Scene Info Smoke#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/package.json
  • apps/bellona/remote-host/project.json
  • apps/bellona/remote-host/scripts/blender-scene-info-smoke.ts
  • apps/bellona/remote-host/tsconfig.app.json
  • libs/bellona/blender/python/bellona_addon/server.py
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/blender/src/addon-smoke.test.ts for current addon smoke coverage, WebSocket smoke fixtures, and addon source layout.
  • apps/bellona/remote-host/src/blender-adapter.ts for Blender executable probing and scene-info schema validation boundaries.
  • docs/domains/bellona/extras/remote-control/hardware-rig-inventory.md for the Phase 180 hardware/headless Blender evidence expectation.

Implementation summary:

  • Added pnpm nx blender:scene-info-smoke @bellona/remote-host, backed by scripts/blender-scene-info-smoke.ts.
  • The smoke test locates Blender via BELLONA_BLENDER_EXECUTABLE, a standard macOS app install, or PATH; missing Blender exits with a skipped summary unless --required or BELLONA_BLENDER_SMOKE_REQUIRED=1 is set.
  • When Blender is available, the smoke launches --background --factory-startup, creates and reopens a tiny .blend fixture with a cube, material, camera, and area light, calls the addon scene.info handler, and validates the returned JSON with RemoteBlenderSceneInfoSchema.
  • Fixed the addon server import path so headless Blender can import the addon when optional websockets is absent; WebSocketServerProtocol now falls back to Any for annotation use.

Verification closure:

  • pnpm nx blender:scene-info-smoke @bellona/remote-host passes locally with /Applications/Blender.app/Contents/MacOS/Blender, reporting active scene scene:Bellona Smoke Scene, objectCount: 3, render engine CYCLES, and selected object object:Bellona Smoke Cube.
  • Full remote-host run-many, Python compile, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.09.08 Gateway and Host Scene Info Route#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • apps/bellona/remote-host/src/gateway-connection.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts for the connected fake-host round trip, client subscription delivery, command-store timeline events, telemetry metrics, and audit payload hashing.
  • apps/bellona/remote-host/src/gateway-connection.test.ts for fake gateway dispatch handling, host handshake setup, progress/result WebSocket message capture, and diagnostics command execution.
  • apps/bellona/remote-host/src/blender-scene-info.integration.test.ts and apps/bellona/remote-host/src/blender-adapter.test.ts for real Blender adapter registration, scene-info provider wiring, and protocol fixture validation.

Implementation summary:

  • Added gateway route coverage for blender.scene.info using a host device with the read-only Blender scene-info capability.
  • Verified the gateway dispatches the command from a subscribed client to the selected host, accepts a protocol-valid scene-info result, delivers the result back to the client, and records command received/dispatched/completed entries in audit, command-store timeline, and telemetry.
  • Added host route coverage proving a gateway-dispatched blender.scene.info command reaches the real Blender adapter command handler and returns RemoteBlenderSceneInfoSchema output through the host gateway connection manager as a RemoteCommandResult.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose --skip-nx-cache passes with 16 test files and 82 tests.
  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache passes with 10 test files and 59 tests.
  • Full remote-gateway and remote-host run-many, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.09.09 Second MacBook Blender Read-Only MVP Runbook#

Implementation date: 2026-04-22

Files changed:

  • docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md
  • apps/bellona/remote-host/README.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/README.md for current host configuration, local gateway smoke setup, Blender loopback adapter behavior, and the optional blender:scene-info-smoke target.
  • apps/bellona/remote-gateway/README.md and apps/bellona/remote-gateway/src/app.ts for the currently exposed gateway endpoints, first-stage store, timeline endpoint, and the absence of a public HTTP command-dispatch API.
  • apps/bellona/remote-host/src/app.ts and apps/bellona/remote-host/src/adapter-registry.ts for the default fake adapter registration, confirming the second-MacBook runbook must use a development wrapper to register the real Blender adapter until the default host startup grows adapter configuration.
  • libs/bellona/blender/python/bellona_addon/__init__.py, libs/bellona/blender/python/bellona_addon/server.py, and libs/bellona/blender/python/bellona_addon/handlers.py for addon enablement, loopback server defaults, localhost:9876, and scene.info handler registration.
  • docs/domains/bellona/extras/remote-control/hardware-rig-inventory.md for the required MAC-OP-01, MAC-HOST-01, evidence naming, and hardware evidence floor.

Implementation summary:

  • Added a two-MacBook read-only Blender MVP runbook that separates the operator gateway role from the controlled host/Blender role.
  • Documented gateway startup on a trusted LAN interface with a first-stage store, controlled-host development identity creation, loopback-only Blender addon setup, local scene-info smoke verification, and a development host wrapper that registers the real Blender adapter plus host diagnostics adapter.
  • Documented expected readiness, capability, gateway-store, timeline, audit, and evidence checks while explicitly calling out that live public command dispatch is owned by 180.C.09.10.
  • Linked the runbook from the remote-host README and updated the README's gateway-dispatch coverage note to include blender.scene.info.

Verification closure:

  • Documentation-only change; no code paths changed.
  • Prettier and diff-check verification recorded in the progress table for the completed item.

180.C.09.10 Full Remote Path Scene Info CLI#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/scripts/blender-scene-info-remote-smoke.ts
  • apps/bellona/remote-host/package.json
  • apps/bellona/remote-host/project.json
  • apps/bellona/remote-host/README.md
  • docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-gateway/src/command-dispatcher.ts and apps/bellona/remote-gateway/src/command-dispatcher.test.ts for client subscription delivery, command dispatch records, command-store events, timeline ordering, audit entries, and result routing.
  • apps/bellona/remote-host/src/gateway-connection.ts and apps/bellona/remote-host/src/gateway-connection.test.ts for outbound host handshake, gateway command.dispatch handling, progress/result emission, and scene-info adapter execution.
  • apps/bellona/remote-host/scripts/blender-scene-info-smoke.ts for optional Blender availability behavior and --required style smoke-test conventions.
  • apps/bellona/remote-host/src/blender-adapter.ts for live addon query, fallback fixture metadata, and --require-live-addon validation.

Implementation summary:

  • Added pnpm nx blender:scene-info-remote-smoke @bellona/remote-host, backed by scripts/blender-scene-info-remote-smoke.ts.
  • The CLI starts an ephemeral Remote Gateway, starts an outbound Remote Host with the real Blender adapter registration and host diagnostics adapter, issues a development host token, waits for the host handshake, dispatches blender.scene.info through the gateway command dispatcher, validates the RemoteBlenderSceneInfoSchema result, and prints command, timeline, and audit evidence.
  • The default run permits the protocol fallback fixture so CI can prove the full gateway-host-adapter route without a live Blender addon. --require-live-addon fails the smoke when the adapter reports fallback metadata.
  • Updated the remote-host README and second-MacBook runbook with the new CLI target, expected output, and live-addon requirement flag.

Verification closure:

  • pnpm nx blender:scene-info-remote-smoke @bellona/remote-host passes locally, printing status: "passed", command id command:blender-scene-info-remote-smoke-001, audit entries command.received, command.dispatched, and command.completed, plus command-store timeline progress/result events.
  • Full remote-host run-many, Prettier, and diff-check verification recorded in the progress table for the completed item.

180.C.10.01 Blender Primitive Creation Schema#

Implementation date: 2026-04-22

Files changed:

  • libs/bellona/remote-protocol/src/blender.ts
  • libs/bellona/remote-protocol/src/blender.test.ts
  • libs/bellona/remote-protocol/src/command.ts
  • libs/bellona/remote-protocol/src/device.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/device.test.ts
  • libs/bellona/remote-protocol/src/policy.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/README.md
  • generated libs/bellona/remote-protocol/contracts/**
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/blender.ts and libs/bellona/remote-protocol/src/blender.test.ts for the established blender.scene.info command-name, argument, payload, parse-helper, and schema registry patterns.
  • libs/bellona/remote-protocol/src/command.ts and libs/bellona/remote-protocol/src/command.test.ts for timeout class, risk-class, rollback metadata, dry-run metadata, idempotency, and actor-chain envelope validation.
  • libs/bellona/remote-protocol/src/policy.ts and libs/bellona/remote-protocol/src/policy.test.ts for safe-mutation, project.write, dry-run requirement, and advertised-capability policy inference.
  • libs/bellona/blender-agent/src/blender-action-schema.ts for the existing object create-primitive action vocabulary and primitive naming conventions.

Implementation summary:

  • Added canonical protocol schemas for blender.object.create_primitive, including command name, primitive type enum, transform, existing collection reference, material reference, command arguments, command metadata, and a specialized command-envelope validator.
  • Constrained primitive creation to safe-mutation, short timeout class, maximum 30 seconds, undo_stack rollback metadata, dry-run metadata, required undo checkpoint flag, and required evidence flag.
  • Added a canonical fixture command plus device capability/permission fixtures advertising command.execute.safe-mutation and project.write.
  • Added protocol tests covering argument defaults/rejections, envelope timeout/risk metadata, fixture parsing, schema registry coverage, device graph consistency, and policy dry-run inference for Blender primitive creation.
  • Regenerated JSON Schema, OpenAPI, and proto-ready contract artifacts so downstream gateway, host, MCP, CLI, and UI code import the same canonical contract.

Verification closure:

  • Remote-protocol contracts:generate, contracts:check, test, typecheck, lint, build, Prettier, and diff-check verification recorded in the progress table for the completed item.
  • No Blender runtime mutation was claimed in this task; undo checkpoint execution, observe-only host policy, before/after evidence, adapter mutation, and hardware smoke remain owned by later 180.C.10 items.

180.C.10.02 Blender Primitive Undo Checkpoint#

Implementation date: 2026-04-22

Files changed:

  • libs/bellona/blender/python/bellona_addon/handlers.py
  • libs/bellona/blender/src/addon-smoke.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/blender-agent/src/transaction-layer.ts for the existing bpy.ops.ed.undo_push(...) checkpoint primitive, rollback step counting, and transaction metadata shape.
  • libs/bellona/blender-agent/src/transaction-layer.test.ts for existing checkpoint-before-action and rollback coverage expectations.
  • libs/bellona/blender/python/bellona_addon/handlers.py for the shipped addon object.create_primitive mutation handler and command registration pattern.
  • libs/bellona/blender/src/addon-smoke.test.ts for addon source-level smoke coverage of registered handlers and command-surface invariants.

Implementation summary:

  • Added _create_undo_checkpoint(...) in the Blender addon, backed by bpy.ops.ed.undo_push(message=...), with stable checkpoint metadata including id, label, creation time, and undo_stack rollback strategy.
  • Added an explicit undo.checkpoint addon command handler so later host and adapter code can create the same checkpoint directly.
  • Updated handle_object_create_primitive(...) to validate the primitive operator, create the undo checkpoint immediately before the Blender mesh operator runs, and return the checkpoint metadata with the created object.
  • Preserved the existing addon objectId result as the Blender object name while adding sceneInfoObjectId for the canonical scene-info identifier.
  • Began accepting the Phase 180 primitive schema's primitiveType, transform, collection, and materialReference payload shape while preserving legacy primitive, location, collectionId, and materialId inputs for existing addon callers.
  • Added addon smoke assertions proving undo.checkpoint is registered and the primitive handler calls _create_undo_checkpoint(...) before op(location=...).

Verification closure:

  • PYTHONPYCACHEPREFIX=/tmp/oshun-pycache python3 -m py_compile libs/bellona/blender/python/bellona_addon/__init__.py libs/bellona/blender/python/bellona_addon/server.py libs/bellona/blender/python/bellona_addon/handlers.py libs/bellona/blender/python/bellona_addon/events.py
  • pnpm nx test @bellona/blender --verbose --skip-nx-cache
  • pnpm nx run-many -p @bellona/blender -t typecheck,lint,build --skip-nx-cache --verbose
  • Final Prettier and diff-check verification recorded in the progress table for the completed item.

180.C.10.03 Blender Mutation Observe-Only Policy#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/src/policy-preflight.ts
  • apps/bellona/remote-host/src/policy-preflight.test.ts
  • apps/bellona/remote-host/src/command-executor.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/policy-preflight.ts for the existing host-side known-command preflight stub that runs before adapter routing.
  • apps/bellona/remote-host/src/command-executor.ts for the existing denied command lifecycle, result shape, and event sequencing.
  • libs/bellona/remote-protocol/src/policy.ts for shared permission-scope inference, especially Blender safe mutation and project.write derivation.
  • libs/bellona/remote-protocol/src/session.ts and session fixtures for participant control state and metadata conventions that can represent an observe-only session without changing the command envelope schema.

Implementation summary:

  • Extended the remote-host policy preflight with a session control mode resolver that reads sessionControlMode, sessionMode, controlState, or observeOnly command metadata.
  • Added a Blender mutation guard that denies commands in observe-only sessions when the command is in the Blender namespace and either carries a mutating risk class or requires safe-mutation, destructive, or project.write scopes.
  • Used the shared remote-protocol permission-scope inference so blender.object.create_primitive is blocked for the same safe-mutation and project-write reasons advertised by the protocol capability.
  • Added policy-preflight tests for observe-only denial, normal-control allow, and metadata normalization, plus a command-executor test proving the adapter handler is not called when observe-only denies the primitive mutation.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • Full typecheck, lint, build, formatting, and diff-check verification recorded in the progress table for the completed item.

180.C.10.04 Blender Scene Evidence Capture#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/src/blender-adapter.ts
  • apps/bellona/remote-host/src/blender-adapter.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/blender-adapter.ts for the existing queryRemoteHostBlenderSceneInfo(...) route, addon fallback behavior, and mock scene-info fixture handling.
  • apps/bellona/remote-gateway/src/artifact-registry.ts for canonical artifact metadata shape, supported screenshot purpose, SHA-256 requirements, and redaction status conventions.
  • libs/bellona/remote-protocol/src/audit.ts for protocol RemoteArtifact and RemoteAuditEvidence validation, including scene-snapshot artifacts and screenshot evidence.
  • apps/bellona/remote-host/src/blender-adapter.test.ts for adapter-level scene-info provider tests and mocked addon patterns.

Implementation summary:

  • Added captureRemoteHostBlenderSceneMutationEvidence(...), a host-side helper that captures scene-info before a mutation, runs the mutation callback, then captures scene-info again after the mutation.
  • Converts each scene-info snapshot into a protocol-valid scene-snapshot artifact with a deterministic artifact URI, byte size, SHA-256 hash, capture time, and compact metadata for active scene, object/material/camera/light counts, selected objects, and Phase 180 provenance.
  • Emits protocol-valid audit evidence for each scene snapshot and returns the mutation result alongside the ordered artifacts/evidence arrays.
  • Supports an optional viewport screenshot provider that can attach a protocol-valid screenshot artifact and screenshot evidence after the mutation, without implementing viewport rendering ahead of 180.C.18.05.
  • Added tests proving before/mutation/after execution order, scene snapshot artifact/evidence validity, relative object-count changes, and optional screenshot evidence attachment.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose
  • Final Prettier and diff-check verification recorded in the progress table for the completed item.

180.C.10.05 Blender Primitive Host Execution#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/src/blender-adapter.ts
  • apps/bellona/remote-host/src/blender-adapter.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/blender/python/bellona_addon/server.py for command envelope routing to registered addon handlers and addon error response behavior.
  • libs/bellona/blender/python/bellona_addon/handlers.py for the existing object.create_primitive handler result shape: object id, object name, scene-info object id, and undo checkpoint metadata.
  • apps/bellona/remote-host/src/blender-adapter.ts for the existing local-only addon WebSocket handshake, scene-info forwarding, and adapter capability registration.
  • apps/bellona/remote-host/src/blender-adapter.test.ts for mocked addon WebSocket route coverage.

Implementation summary:

  • Added the blender.object.create_primitive host capability and command handler to the local Blender adapter registration, using the protocol capability:blender-object-create-primitive fixture.
  • Implemented addon forwarding for primitive creation through object.create_primitive, flattening the Phase 180 command arguments into the addon payload while preserving the original nested arguments object for traceability.
  • Wrapped primitive creation with captureRemoteHostBlenderSceneMutationEvidence(...) so the host returns structured before/after scene-info artifact and evidence references with the mutation result.
  • Normalized addon primitive output into a command-result-safe object containing objectId, objectName, optional sceneInfoObjectId, optional undoCheckpoint, and evidenceReferences with ordered artifact/evidence ids.
  • Added a mocked addon integration test proving the host route handshakes with the addon, sends object.create_primitive, receives the structured object result, captures before/after scene-info, and returns evidence references.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose
  • Final Prettier and diff-check verification recorded in the progress table for the completed item.

180.C.10.06 Blender Primitive Mocked Adapter Coverage#

Changed files:

  • apps/bellona/remote-host/src/blender-adapter.ts
  • apps/bellona/remote-host/src/blender-adapter.test.ts
  • apps/bellona/remote-host/src/command-executor.test.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/blender/python/bellona_addon/handlers.py for primitive validation, undo checkpoint creation before mutation, and addon error behavior.
  • apps/bellona/remote-host/src/blender-adapter.ts for addon WebSocket handshake/command forwarding, scene-info evidence capture, and primitive result normalization.
  • apps/bellona/remote-host/src/command-executor.test.ts and apps/bellona/remote-host/src/policy-preflight.test.ts for observe-only host policy denial before adapter routing.
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts and libs/bellona/remote-protocol/src/policy.test.ts for shared project-write policy evaluation and pre-dispatch gateway rejection.

Implementation summary:

  • Added Blender-specific command-envelope parsing in executeRemoteHostBlenderCreatePrimitive(...) so invalid primitive payloads fail before any scene-info evidence capture or addon mutation request.
  • Extended the mocked Blender addon test harness with no-response and error response modes, then covered invalid primitive input, missing addon endpoint, mutation response timeout, and undo checkpoint failure.
  • Kept and expanded success coverage around the mocked addon route that returns object identity, undo checkpoint metadata, before/after scene evidence references, and forwarded addon payload details.
  • Added host command executor coverage proving observe-only still denies before adapter routing while a control session with the advertised project-write primitive capability completes through the mocked handler.
  • Added gateway command dispatcher coverage proving project-write allowed primitive commands dispatch to the host with policy/audit metadata, while a denied project.write permission blocks dispatch before the host sees the command.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • pnpm nx test @bellona/remote-gateway --verbose --skip-nx-cache
  • Remaining typecheck, lint, build, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.10.07 Optional Headless Blender Primitive Smoke#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/package.json
  • apps/bellona/remote-host/project.json
  • apps/bellona/remote-host/scripts/blender-create-primitive-smoke.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/scripts/blender-scene-info-smoke.ts for optional Blender lookup, skipped-versus-required behavior, temporary fixture handling, and background Blender process execution.
  • libs/bellona/blender/python/bellona_addon/handlers.py for direct handle_scene_info(...) and handle_object_create_primitive(...) handler invocation inside headless Blender.
  • apps/bellona/remote-host/package.json, project.json, and README for the existing optional smoke target naming and operator-facing documentation.

Implementation summary:

  • Added pnpm nx blender:create-primitive-smoke @bellona/remote-host, backed by scripts/blender-create-primitive-smoke.ts.
  • The smoke locates Blender via BELLONA_BLENDER_EXECUTABLE, the standard macOS app install, or PATH; missing Blender exits with a skipped summary unless --required, BELLONA_BLENDER_SMOKE_REQUIRED=1, or BELLONA_BLENDER_MUTATION_SMOKE_REQUIRED=1 is set.
  • When Blender is available, the smoke launches --background --factory-startup, creates and reopens a tiny fixture .blend, captures canonical scene-info before mutation, calls the real addon object.create_primitive handler with a material reference and undo checkpoint command id, captures scene-info after mutation, and validates that the object count increased by one.
  • The summary records the created object id, scene-info object id, undo checkpoint id, before/after object counts, selected object ids, active scene, active file path, and Blender executable.

Verification closure:

  • pnpm nx blender:create-primitive-smoke @bellona/remote-host --verbose --skip-nx-cache passed locally with /Applications/Blender.app/Contents/MacOS/Blender, reporting beforeObjectCount: 3, afterObjectCount: 4, sceneInfoObjectId: "object:Bellona Mutation Smoke Cube", selected object object:Bellona Mutation Smoke Cube, and undo checkpoint id undo-checkpoint:command:blender-create-primitive-smoke-001.
  • Full remote-host test, typecheck, lint, build, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.10.08 Blender Mutation Timeline CLI#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/package.json
  • apps/bellona/remote-host/project.json
  • apps/bellona/remote-host/scripts/blender-create-primitive-remote-smoke.ts
  • apps/bellona/remote-host/src/index.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/scripts/blender-scene-info-remote-smoke.ts for the existing ephemeral gateway/host CLI smoke, client event polling, timeline query, and audit summary output.
  • apps/bellona/remote-gateway/src/timeline.ts for how command progress and command result events appear in ordered timeline queries.
  • apps/bellona/remote-host/src/blender-adapter.ts for primitive creation provider injection, scene-info evidence capture, and evidence reference output.

Implementation summary:

  • Added pnpm nx blender:create-primitive-remote-smoke @bellona/remote-host, backed by scripts/blender-create-primitive-remote-smoke.ts.
  • The CLI starts an ephemeral Remote Gateway and Remote Host, registers the real Blender adapter capability, dispatches blender.object.create_primitive through the gateway command dispatcher, waits for the command result client event, and prints the mutation output.
  • The default CLI path uses deterministic in-process primitive and scene-info providers so command-result timeline visibility is testable without broad UI work or a live addon. --live-addon routes through the configured local Blender addon endpoint for manual runs.
  • The summary includes audit entry types, timeline event source/type strings, the command-store:command.result timeline event metadata, object identity, scene-info object id, undo checkpoint id, and evidence reference count.
  • Exported the primitive capability/command constants and primitive execution helper from the remote-host package index for CLI and later tool reuse.

Verification closure:

  • pnpm nx blender:create-primitive-remote-smoke @bellona/remote-host --verbose --skip-nx-cache passed locally, printing command.received, command.dispatched, and command.completed audit entries; command-store progress/result timeline events; mutation object Bellona Remote Mutation Cube; evidence reference count 4; and timeline result status succeeded.
  • Full remote-host test, typecheck, lint, build, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.10.09 Blender Primitive Rollback Documentation#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • docs/domains/bellona/extras/remote-control/blender-primitive-rollback-and-undo.md
  • docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/blender/python/bellona_addon/handlers.py for _create_undo_checkpoint(...), bpy.ops.ed.undo_push(...), and primitive handler ordering.
  • apps/bellona/remote-host/src/blender-adapter.ts for before/after scene-info evidence capture and primitive result undoCheckpoint plus evidenceReferences output.
  • apps/bellona/remote-host/scripts/blender-create-primitive-smoke.ts and blender-create-primitive-remote-smoke.ts for local hardware/headless and gateway timeline verification commands.

Implementation summary:

  • Added docs/domains/bellona/extras/remote-control/blender-primitive-rollback-and-undo.md documenting the primitive command rollback contract, checkpoint metadata, operator rollback procedure, guarantees, limitations, and required rollback note shape for 180.C.10.10.
  • Linked the rollback note from the remote-host README and the second-MacBook runbook evidence checklist.
  • Documented that the current MVP uses manual undo_stack rollback in the active Blender session and does not expose a remote rollback command.
  • Captured limitations around process-local undo history, intervening local edits, lack of scene lock, before/after scene-info not being a full scene restore snapshot, naming collisions, partial post-mutation failures, and the intentional absence of arbitrary Python rollback.

Verification closure:

  • Documentation-only change; no runtime code paths changed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.10.10 Blender Safe Mutation MVP Closure#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/scripts/blender-create-primitive-smoke.ts
  • docs/domains/bellona/extras/remote-control/blender-primitive-rollback-and-undo.md
  • docs/domains/bellona/extras/remote-control/blender-safe-mutation-mvp-closure.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/scripts/blender-create-primitive-smoke.ts for the existing live headless Blender mutation smoke and scene-info assertions.
  • apps/bellona/remote-host/scripts/blender-create-primitive-remote-smoke.ts for the remote gateway-host audit and timeline closure output.
  • libs/bellona/blender/python/bellona_addon/handlers.py for the primitive handler's _create_undo_checkpoint(...) ordering and addon result shape.
  • docs/domains/bellona/extras/remote-control/blender-primitive-rollback-and-undo.md for the operator rollback contract, limitations, and required review-note shape.

Implementation summary:

  • Extended the headless Blender primitive smoke to write and validate a rollback note after mutation evidence capture.
  • The smoke now attempts bpy.ops.ed.undo() and records the exact result. On Blender --background runs, the editor undo operator has no UI context, so the smoke records the bpy.ops.ed.undo.poll() error and restores the saved fixture file to verify the created object is absent after cleanup.
  • Added stage-closure documentation in docs/domains/bellona/extras/remote-control/blender-safe-mutation-mvp-closure.md, tying together protocol ownership, host policy, addon checkpointing, evidence capture, mocked failure-mode coverage, live Blender mutation evidence, remote audit/timeline evidence, and rollback notes.
  • Linked the closure evidence and updated rollback docs to clarify the difference between active-session operator undo and headless smoke fixture restore verification.

Verification closure:

  • pnpm nx blender:create-primitive-smoke @bellona/remote-host --verbose --skip-nx-cache passed locally with /Applications/Blender.app/Contents/MacOS/Blender, reporting beforeObjectCount: 3, afterObjectCount: 4, postRollbackObjectCount: 3, objectAbsent: true, undo checkpoint id undo-checkpoint:command:blender-create-primitive-smoke-001, and a rollback note recording the headless undo-context limitation plus successful fixture restore.
  • pnpm nx blender:create-primitive-remote-smoke @bellona/remote-host --verbose --skip-nx-cache passed locally, proving gateway audit entries command.received, command.dispatched, and command.completed; command-store result timeline visibility; mutation object Bellona Remote Mutation Cube; evidence reference count 4; and timeline result status succeeded.
  • Remaining remote-host test, typecheck, lint, build, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.11.01 Browser Adapter Capability Discovery#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.ts
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/browser-adapter.ts
  • apps/bellona/remote-host/src/browser-adapter.test.ts
  • apps/bellona/remote-host/src/index.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/blender-adapter.ts for adapter-local discovery/probe helpers, localhost-only endpoint metadata, protocol-valid adapter/capability registration, and injectable probes for deterministic tests.
  • apps/bellona/remote-host/src/adapter-registry.ts for default adapter registration, route-command behavior, health reporting, and immutable protocol-valid snapshots.
  • docs/domains/bellona/extras/remote-control/external-implementation-research-2026-04-21.md and compatibility-matrix.md for the Stage 180 browser decisions: Playwright first, CDP localhost-only, isolated managed profiles only, and real/default browser profiles blocked.
  • services/psyche/conferencing/src/video_conferencing/teams/browser.py for existing Playwright-style browser lifecycle patterns and the risk boundary around persistent user-data directories.

Implementation summary:

  • Added apps/bellona/remote-host/src/browser-adapter.ts, an in-process browser discovery adapter for browser.adapter.discovery.
  • Discovery now reports Chrome/Chromium executable availability and version, the Bellona-managed browser profile root, localhost-only CDP launch readiness, Playwright package availability, Playwright Chromium executable availability, and explicit realProfileAccess: "blocked" status.
  • The managed profile root defaults to a Bellona-owned host path and can be overridden with BELLONA_BROWSER_MANAGED_PROFILE_ROOT; real Chrome/Chromium profile paths such as Default, Profile N, Google Chrome user-data roots, and Chromium user-data roots are detected and block CDP launch support.
  • The adapter registers by default with the remote-host registry as adapter:browser-local and exposes only discovery capability at this stage. Launch, navigation, snapshot, and screenshot support remain false until later 180.C.11 items implement command schemas and isolated profile lifecycle.
  • Added unit coverage for successful discovery, missing browser/Playwright discovery, real-profile path blocking, protocol-valid registration, command routing, default registry inventory, health payload counts, and shutdown cleanup counts.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose
  • Final Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.11.02 Isolated Browser Managed Profile Creation#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/browser-adapter.ts
  • apps/bellona/remote-host/src/browser-adapter.test.ts
  • apps/bellona/remote-host/src/index.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/browser-adapter.ts from 180.C.11.01 for the Bellona-managed profile root, real profile path detection, and browser discovery adapter boundary.
  • docs/domains/bellona/extras/remote-control/compatibility-matrix.md and external-implementation-research-2026-04-21.md for the requirement that browser work use isolated user-data directories and keep real profiles blocked.
  • services/psyche/conferencing/src/video_conferencing/teams/browser.py for the existing Playwright persistent-context pattern, where user_data_dir is a sensitive boundary that must be controlled by the host.

Implementation summary:

  • Added createRemoteHostBrowserManagedProfile(...) to create isolated browser profile directories only under the Bellona-managed root.
  • Managed profiles use the bellona-profile- directory prefix, write a bellona-profile.json marker with cleanup metadata, and explicitly record personalProfileAccess: false.
  • Added cleanupRemoteHostBrowserManagedProfile(...), which recursively removes only validated managed profile directories under the configured root.
  • Added RemoteHostBrowserManagedProfileError and path guards that reject empty roots, cleanup paths that escape the managed root, and Chrome/Chromium real profile paths such as Default, Profile N, Google Chrome user-data roots, and Chromium user-data roots.
  • Extended browser adapter tests to cover creation, marker contents, cleanup, personal root rejection, and escaped cleanup path rejection.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose
  • Final Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.11.03 Browser Managed Command Schemas#

Implementation date: 2026-04-22

Files changed:

  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/src/browser.ts
  • libs/bellona/remote-protocol/src/browser.test.ts
  • libs/bellona/remote-protocol/src/device.test.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • generated libs/bellona/remote-protocol/contracts/**
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/blender.ts and blender.test.ts for command-name constants, argument schemas, specialized command-envelope validators, metadata constraints, fixtures, and parse helpers.
  • libs/bellona/remote-protocol/src/command.ts for risk class, timeout class, rollback strategy, dry-run metadata, target, and envelope rules.
  • libs/bellona/remote-protocol/src/schema-registry.ts and contract generation for JSON Schema/OpenAPI/proto-ready artifact ownership.
  • Browser decisions from 180.C.11.01 and 180.C.11.02: isolated managed profiles only, localhost-only CDP, and real browser profile access blocked.

Implementation summary:

  • Added canonical protocol schemas for browser.launch_managed, browser.navigate, browser.snapshot, browser.screenshot, and browser.close.
  • Added browser command argument schemas for isolated profile launch, HTTP/HTTPS navigation, page snapshot limits, screenshot format/redaction placeholders, and mandatory profile cleanup on close.
  • Added browser command metadata schemas that require isolated profiles, localhost-only CDP, and realProfileAccess: false.
  • Constrained browser.launch_managed and browser.close envelopes to safe-mutation, short timeout, dry-run metadata, and rollback metadata. Navigation, snapshot, and screenshot envelopes are read-only and use the standard timeout ceiling.
  • Added RemoteBrowserManagedSession for later host/runtime command results, protocol fixtures for the managed browser adapter and launch command, registry entries, generated contracts, and schema tests.

Verification closure:

  • pnpm nx contracts:generate @bellona/remote-protocol
  • pnpm nx contracts:check @bellona/remote-protocol
  • pnpm nx test @bellona/remote-protocol --verbose --skip-nx-cache
  • pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose
  • Final Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.11.04 Managed Browser Launch#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/package.json
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/browser-adapter.ts
  • apps/bellona/remote-host/src/browser-adapter.test.ts
  • apps/bellona/remote-host/src/index.ts
  • pnpm-lock.yaml
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/browser-adapter.ts for browser executable discovery, Playwright probing, managed profile creation, and cleanup policy.
  • apps/bellona/remote-host/src/adapter-registry.ts and policy-preflight.ts for capability advertisement and command routing.
  • libs/bellona/remote-protocol/src/browser.ts and generated fixtures for the canonical browser.launch_managed and browser.close command envelopes.
  • Local Playwright 1.57 type/runtime implementation for chromium.launchPersistentContext, persistent user-data directories, executable/channel options, and Chromium remote debugging flags.

Implementation summary:

  • Added the host managed-session browser capability capability:browser-managed-session for browser.launch_managed and browser.close.
  • Added production managed launch through Playwright using a Bellona-created isolated profile directory, an ephemeral 127.0.0.1 CDP port, and explicit validation of the returned WebSocket debugger URL before returning a RemoteBrowserManagedSession.
  • Added session storage, close handling, adapter shutdown cleanup, and launch failure cleanup so contexts and managed profiles are not leaked.
  • Kept real browser profile access blocked and rejected initialUrl launch navigation until 180.C.11.05 adds blocked-domain enforcement.
  • Added injected launcher and CDP port allocator seams for deterministic unit tests while retaining a real Playwright production launcher.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose
  • pnpm exec tsx -e "<managed browser launch/close smoke>"
  • Final Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.11.05 Browser Navigation And Snapshot#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/browser-adapter.ts
  • apps/bellona/remote-host/src/browser-adapter.test.ts
  • apps/bellona/remote-host/src/index.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/browser-adapter.ts for managed session storage, Playwright context handling, and close cleanup from 180.C.11.04.
  • libs/bellona/remote-protocol/src/browser.ts for the canonical browser.navigate and browser.snapshot argument/envelope parsers.
  • Existing host adapter route handlers and policy-preflight behavior for read-only command routing through advertised capabilities.
  • Local Playwright page APIs for page.goto, page.content, page.title, and browser-context page access.

Implementation summary:

  • Added browser.navigate and browser.snapshot handlers to the managed browser session capability.
  • Added blocked-domain enforcement before navigation and before snapshot capture. The default policy blocks credentialed URLs, localhost, .localhost, .local, loopback/private/link-local IPv4 ranges, and loopback/private/link local IPv6 ranges. Host config can add exact or wildcard blocked domains through BELLONA_BROWSER_BLOCKED_DOMAINS or adapter options.
  • Navigation updates the stored RemoteBrowserManagedSession.currentUrl and returns previous URL, final URL, response status, wait condition, and policy evidence.
  • Snapshot captures title, DOM, and text according to command arguments, enforces the maxBytes payload limit with truncation metadata, and returns policy evidence.
  • Tests cover successful launch, navigation, snapshot, blocked localhost navigation, close cleanup, and failed launch cleanup.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose
  • Final Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.11.06 Browser Screenshot Artifacts#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/browser-adapter.ts
  • apps/bellona/remote-host/src/browser-adapter.test.ts
  • apps/bellona/remote-host/src/index.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/audit.ts for canonical RemoteArtifact, RemoteAuditEvidence, screenshot artifact kind, redaction statuses, hashes, and evidence IDs.
  • apps/bellona/remote-host/src/blender-adapter.ts for adapter-local artifact metadata, SHA-256 evidence, and result-level audit reference patterns.
  • apps/bellona/remote-gateway/src/artifact-registry.ts for the downstream artifact registration metadata expected by gateway timeline/audit.
  • Local Playwright type definitions for page.screenshot, selector mask, and maskColor support.

Implementation summary:

  • Added the browser.screenshot host handler and advertised screenshot support in browser discovery, adapter metadata, health, and managed-session capability command names.
  • Screenshot capture now enforces the same blocked-domain policy as snapshots before any image capture.
  • Captured screenshot bytes are written under BELLONA_BROWSER_ARTIFACT_ROOT or the host default browser artifact root, with path containment checks, media type, byte size, and SHA-256 metadata.
  • The handler returns protocol-valid RemoteArtifact and RemoteAuditEvidence records, plus artifactIds, evidenceIds, and auditReferences suitable for the gateway artifact registry in the next routing task.
  • redactSelectors are wired through Playwright screenshot masks with black mask color and redaction hook placeholder IDs; screenshots without selectors are marked not-required, while masked screenshots are marked redacted.
  • Tests cover routed launch, navigation, snapshot, screenshot capture, masked selector redaction, local artifact file creation, schema-valid artifact and evidence references, blocked localhost navigation, close cleanup, and failed launch cleanup.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • pnpm nx typecheck @bellona/remote-host --verbose --skip-nx-cache
  • Final run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.11.07 Browser Test Expansion#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/src/browser-adapter.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/browser-adapter.test.ts for the existing managed-browser happy path, blocked navigation, launch failure cleanup, and isolated profile cleanup tests.
  • apps/bellona/remote-host/src/command-executor.test.ts for command timeout expectations already owned by the executor layer.
  • Browser adapter command fixtures for launch, navigate, snapshot, screenshot, and close routing through the in-memory adapter registry.

Implementation summary:

  • Expanded the browser fake page into spyable Playwright-style handles so tests can assert goto, content, evaluate, title, locator, and screenshot behavior directly.
  • Added timeout coverage proving browser.navigate passes command argument timeoutMs and waitUntil into Playwright navigation, and browser.screenshot passes command envelope timeout, image format, full-page flag, and quality into Playwright screenshot capture.
  • Added blocked-domain capture tests proving snapshot and screenshot reject a blocked current URL before reading page DOM/text/title, creating locators, or capturing screenshot bytes.
  • Added adapter-stop cleanup coverage proving active managed browser sessions close and remove their managed profiles when the adapter is stopped.
  • The browser adapter suite now has explicit coverage for launch, navigate, snapshot, screenshot, blocked domain, timeout propagation, explicit close cleanup, adapter-stop cleanup, failed launch cleanup, and managed profile path safety.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • pnpm nx typecheck @bellona/remote-host --verbose --skip-nx-cache
  • Final run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.11.08 Browser Gateway Route Visibility#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/src/app.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.ts
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • apps/bellona/remote-gateway/src/device-registry.test.ts
  • apps/bellona/remote-gateway/src/timeline.ts
  • apps/bellona/remote-host/src/gateway-connection.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-gateway/src/command-dispatcher.ts for existing gateway host dispatch, command-store event publication, audit-log writes, and policy/approval boundaries.
  • apps/bellona/remote-gateway/src/timeline.ts for how audit-log, artifact-store, lifecycle, and command-store events are merged into visible timelines.
  • apps/bellona/remote-gateway/src/artifact-registry.ts for gateway artifact purpose registration and audit-visible artifact metadata.
  • apps/bellona/remote-host/src/gateway-connection.test.ts for the existing diagnostics and Blender gateway-to-host-adapter routing pattern.
  • apps/bellona/remote-host/src/browser-adapter.test.ts for deterministic fake browser launcher, localhost CDP endpoint, managed profile, and cleanup coverage.

Implementation summary:

  • Wired the gateway command dispatcher to the gateway artifact registry so host-returned browser screenshot artifacts are registered as first-class gateway artifacts without inventing new artifact IDs.
  • Extracted artifact and evidence IDs from host command results using typed result fields plus embedded artifact, artifacts, and evidence objects; the gateway now carries those IDs into command.completed and command.failed audit entries and metadata.
  • Updated timeline command-result projection so browser screenshot artifacts and evidence IDs are visible from command-store timeline events as well as audit-log and artifact-store events.
  • Added a gateway test that routes a browser screenshot command to a connected host, receives a host result with artifact and evidence references, registers the screenshot artifact, and proves artifact-filtered timelines include command.completed, artifact.registered, and command.result.
  • Added a host gateway-connection integration test that dispatches browser.launch_managed and browser.close from a fake gateway through the host command executor into the real browser adapter registration using a fake managed browser launcher.
  • Updated the device registry test expectation to reflect that the canonical Phase 180 remote device fixture now advertises browser.navigate.

Verification closure:

  • pnpm nx test @bellona/remote-gateway --verbose --skip-nx-cache
  • pnpm nx typecheck @bellona/remote-gateway --verbose --skip-nx-cache
  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • pnpm nx typecheck @bellona/remote-host --verbose --skip-nx-cache
  • Final run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.11.09 Browser Profile Isolation Documentation#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • docs/domains/bellona/extras/remote-control/browser-profile-isolation.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/browser-adapter.ts for managed profile root validation, bellona-profile- creation, cleanup markers, real profile path rejection, localhost CDP metadata, and adapter/capability profile metadata.
  • libs/bellona/remote-protocol/src/browser.ts and libs/bellona/remote-protocol/README.md for browser command schema constraints requiring isolated profiles and localhost-only CDP.
  • libs/bellona/remote-protocol/src/policy.ts for profile-related permission scope inference and the split between browser.profile.isolated and browser.profile.real.
  • docs/domains/bellona/extras/remote-control/adr/ADR-0002-remote-control-threat-model.md for cookie, token, password-manager, authenticated-page, and prompt-injection risks that drive the real-profile block.
  • Existing 180.C.11.01 through 180.C.11.08 tracker notes for the Browser CDP MVP constraints already shipped in code.

Implementation summary:

  • Added docs/domains/bellona/extras/remote-control/browser-profile-isolation.md as the operator and agent-facing profile isolation policy for the Browser CDP MVP.
  • Documented the current allowed path: adapter:browser-local, capability:browser-managed-session, browser.launch_managed, isolated bellona-profile-* directories, localhost-only CDP, artifact/evidence references, and managed cleanup through browser.close.
  • Documented why personal profiles remain blocked: cookies, tokens, local storage, autofill, extensions, password-manager state, history, downloads, prompt injection, missing grants, missing approval UX, missing origin/storage policy, missing retention controls, and missing profile locks.
  • Documented future unlock criteria for real profiles, including a later ADR, explicit grants, policy preflight, approval details, spoofing tests, and manual hardware evidence on a controlled test profile.
  • Linked the new policy from the remote-host README where browser discovery and managed session behavior are already documented.

Verification closure:

  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • pnpm exec prettier --check apps/bellona/remote-host/README.md docs/domains/bellona/extras/remote-control/browser-profile-isolation.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md
  • git diff --check

180.C.11.10 Browser Remote CLI Closure#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/package.json
  • apps/bellona/remote-host/project.json
  • apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/scripts/blender-scene-info-remote-smoke.ts for the existing ephemeral gateway, remote host, identity, client event polling, and audit/timeline summary pattern.
  • apps/bellona/remote-host/scripts/blender-create-primitive-remote-smoke.ts for multi-step command dispatch and result validation through the same gateway-host path.
  • apps/bellona/remote-host/src/browser-adapter.ts for managed browser launch, navigation, snapshot, screenshot artifact, evidence, and close behavior.
  • apps/bellona/remote-gateway/src/command-dispatcher.ts and apps/bellona/remote-gateway/src/timeline.ts for artifact/evidence visibility added in 180.C.11.08.

Implementation summary:

  • Added apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts and the Nx/package target browser:managed-remote-smoke.
  • The CLI starts an ephemeral Remote Gateway and Remote Host, registers the real browser adapter, connects the host outbound over the normal gateway WebSocket path, and dispatches browser commands as a gateway client.
  • The live/default path launches an isolated Playwright Chromium session with a Bellona-managed profile root, localhost-only CDP, and temporary screenshot artifact root.
  • The CLI dispatches browser.launch_managed, browser.navigate, browser.snapshot, browser.screenshot, and browser.close sequentially, validates every command result, verifies the screenshot artifact file exists, verifies the managed browser profile no longer exists after close, and prints audit and timeline evidence.
  • The CLI supports --url, --keep-artifacts, and --mock-browser; the mock mode is for deterministic debugging while the default live mode is the signoff path.
  • Updated the remote-host README with the new command and its expected behavior.

Verification closure:

  • pnpm nx typecheck @bellona/remote-host --verbose --skip-nx-cache
  • pnpm nx browser:managed-remote-smoke @bellona/remote-host -- --mock-browser
  • pnpm nx browser:managed-remote-smoke @bellona/remote-host --verbose --skip-nx-cache
  • Final run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.11.11 Browser Compensating Actions#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts
  • apps/bellona/remote-host/src/browser-adapter.test.ts
  • apps/bellona/remote-host/src/gateway-connection.test.ts
  • docs/domains/bellona/extras/remote-control/browser-compensating-actions.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • libs/bellona/remote-protocol/src/browser.test.ts
  • libs/bellona/remote-protocol/src/browser.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/command.ts and common.ts for the RollbackStrategy metadata model from 180.C.03.14 and the primitive-only command metadata value constraint.
  • libs/bellona/remote-protocol/src/browser.ts for existing Browser CDP MVP safe-mutation metadata, read-only metadata, command schemas, and managed session contracts.
  • Existing browser command fixtures and host tests to preserve gateway, adapter, and smoke-script compatibility while adding compensating-action references.
  • docs/domains/bellona/extras/remote-control/browser-profile-isolation.md for the current managed-profile cleanup policy and the explicit decision that real browser profile/account state remains blocked.

Implementation summary:

  • Added a protocol-owned browser compensating-action catalog with stable action ids, mutating command names, rollback strategies, action kinds, labels, descriptions, suggested command names, verification methods, and limitations.
  • Documented current reversal paths: browser.launch_managed compensates with browser.close plus managed-profile cleanup, while browser.close is manual_remediation_only because the isolated profile is intentionally removed.
  • Added future action kinds for back-navigation, cancel-navigation, delete-download, revoke-form-submission, and manual remediation so future browser mutations cannot become routable without a truthful reversal path.
  • Populated current mutating browser command metadata with compensating_action_id and primitive summary fields that comply with RemoteCommandEnvelope metadata validation.
  • Registered the new browser compensating-action schemas for generated JSON Schema, OpenAPI, and proto manifest contract artifacts.
  • Updated browser protocol tests, host browser close fixtures, gateway connection tests, and the managed browser remote smoke script to carry the current compensating-action references.
  • Added docs/domains/bellona/extras/remote-control/browser-compensating-actions.md with the operator-facing catalog, future mutation requirements, and the 180.C.11.12 dispatch-boundary note.

Verification closure:

  • pnpm nx test @bellona/remote-protocol --verbose --skip-nx-cache
  • pnpm nx typecheck @bellona/remote-protocol --verbose --skip-nx-cache
  • pnpm nx contracts:generate @bellona/remote-protocol --verbose --skip-nx-cache
  • pnpm nx contracts:check @bellona/remote-protocol --verbose --skip-nx-cache
  • pnpm nx test @bellona/remote-host --verbose --skip-nx-cache
  • pnpm nx typecheck @bellona/remote-host --verbose --skip-nx-cache
  • Final run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.11.12 Browser Compensating Action Dispatch Gate#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts
  • apps/bellona/remote-host/src/browser-adapter.test.ts
  • apps/bellona/remote-host/src/gateway-connection.test.ts
  • docs/domains/bellona/extras/remote-control/browser-compensating-actions.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • libs/bellona/remote-protocol/src/browser-compensating-actions.ts
  • libs/bellona/remote-protocol/src/browser.test.ts
  • libs/bellona/remote-protocol/src/browser.ts
  • libs/bellona/remote-protocol/src/command.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/policy.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • RemoteCommandEnvelopeSchema in libs/bellona/remote-protocol/src/command.ts because gateway dispatch and host command.dispatch parsing use the generic command envelope before adapter execution.
  • Browser-specific command envelope schemas in libs/bellona/remote-protocol/src/browser.ts, which already constrain browser.launch_managed and browser.close to safe-mutation metadata.
  • apps/bellona/remote-gateway/src/command-dispatcher.ts, where commands are parsed before policy evaluation, host reservation, audit dispatch entries, or WebSocket send.
  • Existing policy tests that use hypothetical future browser commands for permission mapping; these were adjusted so future browser mutations do not bypass the new dispatch gate.

Implementation summary:

  • Added browser-compensating-actions.ts as the shared browser compensating action requirement registry used by both browser-specific schemas and the generic command envelope schema.
  • Made metadata.compensating_action_id mandatory for RemoteBrowserSafeMutationCommandMetadata and constrained it to the declared browser compensating action id set.
  • Added schema validation that rejects missing, unknown, or command-mismatched browser compensating action ids for mutating browser envelopes.
  • Added generic RemoteCommandEnvelopeSchema validation so gateway dispatch and host command.dispatch message parsing reject malformed mutating browser commands before host reservation or adapter execution.
  • Updated gateway tests to prove invalid browser mutations fail before host dispatch and leave no command dispatch/audit side effects.
  • Updated browser, host, policy, and smoke fixtures to use stable literal action id constants, then regenerated protocol contract artifacts.

Verification closure:

  • pnpm nx test @bellona/remote-protocol --verbose --skip-nx-cache
  • pnpm nx typecheck @bellona/remote-protocol --verbose --skip-nx-cache
  • pnpm nx test @bellona/remote-gateway --verbose --skip-nx-cache
  • pnpm nx typecheck @bellona/remote-host --verbose --skip-nx-cache
  • Final contracts, run-many, browser smoke, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.12.01 Control Room Placement Decision#

Implementation date: 2026-04-22

Files changed:

  • docs/domains/bellona/extras/remote-control/adr/ADR-0006-control-room-placement.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • 180.C.02.07 Yemaya Studio Web/Desktop audit notes, which already found that Yemaya provides useful React, Playwright, Electron, IPC, and native-shell patterns but does not own remote device/session/timeline/approval/stream/audit authority.
  • docs/domains/bellona/extras/remote-control/adr/ADR-0001-standalone-remote-gateway-and-host.md, which rejects placing privileged remote-control authority in Yemaya Studio and keeps the gateway/host boundary Bellona-owned.
  • docs/domains/bellona/extras/remote-control/adr/ADR-0005-mvp-release-artifact-and-gates.md, which names the Bellona Control Room MVP as part of the MVP alpha artifact.
  • docs/domains/bellona/extras/remote-control/compatibility-matrix.md, which already points to a browser-first Bellona Control Room with a desktop wrapper deferred.
  • apps/yemaya/studio-web/project.json and apps/yemaya/studio-desktop/project.json for the reusable Vite/React, Playwright, Electron, and native packaging target shapes.

Implementation summary:

  • Added ADR-0006 and accepted apps/bellona/control-room as the MVP Control Room placement.
  • Rejected adding the MVP Control Room as primary routes inside apps/yemaya/studio-web or apps/yemaya/studio-desktop.
  • Documented reuse rules: take Yemaya Web's React/Vite, route, store, API, and Playwright patterns as references; take Yemaya Desktop's secure Electron, deep-link, native packaging, multi-window, multi-monitor, fullscreen, PiP, and permission UX patterns later as wrapper references.
  • Documented that the MVP Control Room is an operational app surface: gateway-backed, protocol-owned, status-first, low-chrome, and Playwright covered from the first scaffold.

Verification closure:

  • Documentation-only change; no UI code was scaffolded in this item.
  • Final Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.12.02 Control Room Scaffold#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/README.md
  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/index.html
  • apps/bellona/control-room/package.json
  • apps/bellona/control-room/playwright.config.ts
  • apps/bellona/control-room/project.json
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/config.ts
  • apps/bellona/control-room/src/main.tsx
  • apps/bellona/control-room/src/styles.css
  • apps/bellona/control-room/src/test/setup.ts
  • apps/bellona/control-room/tsconfig.json
  • apps/bellona/control-room/vite.config.ts
  • apps/bellona/control-room/vitest.config.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • pnpm-lock.yaml
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/yemaya/studio-web/project.json, package.json, vite.config.ts, vitest.config.ts, playwright.config.ts, and tsconfig.json for the existing Vite/React/Nx app shape and test target conventions.
  • Existing Bellona remote-control app and library project metadata for tags, target names, and remote-control surface ownership.
  • Root TypeScript, ESLint, pnpm hoisting, and catalog setup so the new app uses repo-standard resolution without introducing a new toolchain.
  • ADR-0006 placement decision, which requires a browser-first apps/bellona/control-room app with Playwright coverage from the first route and no privileged renderer/Electron bridge.

Implementation summary:

  • Added apps/bellona/control-room as a Bellona-owned Vite React application with Nx build, serve, dev, preview, test, e2e, lint, and typecheck targets.
  • Added the /control-room route and root redirect behavior behind VITE_BELLONA_CONTROL_ROOM_ENABLED; the default route state remains disabled, including production builds unless the flag is explicitly set.
  • Added a restrained operator shell scaffold with gateway, feature flag, and production exposure status plus workspace tabs for devices, timeline, approvals, stream, and audit placeholders.
  • Added Vitest coverage for the feature flag, disabled route, enabled route, and workspace switching.
  • Added Playwright coverage for default-disabled exposure, enabled desktop shell rendering, workspace switching, and responsive overflow checks across desktop and Pixel 5 projects.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • The Playwright interactive js_repl hook was unavailable in this Codex session, so UI signoff used the repository Playwright e2e target.

180.C.12.03 Control Room Device List UI#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/package.json
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/device-list.test.ts
  • apps/bellona/control-room/src/device-list.ts
  • apps/bellona/control-room/src/styles.css
  • apps/bellona/control-room/tsconfig.json
  • apps/bellona/control-room/vite.config.ts
  • apps/bellona/control-room/vitest.config.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • pnpm-lock.yaml
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/device.ts for canonical device, adapter, capability, permission, status, and network-mode fields.
  • libs/bellona/remote-protocol/src/session.ts for active session status and device-to-session relationships.
  • libs/bellona/remote-protocol/src/fixtures.ts for existing Bellona remote device, adapter, permission, and active session fixtures.
  • apps/bellona/remote-gateway/src/device-registry.ts and apps/bellona/remote-gateway/src/session-lifecycle.ts for existing registry and active-session semantics. The gateway does not yet expose a public device-list HTTP route, so the gated UI uses protocol fixtures as its local data source for this task.

Implementation summary:

  • Added a protocol-backed device-list model that maps RemoteDevice and RemoteSession records into Control Room summaries for paired-device count, online count, active-session count, adapter-health aggregation, and permission-gap placeholders.
  • Added a second fixture device so the UI exercises both online and degraded states, active and inactive session states, available/degraded/unavailable/ blocked adapter health, and missing/approval-required permission gaps.
  • Reworked the default Devices workspace from placeholders into selectable paired-device rows plus a selected-device inspector.
  • Added Vitest coverage for the model and UI selection behavior.
  • Expanded Playwright coverage to assert device-list rendering, online state, active session state, degraded adapter health, permission gaps, and desktop/mobile viewport fit.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • The Playwright interactive js_repl hook remains unavailable in this Codex session, so UI signoff used the repository Playwright e2e target.

180.C.12.04 Control Room Session Timeline UI#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/session-timeline.test.ts
  • apps/bellona/control-room/src/session-timeline.ts
  • apps/bellona/control-room/src/styles.css
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/command.ts for command envelope, priority, risk, approval, timeout, and target metadata.
  • libs/bellona/remote-protocol/src/result.ts for command progress states, terminal result states, error/remediation metadata, and retry metadata.
  • libs/bellona/remote-protocol/src/audit.ts for approval-request states and audit event vocabulary.
  • libs/bellona/remote-protocol/src/session.ts for session lifecycle and active-session metadata.
  • apps/bellona/remote-gateway/src/timeline.ts and apps/bellona/remote-gateway/src/timeline.test.ts for the gateway's existing session, command, approval, stream, and artifact timeline aggregation model.
  • libs/bellona/remote-protocol/src/fixtures.ts for canonical command, progress, result, approval, device, and session fixtures. The Control Room still has no public gateway timeline API client in this stage, so the gated UI uses protocol fixtures as a local data source.

Implementation summary:

  • Added a protocol-backed session-timeline model that maps command envelopes, progress events, results, and pending approval requests into operator-facing timeline rows.
  • Covered all required item states with deterministic fixture rows: queued, started, progress, completed, failed, denied, and approval-required.
  • Replaced the Timeline placeholder with a selectable session timeline, progress bars, command-state metrics, and a selected-command inspector showing state, command name, risk class, actor, adapter, command ID, and status detail.
  • Added Vitest model coverage and React interaction coverage for timeline rendering and row selection.
  • Expanded Playwright coverage to verify all required timeline states on the enabled desktop and mobile projects while preserving disabled-by-default route behavior.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • The Playwright interactive js_repl hook remains unavailable in this Codex session, so UI signoff used the repository Playwright e2e target.

180.C.12.05 Control Room Approval UI#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/approval-queue.test.ts
  • apps/bellona/control-room/src/approval-queue.ts
  • apps/bellona/control-room/src/styles.css
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-gateway/src/approval-service.ts for the Stage 07 pending-request store, approve-once continuation dispatch, deny-by-default expiry, denied-reason requirement, and audit/metric behavior.
  • apps/bellona/remote-gateway/src/approval-service.test.ts for approve, deny, expiry, and continuation semantics expected by the gateway service.
  • libs/bellona/remote-protocol/src/audit.ts for canonical approval request statuses and decision schemas.
  • libs/bellona/remote-protocol/src/policy.ts for policy evaluation, required scopes, approval scopes, dry-run flags, and human-readable policy reasons.
  • apps/bellona/remote-gateway/src/app.ts for public HTTP routes. The gateway does not yet expose an approval-decision API route, so this task keeps the feature-gated Control Room fixture-backed while mirroring Stage 07 service semantics through protocol types.

Implementation summary:

  • Added a protocol-backed approval-queue model that maps approval requests, approval decisions, and policy evaluations into operator-facing queue items.
  • Implemented approve once, deny, and timeout transitions with Stage 07-aligned semantics: approval dispatches a single continuation, denial requires an operator reason, and timeout records deny-by-default expiry without dispatch.
  • Replaced the Approvals placeholder with pending/terminal approval rows, queue metrics, policy explanation blocks, a deny-reason field, action controls, and a selected-approval inspector.
  • Added Vitest coverage for approval queue totals, policy explanation, approve once, deny, and timeout transitions.
  • Expanded React and Playwright coverage so desktop and mobile gated Control Room runs exercise approve once, deny, timeout, policy explanation, and the disabled-by-default route.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • The Playwright interactive js_repl hook remains unavailable in this Codex session, so UI signoff used the repository Playwright e2e target.
  • No live macOS host, Blender, Unreal, WebRTC stream, or real gateway approval endpoint is activated by this task.

180.C.12.06 Control Room Stream Descriptor Placeholder#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/stream-preview.test.ts
  • apps/bellona/control-room/src/stream-preview.ts
  • apps/bellona/control-room/src/styles.css
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/stream.ts for canonical RemoteStreamDescriptor, source, state, quality, health, signaling, ICE, TURN, network-mode, codec, and dimension contracts.
  • libs/bellona/remote-protocol/src/fixtures.ts for the existing Blender viewport stream descriptor, source fixture, fake WebRTC signaling records, stream-health values, dimensions, and redaction-required metadata.
  • apps/bellona/remote-gateway/src/timeline.ts and apps/bellona/remote-gateway/src/timeline.test.ts for audit-backed stream timeline events and screenshot artifact/evidence references.
  • docs/domains/bellona/extras/remote-control/external-implementation-research-2026-04-21.md and docs/domains/bellona/extras/remote-control/compatibility-matrix.md for the rule that command/control remains independent from WebRTC media and that TURN/direct media must be gateway-authorized later.
  • TODOS/phase-180-reference.md for the MVP requirement to support display, app, browser, Blender, Unreal, and screenshot-only stream modes over time, with screenshot-only accepted before full WebRTC.

Implementation summary:

  • Added a protocol-backed stream-preview model that maps the existing RemoteStreamDescriptor fixture into a Control Room stream descriptor item.
  • Introduced an explicit screenshot-only placeholder state machine with idle, active, paused, resumed, and stopped transitions while keeping WebRTC transport marked pending.
  • Replaced the Stream placeholder panel with descriptor metrics, a visual screenshot placeholder viewport, start/pause/resume/stop controls, descriptor selection, and a selected-stream inspector.
  • Added Vitest coverage for descriptor mapping and screenshot-only state transitions.
  • Expanded React and Playwright coverage so desktop and mobile gated Control Room runs exercise the screenshot-only placeholder flow while preserving the disabled-by-default route.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • The Playwright interactive js_repl hook remains unavailable in this Codex session, so UI signoff used the repository Playwright e2e target.
  • No live macOS screen capture, Blender viewport media, Unreal viewport media, WebRTC peer connection, TURN relay, or gateway stream endpoint is activated by this task.

180.C.12.07 Control Room WebRTC MVP#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/stream-preview.test.ts
  • apps/bellona/control-room/src/stream-preview.ts
  • apps/bellona/control-room/src/styles.css
  • apps/bellona/control-room/src/webrtc-loopback.test.ts
  • apps/bellona/control-room/src/webrtc-loopback.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/stream.ts and libs/bellona/remote-protocol/src/fixtures.ts for the canonical one-source Blender viewport stream descriptor, WebRTC signaling metadata, direct/TURN flags, stream-health values, codec, dimensions, and redaction metadata.
  • apps/bellona/control-room/src/stream-preview.ts for the existing descriptor-backed screenshot fallback state machine from 180.C.12.06.
  • apps/lilith/svc-webrtc/src/ice-utils.ts, apps/lilith/svc-webrtc/src/types.ts, and the svc-webrtc tests for existing ICE/TURN terminology, service health, room, participant, QoS, and connection-test conventions.
  • services/psyche/conferencing/src/video_conferencing/gateway/session.py and analytics.py for reconnect-attempt and stream-health reporting patterns.
  • libs/yemaya/collaboration/src/voice/voice-video-manager.ts for existing browser/native WebRTC abstraction and reconnect terminology in TypeScript.

Implementation summary:

  • Added a native browser RTCPeerConnection loopback probe for the one Blender viewport source. The probe performs local offer/answer negotiation, opens a data channel, measures a round-trip health ping, closes cleanly, and fails closed when browser WebRTC is unavailable.
  • Extended the Control Room stream model with WebRTC negotiating, active, reconnecting, failed, unsupported, and stopped states while preserving the screenshot-only fallback flow from the prior item.
  • Surfaced explicit transport, health, round-trip, reconnect-count, and direct/TURN status in the stream workspace and selected-stream inspector.
  • Added Start WebRTC, Reconnect WebRTC, Stop, screenshot fallback, and pause/resume controls with deterministic state transitions and stale-probe cleanup on stop/unmount.
  • Expanded Vitest coverage for the WebRTC state machine and unsupported-browser behavior.
  • Expanded Playwright coverage so both desktop and mobile opt-in Control Room projects exercise WebRTC start, reconnect, health, direct/TURN status, and stop against Chromium's real WebRTC implementation.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • The Playwright interactive js_repl hook remains unavailable in this Codex session, so UI signoff used the repository Playwright e2e target.
  • Hardware/media evidence is limited to Chromium desktop and mobile local WebRTC loopback in CI-style Playwright. No live macOS capture, Blender viewport media, Unreal viewport media, TURN relay, gateway stream endpoint, host, or real-device media flow is activated by this task.

180.C.12.08 Control Room Playwright Coverage#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/src/App.tsx
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/control-room/e2e/control-room.spec.ts for the current gated route, device roster, timeline, approval, stream placeholder, WebRTC, and overflow e2e coverage.
  • apps/bellona/control-room/playwright.config.ts for the desktop opt-in, mobile opt-in, and default-disabled projects that exercise the Control Room against separate enabled/disabled dev servers.
  • apps/bellona/control-room/src/device-list.ts, session-timeline.ts, approval-queue.ts, and stream-preview.ts for the fixture-backed labels and stable data-testid contracts the e2e tests should assert.

Implementation summary:

  • Added explicit Playwright coverage inventories for required device rows, timeline states, and approval rows, replacing one-off assertions with table-driven checks.
  • Tightened the device-list e2e coverage to assert both paired fixture devices, online/degraded state, active session state, and permission-gap summaries.
  • Tightened the timeline e2e coverage to assert queued, started, progress, completed, failed, denied, and approval-required rows through the shared required-state inventory.
  • Tightened approval e2e coverage to assert pending, denied, and timed-out approval rows before exercising approve once, deny, and timeout actions.
  • Tightened stream placeholder coverage to assert initial pause/stop disabled states, screenshot start, pause, resume, stop, nav state updates, and stop disabled after the stream is stopped.
  • Fixed the screenshot fallback start control so it is disabled while the screenshot placeholder is already active.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • The Playwright interactive js_repl hook remains unavailable in this Codex session, so UI signoff used the repository Playwright e2e target.
  • Hardware/media evidence is not applicable to this test-coverage task beyond the browser Playwright runs. No live macOS capture, Blender viewport media, Unreal viewport media, TURN relay, gateway stream endpoint, host, or real-device media flow is activated.

180.C.12.09 Control Room Operator Workflow#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/README.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/operator-workflow-blender-browser-mvp.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md for the current blender.scene.info two-MacBook runbook, outbound host path, and live addon fallback expectations.
  • docs/domains/bellona/extras/remote-control/blender-safe-mutation-mvp-closure.md and blender-primitive-rollback-and-undo.md for the blender.object.create_primitive command, evidence refs, undo checkpoint, rollback note, and live-addon smoke behavior.
  • docs/domains/bellona/extras/remote-control/browser-profile-isolation.md and browser-compensating-actions.md for isolated-profile policy, localhost CDP, browser command scope, screenshot artifacts, cleanup, and compensating-action requirements.
  • apps/bellona/remote-host/README.md, project.json, and the committed smoke scripts for the exact Blender and browser CLI commands operators can run today.
  • apps/bellona/control-room/README.md and the current Control Room e2e coverage for the fixture-backed operator surface and live-subscription limitation before 180.C.12.10.

Implementation summary:

  • Added a single operator-facing workflow doc for watching the current Blender and browser MVP commands from the Control Room context.
  • Documented the current support split: Control Room device/timeline/approval and stream lanes are fixture-backed, while live Blender/browser command evidence currently comes from remote-host CLI smokes.
  • Documented safe startup, safety boundaries, watch points, evidence to record, and stop conditions for blender.scene.info, blender.object.create_primitive, and managed-profile browser automation.
  • Linked the new workflow from the Control Room README so operators can find it beside the app startup instructions.
  • Explicitly handed off the live UI subscription gap to 180.C.12.10 rather than claiming it is already complete.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • This is a documentation-only workflow task. No live macOS capture, Blender viewport media, browser session, TURN relay, gateway stream endpoint, host, or real-device media flow is activated by this task.

180.C.12.10 Control Room Observe And Approval Closure#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/README.md
  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/approval-queue.ts
  • apps/bellona/control-room/src/session-timeline.test.ts
  • apps/bellona/control-room/src/session-timeline.ts
  • apps/bellona/control-room/src/styles.css
  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/app.test.ts
  • apps/bellona/remote-gateway/src/app.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/operator-workflow-blender-browser-mvp.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/control-room/src/session-timeline.ts and approval-queue.ts for the fixture-backed command states, pending approval request shape, Stage 07 policy explanation, and approve/deny state reducer.
  • apps/bellona/control-room/e2e/control-room.spec.ts and App.test.tsx for the existing gated Control Room UI coverage, responsive shell expectations, approval actions, and timeline assertions.
  • apps/bellona/remote-gateway/src/approval-service.ts, command-dispatcher.ts, timeline.ts, and persistent-store.ts for the real gateway approval continuation path, timeline query shape, stored approval requests/decisions, and command progress/result event sources.
  • docs/domains/bellona/extras/remote-control/session-timeline-and-audit-bundle.md and the 180.C.12.09 operator workflow for the current operator evidence model and the live-vs-fixture boundary.

Implementation summary:

  • Added a Review workspace to the Control Room that places observed command progress, pending approval context, approve/deny controls, decision outcome, and screenshot-first stream status in one operator flow.
  • Connected approval decisions to the local timeline model so approving appends a completed continuation event and denying appends a denied decision event with the operator reason.
  • Aligned the pending approval fixture with the pending timeline approval event so the review flow is command-correlated instead of separate UI demos.
  • Added gateway HTTP support for GET /v1/approvals and POST /v1/approvals/:requestId/decisions, backed by the existing approval service and fail-closed request validation.
  • Updated Control Room and gateway README guidance and the operator workflow doc to reflect the combined review flow and HTTP approval endpoint.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • playwright-interactive was opened as required, but this Codex session does not expose the js_repl tool required by that skill. UI signoff therefore used the repository Playwright e2e target.
  • The stage is verified with fixture-backed browser automation and gateway HTTP unit coverage. No live macOS capture, Blender viewport media, Unreal viewport media, TURN relay, host, or real-device media flow is activated.

180.C.12.11 Control Room First-Run Onboarding#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/styles.css
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/control-room/src/App.tsx for the existing feature-gated shell, workspace navigation, Review workspace, device roster, timeline, approval queue, stream preview, and inspector composition.
  • apps/bellona/control-room/src/device-list.ts for paired-device totals, online/session counts, adapter health, missing permission summaries, and the existing permission-scope vocabulary.
  • apps/bellona/control-room/src/session-timeline.ts for empty timeline behavior, active-session command state totals, and approval-required event fixtures.
  • Existing App.test.tsx and Control Room Playwright coverage for feature-flag gating, desktop/mobile workspace navigation, approval decisions, stream controls, and responsive shell behavior.
  • The mandatory frontend-skill and playwright-interactive workflows for user-facing UI work. playwright-interactive could not be fully executed because this Codex session does not expose its required js_repl tool.

Implementation summary:

  • Added a first-load "What do I do next?" onboarding runway inside the existing Control Room shell, with next-step text that responds to paired devices, active sessions, and pending approval state.
  • Added an operator-side guided pairing walkthrough covering host pairing, identity confirmation, observe-only start, and one-action approval.
  • Added keyboard-focusable, hover-visible permission tooltips that explain observe-only versus project write in plain operator language.
  • Added true empty states for no paired devices, no session timeline, and no Review workspace command progress.
  • Added explicit workspace-tab ARIA labels so the dense visual nav has stable, screen-reader-friendly names and robust test selectors.
  • Extended unit and Playwright coverage for first-run guidance, empty states, and permission tooltip visibility.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • playwright-interactive was opened as required, but this Codex session does not expose the js_repl tool required by that skill. UI signoff therefore used the repository Playwright e2e target.
  • Desktop and mobile Playwright coverage exercises the first-run guide in the enabled Control Room route, and Chromium desktop verifies the custom permission tooltips. Unit tests cover the no-device/no-session empty states.
  • No live macOS capture, Blender viewport media, Unreal viewport media, TURN relay, host, gateway stream subscription, or real-device media flow is activated by this fixture-backed UI onboarding task.

180.C.12.12 Control Room Keyboard Shortcuts#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/README.md
  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/styles.css
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/control-room/src/App.tsx for approval actions, Review workspace state, stream controls, first-run onboarding, and workspace nav patterns.
  • apps/bellona/control-room/src/approval-queue.ts for existing approve-once, deny, and timeout reducer semantics.
  • apps/bellona/control-room/src/stream-preview.ts for screenshot preview pause/resume/stop state transitions and WebRTC stop behavior.
  • Existing unit and Playwright tests for approval, stream, review, responsive shell, and first-run coverage.
  • Repo search for prior keyboard/hotkey implementations found no Control Room-specific shortcut infrastructure, so this task introduced the first local Control Room shortcut map instead of reusing an app-level shortcut package.
  • The mandatory frontend-skill and playwright-interactive workflows for user-facing UI work. playwright-interactive could not be fully executed because this Codex session does not expose its required js_repl tool.

Implementation summary:

  • Added a canonical Control Room shortcut definition map for approve once, deny, pause stream, resume stream, stop stream, and request takeover.
  • Added a global Ctrl+Alt shortcut handler that ignores editable fields, prevents browser defaults for matched shortcuts, and routes actions through the existing approval and stream reducers.
  • Added a local operator takeover request state that switches the operator to the Review workspace and records whether takeover was requested from the keyboard or the visible map button.
  • Added a visible shortcut cheat sheet with per-shortcut browser-default conflict checks and live readiness/requested state.
  • Added aria-keyshortcuts to the concrete approval, denial, stop, pause, resume, and takeover controls.
  • Documented the shortcut map and browser-default conflict check in the Control Room README.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • playwright-interactive was opened as required, but this Codex session does not expose the js_repl tool required by that skill. UI signoff therefore used the repository Playwright e2e target.
  • Unit tests cover shortcut rendering, approve/deny keyboard actions, takeover, stream pause/resume/stop keyboard actions, and the editable-field guard.
  • Desktop and mobile Playwright coverage exercises the visible shortcut map, browser-default conflict text, takeover, approve, deny, and stream pause/resume/stop shortcuts.
  • No live macOS capture, Blender viewport media, Unreal viewport media, TURN relay, host, gateway stream subscription, OS notification, or real-device media flow is activated by this fixture-backed UI shortcut task.

180.C.12.13 Control Room Desktop Notifications#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/README.md
  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/styles.css
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/control-room/src/App.tsx for workspace shell placement, shortcut controls, approval queue rendering, timeline rendering, device list rendering, and local browser state patterns.
  • apps/bellona/control-room/src/approval-queue.ts for pending and denied approval event semantics.
  • apps/bellona/control-room/src/session-timeline.ts for completed, denied, and approval-required timeline event semantics.
  • apps/bellona/control-room/src/device-list.ts for host online, degraded, offline, health, and permission status semantics.
  • Existing unit and Playwright tests for fixture-backed Control Room shell, responsive layout, keyboard shortcuts, approval, stream, timeline, and device coverage.
  • Browser Notification API behavior from official browser/spec documentation: support detection, permission states, permission request flow, and constructor-based delivery while the browser app is open. Native cross-platform push/service-worker channels remain deferred to 180.C.31.06 and 180.C.34.
  • The mandatory frontend-skill and playwright-interactive workflows for user-facing UI work. playwright-interactive could not be fully executed because this Codex session does not expose its required js_repl tool.

Implementation summary:

  • Added a Control Room desktop notification preferences panel using the browser Notification API as the macOS Notification Center MVP delivery path.
  • Added support and permission detection for unsupported, default, denied, and granted notification states without constructing notifications before permission is granted.
  • Added persisted per-event preferences for approval-required, host-offline, long-running completion, and policy-denial notification classes.
  • Derived notification events from existing approval queue, device list, and session timeline fixtures so the UI exercises the same control-plane states already used elsewhere in Control Room.
  • Added visible delivery status, muted-state handling, and per-event send controls for deterministic automation and operator feedback.
  • Documented the MVP scope, local persistence, macOS browser-to-Notification Center route, and deferred cross-platform/native/mobile push scope in the Control Room README.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • playwright-interactive was opened as required, but this Codex session does not expose the js_repl tool required by that skill. UI signoff therefore used the repository Playwright e2e target.
  • Unit tests cover permission request, notification construction, muted preferences, delivery status, and localStorage persistence with a mocked Notification implementation.
  • Desktop and mobile Playwright coverage exercises the notification preferences panel, the four event classes, a mocked successful OS notification delivery, and per-event muting.
  • No live macOS Notification Center prompt/delivery, APNs/FCM push, service worker push, native shell notification bridge, host, gateway stream subscription, Blender/Unreal media, or real-device notification flow is activated by this fixture-backed browser notification MVP.

180.C.12.14 Mobile Approval-Only PWA#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/README.md
  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/index.html
  • apps/bellona/control-room/public/control-room-sw.js
  • apps/bellona/control-room/public/icons/mobile-approval.svg
  • apps/bellona/control-room/public/manifest.webmanifest
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/mobile-approval-pwa.ts
  • apps/bellona/control-room/src/styles.css
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/control-room/src/App.tsx route gating, approval decision reducers, operator review controls, and existing notification support.
  • apps/bellona/control-room/src/approval-queue.ts approval item shape, pending/approved/denied statuses, decision reason behavior, and totals.
  • apps/bellona/control-room/e2e/control-room.spec.ts opt-in desktop/mobile Playwright projects and existing route-level mobile coverage.
  • apps/yemaya/studio-web PWA patterns for manifest metadata, service worker registration, push capability checks, PushManager, service worker notification display, and notification action messages.
  • Official browser documentation for web app manifests, service workers, Notification permission, Push API capability, push events, and service-worker showNotification/notificationclick behavior.
  • The mandatory frontend-skill and playwright-interactive workflows for user-facing UI work. playwright-interactive could not be fully executed because this Codex session does not expose its required js_repl tool.

QA inventory:

  • User-visible claims: /mobile-approvals is approval-only, responsive, installable as a PWA, can approve once or deny, exposes push capability, and can return notification actions to the approval route.
  • Controls covered: enable push alerts, send approval alert, approve once, deny, notification action deny message, full Control Room link, and mobile viewport no-horizontal-overflow check.
  • Off-happy-path coverage: unsupported/blocked push state is modeled in the snapshot helper and tests mock service-worker action delivery separately from button decisions.

Implementation summary:

  • Added the /mobile-approvals feature-flagged route with a focused approval-only mobile layout, large touch targets, queue totals, pending approval detail, deny reason editing, recent decision history, and a link back to the full Control Room.
  • Added a mobile PWA manifest, standalone mobile metadata, SVG app icon, and a static service worker at /control-room-sw.js.
  • Added service-worker push handling for approval payloads with approve-once and deny notification actions.
  • Added service-worker notification-click handling that focuses or opens the mobile approval route and posts action messages back to open clients.
  • Added browser capability detection for service workers, PushManager, and Notification permission.
  • Added service-worker registration and local notification preview from the mobile route so the same route can be tested without a live gateway push endpoint.
  • Documented the mobile PWA route, push/service-worker scope, and the current gateway VAPID subscription gap in the Control Room README.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • playwright-interactive was opened as required, but this Codex session does not expose the js_repl tool required by that skill. UI signoff therefore used the repository Playwright e2e target.
  • Unit tests cover mobile route rendering, service worker registration, Notification permission request, approval notification preview, approve-once decisions, and service-worker notification-action denial messages.
  • Desktop and mobile Playwright coverage exercises /mobile-approvals, the manifest, service worker push script, push setup, notification preview, service-worker action delivery, and mobile viewport fit.
  • No live phone install, APNs/FCM delivery, VAPID/gateway push subscription, production push provider, native mobile shell, host, gateway stream subscription, Blender/Unreal media, or real-device notification flow is activated by this fixture-backed mobile approval PWA task.

180.C.12.15 Operator Command Palette#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/README.md
  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/command-palette.test.ts
  • apps/bellona/control-room/src/command-palette.ts
  • apps/bellona/control-room/src/styles.css
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/namespaces.ts as the canonical source of remote command namespaces and wildcard patterns.
  • apps/bellona/control-room/src/App.tsx for shell placement, approval workspace transitions, global shortcut behavior, and audit-style visible status patterns.
  • apps/bellona/control-room/src/approval-queue.ts for approval-required terminology, decisions, and deny-by-default posture.
  • Existing Control Room unit and Playwright tests for fixture-backed UI flows, responsive layout, accessible names, and e2e no-overflow coverage.
  • Repo search for prior command palette implementations found no reusable Control Room palette; this task introduced a local, protocol-derived registry while preserving the no-hidden-privileged-path rule.
  • The mandatory frontend-skill and playwright-interactive workflows for user-facing UI work. playwright-interactive could not be fully executed because this Codex session does not expose its required js_repl tool.

Implementation summary:

  • Added a protocol-derived command palette registry with one command entry for every REMOTE_COMMAND_NAMESPACE_VALUES namespace.
  • Added search by namespace, command name, title, and description.
  • Added a visible command detail panel with protocol namespace, risk, approval posture, audit evidence, and editable payload preview.
  • Enforced approval-required-by-default posture for every ad-hoc palette entry.
  • Added queueing behavior that records an audit preview entry and switches the operator to the approval workspace without dispatching to a host.
  • Added palette result accessible names that do not conflict with existing stream-control button assertions or browser/default shortcut behavior.
  • Documented the command palette, protocol namespace source, approval posture, and no-live-dispatch scope in the Control Room README.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • playwright-interactive was opened as required, but this Codex session does not expose the js_repl tool required by that skill. UI signoff therefore used the repository Playwright e2e target.
  • Unit tests cover namespace coverage, search filtering, audit entry creation, UI command search, payload editing, approval queue navigation, and visible audit capture.
  • Desktop and mobile Playwright coverage exercises command palette search, command selection, payload editing, approval-required queueing, audit capture, and the existing stream/shortcut no-regression paths.
  • No live host dispatch, gateway command enqueue API, real approval service request creation, macOS control, browser profile control, Blender/Unreal mutation, or real-device flow is activated by this fixture-backed palette.

180.C.12.16 First-Session Guided Tour#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/README.md
  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/first-session-tour.test.ts
  • apps/bellona/control-room/src/first-session-tour.ts
  • apps/bellona/control-room/src/styles.css
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/control-room/src/App.tsx first-run onboarding, command palette, approval workspace, and stream preview state transitions.
  • apps/bellona/control-room/src/command-palette.ts for protocol command registry entries covering blender.scene.query and browser.navigate.
  • apps/bellona/control-room/src/stream-preview.ts for the screenshot-only MVP start-screenshot transition and mobile stream layout constraints.
  • apps/oshun/web/src/components/onboarding/FeatureTour.tsx as a prior first-time feature-tour pattern with persisted completion behavior.
  • Existing Control Room unit and Playwright coverage for fixture-backed UI flows, mobile viewport fit, and no-regression checks.
  • The mandatory frontend-skill and playwright-interactive workflows for user-facing UI work. playwright-interactive could not be fully executed because this Codex session does not expose its required js_repl tool.

Implementation summary:

  • Added a typed first-session tour model for the required Blender read-only, browser navigate, and screenshot MVP checkpoints.
  • Kept the path within five fixture-backed minutes and persisted completed checkpoints in local browser storage.
  • Wired the Blender and browser checkpoints into the command palette's approval-required audit queue, so the tour uses the same command registry and approval workspace transitions as ad-hoc operator commands.
  • Wired the screenshot checkpoint into the existing stream MVP start-screenshot state transition.
  • Added responsive tour styling and tightened mobile stream-frame sizing so the tour-completed screenshot state does not create horizontal page overflow.
  • Documented the first-session tour route, persistence, command reuse, and no-live-dispatch scope in the Control Room README.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • playwright-interactive was opened as required, but this Codex session does not expose the js_repl tool required by that skill. UI signoff therefore used the repository Playwright e2e target.
  • Unit tests cover the tour's required checkpoint order, five-minute budget, persisted completion normalization, current-step calculation, UI-driven Blender/browser audit queueing, and screenshot preview completion.
  • Desktop and mobile Playwright coverage exercises the full first-session path: Blender read-only queue, browser navigate queue, screenshot MVP activation, completion progress, and mobile viewport fit.
  • No live Blender instance, browser automation backend, gateway command enqueue, approval-service dispatch, host stream transport, real screenshot capture, or hardware evidence is activated by this fixture-backed first-session tour.

180.C.13.01 macOS Permission Detection#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/control-room/README.md
  • apps/bellona/control-room/e2e/control-room.spec.ts
  • apps/bellona/control-room/src/App.test.tsx
  • apps/bellona/control-room/src/App.tsx
  • apps/bellona/control-room/src/device-list.test.ts
  • apps/bellona/control-room/src/device-list.ts
  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/app.test.ts
  • apps/bellona/remote-gateway/src/app.ts
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/adapter-registry.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/app.ts
  • apps/bellona/remote-host/src/macos-permissions.test.ts
  • apps/bellona/remote-host/src/macos-permissions.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/bellona/remote-protocol/src/fixtures.ts for the existing desktop.observe and desktop.input permission scopes, blocked desktop fallback adapter fixture, and host permission-source vocabulary.
  • apps/bellona/remote-host/src/adapter-registry.ts for the host diagnostics adapter, adapter/capability inventory reporting, and prior placeholder missing-permission shape.
  • apps/bellona/remote-host/src/app.ts and apps/bellona/remote-gateway/src/host-connections.ts for the outbound host handshake path that registers the host's RemoteDevice report in the gateway device registry.
  • apps/bellona/control-room/src/device-list.ts and existing Control Room tests for device summaries, adapter health, and permission-gap rendering.
  • Apple macOS APIs for Screen Recording and Accessibility state: CGPreflightScreenCaptureAccess() and AXIsProcessTrusted().
  • The mandatory frontend-skill and playwright-interactive workflows for user-facing UI work. playwright-interactive could not be fully executed because this Codex session does not expose its required js_repl tool.

Implementation summary:

  • Added a host macOS permission detector that probes Screen Recording and Accessibility through local Swift calls on Darwin and returns deterministic not-applicable state on non-macOS platforms.
  • Mapped Screen Recording to desktop.observe and Accessibility to desktop.input, with missing or unknown TCC state advertised as denied host permissions and granted TCC state still requiring gateway/operator approval.
  • Applied the macOS permission report to the host RemoteDevice before gateway handshake registration, including device metadata for missing count, state, and checked timestamp.
  • Extended the host diagnostics adapter and health/readiness payloads with the same macOS permission report and remediation text.
  • Added GET /v1/devices to the gateway so Control Room and future operators can inspect gateway-held device permission diagnostics.
  • Updated Control Room device summaries and selected-device inspector labels to include host-sourced missing-permission reasons for Screen Recording and Accessibility.
  • Documented the host detector behavior, gateway device inventory endpoint, and Control Room permission diagnostics.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • playwright-interactive was opened as required, but this Codex session does not expose the js_repl tool required by that skill. UI signoff therefore used the repository Playwright e2e target.
  • Unit tests cover injected macOS permission detection, permission mapping, device-report mutation, non-macOS no-op behavior, host diagnostics snapshots, host health/readiness state, gateway device inventory output, and Control Room permission-reason rendering.
  • Control Room Playwright coverage asserts that macOS Screen Recording and Accessibility remediation text reaches the selected-device inspector.
  • Hardware evidence remains limited to API-level behavior and injected probes; a live signed/notarized macOS host, real TCC prompts, permission revocation, and Settings-guided remediation remain later packaging and hardware tasks.

180.C.13.02 Desktop Screenshot#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/adapter-registry.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/desktop-screenshot.test.ts
  • apps/bellona/remote-host/src/desktop-screenshot.ts
  • apps/bellona/remote-host/src/index.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/browser-adapter.ts for screenshot artifact creation, artifact-root containment, redaction metadata, audit evidence, and command-result output shape.
  • apps/bellona/remote-gateway/src/command-dispatcher.ts for host-returned artifact collection and gateway artifact registration from command results.
  • apps/bellona/remote-gateway/src/artifact-registry.ts for screenshot artifact metadata validation, audit emission, and timeline visibility.
  • libs/bellona/remote-protocol/src/fixtures.ts and libs/bellona/remote-protocol/src/policy.ts for the existing desktop.observe scope and desktop.screenshot policy inference.
  • services/psyche/computer-use/src/computer_use/vision/screenshot.py and libs/iris/agents/computer-use/src/screen-capture.ts as prior screenshot abstraction references. Those implementations are Linux/simulated oriented, so this task implemented a macOS host command instead of coupling to them.
  • Local macOS screencapture(1) command behavior for selected display (-D), selected window (-l), PNG output (-t png), region (-R), and silent capture (-x).

Implementation summary:

  • Added a desktop.screenshot host adapter registration on adapter:desktop-fallback with capability capability:desktop-screenshot.
  • Implemented display capture through screencapture -D <display> and known window capture through screencapture -l <windowid>, with a test-injectable capture backend.
  • Enforced macOS-only execution and fail-closed Screen Recording permission checks using the 180.C.13.01 permission report.
  • Added retained PNG artifact writing under BELLONA_DESKTOP_ARTIFACT_ROOT or the platform default DesktopArtifacts directory.
  • Added blackout-region redaction hooks that operate on retained PNG bytes before artifact write, record hook placeholders/labels/region hashes, and fail if requested redaction does not return redacted output.
  • Returned protocol-valid RemoteArtifact and RemoteAuditEvidence records in the same artifact/artifacts/artifactIds/evidence/evidenceIds shape already consumed by the gateway.
  • Added the desktop screenshot capability to protocol fixtures so device reports and policy evaluation can advertise desktop.screenshot.
  • Extended gateway command-dispatcher coverage to prove host-returned desktop.screenshot artifacts are registered in the artifact registry and visible through audit/timeline queries.
  • Documented host command arguments, artifact retention, redaction behavior, and gateway command-result artifact registration.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • Unit tests cover display capture, window capture, Screen Recording denial, non-macOS denial, adapter/capability wiring, PNG blackout redaction, artifact and evidence validity, gateway artifact registration, and protocol fixture validity.
  • No live TCC prompt, real physical display capture, real app-window capture, or operator-approved desktop fallback session was exercised. Those require the MAC-HOST-01 hardware rig and later window/focus/acceptance tasks.

180.C.13.03 Desktop Window List And Focus#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/adapter-registry.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/desktop-screenshot.test.ts
  • apps/bellona/remote-host/src/desktop-screenshot.ts
  • apps/bellona/remote-host/src/desktop-window.test.ts
  • apps/bellona/remote-host/src/desktop-window.ts
  • apps/bellona/remote-host/src/index.ts
  • libs/bellona/remote-protocol/src/desktop.test.ts
  • libs/bellona/remote-protocol/src/desktop.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/policy.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/desktop-screenshot.ts for the existing desktop fallback adapter registration, macOS-only execution, TCC fail-closed checks, command-handler wiring, and test-injectable native backends.
  • apps/bellona/remote-host/src/macos-permissions.ts for Swift-based TCC probes and mapping Screen Recording to desktop.observe and Accessibility to desktop.input.
  • libs/bellona/video/src/capture/index.ts for the only local macOS window-list precedent. That code uses simplified AppleScript text parsing and placeholder bounds, so this task implemented structured CoreGraphics/AppKit output instead of reusing it.
  • libs/iris/agents/computer-use/desktop/src/window-manager.ts for expected window-manager semantics around list, focus, focused state, and action results. That implementation is simulated and was used as a behavior reference only.
  • libs/bellona/remote-protocol/src/browser.ts, libs/bellona/remote-protocol/src/blender.ts, and the schema registry for the established protocol-owned command schema pattern.

Implementation summary:

  • Added protocol-owned desktop window schemas for bounds, display, window records, selectors, list/focus command arguments, list/focus command envelopes, and list/focus command results.
  • Added desktop.window.list and desktop.window.focus capabilities to adapter:desktop-fallback without creating a second desktop adapter.
  • Implemented a macOS Swift helper using CoreGraphics for window inventory, AppKit for frontmost application/display resolution, and Accessibility for raising the matched AX window during focus.
  • Enforced macOS-only execution. Window listing requires Screen Recording; window focus requires both Screen Recording and Accessibility before the native backend is invoked.
  • Returned structured list output with app name, title, bounds, display id/index, owner pid, layer, z-order, on-screen state, alpha, and focused state.
  • Returned structured focus output with the requested selector, matched window, verified post-focus window, focus method, boolean result, and reason string.
  • Extended protocol fixtures and policy inference so desktop.window.list carries desktop.observe and desktop.window.focus carries desktop.observe plus desktop.input.
  • Documented gateway command-result behavior for non-artifact desktop window results.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • Unit tests cover protocol schema defaults and envelope validation, injected list/focus backends, Screen Recording denial, Accessibility denial, non-macOS denial, adapter capability/handler wiring, registry counts, and host app health counts.
  • A local native-helper sanity command extracted the embedded Swift source and executed the desktop.window.list path with limit: 1; it returned {"ok":true,"windowCount":1} on the current macOS workstation.
  • The Swift helper was designed for real macOS CoreGraphics/AX execution, but no live hardware focus operation, real TCC prompt, or human-visible app activation was exercised in CI. That evidence remains blocked on the MAC-HOST-01 rig and later coordinate/click/acceptance tasks.

180.C.13.04 Desktop Coordinate Normalization#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/desktop-coordinate.test.ts
  • apps/bellona/remote-host/src/desktop-coordinate.ts
  • apps/bellona/remote-host/src/desktop-window.ts
  • apps/bellona/remote-host/src/index.ts
  • libs/bellona/remote-protocol/src/desktop.test.ts
  • libs/bellona/remote-protocol/src/desktop.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • libs/iris/agents/computer-use/src/screen-capture.ts for region validation, screen bounds clamping, and capture scaling concepts. That code is simulated and screen-buffer oriented, so this task reused the concepts rather than the implementation.
  • libs/iris/agents/computer-use/desktop/src/window-manager.ts for window-relative bounds semantics and focused-window metadata.
  • libs/bellona/remote-protocol/src/stream.ts for existing stream capture region shape and deviceScaleFactor metadata.
  • apps/bellona/remote-host/src/desktop-window.ts for current macOS window bounds, display id/index, and focus metadata.

Implementation summary:

  • Added protocol-owned coordinate schemas for coordinate spaces, points, pixel sizes, display context, screenshot context, stream context, normalize arguments, and normalize results.
  • Extended desktop window display metadata with scaleFactor and updated the macOS Swift window helper to report NSScreen.backingScaleFactor for the matched display.
  • Added normalizeRemoteHostDesktopCoordinate() as a pure host helper using absolute macOS display points as the canonical intermediate coordinate space.
  • Implemented conversions between display points, display pixels, window-relative points, window-relative pixels, screenshot pixels, and stream-normalized coordinates.
  • Added optional clamping to the target coordinate space so later click/input tasks can reject or constrain stale/out-of-bounds points before dispatch.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • Protocol tests cover coordinate context/result validation. Host tests cover Retina display-pixel to window-relative conversion, window point-to-pixel conversion, screenshot-to-stream and stream-to-screenshot conversion, target clamping, and missing context errors.
  • No live click/input dispatch or end-to-end visual coordinate verification was performed; those remain blocked on 180.C.13.05, 180.C.13.06, and 180.C.13.10.

180.C.13.05 Desktop Click Fallback#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/desktop-click.test.ts
  • apps/bellona/remote-host/src/desktop-click.ts
  • apps/bellona/remote-host/src/desktop-screenshot.test.ts
  • apps/bellona/remote-host/src/desktop-screenshot.ts
  • apps/bellona/remote-host/src/desktop-window.ts
  • apps/bellona/remote-host/src/index.ts
  • libs/bellona/remote-protocol/src/desktop.test.ts
  • libs/bellona/remote-protocol/src/desktop.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/desktop-window.ts for focused-window resolution, app/title/window-id selectors, display metadata, and macOS Screen Recording/Accessibility preflight style.
  • apps/bellona/remote-host/src/desktop-coordinate.ts for Retina-aware coordinate conversion and focused-window boundary checks.
  • apps/bellona/remote-host/src/desktop-screenshot.ts for desktop fallback adapter composition, macOS-only fail-closed behavior, and command-result audit payload style.
  • Apple Core Graphics documentation for creating and posting mouse events with CGEvent and the HID event tap.

Implementation summary:

  • Added protocol-owned desktop.click command, arguments, metadata, result, allowlist, mouse button, desktop-control grant, target, and envelope schemas.
  • Added capability:desktop-click to the desktop fallback adapter and default fixture inventory.
  • Implemented clickRemoteHostDesktop() so it fails closed unless macOS Screen Recording and Accessibility are granted, a desktop.input control grant is present, the selected window is currently focused, and the focused window matches the command allowlist.
  • Reused the existing desktop.window.list backend to resolve the focused target and normalizeRemoteHostDesktopCoordinate() to convert the requested coordinate to an absolute display point.
  • Added a Swift Core Graphics backend that posts mouse moved/down/up events through CGEvent and cghidEventTap after all host-side policy checks pass.
  • Rejected coordinates that normalize outside the focused window instead of dispatching clicks to neighboring windows or the desktop.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • Protocol tests cover allowlist validation, desktop-control grant validation, click argument defaults, click result validation, and command-envelope metadata requirements.
  • Host tests cover focused allowlisted click dispatch with a mocked backend, missing focus denial, denied-window allowlist rejection, out-of-window coordinate rejection, missing Accessibility denial, non-macOS denial, adapter capability/handler wiring, registry counts, and health counts.
  • A local native-helper sanity command extracted the embedded Swift click source and executed it without a click request; it compiled and returned {"error":"Missing BELLONA_DESKTOP_CLICK_REQUEST JSON.","ok":false} before any input dispatch.
  • No live hardware click was dispatched. Real macOS pointer movement and visual after-click confirmation remain blocked on 180.C.13.06 and desktop fallback acceptance in 180.C.13.10.

180.C.13.06 Desktop Click Visual Verification#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/desktop-click.test.ts
  • apps/bellona/remote-host/src/desktop-click.ts
  • apps/bellona/remote-host/src/desktop-screenshot.ts
  • apps/bellona/remote-host/src/index.ts
  • libs/bellona/remote-protocol/src/desktop.test.ts
  • libs/bellona/remote-protocol/src/desktop.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/desktop-screenshot.ts for screenshot artifact, evidence, redaction, and gateway command-result registration shape.
  • apps/bellona/remote-host/src/desktop-click.ts for guarded click dispatch and normalized coordinate audit output.
  • apps/bellona/remote-host/src/blender-adapter.ts for before/after evidence ordering around mutating operations.

Implementation summary:

  • Added protocol-owned visualVerification arguments and click result fields for before/after screenshot artifact ids and evidence ids.
  • Wired the desktop adapter so desktop.click captures a before screenshot, dispatches the click, then captures an after screenshot by reusing desktop.screenshot against the focused target window.
  • Kept the screenshot path artifact-compatible with the existing gateway command-result artifact registration instead of introducing a parallel artifact mechanism.
  • Added host coverage proving the ordering is before screenshot, click backend, after screenshot, and proving the click output contains the before/after artifact and evidence references.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • Protocol tests cover visual-verification defaults and click result reference shape. Host tests cover mocked before/after screenshot providers, ordering, and returned artifact/evidence ids.
  • No live hardware click or real before/after screenshot pair was captured. Live visual proof remains blocked on desktop fallback acceptance in 180.C.13.10.

180.C.13.07 Desktop Fallback Emergency Stop#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/adapter-registry.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/command-executor.test.ts
  • apps/bellona/remote-host/src/command-executor.ts
  • apps/bellona/remote-host/src/desktop-click.ts
  • apps/bellona/remote-host/src/desktop-emergency-stop.ts
  • apps/bellona/remote-host/src/desktop-screenshot.test.ts
  • apps/bellona/remote-host/src/desktop-screenshot.ts
  • apps/bellona/remote-host/src/index.ts
  • libs/bellona/remote-protocol/src/desktop.test.ts
  • libs/bellona/remote-protocol/src/desktop.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/command-executor.ts for existing running-command cancellation, timeout, lifecycle progress, and result emission.
  • apps/bellona/remote-host/src/adapter-registry.ts for route-time handler dispatch and adapter capability advertisement.
  • apps/bellona/remote-host/src/desktop-screenshot.ts and apps/bellona/remote-host/src/desktop-click.ts for native macOS command boundaries that need cooperative abort checks.

Implementation summary:

  • Added protocol-owned desktop.emergency_stop arguments, result, target, and envelope schemas, with schema-registry coverage and protocol tests.
  • Added capability:desktop-emergency-stop to the macOS desktop fallback adapter while keeping the stop command handled by the host executor so it can bypass the desktop command queue.
  • Serialized desktop fallback commands through a desktop-only host queue. desktop.emergency_stop interrupts matching queued commands immediately and cancels matching running desktop commands by command id, session scope, or device scope.
  • Added abort-signal propagation through the adapter registry. desktop.click checks the signal before visual-verification screenshots and before Core Graphics input dispatch; desktop.screenshot forwards the signal to screencapture.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • Protocol tests validate emergency-stop defaults, result shape, and envelope metadata requirements. Host tests prove a running desktop command is aborted, a second desktop command remains queued, and desktop.emergency_stop returns both interrupted command ids while both affected executions resolve as cancelled.
  • No live hardware emergency stop was exercised against a real macOS click or screenshot process. Live proof remains blocked on desktop fallback acceptance in 180.C.13.10.

180.C.13.08 Desktop Fallback Test Coverage#

Implementation date: 2026-04-22

Files changed:

  • apps/bellona/remote-host/src/desktop-click.test.ts
  • apps/bellona/remote-host/src/desktop-screenshot.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/desktop-screenshot.test.ts for screenshot artifact, redaction, missing Screen Recording, and adapter capability assertions.
  • apps/bellona/remote-host/src/desktop-click.test.ts for denied-window, allowlist, coordinate-normalization, missing Accessibility, and mocked click dispatch coverage.
  • apps/bellona/remote-host/src/desktop-coordinate.test.ts and apps/bellona/remote-host/src/command-executor.test.ts for existing coordinate-normalization and emergency-stop queue coverage.

Implementation summary:

  • Added a missing Screen Recording denial test for desktop.click, proving the click backend is not called when observation permission is absent.
  • Added a direct emergency-stop abort-signal test for desktop.click, proving a stop raised after the before screenshot prevents native click dispatch.
  • Added a screenshot backend signal propagation test, proving desktop.screenshot forwards the executor abort signal into the capture backend while preserving artifact/evidence output.
  • Confirmed existing tests already cover denied windows, allowlist denial, coordinate normalization, screenshot artifact generation, mocked click dispatch, and queued/running emergency stop cancellation.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • No live macOS permission prompt, click, screenshot process abort, or hardware emergency-stop exercise was performed. Live proof remains blocked on desktop fallback acceptance in 180.C.13.10.

180.C.13.09 Desktop Fallback Selection Policy#

Implementation date: 2026-04-23

Files changed:

  • apps/bellona/remote-host/README.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/README.md for current desktop screenshot, window, coordinate, click, visual-verification, and emergency-stop behavior.
  • docs/domains/bellona/extras/remote-control/adr/ADR-0001-standalone-remote-gateway-and-host.md for the Bellona-owned gateway/host boundary and Psyche fallback boundary.
  • docs/domains/bellona/extras/remote-control/adr/ADR-0002-remote-control-threat-model.md for the requirement that desktop fallback stay visibly degraded, policy-gated, cancellable, and safer than arbitrary remote desktop control.
  • The tracker ground rules for deep-integration-first, localhost adapters, and no hidden privileged path.

Implementation summary:

  • Added a Desktop Fallback Selection Policy section to the remote-host README.
  • Documented desktop fallback as the last-resort control surface, allowed only when typed/domain adapters cannot complete the visible UI task and the target app/window is focused, selected, allowlisted, permissioned, auditable, screenshot-verified, and interruptible.
  • Documented when Blender, Unreal, and browser adapters must be used instead of fallback input, including scene/editor/browser state operations where adapters provide structured execution or verification.
  • Documented prohibited fallback uses: arbitrary shell, arbitrary Blender Python, Unreal console commands, credential or secret entry, financial or publishing actions, OS security prompts, real-profile credential flows, destructive project/file changes, and any hidden privileged path.

Verification closure:

  • Automated verification is recorded in the progress table for this completed item.
  • This item is documentation-only. No live macOS desktop fallback, Blender, Unreal, or browser hardware behavior was exercised.

180.C.13.10 Desktop Fallback Remote CLI Closure#

Implementation date: 2026-04-23

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/package.json
  • apps/bellona/remote-host/project.json
  • apps/bellona/remote-host/scripts/desktop-fallback-remote-smoke.ts
  • apps/bellona/remote-host/src/desktop-click.test.ts
  • apps/bellona/remote-host/src/desktop-click.ts
  • apps/bellona/remote-host/src/desktop-screenshot.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/scripts/blender-scene-info-remote-smoke.ts, apps/bellona/remote-host/scripts/blender-create-primitive-remote-smoke.ts, and apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts for the existing ephemeral gateway, outbound host, identity, client event polling, audit, artifact, and timeline smoke pattern.
  • apps/bellona/remote-host/src/desktop-window.ts, apps/bellona/remote-host/src/desktop-screenshot.ts, and apps/bellona/remote-host/src/desktop-click.ts for desktop focus, screenshot, click, coordinate, and visual-verification behavior.
  • apps/bellona/remote-gateway/src/command-dispatcher.ts and apps/bellona/remote-gateway/src/approval-service.ts for approval-required command continuation, command result routing, artifact registration, and audit ordering.

Implementation summary:

  • Added apps/bellona/remote-host/scripts/desktop-fallback-remote-smoke.ts and Nx/package targets named desktop:fallback-remote-smoke.
  • The CLI starts an ephemeral Remote Gateway and Remote Host, registers the desktop fallback adapter, connects the host outbound over the normal gateway WebSocket path, and dispatches desktop.window.focus, desktop.screenshot, and desktop.click as a gateway client.
  • The deterministic default path injects in-process macOS desktop backends so CI can verify command routing, desktop approval requests/decisions, focused window matching, screenshot artifact registration, click dispatch, before/after visual-verification references, audit entries, and timeline visibility without real input injection.
  • The CLI also accepts --live-macos for a configured MacBook with Screen Recording and Accessibility grants. On the current workstation those TCC grants are missing, so no native pointer movement or real window screenshot was claimed.
  • Fixed approved desktop click envelopes by stripping the parent command's approvalRequestId from internal desktop.window.list and before/after desktop.screenshot helper envelopes, which must remain approvalRequired: false.
  • Promoted click before/after visual-verification artifacts and evidence ids to top-level click result references so the gateway can audit and register them through the existing command-result artifact path.
  • Added focused-window click coverage proving an approved click envelope does not leak approval metadata into the internal window-list command.

Verification closure:

  • pnpm nx desktop:fallback-remote-smoke @bellona/remote-host --verbose --skip-nx-cache passed, reporting focus on window 81310, screenshot artifact artifact:desktop-fallback-remote-smoke-screenshot-001-desktop-screenshot, click visual verification status captured, before/after artifact and evidence ids, approval request/decision audit entries, command completion audit entries, artifact-store timeline visibility, and click command-store timeline visibility.
  • pnpm --silent exec tsx -e "import { createRemoteHostMacPermissionDetector } from './apps/bellona/remote-host/src/macos-permissions.ts'; console.log(JSON.stringify(createRemoteHostMacPermissionDetector().detect(), null, 2));" reported missing Screen Recording and Accessibility on the current Mac, so the native --live-macos path was not run to completion here.
  • Remaining host/protocol/gateway lint, typecheck, test, build, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.13.11 Desktop Compensating-Action Framework#

Implementation date: 2026-04-23

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/scripts/desktop-fallback-remote-smoke.ts
  • apps/bellona/remote-host/src/command-executor.test.ts
  • apps/bellona/remote-host/src/desktop-click.test.ts
  • apps/bellona/remote-host/src/desktop-click.ts
  • apps/bellona/remote-host/src/desktop-emergency-stop.ts
  • apps/bellona/remote-host/src/desktop-window.test.ts
  • apps/bellona/remote-host/src/desktop-window.ts
  • docs/domains/bellona/extras/remote-control/desktop-compensating-actions.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • libs/bellona/remote-protocol/src/command.ts
  • libs/bellona/remote-protocol/src/desktop-compensating-actions.ts
  • libs/bellona/remote-protocol/src/desktop.test.ts
  • libs/bellona/remote-protocol/src/desktop.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • Browser compensating-action catalog and enforcement in libs/bellona/remote-protocol/src/browser-compensating-actions.ts, libs/bellona/remote-protocol/src/browser.ts, and libs/bellona/remote-protocol/src/command.ts.
  • Browser operator documentation in docs/domains/bellona/extras/remote-control/browser-compensating-actions.md.
  • Existing desktop fallback mutating command schemas, host capability metadata, command tests, and the deterministic remote smoke added through 180.C.13.10.

Implementation summary:

  • Added a protocol-owned desktop compensating-action catalog with stable action ids for desktop.window.focus, desktop.click, and desktop.emergency_stop.
  • Added desktop compensating-action schemas for action id, kind, verification, suggested command, mutating command name, and full action descriptors.
  • Populated current desktop mutating command metadata with compensating_action_id, primitive action-kind fields, verification method, and rollbackStrategy: "manual_remediation_only".
  • Added generic command-envelope validation that rejects safe-mutation desktop commands without a protocol-owned compensating action, without the required action id, or with a mismatched rollback strategy.
  • Updated host desktop focus, click, emergency-stop capability metadata and the deterministic remote smoke envelopes to carry the catalog-backed metadata.
  • Documented the desktop rollback contract in docs/domains/bellona/extras/remote-control/desktop-compensating-actions.md, including why click-back, drag-back, key-undo, and explicit remediation must be declared before future mutating desktop commands become routable.
  • Regenerated JSON Schema, OpenAPI, and Proto manifest artifacts for the new protocol schemas.

Verification closure:

  • pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose passed.
  • pnpm nx test @bellona/remote-host --skip-nx-cache --verbose passed.
  • pnpm nx typecheck @bellona/remote-protocol --skip-nx-cache --verbose passed.
  • pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose passed.
  • pnpm nx contracts:generate @bellona/remote-protocol --skip-nx-cache --verbose passed and updated generated protocol artifacts.
  • pnpm nx contracts:check @bellona/remote-protocol --skip-nx-cache --verbose passed.
  • Full host/protocol/gateway lint, typecheck, test, build, Prettier, smoke, and diff-check verification is recorded in the progress table for this completed item.

180.C.13.12 Keyboard-Layout-Aware Desktop Type#

Implementation date: 2026-04-23

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/desktop-screenshot.test.ts
  • apps/bellona/remote-host/src/desktop-screenshot.ts
  • apps/bellona/remote-host/src/desktop-type.test.ts
  • apps/bellona/remote-host/src/desktop-type.ts
  • apps/bellona/remote-host/src/index.ts
  • docs/domains/bellona/extras/remote-control/desktop-compensating-actions.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • libs/bellona/remote-protocol/src/desktop-compensating-actions.ts
  • libs/bellona/remote-protocol/src/desktop.test.ts
  • libs/bellona/remote-protocol/src/desktop.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • Desktop fallback permission, focus, allowlist, and native Swift helper patterns in apps/bellona/remote-host/src/desktop-click.ts and apps/bellona/remote-host/src/desktop-window.ts.
  • Desktop adapter registration and capability metadata in apps/bellona/remote-host/src/desktop-screenshot.ts.
  • Desktop protocol command schemas, command-envelope validation, fixtures, schema registry exports, and desktop compensating-action enforcement in libs/bellona/remote-protocol/src/desktop.ts, libs/bellona/remote-protocol/src/command.ts, and libs/bellona/remote-protocol/src/desktop-compensating-actions.ts.
  • macOS keyboard-input APIs were checked against Apple documentation before implementation: Text Input Source Services for active input-source metadata and Core Graphics keyboard events for Unicode text dispatch.

Implementation summary:

  • Added protocol support for desktop.type, including command target/envelope schemas, arguments, result schema, keyboard-layout report schema, schema registry entries, generated contracts, tests, fixtures, and README coverage.
  • Added a desktop compensating-action catalog entry for typed text with rollbackStrategy: "manual_remediation_only" and key_undo operator remediation metadata, so mutating desktop typing cannot bypass the desktop compensating-action framework.
  • Implemented the macOS host command with Screen Recording and Accessibility permission checks, desktop-control grant validation, focused-window resolution, window allowlist enforcement, and adapter capability/handler registration.
  • Implemented a native Swift backend that detects the active keyboard input source, reports layout family, input-source kind, Unicode layout-data availability, physical keyboard shape, and IME/composition status, then emits text through Core Graphics Unicode keyboard events instead of assuming a US QWERTY keycode map.
  • Added host unit coverage for successful layout-aware Unicode emission, permission denial, unfocused or non-allowlisted target denial, and adapter registration.

Verification closure:

  • pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose passed.
  • pnpm nx typecheck @bellona/remote-protocol --skip-nx-cache --verbose passed.
  • pnpm nx test @bellona/remote-host --skip-nx-cache --verbose passed.
  • pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose passed.
  • Remaining contract generation/check, smoke, full lint/typecheck/test/build, Prettier, Swift compile sanity, and diff-check verification is recorded in the progress table for this completed item.

180.C.13.13 Stable Multi-Display Targeting#

Implementation date: 2026-04-23

Files changed:

  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/desktop-display.test.ts
  • apps/bellona/remote-host/src/desktop-display.ts
  • apps/bellona/remote-host/src/desktop-screenshot.test.ts
  • apps/bellona/remote-host/src/desktop-screenshot.ts
  • apps/bellona/remote-host/src/desktop-window.ts
  • apps/bellona/remote-host/src/index.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • libs/bellona/remote-protocol/src/desktop.test.ts
  • libs/bellona/remote-protocol/src/desktop.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • TODOS/phase-180.md

Existing implementation patterns analyzed:

  • Existing macOS display/window resolution in apps/bellona/remote-host/src/desktop-window.ts, especially CGGetActiveDisplayList, CGDisplayBounds, NSScreenNumber, and Retina scale-factor matching.
  • Existing screenshot target handling in apps/bellona/remote-host/src/desktop-screenshot.ts, including screencapture -D <display> and artifact/evidence target metadata.
  • Existing coordinate display contexts in libs/bellona/remote-protocol/src/desktop.ts.
  • Reusable but simulated screen inventory behavior in libs/iris/agents/computer-use/src/screen-capture.ts.
  • Apple Core Graphics display APIs were checked before implementation: active/online display lists, display bounds, display UUIDs, pixel dimensions, mirror/main/built-in flags, rotation, and AppKit NSScreen display names.

Implementation summary:

  • Added protocol-owned stable display identity schemas and desktop.display.list command/result contracts.
  • Added RemoteDesktopWindowDisplay stable identity fields so window listing can report both legacy numeric display ids and UUID-backed stable ids.
  • Implemented a macOS host display adapter that reports desktop-display:<uuid> stable ids, direct display ids, current screencapture index, display name, bounds, pixel size, scale factor, primary/active/online/built-in/mirrored flags, and rotation.
  • Updated window-list Swift output to attach stable display identity metadata to each window's matched display.
  • Updated desktop.screenshot display targets to accept stable display selectors (stableId, uuid, directDisplayId, or name) and resolve them to the current display index immediately before invoking screencapture.
  • Registered capability:desktop-display-list with the desktop adapter and updated registry/app capability counts.

Verification closure:

  • pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose passed.
  • pnpm nx typecheck @bellona/remote-protocol --skip-nx-cache --verbose passed.
  • pnpm nx test @bellona/remote-host --skip-nx-cache --verbose passed.
  • pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose passed.
  • Remaining contract generation/check, smoke, native Swift compile sanity, full lint/typecheck/test/build, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.13.14 Desktop Clipboard Capture#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/desktop-clipboard.test.ts
  • apps/bellona/remote-host/src/desktop-clipboard.ts
  • apps/bellona/remote-host/src/desktop-screenshot.test.ts
  • apps/bellona/remote-host/src/desktop-screenshot.ts
  • apps/bellona/remote-host/src/index.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • libs/bellona/remote-protocol/src/desktop.test.ts
  • libs/bellona/remote-protocol/src/desktop.ts
  • libs/bellona/remote-protocol/src/device.ts
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts

Existing implementation patterns analyzed:

  • Existing desktop artifact/evidence registration and redaction metadata in apps/bellona/remote-host/src/desktop-screenshot.ts.
  • Existing host command handler/capability composition in apps/bellona/remote-host/src/desktop-screenshot.ts, desktop-type.ts, and desktop-display.ts.
  • Existing protocol registry, fixture, and generated-contract ownership in libs/bellona/remote-protocol/src/desktop.ts, schema-registry.ts, and fixtures.ts.
  • Existing audit artifact and evidence schemas in libs/bellona/remote-protocol/src/audit.ts.
  • Existing policy/device permission scope consistency checks for capability permission wiring.

Implementation summary:

  • Added desktop.clipboard.capture protocol contracts, redaction pattern schemas, result schemas, command target/envelope parsing, registry entries, generated contracts, and a dedicated desktop.clipboard permission scope.
  • Implemented a macOS host clipboard adapter using AppKit NSPasteboard for plain-text pasteboard capture with pasteboard type and changeCount provenance.
  • Added builtin sensitive-text redaction for API keys, GitHub tokens, AWS access key ids, private-key blocks, and secret assignments, plus command-supplied regex pattern hooks with bounded pattern counts/sizes.
  • Stored only redacted clipboard text as a text/plain audit artifact while preserving raw/redacted hashes, redaction counts, pattern labels, evidence references, and optional inline redacted text for session notes.
  • Registered capability:desktop-clipboard-capture with the desktop fallback adapter and updated registry/app capability counts.

Verification closure:

  • pnpm nx typecheck @bellona/remote-protocol --skip-nx-cache --verbose passed.
  • pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose passed.
  • pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose passed.
  • pnpm nx test @bellona/remote-host --skip-nx-cache --verbose passed.
  • Remaining contract generation/check, smoke, native Swift compile sanity, full lint/typecheck/test/build, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.01 MCP Gateway Stdio Scaffold#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/package.json
  • libs/bellona/mcp-gateway/project.json
  • libs/bellona/mcp-gateway/src/index.ts
  • libs/bellona/mcp-gateway/src/stdio-cli.ts
  • libs/bellona/mcp-gateway/src/stdio-server.test.ts
  • libs/bellona/mcp-gateway/src/stdio-server.ts
  • libs/bellona/mcp-gateway/tsconfig.json
  • libs/bellona/mcp-gateway/tsconfig.lib.json
  • libs/bellona/mcp-gateway/tsconfig.spec.json
  • libs/bellona/mcp-gateway/vitest.config.ts
  • pnpm-lock.yaml

Existing implementation patterns analyzed:

  • Existing in-repo MCP client package shape in libs/iris/mcp, including Nx library/test targets, package metadata, ESM TypeScript config, and Vitest node test setup.
  • Existing Bellona library packaging in libs/bellona/remote-protocol, including build, typecheck, lint, and test targets.
  • The installed official @modelcontextprotocol/sdk server APIs: McpServer, StdioServerTransport, InMemoryTransport, and client initialization behavior.
  • The current Phase 180 sequencing for MCP: this item owns only the stdio server scaffold, while tools, resources, auth/session binding, and bypass tests stay in 180.C.14.02 through 180.C.14.05.

Implementation summary:

  • Added @bellona/mcp-gateway as a Bellona Nx library with package metadata, lockfile importer metadata, ESM TypeScript configs, build/typecheck/lint/test targets, and a local stdio run target.
  • Added a stable Bellona MCP server identity and exported server-info helper.
  • Added createBellonaMcpGatewayServer, preserving a configurer hook so later modules can register tools/resources before transport connection.
  • Added injected-stream StdioServerTransport construction and an idempotent connectBellonaMcpGatewayStdioServer lifecycle handle.
  • Added a small stdio CLI entrypoint for local MCP client launchers.
  • Added tests covering stable identity, client/server MCP initialization over linked in-memory transports, pre-connect configurer behavior, injected stdio stream construction, stdio listener cleanup, idempotent close, and blank identity rejection.

Verification closure:

  • pnpm nx lint @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx test @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx build @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • Final run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.02 MCP Gateway Tool Surface#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/package.json
  • libs/bellona/mcp-gateway/src/index.ts
  • libs/bellona/mcp-gateway/src/remote-control-tools.test.ts
  • libs/bellona/mcp-gateway/src/remote-control-tools.ts
  • libs/bellona/mcp-gateway/src/stdio-server.ts
  • libs/bellona/mcp-gateway/vitest.config.ts
  • pnpm-lock.yaml

Existing implementation patterns analyzed:

  • Existing gateway boundaries in apps/bellona/remote-gateway/src/app.ts, device-registry.ts, session-lifecycle.ts, and command-dispatcher.ts.
  • Existing host/gateway route tests for blender.scene.info, blender.object.create_primitive, browser.navigate, browser.snapshot, and desktop.screenshot.
  • Existing protocol-owned schemas in libs/bellona/remote-protocol/src/blender.ts, browser.ts, desktop.ts, command.ts, device.ts, and session.ts.
  • Existing fake MCP client transport behavior in testing/bellona/remote-control/fake-mcp-client-transport.ts, including MCP text results with structured content.

Implementation summary:

  • Added registerBellonaRemoteControlMcpTools, which registers MCP tools for device.list, session.start, session.stop, blender.scene.info, blender.object.create_primitive, browser.navigate, browser.snapshot, and desktop.screenshot.
  • Added a structural BellonaMcpRemoteControlGateway boundary so the MCP library can call existing device registry, session lifecycle, and command dispatcher objects without importing the app package.
  • Extended createBellonaMcpGatewayServer to register the remote-control tool surface when a gateway boundary is supplied.
  • Added typed builders that turn command tool inputs into protocol-valid RemoteCommandEnvelope payloads with correct risk class, timeout class, actor chain, idempotency key, metadata, browser readonly guarantees, and Blender primitive rollback/dry-run metadata.
  • Added MCP SDK client tests covering tool listing, annotations, device listing, session start/stop defaults, command envelope validity, and dispatch client id propagation.
  • Updated package metadata, Vitest aliasing, and the pnpm lockfile importer for @bellona/remote-protocol and zod.

Verification closure:

  • pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx test @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx lint @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx build @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • Final run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.03 MCP Gateway Resource Surface#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/index.ts
  • libs/bellona/mcp-gateway/src/remote-control-resources.test.ts
  • libs/bellona/mcp-gateway/src/remote-control-resources.ts
  • libs/bellona/mcp-gateway/src/stdio-server.ts

Existing implementation patterns analyzed:

  • MCP SDK fixed-resource registration and read callbacks in node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.d.ts and the SDK example server.
  • Existing gateway state boundaries in apps/bellona/remote-gateway/src/app.ts, session-lifecycle.ts, timeline.ts, artifact-registry.ts, and command-dispatcher.ts.
  • Protocol-owned schemas and fixtures for RemoteDevice, RemoteSession, RemoteArtifact, and RemoteCommandResult.

Implementation summary:

  • Added registerBellonaRemoteControlMcpResources, registering four fixed JSON MCP resources: bellona://remote-control/devices/active/capabilities, bellona://remote-control/sessions/active/timeline, bellona://remote-control/artifacts/recent, and bellona://remote-control/commands/last-result.
  • Added a structural resource gateway boundary that can be wired to the existing device registry, session lifecycle manager, timeline service, artifact registry, and command dispatcher without importing the gateway app package.
  • Extended createBellonaMcpGatewayServer so callers can pass either a dedicated remoteControlResourceGateway or reuse the main remote-control gateway when it exposes the read-only state methods.
  • Added SDK client tests for resource listing, JSON MIME metadata, active-device capability filtering, active-session timeline queries, recent artifact snapshots, and last command-result selection.
  • Updated the package README with the resource URIs and gateway wiring example.

Verification closure:

  • pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx test @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • Final run-many, lint, build, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.04 MCP Auth And Session Binding#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/auth-session.test.ts
  • libs/bellona/mcp-gateway/src/auth-session.ts
  • libs/bellona/mcp-gateway/src/index.ts
  • libs/bellona/mcp-gateway/src/remote-control-resources.ts
  • libs/bellona/mcp-gateway/src/remote-control-tools.test.ts
  • libs/bellona/mcp-gateway/src/remote-control-tools.ts
  • libs/bellona/mcp-gateway/src/stdio-server.ts

Existing implementation patterns analyzed:

  • MCP SDK request-handler authInfo and transport session metadata in node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.d.ts.
  • MCP SDK AuthInfo shape, bearer-token middleware, and in-memory transport auth hooks.
  • Existing Bellona gateway host-token, pairing-exchange, command-dispatcher client id, session lifecycle, and resource state boundaries.
  • Phase research notes for MCP OAuth/resource-server authorization, including audience validation and token-passthrough rejection.

Implementation summary:

  • Added auth-session.ts, a request-level binding layer that maps SDK authInfo into Bellona client:*, participant:*, allowed-session, scope, expiry, and resource-audience claims.
  • Added a gateway callback, bindMcpClientSession(request), so remote/cloud MCP transports can delegate final client/session authority to the Remote Gateway rather than trusting MCP transport metadata alone.
  • Added remoteControlAuthSession server options and threaded them into all MCP tools and resources. Default mode remains disabled for local stdio; remote and cloud transports can set mode: "required".
  • Enforced required scopes for device reads, session start/stop, command dispatch, timeline reads, artifact reads, and last-result reads.
  • Ensured authenticated client ids override tool-supplied clientId values, authenticated participant ids override command/session actor defaults, and requested session ids must match gateway-bound allowed session ids.
  • Added unit coverage for binding success, gateway-delegated binding, missing/expired/wrong-audience/under-scoped/unbound requests, and required auth failure through an actual MCP tool call.

Verification closure:

  • pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx test @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • Final run-many, lint, build, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.05 MCP Bypass Tests#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/src/remote-control-bypass.test.ts

Existing implementation patterns analyzed:

  • Existing gateway command-dispatcher rejection paths for policy.denied and approval-required commands.
  • Existing gateway device revocation service behavior that marks devices blocked and disconnects active host connections.
  • MCP tool error handling in the SDK, where thrown tool errors are surfaced as isError tool results.
  • Protocol-owned command envelope validation used by the MCP tool builders.

Implementation summary:

  • Added remote-control-bypass.test.ts with a guarded structural gateway that simulates policy denial, approval-required, and device-revoked gateway outcomes.
  • Added a schema-bypass test proving invalid browser.navigate arguments are rejected before dispatchCommand is called.
  • Added policy, approval, and revocation tests proving gateway rejections are surfaced as MCP tool errors instead of successful tool results.
  • Added a blocked-device list assertion so the test verifies MCP can observe a revoked device but still cannot route a command around the gateway rejection.

Verification closure:

  • pnpm nx test @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • Final run-many, lint, typecheck, build, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.06 Local Cloud-Agent Simulation#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/local-cloud-agent-simulation.md

Existing implementation patterns analyzed:

  • Existing MCP stdio target in libs/bellona/mcp-gateway/project.json.
  • Current MCP tool, resource, auth/session, and bypass-test coverage in libs/bellona/mcp-gateway/src.
  • Existing Remote Gateway state and authority boundaries in apps/bellona/remote-gateway/src/app.ts.
  • Phase reference notes for cloud-agent MVP and no direct LAN control.

Implementation summary:

  • Added local-cloud-agent-simulation.md, a first-stage local simulation procedure for a cloud-agent process that connects through the MCP gateway rather than directly to LAN host/adapters.
  • Documented topology, prerequisites, the stdio harness command, the expected MCP tool/resource sequence, no-direct-LAN prohibitions, required evidence, and the promotion path to Hetzner/AWS/cloud-agent smoke stages.
  • Explicitly documented that the current local proof uses stdio because the Streamable HTTP MCP target is not implemented yet, and that remote/cloud transports must require auth/session binding.

Verification closure:

  • pnpm exec prettier --check docs/domains/bellona/extras/remote-control/local-cloud-agent-simulation.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md passed.
  • git diff --check passed.

180.C.14.07 Hetzner Reference Deployment Notes#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/hetzner-reference-deployment.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md

Existing implementation patterns analyzed:

  • Existing Remote Gateway runtime, local startup, configuration, endpoint, log, and verification docs in apps/bellona/remote-gateway/README.md.
  • Gateway environment schema in apps/bellona/remote-gateway/src/config.ts.
  • Remote Host outbound gateway and pairing configuration docs in apps/bellona/remote-host/README.md.
  • Current MCP gateway stdio/auth/session limitations in libs/bellona/mcp-gateway/README.md and 180.C.14.06.
  • Existing external research for cloud MCP, WebRTC, TURN, and no-direct-LAN rules.
  • Current primary references for Hetzner Cloud Firewalls/server user data, Caddy Automatic HTTPS/reverse proxying, and coturn TURN ports.

Implementation summary:

  • Added hetzner-reference-deployment.md, a first-stage single-node Hetzner runbook for Bellona Remote Gateway.
  • Documented topology, server/firewall posture, Caddy TLS reverse proxying, gateway systemd service shape, required environment variables, TURN placeholder state, journald log commands, smoke-test commands, required evidence, and explicit limitations.
  • Kept the public surface constrained to Caddy on 80/443 and documented that gateway port 4070, Blender, Chrome/CDP, desktop helpers, host health ports, and MCP stdio must not be exposed directly.

Verification closure:

  • pnpm exec prettier --check docs/domains/bellona/extras/remote-control/hetzner-reference-deployment.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md passed.
  • git diff --check passed.

180.C.14.08 AWS Reference Deployment Notes#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/aws-reference-deployment.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md

Existing implementation patterns analyzed:

  • Existing Remote Gateway runtime, endpoint, configuration, and log docs in apps/bellona/remote-gateway/README.md.
  • Gateway environment schema in apps/bellona/remote-gateway/src/config.ts.
  • Remote Host outbound WSS and pairing configuration docs in apps/bellona/remote-host/README.md.
  • Existing Bellona data-plane environment names in libs/bellona/README.md, libs/bellona/event-handlers/src/storage/postgres.ts, and libs/bellona/event-handlers/src/storage/cache.ts.
  • Hetzner reference deployment structure from 180.C.14.07.
  • Current AWS primary references for Application Load Balancer, ACM DNS validation, EC2 security groups, CloudWatch agent, S3 encryption, RDS PostgreSQL TLS, and ElastiCache in-transit encryption.

Implementation summary:

  • Added aws-reference-deployment.md, a first-stage AWS runbook for Bellona Remote Gateway behind an HTTPS/WSS Application Load Balancer.
  • Documented security group boundaries, ACM/TLS listener shape, EC2/systemd runtime, current EBS JSON storage, S3 artifact placeholder, RDS/Postgres placeholder, ElastiCache/Redis placeholder, CloudWatch log collection, smoke commands, required evidence, and explicit limitations.
  • Kept 4070, Redis, Postgres, Remote Host health ports, Blender, Chrome/CDP, desktop helpers, and MCP stdio off the public internet.

Verification closure:

  • pnpm exec prettier --check docs/domains/bellona/extras/remote-control/aws-reference-deployment.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md passed.
  • git diff --check passed.

180.C.14.09 Cloud-Agent MVP Smoke#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/package.json
  • libs/bellona/mcp-gateway/project.json
  • libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.test.ts
  • libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • Existing MCP tool registration and gateway-dispatch tests in libs/bellona/mcp-gateway/src/remote-control-tools.test.ts.
  • Existing MCP resource registration/read tests in libs/bellona/mcp-gateway/src/remote-control-resources.test.ts.
  • Existing MCP auth/session binding in libs/bellona/mcp-gateway/src/auth-session.ts.
  • Existing remote-host CLI smoke patterns for Blender, browser, and desktop fallback under apps/bellona/remote-host/scripts.
  • Protocol fixtures and result/artifact schemas from libs/bellona/remote-protocol/src/fixtures.ts and result contracts.

Implementation summary:

  • Added cloud-agent-mvp-smoke.ts, an executable authenticated MCP cloud-agent smoke runner that uses an in-memory MCP client/server transport and a structural Remote Gateway boundary.
  • The smoke runs the required flow: device.list, session.start, blender.scene.info, browser.navigate, desktop.screenshot, and session.stop.
  • The smoke validates gateway-shaped command results, idempotency keys, last command result resource, screenshot artifact registration, tool/resource surface, auth binding, and no-direct-LAN evidence.
  • Added cloud-agent-mvp-smoke.test.ts, exported the runner, added an Nx cloud-agent:mvp-smoke target, and documented the command in the MCP gateway README.

Smoke evidence:

  • pnpm nx cloud-agent:mvp-smoke @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • Evidence output included device:studio-macbook-air, session:cloud-agent-mvp-smoke, command:mcp-blender-scene-info-000001, command:mcp-browser-navigate-000002, command:mcp-desktop-screenshot-000003, artifact:mcp-desktop-screenshot-000003-desktop-screenshot, and stoppedSessionStatus: "terminated".
  • The report explicitly set liveDeploymentExercised: false, noDirectLanAccess: true, and transport: "mcp-in-memory-cloud-agent-simulation".

Verification closure:

  • pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx test @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx cloud-agent:mvp-smoke @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • Full scoped run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.10 Agent Tool-Selection Policy#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/agent-tool-selection-policy.test.ts
  • libs/bellona/mcp-gateway/src/agent-tool-selection-policy.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • Phase ground rules for deep integration before desktop fallback in TODOS/phase-180.md.
  • Current MCP gateway package shape, exports, README, and test patterns.
  • Existing RemoteDevice and RemoteCapability fixtures from libs/bellona/remote-protocol.
  • Prior browser isolation, desktop fallback, Blender, and external research notes documenting that adapters must precede generic desktop control.

Implementation summary:

  • Added agent-tool-selection-policy.ts, a deterministic policy that ranks candidate tools in the required order: domain APIs, engine/browser adapters, high-level browser agents, desktop fallback, and human handoff.
  • Added rejection gates for blocked/offline candidates, disabled desktop fallback, unavailable approval, and command/namespace mismatches.
  • Added default human handoff so planning has an explicit terminal route when automated tools are unavailable or unsafe.
  • Added createBellonaAgentToolCandidatesFromDevice() so advertised RemoteDevice capabilities can be converted into agent-selection candidates.
  • Documented the policy in the MCP gateway README and exported it from the package entrypoint.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/agent-tool-selection-policy.test.ts --reporter=verbose passed.
  • Full scoped run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.11 Agent Preflight Checks#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/agent-preflight-checks.test.ts
  • libs/bellona/mcp-gateway/src/agent-preflight-checks.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • Remote device, adapter, capability, and permission schemas in libs/bellona/remote-protocol/src/device.ts.
  • Remote stream descriptor and source contracts in libs/bellona/remote-protocol/src/stream.ts.
  • Host-side known-command policy preflight in apps/bellona/remote-host/src/policy-preflight.ts.
  • MCP gateway package export, README, and Vitest patterns from the prior 180.C.14.09 and 180.C.14.10 items.

Implementation summary:

  • Added agent-preflight-checks.ts, a side-effect-free gateway utility with stable policy id bellona-agent-remote-task-preflight-v1.
  • The evaluator checks device online/degraded state, permission scopes, approval-gated permissions, app/adapter availability, project-root grants, stream availability, task budget estimates, and approval service/grant state before remote work starts.
  • The result includes per-check status, blockers, warnings, approval requirements, device id, command/namespace context, and evaluated timestamp.
  • Added focused tests for the all-clear path, offline devices, permission approval requirements, unavailable approval service, granted approvals, unavailable adapters, missing project-root grants, inactive streams, and exceeded budgets.
  • Documented the preflight helper in the MCP gateway README and exported it from the package entrypoint.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/agent-preflight-checks.test.ts --reporter=verbose passed.
  • Full scoped run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.12 Agent Long-Running Job Handling#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/agent-long-running-jobs.test.ts
  • libs/bellona/mcp-gateway/src/agent-long-running-jobs.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • Remote command timeout classes in libs/bellona/remote-protocol/src/command.ts.
  • Remote command progress/result/retry schemas in libs/bellona/remote-protocol/src/result.ts.
  • Remote dynamic running-job state in libs/bellona/remote-protocol/src/state.ts.
  • Host-side command cancellation, timeout, progress, and result emission in apps/bellona/remote-host/src/command-executor.ts.
  • Gateway command progress/result relay in apps/bellona/remote-gateway/src/command-dispatcher.ts and apps/bellona/remote-gateway/src/host-connections.ts.
  • Existing render cache progress patterns in apps/bellona/render-api/src/services/cache.service.ts.

Implementation summary:

  • Added agent-long-running-jobs.ts, a deterministic agent-side state machine for remote render, build, file-transfer, and import work.
  • Implemented progress polling with next-poll timestamps, cancellation requests with configured control commands, checkpoint creation with resumable tokens and artifact references, resume planning from the latest resumable checkpoint, and timeout escalation through warning, cancel, human handoff, and hard timeout.
  • Added terminal result handling for completed, failed, cancelled, and timed-out jobs while preserving checkpoint and warning history for audit or resume.
  • Added tests covering poll due/wait states, checkpointing on progress, file-transfer cancellation, resume from the latest checkpoint, and build timeout escalation across all escalation levels.
  • Documented the helper in the MCP gateway README and exported it from the package entrypoint.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/agent-long-running-jobs.test.ts --reporter=verbose passed.
  • Full scoped run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.13 Agent Visual Verification Policy#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/agent-visual-verification-policy.test.ts
  • libs/bellona/mcp-gateway/src/agent-visual-verification-policy.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • Remote artifact and audit evidence schemas in libs/bellona/remote-protocol/src/audit.ts.
  • Desktop click visual verification arguments/results in libs/bellona/remote-protocol/src/desktop.ts.
  • Desktop click before/after screenshot capture in apps/bellona/remote-host/src/desktop-click.ts.
  • Blender mutation before/after scene evidence and viewport screenshot evidence in apps/bellona/remote-host/src/blender-adapter.ts.
  • Browser, desktop screenshot, artifact registry, and gateway timeline evidence paths that already collect artifact/evidence ids from command results.

Implementation summary:

  • Added agent-visual-verification-policy.ts, a deterministic policy evaluator for high-impact remote edits.
  • The policy detects high-impact work from explicit impact, evidence-required intents, safe-mutation/destructive/privileged risk, desktop input, Blender or Unreal edit terms, browser submit/upload/download actions, renders, builds, imports, and other mutating command terms.
  • Required verification passes only with before and after screenshot/video/render evidence references, or with a documented impossible-evidence reason.
  • The evaluator blocks missing before/after evidence, wrong evidence phase, non-visual artifacts, failed redaction, and command/session mismatches.
  • Added tests for passing before/after evidence, missing after evidence, documented impossible evidence, low-impact read-only commands, failed redaction, and high-impact command inference.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/agent-visual-verification-policy.test.ts --reporter=verbose passed.
  • Full scoped run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.14 Agent Dry-Run Impact Summary#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.test.ts
  • libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • RemoteDryRunPlan schema in libs/bellona/remote-protocol/src/dry-run.ts, including predicted changes, cost/time estimates, reversibility assessment, required risk classes, and impact summaries.
  • Command risk, rollback, and dry-run dispatch metadata in libs/bellona/remote-protocol/src/command.ts.
  • Gateway policy dry-run inference in libs/bellona/remote-protocol/src/policy.ts for project/file writes, desktop input, real browser profiles, arbitrary code, shell, publishing, and financial actions.
  • Existing Blender undo, browser compensating-action, and desktop compensating-action documentation and metadata.

Implementation summary:

  • Added agent-dry-run-impact-summary.ts, a deterministic agent-side helper that generates protocol-valid RemoteDryRunPlan values and human-readable impact summaries before risky remote actions execute.
  • The helper covers Blender, Unreal, browser, desktop, file, shell, and process surfaces, including shell commands represented by the protocol process namespace and shell.execute permission scope.
  • Risky action detection combines command risk class, permission scopes, command terms, affected resources, project roots, and explicit required risk classes.
  • Generated plans include predicted changes, cost/time estimates, reversibility, rollback strategy, affected surfaces, safeguards, warnings, and blockers.
  • Critical shell, privileged, destructive, and financial browser paths block without approval context; explicitly unsupported dry-run actions block without producing a plan.
  • Added tests for Blender safe mutation, shell execution, browser financial submission, desktop input, file writes, read-only bypass, and unsupported dry-run blocking.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/agent-dry-run-impact-summary.test.ts --reporter=verbose passed.
  • Full scoped run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.15 Agent Mutation Locking#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/agent-mutation-locking.test.ts
  • libs/bellona/mcp-gateway/src/agent-mutation-locking.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • Remote gateway command dispatcher, command queue, idempotency, and approval continuation behavior in apps/bellona/remote-gateway/src/command-dispatcher.ts.
  • Remote gateway approval request lifecycle in apps/bellona/remote-gateway/src/approval-service.ts.
  • Session lifecycle and participant ownership metadata in apps/bellona/remote-gateway/src/session-lifecycle.ts.
  • Browser profile isolation policy and Blender rollback limitations that name distributed locks as required future controls.
  • Existing MCP-gateway agent helper shape from tool selection, preflight, long-running jobs, dry-run summaries, and visual verification.

Implementation summary:

  • Added agent-mutation-locking.ts, an in-memory exclusive mutation lock manager with preview, acquire, refresh, release, list, TTL expiry, fencing tokens, and reentrant owner refresh.
  • The manager infers lock resources from commands and explicit inputs for Blender files, Unreal maps, browser profiles, project roots, command queues, and approval requests.
  • Project-root locks detect parent/child path overlap across resource kinds so a project-root mutation blocks a file, Blender file, or Unreal map mutation under the same root.
  • Command queue locks serialize mutating work on the same queue, and approval request locks prevent two agents from driving the same approval request.
  • Read-only commands do not require mutation locks.
  • Added tests for Blender file conflicts, project-root overlap, browser profile conflicts, command queue and approval request conflicts, reentrant refresh, owner-scoped release, expired lease pruning, read-only bypass, and direct resource inference.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/agent-mutation-locking.test.ts --reporter=verbose passed.
  • Full scoped run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.16 Agent Handoff Paths#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/agent-handoff-paths.test.ts
  • libs/bellona/mcp-gateway/src/agent-handoff-paths.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • Tool-selection policy ordering in libs/bellona/mcp-gateway/src/agent-tool-selection-policy.ts, including desktop fallback and human handoff.
  • Preflight statuses and approval requirements in libs/bellona/mcp-gateway/src/agent-preflight-checks.ts.
  • Long-running job human handoff escalation in libs/bellona/mcp-gateway/src/agent-long-running-jobs.ts.
  • RemoteActor and RemoteActorChain schemas and fixtures in libs/bellona/remote-protocol/src/actor.ts and fixtures.ts.
  • Session lifecycle takeover and handoff metadata in the remote gateway.

Implementation summary:

  • Added agent-handoff-paths.ts, a deterministic handoff planner for the cloud model, local model, browser specialist, Blender specialist, Unreal specialist, desktop fallback specialist, and human operator.
  • The planner chooses stay/handoff/block decisions from namespace, tool tier, approval state, policy/preflight state, confidence, cloud/local availability, desktop fallback availability, explicit operator targets, and available roles.
  • Specialist-to-specialist handoffs route through the preferred orchestrator so delegated attribution remains explicit.
  • Human handoff is selected for approval-required, policy-blocked, low-confidence, and tool-selected human-handoff cases.
  • Each decision emits a protocol-valid RemoteActorChain preserving ordered actor delegation across orchestrators, specialists, desktop fallback, and human operators.
  • Added tests for cloud-to-browser, local-to-Blender, specialist-to-Unreal, human approval/low-confidence routing, disabled desktop fallback, unavailable role blocking, already-specialized stay behavior, and actor descriptor overrides.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/agent-handoff-paths.test.ts --reporter=verbose passed.
  • Full scoped run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.17 Agent Capability Memory#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/agent-capability-memory.test.ts
  • libs/bellona/mcp-gateway/src/agent-capability-memory.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • Remote device registry snapshots and filters in apps/bellona/remote-gateway/src/device-registry.ts.
  • MCP active capability resource shape in libs/bellona/mcp-gateway/src/remote-control-resources.ts.
  • Device, adapter, and capability schemas in libs/bellona/remote-protocol/src/device.ts.
  • Existing agent preflight, tool-selection, handoff, and mutation-lock helpers that consume device capability state.

Implementation summary:

  • Added agent-capability-memory.ts, an in-memory capability/app observation memory for agents.
  • The manager records device, adapter, app, namespace, capability, and command observations with deterministic keys, fingerprints, first/last observation timestamps, probe counts, stable observation counts, status-aware TTLs, and summaries.
  • rememberDevice() records adapters and capabilities from a device-list or active-capability snapshot.
  • shouldProbe() reuses unchanged memory until expiry, asks for background refresh near expiry, and requires fresh probes for missing, forced, expired, invalidated, or fingerprint-changed observations.
  • Explicit invalidation supports device, adapter, app, namespace, or exact key eviction when a host reconnects or policy changes.
  • Added tests for device snapshot memory, stable repeat observations, fingerprint-change probing, near-expiry background refresh, expiry, forced probes, invalidation, and stable key generation.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/agent-capability-memory.test.ts --reporter=verbose passed.
  • Full scoped run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.18 Agent Autonomous Stop Criteria#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/agent-autonomous-stop-criteria.test.ts
  • libs/bellona/mcp-gateway/src/agent-autonomous-stop-criteria.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • Preflight budget, approval, and policy blocker checks in libs/bellona/mcp-gateway/src/agent-preflight-checks.ts.
  • Low-confidence human handoff routing in libs/bellona/mcp-gateway/src/agent-handoff-paths.ts.
  • Timeout escalation and terminal state handling in libs/bellona/mcp-gateway/src/agent-long-running-jobs.ts.
  • Session stop and terminal lifecycle records in apps/bellona/remote-gateway/src/session-lifecycle.ts.
  • Protocol stream terminal states and health timestamps in libs/bellona/remote-protocol/src/stream.ts.

Implementation summary:

  • Added agent-autonomous-stop-criteria.ts, a side-effect-free stop evaluator for agent control loops.
  • The evaluator checks task completion, denied approval, policy blocks, repeated failures, host busy timeout, required stream loss, low confidence, and spent/projected budget exhaustion.
  • Decisions return every criterion evaluation, all triggered criteria, primary stop reason, outcome classification, session stop reason, and next actions.
  • Safety blockers such as approval denial, policy blocks, and budget overruns take priority over lower-priority completion claims.
  • Added unit coverage for continue, task-done success, approval-denied priority, policy block, repeated failure windows, host busy timeout, ended and silent streams, low confidence, and budget overruns.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/agent-autonomous-stop-criteria.test.ts --reporter=verbose passed.
  • Full scoped run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.19 Agent Deep-Integration Evaluation Tasks#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/package.json
  • libs/bellona/mcp-gateway/project.json
  • libs/bellona/mcp-gateway/src/agent-deep-integration-evals.test.ts
  • libs/bellona/mcp-gateway/src/agent-deep-integration-evals.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • MCP cloud-agent smoke target and report shape in libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.ts.
  • Blender agent smoke scenarios in libs/bellona/blender-agent/src/smoke-scenarios.test.ts.
  • Psyche Computer Use benchmark task/result structures in services/psyche/computer-use/src/computer_use/benchmark/types.py.
  • Existing Bellona remote command names, browser managed-profile commands, desktop fallback commands, and Unreal command examples across remote protocol fixtures and gateway agent tests.

Implementation summary:

  • Added agent-deep-integration-evals.ts, a typed evaluation catalog and comparator for deep-integration versus Computer Use-only agent workflows.
  • Defined paired variants for Blender, browser, desktop, and Unreal tasks, each with acceptance criteria, command constraints, evidence requirements, score thresholds, step budgets, duration budgets, and comparison thresholds.
  • Added compareBellonaAgentDeepIntegrationEvaluationResults() to fail missing pairs, low scores, tool-constraint violations, insufficient evidence, and deep-integration regressions against the Computer Use-only baseline.
  • Added agent:deep-integration-evals Nx/package target to validate and print the catalog without exercising live hardware.
  • Added unit coverage for domain coverage, catalog validation, passing paired comparisons, missing baseline results, deep-integration regressions, and Computer Use-only runs that accidentally use typed adapter commands.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/agent-deep-integration-evals.test.ts --reporter=verbose passed.
  • pnpm nx agent:deep-integration-evals @bellona/mcp-gateway --skip-nx-cache --verbose passed and printed a catalog report with liveExecutionExercised: false.
  • Full scoped run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.20 MCP Remote Mac No-Inbound Smoke#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/package.json
  • libs/bellona/mcp-gateway/project.json
  • libs/bellona/mcp-gateway/src/index.ts
  • libs/bellona/mcp-gateway/src/remote-mac-no-inbound-smoke.test.ts
  • libs/bellona/mcp-gateway/src/remote-mac-no-inbound-smoke.ts

Existing implementation patterns analyzed:

  • Existing MCP client in-memory cloud-agent smoke in libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.ts.
  • Outbound host connection and gateway listener patterns in apps/bellona/remote-gateway/src/host-connections.ts and apps/bellona/remote-gateway/src/app.ts.
  • Second-MacBook and cloud reference deployment runbooks documenting controlled MacBook outbound-only operation and no public exposure of host health, MCP, Blender, Chrome/CDP, or desktop helper ports.

Implementation summary:

  • Added remote-mac-no-inbound-smoke.ts, a deterministic MCP smoke wrapper that drives the existing cloud-agent command flow and records explicit remote Mac topology assertions.
  • The smoke report proves the MCP client authenticated, used gateway-mediated command dispatch, represented the host path as outbound-from-MacBook, exposed zero inbound MacBook ports, stopped the session, and returned gateway-owned screenshot artifact metadata.
  • Added remote-mac:no-inbound-smoke Nx/package target to print the evidence report with noInboundMacBookPorts: true, hostConnectionDirection: "outbound-from-macbook", and liveDeploymentExercised: false.
  • Added tests for the successful no-inbound report and failure behavior when the gateway-mediated command-flow evidence is incomplete.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/remote-mac-no-inbound-smoke.test.ts --reporter=verbose passed.
  • pnpm nx remote-mac:no-inbound-smoke @bellona/mcp-gateway --skip-nx-cache --verbose passed and printed a no-inbound report with liveDeploymentExercised: false.
  • Full scoped run-many, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.14.21 Agent Readiness and State Snapshot Host Adapter#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/adapter-registry.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/app.ts
  • apps/bellona/remote-host/src/command-executor.test.ts
  • apps/bellona/remote-host/src/command-executor.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md

Existing implementation patterns analyzed:

  • 180.C.03.15 protocol schemas, fixtures, command targets, and result output shape for agent.readiness and state.snapshot.
  • Host adapter registration and routing patterns for diagnostics, browser, desktop fallback, and fake Blender adapters.
  • Existing host command-executor active/queued command lifecycle so dynamic state can report real running jobs instead of empty placeholders.

Implementation summary:

  • Added an in-process adapter:remote-host-state registration that advertises capability:agent-readiness and capability:state-snapshot using the protocol fixtures and routes both read-only commands.
  • Implemented protocol-valid RemoteStateSnapshot output for modal dialogs, shader compile counts, project-root writability, active/queued jobs, disk pressure, and memory pressure with injectable providers for real adapters.
  • Implemented RemoteAgentReadiness evaluation across adapter inventory, capability status, health, macOS permissions, modal/dialog blockers, shader activity, project-root policy, running jobs, and disk/memory pressure.
  • Extended the command executor with listRunningJobs() so the host app wires live active/queued command state into state.snapshot.
  • Updated host docs and tests for the expanded adapter/capability inventory and dynamic readiness blocker behavior.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/adapter-registry.test.ts src/command-executor.test.ts --reporter=verbose passed from apps/bellona/remote-host.
  • pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose passed.
  • pnpm nx run-many -p @bellona/remote-host -t lint,typecheck,test,build --skip-nx-cache --verbose passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.14.22 Structured Error Remediation in MCP#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/command-remediation.test.ts
  • libs/bellona/mcp-gateway/src/command-remediation.ts
  • libs/bellona/mcp-gateway/src/index.ts
  • libs/bellona/mcp-gateway/src/remote-control-resources.test.ts
  • libs/bellona/mcp-gateway/src/remote-control-resources.ts
  • libs/bellona/mcp-gateway/src/remote-control-tools.test.ts
  • libs/bellona/mcp-gateway/src/remote-control-tools.ts

Existing implementation patterns analyzed:

  • 180.C.03.12 protocol helpers: createRemoteCommandError(), createRemoteCommandErrorRemediation(), RemoteCommandErrorSchema, and suggested-next-command templates.
  • Existing host, gateway, fake transport, and remote-control testing error paths that already validate command errors through the protocol schema.
  • MCP command tool and last-command-result resource output shapes, where agents currently had to inspect nested result.error.remediation.

Implementation summary:

  • Added command-remediation.ts to normalize MCP command results, repair legacy command errors missing remediation via createRemoteCommandError(), and produce a concise agent-facing remediation envelope.
  • Enriched failed MCP command tool responses with top-level remediation and suggestedNextCommand fields while preserving the protocol result under result.
  • Enriched the bellona://remote-control/commands/last-result resource with the same top-level remediation fields for agent recovery after a failed command.
  • Added focused tests for legacy remediation repair, failed tool responses, and last-command-result remediation surfacing.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/command-remediation.test.ts src/remote-control-tools.test.ts src/remote-control-resources.test.ts --reporter=verbose passed from libs/bellona/mcp-gateway.
  • pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.14.23 Dry-Run Per-Namespace Planners#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.test.ts
  • libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.ts
  • libs/bellona/mcp-gateway/src/agent-dry-run-planners.test.ts
  • libs/bellona/mcp-gateway/src/agent-dry-run-planners.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • 180.C.03.16 protocol schemas for RemoteDryRunPlan, predicted changes, cost and time estimates, reversibility, required risk classes, and high-risk dry-run metadata requirements.
  • Existing createBellonaAgentDryRunImpactSummary() behavior from 180.C.14.14, which already returns protocol-valid plans through broad inference before risky actions.
  • Namespace-specific command schemas and fixtures for Blender primitive creation, browser managed profiles and compensating actions, desktop fallback commands, file/project-write policy inference, shell/process command policy, and Unreal command patterns used by the MCP gateway agent policies.

Implementation summary:

  • Added agent-dry-run-planners.ts with deterministic, side-effect-free planners for Blender, Unreal, browser, desktop, file, and shell/process commands.
  • Each namespace planner expands command arguments into concrete predicted changes, target paths or surfaces, namespace-specific assumptions, warnings, rollback metadata, and protocol-valid cost, time, and reversibility fields.
  • Updated createBellonaAgentDryRunImpactSummary() to delegate plan generation to the per-namespace planners while preserving the existing impact-decision API.
  • Added focused planner tests for exact Blender, Unreal, browser, desktop, file, and shell previews, including redacted desktop typing and manual-only shell rollback.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/agent-dry-run-planners.test.ts src/agent-dry-run-impact-summary.test.ts --reporter=verbose passed from libs/bellona/mcp-gateway.
  • pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.14.24 Dry-Run Cost and Time Estimator#

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/agent-dry-run-cost-time-estimator.test.ts
  • libs/bellona/mcp-gateway/src/agent-dry-run-cost-time-estimator.ts
  • libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.ts
  • libs/bellona/mcp-gateway/src/agent-dry-run-planners.ts
  • libs/bellona/mcp-gateway/src/index.ts

Existing implementation patterns analyzed:

  • RemoteDryRunCostEstimate and RemoteDryRunTimeEstimate from 180.C.03.16, including token, compute, bandwidth, render-minute, build-minute, confidence, and metadata fields.
  • Existing gateway telemetry records for command duration metrics, command result timestamps/durations, and protocol metadata.
  • The per-namespace dry-run planners from 180.C.14.23, which already provide deterministic fallback estimates and a single plan-generation point.

Implementation summary:

  • Added agent-dry-run-cost-time-estimator.ts with deterministic historical telemetry matching by command name, namespace, shared command terms, and risk class.
  • The estimator ignores failed samples and populates tokens, compute units, TURN bandwidth, render minutes, build minutes, duration quantiles, confidence, and estimator metadata from recent matched samples.
  • Added a command-result normalization helper so gateway or host result records can become estimator samples without changing protocol schemas.
  • Wired the estimator into createBellonaAgentDryRunPlan() and exposed executionTelemetry through the existing impact-summary and planner APIs; no relevant telemetry falls back to deterministic planner defaults with source metadata.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/agent-dry-run-cost-time-estimator.test.ts src/agent-dry-run-planners.test.ts src/agent-dry-run-impact-summary.test.ts --reporter=verbose passed from libs/bellona/mcp-gateway.
  • pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.14.25 MCP Composition Rules#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/mcp-gateway/README.md
  • libs/bellona/mcp-gateway/src/index.ts
  • libs/bellona/mcp-gateway/src/mcp-composition-rules.test.ts
  • libs/bellona/mcp-gateway/src/mcp-composition-rules.ts

Existing implementation patterns analyzed:

  • stdio-server.ts, which owns the stable Bellona MCP Gateway server identity and transport construction.
  • remote-control-tools.ts, which owns the canonical unqualified Bellona remote-control tool names.
  • remote-control-resources.ts, which already reserves the bellona:// resource namespace for gateway snapshots.
  • Existing MCP agent-side policy helpers, which are deterministic, side-effect-free planners exposed from src/index.ts and covered by focused Vitest suites.

Implementation summary:

  • Added mcp-composition-rules.ts with a deterministic composition planner for Bellona running beside Isis, Yemaya, and third-party MCP servers.
  • Added a canonical Bellona server descriptor helper that uses the existing remote-control tool and resource surface.
  • Implemented discovery ordering, namespace normalization, tool-name collision routing, resource URI qualification, and per-server transport multiplex keys with explicit auth boundaries.
  • Documented the composition policy in the MCP gateway README and exported the planner API from the package entrypoint.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/mcp-composition-rules.test.ts --reporter=verbose passed from libs/bellona/mcp-gateway.
  • pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose passed.
  • pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.14.26 Stage 14 Planning Split Closure#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180-gaps.md
  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md

Existing implementation patterns analyzed:

  • TODOS/phase-180-gaps.md section 9.1, which originally identified 180.C.14 as an oversized stage and proposed a future split.
  • Completed 180.C.14.01-.10 tracker entries, which form the MCP Gateway MVP implementation path.
  • Completed 180.C.14.11-.25 tracker entries, which form the Cloud-Agent Operations and Policy implementation path.

Implementation summary:

  • Added the Stage 14 planning split to the canonical checklist without renumbering already-completed executable items.
  • Recorded 180.C.14.A as MCP Gateway MVP covering .01-.10 and 180.C.14.B as Cloud-Agent Operations and Policy covering .11-.25.
  • Updated the gap analysis disposition so future agents see that the Stage 14 split is resolved for planning while the separate 180.C.26 split remains open for 180.C.26.17.

Verification closure:

  • pnpm exec prettier --check TODOS/phase-180.md TODOS/phase-180-gaps.md docs/domains/bellona/extras/remote-control/implementation-tracker.md passed.
  • git diff --check passed.

180.C.15.01 Unreal Plugin Architecture#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/unreal-plugin-architecture.md

Existing implementation patterns analyzed:

  • Existing Unreal bridge forwarding in apps/bellona/bridge-unreal/src/main.ts and libs/bellona/unreal/src/bridge/unreal-bridge.ts.
  • Unreal version/project/plugin metadata types and version discovery helpers in libs/bellona/unreal/src.
  • Completed Remote Host adapter registry and command executor boundaries in apps/bellona/remote-host/src.
  • Completed Blender/browser docs and gateway-host patterns from earlier Phase 180 stages.
  • Official Unreal 5.6 plugin, module, Remote Control, and Python editor scripting references.

Implementation summary:

  • Added unreal-plugin-architecture.md describing the Stage 15 Unreal plugin boundary, package/module shape, localhost-only transport model, command surface, capability discovery contract, read-only query rules, safe actor spawn requirements, security rules, and testing plan.
  • Explicitly kept Unreal behind the Bellona gateway-host-adapter path and blocked direct MCP/Control Room/agent access to Unreal Editor APIs.
  • Mapped Stage 15 follow-on tasks to the documented architecture without implementing later Stage 15 code early.

Verification closure:

  • pnpm exec prettier --check docs/domains/bellona/extras/remote-control/unreal-plugin-architecture.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md passed.
  • git diff --check passed.

180.C.15.02 Unreal Adapter Capability Discovery#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/package.json
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/adapter-registry.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/index.ts
  • apps/bellona/remote-host/src/unreal-adapter.test.ts
  • apps/bellona/remote-host/src/unreal-adapter.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • pnpm-lock.yaml

Existing implementation patterns analyzed:

  • Blender adapter registration, localhost discovery, health reporting, and routed command handler patterns.
  • Browser adapter discovery, managed-profile safety, command support reporting, and default registry wiring.
  • Remote Host adapter registry, app health/readiness payloads, stop lifecycle, and device-report contribution tests.
  • Existing @bellona/unreal version discovery and .uproject parsing helpers.
  • 180.C.15.01 Unreal plugin architecture note.

Implementation summary:

  • Added unreal-adapter.ts with unreal.adapter.discovery support for engine installations, selected engine version/executable path, configured project path and metadata, Bellona Unreal plugin descriptor/enabled state, editor process state, localhost Remote Control endpoint metadata, readiness blockers, and supported/planned/blocked command lists.
  • Registered adapter:unreal-local and capability:unreal-adapter-discovery in the default Remote Host registry.
  • Reused @bellona/unreal discovery and project parsing helpers through a new Remote Host dependency.
  • Added focused tests for healthy discovery, missing Unreal/project, disabled plugin, protocol-valid registration, and command routing.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/unreal-adapter.test.ts src/adapter-registry.test.ts src/app.test.ts --reporter=verbose passed from apps/bellona/remote-host.
  • pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose passed.
  • pnpm nx run-many -p @bellona/remote-host -t lint,typecheck,test,build --skip-nx-cache --verbose passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.15.03 Unreal Project Info Schema and Mocked Adapter Response#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/index.ts
  • apps/bellona/remote-host/src/unreal-adapter.test.ts
  • apps/bellona/remote-host/src/unreal-adapter.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/index.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • libs/bellona/remote-protocol/src/unreal.test.ts
  • libs/bellona/remote-protocol/src/unreal.ts

Existing implementation patterns analyzed:

  • blender.scene.info protocol schemas, fixtures, schema-registry entries, and host adapter route validation.
  • Browser read-only command envelope patterns for target-specific schemas, bounded arguments, and localhost-only metadata.
  • Remote Host Unreal adapter discovery from 180.C.15.02, including .uproject parsing and Bellona plugin descriptor discovery.
  • 180.C.15.01 read-only Unreal project-info rules and the Stage 15 command sequencing plan.

Implementation summary:

  • Added protocol-owned unreal.project.info schemas, parser helpers, fixtures, schema-registry entries, generated JSON Schema/OpenAPI/proto manifests, and focused protocol tests.
  • Constrained unreal.project.info to read-only execution with standard timeout, localhost-only Remote Control assumptions, mutationAllowed: false, and writesProjectFiles: false.
  • Added capability:unreal-project-info to the Remote Host Unreal adapter and a mocked route handler that returns schema-valid project path/name/status, engine version, plugin/module metadata, target platforms, content roots, mocked map summaries, source-control state, config summary, build targets, and Bellona plugin/Remote Control support from local discovery data.
  • Updated registry/app counts and tests so default device reports include both Unreal discovery and project-info capabilities.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts src/schema-registry.test.ts --reporter=verbose passed from libs/bellona/remote-protocol.
  • pnpm exec vitest run --config vitest.config.ts src/unreal-adapter.test.ts src/adapter-registry.test.ts src/app.test.ts --reporter=verbose passed from apps/bellona/remote-host.
  • Full lint/typecheck/test/build, contract drift, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.15.04 Unreal World Query Schema and Mocked Adapter Response#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/index.ts
  • apps/bellona/remote-host/src/unreal-adapter.test.ts
  • apps/bellona/remote-host/src/unreal-adapter.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • libs/bellona/remote-protocol/src/unreal.test.ts
  • libs/bellona/remote-protocol/src/unreal.ts

Existing implementation patterns analyzed:

  • 180.C.15.03 Unreal project-info protocol and host mocked-response patterns.
  • blender.scene.info scene graph schema validation for duplicate ids, selection references, and bounded object reporting.
  • 180.C.15.01 Unreal read-only world-query rules for levels, actors, data layers, selection, shader compile, editor busy state, and structured blockers.
  • Remote Host default registry/app capability-count tests and route-handler validation.

Implementation summary:

  • Added protocol-owned unreal.world.query command argument, target, envelope, output, world, level, actor, component, transform, editor-state, shader compile, and blocker schemas with parser helpers and fixtures.
  • Added duplicate actor/component/level and broken selection-reference validation to the world-query schema.
  • Registered capability:unreal-world-query in the Remote Host Unreal adapter and added a mocked route handler returning bounded map/world, persistent level, actor class counts, actor samples, optional component samples, selection, editor busy, shader compile, and structured blocker data.
  • Updated Unreal discovery command support so unreal.world.query is supported and only unreal.actor.spawn remains a next-stage command.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts src/schema-registry.test.ts --reporter=verbose passed from libs/bellona/remote-protocol.
  • pnpm exec vitest run --config vitest.config.ts src/unreal-adapter.test.ts src/adapter-registry.test.ts src/app.test.ts --reporter=verbose passed from apps/bellona/remote-host.
  • Full lint/typecheck/test/build, contract drift, Prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.15.05 Unreal Editor Plugin Authenticated Localhost Transport#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/index.ts
  • apps/bellona/remote-host/src/unreal-adapter.test.ts
  • apps/bellona/remote-host/src/unreal-adapter.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/unreal-plugin-architecture.md
  • libs/bellona/unreal/package.json
  • libs/bellona/unreal/project.json
  • libs/bellona/unreal/plugin/BellonaUnrealEditor/BellonaUnrealEditor.uplugin
  • libs/bellona/unreal/plugin/BellonaUnrealEditor/Source/BellonaUnrealEditor/BellonaUnrealEditor.Build.cs
  • libs/bellona/unreal/plugin/BellonaUnrealEditor/Source/BellonaUnrealEditor/Private/BellonaUnrealEditorModule.cpp
  • libs/bellona/unreal/plugin/BellonaUnrealEditor/Source/BellonaUnrealEditor/Public/BellonaUnrealEditorModule.h
  • libs/bellona/unreal/src/index.ts
  • libs/bellona/unreal/src/phase-8-completion.test.ts
  • libs/bellona/unreal/src/plugin-transport.test.ts
  • libs/bellona/unreal/src/plugin-transport.ts

Existing implementation patterns analyzed:

  • 180.C.15.01 Unreal plugin architecture, especially the editor-only plugin shape, token requirement, and loopback-only transport rule.
  • Existing Remote Host Unreal discovery/read-only handlers from 180.C.15.02 through 180.C.15.04.
  • Existing Remote Host gateway signed-token and websocket handshake patterns.
  • Unity editor plugin HTTP transport scaffold for local editor-agent transport shape and editor-only packaging.
  • Official Unreal plugin/module and Remote Control HTTP/WebSocket references already recorded in the architecture note.

Implementation summary:

  • Added @bellona/unreal plugin transport helpers that generate high-entropy per-session bearer tokens, normalize and validate loopback-only endpoints, send authenticated ready probes, reject non-loopback hosts before network use, and classify unauthorized, forbidden, unavailable, and malformed responses.
  • Added an editor-only BellonaUnrealEditor plugin bundle under libs/bellona/unreal/plugin/. It is disabled by default, contains no content, starts no listener without a session token, binds Unreal's HTTP server to 127.0.0.1, and exposes only an authenticated GET /bellona/unreal/v1/ready readiness endpoint.
  • Wired Remote Host Unreal discovery to report Bellona plugin transport endpoint, authentication, readiness, HTTP status, plugin version, and blocked non-loopback state while keeping project/world responses mocked until later Stage 15 routing work.
  • Added package/build assets so the Unreal plugin bundle is included when @bellona/unreal is built or packaged.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/plugin-transport.test.ts src/phase-8-completion.test.ts --reporter=verbose passed from libs/bellona/unreal.
  • pnpm exec vitest run --config vitest.config.ts src/unreal-adapter.test.ts src/adapter-registry.test.ts src/app.test.ts --reporter=verbose passed from apps/bellona/remote-host.
  • pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose passed.
  • pnpm nx run-many -p @bellona/unreal,@bellona/remote-host -t lint,test,build --skip-nx-cache --verbose passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.15.06 Unreal Read-Only Gateway Host Route#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/package.json
  • apps/bellona/remote-host/project.json
  • apps/bellona/remote-host/scripts/unreal-readonly-remote-smoke.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md

Existing implementation patterns analyzed:

  • Existing gateway command-dispatcher.ts and host connection routing for generic RemoteCommandEnvelope dispatch, client-event publication, audit writes, telemetry, and timeline collection.
  • Existing blender.scene.info gateway fake-host route coverage in apps/bellona/remote-gateway/src/command-dispatcher.test.ts.
  • Existing Remote Host blender:scene-info-remote-smoke script, which starts an ephemeral gateway plus outbound host to exercise the gateway-host-adapter path without exposing adapter ports.
  • Existing protocol-owned Unreal fixtures and Remote Host Unreal adapter registration from 180.C.15.03 through 180.C.15.05.

Implementation summary:

  • Added gateway command-dispatcher coverage that registers an Unreal-capable connected host, dispatches unreal.project.info and unreal.world.query, sends progress and result messages from the fake host, validates RemoteUnrealProjectInfoSchema / RemoteUnrealWorldQuerySchema, and asserts gateway audit, telemetry, and timeline visibility.
  • Added unreal:readonly-remote-smoke for @bellona/remote-host. The smoke starts an ephemeral gateway and outbound host, registers the Unreal adapter, dispatches both read-only commands through the gateway, validates protocol outputs, and prints per-command timeline and audit evidence.
  • Documented the Unreal remote smoke and gateway fake-host coverage so the read-only Unreal route is now represented by the same visibility model used by the completed Blender/browser gateway-host path.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/command-dispatcher.test.ts --reporter=verbose passed from apps/bellona/remote-gateway.
  • pnpm nx unreal:readonly-remote-smoke @bellona/remote-host --skip-nx-cache --verbose passed.
  • pnpm nx run-many -p @bellona/remote-gateway,@bellona/remote-host -t lint,typecheck,test,build --skip-nx-cache --verbose passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.15.07 Unreal Actor Spawn Safe Mutation#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/command-dispatcher.test.ts
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/adapter-registry.test.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/index.ts
  • apps/bellona/remote-host/src/policy-preflight.test.ts
  • apps/bellona/remote-host/src/policy-preflight.ts
  • apps/bellona/remote-host/src/unreal-adapter.test.ts
  • apps/bellona/remote-host/src/unreal-adapter.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • libs/bellona/remote-protocol/README.md
  • libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json
  • libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json
  • libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json
  • libs/bellona/remote-protocol/src/fixtures.ts
  • libs/bellona/remote-protocol/src/policy.test.ts
  • libs/bellona/remote-protocol/src/policy.ts
  • libs/bellona/remote-protocol/src/schema-registry.test.ts
  • libs/bellona/remote-protocol/src/schema-registry.ts
  • libs/bellona/remote-protocol/src/unreal.test.ts
  • libs/bellona/remote-protocol/src/unreal.ts

Existing implementation patterns analyzed:

  • Blender primitive safe-mutation command metadata and undo-stack precedent in libs/bellona/remote-protocol/src/blender.ts and apps/bellona/remote-host/src/blender-adapter.ts.
  • Gateway command-dispatcher policy/audit/timeline coverage for Blender safe mutations and Unreal read-only host routing.
  • Remote Host adapter registration, command handler, and observe-only preflight patterns from the Blender and Unreal adapters.

Implementation summary:

  • Added protocol-owned unreal.actor.spawn command arguments, metadata, target, envelope, result, actor reference, transaction, and evidence placeholder schemas. The command is constrained to safe-mutation, short timeout, undo_stack, dry-run metadata, editor transaction/undo checkpoint metadata, localhost-only assumptions, and writesProjectFiles: false.
  • Added canonical fixtures and registry coverage for the actor-spawn command and result. Policy inference now treats spawn as a mutating term so Unreal actor spawn requires both command.execute.safe-mutation and project.write.
  • Registered capability:unreal-actor-spawn in the Remote Host Unreal adapter, added a mocked execution path that returns a spawned actor object reference, committed transaction/undo checkpoint metadata, and screenshot/evidence placeholder, and extended host preflight to block Unreal mutations in observe-only sessions.
  • Added gateway coverage for dispatch, client progress/result routing, audit, timeline, policy allow, and pre-host policy denial for unreal.actor.spawn.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts src/schema-registry.test.ts src/policy.test.ts --reporter=verbose passed from libs/bellona/remote-protocol.
  • pnpm exec vitest run --config vitest.config.ts src/unreal-adapter.test.ts src/adapter-registry.test.ts src/app.test.ts src/policy-preflight.test.ts --reporter=verbose passed from apps/bellona/remote-host.
  • pnpm exec vitest run --config vitest.config.ts src/command-dispatcher.test.ts --reporter=verbose passed from apps/bellona/remote-gateway.
  • Full lint/typecheck/test/build, contract, prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.15.08 Unreal Mocked Failure Matrix#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-host/src/unreal-adapter.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md

Existing implementation patterns analyzed:

  • Existing Remote Host Unreal adapter tests for project-info success, world-query success, plugin transport probing, missing project diagnostics, and actor-spawn success from 180.C.15.03 through 180.C.15.07.
  • Host preflight and gateway policy-denial coverage added by 180.C.15.07.

Implementation summary:

  • Added explicit mocked coverage for missing Unreal Engine while a project and plugin descriptor remain configured, missing Bellona Unreal plugin descriptor for a configured project, and a project-configured/editor-not-running world-query path.
  • Added mocked actor-spawn transaction failure coverage using a protocol-valid failed undo_stack transaction result with screenshot evidence placeholder.
  • Confirmed the broader matrix is covered by existing read-only query success, spawn success, and policy denial tests from 180.C.15.07, plus the new failure-focused Remote Host tests in this item.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/unreal-adapter.test.ts src/policy-preflight.test.ts --reporter=verbose passed from apps/bellona/remote-host.
  • Full lint/typecheck/test/build, prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.15.09 Unreal Fixture Project Smoke#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/package.json
  • apps/bellona/remote-host/project.json
  • apps/bellona/remote-host/scripts/unreal-actor-spawn-remote-smoke.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md

Existing implementation patterns analyzed:

  • Optional Blender local smoke tests that skip unless fixture/runtime variables are configured.
  • Existing Unreal read-only remote smoke and Stage 15 architecture notes that call out unreal-actor-spawn-remote-smoke.ts as the hardware evidence entry point.

Implementation summary:

  • Added unreal:actor-spawn-remote-smoke for @bellona/remote-host. The smoke exits with a structured skipped result unless BELLONA_UNREAL_HARDWARE_SMOKE=1 or --required is supplied.
  • When enabled, the smoke reads BELLONA_UNREAL_PROJECT_PATH plus optional plugin descriptor, plugin session token, plugin host/port, and Remote Control port variables, discovers Unreal readiness, validates unreal.project.info, unreal.world.query, and unreal.actor.spawn, and prints hardware evidence fields for project path, plugin state, editor process, command ids, actor id, transaction id, undo checkpoint id, and screenshot placeholder status.
  • Documented the command and required environment variables in the Remote Host README.

Verification closure:

  • pnpm nx unreal:actor-spawn-remote-smoke @bellona/remote-host --skip-nx-cache --verbose passed in skipped mode because the current machine has no configured Unreal fixture project.
  • Full lint/typecheck/test/build, prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.15.10 Unreal Read-Only And Safe Mutation MVP Closure#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-host/README.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/unreal-plugin-architecture.md
  • docs/domains/bellona/extras/remote-control/unreal-readonly-safe-mutation-mvp-closure.md

Existing implementation patterns analyzed:

  • docs/domains/bellona/extras/remote-control/blender-safe-mutation-mvp-closure.md for the closest completed safe-mutation stage closure pattern.
  • Stage 15 implementation records for Unreal discovery, project info, world query, plugin localhost transport, gateway-host routing, actor spawn, mocked failure coverage, and optional hardware smoke.
  • docs/domains/bellona/extras/remote-control/unreal-plugin-architecture.md for the Stage 15 gate and required separation between deterministic CI evidence and optional hardware evidence.

Implementation summary:

  • Added docs/domains/bellona/extras/remote-control/unreal-readonly-safe-mutation-mvp-closure.md tying together protocol ownership, host adapter capability, gateway policy, audit/timeline routing, transaction/undo metadata, evidence placeholders, mocked failure coverage, optional hardware smoke, and known live-editor limitations.
  • Linked the closure from the Remote Host README and Unreal architecture note.
  • Checked off 180.C.15.10 only after all prior Stage 15 items were complete and after deterministic verification could prove the Stage 15 command path.

Verification closure:

  • pnpm nx unreal:readonly-remote-smoke @bellona/remote-host --skip-nx-cache --verbose validates read-only gateway-host-adapter audit and timeline evidence.
  • pnpm nx unreal:actor-spawn-remote-smoke @bellona/remote-host --skip-nx-cache --verbose validates the optional smoke entry point in structured skip mode on this machine because no Unreal fixture project is configured.
  • Full contracts, lint/typecheck/test/build, prettier, and diff-check verification is recorded in the progress table for this completed item.

180.C.16.01 Remote Host macOS Keychain Identity Storage#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-gateway/README.md
  • apps/bellona/remote-gateway/src/app.test.ts
  • apps/bellona/remote-gateway/src/pairing-exchange.ts
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/scripts/blender-create-primitive-remote-smoke.ts
  • apps/bellona/remote-host/scripts/blender-scene-info-remote-smoke.ts
  • apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts
  • apps/bellona/remote-host/scripts/desktop-fallback-remote-smoke.ts
  • apps/bellona/remote-host/scripts/unreal-readonly-remote-smoke.ts
  • apps/bellona/remote-host/src/app.test.ts
  • apps/bellona/remote-host/src/app.ts
  • apps/bellona/remote-host/src/config.test.ts
  • apps/bellona/remote-host/src/config.ts
  • apps/bellona/remote-host/src/identity-store.test.ts
  • apps/bellona/remote-host/src/identity-store.ts
  • apps/bellona/remote-host/src/index.ts
  • apps/bellona/remote-host/src/pairing-client.test.ts
  • apps/bellona/remote-host/src/pairing-client.ts
  • docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md

Existing implementation patterns analyzed:

  • The existing development file identity store and pairing client, including signed host-token schema validation and atomic file writes.
  • Remote Host app health/readiness handling for missing and invalid identity stores.
  • Existing mobile-only secure-storage/keychain references, which were not reusable for this Node/macOS host process.
  • The macOS security add-generic-password help output, which marks -w value as insecure and recommends placing -w last so the password is read interactively.

Implementation summary:

  • Added MacOSKeychainRemoteHostIdentityStore as the default Remote Host identity store. It stores the complete host identity, deviceKeyId, expiresAt, and signed hostToken in a generic password item under configurable service/account values.
  • The Keychain writer invokes /usr/bin/security add-generic-password with -w as the final argument and sends the serialized identity through stdin, so signed host tokens are not passed in the process argument list.
  • Added explicit config for BELLONA_REMOTE_HOST_IDENTITY_STORAGE, BELLONA_REMOTE_HOST_KEYCHAIN_SERVICE, and BELLONA_REMOTE_HOST_KEYCHAIN_ACCOUNT; macos-keychain is the default and development-file remains available only for deterministic local fixtures.
  • Updated pairing so returned credentials are saved through the selected store and Keychain identities are persisted without the legacy keychainReplacementTask marker.
  • Updated gateway pairing metadata, Remote Host health/log storage reporting, deterministic smoke identity-store fixtures, and runbook/README docs.

Verification closure:

  • Focused Remote Host identity, pairing, config, and app tests passed.
  • Focused Remote Gateway pairing app/token/code tests passed.
  • Full Remote Host and Gateway lint/typecheck/test/build verification passed; the Nx output retained the existing @bellona/unreal:build flaky-task note while exiting successfully.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.16.02 macOS Signed And Notarized Packaging Plan#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/index.ts
  • apps/bellona/remote-host/src/macos-packaging-plan.test.ts
  • apps/bellona/remote-host/src/macos-packaging-plan.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/macos-packaging-and-notarization-plan.md

Existing implementation patterns analyzed:

  • libs/bellona/editor-productization/src/plugin-distribution.ts for the existing editor-plugin artifact planning shape.
  • docs/domains/bellona/extras/remote-control/external-implementation-research-2026-04-21.md and hardware-rig-inventory.md for prior macOS signing, TCC, and hardware evidence constraints.
  • Apple Developer documentation for distribution-signed macOS code, Mac software packaging, notarization before distribution, custom notarization workflows, and common notarization issues.

Implementation summary:

  • Added createRemoteHostMacOSPackagingPlan() with a typed release contract for the Remote Host app bundle, LaunchAgent plist, helper tools, Blender add-on, Unreal plugin, and final Developer ID Installer package.
  • The plan enforces inside-out signing order, Developer ID Application versus Developer ID Installer boundaries, hardened runtime requirements, notarytool and stapler usage, Gatekeeper verification commands, and explicit rejection of ad hoc signatures or altool.
  • Added unit tests for artifact coverage, signing order, notarization commands, Gatekeeper verification, plugin artifact separation, and installer blockers.
  • Added docs/domains/bellona/extras/remote-control/macos-packaging-and-notarization-plan.md documenting required signing environment, artifact responsibilities, command skeleton, and release gate evidence.

Verification closure:

  • Focused Remote Host packaging plan tests passed.
  • Full Remote Host lint/typecheck/test/build verification passed; the Nx output retained the existing @bellona/unreal:build flaky-task note while exiting successfully.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.16.03 Signed Update Channel, Rollback, And Adapter Compatibility Plan#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • apps/bellona/remote-host/README.md
  • apps/bellona/remote-host/src/index.ts
  • apps/bellona/remote-host/src/macos-packaging-plan.test.ts
  • apps/bellona/remote-host/src/macos-packaging-plan.ts
  • apps/bellona/remote-host/src/update-manifest.test.ts
  • apps/bellona/remote-host/src/update-manifest.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/macos-packaging-and-notarization-plan.md
  • docs/domains/bellona/extras/remote-control/remote-host-update-channel-and-rollback-plan.md

Existing implementation patterns analyzed:

  • libs/oshun/shell-desktop/src/update-manager.ts and types.ts for the existing desktop channel vocabulary and update progress model.
  • libs/neith/integration-bellona/src/deployment-system/rollout-strategies.ts and libs/neith/linux/crates/neith-update-agent/src/rollback.rs for rollout and rollback design precedents already present in the repo.
  • TUF, Sparkle, and electron-builder primary documentation for signed metadata, rollback/freeze protection, EdDSA/appcast workflows, channels, and staged rollout patterns.

Implementation summary:

  • Added a typed signed update manifest contract with stable JSON canonicalization, Ed25519 signature verification, trusted-key channel scoping, manifest expiry checks, and monotonic manifestVersion protection.
  • Added channel policy for stable, beta, canary, and internal, reusing the existing shell desktop vocabulary while requiring Remote Host-specific signed metadata before install or rollback.
  • Added artifact validation for the Remote Host installer package, app bundle, LaunchAgent, desktop helper, Blender add-on, and Unreal plugin.
  • Added adapter compatibility validation so a manifest cannot strand an installed Blender add-on, Unreal plugin, or desktop helper outside its supported version range.
  • Removed the now-completed 180.C.16.03 blocker from the macOS packaging plan and docs while keeping later live notarized installer evidence blocked on Stage 26.
  • Documented rollback as a new signed manifest version, not replay of old metadata, with failed-update recovery preserving Keychain identity and prior signed artifacts.

Verification closure:

  • Focused Remote Host update-manifest tests passed.
  • Focused Remote Host packaging plan tests passed after updating the completed blocker.
  • Full Remote Host lint/typecheck/test/build verification passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.16.04 Network Impairment Test Harness#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/network-impairment.ts
  • testing/bellona/remote-control/tests/__snapshots__/snapshot-fixtures.test.ts.snap
  • testing/bellona/remote-control/tests/network-impairment.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/network-impairment-test-plan.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-host/src/gateway-connection.ts and gateway-connection.test.ts for existing reconnect state and manager behavior.
  • testing/bellona/remote-control/fake-gateway-transport.ts and fake-host-adapter.ts for reusable in-memory connection, disconnect, dispatch, progress, and audit behavior.
  • compatibility-matrix.md, external-implementation-research-2026-04-21.md, hardware-rig-inventory.md, and hetzner-reference-deployment.md for previous TURN, same-LAN, cloud, and hardware-evidence constraints.

Implementation summary:

  • Added createRemoteControlNetworkImpairmentPlan() and deterministic scenario runners for gateway restart, host reconnect, host sleep/wake, packet loss, high latency, and TURN fallback placeholder.
  • Reused the existing fake gateway/host harness so reconnect scenarios prove command dispatch resumes after disconnect/reconnect without adding real sockets or OS network shaping.
  • Added packet-loss and high-latency fixtures that emit degraded progress, warnings, and metrics instead of silently reporting success.
  • Kept TURN fallback as an explicit placeholder requiring later WebRTC signaling, TURN credentials, TURN-only relay smoke, and teardown evidence.
  • Refreshed the existing remote-control snapshot fixture after the package-wide test gate exposed snapshot drift from prior completed adapter/capability work.

Verification closure:

  • Focused network-impairment harness tests passed.
  • Focused snapshot fixture refresh test passed.
  • Full remote-control testing lint/typecheck/test/build verification passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.16.05 Security Regression Harness#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/security-regression.ts
  • testing/bellona/remote-control/tests/security-regression.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/security-regression-test-plan.md

Existing implementation patterns analyzed:

  • testing/bellona/remote-control/protocol-fuzzing-harness.ts for existing schema, policy-bypass, and approval downgrade fuzz coverage.
  • libs/bellona/remote-protocol/src/command.ts and policy.ts for canonical approval, risk-class, dry-run, device status, and permission-scope rules.
  • apps/bellona/remote-gateway/src/redaction.ts, device-revocation.ts, and command-dispatcher.test.ts for existing redaction, revocation, policy denial, and approval continuation behavior.
  • OWASP prompt-injection, logging, and secrets-management guidance for the deterministic fixture scope documented in the test plan.

Implementation summary:

  • Added createRemoteControlSecurityRegressionPlan() and deterministic scenario runners for prompt injection, denied paths, denied app/window context, revoked devices, approval bypass attempts, and secret redaction.
  • Added prompt-injection inspection that classifies untrusted content as quoted data only when it attempts instruction override, hidden instruction content, system prompt exfiltration, secret exfiltration, or tool hijack.
  • Reused the canonical protocol schema and policy evaluator for denied project-write paths, revoked device fail-closed behavior, and destructive approval downgrade rejection.
  • Added recursive evidence redaction for bearer tokens, host tokens, API keys, browser cookies, passwords, personal paths, denied app names, and denied window titles.
  • Documented the live browser, filesystem, macOS capture, revocation, approval replay, and support-bundle evidence still required before production signoff.

Verification closure:

  • Focused security-regression harness tests passed.
  • Full remote-control testing lint/typecheck/test/build verification passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.16.06 Performance Budget Harness#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/performance-budgets.ts
  • testing/bellona/remote-control/tests/performance-budgets.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/performance-budget-test-plan.md

Existing implementation patterns analyzed:

  • testing/bellona/remote-control/fake-host-adapter.ts, snapshot-fixtures.ts, and network-impairment.ts for existing deterministic command durations, stream descriptors, latency fixtures, and reconnect cases.
  • apps/bellona/remote-gateway/src/command-dispatcher.ts and telemetry.ts for command duration, command failure, host online, reconnect, and approval latency metric patterns.
  • apps/bellona/remote-host/src/command-executor.ts and blender-adapter.ts for host-side result duration and Blender addon latency measurement.
  • apps/bellona/control-room/src/stream-preview.ts and webrtc-loopback.ts for stream latency labels and local startup timing.

Implementation summary:

  • Added createRemoteControlPerformanceBudgetPlan() and deterministic budget runners for command latency, stream startup, screenshot capture, browser navigation, Blender command time, and gateway-host reconnect.
  • Added p50, p95, max, average, and sample-count metric calculation with target p95, hard max p95, and minimum sample-count release-gate rules.
  • Added passed, warning, and failed budget classification so release gates can distinguish target drift from hard blockers.
  • Documented the live LAN, cloud gateway, WebRTC/TURN, macOS capture, managed-browser, Blender, and reconnect evidence required before production performance signoff.

Verification closure:

  • Focused performance-budget harness tests passed.
  • Full remote-control testing lint/typecheck/test/build verification passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.16.07 MVP Alpha Operations Runbooks#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/mvp-alpha-operations-runbooks.md

Existing implementation patterns analyzed:

  • blender-read-only-mvp-second-macbook.md for the existing two-MacBook LAN setup, outbound host rule, loopback-only Blender addon, and scene-info smoke.
  • hetzner-reference-deployment.md and aws-reference-deployment.md for cloud gateway setup, public TLS readiness, firewall/security group boundaries, and host-facing WSS configuration.
  • session-timeline-and-audit-bundle.md for timeline review, audit bundle export, artifact registration, and checksum evidence.
  • apps/bellona/remote-host/README.md, macos-packaging-and-notarization-plan.md, network-impairment-test-plan.md, security-regression-test-plan.md, and performance-budget-test-plan.md for TCC permissions, uninstall boundaries, stream failure, revocation, and performance evidence requirements.

Implementation summary:

  • Added a consolidated MVP alpha operations runbook covering two-MacBook LAN setup, cloud gateway setup, permissions troubleshooting, plugin repair, stream failure, revocation, audit export, and uninstall.
  • Each runbook includes prerequisites, concrete commands or operator steps, required evidence, and stop conditions that preserve outbound-only host, loopback-only adapter, policy, approval, audit, redaction, and evidence boundaries.
  • Documented current limitations for live hardware, cloud, WebRTC/TURN, packaging/uninstall, plugin repair, and production artifact behavior.

Verification closure:

  • Documentation formatting and diff-check verification is recorded in the progress table for this completed item.

180.C.16.08 Deployment Smoke Harness#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/deployment-smoke.ts
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/tests/deployment-smoke.test.ts
  • docs/domains/bellona/extras/remote-control/deployment-smoke-test-plan.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md

Existing implementation patterns analyzed:

  • testing/bellona/remote-control/fake-gateway-transport.ts and fake-host-adapter.ts for the reusable in-memory host connection, command dispatch, progress, event, and audit behavior.
  • local-cloud-agent-simulation.md, blender-read-only-mvp-second-macbook.md, and mvp-alpha-operations-runbooks.md for local and same-LAN smoke commands, outbound-only host requirements, and evidence capture.
  • hetzner-reference-deployment.md and aws-reference-deployment.md for public TLS readiness, firewall/security-group boundaries, provider health checks, logs, and local-only gateway port proof.
  • network-impairment.ts, security-regression.ts, and performance-budgets.ts for the Stage 16 pattern of deterministic fixtures that record later live evidence requirements without claiming unavailable hardware or cloud coverage.

Implementation summary:

  • Added createRemoteControlDeploymentSmokePlan() and deterministic scenario runners for local, LAN, Hetzner reference, and AWS reference modes.
  • Reused the fake gateway/host harness so every mode exercises a protocol-valid outbound host connection, diagnostic readiness command, event stream, progress output, and audit entry.
  • Recorded each mode's gateway profile, protocol network mode, smoke commands, required probes, deployment references, release gate, and hardware/cloud evidence requirements.
  • Marked LAN, Hetzner, and AWS results as live-hardware-required evidence so the harness validates the smoke contract without claiming a physical two-MacBook, provider edge, TLS, firewall, ALB, TURN, Blender, Unreal, browser, or desktop deployment has actually run.
  • Added explicit liveDeploymentEvidenceRequired and releaseSignoffEligible fields so deterministic fixture success cannot be misread as release signoff for LAN, Hetzner, or AWS modes.

Verification closure:

  • Focused deployment-smoke harness tests passed.
  • Full remote-control testing lint/typecheck/test/build verification passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.16.09 MVP Alpha Release Gate#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/mvp-alpha-release-gate.ts
  • testing/bellona/remote-control/tests/mvp-alpha-release-gate.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/mvp-alpha-release-gate.md

Existing implementation patterns analyzed:

  • ADR-0005-mvp-release-artifact-and-gates.md for the normative MVP alpha artifact definition, required stages, docs bundle, and demo scenarios.
  • Completed tracker rows across 180.C.09 through 180.C.16.08 for the actual package verification commands and smoke commands the alpha gate must require.
  • deployment-smoke.ts, network-impairment.ts, security-regression.ts, and performance-budgets.ts for the deterministic Stage 16 suite-composition pattern.
  • Existing Bellona release/smoke plan code in libs/bellona/editor-productization for a concise plan-plus-release-gate structure.

Implementation summary:

  • Added createRemoteControlMvpAlphaReleaseGatePlan() to record the MVP alpha gate as a structured checklist over prerequisite stages, docs bundle, demo scenarios, and the protocol/gateway/host/policy/audit/Blender/browser/desktop fallback/Control Room/MCP/Unreal/deployment/security/performance/network checks required before release.
  • Added evaluateRemoteControlMvpAlphaReleaseGate() to combine deterministic Stage 16 suites with an explicit evidence snapshot for package verification, Playwright, cloud deployment, and hardware evidence that this test package cannot infer on its own.
  • Added createPassingRemoteControlMvpAlphaEvidenceSnapshot() as a fixture for the fully satisfied gate state so future release automation can evolve from a concrete contract instead of ad hoc checklist text.
  • Documented the gate semantics, required commands, and the distinction between Stage 16 MVP alpha and Stage 29 GA in a dedicated release-gate note.

Verification closure:

  • Focused MVP alpha release-gate tests passed.
  • Full remote-control testing lint/typecheck/test/build verification passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.16.10 MVP Alpha Architecture Stability Closure#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/mvp-alpha-architecture-stability.md

Existing implementation patterns analyzed:

  • Prior stage-closure items such as 180.C.02.12, 180.C.10.08, and 180.C.15.10, which all used a closure note plus tracker/checklist updates instead of inventing new runtime code.
  • ADR-0001, ADR-0002, ADR-0003, and ADR-0005 for the architecture, trust, threat-model, and MVP alpha release invariants that later stages must preserve.
  • The completed Stage 16 deployment, security, performance, network, runbook, and MVP alpha release-gate notes for the concrete evidence that now anchors the architecture.

Implementation summary:

  • Added mvp-alpha-architecture-stability.md to record the stable control-plane invariants now enforced by protocol ownership, gateway authority, outbound-only host topology, localhost-only adapters, policy/approval/audit, deterministic fixture harnesses, and the MVP alpha release gate.
  • Documented what future Blender, browser, Unreal, deployment, security, and fleet stages should extend versus what they should not replace.
  • Recorded the specific stability statement that satisfies 180.C.16.10: later stages can broaden capability and evidence without re-architecting the core Bellona Remote Gateway plus Remote Host control plane.

Verification closure:

  • Documentation formatting and diff-check verification is recorded in the progress table for this completed item.

180.C.16.11 MVP Alpha Demo Scenarios#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/mvp-alpha-demo-scenarios.ts
  • testing/bellona/remote-control/tests/mvp-alpha-demo-scenarios.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/mvp-alpha-demo-scenarios.md

Existing implementation patterns analyzed:

  • ADR-0005-mvp-release-artifact-and-gates.md for the existing MVP scenario requirements and release-evidence expectations.
  • operator-workflow-blender-browser-mvp.md, mvp-alpha-operations-runbooks.md, blender-read-only-mvp-second-macbook.md, blender-safe-mutation-mvp-closure.md, and unreal-readonly-safe-mutation-mvp-closure.md for the exact committed smoke commands and operator evidence the script catalog should reuse.
  • The Stage 16 plan/evaluator pattern in mvp-alpha-release-gate.ts and the deterministic test-plan modules already added to @bellona/remote-control-testing.

Implementation summary:

  • Added createRemoteControlMvpAlphaDemoPlan() with three scripted release evidence scenarios: the solo-creator two-Mac LAN happy path, the reference cloud gateway path, and the safety/resilience evidence pack.
  • Made the primary scenario explicitly cover the requested MVP actions in order: pair two Macs, query Blender scene info, create one primitive, navigate the managed browser, capture a screenshot artifact, and complete operator approval plus replay.
  • Attached commands, required evidence, and acceptance criteria to every demo step so the release bundle can point to a concrete script rather than freeform operator notes.
  • Documented the scenario catalog and the expected release-evidence bundle in a dedicated MVP alpha demo-scenarios note.

Verification closure:

  • Focused MVP alpha demo-scenarios tests passed.
  • Documentation formatting and diff-check verification is recorded in the progress table for this completed item.

180.C.16.12 MVP Alpha SLOs And Error Budgets#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/mvp-alpha-release-gate.ts
  • testing/bellona/remote-control/mvp-alpha-slos.ts
  • testing/bellona/remote-control/tests/mvp-alpha-release-gate.test.ts
  • testing/bellona/remote-control/tests/mvp-alpha-slos.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/mvp-alpha-release-gate.md
  • docs/domains/bellona/extras/remote-control/mvp-alpha-slos-and-error-budgets.md

Existing implementation patterns analyzed:

  • apps/bellona/remote-gateway/src/command-dispatcher.ts, approval-service.ts, and audit-log.ts for the latency and durability signals Bellona already emits or can derive without inventing new semantics.
  • apps/bellona/control-room/src/stream-preview.ts and webrtc-loopback.ts plus performance-budgets.ts for the existing stream startup timing model.
  • infra/monitoring/iris/prometheus/recording-rules.yaml and infra/monitoring/iris/alerting/alerts.yaml for the repo's local precedent on error-budget math and burn-rate alert thresholds.
  • mvp-alpha-release-gate.ts for the Stage 16 evidence-snapshot pattern this SLO policy needed to plug into directly.

Implementation summary:

  • Added mvp-alpha-slos.ts with four explicit MVP alpha indicators: command acknowledgement latency, stream start latency, approval round-trip time, and audit write durability.
  • Encoded the 30-day objectives, minimum release sample counts, live-evidence requirements, and multiwindow burn-rate alerts (14.4, 6, and 1) as a deterministic evaluator rather than leaving the policy implicit in prose.
  • Added createPassingRemoteControlMvpAlphaSloEvidenceSnapshot() so the release gate and future automation can share one canonical healthy evidence shape.
  • Extended the MVP alpha release gate to require the published SLO note and a passing slo-error-budget-policy check before MVP alpha can pass.
  • Documented the policy math, thresholds, alert windows, and release semantics in a dedicated SLO and error-budget note.

Verification closure:

180.C.16.13 MVP Alpha Soak-Test Plan#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/mvp-alpha-soak-plan.ts
  • testing/bellona/remote-control/tests/mvp-alpha-soak-plan.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/mvp-alpha-soak-test-plan.md

Existing implementation patterns analyzed:

  • network-impairment.ts and network-impairment-test-plan.md for the already-defined sleep/wake and reconnect evidence Bellona expects from later hardware runs.
  • remote-host-update-channel-and-rollback-plan.md and macos-packaging-plan.ts for the LaunchAgent restart, rollback, and repair surfaces this soak plan has to exercise.
  • apps/bellona/remote-host/src/app.ts and adapter-registry.ts for the current host uptime, health/readiness payloads, and memory-pressure signals.

Implementation summary:

  • Added createRemoteControlMvpAlphaSoakPlan() to encode a real 72+ hour soak matrix instead of leaving long-run stability as an informal checklist.
  • Defined recurring probes for host health/readiness, low-risk command-path probes, RSS plus state.snapshot memory tracking, audit-store growth, and daily audit export validation.
  • Structured the run into warmup, day-one uptime, day-two recovery, and day three crash-loop/export phases with explicit drills and fail-fast conditions.
  • Documented the soak plan in a dedicated MVP alpha note so later Stage 26 and Stage 28 work can reuse one long-run evidence contract instead of drifting.

Verification closure:

180.C.16.14 MVP/GA Release Gate Alignment#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/mvp-alpha-release-gate.ts
  • testing/bellona/remote-control/release-gate-alignment.ts
  • testing/bellona/remote-control/tests/mvp-alpha-release-gate.test.ts
  • testing/bellona/remote-control/tests/release-gate-alignment.test.ts
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/mvp-alpha-release-gate.md
  • docs/domains/bellona/extras/remote-control/release-gate-alignment.md

Existing implementation patterns analyzed:

  • ADR-0005-mvp-release-artifact-and-gates.md for the normative split between the MVP alpha artifact gate and the final GA artifact gate.
  • mvp-alpha-release-gate.ts and mvp-alpha-release-gate.md for the current Stage 16 release contract that later GA work has to inherit rather than redefine.
  • TODOS/phase-180.md Stage 180.C.29.08 through .10 for the exact final verification, release-evidence, and acceptance language the GA gate must preserve.

Implementation summary:

  • Added createRemoteControlReleaseGateAlignmentPlan() so the Stage 16 gate and the future Stage 29 GA gate share one explicit required-stage matrix.
  • Moved the MVP alpha stage list used by mvp-alpha-release-gate.ts into the shared alignment module and extended it through 180.C.16.13 and 180.C.16.14.
  • Documented the shared alpha-versus-GA stage matrix, the GA-only additions, and the conditional 180.C.36/.37 scope rules in a dedicated release-gate alignment note.

Verification closure:

  • Focused release-gate alignment tests passed.
  • Full remote-control testing lint/typecheck/test/build verification passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

180.C.16.15 Bridge Coexistence And Deprecation Plan#

Status: Complete

Implementation date: 2026-04-23

Files changed:

  • TODOS/phase-180.md
  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/bridge-coexistence-plan.ts
  • testing/bellona/remote-control/tests/bridge-coexistence-plan.test.ts
  • docs/domains/bellona/extras/remote-control/bridge-coexistence-and-deprecation-plan.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md

Existing implementation patterns analyzed:

  • apps/bellona/bridge-blender/src/main.ts and apps/bellona/bridge-unreal/src/main.ts for the current legacy bridge-core command surfaces and loopback endpoints.
  • apps/bellona/remote-host/src/blender-adapter.ts, apps/bellona/remote-host/src/unreal-adapter.ts, and apps/bellona/remote-host/README.md for the current protocol-owned replacements that can already absorb legacy traffic.
  • unreal-plugin-architecture.md, the Stage 180.C.02.02 and .04 audits, and Stage 180.C.38 checklist items for the later migration, telemetry, and removal responsibilities this plan has to drive.

Implementation summary:

  • Added createRemoteControlBridgeCoexistencePlan() to encode the old Blender/Unreal bridge command surfaces, current translation candidates, compatibility-only commands, coexistence rules, and Stage 180.C.38.09 removal gate in one typed contract.
  • Anchored the bridge hard cutover date to 2026-10-21 with a required warning lead time so later deprecation work has a concrete date instead of a vague future milestone.
  • Documented the coexistence and deprecation plan in a dedicated note tied directly to Stage 180.C.38 execution tasks.

Verification closure:

  • Focused bridge coexistence plan tests passed.
  • Full remote-control testing lint/typecheck/test/build verification passed.
  • Prettier and diff-check verification is recorded in the progress table for this completed item.

Stage 180.C.29/30 Final GA Release Gate Local Contract#

Implementation date: 2026-07-02.

Related open checklist items:

  • 180.C.29.08 final verification matrix.
  • 180.C.29.09 release evidence bundle.
  • 180.C.29.10 final product acceptance scenarios.
  • 180.C.29.12 Stage 29 roll-up.
  • 180.C.30.10 one-or-many host fleet closure.

Changed files:

  • testing/bellona/remote-control/final-ga-release-gate.ts
  • testing/bellona/remote-control/tests/final-ga-release-gate.test.ts
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/README.md
  • docs/domains/bellona/extras/remote-control/final-ga-release-gate.md
  • docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Implementation summary:

  • Added createRemoteControlFinalGaReleaseGatePlan() to encode the Stage 180.C.29.08 verification matrix, including format, lint, typecheck, unit, integration, contract, Playwright/accessibility, security, performance, deployment smoke, and hardware-in-the-loop requirements.
  • Added release-evidence requirements for test logs, screenshots/streams where allowed, diagnostic bundles, security/privacy review, known risks, rollback plan, compatibility matrix, package/supply-chain evidence, Stage 26 macOS host packaging/acceptance evidence, and operator acceptance signoff.
  • Added final product acceptance scenarios for same-LAN two-MacBook, Hetzner/AWS cloud-agent, Blender edit, browser workflow, desktop fallback, Unreal edit, artifact transfer, operator approval, takeover, replay export, revocation, and uninstall.
  • Added the Stage 180.C.29.12 and 180.C.30.10 dependency gates so the release cannot be marked closed while verification, evidence, acceptance, conditional platform scope, or fleet closure evidence is missing.
  • Tightened conditional 180.C.36/180.C.37 scope waivers so bare stage IDs do not pass; a waiver must carry canonical macOS-scoped release notes, target-platform scope text, current approval from an operator:final-ga-waiver-approver: identity, residual-risk ownership from an owner:final-ga-waiver-risk: identity, and unique supporting evidence under the remote-control docs tree.
  • Tightened conditional platform completion so bare completedConditionalStageIds do not pass; Windows/Linux completion now requires structured conditional-platform evidence records whose artifacts name every platform evidence slot, unless an accepted macOS-scoped waiver is attached.
  • Tightened final-GA verification, release evidence, acceptance, and fleet closure inputs so bare requirement ID summaries do not pass. Each requirement now needs a structured passing record with a canonical UTC millisecond capture time on or after 2026-07-02T00:00:00.000Z, artifacts, and the relevant command, full 40-character commit SHA, environment, reviewer, operator, rig, or fleet-run context.
  • Tightened 180.C.29.09 automated release-log evidence so the final evidence bundle cannot pass with reviewer-only metadata; automated logs must name the command, full 40-character release commit SHA, and environment.
  • Tightened the structured evidence records further so verification records must cite one of the planned commands for the check and duplicate artifact or rig identifiers cannot satisfy release, acceptance, or fleet evidence counts, and acceptance/fleet records must name the required evidence kinds they cover.
  • Tightened the final-GA evidence grouping so duplicate structured records for the same verification, release-evidence, acceptance, or fleet requirement keep that requirement missing instead of letting one passing duplicate mask a conflicting record.
  • Tightened final-GA artifact reuse checks so artifact IDs must be unique across the entire evidence snapshot; one pasted log, capture, bundle, or placeholder cannot satisfy independent verification, release-evidence, acceptance, and fleet requirements.
  • Tightened final-GA artifact naming so every artifact ID must identify the record kind, requirement ID, and concrete evidence suffix.
  • Tightened final-GA acceptance and fleet artifact coverage so artifact IDs must name the required evidence slots they prove, and any appended slot context must be concrete and non-placeholder.
  • Tightened final-GA release identities so verification environments, reviewers, operators, and fleet runs must use contextual final-GA prefixes with non-empty suffixes.
  • Tightened final-GA waiver identities so stale waiver approvals, non-contextual waiver approvers or risk owners, and off-path waiver evidence cannot satisfy the conditional platform-scope gate.
  • Tightened final-GA timestamp validation so evidence and waiver timestamps must use canonical UTC millisecond format before chronology is evaluated.
  • Tightened final-GA chronology so operator acceptance signoff must be captured after every acceptance scenario record, final test-log release evidence must be captured after every verification record it summarizes, and fleet closure records must be captured after the Stage 29 verification, release evidence, and acceptance records they close over.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts tests/final-ga-release-gate.test.ts --reporter=verbose from testing/bellona/remote-control passed with 1 file / 36 tests.
  • pnpm nx test @bellona/remote-control-testing passed after the stale snapshot fixture was refreshed and the protocol fuzzing harness was updated for the current browser.profile.use_personal approval contract.
  • pnpm nx lint @bellona/remote-control-testing passed.
  • pnpm nx build @bellona/remote-control-testing passed.
  • pnpm exec tsc --noEmit -p tsconfig.json --rootDir ../../../ from testing/bellona/remote-control passed.
  • pnpm exec tsc --noEmit -p tsconfig.lib.json --rootDir ../../../ from testing/bellona/remote-control passed for the library compile shape.
  • The focused tests prove the gate blocks by default, passes with a complete structured evidence snapshot, rejects bare requirement ID summaries, rejects malformed evidence records, rejects abbreviated commit SHAs, rejects unplanned verification commands and duplicate artifact or rig identifiers, rejects duplicate structured records for the same requirement, rejects artifact IDs reused across evidence groups, rejects count-only acceptance/fleet artifacts without required evidence-kind coverage, required evidence-slot artifact IDs, or concrete evidence-slot sub-suffix context, keeps 180.C.29.08, .12, and 180.C.30.10 blocked when hardware-in-the-loop evidence is missing, and keeps 180.C.29.10 plus dependent roll-up gates blocked when same-LAN acceptance is missing. They also reject final test-log release evidence captured before the verification matrix it summarizes, stale pre-window evidence, non-canonical timestamp formats, and empty contextual suffix placeholders, and prove bare conditional platform stage IDs are insufficient without structured platform-completion evidence or macOS-scoped waiver evidence. They reject malformed conditional platform completion records, stale or non-contextual conditional platform waiver approvals, and off-path waiver evidence.

Hardware/release evidence status:

  • Local contract only. Final closure still requires real macOS/Windows hosts, cloud deployment smoke, stream/capture artifacts where allowed, diagnostic bundles from final sessions, Stage 26 macOS app/LaunchAgent/signing/install QA acceptance, accepted 180.C.36/180.C.37 scope-waiver evidence if GA is macOS-only, and operator acceptance signoff.

Stage 180.C.21.20 Operator Usability Study Local Contract#

Implementation date: 2026-07-01.

Related open checklist item:

  • 180.C.21.20 structured Control Room usability study with new operators.

Changed files:

  • testing/bellona/remote-control/operator-usability-study.ts
  • testing/bellona/remote-control/tests/operator-usability-study.test.ts
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/README.md
  • testing/bellona/remote-control/final-ga-release-gate.ts
  • testing/bellona/remote-control/tests/final-ga-release-gate.test.ts
  • docs/domains/bellona/extras/remote-control/operator-usability-study.md
  • docs/domains/bellona/extras/remote-control/final-ga-release-gate.md
  • docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Implementation summary:

  • Added createControlRoomOperatorUsabilityStudyPlan() to encode the 180.C.21.20 study scenarios for approval under pressure, policy explanation clarity, approve/deny decision accuracy, and takeover discoverability.
  • Added evaluateControlRoomOperatorUsabilityStudy() to block by default unless at least five new operators participated, all timing/clarity/error/discovery thresholds pass, the report is published, and the top three friction points include fix evidence.
  • Tightened the evaluator so duplicate, blank, non-canonical, or placeholder participant identities/roles, missing or duplicate recruited-participant observations for any scenario, malformed metric observations, zero-duration human timing metrics, successful takeover discoveries without valid time-to-first-action samples, stale, non-canonical, or unparseable observation/report timestamps, and whitespace-only fix evidence cannot satisfy the local gate.
  • Tightened the evidence boundary so metric-only observations do not pass: each recruited-participant scenario row must include the required evidence kinds and unique evidence artifacts whose IDs name the evidence kind they prove, and the top-three friction fixes must use unique valid friction-point metadata and fix evidence.
  • Tightened the published-report boundary so report metadata must link every recruited participant ID and scenario evidence artifact instead of passing with only a generic path, timestamp, and summary.
  • Tightened the artifact boundary so published reports must live under the canonical 180.C.21.20 evidence path, scenario evidence artifacts must identify their recruited participant, scenario, and evidence kind with concrete non-placeholder suffixes, and top-three fix evidence must identify its friction point with a concrete non-placeholder suffix.
  • Tightened study chronology so recruited-participant observations must carry fresh timestamps, the findings report must be published after those observations, and top-three fix evidence must be verified after the findings report.
  • Tightened study timestamp parsing so observations, findings reports, and top-three fix verification records must use canonical UTC millisecond format before freshness or chronology is evaluated.
  • Linked the operator usability report into the final-GA evidence bundle so the Stage 180.C.29.09 release artifact set cannot be satisfied by generic operator signoff alone.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts tests/operator-usability-study.test.ts --reporter=verbose from testing/bellona/remote-control passed with 1 file / 27 tests.

Human-evidence status:

  • Local contract only. Final closure still requires recruited new operators, timed observation under pressure, a published findings report, and implementation plus verification evidence for the observed top three friction fixes. The local contract now rejects malformed, non-canonical, or placeholder participant identities/roles, duplicate recruited-participant scenario observations, metric-only observations without evidence-kind-scoped artifacts, published reports without recruited participant and observation evidence links, published reports that cite invalid or incomplete observation evidence, reports outside or escaping the canonical evidence path, observation artifacts that do not identify their participant/scenario/evidence-kind context with concrete non-placeholder suffixes, stale, non-canonical timestamp, or malformed report metadata, duplicate friction-point IDs, invalid severity, and reused, blank, placeholder, or non-contextual fix-evidence records without concrete non-placeholder suffixes or canonical UTC millisecond verification timestamps rather than treating plausible IDs or strings as sufficient proof.

Stage 180.C.38 Bridge Retirement Local Gate#

Implementation date: 2026-07-01.

Related open checklist items:

  • 180.C.38.07 removal PRs for old bridges.
  • 180.C.38.08 post-removal verification.
  • 180.C.38.09 bridge package cleanup after GA and zero consumers.
  • 180.C.38.10 final bridge retirement roll-up.

Changed files:

  • testing/bellona/remote-control/bridge-retirement-gate.ts
  • testing/bellona/remote-control/tests/bridge-retirement-gate.test.ts
  • testing/bellona/remote-control/index.ts
  • testing/bellona/remote-control/README.md
  • docs/domains/bellona/extras/remote-control/bridge-retirement-gate.md
  • docs/domains/bellona/extras/remote-control/bridge-coexistence-and-deprecation-plan.md
  • docs/domains/bellona/extras/remote-control/README.md
  • docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Implementation summary:

  • Added createRemoteControlBridgeRetirementGatePlan() to encode the Stage 180.C.38.07 through .10 retirement contract for the old Blender and Unreal bridges.
  • Added evaluateRemoteControlBridgeRetirementGate() to block by default unless removal PRs include canonical Oshun PR URLs, non-draft state, fresh submission timestamps, and bridge-specific migration and release-note links, zero-consumer telemetry covers exactly every compatibility-only command after the cutover anchor, rejects unknown command entries, and comes from a bridge-scoped artifact path, package cleanup evidence includes a canonical Oshun PR URL and completion timestamp after merged removal PRs plus zero-consumer windows, post-removal scans cover apps, libraries, services, scripts, testing harnesses, and workspace metadata with zero active dependencies and no remaining findings, documentation is updated, removal PRs are merged for roll-up, and final retirement approval is attached from an operator:bridge-retirement-approver: identity after the removal PR, zero-consumer telemetry, cleanup, and post-removal scan evidence.
  • Tightened the evaluator so duplicate PR, bridge telemetry, or command telemetry records, reused per-bridge PR URLs or telemetry sources, non-canonical PR, migration, release-note, cleanup, telemetry, or approver identities, scan commands that do not use rg/git grep, omit or only partially cover root workspace metadata files, or do not target exact legacy bridge package/path references, stale or non-canonical timestamp removal submissions, premature or non-canonical timestamp merges, stale or non-canonical timestamp cleanup records, and final approvals that predate the latest retirement evidence or use non-canonical timestamp metadata cannot satisfy the single authoritative evidence record expected for each bridge or compatibility command.
  • Tightened bridge-retirement timestamp parsing so removal PR, telemetry-window, package-cleanup, post-removal scan, and final-approval timestamps must use canonical UTC millisecond format before freshness or chronology is evaluated.
  • Tightened cleanup/post-removal scan evidence so token-only commands, commands that merely echo scanner names, wildcard-only bridge searches, and scans that omit or only partially cover root workspace metadata files cannot satisfy the Stage 38 removal proof.
  • Tightened package cleanup evidence so allowed residual reference paths must be unique docs or release-note paths and cannot whitelist active app, library, service, script, test, or workspace dependency references directly or through path traversal.
  • Tightened package cleanup evidence so removed bridge app paths and removed bridge package names must be exact sets with no duplicate or unrelated removals.
  • Kept the retirement gate separate from the coexistence plan so the repository can prove both safe compatibility during rollout and safe removal after GA.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts tests/bridge-retirement-gate.test.ts --reporter=verbose from testing/bellona/remote-control passed with 1 file / 34 tests.

GA evidence status:

  • Local contract only. Final closure still requires Remote Host GA, post-cutover zero-consumer telemetry, submitted and merged removal PRs, actual removal of the old bridge app packages, clean full-scope post-removal scans that target exact legacy bridge package/path references, documentation updates, and complete final approval evidence dated after the retirement evidence it approves.

Stage 180.C.26 macOS Host Evidence Chronology Hardening#

Implementation date: 2026-07-02.

Related open checklist items:

  • 180.C.26.09 macOS install QA matrix.
  • 180.C.26.14 non-developer macOS host acceptance gate.

Changed files:

  • apps/bellona/remote-host/src/macos-host-support.ts
  • apps/bellona/remote-host/src/macos-host-support.test.ts
  • apps/bellona/remote-host/README.md
  • docs/domains/bellona/extras/remote-control/macos-host-local-contracts.md
  • docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Implementation summary:

  • Tightened evaluateMacOSHostStageGate() so the install QA summary cannot close 180.C.26.09 unless it is captured after the per-scenario QA evidence it summarizes.
  • Added chronology checks requiring install QA scenario runs to occur after signing/notarization acceptance evidence.
  • Tightened 180.C.26.14 so non-developer acceptance cannot pass if it was captured before the menu-bar shell, LaunchAgent lifecycle, signing/notarization, install QA summary, or install QA scenario evidence it claims to accept.
  • Tightened Stage 26 contextual evidence IDs so runner IDs, operator IDs, artifact IDs, and canonical artifact URIs need concrete non-placeholder suffixes after their required prefixes.
  • Follow-up hardening on 2026-07-03 closes the per-scenario install-QA gap: MAC-HOST- runner identities must also carry concrete non-placeholder suffixes, so MAC-HOST-placeholder cannot satisfy 180.C.26.09.
  • Tightened Stage 26 timestamp validation so install-QA runs, QA artifacts, and stage evidence records must use canonical UTC millisecond format before freshness or chronology is evaluated.
  • Updated the Stage 26 local-contract docs and audit notes while keeping the canonical checklist items open for real macOS hardware, launchd, Apple signing, install QA, and non-developer acceptance evidence.

Verification closure:

  • pnpm nx test @bellona/remote-host -- macos-host-support.test.ts --reporter=verbose passed with 1 file / 30 tests.
  • pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json passed.
  • pnpm nx lint @bellona/remote-host --verbose passed with existing warnings outside this change.
  • Changed-file Prettier check, Stage 26 stub scan, git diff --check, and docs-center freshness check passed.

Hardware evidence status:

  • Local contract only. Final closure still requires a real macOS host, Apple Developer ID signing/notarization, launchd registration, native app execution, full install QA, and non-developer acceptance evidence.

Stage 180.C.36 Windows Host Evidence Chronology Hardening#

Implementation date: 2026-07-02.

Related open checklist items:

  • 180.C.36.06 signed Windows update channel and rollback.
  • 180.C.36.09 macOS/Windows command parity evidence.
  • 180.C.36.10 Windows host feature-parity roll-up.

Changed files:

  • apps/bellona/remote-host/src/windows-host-support.ts
  • apps/bellona/remote-host/src/windows-host-support.test.ts
  • apps/bellona/remote-host/README.md
  • docs/domains/bellona/extras/remote-control/windows-host-local-contracts.md
  • docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • TODOS/phase-180.md

Implementation summary:

  • Tightened evaluateWindowsHostStageGate() so signed update rollback evidence cannot close 180.C.36.06 unless it is captured after the signed MSI/service lifecycle evidence it depends on.
  • Tightened the macOS/Windows parity gate so parity evidence cannot close 180.C.36.09 unless it is captured after the Windows capability records it compares: MSI/service lifecycle, desktop/input probe, permission probe, managed browser launch, app discovery, signed update rollback, diagnostic bundle, and role validation.
  • Kept final feature-parity acceptance ordered after every prerequisite Stage 36 record while adding specific regressions for stale signed-update and parity evidence.
  • Tightened Stage 36 timestamp validation so evidence records must use canonical UTC millisecond format before freshness or chronology is evaluated.
  • Tightened Stage 36 evidence identifiers so artifact IDs, Windows runner IDs, macOS parity runner IDs, and Windows acceptance operator IDs need concrete non-placeholder suffixes after their required prefixes.
  • Tightened the Windows managed-browser launch contract so managed profile IDs must resolve to a Bellona-managed profile directory under an absolute Windows managed-profile root, rejecting traversal and default personal-profile names.
  • Tightened the Windows managed-browser launch contract so CDP is explicitly bound to 127.0.0.1 and remote debugging ports outside the TCP range are rejected before any launch plan is accepted.
  • Tightened the Windows managed-browser launch contract so launch-time initialUrl values are rejected; Windows Chrome/Edge navigation must go through browser.navigate so the blocked-domain, credentialed URL, loopback/private-host, and configured domain policy checks run before the browser touches a page.
  • Updated the Stage 36 local-contract docs and audit notes while keeping the canonical checklist items open for real Windows build/signing/hardware, macOS parity-host, and operator acceptance evidence.

Verification closure:

  • pnpm exec vitest run --config vitest.config.ts src/windows-host-support.test.ts --reporter=verbose from apps/bellona/remote-host passed with 1 file / 39 tests.

Hardware evidence status:

  • Local contract only. Final closure still requires a real Windows host/build pipeline, Authenticode signing, Windows Service lifecycle, live DXGI/UIAutomation/SendInput probes, UAC/Defender/Smart App Control verification, real app discovery, diagnostic bundle collection, macOS/Windows parity runs, and final operator acceptance evidence.

Stage 180.C.29 TypeScript 6 Verification Cleanup#

Implementation date: 2026-07-03.

Related open checklist items:

  • 180.C.29.08 final verification matrix.
  • 180.C.36.01-.180.C.36.10 Windows host evidence gate.

Changed files:

  • package.json
  • DEPENDENCIES.md
  • scripts/verify-phase-180-completion.mjs
  • apps/bellona/remote-host/project.json
  • testing/bellona/remote-control/project.json
  • testing/bellona/remote-control/README.md
  • TODOS/phase-180.md
  • docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md
  • docs/domains/bellona/extras/remote-control/compatibility-matrix.md
  • docs/domains/bellona/extras/remote-control/implementation-tracker.md
  • docs/domains/bellona/extras/remote-control/windows-host-local-contracts.md

Implementation summary:

  • Removed the stale TypeScript deprecation CLI workaround from the checked-in @bellona/remote-host and @bellona/remote-control-testing typecheck targets.
  • Added pnpm verify:phase 180 as the root Phase 180 verifier and wired it into pnpm bellona:remote-control:verify so the normal Bellona local gate checks TS6 state, checklist/tracker synchronization, and the documented external blocker list.
  • Updated the Phase 180 compatibility matrix to the current TypeScript 6.0.3, Nx 22.7.4, Vite 8.0.14 catalog, and Vitest 4.1.7 baseline.
  • Updated the Phase 180 audit and local-contract notes so release verification is stated in terms of the checked-in TypeScript 6 compiler with no CLI or inherited tsconfig deprecation overrides.
  • Updated the repo dependency inventory to the TypeScript 6.0.3 baseline and added it to the Phase 180 TS6 residue scan so stale pre-TS6 runtime claims fail the local release gate.

Verification closure:

  • pnpm exec tsc --version reported TypeScript 6.0.3.
  • tsconfig.base.json no longer contains ignoreDeprecations.
  • pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json passed without CLI or inherited tsconfig deprecation overrides.
  • pnpm exec tsc --noEmit -p testing/bellona/remote-control/tsconfig.json --rootDir ../../../ passed without CLI or inherited tsconfig deprecation overrides.
  • pnpm nx typecheck @bellona/remote-host passed with the checked-in target command tsc --noEmit -p tsconfig.app.json.
  • pnpm nx typecheck @bellona/remote-control-testing passed with the checked-in target command tsc --noEmit -p tsconfig.json --rootDir ../../../.
  • pnpm nx lint @bellona/remote-control-testing passed.
  • pnpm nx test @bellona/remote-control-testing passed.
  • pnpm verify:phase 180 passed.
  • pnpm verify:phase 180 now checks the repo dependency inventory for the TypeScript 6.0.3 runtime baseline and rejects stale pre-TS6 evidence wording.
  • pnpm bellona:remote-control:verify passed with the Phase 180 verifier wired into the combined gate.
  • pnpm nx lint @bellona/remote-host passed with the existing five warnings and no errors.
  • pnpm exec vitest run --config vitest.config.ts tests/final-ga-release-gate.test.ts --reporter=verbose from testing/bellona/remote-control passed with 1 file / 36 tests.
  • pnpm nx test @bellona/remote-host -- windows-host-support.test.ts --reporter=verbose passed with 1 file / 39 tests.
  • Changed-file Prettier, stub-indicator scan, git diff --check, and docs-center freshness checks passed.

Hardware evidence status:

  • Not applicable for the TypeScript 6 cleanup itself. Final Phase 180 release closure still depends on the hardware, signing, deployment-smoke, and operator acceptance evidence tracked by 180.C.29.08-.180.C.30.10 and Stage 36.

Stage 180.C.29 Nested TypeScript 5 Tooling Audit#

Audit date: 2026-07-04

Known nested compiler packages:

  • @nx/eslint package-internal compiler: TypeScript 5.9.3 at node_modules/@nx/eslint/node_modules/typescript/package.json.
  • @electron-forge/template-webpack-typescript template compiler: TypeScript 5.4.5 at node_modules/@electron-forge/template-webpack-typescript/node_modules/typescript/package.json.
  • @microsoft/api-extractor package-internal compiler: TypeScript 5.9.3 at node_modules/@microsoft/api-extractor/node_modules/typescript/package.json.

These nested packages are not the Phase 180 Bellona compiler surface. The checked Bellona typecheck commands resolve the root typescript package at 6.0.3, while the nested TypeScript 5 packages are third-party tool/template dependencies. pnpm verify:phase 180 now constrains this distinction: it fails if the lockfile gains any TypeScript 5 package snapshot beyond 5.4.5 and 5.9.3, or if the known nested compiler package paths/versions change without updating this evidence.

Progress Table#

Item Task Owner Status Changed Files Verification Command Hardware Evidence Follow-up Blockers
180.C.01.01 Create docs/domains/bellona/extras/remote-control/implementation-tracker.md with a table for every 180.C item, owner, status, changed files, verification command, hardware evidence, and follow-up blockers. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; documentation-only tracker work. None
180.C.01.02 Add a "do not skip stages" rule to the tracker: downstream stages may start only when the prior stage is checked off or explicitly marked blocked with a documented reason. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; documentation-only tracker work. None
180.C.01.03 Add a "definition of checked" rule: an item can be marked checked only after code/docs are merged, verification passes, and the item itself is updated from [ ] to [x]. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; documentation-only tracker work. None
180.C.01.04 Add a "hardware blocker" rule for macOS, Blender, Unreal, and WebRTC tasks: if CI cannot verify the behavior, the task must include a manual/hardware evidence note before being checked. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; documentation-only tracker work. None
180.C.01.05 Add a "no hidden privileged path" rule: no arbitrary shell, arbitrary Blender Python, Unreal console, desktop control, or real browser profile access before policy, approval, and audit primitives are complete. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; documentation-only tracker work. None
180.C.01.06 Add a "deep integration first" rule: Blender, Unreal, and browser tasks must use typed adapters before desktop fallback is allowed. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; documentation-only tracker work. None
180.C.01.07 Add a "localhost adapter" rule: Blender, Unreal, and browser debug/control ports remain localhost-only and are never exposed directly to LAN or internet. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; documentation-only tracker work. None
180.C.01.08 Add a "single source of truth" rule: command schemas live in libs/bellona/remote-protocol and are imported by gateway, host, MCP, adapters, tests, and docs. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; documentation-only tracker work. None
180.C.01.09 Add the initial verification command list for this phase: markdown format check, affected lint/typecheck/test, protocol tests, gateway tests, host tests, adapter tests, and Control Room Playwright tests once those packages exist. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; documentation-only tracker work. None
180.C.01.10 Check off this stage only after the tracker exists, ground rules are documented, and future agents can see exactly how to update progress. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; documentation-only tracker work. None
180.C.02.01 Audit libs/bellona/bridge-core and document reusable protocol, heartbeat, request/response, reconnection, and validation behavior in the tracker. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test bellona-bridge-core; pnpm nx lint bellona-bridge-core; pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; static TypeScript audit with automated package checks. None for this audit; later stages must add auth, policy, audit, schema, idempotency, and reconnect-resume coverage before privileged use.
180.C.02.02 Audit apps/bellona/bridge-blender and libs/bellona/blender and document which Blender commands are real, stubbed, missing, or unsafe for remote operation. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test bellona-bridge-blender; pnpm nx lint bellona-bridge-blender; pnpm nx test @bellona/blender; pnpm nx lint @bellona/blender; pnpm nx typecheck @bellona/blender; pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; static Blender bridge/addon audit with automated package checks. None for this audit; later stages must add protocol adapters, command mapping, policy gates, path grants, audit, evidence capture, and hardware smoke notes before remote Blender mutation.
180.C.02.03 Audit libs/bellona/blender/python/bellona_addon and document addon startup, threading, handler registration, dependency, and Blender main-thread risks. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md PYTHONPYCACHEPREFIX=/tmp/oshun-pycache python3 -m py_compile libs/bellona/blender/python/bellona_addon/__init__.py libs/bellona/blender/python/bellona_addon/server.py libs/bellona/blender/python/bellona_addon/handlers.py libs/bellona/blender/python/bellona_addon/events.py; pnpm nx test @bellona/blender; pnpm nx lint @bellona/blender; pnpm nx typecheck @bellona/blender; pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; static Blender addon audit with Python compile and package checks. None for this audit; later stages must wrap the addon with command timeout/cancellation, auth, schemas, policy, approvals, audit, path grants, undo checkpoints, and backpressure before remote use.
180.C.02.04 Audit apps/bellona/bridge-unreal and libs/bellona/unreal and document Unreal-side plugin gaps, command coverage, version support, and test constraints. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test bellona-bridge-unreal; pnpm nx lint bellona-bridge-unreal; pnpm nx test @bellona/unreal; pnpm nx lint @bellona/unreal; pnpm nx build @bellona/unreal; pnpm nx build bellona-bridge-unreal; pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable; static Unreal bridge/library audit with automated package checks. None for this audit; later stages must add a real Unreal plugin/adapter contract, command mapping, policy gates, project grants, audit, evidence capture, and hardware fixture smoke notes.
180.C.02.05 Audit services/psyche/computer-use and document which screenshot, OCR, accessibility, click, key, file, browser, and screen sharing primitives can be reused for macOS fallback. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md; services/psyche/computer-use/src/computer_use/**/*.py pnpm nx lint psyche-computer-use; pnpm nx test psyche-computer-use; pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable for this static audit; future macOS fallback implementation requires manual evidence for TCC permissions, screen capture, input control, multi-display mapping, and WebRTC streaming. None for this audit; later stages must add macOS-native capture, AX, input, clipboard, browser, permission, policy, approval, audit, and evidence providers before desktop fallback is enabled.
180.C.02.06 Audit services/psyche/orchestrator and services/psyche/api-gateway and document which session, WebSocket, lifecycle, and event patterns should be reused or avoided. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx lint psyche-orchestrator; pnpm nx test psyche-orchestrator; pnpm nx lint psyche-api-gateway; pnpm nx test psyche-api-gateway; pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable for this static audit; later remote gateway, host, WebRTC, and Control Room flows require manual/hardware evidence. None for this audit; later stages must add durable protocol/session/event storage, auth, policy, approval, audit, idempotency, replay protection, reconnect resume, and distributed pub/sub.
180.C.02.07 Audit apps/yemaya/studio-web and apps/yemaya/studio-desktop and document where Control Room should live for MVP and for the final product. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md; apps/yemaya/studio-web/src/types/browser-compat.d.ts; apps/yemaya/studio-desktop/src/main/menu-manager.ts; apps/yemaya/studio-desktop/src/main/menu.ts; apps/yemaya/studio-desktop/src/main/updater.ts; apps/yemaya/studio-desktop/src/preload/index.ts; apps/yemaya/studio-desktop/src/renderer/pages/ProjectPage.tsx; apps/yemaya/studio-desktop/src/renderer/pages/WelcomePage.tsx; apps/yemaya/studio-desktop/src/renderer/stores/projectStore.ts pnpm nx lint @yemaya/studio-web; pnpm nx typecheck @yemaya/studio-web; pnpm nx test @yemaya/studio-web; pnpm nx e2e @yemaya/studio-web; pnpm nx lint @yemaya/studio-desktop; pnpm nx typecheck @yemaya/studio-desktop; pnpm nx test @yemaya/studio-desktop; pnpm exec prettier --check apps/yemaya/studio-web/src/types/browser-compat.d.ts apps/yemaya/studio-desktop/src/main/menu-manager.ts apps/yemaya/studio-desktop/src/main/menu.ts apps/yemaya/studio-desktop/src/main/updater.ts apps/yemaya/studio-desktop/src/preload/index.ts apps/yemaya/studio-desktop/src/renderer/pages/ProjectPage.tsx apps/yemaya/studio-desktop/src/renderer/pages/WelcomePage.tsx apps/yemaya/studio-desktop/src/renderer/stores/projectStore.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md Not applicable for this static placement audit; later live WebRTC, desktop wrapper, macOS permission, and real engine flows require hardware evidence. None for this audit; implement Control Room as Bellona-owned apps/bellona/control-room later, reusing Yemaya patterns without coupling privileged remote state to Yemaya project shells.
180.C.02.08 Create the first architecture decision record: standalone Bellona Remote Gateway plus Remote Host, with reuse of Psyche fallback primitives and Bellona bridge adapters. Codex Complete docs/domains/bellona/extras/remote-control/adr/ADR-0001-standalone-remote-gateway-and-host.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/adr/ADR-0001-standalone-remote-gateway-and-host.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this architecture decision record; later macOS permissions, Blender/Unreal execution, WebRTC streams, and cross-network host operation require hardware evidence. None for this ADR; next eligible item is the compatibility matrix, followed by dated external implementation research and threat-model ADR before privileged implementation stages.
180.C.02.09 Create a compatibility matrix for macOS, Blender, Unreal, Chrome/Chromium, Node, Python, WebRTC, same-LAN, and cloud gateway modes. Codex Complete docs/domains/bellona/extras/remote-control/compatibility-matrix.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/compatibility-matrix.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this documentation matrix; later macOS TCC, Blender/Unreal adapter execution, Chrome app/profile behavior, WebRTC media, same-LAN, and cloud gateway operation require evidence. None for this matrix; protocol capability metadata, external implementation research, and threat-model work must still be completed before privileged implementation stages.
180.C.02.10 Create a dated external implementation research note covering MCP transports/auth, Chrome DevTools Protocol, Playwright, Browser Use, Codex/Claude Computer Use, WebRTC/TURN, macOS TCC permissions, Blender addon APIs, Unreal Editor plugin APIs, remote desktop security patterns, and cloud tunnel options. Codex Complete docs/domains/bellona/extras/remote-control/external-implementation-research-2026-04-21.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/external-implementation-research-2026-04-21.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this research note; later macOS TCC, Blender/Unreal editor execution, browser profile behavior, WebRTC media, and cloud/tunnel operation require manual/hardware evidence. None for this research note; threat-model ADR must still convert these findings into explicit security controls before privileged implementation stages.
180.C.02.11 Create a threat-model ADR covering STRIDE-style risks, prompt injection, browser credential exposure, malicious web pages, compromised gateway, compromised host, compromised agent, local network attacker, replay attacks, and supply-chain tampering. Codex Complete docs/domains/bellona/extras/remote-control/adr/ADR-0002-remote-control-threat-model.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/adr/ADR-0002-remote-control-threat-model.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this architecture/security decision record; later macOS TCC, Blender/Unreal execution, browser profile behavior, WebRTC media, and cross-network operation require evidence. None for this ADR; later implementation tasks must translate the threat controls into protocol schemas, gateway/host enforcement, adapter tests, release gates, and hardware evidence.
180.C.02.12 Check off this stage only after all audit notes and ADRs are committed and no implementation package has been created prematurely. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check; closure evidence command checking absence of apps/bellona/remote-host, apps/bellona/remote-gateway, apps/bellona/control-room, libs/bellona/remote-protocol, libs/bellona/remote-adapters, libs/bellona/mcp-gateway, libs/bellona/mac-host-runtime, libs/psyche/desktop-fallback, and testing/bellona/remote-control Not applicable for this stage-closure documentation check; later macOS TCC, Blender/Unreal execution, browser profile behavior, WebRTC media, and cross-network operation require evidence. None for stage closure; next eligible stage is 180.C.03 Remote Protocol Package.
180.C.02.13 Add an ADR deciding trusted-gateway versus end-to-end encryption trust model between agent and host, and if E2E is adopted, enumerate key-exchange, audit-integrity, and operator-consent implications that cascade into gateway, host, audit, and replay design. Codex Complete docs/domains/bellona/extras/remote-control/adr/ADR-0003-gateway-trust-and-e2e-encryption-model.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/adr/ADR-0003-gateway-trust-and-e2e-encryption-model.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this architecture/security decision record; later macOS host trust, WebRTC media, sealed artifacts, browser profile behavior, Blender/Unreal execution, and cross-network operation require task-specific evidence. Zero-knowledge opaque command routing is rejected for the MVP; future sealed content lanes require a separate ADR covering key exchange, policy-visible associated data, audit commitments, operator consent, failure behavior, and support boundaries.
180.C.02.14 Add an ADR deciding cross-platform host scope: macOS only, macOS+Windows, macOS+Windows+Linux, or phased. The decision gates whether 180.C.36 and 180.C.37 are in-scope and drives the mac-host-runtime vs host-runtime abstraction split. Codex Complete docs/domains/bellona/extras/remote-control/adr/ADR-0004-cross-platform-remote-host-scope.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/adr/ADR-0004-cross-platform-remote-host-scope.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this architecture/scope decision record; future Windows and Linux host work requires platform-specific hardware or VM evidence, and macOS capture/input behavior requires real Mac evidence. The ADR selects phased cross-platform scope: macOS is required for MVP/alpha; Windows (180.C.36) and Linux (180.C.37) remain in Phase 180 scope as later expansion stages after 180.C.26.16 defines host-runtime interfaces.
180.C.02.15 Produce a hardware rig inventory matrix listing required physical and virtual test machines, Blender versions, Unreal versions, Chrome channels, and OS versions needed for signoff on every hardware-gated item across the checklist. Codex Complete docs/domains/bellona/extras/remote-control/hardware-rig-inventory.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/hardware-rig-inventory.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this inventory document itself; it defines the physical and virtual rigs future hardware-gated work must cite before checkoff. Future hardware-gated tasks must attach evidence using the rig IDs and evidence naming rules from hardware-rig-inventory.md; missing rigs block the corresponding task rather than allowing mock-only signoff.
180.C.02.16 Define the MVP release artifact in an ADR: which stages must be complete, which demo scenarios must pass, and what documentation ships at MVP. Resolve the ambiguity between 180.C.16.09 (alpha gate) and 180.C.29.08-.10 (final gate) before implementation begins. Codex Complete docs/domains/bellona/extras/remote-control/adr/ADR-0005-mvp-release-artifact-and-gates.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/adr/ADR-0005-mvp-release-artifact-and-gates.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this release-scope ADR; future MVP alpha and final GA gates must attach hardware evidence from the rig inventory where CI cannot prove behavior. The ADR defines 180.C.16 as the MVP alpha artifact gate and 180.C.29.08-.10 as the final GA gate; future release work must not call the Stage 16 artifact stable/GA.
180.C.03.01 Generate or scaffold libs/bellona/remote-protocol using the repo's established Nx/library pattern and tags for Bellona/shared protocol code. Codex Complete libs/bellona/remote-protocol/project.json; libs/bellona/remote-protocol/package.json; libs/bellona/remote-protocol/tsconfig.json; libs/bellona/remote-protocol/tsconfig.lib.json; libs/bellona/remote-protocol/vitest.config.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/index.test.ts; libs/bellona/remote-protocol/README.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx show project @bellona/remote-protocol; pnpm nx build @bellona/remote-protocol; pnpm nx typecheck @bellona/remote-protocol; pnpm nx lint @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol; pnpm exec prettier --check libs/bellona/remote-protocol/project.json libs/bellona/remote-protocol/package.json libs/bellona/remote-protocol/tsconfig.json libs/bellona/remote-protocol/tsconfig.lib.json libs/bellona/remote-protocol/vitest.config.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/index.test.ts libs/bellona/remote-protocol/README.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for package scaffold; later macOS, Blender, Unreal, WebRTC, browser, and host behavior require hardware/manual evidence. None for scaffold; next tasks must add concrete protocol schemas, fixtures, schema tests, generated-contract drift checks, and version negotiation without duplicating contracts downstream.
180.C.03.02 Implement RemoteDevice, RemoteCapability, RemoteAdapter, RemotePermission, and RemotePermissionScope schemas with fixtures and schema tests. Codex Complete libs/bellona/remote-protocol/package.json; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/common.ts; libs/bellona/remote-protocol/src/device.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/device.test.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/index.test.ts; pnpm-lock.yaml; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-protocol; pnpm nx typecheck @bellona/remote-protocol; pnpm nx lint @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol; pnpm exec prettier --check libs/bellona/remote-protocol/package.json libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/common.ts libs/bellona/remote-protocol/src/device.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/device.test.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/index.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for protocol schema and fixture tests; later macOS TCC, Blender/Unreal execution, browser profile behavior, WebRTC media, and cross-network operation require evidence. None for this schema slice; next task must add session, participant, surface, and lifecycle-event schemas without adding gateway, host, adapter, or UI implementation.
180.C.03.03 Implement RemoteSession, RemoteSessionStatus, RemoteParticipant, RemoteSurface, and RemoteSessionLifecycleEvent schemas with fixtures and schema tests. Codex Complete libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/session.ts; libs/bellona/remote-protocol/src/session.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/index.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-protocol; pnpm nx typecheck @bellona/remote-protocol; pnpm nx lint @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol; pnpm exec prettier --check libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/session.ts libs/bellona/remote-protocol/src/session.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/index.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for protocol schema and fixture tests; later macOS TCC, Blender/Unreal execution, browser profile behavior, WebRTC media, and cross-network operation require evidence. None for this schema slice; next task must add command envelope, priority, timeout-class, risk-class, and command-target schemas.
180.C.03.04 Implement RemoteCommandEnvelope, RemoteCommandPriority, RemoteCommandTimeoutClass, RemoteCommandRiskClass, and RemoteCommandTarget schemas with fixtures and schema tests. Codex Complete libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/command.ts; libs/bellona/remote-protocol/src/command.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/index.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-protocol; pnpm nx typecheck @bellona/remote-protocol; pnpm nx lint @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol; pnpm exec prettier --check libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/command.ts libs/bellona/remote-protocol/src/command.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/index.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for protocol schema and fixture tests; later macOS TCC, Blender/Unreal execution, browser profile behavior, WebRTC media, and cross-network operation require evidence. None for this schema slice; next task must add command result, progress, error code, warning, retry, and idempotency metadata schemas.
180.C.03.05 Implement RemoteCommandResult, RemoteCommandProgress, RemoteErrorCode, RemoteWarning, and retry/idempotency metadata schemas with fixtures and schema tests. Codex Complete libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/result.ts; libs/bellona/remote-protocol/src/result.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/index.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-protocol; pnpm nx typecheck @bellona/remote-protocol; pnpm nx lint @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol; pnpm exec prettier --check libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/result.ts libs/bellona/remote-protocol/src/result.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/index.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for protocol schema and fixture tests; later macOS TCC, Blender/Unreal execution, browser profile behavior, WebRTC media, and cross-network operation require evidence. None for this schema slice; next task must add audit entry, audit evidence, artifact, approval request, and approval decision schemas.
180.C.03.06 Implement RemoteAuditEntry, RemoteAuditEvidence, RemoteArtifact, RemoteApprovalRequest, and RemoteApprovalDecision schemas with fixtures and schema tests. Codex Complete libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/audit.ts; libs/bellona/remote-protocol/src/audit.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/index.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-protocol; pnpm nx typecheck @bellona/remote-protocol; pnpm nx lint @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol; pnpm exec prettier --check libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/audit.ts libs/bellona/remote-protocol/src/audit.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/index.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for protocol schema and fixture tests; later macOS TCC, Blender/Unreal execution, browser profile behavior, WebRTC media, and cross-network operation require evidence. None for this schema slice; next task must add stream descriptor, stream source, stream state, and WebRTC signaling metadata schemas.
180.C.03.07 Implement RemoteStreamDescriptor, RemoteStreamSource, RemoteStreamState, and WebRTC signaling metadata schemas with fixtures and schema tests. Codex Complete libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/stream.ts; libs/bellona/remote-protocol/src/stream.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/index.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-protocol; pnpm nx typecheck @bellona/remote-protocol; pnpm nx lint @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol; pnpm exec prettier --check libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/stream.ts libs/bellona/remote-protocol/src/stream.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/index.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for protocol schema and fixture tests; live WebRTC media, same-LAN, cloud/TURN, macOS capture, Blender, and Unreal operation require later hardware evidence. None for this schema slice; next task must add command namespace constants without adding gateway, host, adapter, or live media implementation.
180.C.03.08 Implement command namespace constants for device.*, session.*, stream.*, blender.*, unreal.*, browser.*, desktop.*, file.*, process.*, approval.*, and diagnostic.*. Codex Complete libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/namespaces.ts; libs/bellona/remote-protocol/src/namespaces.test.ts; libs/bellona/remote-protocol/src/device.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/index.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-protocol; pnpm nx typecheck @bellona/remote-protocol; pnpm nx lint @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol; pnpm exec prettier --check libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/namespaces.ts libs/bellona/remote-protocol/src/namespaces.test.ts libs/bellona/remote-protocol/src/device.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/index.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for protocol constants and schema tests; later macOS, Blender, Unreal, browser, desktop, WebRTC, and cross-network operation require hardware evidence. None for this constants slice; next task must export generated JSON Schema/OpenAPI/Proto-ready artifacts or add a drift-failing generation task.
180.C.03.09 Export JSON Schema/OpenAPI/Proto-ready artifacts or add a clear generation task that fails if protocol schemas drift from generated contracts. Codex Complete libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/package.json; libs/bellona/remote-protocol/project.json; libs/bellona/remote-protocol/tsconfig.lib.json; libs/bellona/remote-protocol/scripts/generate-contract-artifacts.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/index.test.ts; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx contracts:check @bellona/remote-protocol; pnpm nx build @bellona/remote-protocol; pnpm nx typecheck @bellona/remote-protocol; pnpm nx lint @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol; pnpm exec prettier --check libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/package.json libs/bellona/remote-protocol/project.json libs/bellona/remote-protocol/tsconfig.lib.json libs/bellona/remote-protocol/scripts/generate-contract-artifacts.ts libs/bellona/remote-protocol/src/schema-registry.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/index.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for generated protocol artifacts and drift checks; later downstream gateway, host, adapter, OpenAPI publication, and proto compiler integration require their own verification. None for this artifact slice; next task must add protocol version negotiation, compatibility rules, and old/new host-gateway fixture tests.
180.C.03.10 Add protocol version negotiation, backward-compatibility rules, deprecation policy, minimum host/gateway version checks, and fixture tests for old host/new gateway and new host/old gateway behavior. Codex Complete libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/version.ts; libs/bellona/remote-protocol/src/version.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/index.test.ts; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx contracts:check @bellona/remote-protocol; pnpm nx build @bellona/remote-protocol; pnpm nx typecheck @bellona/remote-protocol; pnpm nx lint @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol; pnpm exec prettier --check libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/version.ts libs/bellona/remote-protocol/src/version.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/index.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for protocol schema and fixture tests; later real host, gateway, macOS, Blender, Unreal, WebRTC, and cross-network behavior require hardware/manual evidence. None for this negotiation slice; next task is the 180.C.03 closure check and must not start 180.C.04 until protocol verification and schema ownership docs pass.
180.C.03.11 Check off this stage only after protocol build, typecheck, unit/schema tests, and docs for schema ownership pass. Codex Complete libs/bellona/remote-protocol/README.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx contracts:check @bellona/remote-protocol; pnpm nx build @bellona/remote-protocol; pnpm nx typecheck @bellona/remote-protocol; pnpm nx lint @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol; pnpm exec prettier --check libs/bellona/remote-protocol/README.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for protocol package closure; later real host, gateway, macOS, Blender, Unreal, WebRTC, and cross-network behavior require hardware/manual evidence. None for remote-protocol stage closure; next eligible stage is 180.C.04 Mock Harness and Contract Tests.
180.C.03.12 Extend RemoteErrorCode with a structured remediation field: human text, machine-parseable suggested-next-command template, and a boolean marking whether auto-retry is safe. Every error path must populate it so agents stop burning turns rediscovering what to do next. Codex Complete libs/bellona/remote-protocol/src/result.ts; libs/bellona/remote-protocol/src/result.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; apps/bellona/remote-host/src/command-executor.ts; apps/bellona/remote-host/src/policy-preflight.ts; apps/bellona/remote-host/src/gateway-connection.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; testing/bellona/remote-control/fixtures.ts; testing/bellona/remote-control/fake-gateway-transport.ts; testing/bellona/remote-control/fake-host-adapter.ts; testing/bellona/remote-control/tests/audit-emission-paths.test.ts; testing/bellona/remote-control/tests/command-negative-paths.test.ts; testing/bellona/remote-control/tests/fake-host-adapter.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx contracts:check @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol --verbose; pnpm nx typecheck @bellona/remote-protocol --verbose; pnpm nx lint @bellona/remote-protocol --verbose; pnpm nx build @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --verbose; pnpm nx typecheck @bellona/remote-host --verbose; pnpm nx lint @bellona/remote-host --verbose; pnpm nx build @bellona/remote-host --skip-nx-cache --verbose; pnpm nx test @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; pnpm nx test @bellona/remote-control-testing --verbose; pnpm nx typecheck @bellona/remote-control-testing --verbose; pnpm nx lint @bellona/remote-control-testing --verbose; pnpm nx build @bellona/remote-control-testing --skip-nx-cache --verbose; pnpm exec prettier --check ...; git diff --check Not applicable for schema, host/gateway in-memory tests, and generated contract drift checks; later real host, gateway, macOS, Blender, Unreal, WebRTC, and network behavior require hardware/manual evidence. None for structured error remediation; next task remains 180.C.03.13 and must stay in Phase 180.
180.C.03.13 Add a RemoteActor schema modeling the full delegation chain (human operator, orchestrator agent, specialist agent, adapter) with stable identifiers. Thread it through RemoteCommandEnvelope, RemoteAuditEntry, RemoteApprovalRequest, and timeline events. Codex Complete libs/bellona/remote-protocol/src/actor.ts; libs/bellona/remote-protocol/src/actor.test.ts; libs/bellona/remote-protocol/src/command.ts; libs/bellona/remote-protocol/src/command.test.ts; libs/bellona/remote-protocol/src/audit.ts; libs/bellona/remote-protocol/src/audit.test.ts; libs/bellona/remote-protocol/src/session.ts; libs/bellona/remote-protocol/src/session.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/README.md; generated protocol contract artifacts; apps/bellona/remote-gateway/src/audit-log.ts; apps/bellona/remote-gateway/src/approval-service.ts; apps/bellona/remote-gateway/src/command-dispatcher.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-gateway/src/persistent-store.ts; apps/bellona/remote-gateway/src/session-lifecycle.ts; testing/bellona/remote-control/fake-gateway-transport.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx contracts:check @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol --verbose; pnpm nx typecheck @bellona/remote-protocol --verbose; pnpm nx lint @bellona/remote-protocol --verbose; pnpm nx build @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; pnpm nx test @bellona/remote-control-testing --verbose; pnpm nx typecheck @bellona/remote-control-testing --verbose; pnpm nx lint @bellona/remote-control-testing --verbose; pnpm nx build @bellona/remote-control-testing --skip-nx-cache --verbose; pnpm exec prettier --check ...; git diff --check Not applicable for protocol schemas, gateway in-memory tests, generated contract drift checks, and remote-control mock transport tests; later real host, agent, adapter, macOS, Blender, Unreal, WebRTC, and network behavior require hardware/manual evidence. None for actor delegation chains; next task remains 180.C.03.14 and must stay in Phase 180.
180.C.03.14 Add a RollbackStrategy enum to command metadata with values undo_stack, snapshot_restore, compensating_action, and manual_remediation_only. Require every mutating command schema to declare its strategy; reject envelopes without one at validation. Codex Complete libs/bellona/remote-protocol/src/command.ts; libs/bellona/remote-protocol/src/command.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/policy.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/README.md; generated protocol contract artifacts; testing/bellona/remote-control/fixtures.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx contracts:check @bellona/remote-protocol; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway,@bellona/remote-control-testing -t test,typecheck,lint,build --verbose; pnpm exec prettier --check ...; git diff --check Not applicable for protocol schema validation, generated contract drift checks, host/gateway unit tests, and remote-control mock transport tests; later real host, agent, adapter, macOS, Blender, Unreal, WebRTC, and network behavior require hardware/manual evidence. None for rollback strategy metadata; next task remains 180.C.03.15 and must stay in Phase 180.
180.C.03.15 Add an agent.readiness and state.snapshot command schema returning current dynamic state (modal dialogs open, shader compile count, project-root read-only state, running jobs, disk/memory pressure) alongside the existing static RemoteCapability reports. Codex Complete libs/bellona/remote-protocol/src/state.ts; libs/bellona/remote-protocol/src/state.test.ts; libs/bellona/remote-protocol/src/namespaces.ts; libs/bellona/remote-protocol/src/namespaces.test.ts; libs/bellona/remote-protocol/src/device.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/README.md; generated protocol contract artifacts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx contracts:check @bellona/remote-protocol; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway,@bellona/remote-control-testing -t test,typecheck,lint,build --verbose; pnpm exec prettier --check ...; git diff --check Not applicable for protocol schema validation, generated contract drift checks, host/gateway unit tests, and remote-control mock transport tests; later real host, adapter, macOS, Blender, Unreal, browser, WebRTC, and network behavior require hardware/manual evidence. None for dynamic state command schemas; next task remains 180.C.03.16 and must stay in Phase 180.
180.C.03.16 Add a DryRunPlan schema with predicted changes, cost estimate (tokens, compute, bandwidth, render minutes, build minutes), time estimate, reversibility assessment, and impact summary. Require dry-run support for every command in the high-risk classes defined in 180.C.07.06. Codex Complete libs/bellona/remote-protocol/src/dry-run.ts; libs/bellona/remote-protocol/src/dry-run.test.ts; libs/bellona/remote-protocol/src/command.ts; libs/bellona/remote-protocol/src/command.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/policy.ts; libs/bellona/remote-protocol/src/policy.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/README.md; generated protocol contract artifacts; apps/bellona/remote-gateway/src/approval-service.test.ts; apps/bellona/remote-gateway/src/command-dispatcher.ts; testing/bellona/remote-control/fixtures.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx contracts:check @bellona/remote-protocol; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway,@bellona/remote-control-testing -t test,typecheck,lint,build --verbose; pnpm exec prettier --check ...; git diff --check Not applicable for protocol schema validation, generated contract drift checks, host/gateway unit tests, and remote-control mock transport tests; later real host dry-run planners, adapters, macOS, Blender, Unreal, browser, WebRTC, and network behavior require hardware/manual evidence. None for dry-run plan protocol schemas; next actionable Phase 180 task remains 180.C.04.11 because 180.C.04.01 through 180.C.04.10 are already complete.
180.C.04.01 Create testing/bellona/remote-control with mock device, mock gateway, mock host, mock adapter, command fixture, and audit fixture utilities. Codex Complete testing/bellona/remote-control/README.md; testing/bellona/remote-control/fixtures.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/mocks.ts; testing/bellona/remote-control/package.json; testing/bellona/remote-control/project.json; testing/bellona/remote-control/tests/mock-harness.test.ts; testing/bellona/remote-control/tsconfig.json; testing/bellona/remote-control/tsconfig.lib.json; testing/bellona/remote-control/vitest.config.ts; testing/tsconfig.json; tsconfig.base.json; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx show project @bellona/remote-control-testing; pnpm nx build @bellona/remote-control-testing; pnpm nx typecheck @bellona/remote-control-testing; pnpm nx lint @bellona/remote-control-testing; pnpm nx test @bellona/remote-control-testing; pnpm nx build @oshun/testing-infra; pnpm nx lint @oshun/testing-infra; pnpm exec prettier --check testing/bellona/remote-control/README.md testing/bellona/remote-control/fixtures.ts testing/bellona/remote-control/index.ts testing/bellona/remote-control/mocks.ts testing/bellona/remote-control/package.json testing/bellona/remote-control/project.json testing/bellona/remote-control/tests/mock-harness.test.ts testing/bellona/remote-control/tsconfig.json testing/bellona/remote-control/tsconfig.lib.json testing/bellona/remote-control/vitest.config.ts testing/tsconfig.json tsconfig.base.json docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for in-memory mock utilities and schema-backed fixture tests; later macOS, Blender, Unreal, browser, WebRTC, and cross-network behavior require hardware/manual evidence. None for this scaffold slice; next task must add the fake host adapter behavior for capability registration, command receipt, progress, success/failure, and disconnect.
180.C.04.02 Add a fake host adapter that can register capabilities, receive commands, emit progress, return success/failure, and disconnect. Codex Complete testing/bellona/remote-control/README.md; testing/bellona/remote-control/fake-host-adapter.ts; testing/bellona/remote-control/fixtures.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/tests/fake-host-adapter.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-control-testing; pnpm nx typecheck @bellona/remote-control-testing; pnpm nx lint @bellona/remote-control-testing; pnpm nx test @bellona/remote-control-testing; pnpm exec prettier --check testing/bellona/remote-control/README.md testing/bellona/remote-control/fake-host-adapter.ts testing/bellona/remote-control/fixtures.ts testing/bellona/remote-control/index.ts testing/bellona/remote-control/tests/fake-host-adapter.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for in-memory fake adapter command execution; later real macOS, Blender, Unreal, browser, WebRTC, and network behavior require hardware/manual evidence. None for this fake adapter slice; next task must add the fake gateway transport for outbound host connections and network-free command dispatch.
180.C.04.03 Add a fake gateway transport that can accept outbound host connections and simulate command dispatch without network dependencies. Codex Complete testing/bellona/remote-control/README.md; testing/bellona/remote-control/fake-gateway-transport.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/tests/fake-gateway-transport.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-control-testing; pnpm nx typecheck @bellona/remote-control-testing; pnpm nx lint @bellona/remote-control-testing; pnpm nx test @bellona/remote-control-testing; pnpm exec prettier --check testing/bellona/remote-control/README.md testing/bellona/remote-control/fake-gateway-transport.ts testing/bellona/remote-control/index.ts testing/bellona/remote-control/tests/fake-gateway-transport.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for network-free fake gateway transport tests; later real gateway sockets, cross-network paths, macOS, Blender, Unreal, browser, and WebRTC behavior require hardware/manual evidence. None for this fake gateway transport slice; next task must add a fake MCP/client transport that can call command tools against the gateway mock.
180.C.04.04 Add a fake MCP/client transport that can call command tools against the gateway mock. Codex Complete testing/bellona/remote-control/README.md; testing/bellona/remote-control/fake-mcp-client-transport.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/tests/fake-mcp-client-transport.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-control-testing; pnpm nx typecheck @bellona/remote-control-testing; pnpm nx lint @bellona/remote-control-testing; pnpm nx test @bellona/remote-control-testing; pnpm exec prettier --check testing/bellona/remote-control/README.md testing/bellona/remote-control/fake-mcp-client-transport.ts testing/bellona/remote-control/index.ts testing/bellona/remote-control/tests/fake-mcp-client-transport.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for an in-memory MCP-shaped fake client transport; later real MCP stdio/HTTP, auth/session binding, cloud clients, macOS, Blender, Unreal, browser, and WebRTC behavior require hardware/manual evidence. None for this fake MCP client slice; next task must add validation failure, timeout, cancellation, duplicate idempotency, and host-disconnect tests.
180.C.04.05 Add tests for command validation failure, command timeout, command cancellation, duplicate idempotency key, and host disconnect. Codex Complete testing/bellona/remote-control/fake-gateway-transport.ts; testing/bellona/remote-control/tests/command-negative-paths.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-control-testing; pnpm nx typecheck @bellona/remote-control-testing; pnpm nx lint @bellona/remote-control-testing; pnpm nx test @bellona/remote-control-testing; pnpm exec prettier --check testing/bellona/remote-control/fake-gateway-transport.ts testing/bellona/remote-control/tests/command-negative-paths.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for in-memory negative-path harness tests; later real gateway, host, macOS, Blender, Unreal, browser, WebRTC, and network behavior require hardware/manual evidence. None for this negative-path slice; next task must add policy allowed/denied and approval required/granted/denied/timeout tests.
180.C.04.06 Add tests for policy allowed, policy denied, approval required, approval granted, approval denied, and approval timeout. Codex Complete testing/bellona/remote-control/fake-gateway-transport.ts; testing/bellona/remote-control/tests/policy-approval-paths.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-control-testing; pnpm nx typecheck @bellona/remote-control-testing; pnpm nx lint @bellona/remote-control-testing; pnpm nx test @bellona/remote-control-testing; pnpm exec prettier --check testing/bellona/remote-control/fake-gateway-transport.ts testing/bellona/remote-control/tests/policy-approval-paths.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for in-memory policy and approval harness tests; later real policy engine, approvals UI/session binding, gateway, host, MCP, macOS, Blender, Unreal, browser, WebRTC, and network behavior require hardware/manual evidence. None for this policy and approval slice; next task must add audit emission tests for success, failure, deny, approval, cancel, timeout, and disconnect.
180.C.04.07 Add tests for audit emission on success, failure, deny, approval, cancel, timeout, and disconnect. Codex Complete testing/bellona/remote-control/fake-gateway-transport.ts; testing/bellona/remote-control/tests/audit-emission-paths.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-control-testing; pnpm nx typecheck @bellona/remote-control-testing; pnpm nx lint @bellona/remote-control-testing; pnpm nx test @bellona/remote-control-testing; pnpm exec prettier --check testing/bellona/remote-control/fake-gateway-transport.ts testing/bellona/remote-control/tests/audit-emission-paths.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for in-memory fake gateway audit emission tests; later real gateway, host, policy engine, approval UI, durable audit storage, macOS, Blender, Unreal, browser, WebRTC, and network behavior require hardware/manual evidence. None for this audit-emission slice; next task must add snapshot fixtures for capability reports, session timelines, Blender scene query, browser page query, and stream descriptors.
180.C.04.08 Add snapshot fixtures for device capability reports, session timelines, Blender scene query, browser page query, and stream descriptor. Codex Complete testing/bellona/remote-control/README.md; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/snapshot-fixtures.ts; testing/bellona/remote-control/tests/snapshot-fixtures.test.ts; testing/bellona/remote-control/tests/__snapshots__/snapshot-fixtures.test.ts.snap; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-control-testing; pnpm nx typecheck @bellona/remote-control-testing; pnpm nx lint @bellona/remote-control-testing; pnpm nx test @bellona/remote-control-testing; pnpm exec prettier --check testing/bellona/remote-control/README.md testing/bellona/remote-control/index.ts testing/bellona/remote-control/snapshot-fixtures.ts testing/bellona/remote-control/tests/snapshot-fixtures.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for static in-memory snapshot fixtures; later real device capability reports, live session timelines, Blender/browser adapters, WebRTC streams, and hardware-backed evidence require manual/hardware validation. None for this snapshot-fixture slice; next task must add the mock harness to CI or document local verification commands.
180.C.04.09 Add the mock harness to CI or documented local verification commands. Codex Complete package.json; testing/bellona/remote-control/README.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm bellona:remote-control:verify; pnpm exec prettier --check package.json testing/bellona/remote-control/README.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for local verification command documentation; later CI service evidence, real gateway/host/MCP jobs, macOS, Blender, Unreal, browser, WebRTC, and network behavior require additional evidence. None for this verification-command slice; next task must close the mock-harness stage only after future gateway, host, MCP, and adapter work can reuse the harness.
180.C.04.10 Check off this stage only after future gateway, host, MCP, and adapter work can reuse the mock harness. Codex Complete testing/bellona/remote-control/README.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm bellona:remote-control:verify; pnpm exec prettier --check testing/bellona/remote-control/README.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for mock-harness stage closure; later real gateway, host, MCP, adapter, macOS, Blender, Unreal, browser, WebRTC, and network behavior require task-specific evidence. None for Stage 180.C.04; next eligible stage is 180.C.05 Remote Gateway Service, but this task does not start the next phase/stage.
180.C.04.11 Implement a record-and-replay sandbox that captures real adapter responses from live sessions and replays them deterministically for offline agent development and regression testing without needing a live Blender, Unreal, or Chrome. Codex Complete testing/bellona/remote-control/README.md; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/record-replay-sandbox.ts; testing/bellona/remote-control/tests/record-replay-sandbox.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx build @bellona/remote-control-testing; pnpm nx typecheck @bellona/remote-control-testing; pnpm nx lint @bellona/remote-control-testing; pnpm nx test @bellona/remote-control-testing; pnpm exec prettier --check testing/bellona/remote-control/README.md testing/bellona/remote-control/index.ts testing/bellona/remote-control/record-replay-sandbox.ts testing/bellona/remote-control/tests/record-replay-sandbox.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for in-memory record/replay cassette tests; later real Blender, Unreal, Chrome, macOS, WebRTC, and cross-network adapter sessions require hardware/manual evidence before live-capture signoff. None for the record/replay sandbox; next actionable Phase 180 item remains 180.C.04.12 and must stay in this phase.
180.C.04.12 Add a protocol fuzzing harness covering malformed envelopes, oversized payloads, Unicode edge cases (RTL marks, normalization forms, surrogate pairs), schema-downgrade attacks, and deeply nested structures. Block release if the fuzzer finds a crash, panic, or policy bypass. Codex Complete testing/bellona/remote-control/README.md; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/protocol-fuzzing-harness.ts; testing/bellona/remote-control/tests/protocol-fuzzing-harness.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts --reporter=verbose from testing/bellona/remote-control; pnpm bellona:remote-control:verify; pnpm exec prettier --check testing/bellona/remote-control/README.md testing/bellona/remote-control/index.ts testing/bellona/remote-control/protocol-fuzzing-harness.ts testing/bellona/remote-control/tests/protocol-fuzzing-harness.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for deterministic schema/policy fuzzing over in-memory protocol fixtures; later live Blender, Unreal, Chrome, desktop, macOS, WebRTC, and cross-network fuzz/evidence paths require task-specific hardware/manual evidence. None for the protocol fuzzing harness; next actionable Phase 180 item remains 180.C.04.13 and must stay in this phase.
180.C.04.13 Add property-based tests for envelope invariants (idempotency key determinism, priority ordering, timeout-class monotonicity, risk-class escalation, actor-chain well-formedness) using fast-check or equivalent. Codex Complete testing/bellona/remote-control/README.md; testing/bellona/remote-control/tests/envelope-invariants.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts --reporter=verbose from testing/bellona/remote-control; pnpm nx typecheck @bellona/remote-control-testing --verbose; pnpm nx lint @bellona/remote-control-testing --verbose; pnpm bellona:remote-control:verify; pnpm exec prettier --check testing/bellona/remote-control/README.md testing/bellona/remote-control/tests/envelope-invariants.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for deterministic generated envelope property tests over in-memory protocol fixtures; later live gateway, host, adapter, macOS, Blender, Unreal, browser, WebRTC, and cross-network invariant testing require task-specific hardware/manual evidence. None for envelope invariant property tests; continue only with the next unchecked item in TODOS/phase-180.md and do not leave Phase 180.
180.C.05.01 Scaffold apps/bellona/remote-gateway with health, readiness, config validation, logging, graceful shutdown, and test target. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/package.json; apps/bellona/remote-gateway/project.json; apps/bellona/remote-gateway/tsconfig.json; apps/bellona/remote-gateway/tsconfig.app.json; apps/bellona/remote-gateway/vitest.config.ts; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/app.test.ts; apps/bellona/remote-gateway/src/config.ts; apps/bellona/remote-gateway/src/config.test.ts; apps/bellona/remote-gateway/src/index.ts; apps/bellona/remote-gateway/src/main.ts; pnpm-lock.yaml; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --verbose; from apps/bellona/remote-gateway, BELLONA_REMOTE_GATEWAY_PORT=4097 BELLONA_REMOTE_GATEWAY_LOG_LEVEL=fatal node dist/src/main.js with curl -fsS http://127.0.0.1:4097/health; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/package.json apps/bellona/remote-gateway/project.json apps/bellona/remote-gateway/tsconfig.json apps/bellona/remote-gateway/tsconfig.app.json apps/bellona/remote-gateway/vitest.config.ts apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/app.test.ts apps/bellona/remote-gateway/src/config.ts apps/bellona/remote-gateway/src/config.test.ts apps/bellona/remote-gateway/src/index.ts apps/bellona/remote-gateway/src/main.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task is a Node gateway walking skeleton with mocked HTTP health/readiness tests only and does not exercise macOS hardware, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level pnpm install --frozen-lockfile --lockfile-only is blocked before gateway validation by pre-existing unrelated lock drift in libs/iris/accessibility/cognitive/dist/package.json for typescript, vitest, and eventemitter3; the gateway importer was added to pnpm-lock.yaml.
180.C.05.02 Implement in-memory device registry using remote-protocol schemas before adding persistent storage. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/package.json; apps/bellona/remote-gateway/project.json; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/app.test.ts; apps/bellona/remote-gateway/src/device-registry.ts; apps/bellona/remote-gateway/src/device-registry.test.ts; apps/bellona/remote-gateway/src/index.ts; pnpm-lock.yaml; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; from apps/bellona/remote-gateway, BELLONA_REMOTE_GATEWAY_PORT=4098 BELLONA_REMOTE_GATEWAY_LOG_LEVEL=fatal pnpm exec tsx src/main.ts with curl -fsS http://127.0.0.1:4098/ready; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/package.json apps/bellona/remote-gateway/project.json apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/app.test.ts apps/bellona/remote-gateway/src/device-registry.ts apps/bellona/remote-gateway/src/device-registry.test.ts apps/bellona/remote-gateway/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task uses protocol fixtures and in-memory unit tests only and does not exercise macOS hardware, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by the unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is host outbound WebSocket connection acceptance.
180.C.05.03 Implement host outbound WebSocket connection acceptance with handshake validation, heartbeat, disconnect detection, and tests. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/package.json; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/config.ts; apps/bellona/remote-gateway/src/config.test.ts; apps/bellona/remote-gateway/src/host-connections.ts; apps/bellona/remote-gateway/src/host-connections.test.ts; apps/bellona/remote-gateway/src/index.ts; pnpm-lock.yaml; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; from apps/bellona/remote-gateway, BELLONA_REMOTE_GATEWAY_PORT=4100 BELLONA_REMOTE_GATEWAY_LOG_LEVEL=fatal pnpm exec tsx src/main.ts with curl -fsS http://127.0.0.1:4100/ready; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/package.json apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/config.ts apps/bellona/remote-gateway/src/config.test.ts apps/bellona/remote-gateway/src/host-connections.ts apps/bellona/remote-gateway/src/host-connections.test.ts apps/bellona/remote-gateway/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task verifies host WebSocket behavior with local ws clients and mocked protocol-valid devices, not macOS hardware, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by the unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is command enqueue and dispatch to a connected fake host.
180.C.05.04 Implement command enqueue and dispatch to a connected fake host with idempotency key support and tests. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/command-dispatcher.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-gateway/src/host-connections.ts; apps/bellona/remote-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; from apps/bellona/remote-gateway, BELLONA_REMOTE_GATEWAY_PORT=4101 BELLONA_REMOTE_GATEWAY_LOG_LEVEL=fatal pnpm exec tsx src/main.ts with curl -fsS http://127.0.0.1:4101/ready; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/command-dispatcher.ts apps/bellona/remote-gateway/src/command-dispatcher.test.ts apps/bellona/remote-gateway/src/host-connections.ts apps/bellona/remote-gateway/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task dispatches protocol-valid commands to a local fake WebSocket host and does not exercise macOS hardware, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is command result, progress event, and error event routing.
180.C.05.05 Implement command result, progress event, and error event routing back to the requesting client with tests. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/command-dispatcher.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-gateway/src/host-connections.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; from apps/bellona/remote-gateway, BELLONA_REMOTE_GATEWAY_PORT=4102 BELLONA_REMOTE_GATEWAY_LOG_LEVEL=fatal pnpm exec tsx src/main.ts with curl -fsS http://127.0.0.1:4102/ready; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/command-dispatcher.ts apps/bellona/remote-gateway/src/command-dispatcher.test.ts apps/bellona/remote-gateway/src/host-connections.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task validates host WebSocket progress/result/error routing with local ws clients and protocol fixtures, not macOS hardware, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is session lifecycle endpoints or internal service methods.
180.C.05.06 Implement session lifecycle endpoints or internal service methods for start, pause, resume, stop, and takeover state. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/index.ts; apps/bellona/remote-gateway/src/session-lifecycle.ts; apps/bellona/remote-gateway/src/session-lifecycle.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; from apps/bellona/remote-gateway, BELLONA_REMOTE_GATEWAY_PORT=4103 BELLONA_REMOTE_GATEWAY_LOG_LEVEL=fatal pnpm exec tsx src/main.ts with curl -fsS http://127.0.0.1:4103/ready; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/index.ts apps/bellona/remote-gateway/src/session-lifecycle.ts apps/bellona/remote-gateway/src/session-lifecycle.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task validates protocol-shaped in-memory session lifecycle transitions with unit tests only and does not exercise macOS hardware, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is basic audit emission for gateway-received command, gateway-dispatched command, host-result, and session-ended.
180.C.05.07 Implement basic audit emission for gateway-received command, gateway-dispatched command, host-result, and session-ended. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/audit-log.ts; apps/bellona/remote-gateway/src/audit-log.test.ts; apps/bellona/remote-gateway/src/command-dispatcher.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-gateway/src/index.ts; apps/bellona/remote-gateway/src/session-lifecycle.ts; apps/bellona/remote-gateway/src/session-lifecycle.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; from apps/bellona/remote-gateway, BELLONA_REMOTE_GATEWAY_PORT=4104 BELLONA_REMOTE_GATEWAY_LOG_LEVEL=fatal pnpm exec tsx src/main.ts with curl -fsS http://127.0.0.1:4104/ready; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/audit-log.ts apps/bellona/remote-gateway/src/audit-log.test.ts apps/bellona/remote-gateway/src/command-dispatcher.ts apps/bellona/remote-gateway/src/command-dispatcher.test.ts apps/bellona/remote-gateway/src/index.ts apps/bellona/remote-gateway/src/session-lifecycle.ts apps/bellona/remote-gateway/src/session-lifecycle.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task validates in-memory protocol audit emission with unit tests and local WebSocket host fixtures only and does not exercise macOS hardware, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is gateway metrics/log fields for correlation ID, session ID, device ID, command ID, actor ID, and adapter target.
180.C.05.08 Implement gateway metrics/log fields for correlation ID, session ID, device ID, command ID, actor ID, and adapter target. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/command-dispatcher.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-gateway/src/index.ts; apps/bellona/remote-gateway/src/session-lifecycle.ts; apps/bellona/remote-gateway/src/session-lifecycle.test.ts; apps/bellona/remote-gateway/src/telemetry.ts; apps/bellona/remote-gateway/src/telemetry.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; from apps/bellona/remote-gateway, BELLONA_REMOTE_GATEWAY_PORT=4105 BELLONA_REMOTE_GATEWAY_LOG_LEVEL=fatal pnpm exec tsx src/main.ts with curl -fsS http://127.0.0.1:4105/ready; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/command-dispatcher.ts apps/bellona/remote-gateway/src/command-dispatcher.test.ts apps/bellona/remote-gateway/src/index.ts apps/bellona/remote-gateway/src/session-lifecycle.ts apps/bellona/remote-gateway/src/session-lifecycle.test.ts apps/bellona/remote-gateway/src/telemetry.ts apps/bellona/remote-gateway/src/telemetry.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task validates in-memory telemetry and structured logger fields with unit tests and local WebSocket host fixtures only and does not exercise macOS hardware, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is gateway docs for local startup, fake host connection, fake command dispatch, and expected logs/tests.
180.C.05.09 Add gateway docs showing local startup, fake host connection, fake command dispatch, and expected logs/tests. Codex Complete apps/bellona/remote-gateway/README.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check apps/bellona/remote-gateway/README.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; pnpm nx test @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; git diff --check Not applicable; this is documentation for local gateway startup and fake WebSocket host/command flows, not macOS hardware, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is hardening gateway shutdown and cleanup of host/client sockets.
180.C.05.10 Check off this stage only after the gateway can complete a mocked command round trip through tests. Codex Complete apps/bellona/remote-gateway/src/command-dispatcher.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; from apps/bellona/remote-gateway, BELLONA_REMOTE_GATEWAY_PORT=4106 BELLONA_REMOTE_GATEWAY_LOG_LEVEL=fatal pnpm exec tsx src/main.ts with curl -fsS http://127.0.0.1:4106/ready; pnpm exec prettier --check apps/bellona/remote-gateway/src/command-dispatcher.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task verifies the gateway's complete mocked command round trip with local ws host fixtures and protocol schemas, not macOS hardware, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is remote-host scaffolding.
180.C.06.01 Scaffold apps/bellona/remote-host or the chosen host package with configuration loading, logging, health, and test target. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/project.json; apps/bellona/remote-host/tsconfig.json; apps/bellona/remote-host/tsconfig.app.json; apps/bellona/remote-host/vitest.config.ts; apps/bellona/remote-host/src/app.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/config.ts; apps/bellona/remote-host/src/config.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/src/main.ts; pnpm-lock.yaml; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose; pnpm nx typecheck @bellona/remote-host --verbose; pnpm nx lint @bellona/remote-host --verbose; pnpm nx build @bellona/remote-host --skip-nx-cache --verbose; from apps/bellona/remote-host, BELLONA_REMOTE_HOST_HEALTH_PORT=4107 BELLONA_REMOTE_HOST_LOG_LEVEL=fatal pnpm exec tsx src/main.ts with curl -fsS http://127.0.0.1:4107/ready; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/project.json apps/bellona/remote-host/tsconfig.json apps/bellona/remote-host/tsconfig.app.json apps/bellona/remote-host/vitest.config.ts apps/bellona/remote-host/src/app.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/config.ts apps/bellona/remote-host/src/config.test.ts apps/bellona/remote-host/src/index.ts apps/bellona/remote-host/src/main.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task creates a local Node host health/config/logging skeleton and does not exercise macOS TCC permissions, Blender, Unreal, browser profiles, WebRTC media, or LaunchAgent packaging. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is development-file host identity loading.
180.C.06.02 Implement host identity loading from a development file store first, with a clear future replacement by macOS Keychain. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/src/app.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/config.ts; apps/bellona/remote-host/src/config.test.ts; apps/bellona/remote-host/src/identity-store.ts; apps/bellona/remote-host/src/identity-store.test.ts; apps/bellona/remote-host/src/index.ts; pnpm-lock.yaml; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose; pnpm nx typecheck @bellona/remote-host --verbose; pnpm nx lint @bellona/remote-host --verbose; pnpm nx build @bellona/remote-host --skip-nx-cache --verbose; from apps/bellona/remote-host, BELLONA_REMOTE_HOST_IDENTITY_FILE=/tmp/bellona-remote-host-smoke.identity.json BELLONA_REMOTE_HOST_HEALTH_PORT=4108 BELLONA_REMOTE_HOST_LOG_LEVEL=fatal pnpm exec tsx src/main.ts with curl -fsS http://127.0.0.1:4108/ready; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/src/app.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/config.ts apps/bellona/remote-host/src/config.test.ts apps/bellona/remote-host/src/identity-store.ts apps/bellona/remote-host/src/identity-store.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task validates a development-only local JSON identity store with protocol fixtures and does not exercise macOS Keychain, TCC permissions, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is outbound host connection to gateway.
180.C.06.03 Implement outbound connection from host to gateway with handshake, heartbeat, reconnect, and disconnect event tests. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/src/app.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/config.ts; apps/bellona/remote-host/src/config.test.ts; apps/bellona/remote-host/src/gateway-connection.ts; apps/bellona/remote-host/src/gateway-connection.test.ts; apps/bellona/remote-host/src/index.ts; pnpm-lock.yaml; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose; pnpm nx typecheck @bellona/remote-host --verbose; pnpm nx lint @bellona/remote-host --verbose; pnpm nx build @bellona/remote-host --skip-nx-cache --verbose; local smoke with apps/bellona/remote-gateway on 4109, development identity file, and apps/bellona/remote-host on 4110 returning checks.gatewayConnection: "connected" from /ready; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/src/app.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/config.ts apps/bellona/remote-host/src/config.test.ts apps/bellona/remote-host/src/gateway-connection.ts apps/bellona/remote-host/src/gateway-connection.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task validates outbound WebSocket behavior with local fake gateway and local gateway smoke tests, not macOS TCC permissions, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is local adapter registry with fake adapter registration.
180.C.06.04 Implement local adapter registry with fake adapter registration, capability reporting, health reporting, and command routing. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.ts; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/app.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose; pnpm nx typecheck @bellona/remote-host --verbose; pnpm nx lint @bellona/remote-host --verbose; pnpm nx build @bellona/remote-host --skip-nx-cache --verbose; local gateway/host smoke with /ready reporting checks.adapters: "ok" and checks.gatewayConnection: "connected"; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.ts apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/app.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task validates an in-process fake adapter registry and local routing with protocol fixtures, not macOS TCC permissions, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is host command execution lifecycle.
180.C.06.05 Implement host command execution lifecycle: accepted, started, progress, completed, failed, cancelled, and timed out. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/app.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/command-executor.ts; apps/bellona/remote-host/src/command-executor.test.ts; apps/bellona/remote-host/src/gateway-connection.ts; apps/bellona/remote-host/src/gateway-connection.test.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose; pnpm nx typecheck @bellona/remote-host --verbose; pnpm nx lint @bellona/remote-host --verbose; pnpm nx build @bellona/remote-host --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/app.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/command-executor.ts apps/bellona/remote-host/src/command-executor.test.ts apps/bellona/remote-host/src/gateway-connection.ts apps/bellona/remote-host/src/gateway-connection.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task validates host command lifecycle behavior with in-process fake adapters and local WebSocket gateway fixtures, not macOS TCC permissions, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is host-side policy preflight stub.
180.C.06.06 Implement host-side policy preflight stub that denies unknown commands before the real policy package is added. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/command-executor.ts; apps/bellona/remote-host/src/command-executor.test.ts; apps/bellona/remote-host/src/gateway-connection.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/src/policy-preflight.ts; apps/bellona/remote-host/src/policy-preflight.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose; pnpm nx typecheck @bellona/remote-host --verbose; pnpm nx lint @bellona/remote-host --verbose; pnpm nx build @bellona/remote-host --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/command-executor.ts apps/bellona/remote-host/src/command-executor.test.ts apps/bellona/remote-host/src/gateway-connection.test.ts apps/bellona/remote-host/src/index.ts apps/bellona/remote-host/src/policy-preflight.ts apps/bellona/remote-host/src/policy-preflight.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task validates a conservative in-process policy preflight stub with protocol-valid denied results and local WebSocket gateway fixtures, not macOS TCC permissions, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is host diagnostics command.
180.C.06.07 Implement host diagnostics command returning OS, host version, adapter list, missing permissions placeholder, and resource placeholder. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.ts; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/command-executor.test.ts; apps/bellona/remote-host/src/gateway-connection.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/src/policy-preflight.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose; pnpm nx typecheck @bellona/remote-host --verbose; pnpm nx lint @bellona/remote-host --verbose; pnpm nx build @bellona/remote-host --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.ts apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/command-executor.test.ts apps/bellona/remote-host/src/gateway-connection.test.ts apps/bellona/remote-host/src/index.ts apps/bellona/remote-host/src/policy-preflight.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task validates an in-process diagnostics adapter and local WebSocket command dispatch tests, not real macOS TCC permission probing, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is host shutdown cleanup for running commands and adapters.
180.C.06.08 Implement cleanup on shutdown: cancel running command, close gateway connection, stop fake adapters, flush logs, and emit final event. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.ts; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/app.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/command-executor.ts; apps/bellona/remote-host/src/command-executor.test.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose; pnpm nx typecheck @bellona/remote-host --verbose; pnpm nx lint @bellona/remote-host --verbose; pnpm nx build @bellona/remote-host --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.ts apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/app.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/command-executor.ts apps/bellona/remote-host/src/command-executor.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task validates deterministic local shutdown cleanup with fake in-process adapters and command promises, not real macOS TCC permission probing, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is host local fake-host startup docs.
180.C.06.09 Add host docs showing local fake-host startup against local gateway. Codex Complete apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check apps/bellona/remote-host/README.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; pnpm nx test @bellona/remote-host --verbose; pnpm nx build @bellona/remote-host --skip-nx-cache --verbose; git diff --check Not applicable; this is documentation for local gateway plus host startup and expected readiness/log signals, not real macOS TCC permission probing, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; next eligible item is the remote-host stage closure command-round-trip check.
180.C.06.10 Check off this stage only after fake host and fake gateway pass a complete command round trip both from gateway tests and host tests. Codex Complete docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md Gateway fake-host route: pnpm nx test @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose. Host fake-gateway route: pnpm nx test @bellona/remote-host --verbose; pnpm nx typecheck @bellona/remote-host --verbose; pnpm nx lint @bellona/remote-host --verbose; pnpm nx build @bellona/remote-host --skip-nx-cache --verbose. Docs/hygiene: pnpm exec prettier --check docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this closure item verifies fake host/gateway command round trips in local automated tests, not real macOS TCC permission probing, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; remote-host walking skeleton stage is complete and the next Phase 180 item is 180.C.07.01 within the same Phase 180 checklist.
180.C.07.01 Add persistent device, session, command, approval, and audit storage for the gateway using the repo's established database pattern or an explicitly documented first-stage store. Codex Complete apps/bellona/remote-gateway/src/persistent-store.ts; apps/bellona/remote-gateway/src/persistent-store.test.ts; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/app.test.ts; apps/bellona/remote-gateway/src/audit-log.ts; apps/bellona/remote-gateway/src/command-dispatcher.ts; apps/bellona/remote-gateway/src/config.ts; apps/bellona/remote-gateway/src/config.test.ts; apps/bellona/remote-gateway/src/device-registry.ts; apps/bellona/remote-gateway/src/session-lifecycle.ts; apps/bellona/remote-gateway/src/index.ts; apps/bellona/remote-gateway/README.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/app.test.ts apps/bellona/remote-gateway/src/audit-log.ts apps/bellona/remote-gateway/src/command-dispatcher.ts apps/bellona/remote-gateway/src/config.ts apps/bellona/remote-gateway/src/config.test.ts apps/bellona/remote-gateway/src/device-registry.ts apps/bellona/remote-gateway/src/index.ts apps/bellona/remote-gateway/src/persistent-store.ts apps/bellona/remote-gateway/src/persistent-store.test.ts apps/bellona/remote-gateway/src/session-lifecycle.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this first-stage store is validated by local gateway unit/type/build checks and does not exercise real macOS TCC permission probing, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; final production database choice remains deferred, while BELLONA_REMOTE_GATEWAY_STORE_FILE enables the documented first-stage atomic JSON store.
180.C.07.02 Implement one-time pairing code creation, expiry, single use, and tests. Codex Complete apps/bellona/remote-gateway/src/pairing-codes.ts; apps/bellona/remote-gateway/src/pairing-codes.test.ts; apps/bellona/remote-gateway/src/persistent-store.ts; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/config.ts; apps/bellona/remote-gateway/src/config.test.ts; apps/bellona/remote-gateway/src/index.ts; apps/bellona/remote-gateway/README.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/config.ts apps/bellona/remote-gateway/src/config.test.ts apps/bellona/remote-gateway/src/index.ts apps/bellona/remote-gateway/src/pairing-codes.ts apps/bellona/remote-gateway/src/pairing-codes.test.ts apps/bellona/remote-gateway/src/persistent-store.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; this task validates one-time pairing-code lifecycle behavior in local gateway unit/type/build checks, not real two-Mac pairing, macOS TCC permission probing, Blender, Unreal, browser profiles, or WebRTC media. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; 180.C.07.03 owns exchanging redeemed codes for device identity and development credentials.
180.C.07.03 Implement host pairing flow that exchanges pairing code for device identity and stores credentials in the development credential store. Codex Complete apps/bellona/remote-gateway/{README.md,src/{app.ts,app.test.ts,index.ts,pairing-exchange.ts}}; apps/bellona/remote-host/{README.md,src/{app.ts,config.ts,config.test.ts,identity-store.ts,index.ts,pairing-client.ts,pairing-client.test.ts}}; tracker and TODO. Gateway and host pnpm nx test, typecheck, lint, and build --skip-nx-cache; pnpm exec prettier --check for the changed task files; git diff --check. Not applicable; validates local development pairing exchange and credential-file writes in gateway/host tests, not real hardware paths. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; production signed-token or mTLS host authentication and macOS Keychain storage are owned by 180.C.07.04 and 180.C.16.01.
180.C.07.04 Replace development host auth with signed tokens or mTLS scaffolding and document the final macOS Keychain storage task. Codex Complete apps/bellona/remote-gateway/{README.md,src/{app.ts,app.test.ts,command-dispatcher.test.ts,config.ts,config.test.ts,host-connections.ts,host-connections.test.ts,host-token.ts,host-token.test.ts,index.ts,pairing-exchange.ts}}; apps/bellona/remote-host/{README.md,src/{app.test.ts,gateway-connection.ts,gateway-connection.test.ts,identity-store.ts,identity-store.test.ts,pairing-client.ts,pairing-client.test.ts}}; tracker and TODO. Gateway and host pnpm nx test, typecheck, lint, and build --skip-nx-cache; pnpm exec prettier --check for the changed task files; git diff --check. Not applicable; validates signed host-token pairing and handshake auth in local gateway/host tests, not real hardware paths. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; macOS Keychain replacement remains explicitly tracked by 180.C.16.01, and production mTLS remains later transport hardening.
180.C.07.05 Implement device revocation and prove revoked hosts cannot reconnect or receive commands. Codex Complete apps/bellona/remote-gateway/{README.md,src/{app.ts,device-registry.ts,device-revocation.ts,device-revocation.test.ts,host-connections.ts,host-connections.test.ts,host-token.test.ts,index.ts}}; tracker and TODO. pnpm nx test @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; pnpm exec prettier --check for the changed task files; git diff --check. Not applicable; validates gateway revocation, active disconnect, blocked reconnect, and blocked command dispatch in local gateway tests, not real hardware paths. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; 180.C.07.06 owns the shared permission scope and policy evaluator.
180.C.07.06 Implement shared permission scopes and policy evaluator for observe-only, project write, desktop control, browser profile, arbitrary code, shell, destructive, publishing, and financial actions. Codex Complete libs/bellona/remote-protocol/{README.md,src/{device.ts,device.test.ts,index.ts,policy.ts,policy.test.ts,schema-registry.ts,schema-registry.test.ts},contracts/**}; apps/bellona/remote-gateway/{README.md,src/{app.ts,command-dispatcher.ts,command-dispatcher.test.ts}}; tracker and TODO. Protocol and gateway pnpm nx test, typecheck, lint, and build --skip-nx-cache; pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx contracts:check @bellona/remote-protocol; host pnpm nx test, typecheck, and build --skip-nx-cache; pnpm exec prettier --check for the changed task files; git diff --check. Not applicable; validates shared policy inference, denial, approval-required decisions, and gateway pre-dispatch rejection in local protocol/gateway tests, not real hardware paths. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; 180.C.07.07 owns approval request creation and command continuation.
180.C.07.07 Implement approval request creation, approval response, timeout, deny-by-default, and command continuation after approval. Codex Complete apps/bellona/remote-gateway/{README.md,src/{app.ts,approval-service.ts,approval-service.test.ts,command-dispatcher.ts,command-dispatcher.test.ts,config.ts,config.test.ts,index.ts}}; tracker and TODO. pnpm nx test @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; pnpm exec prettier --check for the changed task files; git diff --check. Not applicable; validates approval request lifecycle, denial, expiry deny-by-default, and approved command continuation in local gateway tests, not real hardware paths. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; 180.C.07.08 owns expanded high-risk namespace policy coverage.
180.C.07.08 Add policy tests for every high-risk command namespace: Blender Python, Unreal console, shell, desktop control, file delete, browser profile, form submit, and upload. Codex Complete libs/bellona/remote-protocol/src/policy.ts; libs/bellona/remote-protocol/src/policy.test.ts; tracker and TODO. pnpm nx test @bellona/remote-protocol --verbose; pnpm nx typecheck @bellona/remote-protocol --verbose; pnpm nx lint @bellona/remote-protocol --verbose; pnpm nx build @bellona/remote-protocol --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/remote-protocol/src/policy.ts libs/bellona/remote-protocol/src/policy.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check. Not applicable; validates high-risk policy scope inference and approval-required outcomes in local protocol tests, not real hardware paths. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; 180.C.07.09 owns audit tests for pairing, revocation, policy, and approval outcomes.
180.C.07.09 Add audit tests for pairing, revocation, policy allow, policy deny, approval request, approval grant, and approval deny. Codex Complete libs/bellona/remote-protocol/{src/{audit.ts,audit.test.ts},contracts/**}; apps/bellona/remote-gateway/src/{app.ts,app.test.ts,command-dispatcher.ts,command-dispatcher.test.ts,device-revocation.ts,device-revocation.test.ts,pairing-exchange.ts}; tracker and TODO. Protocol pnpm nx contracts:generate, contracts:check, test, typecheck, lint, and build --skip-nx-cache; gateway pnpm nx test, typecheck, lint, and build --skip-nx-cache; pnpm exec prettier --check for the changed task files; git diff --check. Not applicable; validates audit emission and typed audit entries for pairing, revocation, policy allow/deny, approval request, approval grant, and approval deny in local tests, not real hardware paths. Workspace-level frozen-lockfile validation remains blocked by unrelated libs/iris/accessibility/cognitive/dist/package.json drift documented in 180.C.05.01; 180.C.07.10 owns final policy/audit closure for mutating adapter work.
180.C.07.10 Check off this stage only after mutating adapter work is impossible to execute without policy and audit coverage. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/command-dispatcher.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-gateway/src/host-connections.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx lint @bellona/remote-gateway --verbose; pnpm nx build @bellona/remote-gateway --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/command-dispatcher.ts apps/bellona/remote-gateway/src/command-dispatcher.test.ts apps/bellona/remote-gateway/src/host-connections.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates policy and audit fail-closed dispatch ordering with local gateway and fake WebSocket host tests, not real macOS, Blender, Unreal, browser, or WebRTC execution. None for this policy/audit closure; next unchecked Phase 180 item is 180.C.08.01.
180.C.08.01 Implement append-only audit service with correlation IDs, command hashes, result hashes, actor, device, session, and policy decision fields. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/audit-log.ts; apps/bellona/remote-gateway/src/audit-log.test.ts; apps/bellona/remote-gateway/src/command-dispatcher.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx run-many -p @bellona/remote-gateway -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/audit-log.ts apps/bellona/remote-gateway/src/audit-log.test.ts apps/bellona/remote-gateway/src/command-dispatcher.ts apps/bellona/remote-gateway/src/command-dispatcher.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates append-only audit metadata and command/result hashing in local gateway tests, not real macOS, Blender, Unreal, browser, or WebRTC execution. None for append-only audit fields; next unchecked Phase 180 item is 180.C.08.02.
180.C.08.02 Implement timeline query API/service returning ordered session events, command events, approval events, stream events, and artifact events. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/app.test.ts; apps/bellona/remote-gateway/src/index.ts; apps/bellona/remote-gateway/src/timeline.ts; apps/bellona/remote-gateway/src/timeline.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx run-many -p @bellona/remote-gateway -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/app.test.ts apps/bellona/remote-gateway/src/index.ts apps/bellona/remote-gateway/src/timeline.ts apps/bellona/remote-gateway/src/timeline.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates the timeline merge, filters, ordering, pagination, and HTTP endpoint with local gateway tests, not real macOS, Blender, Unreal, browser, WebRTC, stream media, or artifact storage behavior. None for the timeline query service; next unchecked Phase 180 item is 180.C.08.03.
180.C.08.03 Implement artifact metadata registration for screenshots, renders, logs, browser traces, exports, and diagnostic bundles. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/app.test.ts; apps/bellona/remote-gateway/src/artifact-registry.ts; apps/bellona/remote-gateway/src/artifact-registry.test.ts; apps/bellona/remote-gateway/src/index.ts; apps/bellona/remote-gateway/src/persistent-store.ts; apps/bellona/remote-gateway/src/persistent-store.test.ts; apps/bellona/remote-gateway/src/timeline.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx run-many -p @bellona/remote-gateway -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/app.test.ts apps/bellona/remote-gateway/src/artifact-registry.ts apps/bellona/remote-gateway/src/artifact-registry.test.ts apps/bellona/remote-gateway/src/index.ts apps/bellona/remote-gateway/src/persistent-store.ts apps/bellona/remote-gateway/src/persistent-store.test.ts apps/bellona/remote-gateway/src/timeline.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates artifact metadata registration, persistence, audit emission, timeline visibility, and HTTP endpoints with local gateway tests, not real screenshots, renders, logs, browser traces, diagnostic bundle files, macOS, Blender, Unreal, browser, or WebRTC behavior. None for artifact metadata registration; next unchecked Phase 180 item is 180.C.08.04.
180.C.08.04 Implement redaction utilities for tokens, API keys, passwords, browser cookies, personal paths, and denied window titles. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/index.ts; apps/bellona/remote-gateway/src/redaction.ts; apps/bellona/remote-gateway/src/redaction.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx typecheck @bellona/remote-gateway --verbose; pnpm nx run-many -p @bellona/remote-gateway -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/index.ts apps/bellona/remote-gateway/src/redaction.ts apps/bellona/remote-gateway/src/redaction.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates credential, cookie, path, and denied-window-title redaction with local gateway utility tests, not real macOS, Blender, Unreal, browser, WebRTC, screenshots, OCR, or active-window capture behavior. None for redaction utilities; next unchecked Phase 180 item is 180.C.08.05.
180.C.08.05 Add structured logging to gateway and host with consistent correlation fields. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/command-dispatcher.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-gateway/src/host-connections.ts; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/app.ts; apps/bellona/remote-host/src/command-executor.ts; apps/bellona/remote-host/src/command-executor.test.ts; apps/bellona/remote-host/src/gateway-connection.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/logging.ts; libs/bellona/remote-protocol/src/logging.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --verbose; pnpm nx test @bellona/remote-gateway --verbose; pnpm nx test @bellona/remote-host --verbose; pnpm nx run-many -p @bellona/remote-protocol @bellona/remote-gateway @bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/command-dispatcher.ts apps/bellona/remote-gateway/src/command-dispatcher.test.ts apps/bellona/remote-gateway/src/host-connections.ts apps/bellona/remote-host/README.md apps/bellona/remote-host/src/app.ts apps/bellona/remote-host/src/command-executor.ts apps/bellona/remote-host/src/command-executor.test.ts apps/bellona/remote-host/src/gateway-connection.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/logging.ts libs/bellona/remote-protocol/src/logging.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates structured log field construction and gateway/host log call sites with local unit and integration tests, not real macOS, Blender, Unreal, browser, WebRTC, live host processes, or external log backends. None for structured logging; next unchecked Phase 180 item is 180.C.08.06.
180.C.08.06 Add basic metrics counters/timers for command count, command duration, command failure, host online state, reconnect count, approval latency, and audit write failure. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/approval-service.ts; apps/bellona/remote-gateway/src/approval-service.test.ts; apps/bellona/remote-gateway/src/audit-log.ts; apps/bellona/remote-gateway/src/audit-log.test.ts; apps/bellona/remote-gateway/src/command-dispatcher.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-gateway/src/host-connections.ts; apps/bellona/remote-gateway/src/host-connections.test.ts; apps/bellona/remote-gateway/src/telemetry.ts; apps/bellona/remote-gateway/src/telemetry.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx run-many -p @bellona/remote-gateway -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/approval-service.ts apps/bellona/remote-gateway/src/approval-service.test.ts apps/bellona/remote-gateway/src/audit-log.ts apps/bellona/remote-gateway/src/audit-log.test.ts apps/bellona/remote-gateway/src/command-dispatcher.ts apps/bellona/remote-gateway/src/command-dispatcher.test.ts apps/bellona/remote-gateway/src/host-connections.ts apps/bellona/remote-gateway/src/host-connections.test.ts apps/bellona/remote-gateway/src/telemetry.ts apps/bellona/remote-gateway/src/telemetry.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates metrics emission for command count/duration/failure, host online/reconnect, approval latency, and audit write failures with local gateway tests, not real macOS, Blender, Unreal, browser, WebRTC, host hardware, or external metrics backends. None for basic metrics; next unchecked Phase 180 item is 180.C.08.07.
180.C.08.07 Add tests proving audit entries are written before and after command execution for allowed, denied, failed, and approved commands. Codex Complete apps/bellona/remote-gateway/src/command-dispatcher.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx run-many -p @bellona/remote-gateway -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/src/command-dispatcher.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates audit ordering with local gateway unit/integration tests and fake WebSocket host messages, not real macOS, Blender, Unreal, browser, WebRTC, host hardware, or external audit storage. None for audit ordering tests; next unchecked Phase 180 item is 180.C.08.08.
180.C.08.08 Add docs for reading a session timeline and exporting an audit bundle. Codex Complete apps/bellona/remote-gateway/README.md; docs/domains/bellona/extras/remote-control/session-timeline-and-audit-bundle.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check apps/bellona/remote-gateway/README.md docs/domains/bellona/extras/remote-control/session-timeline-and-audit-bundle.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; documents existing local gateway timeline and first-stage-store audit bundle procedures without real macOS, Blender, Unreal, browser, WebRTC, host hardware, or production object storage. None for timeline/audit-bundle docs; next unchecked Phase 180 item is 180.C.08.09.
180.C.08.09 Add failure behavior for audit store unavailable: block privileged commands and allow only explicitly safe diagnostics. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/command-dispatcher.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx run-many -p @bellona/remote-gateway -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/command-dispatcher.ts apps/bellona/remote-gateway/src/command-dispatcher.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates audit-store outage command gating with local gateway tests and fake WebSocket host messages, not real macOS, Blender, Unreal, browser, WebRTC, host hardware, or production audit storage. None for audit-store outage gating; next unchecked Phase 180 item is 180.C.08.10.
180.C.08.10 Check off this stage only after every existing command path emits timeline and audit events. Codex Complete apps/bellona/remote-gateway/src/command-dispatcher.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx run-many -p @bellona/remote-gateway -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/src/command-dispatcher.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates command-path timeline/audit closure with local gateway tests and fake WebSocket host messages, not real macOS, Blender, Unreal, browser, WebRTC, host hardware, or production stores. None for 180.C.08 closure; next unchecked Phase 180 item is 180.C.08.11.
180.C.08.11 Implement a stored-data schema migration framework for device, session, command, approval, and audit records with forward and backward migrations, version stamps, and tests that load fixtures from at least two prior protocol versions. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/persistent-store.ts; apps/bellona/remote-gateway/src/persistent-store.test.ts; docs/domains/bellona/extras/remote-control/session-timeline-and-audit-bundle.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx run-many -p @bellona/remote-gateway -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/persistent-store.ts apps/bellona/remote-gateway/src/persistent-store.test.ts docs/domains/bellona/extras/remote-control/session-timeline-and-audit-bundle.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates first-stage store schema migration, record-version stamps, downgrade/remigration helpers, and audit hash-chain preservation with local gateway tests, not real macOS, Blender, Unreal, browser, WebRTC, host hardware, or production database migration tooling. None for stored-data schema migration; next unchecked Phase 180 item is 180.C.08.12.
180.C.08.12 Thread the RemoteActor identity and delegation chain (from 180.C.03.13) through every audit entry so attribution traces human operator, orchestrator, specialist, and adapter with no ambiguity when multiple agents share a session. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.test.ts; apps/bellona/remote-gateway/src/approval-service.ts; apps/bellona/remote-gateway/src/approval-service.test.ts; apps/bellona/remote-gateway/src/artifact-registry.ts; apps/bellona/remote-gateway/src/artifact-registry.test.ts; apps/bellona/remote-gateway/src/audit-log.ts; apps/bellona/remote-gateway/src/audit-log.test.ts; apps/bellona/remote-gateway/src/device-revocation.ts; apps/bellona/remote-gateway/src/device-revocation.test.ts; apps/bellona/remote-gateway/src/pairing-exchange.ts; apps/bellona/remote-gateway/src/persistent-store.test.ts; docs/domains/bellona/extras/remote-control/session-timeline-and-audit-bundle.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose; pnpm nx run-many -p @bellona/remote-gateway -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.test.ts apps/bellona/remote-gateway/src/approval-service.ts apps/bellona/remote-gateway/src/approval-service.test.ts apps/bellona/remote-gateway/src/artifact-registry.ts apps/bellona/remote-gateway/src/artifact-registry.test.ts apps/bellona/remote-gateway/src/audit-log.ts apps/bellona/remote-gateway/src/audit-log.test.ts apps/bellona/remote-gateway/src/device-revocation.ts apps/bellona/remote-gateway/src/device-revocation.test.ts apps/bellona/remote-gateway/src/pairing-exchange.ts apps/bellona/remote-gateway/src/persistent-store.test.ts docs/domains/bellona/extras/remote-control/session-timeline-and-audit-bundle.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates audit actor-chain propagation and searchable attribution metadata with local gateway tests, not real macOS, Blender, Unreal, browser, WebRTC, host hardware, or production identity providers. None for audit actor delegation attribution; next unchecked Phase 180 item is 180.C.09.01.
180.C.09.01 Create or adapt the Blender adapter package so the Remote Host can discover a local Blender addon or bridge without exposing a public port. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose; pnpm nx run-many -p @bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates loopback-only Blender addon/bridge discovery, protocol registration, and host registry behavior with local tests, not a live Blender process or second MacBook. None for loopback discovery; next unchecked Phase 180 item is 180.C.09.02, which must add active Blender/addon health reporting before command routing claims availability.
180.C.09.02 Implement Blender adapter health command reporting Blender installed/missing, addon installed/missing, Blender version, addon version, connection state, and active file path. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/index.ts; libs/bellona/blender/python/bellona_addon/handlers.py; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose; pnpm nx run-many -p @bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; PYTHONPYCACHEPREFIX=/tmp/oshun-pycache python3 -m py_compile libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates Blender health command routing, mock addon WebSocket probing, and Python syntax locally. No live Blender install or second MacBook was required for this health-command implementation. None for adapter health reporting; next unchecked Phase 180 item is 180.C.09.03, which must add the canonical read-only blender.scene.info schema before scene command routing is enabled.
180.C.09.03 Implement read-only blender.scene.info schema in remote-protocol with scenes, collections, objects, materials, cameras, lights, frame range, selected objects, and render engine. Codex Complete libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json; libs/bellona/remote-protocol/src/blender.ts; libs/bellona/remote-protocol/src/blender.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --verbose; pnpm nx run-many -p @bellona/remote-protocol -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx contracts:check @bellona/remote-protocol; pnpm exec prettier --check libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/blender.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/schema-registry.ts libs/bellona/remote-protocol/src/schema-registry.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates canonical Blender scene-info protocol schemas, fixtures, generated contracts, and schema tests locally, not live Blender or second-Mac hardware. None for scene-info schema ownership; next unchecked Phase 180 item is 180.C.09.04, which must map the Remote Host to the addon/bridge and mock adapter using this protocol contract.
180.C.09.04 Implement host-to-Blender read-only command route using the existing addon/bridge where possible and a mock adapter where Blender is unavailable. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/index.ts; libs/bellona/blender/python/bellona_addon/handlers.py; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose; pnpm nx run-many -p @bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; PYTHONPYCACHEPREFIX=/tmp/oshun-pycache python3 -m py_compile libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates host scene-info routing, mock addon WebSocket routing, fallback scene-info output, and Python syntax locally. No live Blender install or second MacBook was required. None for host-to-Blender read-only route; next unchecked Phase 180 item is 180.C.09.05, which must add focused unit tests for scene-info schema and adapter mapping.
180.C.09.05 Add unit tests for scene-info schema and adapter mapping. Codex Complete libs/bellona/remote-protocol/src/blender.test.ts; apps/bellona/remote-host/src/blender-adapter.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/remote-protocol/src/blender.test.ts apps/bellona/remote-host/src/blender-adapter.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates schema and adapter mapping behavior with unit tests and mock addon payload capture locally. No live Blender install or second MacBook was required. None for schema and adapter mapping unit coverage; next unchecked Phase 180 item is 180.C.09.06, which must add integration tests using a mocked Blender addon response.
180.C.09.06 Add integration tests using a mocked Blender addon response. Codex Complete apps/bellona/remote-host/src/blender-scene-info.integration.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/src/blender-scene-info.integration.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates executor-to-registry-to-adapter-to-mocked-addon scene-info integration locally. No live Blender install or second MacBook was required. None for mocked addon integration tests; next unchecked Phase 180 item is 180.C.09.07, which must add an optional hardware/headless Blender smoke test that opens a tiny fixture scene and returns scene info.
180.C.09.07 Add optional hardware/headless Blender smoke test that opens a tiny fixture scene and returns scene info. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/project.json; apps/bellona/remote-host/scripts/blender-scene-info-smoke.ts; apps/bellona/remote-host/tsconfig.app.json; libs/bellona/blender/python/bellona_addon/server.py; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx blender:scene-info-smoke @bellona/remote-host; pnpm nx run-many -p @bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; PYTHONPYCACHEPREFIX=/tmp/oshun-pycache python3 -m py_compile libs/bellona/blender/python/bellona_addon/server.py libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/project.json apps/bellona/remote-host/scripts/blender-scene-info-smoke.ts apps/bellona/remote-host/tsconfig.app.json docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Local headless smoke ran against /Applications/Blender.app/Contents/MacOS/Blender and returned scene:Bellona Smoke Scene, objectCount: 3, render engine CYCLES, and selected object object:Bellona Smoke Cube. None for optional headless Blender smoke; next unchecked Phase 180 item is 180.C.09.08, which must route blender.scene.info from gateway/client to host to adapter and back to timeline/audit.
180.C.09.08 Route blender.scene.info from gateway/client to host to adapter and back to timeline/audit. Codex Complete apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-host/src/gateway-connection.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose --skip-nx-cache; pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-gateway,@bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/src/command-dispatcher.test.ts apps/bellona/remote-host/src/gateway-connection.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable; validates the client-to-gateway-to-host scene-info route, host adapter handler execution, timeline/audit records, and telemetry in automated local tests. No second MacBook was required. None for gateway/client scene-info routing; next unchecked Phase 180 item is 180.C.09.09, which must document how to run the Blender read-only MVP on the second MacBook.
180.C.09.09 Document how to run the Blender read-only MVP on the second MacBook. Codex Complete docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md apps/bellona/remote-host/README.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this documentation-only runbook; it defines the second-MacBook procedure and required future evidence, but no hardware signoff was claimed. None for the runbook; next unchecked Phase 180 item is 180.C.09.10, which must prove an agent/CLI can query Blender scene info through the full remote path.
180.C.09.10 Check off this stage only after an agent/CLI can query Blender scene info through the full remote path. Codex Complete apps/bellona/remote-host/scripts/blender-scene-info-remote-smoke.ts; apps/bellona/remote-host/package.json; apps/bellona/remote-host/project.json; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx blender:scene-info-remote-smoke @bellona/remote-host; pnpm nx run-many -p @bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/scripts/blender-scene-info-remote-smoke.ts apps/bellona/remote-host/package.json apps/bellona/remote-host/project.json apps/bellona/remote-host/README.md docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Local CLI smoke proved the full gateway-host-adapter command path with fallback scene-info output. Live Blender/addon evidence can be required by rerunning the CLI with -- --require-live-addon on MAC-HOST-01. None for the Blender read-only adapter MVP closure; next unchecked Phase 180 item is 180.C.10.01, but this task does not start the next phase/stage.
180.C.10.01 Implement blender.object.create_primitive schema with name, primitive type, transform, collection, material reference, and timeout/risk metadata. Codex Complete libs/bellona/remote-protocol/src/blender.ts; libs/bellona/remote-protocol/src/blender.test.ts; libs/bellona/remote-protocol/src/command.ts; libs/bellona/remote-protocol/src/device.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/device.test.ts; libs/bellona/remote-protocol/src/policy.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/README.md; generated libs/bellona/remote-protocol/contracts/**; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx contracts:check @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-protocol -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md docs/domains/bellona/extras/remote-control/implementation-tracker.md libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/blender.ts libs/bellona/remote-protocol/src/command.ts libs/bellona/remote-protocol/src/device.test.ts libs/bellona/remote-protocol/src/device.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/policy.test.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts; git diff --check Not applicable for schema-only safe mutation contract work; no Blender runtime mutation was claimed. Hardware evidence starts when later 180.C.10 items implement undo checkpoints, adapter execution, evidence capture, and smoke tests. None for primitive creation schema. Next unchecked Phase 180 item is 180.C.10.02, which must implement Blender undo checkpoint creation before the primitive command mutates the scene.
180.C.10.02 Implement Blender undo checkpoint creation before the primitive command mutates the scene. Codex Complete libs/bellona/blender/python/bellona_addon/handlers.py; libs/bellona/blender/src/addon-smoke.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md PYTHONPYCACHEPREFIX=/tmp/oshun-pycache python3 -m py_compile libs/bellona/blender/python/bellona_addon/__init__.py libs/bellona/blender/python/bellona_addon/server.py libs/bellona/blender/python/bellona_addon/handlers.py libs/bellona/blender/python/bellona_addon/events.py; pnpm nx test @bellona/blender --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/blender -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/blender/src/addon-smoke.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for local addon checkpoint implementation; no live Blender hardware run was claimed. Later 180.C.10.07 and 180.C.10.10 must capture real Blender evidence that the checkpoint appears before a primitive mutation and supports rollback. None for addon checkpoint creation. Next unchecked Phase 180 item is 180.C.10.03, which must block Blender mutation when the session is observe-only.
180.C.10.03 Implement host-side policy check for Blender mutation and block if the session is observe-only. Codex Complete apps/bellona/remote-host/src/policy-preflight.ts; apps/bellona/remote-host/src/policy-preflight.test.ts; apps/bellona/remote-host/src/command-executor.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/src/policy-preflight.ts apps/bellona/remote-host/src/policy-preflight.test.ts apps/bellona/remote-host/src/command-executor.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for local host policy preflight work; no live Blender hardware run was claimed. This item proves observe-only mutation blocking with local protocol fixtures before any addon mutation handler is called. None for observe-only host policy. Next unchecked Phase 180 item is 180.C.10.04, which must capture before/after scene evidence.
180.C.10.04 Implement before/after scene evidence capture through scene-info snapshots and optional viewport screenshot artifact. Codex Complete apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-adapter.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-adapter.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for local evidence-capture utility work; no live Blender hardware run was claimed. Tests validate protocol-valid scene snapshot artifacts/evidence and optional screenshot evidence with local fixtures. None for evidence capture plumbing. Next unchecked Phase 180 item is 180.C.10.05, which must execute primitive creation through the Blender addon or bridge and return structured object/evidence references.
180.C.10.05 Implement primitive creation through the Blender addon or bridge with structured result containing object ID, object name, and evidence references. Codex Complete apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-adapter.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-adapter.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for local mocked addon execution; no live Blender hardware run was claimed. The host route is proved with a mocked addon WebSocket, before/after scene-info snapshots, and structured evidence references. None for host primitive execution plumbing. Later failure-mode coverage is complete in 180.C.10.06.
180.C.10.06 Add mocked adapter tests for success, invalid primitive, missing Blender, timeout, policy deny, and undo failure. Codex Complete apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/command-executor.test.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx test @bellona/remote-gateway --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host @bellona/remote-gateway -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/command-executor.test.ts apps/bellona/remote-gateway/src/command-dispatcher.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for local mocked adapter and gateway policy tests; no live Blender hardware run was claimed. Coverage uses mocked addon WebSocket success, missing endpoint, timeout, addon error, host policy preflight, and gateway policy dispatch/deny tests. None for mocked primitive failure-mode coverage. Later optional headless mutation smoke coverage is complete in 180.C.10.07.
180.C.10.07 Add optional hardware/headless Blender smoke test creating a primitive in a fixture scene and verifying scene-info changed. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/project.json; apps/bellona/remote-host/scripts/blender-create-primitive-smoke.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx blender:create-primitive-smoke @bellona/remote-host --verbose --skip-nx-cache; pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/project.json apps/bellona/remote-host/scripts/blender-create-primitive-smoke.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Local headless smoke ran against /Applications/Blender.app/Contents/MacOS/Blender and reported beforeObjectCount: 3, afterObjectCount: 4, selected object object:Bellona Mutation Smoke Cube, and undo checkpoint id undo-checkpoint:command:blender-create-primitive-smoke-001. None for optional headless Blender primitive smoke. Later CLI timeline visibility is complete in 180.C.10.08.
180.C.10.08 Add Control Room or CLI timeline visibility for the Blender mutation result before broad UI work begins. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/project.json; apps/bellona/remote-host/scripts/blender-create-primitive-remote-smoke.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx blender:create-primitive-remote-smoke @bellona/remote-host --verbose --skip-nx-cache; pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/project.json apps/bellona/remote-host/scripts/blender-create-primitive-remote-smoke.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for default CLI timeline visibility, which uses deterministic in-process providers. The CLI supports --live-addon for manual runs against the configured local Blender addon endpoint. None for CLI mutation timeline visibility. Later rollback/undo documentation is complete in 180.C.10.09.
180.C.10.09 Document rollback/undo behavior and limitations. Codex Complete apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/blender-primitive-rollback-and-undo.md; docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check apps/bellona/remote-host/README.md docs/domains/bellona/extras/remote-control/blender-primitive-rollback-and-undo.md docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for documentation-only rollback guidance. Hardware rollback evidence remains owned by 180.C.10.10. None for rollback/undo documentation. Next unchecked Phase 180 item is 180.C.10.10, which must close the Blender safe mutation MVP with audit, evidence, and rollback notes.
180.C.10.10 Check off this stage only after a remote command can safely create one Blender object with audit, evidence, and rollback notes. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/scripts/blender-create-primitive-smoke.ts; docs/domains/bellona/extras/remote-control/blender-primitive-rollback-and-undo.md; docs/domains/bellona/extras/remote-control/blender-safe-mutation-mvp-closure.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx blender:create-primitive-smoke @bellona/remote-host --verbose --skip-nx-cache; pnpm nx blender:create-primitive-remote-smoke @bellona/remote-host --verbose --skip-nx-cache; pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/scripts/blender-create-primitive-smoke.ts docs/domains/bellona/extras/remote-control/blender-primitive-rollback-and-undo.md docs/domains/bellona/extras/remote-control/blender-safe-mutation-mvp-closure.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Local live Blender smoke ran against /Applications/Blender.app/Contents/MacOS/Blender and reported one created object, undo checkpoint metadata, rollback note, post-restore object absence, and postRollbackObjectCount: 3. Remote CLI smoke proved audit entries, command-result timeline visibility, structured mutation output, and evidence reference count 4. None for the Blender safe mutation MVP closure. Next unchecked Phase 180 item is 180.C.11.01; no later phase has been started.
180.C.11.01 Implement browser adapter capability discovery for Chrome/Chromium availability, managed profile path, CDP launch support, and Playwright availability. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.ts; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/browser-adapter.ts; apps/bellona/remote-host/src/browser-adapter.test.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.ts apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/browser-adapter.ts apps/bellona/remote-host/src/browser-adapter.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for hardware signoff; this task implements local capability discovery and unit-tested probes only. It does not launch Chrome/Chromium, create a browser profile, expose CDP, navigate pages, or access personal browser data. None for browser capability discovery. Next unchecked Phase 180 item is 180.C.11.02, which must create isolated managed profiles with cleanup and no personal profile access.
180.C.11.02 Implement isolated managed browser profile creation with cleanup and no personal profile access. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/browser-adapter.ts; apps/bellona/remote-host/src/browser-adapter.test.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/browser-adapter.ts apps/bellona/remote-host/src/browser-adapter.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for hardware signoff; this task creates and cleans local directories in unit tests only. It does not launch Chrome/Chromium, expose CDP, navigate pages, or access personal browser data. None for isolated managed profile creation. Next unchecked Phase 180 item is 180.C.11.03, which must add managed browser command schemas.
180.C.11.03 Implement browser.launch_managed, browser.navigate, browser.snapshot, browser.screenshot, and browser.close schemas. Codex Complete libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/browser.ts; libs/bellona/remote-protocol/src/browser.test.ts; libs/bellona/remote-protocol/src/device.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; generated libs/bellona/remote-protocol/contracts/**; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx contracts:check @bellona/remote-protocol; pnpm nx test @bellona/remote-protocol --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/browser.ts libs/bellona/remote-protocol/src/browser.test.ts libs/bellona/remote-protocol/src/device.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/schema-registry.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for hardware signoff; this is protocol/schema work only. It does not launch Chrome/Chromium, expose CDP, create real browser sessions, navigate pages, or capture screenshots. None for browser command schema ownership. Completed follow-up 180.C.11.04; next unchecked Phase 180 item is 180.C.11.05, which must implement read-only navigation and page snapshot through Playwright/CDP with blocked-domain enforcement.
180.C.11.04 Implement adapter launch of managed Chrome/Chromium with CDP bound to localhost only. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/browser-adapter.ts; apps/bellona/remote-host/src/browser-adapter.test.ts; apps/bellona/remote-host/src/index.ts; pnpm-lock.yaml; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec tsx -e "<managed browser launch/close smoke>"; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/browser-adapter.ts apps/bellona/remote-host/src/browser-adapter.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Real local smoke launched Playwright Chromium headless with a Bellona-managed profile and returned CDP endpoint 127.0.0.1:<ephemeral>/devtools/browser/...; browser.close removed the managed profile. No personal browser profile was used. None for managed launch/close. Completed follow-up 180.C.11.05; next unchecked Phase 180 item is 180.C.11.06, which must implement screenshot artifact creation with redaction hook placeholders and audit references.
180.C.11.05 Implement read-only navigation and page snapshot through Playwright/CDP with blocked-domain enforcement. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/browser-adapter.ts; apps/bellona/remote-host/src/browser-adapter.test.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/browser-adapter.ts apps/bellona/remote-host/src/browser-adapter.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for hardware signoff beyond the managed launch smoke recorded in 180.C.11.04; this task is covered by deterministic Playwright-handle unit tests for navigation, snapshot, blocked localhost navigation, and cleanup. None for navigation/snapshot. Completed follow-up 180.C.11.06; next unchecked Phase 180 item is 180.C.11.07, which must add browser tests for launch, navigate, snapshot, screenshot, blocked domain, timeout, and cleanup.
180.C.11.06 Implement screenshot artifact creation with redaction hook placeholders and audit references. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/browser-adapter.ts; apps/bellona/remote-host/src/browser-adapter.test.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx typecheck @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/browser-adapter.ts apps/bellona/remote-host/src/browser-adapter.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for hardware signoff beyond the managed launch smoke recorded in 180.C.11.04; this task is covered by deterministic Playwright-handle unit tests for screenshot bytes, selector-mask redaction hooks, artifact metadata, evidence references, and artifact file creation. None for screenshot artifact creation. Completed follow-up 180.C.11.07; next unchecked Phase 180 item is 180.C.11.08, which must route browser commands through gateway-host-adapter with timeline and audit visibility.
180.C.11.07 Add browser tests for launch, navigate, snapshot, screenshot, blocked domain, timeout, and cleanup. Codex Complete apps/bellona/remote-host/src/browser-adapter.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx typecheck @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host -t typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/src/browser-adapter.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for hardware signoff; this task expands deterministic browser adapter unit coverage only and does not claim a live browser smoke beyond the managed launch evidence recorded in 180.C.11.04. None for browser adapter test expansion. Completed follow-up 180.C.11.08; next unchecked Phase 180 item is 180.C.11.09, which must document browser profile isolation and why personal profile access remains blocked at this stage.
180.C.11.08 Route browser commands through gateway-host-adapter with timeline and audit visibility. Codex Complete apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-gateway/src/command-dispatcher.ts; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-gateway/src/device-registry.test.ts; apps/bellona/remote-gateway/src/timeline.ts; apps/bellona/remote-host/src/gateway-connection.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-gateway --verbose --skip-nx-cache; pnpm nx typecheck @bellona/remote-gateway --verbose --skip-nx-cache; pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx typecheck @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-gateway,@bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-gateway/src/command-dispatcher.ts apps/bellona/remote-gateway/src/command-dispatcher.test.ts apps/bellona/remote-gateway/src/device-registry.test.ts apps/bellona/remote-gateway/src/timeline.ts apps/bellona/remote-host/src/gateway-connection.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for hardware signoff; deterministic gateway and host tests use fake WebSocket gateway/host connections plus a fake managed browser launcher. No live Chrome/Chromium, personal browser profile, or real network tunnel is used. None for gateway-host browser routing visibility. Completed follow-up 180.C.11.09; next unchecked Phase 180 item is 180.C.11.10, which must verify a remote agent/CLI can open an isolated browser, navigate, snapshot, screenshot, and clean up.
180.C.11.09 Document browser profile isolation and why personal profile access remains blocked at this stage. Codex Complete apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/browser-profile-isolation.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm exec prettier --check apps/bellona/remote-host/README.md docs/domains/bellona/extras/remote-control/browser-profile-isolation.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for hardware signoff; this is documentation of already implemented isolated-profile controls and does not exercise a live Chrome/Chromium or personal profile. None for profile isolation documentation. Completed follow-up 180.C.11.10; next unchecked Phase 180 item is 180.C.11.11, which must implement a browser compensating-action framework.
180.C.11.10 Check off this stage only after a remote agent/CLI can open an isolated browser, navigate, snapshot, screenshot, and clean up. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/project.json; apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx typecheck @bellona/remote-host --verbose --skip-nx-cache; pnpm nx browser:managed-remote-smoke @bellona/remote-host -- --mock-browser; pnpm nx browser:managed-remote-smoke @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-host,@bellona/remote-gateway -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/project.json apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Live local CLI smoke launched Playwright Chromium with a Bellona-managed isolated profile, navigated to https://example.com/, captured snapshot title Example Domain, wrote screenshot artifact artifact:browser-managed-remote-smoke-screenshot-001-browser-screenshot, and verified the profile was removed after browser.close. None for Browser CDP MVP closure. Completed follow-up 180.C.11.11; next unchecked Phase 180 item is 180.C.11.12, which must enforce compensating-action references before dispatch.
180.C.11.11 Implement a browser compensating-action framework. Browsers have no native undo for form submissions, downloads, or account changes, so each mutating browser command declares a documented reversal path (back-navigation, cancel, delete download, revoke form) populated into the RollbackStrategy metadata from 180.C.03.14. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts; apps/bellona/remote-host/src/browser-adapter.test.ts; apps/bellona/remote-host/src/gateway-connection.test.ts; docs/domains/bellona/extras/remote-control/browser-compensating-actions.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json; libs/bellona/remote-protocol/src/browser.test.ts; libs/bellona/remote-protocol/src/browser.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.ts; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --verbose --skip-nx-cache; pnpm nx typecheck @bellona/remote-protocol --verbose --skip-nx-cache; pnpm nx contracts:generate @bellona/remote-protocol --verbose --skip-nx-cache; pnpm nx contracts:check @bellona/remote-protocol --verbose --skip-nx-cache; pnpm nx test @bellona/remote-host --verbose --skip-nx-cache; pnpm nx typecheck @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts apps/bellona/remote-host/src/browser-adapter.test.ts apps/bellona/remote-host/src/gateway-connection.test.ts docs/domains/bellona/extras/remote-control/browser-compensating-actions.md docs/domains/bellona/extras/remote-control/implementation-tracker.md libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/browser.test.ts libs/bellona/remote-protocol/src/browser.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.ts TODOS/phase-180.md; git diff --check Not applicable for hardware signoff; this task adds protocol schemas, generated contracts, fixture metadata, deterministic host tests, and documentation. It does not claim new live browser behavior beyond the existing 180.C.11.10 smoke evidence. None for browser compensating-action catalog. Completed follow-up 180.C.11.12; next unchecked Phase 180 item is 180.C.12.01, which must decide the MVP Control Room location.
180.C.11.12 Require mutating browser command envelopes to carry compensating_action_id references and enforce their presence before dispatch. Reject mutating browser commands without a declared compensating action at schema validation. Codex Complete apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts; apps/bellona/remote-host/src/browser-adapter.test.ts; apps/bellona/remote-host/src/gateway-connection.test.ts; docs/domains/bellona/extras/remote-control/browser-compensating-actions.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json; libs/bellona/remote-protocol/src/browser-compensating-actions.ts; libs/bellona/remote-protocol/src/browser.test.ts; libs/bellona/remote-protocol/src/browser.ts; libs/bellona/remote-protocol/src/command.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/policy.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --verbose --skip-nx-cache; pnpm nx typecheck @bellona/remote-protocol --verbose --skip-nx-cache; pnpm nx contracts:generate @bellona/remote-protocol --verbose --skip-nx-cache; pnpm nx contracts:check @bellona/remote-protocol --verbose --skip-nx-cache; pnpm nx test @bellona/remote-gateway --verbose --skip-nx-cache; pnpm nx typecheck @bellona/remote-host --verbose --skip-nx-cache; pnpm nx browser:managed-remote-smoke @bellona/remote-host -- --mock-browser; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-gateway,@bellona/remote-host -t test,typecheck,lint,build --skip-nx-cache --verbose; pnpm exec prettier --check ...; git diff --check Not applicable for hardware signoff; this task adds deterministic schema, gateway-dispatch, host fixture, and smoke-script validation. It does not add new live browser behavior beyond the existing 180.C.11.10 live smoke evidence. None for browser compensating-action enforcement. Completed follow-up 180.C.12.01; next unchecked Phase 180 item is 180.C.12.02, which must scaffold apps/bellona/control-room.
180.C.12.01 Decide and document whether the MVP Control Room lives in apps/bellona/control-room or an existing Yemaya Studio app. Codex Complete docs/domains/bellona/extras/remote-control/adr/ADR-0006-control-room-placement.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/adr/ADR-0006-control-room-placement.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for hardware signoff; this task is a documentation-only placement ADR and does not create Control Room UI or exercise WebRTC/native desktop behavior. None for placement decision. Next unchecked Phase 180 item is 180.C.12.02, which must scaffold apps/bellona/control-room behind a feature flag.
180.C.12.02 Scaffold the chosen Control Room app/view behind a feature flag with route, app shell, test target, and no production exposure by default. Codex Complete apps/bellona/control-room/README.md; apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/index.html; apps/bellona/control-room/package.json; apps/bellona/control-room/playwright.config.ts; apps/bellona/control-room/project.json; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/config.ts; apps/bellona/control-room/src/main.tsx; apps/bellona/control-room/src/styles.css; apps/bellona/control-room/src/test/setup.ts; apps/bellona/control-room/tsconfig.json; apps/bellona/control-room/vite.config.ts; apps/bellona/control-room/vitest.config.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; pnpm-lock.yaml; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/README.md apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/index.html apps/bellona/control-room/package.json apps/bellona/control-room/playwright.config.ts apps/bellona/control-room/project.json apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/config.ts apps/bellona/control-room/src/main.tsx apps/bellona/control-room/src/styles.css apps/bellona/control-room/src/test/setup.ts apps/bellona/control-room/tsconfig.json apps/bellona/control-room/vite.config.ts apps/bellona/control-room/vitest.config.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this browser-only scaffold; no macOS, Blender, Unreal, WebRTC, host, gateway, or real-device flow is activated. Playwright covers default-disabled and opt-in route behavior. None for scaffold. Next item implements the device-list UI data surface without leaving the gated Control Room route exposed by default.
180.C.12.03 Implement device list UI showing paired devices, online state, active session state, adapter health, and missing permission placeholders. Codex Complete apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/package.json; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/device-list.test.ts; apps/bellona/control-room/src/device-list.ts; apps/bellona/control-room/src/styles.css; apps/bellona/control-room/tsconfig.json; apps/bellona/control-room/vite.config.ts; apps/bellona/control-room/vitest.config.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; pnpm-lock.yaml; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/package.json apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/device-list.test.ts apps/bellona/control-room/src/device-list.ts apps/bellona/control-room/src/styles.css apps/bellona/control-room/tsconfig.json apps/bellona/control-room/vite.config.ts apps/bellona/control-room/vitest.config.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this browser-only fixture-backed UI; no macOS, Blender, Unreal, WebRTC, host, gateway, or real-device flow is activated. Playwright covers the device-list behavior in the gated Control Room. None for device-list UI. Next item implements session timeline UI states while keeping the Control Room feature-gated by default.
180.C.12.04 Implement session timeline UI showing command queued, started, progress, completed, failed, denied, and approval-required states. Codex Complete apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/session-timeline.test.ts; apps/bellona/control-room/src/session-timeline.ts; apps/bellona/control-room/src/styles.css; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/session-timeline.test.ts apps/bellona/control-room/src/session-timeline.ts apps/bellona/control-room/src/styles.css docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this browser-only fixture-backed UI; no macOS, Blender, Unreal, WebRTC, host, gateway, or real-device flow is activated. Playwright covers the timeline behavior on the gated desktop and mobile Control Room projects. None for session timeline UI. Next item implements approval actions and policy explanation using the Stage 07 approval service while keeping the Control Room feature-gated by default.
180.C.12.05 Implement approval UI for approve once, deny, timeout, and policy explanation using the approval service from Stage 07. Codex Complete apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/approval-queue.test.ts; apps/bellona/control-room/src/approval-queue.ts; apps/bellona/control-room/src/styles.css; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/approval-queue.test.ts apps/bellona/control-room/src/approval-queue.ts apps/bellona/control-room/src/styles.css docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this browser-only fixture-backed UI; no macOS, Blender, Unreal, WebRTC, host, gateway, or real-device flow is activated. Playwright covers approval behavior on the gated desktop and mobile Control Room projects. None for approval UI. Next item implements stream descriptor and screenshot-only placeholder mode; wiring the UI to a public gateway approval-decision API remains a future integration once that route exists.
180.C.12.06 Implement stream descriptor flow and screenshot-only placeholder mode before full WebRTC media is ready. Codex Complete apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/stream-preview.test.ts; apps/bellona/control-room/src/stream-preview.ts; apps/bellona/control-room/src/styles.css; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/stream-preview.test.ts apps/bellona/control-room/src/stream-preview.ts apps/bellona/control-room/src/styles.css docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this browser-only fixture-backed UI; no macOS screen capture, Blender viewport media, Unreal viewport media, WebRTC peer connection, TURN relay, gateway stream endpoint, host, or real-device flow is activated. Playwright covers screenshot-only placeholder behavior on the gated desktop and mobile Control Room projects. None for stream descriptor placeholder UI. Next item implements the real WebRTC MVP for one source when repo tooling and hardware/network evidence are ready.
180.C.12.07 Implement WebRTC MVP for one source with start, stop, reconnect, stream health, and TURN/direct status if the repo tooling is ready. Codex Complete apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/stream-preview.test.ts; apps/bellona/control-room/src/stream-preview.ts; apps/bellona/control-room/src/styles.css; apps/bellona/control-room/src/webrtc-loopback.test.ts; apps/bellona/control-room/src/webrtc-loopback.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/stream-preview.test.ts apps/bellona/control-room/src/stream-preview.ts apps/bellona/control-room/src/styles.css apps/bellona/control-room/src/webrtc-loopback.test.ts apps/bellona/control-room/src/webrtc-loopback.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Chromium desktop and mobile Playwright exercised the browser-native RTCPeerConnection loopback: start negotiated offer/answer, opened the data channel, reported WebRTC active with data-channel RTT, showed direct path/TURN not required, reconnected once, and stopped. No live macOS capture, Blender viewport media, Unreal viewport media, TURN relay, gateway stream endpoint, host, or real-device media flow is activated. None for browser-loopback WebRTC MVP. Real gateway media, TURN relay validation, macOS/Blender/Unreal capture, and hardware evidence remain future integration work. Next unchecked Phase 180 item is 180.C.12.08, which consolidates Playwright coverage for the Control Room flows.
180.C.12.08 Add Playwright tests for device list, timeline states, approval states, stream placeholder, pause, and stop controls. Codex Complete apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/src/App.tsx; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/src/App.tsx docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Desktop and mobile Playwright opt-in projects assert both paired device rows, all required timeline states, pending/denied/timed-out approval rows plus approve/deny/timeout actions, and stream placeholder start/pause/resume/stop controls. No live macOS capture, Blender viewport media, Unreal viewport media, TURN relay, gateway stream endpoint, host, or real-device media flow is activated. None for Control Room Playwright coverage. Next unchecked Phase 180 item is 180.C.12.09, which documents the operator workflow for watching an agent run Blender and browser MVP commands.
180.C.12.09 Document operator workflow for watching an agent run the Blender and browser MVP commands. Codex Complete apps/bellona/control-room/README.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/operator-workflow-blender-browser-mvp.md; TODOS/phase-180.md pnpm exec prettier --check apps/bellona/control-room/README.md docs/domains/bellona/extras/remote-control/operator-workflow-blender-browser-mvp.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Documentation-only workflow signoff. This task did not activate live macOS capture, Blender viewport media, browser sessions, TURN relay, gateway stream endpoints, hosts, or real-device media. The workflow points operators to prior CLI smoke evidence and explicitly preserves the live UI subscription gap for 180.C.12.10. None for the operator workflow document. Next unchecked Phase 180 item is 180.C.12.10, which must prove that an operator can observe command progress and approve or deny in the UI, even if the stream stays screenshot-first.
180.C.12.10 Check off this stage only after an operator can observe command progress and approve/deny in a UI, even if stream is screenshot mode first. Codex Complete apps/bellona/control-room/README.md; apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/approval-queue.ts; apps/bellona/control-room/src/session-timeline.test.ts; apps/bellona/control-room/src/session-timeline.ts; apps/bellona/control-room/src/styles.css; apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.test.ts; apps/bellona/remote-gateway/src/app.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/operator-workflow-blender-browser-mvp.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/README.md apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/approval-queue.ts apps/bellona/control-room/src/session-timeline.test.ts apps/bellona/control-room/src/session-timeline.ts apps/bellona/control-room/src/styles.css apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.test.ts apps/bellona/remote-gateway/src/app.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/operator-workflow-blender-browser-mvp.md TODOS/phase-180.md; git diff --check Desktop and mobile Playwright exercise the combined Review workspace: command progress is visible, screenshot-first stream status stays in the same flow, approve appends a completed continuation event, and deny appends an operator-reason denied event. Gateway unit tests cover HTTP listing and decision recording. No live macOS capture, Blender viewport media, Unreal viewport media, TURN relay, host, or real-device media flow is activated. None for the UI-level observe/approve/deny checkpoint. Later stages still need live gateway-to-Control-Room subscription, hardware stream evidence, notification/mobile approval, and production release gates.
180.C.12.11 Implement operator first-run onboarding: Control Room empty states (no devices paired, no sessions), a guided pairing walkthrough from the operator side, permission-meaning tooltips explaining observe-only versus project write in plain language, and a "what do I do next?" step after first load. Codex Complete apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/styles.css; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/styles.css docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Desktop and mobile Playwright exercise the first-run guide in the enabled Control Room route, and Chromium desktop verifies the permission tooltips. Unit tests cover no-devices, no-session-timeline, and no-review-progress empty states. No live macOS capture, Blender viewport media, Unreal viewport media, TURN relay, host, gateway stream subscription, or real-device media flow is activated. None for first-run onboarding. Next unchecked Phase 180 item is 180.C.12.12, which implements keyboard shortcuts, conflict checks, and a visible shortcut map inside the Control Room.
180.C.12.12 Implement keyboard shortcuts for approve, deny, pause, resume, stop, and takeover with a documented shortcut map, a conflict check against browser defaults, and a visible cheat sheet inside the Control Room. Codex Complete apps/bellona/control-room/README.md; apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/styles.css; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/README.md apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/styles.css docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Desktop and mobile Playwright exercise the visible shortcut map, browser-default conflict checks, takeover, approve, deny, and stream pause/resume/stop shortcuts. Unit tests cover shortcut rendering, reducer routing, takeover state, and editable-field guard. No live macOS capture, Blender viewport media, Unreal viewport media, TURN relay, host, gateway stream subscription, OS notification, or real-device media flow is activated. None for keyboard shortcut MVP. Next unchecked Phase 180 item is 180.C.12.13, which implements desktop notifications and user preferences.
180.C.12.13 Implement operating-system desktop notifications (macOS Notification Center at MVP, cross-platform via 180.C.31.06) for approval-required, host-offline, long-running completion, and policy-denial events with per-event user preferences. Codex Complete apps/bellona/control-room/README.md; apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/styles.css; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/README.md apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/styles.css docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Desktop and mobile Playwright exercise notification preference UI and mocked Notification delivery for approval-required, host-offline, long-running completion, and policy-denial event classes. Unit tests cover permission request, delivery, muting, and localStorage persistence. No live macOS Notification Center prompt/delivery, APNs/FCM push, service worker push, native shell notification bridge, host, gateway stream subscription, Blender/Unreal media, or real-device notification flow is activated. Live macOS Notification Center hardware evidence remains required before production signoff; cross-platform/native/mobile push channels remain deferred to 180.C.31.06 and 180.C.34. Next unchecked Phase 180 item is 180.C.12.14, the mobile approval-only PWA.
180.C.12.14 Implement a mobile approval-only PWA (responsive UI, push-notification capable) so operators can approve or deny from a phone without waiting for the full mobile Control Room deferred to 180.C.30.09. Approvals are the highest-value mobile moment. Codex Complete apps/bellona/control-room/README.md; apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/index.html; apps/bellona/control-room/public/control-room-sw.js; apps/bellona/control-room/public/icons/mobile-approval.svg; apps/bellona/control-room/public/manifest.webmanifest; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/mobile-approval-pwa.ts; apps/bellona/control-room/src/styles.css; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/README.md apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/index.html apps/bellona/control-room/public/control-room-sw.js apps/bellona/control-room/public/manifest.webmanifest apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/mobile-approval-pwa.ts apps/bellona/control-room/src/styles.css docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Desktop and mobile Playwright exercise /mobile-approvals, manifest availability, service worker push script availability, mocked service-worker registration, mocked Notification permission, mocked approval alert delivery, notification-action denial, and mobile viewport fit. Unit tests cover mobile route rendering, service-worker registration, Notification permission request, approval alert preview, approve-once, and service-worker action denial. No live phone install, APNs/FCM delivery, VAPID/gateway push subscription, production push provider, native mobile shell, host, gateway stream subscription, Blender/Unreal media, or real-device notification flow is activated. Live real-device mobile install and live push-provider evidence remain required before production signoff; gateway VAPID subscription and production push delivery remain future work. Next unchecked Phase 180 item is 180.C.12.15, the operator command palette.
180.C.12.15 Implement an operator command palette for ad-hoc remote commands with audit capture, approval-required-by-default posture, and a searchable command registry drawn from the protocol namespaces. Codex Complete apps/bellona/control-room/README.md; apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/command-palette.test.ts; apps/bellona/control-room/src/command-palette.ts; apps/bellona/control-room/src/styles.css; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/README.md apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/command-palette.test.ts apps/bellona/control-room/src/command-palette.ts apps/bellona/control-room/src/styles.css docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Desktop and mobile Playwright exercise command palette search, protocol namespace command selection, payload editing, approval-required queueing, visible audit capture, approval workspace navigation, and existing stream/shortcut no-regression paths. Unit tests cover namespace coverage, search filtering, audit entry creation, UI command search, payload editing, approval queue navigation, and visible audit capture. No live host dispatch, gateway command enqueue API, real approval service request creation, macOS control, browser profile control, Blender/Unreal mutation, or real-device flow is activated. Live gateway command enqueue, real approval-service request creation, and host dispatch remain future integration work. Next unchecked Phase 180 item is 180.C.12.16, the first-session guided tour.
180.C.12.16 Implement a first-session guided tour walking through Blender read-only, browser navigate, and screenshot MVP flows so a new operator sees a success path within five minutes of opening the app. Codex Complete apps/bellona/control-room/README.md; apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/first-session-tour.test.ts; apps/bellona/control-room/src/first-session-tour.ts; apps/bellona/control-room/src/styles.css; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/README.md apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/first-session-tour.test.ts apps/bellona/control-room/src/first-session-tour.ts apps/bellona/control-room/src/styles.css docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Desktop and mobile Playwright exercise the full guided first-session path: blender.scene.query audit queueing, browser.navigate audit queueing, screenshot MVP activation, completion progress, approval workspace navigation, stream workspace navigation, and mobile viewport fit. Unit tests cover required checkpoint order, five-minute budget, persisted completion normalization, current-step calculation, and UI-driven path completion. No live Blender instance, browser automation backend, gateway command enqueue, approval-service dispatch, host stream transport, real screenshot capture, or hardware evidence is activated. Live host/gateway command enqueue, real browser automation, real Blender read-only state, and real screenshot artifacts remain future integration work. Next unchecked Phase 180 item is 180.C.13.01.
180.C.13.01 Implement macOS permission detection for Screen Recording and Accessibility and surface missing permission diagnostics to gateway and Control Room. Codex Complete apps/bellona/control-room/README.md; apps/bellona/control-room/e2e/control-room.spec.ts; apps/bellona/control-room/src/App.test.tsx; apps/bellona/control-room/src/App.tsx; apps/bellona/control-room/src/device-list.test.ts; apps/bellona/control-room/src/device-list.ts; apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.test.ts; apps/bellona/remote-gateway/src/app.ts; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/adapter-registry.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/app.ts; apps/bellona/remote-host/src/macos-permissions.test.ts; apps/bellona/remote-host/src/macos-permissions.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx run-many -p @bellona/remote-host,@bellona/remote-gateway,@bellona/control-room -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx e2e @bellona/control-room --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/control-room/README.md apps/bellona/control-room/e2e/control-room.spec.ts apps/bellona/control-room/src/App.test.tsx apps/bellona/control-room/src/App.tsx apps/bellona/control-room/src/device-list.test.ts apps/bellona/control-room/src/device-list.ts apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.test.ts apps/bellona/remote-gateway/src/app.ts apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/adapter-registry.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/app.ts apps/bellona/remote-host/src/macos-permissions.test.ts apps/bellona/remote-host/src/macos-permissions.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit/integration coverage uses injected macOS probes for Screen Recording and Accessibility, validates host device-report mutation, gateway device inventory exposure, and Control Room diagnostic rendering. Playwright validates the selected-device inspector text. No live signed/notarized macOS host, real TCC prompt, permission revocation, or System Settings remediation flow was exercised in hardware. Live TCC prompt/revocation evidence remains part of later macOS packaging and permission workflow tasks. Next unchecked Phase 180 item is 180.C.13.02.
180.C.13.02 Implement desktop.screenshot for selected display or selected app window with redaction hooks and artifact registration. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/adapter-registry.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/desktop-screenshot.test.ts; apps/bellona/remote-host/src/desktop-screenshot.ts; apps/bellona/remote-host/src/index.ts; libs/bellona/remote-protocol/src/fixtures.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx test @bellona/remote-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/command-dispatcher.test.ts apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/adapter-registry.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/desktop-screenshot.test.ts apps/bellona/remote-host/src/desktop-screenshot.ts apps/bellona/remote-host/src/index.ts libs/bellona/remote-protocol/src/fixtures.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage uses injected capture backends and generated PNG fixtures to validate selected display/window capture output, blackout-region redaction, artifact/evidence records, permission denial, non-macOS denial, and gateway artifact registration. No live TCC prompt, physical display capture, real app-window capture, or operator-approved desktop fallback session was exercised. Live macOS display/window hardware evidence remains blocked on later 180.C.13.03 window list/focus, 180.C.13.04 coordinate normalization, and final desktop fallback acceptance tasks. Next unchecked Phase 180 item is 180.C.13.03.
180.C.13.03 Implement desktop.window.list and desktop.window.focus with app name, title, bounds, display, and focus result. Codex Complete apps/bellona/remote-gateway/README.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/adapter-registry.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/desktop-screenshot.test.ts; apps/bellona/remote-host/src/desktop-screenshot.ts; apps/bellona/remote-host/src/desktop-window.test.ts; apps/bellona/remote-host/src/desktop-window.ts; apps/bellona/remote-host/src/index.ts; libs/bellona/remote-protocol/src/desktop.test.ts; libs/bellona/remote-protocol/src/desktop.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/policy.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose; node --input-type=module - <<'NODE' ...extract macDesktopWindowSwiftSource and execute list limit 1... NODE; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/adapter-registry.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/desktop-screenshot.test.ts apps/bellona/remote-host/src/desktop-screenshot.ts apps/bellona/remote-host/src/desktop-window.test.ts apps/bellona/remote-host/src/desktop-window.ts apps/bellona/remote-host/src/index.ts libs/bellona/remote-protocol/src/desktop.test.ts libs/bellona/remote-protocol/src/desktop.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/policy.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage uses injected macOS list/focus backends and protocol fixtures to validate app/title/bounds/display output, focus results, Screen Recording denial, Accessibility denial, non-macOS denial, adapter capability/handler wiring, registry counts, and host health counts. A native Swift sanity run on the current macOS workstation executed the list path and returned {"ok":true,"windowCount":1}. No live TCC prompt, real app activation, or AXRaise hardware focus operation was exercised. Live macOS focus hardware evidence remains blocked on MAC-HOST-01, later coordinate normalization (180.C.13.04), click dispatch (180.C.13.05), emergency stop (180.C.13.06), and desktop fallback acceptance (180.C.13.10).
180.C.13.04 Implement coordinate normalization for Retina scaling, window-relative coordinates, and stream/screenshot coordinates. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/desktop-coordinate.test.ts; apps/bellona/remote-host/src/desktop-coordinate.ts; apps/bellona/remote-host/src/desktop-window.ts; apps/bellona/remote-host/src/index.ts; libs/bellona/remote-protocol/src/desktop.test.ts; libs/bellona/remote-protocol/src/desktop.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/desktop-coordinate.test.ts apps/bellona/remote-host/src/desktop-coordinate.ts apps/bellona/remote-host/src/desktop-window.ts apps/bellona/remote-host/src/index.ts libs/bellona/remote-protocol/src/desktop.test.ts libs/bellona/remote-protocol/src/desktop.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates Retina display-pixel conversion, window-relative point/pixel conversion, screenshot-pixel conversion, stream-normalized conversion, clamping, and missing-context errors. No live desktop input, hardware click, after-screenshot visual verification, or end-to-end stream/screenshot coordinate replay was exercised. Live coordinate-to-click and coordinate-to-visual-verification evidence remains blocked on 180.C.13.05, 180.C.13.06, and desktop fallback acceptance in 180.C.13.10.
180.C.13.05 Implement desktop.click only for a focused, allowlisted app/window and only after desktop-control permission is granted. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/desktop-click.test.ts; apps/bellona/remote-host/src/desktop-click.ts; apps/bellona/remote-host/src/desktop-screenshot.test.ts; apps/bellona/remote-host/src/desktop-screenshot.ts; apps/bellona/remote-host/src/desktop-window.ts; apps/bellona/remote-host/src/index.ts; libs/bellona/remote-protocol/src/desktop.test.ts; libs/bellona/remote-protocol/src/desktop.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; node --input-type=module - <<'NODE' ...extract macDesktopClickSwiftSource and execute without BELLONA_DESKTOP_CLICK_REQUEST... NODE; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/desktop-click.test.ts apps/bellona/remote-host/src/desktop-click.ts apps/bellona/remote-host/src/desktop-screenshot.test.ts apps/bellona/remote-host/src/desktop-screenshot.ts apps/bellona/remote-host/src/desktop-window.ts apps/bellona/remote-host/src/index.ts libs/bellona/remote-protocol/src/desktop.test.ts libs/bellona/remote-protocol/src/desktop.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates protocol click schema defaults and metadata requirements, focused-window resolution, allowlist enforcement, missing focus denial, out-of-window coordinate denial, missing Accessibility denial, non-macOS denial, mocked click dispatch, adapter capability/handler wiring, registry counts, and host health counts. A native Swift compile-only sanity run returned {"error":"Missing BELLONA_DESKTOP_CLICK_REQUEST JSON.","ok":false} before input dispatch. No live hardware click, pointer movement, or after-click screenshot verification was exercised. Live hardware click and visual verification evidence remains blocked on 180.C.13.06 and desktop fallback acceptance in 180.C.13.10.
180.C.13.06 Implement visual verification after click using before/after screenshot artifact references. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/desktop-click.test.ts; apps/bellona/remote-host/src/desktop-click.ts; apps/bellona/remote-host/src/desktop-screenshot.ts; apps/bellona/remote-host/src/index.ts; libs/bellona/remote-protocol/src/desktop.test.ts; libs/bellona/remote-protocol/src/desktop.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/desktop-click.test.ts apps/bellona/remote-host/src/desktop-click.ts apps/bellona/remote-host/src/desktop-screenshot.ts apps/bellona/remote-host/src/index.ts libs/bellona/remote-protocol/src/desktop.test.ts libs/bellona/remote-protocol/src/desktop.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates protocol visual-verification defaults/result references and host before-screenshot, click, after-screenshot ordering with mocked screenshot artifacts/evidence ids. No live hardware click or real before/after screenshot pair was captured. Live hardware click and real visual verification evidence remains blocked on desktop fallback acceptance in 180.C.13.10.
180.C.13.07 Implement emergency stop that interrupts queued and running desktop fallback commands. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/adapter-registry.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/command-executor.test.ts; apps/bellona/remote-host/src/command-executor.ts; apps/bellona/remote-host/src/desktop-click.ts; apps/bellona/remote-host/src/desktop-emergency-stop.ts; apps/bellona/remote-host/src/desktop-screenshot.test.ts; apps/bellona/remote-host/src/desktop-screenshot.ts; apps/bellona/remote-host/src/index.ts; libs/bellona/remote-protocol/src/desktop.test.ts; libs/bellona/remote-protocol/src/desktop.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/adapter-registry.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/command-executor.test.ts apps/bellona/remote-host/src/command-executor.ts apps/bellona/remote-host/src/desktop-click.ts apps/bellona/remote-host/src/desktop-emergency-stop.ts apps/bellona/remote-host/src/desktop-screenshot.test.ts apps/bellona/remote-host/src/desktop-screenshot.ts apps/bellona/remote-host/src/index.ts libs/bellona/remote-protocol/src/desktop.test.ts libs/bellona/remote-protocol/src/desktop.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates protocol emergency-stop defaults/result/envelope, desktop adapter capability advertisement, host queue serialization, queued-command cancellation, running-command abort signaling, and emergency-stop output with queued/running command ids. No live macOS emergency stop was exercised against a real click or screenshot process. Live emergency-stop proof remains blocked on desktop fallback acceptance in 180.C.13.10.
180.C.13.08 Add tests for missing permission, denied window, coordinate normalization, screenshot artifact, click dispatch mock, and emergency stop. Codex Complete apps/bellona/remote-host/src/desktop-click.test.ts; apps/bellona/remote-host/src/desktop-screenshot.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/src/desktop-click.test.ts apps/bellona/remote-host/src/desktop-screenshot.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage now includes missing Screen Recording denial for desktop.click, missing Accessibility denial, denied/unfocused window, allowlist denial, out-of-window coordinate normalization denial, screenshot artifact/evidence output, mocked click dispatch, screenshot abort-signal forwarding, and emergency-stop abort before click dispatch. Existing command-executor.test.ts covers queued/running emergency stop cancellation. No live macOS permission prompt, click, screenshot process abort, or hardware emergency stop was exercised. Live desktop fallback acceptance remains blocked on 180.C.13.10.
180.C.13.09 Document when desktop fallback is allowed and when Blender/Unreal/browser adapters must be used instead. Codex Complete apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check apps/bellona/remote-host/README.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; git diff --check Documentation-only policy update. Existing implementation and ADRs were reviewed; no live macOS desktop fallback, Blender, Unreal, or browser hardware behavior was exercised. Live desktop fallback acceptance remains blocked on 180.C.13.10.
180.C.13.10 Check off this stage only after a remote agent/CLI can focus an allowed window, screenshot it, click a known target, verify, and audit the result. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/project.json; apps/bellona/remote-host/scripts/desktop-fallback-remote-smoke.ts; apps/bellona/remote-host/src/desktop-click.test.ts; apps/bellona/remote-host/src/desktop-click.ts; apps/bellona/remote-host/src/desktop-screenshot.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx desktop:fallback-remote-smoke @bellona/remote-host --verbose --skip-nx-cache; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/project.json apps/bellona/remote-host/scripts/desktop-fallback-remote-smoke.ts apps/bellona/remote-host/src/desktop-click.test.ts apps/bellona/remote-host/src/desktop-click.ts apps/bellona/remote-host/src/desktop-screenshot.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Deterministic remote CLI smoke proved focus, screenshot, approved click, before/after visual-verification references, screenshot artifact registration, audit entries, and timeline events through the real gateway-host path. The current Mac reports missing Screen Recording and Accessibility, so no native --live-macos pointer movement or real screenshot was claimed here. None for the deterministic desktop fallback CLI closure. Native hardware replay remains available with pnpm nx desktop:fallback-remote-smoke @bellona/remote-host -- --live-macos after MAC-HOST-01 has Screen Recording and Accessibility grants.
180.C.13.11 Implement a desktop compensating-action framework. Desktop clicks, drags, and key events have no native undo, so each mutating desktop command declares a documented reversal recipe (click-back, key-undo, explicit remediation) populated into RollbackStrategy metadata from 180.C.03.14. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/scripts/desktop-fallback-remote-smoke.ts; apps/bellona/remote-host/src/command-executor.test.ts; apps/bellona/remote-host/src/desktop-click.test.ts; apps/bellona/remote-host/src/desktop-click.ts; apps/bellona/remote-host/src/desktop-emergency-stop.ts; apps/bellona/remote-host/src/desktop-window.test.ts; apps/bellona/remote-host/src/desktop-window.ts; docs/domains/bellona/extras/remote-control/desktop-compensating-actions.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/**; libs/bellona/remote-protocol/src/command.ts; libs/bellona/remote-protocol/src/desktop-compensating-actions.ts; libs/bellona/remote-protocol/src/desktop.test.ts; libs/bellona/remote-protocol/src/desktop.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose; pnpm nx contracts:generate @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx contracts:check @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx desktop:fallback-remote-smoke @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/scripts/desktop-fallback-remote-smoke.ts apps/bellona/remote-host/src/command-executor.test.ts apps/bellona/remote-host/src/desktop-click.test.ts apps/bellona/remote-host/src/desktop-click.ts apps/bellona/remote-host/src/desktop-emergency-stop.ts apps/bellona/remote-host/src/desktop-window.test.ts apps/bellona/remote-host/src/desktop-window.ts libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/command.ts libs/bellona/remote-protocol/src/desktop-compensating-actions.ts libs/bellona/remote-protocol/src/desktop.test.ts libs/bellona/remote-protocol/src/desktop.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts docs/domains/bellona/extras/remote-control/desktop-compensating-actions.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Local protocol and host tests validate the desktop catalog, schema enforcement for required/mismatched compensating_action_id, command metadata propagation, host capability metadata, and deterministic smoke command envelope compatibility. No live macOS rollback/remediation action was attempted; desktop fallback mutations remain manual-remediation-only unless a future command declares a truthful compensating action. None for current desktop compensating-action metadata and enforcement. Future drag, key, and type commands must add catalog entries before becoming routable.
180.C.13.12 Implement keyboard-layout-aware desktop.type: detect active layout (QWERTY, AZERTY, Dvorak, Colemak, ISO versus ANSI), handle IME/composition, and emit scancodes or Unicode matching the target system's active layout rather than assuming US QWERTY. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/desktop-screenshot.test.ts; apps/bellona/remote-host/src/desktop-screenshot.ts; apps/bellona/remote-host/src/desktop-type.test.ts; apps/bellona/remote-host/src/desktop-type.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/desktop-compensating-actions.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/**; libs/bellona/remote-protocol/src/desktop-compensating-actions.ts; libs/bellona/remote-protocol/src/desktop.test.ts; libs/bellona/remote-protocol/src/desktop.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose; pnpm nx contracts:generate @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx contracts:check @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx desktop:fallback-remote-smoke @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; env -u BELLONA_DESKTOP_TYPE_REQUEST node - <<'NODE' ... NODE; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/desktop-screenshot.test.ts apps/bellona/remote-host/src/desktop-screenshot.ts apps/bellona/remote-host/src/desktop-type.test.ts apps/bellona/remote-host/src/desktop-type.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/desktop-compensating-actions.md docs/domains/bellona/extras/remote-control/implementation-tracker.md libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/desktop-compensating-actions.ts libs/bellona/remote-protocol/src/desktop.test.ts libs/bellona/remote-protocol/src/desktop.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts TODOS/phase-180.md; git diff --check Unit coverage validates protocol schema acceptance/rejection, compensating-action enforcement, host permission denial, focused allowlisted-window gating, layout-aware backend result handling, and adapter registration. Swift compile sanity validates the native macOS backend source without dispatching text. No live macOS typing was performed because the current Mac lacks the required Accessibility and Screen Recording grants recorded in prior desktop fallback closure. None for schema, adapter, and native backend implementation. Live hardware typing remains available only after MAC-HOST-01 has Screen Recording and Accessibility grants and a focused allowlisted target window.
180.C.13.13 Implement multi-display targeting with stable display identities (not just primary/secondary) so a command targeting "the Blender reference display" still works after the operator rearranges displays between sessions. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/desktop-display.test.ts; apps/bellona/remote-host/src/desktop-display.ts; apps/bellona/remote-host/src/desktop-screenshot.test.ts; apps/bellona/remote-host/src/desktop-screenshot.ts; apps/bellona/remote-host/src/desktop-window.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/**; libs/bellona/remote-protocol/src/desktop.test.ts; libs/bellona/remote-protocol/src/desktop.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; TODOS/phase-180.md pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose; pnpm nx contracts:generate @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx contracts:check @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx desktop:fallback-remote-smoke @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; env -u BELLONA_DESKTOP_DISPLAY_REQUEST node - <<'NODE' ... NODE; env -u BELLONA_DESKTOP_WINDOW_REQUEST node - <<'NODE' ... NODE; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/desktop-display.test.ts apps/bellona/remote-host/src/desktop-display.ts apps/bellona/remote-host/src/desktop-screenshot.test.ts apps/bellona/remote-host/src/desktop-screenshot.ts apps/bellona/remote-host/src/desktop-window.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/desktop.test.ts libs/bellona/remote-protocol/src/desktop.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts TODOS/phase-180.md; git diff --check Unit coverage validates display-list protocol schemas, host display-list output, Screen Recording denial, stable selector resolution, screenshot stable selector resolution to current display index, adapter registration, and registry/app capability counts. Native Swift compile sanity validates the display-list and updated window-list helper sources without live capture. No live physical multi-display capture/rearrangement was exercised because current desktop fallback hardware permissions remain unavailable. None for stable display schemas and selector resolution. Live proof that rearranging physical displays preserves a saved stableId target remains available after MAC-HOST-01 has Screen Recording permission and a multi-display rig.
180.C.13.14 Implement a desktop.clipboard.capture command with redaction hooks so operators can copy error text visible on screen into session notes without agents inventing fake OCR content. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/desktop-clipboard.test.ts; apps/bellona/remote-host/src/desktop-clipboard.ts; apps/bellona/remote-host/src/desktop-screenshot.test.ts; apps/bellona/remote-host/src/desktop-screenshot.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/**; libs/bellona/remote-protocol/src/desktop.test.ts; libs/bellona/remote-protocol/src/desktop.ts; libs/bellona/remote-protocol/src/device.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; TODOS/phase-180.md pnpm nx typecheck @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx contracts:generate @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx contracts:check @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx desktop:fallback-remote-smoke @bellona/remote-host --verbose --skip-nx-cache; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; env -u BELLONA_DESKTOP_CLIPBOARD_REQUEST node - <<'NODE' ... NODE; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/desktop-clipboard.test.ts apps/bellona/remote-host/src/desktop-clipboard.ts apps/bellona/remote-host/src/desktop-screenshot.test.ts apps/bellona/remote-host/src/desktop-screenshot.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/desktop.test.ts libs/bellona/remote-protocol/src/desktop.ts libs/bellona/remote-protocol/src/device.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts TODOS/phase-180.md; git diff --check Unit coverage validates clipboard command schemas, redaction-pattern validation, host NSPasteboard backend injection, builtin and custom redaction hooks, redacted artifact/evidence output, inline redacted-text suppression, unsupported platform denial, empty clipboard denial, byte-limit denial, adapter registration, and registry/app capability counts. Native Swift compile sanity validates the NSPasteboard helper source without reading the live clipboard. No live clipboard capture was exercised because hardware-gated desktop fallback evidence remains unavailable. None for schema, host command handling, redaction, and audit artifact wiring. Live proof requires an operator to copy visible screen text on MAC-HOST-01 and run desktop.clipboard.capture after the desktop fallback hardware permissions are available.
180.C.14.01 Scaffold libs/bellona/mcp-gateway with local stdio MCP server support and test target. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/package.json; libs/bellona/mcp-gateway/project.json; libs/bellona/mcp-gateway/src/index.ts; libs/bellona/mcp-gateway/src/stdio-cli.ts; libs/bellona/mcp-gateway/src/stdio-server.test.ts; libs/bellona/mcp-gateway/src/stdio-server.ts; libs/bellona/mcp-gateway/tsconfig.json; libs/bellona/mcp-gateway/tsconfig.lib.json; libs/bellona/mcp-gateway/tsconfig.spec.json; libs/bellona/mcp-gateway/vitest.config.ts; pnpm-lock.yaml; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx lint @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx test @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx build @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/package.json libs/bellona/mcp-gateway/project.json libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/stdio-cli.ts libs/bellona/mcp-gateway/src/stdio-server.test.ts libs/bellona/mcp-gateway/src/stdio-server.ts libs/bellona/mcp-gateway/tsconfig.json libs/bellona/mcp-gateway/tsconfig.lib.json libs/bellona/mcp-gateway/tsconfig.spec.json libs/bellona/mcp-gateway/vitest.config.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Not applicable for this local stdio scaffold; unit coverage validates MCP initialization over linked in-memory transports and stdio listener lifecycle with injected streams. No remote MacBook, cloud client, gateway session, or hardware desktop flow was exercised. 180.C.14.02 must register gateway-backed MCP tools; 180.C.14.03 through 180.C.14.05 must add resources, auth/session binding, and policy-bypass tests before MCP can drive privileged remote-control paths.
180.C.14.02 Expose MCP tools for device.list, session.start, session.stop, blender.scene.info, blender.object.create_primitive, browser.navigate, browser.snapshot, and desktop.screenshot. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/package.json; libs/bellona/mcp-gateway/src/index.ts; libs/bellona/mcp-gateway/src/remote-control-tools.test.ts; libs/bellona/mcp-gateway/src/remote-control-tools.ts; libs/bellona/mcp-gateway/src/stdio-server.ts; libs/bellona/mcp-gateway/vitest.config.ts; pnpm-lock.yaml; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx test @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx lint @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx build @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/package.json libs/bellona/mcp-gateway/project.json libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/remote-control-tools.test.ts libs/bellona/mcp-gateway/src/remote-control-tools.ts libs/bellona/mcp-gateway/src/stdio-cli.ts libs/bellona/mcp-gateway/src/stdio-server.test.ts libs/bellona/mcp-gateway/src/stdio-server.ts libs/bellona/mcp-gateway/tsconfig.json libs/bellona/mcp-gateway/tsconfig.lib.json libs/bellona/mcp-gateway/tsconfig.spec.json libs/bellona/mcp-gateway/vitest.config.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates MCP SDK tool registration, annotations, structured outputs, default MCP agent participant creation, session lifecycle calls, and protocol-valid command envelopes for all required gateway-backed command tools. No live MCP client drove a real remote MacBook host, Blender, browser, or desktop screenshot path. 180.C.14.03 must add MCP resources for active device capabilities, active session timeline, recent artifacts, and last command result. 180.C.14.04 and 180.C.14.05 must add auth/session binding and policy-bypass tests before remote/cloud MCP clients can be trusted.
180.C.14.03 Add MCP resources for active device capabilities, active session timeline, recent artifacts, and last command result. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/index.ts; libs/bellona/mcp-gateway/src/remote-control-resources.test.ts; libs/bellona/mcp-gateway/src/remote-control-resources.ts; libs/bellona/mcp-gateway/src/stdio-server.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx test @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/package.json libs/bellona/mcp-gateway/project.json libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/remote-control-resources.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.ts libs/bellona/mcp-gateway/src/remote-control-tools.test.ts libs/bellona/mcp-gateway/src/remote-control-tools.ts libs/bellona/mcp-gateway/src/stdio-cli.ts libs/bellona/mcp-gateway/src/stdio-server.test.ts libs/bellona/mcp-gateway/src/stdio-server.ts libs/bellona/mcp-gateway/tsconfig.json libs/bellona/mcp-gateway/tsconfig.lib.json libs/bellona/mcp-gateway/tsconfig.spec.json libs/bellona/mcp-gateway/vitest.config.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates MCP SDK resource registration/listing, JSON resource reads, active-device capability filtering, active-session timeline delegation, recent artifact filtering/sorting, and last command result selection. No live MCP client read resources from a real cloud gateway, MacBook host, Blender session, browser session, or desktop artifact stream. 180.C.14.04 must add MCP auth/session binding for remote/cloud clients. 180.C.14.05 must prove MCP tools and resources cannot bypass policy, approval, device revocation, or command schemas.
180.C.14.04 Add MCP auth/session binding for remote/cloud clients through the gateway. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/auth-session.test.ts; libs/bellona/mcp-gateway/src/auth-session.ts; libs/bellona/mcp-gateway/src/index.ts; libs/bellona/mcp-gateway/src/remote-control-resources.ts; libs/bellona/mcp-gateway/src/remote-control-tools.test.ts; libs/bellona/mcp-gateway/src/remote-control-tools.ts; libs/bellona/mcp-gateway/src/stdio-server.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx test @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/package.json libs/bellona/mcp-gateway/project.json libs/bellona/mcp-gateway/src/auth-session.test.ts libs/bellona/mcp-gateway/src/auth-session.ts libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/remote-control-resources.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.ts libs/bellona/mcp-gateway/src/remote-control-tools.test.ts libs/bellona/mcp-gateway/src/remote-control-tools.ts libs/bellona/mcp-gateway/src/stdio-cli.ts libs/bellona/mcp-gateway/src/stdio-server.test.ts libs/bellona/mcp-gateway/src/stdio-server.ts libs/bellona/mcp-gateway/tsconfig.json libs/bellona/mcp-gateway/tsconfig.lib.json libs/bellona/mcp-gateway/tsconfig.spec.json libs/bellona/mcp-gateway/vitest.config.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates SDK authInfo mapping, resource-audience checks, expiry checks, scope checks, gateway-delegated client/session binding, session allow-list enforcement, authenticated client/participant override behavior, and required-auth MCP tool failure. No live HTTP/cloud MCP transport or external identity provider was exercised. 180.C.14.05 must add explicit bypass tests for policy, approval, device revocation, and command schemas before MCP tools are trusted for remote/cloud operation.
180.C.14.05 Add tests proving MCP tools cannot bypass policy, approval, device revocation, or command schemas. Codex Complete libs/bellona/mcp-gateway/src/remote-control-bypass.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx test @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/package.json libs/bellona/mcp-gateway/project.json libs/bellona/mcp-gateway/src/auth-session.test.ts libs/bellona/mcp-gateway/src/auth-session.ts libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/remote-control-bypass.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.ts libs/bellona/mcp-gateway/src/remote-control-tools.test.ts libs/bellona/mcp-gateway/src/remote-control-tools.ts libs/bellona/mcp-gateway/src/stdio-cli.ts libs/bellona/mcp-gateway/src/stdio-server.test.ts libs/bellona/mcp-gateway/src/stdio-server.ts libs/bellona/mcp-gateway/tsconfig.json libs/bellona/mcp-gateway/tsconfig.lib.json libs/bellona/mcp-gateway/tsconfig.spec.json libs/bellona/mcp-gateway/vitest.config.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates MCP cannot dispatch schema-invalid command input, cannot convert gateway policy.denied into success, cannot bypass approval-required gateway errors, and cannot route commands to a blocked/revoked device after observing it through device.list. No live gateway policy engine, approval queue, revocation service, remote MacBook host, or cloud MCP transport was exercised. 180.C.14.06 must document or deploy a local cloud-agent simulation where an agent connects through the gateway rather than direct LAN.
180.C.14.06 Deploy or document a local cloud-agent simulation where an agent process connects through the gateway rather than direct LAN. Codex Complete docs/domains/bellona/extras/remote-control/local-cloud-agent-simulation.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/local-cloud-agent-simulation.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Documentation-only local simulation procedure. No live cloud agent, Remote Gateway HTTP deployment, remote MacBook host, Blender, browser, or desktop adapter was run. The documented first-stage proof references existing MCP gateway unit coverage and the local stdio target until Streamable HTTP/cloud transports are added. 180.C.14.07 and 180.C.14.08 must add Hetzner/AWS reference deployment notes; 180.C.14.09 must run the cloud-agent MVP smoke flow through the deployed gateway path.
180.C.14.07 Add Hetzner reference deployment notes for gateway, TLS, TURN placeholder, environment variables, logs, and smoke test. Codex Complete docs/domains/bellona/extras/remote-control/hetzner-reference-deployment.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/hetzner-reference-deployment.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Documentation-only Hetzner reference deployment notes. No live Hetzner VM, public DNS, Caddy TLS issuance, Remote Host WebSocket handshake, TURN relay, cloud MCP HTTP transport, remote MacBook host, Blender, browser, or desktop adapter was run. The documented smoke covers the expected gateway edge checks once a Hetzner server exists. 180.C.14.08 must add AWS reference deployment notes; 180.C.14.09 must run the cloud-agent MVP smoke flow through the deployed gateway path before this stage claims live cross-network agent control.
180.C.14.08 Add AWS reference deployment notes for gateway, TLS, storage, Redis/Postgres, logs, and smoke test. Codex Complete docs/domains/bellona/extras/remote-control/aws-reference-deployment.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/aws-reference-deployment.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Documentation-only AWS reference deployment notes. No live AWS account, ACM certificate, ALB, EC2 instance, CloudWatch log group, S3 bucket, RDS/Postgres instance, ElastiCache/Redis cache, remote MacBook host, Blender, browser, desktop adapter, or cloud MCP HTTP transport was run. The documented smoke covers the expected AWS gateway edge checks once AWS infrastructure exists. 180.C.14.09 must run the cloud-agent MVP smoke flow through the deployed gateway path before this stage claims live AWS cross-network agent control.
180.C.14.09 Run the cloud-agent MVP smoke flow: list device, start session, query Blender, navigate browser, capture screenshot, stop session. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/package.json; libs/bellona/mcp-gateway/project.json; libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.test.ts; libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx test @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx cloud-agent:mvp-smoke @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/package.json libs/bellona/mcp-gateway/project.json libs/bellona/mcp-gateway/src/auth-session.test.ts libs/bellona/mcp-gateway/src/auth-session.ts libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.test.ts libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.ts libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/remote-control-bypass.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.ts libs/bellona/mcp-gateway/src/remote-control-tools.test.ts libs/bellona/mcp-gateway/src/remote-control-tools.ts libs/bellona/mcp-gateway/src/stdio-cli.ts libs/bellona/mcp-gateway/src/stdio-server.test.ts libs/bellona/mcp-gateway/src/stdio-server.ts libs/bellona/mcp-gateway/tsconfig.json libs/bellona/mcp-gateway/tsconfig.lib.json libs/bellona/mcp-gateway/tsconfig.spec.json libs/bellona/mcp-gateway/vitest.config.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Automated smoke evidence validates the required cloud-agent MVP sequence through an authenticated MCP client and structural Remote Gateway boundary with no direct LAN access. The smoke reports liveDeploymentExercised: false, so no live Hetzner/AWS gateway, public DNS, Remote Host WebSocket, remote MacBook, Blender, browser, or desktop adapter was exercised. 180.C.14.10 must implement the agent tool-selection policy before broader agent planning can choose among domain APIs, adapters, browser agents, desktop fallback, and human handoff.
180.C.14.10 Implement an agent tool-selection policy that prefers domain APIs, then Blender/Unreal/browser adapters, then high-level browser agents, then desktop fallback, then human handoff. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/agent-tool-selection-policy.test.ts; libs/bellona/mcp-gateway/src/agent-tool-selection-policy.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/agent-tool-selection-policy.test.ts --reporter=verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/package.json libs/bellona/mcp-gateway/project.json libs/bellona/mcp-gateway/src/agent-tool-selection-policy.test.ts libs/bellona/mcp-gateway/src/agent-tool-selection-policy.ts libs/bellona/mcp-gateway/src/auth-session.test.ts libs/bellona/mcp-gateway/src/auth-session.ts libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.test.ts libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.ts libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/remote-control-bypass.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.ts libs/bellona/mcp-gateway/src/remote-control-tools.test.ts libs/bellona/mcp-gateway/src/remote-control-tools.ts libs/bellona/mcp-gateway/src/stdio-cli.ts libs/bellona/mcp-gateway/src/stdio-server.test.ts libs/bellona/mcp-gateway/src/stdio-server.ts libs/bellona/mcp-gateway/tsconfig.json libs/bellona/mcp-gateway/tsconfig.lib.json libs/bellona/mcp-gateway/tsconfig.spec.json libs/bellona/mcp-gateway/vitest.config.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates deterministic ranking and fallback behavior for domain APIs, Blender/browser adapters, high-level browser agents, desktop fallback rejection, human handoff, and conversion from advertised RemoteDevice capabilities. No live planner, cloud model, browser agent, desktop helper, or remote MacBook host was exercised. 180.C.14.11 must add preflight checks for online state, permissions, app availability, project-root grants, stream availability, budget limits, and approval requirements before tool selection can dispatch real remote work.
180.C.14.11 Implement agent preflight checks for device online state, permissions, app availability, project root grants, stream availability, budget limits, and approval requirements before any remote task starts. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/agent-preflight-checks.test.ts; libs/bellona/mcp-gateway/src/agent-preflight-checks.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/agent-preflight-checks.test.ts --reporter=verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/package.json libs/bellona/mcp-gateway/project.json libs/bellona/mcp-gateway/src/agent-preflight-checks.test.ts libs/bellona/mcp-gateway/src/agent-preflight-checks.ts libs/bellona/mcp-gateway/src/agent-tool-selection-policy.test.ts libs/bellona/mcp-gateway/src/agent-tool-selection-policy.ts libs/bellona/mcp-gateway/src/auth-session.test.ts libs/bellona/mcp-gateway/src/auth-session.ts libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.test.ts libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.ts libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/remote-control-bypass.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.ts libs/bellona/mcp-gateway/src/remote-control-tools.test.ts libs/bellona/mcp-gateway/src/remote-control-tools.ts libs/bellona/mcp-gateway/src/stdio-cli.ts libs/bellona/mcp-gateway/src/stdio-server.test.ts libs/bellona/mcp-gateway/src/stdio-server.ts libs/bellona/mcp-gateway/tsconfig.json libs/bellona/mcp-gateway/tsconfig.lib.json libs/bellona/mcp-gateway/tsconfig.spec.json libs/bellona/mcp-gateway/vitest.config.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates the all-clear path, offline device blocking, approval-required permission detection, unavailable approval blocking, granted approval passing, unavailable adapter blocking, project-root grant enforcement, inactive stream blocking, and exceeded budget blocking. No live cloud model, gateway deployment, remote MacBook host, Blender, browser, desktop helper, WebRTC media stream, or approval service was exercised. 180.C.14.12 must add long-running job handling before agents can safely manage renders, builds, file transfers, and imports across polling, cancellation, checkpointing, resume, and timeout escalation.
180.C.14.12 Implement long-running job handling for agents: progress polling, cancellation, checkpointing, resume, and timeout escalation for renders, builds, file transfers, and imports. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/agent-long-running-jobs.test.ts; libs/bellona/mcp-gateway/src/agent-long-running-jobs.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/agent-long-running-jobs.test.ts --reporter=verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/package.json libs/bellona/mcp-gateway/project.json libs/bellona/mcp-gateway/src/agent-long-running-jobs.test.ts libs/bellona/mcp-gateway/src/agent-long-running-jobs.ts libs/bellona/mcp-gateway/src/agent-preflight-checks.test.ts libs/bellona/mcp-gateway/src/agent-preflight-checks.ts libs/bellona/mcp-gateway/src/agent-tool-selection-policy.test.ts libs/bellona/mcp-gateway/src/agent-tool-selection-policy.ts libs/bellona/mcp-gateway/src/auth-session.test.ts libs/bellona/mcp-gateway/src/auth-session.ts libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.test.ts libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.ts libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/remote-control-bypass.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.ts libs/bellona/mcp-gateway/src/remote-control-tools.test.ts libs/bellona/mcp-gateway/src/remote-control-tools.ts libs/bellona/mcp-gateway/src/stdio-cli.ts libs/bellona/mcp-gateway/src/stdio-server.test.ts libs/bellona/mcp-gateway/src/stdio-server.ts libs/bellona/mcp-gateway/tsconfig.json libs/bellona/mcp-gateway/tsconfig.lib.json libs/bellona/mcp-gateway/tsconfig.spec.json libs/bellona/mcp-gateway/vitest.config.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates polling due/wait behavior, progress checkpointing, file-transfer cancellation, resume planning from the latest checkpoint, and timeout escalation through warning, cancellation, human handoff, and hard timeout. No live render engine, Unreal build, file-transfer adapter, import pipeline, remote MacBook host, or cloud model was exercised. 180.C.14.13 must add visual verification policy before agents can claim high-impact edit completion without before/after evidence or an explicit impossible-evidence reason.
180.C.14.13 Implement visual verification policy after high-impact edits, requiring before/after evidence or a documented reason evidence is impossible. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/agent-visual-verification-policy.test.ts; libs/bellona/mcp-gateway/src/agent-visual-verification-policy.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/agent-visual-verification-policy.test.ts --reporter=verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/package.json libs/bellona/mcp-gateway/project.json libs/bellona/mcp-gateway/src/agent-long-running-jobs.test.ts libs/bellona/mcp-gateway/src/agent-long-running-jobs.ts libs/bellona/mcp-gateway/src/agent-preflight-checks.test.ts libs/bellona/mcp-gateway/src/agent-preflight-checks.ts libs/bellona/mcp-gateway/src/agent-tool-selection-policy.test.ts libs/bellona/mcp-gateway/src/agent-tool-selection-policy.ts libs/bellona/mcp-gateway/src/agent-visual-verification-policy.test.ts libs/bellona/mcp-gateway/src/agent-visual-verification-policy.ts libs/bellona/mcp-gateway/src/auth-session.test.ts libs/bellona/mcp-gateway/src/auth-session.ts libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.test.ts libs/bellona/mcp-gateway/src/cloud-agent-mvp-smoke.ts libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/remote-control-bypass.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.ts libs/bellona/mcp-gateway/src/remote-control-tools.test.ts libs/bellona/mcp-gateway/src/remote-control-tools.ts libs/bellona/mcp-gateway/src/stdio-cli.ts libs/bellona/mcp-gateway/src/stdio-server.test.ts libs/bellona/mcp-gateway/src/stdio-server.ts libs/bellona/mcp-gateway/tsconfig.json libs/bellona/mcp-gateway/tsconfig.lib.json libs/bellona/mcp-gateway/tsconfig.spec.json libs/bellona/mcp-gateway/vitest.config.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates high-impact evidence pass, missing after-evidence block, documented impossible-evidence pass, low-impact read-only bypass, failed-redaction block, and high-impact command inference. No live screenshot, render, video capture, Blender viewport, Unreal viewport, browser page, desktop helper, or remote MacBook host was exercised. 180.C.14.14 must add dry-run plans and human-readable impact summaries before risky Blender, Unreal, browser, desktop, file, or shell actions can proceed.
180.C.14.14 Implement dry-run plan and human-readable impact summary generation before risky Blender, Unreal, browser, desktop, file, or shell actions. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.test.ts; libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/agent-dry-run-impact-summary.test.ts --reporter=verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.test.ts libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.ts libs/bellona/mcp-gateway/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates protocol-valid Blender dry-run generation, shell approval and command-summary blocking, approved shell planning, browser financial safeguards, desktop fallback remediation, file-write snapshot planning, read-only bypass, and unsupported dry-run blocking. No live Blender, Unreal, browser, desktop helper, shell command, file mutation, remote MacBook host, or cloud model was exercised. 180.C.14.15 must add multi-agent locking before concurrent agents can mutate the same Blender file, Unreal map, browser profile, project root, command queue, or approval request safely.
180.C.14.15 Implement multi-agent locking so two agents cannot concurrently mutate the same Blender file, Unreal map, browser profile, project root, command queue, or approval request. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/agent-mutation-locking.test.ts; libs/bellona/mcp-gateway/src/agent-mutation-locking.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/agent-mutation-locking.test.ts --reporter=verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/src/agent-mutation-locking.test.ts libs/bellona/mcp-gateway/src/agent-mutation-locking.ts libs/bellona/mcp-gateway/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates Blender file conflicts, project-root overlap across resource kinds, browser profile conflicts, command queue conflicts, approval request conflicts, same-owner refresh, owner-scoped release, expired lease pruning, read-only bypass, and direct resource inference. No live Blender, Unreal, browser profile, desktop helper, command queue backend, approval service backend, Redis, SQL, remote MacBook host, or cloud model was exercised. 180.C.14.16 must add explicit agent handoff paths between cloud, local, browser, Blender, Unreal, desktop fallback, and human operator roles.
180.C.14.16 Implement agent handoff paths between cloud model, local model, browser specialist, Blender specialist, Unreal specialist, desktop fallback specialist, and human operator. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/agent-handoff-paths.test.ts; libs/bellona/mcp-gateway/src/agent-handoff-paths.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/agent-handoff-paths.test.ts --reporter=verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/src/agent-handoff-paths.test.ts libs/bellona/mcp-gateway/src/agent-handoff-paths.ts libs/bellona/mcp-gateway/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates cloud-to-browser, local-to-Blender, specialist-to-Unreal, approval-required human handoff, low-confidence human handoff, disabled desktop fallback human routing, unavailable-role blocking, already-specialized stay behavior, and actor descriptor overrides. No live cloud model, local model runtime, browser specialist, Blender specialist, Unreal specialist, desktop fallback helper, human operator UI, remote MacBook host, or gateway deployment was exercised. 180.C.14.17 must add capability memory so agents stop repeatedly probing unchanged remote hosts.
180.C.14.17 Implement capability memory so agents remember stable device/app capability results and stop repeatedly probing unchanged remote hosts. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/agent-capability-memory.test.ts; libs/bellona/mcp-gateway/src/agent-capability-memory.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/agent-capability-memory.test.ts --reporter=verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/src/agent-capability-memory.test.ts libs/bellona/mcp-gateway/src/agent-capability-memory.ts libs/bellona/mcp-gateway/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates device snapshot memory, stable repeat observations, fingerprint-change probing, near-expiry background refresh, expiry probing, forced probes, invalidation, and stable key generation. No live remote host, Blender, Unreal, browser, desktop helper, gateway deployment, Redis cache, or cloud model was exercised. 180.C.14.18 must add autonomous stop criteria for task completion, denied approval, policy blocks, repeated failure, host busy, stream loss, low confidence, and budget exhaustion.
180.C.14.18 Implement autonomous stop criteria: task done, approval denied, policy blocked, repeated failure, host busy too long, stream lost, low confidence, or budget exceeded. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/agent-autonomous-stop-criteria.test.ts; libs/bellona/mcp-gateway/src/agent-autonomous-stop-criteria.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/agent-autonomous-stop-criteria.test.ts --reporter=verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/src/agent-autonomous-stop-criteria.test.ts libs/bellona/mcp-gateway/src/agent-autonomous-stop-criteria.ts libs/bellona/mcp-gateway/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates continue behavior, task-done success, approval-denied priority over completion claims, policy blocks, repeated failure windows, host busy timeout, ended and silent required streams, low confidence, and spent/projected budget overruns. No live remote host, Blender, Unreal, browser, WebRTC stream, desktop helper, gateway deployment, approval service backend, budget ledger, or cloud model was exercised. 180.C.14.19 must add evaluation tasks comparing deep-integration agents against Computer Use-only baselines for Blender, browser, desktop, and Unreal workflows.
180.C.14.19 Add evaluation tasks comparing deep-integration agents against Computer Use-only baselines for Blender, browser, desktop, and Unreal workflows. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/package.json; libs/bellona/mcp-gateway/project.json; libs/bellona/mcp-gateway/src/agent-deep-integration-evals.test.ts; libs/bellona/mcp-gateway/src/agent-deep-integration-evals.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/agent-deep-integration-evals.test.ts --reporter=verbose; pnpm nx agent:deep-integration-evals @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke,agent:deep-integration-evals --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/package.json libs/bellona/mcp-gateway/project.json libs/bellona/mcp-gateway/src/agent-deep-integration-evals.test.ts libs/bellona/mcp-gateway/src/agent-deep-integration-evals.ts libs/bellona/mcp-gateway/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates the evaluation catalog and deterministic result comparator only. The catalog target prints liveExecutionExercised: false; no live remote host, Blender, Unreal Editor, browser, WebRTC stream, desktop helper, Computer Use runner, gateway deployment, or cloud model was exercised. 180.C.14.20 must prove an MCP client can drive the remote Mac path through the gateway with no inbound MacBook ports.
180.C.14.20 Check off this stage only after an MCP client can drive the remote Mac path through the gateway with no inbound MacBook ports. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/package.json; libs/bellona/mcp-gateway/project.json; libs/bellona/mcp-gateway/src/index.ts; libs/bellona/mcp-gateway/src/remote-mac-no-inbound-smoke.test.ts; libs/bellona/mcp-gateway/src/remote-mac-no-inbound-smoke.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/remote-mac-no-inbound-smoke.test.ts --reporter=verbose; pnpm nx remote-mac:no-inbound-smoke @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke,remote-mac:no-inbound-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/package.json libs/bellona/mcp-gateway/project.json libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/remote-mac-no-inbound-smoke.test.ts libs/bellona/mcp-gateway/src/remote-mac-no-inbound-smoke.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage and the smoke target validate the MCP client/gateway command path and explicit no-inbound topology report in deterministic in-memory transport only. The report prints liveDeploymentExercised: false; no live remote MacBook, gateway deployment, WebSocket host connection, port scan, Blender, browser, WebRTC stream, desktop helper, or cloud model was exercised. 180.C.14.21 must implement agent.readiness and state.snapshot commands across adapters so agents can query dynamic state before attempting work.
180.C.14.21 Implement the agent.readiness and state.snapshot commands defined in 180.C.03.15 across all adapters so agents can query current dynamic state rather than rediscovering blockers through failed commands. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/adapter-registry.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/app.ts; apps/bellona/remote-host/src/command-executor.test.ts; apps/bellona/remote-host/src/command-executor.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/adapter-registry.test.ts src/command-executor.test.ts --reporter=verbose from apps/bellona/remote-host; pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-host -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/adapter-registry.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/app.ts apps/bellona/remote-host/src/command-executor.test.ts apps/bellona/remote-host/src/command-executor.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit and host app coverage validate protocol-valid readiness/snapshot outputs, dynamic blockers, command job reporting, adapter inventory counts, host health/readiness integration, lint/typecheck, and build. No live remote MacBook, Blender, Unreal, browser, WebRTC stream, desktop helper, or real macOS permission prompt was exercised. 180.C.14.22 must implement structured error-remediation handling and surface suggested next commands through the MCP layer.
180.C.14.22 Implement structured error-remediation handling. Every RemoteErrorCode returned must populate the remediation field from 180.C.03.12, and the MCP layer surfaces suggested-next-command templates directly to the agent for reduced wasted LLM turns. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/command-remediation.test.ts; libs/bellona/mcp-gateway/src/command-remediation.ts; libs/bellona/mcp-gateway/src/index.ts; libs/bellona/mcp-gateway/src/remote-control-resources.test.ts; libs/bellona/mcp-gateway/src/remote-control-resources.ts; libs/bellona/mcp-gateway/src/remote-control-tools.test.ts; libs/bellona/mcp-gateway/src/remote-control-tools.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/command-remediation.test.ts src/remote-control-tools.test.ts src/remote-control-resources.test.ts --reporter=verbose from libs/bellona/mcp-gateway; pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/src/command-remediation.test.ts libs/bellona/mcp-gateway/src/command-remediation.ts libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/remote-control-resources.test.ts libs/bellona/mcp-gateway/src/remote-control-resources.ts libs/bellona/mcp-gateway/src/remote-control-tools.test.ts libs/bellona/mcp-gateway/src/remote-control-tools.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates legacy remediation repair, failed MCP command tool surfacing, last-command-result resource surfacing, lint/typecheck/build, and deterministic MCP smoke. No live remote MacBook, gateway deployment, Blender, browser, WebRTC stream, desktop helper, approval backend, or cloud model was exercised. 180.C.14.23 must implement DryRunPlan per-namespace planners for Blender, Unreal, browser, desktop, file, and shell.
180.C.14.23 Implement DryRunPlan per-namespace planners (180.C.03.16) for Blender, Unreal, browser, desktop, file, and shell so risky commands always produce a plan object before execution. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.test.ts; libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.ts; libs/bellona/mcp-gateway/src/agent-dry-run-planners.test.ts; libs/bellona/mcp-gateway/src/agent-dry-run-planners.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/agent-dry-run-planners.test.ts src/agent-dry-run-impact-summary.test.ts --reporter=verbose from libs/bellona/mcp-gateway; pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.test.ts libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.ts libs/bellona/mcp-gateway/src/agent-dry-run-planners.test.ts libs/bellona/mcp-gateway/src/agent-dry-run-planners.ts libs/bellona/mcp-gateway/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates protocol-valid per-namespace dry-run previews for Blender, Unreal, browser, desktop, file, and shell, plus integration through the existing impact-summary API, lint/typecheck/build, and deterministic MCP smoke. No live remote MacBook, Blender, Unreal editor, browser profile, desktop helper, shell command, file mutation, approval backend, gateway deployment, or cloud model was exercised. 180.C.14.24 must replace the deterministic default estimates with cost and time estimates drawn from historical execution telemetry.
180.C.14.24 Implement a cost and time estimator populating DryRunPlan with token, compute, TURN bandwidth, render-minute, and build-minute estimates drawn from historical execution telemetry. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/agent-dry-run-cost-time-estimator.test.ts; libs/bellona/mcp-gateway/src/agent-dry-run-cost-time-estimator.ts; libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.ts; libs/bellona/mcp-gateway/src/agent-dry-run-planners.ts; libs/bellona/mcp-gateway/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/agent-dry-run-cost-time-estimator.test.ts src/agent-dry-run-planners.test.ts src/agent-dry-run-impact-summary.test.ts --reporter=verbose from libs/bellona/mcp-gateway; pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/src/agent-dry-run-cost-time-estimator.test.ts libs/bellona/mcp-gateway/src/agent-dry-run-cost-time-estimator.ts libs/bellona/mcp-gateway/src/agent-dry-run-impact-summary.ts libs/bellona/mcp-gateway/src/agent-dry-run-planners.ts libs/bellona/mcp-gateway/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates telemetry-backed estimates for tokens, compute units, TURN bandwidth, render minutes, build minutes, duration quantiles, failed-sample exclusion, command-result normalization, planner integration, lint/typecheck/build, and deterministic MCP smoke. No live remote MacBook, gateway deployment, Blender render, Unreal build, browser profile, desktop helper, shell command, file mutation, TURN relay, approval backend, or cloud model was exercised. 180.C.14.25 must implement MCP composition rules for Bellona running alongside other MCP servers.
180.C.14.25 Implement MCP composition rules for Bellona MCP running alongside other MCP servers (Isis, Yemaya, third-party): namespacing, tool-name collision policy, discovery ordering, and transport multiplexing documented and tested. Codex Complete libs/bellona/mcp-gateway/README.md; libs/bellona/mcp-gateway/src/index.ts; libs/bellona/mcp-gateway/src/mcp-composition-rules.test.ts; libs/bellona/mcp-gateway/src/mcp-composition-rules.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/mcp-composition-rules.test.ts --reporter=verbose from libs/bellona/mcp-gateway; pnpm nx typecheck @bellona/mcp-gateway --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/mcp-gateway -t lint,typecheck,test,build,cloud-agent:mvp-smoke --skip-nx-cache --verbose; pnpm exec prettier --check libs/bellona/mcp-gateway/README.md libs/bellona/mcp-gateway/src/index.ts libs/bellona/mcp-gateway/src/mcp-composition-rules.test.ts libs/bellona/mcp-gateway/src/mcp-composition-rules.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Unit coverage validates canonical Bellona MCP descriptors, Bellona-first discovery, first-party and third-party ordering, unqualified winner routing, namespaced collision routing, resource URI qualification, and isolated transport multiplex/auth-boundary metadata. No live remote MacBook, gateway deployment, Isis/Yemaya server process, third-party MCP process, Blender, Unreal, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised. 180.C.14.26 must close the stage planning split without moving to 180.C.15 until this phase checklist allows it.
180.C.14.26 Treat this stage as two logical units for future work planning: items .01-.10 are MCP Gateway MVP, items .11-.25 are Cloud-Agent Operations and Policy. Future refactors may split them into 180.C.14.A and 180.C.14.B. Codex Complete TODOS/phase-180-gaps.md; TODOS/phase-180.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md pnpm exec prettier --check TODOS/phase-180.md TODOS/phase-180-gaps.md docs/domains/bellona/extras/remote-control/implementation-tracker.md; git diff --check Not applicable; documentation-only stage planning closure. No live remote MacBook, gateway deployment, MCP process, Blender, Unreal, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised. Stage 14 is closed. Next executable item is 180.C.15.01; do not start any other phase from this closure.
180.C.15.01 Document the Unreal plugin architecture using lessons from the completed Blender/browser/gateway/host path. Codex Complete docs/domains/bellona/extras/remote-control/unreal-plugin-architecture.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec prettier --check docs/domains/bellona/extras/remote-control/unreal-plugin-architecture.md docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Documentation-only architecture note. No live Unreal Editor, plugin binary, Remote Control endpoint, gateway deployment, remote MacBook, Blender, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised. Later Stage 15 implementation items must provide mocked tests and optional hardware evidence before claiming live editor behavior. 180.C.15.02 must implement Unreal adapter capability discovery using this architecture without opening direct editor/network authority.
180.C.15.02 Implement Unreal adapter capability discovery for Unreal install path, engine version, project path, plugin state, editor running state, and supported command list. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/adapter-registry.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md; pnpm-lock.yaml pnpm exec vitest run --config vitest.config.ts src/unreal-adapter.test.ts src/adapter-registry.test.ts src/app.test.ts --reporter=verbose from apps/bellona/remote-host; pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-host -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/adapter-registry.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/index.ts apps/bellona/remote-host/src/unreal-adapter.test.ts apps/bellona/remote-host/src/unreal-adapter.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md pnpm-lock.yaml; git diff --check Unit coverage validates Unreal engine/project/plugin/editor discovery using injected fixtures and parsed .uproject/.uplugin files, default registry wiring, health/readiness count updates, command routing, lint/typecheck/build, and full Remote Host tests. No live Unreal Editor, plugin binary, Remote Control endpoint, remote MacBook, gateway deployment, Blender, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised. 180.C.15.03 must add the protocol-owned read-only unreal.project.info command and mocked adapter response without opening direct editor/network authority.
180.C.15.03 Implement read-only unreal.project.info schema and mocked adapter response. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/index.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/unreal.test.ts; libs/bellona/remote-protocol/src/unreal.ts; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts src/schema-registry.test.ts --reporter=verbose from libs/bellona/remote-protocol; pnpm exec vitest run --config vitest.config.ts src/unreal-adapter.test.ts src/adapter-registry.test.ts src/app.test.ts --reporter=verbose from apps/bellona/remote-host; pnpm nx contracts:generate @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx contracts:check @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/index.ts apps/bellona/remote-host/src/unreal-adapter.test.ts apps/bellona/remote-host/src/unreal-adapter.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/index.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts libs/bellona/remote-protocol/src/unreal.test.ts libs/bellona/remote-protocol/src/unreal.ts TODOS/phase-180.md; git diff --check Unit coverage validates protocol argument/output/envelope schemas, duplicate rejection, generated contract registry coverage, Remote Host capability registration, schema-valid mocked project-info routing, default app/registry count updates, lint/typecheck/build, and contract drift checks. No live Unreal Editor, plugin binary, Remote Control endpoint, remote MacBook, gateway deployment, Blender, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised. 180.C.15.04 must add the read-only unreal.world.query schema and mocked adapter response before authenticated editor plugin transport or mutations are unlocked.
180.C.15.04 Implement read-only unreal.world.query schema and mocked adapter response. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/unreal.test.ts; libs/bellona/remote-protocol/src/unreal.ts; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts src/schema-registry.test.ts --reporter=verbose from libs/bellona/remote-protocol; pnpm exec vitest run --config vitest.config.ts src/unreal-adapter.test.ts src/adapter-registry.test.ts src/app.test.ts --reporter=verbose from apps/bellona/remote-host; pnpm nx contracts:generate @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx contracts:check @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/index.ts apps/bellona/remote-host/src/unreal-adapter.test.ts apps/bellona/remote-host/src/unreal-adapter.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts libs/bellona/remote-protocol/src/unreal.test.ts libs/bellona/remote-protocol/src/unreal.ts TODOS/phase-180.md; git diff --check Unit coverage validates protocol argument/output/envelope schemas, duplicate actor/component/level rejection, broken selection-reference rejection, generated contract registry coverage, Remote Host capability registration, schema-valid mocked world-query routing, structured unavailable-project/editor blockers, default app/registry count updates, lint/typecheck/build, and contract drift checks. No live Unreal Editor, plugin binary, Remote Control endpoint, remote MacBook, gateway deployment, Blender, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised. 180.C.15.05 must add the authenticated localhost Unreal Editor plugin connection before replacing mocked world data with live editor data.
180.C.15.05 Build or complete the Unreal Editor plugin connection to the local host runtime with authenticated localhost transport. Codex Complete apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/unreal-plugin-architecture.md; libs/bellona/unreal/package.json; libs/bellona/unreal/project.json; libs/bellona/unreal/plugin/BellonaUnrealEditor/BellonaUnrealEditor.uplugin; libs/bellona/unreal/plugin/BellonaUnrealEditor/Source/BellonaUnrealEditor/BellonaUnrealEditor.Build.cs; libs/bellona/unreal/plugin/BellonaUnrealEditor/Source/BellonaUnrealEditor/Private/BellonaUnrealEditorModule.cpp; libs/bellona/unreal/plugin/BellonaUnrealEditor/Source/BellonaUnrealEditor/Public/BellonaUnrealEditorModule.h; libs/bellona/unreal/src/index.ts; libs/bellona/unreal/src/phase-8-completion.test.ts; libs/bellona/unreal/src/plugin-transport.test.ts; libs/bellona/unreal/src/plugin-transport.ts; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts src/plugin-transport.test.ts src/phase-8-completion.test.ts --reporter=verbose from libs/bellona/unreal; pnpm exec vitest run --config vitest.config.ts src/unreal-adapter.test.ts src/adapter-registry.test.ts src/app.test.ts --reporter=verbose from apps/bellona/remote-host; pnpm nx typecheck @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/unreal,@bellona/remote-host -t lint,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/index.ts apps/bellona/remote-host/src/unreal-adapter.test.ts apps/bellona/remote-host/src/unreal-adapter.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/unreal-plugin-architecture.md libs/bellona/unreal/package.json libs/bellona/unreal/project.json libs/bellona/unreal/src/index.ts libs/bellona/unreal/src/phase-8-completion.test.ts libs/bellona/unreal/src/plugin-transport.test.ts libs/bellona/unreal/src/plugin-transport.ts TODOS/phase-180.md; pnpm exec prettier --check --parser json libs/bellona/unreal/plugin/BellonaUnrealEditor/BellonaUnrealEditor.uplugin; git diff --check Unit coverage validates high-entropy token generation, bearer auth headers, loopback-only endpoint normalization, non-loopback rejection, ready-probe success, unauthorized response handling, malformed readiness rejection, plugin descriptor/module scaffold contents, Remote Host discovery reporting for authenticated plugin readiness, and blocked non-loopback plugin transport. The Unreal C++ plugin bundle is checked in and copied by the Nx build, but no live Unreal Editor process, compiled plugin binary, Remote Control endpoint, remote MacBook, gateway deployment, Blender, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised. 180.C.15.06 must route unreal.project.info and unreal.world.query through gateway-host-adapter with timeline and audit visibility before replacing mocked read-only responses with live plugin/editor data.
180.C.15.06 Route unreal.project.info and unreal.world.query through gateway-host-adapter with timeline and audit visibility. Codex Complete TODOS/phase-180.md; apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/project.json; apps/bellona/remote-host/scripts/unreal-readonly-remote-smoke.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md pnpm exec vitest run --config vitest.config.ts src/command-dispatcher.test.ts --reporter=verbose from apps/bellona/remote-gateway; pnpm nx unreal:readonly-remote-smoke @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-gateway,@bellona/remote-host -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/command-dispatcher.test.ts apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/project.json apps/bellona/remote-host/scripts/unreal-readonly-remote-smoke.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md TODOS/phase-180.md; git diff --check Gateway tests validate connected-host dispatch, policy allow, host progress/result routing, protocol-valid Unreal read-only outputs, audit entries, telemetry, and timeline events. The remote smoke validates the actual Remote Host app, outbound gateway connection, Unreal adapter registration, command executor progress/result emission, and gateway audit/timeline evidence with deterministic fixture-backed outputs. No live Unreal Editor process, compiled plugin binary, Remote Control endpoint, remote MacBook, Blender, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised. 180.C.15.07 may add safe actor spawn now that Unreal read-only commands use the verified gateway-host-adapter-audit path.
180.C.15.07 Implement unreal.actor.spawn as the first safe mutation with policy check, editor transaction/undo, result object reference, and screenshot/evidence placeholder. Codex Complete TODOS/phase-180.md; apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/command-dispatcher.test.ts; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/adapter-registry.test.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/src/policy-preflight.test.ts; apps/bellona/remote-host/src/policy-preflight.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/policy.test.ts; libs/bellona/remote-protocol/src/policy.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/unreal.test.ts; libs/bellona/remote-protocol/src/unreal.ts pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts src/schema-registry.test.ts src/policy.test.ts --reporter=verbose from libs/bellona/remote-protocol; pnpm exec vitest run --config vitest.config.ts src/unreal-adapter.test.ts src/adapter-registry.test.ts src/app.test.ts src/policy-preflight.test.ts --reporter=verbose from apps/bellona/remote-host; pnpm exec vitest run --config vitest.config.ts src/command-dispatcher.test.ts --reporter=verbose from apps/bellona/remote-gateway; pnpm nx contracts:generate @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx contracts:check @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/command-dispatcher.test.ts apps/bellona/remote-host/README.md apps/bellona/remote-host/src/adapter-registry.test.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/index.ts apps/bellona/remote-host/src/policy-preflight.test.ts apps/bellona/remote-host/src/policy-preflight.ts apps/bellona/remote-host/src/unreal-adapter.test.ts apps/bellona/remote-host/src/unreal-adapter.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/policy.test.ts libs/bellona/remote-protocol/src/policy.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts libs/bellona/remote-protocol/src/unreal.test.ts libs/bellona/remote-protocol/src/unreal.ts; git diff --check Unit coverage validates protocol parsing and rejection paths, policy scope inference, host registration and observe-only preflight denial, mocked actor-spawn execution with committed undo-stack transaction metadata, gateway dispatch/audit/timeline/client routing, and pre-host policy denial when project.write is denied. No live Unreal Editor process, compiled plugin binary, Remote Control endpoint, remote MacBook, Blender, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised. 180.C.15.08 should add the broader mocked failure matrix, including transaction failure, before optional hardware fixture smoke in 180.C.15.09.
180.C.15.08 Add mocked tests for Unreal missing, plugin missing, project closed, read-only query success, spawn success, policy deny, and transaction failure. Codex Complete TODOS/phase-180.md; apps/bellona/remote-host/src/unreal-adapter.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md pnpm exec vitest run --config vitest.config.ts src/unreal-adapter.test.ts src/policy-preflight.test.ts --reporter=verbose from apps/bellona/remote-host; pnpm nx run-many -p @bellona/remote-host,@bellona/remote-gateway,@bellona/remote-protocol -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md apps/bellona/remote-host/src/unreal-adapter.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md; git diff --check Mocked coverage validates missing Unreal Engine, missing Bellona Unreal plugin descriptor, project-configured/editor-not-running world-query blockers, read-only query success, actor-spawn success, observe-only/policy denial, and protocol-valid failed actor-spawn transaction output. No live Unreal Editor process, compiled plugin binary, Remote Control endpoint, remote MacBook, Blender, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised. 180.C.15.09 remains optional hardware fixture smoke for query and actor spawn.
180.C.15.09 Add optional hardware Unreal fixture project smoke test for query and actor spawn. Codex Complete TODOS/phase-180.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/project.json; apps/bellona/remote-host/scripts/unreal-actor-spawn-remote-smoke.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md pnpm nx unreal:actor-spawn-remote-smoke @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-host,@bellona/remote-gateway,@bellona/remote-protocol -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/project.json apps/bellona/remote-host/scripts/unreal-actor-spawn-remote-smoke.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md; git diff --check Optional smoke passed in skipped mode on this machine because no Unreal fixture project is configured. The committed smoke records hardware evidence when run with BELLONA_UNREAL_HARDWARE_SMOKE=1, including project path, plugin descriptor, editor process id, command ids, actor id, transaction id, undo checkpoint id, and screenshot placeholder status. No live Unreal Editor process, compiled plugin binary, Remote Control endpoint, remote MacBook, Blender, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised here. 180.C.15.10 can close Stage 15 using the deterministic protocol/host/gateway coverage plus this optional smoke entry point; live editor evidence remains environment-dependent.
180.C.15.10 Check off this stage only after Unreal follows the same verified control path as Blender: schema, policy, adapter, audit, evidence, and docs. Codex Complete TODOS/phase-180.md; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/unreal-plugin-architecture.md; docs/domains/bellona/extras/remote-control/unreal-readonly-safe-mutation-mvp-closure.md pnpm nx contracts:check @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx unreal:readonly-remote-smoke @bellona/remote-host --skip-nx-cache --verbose; pnpm nx unreal:actor-spawn-remote-smoke @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-host,@bellona/remote-gateway,@bellona/remote-protocol -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md apps/bellona/remote-host/README.md docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/unreal-plugin-architecture.md docs/domains/bellona/extras/remote-control/unreal-readonly-safe-mutation-mvp-closure.md; git diff --check Deterministic verification closes Stage 15 for protocol-owned Unreal read-only and first safe-mutation command paths. Optional actor-spawn smoke passed in skipped mode because no Unreal fixture project is configured on this machine. No live Unreal Editor process, compiled plugin binary loaded in an editor, Remote Control endpoint, remote MacBook, Blender, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised here. Stage 15 is closed. Live Unreal fixture evidence remains environment-dependent through BELLONA_UNREAL_HARDWARE_SMOKE=1; the next unchecked Phase 180 item is 180.C.16.01, but it has not been started.
180.C.16.01 Replace development credential storage with macOS Keychain storage for Remote Host device keys and tokens. Codex Complete TODOS/phase-180.md; apps/bellona/remote-gateway/README.md; apps/bellona/remote-gateway/src/app.test.ts; apps/bellona/remote-gateway/src/pairing-exchange.ts; apps/bellona/remote-host/README.md; apps/bellona/remote-host/scripts/blender-create-primitive-remote-smoke.ts; apps/bellona/remote-host/scripts/blender-scene-info-remote-smoke.ts; apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts; apps/bellona/remote-host/scripts/desktop-fallback-remote-smoke.ts; apps/bellona/remote-host/scripts/unreal-readonly-remote-smoke.ts; apps/bellona/remote-host/src/app.test.ts; apps/bellona/remote-host/src/app.ts; apps/bellona/remote-host/src/config.test.ts; apps/bellona/remote-host/src/config.ts; apps/bellona/remote-host/src/identity-store.test.ts; apps/bellona/remote-host/src/identity-store.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/src/pairing-client.test.ts; apps/bellona/remote-host/src/pairing-client.ts; docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md pnpm exec vitest run --config vitest.config.ts src/identity-store.test.ts src/pairing-client.test.ts src/config.test.ts src/app.test.ts --reporter=verbose from apps/bellona/remote-host; pnpm exec vitest run --config vitest.config.ts src/app.test.ts src/pairing-codes.test.ts src/host-token.test.ts --reporter=verbose from apps/bellona/remote-gateway; pnpm nx run-many -p @bellona/remote-host,@bellona/remote-gateway -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md apps/bellona/remote-gateway/README.md apps/bellona/remote-gateway/src/app.test.ts apps/bellona/remote-gateway/src/pairing-exchange.ts apps/bellona/remote-host/README.md apps/bellona/remote-host/scripts/blender-create-primitive-remote-smoke.ts apps/bellona/remote-host/scripts/blender-scene-info-remote-smoke.ts apps/bellona/remote-host/scripts/browser-managed-remote-smoke.ts apps/bellona/remote-host/scripts/desktop-fallback-remote-smoke.ts apps/bellona/remote-host/scripts/unreal-readonly-remote-smoke.ts apps/bellona/remote-host/src/app.test.ts apps/bellona/remote-host/src/app.ts apps/bellona/remote-host/src/config.test.ts apps/bellona/remote-host/src/config.ts apps/bellona/remote-host/src/identity-store.test.ts apps/bellona/remote-host/src/identity-store.ts apps/bellona/remote-host/src/index.ts apps/bellona/remote-host/src/pairing-client.test.ts apps/bellona/remote-host/src/pairing-client.ts docs/domains/bellona/extras/remote-control/blender-read-only-mvp-second-macbook.md docs/domains/bellona/extras/remote-control/implementation-tracker.md; git diff --check Unit coverage validates Keychain identity persistence with the macOS security command mocked, including stdin password input, no token in argv, missing item, invalid item, non-macOS rejection, pairing into Keychain, and explicit development-file fallback. No real macOS Keychain item, remote MacBook, Blender, Unreal, browser profile, desktop helper, WebRTC stream, approval backend, or cloud model was exercised. 180.C.16.02 remains signed/notarized packaging. Later hardening should add a live Keychain install/pair/unpair smoke once the packaged Remote Host identity and uninstall flows exist.
180.C.16.02 Add signed/notarized macOS packaging plan or initial implementation for Remote Host, LaunchAgent, helper tools, Blender addon, and Unreal plugin. Codex Complete TODOS/phase-180.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/src/macos-packaging-plan.test.ts; apps/bellona/remote-host/src/macos-packaging-plan.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/macos-packaging-and-notarization-plan.md pnpm exec vitest run --config vitest.config.ts src/macos-packaging-plan.test.ts --reporter=verbose from apps/bellona/remote-host; pnpm nx run-many -p @bellona/remote-host -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/index.ts apps/bellona/remote-host/src/macos-packaging-plan.test.ts apps/bellona/remote-host/src/macos-packaging-plan.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/macos-packaging-and-notarization-plan.md; git diff --check Unit coverage validates the packaging plan contract, artifact coverage, inside-out signing order, Developer ID Application/Installer boundaries, hardened runtime command usage, notarytool, stapler, spctl, and pkgutil release gates, and the absence of altool. No real Developer ID certificate, code-signed binary, notarization submission, stapled package, LaunchAgent install, helper executable, remote MacBook, Blender, Unreal, WebRTC stream, approval backend, or cloud model was exercised. 180.C.16.03 completed the signed update channel/manifest/rollback contract. Later Stage 26 must implement live packaging scripts, installer/uninstaller, entitlement evidence, and notarized package hardware evidence.
180.C.16.03 Add update channel, signed update manifest, rollback, and adapter compatibility plan. Codex Complete TODOS/phase-180.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/src/macos-packaging-plan.test.ts; apps/bellona/remote-host/src/macos-packaging-plan.ts; apps/bellona/remote-host/src/update-manifest.test.ts; apps/bellona/remote-host/src/update-manifest.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/macos-packaging-and-notarization-plan.md; docs/domains/bellona/extras/remote-control/remote-host-update-channel-and-rollback-plan.md pnpm exec vitest run --config vitest.config.ts src/update-manifest.test.ts src/macos-packaging-plan.test.ts --reporter=verbose from apps/bellona/remote-host; pnpm nx run-many -p @bellona/remote-host -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/index.ts apps/bellona/remote-host/src/macos-packaging-plan.test.ts apps/bellona/remote-host/src/macos-packaging-plan.ts apps/bellona/remote-host/src/update-manifest.test.ts apps/bellona/remote-host/src/update-manifest.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/macos-packaging-and-notarization-plan.md docs/domains/bellona/extras/remote-control/remote-host-update-channel-and-rollback-plan.md; git diff --check Unit coverage validates signed manifest canonicalization, Ed25519 verification, tamper rejection, monotonic manifest-version downgrade protection, rollback as a new signed manifest version, channel policy, required artifact checks, adapter compatibility rejection, and the updated macOS packaging blocker handoff to Stage 26. No real package installer, Sparkle appcast, LaunchAgent update, remote MacBook, Blender, Unreal, WebRTC stream, approval backend, or live rollback drill was exercised. Later Stage 26 must implement live update delivery, Sparkle-compatible appcast/package flow, LaunchAgent repair, installer rollback drill, and hardware evidence.
180.C.16.04 Add network impairment tests for gateway restart, host reconnect, host sleep/wake, packet loss, high latency, and TURN fallback placeholder. Codex Complete TODOS/phase-180.md; testing/bellona/remote-control/README.md; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/network-impairment.ts; testing/bellona/remote-control/tests/__snapshots__/snapshot-fixtures.test.ts.snap; testing/bellona/remote-control/tests/network-impairment.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/network-impairment-test-plan.md pnpm exec vitest run --config vitest.config.ts tests/network-impairment.test.ts --reporter=verbose from testing/bellona/remote-control; pnpm exec vitest run --config vitest.config.ts tests/snapshot-fixtures.test.ts -u --reporter=verbose from testing/bellona/remote-control; pnpm nx run-many -p @bellona/remote-control-testing -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md testing/bellona/remote-control/README.md testing/bellona/remote-control/index.ts testing/bellona/remote-control/network-impairment.ts testing/bellona/remote-control/tests/network-impairment.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/network-impairment-test-plan.md; git diff --check Deterministic fixture coverage validates gateway restart, host reconnect, host sleep/wake reconnect, packet-loss degraded telemetry, high-latency degraded telemetry, and an explicit TURN fallback placeholder. No real packet shaping, physical MacBook sleep/wake, live gateway process restart, WebRTC media, coturn relay, remote MacBook, Blender, Unreal, browser profile, desktop helper, approval backend, or cloud model was exercised. Later hardware/deployment work must attach NET-IMPAIR-01 evidence for real packet loss/high latency, actual macOS sleep/wake, gateway process restart, and TURN-only relay once WebRTC signaling exists.
180.C.16.05 Add security tests for prompt injection, denied paths, denied app/window, revoked device, approval bypass attempt, and secret redaction. Codex Complete TODOS/phase-180.md; testing/bellona/remote-control/README.md; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/security-regression.ts; testing/bellona/remote-control/tests/security-regression.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/security-regression-test-plan.md pnpm exec vitest run --config vitest.config.ts tests/security-regression.test.ts --reporter=verbose from testing/bellona/remote-control; pnpm nx run-many -p @bellona/remote-control-testing -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md testing/bellona/remote-control/README.md testing/bellona/remote-control/index.ts testing/bellona/remote-control/security-regression.ts testing/bellona/remote-control/tests/security-regression.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/security-regression-test-plan.md; git diff --check Deterministic fixture coverage validates prompt-injection detection/isolation, denied project-write path policy, denied app/window redaction, revoked device fail-closed policy, destructive approval downgrade schema rejection, and recursive secret redaction. No live malicious web page, real browser profile, physical MacBook capture, real filesystem grant, active host revocation/reconnect, Control Room approval replay, production log scan, support bundle, Blender, Unreal, WebRTC stream, approval backend, or cloud model was exercised. Later browser, host, gateway, Control Room, packaging, and production release gates must attach live evidence for malicious-page containment, project-root path grants, macOS denied-window redaction, revocation reconnect denial, approval binding, and support-bundle/log secret scans.
180.C.16.06 Add performance budgets and measurements for command latency, stream startup, screenshot capture, browser navigation, Blender command time, and gateway-host reconnect. Codex Complete TODOS/phase-180.md; testing/bellona/remote-control/README.md; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/performance-budgets.ts; testing/bellona/remote-control/tests/performance-budgets.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/performance-budget-test-plan.md pnpm exec vitest run --config vitest.config.ts tests/performance-budgets.test.ts --reporter=verbose from testing/bellona/remote-control; pnpm nx run-many -p @bellona/remote-control-testing -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md testing/bellona/remote-control/README.md testing/bellona/remote-control/index.ts testing/bellona/remote-control/performance-budgets.ts testing/bellona/remote-control/tests/performance-budgets.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/performance-budget-test-plan.md; git diff --check Deterministic fixture coverage validates target p95, max p95, sample-count, p50, p95, average, and max calculations for command latency, stream startup, screenshot capture, browser navigation, Blender command time, and gateway-host reconnect. No live LAN/cloud command histogram, WebRTC/TURN stream, physical MacBook screenshot capture, managed browser profile, live Blender addon, gateway restart, host sleep/wake, remote MacBook, Unreal, approval backend, or cloud model was exercised. Later LAN/cloud, WebRTC/TURN, macOS capture, browser, Blender, and gateway-host reconnect release gates must replace fixture samples with live histograms and attach performance evidence before production signoff.
180.C.16.07 Add runbooks for two-MacBook LAN setup, cloud gateway setup, permissions troubleshooting, plugin repair, stream failure, revocation, audit export, and uninstall. Codex Complete TODOS/phase-180.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/mvp-alpha-operations-runbooks.md pnpm exec prettier --check TODOS/phase-180.md docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/mvp-alpha-operations-runbooks.md; git diff --check Documentation runbooks specify required evidence for future live runs. No live two-MacBook LAN setup, cloud gateway, macOS TCC permission change, Blender addon repair, Unreal plugin repair, stream failure, device revocation drill, audit export, uninstall, WebRTC/TURN stream, remote MacBook, approval backend, or cloud model was exercised. Later deployment, hardware, packaging, stream, revocation, and release-gate tasks must execute these runbooks and attach concrete evidence before production signoff.
180.C.16.08 Add deployment smoke tests for local, LAN, Hetzner, and AWS reference modes as those modes become available. Codex Complete TODOS/phase-180.md; testing/bellona/remote-control/README.md; testing/bellona/remote-control/deployment-smoke.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/tests/deployment-smoke.test.ts; docs/domains/bellona/extras/remote-control/deployment-smoke-test-plan.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md pnpm exec vitest run --config vitest.config.ts tests/deployment-smoke.test.ts --reporter=verbose from testing/bellona/remote-control; pnpm nx run-many -p @bellona/remote-control-testing -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md testing/bellona/remote-control/README.md testing/bellona/remote-control/deployment-smoke.ts testing/bellona/remote-control/index.ts testing/bellona/remote-control/tests/deployment-smoke.test.ts docs/domains/bellona/extras/remote-control/deployment-smoke-test-plan.md docs/domains/bellona/extras/remote-control/implementation-tracker.md; git diff --check Deterministic fixture coverage validates local, LAN, Hetzner, and AWS deployment smoke contracts through a fake outbound host connection, protocol-valid diagnostic readiness command, event stream, progress output, and audit entries. Local mode is fixture evidence only; LAN, Hetzner, and AWS are explicitly marked live-hardware-required and report releaseSignoffEligible=false. No physical two-MacBook LAN setup, real cloud provider edge, TLS certificate, firewall/security group, ALB target, public DNS, TURN relay, live Blender, Unreal, browser, desktop, approval backend, or production gateway deployment was exercised. Later MVP alpha and deployment gates must attach two-MacBook LAN, Hetzner, and AWS live evidence, including gateway health/readiness, local-only bind proof, host identity, smoke output, logs, audit export, deployed commit SHA, and explicit TURN/media limitations before signoff.
180.C.16.09 Add MVP alpha release gate requiring protocol, gateway, host, policy, audit, Blender, browser, desktop fallback, Control Room, MCP, and Unreal checks before MVP alpha release. Codex Complete TODOS/phase-180.md; testing/bellona/remote-control/README.md; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/mvp-alpha-release-gate.ts; testing/bellona/remote-control/tests/mvp-alpha-release-gate.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/mvp-alpha-release-gate.md pnpm exec vitest run --config vitest.config.ts tests/mvp-alpha-release-gate.test.ts --reporter=verbose from testing/bellona/remote-control; pnpm nx run-many -p @bellona/remote-control-testing -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md testing/bellona/remote-control/README.md testing/bellona/remote-control/index.ts testing/bellona/remote-control/mvp-alpha-release-gate.ts testing/bellona/remote-control/tests/mvp-alpha-release-gate.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/mvp-alpha-release-gate.md; git diff --check Deterministic release-gate coverage validates the gate structure, required stages, documentation bundle, MVP demo scenarios, package verification surfaces, deterministic Stage 16 suite composition, default blocked behavior when evidence is missing, and a full pass path when the required evidence snapshot is attached. No real two-MacBook LAN run, cloud deployment, Playwright session, live Blender, live browser profile, live desktop fallback, live Unreal Editor, live WebRTC media, or production release automation was exercised directly by this test package. Later 180.C.16.11 and 180.C.16.12 can extend the same gate with explicit demo scripts, SLO/error-budget policy, and richer release evidence attachment. Stage 180.C.29.08-.10 remains the stronger final GA gate.
180.C.16.10 Check off this stage only after the MVP is stable enough that deeper Blender, browser, Unreal, deployment, security, and fleet stages can extend the same architecture without replacing it. Codex Complete TODOS/phase-180.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/mvp-alpha-architecture-stability.md pnpm exec prettier --check TODOS/phase-180.md docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/mvp-alpha-architecture-stability.md; git diff --check Documentation-only closure note. No live two-MacBook LAN run, cloud deployment, live Blender, browser, desktop fallback, Unreal Editor, WebRTC media, or production fleet behavior was exercised by this item. The closure records the architectural invariants that later stages must extend rather than replace. Later 180.C.16.11 through 180.C.16.15 can add demo scripts, SLO/error-budget policy, soak-test planning, GA-gate alignment, and bridge deprecation planning on top of this stable MVP alpha architecture.
180.C.16.11 Define explicit MVP demo scenarios and acceptance criteria: solo creator pairs two MacBooks on a LAN, agent queries Blender scene, creates a primitive, navigates a browser, captures a screenshot, and operator approves plus replays the session. The demo scripts become release evidence. Codex Complete TODOS/phase-180.md; testing/bellona/remote-control/README.md; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/mvp-alpha-demo-scenarios.ts; testing/bellona/remote-control/tests/mvp-alpha-demo-scenarios.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/mvp-alpha-demo-scenarios.md pnpm exec vitest run --config vitest.config.ts tests/mvp-alpha-demo-scenarios.test.ts --reporter=verbose from testing/bellona/remote-control; pnpm nx run-many -p @bellona/remote-control-testing -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md testing/bellona/remote-control/README.md testing/bellona/remote-control/index.ts testing/bellona/remote-control/mvp-alpha-demo-scenarios.ts testing/bellona/remote-control/tests/mvp-alpha-demo-scenarios.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/mvp-alpha-demo-scenarios.md; git diff --check Deterministic scenario-catalog coverage validates the scripted MVP release-evidence scenarios, exact LAN happy-path commands, and acceptance/evidence requirements. No real two-MacBook LAN run, cloud deployment, live Blender, live browser profile, live desktop fallback, Control Room session, live Unreal Editor, WebRTC media, or production release bundle was exercised by this catalog itself. Later 180.C.16.12 can layer SLO and error-budget policy on top of these scripted release scenarios. Stage 180.C.16.14 should align this MVP script catalog with the final GA acceptance gate in 180.C.29.08-.10.
180.C.16.12 Define SLO targets and error-budget policy for command acknowledgement latency, stream start latency, approval round-trip time, and audit write durability. Burn-rate alerts gate release. Codex Complete TODOS/phase-180.md; testing/bellona/remote-control/README.md; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/mvp-alpha-release-gate.ts; testing/bellona/remote-control/mvp-alpha-slos.ts; testing/bellona/remote-control/tests/mvp-alpha-release-gate.test.ts; testing/bellona/remote-control/tests/mvp-alpha-slos.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/mvp-alpha-release-gate.md; docs/domains/bellona/extras/remote-control/mvp-alpha-slos-and-error-budgets.md pnpm exec vitest run --config vitest.config.ts tests/mvp-alpha-slos.test.ts tests/mvp-alpha-release-gate.test.ts --reporter=verbose from testing/bellona/remote-control; pnpm nx run-many -p @bellona/remote-control-testing -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md testing/bellona/remote-control/README.md testing/bellona/remote-control/index.ts testing/bellona/remote-control/mvp-alpha-release-gate.ts testing/bellona/remote-control/mvp-alpha-slos.ts testing/bellona/remote-control/tests/mvp-alpha-release-gate.test.ts testing/bellona/remote-control/tests/mvp-alpha-slos.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/mvp-alpha-release-gate.md docs/domains/bellona/extras/remote-control/mvp-alpha-slos-and-error-budgets.md; git diff --check Deterministic policy coverage validates the SLO catalog, burn-rate thresholds, budget math, missing-evidence fail-closed behavior, healthy evidence path, active fast-burn regression, low-budget warning path, and MVP alpha release-gate integration. No production telemetry backend, Grafana dashboard, Prometheus rule deployment, same-LAN/TURN stream telemetry collector, real command acknowledgement histogram, or live audit-store fleet evidence was exercised directly by this test package. Stage 180.C.28.13 should automate these exact burn-rate and error-budget semantics against production telemetry. Later soak-test and GA-gate work should attach broader live evidence without changing the policy contract defined here.
180.C.16.13 Add a soak-test plan for multi-day host uptime: sleep/ wake cycles, LaunchAgent crash-loop recovery, gateway reconnect stability, audit store growth under sustained load, and memory-leak detection across 72+ hour runs. Codex Complete TODOS/phase-180.md; testing/bellona/remote-control/README.md; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/mvp-alpha-soak-plan.ts; testing/bellona/remote-control/tests/mvp-alpha-soak-plan.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/mvp-alpha-soak-test-plan.md pnpm exec vitest run --config vitest.config.ts tests/mvp-alpha-soak-plan.test.ts --reporter=verbose from testing/bellona/remote-control; pnpm nx run-many -p @bellona/remote-control-testing -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md testing/bellona/remote-control/README.md testing/bellona/remote-control/index.ts testing/bellona/remote-control/mvp-alpha-soak-plan.ts testing/bellona/remote-control/tests/mvp-alpha-soak-plan.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/mvp-alpha-soak-test-plan.md; git diff --check Deterministic plan coverage validates the 72+ hour envelope, phase layout, recurring probes, LaunchAgent and sleep/wake drills, audit-growth checkpoints, memory-leak thresholds, and required evidence bundle. No real 72-hour MacBook soak run, LaunchAgent crash-loop, gateway restart, sustained audit-store backend, or production memory telemetry collector was exercised by this plan artifact itself. Later Stage 180.C.26 and 180.C.28 work must execute this plan on real macOS hardware, production LaunchAgent packaging, and the final audit-store backend; 180.C.16.14 should align this soak evidence with the broader GA gate without changing the planned drill matrix.
180.C.16.14 Align this Alpha/MVP gate with the final GA gate in 180.C.29.08-.10. Document which stages each gate requires so the two do not drift into divergent release criteria. Codex Complete TODOS/phase-180.md; testing/bellona/remote-control/README.md; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/mvp-alpha-release-gate.ts; testing/bellona/remote-control/release-gate-alignment.ts; testing/bellona/remote-control/tests/mvp-alpha-release-gate.test.ts; testing/bellona/remote-control/tests/release-gate-alignment.test.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/mvp-alpha-release-gate.md; docs/domains/bellona/extras/remote-control/release-gate-alignment.md pnpm exec vitest run --config vitest.config.ts tests/release-gate-alignment.test.ts tests/mvp-alpha-release-gate.test.ts --reporter=verbose from testing/bellona/remote-control; pnpm nx run-many -p @bellona/remote-control-testing -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md testing/bellona/remote-control/README.md testing/bellona/remote-control/index.ts testing/bellona/remote-control/mvp-alpha-release-gate.ts testing/bellona/remote-control/release-gate-alignment.ts testing/bellona/remote-control/tests/mvp-alpha-release-gate.test.ts testing/bellona/remote-control/tests/release-gate-alignment.test.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/mvp-alpha-release-gate.md docs/domains/bellona/extras/remote-control/release-gate-alignment.md; git diff --check Deterministic alignment coverage validates that the Stage 16 release gate stage list is shared with the MVP alpha release evaluator, that the final GA gate remains a strict superset including 180.C.17-.28 plus 180.C.29.01-.10, and that the conditional Windows/Linux scope rules stay explicit. No live two-MacBook LAN run, cloud GA release, packaging signer, SDK consumer, CLI operator, or final hardware-in-the-loop acceptance bundle was exercised by this alignment artifact itself. Later Stage 180.C.29.08-.10 implementation must attach the actual final verification logs, release evidence, and product-acceptance artifacts against this shared gate matrix rather than inventing a separate checklist.
180.C.16.15 Produce a bridge coexistence and deprecation plan for existing apps/bellona/bridge-blender and bridge-unreal consumers describing shim behavior, parallel operation, cutover date, and final removal gate. Execution is tracked in 180.C.38. Codex Complete TODOS/phase-180.md; testing/bellona/remote-control/README.md; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/bridge-coexistence-plan.ts; testing/bellona/remote-control/tests/bridge-coexistence-plan.test.ts; docs/domains/bellona/extras/remote-control/bridge-coexistence-and-deprecation-plan.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md pnpm exec vitest run --config vitest.config.ts tests/bridge-coexistence-plan.test.ts --reporter=verbose from testing/bellona/remote-control; pnpm nx run-many -p @bellona/remote-control-testing -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md testing/bellona/remote-control/README.md testing/bellona/remote-control/index.ts testing/bellona/remote-control/bridge-coexistence-plan.ts testing/bellona/remote-control/tests/bridge-coexistence-plan.test.ts docs/domains/bellona/extras/remote-control/bridge-coexistence-and-deprecation-plan.md docs/domains/bellona/extras/remote-control/implementation-tracker.md; git diff --check Deterministic plan coverage validates the checked-in legacy bridge command surfaces, the current Remote Host translation candidates, the fixed hard cutover date, the coexistence rules, and the Stage 180.C.38.09 final removal gate. No live dual-run on macOS hardware, real bridge-plus-host conflict drill, production telemetry, gateway feature-flag drill, or actual consumer migration was executed by this planning artifact itself. Stage 180.C.38.01 through .09 must implement the actual shim, telemetry, migration guides, public warning timeline, forced-migration drills, and final bridge cleanup against the plan defined here.
180.C.17.01 Implement blender.file.open, blender.file.save, blender.file.save_as, blender.file.pack_resources, and blender.file.recover_last with project-root policy checks, audit, and file snapshot behavior. Codex Complete TODOS/phase-180.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/blender/python/bellona_addon/handlers.py; libs/bellona/blender/src/assets/index.ts; libs/bellona/blender/src/bridge/index.ts; libs/bellona/remote-protocol/src/blender.test.ts; libs/bellona/remote-protocol/src/blender.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts pnpm exec vitest run --config vitest.config.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/schema-registry.test.ts from repo root; pnpm exec vitest run --config vitest.config.ts src/blender-adapter.test.ts from apps/bellona/remote-host; pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host -t lint,typecheck,build --skip-nx-cache --verbose; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host -t typecheck,test --skip-nx-cache --verbose; python3 -m py_compile libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec prettier --check TODOS/phase-180.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md libs/bellona/blender/src/assets/index.ts libs/bellona/blender/src/bridge/index.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/blender.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts; git diff --check Deterministic coverage now validates protocol-owned Blender file envelopes, result schemas, capability fixtures, addon file handlers, Remote Host project-root enforcement, dirty-state guards, and before/after file snapshot evidence. No live Blender UI session, real autosave recovery, or second-MacBook hardware run was exercised in this CI-visible pass. Later Stage 180.C.17.09 must attach live Blender/addon hardware evidence for pack_resources and recover_last against real .blend files on the controlled MacBook.
180.C.17.02 Implement blender.object.delete, blender.object.rename, blender.object.duplicate, blender.object.parent, blender.object.set_transform, and blender.object.set_visibility with undo checkpoints and mocked tests. Codex Complete TODOS/phase-180.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/remote-protocol/src/blender.ts; libs/bellona/remote-protocol/src/blender.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/README.md; apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/README.md; libs/bellona/blender/python/bellona_addon/handlers.py; libs/bellona/blender/src/addon-smoke.test.ts; libs/bellona/blender/src/bridge/index.ts; libs/bellona/blender/src/scene/index.ts; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json pnpm exec vitest run --config vitest.config.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/schema-registry.test.ts; python3 -m py_compile libs/bellona/blender/python/bellona_addon/handlers.py; pnpm nx test @bellona/remote-protocol --skip-nx-cache --verbose; pnpm nx test @bellona/remote-host --skip-nx-cache --verbose; pnpm exec vitest run --config vitest.config.ts libs/bellona/blender/src/addon-smoke.test.ts; pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md docs/domains/bellona/extras/remote-control/implementation-tracker.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/index.ts libs/bellona/blender/python/bellona_addon/handlers.py libs/bellona/blender/src/addon-smoke.test.ts libs/bellona/blender/src/bridge/index.ts libs/bellona/blender/src/scene/index.ts libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/blender.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.ts libs/bellona/remote-protocol/src/schema-registry.test.ts; git diff --check Mocked adapter, protocol, and addon smoke coverage validate the structured command contracts, host evidence wrapping, and undo-checkpoint payloads for all six object mutations. No live macOS + Blender session exercised these handlers, so a manual hardware validation pass is still required before any release signoff that depends on real editor behavior. Next 180.C.17.03 can build collection create/delete/link/move flows on top of the same protocol-owned object-mutation and scene-evidence path without reopening undo/evidence design.
180.C.17.03 Implement blender.collection.create, blender.collection.move_object, collection visibility, collection renderability, and collection hierarchy queries with scene fixture tests. Codex Complete TODOS/phase-180.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/remote-protocol/src/blender.ts; libs/bellona/remote-protocol/src/blender.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/README.md; apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/README.md; libs/bellona/blender/python/bellona_addon/handlers.py; libs/bellona/blender/src/addon-smoke.test.ts; libs/bellona/blender/src/bridge/index.ts; libs/bellona/blender/src/scene/index.ts; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json python3 -m py_compile libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec vitest run --config vitest.config.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/blender/src/addon-smoke.test.ts; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx contracts:generate @bellona/remote-protocol; pnpm exec prettier --check TODOS/phase-180.md docs/domains/bellona/extras/remote-control/implementation-tracker.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/index.ts libs/bellona/blender/python/bellona_addon/handlers.py libs/bellona/blender/src/addon-smoke.test.ts libs/bellona/blender/src/bridge/index.ts libs/bellona/blender/src/scene/index.ts libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/blender.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.ts libs/bellona/remote-protocol/src/schema-registry.test.ts; git diff --check Mocked protocol, adapter, and addon smoke coverage validate collection hierarchy normalization plus collection create, move, viewport visibility, and renderability mutations with undo checkpoints and before/after scene evidence. No live macOS + Blender session exercised these handlers, so manual hardware validation is still required before any release signoff that depends on real editor behavior. Next 180.C.17.04 can build principled material create/assign/parameter flows on top of the same protocol-owned mutation, undo, and scene-evidence path introduced here.
180.C.17.04 Implement blender.material.create_principled, blender.material.assign, blender.material.set_parameter, texture binding, and material semantic search with before/after evidence. Codex Complete TODOS/phase-180.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/index.ts; libs/bellona/blender/python/bellona_addon/handlers.py; libs/bellona/blender/src/addon-smoke.test.ts; libs/bellona/blender/src/assets/index.ts; libs/bellona/blender/src/bridge/index.ts; libs/bellona/blender/src/scene/index.ts; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/blender.test.ts; libs/bellona/remote-protocol/src/blender.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json python3 -m py_compile libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec vitest run --config vitest.config.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/blender/src/addon-smoke.test.ts; pnpm nx run @bellona/remote-host:typecheck --skip-nx-cache; pnpm nx run @bellona/remote-host:test --skip-nx-cache; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/blender -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm nx contracts:generate @bellona/remote-protocol; pnpm exec prettier --check TODOS/phase-180.md docs/domains/bellona/extras/remote-control/implementation-tracker.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/index.ts libs/bellona/blender/src/addon-smoke.test.ts libs/bellona/blender/src/assets/index.ts libs/bellona/blender/src/bridge/index.ts libs/bellona/blender/src/scene/index.ts libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/blender.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/remote-protocol/src/schema-registry.ts; ruff format --check libs/bellona/blender/python/bellona_addon/handlers.py; git diff --check Mocked protocol, host, and addon coverage now validate principled material creation, assignment, parameter mutation, texture binding, and deterministic semantic search with undo checkpoints plus before/after scene evidence. No live Blender editor session or real texture-pack workflow was exercised, so hardware validation is still required before release signoff that depends on actual node-tree behavior. Next 180.C.17.05 can extend the same project-root, file allowlist, provenance, and evidence path to Blender asset import formats.
180.C.17.05 Implement blender.asset.import for GLB/GLTF, FBX, OBJ, USD/USDZ where supported, Alembic, image textures, and audio references with file allowlists and artifact provenance. Codex Complete TODOS/phase-180.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/index.ts; libs/bellona/blender/python/bellona_addon/handlers.py; libs/bellona/blender/src/addon-smoke.test.ts; libs/bellona/blender/src/assets/index.ts; libs/bellona/blender/src/bridge/index.ts; libs/bellona/blender/src/types.ts; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/blender.ts; libs/bellona/remote-protocol/src/blender.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json pnpm exec vitest run --config vitest.config.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/schema-registry.test.ts; python3 -m py_compile libs/bellona/blender/python/bellona_addon/handlers.py; pnpm nx run @bellona/remote-host:typecheck --skip-nx-cache; pnpm nx run @bellona/remote-host:test --skip-nx-cache; pnpm exec vitest run --config vitest.config.ts libs/bellona/blender/src/addon-smoke.test.ts; pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/blender -t lint,typecheck,test,build --skip-nx-cache --verbose; pnpm exec prettier --check TODOS/phase-180.md docs/domains/bellona/extras/remote-control/implementation-tracker.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/index.ts libs/bellona/blender/python/bellona_addon/handlers.py libs/bellona/blender/src/addon-smoke.test.ts libs/bellona/blender/src/assets/index.ts libs/bellona/blender/src/bridge/index.ts libs/bellona/blender/src/types.ts libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/blender.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.ts libs/bellona/remote-protocol/src/schema-registry.test.ts; ruff format --check libs/bellona/blender/python/bellona_addon/handlers.py; git diff --check Mocked protocol, host, and addon coverage now validate allowlisted Blender asset imports for scene formats, image textures, and audio references with project-root enforcement, source-file provenance artifacts, addon undo checkpoints, and before/after scene evidence. No live Blender editor session, large binary import, or codec-dependent audio import was exercised in this CI-visible pass, so hardware validation is still required before release signoff that depends on real editor behavior. Next 180.C.17.06 can build export and transfer-registration flows on top of the same project-root, provenance, and scene-evidence path without reopening the asset import contract design.
180.C.17.06 Implement blender.asset.export for GLB/GLTF, FBX, USD, OBJ, Alembic, image sequences, and .blend packaging with transfer registration and hash verification. Codex Complete TODOS/phase-180.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/index.ts; libs/bellona/blender/python/bellona_addon/handlers.py; libs/bellona/blender/src/addon-smoke.test.ts; libs/bellona/blender/src/assets/index.ts; libs/bellona/blender/src/bridge/index.ts; libs/bellona/blender/src/types.ts; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/blender.ts; libs/bellona/remote-protocol/src/blender.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json pnpm exec vitest run --config vitest.config.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/schema-registry.test.ts; pnpm exec vitest run --config vitest.config.ts libs/bellona/blender/src/addon-smoke.test.ts; pnpm nx run @bellona/remote-host:test --skip-nx-cache; pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/blender -t lint,typecheck,test,build --skip-nx-cache --verbose; python3 -m py_compile libs/bellona/blender/python/bellona_addon/handlers.py; ruff format --check libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec prettier --check TODOS/phase-180.md docs/domains/bellona/extras/remote-control/implementation-tracker.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/index.ts libs/bellona/blender/python/bellona_addon/handlers.py libs/bellona/blender/src/addon-smoke.test.ts libs/bellona/blender/src/assets/index.ts libs/bellona/blender/src/bridge/index.ts libs/bellona/blender/src/types.ts libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/blender.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.ts libs/bellona/remote-protocol/src/schema-registry.test.ts; git diff --check Mocked protocol, host, and addon coverage now validate allowlisted Blender asset exports for GLB/GLTF, FBX, OBJ, USD, Alembic, image-sequence, and packaged .blend outputs with project-root enforcement, addon-reported output inventories, host-side hash verification, transfer-ready export artifact registration, and before/after scene evidence. No live Blender editor session, long-running render export, or multi-file exporter plugin path was exercised in this CI-visible pass, so hardware validation is still required before release signoff that depends on actual exporter behavior. Next 180.C.17.07 can build deterministic semantic selectors on top of the same protocol-owned scene/object/material/export command surface now available through the host adapter path.
180.C.17.07 Implement semantic selectors for "all emissive objects", "selected character rig", "large static props", "objects in collection", and "materials missing textures" with deterministic query results. Codex Complete TODOS/phase-180.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/index.ts; libs/bellona/blender/python/bellona_addon/handlers.py; libs/bellona/blender/src/addon-smoke.test.ts; libs/bellona/blender/src/bridge/index.ts; libs/bellona/blender/src/index.ts; libs/bellona/blender/src/scene/index.ts; libs/bellona/blender/src/types.ts; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/src/blender.ts; libs/bellona/remote-protocol/src/blender.test.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/schema-registry.test.ts; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json pnpm exec vitest run --config vitest.config.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/schema-registry.test.ts; pnpm nx run @bellona/remote-host:test --skip-nx-cache; pnpm exec vitest run --config vitest.config.ts libs/bellona/blender/src/addon-smoke.test.ts; pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/blender -t lint,typecheck,test,build --skip-nx-cache --verbose; python3 -m py_compile libs/bellona/blender/python/bellona_addon/handlers.py; ruff format --check libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec prettier --check TODOS/phase-180.md docs/domains/bellona/extras/remote-control/implementation-tracker.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/index.ts libs/bellona/blender/python/bellona_addon/handlers.py libs/bellona/blender/src/addon-smoke.test.ts libs/bellona/blender/src/bridge/index.ts libs/bellona/blender/src/index.ts libs/bellona/blender/src/scene/index.ts libs/bellona/blender/src/types.ts libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/blender.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.ts libs/bellona/remote-protocol/src/schema-registry.test.ts; git diff --check Mocked protocol, host, and addon coverage now validate deterministic Blender semantic selector queries for emissive objects, selected rigs, large static props, recursive collection membership, and materials missing textures. No live Blender editor session, complex production rig, or real material graph audit was exercised in this CI-visible pass, so hardware validation is still required before release signoff that depends on actual scene content. Next 180.C.17.08 should add golden-scene coverage so these selector heuristics and the existing mutation paths are pinned against stable Blender fixture scenes instead of only mocked responses.
180.C.17.08 Add golden-scene tests for object edits, material edits, collection edits, import/export, undo, file save, and scene-info round trips. Codex Complete TODOS/phase-180.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/blender-adapter.test.ts pnpm nx run @bellona/remote-host:lint --skip-nx-cache; pnpm nx run @bellona/remote-host:typecheck --skip-nx-cache; pnpm nx run @bellona/remote-host:test --skip-nx-cache; pnpm nx run @bellona/remote-host:build --skip-nx-cache; pnpm exec prettier --check TODOS/phase-180.md docs/domains/bellona/extras/remote-control/implementation-tracker.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.test.ts; git diff --check Golden-scene coverage is CI-visible only: deterministic host tests now pin exact Blender scene-info, object rename, duplicate/undo, material assign, collection move, asset import, asset export, and save-as round trips against stable before/after scene fixtures, transfer ids, and file hashes. No live Blender editor session, GPU render state, or macOS hardware path was exercised here, so real editor validation remains required before any release signoff that depends on production scene behavior. Next 180.C.17.09 should add the hardware/headless verification notes that connect these deterministic fixtures to the real Blender commands that CI still cannot prove.
180.C.17.09 Add hardware/headless Blender verification notes for every command that cannot run in normal CI. Codex Complete TODOS/phase-180.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/blender-production-command-hardware-verification.md; apps/bellona/remote-host/README.md pnpm nx run @bellona/remote-host:build --skip-nx-cache; pnpm exec prettier --check TODOS/phase-180.md docs/domains/bellona/extras/remote-control/implementation-tracker.md docs/domains/bellona/extras/remote-control/blender-production-command-hardware-verification.md apps/bellona/remote-host/README.md; git diff --check The new runbook now maps every current Blender production command family to headless-vs-live verification expectations, fixture requirements, evidence-file location, rollback-note requirements, and the gap between deterministic CI and real Blender hardware behavior. No live Blender run was performed as part of this documentation item itself, so 180.C.17.10 still requires actual evidence files on MAC-HOST-01 before stage signoff. Next 180.C.17.10 should close the stage only after the documented evidence bundle exists for the Blender production command families and any unsupported format or live-editor blocker is explicitly recorded.
180.C.17.10 Check off this stage only after Blender has production scene/object/material/file/import/export command coverage through the same gateway-host-adapter-audit path. Codex Complete TODOS/phase-180.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/blender-adapter.test.ts; docs/domains/bellona/extras/remote-control/evidence/180.C.17.09/2026-04-23-MAC-HOST-01-blender-production-commands.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md pnpm nx run @bellona/remote-host:test --skip-nx-cache; pnpm nx run @bellona/remote-host:typecheck --skip-nx-cache; pnpm nx run @bellona/remote-host:build --skip-nx-cache; pnpm nx blender:scene-info-smoke @bellona/remote-host -- --required; pnpm nx blender:create-primitive-smoke @bellona/remote-host -- --required; pnpm nx blender:scene-info-remote-smoke @bellona/remote-host -- --require-live-addon; pnpm nx blender:create-primitive-remote-smoke @bellona/remote-host -- --live-addon; pnpm exec prettier --check TODOS/phase-180.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.test.ts docs/domains/bellona/extras/remote-control/evidence/180.C.17.09/2026-04-23-MAC-HOST-01-blender-production-commands.md docs/domains/bellona/extras/remote-control/implementation-tracker.md; git diff --check Stage 17 now has deterministic gateway-host-adapter-audit coverage for Blender scene info, object rename, collection hierarchy and move, material assign and semantic search, semantic selector queries, file open/save/save-as/pack/recover, asset import, and asset export in the committed host test suite. MAC-HOST-01 evidence also records passing headless scene.info and primitive smokes plus live remote addon-backed scene.info and primitive route proofs. Remaining live-editor gaps for collection/material/file/import/export variants are documented explicitly in the evidence bundle instead of being implied away. Next work stays in Phase 180 only if explicitly requested; the next unchecked item in sequence is 180.C.18.01, which is outside this completed Stage 17 scope.
180.C.18.01 Implement safe modifier stack commands: add, configure, reorder, disable viewport, disable render, apply with snapshot, and rollback note generation. Codex Complete TODOS/phase-180.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/blender-adapter.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/blender/python/bellona_addon/handlers.py; libs/bellona/blender/src/addon-smoke.test.ts; libs/bellona/blender/src/bridge/index.ts; libs/bellona/blender/src/scene/index.ts; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json; libs/bellona/remote-protocol/src/blender.test.ts; libs/bellona/remote-protocol/src/blender.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.ts pnpm exec vitest run --config vitest.config.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/schema-registry.test.ts libs/bellona/blender/src/addon-smoke.test.ts; pnpm exec vitest run --config vitest.config.ts src/blender-adapter.test.ts --reporter=verbose from apps/bellona/remote-host; pnpm nx run @bellona/remote-host:typecheck --skip-nx-cache; pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/blender -t lint,typecheck,test,build --skip-nx-cache --verbose; python3 -m py_compile libs/bellona/blender/python/bellona_addon/handlers.py; ruff format --check libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec prettier --check TODOS/phase-180.md docs/domains/bellona/extras/remote-control/implementation-tracker.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/blender-adapter.ts libs/bellona/blender/python/bellona_addon/handlers.py libs/bellona/blender/src/addon-smoke.test.ts libs/bellona/blender/src/bridge/index.ts libs/bellona/blender/src/scene/index.ts libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/blender.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.ts; git diff --check Mocked protocol, host, and addon coverage now validate canonical Blender modifier add/configure/reorder/viewport-toggle/render-toggle/apply flows with undo checkpoints, rollback notes, before/after scene evidence, and dedicated before/after modifier-stack snapshot artifacts. No live Blender editor session was exercised in this CI-visible pass, so hardware validation is still required before release signoff that depends on real modifier behavior, stack side effects, or modifier-type-specific UI state. Next 180.C.18.02 can build Geometry Nodes macros on top of the new modifier mutation capability once that work is explicitly requested.
180.C.18.02 Implement structured Geometry Nodes graph macros for scatter, cable runs, kitbash arrays, modular facades, terrain dressing, and procedural prop layout. Codex Complete TODOS/phase-180.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/package.json; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-geometry-nodes.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/blender/python/bellona_addon/handlers.py; libs/bellona/blender/src/addon-smoke.test.ts; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json; libs/bellona/remote-protocol/src/blender.test.ts; libs/bellona/remote-protocol/src/blender.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.ts pnpm exec vitest run --config vitest.config.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/schema-registry.test.ts; pnpm exec vitest run src/blender-adapter.test.ts from apps/bellona/remote-host; pnpm nx run @bellona/remote-host:typecheck --skip-nx-cache; pnpm nx run @bellona/remote-host:test --skip-nx-cache; python3 -m py_compile libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec vitest run --config vitest.config.ts libs/bellona/blender/src/addon-smoke.test.ts; pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/blender -t lint,typecheck,test,build --skip-nx-cache --verbose; ruff format --check libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec prettier --check TODOS/phase-180.md apps/bellona/remote-host/README.md apps/bellona/remote-host/package.json apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-geometry-nodes.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md libs/bellona/blender/python/bellona_addon/handlers.py libs/bellona/blender/src/addon-smoke.test.ts libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/blender.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.ts; git diff --check Canonical Phase 180 Geometry Nodes coverage now exposes a deterministic macro catalog plus audited macro execution for scatter, cable runs, kitbash arrays, modular facades, terrain dressing, and procedural prop layout. The host compiles and validates plans with @bellona/blender-agent, executes only deterministic raw geometry_nodes.* addon commands, captures before/after scene evidence and modifier-stack snapshots, and records per-plan audit artifacts so replay and rollback consumers get a stable automation contract. Live Blender editor verification is still required before release signoff that depends on real node-type behavior, UI wiring, or Blender-version-specific Geometry Nodes socket/property semantics. Next 180.C.18.03 can build safe mesh edit macros on top of the newly expanded advanced Blender automation surface once that work is explicitly requested.
180.C.18.03 Implement safe mesh edit macros for bevel, extrude, inset, merge by distance, normal recalculation, UV unwrap, decimate, and triangulate with selection preconditions. Codex Complete TODOS/phase-180.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/blender-adapter.test.ts; apps/bellona/remote-host/src/blender-adapter.ts; apps/bellona/remote-host/src/blender-mesh-edit.ts; docs/domains/bellona/extras/remote-control/implementation-tracker.md; libs/bellona/blender/python/bellona_addon/handlers.py; libs/bellona/blender/src/addon-smoke.test.ts; libs/bellona/remote-protocol/README.md; libs/bellona/remote-protocol/contracts/json-schema/bellona-remote-protocol.schema.json; libs/bellona/remote-protocol/contracts/openapi/bellona-remote-protocol.openapi.json; libs/bellona/remote-protocol/contracts/proto/bellona-remote-protocol.manifest.json; libs/bellona/remote-protocol/src/blender.test.ts; libs/bellona/remote-protocol/src/blender.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/schema-registry.ts pnpm exec vitest run --config vitest.config.ts libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/schema-registry.test.ts; pnpm exec vitest run src/blender-adapter.test.ts from apps/bellona/remote-host; pnpm nx run @bellona/remote-host:typecheck --skip-nx-cache; python3 -m py_compile libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec vitest run --config vitest.config.ts libs/bellona/blender/src/addon-smoke.test.ts; pnpm nx contracts:generate @bellona/remote-protocol; pnpm nx run-many -p @bellona/remote-protocol,@bellona/remote-host,@bellona/blender -t lint,typecheck,test,build --skip-nx-cache --verbose; ruff format --check libs/bellona/blender/python/bellona_addon/handlers.py; pnpm exec prettier --check TODOS/phase-180.md apps/bellona/remote-host/README.md apps/bellona/remote-host/src/blender-adapter.test.ts apps/bellona/remote-host/src/blender-adapter.ts apps/bellona/remote-host/src/blender-mesh-edit.ts docs/domains/bellona/extras/remote-control/implementation-tracker.md libs/bellona/blender/python/bellona_addon/handlers.py libs/bellona/blender/src/addon-smoke.test.ts libs/bellona/remote-protocol/README.md libs/bellona/remote-protocol/src/blender.test.ts libs/bellona/remote-protocol/src/blender.ts libs/bellona/remote-protocol/src/fixtures.ts libs/bellona/remote-protocol/src/schema-registry.ts; git diff --check Canonical Phase 180 mesh-edit coverage now exposes a deterministic macro catalog plus audited edit execution for bevel, extrude, inset, merge-by-distance, normal recalculation, UV unwrap, decimate, and triangulate. The host enforces canonical selection-domain requirements, captures before/after scene evidence plus dedicated mesh-selection snapshots, and normalizes undo-backed rollback notes, while the addon executes only deterministic mesh.* edit commands with explicit precondition checks. Live Blender editor verification is still required before release signoff that depends on real edit-mode context, operator poll behavior, or Blender-version-specific UV and decimation semantics. Next 180.C.18.04 can build camera and lighting presets on top of the expanded advanced Blender automation surface once that work is explicitly requested.
180.C.18.04 Implement camera and lighting presets for product shot, three-point lighting, HDRI lookdev, cinematic blocking, orthographic asset preview, and turntable render. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.18.05 Implement render commands for viewport screenshot, OpenGL preview, Cycles/Eevee still render, playblast, thumbnail capture, progress events, cancel, and artifact registration. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.18.06 Implement rigging setup macros for armature creation, IK/FK setup, retarget preparation, control shapes, and pose-library operations behind approval gates. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.18.07 Implement simulation setup macros for cloth, rigid body, soft body, particle, fluid, and smoke as guided setup only, with bake commands blocked until explicit approval exists. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.18.08 Implement arbitrary Blender Python as a privileged command with static preflight, project-root constraints, approval, redaction, and full command/result audit. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.18.09 Integrate libs/bellona/blender-agent validation rules before applying high-level automation plans and record validation findings in the timeline. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.18.10 Check off this stage only after advanced Blender automation is policy-gated, test-covered, reversible where possible, and visible in the Control Room timeline. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.19.01 Implement browser.back, browser.forward, browser.reload, browser.new_tab, browser.close_tab, browser.switch_tab, and browser target inventory with CDP tests. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.19.02 Implement DOM-aware browser.click_element, browser.type_into, browser.select, browser.submit, and browser.wait_for with accessible selector fallback and failure evidence. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.19.03 Implement download handling with project-root destination, file hash, content-type recording, blocked extension policy, and artifact registration. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.19.04 Implement upload handling with approved source paths, file-size limits, origin policy, operator approval for sensitive uploads, and browser trace evidence. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.19.05 Implement optional persistent automation profiles with explicit grants, per-origin restrictions, session expiry, and revocation. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.19.06 Implement real personal Chrome profile access only as a privileged mode with explicit human consent, visible stream, restricted origins, and credential-entry privacy controls. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.19.07 Implement browser trace recording for failed tasks and attach trace artifacts to the command timeline. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.19.08 Implement prompt-injection test pages that try to exfiltrate cookies, bypass policy, submit forms, upload files, or instruct the agent to ignore Oshun rules. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.19.09 Add task templates for production-board updates, asset marketplace search, documentation lookup, account-free research, and authenticated admin workflows. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.19.10 Check off this stage only after browser automation covers deterministic web tasks with profile isolation, origin policy, artifacts, prompt-injection tests, and audit. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.20.01 Evaluate Browser Use local mode, Browser Use cloud mode, and direct CDP against the same browser task fixtures and document reliability, privacy, latency, and cost tradeoffs. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.20.02 Implement a browser-agent provider interface that can route tasks to direct CDP, Browser Use local, Browser Use cloud, or another MCP browser provider without changing planner code. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.20.03 Normalize Browser Use or external browser-agent step events into Oshun command progress, timeline events, screenshots, traces, and audit entries. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.20.04 Add policy gates that prevent third-party browser providers from receiving authenticated profiles, sensitive origins, file uploads, or form submissions without explicit approval. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.20.05 Add tests proving Browser Use integration cannot bypass Oshun command schemas, device policy, approvals, redaction, or audit. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.20.06 Evaluate whether a Chrome extension adds concrete value beyond CDP for overlays, profile grants, page annotations, and consent UI. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.20.07 If extension mode is approved, implement the minimal manifest, domain-scoped permissions, extension-origin authentication, and visible automation indicator. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.20.08 Add extension tests for malicious iframes, clipboard access, file upload prompts, form submission, blocked origins, and extension disable/uninstall. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.20.09 Document when direct CDP, Browser Use, extension mode, and desktop fallback are each allowed. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.20.10 Check off this stage only after browser-agent delegation is optional, policy-controlled, observable, and never required for the deterministic browser MVP. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.01 Expand the Control Room device list with adapter versions, missing permissions, active app state, resource pressure, last seen, and diagnostic actions. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.02 Expand the session page with active agent task, plan, current tool call, command queue, command timeline, approval queue, artifact panel, and session notes. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.03 Implement live stream source switching between display, app window, browser tab, Blender viewport, Unreal viewport, and screenshot-only low-bandwidth mode. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.04 Implement stream overlays for agent cursor, clicks, drags, key events, selected window, selected Blender object, active Unreal actor, and browser target element where available. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.05 Implement privacy controls for excluded windows, blurred regions, credential-entry pause, recording disable, and screenshot redaction preview. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.06 Implement operator controls for pause, resume, stop, takeover, release takeover, approve once, approve for session, deny, edit constraints, and ask agent to revise plan. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.07 Implement audit replay view synchronized across timeline, screenshots, optional stream segments, commands, approvals, and artifacts. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.08 Implement search and filters across commands, artifacts, file paths, Blender object names, Unreal actor names, URLs, approvals, status, and risk class. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.09 Add Playwright and accessibility tests for all Control Room states: loading, empty, offline, online, streaming, approval, takeover, failed command, replay, and redacted content. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.10 Check off this stage only after a human can supervise, interrupt, approve, take over, replay, and understand a full remote session from the UI. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.11 Implement a live cost visibility panel showing real-time per-session token, gateway compute, TURN bandwidth, render-minute, and build-minute spend with a running total and per-command attribution so operators can decide before approving the next step. Uses the abstraction from 180.C.31.07. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.12 Implement a multi-session grid/mosaic view with mini-streams, a consolidated cross-session approval queue, and a cross-session risk ranking so an operator supervising several agents in parallel knows where to look next. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.13 Implement frame-accurate stream scrubbing backed by a keyframe index (pairs with 180.C.25.15) so operators can jump to any moment in a replay without replaying from the start. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.14 Implement a timeline annotation layer: operator notes tied to specific timestamps, stream moments, or commands, persisted in audit and visible in replay. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.15 Implement named bookmarks with persistence, export, and per-user bookmark lists across sessions. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.16 Implement secure expiring share links for specific timeline moments: signed URLs, audit-linked access, configurable expiry, and automatic revocation when the underlying session is redacted or tombstoned via 180.C.27.17. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.17 Implement a diff view for file and scene changes: visual before/after for text files, image diffs for screenshots, structural diff for Blender scene-info snapshots, and actor diff for Unreal world queries. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.18 Implement i18n/l10n in Control Room: string extraction, per-locale date/number/currency formatting, RTL layout, and translator-friendly resource files. Consumes scaffolding from 180.C.31.01. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.19 Implement screen-reader-friendly timeline semantics, high-contrast and reduced-motion themes, and WCAG 2.1 AA conformance tested at every Control Room milestone per 180.C.31.02. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.21.20 Run a structured usability test with new operators: time-to-approve under pressure, clarity of policy explanations, approve/deny error rate, takeover discoverability. Report findings and fix the top three friction points before release. Codex Blocked testing/bellona/remote-control/operator-usability-study.ts; testing/bellona/remote-control/tests/operator-usability-study.test.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/README.md; testing/bellona/remote-control/final-ga-release-gate.ts; testing/bellona/remote-control/tests/final-ga-release-gate.test.ts; docs/domains/bellona/extras/remote-control/operator-usability-study.md; docs/domains/bellona/extras/remote-control/final-ga-release-gate.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts tests/operator-usability-study.test.ts --reporter=verbose from testing/bellona/remote-control passed with 1 file / 27 tests. Full recruited operator study not run. Local gate only; requires recruited new operators under pressure and fix evidence for the observed top-three friction points. Malformed, non-canonical, or placeholder participant identities/roles, duplicate per-participant scenario observations, metric-only observations without evidence-kind-scoped artifacts, published reports without recruited participant or validated observation evidence links, reports that cite invalid or incomplete observations, reports outside or escaping the canonical evidence path, observation artifacts that do not identify their participant/scenario/evidence-kind context with concrete non-placeholder suffixes, stale, non-canonical timestamp, or malformed observation/report metadata, reports published before observations, zero-duration human timing metrics, duplicate friction-point IDs, invalid severity, and reused, blank, placeholder, or non-contextual fix-evidence records without concrete non-placeholder suffixes, without canonical UTC millisecond verification timestamps, or verified before the findings report do not satisfy the evaluator. Blocked on external recruited-operator usability study and implementation/verification of the observed top-three friction fixes.
180.C.22.01 Implement project root grants with allowed paths, denied paths, read/write scopes, conflict policy, and audit-visible grant state. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.02 Implement resumable file transfer to host with hash verification, destination validation, disk-space preflight, overwrite approval, and transfer progress events. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.03 Implement file transfer from host for screenshots, renders, exports, logs, traces, and diagnostic bundles with artifact metadata and retention policy. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.04 Implement file snapshots before destructive operations and restore for project-local files. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.05 Integrate artifact storage with S3/MinIO or the existing Oshun artifact store and record hashes, sizes, content types, and provenance links. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.06 Implement "Isis to Blender": generated asset selected, transferred, imported, materialized, preview rendered, and provenance attached. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.07 Implement "Blender to Unreal": selected asset exported, transferred, imported into Unreal, placed in map, screenshot verified, and audit-linked. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.08 Implement "Unreal render to Yemaya": Movie Render Queue or screenshot output collected, uploaded, attached to review, and timeline linked. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.09 Implement "browser research to asset action": browser references captured with citations/screenshots, then applied through Blender or Unreal after approval. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.10 Check off this stage only after core cross-app creative flows work through transfers, artifacts, provenance, approvals, and audit. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.11 Implement an asset dependency graph indexing which Blender materials, Unreal material instances, Substance packages, and downstream assets reference each texture, mesh, or source asset. Update on import, export, and mutation events. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.12 Implement reference integrity queries: find broken references, detect missing source files, report stale assets, and flag upstream changes that invalidate downstream artifacts. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.13 Implement an impact-preview command used by the dry-run plans in 180.C.14.23 that lists downstream artifacts affected by a proposed edit, including which collaborators' working files may need refresh. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.22.14 Implement an optional production-tracking integration (Autodesk Flow/Shotgun, ftrack, Kitsu) so agent actions reflect as task status updates, note attachments, and version publishes where configured. Cross-references 180.C.34.06. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.23.01 Implement unreal.map.open, unreal.map.save, unreal.map.create, and unreal.map.list with source-control and dirty state reporting. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.23.02 Implement unreal.actor.destroy, unreal.actor.set_transform, unreal.actor.set_property, unreal.actor.attach, and unreal.actor.select with editor transactions and policy gates. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.23.03 Implement unreal.blueprint.call_function with schema validation, allowlist support, structured result, and approval for non-allowlisted functions. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.23.04 Implement unreal.material.set_parameter for scalar, vector, texture, and material instance targets with screenshot evidence. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.23.05 Implement unreal.asset.import for GLB/FBX/USD/textures and unreal.asset.reimport for source asset updates with provenance. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.23.06 Implement unreal.asset.find, unreal.asset.rename, unreal.asset.move, unreal.asset.delete, and redirector fixup with approval for destructive operations. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.23.07 Implement unreal.console.execute with allowlist, approval for arbitrary commands, command output capture, and high-risk audit. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.23.08 Add Unreal fixture tests for map open/save, actor mutation, material update, asset import, Blueprint call, console allowlist, undo/transaction, and policy denial. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.23.09 Add hardware Unreal verification notes for every command that cannot run in normal CI. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.23.10 Check off this stage only after Unreal editor control is production-capable for maps, actors, materials, assets, Blueprint, console allowlist, evidence, and audit. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.24.01 Implement unreal.sequencer.list, unreal.sequencer.open, unreal.sequencer.set_frame, unreal.sequencer.play, and unreal.sequencer.render_preview. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.24.02 Implement Unreal viewport, active camera, and named camera screenshot capture with artifact registration. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.24.03 Implement Movie Render Queue/Movie Render Graph job creation, launch, progress, cancel, output collection, and artifact linking. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.24.04 Implement Play-in-Editor controls for start, stop, eject, state query, and restricted input injection where policy allows. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.24.05 Implement build/cook/package commands with platform target, configuration, map list, output path, logs, progress, cancel, and artifact collection. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.24.06 Implement shader compile, derived data cache, asset registry, and source-control status reporting so agents can wait and recover intelligently. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.24.07 Implement Unreal diagnostic bundle collection for editor logs, crash reports, plugin logs, project settings, adapter telemetry, and recent command timeline. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.24.08 Add virtual-production observation hooks for Live Link status, nDisplay/Switchboard status, camera tracking state, and stage monitor screenshots as read-only capabilities. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.24.09 Add performance benchmarks for world query, actor mutation, screenshot capture, asset import, render job, and build command overhead. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.24.10 Check off this stage only after Unreal long-running render/build/editor workflows are observable, cancellable, artifact-linked, and recoverable. Codex Complete TODOS/phase-180.md; libs/bellona/remote-protocol/src/unreal.ts; libs/bellona/remote-protocol/src/schema-registry.ts; libs/bellona/remote-protocol/src/fixtures.ts; libs/bellona/remote-protocol/src/live-link.ts; libs/bellona/remote-protocol/src/unreal.test.ts; apps/bellona/remote-host/src/unreal-adapter.ts; apps/bellona/remote-host/src/unreal-adapter.test.ts; apps/bellona/remote-host/src/unreal-adapter-fixtures.test.ts; docs/domains/bellona/extras/remote-control/unreal-hardware-verification.md pnpm exec vitest run --config vitest.config.ts src/unreal.test.ts --reporter=dot from libs/bellona/remote-protocol (110 tests); pnpm nx test @bellona/remote-host -- unreal-adapter.test.ts unreal-adapter-fixtures.test.ts windows-host-support.test.ts --reporter=dot (3 files / 88 tests) CI validates command contracts, fixtures, adapter dispatch, policy/approval gates, audit/evidence shapes, and provider fallback behavior; live viewport, GPU, cook/package, and final release evidence remain gated by 180.C.29.08-.10 with requirements documented in unreal-hardware-verification.md. None for the checklist item; final release hardware-in-the-loop and acceptance remain gated by 180.C.29.08-.10.
180.C.25.01 Implement mDNS/Bonjour discovery for same-LAN hosts while keeping identity verification certificate/token based. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.02 Implement direct LAN TLS/WebSocket command routing when policy allows it, with fallback to gateway tunnel. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.03 Implement host-initiated outbound gateway tunnel over port 443 with reconnect, session resume tokens, duplicate suppression, and backoff. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.04 Implement WebRTC TURN relay fallback with stream metrics showing direct versus relay mode. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.05 Separate transport channels for control, events, logs, file transfer, artifact metadata, stream signaling, and emergency stop. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.06 Implement backpressure and priority handling for emergency stop, approval, observe, interactive control, engine command, file transfer, batch job, and telemetry. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.07 Add network impairment tests for high latency, packet loss, gateway restart, host sleep/wake, NAT change, Wi-Fi disconnect, and laptop lid close. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.08 Create production-ready Hetzner deployment with TLS, gateway service, TURN, database, object storage, logs, monitoring, backups, and smoke test. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.09 Create production-ready AWS deployment with load balancer, gateway service, RDS/Postgres, Redis, S3/object storage, logs, monitoring, TURN, backups, and smoke test. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.10 Add optional Tailscale/WireGuard private-network mode with setup docs, trust boundaries, diagnostics, and explicit guidance that it does not replace gateway auth or policy. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.11 Evaluate QUIC/WebTransport for future multiplexed control and media signaling, document whether to adopt, defer, or reject it, and capture migration requirements if adopted later. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.12 Check off this stage only after same-LAN and cloud-agent modes both work, recover from network failures, and expose clear diagnostics. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.13 Implement HDR and wide-gamut stream support (PQ/HLG transfer functions) with color-space metadata carried in RemoteStreamDescriptor and preserved end-to-end from capture to Control Room preview. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.14 Implement multi-track streaming: separate tracks for cursor, audio, and region-of-interest video, enabling bandwidth- adaptive encoding and selective recording. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.15 Implement stream recording with a keyframe index for fast seek in replay (pairs with scrubbing in 180.C.21.13). Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.16 Implement hardware codec selection with a documented fallback chain: VideoToolbox on macOS, NVENC on Windows, VA-API on Linux, software fallback otherwise. Record the selected codec in session metadata. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.25.17 Implement bandwidth-adaptive bitrate with sender-side bandwidth estimation and automatic quality switch under congestion, exposing direct-versus-relay mode and current bitrate in operator UI. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.26.01 Build the macOS Remote Host app shell with menu bar status, local pause/stop/unpair controls, diagnostics, and session-active indicator. Codex Complete apps/bellona/remote-host/macos/Package.swift; apps/bellona/remote-host/macos/Sources/BellonaRemoteHostShell/*.swift; apps/bellona/remote-host/macos/scripts/bundle-app.sh; apps/bellona/remote-host/src/local-control.ts; apps/bellona/remote-host/src/local-control.test.ts; apps/bellona/remote-host/src/app.ts; apps/bellona/remote-host/src/identity-store.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/scripts/macos-menu-bar-shell-evidence.ts; docs/domains/bellona/extras/remote-control/evidence/180.C.26.01/2026-07-07-MAC-HOST-03-menu-bar-shell-run.md swift build -c release + macos/scripts/bundle-app.sh (bundle assembled, plutil -lint OK); pnpm exec vitest run src/local-control.test.ts (1 file / 12 tests); full remote-host suite 69 files / 923 tests; pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; live run on macOS rig MAC-HOST-03 via scripts/macos-menu-bar-shell-evidence.ts (real gateway + real host + native shell) Live hardware run on MAC-HOST-03 (macOS 26.5.2, Apple Silicon, 2026-07-07): native NSStatusItem shell rendered the host-derived menu-bar model (paired+connected, honest TCC/adapter attention reasons), pause/resume/stop-session/diagnostics/unpair exercised end-to-end over the loopback token-guarded local-control surface, unpair removed the development identity file, SIGTERM exited cleanly. See evidence/180.C.26.01/2026-07-07-MAC-HOST-03-menu-bar-shell-run.md (artifact IDs artifact:180.C.26.01:menu-bar-shell-run:2026-07-07-mac-host-03-*). None for this item; Developer ID signing of the bundle remains 180.C.26.06, and signed-package install QA remains 180.C.26.09.
180.C.26.02 Implement LaunchAgent registration, restart after crash, graceful shutdown, and clean uninstall. Codex Complete apps/bellona/remote-host/macos/ (shell + bundle script used by the run); docs/domains/bellona/extras/remote-control/evidence/180.C.26.02/2026-07-07-MAC-HOST-03-launch-agent-lifecycle-run.md Live launchd run on macOS rig MAC-HOST-03 per createMacOSLaunchAgentLifecyclePlan(): plutil -lint; launchctl bootstrap/enable/kickstart gui/$(id -u); launchctl print (state = running); kill -9 shell -> KeepAlive restart (pid 77576 -> 78231); kill -9 host child -> shell supervision restart (pid 77591 -> 78424); launchctl kill TERM -> graceful stop, last exit code = 0, NOT restarted; launchctl bootout + plist + bundle removal -> service gone See evidence/180.C.26.02/2026-07-07-MAC-HOST-03-launch-agent-lifecycle-run.md (artifact IDs artifact:180.C.26.02:launch-agent-lifecycle-run:2026-07-07-mac-host-03-*): bootstrap/print transcripts, KeepAlive crash-restart pids, child-supervision restart log, host.stopping reason: SIGTERM graceful chain, clean-uninstall verification. Host on real darwin defaulted to the macOS Keychain identity store and failed loud on the missing item. None for this item; signed/notarized agent packaging remains 180.C.26.06 and signed-package install QA remains 180.C.26.09.
180.C.26.03 Implement first-run onboarding for Screen Recording, Accessibility, Automation, Files and Folders, local network access, and exact missing-permission diagnostics. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.26.04 Implement app and adapter discovery for Blender versions, Unreal versions, Chrome/Chromium, Playwright browsers, Bellona bridge services, plugins, and addon install state. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.26.05 Implement install/repair/uninstall actions for Blender addon, Unreal plugin, browser helper, and stream/desktop helper processes. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.26.06 Code-sign and notarize Remote Host, helper tools, LaunchAgent, Blender addon package, Unreal plugin package, and update installer. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/macos-host-support.ts; apps/bellona/remote-host/src/macos-host-support.test.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/macos-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md pnpm nx test @bellona/remote-host -- macos-host-support.test.ts --reporter=verbose (1 file / 30 tests); pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/macos-host-support.ts apps/bellona/remote-host/src/macos-host-support.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/macos-host-local-contracts.md docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md docs/domains/bellona/extras/remote-control/implementation-tracker.md; pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host; scripts/stub-indicator-scan.sh --mode=all apps/bellona/remote-host/src/macos-host-support.ts apps/bellona/remote-host/src/index.ts; git diff --check Local contracts are implemented only; the local gate rejects malformed signing env, missing per-scenario QA artifacts, incomplete, stale, or non-canonical timestamp evidence metadata, QA artifacts without scenario/evidence-kind context, non-macOS host runner records, stale or non-canonical QA run timestamps, generic install-QA operator identities, artifact IDs duplicated within or across QA/stage records, stage artifacts that do not identify both their checklist item and exact evidence slot, generic install-QA summaries without complete per-scenario records, non-developer acceptance without a non-developer operator identity, empty or placeholder runner/operator/artifact suffixes, stale or non-canonical pre-contract stage evidence, and placeholder Stage 26 booleans. Final evidence requires native AppKit/SwiftUI menu-bar execution, launchd registration on macOS, Apple Developer ID signing/notarization/stapling, install QA on a physical macOS host, and non-developer acceptance evidence. Signing and notarization remain blocked until Apple Developer ID credentials and a macOS codesign/notarytool runner are available.
180.C.26.07 Implement signed update manifests, channels, canary rollout, compatibility checks, rollback, and emergency update revocation. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.26.08 Implement diagnostic bundle creation with redaction and user-approved upload. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.26.09 Add clean install, upgrade, permission revoked, adapter repair, update rollback, crash-loop, and uninstall tests/manual QA. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/macos-host-support.ts; apps/bellona/remote-host/src/macos-host-support.test.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/macos-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md pnpm nx test @bellona/remote-host -- macos-host-support.test.ts --reporter=verbose (1 file / 30 tests); pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/macos-host-support.ts apps/bellona/remote-host/src/macos-host-support.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/macos-host-local-contracts.md docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md docs/domains/bellona/extras/remote-control/implementation-tracker.md; pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host; scripts/stub-indicator-scan.sh --mode=all apps/bellona/remote-host/src/macos-host-support.ts apps/bellona/remote-host/src/index.ts; git diff --check Local contracts are implemented only; the local gate rejects malformed signing env, missing per-scenario QA artifacts, incomplete, stale, or non-canonical timestamp evidence metadata, QA artifacts without scenario/evidence-kind context, non-macOS host runner records, stale or non-canonical QA run timestamps, generic install-QA operator identities, artifact IDs duplicated within or across QA/stage records, stage artifacts that do not identify both their checklist item and exact evidence slot, generic install-QA summaries without complete per-scenario records, non-developer acceptance without a non-developer operator identity, empty or placeholder runner/operator/artifact suffixes, stale or non-canonical pre-contract stage evidence, and placeholder Stage 26 booleans. Final evidence requires native AppKit/SwiftUI menu-bar execution, launchd registration on macOS, Apple Developer ID signing/notarization/stapling, install QA on a physical macOS host, and non-developer acceptance evidence. Install QA remains blocked until the macOS clean-install, upgrade, permission-revoked, adapter-repair, rollback, crash-loop, and uninstall scenarios can run on the hardware rig.
180.C.26.10 Add SBOM generation, dependency vulnerability scanning, license checks, malware scanning expectations, and release evidence for host app, gateway, Control Room, Blender addon, Unreal plugin, browser helper, and native helpers. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.26.11 Add macOS hardened runtime, entitlement, sandbox/not sandboxed rationale, Accessibility/Screen Recording permission rationale, and notarization failure recovery documentation. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.26.12 Add tamper detection for modified host binaries, unsigned helper tools, unexpected plugin files, mismatched update manifests, and local adapter binaries outside expected hashes. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.26.13 Add MDM-friendly and offline/private-studio install/update paths with configuration profile guidance and no-cloud update option. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.26.14 Check off this stage only after a non-developer can install, pair, grant permissions, run, update, diagnose, and uninstall the Remote Host safely. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/README.md; apps/bellona/remote-host/src/macos-host-support.ts; apps/bellona/remote-host/src/macos-host-support.test.ts; apps/bellona/remote-host/src/index.ts; docs/domains/bellona/extras/remote-control/macos-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; testing/bellona/remote-control/final-ga-release-gate.ts; testing/bellona/remote-control/tests/final-ga-release-gate.test.ts; docs/domains/bellona/extras/remote-control/final-ga-release-gate.md pnpm nx test @bellona/remote-host -- macos-host-support.test.ts --reporter=verbose (1 file / 30 tests); pnpm exec prettier --check apps/bellona/remote-host/README.md apps/bellona/remote-host/src/macos-host-support.ts apps/bellona/remote-host/src/macos-host-support.test.ts apps/bellona/remote-host/src/index.ts docs/domains/bellona/extras/remote-control/macos-host-local-contracts.md docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md docs/domains/bellona/extras/remote-control/implementation-tracker.md; pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host; scripts/stub-indicator-scan.sh --mode=all apps/bellona/remote-host/src/macos-host-support.ts apps/bellona/remote-host/src/index.ts; git diff --check Local contracts are implemented only and now referenced by the final-GA evidence gate; the local gate rejects malformed signing env, missing per-scenario QA artifacts, incomplete, stale, or non-canonical timestamp evidence metadata, QA artifacts without scenario/evidence-kind context, non-macOS host runner records, stale or non-canonical QA run timestamps, generic install-QA operator identities, artifact IDs duplicated within or across QA/stage records, stage artifacts that do not identify both their checklist item and exact evidence slot, generic install-QA summaries without complete per-scenario records, non-developer acceptance without a non-developer operator identity, empty or placeholder runner/operator/artifact suffixes, stale or non-canonical pre-contract stage evidence, and placeholder Stage 26 booleans. Final evidence requires native AppKit/SwiftUI menu-bar execution, launchd registration on macOS, Apple Developer ID signing/notarization/stapling, install QA on a physical macOS host, and non-developer acceptance evidence. Stage gate remains blocked until 180.C.26.01, .02, .06, and .09 produce live macOS evidence and a non-developer acceptance run passes.
180.C.26.15 Implement continuous DCC plugin integrity checks: verify Blender addon and Unreal plugin hashes on every session start (not only at install time), block session start on mismatch, and emit a tamper-detection audit event. Extends 180.C.26.12. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.26.16 Implement the cross-platform permission abstraction interface in libs/bellona/host-runtime so Windows and Linux hosts (180.C.36, 180.C.37) can plug in without duplicating adapter and command code. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.26.17 Treat this stage as two logical units for future work planning: items .01-.08 are macOS Host App, items .09-.16 are Signing, Updates, SBOM, and Integrity. Future refactors may split them into 180.C.26.A and 180.C.26.B. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.01 Implement device key rotation, device revocation, suspicious clone detection, local unpairing, and trusted gateway pinning. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.02 Implement host-side deny rules that cannot be overridden by a compromised gateway. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.03 Implement project-root enforcement blocking home directories, SSH keys, password stores, browser secrets, system settings, and unrelated repositories by default. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.04 Implement credential-entry mode where the human enters secrets locally while stream capture is paused or blurred and no keystroke data is logged. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.05 Implement redaction for logs, screenshots, traces, browser content, command payloads, file paths, API keys, tokens, and personal data. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.06 Implement organization controls for device pairing, session start, stream access, risky approval, audit export, MCP clients, and external browser providers. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.07 Implement spend and usage controls for cloud agent tokens, gateway compute, TURN bandwidth, artifact storage, render jobs, and build jobs. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.08 Implement audit retention policies, data residency options, access review, and administrator reports for devices/sessions. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.09 Add security review tests for prompt injection, denied paths, sensitive windows, approval bypass, revoked device, token redaction, third-party browser delegation, and local deny rules. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.10 Complete privacy/legal review for remote screen capture, browser session handling, employee monitoring risk, consent, recording retention, audit export, and cross-border artifact storage. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.11 Add organization policy templates for solo creator, small studio, enterprise studio, education lab, local-only private mode, and locked-down review-only mode. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.12 Check off this stage only after the system is safe enough for real authenticated browser, file, Blender, Unreal, and desktop sessions. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.13 Implement agent identity and delegation-chain audit end-to-end: operator, orchestrator, specialist, and adapter threaded through every audit entry, approval decision, command envelope, and timeline event using RemoteActor from 180.C.03.13. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.14 Implement consent capture for incidentally-recorded subjects in stream content: FaceTime windows, dictation overlays, bystander cameras, visible documents. Prompt-based consent with redaction fallback when consent is unavailable. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.15 Implement stream and recording watermarking (visible and cryptographic) for leak attribution back to session, operator, and agent chain. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.16 Implement jurisdiction-aware retention defaults (EU, California, UK, US federal) with operator override, documented defaults per organization template, and automated enforcement. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.17 Implement a right-to-erasure workflow reconciling user-deletion requests with append-only audit: tombstoning, cryptographic erasure of redaction targets, and a documented compliance pathway preserving audit integrity while honoring deletion requests. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.27.18 Extend tamper detection from install-time (180.C.26.12) to continuous: re-verify host binaries, helper tools, Blender addons, Unreal plugins, and native helpers at every session start and periodically during long sessions. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.01 Add dashboards for gateway health, host fleet health, command latency, command failure, stream quality, approval latency, adapter health, reconnects, and audit write failures. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.02 Add alerts for host offline, command failure spike, stream failure, policy violation attempt, crash loop, update failure, audit store unavailable, and relay cost spike. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.03 Implement tamper-evident audit hash chains for high-trust command sessions. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.04 Implement replay bundles containing timeline, screenshots, optional stream segments, command payloads, result summaries, approvals, artifacts, and redaction metadata. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.05 Implement replay export and machine-readable audit export for compliance, debugging, and incident review. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.06 Implement failure taxonomy and user-facing error codes for host offline, gateway offline, adapter offline, app missing, app crashed, permission missing, timeout, policy denial, approval timeout, network degraded, stream failed, and artifact transfer failed. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.07 Implement degraded modes: command-only without stream, observe-only without control, screenshot-only low bandwidth, and local-only without cloud. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.08 Implement recovery flows for adapter restart, app crash, failed mutation rollback, interrupted file transfer, browser crash, and Unreal/Blender restart. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.09 Add chaos tests for process crash, gateway restart, network loss, permission revocation, host sleep, stream freeze, and audit store outage. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.10 Check off this stage only after operations can diagnose, replay, recover, and audit real failures without guessing. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.11 Implement outbound event sinks: webhooks with retry and HMAC signing, Slack approval cards, Discord notifications, and email digests for approvals, failures, and completions. Operators choose channels per event class. Full subsystem in 180.C.34. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.12 Implement ticketing integration (Linear, Jira) for session outcomes and failure tickets, and on-call integration (PagerDuty, Opsgenie) for operational alerts. Bidirectional where APIs allow, for example marking a ticket resolved on session success. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.28.13 Implement SLO error-budget automation: track the budgets defined in 180.C.16.12, block release when burn rate exceeds policy, and surface remaining budget in operational dashboards. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.29.01 Add or update all architecture docs for topology, trust boundaries, protocols, adapters, policy, gateway, host, Control Room, and cloud deployments. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.29.02 Add user/operator docs for two-MacBook LAN setup, Hetzner/AWS setup, pairing, permissions, Blender, Unreal, browser, Control Room, approvals, takeover, replay, and uninstall. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.29.03 Add developer docs for adding commands, adapters, MCP tools, policy rules, approval gates, audit evidence, and tests. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.29.04 Add TypeScript SDK coverage for device, session, command, stream, approval, artifact, audit, Blender, Unreal, browser, desktop, and file operations. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.29.05 Add Python client generation or SDK coverage for automation scripts and notebooks. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.29.06 Add bellona remote CLI commands for pair, devices, sessions, stream, command, approve, diagnose, artifacts, audit export, and unpair. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.29.07 Add end-to-end examples: Blender create/render/export, Unreal import/place/capture, browser production-board update, cloud-agent control, and desktop fallback dialog handling. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.29.08 Run final verification: format, lint, typecheck, unit, integration, contract, Playwright, security, performance, deployment smoke, and hardware-in-the-loop checks. Codex Blocked testing/bellona/remote-control/final-ga-release-gate.ts; testing/bellona/remote-control/tests/final-ga-release-gate.test.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/README.md; docs/domains/bellona/extras/remote-control/final-ga-release-gate.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/release-gate-alignment.md; docs/domains/bellona/extras/remote-control/README.md; TODOS/phase-180.md pnpm --dir testing/bellona/remote-control exec vitest run tests/final-ga-release-gate.test.ts --reporter=verbose passed with 1 file / 36 tests. Full final release matrix still not run because it requires live cloud and hardware evidence. Local final-GA gate contract now requires structured dated verification evidence records with command, full 40-character commit SHA, environment, canonical UTC millisecond timestamp, and artifact context; final verification evidence still requires deployed cloud smoke plus real macOS/Windows hardware-in-the-loop runs. Bare requirement ID summaries, generic or placeholder artifact IDs without record-kind/requirement/evidence-suffix context, non-contextual or placeholder release identities, duplicate structured records for the same requirement, and artifact IDs reused across evidence groups do not satisfy the gate. Blocked until the final release verification matrix and release-evidence checks can run end to end on the required live cloud environments and macOS/Windows hardware.
180.C.29.09 Produce release evidence: test logs, screenshots, stream captures where allowed, diagnostic bundles, security review, known risks, rollback plan, and compatibility matrix. Codex Blocked testing/bellona/remote-control/final-ga-release-gate.ts; testing/bellona/remote-control/tests/final-ga-release-gate.test.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/README.md; docs/domains/bellona/extras/remote-control/final-ga-release-gate.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/release-gate-alignment.md; docs/domains/bellona/extras/remote-control/README.md; TODOS/phase-180.md pnpm --dir testing/bellona/remote-control exec vitest run tests/final-ga-release-gate.test.ts --reporter=verbose passed with 1 file / 36 tests. Full final release matrix still not run because it requires live cloud and hardware evidence. Local structured evidence-record contract only; automated release-log evidence requires command, full 40-character commit SHA, and environment context, and release evidence still needs live logs, screenshots/streams, diagnostic bundles, security review, rollback, compatibility, supply-chain evidence, Stage 26 macOS host packaging/acceptance evidence with required MAC-OP-01 and MAC-HOST-01 rig context, and operator signoff captured after acceptance scenario evidence. Bare artifact ID summaries, generic or placeholder artifact IDs without record-kind/requirement/evidence-suffix context, non-contextual or placeholder release identities, duplicate structured records for the same requirement, and artifact IDs reused across evidence groups do not satisfy the gate. Blocked until 180.C.29.08, the Stage 26 macOS host evidence bundle, and related live evidence are complete.
180.C.29.10 Run final product acceptance scenarios: same-LAN two-MacBook session, Hetzner/AWS cloud-agent session, Blender edit, browser workflow, desktop fallback, Unreal edit, artifact transfer, operator approval, takeover, replay export, revocation, and uninstall. Codex Blocked testing/bellona/remote-control/final-ga-release-gate.ts; testing/bellona/remote-control/tests/final-ga-release-gate.test.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/README.md; docs/domains/bellona/extras/remote-control/final-ga-release-gate.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/release-gate-alignment.md; docs/domains/bellona/extras/remote-control/README.md; TODOS/phase-180.md pnpm --dir testing/bellona/remote-control exec vitest run tests/final-ga-release-gate.test.ts --reporter=verbose passed with 1 file / 36 tests. Full final release matrix still not run because it requires live cloud and hardware evidence. Local acceptance evidence-record contract only; records must include canonical UTC millisecond timestamps and cover the required evidence kinds for each scenario, and artifact IDs must name those evidence slots with concrete non-placeholder sub-suffixes when context is appended. Final same-LAN, cloud-agent, DCC, browser, desktop, replay, revocation, and uninstall evidence requires real hardware/cloud. Bare scenario ID summaries, generic or placeholder artifact IDs without record-kind/requirement/evidence-suffix context, non-contextual or placeholder release identities, duplicate structured records for the same requirement, and artifact IDs reused across evidence groups do not satisfy the gate. Blocked until the required macOS/cloud acceptance environment is available.
180.C.29.11 Run final checklist completeness audit by comparing TODOS/phase-180.md, TODOS/phase-180-reference.md, implemented code, docs, tests, release evidence, and known gaps; add missing ordered tasks before release instead of relying on the reference file. Codex Complete TODOS/phase-180.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md Current audit derives 452 [x] / 25 [ ] from TODOS/phase-180.md; stale-count grep clean; pnpm exec prettier --check docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; scripts/stub-indicator-scan.sh --mode=all TODOS/phase-180.md docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; git diff --check Not applicable for the audit artifact; it records that final hardware and release evidence remains gated by 180.C.29.08-.10. Stage 29 roll-up remains open until 180.C.29.08-.10 complete.
180.C.29.12 Check off this stage only after the Remote Creative Control Plane is documented, SDK-accessible, operator-usable, tested, and releasable. Codex Blocked testing/bellona/remote-control/final-ga-release-gate.ts; testing/bellona/remote-control/tests/final-ga-release-gate.test.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/README.md; docs/domains/bellona/extras/remote-control/final-ga-release-gate.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/release-gate-alignment.md; docs/domains/bellona/extras/remote-control/README.md; TODOS/phase-180.md pnpm --dir testing/bellona/remote-control exec vitest run tests/final-ga-release-gate.test.ts --reporter=verbose passed with 1 file / 36 tests. Full final release matrix still not run because it requires live cloud and hardware evidence. Local roll-up dependency gate only; Stage 29 closure still requires completed structured final verification, release evidence, and product acceptance evidence records. Blocked until 180.C.29.08, .09, and .10 are complete with final verification matrix, release evidence, and product acceptance evidence from the required hosts/cloud.
180.C.29.13 Produce a single top-level "5-minute from clone to round-trip" local dev quickstart combining gateway, host, mock adapter, MCP client, and Control Room so a new contributor sees the full spine without reassembling it from per-package docs. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.29.14 Build a tools/bellona/new-command scaffold generator that creates coordinated stubs across protocol, gateway, host, policy, audit, Control Room timeline, SDK, CLI, and docs for a new command namespace entry. Include a conformance test runner. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.29.15 Document and test protocol evolution: stored-data migrations (180.C.08.11), host/gateway version drift, deprecation policy, and forward-compatibility of stored audit across protocol upgrades. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.29.16 Produce cross-platform permission abstraction developer docs covering the interface defined in 180.C.26.16 and the Windows/Linux host implementations in 180.C.36 and 180.C.37. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.30.01 Implement fleet scheduling by app version, project availability, resource load, network latency, permissions, current operator, and adapter capabilities. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.30.02 Implement host roles for Blender workstation, Unreal workstation, browser/admin workstation, render node, build node, QA viewer, and shared operator room. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.30.03 Implement multi-host session rooms where multiple agents operate separate devices under one production task with explicit locks. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.30.04 Implement distributed locks for shared project roots, source-control branches, Blender files, Unreal maps, browser profiles, and artifact output directories. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.30.05 Implement source-control-aware workflows for Git LFS, Perforce, Plastic/Unity Version Control, branch selection, checkout, changelist, revert, submit, and conflict reporting. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.30.06 Implement render/build queue integration so long-running jobs can continue after interactive sessions end. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.30.07 Implement fleet health dashboard, capacity planning, maintenance windows, adapter update cohorts, and fleet security posture scoring. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.30.08 Implement semantic scene diffing, visual regression, and style-guide checks across Blender and Unreal outputs. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.30.09 Implement mobile observer/approval mode and voice-driven Iris supervision after the desktop Control Room is stable. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.30.10 Check off this final stage only after the system supports one or many remote creative hosts with secure, observable, agent-driven, human-supervised production workflows end to end. Codex Blocked testing/bellona/remote-control/final-ga-release-gate.ts; testing/bellona/remote-control/tests/final-ga-release-gate.test.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/README.md; docs/domains/bellona/extras/remote-control/final-ga-release-gate.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; docs/domains/bellona/extras/remote-control/release-gate-alignment.md; docs/domains/bellona/extras/remote-control/README.md; TODOS/phase-180.md pnpm --dir testing/bellona/remote-control exec vitest run tests/final-ga-release-gate.test.ts --reporter=verbose passed with 1 file / 36 tests. Full final release matrix still not run because it requires live cloud and hardware evidence. Local fleet closure evidence-record gate only; records must include canonical UTC millisecond timestamps and cover the required evidence kinds for each fleet requirement, artifact IDs must name those evidence slots with concrete non-placeholder sub-suffixes when context is appended, and records must be captured after Stage 29 evidence; generic artifact IDs or placeholder evidence-slot sub-suffixes, non-contextual or placeholder release identities, duplicate structured records for the same requirement, and artifact IDs reused across evidence groups do not satisfy the gate. Final proof still requires one-or-many live remote creative hosts running secure observable supervised workflows. Bare closure ID summaries do not satisfy the gate. Blocked until final release acceptance proves the full multi-host workflow.
180.C.30.11 Implement voice and audio operator input (Iris supervision): push-to-talk approve/deny, spoken session commentary captured to audit, and voice-driven command palette. Expansion of the single bullet previously in 180.C.30.09. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.30.12 Implement an agent-in-the-loop red-team adversarial test suite: an agent actively attempting to bypass policy, escape the project-root sandbox, exfiltrate secrets, or manipulate approvals. Any successful bypass blocks release. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.31.01 Extract all Control Room UI strings through an i18n resource system from the MVP scaffold, not after the fact. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.31.02 Adopt a WCAG 2.1 AA accessibility baseline tested at every UI milestone (180.C.12, 180.C.21), not retrofitted in 180.C.21.09. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.31.03 Implement reduced-motion, high-contrast, and light/ dark themes with automated visual regression. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.31.04 Stub RTL-language layout support from MVP and test at each milestone. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.31.05 Define a keyboard navigation baseline (tab order, focus rings, skip links, focus-trap rules for modals) applied at Control Room MVP. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.31.06 Define a notification-channel abstraction (in-app toast, desktop notification, mobile push, email, webhook) wired from MVP so 180.C.12.13 and 180.C.28.11 share one pipeline. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.31.07 Define a cost-display abstraction (tokens, compute, bandwidth, render minutes, build minutes) wired into every UI surface showing session state so 180.C.21.11 has a single source of truth. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.31.08 Produce an empty, loading, and error state library for consistent operator UX across all Control Room views. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.31.09 Document the icon, color, typography, and spacing system before production UI work in 180.C.21 begins. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.31.10 Check off this stage only after cross-cutting UX concerns are codified such that 180.C.21 does not need to retrofit them. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.32.01 Publish an Adapter SDK with a stable contract in libs/bellona/remote-adapters covering capability handshake, command dispatch, progress/result emission, audit hooks, policy preflight, rollback metadata, and health reporting. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.32.02 Publish an adapter conformance test suite that any adapter must pass: lifecycle, error codes, idempotency, cancellation, timeout, policy-deny propagation, evidence registration, and rollback-strategy declaration. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.32.03 Implement adapter hot-reload for dev: file-watcher based reload without host restart, isolated reload failure handling, and state preservation where safe. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.32.04 Define an adapter packaging format: signed bundle, version metadata, declared permission scope, declared command namespace, and runtime integrity check. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.32.05 Implement adapter telemetry hooks so third-party adapters report into the same dashboards as first-party adapters without extra plumbing. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.32.06 Implement an adapter policy sandbox: a third-party adapter cannot bypass device policy, approval gates, or audit even if it misbehaves. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.32.07 Ship a trivially-simple example adapter (a timer or text-file adapter) that demonstrates the full contract end to end. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.32.08 Document the Adapter SDK with versioning policy, deprecation policy, and migration guides. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.32.09 Define an adapter signing and distribution model (signed registry or documented ad-hoc distribution with trust implications). Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.32.10 Check off this stage only after a third-party developer could ship a conforming adapter without modifying Bellona core. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.33.01 Implement frame/timecode sync primitives (SMPTE, TC-relative, offset) shared across Blender, Unreal, Sequencer, and DAW commands. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.33.02 Attach OCIO/ACES color-management metadata to every rendered or captured artifact and preserve it through transfer and storage. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.33.03 Implement audio capture alongside screen capture as a separately routed stream track with independent start/stop and redaction hooks that mute during credential entry. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.33.04 Implement HDR capture, transfer, storage, and Control Room preview including PQ and HLG tone-mapping for SDR fallback. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.33.05 Implement DAW transport control stubs (Logic, Pro Tools, Reason, Ableton) via OSC, ReWire, or AU hosts as read-only first, then gated write. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.33.06 Implement video editor project queries (DaVinci Resolve, Premiere) as read-only first with timeline/clip/bin access. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.33.07 Extend Live Link and virtual-production surfaces from read-only (180.C.24.08) to guarded write commands. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.33.08 Add color-pipeline verification tests: round-trip a scene through OCIO transforms and confirm no drift beyond documented tolerance. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.33.09 Implement audio-stream redaction hooks so credential entry, muting policies, and redacted windows also silence the audio track. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.33.10 Check off this stage only after media pipeline concerns are first-class across DCCs rather than improvised per command. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.34.01 Implement an outbound webhook subsystem with retry, dead-letter queue, HMAC signing, idempotent delivery, and per- subscription filters. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.34.02 Implement Slack integration with approval cards, session links, failure digests, and per-channel routing. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.34.03 Implement SMTP email integration for digests, critical alerts, and approval requests with operator preferences per event class. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.34.04 Implement mobile push notifications via APNs and FCM for approval and session events, coordinated with the mobile PWA from 180.C.12.14. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.34.05 Implement PagerDuty/Opsgenie on-call integration for host-offline, gateway-failure, and policy-bypass attempts. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.34.06 Implement ticketing integration (Linear, Jira) for failed-session ticket creation and session-outcome cross-references. Pairs with 180.C.22.14. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.34.07 Implement calendar integration (.ics export and Google/Outlook APIs) for scheduled render and build jobs. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.34.08 Implement per-user notification preferences, mute windows, escalation policies, and test-delivery helpers. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.34.09 Build a notification delivery test harness that verifies every channel end to end on each release. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.34.10 Check off this stage only after operators can choose reachability channels and configuration changes flow reliably without a restart. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.35.01 Maya adapter: read-only scene/project info, safe mutation (createNode, setAttr), playblast, arbitrary MEL/Python behind approval, reference/referenceload tracking. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.35.02 Houdini adapter: HIP read, node graph query, parameter set, cook/render, arbitrary Python behind approval. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.35.03 Cinema 4D adapter: read-only scene, safe object creation, render, Python Tag behind approval. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.35.04 Substance Painter/Designer adapter: project read, bake/export, JavaScript scripting behind approval. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.35.05 Nuke adapter: script read, node/parameter set, render, TCL/Python behind approval. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.35.06 DaVinci Resolve adapter: project timeline read, clip operations, render queue, LUA behind approval. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.35.07 Figma Desktop adapter: file read via plugin, comment/selection, export. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.35.08 Photoshop and After Effects adapters via UXP or ExtendScript: read-only MVPs before mutation. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.35.09 Run the adapter conformance suite (180.C.32.02) against every Tier-2 DCC adapter. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.35.10 Check off this stage only after Tier-2 DCCs participate in the same audit/approval/evidence pipeline as Blender and Unreal, end to end. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.36.01 Package the Windows Remote Host as a signed MSI running under Windows Services with graceful update and rollback. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/src/windows-host-support.ts; apps/bellona/remote-host/src/windows-host-support.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/windows-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md pnpm nx test @bellona/remote-host -- windows-host-support.test.ts --reporter=verbose (38 tests); pnpm nx test @bellona/remote-host -- --reporter=dot (67 files / 872 tests); pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host Local contracts, managed-profile path escape rejection, localhost-only CDP binding, TCP port validation, signing-readiness validation, and the Stage 36 evidence gate with checklist-item and evidence-slot artifact prefixes with concrete non-placeholder suffixes, stale-evidence and non-canonical timestamp rejection, Windows host/signing runner prefixes with concrete suffixes, macOS host parity-runner validation with concrete suffixes, structured parity comparator validation, acceptance operator-prefix validation with concrete suffixes, final-acceptance timestamp ordering after prerequisite evidence, and duplicate artifact-id rejection across stage records are implemented only; final evidence requires real Windows MSI/service install, Authenticode signing, DXGI/UIAutomation/SendInput probes, UAC/CFA/Smart App Control validation, real app discovery, Windows diagnostic bundle collection, macOS/Windows parity runs with browser, desktop, and Unreal MVP command anchors, and final operator acceptance. Blocked until a Windows host/build-signing pipeline, required macOS parity host, and final operator acceptance evidence are available.
180.C.36.02 Implement Windows screen capture (DXGI Desktop Duplication), window focus (UIAutomation), and input injection (SendInput) with parity to macOS primitives. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/src/windows-host-support.ts; apps/bellona/remote-host/src/windows-host-support.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/windows-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md pnpm nx test @bellona/remote-host -- windows-host-support.test.ts --reporter=verbose (38 tests); pnpm nx test @bellona/remote-host -- --reporter=dot (67 files / 872 tests); pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host Local contracts, managed-profile path escape rejection, localhost-only CDP binding, TCP port validation, signing-readiness validation, and the Stage 36 evidence gate with checklist-item and evidence-slot artifact prefixes with concrete non-placeholder suffixes, stale-evidence and non-canonical timestamp rejection, Windows host/signing runner prefixes with concrete suffixes, macOS host parity-runner validation with concrete suffixes, structured parity comparator validation, acceptance operator-prefix validation with concrete suffixes, final-acceptance timestamp ordering after prerequisite evidence, and duplicate artifact-id rejection across stage records are implemented only; final evidence requires real Windows MSI/service install, Authenticode signing, DXGI/UIAutomation/SendInput probes, UAC/CFA/Smart App Control validation, real app discovery, Windows diagnostic bundle collection, macOS/Windows parity runs with browser, desktop, and Unreal MVP command anchors, and final operator acceptance. Blocked until a Windows host/build-signing pipeline, required macOS parity host, and final operator acceptance evidence are available.
180.C.36.03 Implement Windows permission handling: UAC elevation prompts, Windows Defender Controlled Folder Access allowlisting, and Smart App Control compatibility. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/src/windows-host-support.ts; apps/bellona/remote-host/src/windows-host-support.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/windows-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md pnpm nx test @bellona/remote-host -- windows-host-support.test.ts --reporter=verbose (38 tests); pnpm nx test @bellona/remote-host -- --reporter=dot (67 files / 872 tests); pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host Local contracts, managed-profile path escape rejection, localhost-only CDP binding, TCP port validation, signing-readiness validation, and the Stage 36 evidence gate with checklist-item and evidence-slot artifact prefixes with concrete non-placeholder suffixes, stale-evidence and non-canonical timestamp rejection, Windows host/signing runner prefixes with concrete suffixes, macOS host parity-runner validation with concrete suffixes, structured parity comparator validation, acceptance operator-prefix validation with concrete suffixes, final-acceptance timestamp ordering after prerequisite evidence, and duplicate artifact-id rejection across stage records are implemented only; final evidence requires real Windows MSI/service install, Authenticode signing, DXGI/UIAutomation/SendInput probes, UAC/CFA/Smart App Control validation, real app discovery, Windows diagnostic bundle collection, macOS/Windows parity runs with browser, desktop, and Unreal MVP command anchors, and final operator acceptance. Blocked until a Windows host/build-signing pipeline, required macOS parity host, and final operator acceptance evidence are available.
180.C.36.04 Implement Windows Chrome/Chromium/Edge launch with CDP, managed-profile creation, and policy-isolated browser paths. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/src/windows-host-support.ts; apps/bellona/remote-host/src/windows-host-support.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/windows-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md pnpm nx test @bellona/remote-host -- windows-host-support.test.ts --reporter=verbose (38 tests); pnpm nx test @bellona/remote-host -- --reporter=dot (67 files / 872 tests); pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host Local contracts, managed-profile path escape rejection, localhost-only CDP binding, TCP port validation, signing-readiness validation, and the Stage 36 evidence gate with checklist-item and evidence-slot artifact prefixes with concrete non-placeholder suffixes, stale-evidence and non-canonical timestamp rejection, Windows host/signing runner prefixes with concrete suffixes, macOS host parity-runner validation with concrete suffixes, structured parity comparator validation, acceptance operator-prefix validation with concrete suffixes, final-acceptance timestamp ordering after prerequisite evidence, and duplicate artifact-id rejection across stage records are implemented only; final evidence requires real Windows MSI/service install, Authenticode signing, DXGI/UIAutomation/SendInput probes, UAC/CFA/Smart App Control validation, real app discovery, Windows diagnostic bundle collection, macOS/Windows parity runs with browser, desktop, and Unreal MVP command anchors, and final operator acceptance. Blocked until a Windows host/build-signing pipeline, required macOS parity host, and final operator acceptance evidence are available.
180.C.36.05 Implement Windows Blender and Unreal install discovery, version detection, and plugin installation paths. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/src/windows-host-support.ts; apps/bellona/remote-host/src/windows-host-support.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/windows-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md pnpm nx test @bellona/remote-host -- windows-host-support.test.ts --reporter=verbose (38 tests); pnpm nx test @bellona/remote-host -- --reporter=dot (67 files / 872 tests); pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host Local contracts, managed-profile path escape rejection, localhost-only CDP binding, TCP port validation, signing-readiness validation, and the Stage 36 evidence gate with checklist-item and evidence-slot artifact prefixes with concrete non-placeholder suffixes, stale-evidence and non-canonical timestamp rejection, Windows host/signing runner prefixes with concrete suffixes, macOS host parity-runner validation with concrete suffixes, structured parity comparator validation, acceptance operator-prefix validation with concrete suffixes, final-acceptance timestamp ordering after prerequisite evidence, and duplicate artifact-id rejection across stage records are implemented only; final evidence requires real Windows MSI/service install, Authenticode signing, DXGI/UIAutomation/SendInput probes, UAC/CFA/Smart App Control validation, real app discovery, Windows diagnostic bundle collection, macOS/Windows parity runs with browser, desktop, and Unreal MVP command anchors, and final operator acceptance. Blocked until a Windows host/build-signing pipeline, required macOS parity host, and final operator acceptance evidence are available.
180.C.36.06 Implement a Windows update channel with signed installer manifests, canary rollout, and rollback. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/src/windows-host-support.ts; apps/bellona/remote-host/src/windows-host-support.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/windows-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md pnpm nx test @bellona/remote-host -- windows-host-support.test.ts --reporter=verbose (38 tests); pnpm nx test @bellona/remote-host -- --reporter=dot (67 files / 872 tests); pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host Local contracts, managed-profile path escape rejection, localhost-only CDP binding, TCP port validation, signing-readiness validation, and the Stage 36 evidence gate with checklist-item and evidence-slot artifact prefixes with concrete non-placeholder suffixes, stale-evidence and non-canonical timestamp rejection, Windows host/signing runner prefixes with concrete suffixes, macOS host parity-runner validation with concrete suffixes, structured parity comparator validation, acceptance operator-prefix validation with concrete suffixes, final-acceptance timestamp ordering after prerequisite evidence, and duplicate artifact-id rejection across stage records are implemented only; final evidence requires real Windows MSI/service install, Authenticode signing, DXGI/UIAutomation/SendInput probes, UAC/CFA/Smart App Control validation, real app discovery, Windows diagnostic bundle collection, macOS/Windows parity runs with browser, desktop, and Unreal MVP command anchors, and final operator acceptance. Blocked until a Windows host/build-signing pipeline, required macOS parity host, and final operator acceptance evidence are available.
180.C.36.07 Implement a Windows diagnostic bundle with the same content and redaction policy as the macOS bundle. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/src/windows-host-support.ts; apps/bellona/remote-host/src/windows-host-support.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/windows-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md pnpm nx test @bellona/remote-host -- windows-host-support.test.ts --reporter=verbose (38 tests); pnpm nx test @bellona/remote-host -- --reporter=dot (67 files / 872 tests); pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host Local contracts, managed-profile path escape rejection, localhost-only CDP binding, TCP port validation, signing-readiness validation, and the Stage 36 evidence gate with checklist-item and evidence-slot artifact prefixes with concrete non-placeholder suffixes, stale-evidence and non-canonical timestamp rejection, Windows host/signing runner prefixes with concrete suffixes, macOS host parity-runner validation with concrete suffixes, structured parity comparator validation, acceptance operator-prefix validation with concrete suffixes, final-acceptance timestamp ordering after prerequisite evidence, and duplicate artifact-id rejection across stage records are implemented only; final evidence requires real Windows MSI/service install, Authenticode signing, DXGI/UIAutomation/SendInput probes, UAC/CFA/Smart App Control validation, real app discovery, Windows diagnostic bundle collection, macOS/Windows parity runs with browser, desktop, and Unreal MVP command anchors, and final operator acceptance. Blocked until a Windows host/build-signing pipeline, required macOS parity host, and final operator acceptance evidence are available.
180.C.36.08 Validate Windows as a render-node and browser/admin-workstation host role from 180.C.30.02. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/src/windows-host-support.ts; apps/bellona/remote-host/src/windows-host-support.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/windows-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md pnpm nx test @bellona/remote-host -- windows-host-support.test.ts --reporter=verbose (38 tests); pnpm nx test @bellona/remote-host -- --reporter=dot (67 files / 872 tests); pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host Local contracts, managed-profile path escape rejection, localhost-only CDP binding, TCP port validation, signing-readiness validation, and the Stage 36 evidence gate with checklist-item and evidence-slot artifact prefixes with concrete non-placeholder suffixes, stale-evidence and non-canonical timestamp rejection, Windows host/signing runner prefixes with concrete suffixes, macOS host parity-runner validation with concrete suffixes, structured parity comparator validation, acceptance operator-prefix validation with concrete suffixes, final-acceptance timestamp ordering after prerequisite evidence, and duplicate artifact-id rejection across stage records are implemented only; final evidence requires real Windows MSI/service install, Authenticode signing, DXGI/UIAutomation/SendInput probes, UAC/CFA/Smart App Control validation, real app discovery, Windows diagnostic bundle collection, macOS/Windows parity runs with browser, desktop, and Unreal MVP command anchors, and final operator acceptance. Blocked until a Windows host/build-signing pipeline, required macOS parity host, and final operator acceptance evidence are available.
180.C.36.09 Add cross-platform tests verifying macOS and Windows agents see identical capabilities for shared command namespaces. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/src/windows-host-support.ts; apps/bellona/remote-host/src/windows-host-support.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/windows-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md pnpm nx test @bellona/remote-host -- windows-host-support.test.ts --reporter=verbose (38 tests); pnpm nx test @bellona/remote-host -- --reporter=dot (67 files / 872 tests); pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host Local contracts, managed-profile path escape rejection, localhost-only CDP binding, TCP port validation, signing-readiness validation, and the Stage 36 evidence gate with checklist-item and evidence-slot artifact prefixes with concrete non-placeholder suffixes, stale-evidence and non-canonical timestamp rejection, Windows host/signing runner prefixes with concrete suffixes, macOS host parity-runner validation with concrete suffixes, structured parity comparator validation, acceptance operator-prefix validation with concrete suffixes, final-acceptance timestamp ordering after prerequisite evidence, and duplicate artifact-id rejection across stage records are implemented only; final evidence requires real Windows MSI/service install, Authenticode signing, DXGI/UIAutomation/SendInput probes, UAC/CFA/Smart App Control validation, real app discovery, Windows diagnostic bundle collection, macOS/Windows parity runs with browser, desktop, and Unreal MVP command anchors, and final operator acceptance. Blocked until a Windows host/build-signing pipeline, required macOS parity host, and final operator acceptance evidence are available.
180.C.36.10 Check off this stage only after Windows hosts reach feature parity for Blender, Unreal, browser, and desktop MVPs. Codex Blocked TODOS/phase-180.md; apps/bellona/remote-host/src/windows-host-support.ts; apps/bellona/remote-host/src/windows-host-support.test.ts; apps/bellona/remote-host/src/index.ts; apps/bellona/remote-host/README.md; docs/domains/bellona/extras/remote-control/windows-host-local-contracts.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md pnpm nx test @bellona/remote-host -- windows-host-support.test.ts --reporter=verbose (38 tests); pnpm nx test @bellona/remote-host -- --reporter=dot (67 files / 872 tests); pnpm exec tsc --noEmit -p apps/bellona/remote-host/tsconfig.app.json; pnpm nx lint @bellona/remote-host Local contracts, managed-profile path escape rejection, localhost-only CDP binding, TCP port validation, signing-readiness validation, and the Stage 36 evidence gate with checklist-item and evidence-slot artifact prefixes with concrete non-placeholder suffixes, stale-evidence and non-canonical timestamp rejection, Windows host/signing runner prefixes with concrete suffixes, macOS host parity-runner validation with concrete suffixes, structured parity comparator validation, acceptance operator-prefix validation with concrete suffixes, final-acceptance timestamp ordering after prerequisite evidence, and duplicate artifact-id rejection across stage records are implemented only; final evidence requires real Windows MSI/service install, Authenticode signing, DXGI/UIAutomation/SendInput probes, UAC/CFA/Smart App Control validation, real app discovery, Windows diagnostic bundle collection, macOS/Windows parity runs with browser, desktop, and Unreal MVP command anchors, and final operator acceptance. Blocked until a Windows host/build-signing pipeline, required macOS parity host, and final operator acceptance evidence are available.
180.C.37.01 Package the Linux Remote Host as deb, rpm, and AppImage with systemd user units and distribution-signed packages. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.37.02 Implement Wayland and X11 screen-capture and input- injection strategies with an explicit compositor compatibility matrix. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.37.03 Implement PipeWire audio capture alongside the media pipeline in 180.C.33.03. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.37.04 Implement Linux permission handling: PolicyKit, cgroups, AppArmor/SELinux profiles for the host and adapters. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.37.05 Implement headless Blender (bpy), Unreal commandlet, and Chromium-headless adapters for render-node use. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.37.06 Implement the Linux render-node host role without interactive DCC UI requirements, coordinated with 180.C.30.02. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.37.07 Implement a Linux diagnostic bundle with the same content and redaction policy as macOS and Windows bundles. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.37.08 Implement Linux package signing and repository distribution (signed deb repo, signed rpm repo, or signed AppImage updater). Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.37.09 Add cross-platform tests verifying Linux render nodes participate fully in fleets from 180.C.30. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.37.10 Check off this stage only after Linux hosts function as first-class render, build, and headless-adapter nodes. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.38.01 Implement a compatibility shim so existing consumers of apps/bellona/bridge-blender and bridge-unreal continue to function during rollout without code changes. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.38.02 Document a parallel-operation guide: old bridges and new Remote Host running simultaneously with conflict detection and reconciliation rules. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.38.03 Produce a migration guide for consumers moving from old bridges to the new command envelopes with before/after examples. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.38.04 Publish a deprecation timeline with dates for warning emission, hard cutover, and final removal of old bridges. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.38.05 Implement a feature flag gating the gateway's acceptance of old-bridge protocols for forced-migration drills. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.38.06 Instrument telemetry on old-bridge usage to drive deprecation communication and identify holdouts. Codex Complete TODOS/phase-180.md; item-specific implementation files and evidence notes referenced by the canonical checklist and audit trail. Backfilled from the canonical checklist state; no runtime code changed in this tracker update. Preserve item-specific verification evidence in the implementing commit and run the final 180.C.29.08 matrix before release. Backfilled from existing checklist evidence; any hardware or release evidence that cannot be proven locally remains covered by the open 180.C.29.08-.10 release gates. None for this tracker row; release-wide final evidence remains gated by 180.C.29.08-.10 where applicable.
180.C.38.07 Submit removal PRs for old bridges with migration paths pinned in release notes. Codex Blocked testing/bellona/remote-control/bridge-retirement-gate.ts; testing/bellona/remote-control/tests/bridge-retirement-gate.test.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/README.md; docs/domains/bellona/extras/remote-control/bridge-retirement-gate.md; docs/domains/bellona/extras/remote-control/bridge-coexistence-and-deprecation-plan.md; docs/domains/bellona/extras/remote-control/README.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts tests/bridge-retirement-gate.test.ts --reporter=verbose from testing/bellona/remote-control passed with 1 file / 34 tests. Duplicate PR, bridge telemetry, or command telemetry records, unknown or nonzero command telemetry entries, reused per-bridge PR URLs or telemetry sources, placeholder telemetry source or bridge-retirement approver suffixes, duplicate or unrelated removed cleanup paths/packages, case-variant allowed residual references, and generic or substring-only scan commands that do not use rg/git grep, omit or only partially cover workspace metadata files, or do not target exact legacy bridge package/path references; stale or non-canonical timestamp removal submissions, premature or non-canonical timestamp merges, stale or non-canonical timestamp cleanup records, or final approval timestamps that predate retirement evidence or use non-canonical timestamp metadata do not satisfy the gate. Full bridge retirement run not performed. Local gate only; final evidence requires Remote Host GA, submitted and merged removal PRs, post-cutover zero-consumer telemetry, old bridge package removal, clean full-scope post-removal dependency scans that use rg/git grep and target exact legacy bridge package/path references across apps, libraries, services, scripts, testing, and workspace metadata files with no findings, docs updates, and complete final approval evidence dated after the retirement evidence it approves. Blocked on external bridge-removal PR evidence after active old-bridge consumers are gone or formally migrated.
180.C.38.08 Run a post-removal verification that no Oshun service, test, or script depends on the old bridges. Codex Blocked testing/bellona/remote-control/bridge-retirement-gate.ts; testing/bellona/remote-control/tests/bridge-retirement-gate.test.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/README.md; docs/domains/bellona/extras/remote-control/bridge-retirement-gate.md; docs/domains/bellona/extras/remote-control/bridge-coexistence-and-deprecation-plan.md; docs/domains/bellona/extras/remote-control/README.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts tests/bridge-retirement-gate.test.ts --reporter=verbose from testing/bellona/remote-control passed with 1 file / 34 tests. Duplicate PR, bridge telemetry, or command telemetry records, unknown or nonzero command telemetry entries, reused per-bridge PR URLs or telemetry sources, placeholder telemetry source or bridge-retirement approver suffixes, duplicate or unrelated removed cleanup paths/packages, case-variant allowed residual references, and generic or substring-only scan commands that do not use rg/git grep, omit or only partially cover workspace metadata files, or do not target exact legacy bridge package/path references; stale or non-canonical timestamp removal submissions, premature or non-canonical timestamp merges, stale or non-canonical timestamp cleanup records, or final approval timestamps that predate retirement evidence or use non-canonical timestamp metadata do not satisfy the gate. Full bridge retirement run not performed. Local gate only; final evidence requires Remote Host GA, submitted and merged removal PRs, post-cutover zero-consumer telemetry, old bridge package removal, clean full-scope post-removal dependency scans that use rg/git grep and target exact legacy bridge package/path references across apps, libraries, services, scripts, testing, and workspace metadata files with no findings, docs updates, and complete final approval evidence dated after the retirement evidence it approves. Blocked until removal has actually happened and post-removal app/library/service/script/test/workspace scans can run cleanly.
180.C.38.09 Clean up apps/bellona/bridge-blender, apps/bellona/bridge-unreal, and related packages once Remote Host is GA and no consumers remain. Codex Blocked testing/bellona/remote-control/bridge-retirement-gate.ts; testing/bellona/remote-control/tests/bridge-retirement-gate.test.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/README.md; docs/domains/bellona/extras/remote-control/bridge-retirement-gate.md; docs/domains/bellona/extras/remote-control/bridge-coexistence-and-deprecation-plan.md; docs/domains/bellona/extras/remote-control/README.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts tests/bridge-retirement-gate.test.ts --reporter=verbose from testing/bellona/remote-control passed with 1 file / 34 tests. Duplicate PR, bridge telemetry, or command telemetry records, unknown or nonzero command telemetry entries, reused per-bridge PR URLs or telemetry sources, placeholder telemetry source or bridge-retirement approver suffixes, duplicate or unrelated removed cleanup paths/packages, case-variant allowed residual references, and generic or substring-only scan commands that do not use rg/git grep, omit or only partially cover workspace metadata files, or do not target exact legacy bridge package/path references; stale or non-canonical timestamp removal submissions, premature or non-canonical timestamp merges, stale or non-canonical timestamp cleanup records, or final approval timestamps that predate retirement evidence or use non-canonical timestamp metadata do not satisfy the gate. Full bridge retirement run not performed. Local gate only; final evidence requires Remote Host GA, submitted and merged removal PRs, post-cutover zero-consumer telemetry, old bridge package removal, clean full-scope post-removal dependency scans that use rg/git grep and target exact legacy bridge package/path references across apps, libraries, services, scripts, testing, and workspace metadata files with no findings, docs updates, and complete final approval evidence dated after the retirement evidence it approves. Blocked on Remote Host GA, zero-consumer telemetry, and actual cleanup/removal evidence for the old bridge app packages.
180.C.38.10 Check off this stage only after old bridges are fully retired with zero production consumers and documentation reflects the single supported path. Codex Blocked testing/bellona/remote-control/bridge-retirement-gate.ts; testing/bellona/remote-control/tests/bridge-retirement-gate.test.ts; testing/bellona/remote-control/index.ts; testing/bellona/remote-control/README.md; docs/domains/bellona/extras/remote-control/bridge-retirement-gate.md; docs/domains/bellona/extras/remote-control/bridge-coexistence-and-deprecation-plan.md; docs/domains/bellona/extras/remote-control/README.md; docs/domains/bellona/extras/remote-control/checklist-completeness-audit.md; docs/domains/bellona/extras/remote-control/implementation-tracker.md; TODOS/phase-180.md pnpm exec vitest run --config vitest.config.ts tests/bridge-retirement-gate.test.ts --reporter=verbose from testing/bellona/remote-control passed with 1 file / 34 tests. Duplicate PR, bridge telemetry, or command telemetry records, unknown or nonzero command telemetry entries, reused per-bridge PR URLs or telemetry sources, placeholder telemetry source or bridge-retirement approver suffixes, duplicate or unrelated removed cleanup paths/packages, case-variant allowed residual references, and generic or substring-only scan commands that do not use rg/git grep, omit or only partially cover workspace metadata files, or do not target exact legacy bridge package/path references; stale or non-canonical timestamp removal submissions, premature or non-canonical timestamp merges, stale or non-canonical timestamp cleanup records, or final approval timestamps that predate retirement evidence or use non-canonical timestamp metadata do not satisfy the gate. Full bridge retirement run not performed. Local gate only; final evidence requires Remote Host GA, submitted and merged removal PRs, post-cutover zero-consumer telemetry, old bridge package removal, clean full-scope post-removal dependency scans that use rg/git grep and target exact legacy bridge package/path references across apps, libraries, services, scripts, testing, and workspace metadata files with no findings, docs updates, and complete final approval evidence dated after the retirement evidence it approves. Blocked on Remote Host GA, zero-consumer telemetry, legacy bridge retirement for .07, .08, .09, documentation updates, and final approval evidence.