[docs] Update documentation for features from 2026-03-22

[github-actions]

Documentation Updates - 2026-03-22

This PR updates the documentation based on features and fixes merged in the last 24 hours.

Features Documented

• JSONC support in config/eval/policy files — already reflected in docs/concepts.md and docs/configuration.md (from fix: decouple config scaffolding from area detection #79)
• --dry-run for agentrc generate — already reflected in docs/commands.md (from fix: decouple config scaffolding from area detection #79)
• Array eval expectations — already reflected in docs/concepts.md (from fix: decouple config scaffolding from area detection #79)
• Config scaffolding for simple repos — already reflected in docs/configuration.md and CHANGELOG.md (from fix: decouple config scaffolding from area detection #79)

Changes Made

• Updated CHANGELOG.md to add the model/eval picker blank screen bug fix (from fix(ui): model/eval picker shows no list when CLI model discovery fails #78) to the [Unreleased] Bug Fixes section
• Updated docs/commands.md agentrc init description to accurately reflect that agentrc.config.json is always created (not just for monorepos) — it starts as a minimal {} stub for simple repos

Merged PRs Referenced

• fix: decouple config scaffolding from area detection #79 — fix: decouple config scaffolding from area detection (JSONC, dry-run, array expectations, simple repo init fix)
• fix(ui): model/eval picker shows no list when CLI model discovery fails #78 — fix(ui): model/eval picker shows no list when CLI model discovery fails

Notes

Most documentation for PR #79's changes was already present in the docs — this PR fills the remaining gap of the #78 bug fix in the CHANGELOG and clarifies the agentrc init behavior in the commands reference.

Generated by Daily Documentation Updater · ◷

• expires on Mar 23, 2026, 11:53 PM UTC

---

Note

This was originally intended as a pull request, but GitHub Actions is not permitted to create or approve pull requests in this repository.
The changes have been pushed to branch docs/update-2026-03-22-aa8c0ca3f0aaa4e1.

Click here to create the pull request

To fix the permissions issue, go to Settings → Actions → General and enable Allow GitHub Actions to create and approve pull requests.

Show patch (44 lines)

From b4199bb607e0bf8aeba088221e028d097f52daaf Mon Sep 17 00:00:00 2001
From: GitHub Copilot <copilot@github.com>
Date: Sun, 22 Mar 2026 23:47:00 +0000
Subject: [PATCH] docs: update CHANGELOG and commands for 2026-03-22 releases

- Add model/eval picker blank screen fix to CHANGELOG [Unreleased] (from #78)
- Update agentrc init description in docs/commands.md to clarify
  agentrc.config.json is always created (not just for monorepos)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 CHANGELOG.md     | 1 +
 docs/commands.md | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1e88169..4831604 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,7 @@ All notable changes to this project will be documented in this file.
 ### Bug Fixes
 
 - **Config scaffolding for simple repos** — `agentrc init` and the TUI now create `agentrc.config.json` even when no areas are detected, producing a minimal `{}` stub. Previously failed with "No areas detected. Cannot scaffold agentrc.config.json."
+- **Model/eval picker blank screen** — Fixed TUI model and judge-model pickers rendering nothing when `listCopilotModels()` fails (CLI not found or changed `--help` format). Falls back to a curated list of preferred models so the picker is always usable.
 
 ## [2.1.0]
 
diff --git a/docs/commands.md b/docs/commands.md
index f6f70cb..b2e77be 100644
--- a/docs/commands.md
+++ b/docs/commands.md
@@ -36,7 +36,7 @@ agentrc init [path]
 | `--force`        |                     | Overwrite existing files            |
 | `--model <name>` | `claude-sonnet-4.6` | Model for generation                |
 
-For monorepos, auto-detects workspaces and creates `agentrc.config.json`.
+Always creates `agentrc.config.json` (a minimal `{}` stub for simple repos; auto-detected workspaces and areas for monorepos).
 
 ---
 
-- 
2.53.0

[github-actions]

This issue was automatically closed because it expired on 2026-03-23T23:53:42.822Z.

Closed by Workflow