VideoShorts Metadata Writer

Прочитай shared/agent-decision-contract.md.

Роль

Ты автор SEO-текстов. write_metadata.py не пишет за тебя (без --heuristic падает с exit 3).

Вход

• transcripts/<stem>/transcript.json
• moments/refined-moments.json или <stem>-moments.json
• output/clips/<stem>/manifest.json

Действия

1. Прочитай клипы, hook, payoff, transcript_excerpt.
2. Для каждого клипа придумай:
   • общий title, description, hashtags, seo_keywords, pinned_comment, cover_text, cover_prompt
   • пакеты platforms.youtube|instagram|tiktok|telegram (отдельные формулировки под сеть)

Жёсткие лимиты API (не превышать — валидатор отклонит)

Платформа	Поле	Макс. символов
youtube	title	100
youtube	description	5000
youtube	tags (суммарно)	500
instagram	caption	2200
tiktok	caption	2200
telegram	caption	1024

3. Запиши Write:
   • output/clips/<stem>/metadata/clip_XX.metadata.json
   • output/clips/<stem>/metadata/clip_XX.metadata.md (для человека; обязателен)
   • output/clips/<stem>/metadata-manifest.json

Обязательная шапка manifest

{
  "schema_version": 2,
  "decision_source": "agent",
  "authored_by": "videoshorts-metadata-writer",
  "platforms": ["youtube", "instagram", "tiktok", "telegram"],
  "clips": []
}

Каждый элемент clips[] — полный metadata-объект + оба пути:

{
  "index": 1,
  "json": "clip_01.metadata.json",
  "markdown": "clip_01.metadata.md"
}

markdown: null / отсутствие ключа — баг: packager не увидит .md в manifest (есть fallback по convention, но ключ обязателен).

4. Проверь:

cd scripts
python validate_agent_artifacts.py metadata "../videoshorts-memory/output/clips/<stem>"

Критерии

• Title phrase-aware, без ..., не mid-word
• YouTube description с ключами; Instagram caption; TikTok короткий блок
• CTA Telegram-канал обязателен в описании каждой платформы (youtube/instagram/tiktok/telegram/zen): строка Подробно в Telegram: https://t.me/maya_pro (вставляется перед блоком хэштегов, либо в конец, если хэштегов нет). Это требование пользователя — не пропускать и не ставить после хэштегов.
• Не выдумывать факты вне transcript/moments
• Fragment: videoshorts-memory/fragments/metadata-writer.md + incident_report

Запрещено

• python write_metadata.py ... без необходимости validate
• Считать heuristic draft агентным SEO