hololake-system-architecture/product-source/hololake-native-desktop/contracts/module-donor-admission-registry.json

{
  "schema": "hololake.module-donor-admission-registry/v1",
  "record_id": "HLP-MODULE-DONOR-ADMISSION-001",
  "state": "SEVEN_CANDIDATES_ADMITTED_DONOR_SOURCES_REMAIN_READ_ONLY",
  "root_rule": {
    "official_base": "HOLOLAKE_0.5.0_NUMBERED_IPC_ROOT",
    "repair_old_application_in_place": false,
    "bulk_merge_or_wholesale_copy_allowed": false,
    "one_candidate_per_admission_cycle": true,
    "candidate_number_is_runtime_module_number": false,
    "permanent_module_number_assignment_before_acceptance": false,
    "all_frontend_backend_calls_must_cross_numbered_ipc": true,
    "shared_file_merge_is_admission_evidence": false
  },
  "donors": [
    {
      "donor_id": "HLP-DONOR-COMPILED-DESKTOP-0.4.1",
      "kind": "COMPILED_MACOS_APPLICATION",
      "path": "/Volumes/JZAO/HoloLake/artifacts/hololake-release/0.4.1/macos-arm64/pre-numbered-root-donor/HoloLake.app",
      "state": "READ_ONLY",
      "source_commit": null,
      "source_commit_state": "UNKNOWN_NOT_INFERRED_FROM_COMPILED_BUNDLE",
      "binary_sha256": "adc0d8b028a8b874c39909265ed7c41e7c24e4fe5b38adba04e8f72b64900c15",
      "use": "BEHAVIOR_AND_VISIBLE_PRODUCT_REFERENCE_ONLY"
    },
    {
      "donor_id": "HLP-DONOR-CHAOTIC-WORKTREE-20260818",
      "kind": "DIRTY_SOURCE_WORKTREE",
      "path": "/Users/bingshuolingdianyuanhe/Documents/Codex/2026-08-15/new-chat-2/work/jd-guanghu-supervisor/product-source/hololake-native-desktop",
      "observed_head": "a8fe571b5d5c0a45207b64ac538d729b3d719d21",
      "observed_dirty_path_count": 30,
      "state": "READ_ONLY_UNTRUSTED_AS_A_WHOLE",
      "use": "INDIVIDUAL_MODULE_SOURCE_CANDIDATES_ONLY"
    }
  ],
  "rejected_inputs": [
    {
      "candidate_number": "HLP-DONOR-CAND-0000",
      "name": "legacy_numbered_operation_runtime",
      "state": "REJECTED_SUPERSEDED",
      "why": "It predates the single numbered IPC root and must not become a second numbering authority.",
      "paths": [
        "contracts/numbered-operation-runtime.json",
        "src/modules/numbered-runtime.ts",
        "src-tauri/src/numbered_operation_runtime.rs"
      ]
    },
    {
      "candidate_number": "HLP-DONOR-CAND-SHARED-MUTATIONS",
      "name": "shared_file_mutation_set",
      "state": "REJECTED_AS_MERGE_UNIT",
      "why": "These files mix unrelated modules and divergent frontend/backend routes; each needed behavior must be reconstructed behind its owning numbered module.",
      "examples": [
        "src/main.tsx",
        "src/styles.css",
        "src-tauri/src/lib.rs",
        "src-tauri/src/knowledge_base.rs",
        "src-tauri/src/gls_protocol_runtime.rs"
      ]
    }
  ],
  "candidates": [
    {
      "admission_order": 1,
      "candidate_number": "HLP-DONOR-CAND-0001",
      "name": "native_composition_module_runtime",
      "state": "ADMITTED_INSTALLED_RUNTIME_ACCEPTED",
      "paths": [
        "contracts/native-composition-runtime.json",
        "src/modules/native-composition",
        "src-tauri/src/native_composition.rs",
        "src/styles.css#native-composition-selectors-only"
      ],
      "style_dependency_discovered_during_admission": "Only selectors prefixed native-composition or composition- were isolated into the module directory; unrelated global donor CSS remains prohibited.",
      "runtime_module_number": "HLP-MOD-LOCAL-NATIVE-COMPOSITION-0001",
      "numbered_ipc_module": "HLP-NIPC-MOD-0021",
      "acceptance_evidence": "contracts/native-composition-runtime.json#current_acceptance",
      "why_first": "A module needs an isolated mount, self-test, unmount and rollback boundary before content modules can be admitted safely."
    },
    {
      "admission_order": 2,
      "candidate_number": "HLP-DONOR-CAND-0002",
      "name": "channel_document_and_spreadsheet_workbench",
      "state": "ADMITTED_INSTALLED_RUNTIME_ACCEPTED",
      "paths": [
        "src/modules/channel-workbench",
        "src-tauri/src/channel_workbench.rs",
        "src/styles.css#education-engine-and-channel-spreadsheet-selectors-only"
      ],
      "style_dependency_discovered_during_admission": "Only the document-engine and channel-spreadsheet selector behavior was isolated into the module directory; unrelated education and global donor CSS remains prohibited.",
      "runtime_module_number": "HLP-MOD-LOCAL-CHANNEL-WORKBENCH-0001",
      "numbered_ipc_module": "HLP-NIPC-MOD-0022",
      "acceptance_evidence": "contracts/channel-workbench-runtime.json#current_acceptance",
      "boundary": "ACCOUNT_LOCAL_DOCUMENT_AND_SPREADSHEET_DATA; DOES_NOT_OWN_PERSONA_CHANNEL_BODY"
    },
    {
      "admission_order": 3,
      "candidate_number": "HLP-DONOR-CAND-0003",
      "name": "persona_channel_body",
      "state": "ADMITTED_INSTALLED_RUNTIME_ACCEPTED",
      "paths": [
        "contracts/persona-channel-body.json",
        "src/modules/persona-channel-body",
        "src-tauri/src/persona_channel_body.rs",
        "src-tauri/src/channel_growth.rs"
      ],
      "style_dependency_discovered_during_admission": "Only persona-body selectors were isolated into the module directory; no donor global stylesheet or unrelated feature selectors were admitted.",
      "runtime_module_number": "HLP-MOD-LOCAL-PERSONA-CHANNEL-BODY-0001",
      "numbered_ipc_module": "HLP-NIPC-MOD-0023",
      "acceptance_evidence": "contracts/persona-channel-body.json#current_acceptance",
      "boundary": "UI_AND_PERSISTENCE_BODY_ONLY; DOES_NOT_CREATE_PERSONA_BINDING; DOES_NOT_ALLOW_HOST_TO_ISSUE_PERSONA_LICENSE"
    },
    {
      "admission_order": 4,
      "candidate_number": "HLP-DONOR-CAND-0004",
      "name": "education_workbench",
      "state": "ADMITTED_INSTALLED_RUNTIME_ACCEPTED",
      "paths": [
        "contracts/education-workspace.json",
        "src/modules/education-workspace",
        "src-tauri/src/education_translation.rs",
        "src-tauri/src/education_workspace.rs"
      ],
      "runtime_module_number": "HLP-MOD-OFFICIAL-EDUCATION-WORKBENCH-0001",
      "numbered_ipc_module": "HLP-NIPC-MOD-0024",
      "acceptance_evidence": "contracts/education-workspace.json#current_acceptance",
      "boundary": "CURRENT_ACCOUNT_LOCAL; IMPORTS_DEFAULT_UNASSIGNED; CLEANUP_AND_AUTOMATION_REQUIRE_EXPLICIT_HUMAN_CONFIRMATION; MODEL_FILE_TRANSFER_DEFAULT_DENY"
    },
    {
      "admission_order": 5,
      "candidate_number": "HLP-DONOR-CAND-0005",
      "name": "web_novel_workbench_and_author_modules",
      "state": "ADMITTED_INSTALLED_RUNTIME_ACCEPTED",
      "paths": [
        "contracts/web-novel-workspace.json",
        "contracts/web-novel-module-marketplace-plan.json",
        "src/modules/web-novel/WebNovelWorkspace.tsx",
        "src/modules/web-novel/AuthorModuleCenter.tsx",
        "src/modules/web-novel/AuthorWritingSidecar.tsx",
        "src-tauri/src/web_novel_workspace.rs",
        "src-tauri/src/web_novel_import.rs",
        "src-tauri/src/web_novel_author.rs",
        "src-tauri/src/web_novel_modules.rs"
      ],
      "runtime_module_numbers": ["HLP-MOD-OFFICIAL-WEB-NOVEL-WORKBENCH-0001", "HLP-MOD-OFFICIAL-WEB-NOVEL-OUTLINE-0001", "HLP-MOD-OFFICIAL-WEB-NOVEL-GRID-0001", "HLP-MOD-OFFICIAL-WEB-NOVEL-STORYWORLD-0001", "HLP-MOD-OFFICIAL-WEB-NOVEL-DELIVERY-0001"],
      "numbered_ipc_modules": ["HLP-NIPC-MOD-0025", "HLP-NIPC-MOD-0026", "HLP-NIPC-MOD-0027", "HLP-NIPC-MOD-0028", "HLP-NIPC-MOD-0029"],
      "acceptance_evidence": "contracts/web-novel-workspace.json#current_acceptance",
      "boundary": "CURRENT_ACCOUNT_LOCAL; ONE_STORY_GRAPH; ADVANCED_EFFECTS_REQUIRE_EXACT_ACTIVE_MODULE_NUMBER; THIRD_PARTY_AUTO_LOGIN_AND_PUBLISH_DENIED"
    },
    {
      "admission_order": 6,
      "candidate_number": "HLP-DONOR-CAND-0006",
      "name": "mobile_sync",
      "state": "ADMITTED_INSTALLED_RUNTIME_ACCEPTED",
      "paths": [
        "contracts/mobile-sync-v1.json",
        "src/MobileSyncPanel.tsx",
        "src-tauri/src/mobile_sync.rs"
      ],
      "runtime_module_number": "HLP-MOD-OFFICIAL-MOBILE-SYNC-0001",
      "numbered_ipc_module": "HLP-NIPC-MOD-0030",
      "acceptance_evidence": "contracts/mobile-sync-v1.json#current_acceptance",
      "boundary": "DESKTOP_ROOT_NODE_SAME_LAN_BRIDGE_ONLY; EXPLICIT_LISTENER; IOS_INSTALLABLE_PACKAGE_PENDING_SEPARATE_ADMISSION; NO_SECOND_PERSONA_SYSTEM"
    },
    {
      "admission_order": 7,
      "candidate_number": "HLP-DONOR-CAND-0007",
      "name": "dynamic_language_world_visual_surface",
      "state": "ADMITTED_INSTALLED_RUNTIME_ACCEPTED",
      "paths": [
        "contracts/dynamic-language-world-visual-system.json",
        "src/StarlakeSurface.tsx",
        "src/starlake-surface.css",
        "src/traditional-surface.tsx",
        "src/traditional-surface.css",
        "src-tauri/src/world_climate.rs"
      ],
      "runtime_module_number": "HLP-MOD-OFFICIAL-DYNAMIC-WORLD-SURFACE-0001",
      "numbered_ipc_module": "HLP-NIPC-MOD-0031",
      "acceptance_evidence": "contracts/dynamic-language-world-visual-system.json#current_acceptance",
      "boundary": "REALITY_TIME_AND_PUBLIC_WEATHER_VISUAL_PROJECTION_ONLY; OFFICIAL_FIVE_LAKE_SHELL_AND_ROUTING_UNCHANGED; NO_FAKE_WEATHER_OR_SIMULATED_STATUS"
    }
  ],
  "admission_gate": [
    "EXTRACT_ONLY_DECLARED_CANDIDATE_PATHS",
    "REVIEW_SOURCE_PROVENANCE_AND_LICENSE",
    "DEFINE_DATA_PERMISSION_AND_RESOURCE_BOUNDARY",
    "ALLOCATE_NUMBERED_IPC_MODULE_TARGET_AND_OPERATION_COORDINATES",
    "IMPLEMENT_ADAPTER_WITHOUT_RAW_TAURI_INVOKE",
    "ADD_UNIT_INTEGRATION_AND_NEGATIVE_ROUTE_TESTS",
    "BUILD_FROM_CLEAN_OFFICIAL_BASE",
    "INSTALL_IN_ISOLATED_RUNTIME",
    "VERIFY_MOUNT_SELF_TEST_RESTART_UNMOUNT_AND_ROLLBACK",
    "WRITE_HASH_CHAINED_RUNTIME_RECEIPT",
    "ONLY_THEN_ASSIGN_PERMANENT_MODULE_NUMBER"
  ],
  "hot_install_boundary": {
    "runtime_state": "SIGNED_DECLARATIVE_PACKAGE_ENGINE_IMPLEMENTED",
    "runtime_contract": "contracts/module-package-runtime.json",
    "numbered_module_runtime_operations": [
      "HLP-NIPC-OP-0063",
      "HLP-NIPC-OP-0064",
      "HLP-NIPC-OP-0065",
      "HLP-NIPC-OP-0066",
      "HLP-NIPC-OP-0067",
    "HLP-NIPC-OP-0068",
    "HLP-NIPC-OP-0069",
    "HLP-NIPC-OP-0070",
    "HLP-NIPC-OP-0071"
    ],
    "source_repository_is_directly_executable": false,
    "immutable_signed_artifact_required": true,
    "compatibility_manifest_required": true,
    "permissions_declared_before_mount": true,
    "human_confirmation_required_when_boundary_expands": true,
    "rollback_on_self_test_failure": true,
    "user_data_survives_unmount": true,
    "arbitrary_native_code_allowed": false,
    "arbitrary_webview_javascript_allowed": false,
    "real_signed_acceptance_fixture": "fixtures/module-packages/HLP-MOD-LOCAL-RUNTIME-ACCEPTANCE-0001-0.1.0.ghmod"
  }
}