Skip to content

fix(governance): deutsches pr-regelwerk und merge-gate fuer code-scanning-0#50

Merged
tomtastisch merged 6 commits intomainfrom
codex/fix-de-pr-regeln-und-security-null
Feb 14, 2026
Merged

fix(governance): deutsches pr-regelwerk und merge-gate fuer code-scanning-0#50
tomtastisch merged 6 commits intomainfrom
codex/fix-de-pr-regeln-und-security-null

Conversation

@tomtastisch
Copy link
Owner

Ziel & Scope

  • Ziel: Verbindliche Governance-Haertung fuer deutsche Branch-/PR-Konventionen plus fail-closed Merge-Gate, das offene Code-Scanning-Alerts technisch blockiert.
  • Scope (in): AGENTS.md, PR-Template, CI-Preflight-Gates, Governance-Policy, Scorecard-Tokenhaertung, FsCheck-basierter Fuzzing-Signaltest, Versionierung auf 5.1.3.
  • Non-Goals (out): Keine Aenderung an SECURITY.md.

Umgesetzte Aufgaben (abhaken)

  • AGENTS.md auf iteratives, deutsches, fail-closed Arbeitsmodell erweitert.
  • Deutsches PR-Template mit Aufgaben-/Nachbesserungs-/DoD-Checklisten erstellt.
  • Branch-/PR-Naming-Policy als Governance-Regelwerk hinzugefuegt.
  • preflight erweitert: PR-Governance-Check + security/code-scanning/tools-Null-Check als Blocker.
  • Scorecard-Workflow auf SECURITY_CLAIMS_TOKEN fuer robustere Governance-Auswertung umgestellt.
  • FsCheck-basierter Fuzzing-Smoke-Test implementiert.
  • Versionierung policy-konsistent auf 5.1.3 nachgezogen (RepoVersion/Version/PackageVersion/History/Changelog).

Nachbesserungen aus Review (iterativ)

  • Alle Copilot-/Reviewer-Kommentare geprueft
  • Alle notwendigen Code-Nachbesserungen umgesetzt
  • PR-Beschreibung nach Nachbesserung aktualisiert
  • Alle Threads resolved (inkl. outdated)

Security- und Merge-Gates

  • Required Checks sind gruen
  • security/code-scanning/tools: 0 offene Alerts
  • Keine offenen blocker findings

Evidence (auditierbar)

  • dotnet test tests/FileTypeDetectionLib.Tests/FileTypeDetectionLib.Tests.csproj -c Release -v minimal
  • bash tools/ci/bin/run.sh naming-snt
  • python3 tools/check-doc-consistency.py
  • bash -n tools/ci/check-pr-governance.sh
  • bash -n tools/ci/check-code-scanning-tools-zero.sh

DoD (mindestens 2 pro Punkt)

Punkt DoD A DoD B Status
PR-Governance-Regelwerk CI validiert Branch/Titel/PR-Body fail-closed PR-Template erzwingt Checklisten + DoD [x]
Code-Scanning-Merge-Gate preflight ruft Null-Alert-Check auf Offene Alerts fuehren deterministisch zu fail [x]
Security/Fuzzing-Haertung Scorecard nutzt PAT-basierte Tokenquelle FsCheck-Signaltest laeuft im Unit-Test-Projekt [x]
Versionierungskonvergenz RepoVersion/Version/PackageVersion = 5.1.3 Versionsdoku aktualisiert [x]

Risiken / Open Items

  • vorhanden (unten auflisten)

Details

  • Scorecard-Governance-Heuristiken (MaintainedID, CIIBestPracticesID, CodeReviewID) sind teilweise nicht rein code-seitig remediierbar und muessen ggf. mit begruendetem Dismissal plus Evidence-Logik geschlossen werden.

@tomtastisch tomtastisch force-pushed the codex/fix-de-pr-regeln-und-security-null branch from 363b01f to bf96d31 Compare February 14, 2026 13:18
@github-actions github-actions bot added version:minor New compatible functionality; requires MINOR bump feature New compatible feature or datatype impl:config and removed area:docs area:tooling impl:security area:tests labels Feb 14, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR implements comprehensive German-language governance rules and fail-closed merge gates for branch/PR naming conventions and code scanning alerts. It establishes mandatory PR structure requirements and introduces automated validation to enforce these policies in the CI pipeline.

Changes:

  • Added fail-closed CI checks for PR governance (branch naming, PR title format, PR body structure) and code scanning alerts (must be zero to merge)
  • Introduced mandatory German-language PR template with structured sections, checklists, and Definition of Done matrices
  • Updated AGENTS.md to formalize German workflow requirements and iterative development model
  • Version bumped to 5.1.3 with full convergence across all version fields
  • Added FsCheck-based fuzzing smoke test and updated Scorecard workflow to use PAT-based authentication

Reviewed changes

Copilot reviewed 17 out of 18 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
tools/ci/check-pr-governance.sh New fail-closed validation script for branch names, PR titles, and PR body structure per German governance policy
tools/ci/check-code-scanning-tools-zero.sh New fail-closed check that blocks merge if any open code scanning alerts exist
tools/ci/bin/run.sh Integrated both new governance checks into preflight stage as blocking checks
.github/workflows/ci.yml Added security-events and pull-requests read permissions; set GH_TOKEN for preflight job
.github/workflows/scorecard.yml Updated to use SECURITY_CLAIMS_TOKEN PAT for more robust governance evaluation
tests/FileTypeDetectionLib.Tests/Unit/Fuzzing/FsCheckSmokeTests.cs New smoke test validating FsCheck generator functionality
tests/FileTypeDetectionLib.Tests/FileTypeDetectionLib.Tests.csproj Added FsCheck package reference
tests/FileTypeDetectionLib.Tests/packages.lock.json Locked FsCheck 3.2.0 and FSharp.Core 5.0.2 dependencies
Directory.Packages.props Added centrally managed FsCheck version 3.2.0
Directory.Build.props Version bumped to 5.1.3
src/FileTypeDetection/FileTypeDetectionLib.vbproj Version and PackageVersion updated to 5.1.3
docs/versioning/003_CHANGELOG_RELEASES.MD Documented governance hardening changes under [Unreleased] and added 5.1.2 and 5.1.1 release entries
docs/versioning/002_HISTORY_VERSIONS.MD Added version 5.1.3 entry with TBD commit reference
docs/governance/007_POLICY_BRANCH_PR_NAMING_DE.MD New policy document defining mandatory branch/PR naming conventions with enforcement rules
docs/governance/003_INDEX_GOVERNANCE.MD Added reference to new branch/PR naming policy
docs/audit/013_SCORECARD_GOVERNANCE_ALERT_MAPPING.MD Added merge gate requirement and dismissal protocol for non-remediable heuristic alerts
.github/pull_request_template.md New mandatory German PR template with structured sections and checklists
AGENTS.md Translated to German and expanded with detailed PR requirements, merge gates, and code scanning zero-alert policy

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 17 out of 18 changed files in this pull request and generated 5 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@tomtastisch
Copy link
Owner Author

Abarbeitung der offenen Copilot-Threads (iterativ, fail-closed):

  • r2807500294: Evidence-Ausgabe auf artifacts/ci/preflight/code-scanning-tools-zero/ umgestellt, damit Preflight-Artefakt die Dateien enthält.
  • r2807500298: alerts_file/evidence_paths in check-code-scanning-tools-zero.sh nur noch wenn open-alerts.json tatsächlich existiert (robust für frühe Fehlerpfade).
  • r2807500299: Changelog korrigiert: Einträge auf ## [5.1.3] zugeordnet, Unreleased als Platzhalter belassen.
  • r2807500301: check-pr-governance.sh schreibt nach artifacts/ci/preflight/pr-governance/.
  • r2807500304: Gate-Logik verschärft auf OR, damit beide Bestandteile (security/code-scanning/tools UND 0 offene Alerts) verpflichtend sind.

Alle Required Checks sind nach dem Fix-Push grün.

@tomtastisch tomtastisch merged commit 53135ee into main Feb 14, 2026
27 checks passed
@tomtastisch tomtastisch deleted the codex/fix-de-pr-regeln-und-security-null branch February 14, 2026 13:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:pipeline area:versioning feature New compatible feature or datatype impl:config version:minor New compatible functionality; requires MINOR bump

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant