heaven/textmachine
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
textmachine/docs
History
heaven 3d5d5d54f3 Land accepted editor-role experiment 20 with review header downgrading unpersisted judge claims, plus its harness and judge scripts
2026-08-06 16:10:26 +03:00
..
architecture Close orchestrator fourteen: D39.107 handoff, platform rework acceptance explicitly assigned to fifteen, GPT refinements folded into research 25, map and counter bumped 2026-08-06 04:04:20 +03:00
archive Close orchestrator thirteen: full doc sweep D39.105, handoff to fourteen, queue recounted, injection doctrine pointers propagated, chronicle of sessions nine and ten sliced to archive 2026-08-04 22:27:07 +03:00
experiments Land accepted editor-role experiment 20 with review header downgrading unpersisted judge claims, plus its harness and judge scripts 2026-08-06 16:10:26 +03:00
research Close orchestrator fourteen: D39.107 handoff, platform rework acceptance explicitly assigned to fifteen, GPT refinements folded into research 25, map and counter bumped 2026-08-06 04:04:20 +03:00
BACKEND_BANK_CLUSTER_FIXPACK_SESSION_PROMPT.md Issue audited bank fixpack and editor probe prompts, ratify wire-law doctrine D39.104, close remaining owner questions, backlog row 134, saga trimmed per owner norm 2026-08-04 22:02:29 +03:00
glossary.md Close orchestrator thirteen: full doc sweep D39.105, handoff to fourteen, queue recounted, injection doctrine pointers propagated, chronicle of sessions nine and ten sliced to archive 2026-08-04 22:27:07 +03:00
ORCHESTRATOR_SESSION_PROMPT.md Close orchestrator fourteen: D39.107 handoff, platform rework acceptance explicitly assigned to fifteen, GPT refinements folded into research 25, map and counter bumped 2026-08-06 04:04:20 +03:00
POLYGON_EDITOR_WIRE_PROBE_SESSION_PROMPT.md Issue audited bank fixpack and editor probe prompts, ratify wire-law doctrine D39.104, close remaining owner questions, backlog row 134, saga trimmed per owner norm 2026-08-04 22:02:29 +03:00
POLYGON_PACKAGE4_SESSION_PROMPT.md Sweep all documentation against era D39.96-101: closed-row pointers refreshed, lost chronicle headers restored, glossary extended, stale statuses annotated with closure markers 2026-08-04 16:06:24 +03:00
product-requirements.md Sweep all documentation against era D39.96-101: closed-row pointers refreshed, lost chronicle headers restored, glossary extended, stale statuses annotated with closure markers 2026-08-04 16:06:24 +03:00
PROGRESS.md Close orchestrator thirteen: full doc sweep D39.105, handoff to fourteen, queue recounted, injection doctrine pointers propagated, chronicle of sessions nine and ten sliced to archive 2026-08-04 22:27:07 +03:00
README.md Close orchestrator fourteen: D39.107 handoff, platform rework acceptance explicitly assigned to fifteen, GPT refinements folded into research 25, map and counter bumped 2026-08-06 04:04:20 +03:00

README.md

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

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

Состояние проекта НЕ здесь. Очередь, курс, бэклог — 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 — источник истины по решениям. Читать: карта актуальности (шапка) + живая голова (с хвоста); корпус D1–D38 — справочник по ссылкам/grep, целиком не читать.
    • 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/ — байт-зеркало, сверять при лендинге).
    • Исторические, читать через ⚠-баннеры: 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–16 — отчёты закрытых экспериментов (судьба — в баннерах/D-логе).
  • research/ — фактура ресёрчей 01–25; у принятых — ревью-шапки, часть тел под ⚠ superseded: читай баннер прежде содержимого. Ключевые для навигации: 15 голос · 16 ридер-IDE · 17 внешняя критика · 18 рычаги качества · 19 нарезка · 20 банк-майнинг · 21 обзор транспорта · 22 доменные харнессы · 23 шов движок↔платформа (транспорт superseded D39.106) · 25 холодное ревью шва — форма D39.106, отвергнутые альтернативы, требования к эмиттеру (читать перед любым кодом стыка) · 24 арбитраж банка (ПРИНЯТ D39.102: консилиум закрыт классом, вход фикс-пака банка — §G).
  • PROGRESS.md — журнал: CURRENT-STATE + ЕДИНЫЙ БЭКЛОГ (единственный трекер) + живой хвост хроники. НЕ источник решений.
  • Активные хендофф-промты сессий (состав обновляется при каждом лендинге — норма D39.80): ORCHESTRATOR_SESSION_PROMPT.md (роль/нормы; состояния не дублирует) · POLYGON_PACKAGE4_SESSION_PROMPT.md (полигон, отложен) · платформа: ../platform/docs/PLATFORM_SESSION_PROMPT.md (P0 ИСПОЛНЕН 04.08 — ждёт приёмки №14 (в №13 не исполнена, D39.105); дерево platform/* не залендено, не трогать) · фронт: frontend/docs/S3_SESSION_PROMPT.md (замок ОТКРЫТ — контракт ратифицирован D39.99; первый шаг — правки спеки по D39.100). Зонные журналы фронта/платформы — frontend-PROGRESS.md / platform-PROGRESS.md в их зонах (решение владельца 04.08: прогресс зон только там). Бэкенд: BACKEND_BANK_CLUSTER_FIXPACK_SESSION_PROMPT.md (фикс-пак банка, строка 128+129; санкция D39.103) · Полигон: POLYGON_EDITOR_WIRE_PROBE_SESSION_PROMPT.md (редактор под доктриной закона D39.104 ≤$0.30 + фронтир-пасс ≤$0.50, «go» дан). Очередь и состояние — только CURRENT-STATE.
  • Зоны фронта (чужие, читать при касании стыка; каждая ведёт СВОЙ зонный бэклог — единый бэклог их строк не принимает, D39.84): ../frontend/ — веб-интерфейс: промт фронт-сессий S0–S7 + STACK_DECISIONS.md (пины версий точными числами и ловушки, сверены с вебом 02.08) + BACKLOG.md · ../platform/ — SaaS control plane: README + BACKLOG.md (П-1..П-5) + docs/ (промт P0 · зонный журнал platform-PROGRESS.md).
  • 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