bingshuo/hololake-system-architecture
Watch
1
0
Fork
You've already forked hololake-system-architecture
 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity
hololake-system-architecture/build/TCS-PROGRAM-MACOS-FOCUSED-APPLICATION-OBSERVE-0001.human.en-US.md

14 KiB
Raw Blame History

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.