Skip to content

Durable Key Lifecycle

The host-local boundary that keeps one enrolled agent or pinned admin signing identity available across foreground invocations without giving the CLI raw private keys. S2 alone interprets the typed key bundle; this context owns the protected file, its durability and verified reload.

Language

Protected Key File: An owner-only local file containing one versioned S2-encoded agent or admin identity bundle, never a plaintext user vault or token. Avoid: token file, vault file, credentials file Subsystems: Durable Key Lifecycle Files: crates/ksp-key-lifecycle/src/file.rs Relates to: Agent Keys (persists), Trust Anchor (is checked against) History: - 2026-10-23 (001-keyspout-mvp): Term introduced for Misfit R.

Verified Key Reload: An operation that returns typed S2 authority only after the expected identity, role, key IDs and derived public keys agree with pinned trust state and the Protected Key File passes owner-only checks. Avoid: automatic enrollment, key regeneration, bearer access Subsystems: Durable Key Lifecycle, Identity Sealed Delivery and Policy Verification Files: crates/ksp-key-lifecycle/src/lib.rs, crates/ksp-identity/src/key_bundle.rs Relates to: Protected Key File (reads), Enrolment Fingerprint (checks) History: - 2026-10-23 (001-keyspout-mvp): Term introduced for Misfit R.

Durable Key Replacement: An atomic, synced replacement of a Protected Key File that either preserves the previous complete identity or publishes a complete new identity, never a partially accepted one. Avoid: overwrite in place, silent rotation, key reset Subsystems: Durable Key Lifecycle Files: crates/ksp-key-lifecycle/src/file.rs Relates to: Protected Key File (replaces), Rotation (does not revoke old artifacts) History: - 2026-10-23 (001-keyspout-mvp): Term introduced for Misfit R.

Relationships

  • Verified Key Reload reads a Protected Key File and returns only a verified typed identity.
  • Durable Key Replacement replaces a Protected Key File without exposing a partial identity.
  • Agent Keys remain independent signing and recipient pairs owned by S2's types.

Flagged Ambiguities

  • A Protected Key File holds host-local private identity material; a Delivery Artifact is a recipient-sealed transferable token. They are never interchangeable.