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

111 lines
4.8 KiB
JSON

{
"schema": "hololake.local-development-bridge-contract/v1",
"record_id": "HLP-NATIVE-LOCAL-DEVELOPMENT-BRIDGE-001",
"state": "ACCOUNT_SINGLE_WRITER_KERNEL_IMPLEMENTED_LOCAL_BROKER_PENDING",
"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": false,
"external_local_broker_runtime": false,
"incremental_repository_channel_migrated_to_native_mainline": false
}
}