arch(hololake): establish clean Tauri desktop line

2026-08-12 08:32:37 +08:00 · 2026-08-12 08:32:37 +08:00 · a2302cfd13
commit a2302cfd13
parent d1c8d79899
23 changed files with 662 additions and 17 deletions
--- a/routing/hololake-canonical-desktop-shell.json
+++ b/routing/hololake-canonical-desktop-shell.json
@ -0,0 +1,137 @@
+{
+  "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"
+}