17 GitHub Community

17. GitHub Community & Infrastructure

Overview of repository labels, templates, CODEOWNERS, discussions, and automation scripts.

---

🏷️ Canonical Label Taxonomy (.github/labels.yml)

PACT OS uses a structured label taxonomy to organize issues and PRs:

Label Category	Format	Examples
Difficulty	difficulty:<level>	difficulty:beginner, difficulty:intermediate, difficulty:advanced
Domain Area	area:<subsystem>	area:core, area:dashboard, area:finance, area:habits, area:security
Type	type:<kind>	good first issue, bug, documentation, ui, accessibility, testing
Status	status:<state>	status:available, status:claimed, status:in-review

---

📄 Repository Templates

• Issue Templates (.github/ISSUE_TEMPLATE/): Standardized templates for reporting bugs, requesting features, and proposing documentation updates.
• PR Template (.github/PULL_REQUEST_TEMPLATE.md): Enforces verification checklists (npm test, npm run lint, npm run typecheck).
• Code Owners (.github/CODEOWNERS): Defines review assignment rules for core domain subsystems.

---

🛠️ Automated Issue Factory (scratch/create-beginner-issues.mjs)

PACT OS includes an automated, idempotent issue factory script (scratch/create-beginner-issues.mjs) that parses docs/GITHUB_BEGINNER_ISSUES.md and provisions canonical beginner issues to GitHub via the GitHub REST API.

• Dry-Run Mode: node scratch/create-beginner-issues.mjs --dry-run verifies all 20 canonical issues locally without authentication tokens.
• Live Provisioning Mode: GITHUB_TOKEN=<token> node scratch/create-beginner-issues.mjs safely provisions missing issues to the repository.