heaven/textmachine
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
620 commits 2 branches 0 tags 85 MiB
Find a file
heaven c6c3ada39d Ping the frozen frontend zone: contract review dispositions for its four questions, mock findings and unfreeze inputs recorded in the zone journal
2026-08-16 02:41:06 +03:00
backend Land the accepted DeepSeek repin: peak prices pinned so the ceilings protect again, freshness date bumped with verbatim vendor citations 2026-08-15 23:21:14 +03:00
docs Ratify D39.138: accept the contract review report, order the 0.3.0 batch, close row 179 and PD-104, open rows 183-187, archive the review prompt 2026-08-16 02:40:59 +03:00
eval Freeze the buying code for the Japanese leg noise floor: a second editor generation instead of the near-deterministic fixer floor 2026-08-15 20:30:05 +03:00
frontend Ping the frozen frontend zone: contract review dispositions for its four questions, mock findings and unfreeze inputs recorded in the zone journal 2026-08-16 02:41:06 +03:00
platform Ping the platform zone: contract review accepted, PD-104 closed by owner word, the platform half of batch 0.3.0 and passing findings listed 2026-08-16 02:41:06 +03:00
.gitignore Ignore the Codex local settings file 2026-08-15 18:30:49 +03:00
CLAUDE.md Land docs pack 167 as D39.126: full note registry with counts completeness check and anchors lint, slimmed backlog rows, topical entries for money, emitter, and stack 2026-08-09 21:33:37 +03:00
START_PROMT.MD Commit owner's living brief update: V5 section written into file, SEO item already absorbed as PT-23 2026-08-02 21:05:23 +03:00

docs/README.md

TextMachine — документация

Проект: издательский художественный перевод крупных текстов (книги, ранобэ, вебновеллы; zh/ja/en→ru) мультиагентным пайплайном поверх LLM API. Go-бэкенд + веб-фронт ридер-IDE (Ф3) + платформа (SaaS control plane, platform/, D39.81). Цели и мерило — канон в ../CLAUDE.md; онбординг сессий — там же. Стартовый бриф владельца: ../START_PROMT.MD — живой документ, его V-идеи разобраны в реестр требований (ниже).

Состояние проекта НЕ здесь — кроме одной строки ниже, и это осознанное исключение: строка «активные промты» отвечает на вопрос «какой файл мой», без которого холодная сессия выбирает роль сама (нашёл слепой онбординг-замер 08.08). Всё остальное состояние — Очередь, курс, бэклог — CURRENT-STATE в шапке PROGRESS.md; решения — architecture/05-decisions-log.md (при конфликте с любым доком побеждает он). Эта страница — только карта «что где лежит».

Карта

  • glossary.md — жаргон и сокращения (D-номер, паки, банк, голден, K/DC/H/L…) одним экраном.
  • product-requirements.md — реестр «что продукт обязан уметь»: START_PROMT V0–V5 + находки H6–H18, статусы сверены кодом.
  • architecture/ — синтез и контракты:
    • 05-decisions-log.md — источник истины по решениям. Живой файл после диеты D39.125: карта + эрраты + живые тела + голова D39.106+; тела закрытых эр — слайсы archive/architecture/05-decisions-*.md. Грепай номер сначала в живом, затем в слайсах (тело ноты = строка ^## D<номер>, прочие хиты — упоминания); целиком не читать. Статус/суть/тело ЛЮБОГО номера одним хопом — реестр 05-decisions-index.md (все ноты, колонка тем для грепа «какой закон по X»; D39.126).
    • 09-target-architecture.md — целевая 7-слойная архитектура (статус стройки — шапка-таблица; §3 — карта находок H/L) · 10-prompt-architecture.md — промпт-слой · 12-go-style-notes.md — норматив общности §0 · 13-tech-debt-anchors.md — якоря техдолга + археология выселенных строк бэклога §Б-* (справочник к бэклогу, НЕ трекер) · 14-api-contract/ — контракт API v0 фронт↔платформа (D39.99): нормативная спека OpenAPI 3.1 (типы фронта генерятся из неё) + компаньон-README (провенанс ✓/◆/○, К-вопросы; зонная копия frontend/docs/api-contract/ — байт-зеркало, сверять при лендинге).
    • Топикальные входы (D39.126; НЕ источники истины, при конфликте побеждает D-лог): 15-money-path.md — деньги от гранта до settle одним маршрутом · 16-events-emitter.md — сборка-норматив эмиттера шва (обязательное пре-чтение сессии строки 103) · STACK.md — карта «роль → модель → конфиг → квирки».
    • Исторические, читать через ⚠-баннеры: 01-decisions.md (Р1–Р10) · 02-mvp-plan.md · 03-implementation-notes.md · 04-unhappy-paths.md · 06-memory-risk-registry.md.
  • experiments/ — эмпирика полигона: 00-provider-quirks.md — читать перед любым вызовом провайдера; 08-cost-model-v2.md — денежная модель; 09-pilot-protocol.md — пилот Ф2.5; остальные 01–21 — отчёты ЗАКРЫТЫХ экспериментов (21 принят D39.117); ⚠ 22/23 — залендены с ревью-шапками приёмки №16 (10.08), НЕ ратифицированы: выводы заморожены до фазы Д (шапка первична; 18–20 — с ревью-шапками приёмки D39.108).
  • research/ — фактура ресёрчей 01–28; у принятых — ревью-шапки, часть тел под ⚠ superseded: читай баннер прежде содержимого. Ключевые для навигации: 15 голос · 16 ридер-IDE · 17 внешняя критика · 18 рычаги качества · 19 нарезка · 20 банк-майнинг · 21 обзор транспорта · 22 доменные харнессы · 23 шов движок↔платформа (транспорт superseded D39.106) · 25 холодное ревью шва — форма D39.106, отвергнутые альтернативы, требования к эмиттеру (читать перед любым кодом стыка) · 24 арбитраж банка (ПРИНЯТ D39.102: консилиум закрыт классом, вход фикс-пака банка — §G) · 26 официальные практики Anthropic (D39.121: записка-план, сниппеты хендоффов, карта «уже делаем/перенять») · 28 контракт-ревью API v0 (ПРИНЯТ D39.138: решения владельца 16.08 — §8, состав батча 0.3.0 — §5; НОСИТЕЛЬ для исполняющих сессий, читать оригинал, не пересказ).
  • PROGRESS.md — журнал: CURRENT-STATE + ЕДИНЫЙ БЭКЛОГ (единственный трекер) + живой хвост хроники. НЕ источник решений.
  • scripts/counts.py — производные числа доков считаются им, а не руками (голова по трём носителям · счёт очереди и зон · вес открытых строк регистра платформы · полнота реестра нот); --check даёт ненулевой код на расхождении; --lint — линтер file:line-якорей живых доков (D39.126). Его же зовёт зонный хук scripts/githooks/pre-commit при коммите, задевающем D-лог или PROGRESS — предупреждает, не блокирует. Заведено по D39.112 п.5б: голова отставала трижды у трёх разных оркестраторов.
  • Активные хендофф-промты сессий (состав обновляется при каждом лендинге — норма D39.80): ORCHESTRATOR_SESSION_PROMPT.md (роль/нормы; состояния не дублирует) · Контракт-ревью ОТРАБОТАЛО и ПРИНЯТО (D39.138; отчёт research/28-contract-review.md — носитель решений владельца §8 и состава батча 0.3.0 §5; промт в archive/prompts/; следующий промт — спек-сессия батча 0.3.0, очередь №17) · Полигон: POLYGON_EXP2223_REDO_SESSION_PROMPT.md — фаза Д доводки эксп-22/23 ИДЁТ (заказ владельца 10.08, потолок фазы $4.50; выводы 22/23 заморожены до неё) · POLYGON_PACKAGE4_SESSION_PROMPT.md (отложен) . Фронт: ЗОНА ЗАМОРОЖЕНА (D39.136 п.2) — S4 ИСПОЛНЕН и ПРИНЯТ (D39.135, лендинг 267aa35; контракт 0.2.3 в каноне; промт в frontend/docs/archive/); разморозка = лендинг P7 + гейт-ответы S5 (В-10 · фразы В-11); живой smoke против дев-стенда легитимен и во фризе; фикс-лист ФС — запись приёмки 15.08 в зонном журнале · Платформа: активного промта НЕТ — P6 + дофикс ИСПОЛНЕНЫ и ПРИНЯТЫ (D39.132, промты в platform/docs/archive/); следующий пак — P7 (читающая поверхность + форвард-половина 0.2.3: чтение title и проекция reject_reason, D39.135 п.2в + хвосты D39.134 п.4), промт — очередь №17 · Бэкенд: активного промта НЕТ — пере-пин цен DeepSeek ИСПОЛНЕН и ПРИНЯТ (D39.137, лендинг 76049bb; промт в archive/prompts/), потолки снова защищают; tmctl migrate — D39.134 (d55edd4), деплой эмиттер-бинаря разблокирован. Эмиттер шва ИСПОЛНЕН и ПРИНЯТ (D39.131, промт в архиве). Все ОТРАБОТАННЫЕ промты — в archive/prompts/, отчёты с ревью-шапками — в archive/reports/; статусы паков — CURRENT-STATE и D-лог, здесь не дублируются. Зонные журналы фронта/платформы — frontend-PROGRESS.md / platform-PROGRESS.md в их зонах (прогресс зон только там, D39.100).
  • Зоны фронта (чужие, читать при касании стыка; каждая ведёт СВОЙ зонный бэклог — единый бэклог их строк не принимает, D39.84): ../frontend/ — веб-интерфейс: промт фронт-сессий S0–S7 + STACK_DECISIONS.md (пины версий точными числами и ловушки, сверены с вебом 02.08) + BACKLOG.md · ../platform/ — SaaS control plane: README + BACKLOG.md (П-1..П-14) + docs/ (зонный журнал platform-PROGRESS.md · регистр дефектов · архив промтов P0–P5).
  • archive/ — история (правила архива): закрытые промты (prompts/) · отчёты с ревью-шапками (reports/ — на них ссылаются приёмки) · исполненные арх-доки (architecture/) · слайсы хроники PROGRESS-*.md. Инструкции оттуда не исполнять.
  • Диаграммы: ../backend/docs/components.puml · ../backend/docs/pipeline.puml — дом рядом с кодом (D39.80), правятся бэкендом одним коммитом с кодом; вручную НЕ рендерить (владелец смотрит PlantUML-расширением VS Code).

Доступные ключи от моделей

DEEPSEEK_API_KEY, ZAI_API_KEY, KIMI_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, XAI_API_KEY, MISTRAL_API_KEY