Release v7.10.1

.STATUS

@@ -9,7 +9,15 @@
 ## Priority: 2
 ## Progress: 100
 
-## Current Session (2026-06-13) — agenda / forward-looking schedule layer: brainstorm → spec → worktree [dev]
+## Current Session (2026-06-13) — v7.10.0 SHIPPED + CI full-suite gate COMPLETE (Phase 1–3; main gated) [dev]
+
+**Session activity:**
+- **Agenda feature → v7.10.0 SHIPPED:** reviewed + hardened the schedule layer (adversarial A–F fixes, `e2e-agenda`/`dogfood-agenda` pair, shared-pipeline refactor `_schedule_window_records`/`_schedule_render_capped`); fixed a pre-existing `dash` non-TTY abort (`$(( cond ? 's' : '' ))` ×3). PR #463→dev → release PR #464→main (`477b5c59`) → GitHub release v7.10.0 → Homebrew tap auto-updated → docs deployed. Plus ~50-doc version sweep + CHANGELOG ×2 + index What's-New + `agenda` in index Core Commands (`955b1fe3`).
+- **Cleanup:** agenda worktree + branch removed (local+remote). **3 squash-merged branches** (`manpage-refresh`/`tok-autosync`/`scholar-fix`) await manual `git branch -D` — hook blocks force-delete (route to user).
+- **CI full-suite gate (Next Action #3) — MERGED (PR #465 → dev `b57c0d87`):** spec → worktree → **Phase 1** measured ground truth (**51/14/0**; spec prediction *inverted* — the Ubuntu runner LACKS `atlas`/`ait`/`himalaya`/`R`/`quarto`, so 14 tool-dependent suites failed, ONE uniform class) → **Phase 2** made it green: clean-skip via **rc 77** (automake SKIP, taught to `run-all.sh`), `skip_without_warm_atlas`, pinned `FLOW_ATLAS_ENABLED=no` for atlas-skew — **plus 4 real cross-platform bugs the gate caught**: `exec {var}>` flock fd (zsh ≥10), GNU-first `stat -c %Y` (BSD-first *corrupts* on Linux), `date -d` fallback, em-cache mtime helper. Reviewed (approve) → nits applied (`typeset -g` fd, em-cache null-delim). `full-suite` job runs in CI **non-blocking**; suite now **64 pass / 0 fail / 1 skip** on the runner AND locally. Worktree + branch removed.
+  - **Phase 3 — DONE:** soaked green on dev (4 consecutive runs), then PR #466 flipped `full-suite` to **blocking** (dropped `continue-on-error`, renamed job → `Full Test Suite`) → merged to dev (`020de969`). **`main` branch protection now requires `ZSH Plugin Tests` + `Full Test Suite`** (PR-required/no-force/no-delete preserved; `enforce_admins:false` keeps `--admin` bypass; `strict:false`). **`dev` left unprotected by design** — forcing PR-required there would break the direct-commit docs/spec workflow; the now-blocking job shows red on dev PRs as a soft signal. ci-gate-required worktree + branch (local+remote) cleaned. Gate is LIVE: a red full suite now blocks merge to main.
+
+## Previous Session (2026-06-13) — agenda / forward-looking schedule layer: brainstorm → spec → worktree [dev]
 
 **Session activity:**
 - **Brainstormed** (`/workflow:brainstorm -d -s`) extending `dash` + cadence commands (`morning`/`today`/`week`) to surface forward-looking RESEARCH + TEACHING activity (deadlines, lectures, exams, manuscript/grant milestones, recurring blocks) — today everything is present/backward-looking.
@@ -344,7 +352,7 @@
 
 | Worktree | Branch | Status |
 |----------|--------|--------|
-| Main repo | `dev` | agenda / schedule layer merged (#463, e0b18e5f) + v7.10.0 bump + doc sweep; agenda worktree removed. Release dev→main pending. |
+| Main repo | `dev` | v7.10.0 SHIPPED + CI full-suite gate MERGED (PR #465 → dev `b57c0d87`); both worktrees removed; no active worktrees. **Pending:** 3 squash-merged branches (manpage-refresh/tok-autosync/scholar-fix) await manual `git branch -D`; CI-gate **Phase 3** (promote `full-suite` to required check after dev soak). |
 
 ---
 
@@ -379,7 +387,7 @@
 ---
 
 **Last Updated:** 2026-06-13
-**Status:** v7.10.0 on dev (release dev→main pending) | 64/64 tests passing (1 expected interactive/tmux timeout) | 14 dispatchers + at bridge | 213 test files | 12000+ test functions | 0 lint errors | 0 broken links
-## wins: Fixed the regression bug (2026-06-13), Fixed the regression bug (2026-06-13), Fixed the regression bug (2026-06-13), Fixed the regression bug (2026-06-05), --category fix squashed the bug (2026-06-05)
+**Status:** v7.10.0 SHIPPED (main + Homebrew tap) | full suite in CI (PR #465) — 64 passed / 0 failed / 1 skipped (tool-absent rc 77) | 14 dispatchers + at bridge | 213 test files | 12000+ test functions | 0 lint errors | 0 broken links
+## wins: Fixed the regression bug (2026-06-13), Fixed the regression bug (2026-06-13), Fixed the regression bug (2026-06-13), Fixed the regression bug (2026-06-13), Fixed the regression bug (2026-06-05)
 ## streak: 1
-## last_active: 2026-06-13 16:01
+## last_active: 2026-06-13 18:23

.github/workflows/test.yml

@@ -61,3 +61,84 @@ jobs:
           echo "| Metric | Value |" >> $GITHUB_STEP_SUMMARY
           echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
           echo "| Duration | ${DURATION}s |" >> $GITHUB_STEP_SUMMARY
+
+  # ---------------------------------------------------------------------------
+  # ci-full-suite-gate (Phase 3): the full 65-suite run-all.sh is now a BLOCKING
+  # gate. Service/tool-absent suites clean-skip via rc 77, so a non-zero exit
+  # means a real failure. Promoted to a required status check on dev (then main
+  # after a soak). The check name below ("Full Test Suite") must match the
+  # required-check name configured in branch protection.
+  # ---------------------------------------------------------------------------
+  full-suite:
+    name: Full Test Suite
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Ensure zsh is installed
+        run: |
+          if ! command -v zsh >/dev/null 2>&1; then
+            sudo apt-get update && sudo apt-get install -y zsh
+          fi
+
+      - name: Configure git identity
+        run: |
+          # Fresh runners have no git identity; suites that exercise the deploy
+          # workflow (teach-deploy) run `git commit` and fail with "empty ident"
+          # without it. This is CI environment provisioning, not a test change.
+          git config --global user.email "ci@flow-cli.test"
+          git config --global user.name "flow-cli CI"
+          git config --global init.defaultBranch main
+
+      - name: Record start time
+        id: start
+        run: echo "time=$(date +%s)" >> $GITHUB_OUTPUT
+
+      - name: Create mock project structure
+        run: |
+          mkdir -p ~/projects/dev-tools/flow-cli/.git
+          mkdir -p ~/projects/r-packages/active/mediationverse/.git
+          mkdir -p ~/projects/r-packages/stable/rmediation/.git
+          mkdir -p ~/projects/teaching/stat-440/.git
+          mkdir -p ~/projects/research/mediation-planning/.git
+          mkdir -p ~/projects/quarto/manuscripts/paper1/.git
+          mkdir -p ~/projects/apps/examify/.git
+          cp -r . ~/projects/dev-tools/flow-cli/
+
+      - name: Run full suite
+        id: fullsuite
+        run: |
+          cd ~/projects/dev-tools/flow-cli
+          set +e
+          # Capture run-all.sh output; tee returns 0, so grab run-all's real
+          # exit via PIPESTATUS (1=FAIL, 2=TIMEOUT, 0=clean) and re-exit with it
+          # so the job (a required check) fails the PR on a real failure.
+          ./tests/run-all.sh 2>&1 | tee /tmp/full-suite.log
+          rc=${PIPESTATUS[0]}
+          echo "rc=$rc" >> "$GITHUB_OUTPUT"
+          echo "Full suite exit code: $rc"
+          exit "$rc"
+
+      - name: Full Suite Summary
+        if: always()
+        run: |
+          END_TIME=$(date +%s)
+          DURATION=$((END_TIME - ${{ steps.start.outputs.time }}))
+          {
+            echo "## 🧪 Full Suite (run-all.sh) — required gate"
+            echo ""
+            echo "| Metric | Value |"
+            echo "|--------|-------|"
+            echo "| Duration | ${DURATION}s |"
+            echo "| Exit code | \`${{ steps.fullsuite.outputs.rc }}\` (0=clean, 1=FAIL, 2=TIMEOUT) |"
+            echo ""
+            echo "<details><summary>Full run-all.sh output</summary>"
+            echo ""
+            echo '```'
+            cat /tmp/full-suite.log 2>/dev/null || echo "(no log captured)"
+            echo '```'
+            echo ""
+            echo "</details>"
+          } >> "$GITHUB_STEP_SUMMARY"

CHANGELOG.md

@@ -9,6 +9,40 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [7.10.1] — 2026-06-13 — Linux portability fixes + full-suite CI gate
+
+### Fixed
+
+- **Cache locking errored on Linux** (`lib/doctor-cache.zsh`,
+  `lib/analysis-cache.zsh`): the `flock` path used bash-only high-fd
+  redirection (`exec 201>`/`exec 200>`), which zsh parses as a command and
+  fails with "command not found" on Linux (where `flock` exists). Switched to
+  zsh's dynamic `exec {var}>` allocation. macOS was unaffected (no `flock` →
+  mkdir fallback), so this only ever broke on Linux/CI.
+- **Email cache never worked on Linux** (`lib/em-cache.zsh`): used macOS-only
+  `stat -f %m`, so every entry's mtime read as 0 and looked expired. Added a
+  portable `_em_cache_mtime` (GNU `stat -c %Y` first — it fails cleanly on
+  macOS — then BSD `stat -f %m`).
+- **`teaching_week` computed 0 on Linux** (`lib/teaching-utils.zsh`,
+  `lib/dispatchers/teach-deploy-enhanced.zsh`): used macOS-only `date -j -f`.
+  Added portable date helpers (BSD then GNU `date -d`).
+- **`flow doctor --help-check` false-flagged `tm`** on machines without aiterm
+  (`lib/help-compliance.zsh`): the `tm` dispatcher only loads its help when the
+  `ait` CLI is present, so it's now checked only when `ait` is installed.
+
+### Changed
+
+- **CI now runs the full test suite on every PR.** Added a `full-suite` job to
+  `.github/workflows/test.yml` running `./tests/run-all.sh` (the full 65-suite
+  suite), parallel to the fast smoke job. It started non-blocking
+  (`continue-on-error`); after soaking green on `dev` it is now a **required
+  check on `main`** — a red suite blocks release to production.
+- **`run-all.sh` skip semantics:** exit code **77** now counts a suite as
+  _skipped_ (not failed) — used by suites that require an external tool/service
+  (`atlas`, `ait`, `himalaya`, R, quarto, `claude`) absent on a hosted runner.
+  Service-dependent suites skip/degrade cleanly; standalone-behavior suites pin
+  `FLOW_ATLAS_ENABLED=no` so results are identical with or without atlas.
+
 ## [7.10.0] — 2026-06-13 — forward-looking schedule layer (`agenda` + dash UPCOMING)
 
 ### Added

CLAUDE.md

@@ -7,7 +7,7 @@ This file provides guidance to Claude Code when working with code in this reposi
 **flow-cli** - Pure ZSH plugin for ADHD-optimized workflow management. Zero dependencies. Standalone (works without Oh-My-Zsh or any plugin manager).
 
 - **Architecture:** Pure ZSH plugin (no Node.js runtime required)
-- **Current Version:** v7.10.0
+- **Current Version:** v7.10.1
 - **Install:** Homebrew (recommended), or any plugin manager
 - **Source:** `source /opt/homebrew/opt/flow-cli/flow.plugin.zsh` (via Homebrew)
 - **Optional:** Atlas integration for enhanced state management
@@ -136,7 +136,7 @@ flow-cli/
 ├── docs/                     # Documentation (MkDocs)
 │   └── internal/             # Internal conventions & contributor templates
 ├── scripts/                  # Standalone validators (check-math.zsh)
-├── tests/                    # 213 test files, 12000+ test functions
+├── tests/                    # 216 test files, 12000+ test functions
 │   └── fixtures/demo-course/ # STAT-101 demo course for E2E
 └── .archive/                 # Archived Node.js CLI
 ```
@@ -181,7 +181,7 @@ flow-cli/
 
 ## Testing
 
-**213 test files, 12000+ test functions.** Run: `./tests/run-all.sh` (64/64 passing, 1 expected interactive/tmux timeout) or individual suites in `tests/`.
+**216 test files, 12000+ test functions.** Run: `./tests/run-all.sh` (64/64 passing, 1 expected interactive/tmux timeout) or individual suites in `tests/`.
 
 See `docs/guides/TESTING.md` for patterns, mocks, assertions, TDD workflow.
 
@@ -215,8 +215,8 @@ export FLOW_FORCE_DISPATCHER_OBS=1           # Force-keep one dispatcher (FLOW_F
 
 ## Current Status
 
-**Version:** v7.10.0 | **Tests:** 12000+ (64/64 suite, 1 interactive timeout) | **Docs:** https://Data-Wise.github.io/flow-cli/
+**Version:** v7.10.1 | **Tests:** 12000+ (64/64 suite, 1 interactive timeout) | **Docs:** https://Data-Wise.github.io/flow-cli/
 
 ---
 
-**Last Updated:** 2026-06-13 (v7.10.0)
+**Last Updated:** 2026-06-13 (v7.10.1)

README.md

@@ -35,18 +35,17 @@ or any other framework. Choose any installation method that works for you.
 
 ## What's New
 
-### v7.4.0: 31 Email Commands
+### v7.10.0 → v7.10.1: Forward-Looking Schedule Layer + Reliability
 
-- **Organize:** `em star`, `em thread`, `em snooze`, `em digest` — manage your inbox without leaving the terminal
-- **Manage:** `em delete`, `em move`, `em restore`, `em flag`, `em todo`, `em event` — full email lifecycle with `--pick` multi-select
-- **AI:** Switch backends with `em ai gemini`, capture tasks with `em catch 42`
-- **10 Tutorials** — step-by-step guides for every em subcommand
+- **`agenda`** — what's due across all projects: deadlines, lectures, exams, milestones, and recurring weekly blocks, bucketed into OVERDUE / TODAY / THIS WEEK / LATER (`agt`/`agw`/`agm`)
+- **`dash` UPCOMING** + dated enrichment of `morning` / `today` / `week` — one shared engine, works fully **without `yq` and without atlas**
+- **Data sources:** a `## Schedule:` block in each project's `.STATUS`, plus teaching dates from `.flow/teach-config.yml`
+- **v7.10.1 reliability:** Linux-portability fixes (caches, email cache, teaching-date math) + the full test suite is now a required CI gate
 
 ```bash
-em star 42                   # Star a message
-em move 42 Archive           # Move to folder
-em todo 42                   # Create reminder from email
-em pick                      # Interactive multi-select
+agenda                # what's due soon
+agenda --overdue      # only overdue items
+agenda research       # filter by category
 ```
 
 [Full Changelog](docs/CHANGELOG.md) | [All Releases](https://github.com/Data-Wise/flow-cli/releases)

docs/CHANGELOG.md

@@ -8,6 +8,40 @@ The format follows [Keep a Changelog](https://keepachangelog.com/), and this pro
 
 ## [Unreleased]
 
+## [7.10.1] — 2026-06-13 — Linux portability fixes + full-suite CI gate
+
+### Fixed
+
+- **Cache locking errored on Linux** (`lib/doctor-cache.zsh`,
+  `lib/analysis-cache.zsh`): the `flock` path used bash-only high-fd
+  redirection (`exec 201>`/`exec 200>`), which zsh parses as a command and
+  fails with "command not found" on Linux (where `flock` exists). Switched to
+  zsh's dynamic `exec {var}>` allocation. macOS was unaffected (no `flock` →
+  mkdir fallback), so this only ever broke on Linux/CI.
+- **Email cache never worked on Linux** (`lib/em-cache.zsh`): used macOS-only
+  `stat -f %m`, so every entry's mtime read as 0 and looked expired. Added a
+  portable `_em_cache_mtime` (GNU `stat -c %Y` first — it fails cleanly on
+  macOS — then BSD `stat -f %m`).
+- **`teaching_week` computed 0 on Linux** (`lib/teaching-utils.zsh`,
+  `lib/dispatchers/teach-deploy-enhanced.zsh`): used macOS-only `date -j -f`.
+  Added portable date helpers (BSD then GNU `date -d`).
+- **`flow doctor --help-check` false-flagged `tm`** on machines without aiterm
+  (`lib/help-compliance.zsh`): the `tm` dispatcher only loads its help when the
+  `ait` CLI is present, so it's now checked only when `ait` is installed.
+
+### Changed
+
+- **CI now runs the full test suite on every PR.** Added a `full-suite` job to
+  `.github/workflows/test.yml` running `./tests/run-all.sh` (the full 65-suite
+  suite), parallel to the fast smoke job. It started non-blocking
+  (`continue-on-error`); after soaking green on `dev` it is now a **required
+  check on `main`** — a red suite blocks release to production.
+- **`run-all.sh` skip semantics:** exit code **77** now counts a suite as
+  *skipped* (not failed) — used by suites that require an external tool/service
+  (`atlas`, `ait`, `himalaya`, R, quarto, `claude`) absent on a hosted runner.
+  Service-dependent suites skip/degrade cleanly; standalone-behavior suites pin
+  `FLOW_ATLAS_ENABLED=no` so results are identical with or without atlas.
+
 ## [7.10.0] — 2026-06-13 — forward-looking schedule layer (`agenda` + dash UPCOMING)
 
 ### Added

docs/architecture/SCHOLAR-ENHANCEMENT-ARCHITECTURE.md

@@ -1,7 +1,7 @@
 # Scholar Enhancement Architecture
 
 **Feature:** Teaching Content Generation System
-**Version:** v7.10.0
+**Version:** v7.10.1
 **Date:** 2026-01-17
 
 ---
@@ -747,4 +747,4 @@ teach slides -w 8 --style computational
 
 **Last Updated:** 2026-02-27
 **Status:** Production Ready
-**Version:** v7.10.0
+**Version:** v7.10.1

docs/architecture/TEACHING-DATES-ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # Teaching Dates Architecture
 
-**Version:** v7.10.0
+**Version:** v7.10.1
 **Status:** Complete
 **Last Updated:** 2026-02-27
 
@@ -966,5 +966,5 @@ teach dates import-calendar university-calendar.ics
 ---
 
 **Last Updated:** 2026-02-27
-**Version:** v7.10.0
+**Version:** v7.10.1
 **Status:** Complete

docs/diagrams/TEACHING-V3-WORKFLOWS.md

@@ -470,7 +470,7 @@ flowchart TD
 ---
 
 **Generated:** 2026-02-09
-**Version:** v7.10.0 (Teaching Workflow v3.0)
+**Version:** v7.10.1 (Teaching Workflow v3.0)
 **Total Diagrams:** 8
 
 These diagrams provide comprehensive visual documentation for all major Teaching Workflow features.

docs/guides/ATLAS-INTEGRATION-GUIDE.md

@@ -335,4 +335,4 @@ export FLOW_ATLAS_ENABLED=no
 ---
 
 **Last Updated:** 2026-02-22
-**Version:** v7.10.0
+**Version:** v7.10.1

docs/guides/BACKUP-SYSTEM-GUIDE.md

@@ -1,6 +1,6 @@
 # Backup System Guide
 
-**Version:** v7.10.0
+**Version:** v7.10.1
 **Last Updated:** 2026-01-21
 
 ---
@@ -959,5 +959,5 @@ See `lib/backup-helpers.zsh` for implementation details.
 
 ---
 
-**Version:** v7.10.0
+**Version:** v7.10.1
 **Last Updated:** 2026-01-21

docs/guides/CONFIG-MANAGEMENT-WORKFLOW.md

@@ -730,5 +730,5 @@ flow config profile load adhd
 ---
 
 **Last Updated:** 2026-02-27
-**Version:** v7.10.0
+**Version:** v7.10.1
 **Related:** [flow.md](../commands/flow.md), [plugin guide](./PLUGIN-MANAGEMENT-WORKFLOW.md)

docs/guides/COURSE-PLANNING-BEST-PRACTICES.md

@@ -1,6 +1,6 @@
 # Course Planning Best Practices: A Research-Based Guide
 
-**Version:** v7.10.0
+**Version:** v7.10.1
 **Last Updated:** 2026-01-19
 **Target Audience:** Instructors using flow-cli for systematic course design
 **Status:** Phase 1 Complete (Sections 1-2)
@@ -2498,7 +2498,7 @@ teach analytics --outcomes         # Outcome achievement analysis
 
 # Document Metadata
 
-**Version:** v7.10.0
+**Version:** v7.10.1
 **Created:** 2026-01-19
 **Last Updated:** 2026-01-19
 **Authors:** flow-cli development team

docs/guides/DEVELOPER-GUIDE.md

@@ -1,6 +1,6 @@
 # flow-cli Developer Guide
 
-**Version:** v7.10.0
+**Version:** v7.10.1
 **Last Updated:** 2026-02-27
 **Audience:** Contributors, Plugin Developers, Advanced Users
 
@@ -961,4 +961,4 @@ test: add regression test for worktree detection
 ---
 
 **Last Updated:** 2026-02-27
-**Version:** v7.10.0
+**Version:** v7.10.1

docs/guides/DOCTOR-TOKEN-USER-GUIDE.md

@@ -1,6 +1,6 @@
 # Doctor Token Enhancement - User Guide
 
-**Version:** v7.10.0
+**Version:** v7.10.1
 **Last Updated:** 2026-02-27
 
 ---
@@ -633,5 +633,5 @@ Found a bug or have a feature request?
 ---
 
 **Last Updated:** 2026-02-27
-**Version:** v7.10.0
+**Version:** v7.10.1
 **Maintainer:** flow-cli team

docs/guides/DOT-WORKFLOW.md

@@ -507,5 +507,5 @@ Run: sec unlock
 
 ---
 
-**Version:** v7.10.0
+**Version:** v7.10.1
 **See Also:** [Dispatcher Reference](../reference/MASTER-DISPATCHER-GUIDE.md#dots-dispatcher) | [Tutorial](../tutorials/12-dot-dispatcher.md)

docs/guides/INTELLIGENT-CONTENT-ANALYSIS.md

@@ -1,6 +1,6 @@
 # Intelligent Content Analysis Guide
 
-**Version:** v7.10.0
+**Version:** v7.10.1
 **Last Updated:** 2026-01-22
 
 ---