zorya-classifier 0.2.1 → 0.2.2

package/docs/refactoring-plan.ru.md

@@ -0,0 +1,183 @@
+# План рефакторинга (волны 1–9)
+
+Исторические планы и замороженные свидетельства в `docs/evidence/**` **не переписываются** задним числом. Полные потоки журналов хранятся **вне** репозитория (корень артефактов задачи рефакторинга); здесь — имена журналов/отчётов и измеренные итоги, подтверждённые проверками главного оркестратора.
+
+Ветка: `work/classifier-refactor-20261023`. Порядок работы агентов: [правила для агентов](agents.ru.md), [контракт участников](https://github.com/zoomplus/zorya-classifier/blob/main/AGENTS.md).
+
+## Базовая линия до волн (сохранить)
+
+| Метрика                                     | Значение                                                                                                                                                                      |
+| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Ранний `npm test` (только `test/*.test.ts`) | **674** теста, **671** успех, **3** падения                                                                                                                                   |
+| Типичный блокер до волны `2A`               | H6: журнал целостности — идентичность путей-алиасов: разные пути, ведущие через симлинки к одному и тому же файлу, считаются одним и тем же; воспроизведение через `realpath` |
+
+Дальнейший рост переносимого каталога (772), восстановление идентичности путей, регрессия владения байтами рендерера, явная конфигурация учётных данных каталога `benchmarks` — отражены в волнах 2–7.
+
+**Тройки чисел архива** в проверках `pack:check`: сначала **всего** файлов в установленном архиве, затем файлов **среды выполнения** (`dist` и связанные артефакты), затем деклараций, проверенных через **отдельный** проект-потребитель.
+
+### Пять зафиксированных регрессий/изменений поведения доказательств
+
+1. **Волна 2 / H6:** идентичность каталога-алиаса для воспроизведения целостности (`buildIntegrityReceiptByRealPath`, `test/v03-h6-integrity-receipt-path-identity.test.ts`): пути совпадают, если через симлинки они указывают на один и тот же реальный файл.
+2. **Рендерер:** Рендерер копирует RGBA-байты до чтения синхронного геттера `proposals`; отдельный тест проверяет мутацию исходного буфера этим геттером.
+3. **Историческая фикстура:** отделение синтетического манифеста «53 исходника / 82 ключа» от текущего набора исходников и списков зависимостей без переписывания замороженных хешей оценщика.
+4. **Будущие наборы манифестов исходников и списки зависимостей:** обновлены без изменения исторического JSON, хешей и порядка полей.
+5. **Учётные данные каталога `benchmarks`:** `benchmarks/credentials.ts`, переменные окружения процесса по умолчанию, необязательный `--env-file` только во вспомогательных раннерах.
+
+---
+
+## Волна 1 — базовая линия (ЗАВЕРШЕНО)
+
+**Итог:** зафиксирован исходный набор тестов и список блокеров.
+
+**Проверка:** базовая линия 674/671/3; ранние журналы в каталоге артефактов (сырые потоки не в репозитории).
+
+---
+
+## Волна 2 — фундамент (ЗАВЕРШЕНО)
+
+**Модули:** `2A` — H6 и идентичность `realpath`; `2B` — проверка границ слоёв (`scripts/boundaries.mjs`), каталог тестов, `run-classified-tests.mjs`, `knip.json`, документация для участников разработки.
+
+**Проверка (Linux Node 22, главный оркестратор):** коммит `c3923f0`; `npm run check` **764/764** — `wave2-root-checkpoint-retry.log`. Ранний сбой этапа Husky только на `format:check` — `wave2-root-checkpoint.log` (сохранён).
+
+Узкие прогоны исполнителя Composer на встроенном Linux Node 24 — **не** полная продуктовая проверка Node 24.
+
+---
+
+## Волна 3 — контракты и листовая геометрия (ЗАВЕРШЕНО)
+
+**Итог:** листовые модули `entities/*`, фасад `contracts.ts`; разделение схемы метаданных сегментации.
+
+**Проверка:** коммит `0a5095f`; **764/764**; архив пакета 383 / 126 / 207 — `wave3-root-checkpoint.log`, `wave3-root-pack.log`.
+
+---
+
+## Волна 4 — разделение фабрики приложения (ЗАВЕРШЕНО)
+
+**Итог:** `classifier-{contracts,config,runtime,spatial,representation}.ts` и тонкий `create-classifier.ts`.
+
+**Проверка:** коммит `1515f15`; **764/764**; архив 393/136/208 — `wave4-root-pack.log`.
+
+---
+
+## Волна 5 — извлечение и предложения (ЗАВЕРШЕНО)
+
+**Итог:** `features/segmentation/*`, `features/proposals/*`; процессы только оркестрируют.
+
+**Проверка:** коммит `abc68b3`; **765/765** — отчёт проверенной ревизии (сохранён).
+
+---
+
+## Волна 6 — транспорты и нативная сегментация (ЗАВЕРШЕНО)
+
+| Подволна | Зона ответственности                                                   | Проверка                                                                                                                                                     |
+| -------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `6A`     | `decision-transport/*`, `vision-chat/*`; удалён `openrouter-common.ts` | коммит `9e9b491`; **765/765**; архив **421** / **164** / **209**; API: 4 точки входа / 67 типов — `wave6a-root-checkpoint-retry.log`, `wave6a-root-pack.log` |
+| `6B`     | фасады `mobile-sam/*`, `grabcut/*`                                     | коммит `e5b448b`; **765/765**; архив **449** / **192** / **212** — журналы подволны `6B`                                                                     |
+
+**Фикстура `6A`:** исторический тест манифеста использует замороженные ключи JSON и синтетические дайджесты — хеши замороженного оценщика не менять.
+
+---
+
+## Волна 7 — изоляция исследований, состав npm и инструменты (ЗАВЕРШЕНО)
+
+| Подволна | Зона ответственности                                                                                                                                                                                     | Статус                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `7A`     | `benchmarks/experiments/{create-research-classifier,text-representation,boundary-view}`; `runtime-source-files.ts`; исследования вне дистрибутива npm                                                    | ЗАВЕРШЕНО — **767/767** — `wave7a-root-checkpoint.log`; коммит **`b7f8bd2`**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `7B`     | `integrity-receipts.ts`; индекс H5 по `realpath`; `credentials.ts`; единый раннер; удалён `run-portable-tests.mjs`                                                                                       | ЗАВЕРШЕНО — **7/7** группы `local-evidence` после исправления; H4e сравнивается по реальному пути, сохранена проверка родительского каталога; журналы `wave7b-h4e-realpath-identity-local-evidence.log`, `wave7b-composer-h5-test.log`, **`final-local-evidence-node22-configured.log`** (7/7 при корректной раскладке данных); полные проверки главного оркестратора **772/772** после замены тестовых поддельных ключей на низкоэнтропийные фикстуры — `wave7b-root-checkpoint-retry.log`; сохранены неудачные журналы **`wave7-root-local-evidence-baseline.log`** (4/7 до исправления) и **`final-local-evidence-node22.log`** (3 падения `grounded-mask` при неверной конфигурации); коммит **`0fd9507`** |
+| `7C`     | явные точки входа Knip; удалены **4** неиспользуемые функции и **1** неиспользуемый тип; доказанно неиспользуемые экспорты сделаны внутренними; единственное исключение зависимости — `onnxruntime-node` | ЗАВЕРШЕНО — коммит **`76d7ac6`**; **772/772**; архив **445** / **188** / **212**; API: 4 точки входа / 67 типов / проверка совместимости типов — `wave7c-root-checkpoint.log`, `wave7c-root-pack.log`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+
+**Защищённая базовая линия (волна `7C`):** **407** файлов, включая **весь** JSON каталога `benchmarks`, побайтово идентичны на `76d7ac6`; `package-lock.json` без изменений. Отчёт **`wave7-final-protected-evidence.json`**. Число **377** относилось к более узкому подмножеству — не путать с 407.
+
+**Учётные данные `7B`:** `process.env.OPENROUTER_API_KEY`; `--env-file` только во вспомогательных раннерах; без отката к чужому `.env`.
+
+Алгоритмы классификации и `extract` **не менялись** в `7C`; удаления мёртвого кода уже выполнены — отдельной области работ после волны 9 на удаления в исходниках **не** планируется.
+
+---
+
+## Волна 8 — документация и происхождение (ЗАВЕРШЕНО)
+
+**Зона ответственности:** связные русские руководства по архитектуре, разработке, агентам и этому плану; навигация в корневых руководствах и CONTRIBUTING, в [архитектуре на английском](architecture.md) и [эталонных прогонах](benchmarks.md); записи [provenance.json](provenance.json); указатели [контракта участников](https://github.com/zoomplus/zorya-classifier/blob/main/AGENTS.md) и [правила проекта](https://github.com/zoomplus/zorya-classifier/blob/main/.cursor/rules/zorya-classifier.mdc).
+
+**Проверка:** коммит **`7a74226`**; Linux Node **22.23.2**, полный `npm run check` **772/772**, форматирование в этапе Husky — `wave8-root-checkpoint.log`; `pack:check` архив **447** / **188** / **212**, **0** HTTP-запросов к провайдеру (нет вызовов провайдера по HTTP; это не означает нулевой сетевой трафик) — `wave8-root-pack.log`; локальные ссылки, `git diff --check`, `npm run secrets:check`.
+
+---
+
+## Волна 9 — финальная верификация (ЗАВЕРШЕНО)
+
+**Итог:** принята полная платформенная матрица на ревизии **`4877d05`** (ветка `work/classifier-refactor-20261023`). Сводка и имена журналов — в каталоге артефактов завершения `zorya-classifier-completion-20261023` (`local-verification.json`, `completion-code-verification.json`); сырые потоки **вне** репозитория.
+
+**Узкое завершение кода на `4877d05` (не переписывает историю волн 1–8):** общая проверка границ источника запроса — результаты и упорядоченные ошибки Zod совпали на **420** входных комбинациях (`native-protocol-equivalence.json`). Только **два** теста H11 создают на CPU фикстуры FakeTensor только с метаданными (синтетические метаданные CUDA-устройства и dtype для отдельных случаев валидации и размещения в загрузчике); остальные тесты H11 FakeTensor не используют. Проверяется фактическая логика валидации и загрузчика рабочего кода и негативные случаи; прогон **не** доказывает выделение физической видеопамяти, реальный CUDA/GPU или живой инференс модели H11.
+
+### Исторический снимок на коммите `7a74226` (сохранён)
+
+На этом снимке главный оркестратор измерил **только Linux**; Windows и **`python-native`** **ещё не запускались** — это исторический факт, его **не** переклассифицируют как «ново пройденное» на `7a74226`.
+
+| Проверка                                                                                                          | Результат                                                                                                                      | Журнал                                                       |
+| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------ |
+| Linux Node **22.23.2**, `npm run check`                                                                           | **772/772**, **0** пропусков, форматирование OK                                                                                | `wave8-root-checkpoint.log`                                  |
+| Linux Node **22.23.2**, `pack:check`                                                                              | **447** / **188** / **212**, **0** HTTP-запросов к провайдеру                                                                  | `wave8-root-pack.log`                                        |
+| Linux Node **24.22.1** (измеренный исполняемый файл Node.js для Linux из установки Cursor Agent), `npm run check` | **772/772**, **0** пропусков                                                                                                   | `final-node24-check.log`; формат — `final-node24-format.log` |
+| Linux Node **24.22.1**, `pack:check`                                                                              | **447** / **188** / **212**, **0** HTTP-запросов к провайдеру                                                                  | `final-node24-pack.log`                                      |
+| Публичный API                                                                                                     | **4** точки входа, **67** экспортируемых типов; типы экспортируемых значений совместимы в обе стороны с исходной версией       | `final-public-api.log`                                       |
+| Защищённая базовая линия                                                                                          | **407** файлов без изменений плюс `package-lock.json`, `.env.example`, `src/index.ts`; кодовая контрольная точка **`76d7ac6`** | `final-protected-evidence.json`                              |
+| Группа `local-evidence` (настроенная раскладка)                                                                   | **7/7**, без падений/пропусков                                                                                                 | `final-local-evidence-node22-configured.log`                 |
+| Контрольные тесты геометрии на Python                                                                             | **6/6**                                                                                                                        | `root-controlled-oracles.log`                                |
+
+**Ограничения снимка `7a74226` (исторически):** Windows на Linux-хосте **не запускались**; удалённый GitHub Actions CI **не запускался**; **`python-native`** **не запускался**; **6/6** оракулов **не** заменяет `python-native`.
+
+### Текущая матрица на ревизии `4877d05` (принято)
+
+| Платформа / Node                                                                                                   | `npm run check` (переносимый каталог)                           | `pack:check`                                                  | Прочее                                                                                                                                                                                                                            |
+| ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Linux **22.23.2**                                                                                                  | **772/772**, **0** пропусков                                    | **447** / **188** / **212**, **0** HTTP-запросов к провайдеру | формат в обычном commit-hook — `local-verification.json`                                                                                                                                                                          |
+| Linux **24.22.1**                                                                                                  | **772/772**, **0** пропусков                                    | те же тройки и байты архива                                   | `linux-node24-check.log`, `linux-node24-pack.log`, `linux-node24-format.log`                                                                                                                                                      |
+| Windows Server **2025** (build **26100**), Node **22.23.4** / npm **10.9.9**, задание `win-4877d0535a04-node22-r3` | **772** всего / **765** успех / **0** падений / **7** пропусков | **447** / **188** / **212**, **0** HTTP-запросов к провайдеру | локальная оценочная VM **win32** (удалённый GitHub Actions CI не запускался); все четыре команды exit **0**; **962/962** отслеживаемых исходников побайтово после проверок; журналы `windows/results/win-4877d0535a04-node22-r3/` |
+| Windows Server **2025** (build **26100**), Node **24.22.1** / npm **11.19.1**, задание `win-4877d0535a04-node24`   | **772** / **765** / **0** / **7**                               | идентично Linux                                               | `windows/results/win-4877d0535a04-node24/`; артефакт декодирования консоли OEM **не** меняет имена тестов, счётчики и хеши исходников                                                                                             |
+
+**Общий архив** (все четыре пары): SHA-256 **`cb3e980854bb625380b594f5ac3f05d657bbeda4b42880bf8f57fe307645aa20`**; SHA-256 каталога runtime **`dist`**: **`111c744ad406ff4645e2ff0f471610376a648aa81771eacf0a94bb61ea8d1131`**.
+
+В колонках `pack:check` значение **0** HTTP означает ноль HTTP-запросов или HTTP-вызовов к провайдеру моделей, а не отсутствие любого сетевого трафика.
+
+**Семь заранее существовавших пропусков на Windows** (не добавлены этой задачей; на Linux при наличии входов/возможностей платформы все **772** проходят):
+
+1. один тест с заменой POSIX FIFO;
+2. один тест с внешним симлинком без привилегий Windows;
+3. одна необязательная фикстура маски H3b;
+4. одна необязательная фикстура маски H4e;
+5. одна замороженная фикстура воспроизведения H6;
+6. одна замороженная фикстура отмены H6;
+7. один необязательный тест замороженных доказательств H8.
+
+| Дополнительные проверки на Linux (`4877d05`)          | Результат                                                                                               | Журнал / отчёт                                              |
+| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
+| Публичный API                                         | **4** точки входа, **67** типов, совместимость типов экспортируемых значений **в обе стороны**          | `public-api.log`                                            |
+| Защищённая базовая линия                              | **407** файлов без изменений плюс `package-lock.json`, `.env.example`, `src/index.ts`                   | `protected-evidence.json`                                   |
+| `python-native` (изолированный CPU Python **3.12.3**) | **44/44**, **0** пропусков; офлайн-контракты/метаданные/жизненный цикл — не проверяет GPU или живой H11 | успех: `python-native-rerun.log`; сбой: `python-native.log` |
+| `local-evidence` (существующая раскладка вызывающего) | **7/7**, **0** падений, **0** пропусков                                                                 | `local-evidence-current.log`                                |
+| Контрольные оракулы геометрии Python                  | **6/6**                                                                                                 | `controlled-oracles-current.log`                            |
+
+Платные прогоны провайдера и публикация **не** выполнялись.
+
+**Сохранённые неудачи и неверные конфигурации (имена только):** ранний сбой офлайн-настройки **`python-native`** (`python-native.log`); неверная конфигурация `local-evidence` — **`wave7-root-local-evidence-baseline.log`**, **`final-local-evidence-node22.log`**; Windows — сбой PowerShell-настройки до проверок (`win-4877d0535a04-node22`), отсутствие VC runtime на этапе Knip до переносимых тестов (`win-4877d0535a04-node22-r2`; typecheck/lint/boundaries уже прошли); первая проба Node `-e` с пустым stdout **не принята** (`windows/vc-runtime-first-provisioning.json`); принята последующая проверка загрузки модуля через отдельный CJS-файл с точным маркером stdout и exit **0** (`windows/vc-runtime-verified-smoke.json`). Установка VC++ x64 Redistributable — только в одноразовой VM, зависимости репозитория **не** менялись.
+
+---
+
+## Платформы и CI
+
+| Тема                        | Статус                                                                                                                                                                                                                                                                                                                            |
+| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Матрица CI (проект)         | `ubuntu-latest`, `windows-latest` × Node 22 и 24                                                                                                                                                                                                                                                                                  |
+| Измерено (волна 9, Linux)   | **`4877d05`**: Node **22.23.2** и **24.22.1** — `npm run check` **772/772**, **0** пропусков; `pack:check` **447** / **188** / **212**; исторический снимок **`7a74226`** — см. подраздел выше                                                                                                                                    |
+| Измерено (волна 9, Windows) | **`4877d05`**, локальная оценочная VM Server **2025** build **26100**, Node **22.23.4** и **24.22.1**: все проверки exit **0**; **765/772** с **7** заранее существовавшими пропусками (см. волну 9); байты архива как на Linux                                                                                                   |
+| Удалённый GitHub Actions CI | **Не запускался**; локальная Windows-матрица **не** заменяет удалённый CI                                                                                                                                                                                                                                                         |
+| `python-native`             | **`4877d05`**: **44/44**, **0** пропусков в изолированном CPU Python **3.12.3** (`python-native-rerun.log`, `python-runtime-receipt.json`); два теста H11 с FakeTensor-метаданными **не** проверяют GPU/живую модель; предварительные условия — [разработка](development.ru.md#python-windows-и-нативные-предварительные-условия) |
+| Волна 8                     | **ЗАВЕРШЕНО** — **`7a74226`**                                                                                                                                                                                                                                                                                                     |
+
+Успех удалённого GitHub Actions CI и публикация **не** заявлены этим документом.
+
+## Инварианты на все волны
+
+- Публичные точки входа и семантика региона по умолчанию `v0.2` (закрытые проверки рамки в **текущем** основном потоке `extract`).
+- Гигиена секретов: индексированные и рабочее дерево + байты установленного архива; только пустой `.env.example`.
+- Без автоматической загрузки нативных весов; порты сегментатора и предложений на стороне вызывающего.
+- Исторические метки и метрики `v0.2` остаются **историческими**; непроверенные рецепты не переклассифицировать как текущий проверенный поток.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zorya-classifier",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Provider-independent classification with experimental localization and object extraction for Node.js",
   "type": "module",
   "license": "MIT",
@@ -42,7 +42,9 @@
     "lint": "eslint . --max-warnings 0",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "test": "node --import tsx --test --test-concurrency=2 test/*.test.ts",
+    "test": "node --import tsx scripts/run-classified-tests.mjs portable",
+    "test:local-evidence": "node --import tsx scripts/run-classified-tests.mjs local-evidence",
+    "test:python-native": "node --import tsx scripts/run-classified-tests.mjs python-native",
     "check": "npm run secrets:check && npm run typecheck && npm run lint && npm run boundaries && npm run dead-code:ci && npm test && npm run build",
     "boundaries": "node scripts/boundaries.mjs",
     "dead-code:ci": "knip --no-progress",

package/dist/infrastructure/boundary-view.d.ts

@@ -1,2 +0,0 @@
-import type { BoundaryViewPort } from '../entities/boundary-view.js';
-export declare function createSharpBoundaryView(): BoundaryViewPort;

package/dist/infrastructure/boundary-view.js

@@ -1,263 +0,0 @@
-import sharp from 'sharp';
-import { z } from 'zod';
-import { limits, pixelRectSchema } from '../entities/contracts.js';
-import { ClassifierError, assertActive } from '../entities/errors.js';
-const sourceSchema = z
-    .object({
-    bytes: z
-        .custom((v) => v instanceof Uint8Array)
-        .refine((v) => v.byteLength > 0 && v.byteLength <= limits.imageBytes),
-    width: z.number().int().positive().max(16384),
-    height: z.number().int().positive().max(16384),
-})
-    .strict();
-const candidateSchema = z
-    .object({
-    id: z
-        .string()
-        .min(1)
-        .max(128)
-        .regex(/^[A-Za-z][A-Za-z0-9_-]*$/),
-    display: z
-        .string()
-        .min(1)
-        .max(8)
-        .regex(/^[A-Za-z0-9_-]+$/),
-    interval: z
-        .object({
-        start: z.number().int().nonnegative().safe(),
-        endExclusive: z.number().int().positive().safe(),
-    })
-        .strict()
-        .refine((v) => v.start < v.endExclusive),
-})
-    .strict();
-const inputSchema = z
-    .object({
-    source: sourceSchema,
-    sourceRegion: pixelRectSchema,
-    axis: z.enum(['left', 'right', 'top', 'bottom']),
-    candidates: z.array(candidateSchema).min(1).max(16),
-    signal: z.custom((v) => v instanceof AbortSignal),
-})
-    .strict();
-const maxContentSide = 1280;
-const maxOutputSide = 1567;
-const axisGutter = 210;
-const outerGutter = 10;
-const maxRenderedBytes = limits.imageBytes;
-function contained(outer, inner) {
-    return (inner.left >= outer.left &&
-        inner.top >= outer.top &&
-        inner.left + inner.width <= outer.left + outer.width &&
-        inner.top + inner.height <= outer.top + outer.height);
-}
-function escapeXml(value) {
-    return value.replace(/[&<>"']/gu, (char) => {
-        switch (char) {
-            case '&':
-                return '&amp;';
-            case '<':
-                return '&lt;';
-            case '>':
-                return '&gt;';
-            case '"':
-                return '&quot;';
-            default:
-                return '&apos;';
-        }
-    });
-}
-function failInput(message) {
-    throw new ClassifierError('INVALID_INPUT', message, { component: 'boundary-view' });
-}
-function validate(input) {
-    const parsed = inputSchema.safeParse(input);
-    if (!parsed.success)
-        failInput('Invalid boundary-view request');
-    const value = parsed.data;
-    if (value.source.width * value.source.height > limits.imagePixels)
-        throw new ClassifierError('RESOURCE_LIMIT', 'Source raster exceeds pixel limits', {
-            component: 'boundary-view',
-        });
-    const full = { left: 0, top: 0, width: value.source.width, height: value.source.height };
-    if (!contained(full, value.sourceRegion))
-        failInput('Source region lies outside the oriented image');
-    const xAxis = value.axis === 'left' || value.axis === 'right';
-    const axisSize = xAxis ? value.source.width : value.source.height;
-    const axisStart = xAxis ? value.sourceRegion.left : value.sourceRegion.top;
-    const axisEnd = axisStart + (xAxis ? value.sourceRegion.width : value.sourceRegion.height);
-    const ids = new Set();
-    const displays = new Set();
-    let priorEnd = -1;
-    for (const candidate of value.candidates) {
-        if (ids.has(candidate.id) || displays.has(candidate.display))
-            failInput('Boundary candidate IDs and display labels must be unique');
-        ids.add(candidate.id);
-        displays.add(candidate.display);
-        if (candidate.interval.endExclusive > axisSize)
-            failInput('Boundary interval lies outside the oriented source');
-        if (candidate.interval.start < axisStart || candidate.interval.endExclusive > axisEnd)
-            failInput('Boundary interval lies outside the source region');
-        if (candidate.interval.start < priorEnd)
-            failInput('Boundary intervals must be ordered and non-overlapping');
-        priorEnd = candidate.interval.endExclusive;
-    }
-    return value;
-}
-function svgOverlay(axis, candidates, region, contentWidth, contentHeight, contentLeft, contentTop, outputWidth, outputHeight) {
-    const vertical = axis === 'left' || axis === 'right';
-    const axisLength = vertical ? region.width : region.height;
-    const outputLength = vertical ? contentWidth : contentHeight;
-    const sourceOffset = vertical ? region.left : region.top;
-    const unit = outputLength / axisLength;
-    const strokes = [];
-    // Presentation is tied to the coordinate dimension, never to the semantic side being located.
-    const color = vertical ? '#ff6b5f' : '#49d6a1';
-    const title = vertical ? 'X coordinates' : 'Y coordinates';
-    strokes.push(vertical
-        ? `<text x="${outputWidth - outerGutter - 2}" y="${outerGutter + 10}" text-anchor="end" font-family="DejaVu Sans,sans-serif" font-size="9" fill="#f3f4f6">${title}</text>`
-        : `<text x="${outerGutter}" y="${outerGutter + 10}" font-family="DejaVu Sans,sans-serif" font-size="9" fill="#f3f4f6">${title}</text>`);
-    const positions = candidates.map((candidate) => {
-        const begin = (candidate.interval.start - sourceOffset) * unit;
-        const end = (candidate.interval.endExclusive - sourceOffset) * unit;
-        return (begin + end) / 2;
-    });
-    const labelBaselines = vertical
-        ? (() => {
-            const pitch = 12;
-            const lanes = [];
-            const rightEdges = [];
-            return candidates.map((candidate, index) => {
-                const center = contentLeft + (positions[index] ?? 0);
-                const width = candidate.display.length * 7 + 6;
-                let lane = rightEdges.findIndex((right) => right + 3 <= center - width / 2);
-                if (lane < 0) {
-                    lane = rightEdges.length;
-                    rightEdges.push(Number.NEGATIVE_INFINITY);
-                }
-                rightEdges[lane] = center + width / 2;
-                lanes[index] = lane;
-                return contentTop - 5 - (lane + 1) * pitch;
-            });
-        })()
-        : (() => {
-            const min = outerGutter + 10;
-            const max = outputHeight - outerGutter - 3;
-            const pitch = 12;
-            const desired = positions.map((position) => contentTop + position + 4);
-            const placed = desired.map((position) => Math.max(min, Math.min(max, position)));
-            for (let index = 1; index < placed.length; index++)
-                placed[index] = Math.max(placed[index] ?? min, (placed[index - 1] ?? min) + pitch);
-            if ((placed.at(-1) ?? max) > max) {
-                placed[placed.length - 1] = max;
-                for (let index = placed.length - 2; index >= 0; index--)
-                    placed[index] = Math.min(placed[index] ?? max, (placed[index + 1] ?? max) - pitch);
-            }
-            return placed;
-        })();
-    for (const [index, candidate] of candidates.entries()) {
-        const start = (candidate.interval.start - sourceOffset) * unit;
-        const end = (candidate.interval.endExclusive - sourceOffset) * unit;
-        const lo = Math.min(start, end);
-        const hi = Math.max(start, end);
-        const midpoint = (lo + hi) / 2;
-        const label = escapeXml(candidate.display);
-        if (vertical) {
-            const center = contentLeft + midpoint;
-            const halfWidth = candidate.display.length * 3.5 + 3;
-            const labelCenter = Math.max(contentLeft + halfWidth, Math.min(contentLeft + contentWidth - halfWidth, center));
-            const baseline = labelBaselines[index] ?? contentTop - 17;
-            strokes.push(`<rect x="${contentLeft + lo}" y="${contentTop}" width="${Math.max(1, hi - lo)}" height="${contentHeight}" fill="${color}" fill-opacity="0.045"/>`, `<line x1="${contentLeft + start}" y1="${contentTop}" x2="${contentLeft + start}" y2="${contentTop + contentHeight}" stroke="${color}" stroke-opacity="0.9" stroke-width="2"/>`, `<line x1="${contentLeft + end}" y1="${contentTop}" x2="${contentLeft + end}" y2="${contentTop + contentHeight}" stroke="${color}" stroke-opacity="0.9" stroke-width="2"/>`, `<path d="M ${center} ${contentTop} L ${center} ${baseline + 4} L ${labelCenter} ${baseline + 4}" fill="none" stroke="${color}" stroke-width="1"/>`, `<text x="${labelCenter}" y="${baseline}" text-anchor="middle" font-family="DejaVu Sans,sans-serif" font-size="10" font-weight="bold" fill="${color}">${label}</text>`);
-        }
-        else {
-            const midpointY = contentTop + midpoint;
-            const baseline = labelBaselines[index] ?? midpointY + 4;
-            const elbowX = contentLeft - 12 - index * 3;
-            const labelX = contentLeft - 82;
-            strokes.push(`<rect x="${contentLeft}" y="${contentTop + lo}" width="${contentWidth}" height="${Math.max(1, hi - lo)}" fill="${color}" fill-opacity="0.045"/>`, `<line x1="${contentLeft}" y1="${contentTop + start}" x2="${contentLeft + contentWidth}" y2="${contentTop + start}" stroke="${color}" stroke-opacity="0.9" stroke-width="2"/>`, `<line x1="${contentLeft}" y1="${contentTop + end}" x2="${contentLeft + contentWidth}" y2="${contentTop + end}" stroke="${color}" stroke-opacity="0.9" stroke-width="2"/>`, `<path d="M ${contentLeft} ${midpointY} L ${elbowX} ${midpointY} L ${elbowX} ${baseline} L ${labelX + 4} ${baseline}" fill="none" stroke="${color}" stroke-width="1"/>`, `<text x="${labelX}" y="${baseline}" text-anchor="end" font-family="DejaVu Sans,sans-serif" font-size="10" font-weight="bold" fill="${color}">${label}</text>`);
-        }
-    }
-    const sourceBounds = `<rect x="${contentLeft}" y="${contentTop}" width="${contentWidth}" height="${contentHeight}" fill="none" stroke="#f3f4f6" stroke-opacity="0.65" stroke-width="1"/>`;
-    return Buffer.from(`<svg xmlns="http://www.w3.org/2000/svg" width="${outputWidth}" height="${outputHeight}">${sourceBounds}${strokes.join('')}</svg>`);
-}
-async function render(input) {
-    assertActive(input.signal);
-    const value = validate(input);
-    assertActive(value.signal);
-    // Sharp retains its input through an asynchronous pipeline; take ownership before awaiting.
-    const ownedBytes = Buffer.from(value.source.bytes);
-    const candidates = value.candidates.map((candidate) => ({
-        id: candidate.id,
-        display: candidate.display,
-        interval: { ...candidate.interval },
-    }));
-    const { sourceRegion: region } = value;
-    const scale = Math.min(maxContentSide / Math.max(region.width, region.height), Math.max(1, 768 / Math.min(region.width, region.height)));
-    const contentWidth = Math.max(1, Math.round(region.width * scale));
-    const contentHeight = Math.max(1, Math.round(region.height * scale));
-    const vertical = value.axis === 'left' || value.axis === 'right';
-    const contentLeft = vertical ? outerGutter : axisGutter;
-    const contentTop = vertical ? axisGutter : outerGutter;
-    const outputWidth = Math.max(280, contentLeft + contentWidth + outerGutter);
-    const outputHeight = Math.max(280, contentTop + contentHeight + outerGutter);
-    if (outputWidth > maxOutputSide || outputHeight > maxOutputSide)
-        throw new ClassifierError('RESOURCE_LIMIT', 'Boundary view exceeds output side limit', {
-            component: 'boundary-view',
-        });
-    const pixels = outputWidth * outputHeight;
-    if (pixels > limits.imagePixels)
-        throw new ClassifierError('RESOURCE_LIMIT', 'Boundary view exceeds output pixel limit', {
-            component: 'boundary-view',
-        });
-    const overlay = svgOverlay(value.axis, candidates, region, contentWidth, contentHeight, contentLeft, contentTop, outputWidth, outputHeight);
-    if (overlay.byteLength > 128 * 1024)
-        throw new ClassifierError('RESOURCE_LIMIT', 'Boundary overlay exceeds byte budget', {
-            component: 'boundary-view',
-        });
-    let pipeline;
-    try {
-        assertActive(value.signal);
-        pipeline = sharp(ownedBytes, { limitInputPixels: limits.imagePixels, failOn: 'error' })
-            .extract(region)
-            .resize(contentWidth, contentHeight, { kernel: 'nearest' })
-            .extend({
-            left: contentLeft,
-            top: contentTop,
-            right: outputWidth - contentLeft - contentWidth,
-            bottom: outputHeight - contentTop - contentHeight,
-            background: { r: 17, g: 24, b: 39, alpha: 1 },
-        })
-            .composite([{ input: overlay }]);
-        const result = await pipeline.png().toBuffer();
-        assertActive(value.signal);
-        if (result.byteLength > maxRenderedBytes)
-            throw new ClassifierError('RESOURCE_LIMIT', 'Rendered boundary view exceeds byte limit', {
-                component: 'boundary-view',
-            });
-        return {
-            image: { bytes: result, width: outputWidth, height: outputHeight },
-            sourceRegion: { ...region },
-            content: { left: contentLeft, top: contentTop, width: contentWidth, height: contentHeight },
-            scaleX: contentWidth / region.width,
-            scaleY: contentHeight / region.height,
-            candidates,
-        };
-    }
-    catch (error) {
-        assertActive(value.signal);
-        if (error instanceof ClassifierError)
-            throw error;
-        throw new ClassifierError('INVALID_INPUT', 'Boundary view could not be rendered', {
-            component: 'boundary-view',
-        });
-    }
-    finally {
-        pipeline?.destroy();
-        ownedBytes.fill(0);
-        overlay.fill(0);
-    }
-}
-export function createSharpBoundaryView() {
-    return { render };
-}