Skip to content

docs: show what the demos and the quickstart actually print - #25

Merged
imran-siddique merged 1 commit into
mainfrom
docs/show-real-output
Aug 21, 2026
Merged

docs: show what the demos and the quickstart actually print#25
imran-siddique merged 1 commit into
mainfrom
docs/show-real-output

Conversation

@imran-siddique

Copy link
Copy Markdown
Member

Both pages describe outcomes in prose and never show the output. For pages whose whole pitch is "don't take the spec on trust. Run it.", the output is the argument.

I ran them

  • The published quickstart, end to end, against cmcp-runtime 0.4.0: config validates, the runtime starts, the forbidden call returns 403 POLICY_DENY, the session closes into a signed claim, and cmcp verify reports FAIL (partially_verified) and exits 1.
  • Demo 6 against weight-custody-manifest 0.25.0: all four bullets on the card are accurate.

Nothing here corrects a claim about behaviour. Both pages were already right. What changes is that a reader can see it before installing anything.

Quickstart

  • Step 4 now shows the response body the runtime really returns, in place of a one-line prose summary of it.
  • That body carries a call_id, and the same id lands in the audit chain. That is the thread from the block in step 4 to the signed record in step 5, and the page never mentioned it. It is arguably the point of the whole exercise: a refusal nobody can check afterwards is just a log line.
  • Step 5 shows the CRYPTO-001 advisory the CLI prints before the checks table. It is not a failure, but it is the first thing on screen and the page did not prepare anyone for it.
  • Records which version the page was last verified against, and says that a step not behaving as written is a bug worth reporting.

Demos

Was Now
"These five govern the tool boundary" above six cards Six, of which five are the tool call and demo 10 is the model call
"about twelve minutes" Thirteen. The card times sum to 270s + 510s
export CMCP_BEARER_TOKEN=demo-token Dropped. demo.py sets it, as the repo README says
No mention of --no-pause Added. Without it the runner waits for a keypress before every demo
No output anywhere Demo 6's verbatim output

Noted, not fixed here

  • demos/demo.py says run only demo 2 (1 through 9) in its --help docstring. There are ten.
  • cmcp validate-config crashes on a Windows console ('charmap' codec can't encode '✓') unless PYTHONUTF8=1 is set. The page scopes itself to macOS and Linux, so this is a cmcp issue rather than a page issue.

🤖 Generated with Claude Code

https://claude.ai/code/session_013EQx4N5BzTQbY8kvXUsdkY

Both pages describe outcomes in prose and never show the output. For
pages whose whole pitch is "don't take the spec on trust, run it", the
output is the argument.

I ran the published quickstart end to end against cmcp-runtime 0.4.0 and
demo 6 against weight-custody-manifest 0.25.0. Both do exactly what the
pages say, so nothing here corrects a claim about behaviour. What
changes is that a reader can now see it before they install anything.

Quickstart:
- Step 4 shows the response body the runtime really returns, replacing a
  one-line prose summary of it.
- That body carries a call_id, and the same id lands in the audit chain,
  which is the thread from the block in step 4 to the signed record in
  step 5. The page never mentioned it, and it is the point.
- Step 5 shows the CRYPTO-001 advisory the CLI prints before the checks.
  It is not a failure, but it is the first thing on screen and the page
  did not prepare anyone for it.
- Says which version the page was last verified against, and that a step
  not behaving as written is a bug worth reporting.

Demos:
- The governance section said "these five govern the tool boundary" above
  six cards. Demo 10 is in that section and governs model calls, not the
  tool boundary.
- The card times sum to thirteen minutes, not twelve. Fixed in the hero
  and in the meta, OG and Twitter descriptions.
- Dropped export CMCP_BEARER_TOKEN from the quick start: demo.py sets it,
  as the repo README says. Added --no-pause, without which the runner
  waits for a keypress before every demo.
- Added demo 6's verbatim output.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013EQx4N5BzTQbY8kvXUsdkY
@imran-siddique
imran-siddique merged commit 5b0d462 into main Aug 21, 2026
1 check passed
@imran-siddique
imran-siddique deleted the docs/show-real-output branch August 21, 2026 03:45
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