Skip to content

docs: align credential + network claims with code (findings 3–5) - #39

Open
BuckG71 wants to merge 1 commit into
mainfrom
docs-credential-alignment
Open

BuckG71 wants to merge 1 commit into
mainfrom
docs-credential-alignment

Conversation

@BuckG71

@BuckG71 BuckG71 commented Jul 25, 2026

Copy link
Copy Markdown
Owner

Doc-only alignment from the network-egress design pass (known_issues.md findings 3–5). Bias per direction: change docs to match code.

Changes

  • README credential claims (finding 3). The absolute "No credential of any kind ever enters the sandbox — not your model key, not your service tokens" is inaccurate: under native, a profile that declares secrets:/platforms: (e.g. the default hermes preset's discord platform) injects the real service token into the sandbox — mediation brokers only the model key (D-191). Reworded the intro, the "What you get" bullet, and the Credential-privacy section to the accurate claim: model credential always out; service tokens out with onecli/hybrid.
  • threat_model §4.2 (finding 4). Was framed as "credential mediation … current integration is OneCLI." The native bar-C broker is the default, zero-dependency path; OneCLI is opt-in. Reworded + fixed the native+secrets caveat.
  • threat_model §4.3 (finding 5). Was "v0.1.0 ships a boolean only … unrestricted egress." Five network modes ship; mediated/onecli/hybrid restrict egress to the proxy peer today. Arbitrary per-destination allowlist remains the v1.0 item (points at network_egress_design.md).

Notes for review

🤖 Generated with Claude Code

https://claude.ai/code/session_01PRQ6JeWxpD9zrYcPz6VFTS

…ngs 3–5)

- README: soften the absolute "no credential of any kind ever enters" to the
  accurate claim — the MODEL credential never enters (always, via the broker);
  service tokens are kept out with onecli/hybrid, but a profile's `secrets:`/
  `platforms:` block injects service tokens under `native`. Fixes the intro,
  the "What you get" bullet, and the Credential-privacy section (D-191).
- threat_model §4.2: lead with the native broker as the default credential-
  mediation path; OneCLI is the opt-in extension (was framed as "the current
  integration"). Note the native+secrets service-token caveat.
- threat_model §4.3: replace the stale "boolean only / unrestricted egress"
  with the five shipped network modes; arbitrary per-destination allowlist is
  the v1.0 item (points to network_egress_design.md).

Doc-only. The profiles-table `build`="native" row is intentionally left pending
the D-196 posture decision.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PRQ6JeWxpD9zrYcPz6VFTS
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