hololake-system-architecture/product-source/hololake-native-desktop/contracts/local-development-bridge.json

{
  "schema": "hololake.local-development-bridge-contract/v1",
  "record_id": "HLP-NATIVE-LOCAL-DEVELOPMENT-BRIDGE-001",
  "state": "ACCOUNT_SINGLE_WRITER_RESUMABLE_DIRECT_SESSION_AND_LOCAL_BROKER_IMPLEMENTED",
  "purpose": "Keep a programming AI continuously attached to the human's HoloLake language and development environment without repeated repository clones or MCP-session dependence.",
  "primary_transport": {
    "owner": "HOLOLAKE_NATIVE_LOCAL_BROKER",
    "form": "LOGIN_RESIDENT_BACKGROUND_SERVICE_WITH_TERMINAL_AND_AUTHENTICATED_LOCAL_PROTOCOL_ENTRIES",
    "network_required_for_local_work": false,
    "reconnectable": true,
    "durable_session_state": true,
    "transport_is_authority": false
  },
  "mcp_role": "OPTIONAL_EXTERNAL_TOOL_ADAPTER_NOT_CONTINUITY_OR_AUTHORITY_ROOT",
  "external_ai_entry": {
    "mcp_may_bootstrap_discovery": true,
    "direct_local_protocol_preferred_after_discovery": true,
    "permanent_mcp_only_state_allowed_for_programming_ai": false,
    "missing_direct_connector_triggers_capability_bootstrap": true,
    "all_entries_share_the_same_identity_authority_lane_and_receipt_kernel": true
  },
  "connector_capability_bootstrap": {
    "programming_ai_may_detect_and_implement_missing_connector": true,
    "implementation_occurs_inside_the_active_account_write_lane": true,
    "artifact_is_stored_in_hololake": true,
    "connector_is_versioned_and_recoverable": true,
    "tests_and_capability_receipt_required": true,
    "installation_requires_declared_permissions_and_human_approval": true,
    "silent_persistence_or_authority_expansion_allowed": false,
    "successful_end_state": "AUTHENTICATED_RESUMABLE_DIRECT_LOCAL_CONNECTION",
    "mcp_after_migration": "OPTIONAL_RECOVERY_DISCOVERY_AND_COMPATIBILITY_ENTRY"
  },
  "continuity": {
    "survives_programming_ai_restart": true,
    "survives_hololake_restart": true,
    "active_writer_auto_released_on_disconnect": false,
    "resume_requires_possession_token": true,
    "explicit_release_receipt_required_before_next_lane": true
  },
  "account_concurrency": {
    "write_lanes_per_account": 1,
    "parallel_readers_allowed": true,
    "parallel_reviewers_allowed": true,
    "parallel_editors_allowed": false,
    "parallel_committers_allowed": false,
    "parallel_publishers_allowed": false,
    "parallel_deployers_allowed": false
  },
  "repository_channel": {
    "full_clone_per_task_required": false,
    "persistent_partial_object_cache": true,
    "lightweight_task_views": true,
    "fetch_only_missing_objects": true,
    "durable_verified_cursor": true,
    "history_rewrite_fails_closed": true
  },
  "language_space_reads": {
    "persona_selects_address": true,
    "persona_selects_range": true,
    "persona_selects_read_budget": true,
    "server_may_page_but_must_not_silently_truncate": true,
    "every_partial_response_declares_completion_state": true,
    "every_partial_response_returns_exact_resume_cursor": true,
    "cursor_is_bound_to_subject_object_version_and_query": true
  },
  "security": {
    "raw_account_identifier_in_storage_path": false,
    "caller_selected_bridge_storage_root": false,
    "credentials_exposed_to_programming_ai": false,
    "external_process_requires_authenticated_local_session": true
  },
  "personal_work_lake": {
    "control_plane": "EMBEDDED_SQLITE_SINGLE_HOLOLAKE_OWNER",
    "code_history": "STANDARD_GIT_PERSISTENT_PARTIAL_OBJECT_POOL",
    "persona_semantics": "HLDP",
    "large_artifacts": "USER_OWNED_FILESYSTEM_OBJECT_AREA",
    "execution": "HOLOLAKE_SUPERVISED_TERMINAL",
    "external_ai_direct_database_or_git_mutation_allowed": false,
    "search_indexes_are_rebuildable_authority": false
  },
  "mobile_remote_entry": {
    "same_persona_system": true,
    "remote_desktop_clone": false,
    "same_lan_direct": true,
    "internet_direct_preferred": true,
    "encrypted_relay_optional": true,
    "relay_can_read_private_payload": false,
    "offline_node_can_execute": false
  },
  "enterprise_registry_boundary": {
    "human_number_is_credential": false,
    "account_authentication_is_node_possession": false,
    "node_public_key_registered": true,
    "node_private_key_leaves_user_node": false,
    "platform_stores_private_work_lake": false,
    "platform_stores_code_memory_tasks_or_terminal_output": false,
    "transactional_real_time_verifier_required": true
  },
  "implementation": {
    "account_single_writer_runtime": true,
    "restart_resume_token_runtime": true,
    "explicit_release_receipt_runtime": true,
    "native_ipc_commands_registered": true,
    "language_space_read_cursor_contract_registered": true,
    "language_space_read_cursor_runtime": false,
    "connector_capability_bootstrap_contract_registered": true,
    "connector_capability_bootstrap_runtime": true,
    "installed_app_connector_entry_runtime": true,
    "external_local_broker_runtime": true,
    "resumable_direct_session_kernel_runtime": true,
    "single_use_discovery_ticket_runtime": true,
    "hololake_issued_discovery_ticket_runtime": true,
    "cross_process_session_event_lock_runtime": true,
    "direct_session_account_single_writer_runtime": true,
    "idempotent_session_event_cursor_runtime": true,
    "incremental_repository_channel_migrated_to_native_mainline": false
  }
}