capiscio · beonde · Mar 21, 2026 · Mar 18, 2026
diff --git a/docs/concepts/scoring.md b/docs/concepts/scoring.md
@@ -46,7 +46,7 @@ Every agent card validation returns three independent score dimensions:
 
     ---
 
-    How well does the agent card conform to the A2A v0.3.0 specification?
+    How well does the agent card conform to the A2A v{{ protocol_version }} specification?
 
     Measures protocol adherence, required fields, format validation, and data quality.
 
@@ -74,7 +74,7 @@ Each dimension has its own detailed breakdown, rating enum, and independent scor
 
 ## 📄 Dimension 1: Spec Compliance (100 points)
 
-**What it measures:** How well the agent card adheres to the A2A v0.3.0 specification.
+**What it measures:** How well the agent card adheres to the A2A v{{ protocol_version }} specification.
 
 **Why it matters:** Protocol compliance ensures interoperability. An agent with poor compliance won't work correctly with other agents, registries, or tooling.
 

diff --git a/docs/concepts/validation.md b/docs/concepts/validation.md
@@ -113,7 +113,7 @@ If only a domain is provided, CapiscIO will attempt discovery:
 
 ## Schema Validation
 
-### Required Fields (A2A v0.3.0)
+### Required Fields (A2A v{{ protocol_version }})
 
 #### Basic Required Fields
 - `name`: Agent display name
@@ -123,7 +123,7 @@ If only a domain is provided, CapiscIO will attempt discovery:
 - `version`: Agent version (semver format)
 
 #### A2A Protocol Required Fields
-- `protocolVersion`: A2A protocol version (e.g., "0.3.0")
+- `protocolVersion`: A2A protocol version (e.g., "{{ protocol_version }}")
 - `preferredTransport`: Primary transport protocol
 
 #### Provider Structure
@@ -275,7 +275,7 @@ Each skill in the `skills` array must have:
 **Warning Generated:**
 ```
 LEGACY_DISCOVERY_ENDPOINT: Agent discovered via legacy endpoint.
-The A2A v0.3.0 specification recommends using /.well-known/agent-card.json
+The A2A v{{ protocol_version }} specification recommends using /.well-known/agent-card.json
 ```
 
 ### Transport Protocol Validation
@@ -297,7 +297,7 @@ The A2A v0.3.0 specification recommends using /.well-known/agent-card.json
 ✅ A2A AGENT VALIDATION PASSED
 Agent: https://example.com/.well-known/agent-card.json
 Score: 100/100
-Version: 0.3.0 (Strictness: progressive)
+Version: {{ protocol_version }} (Strictness: progressive)
 
 🔍 VALIDATION SUMMARY:
   📊 3 checks performed: 3 passed, 0 failed, 0 warnings
@@ -310,8 +310,8 @@ Version: 0.3.0 (Strictness: progressive)
 ✅ Endpoint Connectivity
    All endpoints are accessible and responding
    Duration: 195ms
-✅ A2A v0.3.0 Features
-   All v0.3.0 features are properly configured
+✅ A2A v{{ protocol_version }} Features
+   All v{{ protocol_version }} features are properly configured
 
 🏆 Perfect! Your agent passes all validations.
 🚀 Your agent is ready for deployment!
@@ -331,14 +331,14 @@ Version: 0.3.0 (Strictness: progressive)
       "id": "schema_validation",
       "name": "Schema Validation",
       "status": "passed",
-      "message": "Agent card conforms to A2A v0.3.0 schema",
+      "message": "Agent card conforms to A2A v{{ protocol_version }} schema",
       "duration": 12,
       "details": "Agent card structure is valid"
     }
   ],
   "versionInfo": {
-    "detectedVersion": "0.3.0",
-    "validatorVersion": "0.3.0",
+    "detectedVersion": "{{ protocol_version }}",
+    "validatorVersion": "{{ protocol_version }}",
     "strictness": "progressive",
     "compatibility": {
       "compatible": true,

diff --git a/docs/getting-started/cicd/2-action.md b/docs/getting-started/cicd/2-action.md
@@ -68,7 +68,7 @@ cat > agent-card.json << 'EOF'
   "description": "A sample A2A agent",
   "url": "https://example.com/agent",
   "version": "1.0.0",
-  "protocolVersion": "0.3.0",
+  "protocolVersion": "{{ protocol_version }}",
   "provider": {
     "organization": "My Company"
   },
@@ -101,7 +101,7 @@ When the action runs, you'll see output like:
 ```
 ✅ A2A AGENT VALIDATION PASSED
 Score: 75/100
-Version: 0.3.0
+Version: {{ protocol_version }}
 Agent passed with warnings
 
 ISSUES FOUND:

diff --git a/docs/getting-started/secure/2-sdk.md b/docs/getting-started/secure/2-sdk.md
@@ -23,7 +23,7 @@ python -c "import capiscio_sdk; print(capiscio_sdk.__version__)"
 
 Expected output:
 ```
-2.5.0
+{{ capiscio_version }}
 ```
 
 ---
@@ -56,7 +56,7 @@ async def get_agent_card():
         "description": "An A2A agent with CapiscIO security",
         "url": "http://localhost:8000",
         "version": "1.0.0",
-        "protocolVersion": "0.3.0",
+        "protocolVersion": "{{ protocol_version }}",
         "provider": {
             "organization": "My Company"
         },
@@ -124,7 +124,7 @@ async def get_agent_card():
         "description": "An A2A agent with CapiscIO security",
         "url": "http://localhost:8000",
         "version": "1.0.0",
-        "protocolVersion": "0.3.0",
+        "protocolVersion": "{{ protocol_version }}",
         "provider": {"organization": "My Company"},
         "capabilities": {"streaming": False, "pushNotifications": False},
         "public_keys": [
@@ -233,7 +233,7 @@ You'll see your public key embedded:
       "use": "sig"
     }
   ],
-  "protocolVersion": "0.3.0",
+  "protocolVersion": "{{ protocol_version }}",
   ...
 }
 ```

diff --git a/docs/getting-started/secure/5-production.md b/docs/getting-started/secure/5-production.md
@@ -57,7 +57,7 @@ Create a proper `agent-card.json`:
   "description": "Production A2A agent for My Company",
   "url": "https://agent.mycompany.com",
   "version": "1.0.0",
-  "protocolVersion": "0.3.0",
+  "protocolVersion": "{{ protocol_version }}",
   "provider": {
     "organization": "My Company Inc.",
     "url": "https://mycompany.com"

diff --git a/docs/getting-started/validate/1-intro.md b/docs/getting-started/validate/1-intro.md
@@ -54,7 +54,7 @@ Here's a minimal example:
 {
   "name": "My Agent",
   "url": "https://example.com/agent",
-  "protocolVersion": "0.3.0"
+  "protocolVersion": "{{ protocol_version }}"
 }
 ```
 

diff --git a/docs/getting-started/validate/2-install.md b/docs/getting-started/validate/2-install.md
@@ -25,7 +25,7 @@ The CapiscIO CLI is available for Node.js and Python. Choose your preferred plat
 
     Expected output:
     ```
-    capiscio/2.5.0 (darwin-arm64)
+    capiscio/{{ capiscio_version }} (darwin-arm64)
     ```
 
 === "pip (Python)"
@@ -42,7 +42,7 @@ The CapiscIO CLI is available for Node.js and Python. Choose your preferred plat
 
     Expected output:
     ```
-    capiscio/2.5.0 (darwin-arm64)
+    capiscio/{{ capiscio_version }} (darwin-arm64)
     ```
 
 === "Go (Direct)"
@@ -142,7 +142,7 @@ cat > agent-card.json << 'EOF'
   "description": "A sample A2A agent for learning CapiscIO",
   "url": "https://example.com/agent",
   "version": "1.0.0",
-  "protocolVersion": "0.3.0",
+  "protocolVersion": "{{ protocol_version }}",
   "provider": {
     "organization": "My Company"
   },

diff --git a/docs/getting-started/validate/4-reports.md b/docs/getting-started/validate/4-reports.md
@@ -55,11 +55,8 @@ Our sample agent card scores 75/100. Let's improve it:
   "description": "A sample A2A agent for learning CapiscIO",
   "url": "https://example.com/agent",
   "version": "1.0.0",
-  "protocolVersion": "0.3.0",
+  "protocolVersion": "{{ protocol_version }}",
   "provider": {
-    "organization": "My Company",
-    "url": "https://mycompany.com"
-  },
   "capabilities": {
     "streaming": false,
     "pushNotifications": false,

diff --git a/docs/reference/grpc.md b/docs/reference/grpc.md
@@ -1,10 +1,5 @@
 # gRPC Services
 
-<!-- 
-  VERIFIED: 2025-12-26
-  Source: capiscio-core/proto/capiscio/v1/*.proto
--->
-
 `capiscio-core` exposes gRPC services for validation, scoring, and badge operations. The gRPC server is **automatically started and managed by the SDK** when using the Python or Node.js SDKs.
 
 !!! note "No Manual Server Start Required"