1# INSTALL — JoF-250 Writing Engine23Tested on macOS 27 (Apple Silicon), Python 3.12 via `uv`, Claude Code 2.1.317.45```bash6cd ~/Desktop/UQO/Recherche/Recherche-UQO/methodes/wp45-jof2507uv venv --python 3.12 .venv && uv pip install --python .venv/bin/python -e ".[dev]"8cp .env.example .env # point JOF250_ANTHROPIC_KEY_FILE to a file containing ANTHROPIC_API_KEY=… (never committed)9.venv/bin/jof250 --help10```1112Corpus: `config/corpus.yaml` → `corpus_root` (default `~/Desktop/Journal-of-Finance-2018-2020`, read-only). The derived artefacts are regenerated by:1314```bash15make audit # Phase 1 inventory + Crossref verification → data/manifests/16make parse # Phase 2 PyMuPDF structural extraction → data/derived/parsed/ (private, gitignored)17make annotate # Phase 3 LLM annotation (API, budget-capped) → data/annotations/18make profiles # Phase 4 profiles + figures → profiles/*.yaml, figures/19make index # Phase 5 hybrid index → data/derived/index/20make test # pytest (synthetic fixtures only; no API calls)21```2223## Claude Code integration24- 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`.25- 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.26- The commands call the absolute path of this repository's `.venv/bin/jof250`; if you move the repository, re-run the install command.2728## Secrets and spend29API 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).30