cite-placement

Citation Placement

Unified router for three citation workflows. A single Tkinter launcher collects inputs and writes run_config.json; the "pipeline" value selects one of three modes, each with its own detailed workflow document.

Modes and Routing

Read the relevant workflow document at the start of each phase.

Launcher-First Protocol

When the user triggers this skill:

1. Run the launcher with a 10-minute timeout (the user needs time to browse and configure), using the skill's known absolute directory as [skill-dir], not the current working directory:

   python "[skill-dir]/scripts/launcher.py"
   

   Call it via the Bash tool with timeout: 600000.
2. The unified GUI presents the file fields and options for all three modes and offers three run buttons — Inline Placement, Footnote Placement, and Restyle — plus a Utilities area (Strip All Citations; Regenerate / Reorder Cross-Refs, with or without an existing registry). On any run button the launcher validates inputs and writes placement/run_config.json in the output file's parent directory, then prints machine-readable status lines to stdout.
3. Parse the launcher's stdout:
   • LAUNCHER_STATUS: success — proceed. If missing or cancelled, stop.
   • LAUNCHER_CONFIG_PATH: <path> — the absolute path to run_config.json. Use this path for all subsequent phases. All paths inside the config are absolute; do not assume the config lives in the current working directory.
4. Read run_config.json and route on config["pipeline"]:
   • "inline" → run the inline placement pipeline (references/phase-details-inline.md).
   • "footnotes" → run the footnote placement pipeline (references/phase-details-footnotes.md).
   • "restyle" → run the restyle pipeline (Restyle Pipeline section of references/phase-details-footnotes.md).
5. Run the selected pipeline end-to-end without asking questions or waiting for confirmation between phases. The only pause is the Phase 4 human-in-the-loop gate in the two placement modes, and only when auto_approve is false.