Repository navigation
docs: make the docs and site say what the code does (#73) - #76
Merged
Merged
Conversation
Fix the FALSE, MISLEADING and OUTDATED items of the fact-check in README.md, docs/, SECURITY.md, CONTRIBUTING.md and site/, each re-verified against origin/main (and lea origin/main where they meet): - security model: DNS resolved before the decision with --hub-net (T2 residual), Claude allowlist vs user rules and shadow mode, Cookie scanned, decryption covers CONNECT :443 only, internal_hosts lift the floor, CA key on the host under lea, WebSocket frames scanned for injected secrets, warnings in the audit; - approvals are hub tickets; the console only reviews loosenings; lox run's service and volume names, the standalone launcher's kept; - policy: managed deny/ask steps, step 8 with no policy, ClientHello check for non-internal hosts, inject paths, upload class, hub step 19; - decisions D7, D8, D-optin, D-ih, D6, fail-closed fallback, auto checks split between parse time and per request; - usage, configuration, docker, install, lea: flags, defaults, audit decisions, versions table to v0.12.0, cosign behaviour, CA paths, trust store, audit volume, proxy IP, manual checks; - site: version v0.12.x, comparison rows, audit, inject example with internal_hosts, E_UNCONFINED and E_METHOD, signer out of the proxy namespace. pages.yml now pins its actions by full commit SHA, as SECURITY.md says. Closes #73 Co-Authored-By: Claude Opus 5.5 <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.
Summary
This PR fixes the documentation items of the fact-check in #73: the README,
docs/,SECURITY.md,CONTRIBUTING.mdandsite/. It changes no code. I re-verified each item againstorigin/mainat a3761ad, and against leaorigin/mainwhere the two integrate.--hub-net. This is now listed as a T2 residual; the code fix is gate: DNS lookup of the target happens before the decision (--hub-net), leaking labels of denied requests #74.Cookieheaders are scanned.CONNECTto port 443 only.internal_hostslifts the floor for its own ports and single-label names.mcp_serverswarnings taken from a request body.pages.ymlnow pins its actions by full commit SHA, asSECURITY.mdalready said.lox run's service and volume names, and keep the standalone launcher's names for the standalone case. D7, hub step 19, and theSECURITY.mdscope are rewritten for the hub.docs.anthropic.com, andcontainer.pathsis set.uploadclass no longer mentions bodies of unknown length.autochecks are split into parse-time and per-request checks.E_NO_CONSOLE, FREE continues.--hub-netand positional arguments, and the managed-dir mount is documented.decisionvalues are listed.updateis described exactly, includingLOCKHTTP_SKIP_COSIGNand pre-releases.SECURITY.md.~/.local/share/lea/..., lea runsca inititself, and the trust store is/etc/pki/ca-trust/....$LEA_PROXY_IP, a root-owned/usr/local/bin/lockhttpis trusted without checks, and the deck plays no sound.lea doctor's checks from the manual ones.E_METHODandE_UNCONFINEDare listed.internal_hostsentry.ca initis shown with--dir.site/installno longer mentions lockhttp's own "signed install script".brew trustexists: the tap's CI runs it.Closes #73
Test plan
scripts/hygiene.shpasses.go test ./cmd/lockhttp/ -run 'Release|Launcher|Workflow|Pin|Doc'passes.🤖 Generated with Claude Code