Bootstrap Codex project scaffold with Dev Container and Dockerized PostgreSQL

[Copilot]

This PR reshapes the repository into a Codex-ready project skeleton and adds a consistent local development runtime. It introduces Dev Container support, Docker Compose database provisioning, and startup docs/env conventions for secure, repeatable onboarding.

• Project scaffold

  • Added top-level structure for ongoing development and information organization:
    • .devcontainer/, src/, docs/, data/, scripts/
  • Added .gitkeep placeholders in new directories to preserve structure in git.

• Containerized development environment

  • Added .devcontainer/devcontainer.json configured to run against Compose service app.
  • Added .devcontainer/Dockerfile (base dev image + postgresql-client) for local DB tooling in-container.
  • Aligned workspace mount/path naming to codex for consistency.

• Database runtime via Docker Compose

  • Added docker-compose.yml with:
    • app service for Dev Container workflow
    • db service (postgres:16-alpine) with persistent volume
    • configurable host port via POSTGRES_PORT
    • required POSTGRES_PASSWORD (no weak default fallback)

• Environment and secret hygiene

  • Added .env.example with:
    • OPENAI_API_KEY=your_openai_api_key_here
    • PostgreSQL variables (POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB, POSTGRES_PORT)
  • Added .gitignore covering local env files, editor state, caches, logs, and build artifacts.

• README replacement for Codex onboarding

  • Replaced previous repository README with Codex-focused setup:
    • project purpose
    • directory map
    • Dev Container startup
    • Docker Compose DB startup
    • OpenAI env variable usage and expected location

# docker-compose.yml (key behavior)
db:
  image: postgres:16-alpine
  ports:
    - "${POSTGRES_PORT:-5432}:5432"
  environment:
    POSTGRES_USER: ${POSTGRES_USER:-codex}
    POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env}
    POSTGRES_DB: ${POSTGRES_DB:-codex}
  volumes:
    - postgres_data:/var/lib/postgresql/data

[Copilot]

Pull request overview

This PR repurposes the repository into a “Codex” project scaffold and adds a consistent local development environment based on Dev Containers and Docker Compose, including a Dockerized PostgreSQL service and example environment variables.

Changes:

• Replaced the README with Codex onboarding instructions (Dev Container + Compose DB + env usage).
• Added Dev Container configuration and a minimal dev image with postgresql-client.
• Added docker-compose.yml, .env.example, and a baseline .gitignore, plus directory placeholders.

Reviewed changes

Copilot reviewed 5 out of 10 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
README.md	New onboarding docs for Dev Container + Compose DB + env variables.
docker-compose.yml	Adds app (Dev Container) and db (Postgres 16) services with volume persistence.
.devcontainer/devcontainer.json	Dev Container config targeting the Compose app service.
.devcontainer/Dockerfile	Dev image installs postgresql-client for DB tooling.
.env.example	Example env vars for OpenAI key and Postgres configuration.
.gitignore	Ignores env files, editor state, caches, logs, and build artifacts.
src/.gitkeep	Placeholder to keep src/ in git.
docs/.gitkeep	Placeholder to keep docs/ in git.
data/.gitkeep	Placeholder to keep data/ in git.
scripts/.gitkeep	Placeholder to keep scripts/ in git.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.