sync: update 11 files from source repository (#12)

Author: mrz1836

.cursorrules

@@ -4,9 +4,9 @@
 All contributors must read `.github/AGENTS.md` for complete guidelines. If any rule here conflicts with that file, **AGENTS.md** takes precedence.
 
 ## Coding Standards
-- Format with `go fmt ./...` and `goimports -w .`.
-- Lint with `golangci-lint run` and vet with `go vet ./...`.
-- Run `go test ./...` before committing.
+- Format with `magex format:fix`.
+- Lint with `magex lint` and vet with `magex vet`.
+- Run `magex test` before committing.
 - Follow Go naming and commenting conventions described in AGENTS.md.
 
 ## Commit Messages
@@ -22,8 +22,7 @@ All contributors must read `.github/AGENTS.md` for complete guidelines. If any r
   4. **Impact / Risk**
 
 ## Dependency Management
-- Manage modules with `go mod tidy` after import changes.
-- Run `make govulncheck` to check for vulnerabilities when dependencies change.
+- Manage modules with `magex tidy` after import changes.
 
 ## Security Reporting
 - Do not open public issues for vulnerabilities.

.devcontainer.json

@@ -8,7 +8,7 @@
             ],
             "settings": {
                 "editor.codeActionsOnSave": {
-                    "source.organizeImports": true
+                    "source.organizeImports": "explicit"
                 },
                 "editor.formatOnSave": true,
                 "go.lintTool": "golangci-lint",
@@ -28,8 +28,9 @@
         "type=cache,target=/home/vscode/.cache/go-build",
         "type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock"
     ],
-    "name": "go-template dev container",
-    "postCreateCommand": "make lint && go vet ./... && go test ./...",
+    "name": "go-overlay-discovery-services dev container",
+    "postCreateCommand": "magex lint && magex vet && magex test",
+    "postStartCommand": "go install github.com/magefile/mage/cmd/magex@latest",
     "remoteUser": "vscode",
     "runArgs": [
         "--cap-drop=ALL",

.dockerignore

@@ -54,16 +54,20 @@ __pycache__/
 .LSOverride
 ._*
 
-# Custom repo notes
-todo.md
-
 # Temporary directories in the project
 bin
 tmp
-.golangci.yml
+
+# Project files not needed in the container
+.cursorrules
+.editorconfig
+.github
+.gitpod.yml
 .golangci.json
+.golangci.yml
 .goreleaser.yml
-.editorconfig
-codecov.yml
+.vscode
+docs
 LICENSE
 README.md
+codecov.yml

.github/.env.base

@@ -110,7 +110,7 @@ ARTIFACT_DOWNLOAD_CONTINUE_ON_ERROR=false   # Continue workflow execution even i
 BENCHMARK_TIMEOUT=20
 
 # Benchmark mode (Options: quick, full, normal)
-BENCHMARK_MODE=quick 
+BENCHMARK_MODE=quick
 
 # Test Execution Timeouts
 TEST_TIMEOUT=30m                       # Go test timeout for standard tests
@@ -225,7 +225,7 @@ REDIS_CACHE_FORCE_PULL=false           # Force pull Redis images even when cache
 # 🪄 MAGE-X CONFIGURATION
 # ================================================================================================
 
-MAGE_X_VERSION=v1.7.5                                         # https://github.com/mrz1836/mage-x/releases
+MAGE_X_VERSION=v1.7.6                                         # https://github.com/mrz1836/mage-x/releases
 MAGE_X_AUTO_DISCOVER_BUILD_TAGS=true                          # Enable auto-discovery of build tags
 MAGE_X_AUTO_DISCOVER_BUILD_TAGS_EXCLUDE=race,custom           # Comma-separated list of tags to exclude
 MAGE_X_FORMAT_EXCLUDE_PATHS=vendor,node_modules,.git,.idea    # Format exclusion paths (comma-separated directories to exclude from formatting)
@@ -289,7 +289,7 @@ NANCY_VERSION=v1.0.51                  # https://github.com/sonatype-nexus-commu
 # ================================================================================================
 
 # Pre-Commit System
-GO_PRE_COMMIT_VERSION=v1.3.2             # https://github.com/mrz1836/go-pre-commit
+GO_PRE_COMMIT_VERSION=v1.3.4             # https://github.com/mrz1836/go-pre-commit
 GO_PRE_COMMIT_USE_LOCAL=false            # Use local version for development
 
 # System Settings

.github/SECURITY.md

@@ -1,6 +1,6 @@
 # 🔐 Security Policy
 
-Security is a priority. We maintain a proactive stance to identify and fix vulnerabilities in **go-overlay-discovery-service**.
+Security is a priority. We maintain a proactive stance to identify and fix vulnerabilities in **go-overlay-discovery-services**.
 
 <br/>
 
@@ -73,4 +73,4 @@ To proactively protect this repository, we use several automated GitHub workflow
 - **[CodeQL Analysis](./workflows/codeql-analysis.yml)**: Scans the codebase for security vulnerabilities and coding errors using GitHub's CodeQL engine on every push and pull request to the `master` branch.
 - **[OpenSSF Scorecard](./workflows/scorecard.yml)**: Periodically evaluates the repository against OpenSSF Scorecard checks, providing insights and recommendations for improving supply chain security and best practices.
 
-These workflows help us identify, remediate, and prevent security issues as early as possible in the development lifecycle. For more details, see the workflow files in the [`.github/workflows/`](https://github.com/bsv-blockchain/go-overlay-discovery-service/tree/master/.github/workflows) directory.
+These workflows help us identify, remediate, and prevent security issues as early as possible in the development lifecycle. For more details, see the workflow files in the [`.github/workflows/`](https://github.com/bsv-blockchain/go-overlay-discovery-services/tree/master/.github/workflows) directory.

.github/SUPPORT.md

@@ -1,23 +1,23 @@
 # 🛟 Support Guide
 
-Need help with **go-overlay-discovery-service**? You're in the right place. Here’s how to get support, report issues, and stay aligned with project guidelines.
+Need help with **go-overlay-discovery-services**? You're in the right place. Here’s how to get support, report issues, and stay aligned with project guidelines.
 
 <br/>
 
 ## 💬 Questions & Discussion
 
 Before asking, check the existing threads:
 
-* 🔍 Search [Issues](https://github.com/bsv-blockchain/go-overlay-discovery-service/issues) or [Pull Requests](https://github.com/bsv-blockchain/go-overlay-discovery-service/pulls?q=is%3Apr+is%3Aopen+is%3Aclosed)
-* 🆕 Can’t find what you need? Start a [new issue](https://github.com/bsv-blockchain/go-overlay-discovery-service/issues/new?template=question.yml).
+* 🔍 Search [Issues](https://github.com/bsv-blockchain/go-overlay-discovery-services/issues) or [Pull Requests](https://github.com/bsv-blockchain/go-overlay-discovery-services/pulls?q=is%3Apr+is%3Aopen+is%3Aclosed)
+* 🆕 Can’t find what you need? Start a [new issue](https://github.com/bsv-blockchain/go-overlay-discovery-services/issues/new?template=question.yml).
 
 <br/>
 
 ## 🐞 Reporting Issues
 
 Found a bug?
 
-1. Check the [issue tracker](https://github.com/bsv-blockchain/go-overlay-discovery-service/issues) to avoid duplicates.
+1. Check the [issue tracker](https://github.com/bsv-blockchain/go-overlay-discovery-services/issues) to avoid duplicates.
 2. If it’s new, open an issue with:
 
 	* Clear steps to reproduce

.gitpod.yml

@@ -1,35 +1,54 @@
-# Gitpod workspace configuration for the local development environment.
-# This file creates a repeatable cloud development environment.
-# It ensures dependencies are installed and the codebase is vetted
-# and tested on workspace start.
+# Gitpod workspace configuration for go-overlay-discovery-services
+# Uses magex for build automation and development tasks
+# This creates a one-click development environment for contributors
 
-image:
-  name: gitpod/workspace-full:1.0.0
+image: gitpod/workspace-go:latest
 
 tasks:
   - name: setup-and-test
     init: |
-      echo "Downloading Go modules..."
-      go mod download
-      go mod tidy
-      # Install goimports if not present
-      if ! command -v goimports >/dev/null; then
-        go install golang.org/x/tools/cmd/goimports@latest
-      fi
-      go fmt ./...
-      goimports -w .
-      golangci-lint run
-      go vet ./...
+      echo "🚀 Setting up go-overlay-discovery-services development environment..."
+      echo "📦 Installing MAGE-X build tool..."
+      go install github.com/mrz1836/mage-x/cmd/magex@latest
+
+      echo "📥 Downloading dependencies..."
+      magex deps:download
+
+      echo "🔧 Initial build..."
+      magex build
+
+      echo "✅ Running initial tests..."
+      magex test
+
     command: |
-      go test ./...
+      echo "==============================================="
+      echo "🎯 Welcome to go-overlay-discovery-services development!"
+      echo "==============================================="
+      echo ""
+      echo "🛠️  Available magex commands:"
+      echo "  magex test       - Run all tests"
+      echo "  magex lint       - Run linters"
+      echo "  magex format:fix - Format the code"
+      echo "  magex build      - Build the project"
+      echo "  magex help       - List all available commands"
+      echo ""
+      echo "📖 Quick start:"
+      echo "  1. Try: magex test"
+      echo "  2. Make your changes"
+      echo "  3. Run: magex format:fix && magex lint && magex test"
+      echo "  4. Commit and push your changes"
+      echo ""
+      echo "💡 For more help: magex help"
+      echo "==============================================="
 
 ports:
   - port: 8080
-    onOpen: open-preview
-    description: Application
+    onOpen: ignore
+    description: Application (if needed)
 
 vscode:
   extensions:
     - golang.go
     - github.vscode-pull-request-github
     - streetsidesoftware.code-spell-checker
+    - eamodio.gitlens

.goreleaser.yml

@@ -6,14 +6,20 @@ version: 2
 
 before:
   hooks:
-    - make test
+    - |
+      sh -c '
+        if [ "$SKIP_GORELEASER_TESTS" = "true" ]; then
+          echo "Skipping tests (SKIP_GORELEASER_TESTS=true)"
+        else
+          magex test
+        fi
+      '
 changelog:
   sort: asc
   filters:
     exclude:
-      - '^.github:'
-      - '^.vscode:'
-      - '^test:'
+      - "^.vscode:"
+      - "^test:"
 
 # ---------------------------
 # Builder
@@ -27,6 +33,24 @@ builds:
       - darwin
     skip: true
 
+# ---------------------------
+# Archives
+# ---------------------------
+archives:
+  - id: go-overlay-discovery-services
+    name_template: >-
+      {{- .ProjectName }}_{{- .Version }}_{{- .Os }}_{{- .Arch }}
+    files:
+      - LICENSE
+      - README.md
+
+# ---------------------------
+# Checksum
+# ---------------------------
+checksum:
+  name_template: "{{ .ProjectName }}_{{ .Version }}_checksums.txt"
+  algorithm: sha256
+
 # ---------------------------
 # Github Release
 # ---------------------------
@@ -38,31 +62,30 @@ release:
 # Announce
 # ---------------------------
 announce:
-
   # See more at: https://goreleaser.com/customization/announce/#slack
   slack:
     enabled: false
-    message_template: '{{ .ProjectName }} {{ .Tag }} is out! Changelog: https://github.com/bsv-blockchain/{{ .ProjectName }}/releases/tag/{{ .Tag }}'
-    channel: '#test_slack'
+    message_template: "{{ .ProjectName }} {{ .Tag }} is out! Changelog: https://github.com/{{ .GitOwner }}/{{ .ProjectName }}/releases/tag/{{ .Tag }}"
+    channel: "#test_slack"
     # username: ''
     # icon_emoji: ''
     # icon_url: ''
 
   # See more at: https://goreleaser.com/customization/announce/#twitter
   twitter:
     enabled: false
-    message_template: '{{ .ProjectName }} {{ .Tag }} is out!'
+    message_template: "{{ .ProjectName }} {{ .Tag }} is out!"
 
   # See more at: https://goreleaser.com/customization/announce/#discord
   discord:
     enabled: false
-    message_template: '{{ .ProjectName }} {{ .Tag }} is out!'
+    message_template: "{{ .ProjectName }} {{ .Tag }} is out!"
     # Defaults to `GoReleaser`
-    author: ''
+    author: ""
     # Defaults to `3888754` - the grey-ish from goreleaser
-    color: ''
+    color: ""
     # Defaults to `https://goreleaser.com/static/avatar.png`
-    icon_url: ''
+    icon_url: ""
 
   # See more at: https://goreleaser.com/customization/announce/#reddit
   reddit:
@@ -72,6 +95,6 @@ announce:
     # Username for your Reddit account
     username: ""
     # Defaults to `{{ .GitURL }}/releases/tag/{{ .Tag }}`
-    # url_template: 'https://github.com/bsv-blockchain/{{ .ProjectName }}/releases/tag/{{ .Tag }}'
+    # url_template: 'https://github.com/{{ .GitOwner }}/{{ .ProjectName }}/releases/tag/{{ .Tag }}'
     # Defaults to `{{ .ProjectName }} {{ .Tag }} is out!`
-    title_template: '{{ .ProjectName }} {{ .Tag }} is out!'
+    title_template: "{{ .ProjectName }} {{ .Tag }} is out!"

.vscode/settings.json

@@ -80,7 +80,7 @@
             "-.mage-cache"
         ],
         "formatting.gofumpt": true,
-        "formatting.local": "github.com/bsv-blockchain/go-overlay-discovery-service",
+        "formatting.local": "github.com/bsv-blockchain/go-overlay-discovery-services",
         "symbolMatcher": "fastfuzzy",
         "symbolStyle": "full",
         "ui.completion.completeFunctionCalls": true,

.vscode/tasks.json

@@ -526,7 +526,7 @@
             "command": "go-pre-commit install",
             "detail": "Install go-pre-commit hooks",
             "group": "none",
-            "label": "pre-commit: install",
+            "label": "go-pre-commit: install",
             "presentation": {
                 "clear": true,
                 "focus": false,
@@ -540,7 +540,7 @@
             "command": "go-pre-commit run --all-files",
             "detail": "Run pre-commit hooks on all files",
             "group": "none",
-            "label": "pre-commit: run",
+            "label": "go-pre-commit: run",
             "presentation": {
                 "clear": true,
                 "focus": false,