Skip to content

Add .sourceos/manifest.json: declare agentplane as SourceOS agent-execution component#303

Merged
mdheller merged 2 commits into
mainfrom
feat/sourceos-manifest
Jun 16, 2026
Merged

Add .sourceos/manifest.json: declare agentplane as SourceOS agent-execution component#303
mdheller merged 2 commits into
mainfrom
feat/sourceos-manifest

Conversation

@mdheller

Copy link
Copy Markdown
Member

Summary

  • Adds .sourceos/manifest.json to register agentplane as a first-class SourceOS component
  • Domain: agent-execution — the execution control plane bridging bundle intent to SourceOS image production surfaces (Tekton, Katello)
  • policyClass: critical — agentplane owns stop-gate evaluation and live Tekton mutation surfaces
  • ownedSchemas: Bundle, GovernanceContext, ValidationArtifact, PlacementDecision, RunArtifact, ReplayArtifact, StopGateArtifact, SourceOSContextToolProviderEvidence, SourceOSContextCuminRun
  • dangerousSurfaces: sourceos.delegated.live_tekton_mutation (--execute-live path), bundle.stop_gate.override

Integration path context

The agentplane ↔ sourceos-syncd integration path is:

  1. agentplane bundle defines intent: ISO build target, Katello content ref, Tekton pipeline, policy lane
  2. Tekton executes: builds ISO, publishes to Katello file repo, emits bootReleaseSetRef + releaseSetRef
  3. run_sourceos_delegated.py records katelloContentViewRef, katelloLifecycleEnvironmentRef, bootReleaseSetRef in RunArtifact/ReplayArtifact — the evidence boundary
  4. Operator promotes content view qa → stable in Katello (manual today; Phase 2 target for automation)
  5. sourceos-syncd polls Katello stable, detects version bump, runs nix copy with minisign verification, emits SyncCycleReceipt
  6. sourceos-boot health-check timer validates boot chain; rolls back if check fails

Test plan

  • python3 scripts/validate_bundle.py bundles/sourceos-image-production-smoke/bundle.json still passes
  • CI passes (no schema validation touches .sourceos/)

…ecution component

Registers agentplane in the SourceOS component registry with:
- domain: agent-execution
- ownedSchemas: Bundle, GovernanceContext, ValidationArtifact, PlacementDecision,
  RunArtifact, ReplayArtifact, StopGateArtifact, SourceOSContextToolProviderEvidence,
  SourceOSContextCuminRun
- policyClass: critical (stop-gate logic + live Tekton mutation surface)
- dangerousSurfaces: live_tekton_mutation, stop_gate.override
@mdheller mdheller force-pushed the feat/sourceos-manifest branch from 458e3c3 to 1efee96 Compare June 16, 2026 17:20
@mdheller mdheller merged commit 6562837 into main Jun 16, 2026
9 checks passed
@mdheller mdheller deleted the feat/sourceos-manifest branch June 16, 2026 17:22
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