Collapse CultNet catalog to earned boundaries

This commit is contained in:
Meta Vens 2026-08-24 07:03:42 +02:00
commit 8bb0719bc6
16 changed files with 9 additions and 749 deletions

View file

@ -170,7 +170,7 @@ publication, sealed forensic artifacts, or named quarantine experiments.
the Body. It imports and registers:
\begin{itemize}
\item runtime identity, session, job, job-result, and event records;
\item runtime identity, session, job, and job-result records;
\item worker launch requests and role/reorient worker result documents;
\item model adapter, OpenAI adapter, and tool adapter documents;
\item sealed reasoning bases, decision contexts, typed pass failures, and

View file

@ -16,20 +16,17 @@ verbs.
- `index.json`: publication manifest for providers that expose these contracts.
- `*.schema.json`: top-level JSON Schema receipts for payload/document shapes.
The payload receipts are deliberately practical rather than religiously
exhaustive. They publish the stable top-level structure Aquarium needs for
inspection, visualization, and control without pretending every nested app
server object deserves to be duplicated into a second baroque schema maze.
The catalog contains only contracts that cross an owned boundary. Runtime-local
CultCache documents are discovered from the runtime's native registration and
projected by their owning CultMesh provider. They are not copied into a second
hand-maintained JSON registry.
## Main Families
- `epiphany.runtime.*`: native runtime-spine identity, session, job, job
result, and event documents.
- keyed Mind documents and `epiphany.state-ledger`: durable typed state and
exact decision/commit receipts the runtime lives on.
- model, tool, and provider-boundary contracts used by the native runtime.
- `gamecult.persona_state.v0` and `epiphany.work_organ_state.v0`: portable
state contracts whose owners may live outside this repository.
- `epiphany.openai_model_request.v1`: the exact provider request crossing the
OpenAI-compatible transport boundary.
- `gamecult.persona_state.v0`: portable public Persona state.
- `epiphany.work_organ_state.v0`: portable state for lean work organs.
The catalog publishes contracts the executable body actually produces or
consumes. Editor capabilities are provider-owned CultMesh/Eve surfaces, not

View file

@ -1,37 +0,0 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.coordinator-run-receipt.schema.json",
"title": "Epiphany Coordinator Run Receipt",
"description": "Typed terminal decision and exact resident-launch provenance emitted by the local coordinator. Operator artifacts remain non-authoritative projections.",
"type": "object",
"required": [
"schema_version",
"receipt_id",
"session_id",
"thread_id",
"mode",
"status",
"final_action",
"created_at"
],
"properties": {
"schema_version": { "const": "epiphany.coordinator_run_receipt.v1" },
"receipt_id": { "type": "string" },
"session_id": { "type": "string" },
"thread_id": { "type": "string" },
"mode": { "enum": ["plan", "execute"] },
"status": { "type": "string" },
"final_action": { "type": "string" },
"final_reason": { "type": ["string", "null"] },
"created_at": { "type": "string" },
"resident_grant_id": { "type": ["string", "null"] },
"resident_launch_digest": { "type": ["string", "null"] },
"resident_policy_digest": { "type": ["string", "null"] },
"resident_argv_digest": { "type": ["string", "null"] },
"resident_objective_digest": { "type": ["string", "null"] },
"resident_release_commit": { "type": ["string", "null"] },
"resident_release_manifest_digest": { "type": ["string", "null"] },
"resident_executable_digest": { "type": ["string", "null"] }
},
"additionalProperties": false
}

View file

@ -1,19 +0,0 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.model-receipt.schema.json",
"title": "Epiphany Model Receipt",
"type": "object",
"required": ["schema_id", "request_id", "provider", "model"],
"properties": {
"schema_id": { "const": "epiphany.model_receipt.v0" },
"request_id": { "type": "string" },
"provider": { "type": "string" },
"model": { "type": "string" },
"provider_response_id": { "type": ["string", "null"] },
"input_tokens": { "type": ["integer", "null"], "minimum": 0 },
"output_tokens": { "type": ["integer", "null"], "minimum": 0 },
"reasoning_output_tokens": { "type": ["integer", "null"], "minimum": 0 },
"transport": { "type": ["string", "null"] }
},
"additionalProperties": false
}

View file

@ -1,105 +0,0 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.model-request.schema.json",
"title": "Epiphany Model Request",
"type": "object",
"required": ["schema_id", "request_id", "conversation_id", "provider", "model", "instructions", "input"],
"properties": {
"schema_id": { "const": "epiphany.model_request.v0" },
"request_id": { "type": "string" },
"conversation_id": { "type": "string" },
"provider": { "type": "string" },
"model": { "type": "string" },
"instructions": { "type": "string" },
"input": {
"type": "array",
"items": { "$ref": "#/$defs/input_item" }
},
"reasoning_effort": { "type": ["string", "null"] },
"reasoning_summary": { "type": ["string", "null"] },
"service_tier": { "type": ["string", "null"] },
"output_contract_id": { "type": ["string", "null"] },
"previous_response_id": { "type": ["string", "null"] },
"tools": {
"type": "array",
"items": {
"type": "object",
"required": ["name", "description", "parameters_json"],
"properties": {
"name": { "type": "string" },
"description": { "type": "string" },
"parameters_json": { "type": "string" }
},
"additionalProperties": false
}
},
"output_schema_json": { "type": ["string", "null"] },
"source_worker_job_id": { "type": ["string", "null"] }
},
"additionalProperties": false,
"$defs": {
"input_item": {
"oneOf": [
{
"type": "object",
"required": ["ToolCall"],
"properties": {
"ToolCall": {
"type": "object",
"required": ["call_id", "name", "arguments"],
"properties": {
"call_id": { "type": "string" },
"name": { "type": "string" },
"arguments": { "type": "string" }
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": ["UserText"],
"properties": {
"UserText": {
"type": "object",
"required": ["text"],
"properties": { "text": { "type": "string" } },
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": ["AssistantText"],
"properties": {
"AssistantText": {
"type": "object",
"required": ["text"],
"properties": { "text": { "type": "string" } },
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": ["ToolResult"],
"properties": {
"ToolResult": {
"type": "object",
"required": ["call_id", "output"],
"properties": {
"call_id": { "type": "string" },
"output": { "type": "string" }
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
}
}
}

View file

@ -1,94 +0,0 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.model-stream-event.schema.json",
"title": "Epiphany Model Stream Event",
"type": "object",
"required": ["schema_id", "request_id", "provider", "sequence", "payload"],
"properties": {
"schema_id": { "const": "epiphany.model_stream_event.v0" },
"request_id": { "type": "string" },
"provider": { "type": "string" },
"sequence": { "type": "integer", "minimum": 0 },
"payload": {
"oneOf": [
{ "$ref": "#/$defs/text_delta" },
{ "$ref": "#/$defs/reasoning_delta" },
{ "$ref": "#/$defs/tool_call" },
{ "$ref": "#/$defs/completed" },
{ "$ref": "#/$defs/failed" }
]
}
},
"additionalProperties": false,
"$defs": {
"text_delta": {
"type": "object",
"required": ["TextDelta"],
"properties": {
"TextDelta": {
"type": "object",
"required": ["text"],
"properties": { "text": { "type": "string" } },
"additionalProperties": false
}
},
"additionalProperties": false
},
"reasoning_delta": {
"type": "object",
"required": ["ReasoningDelta"],
"properties": {
"ReasoningDelta": {
"type": "object",
"required": ["text"],
"properties": { "text": { "type": "string" } },
"additionalProperties": false
}
},
"additionalProperties": false
},
"tool_call": {
"type": "object",
"required": ["ToolCall"],
"properties": {
"ToolCall": {
"type": "object",
"required": ["call_id", "name", "arguments"],
"properties": {
"call_id": { "type": "string" },
"name": { "type": "string" },
"arguments": { "type": "string" }
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"completed": {
"type": "object",
"required": ["Completed"],
"properties": {
"Completed": {
"type": "object",
"required": ["receipt"],
"properties": { "receipt": { "$ref": "epiphany.model-receipt.schema.json" } },
"additionalProperties": false
}
},
"additionalProperties": false
},
"failed": {
"type": "object",
"required": ["Failed"],
"properties": {
"Failed": {
"type": "object",
"required": ["message"],
"properties": { "message": { "type": "string" } },
"additionalProperties": false
}
},
"additionalProperties": false
}
}
}

View file

@ -1,48 +0,0 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.runtime.identity.schema.json",
"title": "Epiphany Runtime Identity",
"description": "Identity record for the native Epiphany runtime spine.",
"type": "object",
"additionalProperties": true,
"properties": {
"schemaVersion": {
"type": "string",
"description": "Runtime identity payload version."
},
"runtimeId": {
"type": "string"
},
"displayName": {
"type": "string"
},
"runtimeKind": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"supportedDocumentTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"metadata": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"runtimeId",
"displayName",
"runtimeKind",
"createdAt",
"updatedAt",
"supportedDocumentTypes"
]
}

View file

@ -1,63 +0,0 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.runtime.job-result.schema.json",
"title": "Epiphany Runtime Job Result",
"description": "Reviewable runtime-spine job result.",
"type": "object",
"additionalProperties": true,
"properties": {
"schemaVersion": {
"type": "string"
},
"resultId": {
"type": "string"
},
"jobId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"role": {
"type": "string"
},
"verdict": {
"type": "string"
},
"summary": {
"type": "string"
},
"completedAt": {
"type": "string"
},
"nextSafeMove": {
"type": "string"
},
"evidenceRefs": {
"type": "array",
"items": {
"type": "string"
}
},
"artifactRefs": {
"type": "array",
"items": {
"type": "string"
}
},
"metadata": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"resultId",
"jobId",
"sessionId",
"role",
"verdict",
"summary",
"completedAt"
]
}

View file

@ -1,40 +0,0 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.runtime.job.schema.json",
"title": "Epiphany Runtime Job",
"description": "Native runtime-spine job state.",
"type": "object",
"additionalProperties": false,
"properties": {
"schemaVersion": {
"type": "string"
},
"jobId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"role": {
"type": "string"
},
"status": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"updatedAt": {
"type": "string"
}
},
"required": [
"schemaVersion",
"jobId",
"sessionId",
"role",
"status",
"createdAt",
"updatedAt"
]
}

View file

@ -1,27 +0,0 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.runtime.model-execution-binding.schema.json",
"title": "Epiphany Runtime Model Execution Binding",
"description": "Immutable ownership edge from one native/provider model request pair to its runtime session and job.",
"type": "object",
"additionalProperties": false,
"properties": {
"schemaVersion": { "type": "string", "const": "epiphany.runtime.model_execution_binding.v0" },
"bindingId": { "type": "string", "minLength": 1 },
"requestId": { "type": "string", "minLength": 1 },
"sessionId": { "type": "string", "minLength": 1 },
"jobId": { "type": "string", "minLength": 1 },
"provider": { "type": "string", "minLength": 1 },
"boundAt": { "type": "string", "format": "date-time" },
"sourceWorkerJobId": { "type": ["string", "null"] }
},
"required": [
"schemaVersion",
"bindingId",
"requestId",
"sessionId",
"jobId",
"provider",
"boundAt"
]
}

View file

@ -1,40 +0,0 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.runtime.session.schema.json",
"title": "Epiphany Runtime Session",
"description": "Native runtime-spine session state.",
"type": "object",
"additionalProperties": false,
"properties": {
"schemaVersion": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"objective": {
"type": "string"
},
"status": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"coordinatorNote": {
"type": "string"
}
},
"required": [
"schemaVersion",
"sessionId",
"objective",
"status",
"createdAt",
"updatedAt",
"coordinatorNote"
]
}

View file

@ -1,25 +0,0 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.runtime.tool-execution-binding.schema.json",
"title": "Epiphany Runtime Tool Execution Binding",
"description": "Immutable ownership edge from one tool intent to its runtime session, job, and optional model execution.",
"type": "object",
"additionalProperties": false,
"properties": {
"schemaVersion": { "type": "string", "const": "epiphany.runtime.tool_execution_binding.v0" },
"bindingId": { "type": "string", "minLength": 1 },
"intentId": { "type": "string", "minLength": 1 },
"sessionId": { "type": "string", "minLength": 1 },
"jobId": { "type": "string", "minLength": 1 },
"modelRequestId": { "type": ["string", "null"] },
"boundAt": { "type": "string", "format": "date-time" }
},
"required": [
"schemaVersion",
"bindingId",
"intentId",
"sessionId",
"jobId",
"boundAt"
]
}

View file

@ -1,36 +0,0 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.state-ledger.schema.json",
"title": "Epiphany State Ledger",
"description": "Durable branch/evidence ledger entry.",
"type": "object",
"additionalProperties": true,
"properties": {
"schemaVersion": {
"type": "string"
},
"branches": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"extra": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"branches",
"evidence"
]
}

View file

@ -1,30 +0,0 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.tool-invocation-intent.schema.json",
"title": "Epiphany Tool Invocation Intent",
"description": "Coordinator-owned typed request to call a tool through an adapter. Raw MCP arguments remain string cargo until the adapter validates them.",
"type": "object",
"required": [
"schema_id",
"intent_id",
"adapter",
"server",
"tool_name",
"arguments_json",
"caller",
"reason",
"created_at"
],
"properties": {
"schema_id": { "const": "epiphany.tool_invocation_intent.v0" },
"intent_id": { "type": "string" },
"adapter": { "type": "string" },
"server": { "type": "string" },
"tool_name": { "type": "string" },
"arguments_json": { "type": "string" },
"caller": { "type": "string" },
"reason": { "type": "string" },
"created_at": { "type": "string" }
},
"additionalProperties": false
}

View file

@ -1,30 +0,0 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.tool-invocation-receipt.schema.json",
"title": "Epiphany Tool Invocation Receipt",
"description": "Typed receipt from a tool adapter after it executes or refuses a tool invocation.",
"type": "object",
"required": [
"schema_id",
"receipt_id",
"intent_id",
"adapter",
"server",
"tool_name",
"status",
"completed_at"
],
"properties": {
"schema_id": { "const": "epiphany.tool_invocation_receipt.v1" },
"receipt_id": { "type": "string" },
"intent_id": { "type": "string" },
"adapter": { "type": "string" },
"server": { "type": "string" },
"tool_name": { "type": "string" },
"status": { "type": "string" },
"completed_at": { "type": "string", "format": "date-time" },
"result_json": { "type": ["string", "null"] },
"error": { "type": ["string", "null"] }
},
"additionalProperties": false
}

View file

@ -1,138 +1,6 @@
{
"schemaVersion": "epiphany.cultnet_catalog.v0",
"schemas": [
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.runtime.identity.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.runtime_spine.v0",
"documentType": "epiphany.runtime.identity",
"title": "Epiphany Runtime Identity",
"path": "epiphany.runtime.identity.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.runtime.session.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.runtime_spine.v1",
"documentType": "epiphany.runtime.session",
"title": "Epiphany Runtime Session",
"path": "epiphany.runtime.session.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.runtime.model-execution-binding.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.runtime.model_execution_binding.v0",
"documentType": "epiphany.runtime.model_execution_binding",
"title": "Epiphany Runtime Model Execution Binding",
"path": "epiphany.runtime.model-execution-binding.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.runtime.tool-execution-binding.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.runtime.tool_execution_binding.v0",
"documentType": "epiphany.runtime.tool_execution_binding",
"title": "Epiphany Runtime Tool Execution Binding",
"path": "epiphany.runtime.tool-execution-binding.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.runtime.job.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.runtime_spine.v1",
"documentType": "epiphany.runtime.job",
"title": "Epiphany Runtime Job",
"path": "epiphany.runtime.job.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.runtime.job-result.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.runtime_spine.v0",
"documentType": "epiphany.runtime.job_result",
"title": "Epiphany Runtime Job Result",
"path": "epiphany.runtime.job-result.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.coordinator-run-receipt.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.coordinator_run_receipt.v1",
"documentType": "epiphany.coordinator_run_receipt.v1",
"title": "Epiphany Coordinator Run Receipt",
"path": "epiphany.coordinator-run-receipt.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.model-request.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.model_request.v0",
"documentType": "epiphany.model_request.v0",
"title": "Epiphany Model Request",
"path": "epiphany.model-request.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.model-stream-event.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.model_stream_event.v0",
"documentType": "epiphany.model_stream_event.v0",
"title": "Epiphany Model Stream Event",
"path": "epiphany.model-stream-event.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.model-receipt.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.model_receipt.v0",
"documentType": "epiphany.model_receipt.v0",
"title": "Epiphany Model Receipt",
"path": "epiphany.model-receipt.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.tool-invocation-intent.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.tool_invocation_intent.v0",
"documentType": "epiphany.tool_invocation_intent.v0",
"title": "Epiphany Tool Invocation Intent",
"path": "epiphany.tool-invocation-intent.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.tool-invocation-receipt.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.tool_invocation_receipt.v1",
"documentType": "epiphany.tool_invocation_receipt.v1",
"title": "Epiphany Tool Invocation Receipt",
"path": "epiphany.tool-invocation-receipt.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.openai-model-request.schema.json",
"kind": "document_payload",
@ -165,17 +33,6 @@
"documentType": "epiphany.work_organ_state.v0",
"title": "Epiphany Work Organ State v0",
"path": "epiphany.work_organ_state.v0.schema.json"
},
{
"schemaId": "https://gamecult.dev/epiphany/cultnet/epiphany.state-ledger.schema.json",
"kind": "document_payload",
"wireContracts": [
"cultnet.schema.v0"
],
"schemaVersion": "epiphany.state_ledger.v0",
"documentType": "epiphany.state_ledger",
"title": "Epiphany State Ledger",
"path": "epiphany.state-ledger.schema.json"
}
]
}