From 16adf181c07b8704d6ed3e04b6a8a09327689ef1 Mon Sep 17 00:00:00 2001 From: CleverThis Date: Thu, 9 Apr 2026 06:16:22 +0000 Subject: [PATCH] docs: update diagnostics providers, changelog, and automation-tracking agent table - docs/reference/diagnostics_checks.md: expand provider API keys table from 6 to all 9 supported providers (Azure, Cohere, Groq, Together added) matching implementation in system.py (PR #3469) - CHANGELOG.md [Unreleased]: add entries for ACMS real retrieval (PR #3635, #3676), diagnostics 9-provider check (PR #3469), validation attach named options (PR #1222), and plan action args upsert fix (PR #4197) - docs/development/automation-tracking.md: add docs-writer agent prefix (AUTO-DOCS) to the agent prefix table; add required labels (Type/Automation, State/In Progress, Priority/Medium) to the Required Labels section --- CHANGELOG.md | 22 ++++++++++++++++++++++ docs/development/automation-tracking.md | 4 ++++ docs/reference/diagnostics_checks.md | 10 +++++++--- 3 files changed, 33 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 885d0e7ba..84ce7bf80 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -40,6 +40,28 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). header format with mandatory `Reporting Interval: (Next report expected: )` declarations, enabling precise staleness detection. +- **ACMS context strategies now use real backend retrieval** (PR #3635, #3676): All six + built-in context strategies (`simple-keyword`, `semantic-embedding`, + `breadth-depth-navigator`, `arce`, `temporal-archaeology`, `plan-decision-context`) + now perform real backend-driven retrieval instead of returning empty fragment lists. + `ContextAssembler.assemble()` now invokes `SkeletonCompressor` to propagate skeleton + context to child plans. + +- **Diagnostics checks all 9 providers** (PR #3469): `agents diagnostics` now checks + API key configuration for all nine supported providers: OpenAI, Anthropic, Google, + Azure OpenAI, OpenRouter, Google Gemini, Cohere, Groq, and Together (previously only + six providers were checked). + +### Fixed + +- **`agents validation attach` uses named `--key value` options** (PR #1222): The + `attach` subcommand now accepts extra arguments as `--key value` named options + instead of positional arguments, matching the CLI style guide. + +- **Plan action arguments upsert** (PR #4197): `PlanService` now upserts action + arguments during `plan use` to avoid `UNIQUE` constraint violations when the same + action is used multiple times across plan sessions. + --- ## [3.8.0] — 2026-04-05 diff --git a/docs/development/automation-tracking.md b/docs/development/automation-tracking.md index 6711acc9f..21dfd6021 100644 --- a/docs/development/automation-tracking.md +++ b/docs/development/automation-tracking.md @@ -44,11 +44,15 @@ For emergency announcements or important messages: | system-watchdog | `AUTO-WATCHDOG` | `[AUTO-WATCHDOG] System Health (Cycle 8)` | | backlog-groomer | `AUTO-GROOMER` | `[AUTO-GROOMER] Grooming Report (Cycle 23)` | | human-liaison | `AUTO-LIAISON` | `[AUTO-LIAISON] Status Update (Cycle 67)` | +| docs-writer | `AUTO-DOCS` | `[AUTO-DOCS] Documentation Report (Cycle 1)` | ## Required Labels All automation tracking issues MUST include: - **`Automation Tracking`** - Primary label for filtering +- **`Type/Automation`** - Identifies the issue as automation-generated +- **`State/In Progress`** - Indicates the agent is actively running +- **`Priority/Medium`** - Default priority for tracking issues - Additional agent-specific labels as appropriate ## Interval Reporting and Health Monitoring diff --git a/docs/reference/diagnostics_checks.md b/docs/reference/diagnostics_checks.md index 16e762614..9304c3133 100644 --- a/docs/reference/diagnostics_checks.md +++ b/docs/reference/diagnostics_checks.md @@ -44,16 +44,20 @@ first-run) is accessible and writable. ### Provider API keys Checks whether each supported LLM provider has its API key configured. -One sub-check is emitted per provider. +One sub-check is emitted per provider. As of v3.8.0 all nine supported +providers are checked (extended from six in v3.7.0 — PR #3469). | Provider | Environment variable | Status when missing | |----------|---------------------|---------------------| | OpenAI | `OPENAI_API_KEY` | warn | | Anthropic | `ANTHROPIC_API_KEY` | warn | | Google | `GOOGLE_API_KEY` | warn | -| Google Gemini | `GEMINI_API_KEY` | warn | -| Hugging Face | `HF_TOKEN` | warn | +| Azure OpenAI | `AZURE_OPENAI_API_KEY` | warn | | OpenRouter | `OPENROUTER_API_KEY` | warn | +| Google Gemini | `GEMINI_API_KEY` | warn | +| Cohere | `COHERE_API_KEY` | warn | +| Groq | `GROQ_API_KEY` | warn | +| Together | `TOGETHER_API_KEY` | warn | | Status | Condition | Remediation | |--------|-----------|-------------| -- 2.52.0