0001: passmcp-graph makes no network request, and --offline enforces it¶
Status: Accepted
Context¶
passmcp-graph reads MCP client configurations, where people keep credentials, and evidence about servers nobody has vetted. A tool that holds both and can open a connection is a way for either to leave the machine. Operators also run it in CI, where egress is often restricted.
Decision¶
No command makes a network request. Only internal/netguard may import
net or net/http; --offline replaces the process's default HTTP
transport with one that refuses every request, so a library that reached
for the network would fail rather than succeed.
Consequences¶
- The graph holds only what the operator gives it. Discovering servers, or reading an identity provider or a SaaS inventory, is out of scope until a connector is designed; a connector is a decision for the maintainer, recorded in a new ADR, not a drive-by import.
TestNoCommandContactsTheNetworkrecords the default transport and a proxy listener while every command runs, and requires zero requests;TestOnlyTheOfflineGuardImportsTheNetworkfails on any other package that imports the network.