feat(tcs): observe real macOS object tree read-only

This commit is contained in:
冰朔 2026-08-24 13:20:52 +08:00
commit de5fadf048
112 changed files with 15197 additions and 154 deletions

View file

@ -0,0 +1,302 @@
# macOS Focused Application Structured Tree Read Only Observation · Human Engineering Language (English)
> This is an English reading projection of validated native TCS/HLDP source. It is not a new canonical source and grants no execution authority.
## What this is
This is a **program** declaration with identifier `TCS-PROGRAM-MACOS-FOCUSED-APPLICATION-OBSERVE-0001` and version `0.1.0`. The projector validates it with the Stage-1 compiler before changing its reading order.
## Who is here
- **subject** `subject`
- **channel_id**ICE-CH-ZC001 `subject.channel_id`
- **subject_id**TCS-HOST-OBJECT-OBSERVER-MACOS-0001 `subject.subject_id`
- **subject_kind**RUNTIME_INSTANCE `subject.subject_kind`
- **verification**LOCAL_STAGE12_READ_ONLY_CANDIDATE `subject.verification`
## Why this started
- **source** `source`
- **source identifier**BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823 `source.source_id`
- **source role**DIRECT_HUMAN `source.source_role`
- **source checksum**a3dd8dbd2203b631bdb23f2693eb314d4ef86af68fdeaee8835e3cf0861ddd23 `source.source_sha256`
- **source address**language-sources/direct-human/BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823.txt `source.source_uri`
## What changed
The native source does not provide this field; the projector does not guess.
## How it will execute
- **target** `target`
- **exact path**./state/shared-desktop/macos-observation/MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.hldp `target.exact_path`
- **expected fingerprint**NO_PRIOR_OBSERVATION_RECEIPT `target.expected_fingerprint`
- **expected state**ABSENT `target.expected_state`
- **target_id**MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001 `target.target_id`
- **inputs** `inputs`
- **HOST_SCOPE** `inputs.HOST_SCOPE`
- **adapter**MACOS_ACCESSIBILITY `inputs.HOST_SCOPE.adapter`
- **attributes** `inputs.HOST_SCOPE.attributes`
- ROLE
- SUBROLE
- TITLE_HASH
- VALUE_KIND
- ENABLED
- FOCUSED
- CHILDREN
- **identity_scheme**SHA256_V1_HOST_SNAPSHOT_PID_AXPATH_ROLE_SUBROLE `inputs.HOST_SCOPE.identity_scheme`
- **max_depth**2 `inputs.HOST_SCOPE.max_depth`
- **max_nodes**128 `inputs.HOST_SCOPE.max_nodes`
- **mode**READ_ONLY `inputs.HOST_SCOPE.mode`
- **platform**MACOS `inputs.HOST_SCOPE.platform`
- **required**yes `inputs.HOST_SCOPE.required`
- **root**FOCUSED_APPLICATION `inputs.HOST_SCOPE.root`
- **source**TCS_PROTOCOL `inputs.HOST_SCOPE.source`
- **trust_prompt**no `inputs.HOST_SCOPE.trust_prompt`
- **type**HostObjectTreeObservation `inputs.HOST_SCOPE.type`
- **conditions** `conditions`
- **C1** `conditions.C1`
- **on failure**FAIL_CLOSED `conditions.C1.on_false`
- **predicate**MACOS_ADAPTER_PRESENT `conditions.C1.predicate`
- **C2** `conditions.C2`
- **on failure**FAIL_CLOSED `conditions.C2.on_false`
- **predicate**READ_ONLY_AND_TRUST_PROMPT_FALSE `conditions.C2.predicate`
- **C3** `conditions.C3`
- **on failure**FAIL_CLOSED `conditions.C3.on_false`
- **predicate**TARGET_INSIDE_SHARED_DESKTOP_MACOS_OBSERVATION_ROOT `conditions.C3.predicate`
- **C4** `conditions.C4`
- **on failure**FAIL_CLOSED `conditions.C4.on_false`
- **predicate**NO_DESKTOP_ACTION_AND_NO_NETWORK `conditions.C4.predicate`
- **actions** `actions`
- **A1** `actions.A1`
- **input_refs** `actions.A1.input_refs`
- HOST_SCOPE
- **on failure**FAIL_CLOSED `actions.A1.on_failure`
- **on success**COMPLETE `actions.A1.on_success`
- **operation**CORE.OBSERVE_HOST_OBJECT_TREE `actions.A1.operation`
- **output_refs** `actions.A1.output_refs`
- OBJECT_TREE_OR_DENIAL
- OBSERVATION_RECEIPT
- **outputs** `outputs`
- **OBJECT_TREE_OR_DENIAL** `outputs.OBJECT_TREE_OR_DENIAL`
- **destination**TARGET_STATE `outputs.OBJECT_TREE_OR_DENIAL.destination`
- **integrity**SHA256 `outputs.OBJECT_TREE_OR_DENIAL.integrity`
- **type**Record `outputs.OBJECT_TREE_OR_DENIAL.type`
- **OBSERVATION_RECEIPT** `outputs.OBSERVATION_RECEIPT`
- **destination**RECEIPT `outputs.OBSERVATION_RECEIPT.destination`
- **integrity**SHA256 `outputs.OBSERVATION_RECEIPT.integrity`
- **type**Record `outputs.OBSERVATION_RECEIPT.type`
## Boundaries and exception handling
- **authority** `authority`
- **issuer**ICE-GL∞_DIRECT_ENGINEERING_INSTRUCTION `authority.issuer`
- **lease_required**no `authority.lease_required`
- **proof_ref**BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823@a3dd8dbd2203 `authority.proof_ref`
- **scope**ONE_LOCAL_MACOS_FOCUSED_APPLICATION_READ_ONLY_OBSERVATION_WITHOUT_PERMISSION_PROMPT `authority.scope`
- **single_use**yes `authority.single_use`
- **valid_from**2026-08-24 `authority.valid_from`
- **valid_until**CURRENT_STAGE12_END `authority.valid_until`
- **resources** `resources`
- **concurrency**1 `resources.concurrency`
- **memory limit in bytes**67108864 `resources.memory_limit_bytes`
- **runway**LOCAL_TCS_GIR_RUNTIME_STAGE12_CANDIDATE `resources.runway`
- **timeout in milliseconds**5000 `resources.timeout_ms`
- **failure** `failure`
- **errors** `failure.errors`
- TCS-E2101
- TCS-E3001
- TCS-E4001
- TCS-E4002
- TCS-HOST-E4003
- TCS-HOST-E5102
- TCS-E6002
- TCS-E8001
- **fail closed**yes `failure.fail_closed`
- **stop** `stop`
- **safe_checkpoint**WRITE_ONLY_EXPLICIT_OBSERVATION_OR_DENIAL_RECEIPT `stop.safe_checkpoint`
- **signals** `stop.signals`
- CALLER_STOP
- TIMEOUT
- ACCESSIBILITY_PERMISSION_NOT_GRANTED
- NO_FOCUSED_APPLICATION
- NODE_LIMIT_REACHED
- **cleanup** `cleanup`
- **exact_boundary**ONE_STAGE12_OBSERVATION_TEMPORARY_FILE_ONLY `cleanup.exact_boundary`
- **targets** `cleanup.targets`
- ./state/shared-desktop/macos-observation/.MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.tmp
- **rollback** `rollback`
- **actions** `rollback.actions`
- REMOVE_ONLY_STAGE12_TEMPORARY_OBSERVATION
- **preconditions** `rollback.preconditions`
- PARTIAL_OBSERVATION_WITHOUT_READBACK
- **verification** `rollback.verification`
- NO_MACOS_ACTION
- NO_PERMISSION_PROMPT
- NO_NETWORK
- NO_OTHER_FILE_CHANGED
## How completion is proven
- **receipt** `receipt`
- **human-readable projection**REQUIRED `receipt.human_projection`
- **integrity**SHA256 `receipt.integrity`
- **machine_path**./state/shared-desktop/macos-observation/MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.hldp `receipt.machine_path`
- **protocol**TCS-HOST-OBJECT-TREE-OBSERVATION-RECEIPT-v1 `receipt.protocol`
- **target_readback**OBSERVED_TREE_HASH_OR_EXPLICIT_PERMISSION_DENIAL `receipt.target_readback`
## Where to continue next time
The native source does not provide this field; the projector does not guess.
## Source and verification
- **Native declaration identifier**: `TCS-PROGRAM-MACOS-FOCUSED-APPLICATION-OBSERVE-0001`
- **Native declaration kind**: `PROGRAM`
- **TCS source SHA-256**: `f4cbc81d88aede257af0222e292ea828c7840cc0f6d097851699e402e5385650`
- **Validation compiler**: `TCS-COMPILER-STAGE6-HOST-OBJECT-OBSERVATION-0001`
- **Projection protocol**: `GLS-HLDP-HUMAN-ENGINEERING-PROJECTION-0001`
## Complete native structure cross-reference
All top-level structures and field paths are retained below so a reader can audit whether the projection omitted information.
- **actions** `actions`
- **A1** `actions.A1`
- **input_refs** `actions.A1.input_refs`
- HOST_SCOPE
- **on failure**FAIL_CLOSED `actions.A1.on_failure`
- **on success**COMPLETE `actions.A1.on_success`
- **operation**CORE.OBSERVE_HOST_OBJECT_TREE `actions.A1.operation`
- **output_refs** `actions.A1.output_refs`
- OBJECT_TREE_OR_DENIAL
- OBSERVATION_RECEIPT
- **authority** `authority`
- **issuer**ICE-GL∞_DIRECT_ENGINEERING_INSTRUCTION `authority.issuer`
- **lease_required**no `authority.lease_required`
- **proof_ref**BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823@a3dd8dbd2203 `authority.proof_ref`
- **scope**ONE_LOCAL_MACOS_FOCUSED_APPLICATION_READ_ONLY_OBSERVATION_WITHOUT_PERMISSION_PROMPT `authority.scope`
- **single_use**yes `authority.single_use`
- **valid_from**2026-08-24 `authority.valid_from`
- **valid_until**CURRENT_STAGE12_END `authority.valid_until`
- **cleanup** `cleanup`
- **exact_boundary**ONE_STAGE12_OBSERVATION_TEMPORARY_FILE_ONLY `cleanup.exact_boundary`
- **targets** `cleanup.targets`
- ./state/shared-desktop/macos-observation/.MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.tmp
- **conditions** `conditions`
- **C1** `conditions.C1`
- **on failure**FAIL_CLOSED `conditions.C1.on_false`
- **predicate**MACOS_ADAPTER_PRESENT `conditions.C1.predicate`
- **C2** `conditions.C2`
- **on failure**FAIL_CLOSED `conditions.C2.on_false`
- **predicate**READ_ONLY_AND_TRUST_PROMPT_FALSE `conditions.C2.predicate`
- **C3** `conditions.C3`
- **on failure**FAIL_CLOSED `conditions.C3.on_false`
- **predicate**TARGET_INSIDE_SHARED_DESKTOP_MACOS_OBSERVATION_ROOT `conditions.C3.predicate`
- **C4** `conditions.C4`
- **on failure**FAIL_CLOSED `conditions.C4.on_false`
- **predicate**NO_DESKTOP_ACTION_AND_NO_NETWORK `conditions.C4.predicate`
- **failure** `failure`
- **errors** `failure.errors`
- TCS-E2101
- TCS-E3001
- TCS-E4001
- TCS-E4002
- TCS-HOST-E4003
- TCS-HOST-E5102
- TCS-E6002
- TCS-E8001
- **fail closed**yes `failure.fail_closed`
- **header** `header`
- **canonical source path**language/programs/TCS-PROGRAM-MACOS-FOCUSED-APPLICATION-OBSERVE-0001.tcs `header.canonical_uri`
- **compatibility** `header.compatibility`
- TCS-COMPILER-STAGE6-HOST-OBJECT-OBSERVATION-0001
- GIR/1
- **language**TCS/0.1 `header.language`
- **lifecycle**CANDIDATE `header.lifecycle`
- **English name**macOS Focused Application Structured Tree Read Only Observation `header.name_en`
- **Chinese name**macOS当前聚焦应用结构树只读观察 `header.name_zh`
- **profile**HLDP-NP/1 `header.profile`
- **protocols** `header.protocols`
- TCS-HOST-STRUCTURED-OBJECT-TREE-OBSERVATION-0001
- TCS-HOLOLAKE-SHARED-DESKTOP-FRAMEWORK-BEHAVIOR-0001
- **schema**tcs.program/v1 `header.schema`
- **version**0.1.0 `header.version`
- **inputs** `inputs`
- **HOST_SCOPE** `inputs.HOST_SCOPE`
- **adapter**MACOS_ACCESSIBILITY `inputs.HOST_SCOPE.adapter`
- **attributes** `inputs.HOST_SCOPE.attributes`
- ROLE
- SUBROLE
- TITLE_HASH
- VALUE_KIND
- ENABLED
- FOCUSED
- CHILDREN
- **identity_scheme**SHA256_V1_HOST_SNAPSHOT_PID_AXPATH_ROLE_SUBROLE `inputs.HOST_SCOPE.identity_scheme`
- **max_depth**2 `inputs.HOST_SCOPE.max_depth`
- **max_nodes**128 `inputs.HOST_SCOPE.max_nodes`
- **mode**READ_ONLY `inputs.HOST_SCOPE.mode`
- **platform**MACOS `inputs.HOST_SCOPE.platform`
- **required**yes `inputs.HOST_SCOPE.required`
- **root**FOCUSED_APPLICATION `inputs.HOST_SCOPE.root`
- **source**TCS_PROTOCOL `inputs.HOST_SCOPE.source`
- **trust_prompt**no `inputs.HOST_SCOPE.trust_prompt`
- **type**HostObjectTreeObservation `inputs.HOST_SCOPE.type`
- **outputs** `outputs`
- **OBJECT_TREE_OR_DENIAL** `outputs.OBJECT_TREE_OR_DENIAL`
- **destination**TARGET_STATE `outputs.OBJECT_TREE_OR_DENIAL.destination`
- **integrity**SHA256 `outputs.OBJECT_TREE_OR_DENIAL.integrity`
- **type**Record `outputs.OBJECT_TREE_OR_DENIAL.type`
- **OBSERVATION_RECEIPT** `outputs.OBSERVATION_RECEIPT`
- **destination**RECEIPT `outputs.OBSERVATION_RECEIPT.destination`
- **integrity**SHA256 `outputs.OBSERVATION_RECEIPT.integrity`
- **type**Record `outputs.OBSERVATION_RECEIPT.type`
- **receipt** `receipt`
- **human-readable projection**REQUIRED `receipt.human_projection`
- **integrity**SHA256 `receipt.integrity`
- **machine_path**./state/shared-desktop/macos-observation/MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.hldp `receipt.machine_path`
- **protocol**TCS-HOST-OBJECT-TREE-OBSERVATION-RECEIPT-v1 `receipt.protocol`
- **target_readback**OBSERVED_TREE_HASH_OR_EXPLICIT_PERMISSION_DENIAL `receipt.target_readback`
- **resources** `resources`
- **concurrency**1 `resources.concurrency`
- **memory limit in bytes**67108864 `resources.memory_limit_bytes`
- **runway**LOCAL_TCS_GIR_RUNTIME_STAGE12_CANDIDATE `resources.runway`
- **timeout in milliseconds**5000 `resources.timeout_ms`
- **rollback** `rollback`
- **actions** `rollback.actions`
- REMOVE_ONLY_STAGE12_TEMPORARY_OBSERVATION
- **preconditions** `rollback.preconditions`
- PARTIAL_OBSERVATION_WITHOUT_READBACK
- **verification** `rollback.verification`
- NO_MACOS_ACTION
- NO_PERMISSION_PROMPT
- NO_NETWORK
- NO_OTHER_FILE_CHANGED
- **source** `source`
- **source identifier**BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823 `source.source_id`
- **source role**DIRECT_HUMAN `source.source_role`
- **source checksum**a3dd8dbd2203b631bdb23f2693eb314d4ef86af68fdeaee8835e3cf0861ddd23 `source.source_sha256`
- **source address**language-sources/direct-human/BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823.txt `source.source_uri`
- **stop** `stop`
- **safe_checkpoint**WRITE_ONLY_EXPLICIT_OBSERVATION_OR_DENIAL_RECEIPT `stop.safe_checkpoint`
- **signals** `stop.signals`
- CALLER_STOP
- TIMEOUT
- ACCESSIBILITY_PERMISSION_NOT_GRANTED
- NO_FOCUSED_APPLICATION
- NODE_LIMIT_REACHED
- **subject** `subject`
- **channel_id**ICE-CH-ZC001 `subject.channel_id`
- **subject_id**TCS-HOST-OBJECT-OBSERVER-MACOS-0001 `subject.subject_id`
- **subject_kind**RUNTIME_INSTANCE `subject.subject_kind`
- **verification**LOCAL_STAGE12_READ_ONLY_CANDIDATE `subject.verification`
- **target** `target`
- **exact path**./state/shared-desktop/macos-observation/MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.hldp `target.exact_path`
- **expected fingerprint**NO_PRIOR_OBSERVATION_RECEIPT `target.expected_fingerprint`
- **expected state**ABSENT `target.expected_state`
- **target_id**MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001 `target.target_id`
---
This page changes only the reading order; it does not change TCS/HLDP semantics.