Initial commit

skills/plugin-settings/scripts/parse-frontmatter.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+# Frontmatter Parser Utility
+# Extracts YAML frontmatter from .local.md files
+
+set -euo pipefail
+
+# Usage
+show_usage() {
+  echo "Usage: $0 <settings-file.md> [field-name]"
+  echo ""
+  echo "Examples:"
+  echo "  # Show all frontmatter"
+  echo "  $0 .claude/my-plugin.local.md"
+  echo ""
+  echo "  # Extract specific field"
+  echo "  $0 .claude/my-plugin.local.md enabled"
+  echo ""
+  echo "  # Extract and use in script"
+  echo "  ENABLED=\$($0 .claude/my-plugin.local.md enabled)"
+  exit 0
+}
+
+if [ $# -eq 0 ] || [ "$1" = "-h" ] || [ "$1" = "--help" ]; then
+  show_usage
+fi
+
+FILE="$1"
+FIELD="${2:-}"
+
+# Validate file
+if [ ! -f "$FILE" ]; then
+  echo "Error: File not found: $FILE" >&2
+  exit 1
+fi
+
+# Extract frontmatter
+FRONTMATTER=$(sed -n '/^---$/,/^---$/{ /^---$/d; p; }' "$FILE")
+
+if [ -z "$FRONTMATTER" ]; then
+  echo "Error: No frontmatter found in $FILE" >&2
+  exit 1
+fi
+
+# If no field specified, output all frontmatter
+if [ -z "$FIELD" ]; then
+  echo "$FRONTMATTER"
+  exit 0
+fi
+
+# Extract specific field
+VALUE=$(echo "$FRONTMATTER" | grep "^${FIELD}:" | sed "s/${FIELD}: *//" | sed 's/^"\(.*\)"$/\1/' | sed "s/^'\\(.*\\)'$/\\1/")
+
+if [ -z "$VALUE" ]; then
+  echo "Error: Field '$FIELD' not found in frontmatter" >&2
+  exit 1
+fi
+
+echo "$VALUE"
+exit 0

skills/plugin-settings/scripts/validate-settings.sh

@@ -0,0 +1,101 @@
+#!/bin/bash
+# Settings File Validator
+# Validates .claude/plugin-name.local.md structure
+
+set -euo pipefail
+
+# Usage
+if [ $# -eq 0 ]; then
+  echo "Usage: $0 <path/to/settings.local.md>"
+  echo ""
+  echo "Validates plugin settings file for:"
+  echo "  - File existence and readability"
+  echo "  - YAML frontmatter structure"
+  echo "  - Required --- markers"
+  echo "  - Field format"
+  echo ""
+  echo "Example: $0 .claude/my-plugin.local.md"
+  exit 1
+fi
+
+SETTINGS_FILE="$1"
+
+echo "🔍 Validating settings file: $SETTINGS_FILE"
+echo ""
+
+# Check 1: File exists
+if [ ! -f "$SETTINGS_FILE" ]; then
+  echo "❌ File not found: $SETTINGS_FILE"
+  exit 1
+fi
+echo "✅ File exists"
+
+# Check 2: File is readable
+if [ ! -r "$SETTINGS_FILE" ]; then
+  echo "❌ File is not readable"
+  exit 1
+fi
+echo "✅ File is readable"
+
+# Check 3: Has frontmatter markers
+MARKER_COUNT=$(grep -c '^---$' "$SETTINGS_FILE" 2>/dev/null || echo "0")
+
+if [ "$MARKER_COUNT" -lt 2 ]; then
+  echo "❌ Invalid frontmatter: found $MARKER_COUNT '---' markers (need at least 2)"
+  echo "   Expected format:"
+  echo "   ---"
+  echo "   field: value"
+  echo "   ---"
+  echo "   Content..."
+  exit 1
+fi
+echo "✅ Frontmatter markers present"
+
+# Check 4: Extract and validate frontmatter
+FRONTMATTER=$(sed -n '/^---$/,/^---$/{ /^---$/d; p; }' "$SETTINGS_FILE")
+
+if [ -z "$FRONTMATTER" ]; then
+  echo "❌ Empty frontmatter (nothing between --- markers)"
+  exit 1
+fi
+echo "✅ Frontmatter not empty"
+
+# Check 5: Frontmatter has valid YAML-like structure
+if ! echo "$FRONTMATTER" | grep -q ':'; then
+  echo "⚠️  Warning: Frontmatter has no key:value pairs"
+fi
+
+# Check 6: Look for common fields
+echo ""
+echo "Detected fields:"
+echo "$FRONTMATTER" | grep '^[a-z_][a-z0-9_]*:' | while IFS=':' read -r key value; do
+  echo "  - $key: ${value:0:50}"
+done
+
+# Check 7: Validate common boolean fields
+for field in enabled strict_mode; do
+  VALUE=$(echo "$FRONTMATTER" | grep "^${field}:" | sed "s/${field}: *//" || true)
+  if [ -n "$VALUE" ]; then
+    if [ "$VALUE" != "true" ] && [ "$VALUE" != "false" ]; then
+      echo "⚠️  Field '$field' should be boolean (true/false), got: $VALUE"
+    fi
+  fi
+done
+
+# Check 8: Check body exists
+BODY=$(awk '/^---$/{i++; next} i>=2' "$SETTINGS_FILE")
+
+echo ""
+if [ -n "$BODY" ]; then
+  BODY_LINES=$(echo "$BODY" | wc -l | tr -d ' ')
+  echo "✅ Markdown body present ($BODY_LINES lines)"
+else
+  echo "⚠️  No markdown body (frontmatter only)"
+fi
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "✅ Settings file structure is valid"
+echo ""
+echo "Reminder: Changes to this file require restarting Claude Code"
+exit 0