Skip to content

Describe the principal as a credential-scoped identity - #151

Open
germ-mark wants to merge 1 commit into
mainfrom
llm/book-principal-per-half-keys
Open

germ-mark wants to merge 1 commit into
mainfrom
llm/book-principal-per-half-keys

Conversation

@germ-mark

Copy link
Copy Markdown
Contributor

The book described the principal as "a credential-scoped signing identity" and the invitation as holding "the signing identity". That reads as one principal-wide signing key, which is only one conforming choice.

This PR clarifies the spec. The principal is a credential-scoped identity that mints key packages and invitations. Each key-package half carries its own signing key, and that's the key its owner signs with in the group the half joins (Group Rules rule 4). One key per principal, as the deployed engine uses, and a fresh key per half both conform. The invitation holds the credential plus the key package's private material, including its signing keys.

Updated in Concepts (the principal, the invitation and the naming table), the Introduction, and the invitation line in Session Lifecycle. This is a clarification, not a shipped anomaly. The API reference is left as is, since it describes the crate's API.

Book-only, with an empty changeset. mdbook build passes.

🤖 Generated with Claude Code

A key package half carries its own signing key, which is the key used in
the group that half joins; one key per principal and a fresh key per half
both conform.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@changeset-bot

changeset-bot Bot commented Sep 24, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7788074

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

This branch has not been deployed

No deployments
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