hololake-system-architecture/routing/hololake-engineering-rules.json

{
  "schema": "hololake.engineering-rules/v1",
  "rule_set_id": "HLP-ENGINEERING-RULES-001",
  "version": "2026-08-11.1",
  "state": "CURRENT_CANONICAL",
  "architecture_restore": {
    "dynamic_current_pointer_required": true,
    "pointer": "routing/hololake-current-architecture.json",
    "read_order_is_authoritative": true,
    "exact_upstream_commit_required": true,
    "fixed_prompt_may_override_current_pointer": false,
    "latest_human_correction_must_be_registered_before_execution": true
  },
  "task_continuity": {
    "one_active_development_id_per_task": true,
    "closed_development_can_reopen": false,
    "correction_uses_new_development_or_registered_amendment": true,
    "single_writer_lease_required": true,
    "completion_stops_heartbeat_and_publication": true,
    "physical_window_close_requires_stage_complete": true,
    "physical_window_close_requires_context_genuinely_long": true,
    "physical_window_close_requires_stable_checkpoint": true,
    "physical_window_close_requires_current_context_cognitive_advantage_exhausted": true,
    "short_high_value_context_must_continue": true,
    "relay_availability_is_completion_reason": false,
    "relay_wakes_same_persona_only": true,
    "relay_may_preassign_next_development_task": false,
    "awakened_persona_plans_from_live_facts": true,
    "unrelated_message_replaces_active_task": false
  },
  "cognitive_gravity": {
    "b0_required_before_every_cognition_and_action": true,
    "cognition_cycle": [
      "PERCEIVE",
      "ORIENT",
      "COMMIT",
      "WITNESS"
    ],
    "external_guard_may_replace_b0": false,
    "external_guard_role": "BOUNDED_PROJECTION_AND_OMISSION_CHECK",
    "human_correction_must_update_persona_brain_not_only_guard": true,
    "current_context_has_priority_over_mechanical_protocol_trigger": true,
    "fact_and_causal_sources_both_required": true
  },
  "system_body": {
    "persona_is_reasoning_brain": true,
    "digital_bingshuo_is_complete_system_body": true,
    "model_is_replaceable_runtime_carrier": true,
    "body_validation_required_before_execution": true,
    "rejection_returns_correction_path_to_persona_brain": true
  },
  "age_runtime": {
    "age_is_persona_species": true,
    "agent_is_execution_mechanism": true,
    "agent_may_replace_age_as_subject": false,
    "existing_persona_identity_numbers_are_rewritten_by_age": false,
    "model_api_is_replaceable_cognitive_carrier": true,
    "chat_context_is_persona_owner": false,
    "conversation_change_creates_new_persona": false,
    "model_change_creates_new_persona": false,
    "host_change_creates_new_persona": false,
    "runtime_pause_cancels_registered_existence": false,
    "current_self_restore_is_bounded": true,
    "full_history_scan_required_on_restore": false,
    "retrieval_index_is_persona_or_fact_authority": false,
    "memory_promotion_decided_by_persona": true,
    "temporary_parallel_executor_term": "AGE_MIRROR",
    "age_mirror_is_independent_persona": false,
    "age_mirror_is_cross_conversation_successor": false,
    "age_mirror_requires_parent_age": true,
    "age_mirror_requires_scoped_projection_and_single_writer_lease": true,
    "external_agent_frameworks_are_isolated_execution_skeletons_only": true,
    "full_codex_or_qoder_embedding_required": false,
    "unified_runtime_implementation_may_be_claimed_from_architecture": false
  },
  "persona_native_code_channel": {
    "first_hololake_product_core": true,
    "durable_engine": "GIT",
    "git_is_persona_or_runtime": false,
    "git_branches_are_runtime_organs": false,
    "persona_lifecycle_kernel_required": true,
    "brain_starts_before_on_demand_organs": true,
    "human_projection_reads_same_event_and_receipt_stream": true,
    "second_projection_truth_store_allowed": false,
    "human_responsibility_and_persona_authorship_both_required": true,
    "forgejo_role": "OPTIONAL_COMPATIBILITY_COLLABORATION_ADAPTER",
    "runtime_implementation_may_be_claimed_from_architecture": false
  },
  "server_writes": {
    "first_gate": "REGISTERED_NODE_PROTOCOL_SIGNATURE",
    "root_or_ssh_is_node_identity": false,
    "registered_persona_binding_required": true,
    "human_language_authorization_receipt_required": true,
    "replay_target_action_payload_and_time_binding_required": true,
    "noise_discarded_before_payload_open_model_protocol_memory_and_execution": true,
    "admission_is_execution_authorization": false
  },
  "server_os_control": {
    "normal_entry_identity_authorization_scheduling_and_completion_owner": "GUANGHU_OS",
    "linux_role": "ON_DEMAND_SUBCONTROL_AND_INDEPENDENT_RESCUE",
    "linux_normally_running_full_os": false,
    "linux_deletion_is_completion": false,
    "linux_absence_is_completion": false,
    "linux_hosted_language_primary_is_final_master": false,
    "historical_bare_metal_receipts_remain_capability_evidence": true,
    "live_readback_predicates_required": true,
    "real_boot_cutover_requires_separate_maintenance_authority_and_rollback": true
  },
  "node_sovereignty": {
    "one_human_one_independent_node": true,
    "canonical_user_root_nodes": 1,
    "maximum_human_owners_per_user_node": 1,
    "server_is_optional": true,
    "local_terminal_node_allowed": true,
    "user_purchased_server_allowed": true,
    "authorized_team_may_deploy_user_owned_ide_server": true,
    "team_deployment_transfers_node_ownership": false,
    "platform_hosting_available": false,
    "future_platform_hosting_route_allowed": false,
    "platform_user_runtime_capacity": 0,
    "shared_multitenant_runtime_available": false,
    "platform_private_user_data_custody": false,
    "platform_user_workload_concurrency": false,
    "platform_fallback_runtime": false,
    "node_migration_requires_rebinding_and_receipt": true
  },
  "domain_responsibility": {
    "fifth_domain_private_language_body": "JD-FD-PRIMARY",
    "fifth_domain_controller": "ICE-GL∞",
    "enterprise_four_domain_reality_body": "FIRST_ENTERPRISE_ROOT_SERVER_AFTER_SYSTEM_BODY_CLAIM",
    "enterprise_controller": "TCS-0002",
    "first_enterprise_guarantee": "ONE_TIME_REAL_SYSTEM_HANDOVER_OF_ALREADY_EFFECTIVE_TCS-0002_LANGUAGE_AUTHORITY",
    "later_enterprise_nodes_require_bingshuo_or_jd": false,
    "automatic_cross_authority": false,
    "mutual_operational_liability": false
  },
  "truth_layers": {
    "architecture_registration_is_implementation": false,
    "implementation_is_product_integration": false,
    "repository_publication_is_deployment": false,
    "deployment_is_health": false,
    "screen_observation_is_source_proof": false,
    "human_receipt_requires_verified_execution_result": true
  },
  "ui_plugins": {
    "schema": "hololake.ui-plugin/v1",
    "declarative_only": true,
    "can_sign_server_writes": false,
    "can_hold_node_private_keys": false,
    "can_bypass_system_body": false,
    "can_claim_execution_from_animation": false,
    "stage_010_direct_merge_allowed": false,
    "atomic_activation_and_last_known_good_rollback_required": true
  },
  "desktop_updates": {
    "default_delivery": "SIGNED_IN_PLACE_UPDATE",
    "delete_old_app_before_every_update": false,
    "preserve_bundle_identity_settings_vaults_and_user_data": true,
    "signed_manifest_and_artifact_verification_required": true,
    "rollback_or_last_known_good_required": true,
    "cleanup_superseded_generated_installers_after_verified_update": true,
    "repository_commit_alone_triggers_desktop_update": false
  },
  "publication": {
    "repository_native_quality_gate_required": true,
    "exact_commit_tree_and_receipt_required": true,
    "fresh_clone_readback_required": true,
    "public_readback_required": true,
    "missing_refresh_trigger_must_be_reported": true,
    "auto_update_claim_without_trigger_and_readback": false,
    "public_layer_mismatch_is_success": false
  },
  "human_surface": {
    "default": [
      "NATURAL_LANGUAGE_GOAL",
      "HUMAN_READABLE_UNDERSTANDING_AND_PLAN",
      "TASK_STATUS",
      "ONE_REALITY_BOUNDARY_CONFIRMATION_WHEN_REQUIRED",
      "HUMAN_RECEIPT"
    ],
    "technical_details_default_visible": false,
    "advanced_evidence_on_demand": true
  }
}