hololake-system-architecture/routing/hololake-canonical-desktop-shell.json

137 lines
5.1 KiB
JSON

{
"schema": "hololake.canonical-desktop-shell/v2",
"record_id": "HLP-CANONICAL-DESKTOP-SHELL-001",
"version": "2026-08-12.2",
"state": "CURRENT_CANONICAL_FOUNDATION_ROOT_CREATED_TAURI_SCAFFOLD_PENDING",
"development_id": "DEV-20260811-010",
"decision": {
"canonical_shell": "TAURI_V2_RUST_REACT",
"canonical_source": "product-source/hololake-native-desktop",
"canonical_source_state": "FOUNDATION_ROOT_CREATED_TAURI_SCAFFOLD_PENDING",
"existing_tauri_source": "product-source/hololake-platform",
"existing_tauri_role": "READ_ONLY_ENGINEERING_CAPABILITY_DONOR_AND_ACCEPTANCE_ORACLE",
"electron_role": "READ_ONLY_KNOWLEDGE_UX_BEHAVIOR_DONOR_AND_ACCEPTANCE_ORACLE",
"electron_source": [
"product-source/hololake-desktop",
"product-source/guanghu-knowledge-base"
],
"parallel_product_lines_allowed": false,
"new_existing_tauri_product_features_allowed": false,
"new_electron_product_features_allowed": false,
"donor_immediate_deletion_allowed": false,
"knowledge_completeness_depends_on_shell_framework": false,
"electron_is_current_knowledge_ux_reference": true
},
"update_route": {
"record_id": "HLP-SIGNED-OPT-IN-UPDATE-001",
"state": "ARCHITECTURE_ACCEPTED_IMPLEMENTATION_NOT_STARTED",
"upstream_product_update_endpoints_allowed": false,
"hololake_owned_https_endpoint_only": true,
"release_broadcast_may_arrive_automatically": true,
"silent_download_allowed": false,
"human_opt_in_install_required": true,
"automatic_restart_allowed": false,
"restart_activation_required": true,
"tauri_update_artifact_signature_required": true,
"tauri_update_signature_verification_disable_allowed": false,
"platform_code_signature_required": true,
"macos_developer_id_and_notarization_required_for_direct_distribution": true,
"private_signing_key_bundled_or_committed": false,
"startup_health_receipt_required": true,
"recoverable_rollback_required": true,
"required_broadcast_fields": [
"VERSION",
"FEATURES_AND_FIXES",
"COMPATIBILITY_AND_MINIMUM_VERSION",
"DOWNLOAD_SIZE",
"RESTART_IMPACT",
"PUBLISHED_AT",
"PLATFORM_AND_ARCH_URL",
"TAURI_SIGNATURE",
"ARTIFACT_HASH",
"ROLLBACK_METADATA"
]
},
"upstream_policy": {
"tolaria_role": "MANUALLY_REVIEWED_PARTS_SOURCE",
"outline_role": "MANUALLY_REVIEWED_BEHAVIOR_AND_PARTS_SOURCE",
"automatic_upstream_merge_allowed": false,
"automatic_upstream_update_allowed": false,
"full_outline_stack_embedding_allowed": false,
"required_intake_gates": [
"PRODUCT_FIT",
"FILE_LEVEL_PROVENANCE_AND_LICENSE",
"SECURITY",
"DATA_MODEL",
"NATIVE_BOUNDARY",
"USABILITY",
"REGRESSION_AND_ACCEPTANCE"
]
},
"knowledge_capability_contract": [
"PAGE_AND_FOLDER_TREE",
"BLOCK_RICH_TEXT_AND_MARKDOWN_DURABILITY",
"TABLE_CALLOUT_TOGGLE_TOC_CODE_MATH_DIAGRAM_WHITEBOARD_SHEET",
"PROPERTIES_TYPES_FILTER_SORT_DATABASE_LIKE_VIEWS",
"FULL_TEXT_SEARCH_BACKLINKS_WIKILINKS_ATTACHMENTS_MOUNTED_GRAPH",
"VERSION_HISTORY_DIFF_RECOVERY_CONFLICTS_AND_WRITE_RECEIPTS",
"LOCAL_FIRST_WITH_OPTIONAL_REMOTE_COLLABORATION",
"AGE_CONFIRMATION_AUTHORITY_FACT_AND_RECEIPT_BOUNDARY",
"WEBKIT_WEBVIEW2_LINUX_WEBKIT_PARITY_TESTS"
],
"audit": {
"first_live_ui_comparison_complete": true,
"full_source_data_security_and_license_audit_complete": false,
"allowed_outcomes": [
"KEEP_CONTRACT",
"KEEP_UX_REFERENCE",
"REDESIGN",
"REPLACE",
"RETIRE",
"INVESTIGATE"
],
"initial_correction": {
"electron_knowledge_workspace_human_experience_better": true,
"existing_tauri_engine_capability_inventory_broader": true,
"existing_tauri_feature_density_is_not_a_valid_screen_map": true
}
},
"human_surface": {
"primary_layers": [
"WORLD_ENTRY",
"MY_HOLOLAKE",
"KNOWLEDGE_AND_CREATION",
"ACTIVE_WORK",
"AGE_PARTNERSHIP",
"RESULT_CONFIRMATION_AND_RECEIPT"
],
"progressive_evidence_layers": [
"SOURCE_AND_VERSION",
"GIT",
"NODE",
"MODEL",
"SERVER",
"UPDATE",
"DIAGNOSTICS"
],
"internal_engineering_state_in_primary_navigation_allowed": false
},
"migration": {
"mode": "CLEAN_ROOM_CAPABILITY_CONTRACT_NOT_APPLICATION_NESTING",
"new_ui_build_requires_selected_visual_direction": true,
"first_vertical_slice": "KNOWLEDGE_TREE_PAGE_SEARCH_AND_SAFE_DURABILITY",
"required_before_donor_archive": [
"SOURCE_BACKED_CAPABILITY_MATRIX",
"RECOVERABLE_USER_DATA_BACKUP",
"DATA_MIGRATION_REHEARSAL",
"NEW_TAURI_REGRESSION_TESTS",
"SIGNED_INSTALLED_RUNTIME_ACCEPTANCE",
"HOLOLAKE_OWNED_UPDATE_ROUTE_ACCEPTANCE",
"HUMAN_VISIBLE_CLEANUP_SCOPE_CONFIRMATION",
"RECOVERABLE_ARCHIVE_RECEIPT"
],
"complete": false
},
"architecture_page": "product-source/hololake-platform/architecture/HOLOLAKE-CANONICAL-DESKTOP-SHELL-AND-CAPABILITY-MIGRATION-20260812.md",
"adr": "product-source/hololake-platform/docs/adr/0178-tauri-canonical-shell-and-electron-capability-donor.md"
}