Skip to content

book: document facts #673 removed from .claude/design - #693

Merged
vyskocilm merged 2 commits into
mainfrom
docs/683-book-facts
Oct 23, 2026
Merged

vyskocilm merged 2 commits into
mainfrom
docs/683-book-facts

Conversation

@vyskocilm

Copy link
Copy Markdown
Contributor

Closes #683.

Book prose for facts #673 dropped from .claude/design, vetted by hand.

  • claude.md: settings.json filter (host + target files, allowlist, strict JSON 1 MiB, -v/--dry-run report, managed settings not visible). login: BROWSER is /snug/lib/snug/browser, profile BROWSER conflicts, open limit.
  • containers.md: docker cp refused (engine view wider than container, topology diagram linked); podman shim replaced by snug's podman calling docker; docker build section (DOCKER_BUILDKIT=0, open question DOCKER_BUILDKIT=1 inside sandbox: measure what unfiltered BuildKit session actually reaches #690); image signatures.
  • environment.md: prepend across profiles, name grammar, ← not granted / ← writable from inside.
  • network.md: door starts through snug's wrapper, no shell, no network.
  • variables.md: new chapter. Variable table + rules moved out of filesystem.md; {colon}, colon in specs and lists.
  • filesystem.md: file section (profile: place literal text as a read-only file in the sandbox #653 prose), links to variables.md.
  • README.md: CGO_ENABLED=0.

Tests: TestBookClaudeSettingsListsTheAllowlist, TestBookNamesTheWrapperPaths, TestBookLoginOpenLimitIsTheBridges new; TestBookListsExactlyThePathVariablesResolveBuilds and the :/{ refusal check read variables.md.

Stacked on feat/colon-var (dc1c6d3, {colon} path variable + two red-team fixes), included here: variables.md documents {colon} and the variable-table test needs it. make gate green.

claude.md: settings.json filter (host and target files, allowlist,
strict JSON 1 MiB, -v/--dry-run report, managed settings not visible);
login: BROWSER is /snug/lib/snug/browser, conflict with a profile
BROWSER, open limit.

containers.md: docker cp refused (engine view wider than the
container, topology diagram linked), podman shim replaced by snug's
podman calling docker, `docker build` section (DOCKER_BUILDKIT=0, see
issue 690), image signatures.

environment.md: prepend across profiles, name grammar, the two marks.
network.md: door starts through snug's wrapper, no shell or network.

variables.md: new chapter. Variable table and rules moved out of
filesystem.md; {colon} and the colon in path specs and lists.
filesystem.md: `file` section, links to variables.md.
README: CGO_ENABLED=0.

TestBook* hold the allowlist, wrapper paths, login open limit, the
variable table and the spec tables at their new pages.

Refs #683
@vyskocilm
vyskocilm merged commit 515c4fa into main Oct 23, 2026
5 checks passed
@vyskocilm
vyskocilm deleted the docs/683-book-facts branch October 23, 2026 06:45
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.

book: document facts #673 removed from .claude/design

1 participant