refactor(ci): standardize workflows and unify copyright notices (#17)

## Description

- **CI/CD Workflow Restructuring & Standardization**:
  - Redesigned and documented GitHub Action workflows (`pipeline-development.yml`, `pipeline-main.yml`, `pipeline-nightly.yml`, `pipeline-release.yml`, `pipeline-weekly.yml`, `util-cleanup.yml`, `util-pr-comment.yml`) with visual ASCII architecture maps outlining job dependencies.
  - Streamlined stage synchronization by introducing dedicated gate jobs (`build-gate` and `e2e-gate`) to coordinate build steps and test execution blocks.
  - Parameterized Python environments dynamically across matrix test runs using outputs from initialization gating (`init-gate.outputs.default_python`, `init-gate.outputs.full_matrix`), avoiding hardcoded values.
  - Added new development configurations including `.devcontainer/devcontainer.json` and `.github/pipeline-config.json`.
- **Copyright & License Header Alignment**:
  - Ensured consistent presence of the Apache 2.0 license notice block in root files (e.g. `pyproject.toml`, `README.md`, `CONTRIBUTING.md`, `DEVELOPING.md`), `.github/` configurations, and `.devcontainer/` folder assets.
  - Standardized directory-level boundaries by adding/maintaining the copyright block on directory boundary files (`README.md`, `__init__.py`, `conftest.py`, `docs/index.md`) across primary directories (`tests/`, `src/`, `scripts/`, `examples/`, `docs/`).
  - Stripped redundant boilerplate notices from nested implementation files, utility scripts, and unit/integration tests to keep inner files clean and focused.

## Type of Change

- [x] Bug fix (non-breaking change which fixes an issue)
- [x] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [x] Documentation update (changes to `README.md`, `SUPPORT.md`, docstrings, etc.)
- [x] Maintenance/Refactoring (non-breaking change that improves code structure or quality)

## Test Plan

- **Automated Functional Verification**:
  - Ran the functional unit and integration test suite via Hatch to ensure that all core logic, plugins, and configurations remain healthy:
    ```bash
    .venv/bin/hatch run python:tests-func
    ```
    - **Result:** `758 passed, 1 warning in 55.17s`

## Related Issues

- Fixes #None

## Screenshots / Visuals (if applicable)

N/A

## Use of AI

- [x] Includes AI-assisted code completion
- [x] Includes code generated by an AI application
- [ ] Includes AI-generated tests

## Checklist

> [!IMPORTANT]
> Please review and complete this checklist before submitting your PR. This helps our maintainers process your contribution faster and ensures it meets the quality standards.

- [x] "I certify that all code in this PR is my own, except as noted below."
- [x] I have read the [CONTRIBUTING.md](../CONTRIBUTING.md) guide.
- [x] My code follows the established style guidelines.
- [x] I have performed a self-review of my own code.
- [x] I have commented my code, particularly in hard-to-understand areas.
- [x] I have made corresponding changes to the documentation.
- [x] My changes generate no new warnings or errors.
- [ ] I have added tests that prove my fix is effective or that my feature works.
- [x] New and existing unit tests pass locally with my changes.

Author: markurtz

.detect-secrets.scan.json

@@ -139,5 +139,5 @@
       }
     ]
   },
-  "generated_at": "2026-05-29T03:01:36Z"
+  "generated_at": "2026-05-29T15:37:29Z"
 }

.github/CODEOWNERS

@@ -1,24 +1,17 @@
-# =============================================================================
-# CODEOWNERS — Automated Review Assignment
+# Copyright 2026 markurtz
 #
-# GitHub uses this file to automatically request reviews from the designated
-# code owners when a pull request modifies files matching a given pattern.
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
 #
-# HOW TO USE THIS FILE:
-#   1. Replace all placeholder GitHub usernames (e.g., @org/team-name or
-#      @username) with your actual GitHub team or individual usernames.
-#   2. Rules are evaluated from top to bottom. The LAST matching rule wins.
-#   3. Patterns follow the same syntax as .gitignore.
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# REFERENCE:
-#   https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
-# =============================================================================
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 
-# -----------------------------------------------------------------------------
-# Default Owner
-# Catches all files not matched by a more specific rule below.
-# This team or user is the reviewer of last resort.
-# -----------------------------------------------------------------------------
 *                               @markurtz
 
 # -----------------------------------------------------------------------------

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,4 +1,17 @@
 ---
+# Copyright 2026 markurtz
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 name: 🐛 Bug Report
 description: Create a report to help us improve gitversioned
 labels:

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,4 +1,17 @@
 ---
+# Copyright 2026 markurtz
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 name: Feature Request
 description: Suggest an idea for gitversioned
 labels:

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,3 +1,19 @@
+<!--
+Copyright 2026 markurtz
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
 <!--
 Thanks for contributing to GitVersioned!
 Please review the [Contributing Guidelines](../CONTRIBUTING.md) before submitting your PR.

.github/actions/oci/build/action.yml

@@ -17,8 +17,7 @@ description: "Builds container image and saves it as a tarball"
 inputs:
   python-version:
     description: "Python version to set up for tooling"
-    required: false
-    default: "3.10"
+    required: true
   force-run:
     description: "Always run even if no changes are detected"
     required: false

.github/actions/oci/quality/action.yml

@@ -17,8 +17,7 @@ description: "Runs Dockerfile and Docker Compose linters and security checks"
 inputs:
   python-version:
     description: "Python version to set up for tooling"
-    required: false
-    default: "3.10"
+    required: true
   force-run:
     description: "Always run even if no changes are detected"
     required: false

.github/actions/oci/tests/action.yml

@@ -17,8 +17,7 @@ description: "Runs OCI container structure tests (E2E) and no-op functional test
 inputs:
   python-version:
     description: "Python version to set up for tooling"
-    required: false
-    default: "3.10"
+    required: true
   image-tar:
     description: "The path to a pre-built image tarball to load"
     required: true

.github/actions/project/docs/action.yml

@@ -20,8 +20,7 @@ inputs:
     required: true
   python-version:
     description: "Python version to set up for tooling"
-    required: false
-    default: "3.10"
+    required: true
   force-run:
     description: "Always run even if no changes are detected"
     required: false

.github/actions/project/quality/action.yml

@@ -17,8 +17,7 @@ description: "Runs project linting, formatting, and security checks"
 inputs:
   python-version:
     description: "Python version to set up"
-    required: false
-    default: "3.10"
+    required: true
   force-run:
     description: "Always run even if no changes are detected"
     required: false