diff --git a/README.md b/README.md index d92603d..b062706 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,22 @@ Start with [Project direction](docs/PROJECT-DIRECTION.md). Security decisions li - Git and a local filesystem - Linux, macOS, or WSL2; native Windows is not yet validated +## Reproducible source consumption + +Until a registry prerelease is published, consumers may pin the package to an +exact repository commit. The `prepare` script builds the public `dist/` +exports during Git dependency installation, so a clean consumer does not +depend on an unpublished registry tarball or a maintainer's local cache. + +Use an immutable commit SHA rather than a moving branch: + +```sh +npm install "github:AyobamiH/agentproof#" +``` + +This is a source-consumption path, not evidence that an npm package has been +published. + ## CLI quickstart This complete development-only example uses a disposable Git repository. It requires only this README and the packed tarball. All state, keys, and evidence stay under the temporary directory. diff --git a/docs/CURRENT-STATUS.md b/docs/CURRENT-STATUS.md index 3fd52ce..2e45424 100644 --- a/docs/CURRENT-STATUS.md +++ b/docs/CURRENT-STATUS.md @@ -6,7 +6,10 @@ - **RC2:** Receipt V2 repaired the trust boundary, but independent validation was incomplete and compensation returned the transaction ID where correlation was required. - **RC3:** correlation semantics and validation passed, but public-package preflight failed because licensing and prerelease packaging were not ready. - **RC4:** Apache-2.0, public metadata, executable packaging, 46/46 AgentProof tests, 395/395 Operator tests, deterministic packing, and Developers A–D passed. Its publication request was unconsumed and superseded before publication by standalone productisation. -- **RC5:** standalone repository migration and package-consumer extraction are in local validation. Nothing is published. +- **RC5:** standalone source is published at + `github.com/AyobamiH/agentproof`. The npm prerelease and GitHub Release remain + unpublished. Clean Git consumers can pin an exact repository commit; the + package builds its public exports during that source installation. ## Supported capability @@ -18,4 +21,7 @@ The package is ESM-only and requires Node.js 22.5+, Git, and a local filesystem. ## Active gate -The required terminal state is `awaiting_hash_bound_repository_creation_and_publication_approval`: one approval bound to the standalone commit, Operator adapter commit, frozen RC5 tarball, public repository creation, source push, GitHub prerelease, and npm `next` publication. +Source publication is complete. Registry publication and a GitHub Release +remain separate release actions and are not implied by repository availability. +The current integration gate is a reproducible clean consumer pinned to an +exact source commit; npm `next` publication remains separately approval-bound. diff --git a/package.json b/package.json index 6437cee..76bc1a7 100644 --- a/package.json +++ b/package.json @@ -8,6 +8,7 @@ "scripts": { "build": "tsc", "postbuild": "chmod 755 dist/cli.js dist/dev-authority-cli.js", + "prepare": "npm run build", "typecheck": "tsc --noEmit", "test": "npm run build && node --test dist/test/*.test.js", "demo": "npm run build && node dist/demo.js",