ONS Open Knowledge Format

okf-ons — это слой обнаружения, содержащий только метаданные, для публичной статистики, предоставляемой через сервисы Office for National Statistics. Он предназначен для того, чтобы помочь человеку или агенту найти точный набор данных, увидеть легко перепутываемые альтернативы, понять доступные доказательства статистического качества и подготовить неисполняемый план-кандидат, который нижестоящий сервис должен проверить в реальном времени и авторизовать перед получением.

Проект намеренно разделяет четыре задачи:

1. Статический пакет OKF обнаруживает и объясняет наборы данных, версии, измерения, происхождение, доказательства соответствия стандартам и альтернативы.

2. OKF Explorer сужает и сравнивает большой статический корпус без LLM или размещенного поискового сервиса.

3. Локальный MCP-брокер репозитория предоставляет AI-клиентам ограниченный доступ к тем же замороженным метаданным и готовит неисполняемый план выбора.

4. Нижестоящий MCP-сервер с живыми данными выполняет запрос ONS или Nomis только после завершения необходимых выбора, специфичных для набора данных.

Локальный брокер не является нижестоящим сервером с живыми данными: он не совершает сетевых вызовов и не возвращает значений наблюдений. В пакете не хранятся наблюдения, ключи API или частные данные.

Ядро OKF 0.2 и расширения Explorer

Пакет, включённый в репозиторий, нацелен на Open Knowledge Format 0.2. Его сгенерированное переносимое ядро начинается с index.md, который объявляет okf_version: "0.2" и последовательно ссылается на типизированные концепции для каталога, замороженного снимка, четырёх исходных каналов, состояния поставщика, управления, стандартов и выбора MCP.

Каждая концепция использует generated и sources. Никакое событие verified не заявляется: автоматические проверки доказывают структурное соответствие и целостность замороженных входных данных, а не человеческую проверку или статистическую истину. Никакое значение stale_after не выдумывается, пока управляемая политика свежести остаётся неопределённой. Таким образом, статус жизненного цикла является явным, и живое выполнение по-прежнему требует повторной проверки поставщиком.

Дескриптор большого корпуса, JSON/YAML-LD, статический поиск, фасеты, связи, федерация, каталоги целостности и пакеты данных поставщика остаются аддитивными расширениями Explorer. Новые концепции также сохраняют запасные варианты v0.1 timestamp и # Citations, чтобы старые потребители могли продолжать обнаружение с максимальными усилиями, в то время как потребители v0.2 предпочитают generated и sources.

Related MCP server: ONS + Nomis MCP server

Доступ и документация

Это канонические точки входа для развёртывания Pages из main. Неизменяемый релиз приложения v0.2.0 предшествует миграции на спецификацию OKF 0.2 и остаётся доступным как историческое свидетельство релиза.

Живой и машиночитаемый доступ

Подчинённые шарды наборов данных, ресурсов, поиска и вариантов выбора обнаруживаются через указанные выше манифесты данных и поиска; их сгенерированные пути не являются независимыми стабильными точками входа.

Репозитории, релиз и происхождение

• Репозиторий OKF-ONS, все релизы GitHub, и релиз v0.2.0

• Неизменяемые загрузки v0.2.0: ZIP-пакет и SHA-256 дайджест

• Репозиторий OKF Explorer

• Зафиксированный коммит ONSdigital Explore Local Statistics

• Реестр источников, метаданные публикации OKF, манифест снимка релиза, текущий манифест снимка обогащения, и журнал изменений релиза

Карта документации

• Продукт и демонстрация: руководство по демо, контракт на продукт, краткое описание хакатона ONS и заявление о доступности

• Эксплуатация репозитория: руководство по репозиторию, политика безопасности, журнал изменений релиза и рабочий процесс публикации CI; фрагмент изменений для AI-клиента сохранён как предрелизная история

• Метаданные и гарантии: модель метаданных, область охвата и знаменатель и реестр стандартов, а также кампания по обогащению метаданных с ограничением по времени и передача кампании OKF Explorer, с машиночитаемым аудитом остановки

• MCP и AI-доступ: контракт выбора MCP, развёртывание MCP-клиента и предложение по доступу агентов и оценке

• Оценка: метод оценки, анализ межклиентских испытаний и машиночитаемые исследование, реестр клиентов, задачи, ожидаемые результаты, персоны и сценарии, реестр проблем и эталонные запросы

• Исследования и коммуникации: реестр исследований, манифест исследовательских доказательств, манифест архитектуры, промпт для исследования управляемого ИИ, отчёт по архитектуре управляемого ИИ и черновик публикации

• Датированные записи исследований AI-клиента: трассировка доступа Claude Desktop, брифинг Antigravity и посмертный анализ Antigravity

• Переносимые результаты исследований: трассировка Claude в DOCX, брифинг по доступу M365 в DOCX, исследование хостинга M365 в DOCX, презентация по управляемому ИИ, презентация по корпоративному ИИ и визуализация моста обнаружения

OKF Explorer может загрузить пакет уже сегодня по прямой ссылке выше. Рекомендуется отдельное обновление реестра и представления Explorer, чтобы пакет предлагался без вставки его URL, а новые поля авторитета, прав и управления отображались как первоклассный интерфейс, а не только в сыром JSON.

Поддержка SDMX

Пакет регистрирует SDMX 3.1 (ISO 17369), сопоставляет семь канонических полей OKF с концепциями SDMX и сохраняет агентство, идентификатор, версию, порядок измерений, роли компонентов и ссылки на списки кодов SDMX для полосы Nomis. Выборки Nomis также сохраняют ограниченные варианты кодов-меток FREQ и строгие доступные диапазоны TIME, где эти доказательства применимы. FREQ — это статистическая/справочная частота, а не периодичность публикации, а аннотации пересмотра периодов TIME не являются статусом пересмотра набора данных. Все остальные обязательные измерения всё ещё требуют живой валидации и выбора; завершённое живое выполнение использует nomis_query из MCP-Geo.

Пакет сам по себе не является сообщением SDMX. Он сериализован как JSON-LD с использованием терминов DCAT 3, SKOS, PROV-O и RDF Data Cube, без пространства имён SDMX в его контексте. Сгенерированный data/standards/sdmx.json сообщает точное сопоставление и количество доказательств Nomis, не утверждая соответствие или сертификацию вышестоящего уровня.

Демонстратор понедельника

Предхакатонный демонстратор заморожен, чтобы презентация в понедельник могла использовать воспроизводимый, проверяемый снимок, а не изменяющиеся живые приобретения. Он публикует:

• реестр источников и охвата, который делает неполноту явной;

• замороженный снимок метаданных из 5 097 записей из ONS Data API (337), Nomis (1 617), ONS Open Geography (3 035) и ONS Explore Local Statistics (108);

• квалифицированные роли производителя источника, оператора сервиса, издателя пакета и семантического авторитета с явным отсутствием одобрения;

• детерминированный поиск и первоклассные фильтрующие публикации;

• подтверждённые доказательствами альтернативные/контрастные отношения;

• точное согласование кодов таблиц переписи между ONS Data API и Nomis;

• доказательства статистического качества и стандартов без ложных заявлений о гарантиях;

• контракт плана выбора MCP; и

• воспроизводимый отчёт об оценке извлечения и качества метаданных.

Неизменяемый идентификатор снимка monday-2026-07-17-r2 расширяет заморозку пятницы 17 июля закреплённой проекцией метаданных ELS. Суффикс r2 предотвращает повторное использование исходной идентичности снимка v0.1 расширенным корпусом; «monday» — это имя демонстратора, а не утверждение, что 17 июля был понедельник.

Полоса Explore Local Statistics — это детерминированная проекция закреплённого подмодуля приложения, допускающая только разрешённые элементы. Она содержит 108 показателей, курируемых ONS, от 24 атрибутированных производителей, объясняет 12 неопубликованных записей манифеста, сохраняет 46 допустимых исторических псевдонимов и удаляет значения наблюдений, массивы статусов, домены значений, двоичные данные и геометрию. Это среда разработки, а не утверждение, что внутренний API ELS является стабильным публичным контрактом выполнения. Его проверенный Git commitAsOf хранится отдельно от времени приобретения; замороженный фикстур не выдумывает временную метку извлечения, которая не была записана.

Пакет также публикует датапак поставщика, который делает различие между снимком ELS и живым состоянием видимым, не ослабляя воспроизводимость. Управляемый снимок остаётся закреплённым на 795eaf2 от 17 июля 2026 года. Отдельно проверенная вышестоящая ссылка на d5f0ac9 фиксирует известное примерное различие: средняя цена дома заканчивается в апреле 2026 года в снимке и в мае 2026 года в проверенной ссылке. Эта ссылка последний раз проверялась 23 июля 2026 года, она явно внешняя и не является живой валидацией. Её сравнение — это неисчерпывающий проверенный пример, а не утверждение, что все 108 показателей были сравнены. Дескриптор хеширует манифест поставщика, а манифест хеширует пакет, поэтому датированная проверка не может быть заменена под тем же идентификатором снимка без сбоя проверок целостности Explorer. См. контракт датапака поставщика.

Этот экспериментальный пакет независимо публикуется проектом OKF ONS. Атрибуция источника не подразумевает одобрения со стороны ONS или другого производителя.

Сборка

Требуется Python 3.11 или новее. Рекурсивный клон обязателен, поскольку обычные архивы исходников GitHub не содержат закреплённый подмодуль ELS. ZIP-архив релизного пакета, указанный выше, является самодостаточным артефактом публикации.

okf.publication.json фиксирует контракт v1 метода публикации репозитория: замороженные семейства источников, границы авторского и сгенерированного контента, плоскости зависимостей, проверенные объявления команд, синхронизацию документации и цель Pages. Строки команд в контракте являются недоверенными объявлениями и должны быть проверены по этому руководству перед использованием. Проверьте локальные пути, перекрёстные ссылки и ациклический граф плоскостей с помощью:

python scripts/check_publication_contract.py

Изменения в контролируемых путях исходников, генератора, приложения или рабочего процесса должны обновлять соответствующую документацию и CHANGELOG.md в том же изменении. Неизвестные пути закрываются с ошибкой, и для обновлений зависимостей нет всеобъемлющего исключения.

Рабочий процесс Pages один раз собирает игнорируемый каталог bundle/, затем проверяет, собирает и загружает те же байты рабочего пространства. Чистая предварительная сборка --check невозможна, поскольку не отслеживается базовый сгенерированный пакет. Введение отдельного неизменяемого базового уровня или релизного артефакта — это задокументированный будущий вариант; рабочий процесс не выполняет вторую идентичную сборку только для сравнения результата с самим собой.

Чтобы воспроизвести v0.2.0 из его зафиксированного замороженного снимка:

git clone --recurse-submodules --branch v0.2.0 \
  https://github.com/chris-page-gov/okf-ons.git
cd okf-ons
python scripts/project_els_snapshot.py \
  --submodule-dir vendor/explore-local-statistics-app \
  --output output/ons-explore-local-statistics.json
cmp output/ons-explore-local-statistics.json \
  source/demo-snapshot/ons-explore-local-statistics.json
python scripts/build_bundle.py \
  --snapshot-dir source/demo-snapshot \
  --output bundle
python scripts/build_bundle.py \
  --snapshot-dir source/demo-snapshot \
  --output bundle \
  --check
python scripts/check_okf_v02.py bundle

Кампания по обогащению метаданных также включает неизменяемый последующий снимок metadata-enrichment-2026-07-21-r6. Относительно снимка v0.2.0, r3 обновляет ограниченный каталог ONS Data API, r4 добавляет ограниченные компактные обзоры Nomis только с метаданными, а r5 добавляет только проверенную проекцию измерений из каждого замороженного URL последней версии ONS. r6 следует точным ссылкам на списки кодов FREQ и TIME в замороженной когорте Nomis r5 и сохраняет только метаданные кодов-меток и явные аннотации статуса пересмотра периодов. Обёртки источников ONS Data API, Explore Local Statistics и Open Geography в r6 байт-идентичны r5. Пересоберите и профилируйте r6 без доступа к сети:

python scripts/build_bundle.py \
  --snapshot-dir source/metadata-enrichment-2026-07-21-r6 \
  --output bundle
python scripts/build_bundle.py \
  --snapshot-dir source/metadata-enrichment-2026-07-21-r6 \
  --output bundle \
  --check
python scripts/profile_metadata_gaps.py \
  --bundle bundle \
  --output evaluation/metadata-completeness/current.json

Живые URL Pages и Explorer выше по-прежнему обслуживают управляемый релиз v0.2.0. Снимок кампании r6 зафиксирован как управляемое доказательство кампании, но остаётся неразвёрнутым кандидатом на релиз, пока метаданные релиза и выбранный снимок Pages не будут намеренно переключены.

Измеренная история пакетов, определения метрик, тайминги и машиночитаемые профили связаны из кампании по обогащению метаданных, включая аудит остановки.

Для существующего клона выполните git submodule update --init --recursive перед проектором. Чтобы получить будущий снимок, храните сырой кэш вне репозитория, используйте --mode refresh и выберите новую неизменяемую идентичность — никогда не перезаписывайте существующий снимок. Чтобы обновить только каталог ONS, перенося другие проверенные обёртки источников вперёд:

python scripts/acquire_snapshot.py \
  --cache-dir /path/to/raw-cache \
  --output-dir source \
  --snapshot-id NEW_UNIQUE_SNAPSHOT_ID \
  --base-snapshot source/metadata-enrichment-2026-07-21-r4 \
  --source ons-data-api \
  --mode refresh \
  --page-size 1000 \
  --maximum-pages 1 \
  --require-complete

Чтобы воспроизвести или обновить ограниченные компактные обзоры Nomis, используйте проверенный предварительно обогащённый снимок r3 в качестве основы: заменяющие обёртки привязаны по дайджесту к этой точной когорте, а снимки обогащения не связываются как базы приобретения. Сначала выполните приобретение во внешнюю заменяющую обёртку, затем составьте эту обёртку поверх r3. Скрипт приобретения независимо выводит свою когорту из замороженного источника Nomis и не публикует ни сырые ответы, ни пути кэша:

python scripts/acquire_nomis_overviews.py \
  --snapshot-dir source/metadata-enrichment-2026-07-21-r3 \
  --cache-dir /path/to/raw-cache \
  --output /path/to/nomis-overviews.json \
  --limit 1617 \
  --mode refresh \
  --request-interval 0.2
python scripts/acquire_snapshot.py \
  --cache-dir /path/to/raw-cache \
  --output-dir source \
  --snapshot-id NEW_UNIQUE_SNAPSHOT_ID \
  --base-snapshot source/metadata-enrichment-2026-07-21-r3 \
  --replacement-acquisition /path/to/nomis-overviews.json \
  --require-complete

Чтобы воспроизвести или обновить ограниченную проекцию измерений последней версии ONS, используйте r4 в качестве проверенной предварительно обогащённой основы. Приобретение следует только 337 точным значениям links.latest_version.href, замороженным в r4, сохраняет только разрешённую проекцию во внешнем кэше и не загружает наблюдения, опции измерений, списки кодов или загрузки:

python scripts/acquire_ons_version_metadata.py \
  --snapshot-dir source/metadata-enrichment-2026-07-21-r4 \
  --cache-dir /path/to/external-cache \
  --output /path/to/ons-version-metadata.json \
  --limit 337 \
  --mode refresh \
  --request-interval 0.5
python scripts/acquire_snapshot.py \
  --cache-dir /path/to/external-cache \
  --output-dir source \
  --snapshot-id NEW_UNIQUE_SNAPSHOT_ID \
  --base-snapshot source/metadata-enrichment-2026-07-21-r4 \
  --replacement-acquisition /path/to/ons-version-metadata.json \
  --require-complete

Чтобы воспроизвести или обновить ограниченную проекцию списков кодов FREQ/TIME Nomis, используйте r5 в качестве точной основы. Приобретение последовательно следует 3 234 замороженным ссылкам на списки кодов только с метаданными, сохраняет явные неудачные результаты в знаменателе и сохраняет только свою разрешённую проекцию в версионированном внешнем кэше:

python scripts/acquire_nomis_codelists.py \
  --snapshot-dir source/metadata-enrichment-2026-07-21-r5 \
  --cache-dir /path/to/external-cache \
  --output /path/to/nomis-codelists.json \
  --limit 1617 \
  --mode refresh \
  --request-interval 0.2
python scripts/acquire_snapshot.py \
  --cache-dir /path/to/external-cache \
  --output-dir source \
  --snapshot-id NEW_UNIQUE_SNAPSHOT_ID \
  --base-snapshot source/metadata-enrichment-2026-07-21-r5 \
  --replacement-acquisition /path/to/nomis-codelists.json \
  --require-complete

Для полного обновления зарегистрированного источника сначала создайте закреплённую локальную проекцию ELS, затем выполните приобретение всех HTTP-полос и включите её:

python scripts/project_els_snapshot.py \
  --submodule-dir vendor/explore-local-statistics-app \
  --output /path/to/els-projection.json
python scripts/acquire_snapshot.py \
  --cache-dir /path/to/raw-cache \
  --output-dir /path/to/public-snapshots \
  --snapshot-id NEW_UNIQUE_SNAPSHOT_ID \
  --mode refresh \
  --projected-acquisition /path/to/els-projection.json \
  --require-complete

Приобретение возобновляемо и внешнее. bundle/ детерминирован из проверенного замороженного снимка.

Отправляемый краткий обзор хакатона ONS объясняет рабочий пакет, маршрут демо и вопросы для ONS. См. также реестр стандартов, метод оценки и область охвата и знаменатель.

Исследования и оценка AI-доступа

Репозиторий сохраняет и SHA-256-пиннирует испытания от 18 июля 2026 года, проведённые с Claude Desktop Cowork, Google Antigravity CLI и Microsoft 365 Copilot Researcher, в research/. Публикуются только технически проверенные, очищенные публичные производные DOCX. Оригинальные пакеты Office не включаются в Git и идентифицируются только по закреплённым хэшам исходников. Нормализованные наблюдения сохраняют различие между публичными производными, заявленной в сеансе идентичностью, последующей проверкой и нашими интерпретациями.

Тематическое исследование теперь закладывает основу для провайдер-нейтрального, безопасного для фикстур каркаса:

python3 scripts/ai_client_harness.py validate
python3 scripts/ai_client_harness.py validate-research
python3 scripts/ai_client_harness.py clients --initial-only
python3 scripts/ai_client_harness.py probe-clients
python3 scripts/ai_client_harness.py tasks

Каркас определяет ветви OKF, открытого веба и raw-API; восемь задач для смоук-тестирования разработки; шесть персонажей, специфичных для ONS, и восемь путешествий; реестр из десяти наблюдаемых проблем; общий структурированный ответ; независимую оценку, привязанную к ответу; детерминированную оценку компонентов; разделение принудительного и самоотчётного; и отдельные результаты готовности, чтобы заблокированный клиент не оценивался как неверный ответ. CI не выполняет живых, аутентифицированных или платных вызовов моделей.

Независимый от зависимостей, только метаданные MCP-брокер теперь предоставляет детерминированные инструменты дескриптора, поиска, точной записи, сравнения, MCP-плана только для чтения и отправки ответов. Antigravity CLI (agy) может загрузить его из ограниченного репозиторием .agents/mcp_config.json. Эта конфигурация была добавлена после сохранённого испытания Antigravity; никакого нового платного или живого запуска модели не заявляется. Брокер использует замороженный корпус, не совершает сетевых вызовов, не хранит учётные данные и не возвращает значений наблюдений.

Карта подключения ИИ-систем

Руководство по развёртыванию MCP является каноническим руководством по настройке и статусу для каждой ИИ-поверхности в реестре оценки. Оно различает четыре уровня доступа и развёртывания:

• Доступ к статическому пакету: любой разрешённый HTTP-клиент может читать дескриптор Pages и JSON, но нативные ограничения fetch различаются в зависимости от хоста.

• Локальный метаданный MCP: клиенты командной строки и настольные клиенты, поддерживающие локальный stdio MCP, могут запускать scripts/okf_ons_mcp.py. Зафиксированная конфигурация рабочего пространства AGY является единственной клиентской конфигурацией, ограниченной репозиторием; руководство даёт отдельные маршруты для Codex, Claude, Gemini, VS Code/Copilot и Inspector, не рассматривая установку как успешное испытание.

• Планируемый удалённый метаданный MCP: пользовательские приложения ChatGPT требуют поддерживаемой удалённой конечной точки или туннельного маршрута; Claude Research, Cowork с удалённым сеансом и Microsoft 365 Copilot Researcher требуют аутентифицированной удалённой конечной точки. Настольный локальный Cowork может использовать локальный MCP с учётом политики устройства. Этот репозиторий не развёртывает ни удалённую конечную точку, ни туннель. Маршрут федеративного коннектора M365 задокументирован, но он не был создан или включён для тенанта.

• Нисходящий живой MCP: после завершения выбора отдельная интеграция ONS или Nomis может выполнить план. Репозиторный брокер намеренно никогда этого не делает.

Машиночитаемый client-profiles.json является полным реестром клиентов из 16 профилей; study.json закрепляет дизайн оценки. Публичные tasks.json, personas-and-journeys.json и issue-register.json держат задачи, пользователей, путешествия, наблюдаемые сбои и исправления в синхронизации с этим дизайном.

См. кросс-клиентский анализ испытаний для получения доказательств, матрицы проблема/исправление, персонажей, протокола эффективности и приоритизированных рабочих пакетов.

Что означает «все»

Репозиторий может описывать себя как покрывающий все публичные метаданные ONS только тогда, когда каждый источник, входящий в область действия в source/source-register.json, имеет измеренный знаменатель, а сгенерированный реестр покрытия сообщает unexplained_omissions = 0.

Ячейки наблюдений, защищённые микроданные и дублирующиеся бинарные полезные нагрузки намеренно исключены из области действия. См. область действия и знаменатель.

Лицензирование

Код лицензирован по MIT. Метаданные источников остаются подчиненными указанной вышестоящей лицензии, часто Open Government Licence v3.0. Пакет не делает общих заявлений о лицензировании: права на записи ELS остаются not-evaluated до посуточного рассмотрения, а сгенерированные записи сохраняют доступные доказательства источника и прав.