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>
137 lines
2.9 KiB
JSON
137 lines
2.9 KiB
JSON
{
|
|
"$defs": {
|
|
"Date": {
|
|
"description": "A calendar date, `YYYY-MM-DD`.",
|
|
"maxLength": 10,
|
|
"type": "string"
|
|
},
|
|
"Label": {
|
|
"description": "A key label: `[A-Za-z0-9_-]{1,64}`.",
|
|
"maxLength": 64,
|
|
"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"
|
|
},
|
|
"QuestionOption": {
|
|
"properties": {
|
|
"label": {
|
|
"$ref": "#/$defs/Label"
|
|
},
|
|
"text": {
|
|
"$ref": "#/$defs/Line"
|
|
}
|
|
},
|
|
"required": [
|
|
"label",
|
|
"text"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"Short": {
|
|
"description": "Text of at most 200 UTF-8 bytes.",
|
|
"maxLength": 200,
|
|
"type": "string"
|
|
},
|
|
"Slug": {
|
|
"description": "A campaign slug or key segment: label parts joined by `.`.",
|
|
"maxLength": 64,
|
|
"type": "string"
|
|
}
|
|
},
|
|
"$id": "https://gamecult.dev/epiphany/cultnet/epiphany.pipeline.question.v1.schema.json",
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"properties": {
|
|
"asked_on": {
|
|
"$ref": "#/$defs/Date"
|
|
},
|
|
"campaign": {
|
|
"$ref": "#/$defs/Slug"
|
|
},
|
|
"depends": {
|
|
"items": {
|
|
"$ref": "#/$defs/Line"
|
|
},
|
|
"maxItems": 8,
|
|
"type": "array"
|
|
},
|
|
"label": {
|
|
"$ref": "#/$defs/Label"
|
|
},
|
|
"options": {
|
|
"items": {
|
|
"$ref": "#/$defs/QuestionOption"
|
|
},
|
|
"maxItems": 8,
|
|
"type": "array"
|
|
},
|
|
"question": {
|
|
"$ref": "#/$defs/Para"
|
|
},
|
|
"raised_in": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/$defs/PipelineRef"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"recommended": {
|
|
"$ref": "#/$defs/Label"
|
|
}
|
|
},
|
|
"required": [
|
|
"campaign",
|
|
"label",
|
|
"question",
|
|
"options",
|
|
"recommended",
|
|
"depends",
|
|
"asked_on"
|
|
],
|
|
"title": "PipelineQuestion",
|
|
"type": "object"
|
|
}
|