feat(agentic-os): canonical contract for the agentic operating system#191
Closed
mdheller wants to merge 2 commits into
Closed
feat(agentic-os): canonical contract for the agentic operating system#191mdheller wants to merge 2 commits into
mdheller wants to merge 2 commits into
Conversation
Adds the schema family for the agentic OS that coordinates agent pods against objectives across the estate (from the VA OIT Portfolio Operating System, generalized). System of record for the cockpit's Agentic OS console. Schemas (JSON Schema 2020-12, urn:srcos:* ids): - AgentPod — the staffing unit. Fills the existing urn:srcos:agent-pod: reference already used by AgentMachineReceipt.agentPodRef (no schema existed). - Opportunity — the objective a pod set pursues; anchors reuseRepos, podRefs, sharedLibraryRefs, readinessRef, deltaRefs. - ReadinessScore — 12-dimension scorecard (0..3 each, 0..36), pct + RAG + nextGate. - CaptureCadence — the governed sprint (weeks, min-readiness gates, exit decisions). - CaptureDelta — standing delta-control monitor with response SLA. - SharedLibrary — standardized-once/inherited-everywhere content library. + examples/*.json for each, tools/validate_agentic_os_examples.py, and a validate-agentic-os-examples Makefile target wired into `make validate`. All six schema/example pairs validate.
…overnance constitution
Recon of prophet-workspace + prophet-mesh showed the agentic-OS objects overlap
existing authorities; reconcile the contract to COMPOSE over them rather than
stand alone (authority separation: workspace=product semantics, mesh=graph+roles).
- Opportunity: + workroomRef (prophet-workspace ProfessionalWorkroom = the
objective container), controlRoomRef (OrgGovControlRoom = Objective→Actor→Role→
Policy→Evidence→Review→Score→Learning), telos {objective, constraints} (the
Telos layer — sets burden-of-proof/thresholds, does NOT assert truth), and
evidenceRefs (Truth Engine attestations).
- AgentPod: + choirRole (reconciles with the prophet-mesh agent-choir role
vocabulary) + agentSessionRef (the Perceive→Reason→Act→Verify execution loop).
- ReadinessScore: + evidenceRefs + policyRef — each dimension is a burden-of-proof
gate that advances only when its claim earns a Truth Record, per the constitution
(Telos sets thresholds; the falsifiable Truth Engine asserts truth).
All optional/back-compatible; 6/6 examples still validate.
This was referenced Jul 4, 2026
mdheller
added a commit
that referenced
this pull request
Jul 4, 2026
…r / supply-risk (#195) Consolidates the four handoff-spec contracts that back the client-vue cockpit program into one canonical pack (each was PR #191-194): - agentic-os: AgentPod, Opportunity, ReadinessScore, CaptureCadence, CaptureDelta, SharedLibrary (VA capture as the agentic OS over the stack) - triparty: NettingCell, TripartyBundle (governed-triparty marketplace) - labor-market: LaborRequest, LaborResponse, FitScore, LaborAward, TrustEvent (request-centric; fit is scored request<->response, never a global human-worth score) - supply-chain-risk: RiskNode, RiskPath, RiskCluster, RiskIndicator (BIAN op-risk / FICO) All 17 schemas + 17 examples validate; Makefile aggregates the four new targets into `make validate`.
Contributor
Author
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds the schema family for the agentic operating system — agent pods pursuing objectives across the estate under a governed capture cadence, delta-control SLAs, shared libraries, and a readiness scorecard (from the VA OIT Portfolio Operating System, generalized). System-of-record contract behind the cockpit's new Agentic OS console.
Schemas (JSON Schema 2020-12,
urn:srcos:*):urn:srcos:agent-pod:reference already used byAgentMachineReceipt.agentPodRef(no schema existed).Each has an example,
tools/validate_agentic_os_examples.py, and avalidate-agentic-os-examplestarget inmake validate. All six pairs validate.First of five handoff specs being built in; cockpit console shipped in the socioprophet client-vue.
🤖 Generated with Claude Code