{"openapi":"3.1.0","info":{"title":"DGW API","description":"Public read-only subset of the DGW decision-graph API: every listed path is GET-only and answers without authentication (per-IP rate budget); an X-API-Key raises the budget. Writes, auth and account endpoints live in the full document at /openapi.json.","version":"0.1.0"},"paths":{"/v1/actors":{"get":{"tags":["actors"],"summary":"List actors","operationId":"public_list_actors","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":20,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":512},{"type":"null"}],"description":"Opaque cursor from `next_cursor`; ignores `offset`","title":"Cursor"},"description":"Opaque cursor from `next_cursor`; ignores `offset`"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Case-insensitive title/name search","title":"Q"},"description":"Case-insensitive title/name search"},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"person, organization, state, ...","title":"Kind"},"description":"person, organization, state, ..."},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[A-Za-z]{2}$"},{"type":"null"}],"description":"ISO 3166-1 alpha-2","title":"Country Code"},"description":"ISO 3166-1 alpha-2"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageOut_ActorListItemOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/actors/{actor_id}":{"get":{"tags":["actors"],"summary":"Get one actor","operationId":"public_get_actor","parameters":[{"name":"actor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Actor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorCardOut"}}}},"404":{"description":"Actor not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/actors/{actor_id}/claims":{"get":{"tags":["actors"],"summary":"List claims attributed to an actor","operationId":"public_list_actor_claims","parameters":[{"name":"actor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Actor Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":20,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageOut_ClaimItemOut_"}}}},"404":{"description":"Actor not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/actors/{actor_id}/decisions":{"get":{"tags":["actors"],"summary":"List decisions involving an actor","operationId":"public_list_actor_decisions","parameters":[{"name":"actor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Actor Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":24,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageOut_ActorItemOut_"}}}},"404":{"description":"Actor not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/actors/{actor_id}/events":{"get":{"tags":["actors"],"summary":"List events involving an actor","operationId":"public_list_actor_events","parameters":[{"name":"actor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Actor Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":24,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageOut_ActorItemOut_"}}}},"404":{"description":"Actor not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/actors/{actor_id}/relations":{"get":{"tags":["actors"],"summary":"Typed relation edges of an actor","description":"Active relation edges, both directions, weight-first.\n\nThe dossier Network tab groups these by relation type; direction is\nrelative to the profile subject (outgoing = the subject acts on the\ncounterparty, incoming = the reverse).","operationId":"public_list_actor_relations","parameters":[{"name":"actor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Actor Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":50,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageOut_ActorRelationOut_"}}}},"404":{"description":"Actor not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/actors/{actor_id}/similar":{"get":{"tags":["actors"],"summary":"Actors similar to this one","description":"Nearest neighbours by name, kind and country.  Useful mainly for name variants of the same person or organisation.","operationId":"public_similar_actors","parameters":[{"name":"actor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Actor Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"Rows to return (1-20)","default":5,"title":"Limit"},"description":"Rows to return (1-20)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":0,"description":"Rows to skip (0-200)","default":0,"title":"Offset"},"description":"Rows to skip (0-200)"},{"name":"min_score","in":"query","required":false,"schema":{"type":"number","maximum":1,"minimum":0,"description":"Cosine similarity floor (0-1)","default":0.45,"title":"Min Score"},"description":"Cosine similarity floor (0-1)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SimilarItemOut"},"title":"Response Public Similar Actors"}}}},"404":{"description":"Actor not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/calendar":{"get":{"tags":["calendar"],"summary":"List calendar entries","description":"One dated slot per row. `axis=world` explodes each entity by date role (decision, announcement, effective, deadline, start, end); `axis=known` returns one row per entity dated by first-seen. The two clocks are never mixed.","operationId":"public_list_calendar","parameters":[{"name":"axis","in":"query","required":false,"schema":{"enum":["world","known"],"type":"string","description":"Time axis: world dates or first-seen dates","default":"world","title":"Axis"},"description":"Time axis: world dates or first-seen dates"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive start date (default: today - 30d)","title":"From"},"description":"Inclusive start date (default: today - 30d)"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive end date (default: today + 90d)","title":"To"},"description":"Inclusive end date (default: today + 90d)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Page size (1-500)","default":100,"title":"Limit"},"description":"Page size (1-500)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"},{"name":"order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"asc","title":"Order"}},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":16,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"decision or event","title":"Kind"},"description":"decision or event"},{"name":"date_kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"decision_date, effective_date, deadline, ...","title":"Date Kind"},"description":"decision_date, effective_date, deadline, ..."},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Decision or event status","title":"Status"},"description":"Decision or event status"},{"name":"type_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Decision type code or event type","title":"Type Code"},"description":"Decision type code or event type"},{"name":"actor_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Lead decider (decisions) or any actor (events)","title":"Actor Id"},"description":"Lead decider (decisions) or any actor (events)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[A-Za-z]{2}$"},{"type":"null"}],"description":"ISO 3166-1 alpha-2","title":"Country Code"},"description":"ISO 3166-1 alpha-2"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Case-insensitive title/name search","title":"Q"},"description":"Case-insensitive title/name search"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageOut_CalendarEntryOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/calendar/coverage":{"get":{"tags":["calendar"],"summary":"Calendar date coverage","description":"How many decisions and events can be placed on the world axis, how many are month-only, and the range of first-seen dates.","operationId":"public_get_calendar_coverage","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalendarCoverageOut"}}}}}}},"/v1/claims":{"get":{"tags":["claims"],"summary":"Latest public claims, typed and attributed","description":"The claims wire: latest first, the row carries the normalized\nstatement and the claimant (dossier link); the verbatim quote waits in\nthe detail read. A ``claim_type`` that passes validation but matches\nnothing simply answers empty — filters never error the wire.","operationId":"public_list_claims","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":20,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Rows to skip","default":0,"title":"Offset"},"description":"Rows to skip"},{"name":"claim_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"statement, allegation, prediction, commitment, denial, ...","title":"Claim Type"},"description":"statement, allegation, prediction, commitment, denial, ..."},{"name":"claimant_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Restrict the wire to one claimant actor","title":"Claimant Id"},"description":"Restrict the wire to one claimant actor"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimPageOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}":{"get":{"tags":["claims"],"summary":"One claim with its verbatim quote and source citation","description":"Citable record: normalized statement, verbatim original-language\nquote, publisher, source URL and dates. Unknown ids are 404 — never\n500, never a leak.","operationId":"public_get_claim","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimDetailOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/{claim_id}/similar":{"get":{"tags":["claims"],"summary":"Nearest-neighbor claims by embedding similarity","description":"Related claims for the detail page's ``Related`` read: cosine\nneighbors over precomputed pgvector embeddings — similarity only, no\ninference at request time. Unknown ids stay 404; a claim without an\nembedding answers empty, never errors the page.","operationId":"public_similar_claims","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Claim Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"How many neighbors (1-20)","default":6,"title":"Limit"},"description":"How many neighbors (1-20)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimSimilarPageOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/types":{"get":{"tags":["claims"],"summary":"Type facet for the claims wire","description":"Live per-type counts so the wire's filter chips carry real numbers,\nnot a baked-in list. ``without_type`` is the honest untyped bucket.","operationId":"public_claim_type_facets","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimTypeFacetsOut"}}}}}}},"/v1/comments/counts":{"get":{"tags":["comments"],"summary":"Public discussion sizes for a page of forecast or claim rows","description":"One round-trip per visible page: how many comments each row carries.\n\nOnly the public conversation counts (visible, not deleted); targets\nwith nothing to join are absent from the map — the row renders no\nchip. Read-only, same per-IP public budget as the thread read.","operationId":"public_comment_counts","parameters":[{"name":"target_type","in":"query","required":true,"schema":{"enum":["forecast","claim"],"type":"string","title":"Target Type"}},{"name":"target_ids","in":"query","required":true,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":50,"description":"Target ids (repeat the param), 1-50 per call","title":"Target Ids"},"description":"Target ids (repeat the param), 1-50 per call"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentCountsOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/comments/{target_type}/{target_id}":{"get":{"tags":["comments"],"summary":"Discussion thread on one forecast or claim","description":"The thread below one object, public read. Pending rows appear only\nto their author (the optional token decides who that is); deleted rows\nkeep their place with a null body — the renderer's \"[removed]\"\ntombstone. ``sort=top`` ranks activity over age decay.","operationId":"public_list_comments","parameters":[{"name":"target_type","in":"path","required":true,"schema":{"enum":["forecast","claim"],"type":"string","title":"Target Type"}},{"name":"target_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Target Id"}},{"name":"sort","in":"query","required":false,"schema":{"enum":["top","new","old"],"type":"string","default":"top","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size (1-100)","default":50,"title":"Limit"},"description":"Page size (1-100)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Rows to skip","default":0,"title":"Offset"},"description":"Rows to skip"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentPageOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/decisions":{"get":{"tags":["decisions"],"summary":"List decisions","operationId":"public_list_decisions","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":20,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":512},{"type":"null"}],"description":"Opaque cursor from `next_cursor`; ignores `offset`","title":"Cursor"},"description":"Opaque cursor from `next_cursor`; ignores `offset`"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Case-insensitive title/name search","title":"Q"},"description":"Case-insensitive title/name search"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Decision status","title":"Status"},"description":"Decision status"},{"name":"type_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Closed decision type code","title":"Type Code"},"description":"Closed decision type code"},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Domain slug to restrict the list to","title":"Domain"},"description":"Domain slug to restrict the list to"},{"name":"place_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Decisions made about this place","title":"Place Id"},"description":"Decisions made about this place"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageOut_DecisionListItemOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/decisions/{decision_id}":{"get":{"tags":["decisions"],"summary":"Get one decision","operationId":"public_get_decision","parameters":[{"name":"decision_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Decision Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionCardOut"}}}},"404":{"description":"Decision not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/decisions/{decision_id}/similar":{"get":{"tags":["decisions"],"summary":"Decisions similar to this one","description":"Nearest neighbours in the embedding index, same kind only. The source vector is read from the index; nothing is embedded per call.","operationId":"public_similar_decisions","parameters":[{"name":"decision_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Decision Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"Rows to return (1-20)","default":5,"title":"Limit"},"description":"Rows to return (1-20)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":0,"description":"Rows to skip (0-200)","default":0,"title":"Offset"},"description":"Rows to skip (0-200)"},{"name":"min_score","in":"query","required":false,"schema":{"type":"number","maximum":1,"minimum":0,"description":"Cosine similarity floor (0-1)","default":0.45,"title":"Min Score"},"description":"Cosine similarity floor (0-1)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SimilarItemOut"},"title":"Response Public Similar Decisions"}}}},"404":{"description":"Decision not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/digest":{"get":{"tags":["digest"],"summary":"Today's ranked story cards for the feed band","description":"The day's shape (card specs/daily_digest.md): up to six stories\nranked by the day's member count, each with the pre-written headline\nthe discovery pass composed, the three newest member rows and the top\nactor chips. Read-only, anonymous, parameter-free — one bucket per\nday. The honest empty state is ``stories: []`` with ``updated_at:\nnull``.","operationId":"public_digest_today","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DigestOut"}}}}}}},"/v1/domains":{"get":{"tags":["domains"],"summary":"List decision domains","description":"The closed taxonomy decisions are filed under. `decision_count`, `actor_count` and `evidence_count` are distinct rows in the graph, not scores: a domain is sized by what is actually attached to it.","operationId":"public_list_domains","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DomainListItemOut"},"type":"array","title":"Response Public List Domains"}}}}}}},"/v1/domains/{slug}":{"get":{"tags":["domains"],"summary":"Get one decision domain","operationId":"public_get_domain","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9_]+$","description":"Domain slug","title":"Slug"},"description":"Domain slug"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainCardOut"}}}},"404":{"description":"Domain not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/entities/{kind}/{id}/trajectories":{"get":{"tags":["trajectories"],"summary":"Trajectories anchored on this entity","description":"Arcs whose resolved target is this entity, or which count it as a source. Newest first. `kind` is one of `actor`, `event`, `decision`, `situation`. No vectors or engine internals are exposed; read-only.","operationId":"public_list_entity_trajectories","parameters":[{"name":"kind","in":"path","required":true,"schema":{"enum":["actor","event","decision","situation"],"type":"string","title":"Kind"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":20,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"enum":["active","materialized","expired_no","expired_unobserved","superseded"],"type":"string"},{"type":"null"}],"description":"Narrow to one arc status; default is all","title":"Status"},"description":"Narrow to one arc status; default is all"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TrajectoryArcOut"},"title":"Response Public List Entity Trajectories"}}}},"404":{"description":"Entity not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/entrants":{"get":{"tags":["entrants"],"summary":"Fresh actors on the wire (first seen in the window)","description":"The window's fresh entrants (card specs/new_on_wire.md): actors\nwhose first wire appearance is inside the window, prominence-ranked\n(mention-count x type-weight x mild recency, per the pinned pass-2\nspec), each row carrying the first record that put the actor on the\nwire — the why-line inputs. Read-only, anonymous; ``total`` is the\nwhole-window count. The honest empty state is ``items: []`` with\n``total: 0``.","operationId":"public_actors_new","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"description":"First-seen window (1-30 days)","default":7,"title":"Days"},"description":"First-seen window (1-30 days)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":20,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Rows to skip","default":0,"title":"Offset"},"description":"Rows to skip"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorsNewOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/events":{"get":{"tags":["events"],"summary":"List events","operationId":"public_list_events","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":20,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":512},{"type":"null"}],"description":"Opaque cursor from `next_cursor`; ignores `offset`","title":"Cursor"},"description":"Opaque cursor from `next_cursor`; ignores `offset`"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Case-insensitive title/name search","title":"Q"},"description":"Case-insensitive title/name search"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Event status","title":"Status"},"description":"Event status"},{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Event type","title":"Event Type"},"description":"Event type"},{"name":"place_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Events that happened at this place","title":"Place Id"},"description":"Events that happened at this place"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageOut_EventListItemOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/events/{event_id}":{"get":{"tags":["events"],"summary":"Get one event","operationId":"public_get_event","parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Event Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventCardOut"}}}},"404":{"description":"Event not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/events/{event_id}/similar":{"get":{"tags":["events"],"summary":"Events similar to this one","description":"Nearest neighbours in the embedding index, same kind only.","operationId":"public_similar_events","parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Event Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"Rows to return (1-20)","default":5,"title":"Limit"},"description":"Rows to return (1-20)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":0,"description":"Rows to skip (0-200)","default":0,"title":"Offset"},"description":"Rows to skip (0-200)"},{"name":"min_score","in":"query","required":false,"schema":{"type":"number","maximum":1,"minimum":0,"description":"Cosine similarity floor (0-1)","default":0.45,"title":"Min Score"},"description":"Cosine similarity floor (0-1)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SimilarItemOut"},"title":"Response Public Similar Events"}}}},"404":{"description":"Event not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/facets/actors/country":{"get":{"tags":["facets"],"summary":"Country facet for the actors browser","description":"Per-country actor counts, composed with ``kind`` only.\n\nNever composed with a country filter of its own — a facet that fed its\nown filter would zero itself out. The NULL bucket is reported as\n``without_country``; ``countries`` carries only named codes, count\ndescending. Read-only and public: the browser's filter chips re-rank\nfrom these live counts instead of a static list.","operationId":"public_actor_country_facets","parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"person, organization, state, ... — the same kind the actors list takes","title":"Kind"},"description":"person, organization, state, ... — the same kind the actors list takes"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorCountryFacetsOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/facets/forecast-track":{"get":{"tags":["facets"],"summary":"Forecast track record (platform)","description":"The platform's forecast track record: scored points, resolved\nforecasts, mean Brier and log loss, calibration bins — with the\ncoin-flip baseline attached so a reader can place the numbers without\nknowing what a Brier score is. No scored points yet answers an\nhonest zero-state, never an error.","operationId":"public_forecast_track_summary","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForecastTrackSummaryOut"}}}}}}},"/v1/facets/forecast-track/{forecast_id}":{"get":{"tags":["facets"],"summary":"Track record for one forecast","description":"One forecast's scored points and Brier/log-loss stats. A forecast\nthe scoring pipeline has never scored answers 404 — the track record\nonly exists where the pipeline produced one.","operationId":"public_forecast_track_detail","parameters":[{"name":"forecast_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Forecast Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForecastTrackOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/facets/forecast-track/points":{"get":{"tags":["facets"],"summary":"Scored checks for the track-record plot","description":"The raw record one dot at a time: every scored check the pipeline\nproduced, newest first — probability, Brier, log loss per check. A\nliteral path sibling of the ``{forecast_id}`` detail route; declared\nBEFORE it because Starlette matches routes in registration order.","operationId":"public_forecast_track_points","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Newest checks first (1-200)","default":100,"title":"Limit"},"description":"Newest checks first (1-200)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForecastTrackPointsOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/feed":{"get":{"tags":["feed"],"summary":"List the mixed feed","description":"Decisions, events and current situations as one stream, newest recorded first, with a cursor. `kind` narrows the stream to one card type; the kind-specific card fields travel in `extras`.","operationId":"public_list_feed","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":20,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":512},{"type":"null"}],"description":"Opaque cursor from `next_cursor`; ignores `offset`","title":"Cursor"},"description":"Opaque cursor from `next_cursor`; ignores `offset`"},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"enum":["decision","event","situation"],"type":"string"},{"type":"null"}],"description":"Narrow the stream to one card type","title":"Kind"},"description":"Narrow the stream to one card type"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Case-insensitive title/name search","title":"Q"},"description":"Case-insensitive title/name search"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Card status","title":"Status"},"description":"Card status"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageOut_FeedItemOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/forecasts":{"get":{"tags":["forecasts"],"summary":"List forecasts","description":"The forecast board: one question per row with the latest probability and the information cutoff it was set at. `status` defaults to `open`; `status=all` includes resolved and closed history. `order=deadline` sorts by the soonest deadline, `order=recent` by the newest row.","operationId":"public_list_forecasts","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":20,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":512},{"type":"null"}],"description":"Opaque cursor from `next_cursor`; ignores `offset`","title":"Cursor"},"description":"Opaque cursor from `next_cursor`; ignores `offset`"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Case-insensitive title/name search","title":"Q"},"description":"Case-insensitive title/name search"},{"name":"status","in":"query","required":false,"schema":{"enum":["open","resolved","expired","invalidated","superseded","all"],"type":"string","description":"Forecast status; `all` includes history","default":"open","title":"Status"},"description":"Forecast status; `all` includes history"},{"name":"target_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"decision, event, situation, ...","title":"Target Type"},"description":"decision, event, situation, ..."},{"name":"target_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Only forecasts about this decision/event/situation","title":"Target Id"},"description":"Only forecasts about this decision/event/situation"},{"name":"deadline_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive earliest deadline date","title":"Deadline From"},"description":"Inclusive earliest deadline date"},{"name":"deadline_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Inclusive latest deadline date","title":"Deadline To"},"description":"Inclusive latest deadline date"},{"name":"order","in":"query","required":false,"schema":{"enum":["deadline","recent"],"type":"string","description":"`deadline` (soonest first) or `recent` (newest first)","default":"deadline","title":"Order"},"description":"`deadline` (soonest first) or `recent` (newest first)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForecastPageOut_ForecastListItemOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/forecasts/score":{"get":{"tags":["forecasts"],"summary":"Score the agent-v0 forecasts","description":"The measured score of the nowcast lane's agent-v0 forecasts over the resolved deposit seam: Brier, log-loss and the reliability table, computed live at the read time (no lookahead, skill withheld). This is a measurement, never a quality claim.","operationId":"public_get_forecast_score","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForecastScoreOut"}}}}}}},"/v1/forecasts/{forecast_id}":{"get":{"tags":["forecasts"],"summary":"Get one forecast","description":"The question, its latest probability, its immediate branches and — when resolved — the outcome with the quote and page that proved it.","operationId":"public_get_forecast","parameters":[{"name":"forecast_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Forecast Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForecastCardOut"}}}},"404":{"description":"Forecast not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/forecasts/{forecast_id}/points":{"get":{"tags":["forecasts"],"summary":"List the probability series","description":"Append-only history of probability points. A check that changed nothing still writes a point with the same probability and `change_reason=checked_no_change`.","operationId":"public_list_forecast_points","parameters":[{"name":"forecast_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Forecast Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Point page size (1-200)","default":50,"title":"Limit"},"description":"Point page size (1-200)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"},{"name":"order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Order"}},{"name":"bucket","in":"query","required":false,"schema":{"enum":["none","day","week"],"type":"string","description":"Collapse to the last point per day/week; `none` keeps raw checks","default":"none","title":"Bucket"},"description":"Collapse to the last point per day/week; `none` keeps raw checks"},{"name":"changes_only","in":"query","required":false,"schema":{"type":"boolean","description":"Only points whose probability moved or whose reason is not a routine check","default":false,"title":"Changes Only"},"description":"Only points whose probability moved or whose reason is not a routine check"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForecastPageOut_ForecastPointOut_"}}}},"404":{"description":"Forecast not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/forecasts/{forecast_id}/tree":{"get":{"tags":["forecasts"],"summary":"Get a forecast and its branches","description":"Depth-first by level. `depth` is 0 for the root, 1 for its direct branches, and so on; the depth is capped at 10.","operationId":"public_get_forecast_tree","parameters":[{"name":"forecast_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Forecast Id"}},{"name":"max_depth","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":0,"description":"Levels below the root","default":3,"title":"Max Depth"},"description":"Levels below the root"},{"name":"from_top","in":"query","required":false,"schema":{"type":"boolean","description":"Root the answer at the topmost ancestor, so a branch page still shows the whole tree; depth is then relative to that root","default":false,"title":"From Top"},"description":"Root the answer at the topmost ancestor, so a branch page still shows the whole tree; depth is then relative to that root"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForecastTreeOut"}}}},"404":{"description":"Forecast not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/places":{"get":{"tags":["places"],"summary":"List places","description":"The canonical place directory, mass-first: every place, zero-count ones included, ordered by linked events + decisions. Counts are distinct rows pointing at the place, the same sizing as the actor directory.","operationId":"public_list_places","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":50,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Case-insensitive title/name search","title":"Q"},"description":"Case-insensitive title/name search"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageOut_PlaceListItemOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/places/{place_id}":{"get":{"tags":["places"],"summary":"Get one place","operationId":"public_get_place","parameters":[{"name":"place_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Place Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceCardOut"}}}},"404":{"description":"Place not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search":{"get":{"tags":["search"],"summary":"Search decisions, events, situations, forecasts and actors","description":"One ranked pass across every searchable kind. `items` are grouped by `kind` in response order; `totals` is the full match count per kind before the per-kind cut, so a UI can label a group without a second request. Situations match their name and summary; forecasts match their question.","operationId":"public_search","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]*$","description":"Search term (2-100 characters)","title":"Q"},"description":"Search term (2-100 characters)"},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"enum":["decision","event","actor","situation","forecast"],"type":"string"},{"type":"null"}],"description":"Restrict the scan to one kind","title":"Kind"},"description":"Restrict the scan to one kind"},{"name":"per_kind","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"Rows per kind (1-20)","default":5,"title":"Per Kind"},"description":"Rows per kind (1-20)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/situations":{"get":{"tags":["situations"],"summary":"List situations","description":"Situations are discovered clusters of decisions and events that belong to one story. `member_count` counts the current `part_of` members; a retired situation is not listed.","operationId":"public_list_situations","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":20,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Case-insensitive title/name search","title":"Q"},"description":"Case-insensitive title/name search"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Situation status","title":"Status"},"description":"Situation status"},{"name":"situation_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"description":"Situation type (other, construction, market_shift, ...)","title":"Situation Type"},"description":"Situation type (other, construction, market_shift, ...)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageOut_SituationListItemOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/situations/{situation_id}":{"get":{"tags":["situations"],"summary":"Get one situation","description":"The situation, its actors with their role in it, and its current members as links to the decision or event cards.","operationId":"public_get_situation","parameters":[{"name":"situation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Situation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SituationCardOut"}}}},"404":{"description":"Situation not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stats":{"get":{"tags":["system"],"summary":"Graph totals","operationId":"public_get_stats","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsOut"}}}}}}},"/v1/trajectories":{"get":{"tags":["trajectories"],"summary":"Page the trajectory ledger as frontend cards","description":"Arcs with their entity links rendered in one face: resolved target, anchoring sources, materialization provenance. Default view is `status=active`, newest first; `sort=deadline` shows what resolves next. `entity_id` keeps arcs that touch one entity (target or source) — 404 if the entity itself is unknown. Read-only.","operationId":"public_list_trajectories","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Page size (1-50)","default":20,"title":"Limit"},"description":"Page size (1-50)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":0,"description":"Rows to skip (0-5000)","default":0,"title":"Offset"},"description":"Rows to skip (0-5000)"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(active|materialized|dormant|retired_parent_dead|expired_no|expired_unobserved|superseded|all)$"},{"type":"null"}],"description":"One arc status, or `all`; default is `active`","default":"active","title":"Status"},"description":"One arc status, or `all`; default is `active`"},{"name":"target_kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"actor | event | decision | situation | market_state | domain","title":"Target Kind"},"description":"actor | event | decision | situation | market_state | domain"},{"name":"horizon_bucket","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"d1 | d7 | d30 | d90 | d365","title":"Horizon Bucket"},"description":"d1 | d7 | d30 | d90 | d365"},{"name":"direction","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":1,"minimum":-1},{"type":"null"}],"title":"Direction"}},{"name":"entity_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Entity Id"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Q"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(recent|deadline|probability)$","default":"recent","title":"Sort"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrajectoryListOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trajectories/stats":{"get":{"tags":["trajectories"],"summary":"Counters for the trajectories page header","description":"Arc counts by status, target kind and horizon bucket, plus the median lead time of materialized arcs — the calibration social proof. Read-only.","operationId":"public_trajectory_stats","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrajectoryStatsOut"}}}}}}},"/v1/trajectories/{trajectory_id}":{"get":{"tags":["trajectories"],"summary":"One trajectory's detail face: the arc, its chain, its status trail","description":"The detail card for one arc. `chain.parent` / `chain.children` carry the conditional chains (a child's `p` is CONDITIONAL — P(child | parent true); multiply by the parent's p for the absolute number). `history` is the lifecycle proof: resolution flips, chain wakes and cascades, oldest first. Read-only.","operationId":"public_get_trajectory","parameters":[{"name":"trajectory_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Trajectory Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrajectoryDetailOut"}}}},"404":{"description":"Entity not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ActorCardOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"canonical_name":{"type":"string","title":"Canonical Name"},"kind":{"type":"string","title":"Kind"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"decision_count":{"type":"integer","title":"Decision Count","default":0},"event_count":{"type":"integer","title":"Event Count","default":0},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website Url","description":"Official website of the actor, when one is recorded (00190; org actors are the primary consumers)"},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases"},"decisions":{"items":{"$ref":"#/components/schemas/ActorItemOut"},"type":"array","title":"Decisions"},"events":{"items":{"$ref":"#/components/schemas/ActorItemOut"},"type":"array","title":"Events"}},"type":"object","required":["id","canonical_name","kind"],"title":"ActorCardOut"},"ActorCountryFacetsOut":{"properties":{"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"},"total":{"type":"integer","title":"Total"},"without_country":{"type":"integer","title":"Without Country"},"countries":{"items":{"$ref":"#/components/schemas/CountryCountOut"},"type":"array","title":"Countries"}},"type":"object","required":["total","without_country","countries"],"title":"ActorCountryFacetsOut","description":"Country facet for the actors browser, composed with `kind` only.\n\n`without_country` is the honest sparse-coverage bucket; `total` is the\nkind-filtered actor count, with and without a country alike."},"ActorItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"status":{"type":"string","title":"Status"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"}},"type":"object","required":["id","title","status"],"title":"ActorItemOut"},"ActorListItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"canonical_name":{"type":"string","title":"Canonical Name"},"kind":{"type":"string","title":"Kind"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"decision_count":{"type":"integer","title":"Decision Count","default":0},"event_count":{"type":"integer","title":"Event Count","default":0},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website Url","description":"Official website of the actor, when one is recorded (00190; org actors are the primary consumers)"}},"type":"object","required":["id","canonical_name","kind"],"title":"ActorListItemOut"},"ActorNewOut":{"properties":{"actor_id":{"type":"string","format":"uuid","title":"Actor Id"},"name":{"type":"string","title":"Name"},"kind":{"type":"string","title":"Kind"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"first_seen":{"type":"string","format":"date-time","title":"First Seen"},"mentions":{"type":"integer","title":"Mentions"},"first_kind":{"type":"string","title":"First Kind"},"first_record_id":{"type":"string","format":"uuid","title":"First Record Id"},"first_title":{"type":"string","title":"First Title"}},"type":"object","required":["actor_id","name","kind","first_seen","mentions","first_kind","first_record_id","first_title"],"title":"ActorNewOut","description":"One fresh-entrant row (card specs/new_on_wire.md, pinned pass-2\nspec): the actor's identity, its first-seen stamp and lifetime\nmentions, and the first record that put it on the wire — the row's\nwhy-line inputs. `first_kind` is `event` (appeared in one) or `claim`\n(issued one)."},"ActorRefOut":{"properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Id","description":"Actor registry id, when the mention resolved to an entity"},"name":{"type":"string","title":"Name"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"}},"type":"object","required":["name"],"title":"ActorRefOut"},"ActorRelationOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"relation_type":{"type":"string","title":"Relation Type"},"direction":{"type":"string","enum":["outgoing","incoming"],"title":"Direction"},"counterparty_id":{"type":"string","format":"uuid","title":"Counterparty Id"},"counterparty_name":{"type":"string","title":"Counterparty Name"},"counterparty_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Counterparty Kind"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"weight":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Weight"},"known_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Known At"}},"type":"object","required":["id","relation_type","direction","counterparty_id","counterparty_name"],"title":"ActorRelationOut","description":"One typed relation edge of an actor dossier (Network tab row).\n\n``direction`` is relative to the dossier subject: outgoing = the subject\nis the source of the edge, incoming = the subject is its target."},"ActorsNewOut":{"properties":{"days":{"type":"integer","title":"Days"},"total":{"type":"integer","title":"Total"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"items":{"items":{"$ref":"#/components/schemas/ActorNewOut"},"type":"array","title":"Items"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["days","total","items","limit","offset","has_more"],"title":"ActorsNewOut","description":"GET /v1/entrants — the window's fresh entrants, prominence-ranked\nper the pinned pass-2 spec (mention-count x type-weight x mild\nrecency, server-side: one sort authority, page-able). `total` is the\nwhole-window count (the \"N new actors this week\" header), `days` the\nserved window; the honest empty state is items: [] with total: 0."},"ApiKeyCreateIn":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":50,"pattern":"^[^\\x00-\\x1f\\x7f]*$"},{"type":"null"}],"title":"Name"},"scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Scopes"}},"type":"object","title":"ApiKeyCreateIn","description":"Body of POST /v1/me/api-keys. Extra keys are ignored.\n\n``owner_id`` in the body is dropped, not read: the owner always comes\nfrom the JWT. ``name`` is optional (the cabinet defaults it);\n``scopes`` omitted means the read-only preset (every public read\nfamily); an unknown scope name fails 422 — fail closed, no wildcards."},"ApiKeyItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"masked_key":{"type":"string","title":"Masked Key"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"},"first_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"First Used At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["id","name","masked_key","scopes","created_at"],"title":"ApiKeyItemOut","description":"One key row as the cabinet list serves it — never the hash, never\nthe raw key (re-reveal is structurally impossible: the raw key exists\nonly in the create response). ``first_used_at`` is the TTFC metric."},"ApiKeyPageOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ApiKeyItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","total"],"title":"ApiKeyPageOut"},"ApiKeyUsageDayOut":{"properties":{"day":{"type":"string","title":"Day"},"requests":{"type":"integer","title":"Requests"},"throttled":{"type":"integer","title":"Throttled"},"errors":{"type":"integer","title":"Errors"}},"type":"object","required":["day","requests","throttled","errors"],"title":"ApiKeyUsageDayOut","description":"One UTC day of keyed traffic: total, throttled (429) and failed\n(5xx) counts. Missing days zero-fill client-side."},"ApiKeyUsageOut":{"properties":{"key_id":{"type":"string","format":"uuid","title":"Key Id"},"name":{"type":"string","title":"Name"},"masked_key":{"type":"string","title":"Masked Key"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"},"first_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"First Used At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"limits":{"additionalProperties":{"type":"integer"},"type":"object","title":"Limits"},"last_minute":{"type":"integer","title":"Last Minute"},"day_requests":{"type":"integer","title":"Day Requests"},"day_throttled":{"type":"integer","title":"Day Throttled"},"total_30d":{"type":"integer","title":"Total 30D"},"throttled_30d":{"type":"integer","title":"Throttled 30D"},"errors_30d":{"type":"integer","title":"Errors 30D"},"by_day":{"items":{"$ref":"#/components/schemas/ApiKeyUsageDayOut"},"type":"array","title":"By Day"},"top_routes":{"items":{"$ref":"#/components/schemas/ApiKeyUsageRouteOut"},"type":"array","title":"Top Routes"}},"type":"object","required":["key_id","name","masked_key","scopes","created_at","limits","last_minute","day_requests","day_throttled","total_30d","throttled_30d","errors_30d","by_day","top_routes"],"title":"ApiKeyUsageOut","description":"GET /v1/me/api-keys/{key_id}/usage — the cabinet drawer's data.\n``last_minute``/``day_requests`` sit against ``limits`` for the meter\nbars (the per-key windows the middleware enforces); 429s are metered\ntoo, so throttling pressure is visible, not silent."},"ApiKeyUsageRouteOut":{"properties":{"route":{"type":"string","title":"Route"},"requests":{"type":"integer","title":"Requests"},"throttled":{"type":"integer","title":"Throttled"}},"type":"object","required":["route","requests","throttled"],"title":"ApiKeyUsageRouteOut"},"BetIn":{"properties":{"forecast_id":{"type":"string","format":"uuid","title":"Forecast Id"},"side":{"type":"string","enum":["yes","no"],"title":"Side"},"stake":{"type":"integer","maximum":100,"minimum":1,"title":"Stake"}},"type":"object","required":["forecast_id","side","stake"],"title":"BetIn","description":"Body of POST /v1/me/bets. Extra keys are ignored; the owner never\ntravels in the body (JWT-only, like every /v1/me write)."},"BetMarketOut":{"properties":{"forecast_id":{"type":"string","format":"uuid","title":"Forecast Id"},"model_probability":{"type":"number","title":"Model Probability"},"crowd_price_yes":{"type":"number","title":"Crowd Price Yes"},"settled_outcome":{"anyOf":[{"type":"string","enum":["yes","no"]},{"type":"null"}],"title":"Settled Outcome"},"forecast_status":{"type":"string","title":"Forecast Status"},"positions":{"items":{"$ref":"#/components/schemas/BetPositionOut"},"type":"array","title":"Positions"}},"type":"object","required":["forecast_id","model_probability","crowd_price_yes","forecast_status","positions"],"title":"BetMarketOut","description":"GET /v1/me/bets/market/{forecast_id} — the bet panel read: the\nmodel line, the crowd price against it, the pool state and the\ncaller's positions on this forecast."},"BetPlacementOut":{"properties":{"side":{"type":"string","enum":["yes","no"],"title":"Side"},"stake":{"type":"integer","title":"Stake"},"shares":{"type":"number","title":"Shares"},"payout_if_win":{"type":"number","title":"Payout If Win"},"price_before":{"type":"number","title":"Price Before"},"price_after":{"type":"number","title":"Price After"}},"type":"object","required":["side","stake","shares","payout_if_win","price_before","price_after"],"title":"BetPlacementOut","description":"The bet receipt: the payout pair and the price impact the panel\nrenders next to the moving line."},"BetPositionOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"forecast_id":{"type":"string","format":"uuid","title":"Forecast Id"},"side":{"type":"string","enum":["yes","no"],"title":"Side"},"shares":{"type":"number","title":"Shares"},"stake":{"type":"integer","title":"Stake"},"created_at":{"type":"string","title":"Created At"},"payout":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Payout"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"forecast_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Forecast Status"},"deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deadline"},"open_ended":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Open Ended"}},"type":"object","required":["id","forecast_id","side","shares","stake","created_at"],"title":"BetPositionOut","description":"One open-or-settled bet row. Shares pay 1 coin each if the side\nwins; ``payout`` is stamped at resolution and the row settles.\n``title`` is the forecast question (history rows carry a label,\nthe follows pattern)."},"BetPositionsOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/BetPositionOut"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"BetPositionsOut","description":"GET /v1/me/bets — the caller's bet rows, newest first."},"CalendarCoverageOut":{"properties":{"decisions_total":{"type":"integer","title":"Decisions Total"},"decisions_dated":{"type":"integer","title":"Decisions Dated"},"decisions_month_only":{"type":"integer","title":"Decisions Month Only"},"events_total":{"type":"integer","title":"Events Total"},"events_dated":{"type":"integer","title":"Events Dated"},"events_scheduled_dated":{"type":"integer","title":"Events Scheduled Dated"},"events_month_only":{"type":"integer","title":"Events Month Only"},"known_from":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Known From"},"known_to":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Known To"}},"type":"object","required":["decisions_total","decisions_dated","decisions_month_only","events_total","events_dated","events_scheduled_dated","events_month_only"],"title":"CalendarCoverageOut"},"CalendarEntryOut":{"properties":{"id":{"type":"string","title":"Id","description":"Stable composite id: axis:kind:entity_id:date_kind"},"axis":{"type":"string","title":"Axis","description":"world (when it happens) or known (when we learned it)"},"kind":{"type":"string","title":"Kind","description":"decision or event"},"entity_id":{"type":"string","format":"uuid","title":"Entity Id"},"date_kind":{"type":"string","title":"Date Kind","description":"Date role on the world axis (decision_date, announcement_date, effective_date, deadline, start_date, end_date) or known"},"date":{"type":"string","format":"date","title":"Date"},"title":{"type":"string","title":"Title"},"type_code":{"type":"string","title":"Type Code"},"status":{"type":"string","title":"Status"},"actor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"instrument":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instrument"},"target_count":{"type":"integer","title":"Target Count","default":0},"known_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Known On"}},"type":"object","required":["id","axis","kind","entity_id","date_kind","date","title","type_code","status"],"title":"CalendarEntryOut"},"CalibrationOut":{"properties":{"bins":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Bins","description":"Reliability bin table"},"bins_requested":{"type":"integer","title":"Bins Requested"},"n":{"type":"integer","title":"N"},"ece":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ece","description":"Expected calibration error; null when withheld"},"ece_min_n":{"type":"integer","title":"Ece Min N","description":"Minimum rows required to publish ECE"},"ece_withheld":{"type":"boolean","title":"Ece Withheld","description":"True when n < ece_min_n"}},"type":"object","required":["bins","bins_requested","n","ece_min_n","ece_withheld"],"title":"CalibrationOut","description":"Reliability table + ECE; `ece` is null below the honesty floor."},"CaptureEventIn":{"properties":{"surface":{"type":"string","enum":["actor_dossier","actor_list","claim_detail","claims_wire","comments_cta","decision_detail","digest","entrants","entrants_home","event_detail","situation_detail","place_detail","forecast_detail","feed_peek","search_palette","login"],"title":"Surface"},"action":{"type":"string","enum":["sign_in_cta","graph_activate","digest_impression","entrants_impression","related_impression","related_click","sign_in_continue"],"title":"Action"},"target_kind":{"type":"string","enum":["actor","place","forecast","search","claim","decision","event","situation","account"],"title":"Target Kind"}},"type":"object","required":["surface","action","target_kind"],"title":"CaptureEventIn","description":"One anonymous capture-funnel beacon (strictly-count).\n\nSTRICTLY-COUNT mode: no owner, no IP, no session id ever crosses the\nwire — the only inputs are three closed enums plus the server clock.\nAnything outside a Literal below dies 422 before any SQL runs; extra\nbody keys are ignored because there is nothing else to assign.\n\nActions: ``sign_in_cta`` = a capture CTA click (the conversion\nmoment); ``graph_activate`` = the dossier Network tab switched to\ngraph view (actor_graph_view adoption instrument, specs/\nactor_graph_view.md v2 item 4 — fired once per dossier visit,\nsame strictly-count contract); ``related_impression`` /\n``related_click`` = the rec-rail telemetry pair (recsys gap #1,\nsupervisor audit 2026-11-15: one impression per RelatedList mount\nthat actually rendered items, one click per row — the rec surface\nbecomes measurable without gaining a single identity byte);\n``digest_impression`` = the today's-stories band mounted with\nstories rendered (card specs/daily_digest.md, human pick #13: the\ndigest funnel gets its denominator — one beacon per DigestBand\nmount, surface ``digest``; the anonymous capture CTA on the band's\nactor chips already speaks ``sign_in_cta`` and gains its surface);\n``sign_in_continue`` = the /login Continue submit — the Auth0\nwall-reach, the funnel's middle metric between ``sign_in_cta``\nintent and registration (surface ``login``, target_kind\n``account``; how many anon readers actually reach the hosted wall);\n``entrants_impression`` = the «New on the wire» section mounted with\nrows rendered — the entrants funnel's denominator, the\n``digest_impression`` precedent applied to the fresh-entrant\ndirectory (surface ``entrants``, target_kind ``actor``: one\nstrictly-count beacon per mount that actually rendered rows, the\nstar-tap numerator's reach base; decision evidence for the pending\nhomepage-placement call).\n\nSurfaces name the UI region the tap happened in. ``entrants`` = the\n«New on the wire» section rows (the fresh-entrant directory, flag\nflipped live 2026-11-13 03:11Z): EntrantsSection mounts WatchStar\non /actors where the route-derived surface would say ``actor_list``,\nso the section passes its own surface explicitly — entrant-row\nstar-taps stop pooling with catalog-row taps in the funnel.\n``entrants_home`` = the SAME section's homepage band (the top-5\nmount behind ``entrants_home``, receiver-first rider 2026-11-16\n05:2xZ: the enum lands before any client sends the value, so there\nis no 422 window; the frontend threads its mounts to this value at\nthe next natural deploy — until then nothing sends it). The two\nmounts must stay separable: the human's homepage-placement call\nand the rollout observation need per-page attribution, one surface\nper region was the 04:1xZ rider's blind spot."},"ClaimDetailOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"claimant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Claimant Id"},"claimant_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claimant Name"},"claimant_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claimant Text"},"claim_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Type"},"verification_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verification Status"},"statement":{"type":"string","title":"Statement"},"stated_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Stated On"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"},"quote":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type"},"published_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Published On"}},"type":"object","required":["id","statement","recorded_at"],"title":"ClaimDetailOut","description":"One claim with its evidence: verbatim original-language quote plus\npublisher, source URL and source dates. Claimant fields link the row to\nthe actor dossier (the watch capture point)."},"ClaimItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"statement":{"type":"string","title":"Statement"},"claim_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Type"},"verification_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verification Status"},"stated_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Stated On"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"},"quote":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher"},"published_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Published On"}},"type":"object","required":["id","statement","recorded_at"],"title":"ClaimItemOut","description":"One claim of an actor dossier, cited (dossier Claims tab row)."},"ClaimPageOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ClaimWireItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"ClaimPageOut"},"ClaimSimilarItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"claimant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Claimant Id"},"claimant_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claimant Name"},"claim_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Type"},"verification_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verification Status"},"statement":{"type":"string","title":"Statement"},"stated_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Stated On"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"},"similarity":{"type":"number","title":"Similarity"}},"type":"object","required":["id","statement","recorded_at","similarity"],"title":"ClaimSimilarItemOut","description":"One neighbor in the similar-claims read: a wire row plus the cosine\nsimilarity to the seed (0-1, higher = closer). Renders exactly like a\nwire row, so the related section reuses the wire's row anatomy."},"ClaimSimilarPageOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ClaimSimilarItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"}},"type":"object","required":["items","total","limit"],"title":"ClaimSimilarPageOut"},"ClaimTypeCountOut":{"properties":{"claim_type":{"type":"string","title":"Claim Type"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["claim_type","count"],"title":"ClaimTypeCountOut"},"ClaimTypeFacetsOut":{"properties":{"total":{"type":"integer","title":"Total"},"without_type":{"type":"integer","title":"Without Type"},"types":{"items":{"$ref":"#/components/schemas/ClaimTypeCountOut"},"type":"array","title":"Types"}},"type":"object","required":["total","without_type","types"],"title":"ClaimTypeFacetsOut","description":"Type facet for the claims wire: live counts for the filter chips."},"ClaimWireItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"claimant_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Claimant Id"},"claimant_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claimant Name"},"claim_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Type"},"verification_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verification Status"},"statement":{"type":"string","title":"Statement"},"stated_on":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Stated On"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"}},"type":"object","required":["id","statement","recorded_at"],"title":"ClaimWireItemOut","description":"One row of the public claims wire. The verbatim quote and the source\ncitation live on the detail read (panel fetch), never on the list —\nPolitiFact's row anatomy: the normalized claim leads, the quote waits."},"CoinCheckInOut":{"properties":{"checked_in":{"type":"boolean","title":"Checked In"},"replay":{"type":"boolean","title":"Replay"},"delta":{"type":"integer","title":"Delta"},"balance":{"type":"integer","title":"Balance"},"streak_current":{"type":"integer","title":"Streak Current"},"streak_credited":{"type":"boolean","title":"Streak Credited"},"streak_lost":{"type":"boolean","title":"Streak Lost"}},"type":"object","required":["checked_in","replay","delta","balance","streak_current","streak_credited","streak_lost"],"title":"CoinCheckInOut","description":"POST /v1/me/coins/check-in — the explicit daily check-in. Same\nsemantics as an award()'s day bonus: ``replay`` (no write) when the\nday is already credited (check-in or capture — never double-paid);\nthe day is credited even when the coin cap capped the coins."},"CoinFreezeOut":{"properties":{"freeze_count":{"type":"integer","title":"Freeze Count"},"balance":{"type":"integer","title":"Balance"}},"type":"object","required":["freeze_count","balance"],"title":"CoinFreezeOut","description":"POST /v1/me/coins/freeze — the inventory count and the balance\nafter the spend."},"CoinGoalIn":{"properties":{"goal_days":{"type":"integer","enum":[7,14,30],"title":"Goal Days"}},"type":"object","required":["goal_days"],"title":"CoinGoalIn","description":"Body of POST /v1/me/coins/goal. Extra keys are ignored; the owner\nnever travels in the body (JWT-only, like every /v1/me write)."},"CoinGoalOut":{"properties":{"goal_days":{"type":"integer","title":"Goal Days"}},"type":"object","required":["goal_days"],"title":"CoinGoalOut"},"CoinQuestOut":{"properties":{"key":{"type":"string","title":"Key"},"amount":{"type":"integer","title":"Amount"},"done":{"type":"boolean","title":"Done"}},"type":"object","required":["key","amount","done"],"title":"CoinQuestOut","description":"One row of the drawer's quest checklist (done = a NEW capture of\nthat kind today)."},"CoinRevivalOut":{"properties":{"revived":{"type":"boolean","title":"Revived"},"current_streak":{"type":"integer","title":"Current Streak"},"balance":{"type":"integer","title":"Balance"}},"type":"object","required":["revived","current_streak","balance"],"title":"CoinRevivalOut","description":"POST /v1/me/coins/revival — the restored streak and the balance\nafter the spend."},"CoinStateOut":{"properties":{"balance":{"type":"integer","title":"Balance"},"current_streak":{"type":"integer","title":"Current Streak"},"longest_streak":{"type":"integer","title":"Longest Streak"},"last_action_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Action Date"},"freeze_count":{"type":"integer","title":"Freeze Count"},"goal_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Goal Days"},"bonus_done":{"type":"boolean","title":"Bonus Done"},"quests":{"items":{"$ref":"#/components/schemas/CoinQuestOut"},"type":"array","title":"Quests"},"daily_cap":{"type":"integer","title":"Daily Cap"}},"type":"object","required":["balance","current_streak","longest_streak","freeze_count","bonus_done","quests","daily_cap"],"title":"CoinStateOut","description":"GET /v1/me/coins — the chip/drawer read. ``daily_cap`` is served\nso the client never hardcodes the economy."},"CoinTransactionOut":{"properties":{"id":{"type":"integer","title":"Id"},"delta":{"type":"integer","title":"Delta"},"reason":{"type":"string","title":"Reason"},"ref":{"type":"string","title":"Ref"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","delta","reason","ref","created_at"],"title":"CoinTransactionOut","description":"One ledger row of the wallet history. ``reason`` is the raw ledger\nreason (the client maps labels); ``id`` + ``ref`` ride along as the\nloop's data contract (feature-lifecycle directive 2026-11-15): the detail\nroute addresses rows by id, and ref names the related entity\n(watch:<actor>, day:<date>, bet_stake:<position>, place_watch:<place>,\nfollow:<forecast>, freeze:<ts>, revive:<day>) the detail screen's\nactions link to."},"CoinTransactionsOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CoinTransactionOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"CoinTransactionsOut","description":"GET /v1/me/coins/transactions — the wallet page's history list,\nnewest first (the comments-page shape: items + total + window)."},"CommentCountsOut":{"properties":{"counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Counts"}},"type":"object","required":["counts"],"title":"CommentCountsOut","description":"Public discussion sizes for a page of list rows.\n\nKeyed by target id; only targets with at least one visible comment\nappear (the row renders no chip when the key is missing)."},"CommentEditIn":{"properties":{"body":{"type":"string","maxLength":2000,"minLength":1,"title":"Body"}},"type":"object","required":["body"],"title":"CommentEditIn","description":"Body of PATCH /v1/me/comments/{id}: the text, nothing else."},"CommentIn":{"properties":{"target_type":{"type":"string","enum":["forecast","claim"],"title":"Target Type"},"target_id":{"type":"string","format":"uuid","title":"Target Id"},"parent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Id"},"body":{"type":"string","maxLength":2000,"minLength":1,"title":"Body"}},"type":"object","required":["target_type","target_id","body"],"title":"CommentIn","description":"Body of POST /v1/me/comments. Extra keys are ignored.\n\n``owner_id`` or ``status`` in the body are dropped, not read: the owner\nalways comes from the JWT and the hold is the server's call. The parent\nmust be a top-level comment on the same target (enforced in the service,\nnot here — the parent row has to be read first)."},"CommentItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"owner_id":{"type":"string","format":"uuid","title":"Owner Id"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"target_type":{"type":"string","title":"Target Type"},"target_id":{"type":"string","format":"uuid","title":"Target Id"},"parent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Id"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"score":{"type":"integer","title":"Score"},"status":{"type":"string","title":"Status"},"reply_count":{"type":"integer","title":"Reply Count"},"edited_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Edited At"},"deleted":{"type":"boolean","title":"Deleted"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","owner_id","target_type","target_id","score","status","reply_count","deleted","created_at"],"title":"CommentItemOut","description":"One comment of a thread. Deleted rows keep their place with a null\nbody (the renderer's \"[removed]\" tombstone); a pending row appears only\non its author's own read."},"CommentPageOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CommentItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"CommentPageOut"},"CommentReportIn":{"properties":{"reason":{"type":"string","enum":["spam","abuse","off_topic","other"],"title":"Reason"}},"type":"object","required":["reason"],"title":"CommentReportIn","description":"Body of POST /v1/me/comments/{id}/report: one reason, enum-lite.\n\nFree-text reports are a moderation and defamation surface; four closed\nreasons cover the queue and stay greppable."},"CountryCountOut":{"properties":{"code":{"type":"string","title":"Code"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["code","count"],"title":"CountryCountOut"},"DecisionCardOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"type_code":{"type":"string","title":"Type Code","description":"Closed decision type code"},"status":{"type":"string","title":"Status"},"lead_decider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lead Decider"},"decision_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Decision Date"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id","description":"The place registry row behind ``place`` — deep-link target for ``/places/{id}``; null when the decision has no place"},"type_raw":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type Raw"},"instrument":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instrument"},"instrument_raw":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instrument Raw"},"effective_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Effective Date"},"announcement_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Announcement Date"},"deadline":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Deadline"},"known_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Known At","description":"When the record first entered the archive (immutable first-seen time)"},"arena":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Arena"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"unknowns":{"items":{"type":"string"},"type":"array","title":"Unknowns"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"actors":{"items":{"$ref":"#/components/schemas/ActorRefOut"},"type":"array","title":"Actors"},"targets":{"items":{"$ref":"#/components/schemas/TargetRefOut"},"type":"array","title":"Targets"},"evidence":{"anyOf":[{"$ref":"#/components/schemas/EvidenceRefOut"},{"type":"null"}]}},"type":"object","required":["id","title","type_code","status"],"title":"DecisionCardOut"},"DecisionListItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"type_code":{"type":"string","title":"Type Code","description":"Closed decision type code"},"status":{"type":"string","title":"Status"},"lead_decider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lead Decider"},"decision_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Decision Date"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place","description":"Named place of the decision, when one is recorded"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id","description":"The place registry row behind ``place`` — deep-link target for ``/places/{id}``; null when the decision has no place"}},"type":"object","required":["id","title","type_code","status"],"title":"DecisionListItemOut"},"DigestActorOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"kind":{"type":"string","title":"Kind"}},"type":"object","required":["id","name","kind"],"title":"DigestActorOut","description":"One actor chip on a story card — a dossier deep link plus the watch\nstar's target. `kind` is the registry kind, surfaced for chip styling\nonly."},"DigestMemberOut":{"properties":{"kind":{"type":"string","enum":["event","decision"],"title":"Kind"},"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"}},"type":"object","required":["kind","id","title","recorded_at"],"title":"DigestMemberOut","description":"One deep-linked member row of a story card: the record's kind, id,\ntitle and ingestion stamp. The card caps at three; the situation page\ncarries the rest."},"DigestOut":{"properties":{"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"stories":{"items":{"$ref":"#/components/schemas/DigestStoryOut"},"type":"array","title":"Stories"}},"type":"object","required":["stories"],"title":"DigestOut","description":"GET /v1/digest — the day's shape for the /feed band: up to six\nstories ranked by the day's member count. `updated_at` is the freshest\nmember stamp across the page; the honest empty state is stories: []."},"DigestStoryOut":{"properties":{"situation_id":{"type":"string","format":"uuid","title":"Situation Id"},"name":{"type":"string","title":"Name"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"status":{"type":"string","title":"Status"},"records":{"type":"integer","title":"Records"},"freshest_at":{"type":"string","format":"date-time","title":"Freshest At"},"members":{"items":{"$ref":"#/components/schemas/DigestMemberOut"},"type":"array","title":"Members"},"actors":{"items":{"$ref":"#/components/schemas/DigestActorOut"},"type":"array","title":"Actors"}},"type":"object","required":["situation_id","name","status","records","freshest_at","members","actors"],"title":"DigestStoryOut","description":"One ranked story of the day: the pre-written headline with its rank\ninputs (records + freshest stamp), the three newest member rows, and up\nto three actor chips."},"DomainActorOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"decision_count":{"type":"integer","title":"Decision Count"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind","description":"Actor kind (person, state, organization…)"}},"type":"object","required":["id","name","decision_count"],"title":"DomainActorOut"},"DomainCardOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"type":"string","title":"Slug","description":"Stable public handle for the domain"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"decision_count":{"type":"integer","title":"Decision Count"},"actor_count":{"type":"integer","title":"Actor Count"},"evidence_count":{"type":"integer","title":"Evidence Count"},"last_decision_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Decision Date"},"types":{"items":{"$ref":"#/components/schemas/DomainTypeCountOut"},"type":"array","title":"Types","description":"Decision types in this domain, largest first"},"actors":{"items":{"$ref":"#/components/schemas/DomainActorOut"},"type":"array","title":"Actors","description":"Actors appearing in this domain's decisions, most first"}},"type":"object","required":["id","slug","name","decision_count","actor_count","evidence_count"],"title":"DomainCardOut"},"DomainListItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"slug":{"type":"string","title":"Slug","description":"Stable public handle for the domain"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"decision_count":{"type":"integer","title":"Decision Count"},"actor_count":{"type":"integer","title":"Actor Count"},"evidence_count":{"type":"integer","title":"Evidence Count"},"last_decision_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Decision Date"}},"type":"object","required":["id","slug","name","decision_count","actor_count","evidence_count"],"title":"DomainListItemOut"},"DomainTypeCountOut":{"properties":{"code":{"type":"string","title":"Code","description":"Closed decision type code"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["code","count"],"title":"DomainTypeCountOut"},"EventCardOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"event_type":{"type":"string","title":"Event Type"},"status":{"type":"string","title":"Status"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id","description":"The place registry row behind ``place`` — deep-link target for ``/places/{id}``; null when the event has no place"},"shape":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shape"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"known_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Known At","description":"When the record first entered the archive (immutable first-seen time)"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"unknowns":{"items":{"type":"string"},"type":"array","title":"Unknowns"},"actors":{"items":{"$ref":"#/components/schemas/ActorRefOut"},"type":"array","title":"Actors"},"evidence":{"anyOf":[{"$ref":"#/components/schemas/EvidenceRefOut"},{"type":"null"}]}},"type":"object","required":["id","title","event_type","status"],"title":"EventCardOut"},"EventListItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"event_type":{"type":"string","title":"Event Type"},"status":{"type":"string","title":"Status"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place"},"place_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Place Id","description":"The place registry row behind ``place`` — deep-link target for ``/places/{id}``; null when the event has no place"}},"type":"object","required":["id","title","event_type","status"],"title":"EventListItemOut"},"EvidenceRefOut":{"properties":{"quote":{"type":"string","title":"Quote"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher"}},"type":"object","required":["quote"],"title":"EvidenceRefOut"},"FeedItemOut":{"properties":{"kind":{"type":"string","title":"Kind","description":"decision, event or situation"},"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"kind_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind Type","description":"Decision type code, event type or situation type"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"item_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Item Date","description":"The kind's own clock for display: decision date or start date"},"recorded_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Recorded At","description":"When the row entered the corpus (v_feed's clock) — the feed's own publication time, usable as an RSS pubDate when item_date is empty"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"extras":{"additionalProperties":true,"type":"object","title":"Extras","description":"Kind-specific card fields as the feed view built them: lead_decider/domain_slug for a decision, place/shape for an event, member_count/end_date/intensity for a situation"}},"type":"object","required":["kind","id","title"],"title":"FeedItemOut","description":"One card in the mixed feed (``v_feed``)."},"FollowIn":{"properties":{"forecast_id":{"type":"string","format":"uuid","title":"Forecast Id"}},"type":"object","required":["forecast_id"],"title":"FollowIn","description":"Body of POST /v1/me/follows. Extra keys are ignored."},"FollowItemOut":{"properties":{"forecast_id":{"type":"string","format":"uuid","title":"Forecast Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"deadline":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deadline"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["forecast_id","created_at"],"title":"FollowItemOut"},"FollowPageOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/FollowItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","total"],"title":"FollowPageOut"},"ForecastBranchOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"status":{"type":"string","title":"Status"},"probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Probability"},"as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"As Of"},"deadline":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deadline"}},"type":"object","required":["id","title","status"],"title":"ForecastBranchOut"},"ForecastCardOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"target_type":{"type":"string","title":"Target Type"},"target_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Target Id"},"deadline":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deadline"},"status":{"type":"string","title":"Status"},"probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Probability","description":"Latest recorded probability, or null before the first point"},"as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"As Of","description":"Information cutoff of the latest probability point"},"is_exclusive":{"type":"boolean","title":"Is Exclusive","default":false},"parent_forecast_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Forecast Id"},"branch_count":{"type":"integer","title":"Branch Count","description":"Direct branches below this forecast","default":0},"resolution_outcome":{"anyOf":[{},{"type":"null"}],"title":"Resolution Outcome","description":"Recorded outcome when resolved; null while open"},"recorded_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Recorded At"},"condition":{"type":"string","title":"Condition"},"forecast_type":{"type":"string","title":"Forecast Type"},"parent":{"anyOf":[{"$ref":"#/components/schemas/ForecastParentOut"},{"type":"null"}]},"branches":{"items":{"$ref":"#/components/schemas/ForecastBranchOut"},"type":"array","title":"Branches"},"resolution":{"anyOf":[{"$ref":"#/components/schemas/ForecastResolutionOut"},{"type":"null"}]},"point_count":{"type":"integer","title":"Point Count","description":"Rows in the probability series","default":0}},"type":"object","required":["id","title","target_type","status","condition","forecast_type"],"title":"ForecastCardOut"},"ForecastEvidenceOut":{"properties":{"quote":{"type":"string","title":"Quote"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher"}},"type":"object","required":["quote"],"title":"ForecastEvidenceOut"},"ForecastListItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"target_type":{"type":"string","title":"Target Type"},"target_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Target Id"},"deadline":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deadline"},"status":{"type":"string","title":"Status"},"probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Probability","description":"Latest recorded probability, or null before the first point"},"as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"As Of","description":"Information cutoff of the latest probability point"},"is_exclusive":{"type":"boolean","title":"Is Exclusive","default":false},"parent_forecast_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Forecast Id"},"branch_count":{"type":"integer","title":"Branch Count","description":"Direct branches below this forecast","default":0},"resolution_outcome":{"anyOf":[{},{"type":"null"}],"title":"Resolution Outcome","description":"Recorded outcome when resolved; null while open"},"recorded_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Recorded At"}},"type":"object","required":["id","title","target_type","status"],"title":"ForecastListItemOut"},"ForecastPageOut_ForecastListItemOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ForecastListItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Total rows matching the filters"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` to read the next page; null on the last page"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"ForecastPageOut[ForecastListItemOut]"},"ForecastPageOut_ForecastPointOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ForecastPointOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Total rows matching the filters"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` to read the next page; null on the last page"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"ForecastPageOut[ForecastPointOut]"},"ForecastParentOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"status":{"type":"string","title":"Status"}},"type":"object","required":["id","title","status"],"title":"ForecastParentOut"},"ForecastPointOut":{"properties":{"as_of":{"type":"string","format":"date-time","title":"As Of"},"probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Probability"},"change_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Reason","description":"Why the point was written; 'checked_no_change' is a deliberate no-op"},"evidence_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Evidence Id","description":"Evidence row that moved the probability, when one exists"}},"type":"object","required":["as_of"],"title":"ForecastPointOut"},"ForecastResolutionOut":{"properties":{"outcome":{"anyOf":[{},{"type":"null"}],"title":"Outcome"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"evidence":{"anyOf":[{"$ref":"#/components/schemas/ForecastEvidenceOut"},{"type":"null"}]}},"type":"object","title":"ForecastResolutionOut"},"ForecastScoreOut":{"properties":{"policy_version":{"type":"string","title":"Policy Version"},"model_version":{"type":"string","title":"Model Version"},"replay":{"type":"string","title":"Replay","description":"Live table read at `as_of`; not a point-in-time snapshot","default":"live_read"},"as_of":{"type":"string","format":"date-time","title":"As Of"},"n":{"type":"integer","title":"N","description":"Scored (p, y) rows"},"n_refused":{"type":"integer","title":"N Refused","description":"Resolved forecasts refused a score"},"n_excluded_non_model":{"type":"integer","title":"N Excluded Non Model","description":"Resolved forecasts from another model (no agent-v0 point)","default":0},"refusals":{"items":{"$ref":"#/components/schemas/ScoringRefusalOut"},"type":"array","title":"Refusals"},"forecast_status":{"additionalProperties":{"type":"integer"},"type":"object","title":"Forecast Status","description":"Count of forecasts per status (context, not scored)"},"quality_claim":{"type":"boolean","title":"Quality Claim","default":false},"brier":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Brier","description":"Brier score; null when n=0"},"log_loss":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Log Loss","description":"Log loss; null when n=0"},"calibration":{"anyOf":[{"$ref":"#/components/schemas/CalibrationOut"},{"type":"null"}],"description":"Reliability table; null when n=0"},"skill_withheld":{"type":"boolean","title":"Skill Withheld","description":"Always true for agent-v0: no reference class is carried","default":true},"p_series":{"items":{"$ref":"#/components/schemas/ScoredRowOut"},"type":"array","title":"P Series","description":"The scored (p, y) rows; empty when n=0"}},"type":"object","required":["policy_version","model_version","as_of","n","n_refused"],"title":"ForecastScoreOut","description":"The agent-v0 scoring report over the resolved deposit seam.\n\nRead-only: this is a live measurement over ``public.forecast`` +\n``public.forecast_point``, never a quality claim."},"ForecastTrackBinOut":{"properties":{"bin":{"type":"string","title":"Bin"},"n":{"type":"integer","title":"N"},"mean_prob":{"type":"number","title":"Mean Prob"},"outcome_rate":{"type":"number","title":"Outcome Rate"}},"type":"object","required":["bin","n","mean_prob","outcome_rate"],"title":"ForecastTrackBinOut","description":"One calibration bin: probability band, sample size, how often the\nbinned forecasts actually resolved YES (empirical outcome rate)."},"ForecastTrackOut":{"properties":{"forecast_id":{"type":"string","title":"Forecast Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"resolution_outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Outcome"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"},"deadline":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deadline"},"n_scored":{"type":"integer","title":"N Scored"},"mean_brier":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mean Brier"},"worst_brier":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Worst Brier"},"best_brier":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Best Brier"},"mean_log_loss":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mean Log Loss"},"first_prob":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"First Prob"},"last_prob":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Last Prob"},"last_scored_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scored At"},"coin_flip_baseline":{"type":"number","title":"Coin Flip Baseline"}},"type":"object","required":["forecast_id","title","status","resolution_outcome","resolved_at","deadline","n_scored","mean_brier","worst_brier","best_brier","mean_log_loss","first_prob","last_prob","last_scored_at","coin_flip_baseline"],"title":"ForecastTrackOut","description":"Track record for one forecast: scored points, Brier/log-loss stats,\nfirst/last probabilities and the resolution, all from the scoring\npipeline's own output."},"ForecastTrackPointOut":{"properties":{"point_id":{"type":"string","title":"Point Id"},"forecast_id":{"type":"string","title":"Forecast Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"as_of":{"type":"string","format":"date-time","title":"As Of"},"probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Probability"},"brier":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Brier"},"log_loss":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Log Loss"},"calibration_bin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Calibration Bin"}},"type":"object","required":["point_id","forecast_id","title","as_of","probability","brier","log_loss","calibration_bin"],"title":"ForecastTrackPointOut","description":"One scored check: the probability the model carried at that moment,\nscored against the final outcome (Brier, log loss, calibration bin)."},"ForecastTrackPointsOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ForecastTrackPointOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","total"],"title":"ForecastTrackPointsOut","description":"Newest scored checks first, with the full total so a client can\nlabel small-sample states honestly (total != len(items) means the\nwindow clipped the plot)."},"ForecastTrackSummaryOut":{"properties":{"model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Version"},"n_scored":{"type":"integer","title":"N Scored"},"n_forecasts":{"type":"integer","title":"N Forecasts"},"n_resolved":{"type":"integer","title":"N Resolved"},"mean_brier":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mean Brier"},"mean_log_loss":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mean Log Loss"},"coin_flip_baseline":{"type":"number","title":"Coin Flip Baseline"},"bins":{"items":{"$ref":"#/components/schemas/ForecastTrackBinOut"},"type":"array","title":"Bins"}},"type":"object","required":["model_version","n_scored","n_forecasts","n_resolved","mean_brier","mean_log_loss","coin_flip_baseline","bins"],"title":"ForecastTrackSummaryOut","description":"Platform forecast track record: the scoring pipeline's own numbers\n(per model_version rollup over public.forecast_score) plus the\ncoin-flip baseline served server-side — the one honest comparison\navailable at any sample size."},"ForecastTreeNodeOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"parent_forecast_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Forecast Id"},"title":{"type":"string","title":"Title"},"target_type":{"type":"string","title":"Target Type"},"target_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Target Id"},"condition":{"type":"string","title":"Condition"},"deadline":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deadline"},"status":{"type":"string","title":"Status"},"is_exclusive":{"type":"boolean","title":"Is Exclusive","default":false},"depth":{"type":"integer","title":"Depth","description":"0 for the root, 1 for its direct branches"},"branch_count":{"type":"integer","title":"Branch Count","description":"Direct branches below this node","default":0},"probability":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Probability"},"as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"As Of"},"resolution_outcome":{"anyOf":[{},{"type":"null"}],"title":"Resolution Outcome"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"}},"type":"object","required":["id","title","target_type","condition","status","depth"],"title":"ForecastTreeNodeOut"},"ForecastTreeOut":{"properties":{"root":{"$ref":"#/components/schemas/ForecastTreeNodeOut"},"nodes":{"items":{"$ref":"#/components/schemas/ForecastTreeNodeOut"},"type":"array","title":"Nodes"},"max_depth":{"type":"integer","title":"Max Depth"},"depth_capped":{"type":"boolean","title":"Depth Capped","description":"True when the requested depth was larger than the allowed maximum"}},"type":"object","required":["root","nodes","max_depth","depth_capped"],"title":"ForecastTreeOut"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LoginIn":{"properties":{"login":{"type":"string","pattern":"^(?:[a-zA-Z0-9_.-]{3,64}|[^\\s@]{1,64}@[^\\s@]{1,190}\\.[^\\s@]{1,63})$","title":"Login","description":"Handle or account email"},"password":{"type":"string","maxLength":256,"minLength":8,"title":"Password"}},"type":"object","required":["login","password"],"title":"LoginIn"},"LogoutIn":{"properties":{"refreshToken":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Refreshtoken"}},"type":"object","title":"LogoutIn"},"NotificationItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"kind":{"type":"string","title":"Kind"},"subject_id":{"type":"string","title":"Subject Id"},"title":{"type":"string","title":"Title"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"link":{"type":"string","title":"Link"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Read At"}},"type":"object","required":["id","kind","subject_id","title","payload","link","created_at","read_at"],"title":"NotificationItemOut","description":"One inbox row. ``payload`` is the delta summary (counts, top event,\nprobabilities) so the row renders without re-querying the graph."},"NotificationPageOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/NotificationItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"unread":{"type":"integer","title":"Unread"}},"type":"object","required":["items","total","unread"],"title":"NotificationPageOut"},"PageOut_ActorItemOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ActorItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Total rows matching the filters"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` to read the next page; null on the last page"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"PageOut[ActorItemOut]"},"PageOut_ActorListItemOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ActorListItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Total rows matching the filters"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` to read the next page; null on the last page"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"PageOut[ActorListItemOut]"},"PageOut_ActorRelationOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ActorRelationOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Total rows matching the filters"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` to read the next page; null on the last page"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"PageOut[ActorRelationOut]"},"PageOut_CalendarEntryOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CalendarEntryOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Total rows matching the filters"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` to read the next page; null on the last page"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"PageOut[CalendarEntryOut]"},"PageOut_ClaimItemOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ClaimItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Total rows matching the filters"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` to read the next page; null on the last page"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"PageOut[ClaimItemOut]"},"PageOut_DecisionListItemOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/DecisionListItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Total rows matching the filters"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` to read the next page; null on the last page"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"PageOut[DecisionListItemOut]"},"PageOut_EventListItemOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/EventListItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Total rows matching the filters"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` to read the next page; null on the last page"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"PageOut[EventListItemOut]"},"PageOut_FeedItemOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/FeedItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Total rows matching the filters"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` to read the next page; null on the last page"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"PageOut[FeedItemOut]"},"PageOut_PlaceListItemOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PlaceListItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Total rows matching the filters"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` to read the next page; null on the last page"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"PageOut[PlaceListItemOut]"},"PageOut_SituationListItemOut_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/SituationListItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","description":"Total rows matching the filters"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` to read the next page; null on the last page"}},"type":"object","required":["items","total","limit","offset","has_more"],"title":"PageOut[SituationListItemOut]"},"PlaceCardOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"kind":{"type":"string","title":"Kind","description":"country, region, city, physical, market, jurisdiction, digital or global"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO 3166-1 alpha-2, for physical kinds"},"parent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Id","description":"Containing place, when known"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"event_count":{"type":"integer","title":"Event Count","description":"Events placed here","default":0},"decision_count":{"type":"integer","title":"Decision Count","description":"Decisions made about this place","default":0},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases","description":"Surface forms recorded for this place (place_alias)"}},"type":"object","required":["id","name","kind"],"title":"PlaceCardOut"},"PlaceCountOut":{"properties":{"name":{"type":"string","title":"Name"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["name","count"],"title":"PlaceCountOut","description":"A place name rolled up from a situation's members, with its weight."},"PlaceListItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"kind":{"type":"string","title":"Kind","description":"country, region, city, physical, market, jurisdiction, digital or global"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO 3166-1 alpha-2, for physical kinds"},"parent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Id","description":"Containing place, when known"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"event_count":{"type":"integer","title":"Event Count","description":"Events placed here","default":0},"decision_count":{"type":"integer","title":"Decision Count","description":"Decisions made about this place","default":0}},"type":"object","required":["id","name","kind"],"title":"PlaceListItemOut","description":"One place of the directory hub (the canonical ``place`` registry)."},"PlaceWatchIn":{"properties":{"place_id":{"type":"string","format":"uuid","title":"Place Id"}},"type":"object","required":["place_id"],"title":"PlaceWatchIn","description":"Body of POST /v1/me/places. Extra keys are ignored.\n\nAn incoming `owner_id` is dropped, not read; the owner always comes from\nthe JWT."},"PlaceWatchItemOut":{"properties":{"place_id":{"type":"string","format":"uuid","title":"Place Id"},"place_name":{"type":"string","title":"Place Name"},"place_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Kind"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["place_id","place_name","created_at"],"title":"PlaceWatchItemOut"},"PlaceWatchPageOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PlaceWatchItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","total"],"title":"PlaceWatchPageOut"},"ProfileOut":{"properties":{"user_id":{"type":"string","title":"User Id"},"login":{"type":"string","title":"Login"},"email":{"type":"string","title":"Email"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["user_id","login","email"],"title":"ProfileOut","description":"The caller's own account row (``GET /v1/me/profile``): the\njust-registered signal the browser's umami ``signup:user_signed_up``\nonce-guard reads (specs/umami_signup_events.md). JWT-only read;\n``created_at`` is nullable only for rows written before the field\nrode the auth resolution."},"RefreshIn":{"properties":{"refreshToken":{"type":"string","maxLength":256,"minLength":16,"title":"Refreshtoken"}},"type":"object","required":["refreshToken"],"title":"RefreshIn"},"RefreshOut":{"properties":{"token":{"type":"string","title":"Token"},"refreshToken":{"type":"string","title":"Refreshtoken"}},"type":"object","required":["token","refreshToken"],"title":"RefreshOut"},"RegisterIn":{"properties":{"login":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{3,64}$","title":"Login","description":"Account handle"},"email":{"type":"string","pattern":"^[^\\s@]{1,64}@[^\\s@]{1,190}\\.[^\\s@]{1,63}$","title":"Email","description":"Account email"},"password":{"type":"string","maxLength":256,"minLength":8,"title":"Password"}},"type":"object","required":["login","email","password"],"title":"RegisterIn"},"RegisteredOut":{"properties":{"user":{"$ref":"#/components/schemas/UserOut"}},"type":"object","required":["user"],"title":"RegisteredOut"},"SavedSearchIn":{"properties":{"query":{"type":"string","maxLength":200,"minLength":2,"title":"Query"},"kind":{"type":"string","enum":["all","decision","event","situation","forecast","actor"],"title":"Kind","default":"all"},"title":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Title"}},"type":"object","required":["query"],"title":"SavedSearchIn","description":"Body of POST /v1/me/saved-searches. Extra keys are ignored.\n\n`query` is the palette's typed text (the palette refuses empty searches\nclient-side; the API enforces the same floor). `kind` is the palette's\nfilter, defaulting to 'all'. An incoming `owner_id` is never read."},"SavedSearchItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"query":{"type":"string","title":"Query"},"kind":{"type":"string","title":"Kind"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","title","query","kind","created_at"],"title":"SavedSearchItemOut"},"SavedSearchPageOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/SavedSearchItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","total"],"title":"SavedSearchPageOut"},"ScoredRowOut":{"properties":{"forecast_id":{"type":"string","format":"uuid","title":"Forecast Id"},"p":{"type":"number","title":"P","description":"Final probability before resolution"},"y":{"type":"integer","title":"Y","description":"Realized binary outcome (0 or 1)"},"as_of":{"type":"string","format":"date-time","title":"As Of","description":"Information cutoff of the scored probability point"}},"type":"object","required":["forecast_id","p","y","as_of"],"title":"ScoredRowOut","description":"One scored (p, y) pair: the final point before resolution."},"ScoringRefusalOut":{"properties":{"forecast_id":{"type":"string","format":"uuid","title":"Forecast Id"},"code":{"type":"string","title":"Code","description":"non_binary_outcome | no_resolved_at | no_point_before_resolution"}},"type":"object","required":["forecast_id","code"],"title":"ScoringRefusalOut","description":"A resolved forecast that could not be scored, with a stable code."},"SearchItemOut":{"properties":{"kind":{"type":"string","title":"Kind","description":"decision, event, situation, forecast or actor"},"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"score":{"type":"number","title":"Score","description":"Within-kind rank, higher first. Not comparable across kinds."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"type_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type Code"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"}},"type":"object","required":["kind","id","title","score"],"title":"SearchItemOut"},"SearchOut":{"properties":{"query":{"type":"string","title":"Query"},"per_kind":{"type":"integer","title":"Per Kind"},"items":{"items":{"$ref":"#/components/schemas/SearchItemOut"},"type":"array","title":"Items"},"totals":{"additionalProperties":{"type":"integer"},"type":"object","title":"Totals","description":"Matching rows per kind, before the per-kind cut"}},"type":"object","required":["query","per_kind"],"title":"SearchOut"},"SimilarItemOut":{"properties":{"kind":{"type":"string","title":"Kind","description":"decision, event, actor, situation or forecast"},"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"score":{"type":"number","title":"Score","description":"Cosine similarity to the source entity (0-1)"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"type_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type Code"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"}},"type":"object","required":["kind","id","title","score"],"title":"SimilarItemOut"},"SituationCardOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"situation_type":{"type":"string","title":"Situation Type"},"status":{"type":"string","title":"Status"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"member_count":{"type":"integer","title":"Member Count","description":"Decisions and events currently attached by part_of"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place","description":"Most frequent place name among the situation's current members (decisions and events), when at least one of them is placed"},"places":{"items":{"$ref":"#/components/schemas/PlaceCountOut"},"type":"array","title":"Places","description":"The same rollup as `place`, top three names with member counts"},"intensity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Intensity"},"unknowns":{"items":{"type":"string"},"type":"array","title":"Unknowns"},"known_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Known At","description":"When the situation first entered the archive (immutable first-seen time)"},"actors":{"items":{"$ref":"#/components/schemas/ActorRefOut"},"type":"array","title":"Actors"},"members":{"items":{"$ref":"#/components/schemas/SituationMemberOut"},"type":"array","title":"Members"},"evidence":{"anyOf":[{"$ref":"#/components/schemas/EvidenceRefOut"},{"type":"null"}]}},"type":"object","required":["id","name","situation_type","status","member_count"],"title":"SituationCardOut"},"SituationListItemOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"situation_type":{"type":"string","title":"Situation Type"},"status":{"type":"string","title":"Status"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"member_count":{"type":"integer","title":"Member Count","description":"Decisions and events currently attached by part_of"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary","description":"Discovery's description of the cluster, for catalog cards"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place","description":"Most frequent place name among the situation's current members (decisions and events), when at least one of them is placed"},"places":{"items":{"$ref":"#/components/schemas/PlaceCountOut"},"type":"array","title":"Places","description":"The same rollup as `place`, top three names with member counts"}},"type":"object","required":["id","name","situation_type","status","member_count"],"title":"SituationListItemOut"},"SituationMemberOut":{"properties":{"kind":{"type":"string","title":"Kind","description":"decision or event"},"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"type_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type Code","description":"Decision type code or event type"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date","description":"Decision date or event start date"},"role":{"type":"string","title":"Role","description":"How the member belongs to the situation (part_of)"}},"type":"object","required":["kind","id","title","role"],"title":"SituationMemberOut"},"StatsOut":{"properties":{"decisions":{"type":"integer","title":"Decisions"},"events":{"type":"integer","title":"Events"},"actors":{"type":"integer","title":"Actors"},"situations":{"type":"integer","title":"Situations","description":"Current situations (not retired)","default":0}},"type":"object","required":["decisions","events","actors"],"title":"StatsOut"},"TargetRefOut":{"properties":{"label":{"type":"string","title":"Label"},"target_type":{"type":"string","title":"Target Type"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"actor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Actor Id","description":"Registry id of the target actor, when the target is an entity"}},"type":"object","required":["label","target_type"],"title":"TargetRefOut"},"TokenPairOut":{"properties":{"token":{"type":"string","title":"Token"},"refreshToken":{"type":"string","title":"Refreshtoken"},"user":{"$ref":"#/components/schemas/UserOut"}},"type":"object","required":["token","refreshToken","user"],"title":"TokenPairOut","description":"The nuxt-auth `local` provider sign-in shape.\n\n``/token`` and ``/refreshToken`` are the JSON Pointer defaults the\nfrontend is configured with; ``user`` rides along so the client can\nrender the session without a second request."},"TrajectoryArcOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"target_kind":{"type":"string","title":"Target Kind"},"direction":{"type":"integer","title":"Direction","description":"-1 headwind, 0 neutral, +1 tailwind"},"p":{"type":"number","title":"P","description":"Current probability that the arc fires"},"horizon_bucket":{"type":"string","title":"Horizon Bucket","description":"d1 | d7 | d30 | d90 | d365"},"expected_by":{"type":"string","format":"date-time","title":"Expected By"},"status":{"type":"string","title":"Status"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"},"resolution_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Reason"}},"type":"object","required":["id","title","target_kind","direction","p","horizon_bucket","expected_by","status"],"title":"TrajectoryArcOut","description":"One arc as the widget renders it.\n\nDeliberately excludes the vector and coverage internals; those never\ncross the public boundary."},"TrajectoryCardOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"target_kind":{"type":"string","title":"Target Kind"},"direction":{"type":"integer","title":"Direction","description":"-1 headwind, 0 neutral, +1 tailwind"},"p":{"type":"number","title":"P","description":"Current probability that the arc fires"},"horizon_bucket":{"type":"string","title":"Horizon Bucket","description":"d1 | d7 | d30 | d90 | d365"},"expected_by":{"type":"string","format":"date-time","title":"Expected By"},"status":{"type":"string","title":"Status"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"},"resolution_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Reason"},"kill_condition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kill Condition"},"target":{"$ref":"#/components/schemas/TrajectoryTargetOut"},"sources":{"items":{"$ref":"#/components/schemas/TrajectorySourceRefOut"},"type":"array","title":"Sources"},"resolution":{"anyOf":[{"$ref":"#/components/schemas/TrajectoryResolutionOut"},{"type":"null"}]}},"type":"object","required":["id","title","target_kind","direction","p","horizon_bucket","expected_by","status","target"],"title":"TrajectoryCardOut","description":"A listing card: the arc plus its entity links in one face.\n\n``kill_condition`` is user-facing semantics (the arc's own definition of\nbeing wrong), unlike the vector/coverage internals which stay server-side."},"TrajectoryChainMemberOut":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"target_kind":{"type":"string","title":"Target Kind"},"direction":{"type":"integer","title":"Direction","description":"-1 headwind, 0 neutral, +1 tailwind"},"p":{"type":"number","title":"P","description":"Current probability that the arc fires"},"horizon_bucket":{"type":"string","title":"Horizon Bucket","description":"d1 | d7 | d30 | d90 | d365"},"expected_by":{"type":"string","format":"date-time","title":"Expected By"},"status":{"type":"string","title":"Status"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"},"resolution_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Reason"},"kill_condition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kill Condition"},"target":{"$ref":"#/components/schemas/TrajectoryTargetOut"},"sources":{"items":{"$ref":"#/components/schemas/TrajectorySourceRefOut"},"type":"array","title":"Sources"},"resolution":{"anyOf":[{"$ref":"#/components/schemas/TrajectoryResolutionOut"},{"type":"null"}]},"p_initial":{"type":"number","title":"P Initial","description":"The p the model proposed at birth"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence","description":"The model's own self-rated confidence at birth"},"engine":{"type":"string","title":"Engine","description":"organic (discover tick) or ondemand (paid run)"},"parent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Id"},"condition_deadline":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Condition Deadline","description":"Dormant children only: wake-or-kill date tied to the parent's window"}},"type":"object","required":["id","title","target_kind","direction","p","horizon_bucket","expected_by","status","target","p_initial","engine","condition_deadline"],"title":"TrajectoryChainMemberOut","description":"A chain neighbour: the card face plus the lineage columns.\n\n``p`` on a child is CONDITIONAL — P(child | parent true), never its\nabsolute probability; the frontend multiplies it by the parent's p for\nthe effective number and shows both (the house honesty rule: never hide\nthe factors behind the product)."},"TrajectoryChainOut":{"properties":{"parent":{"anyOf":[{"$ref":"#/components/schemas/TrajectoryChainMemberOut"},{"type":"null"}]},"children":{"items":{"$ref":"#/components/schemas/TrajectoryChainMemberOut"},"type":"array","title":"Children"}},"type":"object","title":"TrajectoryChainOut","description":"The chain around one arc: its parent (if it is a child) and its\nchildren (if it is a parent).  Depth stays flat — the detail page\nrenders a story, deeper hops are the child's own detail page."},"TrajectoryDetailOut":{"properties":{"arc":{"$ref":"#/components/schemas/TrajectoryChainMemberOut"},"chain":{"$ref":"#/components/schemas/TrajectoryChainOut"},"history":{"items":{"$ref":"#/components/schemas/TrajectoryStatusChangeOut"},"type":"array","title":"History"},"tree":{"anyOf":[{"$ref":"#/components/schemas/TrajectoryTreeOut"},{"type":"null"}]}},"type":"object","required":["arc"],"title":"TrajectoryDetailOut","description":"The detail face: chain member columns + the chain + the status trail."},"TrajectoryListOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/TrajectoryCardOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["items","total","limit","offset"],"title":"TrajectoryListOut","description":"One page of trajectory cards plus the listing counters."},"TrajectoryReadinessOut":{"properties":{"enough":{"type":"boolean","title":"Enough"},"reason":{"type":"string","enum":["ok","no_anchor","no_neighbours"],"title":"Reason"},"neighbours":{"type":"integer","minimum":0,"title":"Neighbours","description":"Semantic neighbours above the floor"},"price_coins":{"type":"integer","minimum":0,"title":"Price Coins"}},"type":"object","required":["enough","reason","neighbours","price_coins"],"title":"TrajectoryReadinessOut","description":"The paid-mining pre-flight: can the archive deliver, and for how much.\n\n``reason`` is the countable why — ``ok`` when generation may proceed,\n``no_anchor`` / ``no_neighbours`` when it must not (the honest refusal:\nthe button is never offered for an entity the archive cannot ground)."},"TrajectoryResolutionOut":{"properties":{"resolved_via_entity_id":{"type":"string","format":"uuid","title":"Resolved Via Entity Id"},"lead_time_days":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lead Time Days","description":"known_at(target) - known_at(source), world clocks"}},"type":"object","required":["resolved_via_entity_id","lead_time_days"],"title":"TrajectoryResolutionOut","description":"Materialization provenance — the calibration social proof on the card."},"TrajectorySourceRefOut":{"properties":{"entity_kind":{"type":"string","title":"Entity Kind"},"entity_id":{"type":"string","format":"uuid","title":"Entity Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Anchor card title; claims carry the statement"}},"type":"object","required":["entity_kind","entity_id","title"],"title":"TrajectorySourceRefOut","description":"One anchoring entity the arc grew from; frontend builds its own link."},"TrajectoryStatsOut":{"properties":{"by_status":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Status"},"by_kind":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Kind"},"by_horizon":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Horizon"},"materialized_lead_days_p50":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Materialized Lead Days P50"}},"type":"object","required":["by_status","by_kind","by_horizon"],"title":"TrajectoryStatsOut","description":"Header counters for the /trajectories page."},"TrajectoryStatusChangeOut":{"properties":{"changed_at":{"type":"string","format":"date-time","title":"Changed At"},"origin":{"type":"string","title":"Origin"},"field":{"type":"string","title":"Field"},"old_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Old Value"},"new_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"New Value"}},"type":"object","required":["changed_at","origin","field"],"title":"TrajectoryStatusChangeOut","description":"One flip in the arc's lifecycle — the resolution proof trail.\n\n``origin`` distinguishes the world's verdict (``resolution``) from the\nchain mechanics (``chain_wake`` / ``chain_cascade``)."},"TrajectoryTargetOut":{"properties":{"entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Entity Id","description":"Null for soft targets (market_state and unresolved refs)"},"entity_kind":{"type":"string","title":"Entity Kind","description":"Same vocabulary as target_kind"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name","description":"Registry name of the resolved target, if any"}},"type":"object","required":["entity_id","entity_kind","display_name"],"title":"TrajectoryTargetOut","description":"The resolved addressee; soft arcs carry a null entity and no name."},"TrajectoryTreeOut":{"properties":{"root_id":{"type":"string","format":"uuid","title":"Root Id"},"nodes":{"items":{"$ref":"#/components/schemas/TrajectoryChainMemberOut"},"type":"array","title":"Nodes"}},"type":"object","required":["root_id"],"title":"TrajectoryTreeOut","description":"The WHOLE chain tree from its root — the canvas face.\n\n``nodes`` carry ``parent_id`` links; the frontend derives edges and\nthe running p_eff product (root's p x every conditional p along the\npath — the honest absolute number, computed where it is shown).  The\ntree is capped server-side: a detail page renders a story, not a\ncensus."},"UserOut":{"properties":{"id":{"type":"string","title":"Id"},"login":{"type":"string","title":"Login"},"email":{"type":"string","title":"Email"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","login","email"],"title":"UserOut","description":"The nuxt-auth session data: exactly what the browser may know."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WatchChangesOut":{"properties":{"since":{"type":"string","format":"date-time","title":"Since"},"until":{"type":"string","format":"date-time","title":"Until"},"first_visit":{"type":"boolean","title":"First Visit"},"items":{"items":{"$ref":"#/components/schemas/WatchDeltaOut"},"type":"array","title":"Items"}},"type":"object","required":["since","until","first_visit","items"],"title":"WatchChangesOut"},"WatchDeltaOut":{"properties":{"actor_id":{"type":"string","format":"uuid","title":"Actor Id"},"actor_name":{"type":"string","title":"Actor Name"},"events_since":{"type":"integer","title":"Events Since"},"claims_since":{"type":"integer","title":"Claims Since"},"latest_event_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Event Title"},"latest_event_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Event At"},"claims_by_since":{"type":"integer","title":"Claims By Since","default":0}},"type":"object","required":["actor_id","actor_name","events_since","claims_since"],"title":"WatchDeltaOut"},"WatchIn":{"properties":{"actor_id":{"type":"string","format":"uuid","title":"Actor Id"}},"type":"object","required":["actor_id"],"title":"WatchIn","description":"Body of POST /v1/me/watchlist. Extra keys are ignored."},"WatchItemOut":{"properties":{"actor_id":{"type":"string","format":"uuid","title":"Actor Id"},"actor_name":{"type":"string","title":"Actor Name"},"actor_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor Kind"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["actor_id","actor_name","created_at"],"title":"WatchItemOut"},"WatchPageOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/WatchItemOut"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","total"],"title":"WatchPageOut"},"WatchSuggestionOut":{"properties":{"actor_id":{"type":"string","format":"uuid","title":"Actor Id"},"actor_name":{"type":"string","title":"Actor Name"},"actor_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor Kind"},"score":{"type":"number","title":"Score"},"anchors":{"type":"integer","title":"Anchors"},"anchor_names":{"items":{"type":"string"},"type":"array","title":"Anchor Names","default":[]}},"type":"object","required":["actor_id","actor_name","score","anchors"],"title":"WatchSuggestionOut"},"WatchSuggestionsOut":{"properties":{"items":{"items":{"$ref":"#/components/schemas/WatchSuggestionOut"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"WatchSuggestionsOut"}}},"tags":[{"name":"actors","description":"People, organisations, states and other actors."},{"name":"decisions","description":"Decisions extracted from the wire."},{"name":"events","description":"Events and occurrences linked to the graph."},{"name":"calendar","description":"Decisions and events placed on a time axis, with coverage."},{"name":"forecasts","description":"Falsifiable questions about the graph, their probability series, branches and proven outcomes."},{"name":"system","description":"Totals and service metadata."}]}