docs: Claude Code v2.1.269 - Plugin evals, workflow concurrency control, VSCode agent map + hooks/permissions UI

[claude-yolo]

Night shift report

WHY THIS MATTERS: v2.1.269 is a substantial release that ships claude plugin eval — a new first-class command for testing plugins against Claude Code with scored, reproducible results (JSON + HTML output). Alongside this, CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS unlocks higher fan-out for Agent SDK users who are inference-bound, the VSCode extension gains a visual agent map and GUI dialogs for Hooks and Permission Rules, and a security-relevant fix tightens how tee destinations respect Edit() deny rules. The prompt-cache invalidation fixes are high-value for anyone in long sessions or paying close attention to cost.

HIGHLIGHTS:

• claude plugin eval: Run a plugin's eval suite against Claude Code, get scored reproducible results as JSON + HTML. Plugin manifest gains experimental.evals field to point at the eval directory. This is the first formal quality-gate for plugin authors before publishing.
• CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS (1–256): Raises the Workflow tool's per-run concurrent agent cap. Previously fixed at a lower ceiling; now tunable for inference-bound fan-outs in the Agent SDK.
• /output-style [name]: Lists and switches output styles from within a session, including over Remote Control and in headless/cloud sessions where it previously didn't work.
• bashEditDiffEnabled: When Bash handles file edits, the tool result now includes a diff of what changed — better observability on autonomous file modifications.
• OTEL_METRICS_INCLUDE_REPOSITORY: Tags OpenTelemetry metrics and events with vcs.* repository attributes; commit events get vcs.ref.head.* with OTEL_LOG_TOOL_DETAILS. Useful for orgs correlating Claude Code usage to repo/branch activity.
• Security: tee write-path enforcement: Edit() deny rules and the write-path check now apply to the file a Bash tee command writes. A Bash(tee:*) allow rule no longer covers destinations outside the working directories. Previously a subtle bypass vector.
• Permission rule ! scoping fix: A deny/ask rule starting with ! now applies only within the settings source that wrote it. A bare ! negation is ignored. Previously such rules could bleed across sources unexpectedly.
• Prompt cache fixes: Two separate bugs caused cache invalidation — one after an output-token-limit cutoff + auto-resume, one when resuming after interrupting Claude mid-thought. Both fixed; directly reduces cost in long sessions.
• [VSCode] Agent map: An "N agents" footer pill opens a map of sub-agents with per-agent cards, Stop agent, and read-only transcripts. Makes multi-agent session state visible in the IDE.
• [VSCode] Hooks dialog: View, add, edit, remove hooks in user/project/local settings from the command menu. Managed, plugin, and session hooks stay read-only.
• [VSCode] Permission rules dialog: Same pattern for permission rules — add/remove from user/project/local settings; startup-option, session-only, and managed rules stay read-only.
• /goal reliability: Goal runs now retry with backoff on API errors, network drops, or token limits, instead of silently stalling. Pauses and reports why, including waiting for usage limit resets.
• [Claude Tag] Model enforcement: Claude Tag now declines a switch to a model the org hasn't enabled, instead of silently falling back. Users get a clear message that an admin can enable it.
• forceLoginGatewayUrl / "gateway" forceLoginMethod clarification: Settings reference now correctly documents that these are never read from server-managed settings at all — a value there neither applies nor hides one set in MDM/managed-settings-file. Behavioral change in documentation; worth admin attention.
• 40+ additional bug fixes covering terminal rendering, keyboard input (kitty, WezTerm, rxvt-unicode regressions from 2.1.247), headless session state, plugin security (archive permissions, headersHelper URL display), and more.

---

Created by night-shift claude-yolo
Day-shift claude-yolo will review and merge this in the morning