This repository has been archived on 2026-10-29. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
Epiphany/schemas/cultnet/epiphany.pipeline.resolution.v1.schema.json
Meta Vens 7ab838f167 Extract epiphany-pipeline, and add the three kinds a mind is keyed by
Ruling 1 keeps schema ownership in Epiphany; ruling 17 puts admission in
Huginn. Huginn must not take on epiphany-core -- about 41,000 lines and 295
lock packages -- to use about 1,000 lines of document types. So the documents
leave as a leaf library, and epiphany-core keeps no pipeline surface at all:
its consumption is campaign two.

`epiphany-core/src/pipeline_documents.rs` moves whole to
`epiphany-pipeline/src/lib.rs`, with its nine tests. Only three things changed
in the move: the module doc now describes a package rather than a cut map
section; `anyhow` joins `rmp-serde` behind `cfg(test)`, because the write path
has been test-only since 186dbc62 and the live library's errors are all
`PipelineRefusal`; and the decode refusal, which was pinned against
epiphany-core's Mind commit receipt, is pinned against a local `ForeignDocument`
carrying that receipt's type id, since the receipt belongs to the harness.

The package declares four dependencies. chrono parses a Date, cultcache-rs
supplies DatabaseEntry, schemars derives the published schemas (Q5), and serde
is the document format. anyhow, rmp-serde and serde_json are dev-dependencies:
every use of them is `cfg(test)`. `autobins = false`, as a leaf library must.
The workspace lock grows by exactly one entry, the member itself; no new
third-party package.

Deleted rather than re-exported: epiphany-core's `mod pipeline_documents;` and
`pub use pipeline_documents::*;`, and `schemars` from its manifest, whose only
user was this module. No shim, no duplicate type.

`runtime_spine_cache_refuses_a_pipeline_store` stays in epiphany-core, because
the rule is the spine registry's: it registers its own types and nothing else.
It now builds its foreign envelope from a `cfg(test)` stand-in carrying
`epiphany.pipeline.campaign.v1` rather than from the moved documents, so the
rule keeps its test without the package keeping a dependency.

D2's three new kinds arrive with the move, each with a live consumer in the
organ: `instance` is a mind's identity document, `stewardship` records the
repos an instance is assigned, and `hand_off` records a reassignment in both
minds. All three hang off an instance rather than a campaign, so they compose
their own keys instead of borrowing the `<campaign>:<kind>:<local>` tail. A
repo inside a key is escaped to `Org_Repo`, because `/` is not a Label byte.

Thirteen schemas now derive. The five that embed `PipelineKind` gained three
enum variants, which is additive, so Q2 keeps `epiphany.pipeline.epoch.v1`.

epiphany-pipeline: 12 tests, 0 warnings. epiphany-core: 163 tests -- 172 minus
the nine that moved -- 0 warnings. epiphany-state.exe is byte-identical.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-16 11:40:12 +02:00

206 lines
4.6 KiB
JSON

{
"$defs": {
"Date": {
"description": "A calendar date, `YYYY-MM-DD`.",
"maxLength": 10,
"type": "string"
},
"Line": {
"description": "Text of at most 1,000 UTF-8 bytes.",
"maxLength": 1000,
"type": "string"
},
"Para": {
"description": "Text of at most 4,000 UTF-8 bytes; longer narrative is cited by `DocRef`.",
"maxLength": 4000,
"type": "string"
},
"PipelineKind": {
"enum": [
"Campaign",
"Target",
"Question",
"Ruling",
"CutSpec",
"CutReport",
"Verdict",
"Finding",
"FollowUp",
"Resolution",
"Instance",
"Stewardship",
"HandOff"
],
"type": "string"
},
"PipelineRef": {
"description": "A reference to another document. The id is parsed as a full pipeline id of\nthe declared `kind`, so the kind and the id's kind segment cannot disagree.",
"properties": {
"id": {
"$ref": "#/$defs/Short"
},
"kind": {
"$ref": "#/$defs/PipelineKind"
}
},
"required": [
"kind",
"id"
],
"type": "object"
},
"ResolutionOutcome": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"Superseded": {
"properties": {
"by": {
"$ref": "#/$defs/Short"
}
},
"required": [
"by"
],
"type": "object"
}
},
"required": [
"Superseded"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"Answered": {
"properties": {
"by": {
"$ref": "#/$defs/Short"
}
},
"required": [
"by"
],
"type": "object"
}
},
"required": [
"Answered"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"Fixed": {
"properties": {
"by": {
"$ref": "#/$defs/Short"
}
},
"required": [
"by"
],
"type": "object"
}
},
"required": [
"Fixed"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"Deferred": {
"properties": {
"to": {
"$ref": "#/$defs/Short"
}
},
"required": [
"to"
],
"type": "object"
}
},
"required": [
"Deferred"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"Recorded": {
"properties": {
"reason": {
"$ref": "#/$defs/Line"
}
},
"required": [
"reason"
],
"type": "object"
}
},
"required": [
"Recorded"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"Withdrawn": {
"properties": {
"reason": {
"$ref": "#/$defs/Line"
}
},
"required": [
"reason"
],
"type": "object"
}
},
"required": [
"Withdrawn"
],
"type": "object"
}
]
},
"Short": {
"description": "Text of at most 200 UTF-8 bytes.",
"maxLength": 200,
"type": "string"
}
},
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.pipeline.resolution.v1.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"outcome": {
"$ref": "#/$defs/ResolutionOutcome"
},
"rationale": {
"$ref": "#/$defs/Para"
},
"resolved_on": {
"$ref": "#/$defs/Date"
},
"subject": {
"$ref": "#/$defs/PipelineRef"
}
},
"required": [
"subject",
"outcome",
"rationale",
"resolved_on"
],
"title": "PipelineResolution",
"type": "object"
}