Документ Legend V2
src/modules/legend-v2/types.ts — агрегат LegendV2Document.
Документ зберігає анкету, стан кожного етапу, рішення оператора, звіти перевірок, журнал LLM-запусків і фінальний результат. schemaVersion дозволяє нормалізувати раніше створені документи після зміни внутрішньої структури.
Поля
- id — ідентифікатор легенди.
- schemaVersion — версія внутрішньої структури документа.
- version — версія для захисту від паралельного перезапису.
- status, currentStage — загальний стан і поточний етап.
- sourceProfile — вихідна анкета оператора.
- canon, blueprint, anchorPlan, factCoveragePlan — зафіксовані правила персонажа та плани генерації.
- anchors, facts, blocks — результати основних етапів і рішення оператора.
- claimLedger — маршрутизація затверджених фактів між Життєвими Блоками.
- finalDossierDraft, finalDossier, finalProfile — чернетка досьє, редакційний результат і фінальна легенда.
- qualityReports — результати перевірок етапів.
- runs — короткий журнал запусків етапів: час, провайдер, успіх або помилка.
- pipelineRuns — детальний журнал тестових запусків з Legend Lab. Зберігає вибрані й фактичні моделі, спроби, токени, час, вартість, помилки та оцінку оператора.
- createdAt, updatedAt — час створення й останньої зміни.
Життєвий цикл
- Новий документ починається як чернетка на етапі Канону.
- Кожен етап має власний статус, звіт перевірки та залежні дані.
- Рішення оператора зберігаються в тому самому агрегаті.
- Після успішного фінального QC документ переходить у статус
ready. - Зміна джерела не видаляє весь документ: залежні результати позначаються застарілими або очищаються відповідно до їхнього рівня.
- Звичайні production-запити не заповнюють детальний тестовий журнал.
Перевірка Якоря
Для кожного кандидата зберігається результат змістової перевірки. Вона окремо визначає, чи є подія справжнім Якорем, чи достатньо вона конкретна й важлива, чи змінює подальшу поведінку, чи відповідає Канону та чи не повторює інший сюжет. Без успішної перевірки кандидат не отримує автоматичної рекомендації, але оператор може розглянути його вручну.
Зберігання
LegendV2Repository відокремлює доменну логіку від конкретної бази даних. Репозиторій перевіряє версію документа під час save, щоб не перезаписати паралельні зміни.
Доступні дві локальні реалізації:
- in-memory — дані існують до перезапуску процесу;
- local-file — JSON-файл з атомарним записом через тимчасовий файл.
MongoDB-реалізація репозиторію ще не підключена.