Skip to content

docs: fix the #220 fact-check items (README, docs, lox help) - #223

Merged
DavidGodefroid merged 2 commits into
mainfrom
docs/fact-check-220
Nov 14, 2026
Merged

DavidGodefroid merged 2 commits into
mainfrom
docs/fact-check-220

Conversation

@DavidGodefroid

@DavidGodefroid DavidGodefroid commented Nov 14, 2026 •

Copy link
Copy Markdown
Owner

Fixes the lockhub-repo items of the docs fact-check #220. Each item was re-verified against origin/main before the change; only docs and help texts change (plus the lox init end line and its goldens), no behaviour.

Security

  • docs/lox-run.md threat model, intro, docs/approvals.md, README safety model, docs/mobile.md: a host agent running as the user can approve tickets, except require_device classes. Hardening proposal: security hardening: ticket approval should require a human-only factor #221.
  • Reveals: only a lock with reveal: true pins the facade keys.
  • Quitting lox run leaves the stack up; other facades still answer (README, approvals.md, lox help).
  • locksql write/DDL "asked every time" is the default; a profile auto rule may allow it.

FALSE / broken

  • Old hub without GET /v1/hub: served, lox doctor warns.
  • lox run --rotate … --dry-run: dropped (lox run has no --dry-run); dry run = deprecated lox up --dry-run.
  • lox run "or a parent": workspace root only (or --file).
  • Masking: LIMIT/OFFSET bounds are masked too.
  • lox help: all six lock types.

Other

  • lox help: init question, add rollback, --image/--hub-image verified at next lox run, audit verify --lock/--anchors, withdraw of an unverifiable ticket, lox CMD -h.
  • lox-run.md: console backlog (log driver none), workspace symlink, lockssh Vault egress (vault: true), files table readers, MinRelease and --allowed-uids lists, extension-points paragraph removed, lox run --rotate, lox down quote, agent-neutral wording.
  • lox-add.md: doctor --fix version floors, --review on first run, found: hints, loopback IPs, lockssh Vault questions, --only/--allow/--exec, lox vault set IP gap (lox vault set does not refuse an IP address for the Vault address #222).
  • lox-init.md / lox init: asks for declared locks, lea runs no lox command (lea#300), end line keep lox run open, --file legacy fallback.
  • mobile.md: 20 wrong codes cancel every pairing; lox run after revoke.
  • design-notes.md: no hard-coded lockkit versions.
  • getting-started.md, README: only Claude Code's MCP files are written; lockssh listed.

Items in lockfamily docs/lox.md remain for the lockfamily repo, hence Refs, not Closes.

Refs #220

🤖 Generated with Claude Code

DavidGodefroid and others added 2 commits November 14, 2026 23:01
README, docs and lox help texts now say what origin/main does: a
same-uid host agent can approve tickets through the facade socket
(lockhub#221), quitting lox run leaves the stack serving other facades,
lox run has no --dry-run and no parent lookup, lox add lists all six
types and what a failure rolls back, --image/--hub-image skip cosign
until lox run, audit verify flags, withdraw of an unverifiable ticket,
lox init's end line and legacy file fallback, stale versions removed,
agent-neutral wording. lox vault set's missing IP check: lockhub#222.

Refs #220

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Refs #220

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@DavidGodefroid
DavidGodefroid merged commit 4d94ef1 into main Nov 14, 2026
20 checks passed
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