From 79359baff3c64efaabba2519bbcc91d0a93f1bad Mon Sep 17 00:00:00 2001 From: CleverThis Date: Fri, 10 Apr 2026 05:54:29 +0000 Subject: [PATCH] docs: update CHANGELOG and automation-tracking for recent agent changes ISSUES CLOSED: #7116 --- CHANGELOG.md | 79 ++++++++++++++++++++++--- docs/development/automation-tracking.md | 42 +++++++++++++ 2 files changed, 112 insertions(+), 9 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index b26bc4871..d590f89c1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -46,20 +46,81 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). PR–issue label synchronization. The `issue-state-updater` syncs PR state labels whenever issue states change. +- **Automation Tracking Announcements**: Extended `automation-tracking-manager` with + announcement issue support (`CREATE_ANNOUNCEMENT_ISSUE`, `CLOSE_ANNOUNCEMENT_ISSUE`, + `LIST_TRACKING_ISSUES`, `READ_ANNOUNCEMENTS`, `REVIEW_OWN_ANNOUNCEMENTS`). Supervisors + and workers now read critical announcements before each cycle for cross-agent awareness. + Priority-based filtering (Critical/High/Medium/Low) reduces noise. Backlog-groomer + performs intelligent cleanup with age thresholds by priority. + +- **PR Agent Reorganization**: All PR-related agents renamed and reorganized to follow + the `*-pool-supervisor` naming pattern. New agents added: `pr-editor` (safe PR editing + with description preservation), `pr-manager` (unified PR interface), and + `pr-merge-pool-supervisor` (automated PR merging supervisor). Renamed: + `pr-api-creator` → `pr-creator`, `pr-checker` → `pr-ci-test-fixer`, + `pr-status-checker` → `pr-status-analyzer`, `pr-self-reviewer` → `pr-reviewer`, + `pr-fix-orchestrator` → `pr-fix-pool-supervisor`. + +- **Automated PR Merging** (`pr-merge-pool-supervisor`): New supervisor continuously + monitors for merge-ready PRs and merges them automatically when all criteria are met + (approvals, CI passing, no conflicts). Supports both formal reviews and comment-based + approvals (LGTM, ✅, "ready to merge", etc.). + +- **Implementation Worker Workflow Completion**: `implementation-worker` now implements + work claiming protocols with conflict detection, comprehensive review feedback handling + with intelligent parsing, sophisticated merge conflict resolution with multiple + strategies, and parallel subtask execution with wave-based dependency analysis. + Pass rate improved from 48.15% to 84.8%. + +- **Container Resource Stop Support**: `agents resource stop` now correctly stops + `container-instance` and `devcontainer-instance` resource types. + ### Changed - **Automation Tracking Format**: All automation tracking issues now use a standardized header format with mandatory `Reporting Interval: (Next report expected: )` declarations, enabling precise staleness detection. -- Fixed ACMS indexing pipeline not wired into CLI — ContextTierService - started empty on every CLI invocation so LLM received zero file context - during plan execution. Added `context_tier_hydrator.py` that reads files - from linked project resources (via `git ls-files` or `os.walk`) and - stores them as `TieredFragment` objects in the tier service. Hydration - runs automatically before context assembly in `LLMExecuteActor.execute()`. - Respects max file size (256KB), total budget (10MB), binary file - exclusion, and `.git`/`node_modules`/`__pycache__` directory skipping. - (#1028) + +- **PR Review Policy**: Reduced PR review requirement from 2 approvals to 1. Self-approval + is now permitted including for automated bot PRs. Approval can be a formal review OR an + approval comment (LGTM, Approved, ✅, "ready to merge"). + +- **Label Delegation Enforcement**: `automation-tracking-manager` now enforces delegation + to `forgejo-label-manager` for all label operations, preventing "invalid label ID" errors + and ensuring all tracking issues receive proper labels via name-to-ID mapping. + +- **ACMS Context Hydration**: Fixed ACMS indexing pipeline not wired into CLI — + `ContextTierService` started empty on every CLI invocation so LLM received zero file + context during plan execution. Added `context_tier_hydrator.py` that reads files from + linked project resources (via `git ls-files` or `os.walk`) and stores them as + `TieredFragment` objects in the tier service. Hydration runs automatically before context + assembly in `LLMExecuteActor.execute()`. Respects max file size (256KB), total budget + (10MB), binary file exclusion, and `.git`/`node_modules`/`__pycache__` directory + skipping. (#1028) + +### Fixed + +- **Robot Framework TDD Listener Guards** (#5436): Added three guard conditions to the + `tdd_expected_fail_listener` `end_test()` function to prevent blindly inverting ALL test + failures to passes, which was masking infrastructure errors and causing flaky CI behavior. + Guards: setup/teardown error detection, non-assertion failure detection (infrastructure + errors), and dry-run mode detection. Also fixed `Variable Should Exist` syntax errors in + e2e test files and removed `tdd_expected_fail` from 4 context assembly e2e tests where + bugs were already fixed. + +- **`issue-state-updater` Bash Script Errors**: Removed problematic bash script examples + that tried to invoke `task forgejo-label-manager` as a bash command (the Task tool cannot + be invoked from bash). Replaced with clear step-by-step operational instructions and + direct label management via API. + +- **`automation-tracking-manager` Label Delegation Syntax**: Fixed incorrect delegation + syntax when calling `forgejo-label-manager`. The manager now uses correct natural language + requests (e.g., "Apply labels to issue #123: Automation Tracking") instead of structured + parameters, ensuring tracking issues receive proper labels. + +- **`product-builder` Missing Supervisors**: Added missing `pr-fix-pool-supervisor` and + `pr-merge-pool-supervisor` to the product-builder's supervisor launch list (18 total + supervisors). Updated all numeric references, pre-flight checklists, and validation logic. --- diff --git a/docs/development/automation-tracking.md b/docs/development/automation-tracking.md index c24cf47b0..e5e12d101 100644 --- a/docs/development/automation-tracking.md +++ b/docs/development/automation-tracking.md @@ -50,6 +50,8 @@ For emergency announcements or important messages: | documentation-pool-supervisor | `AUTO-DOCS` | `[AUTO-DOCS] Documentation Report (Cycle 7)` | | architecture-guard-pool-supervisor | `AUTO-GUARD` | `[AUTO-GUARD] Guard Report (Cycle 9)` | | pr-review-pool-supervisor | `AUTO-REV-POOL` | `[AUTO-REV-POOL] Review Status (Cycle 4)` | +| pr-fix-pool-supervisor | `AUTO-FIX-POOL` | `[AUTO-FIX-POOL] PR Fix Status (Cycle 5)` | +| pr-merge-pool-supervisor | `AUTO-MERGE` | `[AUTO-MERGE] PR Merge Status (Cycle 3)` | | uat-test-pool-supervisor | `AUTO-UAT-POOL` | `[AUTO-UAT-POOL] UAT Status (Cycle 6)` | | project-owner-pool-supervisor | `AUTO-PROJ-OWN` | `[AUTO-PROJ-OWN] Project Status (Cycle 11)` | | agent-evolution-pool-supervisor | `AUTO-EVLV` | `[AUTO-EVLV] Agent Evolution Report (Cycle 10)` | @@ -141,6 +143,8 @@ This enables automated health monitoring by the system-watchdog to detect stalle | documentation-pool-supervisor | Documentation Report | Every 10 cycles (~3.3 hours) | Documentation update status | | architecture-guard-pool-supervisor | Guard Report | Every 10 cycles (~variable timing) | Codebase coherence check | | pr-review-pool-supervisor | Review Status | Every 10 cycles (~variable timing) | PR review pool status | +| pr-fix-pool-supervisor | PR Fix Status | Every 10 cycles (~variable timing) | PR CI fix pool status | +| pr-merge-pool-supervisor | PR Merge Status | Every 10 cycles (~variable timing) | Automated PR merge status | | uat-test-pool-supervisor | UAT Status | Every 10 cycles (~variable timing) | UAT testing progress | | project-owner-pool-supervisor | Project Status | Every 10 cycles (~variable timing) | Project ownership decisions | | agent-evolution-pool-supervisor | Evolution Report | Every 10 cycles (~variable timing) | Agent improvement proposals | @@ -346,6 +350,8 @@ label:"Automation Tracking" [AUTO-TIME] in:title label:"Automation Tracking" [AUTO-DOCS] in:title label:"Automation Tracking" [AUTO-GUARD] in:title label:"Automation Tracking" [AUTO-REV-POOL] in:title +label:"Automation Tracking" [AUTO-FIX-POOL] in:title +label:"Automation Tracking" [AUTO-MERGE] in:title label:"Automation Tracking" [AUTO-UAT-POOL] in:title label:"Automation Tracking" [AUTO-PROJ-OWN] in:title label:"Automation Tracking" [AUTO-EVLV] in:title @@ -364,6 +370,42 @@ label:"Automation Tracking" created:>2024-01-01T00:00:00Z label:"Automation Tracking" "Announce:" in:title ``` +## Cross-Agent Announcements + +The automation tracking system supports emergency announcements and important messages +that need to be visible to all agents. + +### Announcement Operations + +The `automation-tracking-manager` subagent supports the following announcement operations: + +| Operation | Description | +|-----------|-------------| +| `CREATE_ANNOUNCEMENT_ISSUE` | Create a new announcement with priority support | +| `CLOSE_ANNOUNCEMENT_ISSUE` | Close an announcement when it is no longer relevant | +| `LIST_TRACKING_ISSUES` | List all current tracking and announcement issues | +| `READ_ANNOUNCEMENTS` | Read announcements from other agents (cross-agent awareness) | +| `REVIEW_OWN_ANNOUNCEMENTS` | Review and clean up own announcements | + +### Announcement Lifecycle + +1. **Supervisors** read critical announcements before each cycle +2. **Workers** read announcements from system agents and orchestrators +3. **Priority-based filtering** reduces noise (Critical/High/Medium/Low) +4. **Backlog-groomer** performs intelligent cleanup with age thresholds by priority: + - Critical: 72 hours + - High: 48 hours + - Medium: 24 hours + - Low: 12 hours + +### Announcement Title Format + +``` +[AUTO-] Announce: +``` + +Example: `[AUTO-WATCHDOG] Announce: CRITICAL: CI pipeline down — all merges blocked` + ## Cleanup Protocol ### Primary Cleanup (Each Agent)