Source Manifest

Goal: collect the source candidates for source-tutorial into one explicit manifest before ingest starts.

Inputs

• GOAL.md
• DECISIONS.md

Outputs

• sources/manifest.yml

Workflow

1. Read GOAL.md and any existing DECISIONS.md notes to understand what kinds of sources the tutorial is expected to use.
2. If sources/manifest.yml does not exist, scaffold it with a minimal example.
3. Validate that each source has:
   • source_id
   • kind
   • locator
   • label
   • for kind: video, prefer transcript_locator unless the platform exposes public subtitles
4. Reject placeholder/example-only manifests.
5. Return success only when at least one real source exists.

Accepted kind

• webpage
• pdf
• markdown
• repo
• docs_site
• video

For video:

• preferred: add transcript_locator
• Bilibili may succeed from public subtitles when available
• YouTube should currently be paired with transcript_locator

Script

Quick Start

• python .codex/skills/source-manifest/scripts/run.py --workspace <ws>

All Options

• --workspace <dir> (required)
• --unit-id <U###>
• --inputs <semicolon-separated>
• --outputs <semicolon-separated>
• --checkpoint <C#>

Examples

• Scaffold or validate the manifest:
  • python .codex/skills/source-manifest/scripts/run.py --workspace <ws>

Troubleshooting

Issue: the unit keeps blocking after scaffold

Cause:

• The manifest still contains example placeholders.

Fix:

• Replace the scaffold entry with real URLs or local file paths, then rerun the unit.