Bump github.com/senzing-garage/go-cmdhelping from 0.2.2 to 0.2.3

.github/coverage/README.md

@@ -0,0 +1,20 @@
+# Coverage
+
+## testcoverage.yaml
+
+- [testcoverage.yaml]
+- Used by `coverage:` in
+  - [go-test-darwin.yaml]
+  - [go-test-linux.yaml]
+  - [go-test-windows.yaml]
+- [go-test-coverage]
+  - [go-test-coverage configuration]
+  - [go-test-coverage badge]
+
+[go-test-darwin.yaml]: ../workflows/README.md#go-test-darwinyaml
+[go-test-linux.yaml]: ../workflows/README.md#go-test-linuxyaml
+[go-test-windows.yaml]: ../workflows/README.md#go-test-windowsyaml
+[testcoverage.yaml]: testcoverage.yaml
+[go-test-coverage]: https://github.com/vladopajic/go-test-coverage
+[go-test-coverage configuration]: https://github.com/vladopajic/go-test-coverage?tab=readme-ov-file#config
+[go-test-coverage badge]: https://github.com/vladopajic/go-test-coverage/blob/main/docs/badge.md

.github/coverage/testcoverage-darwin.yaml

@@ -0,0 +1,49 @@
+# (mandatory)
+# Path to coverprofile file (output of `go test -coverprofile` command).
+#
+# For cases where there are many coverage profiles, such as when running
+# unit tests and integration tests separately, you can combine all those
+# profiles into one. In this case, the profile should have a comma-separated list
+# of profile files, e.g., 'cover_unit.out,cover_integration.out'.
+profile: cover.out
+
+# (optional; but recommended to set)
+# When specified reported file paths will not contain local prefix in the output
+local-prefix: "github.com/org/project"
+
+# Holds coverage thresholds percentages, values should be in range [0-100]
+threshold:
+  # (optional; default 0)
+  # The minimum coverage that each file should have
+  file: 50
+
+  # (optional; default 0)
+  # The minimum coverage that each package should have
+  package: 50
+
+  # (optional; default 0)
+  # The minimum total coverage project should have
+  total: 50
+# Holds regexp rules which will override thresholds for matched files or packages
+# using their paths.
+#
+# First rule from this list that matches file or package is going to apply
+# new threshold to it. If project has multiple rules that match same path,
+# override rules should be listed in order from specific to more general rules.
+#override:
+# Increase coverage threshold to 100% for `foo` package
+# (default is 80, as configured above in this example)
+#- threshold: 100
+#  path: ^pkg/lib/foo$
+
+# Holds regexp rules which will exclude matched files or packages
+# from coverage statistics
+#exclude:
+# Exclude files or packages matching their paths
+#paths:
+#  - \.pb\.go$    # excludes all protobuf generated files
+#  - ^pkg/bar     # exclude package `pkg/bar`
+
+# NOTES:
+# - symbol `/` in all path regexps will be replaced by current OS file path separator
+#   to properly work on Windows

.github/coverage/testcoverage.yaml

@@ -44,25 +44,6 @@ threshold:
 #  - \.pb\.go$    # excludes all protobuf generated files
 #  - ^pkg/bar     # exclude package `pkg/bar`
 
-exclude:
-  paths:
-    - senzingchatapi/oas_cfg_gen.go
-    - senzingchatapi/oas_client_gen.go
-    - senzingchatapi/oas_handlers_gen.go
-    - senzingchatapi/oas_interfaces_gen.go
-    - senzingchatapi/oas_json_gen.go
-    - senzingchatapi/oas_labeler_gen.go
-    - senzingchatapi/oas_middleware_gen.go
-    - senzingchatapi/oas_parameters_gen.go
-    - senzingchatapi/oas_request_decoders_gen.go
-    - senzingchatapi/oas_request_encoders_gen.go
-    - senzingchatapi/oas_response_decoders_gen.go
-    - senzingchatapi/oas_response_encoders_gen.go
-    - senzingchatapi/oas_router_gen.go
-    - senzingchatapi/oas_schemas_gen.go
-    - senzingchatapi/oas_server_gen.go
-    - senzingchatapi/oas_unimplemented_gen.go
-    - senzingchatapi/oas_validators_gen.go
 # NOTES:
 # - symbol `/` in all path regexps will be replaced by current OS file path separator
 #   to properly work on Windows

.github/linters/.checkov.yaml

@@ -1,2 +1,3 @@
 quiet: true
-skip-check: CKV_DOCKER_7
+skip-check:
+  - CKV_DOCKER_7

.github/linters/.golangci.yml → .github/linters/.golangci.yaml

@@ -1,9 +1,10 @@
 run:
   modules-download-mode: readonly
-  show-stats: true
+  timeout: 10m
 
 output:
   print-linter-name: false
+  show-stats: true
   sort-results: true
 
 linters:

.github/linters/.jscpd.json

@@ -1,6 +1 @@
-{
-  "ignore": [
-    "**/*.go,**/go-test*.yaml"
-  ],
-  "threshold": 20
-}
+{}

.github/linters/README.md

@@ -0,0 +1,54 @@
+# Linters
+
+## .checkov.yaml
+
+- [.checkov.yaml]
+- Used by [lint-workflows.yaml]
+- [checkov]
+  - [checkov configuration]
+
+## .golangci.yaml
+
+- [.golangci.yaml]
+- Used by [golangci-lint.yaml]
+- [golangci-lint]
+  - [golangci-lint configuration]
+
+## .jscpd.json
+
+- [.jscpd.json]
+- Used by [lint-workflows.yaml]
+- [jscpd]
+  - [jscpd configuration]
+  - Example:
+
+      ```json
+      {
+      "ignore": [
+          "**/*.go,**/go-test*.yaml"
+      ],
+      "threshold": 10
+      }
+      ```
+
+## .yaml-lint.yml
+
+- [.yaml-lint.yml]
+- Used by [lint-workflows.yaml]
+- [yaml-lint]
+  - [yaml-lint configuration]
+
+[.checkov.yaml]:  .checkov.yaml
+[.golangci.yaml]: .golangci.yaml
+[.jscpd.json]: .jscpd.json
+[.yaml-lint.yml]: .yaml-lint.yml
+[checkov configuration]: https://www.checkov.io/2.Basics/CLI%20Command%20Reference.html
+[checkov]: https://www.checkov.io/
+[golangci-lint configuration]: https://golangci-lint.run/usage/configuration/
+[golangci-lint.yaml]: ../workflows/README.md#golangci-lintyaml
+[golangci-lint]: https://golangci-lint.run/
+[jscpd configuration]: https://github.com/kucherenko/jscpd/tree/master/apps/jscpd#options
+[jscpd]: https://github.com/kucherenko/jscpd
+[lint-workflows.yaml]: ../workflows/README.md#lint-workflowsyaml
+[yaml-lint configuration]: https://yamllint.readthedocs.io/en/stable/configuration.html
+[yaml-lint]: https://github.com/adrienverge/yamllint

.github/workflows/README.md

@@ -0,0 +1,205 @@
+# Workflows
+
+## add-labels-standardized.yaml
+
+When issues are opened,
+this action adds appropriate labels to the issue.
+(e.g. "triage", "customer-submission")
+
+- [Add Labels Standardized GitHub action]
+  - Uses: [senzing-factory/build-resources/.../add-labels-to-issue.yaml]
+
+## add-to-project-garage-dependabot.yaml
+
+When a Dependabot Pull Request (PR) is made against `main` branch,
+this action adds the PR to the "Garage" project board as "In Progress".
+
+- [Add to Project Garage Dependabot GitHub action]
+  - Uses: [senzing-factory/build-resources/.../add-to-project-dependabot.yaml]
+
+## add-to-project-garage.yaml
+
+When an issue is created,
+this action adds the issue to the "Garage" board as "Backlog".
+
+- [Add to Project Garage GitHub action]
+  - Uses: [senzing-factory/build-resources/.../add-to-project.yaml]
+
+## dependabot-approve-and-merge.yaml
+
+When a Dependabot Pull Request (PR) is made against the `main` branch,
+this action determines if it should be automatically approved and merged into the `main` branch.
+Once this action occurs [move-pr-to-done-dependabot.yaml] moves the PR on the "Garage" project board to "Done".
+
+- [Dependabot Approve and Merge GitHub action]
+  - Uses: [senzing-factory/build-resources/.../dependabot-approve-and-merge.yaml]
+
+## docker-build-container.yaml
+
+When a Pull Request is made against the `main` branch,
+this action verifies that the `Dockerfile` can be successfully built.
+
+*Note:* The Docker image is **not** pushed to [DockerHub].
+
+- [Docker Build Container GitHub action]
+  - Uses: [senzing-factory/github-action-docker-buildx-build]
+
+## docker-push-containers-to-dockerhub.yaml
+
+After a [Semantic Version] release is created,
+this action builds Docker images on multiple architectures and pushes the Docker images to [DockerHub].
+
+- [Docker Push Containers to DockerHub GitHub action]
+  - Uses: [senzing-factory/github-action-docker-buildx-build]
+
+## golangci-lint.yaml
+
+When a change is committed to GitHub or a Pull Request is made against the `main` branch,
+this action runs [golangci-lint] to run multiple linters against the code.
+
+- [Golangci Lint GitHub action]
+  - Configuration:
+    - [.golangci.yaml]
+  - Uses:
+    - [actions/checkout]
+    - [senzing-factory/github-action-install-senzing-api]
+    - [actions/setup-go]
+    - [golangci/golangci-lint-action]
+
+## go-proxy-pull.yaml
+
+After a [Semantic Version] release is created,
+this action expedites the Go publishing process.
+
+- [Go Proxy Pull GitHub action]
+  - Uses: [andrewslotin/go-proxy-pull-action]
+
+## go-test-darwin.yaml
+
+When a Pull Request is made against the `main` branch,
+this action runs `go test` with coverage testing on macOS.
+
+- [Go Test Darwin GitHub action]
+  - Configuration: [testcoverage.yaml]
+  - Uses:
+    - [actions/checkout]
+    - [actions/setup-go]
+    - [gotesttools/gotestfmt-action]
+    - [senzing-factory/github-action-install-senzing-api]
+    - [actions/upload-artifact]
+    - [senzing-factory/build-resources/.../go-coverage.yaml]
+
+## go-test-linux.yaml
+
+When a change is committed to GitHub or a Pull Request is made against the `main` branch,
+this action runs `go test` with coverage testing on Linux.
+
+- [Go Test Linux GitHub action]
+  - Configuration: [testcoverage.yaml]
+  - Uses:
+    - [actions/checkout]
+    - [actions/setup-go]
+    - [gotesttools/gotestfmt-action]
+    - [senzing-factory/github-action-install-senzing-api]
+    - [actions/upload-artifact]
+    - [senzing-factory/build-resources/.../go-coverage.yaml]
+
+## go-test-windows.yaml
+
+When a Pull Request is made against the `main` branch,
+this action runs `go test` with coverage testing on Windows.
+
+- [Go Test Windows GitHub action]
+  - Configuration: [testcoverage.yaml]
+  - Uses:
+    - [actions/checkout]
+    - [actions/setup-go]
+    - [gotesttools/gotestfmt-action]
+    - [senzing-factory/github-action-install-senzing-api]
+    - [actions/upload-artifact]
+    - [senzing-factory/build-resources/.../go-coverage.yaml]
+
+## lint-workflows.yaml
+
+When a change is committed to GitHub or a Pull Request is made against the `main` branch,
+this action runs [super-linter] to run multiple linters against the code.
+
+- [Lint Workflows GitHub action]
+  - Configuration:
+    - [.checkov.yaml]
+    - [.jscpd.json]
+    - [.yaml-lint.yml]
+  - Uses: [senzing-factory/build-resources/.../lint-workflows.yaml]
+
+## make-go-github-file.yaml
+
+After a [Semantic Version] release is created,
+this action creates a Pull Request for an updated [github.go] file
+for the **next** Semantic Version release by increasing the Semantic Version's Patch value.
+
+- [Make Go GitHub File GitHub action]
+  - Uses: [senzing-factory/build-resources/.../make-go-github-file.yaml]
+
+## make-go-tag.yaml
+
+After a [Semantic Version] release is created,
+this action creates a tag in the form `vM.m.P` using the SHA of the `M.m.P` release.
+The `v` prefix is standard usage in [Go].
+
+- [Make Go Tag GitHub action]
+  - Uses:
+    - [actions/checkout]
+    - [senzing-factory/github-action-make-go-tag]
+
+## move-pr-to-done-dependabot.yaml
+
+When a Pull Request is merged into the `main` branch,
+this action moves the PR on the "Garage" project board to "Done".
+
+- [Move PR to Done Dependabot GitHub action]
+  - Uses: [senzing-factory/build-resources/.../move-pr-to-done-dependabot.yaml]
+
+[.checkov.yaml]:  ../linters/README.md#checkovyaml
+[.golangci.yaml]: ../linters/README.md#golangciyaml
+[.jscpd.json]: ../linters/README.md#jscpdjson
+[.yaml-lint.yml]: ../linters/README.md#yaml-lintyml
+[actions/checkout]: https://github.com/actions/checkout
+[actions/setup-go]: https://github.com/actions/setup-go
+[actions/upload-artifact]: https://github.com/actions/upload-artifact
+[Add Labels Standardized GitHub action]: add-labels-standardized.yaml
+[Add to Project Garage Dependabot GitHub action]: add-to-project-garage-dependabot.yaml
+[Add to Project Garage GitHub action]: add-to-project-garage.yaml
+[andrewslotin/go-proxy-pull-action]: https://github.com/andrewslotin/go-proxy-pull-action
+[Dependabot Approve and Merge GitHub action]: dependabot-approve-and-merge.yaml
+[Docker Build Container GitHub action]: docker-build-container.yaml
+[Docker Push Containers to DockerHub GitHub action]: docker-push-containers-to-dockerhub.yaml
+[DockerHub]: https://hub.docker.com/
+[github.go]: ../../cmd/github.go
+[Go Proxy Pull GitHub action]: go-proxy-pull.yaml
+[Go Test Darwin GitHub action]: go-test-darwin.yaml
+[Go Test Linux GitHub action]: go-test-linux.yaml
+[Go Test Windows GitHub action]: go-test-windows.yaml
+[Go]: https://go.dev/
+[Golangci Lint GitHub action]: golangci-lint.yaml
+[golangci-lint]: https://github.com/golangci/golangci-lint
+[golangci/golangci-lint-action]: https://github.com/golangci/golangci-lint-action
+[gotesttools/gotestfmt-action]: https://github.com/gotesttools/gotestfmt-action
+[Lint Workflows GitHub action]: lint-workflows.yaml
+[Make Go GitHub File GitHub action]: make-go-github-file.yaml
+[Make Go Tag GitHub action]: make-go-tag.yaml
+[Move PR to Done Dependabot GitHub action]: move-pr-to-done-dependabot.yaml
+[move-pr-to-done-dependabot.yaml]: move-pr-to-done-dependabotyaml
+[Semantic Version]: https://semver.org/
+[senzing-factory/build-resources/.../add-labels-to-issue.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/add-labels-to-issue.yaml
+[senzing-factory/build-resources/.../add-to-project-dependabot.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/add-to-project-dependabot.yaml
+[senzing-factory/build-resources/.../add-to-project.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/add-to-project.yaml
+[senzing-factory/build-resources/.../dependabot-approve-and-merge.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/dependabot-approve-and-merge.yaml
+[senzing-factory/build-resources/.../go-coverage.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/go-coverage.yaml
+[senzing-factory/build-resources/.../lint-workflows.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/lint-workflows.yaml
+[senzing-factory/build-resources/.../make-go-github-file.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/make-go-github-file.yaml
+[senzing-factory/build-resources/.../move-pr-to-done-dependabot.yaml]: https://github.com/senzing-factory/build-resources/blob/main/.github/workflows/move-pr-to-done-dependabot.yaml
+[senzing-factory/github-action-docker-buildx-build]: https://github.com/senzing-factory/github-action-docker-buildx-build
+[senzing-factory/github-action-install-senzing-api]: https://github.com/senzing-factory/github-action-install-senzing-api
+[senzing-factory/github-action-make-go-tag]: https://github.com/senzing-factory/github-action-make-go-tag
+[super-linter]: https://github.com/super-linter/super-linter
+[testcoverage.yaml]:  ../coverage/README.md#testcoverageyaml

.github/workflows/add-labels-standardized.yaml

@@ -1,4 +1,4 @@
-name: add labels standardized
+name: Add labels standardized
 
 on:
   issues:

.github/workflows/add-to-project-garage-dependabot.yaml

@@ -1,4 +1,4 @@
-name: add to project garage dependabot
+name: Add to project garage dependabot
 
 on:
   pull_request: