docs: update README.md (#135)

Author: wislertt

.claude/plan/48-docs-restructure.md

@@ -54,7 +54,7 @@
 
 4. **Usage Examples** 🚧 - Copy-paste examples by command
     - **Content**:
-        - **zerv flow**: Automated branch-based versions with comprehensive documentation:
+        - ✅ **zerv flow**: Automated branch-based versions with comprehensive documentation:
             - ✅ **Core Principles**: 4 fundamental design principles
             - ✅ **Version Format Explained**: Structure, components, and variations with examples
             - ✅ **Pre-release Resolution Strategy**: Branch patterns, post-release logic, distance modes
@@ -67,13 +67,13 @@
             - ✅ **Branch Rules**: Configurable pattern matching (default GitFlow) for pre-release automation
             - ✅ **Pre-release Control**: Labels (alpha/beta/rc), numbers, hash-based identification
             - ✅ **Post Mode Options**: Tag distance vs commit distance calculation modes
-        - **zerv version**: Manual control with 4 main capability areas:
+        - ✅ **zerv version**: Manual control with 4 main capability areas:
             - ✅ **Schema Variants**: 20+ presets (standard, calver families) and custom RON schemas
             - ✅ **VCS Overrides**: Override tag version, distance, dirty state, branch, commit data
             - ✅ **Version Bumping**: Field-based bumps (major/minor/patch) and schema-based bumps
-            - **Component Overrides**: Fine-grained control over individual version components
-        - **zerv check**: Version validation for different formats
-        - **Input/Output & Piping**: Shared capabilities for both zerv version and zerv flow:
+            - ✅ **Component Overrides**: Fine-grained control over individual version components
+        - ✅ **zerv check**: Version validation for different formats
+        - ✅ **Input/Output & Piping**: Shared capabilities for both zerv version and zerv flow:
             - Source options: git, stdin
             - Output formats: semver, pep440, zerv
             - Template customization and prefix support

Cargo.lock

@@ -34,71 +34,12 @@ test_easy:
 test:
 	ZERV_TEST_NATIVE_GIT=false ZERV_TEST_DOCKER=true $(MAKE) _test
 
-test_flaky:
-	@echo "🚀 Starting flaky test detection with 5 iterations..."
-	@echo "=================================================="
-	@set -o pipefail; \
-	start_time=$$(date +%s); \
-	total_time=0; \
-	success_count=0; \
-	failed_iteration=0; \
-	for i in 1 2 3 4 5; do \
-		echo ""; \
-		echo "=== Iteration $$i/5 ==="; \
-		iter_start=$$(date +%s); \
-		echo "⏰ Start time: $$(date)"; \
-		echo "🔍 Running tests..."; \
-		ZERV_TEST_NATIVE_GIT=false ZERV_TEST_DOCKER=true $(MAKE) _test 2>&1 | tee /tmp/test_output_$$i.log; \
-		test_exit_code=$$?; \
-		iter_end=$$(date +%s); \
-		iter_duration=$$((iter_end - iter_start)); \
-		if [ $$test_exit_code -eq 0 ]; then \
-			total_time=$$((total_time + iter_duration)); \
-			success_count=$$((success_count + 1)); \
-			echo "✅ Iteration $$i completed successfully in $${iter_duration}s"; \
-			echo "⏰ End time: $$(date)"; \
-			rm -f /tmp/test_output_$$i.log; \
-		else \
-			failed_iteration=$$i; \
-			echo ""; \
-			echo "❌ FAILED at iteration $$i after $${iter_duration}s (exit code: $$test_exit_code)"; \
-			echo "⏰ End time: $$(date)"; \
-			echo ""; \
-			echo "🚨 FLAKINESS DETECTED - Test failed at iteration $$i"; \
-			echo "Total successful iterations: $$((i-1))/5"; \
-			echo ""; \
-			echo "📋 FAILURE DETAILS:"; \
-			echo "=================================================="; \
-			if [ -f /tmp/test_output_$$i.log ]; then \
-				echo "Last 50 lines of test output:"; \
-				tail -50 /tmp/test_output_$$i.log; \
-				echo ""; \
-				echo "Full test output saved to: /tmp/test_output_$$i.log"; \
-			else \
-				echo "No test output captured"; \
-			fi; \
-			echo "=================================================="; \
-			break; \
-		fi; \
-	done; \
-	if [ $$failed_iteration -gt 0 ]; then \
-		exit 1; \
-	fi; \
-	end_time=$$(date +%s); \
-	total_duration=$$((end_time - start_time)); \
-	avg_time=$$((total_time / success_count)); \
-	echo ""; \
-	echo "=================================================="; \
-	echo "✅ ALL 5 ITERATIONS PASSED - NO FLAKINESS DETECTED"; \
-	echo "📊 PERFORMANCE SUMMARY:"; \
-	echo "   Total time: $${total_duration}s"; \
-	echo "   Average iteration time: $${avg_time}s"; \
-	echo "   Success rate: 5/5 (100%)"; \
-	echo "=================================================="
-
 open_coverage:
 	open coverage/tarpaulin-report.html
 
 .PHONY: docs
 docs:
 	cargo xtask generate-docs
+
+extract_mermaid_svgs:
+	@./scripts/extract_mermaid_from_markers.sh