Skip to content

docs: update CLI naming to capiscio (consolidation)#17

Merged
beonde merged 6 commits intomainfrom
fix/rfc002-doc-alignment
Feb 3, 2026
Merged

docs: update CLI naming to capiscio (consolidation)#17
beonde merged 6 commits intomainfrom
fix/rfc002-doc-alignment

Conversation

@beonde
Copy link
Member

@beonde beonde commented Feb 3, 2026

Updates CLI naming references from capiscio-cli to capiscio for consistency across documentation.

Part of the CLI naming consolidation effort.

- Fix CLI docs: badge keep CA mode shown as implemented (not future)
- Add --agent-id flag documentation to badge keep
- Update trust level descriptions to RFC-002 §5 names
- Fix request.state.agent_claims → request.state.agent in middleware examples
- Add API Route Architecture section documenting dual-path pattern
- Update SDK badge reference with IAL documentation
- Fix badge lifetime: badges are 5-minute TTL, not 1 year
- Add IAL (Identity Assurance Level) FAQ explaining IAL-0 vs IAL-1
- Add FAQ explaining why badges are short-lived
- Fix badge structure example to match RFC-002 §4.3 claims
- Correct Trust Level 1 description: 'Registered' not 'Email verification'
- Update SSL comparison to highlight lifetime difference
- Fix badge lifecycle diagram for short-lived token model
- Add warning about Level 0 in production

BREAKING MISCONCEPTION FIX: The previous docs implied badges last
1 year like SSL certificates. Badges are intentionally short-lived
(5 min default) for security. This is a critical conceptual fix.
…ls 0-4 mapping across all docs (SS, REG, DV, OV, EV)
@github-actions
Copy link

github-actions bot commented Feb 3, 2026

✅ Documentation Build Successful

The documentation build completed successfully and passed validation checks.

  • ✅ Build completed without errors
  • ✅ Critical files present (index.html, sitemap.xml, robots.txt)
  • ✅ Link validation completed

This PR will deploy to dev-docs.capisc.io when merged to main.

@beonde beonde merged commit 6f03ead into main Feb 3, 2026
4 checks passed
@beonde beonde deleted the fix/rfc002-doc-alignment branch February 3, 2026 21:38
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