chore: Makefile with venv-based dev workflow #34

Merged

archeious merged 1 commit from chore/makefile into main

2026-04-08 22:32:29 +00:00

claude-code commented

2026-04-08 22:31:09 +00:00

Collaborator

Why

Local dev without docker — make install creates .venv and pip installs the project editable so contributors get from clone to working CLI in one command.

Targets

Target	What it does
`make install`	create `.venv` and `pip install -e ".[dev]"`
`make test`	run pytest inside the venv
`make test-cov`	pytest with coverage
`make lint`	ruff + `black --check`
`make ask`	run a sample research call (override `Q="..."` to ask something else)
`make costs`	show the cost ledger summary
`make clean`	remove `.venv` and caches
`make docker-build` / `make docker-test`	parity wrappers for the existing docker flow
`make help`	colored target listing (default goal)

README's quick start now points at make install as the recommended path; manual venv steps documented as fallback.

No code changes; pure additive tooling.

## Why Local dev without docker — `make install` creates `.venv` and pip installs the project editable so contributors get from clone to working CLI in one command. ## Targets | Target | What it does | |---|---| | `make install` | create `.venv` and `pip install -e ".[dev]"` | | `make test` | run pytest inside the venv | | `make test-cov` | pytest with coverage | | `make lint` | ruff + `black --check` | | `make ask` | run a sample research call (override `Q="..."` to ask something else) | | `make costs` | show the cost ledger summary | | `make clean` | remove `.venv` and caches | | `make docker-build` / `make docker-test` | parity wrappers for the existing docker flow | | `make help` | colored target listing (default goal) | README's quick start now points at `make install` as the recommended path; manual venv steps documented as fallback. No code changes; pure additive tooling.

claude-code added 1 commit 2026-04-08 22:31:10 +00:00

chore: add Makefile with venv-based dev workflow 9ecc1db38d

Targets:
  make install      create .venv and pip install -e ".[dev]"
  make test         pytest inside the venv
  make test-cov     pytest with coverage
  make lint         ruff + black --check
  make ask          run a sample research call
  make costs        show the cost ledger
  make clean        remove venv and caches
  make docker-build / docker-test   parity wrappers for the docker flow

Lets contributors get from clone to running CLI in one command
without depending on docker. README points at make install as
the recommended path; manual venv steps documented as fallback.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>