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