fix: prepare v1.2.1 patch release with corrected workflows and documentation (#10)

- Bump version to 1.2.1 across all package files
- Fix README binary download links to use correct .tar.gz format for macOS/Linux
- Fix GitHub Actions workflow trigger from 'published' to 'created' to allow asset uploads
- Fix Python workflow Windows shell syntax errors (remove backslash line continuations)
- Update installation commands with proper tar extraction steps
- Update CI/CD examples with correct binary format

This patch release fixes the v1.2.0 release issues:
- Immutable release preventing binary uploads
- Incorrect binary download links in documentation
- Windows PowerShell syntax errors in Python workflow

Author: beonde

.github/workflows/publish-python.yml

@@ -67,21 +67,14 @@ jobs:
 
       - name: Bundle CLI with esbuild
         run: |
-          npx esbuild src/cli.ts \
-            --bundle \
-            --platform=node \
-            --target=node18 \
-            --outfile=dist/cli-bundled.js \
-            --banner:js="#!/usr/bin/env node"
+          npx esbuild src/cli.ts --bundle --platform=node --target=node18 --outfile=dist/cli-bundled.js --banner:js="#!/usr/bin/env node"
 
       - name: Create binary directory
         run: mkdir -p dist/binaries
 
       - name: Create binary with pkg
         run: |
-          npx pkg dist/cli-bundled.js \
-            --targets ${{ matrix.target }} \
-            --output dist/binaries/${{ matrix.binary_name }}
+          npx pkg dist/cli-bundled.js --targets ${{ matrix.target }} --output dist/binaries/${{ matrix.binary_name }}
 
       - name: Sign macOS binary (ad-hoc)
         if: runner.os == 'macOS'

.github/workflows/release-binaries.yml

@@ -2,13 +2,13 @@ name: Build and Release Binaries
 
 on:
   release:
-    types: [published]
+    types: [created]  # Triggers when release is created (still allows asset uploads)
   workflow_dispatch:
     inputs:
       release_tag:
-        description: 'Release tag to build binaries for (e.g., v1.2.0)'
+        description: 'Release tag to build binaries for (e.g., v1.2.1)'
         required: true
-        default: 'v1.2.0'
+        default: 'v1.2.1'
 
 # Explicit permissions for security
 permissions:

README.md

@@ -51,25 +51,28 @@ capiscio validate ./agent-card.json --strict --json
 
 | Platform | Architecture | Download | Size |
 |----------|-------------|----------|------|
-| **Linux** | x64 | [`capiscio-linux-x64`](https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-linux-x64) | ~50MB |
-| **macOS** | Intel | [`capiscio-darwin-x64`](https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-darwin-x64) | ~54MB |
-| **macOS** | Apple Silicon | [`capiscio-darwin-arm64`](https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-darwin-arm64) | ~48MB |
-| **Windows** | Intel x64 | [`capiscio-win-x64.exe`](https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-win-x64.exe) | ~41MB |
-| **Windows** | ARM64 | [`capiscio-win-arm64.exe`](https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-win-arm64.exe) | ~29MB |
+| **Linux** | x64 | [`capiscio-linux-x64.tar.gz`](https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-linux-x64.tar.gz) | ~18MB |
+| **macOS** | Intel | [`capiscio-darwin-x64.tar.gz`](https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-darwin-x64.tar.gz) | ~48MB |
+| **macOS** | Apple Silicon | [`capiscio-darwin-arm64.tar.gz`](https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-darwin-arm64.tar.gz) | ~44MB |
+| **Windows** | Intel x64 | [`capiscio-win-x64.exe`](https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-win-x64.exe) | ~45MB |
+| **Windows** | ARM64 | [`capiscio-win-arm64.exe`](https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-win-arm64.exe) | ~42MB |
 
 #### Quick Download Commands:
 ```bash
 # Linux x64
-curl -L -o capiscio https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-linux-x64
-chmod +x capiscio
+curl -L -o capiscio-linux-x64.tar.gz https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-linux-x64.tar.gz
+tar -xzf capiscio-linux-x64.tar.gz
+chmod +x capiscio-linux-x64
 
 # macOS Intel
-curl -L -o capiscio https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-darwin-x64
-chmod +x capiscio
+curl -L -o capiscio-darwin-x64.tar.gz https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-darwin-x64.tar.gz
+tar -xzf capiscio-darwin-x64.tar.gz
+chmod +x capiscio-darwin-x64
 
 # macOS Apple Silicon (M1/M2/M3/M4)
-curl -L -o capiscio https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-darwin-arm64
-chmod +x capiscio
+curl -L -o capiscio-darwin-arm64.tar.gz https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-darwin-arm64.tar.gz
+tar -xzf capiscio-darwin-arm64.tar.gz
+chmod +x capiscio-darwin-arm64
 
 # Windows Intel (PowerShell)
 Invoke-WebRequest -Uri "https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-win-x64.exe" -OutFile "capiscio.exe"
@@ -78,7 +81,9 @@ Invoke-WebRequest -Uri "https://github.com/capiscio/capiscio-cli/releases/latest
 Invoke-WebRequest -Uri "https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-win-arm64.exe" -OutFile "capiscio.exe"
 
 # Use the binary
-./capiscio validate ./agent-card.json
+./capiscio-linux-x64 validate ./agent-card.json
+# or ./capiscio-darwin-* validate ./agent-card.json
+# or .\capiscio.exe validate .\agent-card.json
 ```
 
 ## Key Features
@@ -202,9 +207,10 @@ Signature verification adds minimal overhead while providing crucial security gu
 # GitHub Actions - No Node.js required
 - name: Download and Validate Agent
   run: |
-    curl -L -o capiscio https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-linux-x64
-    chmod +x capiscio
-    ./capiscio validate ./agent-card.json --json --strict
+    curl -L -o capiscio-linux-x64.tar.gz https://github.com/capiscio/capiscio-cli/releases/latest/download/capiscio-linux-x64.tar.gz
+    tar -xzf capiscio-linux-x64.tar.gz
+    chmod +x capiscio-linux-x64
+    ./capiscio-linux-x64 validate ./agent-card.json --json --strict
 ```
 
 Exit codes: 0 = success, 1 = validation failed

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "capiscio-cli",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "The definitive CLI tool for validating A2A (Agent-to-Agent) protocol agent cards",
   "keywords": [
     "a2a",

package.json

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "capiscio"
-version = "1.2.0"
+version = "1.2.1"
 description = "A2A protocol validator and CLI tool"
 readme = "README.md"
 requires-python = ">=3.7"