hololake-system-architecture/language/programs/TCS-PROGRAM-MACOS-FOCUSED-APPLICATION-OBSERVE-0001.tcs

TCS 0.1;

PROGRAM TCS-PROGRAM-MACOS-FOCUSED-APPLICATION-OBSERVE-0001 {
  header { schema = "tcs.program/v1"; name_zh = "macOS当前聚焦应用结构树只读观察"; name_en = "macOS Focused Application Structured Tree Read Only Observation"; version = "0.1.0"; language = "TCS/0.1"; profile = "HLDP-NP/1"; protocols = ["TCS-HOST-STRUCTURED-OBJECT-TREE-OBSERVATION-0001", "TCS-HOLOLAKE-SHARED-DESKTOP-FRAMEWORK-BEHAVIOR-0001"]; lifecycle = "CANDIDATE"; canonical_uri = "language/programs/TCS-PROGRAM-MACOS-FOCUSED-APPLICATION-OBSERVE-0001.tcs"; compatibility = ["TCS-COMPILER-STAGE6-HOST-OBJECT-OBSERVATION-0001", "GIR/1"]; }
  source { source_id = "BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823"; source_uri = "language-sources/direct-human/BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823.txt"; source_sha256 = "a3dd8dbd2203b631bdb23f2693eb314d4ef86af68fdeaee8835e3cf0861ddd23"; source_role = "DIRECT_HUMAN"; }
  subject { subject_id = "TCS-HOST-OBJECT-OBSERVER-MACOS-0001"; subject_kind = "RUNTIME_INSTANCE"; channel_id = "ICE-CH-ZC001"; verification = "LOCAL_STAGE12_READ_ONLY_CANDIDATE"; }
  target { target_id = "MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001"; exact_path = "./state/shared-desktop/macos-observation/MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.hldp"; expected_state = "ABSENT"; expected_fingerprint = "NO_PRIOR_OBSERVATION_RECEIPT"; }
  inputs { HOST_SCOPE { type = "HostObjectTreeObservation"; source = "TCS_PROTOCOL"; required = true; platform = "MACOS"; adapter = "MACOS_ACCESSIBILITY"; root = "FOCUSED_APPLICATION"; mode = "READ_ONLY"; trust_prompt = false; max_depth = 2; max_nodes = 128; identity_scheme = "SHA256_V1_HOST_SNAPSHOT_PID_AXPATH_ROLE_SUBROLE"; attributes = ["ROLE", "SUBROLE", "TITLE_HASH", "VALUE_KIND", "ENABLED", "FOCUSED", "CHILDREN"]; } }
  outputs { OBJECT_TREE_OR_DENIAL { type = "Record"; destination = "TARGET_STATE"; integrity = "SHA256"; } OBSERVATION_RECEIPT { type = "Record"; destination = "RECEIPT"; integrity = "SHA256"; } }
  conditions { C1 { predicate = "MACOS_ADAPTER_PRESENT"; on_false = "FAIL_CLOSED"; } C2 { predicate = "READ_ONLY_AND_TRUST_PROMPT_FALSE"; on_false = "FAIL_CLOSED"; } C3 { predicate = "TARGET_INSIDE_SHARED_DESKTOP_MACOS_OBSERVATION_ROOT"; on_false = "FAIL_CLOSED"; } C4 { predicate = "NO_DESKTOP_ACTION_AND_NO_NETWORK"; on_false = "FAIL_CLOSED"; } }
  actions { A1 { operation = "CORE.OBSERVE_HOST_OBJECT_TREE"; input_refs = ["HOST_SCOPE"]; output_refs = ["OBJECT_TREE_OR_DENIAL", "OBSERVATION_RECEIPT"]; on_success = "COMPLETE"; on_failure = "FAIL_CLOSED"; } }
  authority { issuer = "ICE-GL∞_DIRECT_ENGINEERING_INSTRUCTION"; proof_ref = "BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823@a3dd8dbd2203"; scope = "ONE_LOCAL_MACOS_FOCUSED_APPLICATION_READ_ONLY_OBSERVATION_WITHOUT_PERMISSION_PROMPT"; valid_from = "2026-08-24"; valid_until = "CURRENT_STAGE12_END"; single_use = true; lease_required = false; }
  resources { runway = "LOCAL_TCS_GIR_RUNTIME_STAGE12_CANDIDATE"; concurrency = 1; timeout_ms = 5000; memory_limit_bytes = 67108864; }
  failure { errors = ["TCS-E2101", "TCS-E3001", "TCS-E4001", "TCS-E4002", "TCS-HOST-E4003", "TCS-HOST-E5102", "TCS-E6002", "TCS-E8001"]; fail_closed = true; }
  stop { signals = ["CALLER_STOP", "TIMEOUT", "ACCESSIBILITY_PERMISSION_NOT_GRANTED", "NO_FOCUSED_APPLICATION", "NODE_LIMIT_REACHED"]; safe_checkpoint = "WRITE_ONLY_EXPLICIT_OBSERVATION_OR_DENIAL_RECEIPT"; }
  cleanup { targets = ["./state/shared-desktop/macos-observation/.MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.tmp"]; exact_boundary = "ONE_STAGE12_OBSERVATION_TEMPORARY_FILE_ONLY"; }
  rollback { preconditions = ["PARTIAL_OBSERVATION_WITHOUT_READBACK"]; actions = ["REMOVE_ONLY_STAGE12_TEMPORARY_OBSERVATION"]; verification = ["NO_MACOS_ACTION", "NO_PERMISSION_PROMPT", "NO_NETWORK", "NO_OTHER_FILE_CHANGED"]; }
  receipt { protocol = "TCS-HOST-OBJECT-TREE-OBSERVATION-RECEIPT-v1"; machine_path = "./state/shared-desktop/macos-observation/MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.hldp"; human_projection = "REQUIRED"; integrity = "SHA256"; target_readback = "OBSERVED_TREE_HASH_OR_EXPLICIT_PERMISSION_DENIAL"; }
}