verify-video-archive
Use when validating the macOS or Linux archive workflow reached by `just convert-video`, including real media, prerequisites, terminal progress, source safety, locking, and recovery.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- kind
- dev
- name
- verify-video-archive
- description
- Use when validating the macOS or Linux archive workflow reached by `just convert-video`, including real media, prerequisites, terminal progress, source safety, locking, and recovery.
02 资源文件 20
- 参考文档agents/openai.yaml271 B
- 参考文档features/backend-benchmark.md2.0 KB
- 参考文档features/changing-source.md865 B
- 参考文档features/cleanup-pending.md1.1 KB
- 参考文档features/collisions.md1.0 KB
- 参考文档features/conversion.md1.3 KB
- 参考文档features/dependencies.md1001 B
- 参考文档features/failure-continuation.md1.2 KB
- 参考文档features/interruption.md1.0 KB
- 参考文档features/lock-contention.md875 B
- 参考文档features/open-source.md824 B
- 参考文档features/ordering.md855 B
- 参考文档features/original-fallback.md1.1 KB
- 参考文档features/output-contracts.md1.2 KB
- 参考文档features/parallel-batch.md1.9 KB
- 参考文档features/README.md3.2 KB
- 参考文档features/recovery.md1.5 KB
- 参考文档references/evidence-schema.md4.3 KB
- 脚本scripts/tests/test_verify_video_archive.py13.8 KB
- 脚本scripts/verify_video_archive.py116.2 KB
03 SKILL.md 正文
Verify video archive
Drive the checkout implementation through just convert-video. The verifier
creates generated media and never reads the real archive or personal input
folders.
Load this skill from
authoring/verify-loops/verify-video-archive/SKILL.md in a skills repository
checkout. After skill installation, you can invoke
$verify-video-archive and resolve VERIFY_DIR from the loaded skill directory.
Launch
Create a new run. The command answers {"ok":true,"file":"<manifest>"},
where file is the retained manifest path.
VERIFY_DIR="<verify-video-archive-skill-dir>"
CHECKOUT="<dotfiles-checkout>"
uv run --no-project python "$VERIFY_DIR/scripts/verify_video_archive.py" \
launch --checkout "$CHECKOUT"
Copy the file value into MANIFEST. Launch creates a unique
disposable root and a separate evidence root. Each scenario gets its own home,
input roots, archive, state, journal, and scratch directories.
Doctor
Run Doctor before Drive.
uv run --no-project python "$VERIFY_DIR/scripts/verify_video_archive.py" \
doctor --manifest "$MANIFEST"
Doctor checks macOS or Linux, Python 3.11 or newer, Just, Git, FFmpeg, FFprobe,
libx265, a resolved lsof executable, and the checkout wrapper. An unmet
check blocks real-media acceptance on that platform.
Drive
Read the feature map, then run one feature or the full map.
uv run --no-project python "$VERIFY_DIR/scripts/verify_video_archive.py" \
drive --manifest "$MANIFEST" --feature conversion
uv run --no-project python "$VERIFY_DIR/scripts/verify_video_archive.py" \
drive --manifest "$MANIFEST" --feature all
Every archive invocation executes this argument array:
<resolved-just> --justfile <checkout>/justfile convert-video
The isolated ~/.local/bin/video-archive is a symbolic link to the checkout
wrapper. It adds no archive behavior. The Just recipe supplies the real
archive subcommand and uses the isolated default folders.
The recovery feature sets the verifier-only
VIDEO_ARCHIVE_VERIFY_PAUSE_AFTER_PREPARED_SECONDS environment variable. The
archive command pauses only after its durable prepared record. The verifier
stops and kills the process group created for that invocation, then runs the
same Just command again without the pause.
Progress scenarios run the real Just command in a task-owned PTY. The driver sets the PTY width with the terminal interface for the narrow-layout check. It does not fake outcome data. Generated media, archive state, exit status, and retained transcripts prove each outcome.
The dependency feature runs the real Just recipe with task-owned restricted
PATH directories. It proves that missing Python, FFmpeg, FFprobe, libx265,
or lsof fails before the source or archive changes.
The parallel-batch feature creates 100 generated videos for each serial, normal, maximum, and cancellation run. It records selected limits, observed simultaneous media processes, throughput, elapsed time, peak RSS, CPU use, and backend-session applicability. During the cancellation run, it starts a second real archive invocation and requires exit 75 before it sends one SIGINT to the first invocation. It then verifies exit 130, owned-child cleanup, recovery, and exact final accounting. A separate six-video 1280x720 workload exercises the maximum-mode worker bound with representative media instead of relying on the small 100-video correctness fixtures for resource safety.
Evidence
Validate the retained bundle after Drive.
uv run --no-project python "$VERIFY_DIR/scripts/verify_video_archive.py" \
evidence --manifest "$MANIFEST"
Read manifest.json first. It records exact argument arrays, exit status,
transcripts, Git revision and dirty identity, platform and tool versions,
inventories, hashes, FFprobe output, operation records, and check status.
skipped and unmet remain separate from passed. verifier identifies
the B package and its files separately from git and tested_files, which
identify the A checkout under test.
For a target-platform acceptance run, use --feature parallel-batch and retain
the complete bundle. Run the feature on both Linux and Apple M2 hardware. A run
from another machine does not satisfy either target gate.
Evidence paths are relative to manifest.json. You can move the complete
bundle and run Evidence again. It rechecks every retained path and SHA-256.
The verifier independently reopens each successful archive with FFprobe, decodes it with FFmpeg, and compares its hash with the durable operation record. The production store remains responsible for verifying publication before it removes a source.
See the evidence schema when reviewing or extending the manifest.
Cleanup
Remove only the disposable root named by the manifest.
uv run --no-project python "$VERIFY_DIR/scripts/verify_video_archive.py" \
cleanup --manifest "$MANIFEST"
Cleanup checks the run ID and random owner token before removal. It refuses a symbolic link, a broad path, a changed marker, or evidence stored below the run root. Cleanup never loads a PID or signals a process. The evidence bundle and manifest survive.
Helpers
Run the whole lifecycle when you do not need to inspect the run before cleanup.
Its answer names the manifest in file, also when a check fails.
uv run --no-project python "$VERIFY_DIR/scripts/verify_video_archive.py" \
run --checkout "$CHECKOUT" --feature all
Benchmark backends
For backend performance and compression qualification, read
the backend benchmark feature. Its command
uses generated media and invokes the same just convert-video entry point.
Keep its visual gate unmet until a reviewer finishes the blinded comparison.
Run focused helper tests after changing the verifier.
uv run --no-project python -m unittest discover \
-s "$VERIFY_DIR/scripts/tests" -v
Run the verifier package checks in the skills checkout and the application checks in the explicit dotfiles checkout. Each platform acceptance gate also needs a passing full Drive run on that platform.
just check --only verify-video-archive
just --justfile "$CHECKOUT/justfile" test-video-archive
uv run --no-project python "$VERIFY_DIR/scripts/verify_video_archive.py" \
run --checkout "$CHECKOUT" --feature all
04 同仓库更多 Skills
writing-great-skills
Use when creating, modifying, evaluating a skill.
writing-for-agents
Use when creating, editing, or reviewing a skill, AGENTS.md, CLAUDE.md, or another document agents read.
why
Use for questions about design rationale, the history of regressions or incidents, or the evidence behind thresholds and tradeoffs. Use `how` for runtime behavior. Do not use for plain commit or date lookups.
verify-transcript
Use when validating transcript CLI behavior, locating its verification features, or running the paid YouTube end-to-end check.
verify-skills
Use when verifying `just compile-skills`, `just remote-skills`, `just install-skills`, or `just skills-discover` in the skills repository, such as after changing their scripts or adding, renaming, or moving a skill.
unslop
Use when communicating directly with the user or writing and editing documents.