feat(tcs): observe real macOS object tree read-only
This commit is contained in:
parent
6199e5b6bf
commit
de5fadf048
112 changed files with 15197 additions and 154 deletions
|
|
@ -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.
|
||||
Loading…
Reference in a new issue