fix: harden release workflow and fix Usage spec inaccuracies

Pin usage tool to v2.18.2 in both mise.toml and release workflow,
add --fail/pipefail to curl, validate generated completion files are
non-empty. Fix version prefix (v2.8.0) and schemas default path in
exfig.usage.kdl. Add version sync reminder to CLAUDE.md.

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

Author: alexey1312

.github/workflows/release.yml

@@ -194,12 +194,21 @@ jobs:
 
       - name: Generate shell completions
         run: |
-          curl -sL "https://github.com/jdx/usage/releases/latest/download/usage-x86_64-unknown-linux-gnu.tar.gz" | tar xz
+          set -euo pipefail
+          USAGE_VERSION="2.18.2"
+          curl --fail -sL "https://github.com/jdx/usage/releases/download/v${USAGE_VERSION}/usage-x86_64-unknown-linux-gnu.tar.gz" -o usage.tar.gz
+          tar xzf usage.tar.gz
           chmod +x usage/bin/usage
           mkdir -p completions
           usage/bin/usage generate completion bash exfig -f exfig.usage.kdl > completions/exfig.bash
           usage/bin/usage generate completion zsh exfig -f exfig.usage.kdl > completions/_exfig
           usage/bin/usage generate completion fish exfig -f exfig.usage.kdl > completions/exfig.fish
+          for f in completions/exfig.bash completions/_exfig completions/exfig.fish; do
+            if [[ ! -s "$f" ]]; then
+              echo "::error::Generated completion file is empty: $f"
+              exit 1
+            fi
+          done
 
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2

CLAUDE.md

@@ -285,7 +285,7 @@ Changing `load()` return type affects:
 
 See `ExFigCLI/CLAUDE.md` (Adding a New Subcommand).
 
-**Important:** When adding/changing CLI flags or subcommands, update `exfig.usage.kdl` (Usage spec) to keep shell completions and docs in sync.
+**Important:** When adding/changing CLI flags or subcommands, update `exfig.usage.kdl` (Usage spec) to keep shell completions and docs in sync. When bumping the app version in `ExFigCommand.swift`, also update the `version` field in `exfig.usage.kdl`.
 
 ### Adding a Figma API Endpoint
 

exfig.usage.kdl

@@ -6,7 +6,7 @@
 
 name "ExFig"
 bin "exfig"
-version "2.8.0"
+version "v2.8.0"
 about "Exports resources from Figma to iOS, Android, Flutter, and Web projects"
 
 // =============================================================================
@@ -121,7 +121,7 @@ cmd "init" help="Generates config file" {
 cmd "schemas" help="Extracts PKL schemas to local directory" {
     long_help "Extracts PKL schema files used for config validation and IDE support. Schemas are extracted to .exfig/schemas/ by default."
 
-    flag "-o --output <dir>" help="Output directory for schemas." default=".exfig/schemas/"
+    flag "-o --output <dir>" help="Output directory for schemas." default=".exfig/schemas"
     flag "-f --force" help="Overwrite existing schema files."
 }
 

mise.toml

@@ -53,7 +53,7 @@ git-cliff = "2.10.1" # Changelog generation
 pkl = "0.31.0" # Configuration language (for hk.pkl)
 
 # --- CLI Spec ---
-usage = "latest" # CLI spec → shell completions, docs, man pages
+usage = "2.18.2" # CLI spec → shell completions, docs, man pages
 
 # --- Search ---
 "github:alexey1312/swift-index" = { version = "latest", os = [