chrysopedia/CLAUDE.md
jlightner 4b0914b12b fix: restore complete project tree from ub01 canonical state
Auto-mode commit 7aa33cd accidentally deleted 78 files (14,814 lines) during M005
execution. Subsequent commits rebuilt some frontend files but backend/, alembic/,
tests/, whisper/, docker configs, and prompts were never restored in this repo.

This commit restores the full project tree by syncing from ub01's working directory,
which has all M001-M007 features running in production containers.

Restored: backend/ (config, models, routers, database, redis, search_service, worker),
alembic/ (6 migrations), docker/ (Dockerfiles, nginx, compose), prompts/ (4 stages),
tests/, whisper/, README.md, .env.example, chrysopedia-spec.md
2026-03-31 02:10:41 +00:00

1.5 KiB

Chrysopedia — Development Reference

⚠️ Canonical Development Directory

This is NOT the canonical development directory.

The production codebase and all future development happens on ub01:

ssh ub01
cd /vmPool/r/repos/xpltdco/chrysopedia

GitHub: https://github.com/xpltdco/chrysopedia (private, xpltdco org)

Why?

The Docker Compose stack runs on ub01 with bind mounts at /vmPool/r/services/chrysopedia_*. Development, deployment, and testing all happen from the ub01 clone. This directory (/home/aux/projects/content-to-kb-automator) was the initial workspace used during M001 development and should not be used for future work.

Stack Info

  • Web UI: http://ub01:8096
  • API Health: http://ub01:8096/health
  • PostgreSQL: ub01:5433 (user: chrysopedia)
  • Compose project: xpltd_chrysopedia
  • Compose path: /vmPool/r/compose/xpltd_chrysopedia/docker-compose.yml (symlink to repo)
  • Services: chrysopedia-db, chrysopedia-redis, chrysopedia-qdrant, chrysopedia-ollama, chrysopedia-api, chrysopedia-worker, chrysopedia-web-8096

Quick Commands (on ub01)

# Check status
docker ps --filter name=chrysopedia

# Rebuild and restart after code changes
cd /vmPool/r/repos/xpltdco/chrysopedia
git pull
docker compose build && docker compose up -d

# Run Alembic migrations
docker exec chrysopedia-api alembic upgrade head

# View worker logs
docker logs -f chrysopedia-worker

# View API logs
docker logs -f chrysopedia-api