Metadata-Version: 2.4
Name: protocol-governed-computing
Version: 2.0.0
Summary: Protocol-Governed Computing — installs the full toolchain and reports whether an environment is ready to compile, seal, and execute
Author-email: Bhash Ganti <bachipeachy@gmail.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://omnibachi.org/
Project-URL: Repository, https://github.com/protocol-governed-computing
Project-URL: Standard, https://doi.org/10.5281/zenodo.22150616
Keywords: protocol-governed-computing,pgc,governance,authorization,sdlc
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Compilers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: pgc-compiler==2.0.0
Requires-Dist: pgc-assembler==2.0.1
Requires-Dist: pgc-runtime==2.0.1
Requires-Dist: pgc-inspector==2.0.0
Requires-Dist: pgc-transformation==2.0.0
Requires-Dist: pgc-governance==2.0.0
Requires-Dist: pgc-workloads==2.0.0
Requires-Dist: pgc-domains==2.0.1
Provides-Extra: blockchain
Requires-Dist: pgc-domains[blockchain]==2.0.1; extra == "blockchain"

# pgc_install

**Protocol-Governed Computing — the whole toolchain in one install.**

This repository publishes the `pgc` distribution. It is the composition as *installable
software*, the counterpart to `pgc_release`, which is the same composition as *sealed
evidence* — assembled, immutable, and cited by DOI. The parallel is in role, not in citation:
a release is a thing a paper points at; an install is a thing that changes each version.

```bash
pip install pgc
```

That brings in the seven packages of the family, pinned to one composition.

## Two steps, not one

Installing the toolchain is half of a working environment. The compiler resolves the
governance surface from `PGC_PLATFORM_ROOT` — fail-hard, cwd-independent, zero
inference — so the **declarations come from a repository you point at, not from a
wheel**. A registry inside a package would be a second governance surface competing
with the repository's, and a build could then be governed by a stale copy.

```bash
git clone https://github.com/protocol-governed-computing/software_governance
export PGC_PLATFORM_ROOT=$PWD/software_governance
pgc            # reports what is installed and whether the anchor resolves
```

## The family

| Package | Role |
|---|---|
| `pgc-compiler` | declarations → compiled projections |
| `pgc-assembler` | projections → sealed snapshot |
| `pgc-runtime` | snapshot → governed execution |
| `pgc-inspector` | snapshot → read-only inspection |
| `pgc-transformation` | change request → protocol artifacts |
| `pgc-governance` | the governance surface and its capability implementations |
| `pgc-workloads` | the workloads that make conformance observable |
| `pgc-domains` | the business domain implementations the composed snapshot binds |

**Versioning.** Two schemes. Each repository's `VERSION` is a monotonic composition ordinal —
internal build accounting, tagged `release-<N>`, never published. `PUBLIC_VERSION` is the platform's
public identity, tagged on every component repository; the platform is at **`v2`**.

**The published version is the public one: `v2` is `2.0.0`.** The family releases in lockstep, so `pgc`
pins exact versions rather than ranges. The standard these packages implement is a separate artifact on
its own track and is not this number.

The standard these packages implement is published separately:
https://doi.org/10.5281/zenodo.22150616
