feat: add CI/CD workflows and release binary publishing

- Add CI workflow (test, clippy, fmt on ubuntu/macos/windows)
- Add release workflow (cross-compile binaries on tag push for linux/macos/windows x86_64 + linux/macos aarch64)
- Fix all clippy warnings (collapsible ifs, unnecessary filter_map, manual prefix strip)
- Run cargo fmt across all source files
- Update README with install instructions (pre-built binaries, cargo install from git)
- Fix repository URL in Cargo.toml

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: corvid-agent

.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo build --verbose
+      - run: cargo test --verbose
+      - run: cargo clippy -- -D warnings
+
+  fmt:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - run: cargo fmt --check

.github/workflows/release.yml

@@ -0,0 +1,89 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+            artifact: specsync-linux-x86_64
+          - os: ubuntu-latest
+            target: aarch64-unknown-linux-gnu
+            artifact: specsync-linux-aarch64
+          - os: macos-latest
+            target: x86_64-apple-darwin
+            artifact: specsync-macos-x86_64
+          - os: macos-latest
+            target: aarch64-apple-darwin
+            artifact: specsync-macos-aarch64
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+            artifact: specsync-windows-x86_64.exe
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
+
+      - name: Install cross-compilation tools (Linux aarch64)
+        if: matrix.target == 'aarch64-unknown-linux-gnu'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y gcc-aarch64-linux-gnu
+          echo "CARGO_TARGET_AARCH64_UNKNOWN_LINUX_GNU_LINKER=aarch64-linux-gnu-gcc" >> $GITHUB_ENV
+
+      - uses: Swatinem/rust-cache@v2
+
+      - name: Build
+        run: cargo build --release --target ${{ matrix.target }}
+
+      - name: Package (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          cp target/${{ matrix.target }}/release/specsync ${{ matrix.artifact }}
+          chmod +x ${{ matrix.artifact }}
+          tar czf ${{ matrix.artifact }}.tar.gz ${{ matrix.artifact }}
+
+      - name: Package (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          cp target/${{ matrix.target }}/release/specsync.exe ${{ matrix.artifact }}
+          Compress-Archive -Path ${{ matrix.artifact }} -DestinationPath ${{ matrix.artifact }}.zip
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact }}
+          path: |
+            ${{ matrix.artifact }}.tar.gz
+            ${{ matrix.artifact }}.zip
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: Create release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: |
+            artifacts/**/*.tar.gz
+            artifacts/**/*.zip

Cargo.toml

@@ -4,7 +4,7 @@ version = "1.0.0"
 edition = "2024"
 description = "Bidirectional spec-to-code validation — language-agnostic, blazing fast"
 license = "MIT"
-repository = "https://github.com/corvid-agent/specsync"
+repository = "https://github.com/CorvidLabs/spec-sync"
 keywords = ["spec", "documentation", "validation", "coverage"]
 categories = ["development-tools", "command-line-utilities"]
 

README.md

@@ -32,13 +32,39 @@ Language is auto-detected from file extensions. The same spec format works for a
 
 ## Install
 
+### Pre-built binaries (recommended)
+
+Download the latest binary from [GitHub Releases](https://github.com/CorvidLabs/spec-sync/releases):
+
 ```bash
-# From source
-cargo install --path .
+# macOS (Apple Silicon)
+curl -sL https://github.com/CorvidLabs/spec-sync/releases/latest/download/specsync-macos-aarch64.tar.gz | tar xz
+sudo mv specsync-macos-aarch64 /usr/local/bin/specsync
+
+# macOS (Intel)
+curl -sL https://github.com/CorvidLabs/spec-sync/releases/latest/download/specsync-macos-x86_64.tar.gz | tar xz
+sudo mv specsync-macos-x86_64 /usr/local/bin/specsync
+
+# Linux (x86_64)
+curl -sL https://github.com/CorvidLabs/spec-sync/releases/latest/download/specsync-linux-x86_64.tar.gz | tar xz
+sudo mv specsync-linux-x86_64 /usr/local/bin/specsync
 
-# Or build release binary
-cargo build --release
-# Binary at: target/release/specsync
+# Linux (aarch64)
+curl -sL https://github.com/CorvidLabs/spec-sync/releases/latest/download/specsync-linux-aarch64.tar.gz | tar xz
+sudo mv specsync-linux-aarch64 /usr/local/bin/specsync
+```
+
+Windows: download `specsync-windows-x86_64.exe.zip` from the releases page.
+
+### From source
+
+```bash
+cargo install --git https://github.com/CorvidLabs/spec-sync
+
+# Or clone and build
+git clone https://github.com/CorvidLabs/spec-sync.git
+cd spec-sync
+cargo install --path .
 ```
 
 ## Quick start
@@ -187,7 +213,21 @@ Flags:
 ## CI integration
 
 ```yaml
-# GitHub Actions
+# GitHub Actions — install from release binary
+- name: Install specsync
+  run: |
+    curl -sL https://github.com/CorvidLabs/spec-sync/releases/latest/download/specsync-linux-x86_64.tar.gz | tar xz
+    sudo mv specsync-linux-x86_64 /usr/local/bin/specsync
+
+- name: Spec check
+  run: specsync check --strict --require-coverage 100
+```
+
+```yaml
+# Or install from source (slower but always up to date)
+- name: Install specsync
+  run: cargo install --git https://github.com/CorvidLabs/spec-sync
+
 - name: Spec check
   run: specsync check --strict --require-coverage 100
 ```

src/exports/csharp.rs

@@ -1,11 +1,9 @@
 use regex::Regex;
 use std::sync::LazyLock;
 
-static COMMENT_SINGLE: LazyLock<Regex> =
-    LazyLock::new(|| Regex::new(r"//.*$").unwrap());
+static COMMENT_SINGLE: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"//.*$").unwrap());
 
-static COMMENT_MULTI: LazyLock<Regex> =
-    LazyLock::new(|| Regex::new(r"(?s)/\*.*?\*/").unwrap());
+static COMMENT_MULTI: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"(?s)/\*.*?\*/").unwrap());
 
 /// C# public/internal types: class, struct, interface, enum, record, delegate
 static CS_TYPE: LazyLock<Regex> = LazyLock::new(|| {

src/exports/dart.rs

@@ -1,19 +1,14 @@
 use regex::Regex;
 use std::sync::LazyLock;
 
-static COMMENT_SINGLE: LazyLock<Regex> =
-    LazyLock::new(|| Regex::new(r"//.*$").unwrap());
+static COMMENT_SINGLE: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"//.*$").unwrap());
 
-static COMMENT_MULTI: LazyLock<Regex> =
-    LazyLock::new(|| Regex::new(r"(?s)/\*.*?\*/").unwrap());
+static COMMENT_MULTI: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"(?s)/\*.*?\*/").unwrap());
 
 /// Dart top-level declarations: class, mixin, enum, extension, typedef
 /// In Dart, anything NOT prefixed with _ is public.
 static DART_TYPE: LazyLock<Regex> = LazyLock::new(|| {
-    Regex::new(
-        r"(?m)^(?:abstract\s+)?(?:class|mixin|enum|extension|typedef)\s+([A-Z]\w*)",
-    )
-    .unwrap()
+    Regex::new(r"(?m)^(?:abstract\s+)?(?:class|mixin|enum|extension|typedef)\s+([A-Z]\w*)").unwrap()
 });
 
 /// Dart top-level functions and variables (public = no underscore prefix)

src/exports/go.rs

@@ -1,11 +1,9 @@
 use regex::Regex;
 use std::sync::LazyLock;
 
-static COMMENT_SINGLE: LazyLock<Regex> =
-    LazyLock::new(|| Regex::new(r"//.*$").unwrap());
+static COMMENT_SINGLE: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"//.*$").unwrap());
 
-static COMMENT_MULTI: LazyLock<Regex> =
-    LazyLock::new(|| Regex::new(r"(?s)/\*.*?\*/").unwrap());
+static COMMENT_MULTI: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"(?s)/\*.*?\*/").unwrap());
 
 /// Go exports: func Name, type Name, var Name, const Name
 /// In Go, anything starting with uppercase is exported.
@@ -14,9 +12,8 @@ static GO_DECL: LazyLock<Regex> = LazyLock::new(|| {
 });
 
 /// Go method: func (receiver) Name(...)
-static GO_METHOD: LazyLock<Regex> = LazyLock::new(|| {
-    Regex::new(r"(?m)^func\s+\([^)]+\)\s+([A-Z]\w*)").unwrap()
-});
+static GO_METHOD: LazyLock<Regex> =
+    LazyLock::new(|| Regex::new(r"(?m)^func\s+\([^)]+\)\s+([A-Z]\w*)").unwrap());
 
 /// Extract exported symbols from Go source code.
 /// In Go, any top-level identifier starting with an uppercase letter is exported.

src/exports/java.rs

@@ -1,11 +1,9 @@
 use regex::Regex;
 use std::sync::LazyLock;
 
-static COMMENT_SINGLE: LazyLock<Regex> =
-    LazyLock::new(|| Regex::new(r"//.*$").unwrap());
+static COMMENT_SINGLE: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"//.*$").unwrap());
 
-static COMMENT_MULTI: LazyLock<Regex> =
-    LazyLock::new(|| Regex::new(r"(?s)/\*.*?\*/").unwrap());
+static COMMENT_MULTI: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"(?s)/\*.*?\*/").unwrap());
 
 /// Java public declarations: public class, interface, enum, record, @interface (annotation)
 static JAVA_TYPE: LazyLock<Regex> = LazyLock::new(|| {

src/exports/kotlin.rs

@@ -1,11 +1,9 @@
 use regex::Regex;
 use std::sync::LazyLock;
 
-static COMMENT_SINGLE: LazyLock<Regex> =
-    LazyLock::new(|| Regex::new(r"//.*$").unwrap());
+static COMMENT_SINGLE: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"//.*$").unwrap());
 
-static COMMENT_MULTI: LazyLock<Regex> =
-    LazyLock::new(|| Regex::new(r"(?s)/\*.*?\*/").unwrap());
+static COMMENT_MULTI: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"(?s)/\*.*?\*/").unwrap());
 
 /// Kotlin top-level declarations (everything not marked private/internal/protected is public by default).
 /// We match: fun, class, object, interface, typealias, val, var, enum class, data class, sealed class, annotation class
@@ -18,9 +16,8 @@ static KT_DECL: LazyLock<Regex> = LazyLock::new(|| {
 });
 
 /// Detect visibility — private/internal/protected lines should be excluded
-static PRIVATE_LINE: LazyLock<Regex> = LazyLock::new(|| {
-    Regex::new(r"(?m)^[^\S\n]*(?:private|internal|protected)\s+").unwrap()
-});
+static PRIVATE_LINE: LazyLock<Regex> =
+    LazyLock::new(|| Regex::new(r"(?m)^[^\S\n]*(?:private|internal|protected)\s+").unwrap());
 
 /// Extract exported symbols from Kotlin source code.
 /// In Kotlin, everything is public by default unless marked private/internal/protected.
@@ -37,15 +34,14 @@ pub fn extract_exports(content: &str) -> Vec<String> {
             continue;
         }
 
-        if let Some(caps) = KT_DECL.captures(line) {
-            if let Some(name) = caps.get(1) {
+        if let Some(caps) = KT_DECL.captures(line)
+            && let Some(name) = caps.get(1) {
                 // Skip companion objects (they're not standalone exports)
                 if trimmed.starts_with("companion") {
                     continue;
                 }
                 symbols.push(name.as_str().to_string());
             }
-        }
     }
 
     symbols