pgc-runtime 2.0.1__tar.gz → 4.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. {pgc_runtime-2.0.1/pgc_runtime.egg-info → pgc_runtime-4.0.0}/PKG-INFO +16 -6
  2. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/README.md +15 -5
  3. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0/pgc_runtime.egg-info}/PKG-INFO +16 -6
  4. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/pyproject.toml +1 -1
  5. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/boot.py +1 -24
  6. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/loader.py +1 -1
  7. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/LICENSE +0 -0
  8. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/MANIFEST.in +0 -0
  9. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/NOTICE +0 -0
  10. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/pgc_runtime.egg-info/SOURCES.txt +0 -0
  11. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/pgc_runtime.egg-info/dependency_links.txt +0 -0
  12. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/pgc_runtime.egg-info/entry_points.txt +0 -0
  13. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/pgc_runtime.egg-info/requires.txt +0 -0
  14. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/pgc_runtime.egg-info/top_level.txt +0 -0
  15. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/__init__.py +0 -0
  16. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/api.py +0 -0
  17. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/cli.py +0 -0
  18. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/conformance.py +0 -0
  19. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/ct_errors.py +0 -0
  20. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/ct_execute.py +0 -0
  21. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/ct_executor.py +0 -0
  22. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/dispatcher.py +0 -0
  23. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/evidence.py +0 -0
  24. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/examine/__init__.py +0 -0
  25. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/examine/classifier.py +0 -0
  26. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/examine/cli.py +0 -0
  27. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/examine/hint_engine.py +0 -0
  28. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/examine/locator.py +0 -0
  29. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/examine/parser.py +0 -0
  30. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/examine/reporter.py +0 -0
  31. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/memory.py +0 -0
  32. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/scheduler.py +0 -0
  33. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/runtime/trace_viz.py +0 -0
  34. {pgc_runtime-2.0.1 → pgc_runtime-4.0.0}/setup.cfg +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: pgc-runtime
3
- Version: 2.0.1
3
+ Version: 4.0.0
4
4
  Summary: PGC protocol runtime — executes a sealed snapshot as governed DAG traversal and emits traces (import package: runtime)
5
5
  Author-email: Bhash Ganti <bachipeachy@gmail.com>
6
6
  License-Expression: Apache-2.0
@@ -151,7 +151,7 @@ Apache-2.0. See `LICENSE` and `NOTICE`.
151
151
  | `pgc-workloads` | `conformance_workloads` | the workloads that make conformance observable |
152
152
  | `pgc-domains` | `business_domains` | the business domain implementations the composed snapshot binds |
153
153
 
154
- `pip install pgc` brings in the whole family.
154
+ `pip install protocol-governed-computing` brings in the whole family.
155
155
 
156
156
  **Installing the toolchain is one of two steps.** The compiler resolves the governance surface from
157
157
  `PGC_PLATFORM_ROOT` — fail-hard, cwd-independent, zero inference — so the *declarations* come from a
@@ -164,8 +164,18 @@ export PGC_PLATFORM_ROOT=$PWD/software_governance
164
164
  pgc # reports what is installed and whether the anchor resolves
165
165
  ```
166
166
 
167
- `PGC_BUILD_ROOT` (compiled output, keeping the governance repo read-only) and `PGC_DOMAIN_ROOTS`
168
- (additional domains contributing their own `registry/structures`) are optional.
167
+ `PGC_DOMAIN_ROOTS` names an additional domain contributing its own `registry/structures` — the
168
+ directory that *directly contains* it, not the repository above it; pointing one level too high is a
169
+ silent no-op. `PGC_SNAPSHOT_ROOT` is where compiled output is written, and each domain build needs
170
+ its own: every layer's output consolidates into one root, and verification rejects any file in that
171
+ root the current build did not declare. `PGC_SNAPSHOT_PROFILES` is the directory holding snapshot
172
+ profiles, required by the assembler and the runtime alike.
173
+
174
+ `PGC_BUILD_ROOT` is accepted and reported and **nothing reads it** — `PGC_SNAPSHOT_ROOT` is the
175
+ anchor that controls output.
176
+
177
+ The full sequence, with the repositories it needs, is in
178
+ [`pgc_install`](https://github.com/protocol-governed-computing/pgc_install).
169
179
 
170
180
  **Versioning.** Two schemes, and the published version follows the second.
171
181
 
@@ -173,9 +183,9 @@ pgc # reports what is installed and whether the anchor resolves
173
183
  composition rather than each repo: they release together and the governance closure forces lockstep,
174
184
  so the ordinal names which composition a repo belongs to. Development happens on `dev/<N>` and each
175
185
  cycle is tagged `release-<N>`. This is not published.
176
- - **Public** — `PUBLIC_VERSION`, tagged on every component repository. The platform is at **`v2`**.
186
+ - **Public** — `PUBLIC_VERSION`, tagged on every component repository. The platform is at **`v3`**.
177
187
 
178
- **The published version is the public one: `v2` is `2.0.0`.** The standard the packages implement is a
188
+ **The published version is the public one: `v4` is `4.0.0`.** The standard the packages implement is a
179
189
  separate artifact on its own track and is not this number.
180
190
 
181
191
  The standard these packages implement is published separately: https://doi.org/10.5281/zenodo.22150616
@@ -125,7 +125,7 @@ Apache-2.0. See `LICENSE` and `NOTICE`.
125
125
  | `pgc-workloads` | `conformance_workloads` | the workloads that make conformance observable |
126
126
  | `pgc-domains` | `business_domains` | the business domain implementations the composed snapshot binds |
127
127
 
128
- `pip install pgc` brings in the whole family.
128
+ `pip install protocol-governed-computing` brings in the whole family.
129
129
 
130
130
  **Installing the toolchain is one of two steps.** The compiler resolves the governance surface from
131
131
  `PGC_PLATFORM_ROOT` — fail-hard, cwd-independent, zero inference — so the *declarations* come from a
@@ -138,8 +138,18 @@ export PGC_PLATFORM_ROOT=$PWD/software_governance
138
138
  pgc # reports what is installed and whether the anchor resolves
139
139
  ```
140
140
 
141
- `PGC_BUILD_ROOT` (compiled output, keeping the governance repo read-only) and `PGC_DOMAIN_ROOTS`
142
- (additional domains contributing their own `registry/structures`) are optional.
141
+ `PGC_DOMAIN_ROOTS` names an additional domain contributing its own `registry/structures` — the
142
+ directory that *directly contains* it, not the repository above it; pointing one level too high is a
143
+ silent no-op. `PGC_SNAPSHOT_ROOT` is where compiled output is written, and each domain build needs
144
+ its own: every layer's output consolidates into one root, and verification rejects any file in that
145
+ root the current build did not declare. `PGC_SNAPSHOT_PROFILES` is the directory holding snapshot
146
+ profiles, required by the assembler and the runtime alike.
147
+
148
+ `PGC_BUILD_ROOT` is accepted and reported and **nothing reads it** — `PGC_SNAPSHOT_ROOT` is the
149
+ anchor that controls output.
150
+
151
+ The full sequence, with the repositories it needs, is in
152
+ [`pgc_install`](https://github.com/protocol-governed-computing/pgc_install).
143
153
 
144
154
  **Versioning.** Two schemes, and the published version follows the second.
145
155
 
@@ -147,9 +157,9 @@ pgc # reports what is installed and whether the anchor resolves
147
157
  composition rather than each repo: they release together and the governance closure forces lockstep,
148
158
  so the ordinal names which composition a repo belongs to. Development happens on `dev/<N>` and each
149
159
  cycle is tagged `release-<N>`. This is not published.
150
- - **Public** — `PUBLIC_VERSION`, tagged on every component repository. The platform is at **`v2`**.
160
+ - **Public** — `PUBLIC_VERSION`, tagged on every component repository. The platform is at **`v3`**.
151
161
 
152
- **The published version is the public one: `v2` is `2.0.0`.** The standard the packages implement is a
162
+ **The published version is the public one: `v4` is `4.0.0`.** The standard the packages implement is a
153
163
  separate artifact on its own track and is not this number.
154
164
 
155
165
  The standard these packages implement is published separately: https://doi.org/10.5281/zenodo.22150616
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: pgc-runtime
3
- Version: 2.0.1
3
+ Version: 4.0.0
4
4
  Summary: PGC protocol runtime — executes a sealed snapshot as governed DAG traversal and emits traces (import package: runtime)
5
5
  Author-email: Bhash Ganti <bachipeachy@gmail.com>
6
6
  License-Expression: Apache-2.0
@@ -151,7 +151,7 @@ Apache-2.0. See `LICENSE` and `NOTICE`.
151
151
  | `pgc-workloads` | `conformance_workloads` | the workloads that make conformance observable |
152
152
  | `pgc-domains` | `business_domains` | the business domain implementations the composed snapshot binds |
153
153
 
154
- `pip install pgc` brings in the whole family.
154
+ `pip install protocol-governed-computing` brings in the whole family.
155
155
 
156
156
  **Installing the toolchain is one of two steps.** The compiler resolves the governance surface from
157
157
  `PGC_PLATFORM_ROOT` — fail-hard, cwd-independent, zero inference — so the *declarations* come from a
@@ -164,8 +164,18 @@ export PGC_PLATFORM_ROOT=$PWD/software_governance
164
164
  pgc # reports what is installed and whether the anchor resolves
165
165
  ```
166
166
 
167
- `PGC_BUILD_ROOT` (compiled output, keeping the governance repo read-only) and `PGC_DOMAIN_ROOTS`
168
- (additional domains contributing their own `registry/structures`) are optional.
167
+ `PGC_DOMAIN_ROOTS` names an additional domain contributing its own `registry/structures` — the
168
+ directory that *directly contains* it, not the repository above it; pointing one level too high is a
169
+ silent no-op. `PGC_SNAPSHOT_ROOT` is where compiled output is written, and each domain build needs
170
+ its own: every layer's output consolidates into one root, and verification rejects any file in that
171
+ root the current build did not declare. `PGC_SNAPSHOT_PROFILES` is the directory holding snapshot
172
+ profiles, required by the assembler and the runtime alike.
173
+
174
+ `PGC_BUILD_ROOT` is accepted and reported and **nothing reads it** — `PGC_SNAPSHOT_ROOT` is the
175
+ anchor that controls output.
176
+
177
+ The full sequence, with the repositories it needs, is in
178
+ [`pgc_install`](https://github.com/protocol-governed-computing/pgc_install).
169
179
 
170
180
  **Versioning.** Two schemes, and the published version follows the second.
171
181
 
@@ -173,9 +183,9 @@ pgc # reports what is installed and whether the anchor resolves
173
183
  composition rather than each repo: they release together and the governance closure forces lockstep,
174
184
  so the ordinal names which composition a repo belongs to. Development happens on `dev/<N>` and each
175
185
  cycle is tagged `release-<N>`. This is not published.
176
- - **Public** — `PUBLIC_VERSION`, tagged on every component repository. The platform is at **`v2`**.
186
+ - **Public** — `PUBLIC_VERSION`, tagged on every component repository. The platform is at **`v3`**.
177
187
 
178
- **The published version is the public one: `v2` is `2.0.0`.** The standard the packages implement is a
188
+ **The published version is the public one: `v4` is `4.0.0`.** The standard the packages implement is a
179
189
  separate artifact on its own track and is not this number.
180
190
 
181
191
  The standard these packages implement is published separately: https://doi.org/10.5281/zenodo.22150616
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "pgc-runtime"
7
- version = "2.0.1"
7
+ version = "4.0.0"
8
8
  description = "PGC protocol runtime — executes a sealed snapshot as governed DAG traversal and emits traces (import package: runtime)"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -2,7 +2,7 @@
2
2
  boot.py — warm reboot: bring the assembled snapshot resident and hash-verified.
3
3
 
4
4
  The manifest is the ROOT OF TRUST. The runtime boots *through* it, never by scanning the
5
- filesystem. Contract: snapshot_assembler/doc/SNAPSHOT_ASSEMBLY_CONTRACT.md
5
+ filesystem. Contract: snapshot_assembler/CONTRACT.md
6
6
 
7
7
  Boot sequence:
8
8
  1. load manifest.json
@@ -75,29 +75,6 @@ def default_snapshot_root() -> Path:
75
75
 
76
76
  # --- composite hash: independent reimplementation of the assembly contract -----------------
77
77
 
78
- def _identity_view(domains: list[dict]) -> list[dict]:
79
- view = [
80
- {
81
- "domain": d["domain"],
82
- "tokenized_projection_hash": d["projections"]["tokenized"]["projection_hash"],
83
- "vocabulary_projection_hash": d["projections"]["vocabulary"]["projection_hash"],
84
- # Canonical joins the view because every other member is graph-derived, and STRUCTURE
85
- # artifacts never enter the semantic graph — without it a STRUCTURE artifact could
86
- # change inside a sealed snapshot and boot would still attest the same identity.
87
- "canonical_projection_hash": d["projections"]["canonical"]["projection_hash"],
88
- "attestation_hash": d["projections"]["trust"]["attestation_hash"],
89
- "graph_address_hash": d["graph_address_hash"],
90
- }
91
- for d in domains
92
- ]
93
- return sorted(view, key=lambda e: e["domain"])
94
-
95
-
96
- def _composite_hash(domains: list[dict]) -> str:
97
- canonical = json.dumps(_identity_view(domains), sort_keys=True, separators=(",", ":"))
98
- return hashlib.sha256(canonical.encode("utf-8")).hexdigest()
99
-
100
-
101
78
  def _load_manifest(snapshot_root: Path) -> dict:
102
79
  path = snapshot_root / "manifest.json"
103
80
  if not path.exists():
@@ -10,7 +10,7 @@ it (dispatcher, scheduler, memory, evidence) works only against the frozen
10
10
  RuntimePackage.
11
11
 
12
12
  Consumed from the assembled snapshot root (the assembler product; see
13
- snapshot_assembler/doc/SNAPSHOT_ASSEMBLY_CONTRACT.md):
13
+ snapshot_assembler/CONTRACT.md):
14
14
  tokenized/<domain>/dispatch.json — routing (per-WF), pipeline, entry, bindings
15
15
  tokenized/<domain>/handlers.json — ct, cs, rb_policy
16
16
  tokenized/<domain>/metadata.json — projection_hash for trust verification
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes