oct.git package#
Purpose#
Phase 4B oct git package: user-facing Click commands, quality-gate
orchestration, audit logging, and profile policy. Imported lazily by
oct.cli via git_group() so that CLI startup does not pay
the cost of loading the linter, formatter, or subprocess machinery for
non-git commands.
Responsibilities#
Expose the
gitClick command group foroct.cliregistration.Re-export the stable public API consumed by other oct modules.
Contracts#
All Click command functions go through the
audited()decorator defined inoct.git.audit.Every read-only git state query delegates to
oct.core.git(Phase 4A foundation). This module never callssubprocess.rundirectly.No write operations land in Phase 4B — both
oct git statusandoct git checkare strictly read-only. Writes come in Phase 4C/4D.
Submodules#
- oct.git.audit module
- oct.git.changelog module
- oct.git.commit_observer module
- oct.git.conventional module
- oct.git.oct_git module
- oct.git.policy module
- Purpose
- Responsibilities
- Diagnostics
- Contracts
DEFAULT_BRANCH_PATTERNSDEFAULT_PROFILEDEFAULT_PROTECTED_BRANCHESOC_GITIGNORE_MARKER_STARTPROFILE_MATRIXSECRETS_ALWAYS_BLOCKSVALID_PROFILESadd_ignore_patterns()apply_profile_policy()check_protected_branch_commit()generate_branch_name_from_message()is_protected_branch()list_ignore_patterns()remove_ignore_pattern()resolve_effective_profile()validate_branch_name()validate_ignore_pattern()
- oct.git.quality_gate module