Skip to content

docs: fix the fact-check findings of #38 - #42

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

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

Conversation

@DavidGodefroid

Copy link
Copy Markdown
Owner

Fixes every finding of the docs fact-check #38 (5 FALSE, 4 OVERCLAIM, 6 OUTDATED, 20 MISLEADING) against origin/main at 52a4914 (v0.3.0). Docs only: README, docs/, SECURITY.md, CONTRIBUTING.md and site/.

Each item was re-checked in the code first. Notable checks:

  • 2.1: the old managed.toml sample fails NewManaged with lockssh.profiles.prod-web is beyond the managed bounds: … family.vault.required = vault (profile prod-web: credentials = none); the new sample loads (checked with a throwaway test, not committed).
  • 4.3: lockhub's CHANGELOG puts lockkit v0.20.0 (confined agents, --runtime-gids for lockssh v0.3.0) in lox v0.12.0, so the docs now say v0.12.0 or later for lockssh v0.3.0 (v0.11.0 stays the first with the lockssh lock type).
  • 2.3: the anchor is fixed by a ### Migrating from a host install heading, so scripts/install.sh is unchanged.
  • python3 scripts/check-site.py site: 6 pages checked, 0 errors; scripts/hygiene.sh passes.

Code bugs found by the review, filed separately and documented as they behave today:

The open point of #38 (a secret cut at max_output_bytes before masking) is not addressed here.

Closes #38

🤖 Generated with Claude Code

DavidGodefroid and others added 2 commits November 14, 2026 23:05
Make README, docs/, SECURITY.md, CONTRIBUTING.md and site/ say what
v0.3.0 does:

- security: auto.exec = "auto" decides exec tickets off production;
  confined agents only (unconfined = true exception, self-reported);
  PII allow rules leave values in clear; globs match options when they
  start with - or + or follow a literal --; only * and ? stop at /;
  the audit masks argv with a fixed set (#40) and skips dry runs; key
  file mode, password wiping; LOCKSSH_SKIP_COSIGN only without cosign;
  the first connect ticket is the human's under connect = "ask" only
- wrong examples: managed.toml sample now loads; image tag; broken
  #migrating-from-a-host-install anchor; no Linux packages; truncated
  output is dropped, not counted
- launcher and Docker guide: pii is not routed (#39); doctor runs
  without a socket; init's home mount; console started by lox run only
  (allowed_uids, networks in lockfamily.yaml); lox run's socket volume
- versions: badge v0.3; lox add pins the latest release; lockssh v0.3.0
  takes lox v0.12.0; decisions.md marks #4 to #11 shipped, lockkit
  v0.20.0, the full code-program table
- wording: protocol major, -32009, unmask risk, status, profile add
  synopsis, argv[0] with a /, secrets are not pseudonyms, max session
  default, SSH login vs session

Closes #38

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

Docs fact-check: wrong or misleading claims

1 participant