Skip to content

docs(claude): weekly CLAUDE.md refresh 2026-07-06 #16

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
allyblockcast wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(claude): weekly CLAUDE.md refresh 2026-07-06 #16

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,9 @@ cd hindsight-control-plane && npm run dev
./scripts/benchmarks/run-perf-test.sh --scale tiny # Quick smoke test
./scripts/benchmarks/run-consolidation.sh

# GitHub Actions perf artifacts intentionally retain for 1 day; durable
# history is published to the performance dashboard instead.

# Results viewer
./scripts/benchmarks/start-visualizer.sh # View results at localhost:8001
```
Expand Down Expand Up @@ -121,6 +124,10 @@ PostgreSQL with pgvector. Schema managed via Alembic migrations in `hindsight-ap

Key tables: `banks`, `memory_units`, `documents`, `entities`, `entity_links`

### Helm Operations

Helm liveness probes must stay process-local so database pressure does not restart healthy pods: API liveness uses `/version`, worker liveness uses `/metrics`, and readiness remains DB-backed on `/health`. The default embedded-PostgreSQL chart values intentionally cap API DB pools and worker/retain concurrency; do not raise those defaults without validating connection pressure under retain/consolidation backlog.

### Adding Database Migrations

Hindsight runs the same Alembic tree against PostgreSQL and Oracle 23ai. Each
Expand Down