Skip to content

docs(cli): explain when read-only commands contact a host (stack 3/4) - #250

Open
benvinegar wants to merge 1 commit into
feat/cli-canonical-hintsfrom
docs/cli-read-only-vs-offline
Open

benvinegar wants to merge 1 commit into
feat/cli-canonical-hintsfrom
docs/cli-read-only-vs-offline

Conversation

@benvinegar

@benvinegar benvinegar commented Nov 9, 2026 •

Copy link
Copy Markdown
Member

Problem

“Read-only” can sound like “local and offline,” but some listings contact a host or refresh caches. An empty grant list can also mean the host was unreachable—not that the VM has no access.

Change

Explain where each query gets its information and when it contacts a host. In particular, access ls reads this controller's records, checks host inventory when none exist, and falls back to no local records if that check fails.

Help also explains cached guest information, SSH cache updates and visible --cmd text. Documentation only; command behavior and output stay unchanged.

Tests

Lint, typecheck and shell tests passed; unit tests: 489 passed, 1 skipped. Help/documentation checks passed.

Stack 3/4: #246 → #249 → #250 → #251. Based on #249's branch; merge that first.

@benvinegar benvinegar changed the title docs(cli): distinguish read-only queries from offline operations (stack 3/4) docs(cli): explain when read-only commands contact a host (stack 3/4) Nov 9, 2026
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