Merge pull request #346 from Data-Wise/dev

Release: v6.4.2 site sync

Author: Data-Wise

.STATUS

@@ -4,49 +4,44 @@
 ## Project: flow-cli
 ## Type: zsh-plugin
 ## Status: active
-## Phase: v6.4.1 Released & Deployed
+## Phase: v6.4.2 Released & Deployed
 ## Priority: 1
 ## Progress: 100
 
-## Just Completed: v6.4.1 - Deploy Progress & Summary (2026-02-04)
+## Just Completed: v6.4.2 - Docs Cleanup & Reorganization (2026-02-04)
 
-**Released:** v6.4.1 — Deploy Step Progress + Deployment Summary Box
-**Tag:** v6.4.1
-**Release:** https://github.com/Data-Wise/flow-cli/releases/tag/v6.4.1
+**Released:** v6.4.2 — Orphaned docs cleanup + internal/ reorganization
+**Tag:** v6.4.2
+**Release:** https://github.com/Data-Wise/flow-cli/releases/tag/v6.4.2
 **Docs:** https://data-wise.github.io/flow-cli/
 
 **What shipped:**
-- **Deploy Step Progress** — `[1/5]..[5/5]` numbered steps during direct merge
-- **Deployment Summary Box** — Unicode box with files, duration, commit, URL
-- **Git checkout noise suppressed** — stderr redirected during deploy steps
-- **20 new tests** — 14 unit + 6 E2E assertions
-- **Documentation updated** — REFCARD, tutorial 31, deploy guide, CHANGELOG, API reference
-- **README consolidated** — 8 stale What's New sections → concise v6.4.1 summary
-- **CLAUDE.md updated** — All version references bumped to v6.4.1
-
-**New functions:**
-- `_deploy_step()` — Step progress with done/active/fail states
-- `_deploy_summary_box()` — Post-deploy summary for both modes
-- 4 new exported variables: `DEPLOY_FILE_COUNT`, `DEPLOY_INSERTIONS`, `DEPLOY_DELETIONS`, `DEPLOY_SHORT_HASH`
-
-**Session activity (9 commits):**
-- feat: deploy step progress and summary box
-- test: deploy step progress and summary box tests
-- chore: update CLAUDE.md for v6.4.1
-- fix: suppress git checkout noise during deploy
-- test: E2E deploy step progress assertions
-- docs: update deploy documentation for v6.4.1 output format
-- docs: update MASTER-API-REFERENCE with deploy functions
-- docs: update badges, index page, and consolidate README
-- docs: update CLAUDE.md with v6.4.1 version info
-
-**PRs merged:** #338, #339, #340, #341
-**Docs deployed:** 2x (fixed stale gh-pages ref with `git fetch origin gh-pages`)
+- **54 orphaned doc pages removed** — planning archives, obsolete guides, duplicate tutorials, stale implementation notes
+- **docs/internal/ created** — conventions and contributor templates moved to internal/
+- **3 nav entries added** — Doctor Token Guide, Prompt Dispatcher Guide, Date Automation tutorial
+- **10 broken cross-references fixed** — testing/TESTING.md, TEACHING-QUICK-START.md, help/00-START-HERE.md
+- **mkdocs.yml exclude globs updated** — internal/ subdirectories properly excluded
+- **CLAUDE.md updated** — accurate file counts (62 lib, 31 commands, 126 test files, 2400+ test functions)
+- **Zero MkDocs warnings** — clean build verified
+
+**Session activity:**
+- docs: clean up 54 orphaned pages, reorganize internal docs
+- docs: update CLAUDE.md with accurate file counts and docs/internal/
+
+**PRs merged:** #344, #345
+**Docs deployed:** 2x
 
 ---
 
 ## Recent Releases
 
+### v6.4.2 (2026-02-04) — Docs Cleanup & Reorganization
+- 54 orphaned doc pages removed (32,636 lines)
+- docs/internal/ for conventions and contributor templates
+- 3 new nav entries, 10 cross-reference fixes
+- CLAUDE.md synced with accurate file counts
+- Release: https://github.com/Data-Wise/flow-cli/releases/tag/v6.4.2
+
 ### v6.4.1 (2026-02-04) — Deploy Progress & Summary
 - Step-by-step progress `[1/5]..[5/5]` during direct deploy
 - Deployment summary box with files, duration, commit info
@@ -57,10 +52,6 @@
 - Direct merge mode (8-15s deploys), smart commits, history, rollback, dry-run, CI mode
 - Teaching style consolidation from `.flow/teach-config.yml`
 - 9-rule help compliance checker for all 12 dispatchers
-- Website reorganization (14 → 7 sections), 11 new teaching docs
-- Comprehensive chezmoi safety features
-- Token automation Phase 1 (isolated checks, smart caching, 20x faster)
-- AI prompt management, content analysis, template management
 - Release: https://github.com/Data-Wise/flow-cli/releases/tag/v6.4.0
 
 ---
@@ -69,7 +60,7 @@
 
 | Worktree | Branch | Status |
 |----------|--------|--------|
-| Main repo | `dev` | Clean (v6.4.1 released) |
+| Main repo | `dev` | Clean (v6.4.2 released) |
 
 ---
 
@@ -101,7 +92,7 @@ Session complete. Possible next steps:
 ---
 
 **Last Updated:** 2026-02-04
-**Status:** v6.4.1 Released | Docs deployed | All tests passing | 563+ total tests
+**Status:** v6.4.2 Released | Docs deployed | All tests passing | 2400+ test functions
 ## wins: --category fix squashed the bug (2026-02-04), fixed the bug (2026-02-04), --category fix squashed the bug (2026-02-04), fixed the bug (2026-02-04), --category fix squashed the bug (2026-02-04)
 ## streak: 0
 ## last_active: 2026-02-04 15:49

docs/CHANGELOG.md

@@ -6,6 +6,30 @@ The format follows [Keep a Changelog](https://keepachangelog.com/), and this pro
 
 ---
 
+## [6.4.2] - 2026-02-04
+
+### Removed
+
+- **54 orphaned doc pages** — planning archives, obsolete guides, duplicate tutorials, stale implementation notes (32,636 lines removed)
+
+### Added
+
+- **`docs/internal/` directory** — conventions and contributor templates organized into internal/
+- **3 nav entries** — Doctor Token Guide, Prompt Dispatcher Guide, Date Automation tutorial
+
+### Fixed
+
+- 10 broken cross-references across testing, teaching, and help docs
+- `mkdocs.yml` exclude globs updated for internal/ subdirectories
+
+### Documentation
+
+- CLAUDE.md updated with accurate file counts (62 lib, 31 commands, 126 test files)
+- CHANGELOG.md rewritten to Keep a Changelog format (2442 → 576 lines)
+- Zero MkDocs build warnings
+
+---
+
 ## [6.4.1] - 2026-02-04
 
 ### Added

docs/help/QUICK-REFERENCE.md

@@ -8,8 +8,8 @@ tags:
 
 **Purpose:** Single-page command lookup for all flow-cli features
 **Format:** Copy-paste ready with expected outputs
-**Version:** v6.4.0
-**Last Updated:** 2026-02-02
+**Version:** v6.4.2
+**Last Updated:** 2026-02-04
 
 ---
 
@@ -1025,6 +1025,6 @@ mcp help
 
 ---
 
-**Version:** v6.4.0
-**Last Updated:** 2026-02-02
+**Version:** v6.4.2
+**Last Updated:** 2026-02-04
 **Contributors:** See [CHANGELOG.md](../CHANGELOG.md)

docs/index.md

@@ -26,8 +26,8 @@ tags:
     ```
     **That's it!** No configuration required.
 
-!!! success "🎉 What's New: v6.4.1 - Deploy Progress & Summary"
-    Step-by-step progress `[1/5]..[5/5]` during direct deploy. Deployment summary box with files, duration, and commit info. Plus: deploy history, rollback, smart commits.
+!!! success "🎉 What's New: v6.4.2 - Docs Cleanup & Reorganization"
+    Removed 54 orphaned doc pages. Created `docs/internal/` for conventions and contributor templates. Fixed 10 broken cross-references. Clean MkDocs build with zero warnings.
     [→ See what's new](CHANGELOG.md){ .md-button }
     [→ All releases](RELEASES.md){ .md-button }