Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
70 changes: 29 additions & 41 deletions .STATUS
Original file line number Diff line number Diff line change
Expand Up @@ -4,59 +4,47 @@
## Project: flow-cli
## Type: zsh-plugin
## Status: active
## Focus: --help
## Phase: v6.6.0 Planning — teach map ecosystem discovery
## Priority: 1
## Progress: 10
## Focus: PR #368 Review — Math Blanks Preflight
## Phase: Active Development
## Priority: 2
## Progress: 30

## Just Completed: v6.5.0 Release — Teach Doctor v2 (2026-02-08)

**v6.5.0 released** — two-mode health check architecture
## Current Session (2026-02-09)

**Session activity:**
- review: code review of PR #360 (teach doctor v2, 38 files, 3918 insertions)
- fix: removed auto-refresh, spinner cleanup trap, doc count consistency, unit test vars
- merge: PR #360 merged to dev with --admin (CI passed)
- docs: post-merge sync (CLAUDE.md, CHANGELOG, site content, tutorial index)
- docs: site content sync (version footers, quick reference, dispatcher guide)
- release: v6.5.0 version bump, release PR #361 → main, tag, GitHub release
- deploy: docs deployed to GitHub Pages
- homebrew: formula updated to v6.5.0

**PRs merged:** #360, #361
- review: code review of PR #368 (math blank-line preflight, +37/-0)
- found: 5 issues — Python dep violates pure-ZSH, missing path resolution, no CI mode, nonexistent script ref, no tests
- plan: fix all issues in existing worktree `feature-math-blanks-preflight`

**PR open:** #368 (needs changes)
**Test suite:** 42/42 passing, 0 timeouts
**Release:** https://github.com/Data-Wise/flow-cli/releases/tag/v6.5.0

---

## Recent Releases

### v6.6.0 (2026-02-09) — Teach Map + Deploy Safety
- `teach map` — unified ecosystem discovery command
- Deploy safety: trap handler, uncommitted prompt, hook recovery, Actions link
- Release: https://github.com/Data-Wise/flow-cli/releases/tag/v6.6.0

### v6.5.0 (2026-02-08) — Teach Doctor v2
- Two-mode health check architecture (quick + full)
- Release: https://github.com/Data-Wise/flow-cli/releases/tag/v6.5.0

### v6.4.3 (2026-02-06) — Bug Fix + Test Coverage
- ZSH `local path=` bug fixed (20+ instances renamed)
- 106 new test assertions (regression, dogfood, e2e)
- run-all.sh: 26 → 34 passing tests
- Release: https://github.com/Data-Wise/flow-cli/releases/tag/v6.4.3

### 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
- 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
- 20 new tests (14 unit + 6 E2E)
- Release: https://github.com/Data-Wise/flow-cli/releases/tag/v6.4.1

---

## Active Worktrees

| Worktree | Branch | Status |
|----------|--------|--------|
| Main repo | `dev` | Clean (v6.5.0 released) |
| `~/.git-worktrees/flow-cli/feature-teach-map` | `feature/teach-map` | WIP — spec + brainstorm ready |
| Main repo | `dev` | Clean |
| `feature-math-blanks-preflight` | `feature/math-blanks-preflight` | PR #368 open — needs fixes |
| `feature-teach-map` | `feature/teach-map` | Stale (already merged) |

---

Expand All @@ -80,15 +68,15 @@

## Next Action

Feature `teach map` (#358) planned and spec'd. Worktree ready for implementation.
- `cd ~/.git-worktrees/flow-cli/feature-teach-map && claude`
- Spec: `docs/specs/SPEC-teach-map-2026-02-08.md`
- Plan: `~/.claude/plans/cryptic-crafting-acorn.md`
1. **Fix PR #368** — `cd ~/.git-worktrees/flow-cli/feature-math-blanks-preflight && claude`
2. Clean up stale `feature-teach-map` worktree
3. Scholar Config Sync (#299) — next feature candidate
4. API documentation push (50% → 80%)

---

**Last Updated:** 2026-02-08
**Status:** v6.5.0 Released | Docs deployed | 42/42 tests passing | 8000+ test functions | 0 timeouts
## wins: Fixed the regression bug (2026-02-09), --category fix squashed the bug (2026-02-09), fixed the bug (2026-02-09), Fixed the regression bug (2026-02-09), --category fix squashed the bug (2026-02-09)
**Last Updated:** 2026-02-09
**Status:** v6.6.0 released | PR #368 under review | 42/42 tests passing | 8000+ test functions
## wins: v6.6.0 released (2026-02-09), deploy safety merged (2026-02-09), teach map merged (2026-02-09), Fixed the regression bug (2026-02-09), --category fix squashed the bug (2026-02-09)
## streak: 1
## last_active: 2026-02-09 13:52
13 changes: 8 additions & 5 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:** v6.6.0
- **Current Version:** v6.7.0
- **Install:** Homebrew (recommended), or any plugin manager
- **Optional:** Atlas integration for enhanced state management
- **Health Check:** `flow doctor` for dependency verification
Expand Down Expand Up @@ -157,6 +157,7 @@ v <cmd> # Vibe coding mode
- `--ci` exits non-zero on failure, no color, machine-readable output
- Health dot shown on `teach` startup (refreshed on next `teach doctor` run)
- **Deploy:** `teach deploy --direct` (8-15s direct merge) or `teach deploy` (PR workflow)
- **Deploy preflight:** Display math `$$` validation (blank lines, unclosed blocks) — also runs at pre-commit via lint-staged
- **Deploy extras:** `--dry-run`, `--ci`, `--history [N]`, `--rollback [N]`
- **Templates:** `.flow/templates/` (content, prompts, metadata, checklists)
- **Macros:** `teach macros list|sync|export` (LaTeX notation consistency)
Expand All @@ -182,7 +183,8 @@ flow-cli/
├── hooks/ # ZSH hooks
├── docs/ # Documentation (MkDocs)
│ └── internal/ # Internal conventions & contributor templates
├── tests/ # 137 test files, 8000+ test functions
├── scripts/ # Standalone validators (check-math.zsh)
├── tests/ # 143 test files, 8000+ test functions
│ └── fixtures/demo-course/ # STAT-101 demo course for E2E
└── .archive/ # Archived Node.js CLI
```
Expand All @@ -198,6 +200,7 @@ flow-cli/
| `docs/reference/MASTER-DISPATCHER-GUIDE.md` | Complete dispatcher docs |
| `docs/reference/MASTER-API-REFERENCE.md` | API function reference |
| `docs/reference/MASTER-ARCHITECTURE.md` | System architecture |
| `scripts/check-math.zsh` | Pre-commit math validator (lint-staged) |
| `.STATUS` | Current progress/sprint tracking |

---
Expand Down Expand Up @@ -248,7 +251,7 @@ Update: `MASTER-DISPATCHER-GUIDE.md`, `QUICK-REFERENCE.md`, `mkdocs.yml`

## Testing

**137 test files, 8000+ test functions.** Run: `./tests/run-all.sh` (42/42 passing, 0 timeouts) or individual suites in `tests/`.
**143 test files, 8000+ test functions.** Run: `./tests/run-all.sh` (42/42 passing, 0 timeouts) or individual suites in `tests/`.

See `docs/guides/TESTING.md` for patterns, mocks, assertions, TDD workflow.

Expand Down Expand Up @@ -276,8 +279,8 @@ export FLOW_DEBUG=1 # Debug mode

## Current Status

**Version:** v6.6.0 | **Tests:** 8000+ (42/42 suite) | **Docs:** https://Data-Wise.github.io/flow-cli/
**Version:** v6.7.0 | **Tests:** 8000+ (42/42 suite) | **Docs:** https://Data-Wise.github.io/flow-cli/

---

**Last Updated:** 2026-02-08 (v6.6.0)
**Last Updated:** 2026-02-10 (v6.7.0)
Loading