Makefile

# Penrose — research referee. Common tasks.
# The core (eval, calib-*, worked-example, connections, test) runs with no API key and no external data.
# Ingesting a paper needs a model key; the cz-* / rdagent targets need a data download (see the notebook).
# Sandboxed auto-module implementation optionally requires Docker.

PY ?= python3
export PYTHONPATH := src:.
ROOT := $(shell pwd)

.PHONY: help init eval worked-example calib-placebo calib-persistence calib-injection calib-nulls \
        calib-sensitivity calib-breadth calib-synth calib-hypothesis calib-tail connections test \
        run review generate stage0 dash cz-referee cz-decay rdagent-referee

help:
	@echo "Penrose targets (the core runs keyless, no external data):"
	@echo "  make init             — create the ignored repo-local data catalog scaffold"
	@echo "  make eval             — planted strategies with known verdicts (proves it discriminates)"
	@echo "  make worked-example   — same return series, two search processes, two verdicts"
	@echo "  make calib-placebo    — negative control: no-edge signals must NOT certify"
	@echo "  make calib-injection  — positive control: detection curve for a known injected edge"
	@echo "  make calib-nulls      — 5-null falsification battery: no null may certify"
	@echo "  make calib-sensitivity— detection-threshold vs sample size and cost"
	@echo "  make calib-tail       — tail-risk control: detector flags widow-makers, spares benign"
	@echo "  make calib-breadth    — native-breadth recalibration (IC floor vs N)"
	@echo "  make calib-synth      — honesty controls for concepts / synthesis / firewall"
	@echo "  make calib-hypothesis — planted-principle recovery + grounding firewall"
	@echo "  make connections      — advisory connection-discovery over the corpus"
	@echo "  make test             — run the test suite"
	@echo "  make dash             — launch the read-only dashboard (localhost)"
	@echo "  make generate ARGS='[claims|specs] ...' — candidate modes or live readiness"
	@echo ""
	@echo "  Needs a data download (see the notebook):"
	@echo "    make cz-referee  /  make cz-decay  /  make rdagent-referee"
	@echo ""
	@echo "  Ingest your own claim (needs a model key):  make run ARGS='--paper inbox/<file>'"
	@echo "  Commit a proposal (human gate, you run this yourself):"
	@echo "    $(PY) -m penrose.pipeline.p9_review approve <i> --approver <you>"

init:
	@if [ -L "$(ROOT)/data" ]; then \
		echo "make init: ERROR: $(ROOT)/data is a symlink; expected a real directory." >&2; exit 1; \
	fi
	@if [ -e "$(ROOT)/data" ] && [ ! -d "$(ROOT)/data" ]; then \
		echo "make init: ERROR: $(ROOT)/data exists but is not a directory." >&2; exit 1; \
	fi
	@mkdir -p "$(ROOT)/data"
	@if [ ! -e "$(ROOT)/data/catalog.yaml" ] && [ ! -L "$(ROOT)/data/catalog.yaml" ]; then \
		printf 'series: {}\n' > "$(ROOT)/data/catalog.yaml"; \
		echo "Created $(ROOT)/data/catalog.yaml"; \
	else \
		echo "Existing $(ROOT)/data/catalog.yaml left unchanged."; \
	fi
	@echo "Add series files under $(ROOT)/data/files/ and register them in catalog.yaml."
	@echo "To use another catalog directory, set PENROSE_DATA_DIR=/path/to/catalog."

# --- keyless: discrimination + calibration -------------------------------------
eval:
	$(PY) scripts/eval_suite.py
worked-example:
	$(PY) scripts/worked_example_process_conditional.py
calib-placebo:
	$(PY) scripts/calibration_placebo.py 100 0
calib-persistence:
	$(PY) scripts/calibration_persistence.py 100 0
calib-injection:
	$(PY) scripts/calibration_injection.py 15 0
calib-nulls:
	$(PY) scripts/calibration_nulls.py 60
calib-sensitivity:
	$(PY) scripts/calibration_sensitivity.py 12
calib-tail:
	$(PY) scripts/calibration_tail.py 200
calib-breadth:
	$(PY) scripts/calibration_breadth.py 12
calib-synth:
	$(PY) scripts/calibration_synthesizer.py
calib-hypothesis:
	$(PY) scripts/calibration_hypothesis_creation.py
connections:
	$(PY) scripts/brain_connections.py
test:
	$(PY) -m pytest tests/ -q

# --- pipeline (model key as noted) ---------------------------------------------
run:
	$(PY) -m penrose.pipeline.run $(ARGS)
review:
	$(PY) -m penrose.pipeline.p9_review list
generate:
	$(PY) -m penrose.cli generate $(ARGS)
stage0:
	$(PY) scripts/stage0_funding_carry.py
dash:
	$(PY) dashboard/live_server.py

# --- external data required (see the notebook) ---------------------------------
cz-referee:
	$(PY) scripts/cz_referee.py
cz-decay:
	$(PY) scripts/cz_decay.py
rdagent-referee:
	$(PY) scripts/rdagent_referee.py