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

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

FixtureResult
…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.jsonREJECTED — restricted class (min: attested TEE rank 2) run on-device (rank 0). Fail-closed.
…missing-attestation.invalid.jsonREJECTED — chosen tier requires attestation, decision has no attestationRef.
…non-monotonic-tiers.invalid.jsonREJECTED — tier lattice not strictly monotonic by rank.
…unknown-class.invalid.jsonREJECTED — 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.
@mdhellermdheller self-assigned this Aug 3, 2026
@mdheller
mdheller merged commit dcbabb4 into mainAug 3, 2026
1 check passed
@mdheller
mdheller deleted the feat/confidential-compute-escalation branch August 3, 2026 10:14
Sign up for freeto 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

@mdheller