# INSTALL — JoF-250 Writing Engine

Tested on macOS 27 (Apple Silicon), Python 3.12 via uv, Claude Code 2.1.317.

cd ~/Desktop/UQO/Recherche/Recherche-UQO/methodes/wp45-jof250
uv venv --python 3.12 .venv && uv pip install --python .venv/bin/python -e ".[dev]"
cp .env.example .env            # point JOF250_ANTHROPIC_KEY_FILE to a file containing ANTHROPIC_API_KEY=… (never committed)
.venv/bin/jof250 --help

Corpus: config/corpus.yaml → corpus_root (default ~/Desktop/Journal-of-Finance-2018-2020, read-only). The derived artefacts are regenerated by:

make audit      # Phase 1 inventory + Crossref verification  → data/manifests/
make parse      # Phase 2 PyMuPDF structural extraction      → data/derived/parsed/ (private, gitignored)
make annotate   # Phase 3 LLM annotation (API, budget-capped) → data/annotations/
make profiles   # Phase 4 profiles + figures                  → profiles/*.yaml, figures/
make index      # Phase 5 hybrid index                        → data/derived/index/
make test       # pytest (synthetic fixtures only; no API calls)

# Claude Code integration

• Project scope (already present): .claude/commands/jof-*.md, .claude/agents/jof-*.md, .claude/skills/jof250/SKILL.md. Open Claude Code inside the repository and type /jof-status.
• User scope (optional, makes /jof-* available in every session): .venv/bin/jof250 install-claude-code --scope user [--force]. It writes only ~/.claude/commands/jof-*.md, ~/.claude/agents/jof-*.md, ~/.claude/skills/jof250/; it never edits ~/.claude/settings.json. To uninstall: delete those files.
• The commands call the absolute path of this repository's .venv/bin/jof250; if you move the repository, re-run the install command.

# Secrets and spend

API key is read from ANTHROPIC_API_KEY or JOF250_ANTHROPIC_KEY_FILE (see .env.example). Every API call is logged to data/annotations/api_ledger.jsonl; config/models.yaml: budget_usd_cap stops further calls once reached (jof250 status shows spend).