Skip to content

Define organization label taxonomy and routing contract - #21

Merged
szmyty merged 1 commit into
mainfrom
codex/github-8-label-taxonomy
Sep 2, 2026
Merged

Define organization label taxonomy and routing contract#21
szmyty merged 1 commit into
mainfrom
codex/github-8-label-taxonomy

Conversation

@szmyty

@szmyty szmyty commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • publish the versioned canonical organization label catalog and JSON schemas
  • classify the complete approved 30-label catalog into five opt-in overlays
  • define required universal priority, type, area, coordination, and status labels
  • add governed repository assignments and a deterministic .github reference projection
  • document ownership, routing, collision, lifecycle, deprecation, removal, rollback, and private-repository behavior
  • strengthen the organization work form and add local issue-template configuration
  • validate the contract with a pinned, least-privilege GitHub Actions workflow

Ownership boundary

.github owns label meaning, overlay definitions, and repository assignments. Relay owns previewing and applying provider mutations and must consume a merged immutable revision. Pace may report adoption and drift but does not gain mutation authority.

This contract does not redefine Hygiene's broader machine-readable portfolio policy.

Safety

  • universal labels cannot be disabled
  • repository labels cannot redefine canonical names
  • unknown overlays and version mismatches fail closed
  • deletion is never inferred from absence
  • the default removal policy is retain
  • no credentials or repository write permissions are introduced

Validation

  • python scripts/validate_labels.py
  • python -m unittest discover --start-directory tests --verbose (9 tests)
  • deterministic reference projection diff
  • JSON and YAML parsing
  • Python compilation
  • git diff --check

Closes #8

@szmyty
szmyty merged commit b415c80 into main Sep 2, 2026
1 check passed
@szmyty
szmyty deleted the codex/github-8-label-taxonomy branch September 2, 2026 00:16
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.

Define organization issue intake, routing, and label taxonomy

1 participant