Skip to content

Release: v6.4.0 #336

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Data-Wise merged 16 commits into from
Feb 4, 2026
Merged

Release: v6.4.0 #336

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
f784cc9
chore: update CLAUDE.md to v6.3.0
Feb 4, 2026
5fca39c
docs: add teach deploy v2 spec and brainstorm
Feb 4, 2026
c27dcd6
feat: teach deploy v2 — direct merge, smart commits, history, rollbac…
Feb 4, 2026
29dd228
docs: update CLAUDE.md for v6.4.0 teach deploy v2
Feb 4, 2026
4c3aa83
test: add 51-test dogfooding suite for teach deploy v2
Feb 4, 2026
604dfd3
docs: add teach deploy v2 documentation
Feb 4, 2026
d41a263
docs: add deploy v2 docs to mkdocs.yml navigation
Feb 4, 2026
aac256e
fix: address code review issues in teach deploy v2
Feb 4, 2026
036e421
test: add merge commit rollback regression tests
Feb 4, 2026
83913a1
chore: update auto-generated metadata after test runs
Feb 4, 2026
1936084
docs: update documentation for teach deploy v2
Feb 4, 2026
19e7945
docs: regenerate deploy v2 GIF and embed in tutorial + guide
Feb 4, 2026
66d2ce1
docs: update version badges and site content for v6.4.0
Feb 4, 2026
9eca021
Merge pull request #335 from Data-Wise/feature/teach-deploy-v2
Data-Wise Feb 4, 2026
08b4ff8
chore: update version footers to v6.4.0, fix deploy timing refs, dele…
Feb 4, 2026
f9ec8d2
chore: bump version to 6.4.0
Feb 4, 2026
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
4 changes: 2 additions & 2 deletions .STATUS
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1709,6 +1709,6 @@ E) **Quarto Workflow Enhancements** (Additional validators)

**Last Updated:** 2026-02-02
**Status:** v6.2.0 Released ✅ | Docs deployed ✅ | Website reorganized (14→7 sections) ✅ | 0 build warnings ✅
## wins: --category fix squashed the bug (2026-02-02), fixed the bug (2026-02-02), --category fix squashed the bug (2026-01-31), fixed the bug (2026-01-31), --category fix squashed the bug (2026-01-31)
## wins: --category fix squashed the bug (2026-02-03), fixed the bug (2026-02-03), --category fix squashed the bug (2026-02-03), fixed the bug (2026-02-03), --category fix squashed the bug (2026-02-03)
## streak: 0
## last_active: 2026-02-02 17:08
## last_active: 2026-02-03 22:01
79 changes: 79 additions & 0 deletions .archive/BRAINSTORM-teach-deploy-v2-2026-02-03.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
# teach deploy v2 — Brainstorm

**Generated:** 2026-02-03
**Context:** flow-cli v6.3.0 (`teach deploy` enhancement)
**Mode:** deep + feature + save
**Duration:** ~10 min

## Overview

Port STAT-545's battle-tested deploy patterns into flow-cli's `teach deploy` command, plus add dry-run, history, rollback, and CI mode. Consolidate the two deploy code paths into one.

## Current Pain Points

1. **Slow PR workflow** (45-90s) — STAT-545 has a 8-15s direct merge script
2. **Generic commit messages** — `"Update: 2026-02-03"` vs smart `content: week-05 lecture, assignment 5`
3. **No deployment tracking** — No history of what was deployed when
4. **No rollback** — Manual `git revert` only
5. **No dry-run** — Can't preview without executing
6. **Two code paths** — `_teach_deploy()` and `_teach_deploy_enhanced()` with inconsistent behavior
7. **No CI support** — Prompts block non-interactive use
8. **No .STATUS integration** — Teaching week / progress not tracked on deploy

## Quick Wins (Phase 0-1)

1. Delete old `_teach_deploy()` dead code (~340 lines removed)
2. Add `--ci` flag + TTY auto-detection
3. Extract shared `_deploy_preflight_checks()`

## Medium Effort (Phase 2-4)

4. Smart commit messages from changed file categories
5. `--direct` flag for direct merge mode (8-15s)
6. Branch divergence detection + recovery
7. `--dry-run` preview mode

## Larger Effort (Phase 5-6)

8. Deploy history log (`.flow/deploy-history.yml`)
9. `--rollback [N]` with interactive picker
10. `.STATUS` auto-updates (teaching week, progress, deploy count)

## Options Considered

### Option A: Phase It (rejected by user)
Port STAT-545 first, then add new features.
**Pros:** Smaller PRs, faster feedback
**Cons:** More branches, more merge overhead

### Option B: All at Once (selected)
Single feature branch with everything.
**Pros:** One implementation pass, coherent design
**Cons:** Larger PR, more risk

### Option C: Skip Rollback (not selected)
Defer rollback + history to a future release.
**Pros:** Simpler scope
**Cons:** History is needed for rollback, and both are useful independently

## Recommended Path

All 8 features + 1 refactor in a single `feature/teach-deploy-v2` branch. Implementation follows a dependency-ordered 7-phase plan where CI mode comes first (every feature needs it), then smart commits, direct merge, dry-run, history+rollback, .STATUS updates, and finally help/docs.

## Key Design Decisions

1. **`--direct` replaces `--direct-push`** — shorter name, `--direct-push` kept as alias
2. **deploy-history.yml uses append-only writes** — no yq rewrite of entire file
3. **Rollback uses `git revert`** — forward rollback, not destructive reset
4. **CI mode auto-detects from TTY** — plus explicit `--ci` flag override
5. **Smart commit messages are overridable** — `--message "text"` takes precedence
6. **.STATUS updates are non-destructive** — skip if file doesn't exist

## Next Steps

1. [ ] Create worktree: `feature/teach-deploy-v2`
2. [ ] Implement Phase 0: Consolidation
3. [ ] Implement Phase 1-6 sequentially
4. [ ] Run full test suite
5. [ ] Update help + CLAUDE.md
6. [ ] PR to dev
Loading