Skip to content

Glossary

API key. A secret starting alm_live_ that identifies a workspace and carries scopes. Sent as Authorization: Bearer …. Shown once when made. See Authentication.

Article. One piece of reporting from one outlet, read and tagged with sectors and states. The API calls the list of articles signals (GET /signals).

Attribution. How the reporting attributes a role to a party, strongest first: official_statement, claim_by_actor (the party’s own claim), reported, alleged_by_opponent, speculation. A finding that rests on speculation is weaker than one that rests on official statements.

Bloc finding. How coverage of a story’s proposition divides into camps of outlets, with an evidence grade from A (a clear split) to D (no split) and a coordination likelihood (low, moderate, elevated). On GET /stories/{id} as bloc_finding.

Brier score. How good a set of probability forecasts has been: the mean squared gap between the probability given and what happened (1 or 0). 0 is perfect; 0.25 is what always saying 50% earns. On GET /forecasts as track_record.brier_score.

Coordination finding. A pattern that joins several stories: the same party named in each (same_actor), a shared theme and sector (same_theme), or one action described as called or multi-site (called_action). It names who the reporting says runs it (the orchestrator), the outlets carrying it hardest (the mediums) and its target. Part of Veritos. See GET /coordination.

Cursor. An opaque string that marks a place in a list, returned as next_cursor and passed back as cursor. See Pagination.

Direction. How an outlook compares with the reading before it: rising, steady, easing, or new for a first reading.

Driver. A story an outlook names as moving the sector, with a line on why. On GET /outlooks as drivers.

Event type. What kind of event a story reports (a protest, an attack, a policy decision and so on). An open list: new values can appear (Versioning).

Evidence grade. How much the reporting supports a coordination finding: A strongest, B a pattern across stories or places, C an early pattern to watch. A grade says how strongly the reporting supports a pattern, not that anyone coordinated it.

Forecast. A dated yes-or-no question with a probability, a deadline (resolves_by) and a rule for what counts as yes, written before the outcome is known. open until its deadline, then awaiting a verdict, then resolved. Made by Nostradamus.

Independent outlets. How many outlets carry a story on their own reporting. Syndicated wire copy, and copy credited to a news agency, count once, so a story run by fifty papers from one agency wire counts as one voice. The API’s order=voices sorts by it.

Lift. For a medium in a coordination finding: its share of the finding’s articles against its usual share of protest, strike and attack coverage. Above 1, the outlet carries this pattern more than usual. Null when there is too little history to compare.

MCP (Model Context Protocol). An open protocol that lets AI assistants call tools. Alethman’s MCP server exposes the API as eleven read-only tools. See The MCP server.

Narrative intelligence. What Alethman does: reads the news across outlets and languages, groups it into stories, and reports which narratives are moving, how risky they are, who the reporting says is behind them and how coverage divides.

Nostradamus. Alethman’s view that joins a client’s own records from separate systems into the organisations, facilities and items they share. Not offered over the API yet.

Orchestrator. The party a coordination finding’s reporting names as running it, or none when no one is named. Named from the reporting, never inferred.

Outlook. The current reading of one sector: a risk score and level, its direction, a verdict paragraph and the stories driving it. Refreshed several times a day. See GET /outlooks.

Party. An organisation, movement, political party, state agency, armed group, union, company, public official or public figure named by the reporting, in a role: organiser, claimant, blamed, accused, target or responder.

Polity. Alethman’s view of public spending and procurement. Not offered over the API yet.

Proposition. The claim at the centre of a story’s coverage, as one sentence outlets can agree or disagree with. Bloc findings are read against it.

Quiet. An outlook with too little reporting in its window to read. Its score, level, direction and verdict are null.

Report. A compiled document for the workspace, scheduled (scheduled) or asked for (on_demand), covering a period, in Markdown or as structured JSON. See GET /reports.

Risk level. The band a risk score falls in: low, guarded, elevated, high, severe. Use it as the headline. The band edges are not published and may be tuned.

Risk score. 0 to 100: how much disruption the reporting describes, read by Alethman. Higher is more severe, and scores compare across sectors and over time. A story says in words what its reading rests on (risk_basis).

Scope (of a key). A permission a key carries: signals:read, intel:read, reports:read, sources:read, sources:write. See Authentication.

Scope (of a workspace). The sectors and states a workspace follows. Every list in the API stays inside it. See Countries and scopes.

Sector. One of nineteen areas a workspace can follow, such as energy_power or public_order_unrest. The full list is on Countries and scopes.

Source. A feed of your own (RSS or Atom) your workspace follows, beside the outlets Alethman reads for everyone. See Follow your own feed.

State. One of India’s 36 states and union territories, by slug (maharashtra, jammu-and-kashmir). The full list is on Countries and scopes.

Story. Articles from many outlets grouped as reporting on one event or development, with a headline (label), its places, its trajectory and Alethman’s reading of it. See GET /stories.

Trajectory. Where a story’s coverage is heading: new, rising, steady or decaying.

Veritos. Alethman’s verification view: how claims and campaigns move through coverage. Its coordination findings are on GET /coordination; its claim checks are not offered over the API yet.

Workspace. One organisation’s Alethman: its sectors and states, its people, its keys, its reports and alerts. Every key belongs to one. See GET /workspace.