Skip to content

feat: add operability, design, and delivery governance checks - #70

Merged
alxxjohn merged 13 commits into
mainfrom
feature/operability-design-delivery-governance
Jul 27, 2026
Merged

feat: add operability, design, and delivery governance checks#70
alxxjohn merged 13 commits into
mainfrom
feature/operability-design-delivery-governance

Conversation

@alxxjohn

Copy link
Copy Markdown
Contributor

Summary

Adds the next production-readiness rule set for CodeGuard, focused on operability, local abstraction quality, delivery safety,
and governance.

This branch expands CodeGuard beyond code-quality scanning into readiness review by adding new checks for:

  • Observability and operational readiness
  • Service ownership and runbook metadata
  • Local abstraction/design quality
  • Environment branching and configuration leakage
  • Delivery and rollout safety
  • CI/CD governance
  • Supply-chain provenance expectations

Major changes

  • Added observability checks for:

    • unstructured logs
    • errors without useful context
    • sensitive data in logs
    • high-cardinality metric labels
    • missing critical-path instrumentation
    • log-and-ignore failure handling
    • shallow health checks
  • Added operations checks for:

    • missing service ownership
    • missing runbook metadata for critical paths
  • Added design checks for:

    • shallow modules
    • excessive public surface
    • pass-through abstractions
    • configuration leakage
    • temporal coupling
    • duplicated business knowledge
    • infrastructure type leakage
    • persistence model leakage
    • domain logic in handlers/controllers
  • Added delivery governance checks for:

    • missing required CI gates
    • mutable deployment references
    • missing rollback strategy
    • unsafe migration ordering
    • high-risk changes without kill switches
    • missing post-deploy verification
    • missing artifact provenance
    • environment-specific branching in source
  • Updated docs/rule metadata so the new check families and rule IDs are visible to users.

Dogfooding / cleanup

This branch also dogfoods the new strict checks against CodeGuard itself.

Instead of relaxing CodeGuard policy to make the branch pass, we reverted the policy-tuning commit and refactored concrete
hotspots:

  • split large quality precision code into smaller units
  • consolidated operability check packages to reduce dependency fan-in
  • extracted shared path-pattern matching
  • refactored policy profile comparison rendering
  • fixed strict lint findings directly

Validation

  • make codeguard-ci passes
  • make ci passes
  • Branch is clean and pushed

@alxxjohn
alxxjohn merged commit a52199a into main Jul 27, 2026
16 checks passed
alxxjohn added a commit that referenced this pull request Jul 27, 2026
🤖 I have created a release *beep* *boop*
---


##
[1.3.0](v1.2.2...v1.3.0)
(2026-07-27)


### Features

* add abstraction quality checks
([fc5a7ec](fc5a7ec))
* add change safety diff detectors
([ebc2f80](ebc2f80))
* add change safety PR summary metrics
([5b10ecd](5b10ecd))
* add delivery governance checks
([eb1b803](eb1b803))
* add local quality precision rules
([dd75b79](dd75b79))
* add local quality precision rules
([00c493e](00c493e))
* add observability and operations checks
([3e8713c](3e8713c))
* add operability, design, and delivery governance checks
([#70](#70))
([a52199a](a52199a))
* add opt-in recommended check defaults
([1680b21](1680b21))
* add opt-in recommended check defaults
([#66](#66))
([67510e3](67510e3))
* add production readiness rule families
([d58e8eb](d58e8eb))
* Add production reliability and data-readiness checks across languages
([#67](#67))
([c243ead](c243ead))
* add refused bequest smell detection
([053cb1a](053cb1a))
* add refused bequest smell detection
([#72](#72))
([4423aa4](4423aa4))
* add structural smell quality rules
([eefd8bd](eefd8bd))
* change safety testability refactors
([#69](#69))
([9081ad3](9081ad3))
* deepen code smell and maintainability precision checks
([#71](#71))
([d554347](d554347))
* deepen reliability parity checks
([fc8d769](fc8d769))
* expand production readiness language coverage
([588bf19](588bf19))
* scaffold change safety checks
([0b313d9](0b313d9))


### Bug Fixes

* dogfood production readiness coverage
([1110f4f](1110f4f))
* restore change testability detectors
([88f6df0](88f6df0))
* satisfy strict lint for change safety
([311716c](311716c))
* satisfy strict lint for operability governance
([abc9fd1](abc9fd1))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
@alxxjohn
alxxjohn deleted the feature/operability-design-delivery-governance branch July 28, 2026 14:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant