module-source-coverage

name: module-source-coverage description: | Use when a tutorial module plan exists and the run needs an auditable module-to-source grounding file before prose. Trigger: module coverage, source coverage, tutorial grounding, 模块覆盖, 来源覆盖. Use when: source-tutorial 的 C2，已有 outline/module_plan.yml，需要确认每个模块都能回指到 sources。 Skip if: module plan 或 source ingest 不完整。 Network: none. Guardrail: 只做 grounding audit，不写教程正文。

Module Source Coverage

Builds outline/source_coverage.jsonl, one coverage record per module.

Inputs

• outline/module_plan.yml
• sources/index.jsonl
• sources/provenance.jsonl

Output

• outline/source_coverage.jsonl

Contract

Each record must include:

• module_id
• module_title
• source_ids and/or explicit gaps

Script boundary

scripts/run.py should:

• score module-to-source relevance
• choose a small source set per module
• record explicit grounding gaps when coverage is weak

Keep text matching and snippet scoring in shared tutorial tooling, not in the wrapper.

Acceptance

• outline/source_coverage.jsonl exists
• every module appears exactly once
• missing grounding is explicit instead of silent

Non-goals

• context pack assembly
• tutorial prose