toon-decode

TOON Decode

Convert TOON v2.0 format back to JSON using the Zig decoder.

Usage: /toon-decode <file> [options]

Options:

• --strict - Enable strict mode validation during decoding
• --no-expand-paths - Don't expand folded paths (keep dot notation)

Execute the following workflow:

1. Validate Input

FILE="$1"

if [[ -z "$FILE" ]]; then
  echo "Usage: /toon-decode <file> [options]"
  echo "Example: /toon-decode data.toon"
  echo "Example: /toon-decode data.toon --strict"
  exit 1
fi

if [[ ! -f "$FILE" ]]; then
  echo "❌ Error: File not found: $FILE"
  exit 1
fi

if [[ ! "$FILE" =~ \.toon$ ]]; then
  echo "⚠️  Warning: File doesn't have .toon extension"
  read -p "Continue? (y/n) " -n 1 -r
  echo
  if [[ ! $REPLY =~ ^[Yy]$ ]]; then
    exit 0
  fi
fi

echo "✓ Input: $FILE"

2. Parse Options

STRICT_FLAG=""
EXPAND_PATHS_FLAG=""
OUTPUT="${FILE%.toon}.json"

shift  # Remove first arg (filename)
while [[ $# -gt 0 ]]; do
  case "$1" in
    --strict)
      STRICT_FLAG="--strict"
      shift
      ;;
    --no-expand-paths)
      EXPAND_PATHS_FLAG="--no-expand-paths"
      shift
      ;;
    *)
      shift
      ;;
  esac
done

echo "⚙️  Configuration:"
echo "  Strict mode: ${STRICT_FLAG:-disabled}"
echo "  Path expansion: ${EXPAND_PATHS_FLAG:-enabled (default)}"
echo "  Output: $OUTPUT"

3. Check Zig Binary

TOON_BIN=".claude/utils/toon/zig-out/bin/toon"

if [[ ! -f "$TOON_BIN" ]]; then
  echo "❌ Zig binary not found. Building..."
  echo ""
  cd .claude/utils/toon
  /opt/homebrew/opt/[email protected]/bin/zig build -Doptimize=ReleaseFast
  cd -
  echo ""
  echo "✓ Build complete"
fi

4. Decode

echo ""
echo "Decoding..."

$TOON_BIN decode "$FILE" \
  $STRICT_FLAG \
  $EXPAND_PATHS_FLAG \
  > "$OUTPUT"

if [[ $? -eq 0 ]]; then
  echo "✓ Decoding successful"
else
  echo "❌ Decoding failed"
  exit 1
fi

5. Validate JSON

# Verify JSON is valid
if command -v python3 &> /dev/null; then
  python3 -m json.tool "$OUTPUT" > /dev/null 2>&1
  if [[ $? -eq 0 ]]; then
    echo "✓ JSON validation passed"
  else
    echo "⚠️  Warning: Output may not be valid JSON"
  fi
fi