<!-- PUBLIC: evidence-first extraction contract; draft pending Gate 1 approval. -->
# Daisy Content Extraction Contract · v0.2

Дата: **22 августа 2026**. Статус: **DRAFT_OWNER_REVIEW**. Bulk parsing: **LOCKED_SCHEMA_APPROVAL**.

Интерактивная версия: [Extraction Contract v0.2](../extraction-contract/).

## Зачем нужен этот слой

Frozen corpus v1 содержит 38 318 release-pinned items и неизменяемую первичку. Его 12 deterministic claims на item — навигационный слой, а не достаточный содержательный анализ. Contract v0.2 задаёт, что именно считать, в какой гранулярности и с каким evidence, прежде чем размечать весь корпус.

## Универсальный контракт значения

Каждое значение хранит:

```text
contract_id / field_id / field_path
calibration_set_id / content_item_id / content_snapshot_id
value_json / knowledge_status
evidence_type / evidence_locator / evidence_start / evidence_end
extractor / parser / model / prompt versions
confidence / annotator / review decision / timestamps
```

`knowledge_status`: `OBSERVED | DERIVED | MODEL | HUMAN_ANNOTATION | MISSING | NOT_APPLICABLE | BLOCKED`.

`evidence_type`: `METADATA_FIELD | TEXT_SPAN | TRANSCRIPT_SPAN | FRAME | IMAGE_REGION | AUDIO_SPAN | LINK | COMMENT_SNAPSHOT | METRIC_SNAPSHOT | RELATION | HUMAN_ANNOTATION`.

## 110 полей в 10 доменах

1. **Identity & provenance — 9:** item, source, snapshot, language, type, publish time, raw hash.
2. **Audience & situation — 9:** explicit/inferred audience, profession, role, level, team context, entry state, constraints, exclusions.
3. **Work & result — 14:** trigger, pain, workaround, action → task → job → epic, inputs, deliverables, DT01–DT16, K1–K10, acceptance, failure, handoff.
4. **Workflow, tools & effort — 16:** ordered steps, branches, human/AI boundary, automation, reproducibility, product/feature/stack/cost/access, five different time measures, prerequisites.
5. **Teaching, proof & risk — 13:** mode, objective, scaffold, example, transfer, exercise, assessment, pacing, proof, acceptance test, limitations, safety, uncertainty.
6. **Editorial & structure — 14:** hook, promise, tension, novelty, first 30/60 sec, segments, chapters, reveal order, pattern interrupts, summary, text blocks, caption style, extractive summary.
7. **Visual/audio/production — 13:** thumbnail OCR/face/brand/layout/palette/emotion, sampled frames, shot mix, on-screen text, voice, music, edit density, asset reuse.
8. **Distribution & economics — 9:** title/description patterns, all/primary CTA, monetization, offer, raw/normalized metrics, retention proxy.
9. **Seriality & relations — 5:** series, playlists, prev/next, cadence, translation/cross-post/excerpt/remake/update/sequel/response/template/duplicate.
10. **Daisy & quality — 8:** product relevance, profession × epic, transferability, content-system role, adaptation note, evidence density, calibrated confidence, reviewer disagreement.

Машиночитаемый полный словарь доступен через `GET /api/daisy-content/contract` и выгружается кнопкой `JSON` в workbench.

## Calibration set · 96

Выборка детерминирована и привязана к exact snapshots frozen release:

- 48 YouTube: целевой mix 32 EN / 16 RU; 32 COMPLETE / 14 MISSING / 2 BLOCKED transcripts;
- 32 Telegram: 16 PRIMARY / 16 COMPARATOR;
- 16 web/course/newsletter/publication resources;
- внутри квот максимизируется разнообразие источников, archetypes, audience buckets, depth и content types;
- membership получает SHA-256 и не пересобирается после начала review.

## Gate 1

Bulk parsing 38 318 items разрешается только после выполнения всех условий:

1. утверждены все 110 field contracts;
2. зафиксированы все 96 calibration members;
3. размечены 96 items;
4. 24 items размечены независимо вторым annotator;
5. macro F1 критических полей ≥ 0.85;
6. валидность evidence pointers ≥ 0.98;
7. unresolved critical disagreements = 0.

## Двенадцать решений владельца

`D01` action/task/job/epic; `D02` DT01–DT16; `D03` пять времён; `D04` explicit/inferred audience; `D05` frame sampling; `D06` thumbnail features; `D07` platform applicability; `D08` relation types; `D09` metric denominators; `D10` minimum evidence; `D11` ASR provenance; `D12` Gate 1 unlock rule.

Полные формулировки, предлагаемые решения и последствия находятся в workbench и API.

## Что Contract v0.2 не делает

- не меняет frozen release membership;
- не перезаписывает raw snapshots, captions или legacy claims;
- не выдаёт частоты, рейтинги, паттерны, выводы и контент-стратегии;
- не запускает bulk parsing до измеримого Gate 1 PASS.

