Land phoebe on release-2026.02.01

.dockerignore

@@ -0,0 +1,5 @@
+.git
+.github
+bin
+*.md
+config/settings.example.yaml

.github/workflows/ci.yml

@@ -0,0 +1,66 @@
+name: CI
+on: push
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.23"
+      - name: golangci-lint
+        uses: golangci/golangci-lint-action@v6
+        with:
+          version: v1.64.8
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.23"
+      - run: go mod download
+      - name: Vet
+        run: go vet ./...
+      - name: Test
+        run: make test
+
+  integration-test:
+    name: Integration (live Postgres conformance)
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        # Money correctness IS the product: the rating SQL must be exercised
+        # against a real Postgres (the in-Go oracle pins the formula, but only
+        # the live DB proves the SQL — and the NUMERIC sum-then-round — match).
+        image: postgres:16
+        env:
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: phoebe_test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U postgres"
+          --health-interval 5s
+          --health-timeout 5s
+          --health-retries 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.23"
+      - run: go mod download
+      - name: Integration test
+        env:
+          PHOEBE_TEST_DATABASE_URL: postgres://postgres:postgres@localhost:5432/phoebe_test?sslmode=disable
+        run: make integration-test

.gitignore

@@ -0,0 +1,26 @@
+# build artifacts
+/bin/
+*.exe
+*.o
+*.a
+*.so
+
+# test / coverage
+*.out
+.coverage
+
+# editor files
+**/.idea/
+**/.vscode/
+
+# misc
+*.DS_Store
+*.log
+
+# credentials and key material
+*.pem
+*.env
+config/settings.yaml
+
+# go workspace
+vendor/

.golangci.yml

@@ -0,0 +1,32 @@
+# golangci-lint configuration for phoebe.
+# Run locally with `make lint` (installs the pinned version on demand) or via
+# the pre-commit hook. CI runs the same version.
+run:
+  timeout: 5m
+
+linters:
+  enable:
+    - errcheck      # unchecked errors
+    - govet         # go vet
+    - ineffassign   # ineffectual assignments
+    - staticcheck   # staticcheck analyzers
+    - unused        # unused code
+    - gofmt         # formatting
+    - goimports     # import grouping/ordering
+    - misspell      # common misspellings
+    - bodyclose     # http response bodies closed
+    - noctx         # http requests should carry a context
+    - unconvert     # unnecessary type conversions
+    - revive        # golint successor (style)
+
+linters-settings:
+  goimports:
+    local-prefixes: github.com/saturncloud/phoebe
+
+issues:
+  exclude-rules:
+    # Test files may leave bodies/errs unchecked for brevity.
+    - path: _test\.go
+      linters:
+        - errcheck
+        - bodyclose

.pre-commit-config.yaml

@@ -0,0 +1,15 @@
+# Pre-commit hooks for phoebe. Install once with `pre-commit install`.
+# Mirrors what CI enforces: formatting, vet, and golangci-lint.
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+
+  - repo: https://github.com/golangci/golangci-lint
+    rev: v1.64.8
+    hooks:
+      - id: golangci-lint