feat(tcs): define generic action graph loader

2026-08-23 23:35:19 +08:00 · 2026-08-23 23:35:19 +08:00 · b5072d6a8b
commit b5072d6a8b
parent d5c87e3768
40 changed files with 3742 additions and 18 deletions
--- a/packages/TCS-MOD-GENERIC-ACTION-GRAPH-LOADER-0001/module.manifest.human.en-US.md
+++ b/packages/TCS-MOD-GENERIC-ACTION-GRAPH-LOADER-0001/module.manifest.human.en-US.md
@ -0,0 +1,172 @@
+# TCS Generic Action Graph Loader Module Manifest · 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 **protocol** declaration with identifier `TCS-MOD-GENERIC-ACTION-GRAPH-LOADER-0001-MANIFEST` and version `0.1.0`. The projector validates it with the Stage-1 compiler before changing its reading order.
+
+## Who is here
+
+- **manifest**  `manifest`
+  - **capabilities**  `manifest.capabilities`
+    - TCS.EXECUTE_ACTION_GRAPH
+    - TCS.GENERIC_ACTION_GRAPH_EXECUTION
+    - TCS.CAPABILITY_RESOLUTION
+    - TCS.TARGET_READBACK_RECEIPT
+    - TCS.BOUNDED_ROLLBACK
+  - **compiler_id**：TCS-COMPILER-STAGE3-GENERIC-ACTION-LOADER-0001  `manifest.compiler_id`
+  - **compiler_sha256**：cd4889b941976bae3ce8c22f081d6da9bb880b4466ef271f1516c6d3d241b5ee  `manifest.compiler_sha256`
+  - **display_name_zh**：TCS通用动作图装载器模块  `manifest.display_name_zh`
+  - **entry_program_id**：TCS-PROGRAM-GENERIC-ACTION-GRAPH-LOADER-SELF-TEST-0001  `manifest.entry_program_id`
+  - **gir_sha256**：1000971f4121ccab9c396f68a4bcf9ff0cb5f116d4dbfdf051f8607dd22abd33  `manifest.gir_sha256`
+  - **module_id**：TCS-MOD-GENERIC-ACTION-GRAPH-LOADER-0001  `manifest.module_id`
+  - **protocols**  `manifest.protocols`
+    - TCS-MODULE-ABI-0001
+    - TCS-GENERIC-ACTION-GRAPH-LOADER-0001
+    - TCS-HOST-ABI-0001
+  - **version**：0.1.0  `manifest.version`
+
+## Why this started
+
+- **source**  `source`
+  - **source identifier**：TCS-MOD-GENERIC-ACTION-GRAPH-LOADER-0001  `source.source_id`
+  - **source role**：REGISTERED_MODULE  `source.source_role`
+  - **source checksum**：424d0b79ca40859c6a62e29f5a434ea0a6417f3ca582322e9c66ad9831ffd5c0  `source.source_sha256`
+  - **source address**：packages/TCS-MOD-GENERIC-ACTION-GRAPH-LOADER-0001/module.tcs  `source.source_uri`
+
+## What changed
+
+The native source does not provide this field; the projector does not guess.
+
+## How it will execute
+
+This is a non-executable declaration and has no action graph.
+
+## Boundaries and exception handling
+
+- **authority_ceiling**  `authority_ceiling`
+  - **host_may_expand_scope**：no  `authority_ceiling.host_may_expand_scope`
+  - **network**：no  `authority_ceiling.network`
+  - **value**：CHILD_GIR_EXACT_TARGET_AUTHORITY_AND_RESOURCE_CEILINGS  `authority_ceiling.value`
+- **resource_ceiling**  `resource_ceiling`
+  - **concurrency**：1  `resource_ceiling.concurrency`
+  - **memory limit in bytes**：268435456  `resource_ceiling.memory_limit_bytes`
+  - **timeout in milliseconds**：30000  `resource_ceiling.timeout_ms`
+- **data_scope**  `data_scope`
+  - **read**  `data_scope.read`
+    - VERIFIED_GIR
+    - LOCKED_CAPABILITY_REGISTRY
+    - MODULE_LOCKS
+    - EXACT_TARGET_STATE
+  - **write**  `data_scope.write`
+    - CHILD_EXACT_TARGET
+    - ACTION_RESULTS
+    - TARGET_READBACK
+    - RECEIPT
+- **network_scope**  `network_scope`
+  - **allowed**：no  `network_scope.allowed`
+  - **domains**  `network_scope.domains`
+    - none
+- **rollback**  `rollback`
+  - **value**：REMOVE_ONLY_PARTIAL_SELF_TEST_RECEIPTS_AND_PRESERVE_SOURCE_GIR_AND_FAILURE_EVIDENCE  `rollback.value`
+
+## How completion is proven
+
+The native source does not provide this field; the projector does not guess.
+
+## 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-MOD-GENERIC-ACTION-GRAPH-LOADER-0001-MANIFEST`
+- **Native declaration kind**: `PROTOCOL`
+- **TCS source SHA-256**: `08044c0b972c6a614e41913314432c5b8d9a0c4af78d896cb5ace3ca9924b1ef`
+- **Validation compiler**: `TCS-COMPILER-STAGE3-GENERIC-ACTION-LOADER-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.
+
+- **authority_ceiling**  `authority_ceiling`
+  - **host_may_expand_scope**：no  `authority_ceiling.host_may_expand_scope`
+  - **network**：no  `authority_ceiling.network`
+  - **value**：CHILD_GIR_EXACT_TARGET_AUTHORITY_AND_RESOURCE_CEILINGS  `authority_ceiling.value`
+- **data_scope**  `data_scope`
+  - **read**  `data_scope.read`
+    - VERIFIED_GIR
+    - LOCKED_CAPABILITY_REGISTRY
+    - MODULE_LOCKS
+    - EXACT_TARGET_STATE
+  - **write**  `data_scope.write`
+    - CHILD_EXACT_TARGET
+    - ACTION_RESULTS
+    - TARGET_READBACK
+    - RECEIPT
+- **header**  `header`
+  - **canonical source path**：packages/TCS-MOD-GENERIC-ACTION-GRAPH-LOADER-0001/module.manifest.tcs  `header.canonical_uri`
+  - **compatibility**  `header.compatibility`
+    - TCS-COMPILER-STAGE3-GENERIC-ACTION-LOADER-0001
+    - GIR/1
+  - **language**：TCS/0.1  `header.language`
+  - **lifecycle**：VERIFIED  `header.lifecycle`
+  - **English name**：TCS Generic Action Graph Loader Module Manifest  `header.name_en`
+  - **Chinese name**：TCS通用动作图装载器模块清单  `header.name_zh`
+  - **profile**：TCS-MODULE-ABI/0.1  `header.profile`
+  - **protocols**  `header.protocols`
+    - TCS-MODULE-ABI-0001
+    - TCS-GENERIC-ACTION-GRAPH-LOADER-0001
+  - **schema**：tcs.protocol/v1  `header.schema`
+  - **version**：0.1.0  `header.version`
+- **human-readable projection**  `human_projection`
+  - **canonical**：no  `human_projection.canonical`
+  - **en_us**：module.manifest.human.en-US.md  `human_projection.en_us`
+  - **zh_cn**：module.manifest.hldp  `human_projection.zh_cn`
+- **lifecycle**  `lifecycle`
+  - **active**：no  `lifecycle.active`
+  - **capability_registry**：UNSIGNED_CANDIDATE  `lifecycle.capability_registry`
+  - **current**：VERIFIED  `lifecycle.current`
+  - **installed**：no  `lifecycle.installed`
+  - **mounted**：no  `lifecycle.mounted`
+  - **runtime_dispatch**：MISSING  `lifecycle.runtime_dispatch`
+  - **signature**：ABSENT  `lifecycle.signature`
+- **manifest**  `manifest`
+  - **capabilities**  `manifest.capabilities`
+    - TCS.EXECUTE_ACTION_GRAPH
+    - TCS.GENERIC_ACTION_GRAPH_EXECUTION
+    - TCS.CAPABILITY_RESOLUTION
+    - TCS.TARGET_READBACK_RECEIPT
+    - TCS.BOUNDED_ROLLBACK
+  - **compiler_id**：TCS-COMPILER-STAGE3-GENERIC-ACTION-LOADER-0001  `manifest.compiler_id`
+  - **compiler_sha256**：cd4889b941976bae3ce8c22f081d6da9bb880b4466ef271f1516c6d3d241b5ee  `manifest.compiler_sha256`
+  - **display_name_zh**：TCS通用动作图装载器模块  `manifest.display_name_zh`
+  - **entry_program_id**：TCS-PROGRAM-GENERIC-ACTION-GRAPH-LOADER-SELF-TEST-0001  `manifest.entry_program_id`
+  - **gir_sha256**：1000971f4121ccab9c396f68a4bcf9ff0cb5f116d4dbfdf051f8607dd22abd33  `manifest.gir_sha256`
+  - **module_id**：TCS-MOD-GENERIC-ACTION-GRAPH-LOADER-0001  `manifest.module_id`
+  - **protocols**  `manifest.protocols`
+    - TCS-MODULE-ABI-0001
+    - TCS-GENERIC-ACTION-GRAPH-LOADER-0001
+    - TCS-HOST-ABI-0001
+  - **version**：0.1.0  `manifest.version`
+- **network_scope**  `network_scope`
+  - **allowed**：no  `network_scope.allowed`
+  - **domains**  `network_scope.domains`
+    - none
+- **resource_ceiling**  `resource_ceiling`
+  - **concurrency**：1  `resource_ceiling.concurrency`
+  - **memory limit in bytes**：268435456  `resource_ceiling.memory_limit_bytes`
+  - **timeout in milliseconds**：30000  `resource_ceiling.timeout_ms`
+- **rollback**  `rollback`
+  - **value**：REMOVE_ONLY_PARTIAL_SELF_TEST_RECEIPTS_AND_PRESERVE_SOURCE_GIR_AND_FAILURE_EVIDENCE  `rollback.value`
+- **source**  `source`
+  - **source identifier**：TCS-MOD-GENERIC-ACTION-GRAPH-LOADER-0001  `source.source_id`
+  - **source role**：REGISTERED_MODULE  `source.source_role`
+  - **source checksum**：424d0b79ca40859c6a62e29f5a434ea0a6417f3ca582322e9c66ad9831ffd5c0  `source.source_sha256`
+  - **source address**：packages/TCS-MOD-GENERIC-ACTION-GRAPH-LOADER-0001/module.tcs  `source.source_uri`
+
+---
+
+This page changes only the reading order; it does not change TCS/HLDP semantics.