Repository navigation
docs: redraw the demo with the approval answered in lox run (#77) - #79
Merged
Merged
Conversation
The demo's terminals now show a capture of the scenario run through the code (scripts/brand/demo-capture/): curl through the gate with lea's sources.json, the frames lox run draws for the gate's ticket, and the gate's audit records. The request carries an email only: a GitHub token in the body is now refused by the gate itself (E_SECRET_EGRESS), without a question. The README caption saying the demo predates the hub is gone. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
The capture is output of the code, but of two test runs joined by hand, not of one lea + lox run stack: demo.py and docs/install.md now say so, and scripts/brand/demo-capture/README.md gives the source commits, how each file was produced, the join, and what demo.py types. The gate's run is a test skipped by default (TestDemoCapture, LOCKHTTP_DEMO_OUT); the lox run one belongs in lockhub and is kept as text. The capture is taken again with those two. The audit box no longer says one line per decision: the gate keeps two records for a denied request. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #77
What changed
site/assets/demo.svgis redrawn: the agent (Claude Code in a lea container, left) sends a GET to a trusted host and a POST to an unknown host; the question is answered inlox run(right), and the gate's audit shows both decisions.scripts/brand/demo.pyno longer contains the terminals' output. It reads it from a capture committed inscripts/brand/demo-capture/and converts the SGR colours oflox run's frames to SVG.README.md: the caption "Drawn in the console's frame from before the hub…" is removed; the alt text lists each step.site/index.htmluses the same file: alt text, figcaption andheight(600 → 680) are updated.securityadded (gh repo edit --add-topic security); topics are nowai-agents,harness-security,mcp,security.The scenario changed, because the product did
The old demo sent a token in the body and had the human answer
n token in body. Neither is today's behaviour:LockHTTP refused this request (E_SECRET_EGRESS): a GitHub token sent to hooks.example.net, outside its own hosts(captured while preparing this). The new body carries an email only ({"build":"ok","author":"jean.dupont@example.org"}), which the gate asks about and masks asj***(23).lox runtakesy/nwith no typed reason. The hub's signed decision has an empty reason, and the gate answersdenied on the hub.Where each screen comes from
Nothing was run against published images, and not one lea +
lox runstack either: the capture is output of the code of both repositories (lockhttp 2f0d37f, lockhub 4d94ef1, both on lockkit v0.20.0), taken in two separate test runs joined by hand.scripts/brand/demo-capture/README.mdgives the commits, how each file was made, the join, and whatdemo.pytypes. The gate's run is committed as a test skipped by default (TestDemoCapture,LOCKHTTP_DEMO_OUT); thelox runone belongs in lockhub and is kept there as text (loxrun_demo_test.go.txt). The committed capture was taken with exactly those two.200;LockHTTP refused this request (E_DENIED): denied on the hub/Do not retry…/request id: …)curl(HTTPS_PROXYset as lea sets it) through the gate ofinternal/gate(the tests'newEnvHub, MITM on), with asources.jsonnaming containerlea-ab12cd34efand agentdev-3, policytrusted = ["pkg.go.dev"],hold = "60s". Captured indemo-capture/gate.txt.lox runframes (idle, question, question afterd, aftern)internal/loxrun, run by its own e2e harness (newWorld: the real hub, a real lockkit hub client,lox rundriven by key presses, 80×26). The ticket is the one the gate signed in the run above (same header, body lines, warning, flags, risk, built withticket.NewTicketandrender.MaskScreenasinternal/gate/hub.godoes). Captured with their colours indemo-capture/lox-run-*.ans.denied on the hubninlox rungives a hub decision with"reason": ""(read back from the hub in the lockhub run); the gate was then given that same decision (denied, empty reason, facadetty), andhubApproveturns it intodenied on the hub.demo-capture/gate.txt), fields left out where the line shows….demo.py(not output)curlcommands, Claude Code's frame around a command (● Bash(…),└,Running…), the pane titles, theFREE/ASK/403badges, the two "you press…" hints (lox rundoes not echo keys) and the three captions.Limits to know about:
lox runran in two processes joined by hand, not under onelox run+ lea stack: the hub in the gate's run is the test suite's fake hub, and the ticket was signed again by the lockhub harness's lock key for the second run. The request id is the same on both sides; the clocks are those of two runs, a few seconds apart.why asked: this lock's ticket does not name its kind (version 1): askedand the feed'sfrom container lea…summary are whatlox runshows for a lockhttp ticket today. They are shown as they are.200is the gate's answer for a stand-in upstream, not pkg.go.dev itself.Verified
python3 scripts/brand/demo.py > site/assets/demo.svgreproduces the committed file.sh scripts/hygiene.sh:hygiene: clean.site/index.htmlat 360 and 1280 px.Screenshots
Before (main): https://github.com/DavidGodefroid/lockhttp/blob/2f0d37f/site/assets/demo.svg
After, at 2.5 s, 5.5 s, 9 s and 12 s of the loop:
On the site (1280 px, first moment of the loop): https://raw.githubusercontent.com/DavidGodefroid/lockhttp/pr-assets/79/site77-1280.png · 360 px: https://raw.githubusercontent.com/DavidGodefroid/lockhttp/pr-assets/79/site77-360.png
🤖 Generated with Claude Code