Files
pegas-memory/DOCSTRAT.md
T
Pegas 51b79d4045 docs: fix ingestion-rule typos in DOCSTRAT.md
- repair 'истина'->'источник', remove injected CJK chars on 'расруит ошибку'
- fix 'основа' spelling after 'Английская'
- no Latin/Cyrillic mixups, no CJK leakage
2026-10-15 23:26:47 +05:00

3.0 KiB

Стратегия документов (English source of truth)

Правило (обязательное)

  • Английский — канонический источник (source of truth). Все правки вносятся только в исходный *.md (EN).
  • Русский — только для бегного понимания. Это вычислительный инструмент; термиология может «поплыть».
  • Ник не использовать .ru.md за основу для правок. Правим EN → перезапускаем en2ru.py. Нарушение → накаплием ошибочный русский текст и не можем сделать то, что задумано (опора на «поплывшую» термиологию ломает смысл).

Причина

translategemma:latest чисто пишет орфографию, но джаргон переводит криво — вплоть до переворота значения: dedup → «дублирование» (обратное значение), receipt → «результат». Порусскому — вторичен и нуждается в ревью джаргона.

Ингест в базу (запрет русского с опечаткой)

  • Ingest только из английских источников. memory_ingest / memory_store принимают EN-текст → дестилируются в атомы.
  • Русский в атомы — только после орфографической чистки. Если русский источник неизбежен → сначала прогоним через en2ru.py / проверку орфографии → только чистый текст может стать атомом.
  • .ru.md — никогда не ingest'ится в атомы. Это внешний слой понимания, вне базы.
  • Фиаско, если русское с опечаткой попадёт в атомы: такой атом станет «источник» для ответов и расруит ошибку по кругу. Английская основа этого не позволяет.

Как

python3 en2ru.py ROADMAP.md        # -> ROADMAP.ru.md
cat doc.md | python3 en2ru.py -    # stdin -> doc.ru.md
  • Вывод: <file>.ru.md.
  • Джаргон-ревью (термы, где модель ошибается) — в stderr, не в RU-выводе.
  • Оффлайн: зависимостей нет (urllib), модель уже в Ollama (translategemma:latest).

Порядок работ

  1. Пишем/правим EN источник.
  2. en2ru.py → генерим RU.
  3. Смотри stderr — правь flagged-термы (ревью, не авто).
  4. Храни оба файла рядом: X.md (EN, канон) + X.ru.md (RU, понимание).