Skip to content

feat: tiered confidential-compute escalation contract (#22) - #24

Merged
mdheller merged 1 commit into
mainfrom
feat/confidential-compute-escalation
Aug 3, 2026
Merged

feat: tiered confidential-compute escalation contract (#22)#24
mdheller merged 1 commit into
mainfrom
feat/confidential-compute-escalation

Conversation

@mdheller

@mdheller mdheller commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

What

Closes the §5.2 gap from the SourceOS-vs-Apple ModelCarry analysis: a tiered confidential-compute escalation. Model execution escalates to a higher confidential-compute tier (on_devicesealed_enclaveattested_tee) based on the data-residency / sensitivity class of the inputs, and the escalation decision is governed and receipted — the SourceOS analogue of Apple's on-device → Private Cloud Compute boundary.

Consume-not-fork; matches the existing manifest/boundary house style (schema + stdlib validator + valid/invalid fixtures + make target). Builds on ModelCarryManifest (#20, MERGED).

  • contracts/confidential-compute-escalation.schema.json — ordered compute-tier lattice, sensitivity/dataResidencyClass → minimum-tier map (residency vocab aligned with the estate InferenceReceipt), and a receipted decision (chosen tier + reason + attestationRef + SHA-256 receipt).
  • tools/validate_confidential_compute_escalations.py — structural validator, wired into make validate.
  • docs/confidential-compute-escalation.md — contract, invariants, teeth.

SHA-256 is the authoritative receipt-hash algorithm (FIPS 180-4). Fail-closed is the core invariant.

Teeth

Fixture Result
…attested-tee.json (valid) VERIFIES — restricted-class request run at the attested TEE tier, at/above its required minimum, with an attestation ref.
…below-minimum-tier.invalid.json REJECTED — restricted class (min: attested TEE rank 2) run on-device (rank 0). Fail-closed.
…missing-attestation.invalid.json REJECTED — chosen tier requires attestation, decision has no attestationRef.
…non-monotonic-tiers.invalid.json REJECTED — tier lattice not strictly monotonic by rank.
…unknown-class.invalid.json REJECTED — request class not declared in sensitivityClassMap (never defaulted to weakest).

Verified locally: make validate and make release-dry-run both green.

Boundary / follow-up (@mdheller)

Structural contract only — no live TEE attestation, no compute provisioning, no runtime authorization. Follow-ups:

Refs #22, #20.

Adds ConfidentialComputeEscalation (SourceOS-vs-Apple ModelCarry spec
section 5.2): model execution escalates to a higher confidential-compute
tier (on_device -> sealed_enclave -> attested_tee) based on the
data-residency / sensitivity class of the inputs, and the escalation
decision is governed and receipted.

- contracts/confidential-compute-escalation.schema.json: ordered compute
  tier lattice, sensitivity/residency class -> minimum-tier map, and a
  receipted decision record (chosen tier + reason + attestationRef +
  SHA-256 receipt). SHA-256 is the authoritative receipt hash (FIPS 180-4).
- tools/validate_confidential_compute_escalations.py: structural validator
  with teeth, wired into make validate.

Teeth (fail-closed is the core invariant):
- a request satisfied by its chosen tier VERIFIES;
- a request run BELOW its required minimum tier is REJECTED;
- a chosen tier requiring attestation with no attestationRef is REJECTED;
- a non-monotonic tier lattice is REJECTED;
- an undeclared sensitivity class is REJECTED (never defaulted).

Follow-up (@mdheller): live TEE attestation verification; governed staged
pre-load + atomic swap (#21).

Refs #22, #20.
@mdheller mdheller self-assigned this Aug 3, 2026
@mdheller
mdheller merged commit dcbabb4 into main Aug 3, 2026
1 check passed
@mdheller
mdheller deleted the feat/confidential-compute-escalation branch August 3, 2026 10:14
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