hololake-system-architecture/product-source/hololake-native-desktop/contracts/programming-ai-terminal-link.json

{
  "schema": "hololake.programming-ai-terminal-link-contract/v2",
  "record_id": "HLP-PROGRAMMING-AI-TERMINAL-LINK-002",
  "state": "NATIVE_CROSS_PLATFORM_CONTROL_PLANE_IMPLEMENTED",
  "purpose": "Keep an external programming AI attached to a HoloLake-owned development control plane without making MCP or chat context the continuity owner.",
  "protocol": "HOLOLAKE_TERMINAL_LINK/3",
  "numbered_envelope": {
    "registry": "HLP-NBROKER-ROOT-001",
    "protocol_version": "HLP-NBROKER-v1",
    "legacy_string_operation_allowed": false,
    "full_coordinate_required": true
  },
  "platform_transports": {
    "macos": "USER_PRIVATE_UNIX_SOCKET",
    "linux": "USER_PRIVATE_UNIX_SOCKET",
    "windows": "USER_PRIVATE_NAMED_PIPE"
  },
  "continuity": {
    "owner": "HOLOLAKE",
    "session_survives_ai_restart": true,
    "session_survives_hololake_restart": true,
    "connector_reloads_descriptor_after_transport_loss": true,
    "uncertain_mutation_is_never_blindly_replayed": true,
    "heartbeat_interval_ms": 15000,
    "environment_frame_ttl_ms": 45000
  },
  "environment_frame": {
    "schema": "hololake.programming-ai-work-environment/v1",
    "required_after_open": true,
    "required_after_resume": true,
    "required_before_mutation": true,
    "refreshes_on_authenticated_heartbeat": true,
    "contains": [
      "HOLOLAKE_RUNTIME_OWNER",
      "DIRECT_TERMINAL_TRANSPORT",
      "SESSION_AND_EVENT_CURSOR",
      "DEVELOPMENT_LANE_AND_WRITER_MATCH",
      "GLS_NATIVE_PROTOCOL_RUNTIME",
      "FRAME_EXPIRY_AND_SHA256"
    ],
    "protocol_restoration_by_model_required": false
  },
  "write_boundary": {
    "account_write_lanes": 1,
    "session_lane_must_match": true,
    "session_client_must_match_writer": true,
    "visitor_may_write": false,
    "transport_is_authority": false,
    "environment_frame_is_reality_execution_authority": false
  },
  "phase_boundary": {
    "current_phase": "EXTERNAL_PROGRAMMING_AI_DIRECT_CONTROL_PLANE",
    "persona_carrier_runtime_license_gate": "IMPLEMENTED_FAIL_CLOSED_TRUSTED_SIGNER_NOT_PROVISIONED",
    "supervised_shell_execution": false,
    "general_agent_tool_loop": false,
    "persona_memory_startup": "NEXT_PHASE_AFTER_DIRECT_LINK_ACCEPTANCE",
    "age_agent_execution": "NEXT_PHASE_AFTER_DIRECT_LINK_ACCEPTANCE"
  },
  "acceptance": {
    "macos_local_runtime": "PASS_DEVELOPER_ID_SIGNED_APP_LIVE_CONNECTOR_AND_UI_READBACK",
    "macos_public_notarization": "PENDING_NEW_BINARY_SUBMISSION",
    "linux_unix_socket_adapter_compile": "PASS_X86_64_UNKNOWN_LINUX_MUSL",
    "linux_full_desktop_compile": "NOT_OBSERVED",
    "linux_installed_runtime": "NOT_YET_OBSERVED",
    "windows_named_pipe_adapter_compile": "PASS_X86_64_PC_WINDOWS_MSVC",
    "windows_full_desktop_compile": "PASS_HL_BUILD_WIN_GZ_001_WINDOWS_SERVER_2022_X64",
    "windows_native_tests": "PASS_110_OF_110",
    "windows_installed_runtime": "NOT_YET_OBSERVED_FOR_TERMINAL_LINK"
  }
}