Schema Normalizer (NO PROSE)

Triggers & routing

• Trigger: schema normalize, jsonl contract, interface drift, join drift, 字段不一致, schema 规范化.
• Use when: you have generated C2-C4 JSONL artifacts (outline/briefs/bindings/packs/anchors) and want deterministic, stable fields before self-loops/writing.

Purpose: close a common failure mode in skills-first pipelines: schema drift across JSONL artifacts.

When fields are inconsistent (missing ids/titles, mixed citation-key formats), downstream skills start doing best-effort joins and fragile parsing. This skill makes the interface explicit and deterministic.

Inputs

• outline/outline.yml (source of truth for section/subsection ids + titles)
• Optional (for citation-key sanity): citations/ref.bib
• Default JSONL artifacts to normalize (arxiv-survey(-latex) C4 bridge):
  • outline/subsection_briefs.jsonl
  • outline/chapter_briefs.jsonl
  • outline/evidence_bindings.jsonl
  • outline/evidence_drafts.jsonl
  • outline/anchor_sheet.jsonl
• Optional (run after writer packs are generated):
  • outline/writer_context_packs.jsonl

Outputs

• output/SCHEMA_NORMALIZATION_REPORT.md (always written; PASS/FAIL + what changed)
• The processed JSONL files are normalized in place (a .bak.* is created if changes are applied).

What gets normalized

1) IDs + titles (join keys)

For any record with sub_id: "<H2>.<H3>":

• Ensure section_id exists (derived from the prefix before the dot)
• Ensure title, section_title exist (filled from outline/outline.yml)

For any record with section_id: "<H2>":

• Ensure section_title exists (filled from outline/outline.yml)

2) Citation key format (reduce parsing drift)

Within these C2-C4 JSONL artifacts, normalize citation keys so they are raw BibTeX keys (no @ prefix):

• "citations": ["smith2023", "jones2024"]