pr-process

1. Prerequisites

- Node.js 24.11.x and Bun 1.3.5

- Go 1.24+

- Docker / Kubernetes tooling if you plan to run services or apply manifests locally

1. Install workspace dependencies

```bash

bun install

```

1. Launch the landing web app

```bash

bun run dev:landing

```

1. Start the Convex backend locally (in another terminal)

```bash

bun run dev:convex

```

1. Run Go services (example)

```bash

go run ./services/prt

```

> Prefer a hosted development experience? Click the Open in Coder button above to provision a workspace with Node 24, Bun, and the repository pre-installed.

---

| Path | Description |

| ---- | ----------- |

| apps/ | Frontends and UX surfaces (e.g. landing, app, docs) with co-located fixtures and tests. |

| packages/backend | Convex backend project (convex dev, codegen, model seeding). |

| packages/atelier, packages/cloutt | Shared TypeScript utilities and infrastructure tooling. |

| services/ | Go microservices (miel, prt, eclair) with adjacent tests and Dockerfiles. |

| ansible/ | Playbooks and inventory for provisioning supporting hosts. |

| tofu/ | OpenTofu (Terraform) configurations for Harvester, Cloudflare, Rancher, and Tailscale. |

| kubernetes/ | Cluster bootstrap/maintenance tooling (install scripts, Coder template); no workload manifests. |

| argocd/ | Argo CD application specs and ApplicationSets for GitOps deployment. |

| scripts/ | Helper scripts for builds, secrets management, and Tailscale automation. |

| AGENTS.md, CLAUDE.md | Notes and prompts for AI agent integrations. |

---

Frontend

• Lint & format: bun run lint:landing, bun run format
• Build & smoke test: bun run build:landing then bun run start:landing
• Shared Biome config lives at biome.json

Convex Backend

• Generate types: bun run --filter @proompteng/backend codegen
• Start local dev: bun run dev:convex
• Seed models: bun run seed:models

Go Services

• Test all services: go test ./services/...
• Build binaries: go build ./services/...
• Unit test a single service: go test ./services/prt -run TestHandleRoot

Tooling & Quality

• Husky + Biome formatted on commit (lint-staged configuration in package.json).
• Oxlint runs alongside Biome: bun run lint:oxlint for repo-wide JS/TS checks and bun run lint:oxlint:type to run type-aware checks across TS workspaces.
• Type-aware Oxlint uses tsgolint (typescript-go), which may skip unsupported tsconfig options (such as baseUrl)—use lint-only tsconfigs per workspace if needed.
• TailwindCSS v4 & Radix UI used extensively in frontend components.

---

Some experiments expect a Postgres instance (see original Home Cloud notes). To recreate the environment locally:

1. Install the CLI:

```bash

brew install postgresql

```

1. (Linux) install server packages:

```bash

sudo apt update && sudo apt install postgresql

```

1. Enable remote access (optional lab setup):

- Add to pg_hba.conf:

```

host all all 192.168.1.0/24 trust

```

- Ensure postgresql.conf includes listen_addresses = '*'.

1. Create a user & database:

```bash

create role altra with login;

create database altra with owner altra;

```

1. Grant privileges as needed:

```sql

grant create on database altra to altra;

```

These instruc