Skip to content

docs: update README for typed Auth dispatch#34

Merged
packet-mover merged 1 commit intomainfrom
docs/update-readme-auth
Apr 19, 2026
Merged

docs: update README for typed Auth dispatch#34
packet-mover merged 1 commit intomainfrom
docs/update-readme-auth

Conversation

@packet-mover
Copy link
Copy Markdown
Contributor

Summary

README still described the pre-v0.3.0 API with Config{Org, Token}. Rewrote the stale sections to match the current Auth interface.

What changed

  • Intro / "How it works": framing now covers user accounts as well as organizations (PATAuth falls back /orgs → /users on 404; InstallationAuth uses /installation/repositories which is account-type-agnostic).
  • "Scanner configuration" section: full rewrite describing both PATAuth and InstallationAuth with Go examples and field tables.
  • Required token permissions: broken out into classic PAT, fine-grained PAT, and installation-token rows.
  • CLI section: clarifies CODATUS_ORG accepts a user login too, and names PATAuth as the type the CLI wraps its env vars into.

Still accurate (not touched)

  • The 11 rule descriptions
  • Report format reference
  • "What Codatus is not" section

🤖 Generated with Claude Code

README still described the pre-v0.3.0 API with Config{Org, Token}. The
scanner now takes a sealed Auth interface implemented by PATAuth and
InstallationAuth. Rewrites:

- Intro + "How it works": framing now covers user accounts as well as
  organizations (PATAuth falls back from /orgs to /users on 404;
  InstallationAuth uses /installation/repositories which is
  account-type-agnostic).
- "Scanner configuration": full rewrite describing both PATAuth and
  InstallationAuth with examples, field tables, and field semantics.
- Token permissions: now broken out into classic PAT, fine-grained
  PAT, and installation-token rows with the relevant
  scopes/permissions for each.
- CLI: clarifies CODATUS_ORG accepts a user login too, and names
  PATAuth as the wrapping type the CLI uses internally.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@packet-mover packet-mover merged commit cf6e2d1 into main Apr 19, 2026
2 checks passed
@packet-mover packet-mover deleted the docs/update-readme-auth branch April 19, 2026 19:56
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