Skip to content

docs: pin loopback in the README config and scope the tpm row to 0.3.0 - #475

Merged
imran-siddique merged 2 commits into
mainfrom
docs/pin-loopback-and-tpm-status
Aug 5, 2026
Merged

docs: pin loopback in the README config and scope the tpm row to 0.3.0#475
imran-siddique merged 2 commits into
mainfrom
docs/pin-loopback-and-tpm-status

Conversation

@imran-siddique

Copy link
Copy Markdown
Contributor

Both halves are the same defect in different files: the tree is correct, the release a reader installs is not, and the docs describe the tree. Surfaced by HN traffic landing on the repo, where the README is the only thing a visitor reads.

listen_addr

The Quick Start config omitted listen_addr, and the Configuration reference documented "0.0.0.0:8443" outright.

0.3.0 (current PyPI) main
listen_addr default 0.0.0.0:8443, unconditional loopback when dev mode and no token
tokenless non-loopback guard absent ConfigError

CMCP_DEV_MODE=1 skips the bearer token requirement on purpose. So following the README on 0.3.0 stands up an unauthenticated policy gateway on every interface. Verified by unpacking the published cmcp_runtime-0.3.0-py3-none-any.whl: config.py has listen_addr: str = "0.0.0.0:8443" and no _is_loopback_host at all.

Pinning 127.0.0.1:8443 explicitly is correct on both versions, so this needs no release to take effect. The quickstart page was fixed for exactly this; the README was not.

tpm row in STATUS.md

The row credited report-signature verification as hardware-validated. verify_tpm_quote_chained was validated on 2026-07-31, but it had no production caller: the tpm2 branch of verify_trace_claim called only verify_tpm_measurement, which takes no signature parameter, so a forged TPMS_ATTEST with correct magic and matching qualifying_data was reported as hardware-attested. That is #370, fixed in #469, shipping in 0.4.0.

The row now leads with "Not in 0.3.0", separates the validated function from the shipped code path, and points TPM evaluators at main. The #431 chain caveat is unchanged and still applies after the fix.

Also

Links agentrust-io.com/quickstart from Quick Start. The repo is the landing page for anyone who never reaches the docs site.

Docs only, no code changes. Independent of #470, so it can merge without waiting on the agt-core pin.

🤖 Generated with Claude Code

imran-siddique and others added 2 commits August 4, 2026 13:25
Both halves are the same defect: the tree is correct and the release a
reader installs is not, and the docs describe the tree.

  listen_addr  The Quick Start config omitted listen_addr and the
               Configuration reference documented "0.0.0.0:8443". On the
               published 0.3.0 the default is unconditionally
               0.0.0.0:8443 and there is no loopback guard, while
               CMCP_DEV_MODE=1 skips the bearer token on purpose. So
               following the README on 0.3.0 stands up an
               unauthenticated policy gateway on every interface. main
               already defaults to loopback in tokenless dev mode and
               raises ConfigError on a non-loopback bind, so pinning
               127.0.0.1 explicitly is correct on both. The quickstart
               page was fixed for this; the README was not.

  tpm row      STATUS.md credited report-signature verification as
               hardware-validated. verify_tpm_quote_chained was
               validated on 2026-07-31, but it had no production caller:
               the tpm2 branch of verify_trace_claim called only
               verify_tpm_measurement, which takes no signature
               parameter, so a forged TPMS_ATTEST with correct magic and
               matching qualifying_data was reported as
               hardware-attested (#370, fixed in #469, ships in 0.4.0).
               The row now says so and points TPM evaluators at main.
               The #431 chain caveat is unchanged and still applies
               after the fix.

Also links agentrust-io.com/quickstart from Quick Start. The repo is the
landing page for readers who never reach the docs site.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@imran-siddique
imran-siddique merged commit b36b9bd into main Aug 5, 2026
11 checks passed
@imran-siddique
imran-siddique deleted the docs/pin-loopback-and-tpm-status branch August 5, 2026 04:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant