gh-dhofheinz-open-plugins-plugins-marketplace-validator-plugin/commands/schema-validation/validate-json.md

Operation: Validate JSON Syntax

Validate JSON file syntax with multi-backend support (jq + python3 fallback).

Parameters from $ARGUMENTS

• file: Path to JSON file (required)
• verbose: Show detailed error information (optional, default: false)

Workflow

1. Parse Arguments

   Extract file path from $ARGUMENTS
   Check if verbose mode requested
   

2. Validate File Exists

   IF file does not exist:
     Return error with file path
     Exit with status 1
   

3. Detect JSON Tool

   Execute .scripts/json-validator.py --detect
   Primary: jq (faster, better error messages)
   Fallback: python3 (universal availability)
   

4. Validate JSON Syntax

   Execute .scripts/json-validator.py --file "$file" --verbose "$verbose"
   
   On success:
     - Print success message with file path
     - Return 0
   
   On failure:
     - Print error message with line number and details
     - Show problematic JSON section
     - Return 1
   

Examples

# Basic JSON validation
/schema-validation json file:plugin.json

# Verbose validation with details
/schema-validation json file:marketplace.json verbose:true

# Validate multiple files (call multiple times)
/schema-validation json file:plugin1.json
/schema-validation json file:plugin2.json

Error Handling

• File not found: Clear message with expected path
• Invalid JSON: Line number, character position, error description
• No JSON tool available: Instruction to install jq or python3
• Permission denied: File access error with remediation

Output Format

Success:

✅ Valid JSON: plugin.json
Backend: jq

Failure (basic):

❌ Invalid JSON: marketplace.json
Error: Unexpected token at line 15

Failure (verbose):

❌ Invalid JSON: marketplace.json
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Error Details:
  Line: 15
  Position: 8
  Issue: Expected ',' or ']' but got '}'

Problematic Section (lines 13-17):
  13  |   "plugins": [
  14  |     {
  15  |       "name": "test"
  16  |     }
  17  |   }

Remediation:
  - Check for missing commas between array elements
  - Verify bracket matching: [ ] { }
  - Use a JSON formatter/linter in your editor

Integration

This operation is called by:

• full-schema-validation.md - First validation step
• validation-orchestrator - Quick validation checks
• Direct user invocation for single file checks

Request: $ARGUMENTS