Config-Driven git-receive-pack Hook Orchestration and Admission Phase Routing

[juliuskrah]

Summary

Implement runtime-configurable git-receive-pack hook orchestration so GitStore can enable or disable hook phases via environment variables and route admission control to the configured phase.

This wires the following environment variables into executable behavior:

• GITSTORE_HOOKS__GIT_RECEIVE_PACK__PRE_RECEIVE__ENABLED
• GITSTORE_HOOKS__GIT_RECEIVE_PACK__UPDATE__ENABLED
• GITSTORE_HOOKS__GIT_RECEIVE_PACK__POST_RECEIVE__ENABLED
• GITSTORE_HOOKS__GIT_RECEIVE_PACK__PROC_RECEIVE__ENABLED
• GITSTORE_HOOKS__GIT_RECEIVE_PACK__POST_UPDATE__ENABLED
• GITSTORE_ADMISSION_CONTROL__PHASE

Scope

In Scope

• Parse and validate git-receive-pack hook phase configuration from environment.
• Enable or disable each supported git-receive-pack hook phase at runtime.
• Route AdmissionControl execution to the configured phase (default pre-receive).
• Enforce phase compatibility rules, including fail-fast behavior when admission control targets a disabled or unsupported hook phase.
• Emit structured startup logs showing enabled hook phases and the active admission-control phase.
• Add integration tests for phase enable/disable behavior, admission phase routing, and invalid configuration handling.

Out of Scope

• Implementing the admission policy evaluation engine itself (tracked in ValidatingAdmissionPolicy Engine for Catalog Objects #106).
• Implementing catalog validation semantics for resource kinds and fields (tracked in [Initiative] Catalog Validation in gitstore-api #105).
• Non-git-receive-pack hook families.

Acceptance Criteria

• Hook execution respects all GITSTORE_HOOKS__GIT_RECEIVE_PACK_*_ENABLED flags.
• GITSTORE_ADMISSION_CONTROL__PHASE is parsed and validated at startup.
• Invalid phase values or disabled-target-phase configurations fail fast with actionable errors.
• Admission control executes exactly once in the configured hook phase when enabled.
• Startup logs clearly report enabled hook phases and the active admission phase.
• Integration tests cover valid config, invalid config, and disabled-phase edge cases.

Dependencies

• Subtask of: [Initiative] Catalog Validation in gitstore-api #105
• Depends on: ValidatingAdmissionPolicy Engine for Catalog Objects #106

Tracking

• Milestone: TBD