diff --git a/CHANGELOG.md b/CHANGELOG.md index fc21663..49d399a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,7 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). Thi ## [Unreleased] ### Added +- SourceOS interaction substrate top-level index and README discovery links for `SourceOSInteractionEvent`, generated TypeScript/Python artifacts, and the Noetica → Superconscious → AgentPlane → AgentTerm reference flow. - Runtime observability and capability governance contracts: `CapabilityLedger`, `BrowserAutomationReceipt`, `GitWorkspaceState`, `OrphanEventReceipt`, and `RuntimeInstallReceipt` with canonical examples, validation wiring (`tools/validate_runtime_observability_examples.py`), a contract catalog, and ADR-0012. - Reasoning run contracts: `ReasoningRun`, `ReasoningEvent`, `ReasoningReceipt`, `ReasoningReplayPlan`, and `ReasoningBenchmark` with canonical examples and a contract-additions note for the Superconscious reference loop. - Agent Machine / Model Carry schemas: `SourceOSModelCarryRef`, `InferenceProvider`, `ModelResidency`, `PlacementFact`, and `AgentMachineReceipt` with canonical examples and a contract-additions placement note. diff --git a/README.md b/README.md index 766b87f..4e5368f 100644 --- a/README.md +++ b/README.md @@ -86,6 +86,28 @@ New machine-readable contracts: --- +## SourceOS interaction substrate + +The SourceOS interaction substrate defines the governed noetic/chat/task event path shared by Noetica, AgentTerm, Superconscious, and AgentPlane. + +Start here: + +- [SourceOS Interaction Substrate Catalog](docs/contract-additions/sourceos-interaction-catalog.md) +- [SourceOS Interaction Reference Flow](docs/contract-additions/sourceos-interaction-reference-flow.md) +- [SourceOS Interaction Top-Level Index](docs/contract-additions/sourceos-interaction-top-level-index.md) +- `schemas/SourceOSInteractionEvent.json` +- `examples/interaction-flow/noetica-superconscious-agentplane-agentterm.flow.json` + +Validate locally: + +```bash +python tools/validate_sourceos_interaction_examples.py +python tools/generate_sourceos_interaction_types.py --check +python tools/validate_interaction_flow_reference.py +``` + +--- + ## Schema families The schemas are organised into domain-oriented families that map to the SourceOS / SociOS contract surface: @@ -103,6 +125,7 @@ The schemas are organised into domain-oriented families that map to the SourceOS | + | **Release / Experiments** | `ExperimentFlag`, `RolloutPolicy`, `ReleaseReceipt` | | + | **Fog Layer** | `Topic`, `TopicEnvelope`, `ReplicationPolicy`, `ContentRef`, `Offer`, `WorkOrder`, `UsageReceipt`, `SettlementEvent` | | + | **Agentic Graph Foundation** | `SourceOSRepoManifest`, `SyncEngineManifest`, `SourceChannelEnvelope`, `SourceGraphWrite`, `AgentCapabilityLease`, `AuditEvent` | +| + | **Interaction Substrate** | `SourceOSInteractionEvent` | --- diff --git a/docs/contract-additions/sourceos-interaction-top-level-index.md b/docs/contract-additions/sourceos-interaction-top-level-index.md new file mode 100644 index 0000000..7aa20db --- /dev/null +++ b/docs/contract-additions/sourceos-interaction-top-level-index.md @@ -0,0 +1,38 @@ +# SourceOS Interaction Substrate Top-Level Index + +Status: informational index + +The SourceOS interaction substrate is the governed noetic/chat/task event path connecting browser chat, task-boundary coordination, execution evidence, and terminal rendering. + +Start here: + +- Canonical schema: `schemas/SourceOSInteractionEvent.json` +- Base example: `examples/sourceos-interaction-event.json` +- Generated TypeScript artifact: `generated/typescript/sourceos-interaction-event.ts` +- Generated Python artifact: `generated/python/sourceos_interaction_event.py` +- Substrate catalog: `docs/contract-additions/sourceos-interaction-catalog.md` +- Reference flow: `docs/contract-additions/sourceos-interaction-reference-flow.md` +- Reference manifest: `examples/interaction-flow/noetica-superconscious-agentplane-agentterm.flow.json` + +Implemented downstream roles: + +- `SocioProphet/Noetica`: browser chat and governance-trail emitter. +- `SourceOS-Linux/agent-term`: terminal governance-trace renderer. +- `SocioProphet/superconscious`: task-boundary reference binding. +- `SocioProphet/agentplane`: evidence and replay reference binding. + +Validation commands: + +```bash +python tools/validate_sourceos_interaction_examples.py +python tools/generate_sourceos_interaction_types.py --check +python tools/validate_interaction_flow_reference.py +``` + +Authority split: + +- `sourceos-spec` owns schema and generated contract artifacts. +- Surfaces own rendering and user interaction. +- Superconscious owns task-boundary coordination. +- AgentPlane owns evidence and replay references. +- Policy, identity/grants, and memory remain separate authority planes.