This repository was archived by the owner on May 26, 2026. It is now read-only.
KR-P2-CLASS-C-DOC: document Class C wire-format-stable identifier convention#99
Merged
Merged
Conversation
…er convention Extends the module docstring of `gateway/platforms/api_server.py` with an in-place explanation of the K-DG identity-literal taxonomy Class C convention. Class C identifiers (preserved permanently): - X-Hermes-Session-Id request header - X-Hermes-Session-Key request header - hermes-agent user-agent / platform string Renaming any of these breaks external HTTP consumers that have integrated against them (OpenAI-compat frontends + monitoring tools that index on the platform string). Documents the "default to Kora-prefixed for new identifiers" guidance — Class C is a small closed set; every addition is a permanent contract. Cross-references the full taxonomy doc at `kora_docs/00_canonical_current_state/identity_literal_taxonomy.md` (parallel PR in rafe-walker/kora-docs). Cites CC#3 commit 64eaaae where the 3-class taxonomy was first articulated. No code changes — docstring-only. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
1 participant
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
Closes the open documentation thread from KR-P2-B/B2 — the K-DG
taxonomy decided in CC#3's KR-P2-B2 STOP-ASK (commit `64eaaae`)
never got formal documentation. This is the in-code half.
Extends `gateway/platforms/api_server.py` module docstring with:
`X-Hermes-Session-Key`, `hermes-agent` (with file:line refs)
external compatibility genuinely requires Hermes-prefixed
Companion PR
Parallel PR in rafe-walker/kora-docs adds
`kora_docs/00_canonical_current_state/identity_literal_taxonomy.md` —
the full taxonomy reference + cross-class examples + lineage
(KR-P2-B → B2 → this doc → pending B3).
Test plan
🤖 Generated with Claude Code