textmachine/docs/glossary.md

Глоссарий — жаргон и сокращения проекта (один экран)

Читать при онбординге по мере надобности; термин непонятен → сюда. Пополняет оркестратор.

Роли и фазы

• Оркестратор / Бэкенд / Полигон / Фронт / Платформа — роли сессий с зонами записи (CLAUDE.md §Роли); платформа = SaaS control plane (platform/, D39.81). «Оркестратор №N» — канонический счётчик преемственности роли (текущий N — в шапке ORCHESTRATOR_SESSION_PROMPT).
• Хендофф(-промт) — передача роли новой сессии файлом-промтом; аддендумы к бегущей сессии доезжают только релеем владельца.
• Владелец — человек; ратифицирует деньги, скоуп-сдвиги, продукт, 18+; связной между сессиями.
• Ф0–Ф3 — фазы: Ф0 скелет · Ф1 инфраструктура · Ф2 качество (судья/гейты) · Ф2.5 пилот · Ф3 продукт (веб-фронт, ридер-IDE).
• S0–S7 / P0 — нумерация кодовых сессий зон: S-этапы фронта (D39.84) · P-этапы платформы (P0 — бутстрап, D39.100); не путать с фазами Ф0–Ф3.
• Зонный журнал / зонный бэклог — frontend/docs/frontend-PROGRESS.md · platform/docs/platform-PROGRESS.md и BACKLOG зоны: прогресс/пинги фронта и платформы живут ТОЛЬКО там (D39.100); их строки единый бэклог не принимает (D39.84).
• Полигон — eval-зона платных/бесплатных экспериментов (eval/; отчёты — docs/experiments/, статус эксп-а — его баннер/D-лог).

Решения и документы

• D-номер (D39.x) — ратифицированная запись в architecture/05-decisions-log.md; голова — последний номер; эра — куст решений одного курса; лендинг — коммит работ сессии оркестратором после приёмки.
• Р-номер — ДВА смысла по контексту: Р1–Р10 = десять ранних принципов (01-decisions.md, историчны); Р1–Р7 в записях эры D39.5x–6x = вопросы/решения владельца по банку и промптам (D39.63 и соседние) — «Р2 = ЗНАЧЕНИЕ» из CURRENT-STATE не про принцип Р2. H1–H18 / L1–L8 — находки стратегического аудита (09-target-architecture.md §3); H — HIGH, в т.ч. незакрытые владельческие требования.
• Q1–Qn — нумерованные вопросы КОНКРЕТНОГО пакета/отчёта — контекст локален, Q2 пака-19 ≠ Q2 чекер-пака.
• V0–V5 — секции идей владельца в START_PROMT.MD (живой бриф; разобраны в product-requirements.md).
• Ш-1/Ш-2 — стоячие трипваеры голден-дрейфа стандартной библиотеки; Ш-2 = пересмотр unicode.Version-зависимых мест (memnorm/classifier/style + chunker/estimator) до перехода на go1.27 (детали — grep «Ш-2» по D-логу).
• PD-классика — public-domain тексты из претрейна моделей; эмпирика на них предварительна до вебновелл-среза (CLAUDE.md §Дисциплина).
• Харнесс — обвязка исполнения (наш пайплайн-транспорт или конкурентные agent-обвязки; калибровка — research/21–22).
• ⚠-баннер — шапка «тело superseded, чему верить»; ревью-шапка — вердикты приёмки поверх отчёта в archive/reports/.
• Пак — пакет работ одной сессии; свип — полная перепроверка обязательств (D39.66: 951 позиция); добор идеала — очередь качества после ре-пробы flash; МАСШТАБ — прогон целой книги.
• Строка N — стабильный ID строки единого бэклога (PROGRESS §Бэклог; не перенумеровывается); вес — блокер-очереди / скоро / когда-нибудь; носитель — артефакт, в котором обязательство живёт; хвост — незакрытый остаток; петля — вопрос, обязанный получить диспозицию; слот — зарезервированное место в будущем пакете/замере.
• Гвоздь — регрессионный тест, прибивающий контракт (негативный гвоздь — тест на ОТСУТСТВИЕ поведения).
• Реестр 108 / «жилец реестра» — строка 108 единого бэклога: реестр ЗАГЕЙЧЕННЫХ ТРИГГЕРОВ (отложенных реопенов с условием «когда вернуться»); «жилец» = такой реопен. «Каждое отложено получает строку бэклога или жильца реестра 108» — норма D39.66/D39.90.
• Контракт 14 (API v0) — ратифицированный контракт фронт↔платформа: architecture/14-api-contract/ — нормативная спека OpenAPI 3.1 + компаньон-README; зонная копия frontend/docs/api-contract/ — байт-зеркало (D39.99). Провенанс ✓/◆/○ — классы утверждений компаньона: выведено из кода/ратификации · предложено (подтверждает названная зона) · открыто (К-вопросы). spectral / openapi-typescript — линт спеки и генерация типов фронта с дрифт-тестом (⚠ 3.1-условия генератор игнорирует — К-11).
• ПТ-N — стабильный ID требования в product-requirements.md; не путать со строками единого бэклога. paused / лимиты «как Claude Code» — статус книги при стопе по потолку + страница статуса использования в настройках, сумм на экране нет (ПТ-35, D39.100).

Пайплайн и код

• Волны — waveDraft (черновик) → терминолог → waveEdit (редактура); имена только полные, аббревиатуры W0/W1 запрещены (решение владельца 19.07).
• Чанк — единица нарезки книги; edit-unit (юнит редактуры) — member-чанки, схлопнутые редактором в один финальный текст: гранулярность финала и экспорта пар (~1.9 юнита/главу; якорь синхронизации фронта — D39.84; draft-only-пайплайн шипит по чанкам).
• Банк (памяти) — термины/имена/голоса книги на весь прогон; сид — стартовый банк книги (YAML; подпись владельца — только вкусовые поля, D39.77); бриф — книжные вводные; банкнота — канал выноса кандидатов из ответа переводчика; майнер — $0-извлечение кандидатов из исходника; KWIC — конкорданс-контекст кандидата; терминолог — роль перевода/подписи терминов батчами.
• Доктрина инжекта (закон) — банк на проводе обязателен для всех ролей НЕЗАВИСИМО от статуса строки; право «перевести иначе, если сомнительно» упразднено, свобода — только оговоркой ОБЛАСТИ употребления (не-терминные пассажи: игра слов, разбор знаков); на проводе — единый закон-блок редактора, маркер ⟨проверить⟩ снят; статусы строк и подписная таблица не меняются (D39.104; внесение в движок — строка 134 после пробы 18).
• Гейты — детерминированные $0-проверки перевода; чекеры K1–K12 — классы дефектов рубрики; DC1–DC7 — data-driven чекеры на данных пары; репэйр — платная петля ремонта (построена, выключена — строка 13).
• Судья — Ф2-оценка качества (gemini); канал B — путь чувствительного контента (Mistral+grok); лейблы (labels) — размеченный корпус для precision/recall чекеров, метрики заморожены числами в приёмках.
• Голден — байт-фиксированный снапшот прогона; маскированный дифф — сверка голдена с маской hex/версий; CheapGateVersion (CGVER) — версия контракта гейтов; парити — TM_MINER_PARITY=1 EXACT-сверка майнера.
• Эхо-мина — DeepSeek без thinking эхоит вход вместо перевода; гейт echoMineViolation принуждает thinking-ON.
• Langpack / пар-файл — данные языковой пары (backend/configs/langpacks/); книжное в пар-слое = утечка; общность — ревью-вопрос «заработает ли пара/вторая книга без правки Go».
• Ведро B/D — корзины триажа карты общности D39.60 (B «пар-модуль без гейта» · D «удалить»).
• tmctl — CLI бэкенда (translate / report / status / export / redrive / seed-lint / backup).
• COGS — себестоимость перевода; ре-проба — дешёвый повторный замер провайдера после аномалии (строка 74).

Неймспейсы номеров (полная легенда — испр. D39.125 по докс-аудиту)

• PD-N — регистр дефектов ПЛАТФОРМЫ (platform/docs/DEFECT_REGISTER.md; счёт — counts.py); П-N — зонный бэклог платформы (platform/BACKLOG.md); Ф-N — зонный бэклог фронта (frontend/docs/BACKLOG.md); В-N — вопрос ВЛАДЕЛЬЦУ от фронта (журнал frontend-PROGRESS.md); К-N — вопрос контракта API (14-api-contract/README.md). «Строка N» без префикса = ЕДИНЫЙ бэклог docs/PROGRESS.md (НЕ номер строки файла).
• Глава — единица структуры книги: детект chunk/ingest.go (txt: CJK-шапки/form-feed; epub: документ spine), нумерация плотная позиционная + титульная политика chunk/chunker.go (stripHeading/ApplyHeading по langpacks/*/heading.txt), идентичность = контент-хеш в манифесте (pipeline/manifest.go), деньги ключуются ПОЗИЦИЕЙ (сдвиг границы = перекупка хвоста). Дизайн будущего — research/27.
• Деньги платформы: холд — резервация суммы прироста на счёте ДО спавна; прирост — купленные главы × ставка ($0.03, pricing.go); аргумент потолка — что уходит движку в --ceiling-usd = committed книги + прирост (PD-158; ЭТО НЕ ХОЛД — он больше холда на committed); baseline — счётчик книги на старте попытки, списание = разница; settle/расчёт — закрытие холда по фигуре движка; leftover-reserved — висячий reserved движка после краша (зануляется его write-open); SpendBound — верхняя граница отложенного расчёта по baseline следующей попытки (PD-159).
• Лексикон экспериментов: жилец — модель на роли; арм — вариант в бейк-оффе; однопроходка/второй проход — топологии редактуры; закон-блок = доктрина инжекта (D39.104); пол/floor — нижний якорь шкалы судьи; Холм — поправка Холма на множественные сравнения; порог различимости — минимальная дельта, отличимая от шума риге.