revise March 2025 knowledge retrieval articles

editorial/reviews/2025-03-draft.md

@@ -0,0 +1,175 @@
+# P85 — март 2025: поиск по инженерной базе знаний
+
+## Область draft-пакета
+
+Пакет заменяет только три overlay-статьи:
+
+- <code>editorial-2025-03-practice-knowledge-retrieval</code> — «Поиск по инженерной базе: источник важнее уверенного пересказа».
+- <code>editorial-2025-03-mechanism-knowledge-retrieval</code> — «Почему vector score не делает документ доказательством».
+- <code>editorial-2025-03-field-knowledge-retrieval</code> — «Когда поиск обязан остановиться: нет цитаты — нет ответа».
+
+Единственный исполняемый артефакт — <code>web/scripts/upgrade-2025-03.mjs</code>.
+Все records, scores, labels доступа, timestamps, expiry, URI, anchors, excerpts,
+reports, citations и decisions внутри него являются fixed synthetic in-memory
+значениями. Скрипт не читает и не пишет files, Git, network, CI, clock,
+telemetry, production, user data и не выполняет external search. Его
+<code>synthetic://</code> citations не выданы за реальные документы.
+
+Пакет не меняет registry, README, очередь, <code>articles.json</code>,
+app-страницы, staging, commit, push или full build. Это самостоятельный draft
+для последующей интеграции.
+
+## Исследование и историческая граница
+
+Проверка URL выполнена 31.07.2026 обычными HTTPS-запросами
+<code>curl -L --fail</code> / <code>curl -I -L --fail</code>, без TLS bypass и
+без авторизации. Текущая доступность не подменяет историческую дату: для каждого
+источника ниже есть версия, RFC или immutable commit, существовавшие до марта
+2025.
+
+| Источник | Историческое закрепление | Узко подтверждаемое утверждение | Граница утверждения |
+| --- | --- | --- | --- |
+| [OpenSearch k-NN README](https://raw.githubusercontent.com/opensearch-project/k-NN/150c589849a8ec3bc442d830b43a3eaf4e25fa0c/README.md) | tag <code>2.15.0.0</code>, immutable commit <code>150c589849a8ec3bc442d830b43a3eaf4e25fa0c</code>, commit date 12.06.2024 | k-NN предназначен для nearest-neighbor similarity search; README упоминает filters для уточнения similarity search. | Не подтверждает истинность claim, свежесть source, право reader на fragment, полноту corpus или качество конкретного ranker. |
+| [RFC 9110, §8.8.2](https://www.rfc-editor.org/rfc/rfc9110.html#section-8.8.2) | IETF Standards Track RFC, June 2022 | <code>Last-Modified</code> сообщает время, в которое origin server считает selected representation изменённым; способ вычисления остаётся implementation detail. | HTTP metadata не доказывает semantic correctness текста, owner, права доступа или отсутствие более новой редакции. |
+| [NIST SP 800-207 PDF](https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-207.pdf) | dated final publication, 2020-08-11 | authentication и authorization описаны как отдельные функции до сессии к enterprise resource; неявное доверие по сетевому положению не предполагается. | Это не retrieval design, не схема labels и не готовая access policy для базы знаний. |
+
+Вывод «vector score не доказывает истину» отмечен в статьях как собственный
+инженерный вывод. Он следует из того, что ranking, access, freshness,
+citability и human verification отвечают на разные вопросы; он не приписан
+OpenSearch, RFC или NIST как формальная гарантия.
+
+## Проход 1 — факты, техника и границы
+
+**Проверена модель.**
+
+- <code>createFixedSyntheticKnowledgeRetrievalInput</code> принимает case id и
+  возвращает строго shaped input для fixed corpus.
+- В corpus есть version, access labels, publishedAt, indexedAt, expiresAt,
+  synthetic URI, exact anchor, excerpt и score. Output отдельно содержит
+  candidate records, reject reasons и citations.
+- <code>inspectFixedSyntheticKnowledgeRetrieval</code> пропускает в citation
+  только active, allowed, fresh и anchor-addressable record. Один score не
+  снимает ни одно из этих условий.
+- <code>prepareSyntheticKnowledgeHumanReview</code> создаёт лишь in-memory
+  review draft. Даже accepted citation получает статус
+  <code>requires-human-verification</code>, а не заверенный факт.
+- <code>stopSyntheticKnowledgeAnswer</code> discard-ит только accepted
+  in-memory review draft и возвращает <code>productionEffect:
+  not-attempted</code>. Это не withdrawal реального ответа и не изменение
+  источника.
+
+**Проверены отрицательные ветки.**
+
+| Случай | Fixed record | Ожидаемое решение | Проверяемая причина |
+| --- | --- | --- | --- |
+| freshness | <code>synthetic-adapter-guideline-v1</code>, score 0.97 | не становится citation | <code>expired-at-fixed-retrieval-time</code> |
+| access | <code>synthetic-security-override-v2</code>, score 0.99 | не становится citation | <code>access-label-not-granted</code> |
+| citation | <code>synthetic-note-without-anchor-v1</code> | не становится citation | <code>missing-exact-citation-anchor</code> |
+| stale-only / closed-only corpus | один неразрешённый candidate | answer stops | <code>stop-no-fresh-authorized-citable-source</code> |
+| forged / sparse / cyclic objects | не совпадают с canonical fixed output | review / stop rejects object | нет доступа к произвольным input или report |
+
+Fixture намеренно проверяет shape, dense arrays, unknown case, extra input
+field, forged timestamp, frozen fixed corpus, forged report, sparse citations,
+циклические input/report и отсутствие external effects. Она не проверяет
+качество реального embedding, реальный identity check, HTTP fetch, corpus
+полноту или production outcome.
+
+**Вердикт прохода 1:** пройдено. Утверждения об источниках ограничены их
+содержанием; example не использует реальные данные и не делает score
+доказательством истины.
+
+## Проход 2 — редактура, голос и плотность
+
+Март 2025 соответствует уровню М8: автор ведёт от наблюдаемого симптома к
+стоимости, владельцу policy, проверяемому контракта и небольшому маршруту
+внедрения. Речь сохраняет формулу «симптом → причина → проверка → действие»,
+не объявляет fixed model реальными данными и не обещает универсальный RAG
+процесс.
+
+| Статья | Проблема и цена ошибки в первых двух абзацах | Основной текст | Практический артефакт | Проверяемый финал |
+| --- | --- | ---: | --- | --- |
+| practice | Релевантная запись может быть expired, closed или без anchor; цена — неверная миграция, раскрытие fragment или невозможность проверить правило. | 10 124 знака | source-record contract, маршрут filtering, fixed fixture | Удалить одно metadata поле и получить явную stop condition. |
+| mechanism | High-score document может описывать прежний contract; цена — повторное расследование и потеря доверия к базе. | 10 920 знаков | matrix signals, strict candidate output, filter order | Добавить один rejection test для expired / denied candidate. |
+| field | Search может найти только closed или stale source; цена — неверная миграция, disclosure или неразрешимый спор о правиле. | 10 952 знака | structured stop path, comparison table, human-review card | Создать test: top-score candidate не допускается к answer без citation. |
+
+Редакторская вычитка:
+
+- В каждом из первых двух <code>&lt;p&gt;</code> явно названы problem и
+  <strong>цена ошибки</strong>. Это повторно подтверждено усиленным
+  <code>audit:draft</code>.
+- В каждой статье есть HTML-table, figure с meaningful <code>alt</code> и
+  caption, компактный воспроизводимый example, limitation, next step и не
+  меньше двух первичных/официальных источников.
+- Длинные технические термины привязаны к полю, decision или fragment:
+  score, access labels, publishedAt, indexedAt, expiresAt, URI#anchor и human
+  verification не оставлены декларациями.
+- Source fact и policy автора разнесены явно. Ни fixed timestamps, ни
+  synthetic URI, ни scores не выданы за telemetry или реальный corpus.
+- Убраны повторы в полевой статье: объём снижен с 13,5 тыс. до 10,95 тыс.
+  знаков без потери table, stop path, limitation или next action.
+
+**Вердикт прохода 2:** пройдено. Три текста остаются в диапазоне 5–15 тыс.
+знаков и целевом диапазоне 8–11 тыс. с допустимым отклонением field-текста до
+10,95 тыс.; тон 2025 года наставнический, но технический и не стратегический.
+
+## Проход 3 — SVG, fixture и выпуск
+
+Проверены три собственных SVG:
+
+| Asset | Смысл | Проверка 375 px |
+| --- | --- | --- |
+| <code>knowledge-retrieval-2025-query-retrieval-citation.svg</code> | index → retrieval → access/freshness → exact citation → human verification | Первый render обнаружил обрезанные длинные подписи. Подписи сокращены, повторный Sharp-render читаем, STOP path виден полностью. |
+| <code>knowledge-retrieval-2025-freshness-access-matrix.svg</code> | matrix допуска: high-score expired, closed и no-anchor records отвергаются | Колонки и footer читаемы на 375 px; нет обрезания справа. |
+| <code>knowledge-retrieval-2025-verification-loop.svg</code> | human verification loop и видимая stop ветка | Первый render обнаружил длинные labels в карточках; после сокращения все пять шагов и STOP card читаемы на 375 px. |
+
+Последовательность проверок:
+
+- <code>node --check scripts/upgrade-2025-03.mjs</code> — PASS.
+- <code>node scripts/upgrade-2025-03.mjs --verify-fixture</code> — PASS,
+  <strong>34/34</strong> assertions.
+- <code>npm run audit:draft -- scripts/upgrade-2025-03.mjs</code> — PASS для
+  всех трёх slug, включая усиленное требование о цене ошибки в первых двух
+  <code>&lt;p&gt;</code>.
+- <code>xmllint --noout</code> для трёх SVG — PASS.
+- SVG safety scan — чисто: нет <code>script</code>,
+  <code>foreignObject</code>, <code>javascript:</code>,
+  <code>data:image</code> и event-handler attributes.
+- Sharp render на ширине 375 px и ручной visual review — PASS после одного
+  исправления copy length в каждом из трёх SVG.
+
+Full build намеренно не запускался. Registry, production README, очередь,
+стадия Git, commit и push намеренно не менялись. Это не освобождает будущего
+интегратора от <code>audit:articles</code>, production build и отдельной
+проверки registry, но сохраняет независимость P85 draft-пакета.
+
+**Вердикт прохода 3:** пройдено для draft-пакета. Публикация не выполнена.
+
+## Выпуск после независимой приёмки
+
+Основной редактор повторил три прохода после подключения overlay:
+
+1. **Факты и техника.** Закреплённый README OpenSearch k-NN по commit
+   <code>150c589849a8ec3bc442d830b43a3eaf4e25fa0c</code> подтверждает дату
+   12 июня 2024, nearest-neighbor similarity search и фильтры для уточнения
+   результатов. RFC 9110 §8.8.2 определяет `Last-Modified` как timestamp,
+   который origin server считает датой изменения selected representation, и
+   называет способ вычисления implementation detail. NIST SP 800-207
+   подтверждает отдельные dynamic authentication/authorization checks до
+   доступа к enterprise resource. Статья корректно оставляет правило о том,
+   что score не является доказательством, собственным инженерным выводом.
+   Fixture проходит **34/34**.
+2. **Редактура и голос.** Полные тела перечитаны: в первых двух абзацах
+   названы риск и цена ошибочной цитаты, а значение score, дат, label,
+   URI#anchor и human verification раскрыто рядом с действием. Три текста не
+   обещают RAG-платформу и не имитируют реальный corpus. Усиленный
+   `audit:draft` подтвердил 10 124 / 10 920 / 10 952 знака и структурную
+   полноту.
+3. **Визуал и выпуск.** Три SVG повторно отрисованы Sharp и просмотрены на
+   375 px: query → citation — 375×513, freshness/access matrix — 375×464,
+   verification loop — 375×488. Карточки, стрелки, reject reasons и STOP
+   остаются читаемыми; XML и safety scan чисты. Целевой аудит подтверждает
+   рисунок, код и минимум две таблицы в каждой статье. Реестр содержит
+   **250 уникальных** ревизий, `git diff --check` чист, production build
+   успешно сгенерировал **374** страницы.
+
+Вердикт: мартовская партия готова к отдельному публикационному коммиту.