feat: implement vergen crate for git-based versioning (#21)

- Add vergen build dependency with git and gitcl features
- Create build.rs to emit VERGEN_GIT_SHA and VERGEN_GIT_COMMIT_DATE
- Update version output to use short SHA and date (e.g., bbl_parser 14be1ee (2025-12-04))
- Use CARGO_PKG_NAME macro for package name consistency
- Remove hardcoded semantic version references from documentation
- Update .gitignore to whitelist build.rs
- Version now reflects actual git commit info at build time

Author: nerdCopter

.gitignore

@@ -6,6 +6,7 @@
 !OVERVIEW.md
 !GOALS.md
 !FRAMES.md
+!build.rs
 !Cargo.*
 !.gitignore
 !LICENSE

Cargo.lock

@@ -9,6 +9,10 @@ keywords = ["betaflight", "blackbox", "drone", "flight-log", "parser"]
 categories = ["parsing", "aerospace"]
 rust-version = "1.70.0"
 
+[build-dependencies]
+anyhow = "1.0"
+vergen = { version = "8", features = ["git", "gitcl"] }
+
 [dependencies]
 anyhow = "1.0"
 clap = { version = "4.0", features = ["derive"], optional = true }

Cargo.toml

@@ -1,7 +1,6 @@
-# BBL Parser v0.9.0 - Project Overview
+# BBL Parser - Project Overview
 
 **Project Status:** 🚧 **WORK IN PROGRESS**  
-**Version:** 0.9.0  
 **Focus:** High-Performance BBL Processing  
 **⚠️ Not Production Ready**
 
@@ -281,9 +280,3 @@ Exported event data to: BTFL_BLACKBOX_LOG_20250601_121852.event
 - **Performance** adequate but not optimized
 - **Error handling** basic with room for improvement
 - **API stability** documented with migration notes
-
----
-
-**Current Focus:** Core functionality development and testing  
-**Version:** 0.9.0 🚧 Work-in-Progress  
-**⚠️ Not recommended for production use**

OVERVIEW.md

@@ -1,4 +1,4 @@
-# BBL Parser (Work-in-Progress)
+# BBL Parser
 
 A fast, pure-Rust Blackbox Log parser primarily used as a command-line tool, with an optional Rust crate API.
 

README.md

@@ -0,0 +1,10 @@
+use anyhow::Result;
+use vergen::EmitBuilder;
+
+fn main() -> Result<()> {
+    EmitBuilder::builder()
+        .git_sha(true)
+        .git_commit_date()
+        .emit()?;
+    Ok(())
+}

build.rs

@@ -27,6 +27,18 @@ use bbl_parser::types::{FrameDefinition, FrameStats};
 // Import ExportOptions from crate library
 use bbl_parser::ExportOptions;
 
+// Include vergen generated environment variables
+const GIT_SHA: &str = env!("VERGEN_GIT_SHA", "unknown");
+const GIT_COMMIT_DATE: &str = env!("VERGEN_GIT_COMMIT_DATE", "unknown");
+
+// Build version string from git info
+const VERSION_STR: &str = concat!(
+    env!("VERGEN_GIT_SHA", "unknown"),
+    " (",
+    env!("VERGEN_GIT_COMMIT_DATE", "unknown"),
+    ")"
+);
+
 /// Maximum recursion depth to prevent stack overflow
 const MAX_RECURSION_DEPTH: usize = 100;
 
@@ -326,9 +338,14 @@ impl CsvFieldMap {
 }
 
 fn build_command() -> Command {
-    Command::new("BBL Parser")
-        .version(env!("CARGO_PKG_VERSION"))
-        .about("Read and parse BBL blackbox log files. Exports to CSV by default (optionally GPX/JSON).")
+    let about_text = format!(
+        "\n\nRead and parse BBL blackbox log files. Exports to CSV by default (optionally GPX/JSON).\n  {} {} ({})",
+        env!("CARGO_PKG_NAME"), GIT_SHA, GIT_COMMIT_DATE
+    );
+
+    Command::new(env!("CARGO_PKG_NAME"))
+        .version(VERSION_STR)
+        .about(about_text)
         .arg(
             Arg::new("files")
                 .help("BBL files or directories to parse. Direct file paths: .BBL, .BFL, .TXT extensions supported. Directories: recursively finds .BBL/.BFL files only (TXT files must be specified directly). Case-insensitive, supports globbing.")