docs: Add server registration module documentation #2
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
BREAKING CHANGE: Trust level naming corrected to match RFC-002 v1.4. Before (incorrect): - Level 1: DV (Domain Validated) - Level 2: OV (Organization Validated) - Level 3: EV (Extended Validation) - Level 4: CV (Continuous Validation) ← doesn't exist in RFC After (correct per RFC-002 v1.4): - Level 1: REG (Registered) - Level 2: DV (Domain Validated) - Level 3: OV (Organization Validated) - Level 4: EV (Extended Validated) Integer values (0-4) unchanged - this is a naming/documentation fix only. The actual verification logic was already correct. Files updated: - capiscio_mcp/types.py: TrustLevel enum docstring and comments - README.md: Trust level table - docs/index.md: Trust level table - docs/getting-started/quickstart.md: Trust level table - docs/guides/server-side.md: Code comment (CV → EV) Refs: RFC-002 v1.4 §5 Trust Levels
- Add registration module to API reference - Create server-registration.md guide - Update index.md with registration feature - Update README.md with Quickstart 3 and Registration API - Update mkdocs.yml with registration guide in nav - Add registration exports to __init__.py docstring - Add server.py early-return for DECLARED_PRINCIPAL state
The capiscio CLI uses --version, not 'version' subcommand
The _caller_badge is a ContextVar, not a function, so patch() with return_value does not work. The mock RPC response already provides all needed data, so these patches were unnecessary.
The test_calls_download_binary test was failing because the CI environment has CAPISCIO_BINARY_PATH set, which causes ensure_binary to return early without calling download_binary. The fix clears the environment dictionary to ensure the download path is taken.
|
✅ Integration tests passed! capiscio-core gRPC tests working. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Adds comprehensive documentation for the server registration module (
registration.py), which enables MCP servers to establish verifiable identities through the CapiscIO registry.Changes
API Reference (
docs/api-reference.md)generate_server_keypair,register_server_identity,setup_server_identityNew Guide (
docs/guides/server-registration.md)setup_server_identity()Updated Index (
docs/index.md)README Updates
Package Updates (
capiscio_mcp/__init__.py)Server Enhancement (
capiscio_mcp/server.py)DECLARED_PRINCIPALstate to support badge-less DID disclosure scenarios (RFC-007 §4.2)Test Suite (
tests/test_registration.py)RFC Alignment
Testing
All 270 tests pass:
Related
capiscio-docsintegration PR (pending)