Dicklesworthstone/agentic_coding_flywheel_setup v0.2.0

ACFS v0.2.0 - Documentation & Polish Release

on GitHub

🎉 ACFS v0.2.0 - Documentation & Polish Release

This release focuses on comprehensive documentation, shell UX improvements, and agent configuration fixes. The README has been expanded by over 1,000 lines with detailed explanations of every system component.

✨ Features

Shell Experience Enhancements

• 6 New Oh-My-Zsh Plugins included by default:

  Plugin	Purpose
  python	Python aliases (pyfind, pyclean, pygrep)
  pip	pip completion and cache management
  tmux	tmux aliases (ta, tad, ts, tl, tkss)
  tmuxinator	tmuxinator project completion
  systemd	systemctl aliases (sc-status, sc-start)
  rsync	rsync completion and common flags

Analytics

• Comprehensive GA4 acquisition tracking
• Diagnostic tools for analytics debugging

🐛 Bug Fixes

Agent Configuration

• Gemini CLI: Fixed tmux compatibility issues with terminal detection
• Gemini CLI: Corrected heredoc syntax and file ownership bugs
• jq Handling: Fixed alternative operator (//) treating false as falsy

CI/CD

• Resolved YAML lint warnings in workflow files
• Fixed shellcheck issues in installer scripts
• Corrected SSH key TTY handling for non-interactive environments

E2E Tests

• Fixed strict mode violations in test suite
• Resolved flaky navigation test timing issues

📚 Documentation

The README has been massively expanded with detailed technical documentation:

New Sections Added

• Tmux Configuration Deep Dive: Agent workflow optimizations, vim-style copy mode, Catppuccin theme details
• Wizard State Management: TanStack Query architecture with optimistic updates and cross-tab sync
• Generated Manifest Index: Bash associative arrays for runtime module metadata
• Jargon Component: Responsive tooltip system (desktop hover, mobile bottom sheet)
• Shell Keybindings: Quality of life bindings reference table
• Learning Hub: 10 interactive lessons with completion tracking
• CI/CD Automation: Checksum monitoring, production smoke tests, Playwright E2E
• Provider Guides: Contabo, OVH, Hetzner comparison with recommendations
• Validation System: Error codes, Tarjan's SCC algorithm for cycle detection
• Test Harness: harness_* API documentation for integration testing

Documentation Stats

• ~1,000+ new lines of documentation
• 4 comprehensive README commits
• Every major system component now documented

🔧 Maintenance

• refactor(cass): Removed obsolete robot wrapper code
• chore(security): Multiple upstream checksum auto-updates for cass, uv, cm

📦 Installation

Fresh Install (Recommended)

curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/install.sh?$(date +%s)" | bash -s -- --yes --mode vibe

Pin to v0.2.0

ACFS_REF=v0.2.0 curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/v0.2.0/install.sh" | bash -s -- --yes --mode vibe

Update Existing Installation

acfs update --all

📊 Commits Since v0.1.0

Full Changelog: v0.1.0...v0.2.0