feat/initial version

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [sgaunet]

.github/workflows/coverage.yml

@@ -0,0 +1,49 @@
+name: Generate coverage badges
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+
+jobs:
+  generate-badges:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      # setup go environment
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: 1.24.x
+
+      - name: coverage
+        id: coverage
+        run: |
+          go mod download
+          go test ./...  -coverprofile=profile.cov
+          #echo -n "Total Coverage{{":"}} "
+          total=$(go tool cover -func profile.cov | grep '^total:' | awk '{print $3}' | sed 's/%//')
+          rm -f profile.cov
+          echo "COVERAGE_VALUE=${total}" >> $GITHUB_ENV
+
+      - uses: actions/checkout@v5
+        with:
+          repository: sgaunet/gh-action-badge
+          path: gh-action-badge
+          ref: main
+          fetch-depth: 1
+
+      - name: Generate coverage badge
+        id: coverage-badge
+        uses: ./gh-action-badge/.github/actions/gh-action-coverage
+        with:
+          limit-coverage: "30"
+          badge-label: "coverage"
+          badge-filename: "coverage-badge.svg"
+          badge-value: "${COVERAGE_VALUE}"
+
+      - name: Print url of badge
+        run: |
+          echo "Badge URL: ${{ steps.coverage-badge.outputs.badge-url }}"

.github/workflows/linter.yml

@@ -0,0 +1,34 @@
+name: linter
+
+on:
+  push:
+
+permissions:
+  contents: read
+
+jobs:
+  linter:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-go@v5
+        with:
+          go-version: stable
+      - name: Install task
+        uses: jaxxstorm/action-install-gh-release@v1.12.0
+        with:
+          repo: go-task/task
+          cache: enable
+          # tag: 
+      - name: Install golangci-lint
+        uses: jaxxstorm/action-install-gh-release@v1.12.0
+        with:
+          repo: golangci/golangci-lint
+          tag: v2.4.0
+          cache: enable
+          binaries-location: golangci-lint-2.4.0-linux-amd64
+
+      - name: Run linter
+        shell: /usr/bin/bash {0}
+        run: |
+          task linter

.github/workflows/release.yml

@@ -0,0 +1,61 @@
+name: release
+
+on:
+  push:
+    # Pattern matched against refs/tags
+    tags:        
+      - '**'           # Push events to every tag including hierarchical tags like v1.0/beta
+
+permissions:
+  contents: write
+  packages: write
+
+jobs:
+  goreleaser-release:
+    runs-on: ubuntu-latest
+    steps:
+      -
+        name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - name: Install Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '>=1.24'
+      - name: Install task
+        uses: jaxxstorm/action-install-gh-release@v1.12.0
+        with:
+          repo: go-task/task
+          # tag: 
+      - name: Install goreleaser
+        uses: jaxxstorm/action-install-gh-release@v1.12.0
+        with:
+          repo: goreleaser/goreleaser
+          # tag: 
+
+      -
+        # Add support for more platforms with QEMU (optional)
+        # https://github.com/docker/setup-qemu-action
+        name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+      -
+        name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Create release
+        shell: /usr/bin/bash {0}
+        run: |
+          task release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          # Your GoReleaser Pro key, if you are using the 'goreleaser-pro' distribution
+          # GORELEASER_KEY: ${{ secrets.GORELEASER_KEY }}
+          HOMEBREW_TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}

.github/workflows/snapshot.yml

@@ -0,0 +1,58 @@
+name: snapshot
+
+on:
+  push:
+
+permissions:
+  contents: read
+
+jobs:
+  goreleaser-snapshot:
+    runs-on: ubuntu-latest
+    steps:
+      -
+        name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - name: Install Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '>=1.24'
+      - name: Install task
+        uses: jaxxstorm/action-install-gh-release@v1.12.0
+        with:
+          repo: go-task/task
+          cache: true
+          # tag: 
+      - name: Install goreleaser
+        uses: jaxxstorm/action-install-gh-release@v1.12.0
+        with:
+          repo: goreleaser/goreleaser
+          cache: true
+          # tag: 
+
+      -
+        # Add support for more platforms with QEMU (optional)
+        # https://github.com/docker/setup-qemu-action
+        name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+      -
+        name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Create snapshot release
+        shell: /usr/bin/bash {0}
+        run: |
+          task snapshot
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          # Your GoReleaser Pro key, if you are using the 'goreleaser-pro' distribution
+          # GORELEASER_KEY: ${{ secrets.GORELEASER_KEY }}

.github/workflows/test.yml

@@ -0,0 +1,35 @@
+name: Tests
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install Go
+      uses: actions/setup-go@v5
+      with:
+        go-version: '>=1.24'
+
+    -
+      # Add support for more platforms with QEMU (optional)
+      # https://github.com/docker/setup-qemu-action
+      name: Set up QEMU
+      uses: docker/setup-qemu-action@v3
+    -
+      name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Download dependencies
+      run: go mod download
+
+    - name: Verify dependencies
+      run: go mod verify
+
+    - name: Run unit tests
+      run: |
+        go test -v -race ./...

.github/workflows/vulnerability-scan.yml

@@ -0,0 +1,32 @@
+name: Vulnerability Scan
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+  schedule:
+    - cron: '0 2 1 * *'  # Run at 2 AM on the 1st of every month
+  workflow_dispatch:     # Allow manual triggering
+
+permissions:
+  contents: read
+  security-events: write
+
+jobs:
+  vulnerability-scan:
+    runs-on: ubuntu-latest
+    name: Run govulncheck
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v5
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: 'go.mod'
+
+      - name: Run govulncheck
+        uses: golang/govulncheck-action@v1
+        with:
+          go-package: ./...

.gitignore

@@ -0,0 +1,52 @@
+# Binaries for programs and plugins
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, built with `go test -c`
+*.test
+
+# Output of the go coverage tool, specifically when used with LiteIDE
+*.out
+
+# Dependency directories (remove the comment below to include it)
+# vendor/
+
+# Go workspace file
+go.work
+
+# Built executable
+postgresql-mcp
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# IDE files
+.idea/
+*.swp
+*.swo
+*~
+
+# Logs
+*.log
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# Database files (if any test databases are created)
+*.db
+*.sqlite
+
+# Temporary files
+tmp/
+temp/

.golangci.yml

@@ -0,0 +1,24 @@
+---
+version: "2"
+# Configure which files to skip during linting
+run:
+  tests: false
+
+linters:
+  default: all
+
+  disable:
+    - wsl
+    - wsl_v5
+    - nlreturn
+    - depguard
+    - gochecknoinits
+    - gochecknoglobals
+    - forbidigo
+    - varnamelen
+    - exhaustruct
+    - tagliatelle
+    - noinlineerr
+    - revive
+    - ireturn
+    - misspell