beta-v2.2.0

[ChaseSunstrom]

CForge Release beta-v2.2.0

Developer Experience & Build Reliability

CForge beta-v2.2.0 brings powerful new commands for day-to-day development workflows, along with significant improvements to build reliability and error reporting.

---

New Commands

cforge watch — File Watching & Auto-Rebuild

Automatically rebuild your project when source files change.

cforge watch                  # Watch and rebuild on changes
cforge watch --run            # Watch, rebuild, and run executable
cforge watch -c Release       # Watch with Release configuration
cforge watch --interval 1000  # Custom poll interval (ms)

Features:

• Watches .cpp, .cc, .cxx, .c, .hpp, .hxx, .h, .toml files
• Automatically ignores build/, .git/, deps/, vendor/ directories
• Optional --run flag to execute after successful builds

---

cforge bench — Benchmark Runner

Run performance benchmarks with Google Benchmark support.

cforge bench                      # Run all benchmarks
cforge bench --filter 'BM_Sort'   # Run matching benchmarks
cforge bench --json > results.json  # JSON output
cforge bench --csv                # CSV output

Configuration (cforge.toml):

[benchmark]
directory = "bench"
target = "my_benchmarks"

---

cforge tree — Dependency Visualization

Visualize your project's dependency tree with color-coded output.

cforge tree        # Show dependency tree
cforge tree -d 2   # Limit depth
cforge tree --all  # Include transitive dependencies

Color Coding:

Color	Type
🔵 Cyan	Git dependencies
🟣 Magenta	vcpkg dependencies
🟡 Yellow	System dependencies
🟢 Green	Project dependencies (workspace)

---

cforge new — Template Generator

Quickly scaffold new files from templates.

cforge new class MyClass         # Create MyClass.hpp + MyClass.cpp
cforge new class MyClass -n myproj  # With namespace
cforge new header utils          # Header-only file
cforge new interface IService    # Abstract interface
cforge new struct Config         # Struct definition
cforge new test MyClass          # Test file

Available Templates: class, header, struct, interface, test, main

---

cforge doc — Documentation Generation

Generate API documentation with Doxygen.

cforge doc          # Generate documentation
cforge doc --init   # Create Doxyfile for customization
cforge doc --open   # Generate and open in browser
cforge doc -o api-docs  # Custom output directory

---

cforge lock — Reproducible Builds

Manage dependency lock files for reproducible builds.

cforge lock           # Generate/update lock file
cforge lock --verify  # Check deps match lock file
cforge lock --force   # Regenerate lock file
cforge lock --clean   # Remove lock file

Best Practices:

1. Commit cforge.lock to version control
2. Run cforge lock --verify in CI pipelines
3. Run cforge lock after adding/updating dependencies

---

cforge fmt — Code Formatting

Format source code with clang-format.

cforge fmt                # Format all files in place
cforge fmt --check        # Check without modifying
cforge fmt --diff         # Show what would change
cforge fmt --style=google # Use Google style

---

cforge lint — Static Analysis

Run static analysis with clang-tidy.

cforge lint                      # Run all checks
cforge lint --fix                # Apply automatic fixes
cforge lint --checks='modernize-*'  # Specific checks

---

cforge completions — Shell Completions

Generate tab-completion scripts for your shell.

cforge completions bash >> ~/.bashrc
cforge completions zsh >> ~/.zshrc
cforge completions powershell >> $PROFILE
cforge completions fish > ~/.config/fish/completions/cforge.fish

---

Build System Improvements

Extended Build Timeouts

• Increased CMake build timeout from 60s to 600s (10 minutes)
• Prevents false failures on slower CI runners and large Release builds

Self-Build Protection

• Fixed Windows packaging issue where cforge.exe couldn't rebuild itself while running
• Added --no-build flag for packaging when build is already complete

New Dependency Hash Format

• Migrated from .cforge_dependency_hashes to cforge.hash
• Human-readable TOML format for dependency state tracking

---

Error Reporting Enhancements

Deduplicated Error Messages

• Fixed duplicate error reporting (e.g., GCC-UNDECL and COMPILER-UNDECLARED for same error)
• Intelligent deduplication preserves the most detailed diagnostic

Cleaner Output

• Removed redundant → Error details: prefix
• Streamlined formatting for better readability

---

Code Quality & Compatibility

• GCC 15 Compatibility: Fixed all compiler warnings
• Security: Replaced unsafe strncpy with snprintf

---

CI/CD Pipeline

Multi-Platform Support

• Windows x64 (MSVC)
• Linux x64 (GCC)
• macOS x64 & ARM64 (Clang)

Package Formats

Platform	Formats
Windows	ZIP
Linux	TGZ, DEB
macOS	TGZ

---

Installation

Upgrade to beta-v2.2.0:

git clone https://github.com/ChaseSunstrom/cforge.git
cd cforge

# Windows
.\scripts\bootstrap.ps1

# Linux/macOS
./scripts/bootstrap.sh

---

Full Command Reference

Command	Description
init	Initialize a new project or workspace
build	Build the project
clean	Clean build artifacts
run	Build and run the project
test	Run tests
package	Create distributable packages
deps	Manage Git dependencies
vcpkg	Manage vcpkg dependencies
install	Install project to system
add	Add a dependency
remove	Remove a dependency
update	Update cforge
ide	Generate IDE project files
list	List dependencies or projects
lock	Manage dependency lock file
fmt	Format code with clang-format
lint	Static analysis with clang-tidy
watch	Watch and auto-rebuild
completions	Generate shell completions
doc	Generate documentation
tree	Visualize dependency tree
new	Create files from templates
bench	Run benchmarks

---

Note: All existing workflows remain compatible.

Please report issues at [github.com/ChaseSunstrom/cforge/issues](https://github.com/ChaseSunstrom/cforge/issues)

---

This discussion was created from the release beta-v2.2.0.