fix(ci): improve crates.io publication check robustness (#279)

* feat(ci): optimize CI/CD pipeline for better performance

- Split CI into parallel jobs for faster execution
- Add path filters to skip CI for documentation-only changes
- Create separate docs workflow for markdown and mdBook checks
- Improve caching with more granular cache keys
- Add fail-fast strategy to stop early on failures
- Parallelize unit tests by package
- Make platform builds optional (only Linux required)
- Add environment optimizations (CARGO_INCREMENTAL, reduced debuginfo)
- Only run coverage on main branch
- Add comprehensive documentation checks (lint, links, build)

These optimizations should reduce CI time by 40-50% for most PRs

* fix(ci): improve crates.io publication check robustness

- Redirect stderr to avoid 'note:' messages interfering with grep
- Capture search output for debugging when check fails
- Add debug output to see what cargo search returns
- This should fix the false positives where already-published crates are detected as needing publishing

* fix(ci): remove npm cache configuration from docs workflow

The npm cache was looking for package-lock.json files that don't exist.
Since we only install markdownlint-cli globally, we don't need npm caching.

Author: joshrotenberg

.github/workflows/publish-crates.yml

@@ -8,7 +8,7 @@ on:
   workflow_dispatch:
     inputs:
       dry-run:
-        description: 'Dry run (do not actually publish)'
+        description: "Dry run (do not actually publish)"
         required: false
         default: false
         type: boolean
@@ -59,10 +59,15 @@ jobs:
             echo "Checking $crate v$CRATE_VERSION..."
 
             # Check if this version is already on crates.io
-            if cargo search $crate --limit 1 | grep -q "^$crate = \"$CRATE_VERSION\""; then
+            # Capture both stdout and stderr, ignore stderr output (the "note:" lines)
+            SEARCH_OUTPUT=$(cargo search "$crate" --limit 1 2>/dev/null || true)
+
+            # Check if the exact version is found
+            if echo "$SEARCH_OUTPUT" | grep -q "^${crate} = \"${CRATE_VERSION}\""; then
               echo "  ✓ $crate v$CRATE_VERSION is already published"
             else
               echo "  → $crate v$CRATE_VERSION needs publishing"
+              echo "  Search output was: $SEARCH_OUTPUT"
               NEEDS_PUBLISH="$NEEDS_PUBLISH $crate"
             fi
           done
@@ -141,10 +146,12 @@ jobs:
             CRATE_VERSION=$(grep "^version" crates/$crate/Cargo.toml | sed 's/.*= *"\(.*\)"/\1/')
             echo -n "Checking $crate v$CRATE_VERSION... "
 
-            if cargo search $crate --limit 1 | grep -q "^$crate = \"$CRATE_VERSION\""; then
+            SEARCH_OUTPUT=$(cargo search "$crate" --limit 1 2>/dev/null || true)
+            if echo "$SEARCH_OUTPUT" | grep -q "^${crate} = \"${CRATE_VERSION}\""; then
               echo "✓ Published!"
             else
               echo "✗ Not found!"
+              echo "Search output: $SEARCH_OUTPUT"
               exit 1
             fi
           done