Files
rengine/Makefile
T
Yogesh OjhaandClaude Opus 5 0b853e04b6 chore: production-readiness review across the tree
A full static review of the 3.0 tree, run as two fan-out passes with every
finding verified against the running stack rather than taken on inspection.

Correctness and security
- instance settings encrypted the mask over the stored AI key: `!= MASK` never
  matched `••••••••abcd`, so saving settings destroyed the key and `test_ai`
  posted the mask as a bearer token
- the MFA token was replayable for its full five-minute life; the gate now
  checks revocation and consumes the token after a successful exchange
- logout revoked nothing for a bearer client while answering "Logged out"
- `POST /api-keys/{id}/test` returned the plaintext key inside httpx's error
  string, which embeds the whole URL
- an interest rule could be edited or deleted through another project's id
- redis ran the celery broker under `allkeys-lru`, free to evict a queued task
  or a chord counter; now `noeviction`
- nuclei's stored command carried the OAST token and every auth header
- a finalize step could poison the session and leave a scan RUNNING for ever
- `is:issue` raised TypeError on every search
- offset paging repeated and skipped rows in four dimensions
- a cancelled run kept a stale `scans.*_found` rollup
- every PDF report raised `KeyError: 'software'`
- `version_key` truncated a wide numeric run and inverted release ordering
- psycopg raises a NUL as a bare ValueError, above StatementError, so every
  savepoint guard was blind to the case it was written for

Performance
- endpoints.host had no trigram index: 35.9ms seq scan -> 0.389ms
- free text compiled to one OR, not the prescribed UNION ALL: 132ms -> 41ms
- `/http-assets/summary` and `/ips/summary` materialised whole tables
- the cross-link `ip` kind ran an estate query per page and drew nothing

Frontend
- `$effect` loaders that read the state they write, an unbounded request loop
  on a failing endpoint
- error states that rendered as empty states
- 2FA backup codes were unusable while the copy said they worked
- a "Scan history" dialog that always reported none
- ~400 duplicated lines across five filter bars, now one component

Build and tooling
- every scanner installed at @latest; all 13 pinned to the measured versions
- CI built `web/`, gone since 2.x, with tags that cannot be valid
- the prettier pre-commit hook discarded its filenames and always passed
- the test suite destroyed itself when run twice

Also: subdomains from public code, via a pinned github-subdomains source and a
GitHub API key that subfinder receives too; sublist3r and oneforall removed
after measuring one unique host in 89 across four targets.

Verified: 853 tests, ruff clean over eleven packages, svelte-check 0 errors,
the count-is-a-promise gate at 131 checks and 0 mismatches, and 143 GET routes
with no 5xx. Four migrations, each with an exercised downgrade.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DVkdx5ynZ6aof5kLFczmhX
2026-09-13 18:03:29 +05:30

82 lines
2.5 KiB
Makefile

.PHONY: help up down build logs logs-api logs-worker migrate migrate-create migrate-draft migrate-history \
migrate-downgrade db-stamp db-reset shell-api shell-worker db-shell
help:
@echo "reNgine 3.0 Dev Commands"
@echo ""
@echo " Docker:"
@echo " make up Start all services"
@echo " make down Stop all services"
@echo " make build Rebuild all containers"
@echo " make logs Tail all logs"
@echo " make logs-api Tail API logs"
@echo " make logs-worker Tail worker logs"
@echo ""
@echo " Database Migrations:"
@echo " make migrate Apply all pending migrations"
@echo " make migrate-create m=msg Create new migration (autogenerate)"
@echo " make migrate-history Show migration history"
@echo " make migrate-downgrade Rollback last migration"
@echo " make db-stamp Stamp DB as current (existing DB setup)"
@echo " make db-reset Drop all tables and re-migrate (DESTRUCTIVE)"
@echo ""
@echo " Debug:"
@echo " make shell-api Shell into API container"
@echo " make shell-worker Shell into worker container"
@echo " make db-shell PostgreSQL shell"
# Docker
up:
docker compose up -d
down:
docker compose down
build:
docker compose build
logs:
docker compose logs -f
logs-api:
docker compose logs -f api
logs-worker:
docker compose logs -f worker-default
migrate:
docker compose exec api uv run alembic upgrade head
migrate-create:
@if [ -z "$(m)" ]; then echo "Usage: make migrate-create m='migration message'"; exit 1; fi
docker compose exec api uv run alembic revision -m "$(m)"
migrate-draft:
@if [ -z "$(m)" ]; then echo "Usage: make migrate-draft m='migration message'"; exit 1; fi
docker compose exec api uv run alembic revision --autogenerate -m "$(m)"
migrate-history:
docker compose exec api uv run alembic history --verbose
migrate-downgrade:
docker compose exec api uv run alembic downgrade -1
db-stamp:
docker compose exec api uv run alembic stamp head
db-reset:
@echo "Every table is dropped and the migrations are re-applied."
@read -p "Continue? [y/N] " confirm && [ "$$confirm" = "y" ] || exit 1
docker compose exec api uv run alembic downgrade base
docker compose exec api uv run alembic upgrade head
# Shells
shell-api:
docker compose exec api bash
shell-worker:
docker compose exec worker-default bash
db-shell:
docker compose exec db sh -c 'psql -U "$${POSTGRES_USER:-rengine}" -d "$${POSTGRES_DB:-rengine}"'