# totally-spies-cultshot

Internal working repo for the `Totally Spies x Cultshot` marketing video
pipeline project.

## Repo structure

- `docs/proposal/laurent-proposal-draft.md`
  - Current action-oriented producer draft.
- `docs/strategy/monthly-content-system.md`
  - Monthly output model, validation package, shot families, and execution
    model.
- `docs/research/official-marketing-reference-study.md`
  - Verified official marketing assets and the campaign grammar they establish.
- `docs/internal/benchmark-review.md`
  - Internal-only review of Laurent's sample videos and the implications for
    the value proposition.
- `docs/internal/source-materials.md`
  - Source-of-truth note for copied media, checkpoints, and reference docs.
- `docs/internal/training-asset-manifest.csv`
  - Working manifest for owned training inputs, provenance, and weight-pack readiness.
- `docs/internal/asset-request-pack.md`
  - Internal checklist for the first Laurent/Paul owned-material delivery.
- `docs/internal/source-episode-inventory.csv`
  - Generated inventory of owned episodes copied into `materials/source-episodes/ingested/`.
- `docs/internal/reference-extraction-requests.csv`
  - Queue of timestamped frame-extraction requests for character, location, prop, and wardrobe references.
- `docs/strategy/validation-shot-plan.md`
  - Deterministic validation package plan for the first five shot families.
- `docs/internal/validation-metrics-tracker.csv`
  - Baseline vs owned-asset-tuned evaluation tracker for the validation package.
- `docs/internal/material-inventory.md`
  - Generated inventory of copied repo materials.
- `docs/internal/benchmark-metadata.md`
  - Generated ffprobe summary for the raw benchmark source videos.
- `docs/internal/checkpoints/`
  - Copied session checkpoints relevant to the project history.
- `materials/source-context/`
  - WhatsApp summaries and the context image.
- `materials/source-media/`
  - Raw benchmark videos copied into the repo.
- `materials/source-episodes/`
  - Owned episode intake scaffold, with `ingested/` for master deliveries and `proxies/` for lightweight review exports.
- `materials/assets/`
  - Character, wardrobe, gadget, and location folders ready for cleaned reference extraction.
- `materials/brand/`
  - Brand and title-treatment landing area for rights-holder campaign standards.
- `materials/benchmark/`
  - Extracted review stills, sheets, dense frames, and frame folders.
- `materials/reference/cultshot-radial/docs/`
  - Copied `cultshot-radial` docs used as reference material.
- `tools/`
  - Repo-local helper scripts for syncing materials and generating inventory.

## Git LFS

This repo uses Git LFS for the binary material we are likely to keep editing or
reviewing:

- `materials/source-media/**`
- `materials/source-episodes/**`
- `materials/benchmark/**`
- `materials/assets/**/*.{png,jpg,jpeg,webp}`
- `materials/source-context/*.jpg`
- `materials/brand/**/*.{pdf,png,jpg}`
- `materials/reference/cultshot-radial/docs/screenshots/*.{png,jpg,pdf}`

Install the local hooks once per clone:

```bash
git lfs install --local
```

## Local devenv

This repo ships with a native `devenv` setup.

```bash
direnv allow
devenv shell
spies-lfs-install
spies-sync-materials
spies-material-inventory
spies-benchmark-metadata
spies-episode-ingest
spies-reference-extract
spies-smoke
```

Task aliases are also available:

```bash
devenv tasks run materials:sync
devenv tasks run materials:inventory
devenv tasks run benchmark:metadata
devenv tasks run episodes:ingest
devenv tasks run references:extract
devenv tasks run repo:smoke
```

## Notes

- External benchmark critique stays internal.
- Official references are limited to primary sources or clearly attributed
  Banijay / official channel materials.
- Set `TOTALLY_SPIES_EPISODE_SOURCE_ROOT` before running `spies-episode-ingest`.
- The current Gmail draft ID when this repo was created was
  `r-2510603559359686682`.