[WIP] Fix bugs in automated labeling infrastructure and improve logging

[Copilot]

Thanks for assigning this issue to me. I'm starting to work on it and will keep this PR's description up to date as I form a plan and make progress.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[AI Ops] Finalise the automated labeling infrastructure</issue_title>
<issue_description>## AI Ops Summary

• Review logic for applying labels via branch, file, and content heuristics
• Add or upgrade logging for traceability and debugging
• Identify and fix bugs in automated label application, one-hot enforcement, and migration/removal of legacy labels

Problem Statement

The labeling infrastructure is currently in place but is broken due to bugs and missing logging. We need to:

• Audit every instruction and code file related to labeling automation
• Add/upgrade logging for better traceability
• Debug and patch each issue
• Validate the system end-to-end

Scope & Deliverables

• Validate unified labeling agent and workflow (labeling.agent.js, labeling.yml)
• Audit and debug canonical config files: labels.yml, labeler.yml, issue-types.yml
• Review and patch automation governance and agent instructions
• Verify minimum required label enforcement and migration logic
• Add/upgrade logging throughout labeling workflows and agents
• Document troubleshooting steps and root cause analysis for each bug
• Ensure all documentation references are accurate and up-to-date

Success Criteria

• All bugs in labeling automation are resolved
• Comprehensive logging is added to all labeling agents and workflows
• Labeling rules and enforcement are validated against configs
• Documentation is accurate, cross-linked, and up-to-date
• Maintainers and contributors can reliably use automation for labeling without manual intervention

References

• Labeling Agent Spec
• Labeling Agent Instructions
• Labeling Workflow
• Canonical Labels
• Labeler Rules
• Issue Types
• Label Strategy Documentation
• Automation Governance
• Issue Labels Guide
• PR Labels Guide

---

This epic will be broken down into sub-issues for each component (agent, workflow, configs, logging, governance, docs, and troubleshooting).

Acceptance Criteria

• AI workflow/agent described
• Problem/opportunity scoped
• Success metric defined
• Documentation updated
• PR uses correct branch prefix (ai/)
• Approved by at least one maintainer

Additional Context

References

• Contribution Guidelines
• Branching Strategy
• Automation Governance
• PR Labels
• Saved Replies
• Project Meta
• Labeler Config
• Labels
• Issue Types

---

Definition of Ready (DoR)

• AI ops goal described
• Area/action mapped
• Acceptance criteria listed
• Estimate added

Definition of Done (DoD)

• All acceptance criteria met
• Solution/automation verified
• Documentation updated
• PR uses correct branch prefix (ai/)
  </issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes [AI Ops] Finalise the automated labeling infrastructure #32

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Note

.coderabbit.yml has unrecognized properties

CodeRabbit is using all valid settings from your configuration. Unrecognized properties (listed below) have been ignored and may indicate typos or deprecated fields that can be removed.

⚠️ Parsing warnings (1)

Validation error: Unrecognized key(s) in object: 'auto_labels', 'auto_assign', 'auto_review'

⚙️ Configuration instructions

• Please see the configuration documentation for more information.
• You can also validate your configuration using the online YAML validator.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}