Skip to content

Commit 4cf2fca

Browse files
imran-siddiqueimran-siddique
committed
Improve visitor paths, architecture boundaries, and runnable tutorials
1 parent 9697f58 commit 4cf2fca

9 files changed

Lines changed: 328 additions & 103 deletions

File tree

‎.github/workflows/reader-journey.yml‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
name: Reader journey
2+
on:
3+
pull_request:
4+
push:
5+
branches: [main]
6+
permissions:
7+
contents: read
8+
jobs:
9+
links:
10+
runs-on: ubuntu-latest
11+
steps:
12+
- uses: actions/checkout@v4
13+
with:
14+
persist-credentials: false
15+
- uses: actions/setup-python@v5
16+
with:
17+
python-version: '3.12'
18+
- run: python tools/check-site.py
19+
quickstart:
20+
runs-on: ubuntu-latest
21+
timeout-minutes: 8
22+
steps:
23+
- uses: actions/checkout@v4
24+
with:
25+
persist-credentials: false
26+
- uses: actions/setup-python@v5
27+
with:
28+
python-version: '3.12'
29+
- run: python tools/check-quickstart.py

‎demos/index.html‎

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@
3232
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
3333
<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
3434

35-
<link rel="stylesheet" href="/design-system.css?v=10">
35+
<link rel="stylesheet" href="/design-system.css?v=15">
3636
</head>
3737
<body class="at-page">
3838

@@ -48,7 +48,7 @@
4848

4949
<div class="hero"><div class="wrap">
5050
<span class="eyebrow">Runnable demos</span>
51-
<h1>Don't take the spec<br>on trust. <em>Run it.</em></h1>
51+
<h1>Run a policy check.<br><em>Inspect the result.</em></h1>
5252
<p class="sub">Ten demos, about thirteen minutes end to end. Four cover custody of model weights. Five govern what an agent does at the tool boundary. One governs model calls through an OpenAI-compatible endpoint.</p>
5353
<div><span class="status">Software mode · <code>CMCP_DEV_MODE=1</code> · no special hardware</span></div>
5454
</div></div>
@@ -57,18 +57,20 @@ <h1>Don't take the spec<br>on trust. <em>Run it.</em></h1>
5757

5858
<section id="start">
5959
<span class="label">Quick start</span>
60-
<h2>Clone it and run all ten</h2>
61-
<p>No confidential-computing hardware, no cloud account, no signup. Everything runs in software mode.</p>
60+
<h2>Start with one demo</h2>
61+
<p>Use Python 3.11+, Git, and Bash on macOS, Linux, or Windows with WSL for the commands below. No cloud account is needed. These demos use software attestation and do not demonstrate hardware isolation.</p>
6262
<div class="code">
6363
<div class="code-head"><span class="code-label">Terminal</span><button class="copy">COPY</button></div>
6464
<pre>git clone https://github.com/agentrust-io/demos &amp;&amp; cd demos
65-
pip install -r requirements.txt
66-
python demo.py <span class="c"># all ten, pausing before each</span>
67-
python demo.py --no-pause <span class="c"># straight through, no prompts</span>
68-
python demo.py 6 <span class="c"># just demo 6</span></pre>
65+
python3 -m venv .venv
66+
source .venv/bin/activate
67+
python -m pip install -r requirements.txt
68+
python demo.py 1 <span class="c"># start with tool-call policy enforcement</span></pre>
6969
</div>
7070
<p>The requirements install cMCP for demos 1 to 5, Weight Custody Manifest for demos 6 to 9, and the OpenAI client for demo 10. <code>demo.py</code> sets dev mode and the bearer token for you, so there is nothing to export. Source: <a href="https://github.com/agentrust-io/demos">github.com/agentrust-io/demos</a>.</p>
7171

72+
<p><strong>What to look for:</strong> demo 1 routes calls through the local gateway and closes the session into a signed record. Software mode does not pass hardware-attestation verification. To explore weight custody, run <code>python demo.py 6</code>; to run the full set without pauses, use <code>python demo.py --no-pause</code>.</p>
73+
<p><strong>Individual commands below:</strong> run them from the <code>demos</code> folder with the environment activated. For demos that start cMCP, set <code>export CMCP_BEARER_TOKEN=demo-token</code> first. The <code>demo.py</code> launcher handles this setup for you.</p>
7274
<p class="meta" style="margin-top:2.25rem;">What demo 6 actually prints, verbatim from a run on <code>weight-custody-manifest 0.25.0</code></p>
7375
<div class="term">
7476
<div class="term-bar"><span class="dot"></span><span class="dot"></span><span class="dot"></span><span class="term-title">python demo-06-weight-custody/run.py</span></div>

‎design-system.css‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1949,3 +1949,43 @@ html:has(body.agentrust-hub) { scroll-behavior: smooth; }
19491949
.marketplace-page [hidden] { display:none!important; }.sr-only { position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0; }
19501950
@media(max-width:860px){.marketplace-callout,.market-section-heading{align-items:flex-start;flex-direction:column}.market-hero-grid,.market-layout,.submit-grid{grid-template-columns:1fr}.market-signal{max-width:440px}.featured-strip,.market-grid{grid-template-columns:1fr}.market-filters{position:static;display:grid;grid-template-columns:1fr 1fr;gap:1rem}.neutrality-note{grid-column:1/-1;margin-top:0}.market-search-row{grid-template-columns:1fr}.market-sort{padding-left:0}.market-card{min-height:315px}}
19511951
@media(max-width:560px){.market-hero h1 br{display:none}.market-filters{grid-template-columns:1fr}.neutrality-note{grid-column:auto}.market-search kbd{display:none}}
1952+
/* Reader entry points and architecture share the site's existing palette. */
1953+
.skip-link { position: fixed; top: -5rem; left: 1rem; z-index: 20000; padding: .75rem 1rem; background: var(--at-ink); color: var(--at-paper); }
1954+
.skip-link:focus { top: .5rem; }
1955+
.agentrust-hub .hero { padding-block: clamp(2rem, 4vw, 3.5rem); }
1956+
.agentrust-hub .hero h1 { font-size: clamp(2.6rem, 5.5vw, 4.8rem); line-height: 1.03; max-width: 1000px; margin-block: 1rem; }
1957+
.agentrust-hub .hero > .hero-inner > p:not(.hero-eyebrow) { max-width: 760px; font-family: var(--at-sans); font-size: clamp(1rem, 1.6vw, 1.2rem); line-height: 1.6; }
1958+
.agentrust-hub .hero > .hero-inner > p.hero-scope { font-size: .85rem; margin-top: 1rem; }
1959+
.agentrust-hub .hero .hero-eyebrow { max-width: none; font-size: .78rem; }
1960+
.agentrust-hub .reader-start { padding-block: 2rem 3rem; }
1961+
.agentrust-hub .reader-start h2 { font-size: 2rem; margin-bottom: 1.5rem; }
1962+
.agentrust-hub .ecosystem-card a { display: inline-block; margin-top: 1rem; color: var(--at-ink); font-weight: 650; text-underline-offset: .2em; }
1963+
.architecture { margin: 2rem 0; color: var(--at-ink); }
1964+
.architecture-input { display: flex; align-items: center; gap: 1.5rem; padding: 1.25rem; border: 1px solid var(--at-line); background: var(--at-paper-2); }
1965+
.architecture-input > a { flex-shrink: 0; }
1966+
.architecture a { color: var(--at-ink); text-underline-offset: .2em; }
1967+
.architecture-row { display: grid; grid-template-columns: 1fr auto 1.3fr auto 1fr; gap: .8rem; align-items: stretch; margin-block: 1.25rem; }
1968+
.architecture-node { display: flex; flex-direction: column; justify-content: center; gap: .65rem; padding: 1.25rem; border: 1px solid var(--at-line); background: var(--at-white); min-width: 0; }
1969+
.architecture-boundary { border: 2px dashed var(--at-navy); }
1970+
.architecture-edge { align-self: center; font-size: .8rem; font-weight: 650; white-space: nowrap; }
1971+
.architecture-outcomes { display: grid; grid-template-columns: repeat(3, 1fr); border: 1px solid var(--at-line); background: var(--at-white); }
1972+
.architecture-outcomes > div { padding: 1.25rem; }
1973+
.architecture-outcomes > div + div { border-left: 1px solid var(--at-line); }
1974+
.architecture span, .architecture p, .architecture small, .architecture figcaption { font-size: .9rem; line-height: 1.6; }
1975+
.architecture p { margin-bottom: 0; }
1976+
.architecture figcaption { margin-top: 1rem; color: var(--at-muted); }
1977+
.tutorial-toc { display: flex; flex-wrap: wrap; gap: .75rem 1.25rem; margin: 1.5rem 0; }
1978+
.tutorial-toc a { color: var(--at-ink); padding-block: .4rem; }
1979+
.troubleshooting dt { font-weight: 700; margin-top: 1.25rem; }
1980+
.troubleshooting dd { margin: .5rem 0 0; }
1981+
.at-page .step-body, .at-page .split > *, .at-page .code { min-width: 0; }
1982+
.at-page .code-label { overflow-wrap: anywhere; }
1983+
.at-page .copy { flex-shrink: 0; }
1984+
@media (max-width: 700px) {
1985+
.architecture-input { flex-direction: column; align-items: start; gap: .5rem; }
1986+
.architecture-row, .architecture-outcomes { grid-template-columns: 1fr; }
1987+
.architecture-edge { justify-self: center; margin-block: .25rem; }
1988+
.architecture-outcomes > div + div { border-left: 0; border-top: 1px solid var(--at-line); }
1989+
.agentrust-hub .hero-actions { gap: .75rem; }
1990+
.agentrust-hub .hero-actions .btn { text-align: center; white-space: normal; }
1991+
}

0 commit comments

Comments
 (0)