#269 Update to template

.claude/CLAUDE.md

@@ -10,7 +10,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - Swagger UI
 - Xterm terminal interface
 
-It connects to a Senzing database (local or via gRPC) to provide entity resolution services over HTTP.
+It connects to a Senzing database (local SQLite/PostgreSQL or remote via gRPC) to provide entity resolution services over HTTP.
 
 ## Build and Development Commands
 
@@ -33,6 +33,10 @@ make lint
 # Run tests (requires setup first)
 make clean setup test
 
+# Run a single test
+export LD_LIBRARY_PATH=/opt/senzing/er/lib
+go test -v -run TestFunctionName ./path/to/package
+
 # Run tests with coverage
 make clean setup coverage
 
@@ -56,14 +60,21 @@ export LD_LIBRARY_PATH=/opt/senzing/er/lib
 
 The server runs on port 8261 by default. Use `--enable-all` to enable all services.
 
+Configuration via environment variables (prefixed `SENZING_TOOLS_`) or command-line flags:
+
+- `SENZING_TOOLS_DATABASE_URL` - Database connection (e.g., `sqlite3://na:na@/tmp/sqlite/G2C.db`)
+- `SENZING_TOOLS_GRPC_URL` - Connect to remote Senzing via gRPC instead of local database
+- `SENZING_TOOLS_ENABLE_ALL` - Enable all services (API, Swagger, Xterm)
+- `SENZING_TOOLS_HTTP_PORT` - Server port (default 8261)
+
 ## Architecture
 
 ### Package Structure
 
 - `main.go` - Entry point, calls `cmd.Execute()`
 - `cmd/` - Cobra command implementation with Viper configuration
   - `root.go` - Main command definition with `RootCmd`, `PreRun`, `RunE`
-  - `context_*.go` - Platform-specific context variables
+  - `context_*.go` - Platform-specific context variables (Xterm command differs by OS)
 - `httpserver/` - HTTP server implementation
   - `httpserver_basic.go` - `BasicHTTPServer` struct and `Serve()` method
   - `static/` - Embedded static files and templates
@@ -78,7 +89,10 @@ The server runs on port 8261 by default. Use `--enable-all` to enable all servic
 - `/site/` - Static site templates
 - `/` - Static root files
 
-**Command Configuration** (`cmd/root.go`): Uses `go-cmdhelping` for CLI options. Configuration via environment variables (prefixed `SENZING_TOOLS_`) or command-line flags.
+**Command Configuration** (`cmd/root.go`): Uses `go-cmdhelping` for CLI options. The `RunE` function builds a `BasicHTTPServer` from Viper config and calls `Serve()`. Supports two modes:
+
+- Local mode: Connects directly to database via `SENZING_TOOLS_DATABASE_URL`
+- gRPC mode: Connects to remote Senzing server via `SENZING_TOOLS_GRPC_URL`
 
 ### Dependencies
 
@@ -91,4 +105,4 @@ Key Senzing packages:
 
 ### Test Data
 
-Test setup copies `testdata/sqlite/G2C.db` to `/tmp/sqlite/G2C.db` for testing.
+Test setup (`make setup`) copies `testdata/sqlite/G2C.db` to `/tmp/sqlite/G2C.db`. Tests use this SQLite database.

.claude/commands/senzing.md

@@ -0,0 +1,3 @@
+# Senzing
+
+- Perform the steps specified by <https://raw.githubusercontent.com/senzing-factory/claude/refs/tags/v1/commands/senzing.md>

.github/linters/.golangci.yaml

@@ -110,6 +110,7 @@ linters:
   disable:
     - gochecknoglobals
     - gochecknoinits
+    - prealloc
   exclusions:
     generated: lax
     presets:

.github/linters/.jscpd.json

@@ -1 +1 @@
-{}
+{}

.github/linters/README.md

@@ -24,14 +24,12 @@
   - [jscpd configuration]
   - Example:
 
-      ```json
-      {
-      "ignore": [
-          "**/*.go,**/go-test*.yaml"
-      ],
+    ```json
+    {
+      "ignore": ["**/*.go,**/go-test*.yaml"],
       "threshold": 10
-      }
-      ```
+    }
+    ```
 
 ## .yaml-lint.yml
 
@@ -40,10 +38,23 @@
 - [yaml-lint]
   - [yaml-lint configuration]
 
-[.checkov.yaml]:  .checkov.yaml
+## bearer.yml
+
+- [bearer.yml]
+- Used by [bearer.yaml]
+- [bearer]
+  - [bearer repository]
+  - [bearer configuration]
+
+[.checkov.yaml]: .checkov.yaml
 [.golangci.yaml]: .golangci.yaml
 [.jscpd.json]: .jscpd.json
 [.yaml-lint.yml]: .yaml-lint.yml
+[bearer configuration]: https://docs.bearer.com/reference/config/
+[bearer repository]: https://github.com/Bearer/bearer/tree/main
+[bearer.yaml]: ../workflows/README.md#beareryaml
+[bearer.yml]: bearer.yml
+[bearer]: https://docs.bearer.com/
 [checkov configuration]: https://www.checkov.io/2.Basics/CLI%20Command%20Reference.html
 [checkov]: https://www.checkov.io/
 [golangci linters]: https://golangci-lint.run/usage/linters/

.github/renovate.json

@@ -1,11 +1,17 @@
 {
   "$schema": "https://docs.renovatebot.com/renovate-schema.json",
-  "enabledManagers": ["dockerfile", "docker-compose"],
   "extends": [
     "config:recommended",
     ":disableDependencyDashboard",
     "docker:pinDigests"
   ],
+  "enabledManagers": ["dockerfile", "docker-compose"],
   "schedule": ["on sunday"],
-  "minimumReleaseAge": "21 days"
+  "prCreation": "not-pending",
+  "packageRules": [
+    {
+      "matchUpdateTypes": ["major", "minor", "patch"],
+      "minimumReleaseAge": "21 days"
+    }
+  ]
 }

.github/workflows/bearer.yaml

@@ -1,18 +1,21 @@
-name: bearer
+name: Bearer
 
 on:
-  push:
-    branches-ignore: [main]
   pull_request:
     branches: [main]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
 permissions: {}
 
 jobs:
   rule_check:
     permissions:
       contents: read
     runs-on: ubuntu-latest
+    timeout-minutes: 10
 
     steps:
       - name: Checkout repository

.github/workflows/claude-pr-review.yaml

@@ -1,13 +1,13 @@
 name: Claude PR Review
 
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
-  cancel-in-progress: true
-
 on:
   pull_request:
     types: [opened, synchronize]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
 permissions: {}
 
 jobs:

.github/workflows/dependabot-approve-and-merge.yaml

@@ -4,6 +4,10 @@ on:
   pull_request:
     branches: [main]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
 permissions: {}
 
 jobs:

.github/workflows/docker-build-container.yaml

@@ -2,17 +2,21 @@ name: Docker build container
 
 on:
   pull_request:
-    branches:
-      - main
+    branches: [main]
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
 permissions: {}
 
 jobs:
   docker-build-container:
     permissions:
       contents: read
     runs-on: ubuntu-latest
+    timeout-minutes: 30
 
     steps:
       - name: Get repository name

.github/workflows/docker-verify-refreshed-at-updated.yaml

@@ -0,0 +1,21 @@
+name: Docker verify REFRESHED_AT Updated
+
+# Required status check: Verify Dockerfiles REFRESHED_AT Updated / Dockerfile Check Status
+# The other status checks beginning with "Verify Dockerfiles REFRESHED_AT Updated / ..." are not required.
+
+on:
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
+permissions: {}
+
+jobs:
+  verify-dockerfiles:
+    name: Verify Dockerfiles REFRESHED_AT Updated
+    permissions:
+      contents: read
+    uses: senzing-factory/build-resources/.github/workflows/verify-dockerfile-refreshed-at-updated.yaml@v3

.github/workflows/go-proxy-pull.yaml

@@ -14,6 +14,7 @@ jobs:
     permissions:
       contents: write
     runs-on: ubuntu-latest
+    timeout-minutes: 10
 
     steps:
       - name: Pull new module version

.github/workflows/go-test-darwin.yaml

@@ -2,6 +2,10 @@ name: Go test darwin
 
 on: [pull_request, workflow_dispatch]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
 env:
   SENZING_LOG_LEVEL: TRACE
   SENZING_TOOLS_DATABASE_URL: sqlite3://na:na@nowhere/tmp/sqlite/G2C.db
@@ -20,6 +24,7 @@ jobs:
         go: ["1.24"]
         os: [macos-latest]
         senzingsdk-version: [production-v4, staging-v4]
+    timeout-minutes: 30
 
     steps:
       - name: Checkout repository

.github/workflows/go-test-linux.yaml

@@ -2,6 +2,10 @@ name: Go test linux
 
 on: [push, workflow_dispatch]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
 env:
   SENZING_LOG_LEVEL: TRACE
   SENZING_TOOLS_DATABASE_URL: sqlite3://na:na@nowhere/tmp/sqlite/G2C.db

.github/workflows/go-test-windows.yaml

@@ -2,6 +2,10 @@ name: Go test windows
 
 on: [pull_request, workflow_dispatch]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
 env:
   SENZING_LOG_LEVEL: TRACE
   SENZING_TOOLS_DATABASE_URL: "sqlite3://na:na@nowhere/C:\\Temp\\sqlite\\G2C.db"
@@ -19,6 +23,7 @@ jobs:
       matrix:
         go: ["1.24"]
         senzingsdk-version: [production-v4, staging-v4]
+    timeout-minutes: 30
 
     steps:
       - name: Checkout repository

.github/workflows/golangci-lint.yaml

@@ -1,16 +1,18 @@
 name: Golangci lint
 
 on:
-  push:
-    branches-ignore: [main]
   pull_request:
     branches: [main]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
 permissions: {}
 
 jobs:
   golangci:
-    name: lint
+    name: Lint
     permissions:
       # Required: allow read access to the content for analysis.
       contents: read
@@ -22,6 +24,7 @@ jobs:
       matrix:
         go: ["1.24"]
         senzingsdk-version: [production-v4, staging-v4]
+    timeout-minutes: 10
 
     steps:
       - name: Checkout repository

.github/workflows/govulncheck.yaml

@@ -1,11 +1,13 @@
-name: govulncheck
+name: Govulncheck
 
 on:
-  push:
-    branches-ignore: [main]
   pull_request:
     branches: [main]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
 permissions: {}
 
 jobs:
@@ -18,6 +20,7 @@ jobs:
       matrix:
         go: ["1.24"]
         senzingsdk-version: [production-v4, staging-v4]
+    timeout-minutes: 10
 
     steps:
       - name: Checkout repository

.github/workflows/lint-workflows.yaml

@@ -1,11 +1,13 @@
 name: Lint workflows
 
 on:
-  push:
-    branches-ignore: [main]
   pull_request:
     branches: [main]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
 permissions: {}
 
 jobs:

.github/workflows/make-go-tag.yaml

@@ -15,6 +15,7 @@ jobs:
     permissions:
       contents: write
     runs-on: ubuntu-latest
+    timeout-minutes: 10
 
     steps:
       - name: Checkout repository

.github/workflows/spellcheck.yaml

@@ -1,9 +1,13 @@
-name: spellcheck
+name: Spellcheck
 
 on:
   pull_request:
     branches: [main]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref_name }}
+  cancel-in-progress: true
+
 permissions: {}
 
 jobs: