{
  "schema_version": "1.0",
  "product": {
    "id": "pssr",
    "name": "PSSR",
    "expanded_name": "Probabilistic State-Space Reasoning",
    "canonical_url": "https://pssr.site/",
    "description": "Evidence-aware framework for analysis of dynamic states, regimes and scenarios."
  },
  "public_surfaces": {
    "portal": "https://pssr.site/",
    "evidence": "https://pssr.site/evidence/",
    "coverage": "https://pssr.site/coverage/",
    "calibration": "https://pssr.site/calibration/",
    "validation": "https://pssr.site/validation/",
    "roles": "https://pssr.site/roles/",
    "cases": "https://pssr.site/cases/",
    "engine_model": "https://pssr.site/engine-model/",
    "review_workflow": "https://pssr.site/review-workflow/",
    "next_version": "https://pssr.site/next-version/",
    "geo": "https://pssr.site/geo/",
    "versions": "https://pssr.site/versions/",
    "methodology": "https://pssr.site/methodology/",
    "architecture": "https://pssr.site/architecture/",
    "status": "https://pssr.site/status/",
    "responsible_use": "https://pssr.site/responsible-use/",
    "contact": "https://pssr.site/contact/",
    "knowledge_base": "https://pssr.site/kb/"
  },
  "protected_surfaces": {
    "cockpit": {
      "url": "https://pssr.site/cockpit",
      "access": "authenticated",
      "crawl": false
    },
    "engine": {
      "url": "https://pssr.site/engine/",
      "access": "authenticated",
      "crawl": false
    }
  },
  "machine_surfaces": {
    "kb_manifest": "https://pssr.site/kb/ai-manifest.json",
    "public_release_log": "https://pssr.site/public-release-log.json",
    "kb_field_dictionary": "https://pssr.site/kb/field-dictionary.json",
    "kb_academic_review_package": "https://pssr.site/kb/academic-review-package.json",
    "engine_health": "https://pssr.site/api/v1/health",
    "public_brief": "https://pssr.site/api/v1/public/brief",
    "public_model_card": "https://pssr.site/api/v1/public/model-card",
    "public_limits": "https://pssr.site/api/v1/public/limits",
    "public_evidence_map": "https://pssr.site/api/v1/public/evidence-map",
    "public_qazstack_consumer": "https://pssr.site/api/v1/public/qazstack-consumer",
    "current_regime": "https://pssr.site/api/v1/regime/current",
    "compatibility_health": "https://pssr.site/health",
    "compatibility_context": "https://pssr.site/api/context"
  },
  "adjacent_products": {
    "electoral_os": {
      "url": "https://elect.qdev.run/cockpit",
      "access": "authenticated",
      "crawl": false
    },
    "commstrat": {
      "url": "https://commstrat.qdev.run/",
      "owner_of": [
        "audiences",
        "messages",
        "channels",
        "media_plans"
      ]
    }
  },
  "interpretation": {
    "probabilistic": true,
    "human_review_required": true,
    "public_context_is_official_forecast": false,
    "automated_decision_authority": false,
    "version_contours_are_distinct": true
  },
  "route_summaries": {
    "portal": {
      "url": "https://pssr.site/",
      "title": "PSSR – ежедневная проверяемая сводка",
      "summary": "Текущий режим PSSR, изменения, причины, качество данных и ограничения.",
      "purpose": "Fast orientation and current public brief.",
      "allowed_use": "Use as a public entrypoint to the latest bounded PSSR context.",
      "forbidden_inference": "Do not treat the brief as an official forecast, causal proof or automatic decision.",
      "freshness": "Runtime widgets depend on public Engine API freshness."
    },
    "evidence": {
      "url": "https://pssr.site/evidence/",
      "title": "Доказательства и ограничения – PSSR",
      "summary": "Публичный evidence pack PSSR: текущий снимок, качество данных, worked cases, model-card, limits и review package.",
      "purpose": "Evidence-first entrypoint with model-card, limits and review package links.",
      "allowed_use": "Use to find support level and known blind spots before summarising claims.",
      "forbidden_inference": "Do not infer missing raw events, protected workspace notes or closed sources.",
      "freshness": "Mixes static guidance with live public evidence-map API."
    },
    "coverage": {
      "url": "https://pssr.site/coverage/",
      "title": "Source coverage и blind spots – PSSR",
      "summary": "Публичная карта семейств источников PSSR, текущего покрытия, blind spots и допустимых claims.",
      "purpose": "Show data coverage, failed sources and claim support boundaries.",
      "allowed_use": "Use to weaken claims when source quality or coverage is limited.",
      "forbidden_inference": "Do not turn missing evidence into evidence of absence.",
      "freshness": "Static source-family map plus live public coverage references."
    },
    "calibration": {
      "url": "https://pssr.site/calibration/",
      "title": "Calibration и baselines – PSSR",
      "summary": "Почему PSSR пока не публикует probability claims и какие baseline protocols нужны для следующего уровня доверия.",
      "purpose": "Explain why probability claims are blocked until validation evidence exists.",
      "allowed_use": "Use to describe calibration requirements and baseline gates.",
      "forbidden_inference": "Do not state that PSSR has proven forecast accuracy.",
      "freshness": "Static governance page until a validation package closes gates."
    },
    "validation": {
      "url": "https://pssr.site/validation/",
      "title": "Validation gate – PSSR",
      "summary": "G0–G7, active blockers и next safe step для честной оценки готовности PSSR.",
      "purpose": "Human-readable G0-G7 blocker surface mirrored from KB review package.",
      "allowed_use": "Use to determine which claims remain blocked and what the next safe step is.",
      "forbidden_inference": "Do not promote v10.4-RC1 or probability claims while blockers remain active.",
      "freshness": "Must stay contract-checked against KB academic-review-package."
    },
    "roles": {
      "url": "https://pssr.site/roles/",
      "title": "Ролевые маршруты – PSSR",
      "summary": "Как аналитик, reviewer, заказчик, редактор и интегратор должны читать один и тот же снимок PSSR.",
      "purpose": "Separate analyst, reviewer, owner, editor and integrator tasks.",
      "allowed_use": "Use to route stakeholders to the right public or protected surface.",
      "forbidden_inference": "Do not assume all roles have the same access or authority.",
      "freshness": "Static role contract, tied to public surface boundaries."
    },
    "cases": {
      "url": "https://pssr.site/cases/",
      "title": "Worked cases – PSSR",
      "summary": "Normal, stress и data-degraded examples для чтения PSSR без преждевременных claims.",
      "purpose": "Worked examples for allowed and blocked interpretations.",
      "allowed_use": "Use examples to explain normal, stress and data-degraded readings.",
      "forbidden_inference": "Do not treat examples as live incidents or forecasts.",
      "freshness": "Static training examples."
    },
    "engine_model": {
      "url": "https://pssr.site/engine-model/",
      "title": "Engine model – PSSR",
      "summary": "Публичная схема runtime PSSR: regime, PRS, SSS, confidence, quality weakening и state machine boundary.",
      "purpose": "Explain public runtime fields without exposing protected formulas or data.",
      "allowed_use": "Use to interpret regime, PRS, SSS, confidence and quality weakening.",
      "forbidden_inference": "Do not infer raw rows, private weights or operator materials.",
      "freshness": "Static runtime-reading contract linked to public model-card."
    },
    "review_workflow": {
      "url": "https://pssr.site/review-workflow/",
      "title": "Review workflow – PSSR",
      "summary": "Read-only operator workflow для проверки PSSR без раскрытия protected Cockpit data.",
      "purpose": "Public explanation of human review steps and escalation states.",
      "allowed_use": "Use to describe how humans should check PSSR before acting.",
      "forbidden_inference": "Do not expose or reconstruct protected workspace notes.",
      "freshness": "Static public workflow summary."
    },
    "next_version": {
      "url": "https://pssr.site/next-version/",
      "title": "Next version – PSSR",
      "summary": "v10.4-RC1, recovered materials, migration map и границы research candidate.",
      "purpose": "Summarise v10.4-RC1, recovered materials and migration boundary.",
      "allowed_use": "Use as a non-canonical research-candidate map.",
      "forbidden_inference": "Do not treat v10.4-RC1 as released canon or current runtime formula.",
      "freshness": "Static summary; canonical details remain in KB next-version package."
    },
    "geo": {
      "url": "https://pssr.site/geo/",
      "title": "Geo readiness – PSSR",
      "summary": "Публичный статус QazGeo в PSSR без публикации региональных risk scores.",
      "purpose": "Explain QazGeo readiness and the regional-score boundary.",
      "allowed_use": "Use to find safe geo status and region-directory API references.",
      "forbidden_inference": "Do not publish or infer regional risk scores before validation gate passes.",
      "freshness": "Static boundary plus live geo status and regions API."
    },
    "versions": {
      "url": "https://pssr.site/versions/",
      "title": "Версии и контуры – PSSR",
      "summary": "Как связаны PSSR KB v10.3.1, текущий Regime Engine runtime, Cockpit и исследовательский кандидат v10.4-RC1.",
      "purpose": "Separate KB canon, Engine runtime, Cockpit and v10.4-RC1.",
      "allowed_use": "Use to prevent version-contour merging.",
      "forbidden_inference": "Do not merge readiness statuses across KB, Engine and candidate versions.",
      "freshness": "Static page with current build release evidence."
    },
    "methodology": {
      "url": "https://pssr.site/methodology/",
      "title": "Как читать PSSR",
      "summary": "Понятное объяснение методологии, индексов, неопределённости и человеческой проверки PSSR.",
      "purpose": "Plain-language methodology entrypoint.",
      "allowed_use": "Use to explain PSSR concepts and reading discipline.",
      "forbidden_inference": "Do not replace KB formulas or validation package with this summary.",
      "freshness": "Static public explanation."
    },
    "architecture": {
      "url": "https://pssr.site/architecture/",
      "title": "Архитектура – PSSR",
      "summary": "Техническая архитектура и границы публичного сайта, PSSR Cockpit, Regime Engine, KB, Electoral OS и CommStrat.",
      "purpose": "Map PSSR surfaces, adjacent systems and ownership boundaries.",
      "allowed_use": "Use to route architecture and integration questions.",
      "forbidden_inference": "Do not expose protected Cockpit or Engine data.",
      "freshness": "Static architecture map."
    },
    "status": {
      "url": "https://pssr.site/status/",
      "title": "Источники и качество – PSSR",
      "summary": "Покрытие, ограничения и техническая доступность данных текущего расчёта PSSR.",
      "purpose": "Operational status and data-quality context.",
      "allowed_use": "Use to evaluate source freshness and degraded modes.",
      "forbidden_inference": "Do not assume live data are complete when status is degraded.",
      "freshness": "Depends on public Engine status APIs."
    },
    "responsible_use": {
      "url": "https://pssr.site/responsible-use/",
      "title": "Ответственное использование – PSSR",
      "summary": "Правовой и редакционный статус аналитических материалов PSSR, ограничения и порядок исправлений.",
      "purpose": "Rules for safe public interpretation, corrections and limits.",
      "allowed_use": "Use to frame legal/editorial cautions.",
      "forbidden_inference": "Do not remove human responsibility or correction requirements.",
      "freshness": "Static policy page."
    },
    "contact": {
      "url": "https://pssr.site/contact/",
      "title": "Связаться с PSSR",
      "summary": "Каналы связи, порядок сообщения об ошибках и безопасные границы обратной связи PSSR.",
      "purpose": "Safe feedback and correction channel.",
      "allowed_use": "Use to route public issue reports and methodology questions.",
      "forbidden_inference": "Do not send personal, protected or raw source data through public feedback.",
      "freshness": "Static contact page."
    }
  },
  "version_boundaries": {
    "knowledge_base": {
      "canonical_version": "v10.3.1",
      "role": "theory and methodology"
    },
    "engine_runtime": {
      "formula_family": "hybrid-v9.3-v10.1",
      "role": "current public runtime contract"
    },
    "next_candidate": {
      "version": "v10.4-RC1",
      "status": "research candidate, not canon"
    }
  },
  "privacy": {
    "never_public": [
      "raw source rows",
      "personal data",
      "protected workspace notes",
      "authenticated Electoral OS data"
    ]
  },
  "corrections": "https://github.com/belilovsky/pssr/issues/new"
}