Move one of the reader's magnets, what draws their own edition: a `target` and a step (away, low, normal,
high) saves at once. For a subject no target names, a `draft` of their own words: without `preview` it answers
what the draft would give a day, the pieces it finds, and a `confirm` digest; with preview=<confirm> it saves.
Their own words are the cause. The same move again changes nothing.
View input schema
{
"type": "object",
"properties": {
"amplitude": {
"enum": [
"away",
"low",
"normal",
"high"
],
"type": "string"
},
"cause": {
"description": "The reader's own words, kept verbatim as the cause.",
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "What to move: world, country:XX (ISO 3166-1), medtop:NNNNNNNN (an IPTC Media Topic), wd:Qnnn (a Wikidata item), word:<a few words> for a subject no code names, or def:<n> for a saved definition."
},
"draft": {
"anyOf": [
{
"additionalProperties": false,
"description": "A definition of a reader's own words, one saved version of it (docs/field/own-words.md).",
"properties": {
"author": {
"description": "Who wrote this version: the reader, an assistant in conversation, or the owner.",
"enum": [
"reader",
"assistant",
"owner"
],
"type": "string"
},
"lang": {
"description": "The ISO 639-1 language of `said`.",
"pattern": "^[a-z]{2}$",
"type": "string"
},
"said": {
"description": "The reader's words, verbatim; Profile reads them back to that reader.",
"maxLength": 1000,
"minLength": 1,
"pattern": "\\S",
"type": "string"
},
"interest": {
"description": "One sentence of what the definition is about: what any future model reads, and a magnet's label.",
"maxLength": 600,
"minLength": 1,
"pattern": "\\S",
"type": "string"
},
"breadth": {
"default": "narrow",
"description": "narrow (about it) by default; broad adds adjacent pieces.",
"enum": [
"narrow",
"broad"
],
"type": "string"
},
"include": {
"description": "Each line becomes a facet.",
"items": {
"maxLength": 120,
"minLength": 2,
"pattern": "\\S",
"type": "string"
},
"maxItems": 12,
"type": "array"
},
"exclude": {
"description": "The wrong senses, named.",
"items": {
"maxLength": 120,
"minLength": 2,
"pattern": "\\S",
"type": "string"
},
"maxItems": 12,
"type": "array"
},
"names": {
"additionalProperties": false,
"description": "The names it goes by, per ISO 639-1 language: model-free recall. A name matches whole words, case aside, in a piece's title or teaser, whatever the piece's language; a space or hyphen in it matches a space, a hyphen or nothing, and `*` any letters (a truncation).",
"maxProperties": 12,
"minProperties": 1,
"patternProperties": {
"^[a-z]{2}$": {
"items": {
"maxLength": 80,
"minLength": 2,
"pattern": "\\S",
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
},
"type": "object"
},
"anchors": {
"description": "Codes, countries and entities, each with its use.",
"items": {
"additionalProperties": false,
"description": "A code, a country or an entity the definition leans on, and how.",
"properties": {
"key": {
"description": "country:XX (ISO 3166-1), medtop:NNNNNNNN (an IPTC Media Topic code in the tree) or wd:Qnnn (a Wikidata item), normalised as a magnet's target is.",
"pattern": "^(?:country:[A-Z]{2}|medtop:[0-9]{8}|wd:Q[1-9][0-9]{0,9})$",
"type": "string"
},
"use": {
"description": "An entity selects or excludes; a code or a country gates or excludes, never selects (0.00 to 0.02 precision as selectors).",
"enum": [
"select",
"exclude",
"gate"
],
"type": "string"
},
"release": {
"anyOf": [
{
"pattern": "^\\d{4}-\\d\\d-\\d\\d$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "A Media Topic code's IPTC release; null on a country or an entity."
}
},
"required": [
"key",
"use"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"examples": {
"description": "3 to 8 pieces the reader wants, with their titles stored.",
"items": {
"additionalProperties": false,
"description": "A piece the definition should find (an example) or should not (a counter-example).",
"properties": {
"item": {
"description": "The piece's item id. Not checked against the pool, which prunes.",
"minimum": 1,
"type": "integer"
},
"title": {
"description": "The piece's title as stored, so the definition outlives it.",
"maxLength": 400,
"minLength": 1,
"pattern": "\\S",
"type": "string"
},
"why": {
"description": "Why it is in or out, in a few words (\"water\", \"a strike\").",
"maxLength": 120,
"minLength": 1,
"pattern": "\\S",
"type": "string"
}
},
"required": [
"item",
"title",
"why"
],
"type": "object"
},
"maxItems": 8,
"minItems": 3,
"type": "array"
},
"counter": {
"description": "Up to 8 pieces the reader does not want, the same shape.",
"items": {
"additionalProperties": false,
"description": "A piece the definition should find (an example) or should not (a counter-example).",
"properties": {
"item": {
"description": "The piece's item id. Not checked against the pool, which prunes.",
"minimum": 1,
"type": "integer"
},
"title": {
"description": "The piece's title as stored, so the definition outlives it.",
"maxLength": 400,
"minLength": 1,
"pattern": "\\S",
"type": "string"
},
"why": {
"description": "Why it is in or out, in a few words (\"water\", \"a strike\").",
"maxLength": 120,
"minLength": 1,
"pattern": "\\S",
"type": "string"
}
},
"required": [
"item",
"title",
"why"
],
"type": "object"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"author",
"lang",
"said",
"interest",
"names",
"examples"
],
"type": "object"
},
{
"type": "null"
}
],
"default": null
},
"preview": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The `confirm` digest a draft's preview answered, to save that very draft."
},
"note": {
"anyOf": [
{
"maxLength": 300,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"language": {
"default": "en",
"enum": [
"en",
"pl"
],
"type": "string"
}
},
"required": [
"amplitude",
"cause"
],
"additionalProperties": false
}