Development record
The 'abcd version --check' flag help calls it 'the only command that touches the network', but the same generated reference page also calls 'docs cite refresh' the only network verb and 'memory ingest <url>' does its own HTTP GET — three real fetch paths, contradicting adr-38's own two-verb model
The 'abcd version --check' flag help calls it 'the only command that touches the network', but the same generated reference page also calls 'docs cite refresh' the only network verb and 'memory ingest <url>' does its own HTTP GET — three real fetch paths, contradicting adr-38's own two-verb model
Evidence
internal/surface/cli/version.go— the--checkflag help reads "fetch the latest release once and compare (the only command that touches the network); names its source".internal/surface/cli/cite.go— thedocs cite refreshhelp calls it "the only abcd verb that reaches the network on behalf of documentation" (fetcher:internal/core/cite/fetch.go).internal/core/memory/ingest.go—defaultFetchperforms anhttp.MethodGet(UAabcd-memory-ingest) formemory ingest <url>;internal/surface/cli/cli.gowires theingest <path-or-url>verb with a nil fetcher soacquireSourcetakes the fetch branch..abcd/development/decisions/adrs/0038-implicit-checks-are-disk-only.mdnames two tier-2 fetch verbs (version --check,docs cite refresh); memory ingest is an unlisted third.
Adversarial review
CONFIRMED (substantive, low end) by an independent refuter: three real fetch call sites; the
"only" claim is categorical and self-contradicted on the same generated page. Fix: rescope the
version.go help string (e.g. "this command's only network touch; abcd never fetches
implicitly — adr-38") and go generate ./internal/surface/cli.
Frontmatter
| id | iss-294 |
|---|---|
| type | issue |
| lifecycle | resolved |
| severity | minor |
.abcd/work/issues/resolved/iss-294-the-abcd-version-check-flag-help-calls.md
open on GitHub ↗ · commit history ↗
mentions3
- adr-38Implicit checks are disk-only — the network answers only an explicit ask
- dcn-26081900000000032026-08-19 — bughunt round 1 (branch bughunt-b/round-1): captured iss-291..iss-304 and fixed
- iss-385commands/version.md's network enumeration is still false after two rewrites — it names version --check and update as the only fetch verbs while docs cite refresh and memory ingest <url> also reach the network