Files
agentrhq__authsome/docs
Priyansh Khodiyar cdf3de8456 fix(docs): align README, plugin, and docs with source-of-truth
The earlier audit surfaced contradictions between docs and code that
were verified against agentrhq/authsome main at 3929b86. This fixes
the verified gaps; the rest is tracked for follow-up PRs.

Provider count: source has 45 JSONs (14 OAuth2 + 31 API key) in
src/authsome/auth/bundled_providers/. Notion ships as two entries
(notion + notion_dcr) and Klaviyo as two (klaviyo + klaviyo-oauth).

- README.md: 44 -> 45 and 13 OAuth -> 14 OAuth.
- .claude-plugin/marketplace.json: same correction in the plugin
  description.

Master key path: paths.py routes the server master key to
~/.authsome/server/master.key, confirmed by vault/crypto.py and
health.py. Three doc pages had the wrong (top-level) path.

- security/threat-model.mdx: data-at-rest table and offline-disk
  paragraph.
- security/encryption.mdx: local_key backend description.
- troubleshooting/doctor.mdx: both accordion FAIL examples and the
  chmod remediation. Also points users at "authsome init" instead of
  the side-effect-on-first-run workaround.
- concepts/credential-storage.mdx: local_key backend description.
- concepts/architecture.mdx: vault wrapping description.

Architecture layer status: src/authsome/ ships identity/ (Ed25519
keys, did:key DIDs, PoP JWT), audit/ (structured JSON events), in
addition to vault/ and auth/. Only policy/ is still planned.

- concepts/architecture.mdx: replace the "alpha focuses on Vault and
  Auth" Note with a per-layer status table reflecting reality. Also
  updates the SQLite backend description to the kv_store path
  (~/.authsome/server/kv_store/) consistent with the canonical
  filesystem layout.

Hosted daemon cross-reference: changelog 0.2.4 ships
AUTHSOME_DAEMON_URL and AUTHSOME_SERVER_BASE_URL, but the threat
model classifies hosted daemons as "Caveat (VPN only)" for private
and "No" for public. Cross-reference added to the changelog entry so
adopters see the constraint at the point of the feature
announcement.

Domain: README links updated from authsome.agentr.dev to
authsome.ai for consistency with the docs canonical URL fixed in
#271.

Out of scope (separate follow-ups):
- Profile-as-folder trees in credential-storage.mdx and
  profiles-vs-connections.mdx still show profiles/<name>/store.db,
  which conflicts with the new server/kv_store/ architecture. Needs
  a dedicated rewrite of those pages.
- mitmproxy CA install procedure (10 pages mention it; none have an
  install command).
- Anthropic bundling.
- Marketing site sitemap on authsome-web.
2026-05-15 19:23:13 +05:30
..