v0.6.0 - Complete bd→br migration

Changes

Breaking Changes

• Removed bd alias for br (beads_rust) - use br directly

New Features

• br alias guard: Automatically removes stale alias br='bun run' from older ACFS versions
  • Uses whence -p br to detect binary vs alias (zsh-specific)
  • Ensures br command always points to beads_rust binary

Migrations

• All bd references migrated to br across:
  • Shell config (acfs.zshrc)
  • Web app lessons and tutorials
  • Installer scripts (newproj, doctor, screens)
  • CLI flags (--no-bd → --no-br)
  • Environment variables (AGENTS_ENABLE_BD → AGENTS_ENABLE_BR)
  • State variables (enable_bd → enable_br)
  • Test suites

Bug Fixes

• Fixed mock function in test_newproj_errors.bats using wrong function name
• Fixed shellcheck SC1087 in test_new_tools_e2e.sh

Notes

• Bead IDs (bd-XXXX) are preserved as historical identifiers
• Upgrading users should re-source their shell or restart terminal

ACFS v0.5.0 - DCG & RU Integration Release

ACFS v0.5.0 - DCG & RU Integration Release

This release completes the integration of DCG (Destructive Command Guard) and RU (Repo Updater) as first-class citizens in the ACFS ecosystem, along with significant improvements to the onboarding experience, web application stability, and security.

Highlights

DCG (Destructive Command Guard) - Full Integration

• Complete DCG integration across website, installer, and onboarding
• New DCG lesson in onboarding TUI
• DCG added to flywheel loop lesson and safety-tools-lesson
• Comprehensive DCG test suite with 88+ passing tests
• DCG doctor and update verification tests
• Allow-once workflow tests
• Pack configuration validation tests
• DCG+SLB layered safety integration tests

RU (Repo Updater) - Full Integration

• RU tool page added to learn section
• RU lesson component with structural tests
• E2E Playwright tests for RU pages
• RU integrated into Installer CI workflow
• Multi-repo sync and AI-driven commit automation documentation

Enhanced Onboarding TUI

• File locking for concurrent operations - Prevents race conditions in progress tracking
• Dynamic lesson counts - NUM_LESSONS derived from array length for maintainability
• New lessons: RU and DCG
• Updated certificate and help text with RU/DCG skills
• Lesson count properly updated from 9 to 11

Web Application Improvements

• Error boundary for lesson rendering - Catches JavaScript errors and shows user-friendly recovery UI
• IPv6 zone ID validation security fix - Rejects zone IDs (like %eth0) that are meaningless for remote VPS connections
• maxDelay cap for stagger animations
• Accessibility: Button respects prefers-reduced-motion setting
• Tool page split into server and client components

Security Improvements

• Category name validation in manifest to prevent injection
• Checksum auto-updates for uv and claude
• Error handling improvements in acfs_chown_tree
• State write atomic error capture fixes

Test Infrastructure

• Comprehensive DCG test suite
• RU integration tests
• E2E Playwright tests for DCG and RU pages
• Unit tests for flywheel.ts
• Improved test reliability and TTY handling

Bug Fixes

• Fixed manifest cycle detection consolidation (removed duplicate implementation)
• Removed unused fallback_url field from manifest schema
• Fixed path normalization in screen_directory.sh
• Fixed upgrade detection for LTS version format
• Fixed nested hook structures in DCG removal
• Various shell script reliability improvements

Breaking Changes

None - this release is backwards compatible.

Upgrade Instructions

# One-liner update
curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/agentic_coding_flywheel_setup/main/scripts/update.sh | bash

Contributors

• Claude Opus 4.5 (AI Assistant)

---

Full Changelog: v0.4.0...v0.5.0

v0.4.0 - Expanded Flywheel Stack (10 tools + utilities)

New Flywheel Tools

destructive_command_guard (dcg) - Tool #9

Rust-based Claude Code PreToolUse hook that blocks dangerous git/fs commands with sub-millisecond latency. Replaces the simpler Python-based approach.

• Blocks: recursive deletions, force pushes, hard resets, etc.
• Auto-bypass for confirmed intention
• <1ms hook latency via native Rust binary

repo_updater (ru) - Tool #10

17K-line Bash tool for multi-repo sync + AI-driven commit automation.

• Batch sync multiple repos with smart stash handling
• AI-powered commit message generation
• Interactive commit review/editing

New Utilities

giil (Get Image from Internet Link)

Downloads cloud-hosted images (iCloud, Dropbox, Google Photos) for visual debugging in SSH/headless environments where clipboard isn't available.

csctf (Chat Shared Conversation to File)

Converts AI chat share links (Claude, ChatGPT, Grok) to Markdown/HTML archives with full formatting preservation.

Changes

• Updated all documentation to reflect 10-tool stack
• Added checksums for all 4 new installers (security.sh verified)
• Regenerated installer scripts from manifest
• Updated web app tool counts throughout

Full Changelog

v0.3.0...v0.4.0

ACFS v0.3.0 - TUI Wizard & Security Release

🎉 ACFS v0.3.0 - TUI Wizard & Security Release

This release introduces a complete interactive TUI wizard for project creation, comprehensive test infrastructure, and includes a critical security fix.

---

🔒 Security

Critical Fix: Command Injection Vulnerability

• Fixed command injection in validate_directory() - The previous implementation used eval echo "$dir" for tilde expansion, which could allow arbitrary command execution if a malicious path was entered
• New safe implementation uses pattern matching for ~ and ~/path expansion without eval
• Commit: 6c6e899

---

✨ Features

Complete TUI Wizard for Project Creation

The newproj command now supports a full interactive TUI mode with 9 screens:

Screen	Description
Welcome	Introduction with keyboard navigation hints
Project Name	Input with real-time validation
Directory	Path selection with tilde expansion
Tech Stack	Auto-detection + manual selection
Features	Toggle AGENTS.md, beads, Claude settings
AGENTS.md Preview	Live preview with syntax highlighting
Confirmation	Review all settings before creation
Progress	Real-time creation progress
Success	Summary with next steps

Usage:

newproj --interactive  # or -i
newproj myproject ./path  # CLI mode (non-interactive)

Smart AGENTS.md Generation

• Tech stack detection for Python, Node.js, Rust, Go, Ruby, PHP, Java
• Context-aware sections based on detected technologies
• Best practices tailored to each stack

Testing Infrastructure

• 284 unit tests using bats-core framework
• 53 E2E tests covering happy paths, navigation, and error recovery
• Expect-based TUI testing for full interactive workflow verification
• Test helpers: verify_project_created, verify_feature_enabled, screen matchers

---

🐛 Bug Fixes

TUI Wizard Fixes

• Fixed ASCII box alignment in welcome screen
• Fixed file tree rendering for nested paths
• Fixed tech stack display name in confirmation screen
• Added missing .gitignore to success screen
• Fixed safe arithmetic increment to avoid set -e issues
• Handle unconfigured git user gracefully

Test Suite Fixes

• Fixed strict mode violations
• Resolved flaky navigation test timing
• Fixed test helper quoting issues

Other Fixes

• Corrected SSH keepalive check in doctor
• Fixed Claude auth and PostgreSQL role checks
• Corrected bd install message in newproj

---

📚 Documentation

• TUI Wizard Design Document with ASCII mockups
• Research findings for terminal UI best practices
• Comprehensive test README with usage examples

---

📦 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.3.0

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

Update Existing Installation

acfs update --all

---

📊 Commits Since v0.2.0

Type	Count
Security	1
Features	11
Bug Fixes	13
Documentation	2
Chores	1
Total	28

---

🧪 Test Coverage

Unit Tests:     284 passing
E2E Tests:       53 passing (16 with expect, 37 CLI-only)

---

Full Changelog: v0.2.0...v0.3.0

ACFS v0.2.0 - Documentation & Polish Release

🎉 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

Type	Count
Features	2
Bug Fixes	6
Documentation	4
Refactoring	1
Security/Checksums	7
Total	19

---

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

ACFS v0.1.0 - Initial Release

ACFS v0.1.0 - Initial Release

The first public release of the Agentic Coding Flywheel Setup (ACFS) installer.

What is ACFS?

ACFS is a comprehensive installer for setting up an AI-powered development environment. It provides:

• Three-tier agent system: Claude Code, Codex CLI, and Gemini CLI
• Named tmux manager (NTM): Agent cockpit for managing coding sessions
• Unified session search (CASS): Search across all agent session history
• Procedural memory (CM): Agent memory system for persistent context
• Auth switching (CAAM): Instant switching between different API keys
• Security guardrails (SLB): Two-person rule for dangerous commands
• Interactive onboarding: Tutorial to get started quickly
• Self-healing acfs doctor: Diagnose and fix issues automatically

Installation

curl -fsSL https://agent-flywheel.com/install | bash

Recent Fixes

• CASS wrapper installation: Fixed detection of when the CASS robot compatibility wrapper needs to be installed (#25)
• CI workflow stability: Fixed stderr corruption issues in checksum verification workflows
• Checksum verification: Comprehensive E2E tests for the security checksum system
• Doctor improvements: Added fix messages and headless authentication hints

Requirements

• Ubuntu 24.04 or 25.04 (fresh install recommended)
• At least 20GB free disk space
• Internet connection for downloading tools

Documentation

See the README for full documentation.

---

🤖 Generated with Claude Code