Provenance and AI disclosure

Production is described by what actually happened at each stage, not by a single label. The API is deliberately more transparent than the law requires: a subscriber sees the machine stages, the human control, the source trail and the verification level, and decides for themselves.

Production method

Value	Meaning
human	Written and edited by a person.
ai_assisted	A person authored or supplied the material; machine help in parts of the process.
ai_generated_reviewed	Machine-drafted, reviewed by a person before release.
automated	Machine pipeline end to end, under editorial rules, without per-item human review.

Stages

Alongside the method, each item lists which stages involved a machine: discovery, source collection, cross-source comparison, translation, drafting, headline, fact-checking, editing, image selection, classification. "AI touched this" is not a useful statement; "the draft was machine-written and a person edited it" is.

Disclosure rule

Art. 50(4) of the EU AI Act applies to text published to inform the public on matters of public interest, and lifts where there was meaningful human review and someone carries editorial responsibility. We encode exactly that:

disclosure_required =
      public_interest_subject
      AND NOT (human_reviewed AND editorial_control)

So a sports round-up does not carry a public notice, a machine-written piece on health policy does, and the same piece stops carrying it once a person has reviewed it and the review is recorded on the item. Editorial responsibility for everything on this wire rests with Haydamax OÜ.

Verification

Each item states how well the facts are stood up: unverified, single_source, multi_source, official_source, verified — with the count of independent confirmations and the full source list, each entry marked primary, supporting, confirming or quoted.

Corrections and withdrawals

A correction is an item in its own right, linked to what it corrects, and it is pushed through the same channels that delivered the original — webhook, email, feed. A withdrawal sets pubstatus: canceled, which is the ninjs way of saying "do not use this".