Sync: docs update — teaching refresh, consolidation, lint

.STATUS

@@ -4,10 +4,10 @@
 ## Project: flow-cli
 ## Type: zsh-plugin
 ## Status: active
-## Focus: v7.6.0 release
-## Phase: Releasing
-## Priority: 1
-## Progress: 98
+## Focus: post-release
+## Phase: Released
+## Priority: 2
+## Progress: 100
 
 ## Current Session (2026-02-27)
 
@@ -24,7 +24,9 @@
 - docs: site update — index.md What's New, stale test counts, README Teaching section
 - merged: PR #425 (Scholar Config Sync), PR #424 (em --prompt), PR #427 (docs gap fix)
 - cleanup: worktree removed, stale branches deleted
-- status: ready for v7.6.0 release
+- release: v7.6.0 — full pipeline (PR #428, CI green, merge, retag, GitHub release)
+  - Homebrew tap updated, docs deployed, all downstream verified
+  - Stale remote branches deleted (atlas-integration, em-v2, homebrew-release-fix, swarm-em-v2-dispatcher)
 
 ## Previous Session (2026-02-27, earlier)
 
@@ -198,7 +200,7 @@
 
 | Worktree | Branch | Status |
 |----------|--------|--------|
-| Main repo | `dev` | v7.6.0 released, both features merged |
+| Main repo | `dev` | v7.6.0 released, all clean |
 
 ---
 

CHANGELOG.md

@@ -96,23 +96,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-## [v7.6.0] — 2026-02-27 — Email Polish & Help Guards
+## [v7.6.0] — 2026-02-27 — em --prompt + Scholar Config Sync
 
 ### Added
 
-- **`em --prompt`** flag for AI-guided email composition
-- **`em --backend`** flag to override AI provider (openai, anthropic, etc.)
-- **`em forward`** command with address validation and attachment passthrough
-- **`--help` guards** on all 34 em subcommand functions — consistent help access everywhere
+- **`em --prompt` flag** — Natural-language instructions for AI-drafted replies, sends, and forwards (`em reply 123 --prompt 'decline politely'`)
+- **`em --backend` flag** — Per-command AI backend override (`--backend claude|gemini`)
+- **`em forward` command** — Forward emails with optional AI body and `--prompt` support
+- **Smart TTY detection** — Non-interactive contexts (Claude Code) auto-route to batch send path
+- **Scholar Config Sync** — `--config` flag auto-appended to all Scholar commands when `.flow/teach-config.yml` exists
+- **Config subcommands** — `teach config check`, `teach config diff`, `teach config show`, `teach config scaffold`
+- **New teach wrappers** — `teach solution`, `teach sync`, `teach validate-r` (with shortcuts `sol`, `vr`)
+- **Doctor config sync** — New section in `teach doctor` quick mode (5 categories now)
+- **Stale config detection** — Warns when config changes since last Scholar run
+- **Help guards** — `--help` flag support added to all 34 em subcommand functions
 
-### Changed
+### Fixed
+
+- **RETURN trap bug** — Replaced ZSH-incompatible `trap "..." RETURN` with `always` block in `_em_hml_reply`
+- **Config arg duplication** — Fixed `_teach_build_command` config case passing args twice
+- **Legacy path anchoring** — `teaching-style.local.md` path now anchored to `$FLOW_PROJECT_ROOT`
+
+### Tests
 
-- Test suite expanded to **50/50 passing** (was 49/49), 198 test files
+- `test-em-prompt-flag.zsh` — 14 tests for --prompt/--backend flag parsing
+- `test-em-help-guards.zsh` — Help guard coverage for all em subcommands
+- `test-scholar-config-sync.zsh` — 13 unit tests for config injection
+- `e2e-scholar-config-sync.zsh` — 28 end-to-end tests
+- `dogfood-scholar-config-sync.zsh` — 41 structural checks
+- Test suite: 53/53 passing (205 test files, 1 expected timeout)
 
 ### Documentation
 
-- Synced site for 38 commands with forward/--prompt/--backend docs
-- Updated test counts across TESTING.md, CLAUDE.md, site footers
+- New: `docs/guides/SCHOLAR-INTEGRATION-GUIDE.md`
+- Updated: QUICK-REFERENCE, MASTER-DISPATCHER-GUIDE, TEACHING-SYSTEM-ARCHITECTURE
+- Updated: em help, completions, cookbook, refcard, architecture docs
 
 ---