math-biographies

name	math-biographies
description	Plan and insert sourced mathematician biographies into relevant mathematical-book chapters with project-configured count, length, format, placement, and whole-book de-duplication.

Math Biographies

This capability is optional. Read the project biography settings, outline, chapter files, existing plan, and existing ledger before acting.

Plan the complete set of people in blueprint/biography-plan.json before editing any chapter. Select only people with a specific mathematical relationship to their assigned chapter. A name occurrence alone is insufficient. Use stable lower-case hyphenated person IDs and never repeat a person within the book.

Respect the project's count, length unit/range, LaTeX environment, title template, and placement rules. Add % MATHBOOK_BIOGRAPHY: person-id immediately before each inserted block. Keep biographies outside exercises and never split a definition, theorem, proof, or worked calculation.

Every historical claim needs a factual source. After insertion, write logs/biography-ledger.json, bind plan_sha256 to the current plan bytes, and record each person's ID, chapter, artifact, inserted status, sources, and measured length. Run deterministic checks. Leave any configured human gate for a human to approve.

Use this plan shape:

{
  "version": 1,
  "settings": {
    "target_count": 4,
    "min_length": 180,
    "max_length": 320,
    "length_unit": "characters",
    "format": {
      "environment": "project-environment",
      "title_template": "project-defined template"
    },
    "placement_rules": "project-defined rules"
  },
  "people": [
    {
      "person_id": "stable-person-id",
      "name": "display name",
      "aliases": ["optional alternate name"],
      "chapter": "04",
      "placement": "after-section:4.2",
      "relevance": "specific mathematical relationship to this chapter",
      "sources": ["factual source identifier and location"],
      "status": "planned"
    }
  ]
}

Use this ledger shape after every planned block is present:

{
  "version": 1,
  "plan_sha256": "sha256 of the exact biography-plan.json bytes",
  "entries": [
    {
      "person_id": "stable-person-id",
      "chapter": "04",
      "artifact": "chapters/04-draft.tex",
      "status": "inserted",
      "sources": ["factual source identifier and location"],
      "measured_length": 240
    }
  ]
}

Measure only the biography body, excluding its title and TeX commands. The deterministic checker recalculates this value using the configured unit.

The bundled references/heine-renwu-example.tex shows one user-supplied Chinese format. It is a reference only and must not become the default for unrelated projects.