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": "DONORS_QUARANTINED_CANDIDATES_NUMBERED_NOT_ADMITTED",
  "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": "QUARANTINED_ASSESS_FIRST",
      "paths": [
        "contracts/native-composition-runtime.json",
        "src/modules/native-composition",
        "src-tauri/src/native_composition.rs"
      ],
      "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": "QUARANTINED_PENDING_ADMISSION",
      "paths": [
        "src/modules/channel-workbench"
      ]
    },
    {
      "admission_order": 3,
      "candidate_number": "HLP-DONOR-CAND-0003",
      "name": "persona_channel_body",
      "state": "QUARANTINED_PENDING_ADMISSION",
      "paths": [
        "contracts/persona-channel-body.json",
        "src/PersonaChannelBody.tsx",
        "src-tauri/src/persona_channel_body.rs",
        "src-tauri/src/channel_growth.rs"
      ],
      "boundary": "UI_AND_PERSISTENCE_BODY_ONLY; DOES_NOT_CREATE_PERSONA_BINDING"
    },
    {
      "admission_order": 4,
      "candidate_number": "HLP-DONOR-CAND-0004",
      "name": "education_workbench",
      "state": "QUARANTINED_PENDING_ADMISSION",
      "paths": [
        "contracts/education-workspace.json",
        "src/modules/education-adaptive-rendering.ts",
        "src/modules/education-data.ts",
        "src/modules/education-document-engine.tsx",
        "src-tauri/src/education_translation.rs",
        "src-tauri/src/education_workspace.rs"
      ]
    },
    {
      "admission_order": 5,
      "candidate_number": "HLP-DONOR-CAND-0005",
      "name": "web_novel_workbench_and_author_modules",
      "state": "QUARANTINED_PENDING_ADMISSION",
      "paths": [
        "contracts/web-novel-workspace.json",
        "contracts/web-novel-module-marketplace-plan.json",
        "src/WebNovelWorkspace.tsx",
        "src/AuthorModuleCenter.tsx",
        "src/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"
      ]
    },
    {
      "admission_order": 6,
      "candidate_number": "HLP-DONOR-CAND-0006",
      "name": "mobile_sync",
      "state": "QUARANTINED_PENDING_ADMISSION",
      "paths": [
        "contracts/mobile-sync-v1.json",
        "src/MobileSyncPanel.tsx",
        "src-tauri/src/mobile_sync.rs"
      ]
    },
    {
      "admission_order": 7,
      "candidate_number": "HLP-DONOR-CAND-0007",
      "name": "dynamic_language_world_visual_surface",
      "state": "QUARANTINED_PENDING_ADMISSION",
      "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"
      ]
    }
  ],
  "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"
    ],
    "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"
  }
}