NewsStory `news.story@1`

Generated at 2026-09-26 00:45:03 UTC from openvibe-contracts v0.53.0 and openvibe-sdk v0.11.0.

Version: 1.0.0
Owner: news
Visibility: first-party
Status: active
Compatibility: backward
Schema: https://openvibe.network/contracts/news/story.v1.json

news.story@1: one story as OpenVibe.News shows it to editors (server/http/api.js storyDto), drafts included: publication state, the head revision (headline and paragraphs that each cite source numbers, authorship), what stands between it and publication, the gate's indexability of the published revision, the working source table (numbered, never renumbered; detached sources stay listed), timeline, perspectives and editorial flags.

Fields

Field	Type	Required	Description	Constraints
`id`	string	yes		`pattern ^sty_[0-9A-HJKMNP-TV-Z]{26}$`
`slug`	string	yes
`url`	string	yes
`state`	enum	yes		`one of "draft", "published", "unpublished", "retracted"`
`cluster_id`	string \| null	yes
`topic`	string \| null	yes	The topic slug.
`working_headline`	string	yes
`noindex`	boolean	yes
`published_revision`	integer \| null	yes
`first_published_at`	string \| null	yes		`format date-time`
`published_at`	string \| null	yes		`format date-time`
`retracted_at`	string \| null	yes		`format date-time`
`head`	object \| null	yes
`publishable`	array of object	yes	What stands between the revision and publication (story.unsourced, story.claim_unsourced, story.source_removed, story.source_detached, story.review_required, story.no_headline, …); empty when it can be published.
`publishable[].code`	string	yes
`publishable[].detail`	string	yes
`indexability`	object \| null	yes
`sources`	array of object	yes
`sources[].n`	integer	yes		`minimum 1`
`sources[].perspective_id`	string \| null	yes
`sources[].detached_at`	string \| null	yes		`format date-time`
`sources[].item`	news.source-item	yes
`timeline`	array of object	yes
`timeline[].id`	string	yes		`pattern ^tle_[0-9A-HJKMNP-TV-Z]{26}$`
`timeline[].occurred_on`	string	yes
`timeline[].text`	string	yes
`timeline[].source_item_id`	string	yes
`perspectives`	array of object	yes
`perspectives[].id`	string	yes		`pattern ^per_[0-9A-HJKMNP-TV-Z]{26}$`
`perspectives[].label`	string	yes
`perspectives[].description`	string \| null	yes
`flags`	array of object	yes
`flags[].id`	string	yes		`pattern ^flg_[0-9A-HJKMNP-TV-Z]{26}$`
`flags[].kind`	enum	yes		`one of "correction", "update", "retraction", "source_updated", "source_removed"`
`flags[].status`	enum	yes		`one of "open", "published", "resolved"`
`flags[].note`	string \| null	yes
`flags[].source_item_id`	string \| null	yes
`flags[].pending_revision`	integer \| null	yes
`flags[].revision`	integer \| null	yes
`flags[].created_by`	string	yes
`flags[].created_at`	string	yes		`format date-time`
`flags[].resolved_at`	string \| null	yes		`format date-time`

Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

Valid: draft

{
  "id": "sty_01JAB3DEF4GH5JK6MN7PQ8RS9T",
  "slug": "harbour-bridge-closes-for-inspection",
  "url": "https://openvibe.news/s/harbour-bridge-closes-for-inspection",
  "state": "draft",
  "cluster_id": "clu_01JAB2X3C4D5E6F7G8H9J0KMNP",
  "topic": "local",
  "working_headline": "Harbour bridge closes for inspection",
  "noindex": false,
  "published_revision": null,
  "first_published_at": null,
  "published_at": null,
  "retracted_at": null,
  "head": {
    "revision": 1,
    "headline": "Harbour bridge closes for inspection",
    "paragraphs": [
      {
        "text": "The harbour bridge closed on Tuesday morning after inspectors found cracks in a support.",
        "sources": [
          1
        ]
      },
      {
        "text": "The council expects the inspection to take two weeks.",
        "sources": [
          2
        ]
      }
    ],
    "authorship": {
      "mode": "human",
      "authors": [
        "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ"
      ]
    },
    "system": null,
    "gaps": null,
    "author": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
    "created_at": "2026-09-24T09:40:12.000Z"
  },
  "publishable": [],
  "indexability": null,
  "sources": [
    {
      "n": 1,
      "perspective_id": null,
      "detached_at": null,
      "item": {
        "id": "nsi_01JAB2Z7Y6X5W4V3T2S1R0QPNM",
        "sources_item": {
          "service": "sources",
          "type": "item",
          "id": "itm_01JAB2Y8K9M1N2P3Q4R5S6T7VW",
          "revision": 1
        },
        "source_key": "harbour-gazette",
        "headline": "Harbour bridge closes for inspection after cracks found",
        "url": "https://harbourgazette.example/bridge-closure",
        "outlet": "Harbour Gazette",
        "authors": [
          "M. Okafor"
        ],
        "published_at": "2026-09-24T07:30:00+01:00",
        "summary": null,
        "summary_basis": "terms do not allow a stored summary",
        "license_note": null,
        "terms_note": "Headline and link only",
        "status": "active",
        "duplicate_of": null,
        "dedupe": null,
        "cluster_id": "clu_01JAB2X3C4D5E6F7G8H9J0KMNP",
        "cluster_reason": {
          "rule": "new_cluster",
          "cluster": "clu_01JAB2X3C4D5E6F7G8H9J0KMNP",
          "terms": [
            "bridge",
            "harbour",
            "inspection"
          ],
          "entities": [
            "Harbour Bridge"
          ]
        },
        "retrieved_at": "2026-09-24T08:15:00.000Z",
        "first_seen_at": "2026-09-24T08:15:00.000Z",
        "upstream_updated_at": null,
        "removed": null
      }
    },
    {
      "n": 2,
      "perspective_id": null,
      "detached_at": null,
      "item": {
        "id": "nsi_01JAB2Z8Y6X5W4V3T2S1R0QPNM",
        "sources_item": {
          "service": "sources",
          "type": "item",
          "id": "itm_01JAB2Y9K9M1N2P3Q4R5S6T7VW",
          "revision": 1
        },
        "source_key": "coastal-wire",
        "headline": "Bridge inspection to take two weeks, council says",
        "url": "https://coastalwire.example/news/bridge-inspection",
        "outlet": "Coastal Wire",
        "authors": [
          "M. Okafor"
        ],
        "published_at": "2026-09-24T07:30:00+01:00",
        "summary": null,
        "summary_basis": "terms do not allow a stored summary",
        "license_note": null,
        "terms_note": "Headline and link only",
        "status": "active",
        "duplicate_of": null,
        "dedupe": null,
        "cluster_id": "clu_01JAB2X3C4D5E6F7G8H9J0KMNP",
        "cluster_reason": {
          "rule": "shared_terms",
          "cluster": "clu_01JAB2X3C4D5E6F7G8H9J0KMNP",
          "shared_entities": [
            "Harbour Bridge"
          ],
          "shared_terms": [
            "bridge",
            "inspection"
          ],
          "score": 4,
          "window_hours": 72
        },
        "retrieved_at": "2026-09-24T08:15:00.000Z",
        "first_seen_at": "2026-09-24T08:15:00.000Z",
        "upstream_updated_at": null,
        "removed": null
      }
    }
  ],
  "timeline": [
    {
      "id": "tle_01JAB4T5V6W7X8Y9Z0A1B2C3D4",
      "occurred_on": "2026-09-23",
      "text": "Inspectors report cracks in a bridge support.",
      "source_item_id": "nsi_01JAB2Z7Y6X5W4V3T2S1R0QPNM"
    }
  ],
  "perspectives": [
    {
      "id": "per_01JAB4P5Q6R7S8T9V0W1X2Y3Z4",
      "label": "Council statements",
      "description": null
    }
  ],
  "flags": []
}

Rejected: bad-state

{
  "id": "sty_01JAB3DEF4GH5JK6MN7PQ8RS9T",
  "slug": "harbour-bridge-closes-for-inspection",
  "url": "https://openvibe.news/s/harbour-bridge-closes-for-inspection",
  "state": "archived",
  "cluster_id": "clu_01JAB2X3C4D5E6F7G8H9J0KMNP",
  "topic": "local",
  "working_headline": "Harbour bridge closes for inspection",
  "noindex": false,
  "published_revision": null,
  "first_published_at": null,
  "published_at": null,
  "retracted_at": null,
  "head": {
    "revision": 1,
    "headline": "Harbour bridge closes for inspection",
    "paragraphs": [
      {
        "text": "The harbour bridge closed on Tuesday morning after inspectors found cracks in a support.",
        "sources": [
          1
        ]
      },
      {
        "text": "The council expects the inspection to take two weeks.",
        "sources": [
          2
        ]
      }
    ],
    "authorship": {
      "mode": "human",
      "authors": [
        "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ"
      ]
    },
    "system": null,
    "gaps": null,
    "author": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
    "created_at": "2026-09-24T09:40:12.000Z"
  },
  "publishable": [],
  "indexability": null,
  "sources": [
    {
      "n": 1,
      "perspective_id": null,
      "detached_at": null,
      "item": {
        "id": "nsi_01JAB2Z7Y6X5W4V3T2S1R0QPNM",
        "sources_item": {
          "service": "sources",
          "type": "item",
          "id": "itm_01JAB2Y8K9M1N2P3Q4R5S6T7VW",
          "revision": 1
        },
        "source_key": "harbour-gazette",
        "headline": "Harbour bridge closes for inspection after cracks found",
        "url": "https://harbourgazette.example/bridge-closure",
        "outlet": "Harbour Gazette",
        "authors": [
          "M. Okafor"
        ],
        "published_at": "2026-09-24T07:30:00+01:00",
        "summary": null,
        "summary_basis": "terms do not allow a stored summary",
        "license_note": null,
        "terms_note": "Headline and link only",
        "status": "active",
        "duplicate_of": null,
        "dedupe": null,
        "cluster_id": "clu_01JAB2X3C4D5E6F7G8H9J0KMNP",
        "cluster_reason": {
          "rule": "new_cluster",
          "cluster": "clu_01JAB2X3C4D5E6F7G8H9J0KMNP",
          "terms": [
            "bridge",
            "harbour",
            "inspection"
          ],
          "entities": [
            "Harbour Bridge"
          ]
        },
        "retrieved_at": "2026-09-24T08:15:00.000Z",
        "first_seen_at": "2026-09-24T08:15:00.000Z",
        "upstream_updated_at": null,
        "removed": null
      }
    },
    {
      "n": 2,
      "perspective_id": null,
      "detached_at": null,
      "item": {
        "id": "nsi_01JAB2Z8Y6X5W4V3T2S1R0QPNM",
        "sources_item": {
          "service": "sources",
          "type": "item",
          "id": "itm_01JAB2Y9K9M1N2P3Q4R5S6T7VW",
          "revision": 1
        },
        "source_key": "coastal-wire",
        "headline": "Bridge inspection to take two weeks, council says",
        "url": "https://coastalwire.example/news/bridge-inspection",
        "outlet": "Coastal Wire",
        "authors": [
          "M. Okafor"
        ],
        "published_at": "2026-09-24T07:30:00+01:00",
        "summary": null,
        "summary_basis": "terms do not allow a stored summary",
        "license_note": null,
        "terms_note": "Headline and link only",
        "status": "active",
        "duplicate_of": null,
        "dedupe": null,
        "cluster_id": "clu_01JAB2X3C4D5E6F7G8H9J0KMNP",
        "cluster_reason": {
          "rule": "shared_terms",
          "cluster": "clu_01JAB2X3C4D5E6F7G8H9J0KMNP",
          "shared_entities": [
            "Harbour Bridge"
          ],
          "shared_terms": [
            "bridge",
            "inspection"
          ],
          "score": 4,
          "window_hours": 72
        },
        "retrieved_at": "2026-09-24T08:15:00.000Z",
        "first_seen_at": "2026-09-24T08:15:00.000Z",
        "upstream_updated_at": null,
        "removed": null
      }
    }
  ],
  "timeline": [
    {
      "id": "tle_01JAB4T5V6W7X8Y9Z0A1B2C3D4",
      "occurred_on": "2026-09-23",
      "text": "Inspectors report cracks in a bridge support.",
      "source_item_id": "nsi_01JAB2Z7Y6X5W4V3T2S1R0QPNM"
    }
  ],
  "perspectives": [
    {
      "id": "per_01JAB4P5Q6R7S8T9V0W1X2Y3Z4",
      "label": "Council statements",
      "description": null
    }
  ],
  "flags": []
}

Validate

const contracts = require('openvibe-contracts');
contracts.validate('news.story@1', value);   // { valid, errors: [{ path, message }] }

NewsStory news.story@1

Fields

Examples

Validate

NewsStory `news.story@1`