zorya-classifier 0.2.2 → 0.2.3

package/dist/entities/representation.js

@@ -1,33 +1 @@
-import { pixelRectSchema } from './contracts.js';
-import { z } from 'zod';
-export const representationLimits = Object.freeze({
-    totalBytes: 64 * 1024,
-    partCharacters: 64000,
-    maxSide: 64,
-    maxViews: 9,
-});
-export const preparedTextSchema = z
-    .object({
-    state: z.array(z.string().min(1).max(representationLimits.partCharacters)).min(1).max(64),
-    metadata: z
-        .object({
-        profile: z.string().min(1).max(128),
-        bytes: z.number().int().nonnegative().max(representationLimits.totalBytes),
-        views: z
-            .array(z
-            .object({
-            id: z.string().min(1).max(256),
-            sourceRegion: pixelRectSchema,
-            width: z.number().int().positive().max(16384),
-            height: z.number().int().positive().max(16384),
-            scaleX: z.number().finite().positive(),
-            scaleY: z.number().finite().positive(),
-            content: pixelRectSchema.optional(),
-        })
-            .strict())
-            .min(1)
-            .max(representationLimits.maxViews),
-    })
-        .strict(),
-})
-    .strict();
+export {};

package/dist/entities/segmentation-verification.d.ts

@@ -16,7 +16,7 @@ export interface SegmentationBoxCheckResult {
     selection: ChoiceSelection;
     metadata: DecisionMetadata;
 }
-/** @experimental Closed box containment check; verdicts are unqualified for general spatial accuracy. */
+/** Closed box containment check; verdicts are not universal spatial accuracy guarantees. */
 export interface SegmentationBoxCheckPort {
     check(input: SegmentationBoxCheckInput): Promise<SegmentationBoxCheckResult>;
 }

package/dist/entities/segmentation.d.ts

@@ -25,22 +25,13 @@ export declare const extractSchema: z.ZodObject<{
         width: number;
         height: number;
     }>>;
-    representation: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    representation: z.ZodOptional<z.ZodObject<{
         type: z.ZodLiteral<"vision">;
     }, "strict", z.ZodTypeAny, {
         type: "vision";
     }, {
         type: "vision";
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"experimental-text">;
-        profile: z.ZodLiteral<"text-image-v1">;
-    }, "strict", z.ZodTypeAny, {
-        type: "experimental-text";
-        profile: "text-image-v1";
-    }, {
-        type: "experimental-text";
-        profile: "text-image-v1";
-    }>]>>;
+    }>>;
     boxTolerancePx: z.ZodDefault<z.ZodNumber>;
     maxExtentPasses: z.ZodDefault<z.ZodNumber>;
 } & {
@@ -53,9 +44,6 @@ export declare const extractSchema: z.ZodObject<{
     maxExtentPasses: number;
     representation?: {
         type: "vision";
-    } | {
-        type: "experimental-text";
-        profile: "text-image-v1";
     } | undefined;
     roi?: {
         left: number;
@@ -69,9 +57,6 @@ export declare const extractSchema: z.ZodObject<{
     target: string;
     representation?: {
         type: "vision";
-    } | {
-        type: "experimental-text";
-        profile: "text-image-v1";
     } | undefined;
     exclusions?: string[] | undefined;
     roi?: {
@@ -84,7 +69,7 @@ export declare const extractSchema: z.ZodObject<{
     boxTolerancePx?: number | undefined;
     maxExtentPasses?: number | undefined;
 }>;
-/** @experimental Region-seeded extraction input; unqualified for general object or mask accuracy. */
+/** Region-seeded extraction input; structural success does not guarantee semantic object or mask quality. */
 export type ExtractInput = z.input<typeof extractSchema> & {
     signal?: AbortSignal;
 };
@@ -118,7 +103,7 @@ export type SegmentationResult = {
 };
 /**
  * Caller-owned. settle joins physical work; dispose closes this adapter only.
- * @experimental Caller-owned segmentation; structural validation does not establish semantic object or mask quality.
+ * Structural validation does not establish semantic object or mask quality.
  */
 export interface SegmentationPort {
     segment(input: SegmentationInput): Promise<SegmentationResult>;
@@ -127,7 +112,7 @@ export interface SegmentationPort {
     settle(): Promise<void>;
     dispose(): Promise<void>;
 }
-/** @experimental Extraction outcome; `extracted` reflects validation, not guaranteed semantic correctness. */
+/** Extraction outcome; `extracted` reflects validation, not guaranteed semantic correctness. */
 export type ExtractionResult = {
     status: 'extracted';
     location: WholeObjectLocated;

package/dist/entities/whole-object.d.ts

@@ -22,22 +22,13 @@ export declare const wholeObjectSchema: z.ZodObject<{
         width: number;
         height: number;
     }>>;
-    representation: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    representation: z.ZodOptional<z.ZodObject<{
         type: z.ZodLiteral<"vision">;
     }, "strict", z.ZodTypeAny, {
         type: "vision";
     }, {
         type: "vision";
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"experimental-text">;
-        profile: z.ZodLiteral<"text-image-v1">;
-    }, "strict", z.ZodTypeAny, {
-        type: "experimental-text";
-        profile: "text-image-v1";
-    }, {
-        type: "experimental-text";
-        profile: "text-image-v1";
-    }>]>>;
+    }>>;
 } & {
     mode: z.ZodLiteral<"whole-object">;
     boxTolerancePx: z.ZodDefault<z.ZodNumber>;
@@ -51,9 +42,6 @@ export declare const wholeObjectSchema: z.ZodObject<{
     maxExtentPasses: number;
     representation?: {
         type: "vision";
-    } | {
-        type: "experimental-text";
-        profile: "text-image-v1";
     } | undefined;
     roi?: {
         left: number;
@@ -67,9 +55,6 @@ export declare const wholeObjectSchema: z.ZodObject<{
     mode: "whole-object";
     representation?: {
         type: "vision";
-    } | {
-        type: "experimental-text";
-        profile: "text-image-v1";
     } | undefined;
     exclusions?: string[] | undefined;
     roi?: {
@@ -81,13 +66,13 @@ export declare const wholeObjectSchema: z.ZodObject<{
     boxTolerancePx?: number | undefined;
     maxExtentPasses?: number | undefined;
 }>;
-/** @experimental Same unqualified coarse region search as default {@link LocateInput}. */
+/** Same coarse region search as default {@link LocateInput}. */
 export type RegionLocateInput = LocateInput;
-/** @experimental Whole-object localization (interval or caller segmentation); unqualified for general use. */
+/** Whole-object localization (interval or caller segmentation). */
 export type WholeObjectLocateInput = z.input<typeof wholeObjectSchema> & {
     signal?: AbortSignal;
 };
-/** @experimental Region or whole-object locate input; spatial paths are experimental. */
+/** Region or whole-object locate input. */
 export type AnyLocateInput = RegionLocateInput | WholeObjectLocateInput;
 export interface BoundaryInterval {
     start: number;
@@ -127,6 +112,6 @@ export type WholeObjectFailure = LocalizationFailure | {
     metadata: LocalizationMetadata;
     verification?: SegmentationVerification;
 };
-/** @experimental Whole-object localization outcome; passing structural checks does not establish mask or box accuracy. */
+/** Whole-object localization outcome; passing structural checks does not establish mask or box accuracy. */
 export type WholeObjectLocalizationResult = WholeObjectLocated | WholeObjectFailure;
 export {};

package/dist/infrastructure/segmentation/grabcut/index.d.ts

@@ -7,11 +7,11 @@ declare const optionsSchema: z.ZodObject<{
 }, {
     assetPath: string;
 }>;
-/** @experimental Options for the unqualified GrabCut segmentation factory. */
+/** Options for the GrabCut segmentation factory (caller-supplied pinned assets). */
 export type GrabCutSegmenterOptions = z.input<typeof optionsSchema>;
 /**
  * Explicit pinned OpenCV GrabCut adapter. The supplied native asset is never downloaded.
- * @experimental Native segmentation adapter; unqualified for general mask or object accuracy.
+ * Structural validation does not establish semantic mask or object quality.
  */
 export declare function createGrabCutSegmenter(options: GrabCutSegmenterOptions): Promise<SegmentationPort>;
 export {};

package/dist/infrastructure/segmentation/grabcut/index.js

@@ -10,7 +10,7 @@ import { grabcutOpenCvArtifact } from './model-asset.js';
 const optionsSchema = z.object({ assetPath: z.string().min(1).max(4096) }).strict();
 /**
  * Explicit pinned OpenCV GrabCut adapter. The supplied native asset is never downloaded.
- * @experimental Native segmentation adapter; unqualified for general mask or object accuracy.
+ * Structural validation does not establish semantic mask or object quality.
  */
 export async function createGrabCutSegmenter(options) {
     const checked = optionsSchema.safeParse(options);

package/dist/infrastructure/segmentation/mobile-sam/object-proposals.d.ts

@@ -2,6 +2,6 @@ import type { ObjectProposalPort } from '../../../entities/object-proposals.js';
 import { type MobileSamObjectProposalsOptions } from './options.js';
 /**
  * Explicit CPU-only proposals: historical 3x3/36 default or opt-in seed-center/four.
- * @experimental Native proposal adapter; unqualified for general spatial or mask accuracy.
+ * Native proposal adapter; no general spatial or mask quality is implied.
  */
 export declare function createMobileSamObjectProposals(options: MobileSamObjectProposalsOptions): Promise<ObjectProposalPort>;

package/dist/infrastructure/segmentation/mobile-sam/object-proposals.js

@@ -10,7 +10,7 @@ import { proposalOptionsSchema } from './options.js';
 import { snapshotProposalInput } from './input.js';
 /**
  * Explicit CPU-only proposals: historical 3x3/36 default or opt-in seed-center/four.
- * @experimental Native proposal adapter; unqualified for general spatial or mask accuracy.
+ * Native proposal adapter; no general spatial or mask quality is implied.
  */
 export async function createMobileSamObjectProposals(options) {
     const checked = proposalOptionsSchema.safeParse(options);

package/dist/infrastructure/segmentation/mobile-sam/options.d.ts

@@ -18,7 +18,7 @@ export declare const optionsSchema: z.ZodObject<{
     deviceId?: number | undefined;
     threads?: number | undefined;
 }>;
-/** @experimental Options for the unqualified MobileSAM segmentation factory. */
+/** Options for the MobileSAM segmentation factory (caller-supplied pinned assets). */
 export type MobileSamSegmenterOptions = z.input<typeof optionsSchema>;
 export declare const proposalOptionsSchema: z.ZodObject<{
     encoderPath: z.ZodString;
@@ -39,5 +39,5 @@ export declare const proposalOptionsSchema: z.ZodObject<{
     threads?: number | undefined;
     sampling?: "seed-grid" | "seed-center" | undefined;
 }>;
-/** @experimental Options for the unqualified MobileSAM object-proposal factory. */
+/** Options for the MobileSAM object-proposal factory (caller-supplied pinned assets). */
 export type MobileSamObjectProposalsOptions = z.input<typeof proposalOptionsSchema>;

package/dist/infrastructure/segmentation/mobile-sam/segmenter.d.ts

@@ -14,7 +14,7 @@ type SerializedTask = (Omit<Extract<NativeSegmentationRequest, {
 });
 /**
  * Explicit pinned MobileSAM inference in a separately owned Node child process.
- * @experimental Native segmentation adapter; unqualified for general mask or object accuracy.
+ * Structural validation does not establish semantic mask or object quality.
  */
 export declare function createMobileSamSegmenter(options: MobileSamSegmenterOptions): Promise<SegmentationPort>;
 /** Internal adapter seam: pool ownership stays with the caller. */

package/dist/infrastructure/segmentation/mobile-sam/segmenter.js

@@ -10,7 +10,7 @@ import { snapshotInput, snapshotPreviousMask } from './input.js';
 import { packFullSourceBinaryMask, unpackFullSourceBinaryMask, validateMobileSamPreviousMask, } from './segmentation-masks.js';
 /**
  * Explicit pinned MobileSAM inference in a separately owned Node child process.
- * @experimental Native segmentation adapter; unqualified for general mask or object accuracy.
+ * Structural validation does not establish semantic mask or object quality.
  */
 export async function createMobileSamSegmenter(options) {
     const checked = optionsSchema.safeParse(options);

package/docs/README.ru.md

@@ -1,40 +1,54 @@
 # Zorya Classifier: руководство
 
+> **В этом пилоте H8a дал более полные рамки без дообучения: 7/9 против 3/9 у встроенного Jev 1.14**
+>
+> Это один открытый пилот DEV12: 12 задач на 9 исходных изображениях (четыре цели интерфейса используют один скриншот), 9 задач с объектом и 3 без. Сравниваются исторический результат H8a и один новый прогон Jev. Конвейер сегментации формирует маски-кандидаты, а явно настроенная модель OpenAI **gpt-6-luna** выбирает одну из них; рамка строится по пикселям выбранной маски. Дополнительного обучения для этого сравнения не было. Встроенный Jev 1.14 использует Box+Noul и возвращает рамку, а не маску. Для строгого зачёта одна и та же рамка-кандидат должна иметь IoU ≥0,5 с рамкой эталонного объекта и покрывать не менее 90% этой эталонной рамки. Это не проверка на отложенной выборке и не квалификация точности.
+>
+> | Показатель                                               | H8a              | Jev 1.14      |
+> | -------------------------------------------------------- | ---------------- | ------------- |
+> | Строгий критерий рамки                                   | 7/9              | 3/9           |
+> | IoU ≥0,5 без проверки покрытия (вспомогательная метрика) | 7/9              | 8/9           |
+> | Ложные обнаружения, когда объекта нет (меньше — лучше)   | 2/3 (Bowl, Undo) | 1/3 (Fighter) |
+>
+> [Полный отчёт](https://github.com/zoomplus/zorya-classifier/blob/v0.2.3/docs/research/v03-jev-native-box-results.ru.md) · [JSON-доказательная база](https://github.com/zoomplus/zorya-classifier/blob/v0.2.3/docs/evidence/v03/jev-native-box-dev12-20261025.json) · [Скачать визуальное сравнение ZIP](https://github.com/zoomplus/zorya-classifier/releases/download/v0.2.3/jev-native-box-dev12-comparison.zip)
+>
+> H8a здесь — только исследовательский рецепт: он не является стандартным путём `locate`/`extract` и не поставляется в npm как стратегия H8. Эти результаты не доказывают общую точность.
+
 Версия 0.2 добавляет прозрачный PNG, бинарную маску, её рамку и центр. Прежний поиск области служит подсказкой для сегментации всего исходного изображения. Затем порт решений проверяет рамку; допускаются одно расширение маски и повторная проверка. [Руководство](v02-usage.md) описывает API, CLI и владение ресурсами.
 
 [Независимый тест 80 случаев](evidence/v02/region-seeded-heldout-v3/README.md) прошёл согласованные критерии, но показал ограниченную полноту: 26/60 попаданий в область объекта и 8/60 полных рамок, без ложных выделений на 20 отрицательных случаях. Из 30 эталонных масок восемь достигли IoU 0,8, три не достигли, для 19 предсказание отсутствовало. Это результаты одной явно настроенной комбинации Luna/OpenAI и MobileSAM, а не гарантия для любой модели или игры.
 
-Сравнение шести способов передачи изображения текстом завершено на свежих фотографиях и реальном интерфейсе: ни один не прошёл требования локализации. [Результаты и ограничения](evidence/v02/fresh-text/README.md) сохранены, публичный экспериментальный режим явно возвращает `UNSUPPORTED`.
+Сравнение шести способов передачи изображения текстом завершено на свежих фотографиях и реальном интерфейсе: ни один не прошёл требования локализации. [Результаты и ограничения](evidence/v02/fresh-text/README.md) сохранены; публичный селектор IMAGE-AS-TEXT удалён — запросы с ним отклоняются на этапе валидации (`INVALID_INPUT`). Кодеки остаются только в `benchmarks/experiments/`.
 
-Zorya Classifier — библиотека для Node.js и TypeScript с поддерживаемой классификацией по тексту и изображениям и экспериментальной, не квалифицированной для общего применения пространственной локализацией и извлечением объектов. Библиотека не выбирает и не подключает модель за приложение: клиент получает явно переданный `DecisionPort` — готовый адаптер с выбранными настройками или собственную реализацию. Модель и провайдер в примерах — лишь варианты интеграции, не значения по умолчанию. Код распространяется по MIT; веса модели в поставку не входят, запросы удалённых моделей оплачиваются отдельно; можно подключить и свой локальный сервер. Совместимость и качество зависят от выбранного маршрута. Более мощная модель может помочь, но улучшение точности не гарантировано. Проверенные комбинации и результаты перечислены в [таблице моделей](vision-results.md).
+Zorya Classifier — библиотека для Node.js и TypeScript с поддерживаемой классификацией по тексту и изображениям и реализованными API пространственной локализации и извлечения объектов (модель, провайдер и нативные ресурсы — на стороне вызывающего). Библиотека не выбирает и не подключает модель за приложение: клиент получает явно переданный `DecisionPort` — готовый адаптер с выбранными настройками или собственную реализацию. Модель и провайдер в примерах — лишь варианты интеграции, не значения по умолчанию. Код распространяется по MIT; веса модели в поставку не входят, запросы удалённых моделей оплачиваются отдельно; можно подключить и свой локальный сервер. Совместимость и качество зависят от выбранного маршрута. Более мощная модель может помочь, но улучшение точности не гарантировано. Проверенные комбинации и результаты перечислены в [таблице моделей](vision-results.md).
 
 Это самостоятельная библиотека: ей не нужны Zorya Games, Electron, база данных или игровой процесс. Её можно встроить в сервер, бота, инструмент обработки фотографий или собственный HTTP-сервис. Готовый постоянно работающий HTTP-сервер в пакет не входит.
 
 ## Статус возможностей
 
-Дальнейшие эксперименты по точности пространственных сценариев остановлены; ни одна стратегия локализации, извлечения или предложений масок не продвигается для общего использования. Исторические метрики в `docs/evidence/**` сохранены без переинтерпретации.
+Пространственные API реализованы и документированы; сравнение рамок [H8a vs Jev на DEV12](https://github.com/zoomplus/zorya-classifier/blob/v0.2.3/docs/research/v03-jev-native-box-results.ru.md) — один исследовательский рецепт, не default библиотеки. Исторические метрики в `docs/evidence/**` сохранены без переинтерпретации. Сквозной ordinary-vision профиль H8a на DEV12 также описан в [базовом отчёте](https://github.com/zoomplus/zorya-classifier/blob/v0.2.3/docs/research/v03-h8a-development-baseline.ru.md).
 
-| Возможность                                   | Статус           | Примечание                                                                     |
-| --------------------------------------------- | ---------------- | ------------------------------------------------------------------------------ |
-| `classify` с явным `DecisionPort`             | Поддерживается   | Один закрытый ID класса; без заявления об универсальной точности модели        |
-| `locate` (сетка регионов)                     | Экспериментально | Гипотеза по ячейке, не геометрия целого объекта и не доказательство отсутствия |
-| `RefinementPort`                              | Экспериментально | Без общей квалификации качества                                                |
-| `locate({ mode: 'whole-object' })`            | Экспериментально | Интервалы или сегментация вызывающего; без квалификации                        |
-| `extract`, `SegmentationPort`, проверка рамки | Экспериментально | Структурный успех ≠ семантическая точность маски                               |
-| `objectProposals`, нативные фабрики           | Экспериментально | На стороне вызывающего; без квалификации                                       |
-| `experimental-text`                           | Отклонено        | `UNSUPPORTED`, пока профиль не пройдёт отбор                                   |
+| Возможность                                   | Статус         | Примечание                                                                     |
+| --------------------------------------------- | -------------- | ------------------------------------------------------------------------------ |
+| `classify` с явным `DecisionPort`             | Поддерживается | Один закрытый ID класса; без заявления об универсальной точности модели        |
+| `locate` (сетка регионов)                     | Доступно       | Гипотеза по ячейке, не геометрия целого объекта и не доказательство отсутствия |
+| `RefinementPort`                              | Доступно       | Опциональный legacy-хук на стороне вызывающего                                 |
+| `locate({ mode: 'whole-object' })`            | Доступно       | Интервалы или сегментация вызывающего                                          |
+| `extract`, `SegmentationPort`, проверка рамки | Доступно       | Структурный успех ≠ семантическая точность маски                               |
+| `objectProposals`, нативные фабрики           | Доступно       | На стороне вызывающего; ресурсы модели/runtime не поставляются библиотекой     |
+| `experimental-text`                           | Удалено из API | `INVALID_INPUT`; исследовательские кодеки только в benchmarks                  |
 
 Heldout region-seeded (один задокументированный рецепт): 26/60 попаданий seed на позитивах; 8/60 полных рамок объекта; на 30 эталонных масках — 8 с IoU 0,8, 3 неудачи, 19 без предсказания. H8 DEV: 7/9 позитивов и 2/3 ложных выхода, без квалификации. Узкий исторический admission — не общая пространственная квалификация.
 
 ## Что умеет
 
-| Задача                                                     | Статус           | API                                 | Результат                                                                         |
-| ---------------------------------------------------------- | ---------------- | ----------------------------------- | --------------------------------------------------------------------------------- |
-| Распределить обращения по отделам, определить намерение    | Поддерживается   | `classify` с текстом                | Один из заданных классов и ранжирование вариантов                                 |
-| Проверить наличие объекта или выбрать категорию фотографии | Поддерживается   | `classify` с изображением           | Один из заданных классов                                                          |
-| Оценить изображение с текстовым условием                   | Поддерживается   | `classify` с текстом и изображением | Класс с учётом обоих входов                                                       |
-| Найти примерную область предмета, значка или указателя     | Экспериментально | `locate`                            | Ячейка в координатах исходного изображения либо явная неопределённость/отсутствие |
-| Получить маску, рамку, центр и прозрачный вырез предмета   | Экспериментально | `extract` с явным сегментатором     | Геометрия и вырез, выведенные из пикселей маски                                   |
+| Задача                                                     | Статус         | API                                 | Результат                                                                         |
+| ---------------------------------------------------------- | -------------- | ----------------------------------- | --------------------------------------------------------------------------------- |
+| Распределить обращения по отделам, определить намерение    | Поддерживается | `classify` с текстом                | Один из заданных классов и ранжирование вариантов                                 |
+| Проверить наличие объекта или выбрать категорию фотографии | Поддерживается | `classify` с изображением           | Один из заданных классов                                                          |
+| Оценить изображение с текстовым условием                   | Поддерживается | `classify` с текстом и изображением | Класс с учётом обоих входов                                                       |
+| Найти примерную область предмета, значка или указателя     | Доступно       | `locate`                            | Ячейка в координатах исходного изображения либо явная неопределённость/отсутствие |
+| Получить маску, рамку, центр и прозрачный вырез предмета   | Доступно       | `extract` с явным сегментатором     | Геометрия и вырез, выведенные из пикселей маски                                   |
 
 Для `extract` после сегментации порт решений получает полный исходник с рамкой из маски и исходной подсказкой `seed`. Ответ закрыт: `complete` (можно вернуть результат и опциональный вырез), `needs-expansion` (не более одного расширения охватывающей маски и одной финальной проверки; повторный `complete` после финальной проверки тоже допускает результат) или `unknown` (неразрешённая проверка, нет поддержки расширения, нет действительной охватывающей маски или провал финальной проверки — второго расширения нет). Внутри одного `extract` со встроенным `locate` — до трёх запросов на поиск области и до двух закрытых проверок рамки. Без подтверждения библиотека возвращает неопределённость и не публикует частичный вырез. Рамка и центр только из пикселей маски; успешная проверка рамки не доказывает идеальную сегментацию по пикселям. Порт решений подключается через `DecisionPort`; сегментатор остаётся на стороне вызывающего.
 
@@ -52,7 +66,7 @@ Heldout region-seeded (один задокументированный реце
 npm install zorya-classifier
 ```
 
-Для локального/релизного архива также работает `npm install ./zorya-classifier-0.2.0.tgz` (имя следует версии в `package.json`; это не заявление о новой публикации в npm).
+Для локального/релизного архива также работает `npm install ./zorya-classifier-0.2.3.tgz` (имя архива соответствует версии в `package.json`).
 
 Скопируйте пример конфигурации в локальный `.env` и заполните значение `OPENROUTER_API_KEY` своим ключом. В репозитории `.env` исключён из Git; в своём проекте тоже добавьте это исключение. Не помещайте ключ в браузерный React-код, приложение клиента или публичный репозиторий. Вызовы модели выполняйте на доверенном сервере.
 
@@ -127,9 +141,9 @@ const result = await client.classify({
 
 Для одной картинки поле `text` можно опустить. Принимаются `Uint8Array` и `Buffer` с одним PNG/JPEG/WebP: до 16 MiB и 16 777 216 декодированных пикселей. Ссылки на изображения публичный API не загружает — скачивание, права доступа и ограничения внешних URL остаются у вызывающего приложения.
 
-## Поиск объекта и координаты (экспериментально)
+## Поиск объекта и координаты
 
-Обычный `locate` экспериментален и не квалифицирован для общего применения. Также внутри `try`:
+Локализация и обычный `locate` доступны в публичном API. Региональный `locate` по умолчанию возвращает гипотетическую ячейку сетки, а не точную рамку объекта, маску, центр, доказательство отсутствия или универсальную точность. Пример внутри `try`:
 
 ```js
 const result = await client.locate({
@@ -252,7 +266,7 @@ const client = createClassifier({ decision })
 
 [Таблица проверенных моделей](vision-results.md) содержит названия, провайдеров, число примеров, ошибки, точность, задержки и цену. Там отдельно указаны полноценная проверка на корпусе, короткий screening и тесты адаптера с искусственным сервером. Необозначенная модель не считается автоматически проверенной.
 
-Исторический Jev-прогон дал 55/60 на фото и 30/30 на авторских текстовых примерах. Это исходный эталон прежнего адаптера, а не доказательство качества или превосходства другой модели. Результаты не позволяют предполагать, что более мощная модель обязательно повысит точность. Подробности и исходные ошибки сохранены в [исторических результатах](results.md). Локализация остаётся экспериментальной; ячейка не является точной маской или центром объекта.
+Исторический Jev-прогон дал 55/60 на фото и 30/30 на авторских текстовых примерах. Это исходный эталон прежнего адаптера, а не доказательство качества или превосходства другой модели. Результаты не позволяют предполагать, что более мощная модель обязательно повысит точность. Подробности и исходные ошибки сохранены в [исторических результатах](results.md). Локализация доступна; выбранная ячейка не является точной маской, центром объекта, сегментацией или гарантией универсальной точности карты.
 
 ## Разработка и следующие документы
 

package/docs/acceptance.md

@@ -1,6 +1,8 @@
 # Acceptance: standalone library
 
-This acceptance concerns the extracted MIT Node.js library, not the Zorya desktop application, installer, microphone or game session. The caller supplies a `DecisionPort` or explicitly configures an adapter; model/provider recipes below are examples, not library defaults. Closed `classify` and explicitly configured provider/transport adapters are supported integration paths. Region `locate`, whole-object location, extraction, `RefinementPort`, segmentation/box-check composition, `objectProposals`, and native segmentation factories are experimental and unqualified; public API symbols carry `@experimental`. Further spatial accuracy experiments are stopped; no strategy is promoted. Jev is optional historical compatibility.
+This acceptance concerns the extracted MIT Node.js library, not the Zorya desktop application, installer, microphone or game session. The caller supplies a `DecisionPort` or explicitly configures an adapter; model/provider recipes are examples, not library defaults. Closed `classify` and explicitly configured provider/transport adapters are supported integration paths.
+
+Region `locate`, whole-object location, extraction, `RefinementPort`, segmentation/box-check composition, `objectProposals` and native segmentation factories are implemented public APIs. A region cell is a search hypothesis, not a whole-object box; box checks and pixel-mask quality are separate measurements. One exposed DEV12 pilot compared historical H8a output with a single native Jev 1.14 run: H8a passed the strict same-instance box criterion on 7/9 positive tasks, Jev on 3/9. This is a research result, not a default `locate`/`extract` strategy or a general accuracy claim. See the [full comparison](research/v03-jev-native-box-results.ru.md) and [evidence](evidence/v03/jev-native-box-dev12-20261025.json). Jev remains optional historical compatibility.
 
 ## Current 0.2 acceptance
 
@@ -75,7 +77,7 @@ A separate [reconstructed C03 diagnostic](evidence/v02/reconstructed-c03-box.jso
 | Two-hour resource soak               | Old snapshot passed; fresh `450439c` two-thread run is active, no result yet                  |
 | First frozen blind vision candidate  | Failed both false-location and paired-bootstrap gates                                         |
 | Second frozen blind vision candidate | Failed: 1/60 whole boxes; paired lower bound zero; new development required                   |
-| Text-only encoders                   | None qualified; public experimental image selector returns `UNSUPPORTED`                      |
+| Text-only encoders                   | None qualified; public experimental image selector removed (`INVALID_INPUT` on strict parse)  |
 | Publication                          | Pending all mandatory gates                                                                   |
 
 ## 0.2 development snapshot, 2026-10-20
@@ -103,7 +105,7 @@ Hosted CI for source `32aa90d` passed every Windows/Linux × Node 22/24 job, inc
 
 The subsequent [CI run for `9d00fe5`](evidence/v02/ci-9d00fe5.json) passed all four Windows/Linux × Node 22/24 jobs with 316 offline tests and the installed-archive checks. Earlier platform-path and formatting failures remain preserved. This verifies that source snapshot, not a later untested release or real-provider accuracy.
 
-All six text-image encoders remain research-only. The [fresh independent comparison](evidence/v02/fresh-text/README.md) is complete for photographs and real UI: every encoder has zero correct whole-object matches, and some violate the negative-case gate. None qualifies for heldout promotion. The initial classification harness defect and corrected classification-only follow-ups are preserved separately; they do not overwrite the localization runs. Failed protocol/rate-limit/truncated-generation diagnostics remain recorded. The public experimental image selector rejects explicitly. Historical controlled map/UI renders with model-assisted labels remain an exploratory supplement: their source licensing and split are recorded, but they do not close the independent-ground-truth gate.
+All six text-image encoders remain research-only. The [fresh independent comparison](evidence/v02/fresh-text/README.md) is complete for photographs and real UI: every encoder has zero correct whole-object matches, and some violate the negative-case gate. None qualifies for heldout promotion. The initial classification harness defect and corrected classification-only follow-ups are preserved separately; they do not overwrite the localization runs. Failed protocol/rate-limit/truncated-generation diagnostics remain recorded. The public experimental image selector was removed; strict input validation rejects it with `INVALID_INPUT`. Historical controlled map/UI renders with model-assisted labels remain an exploratory supplement: their source licensing and split are recorded, but they do not close the independent-ground-truth gate.
 
 Subsequent [whole-object prompt/presentation experiments](evidence/v02/boundary-variants.md) found one correctly bounded Car example after removing the separate seed crop and outlining that seed on the original. Boat still returned unknown; this is development evidence, not qualification. A [controlled real-UI oracle](https://github.com/zoomplus/zorya-classifier/blob/main/benchmarks/v02/corpus/dev-independent-ui/README.md) now independently derives seven button boxes from GTK accessibility allocations and verifies all painted edges in the captured pixels. Its three negatives are scoped to the completely inventoried visible toolbar. It is one controlled source family, not a diverse natural-UI benchmark.
 
@@ -135,7 +137,7 @@ Historical native Windows/source and secret-scan receipts remain under docs/evid
 
 Luna Decisions matches the historical Jev photo/text counts on this corpus; this is not proof of statistical non-inferiority, calibration or universal superiority. Two disjoint native sessions cover the full90 classification cases without replay or prompt changes. Public photographs may overlap training; text cases are authored fixtures, not customer traffic. No independent annotation/duplicate audit was performed.
 
-Localization is experimental. The first native smoke failed at its195-option/nine-image fine request; an explicit replay returned HTTP502 with provider refusal. The original error and diagnostic remain preserved. A separate fixed flower-image smoke completed all three native stages in4.75s; its reviewed receipt is in docs/evidence, and it does not replace a full localization evaluation. A selected cell is not segmentation, an exact object center, tracking or a universal map/minimap guarantee. Offline fixtures are not real-model quality evidence.
+Region `locate` is an implemented public API. By default it returns a hypothesized grid cell, not an exact object box, mask, center or proof of absence. It makes no universal accuracy guarantee. This section also records an older native-model smoke: its first attempt failed on a fine-grained request with 195 options and nine images; a separate replay returned HTTP 502 with a provider refusal. The original error and diagnostic remain preserved. A fixed flower-image smoke completed all three native stages in 4.75 seconds, but it is not a full localization evaluation and does not qualify general `locate` quality. A selected cell is not segmentation, an exact object center, tracking or a universal map/minimap guarantee. Offline fixtures are not real-model quality evidence.
 
 Paid comparison accounting is separate from the historical337-call Jev work. The owner expanded the comparison limit to1000 calls while retaining the$0.50 ceiling. Reported costs are reconciled only from retained numeric receipts; failed classifications remain failures, unknown charges retain conservative reservations. Local admission accounting is not a provider-side account cap or a verified invoice. The comparison finished at332 calls, known cost$0.03456876 and four unknown costs; conservative accounted exposure is$0.23456876. Exact receipts are in the model evidence/release manifest.
 

package/docs/agents.ru.md

@@ -4,24 +4,26 @@
 
 ## Глобальные правила владельца
 
-Cursor **не** подгружает автоматически файлы из `/root/.cursor/rules/`. **Главный оркестратор** и **каждый** порождённый подагент Codex должны прочитать оба канонических файла:
+Cursor **не** подгружает автоматически файлы из `/root/.cursor/rules/`. **Главный оркестратор** и **каждый** порождённый подагент Codex должны прочитать все три канонических файла:
 
-| Файл                                                                            | Назначение                                                                                                     |
-| ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
-| `repository-cleanliness.mdc` (`/root/.cursor/rules/repository-cleanliness.mdc`) | Уборка только артефактов текущей задачи; сохранять чужие ветки, блокировки и журналы проверок                  |
-| `context7.mdc` (`/root/.cursor/rules/context7.mdc`)                             | Внешняя документация SDK, API и CLI по запросу; **не** для внутреннего рефакторинга и документации репозитория |
+| Файл                                                                            | Назначение                                                                                                             |
+| ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `repository-cleanliness.mdc` (`/root/.cursor/rules/repository-cleanliness.mdc`) | Уборка только артефактов текущей задачи; сохранять чужие ветки, блокировки и журналы проверок                          |
+| `context7.mdc` (`/root/.cursor/rules/context7.mdc`)                             | Внешняя документация SDK, API и CLI по запросу; **не** для внутреннего рефакторинга и документации репозитория         |
+| `text-authorship.mdc` (`/root/.cursor/rules/text-authorship.mdc`)               | Постоянный пользовательский текст пишет `gpt-6-luna` / `high` / `fork_turns=none`, если владелец явно не разрешил иное |
 
 **Координатор** **включает** применимые пункты глобальных правил и [контракт участников](https://github.com/zoomplus/zorya-classifier/blob/main/AGENTS.md) в текст каждой задачи для исполнителя Composer. Не дублировать глобальные правила в [правила проекта](https://github.com/zoomplus/zorya-classifier/blob/main/.cursor/rules/zorya-classifier.mdc).
 
 ## Роли
 
-| Роль                     | Модель / исполнитель                                                                                       | Обязанности                                                                                                                                                                                                                                                            |
-| ------------------------ | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Главный оркестратор**  | Выбирает **человек** (нет модели главного по умолчанию)                                                    | По умолчанию: анализ, исследование, проверка изменений, планирование, прогон тестов, интеграция в Git после проверки; **никогда** не запускает и не владеет Cursor CLI; **не** подменяет Composer при правках исходников, тестов и документации в разрешённых границах |
-| **Координатор**          | **`gpt-6-luna`**, рассуждение **`high`**, **`fork_turns=none`** (иначе — только явная инструкция человека) | Владелец **каждого** процесса Cursor CLI; предварительная проверка CLI перед первым запуском; постановка задач Composer; проверка фактических изменений и журналов; передача владения — только явно                                                                    |
-| **Исполнитель Composer** | **`composer-2.5-fast`**                                                                                    | Редактирует разрешённые пути **сам**; **не** запускает `cursor-agent`, не делегирует и не запускает вложенных агентов                                                                                                                                                  |
+| Роль                     | Модель / исполнитель                                                                                       | Обязанности                                                                                                                                                                                                                                                                       |
+| ------------------------ | ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Главный оркестратор**  | Выбирает **человек** (нет модели главного по умолчанию)                                                    | По умолчанию: анализ, исследование, проверка изменений, планирование, прогон тестов, интеграция в Git после проверки; **никогда** не запускает и не владеет Cursor CLI; технические правки передаёт Composer, а прозу — автору Luna согласно отдельному правилу                   |
+| **Автор текста Luna**    | **`gpt-6-luna`**, рассуждение **`high`**, **`fork_turns=none`**                                            | Пишет пользовательский и постоянный текст: документацию, описания, сообщения CLI/интерфейса и прозу в комментариях. Может править только текст; не меняет исполняемую логику, тесты или конфигурацию времени выполнения. В смешанной задаче передаёт точную формулировку Composer |
+| **Координатор**          | **`gpt-6-luna`**, рассуждение **`high`**, **`fork_turns=none`** (иначе — только явная инструкция человека) | Владелец **каждого** процесса Cursor CLI; предварительная проверка CLI перед первым запуском; постановка задач Composer; проверка фактических изменений и журналов; передача владения — только явно                                                                               |
+| **Исполнитель Composer** | **`composer-2.5-fast`**                                                                                    | Выполняет технические изменения в исходниках, тестах и конфигурации; в смешанной задаче вставляет предоставленный Luna текст без переписывания. **Не** запускает `cursor-agent`, не делегирует и не запускает вложенных агентов                                                   |
 
-**Каждый** подагент Codex любой роли (включая координацию и явно запрошенные исследование или проверку изменений) порождается как **`gpt-6-luna` / `high` / `fork_turns=none`**, если человек не указал иное.
+**Каждый** подагент Codex любой роли (включая координацию, автора текста и явно запрошенные исследование или проверку изменений) порождается как **`gpt-6-luna` / `high` / `fork_turns=none`**, если человек не указал иное. Владелец уже дал постоянное разрешение на такую роль, поэтому не нужно спрашивать отдельно для каждой задачи. Если главный оркестратор сам работает на Luna, он может написать текст напрямую; не нужно менять выбранную человеком модель или создавать дублирующую роль.
 
 Отдельные подагенты для исследования или проверки изменений — **только по явному запросу** человека и остаются **только для чтения**. Иначе исследование и проверку изменений выполняет главный оркестратор.
 
@@ -70,7 +72,7 @@ cursor-agent \
 - v0.2 `extract`: геометрия из маски, закрытая проверка рамки, не более одного расширения маски и финальной проверки; без координат от модели.
 - Ранг не равен вероятности; один финальный ID против четырёх кандидатов пространственной стадии луча.
 - Каталог `benchmarks`: `hashCanonical` = `SHA-256`(`JSON.stringify`) с фиксированным порядком полей.
-- Исследования в `benchmarks/experiments/` — вне дистрибутива npm; публичный профиль `experimental-text` явно отклоняет не квалифицированные запросы.
+- Исследования в `benchmarks/experiments/` — вне дистрибутива npm; публичный селектор IMAGE-AS-TEXT удалён (`INVALID_INPUT`); benchmark-only композиция через `createResearchClassifier`.
 
 ## Тесты
 

package/docs/api.md

@@ -1,22 +1,22 @@
 # Public API
 
-Spatial localization, whole-object location, extraction, `RefinementPort`, caller-owned segmentation/box-check composition, `objectProposals`, and native segmentation factories are **experimental and unqualified** for general use (TypeScript `@experimental` on the corresponding public types and methods). Closed `classify` and explicitly configured `DecisionPort`/transport adapters remain supported; they do not imply universal model accuracy. Further spatial accuracy experiments are stopped; no strategy is promoted.
+Spatial localization, whole-object location, extraction, `RefinementPort`, caller-owned segmentation/box-check composition, `objectProposals`, and native segmentation factories are implemented public APIs. Grid cells from default `locate` are not whole-object boxes; mask-derived geometry and box-check verdicts measure different things; model, provider and native assets remain caller-supplied. Closed `classify` and explicitly configured `DecisionPort`/transport adapters remain supported; they do not imply universal model accuracy. The [H8a vs Jev DEV12 box comparison](research/v03-jev-native-box-results.ru.md) is a research recipe, not a library default.
 
 `createClassifier({ decision, timeoutMs?, concurrency?, maxQueue?, maxInputBytes?, refinement?, segmentation?, objectProposals? })` creates an owned client. Defaults: 45,000ms absolute budget including queue/image work/provider work; two active operations; sixteen waiters; 64 MiB total admitted input bytes, reserved before copying. Configured maxima: 120s, four active,32 queued,256 MiB admitted input. Input images are at most16MiB and16,777,216 decoded pixels, with source sides at most16,384; single PNG/JPEG/WebP only. The vision adapter accepts prepared PNG/JPEG with sides280..1568 and a32MiB total request cap. Byte inputs are copied before the first await, including Buffer views.
 
 The caller supplies the `DecisionPort`; the library never chooses a model, provider or endpoint. You may inject a port directly or explicitly construct one of the adapters below. Their model/provider values are examples or benchmark recipes, not defaults, and stronger models do not guarantee higher accuracy. Optional segmentation adapters are configured separately and require caller-installed runtime packages and caller-supplied local assets.
 
-The [0.2 guide](v02-usage.md) documents `extract`, mask-derived `locate({ mode: 'whole-object', ... })`, optional native adapters and the reserved experimental representation selector. Default region behavior is unchanged. The primary object flow runs the original region locator, then prompts the caller-configured segmenter on the full oriented source image; the actual mask determines bounds, center and cutout. A closed containment check then sees the full source with the actual mask-derived box and seed anchor. An incomplete box can trigger one optional `SegmentationPort.expand(input, previousMask)` and one final check; missing support or unresolved verification returns `unknown/segmentation-uncertain`. The previous mask is full-source binary-u8. `segmentationBoxCheck` can inject a custom checker; otherwise the same caller-supplied `decision` is reused. `verification.checks` retains each closed decision and `verification.expansion` records the correction path; all decision receipts contribute to localization metadata. This checks box containment separately from pixel-mask quality, without an extent search. Native factories are exported from `zorya-classifier/segmentation`; the caller supplies and disposes the segmenter separately. `objectProposals` and interval-based whole-object location remain optional legacy strategies. The segmentation entry also exports `packBinaryMask`/`unpackBinaryMask` for custom adapters.
+The [0.2 guide](v02-usage.md) documents `extract`, mask-derived `locate({ mode: 'whole-object', ... })`, optional native adapters and public `representation: { type: 'vision' }` compatibility. The former experimental text-image selector was removed from public input. Default region behavior is unchanged. The primary object flow runs the original region locator, then prompts the caller-configured segmenter on the full oriented source image; the actual mask determines bounds, center and cutout. A closed containment check then sees the full source with the actual mask-derived box and seed anchor. An incomplete box can trigger one optional `SegmentationPort.expand(input, previousMask)` and one final check; missing support or unresolved verification returns `unknown/segmentation-uncertain`. The previous mask is full-source binary-u8. `segmentationBoxCheck` can inject a custom checker; otherwise the same caller-supplied `decision` is reused. `verification.checks` retains each closed decision and `verification.expansion` records the correction path; all decision receipts contribute to localization metadata. This checks box containment separately from pixel-mask quality, without an extent search. Native factories are exported from `zorya-classifier/segmentation`; the caller supplies and disposes the segmenter separately. `objectProposals` and interval-based whole-object location remain optional legacy strategies. The segmentation entry also exports `packBinaryMask`/`unpackBinaryMask` for custom adapters.
 
 `classify({ input, classes, instructions?, signal? })`: input is a string or `{ text?, image? }` with at least one field. Classes are2..255 distinct IDs plus descriptions. IDs match `[a-zA-Z][a-zA-Z0-9_-]*`; descriptions at most300 chars. Text is at most32,000 chars, custom instructions4,000. Define explicit none/other behavior in your classes. With ordinary vision models the result contains `choice` (first ranked ID), `ranking`, `probabilities: null`, `nativeChoice: null`, empty `tied`, and metadata. No rank is converted to a fabricated probability. Optional native integrations instead retain raw probabilities, stable maximum/ties, native choice/confidence and optional quantization annotation. Confidence is never a calibrated spatial guarantee.
 
-`locate({ image, target, exclusions?, roi?, signal? })` (**experimental**): target at most2,000 chars; up to16 exclusions of500 chars. ROI uses integer `left/top/width/height` in EXIF-oriented source pixels. Return coordinates reference that oriented image; metadata names this space and dimensions. Rectangles include left/top and exclude right/bottom. Normalized rectangle fields are divided by image dimensions. Tiny/impossible bounded grids return `unknown/layout-limit`.
+`locate({ image, target, exclusions?, roi?, signal? })` (available): target at most2,000 chars; up to16 exclusions of500 chars. ROI uses integer `left/top/width/height` in EXIF-oriented source pixels. Return coordinates reference that oriented image; metadata names this space and dimensions. Rectangles include left/top and exclude right/bottom. Normalized rectangle fields are divided by image dimensions. Tiny/impossible bounded grids return `unknown/layout-limit`.
 
 `located` from default region mode returns a selected grid region, normalized region, third-stage selection evidence and optional refinement. `not-found/absent-in-evaluated-region` is based on the initial independent presence check. A target missing from later shortlisted cells yields `unknown/candidate-union-empty`, not global absence. Ordinary models return present/absent/unknown as an independent categorical predicate. Legacy Noul0.5 abstains; contradictory presence/selection returns unknown. Multiple physical matching objects are permitted; this is an any-instance locator. With an explicit `segmentation` port, `locate({ mode: 'whole-object' })` and `extract` use the region seed plus full-source segmentation; reported bounds and center come from the valid mask.
 
 The algorithm searches4×4 coarse cells, keeps four source-distinct maxima, pads each by half a coarse cell within ROI, partitions each into at most49 fine cells (global≤196, side≤256), then compares the four best fine cells as enlarged A–D/none. Edges count as matches. Scores/rank hints are not sent to the final comparison. No cell-center correction is presented as object segmentation.
 
-`RefinementPort.refine({ image, target, region, signal })` (**experimental**) is optional trusted code. It receives a private oriented-source byte copy. A returned refined rectangle must fit the source and intersect the selected cell. It does not replace the original area evidence. No built-in heavy refiner is downloaded.
+`RefinementPort.refine({ image, target, region, signal })` (available) is optional trusted code. It receives a private oriented-source byte copy. A returned refined rectangle must fit the source and intersect the selected cell. It does not replace the original area evidence. No built-in heavy refiner is downloaded.
 
 `dispose()` cancels current/queued work, rejects further calls and waits for physical settlement. Injected ports must honor cancellation. Native image work retains its concurrency slot until completion, even if cancellation has already been requested.
 

package/docs/architecture.md

@@ -2,13 +2,13 @@
 
 Russian guide with layer map, SOLID notes and current paths: [architecture.ru.md](architecture.ru.md). Development onboarding: [development.ru.md](development.ru.md).
 
-Closed `classify` and injected `DecisionPort`/adapter transport are supported integration paths. Region `locate`, whole-object location, extraction, `RefinementPort`, caller-owned segmentation and box-check composition, `ObjectProposalPort`, and explicit native segmentation factories are experimental and unqualified; they are labeled `@experimental` on the public API. No spatial or extraction strategy is promoted; evidence under `docs/evidence/**` remains historical.
+Closed `classify` and injected `DecisionPort`/adapter transport are supported integration paths. Region `locate`, whole-object location, extraction, `RefinementPort`, caller-owned segmentation and box-check composition, `ObjectProposalPort`, and explicit native segmentation factories are implemented public APIs (grid cells ≠ whole-object boxes; masks and box checks differ). Evidence under `docs/evidence/**` remains historical; the DEV12 H8a vs Jev box comparison is documented separately as research, not a shipped default strategy.
 
 The public factory composes the caller-supplied `DecisionPort` and a Sharp-backed `RasterPort`. The library exposes four package entries (`.`, `./openrouter`, `./openai-compatible`, `./segmentation`); the CLI is a separate bin, not a fifth library export. The library does not select a model, provider or endpoint; applications either inject an existing port or explicitly build one with a supported adapter. **Import layers:** `app` composes `processes` and `infrastructure`; `processes` depend on `features`, `entities`, and `shared` port contracts only (no direct `processes` → `infrastructure` imports); `infrastructure` implements ports and may use `features`/`entities`/`shared`. Runtime calls reach HTTP, raster, and native work through injected port instances wired in `app`. Processes orchestrate classify/locate; features contain pure Choice interpretation, grid geometry and prompt construction; entities define validated public contracts. Benchmark runners live under `benchmarks/v02/`, `benchmarks/v03/`, and the repo root as well as helpers in `benchmarks/experiments/`; not all runners are under `experiments/`. No application runtime, game-state schema or workspace import is required.
 
 The primary 0.2 object path preserves the original region locator. Its selected seed prompts an explicitly configured segmenter on the full oriented source image; actual mask pixels determine bounds, center and the optional cutout. A generic closed containment checker receives the full source with the mask-derived box and original seed anchor. It uses the injected decision port and a presentation port; the process allows at most one actual enclosing-mask correction and a final check. The segmenter can implement optional `expand`; corrected foreground must strictly contain the old visible foreground and grow the real box within the hard ROI. The process rejects unresolved checks without publishing a partial cutout. Its absolute deadline, cancellation and byte ownership cover every stage. No additional extent search or model-generated coordinates are used. `locate({ mode: 'whole-object' })` and `extract` use the same mask-derived geometry when a segmenter is configured. Boundary-interval location and `ObjectProposalPort` remain optional legacy strategies with their own request flows.
 
-Extraction composes the selected locator with a caller-owned `SegmentationPort` and a `CutoutRasterPort`; processes import neither Sharp nor native inference. Explicitly created native adapters own their workers and queues, while the caller supplies and manages their optional runtime packages and local model assets. No weights are selected, installed or downloaded by the library. [Operation and ownership details](v02-usage.md) are explicit; no experimental text-image profile is publicly qualified yet.
+Extraction composes the selected locator with a caller-owned `SegmentationPort` and a `CutoutRasterPort`; processes import neither Sharp nor native inference. Explicitly created native adapters own their workers and queues, while the caller supplies and manages their optional runtime packages and local model assets. No weights are selected, installed or downloaded by the library. [Operation and ownership details](v02-usage.md) are explicit; the former experimental text-image selector was removed from public input (strict `INVALID_INPUT`). Research encoders remain benchmark-only.
 
 ```mermaid
 flowchart TB