@lvlup-sw/exarchos 2.0.1

package/scripts/validate-dotnet-standards.sh

@@ -0,0 +1,267 @@
+#!/usr/bin/env bash
+# Validate .NET Standards
+# Checks .NET project structure compliance: required files, CPM configuration,
+# editorconfig, global.json, and no inline package versions.
+#
+# Usage: validate-dotnet-standards.sh --project-root <path>
+#
+# Exit codes:
+#   0 = project is compliant
+#   1 = violations found
+#   2 = usage error (missing required args)
+
+set -euo pipefail
+
+# ============================================================
+# ARGUMENT PARSING
+# ============================================================
+
+PROJECT_ROOT=""
+
+usage() {
+    cat << 'USAGE'
+Usage: validate-dotnet-standards.sh --project-root <path>
+
+Required:
+  --project-root <path>   Root directory of the .NET project
+
+Optional:
+  --help                  Show this help message
+
+Exit codes:
+  0  Project is compliant
+  1  Violations found
+  2  Usage error (missing required args)
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --project-root)
+            if [[ -z "${2:-}" ]]; then
+                echo "Error: --project-root requires a path argument" >&2
+                exit 2
+            fi
+            PROJECT_ROOT="$2"
+            shift 2
+            ;;
+        --help)
+            usage
+            exit 0
+            ;;
+        *)
+            echo "Error: Unknown argument '$1'" >&2
+            usage >&2
+            exit 2
+            ;;
+    esac
+done
+
+if [[ -z "$PROJECT_ROOT" ]]; then
+    echo "Error: --project-root is required" >&2
+    usage >&2
+    exit 2
+fi
+
+# ============================================================
+# CHECK FUNCTIONS
+# ============================================================
+
+CHECK_PASS=0
+CHECK_FAIL=0
+RESULTS=()
+
+check_pass() {
+    local name="$1"
+    RESULTS+=("- **PASS**: $name")
+    CHECK_PASS=$((CHECK_PASS + 1))
+}
+
+check_fail() {
+    local name="$1"
+    local detail="${2:-}"
+    if [[ -n "$detail" ]]; then
+        RESULTS+=("- **FAIL**: $name — $detail")
+    else
+        RESULTS+=("- **FAIL**: $name")
+    fi
+    CHECK_FAIL=$((CHECK_FAIL + 1))
+}
+
+# ============================================================
+# CHECK 1: Directory.Build.props exists
+# ============================================================
+
+check_build_props() {
+    local build_props="$PROJECT_ROOT/src/Directory.Build.props"
+    if [[ -f "$build_props" ]]; then
+        check_pass "Directory.Build.props exists"
+        return 0
+    else
+        check_fail "Directory.Build.props exists" "Not found at $build_props"
+        return 1
+    fi
+}
+
+# ============================================================
+# CHECK 2: Directory.Packages.props exists
+# ============================================================
+
+check_packages_props_exists() {
+    local packages_props="$PROJECT_ROOT/src/Directory.Packages.props"
+    if [[ -f "$packages_props" ]]; then
+        check_pass "Directory.Packages.props exists"
+        return 0
+    else
+        check_fail "Directory.Packages.props exists" "Not found at $packages_props"
+        return 1
+    fi
+}
+
+# ============================================================
+# CHECK 3: CPM is enabled in Directory.Packages.props
+# ============================================================
+
+check_cpm_enabled() {
+    local packages_props="$PROJECT_ROOT/src/Directory.Packages.props"
+
+    if [[ ! -f "$packages_props" ]]; then
+        # Already reported by check_packages_props_exists
+        return 1
+    fi
+
+    if grep -qE '<ManagePackageVersionsCentrally>[[:space:]]*true[[:space:]]*</ManagePackageVersionsCentrally>' "$packages_props"; then
+        check_pass "Central Package Management (CPM) enabled"
+        return 0
+    else
+        check_fail "Central Package Management (CPM) enabled" "ManagePackageVersionsCentrally is not set to true in Directory.Packages.props"
+        return 1
+    fi
+}
+
+# ============================================================
+# CHECK 4: .editorconfig exists
+# ============================================================
+
+check_editorconfig() {
+    local editorconfig="$PROJECT_ROOT/src/.editorconfig"
+    if [[ -f "$editorconfig" ]]; then
+        check_pass ".editorconfig exists"
+        return 0
+    else
+        check_fail ".editorconfig exists" "Not found at $editorconfig"
+        return 1
+    fi
+}
+
+# ============================================================
+# CHECK 5: global.json exists with SDK version
+# ============================================================
+
+check_global_json() {
+    local global_json="$PROJECT_ROOT/src/global.json"
+
+    if [[ ! -f "$global_json" ]]; then
+        check_fail "global.json exists" "Not found at $global_json"
+        return 1
+    fi
+
+    # Check for sdk.version field
+    if command -v jq &>/dev/null; then
+        local sdk_version
+        if ! sdk_version="$(jq -r '.sdk.version // empty' "$global_json" 2>/dev/null)"; then
+            check_fail "global.json valid" "Invalid JSON in $global_json"
+            return 1
+        fi
+        if [[ -n "$sdk_version" ]]; then
+            check_pass "global.json exists (SDK $sdk_version)"
+            return 0
+        else
+            check_fail "global.json exists" "File exists but sdk.version is not specified"
+            return 1
+        fi
+    else
+        # Fallback: just check file contains "version"
+        if grep -q '"version"' "$global_json"; then
+            check_pass "global.json exists (with version)"
+            return 0
+        else
+            check_fail "global.json exists" "File exists but no version field found"
+            return 1
+        fi
+    fi
+}
+
+# ============================================================
+# CHECK 6: No inline PackageReference with Version in .csproj
+# ============================================================
+
+check_no_inline_versions() {
+    # Find all .csproj files under src/
+    local src_dir="$PROJECT_ROOT/src"
+    if [[ ! -d "$src_dir" ]]; then
+        check_pass "No inline package versions (no src/ directory)"
+        return 0
+    fi
+
+    local violations=()
+    while IFS= read -r csproj_file; do
+        [[ -z "$csproj_file" ]] && continue
+        # Check for PackageReference with Version attribute (but not in Directory.Build.props)
+        local basename
+        basename="$(basename "$csproj_file")"
+        if [[ "$basename" == "Directory.Build.props" || "$basename" == "Directory.Packages.props" ]]; then
+            continue
+        fi
+        if grep -qE '<PackageReference\s+[^>]*Version\s*=' "$csproj_file"; then
+            violations+=("$csproj_file")
+        fi
+    done < <(find "$src_dir" -name '*.csproj' -type f 2>/dev/null)
+
+    if [[ ${#violations[@]} -eq 0 ]]; then
+        check_pass "No inline package versions in .csproj files"
+        return 0
+    else
+        local violation_list
+        violation_list="$(printf '%s\n' "${violations[@]}" | sed "s|$PROJECT_ROOT/||g" | tr '\n' ', ' | sed 's/, $//')"
+        check_fail "No inline package versions in .csproj files" "Inline Version found in: $violation_list"
+        return 1
+    fi
+}
+
+# ============================================================
+# EXECUTE CHECKS
+# ============================================================
+
+check_build_props || true
+check_packages_props_exists || true
+check_cpm_enabled || true
+check_editorconfig || true
+check_global_json || true
+check_no_inline_versions || true
+
+# ============================================================
+# STRUCTURED OUTPUT
+# ============================================================
+
+echo "## .NET Standards Compliance Report"
+echo ""
+echo "**Project root:** \`$PROJECT_ROOT\`"
+echo ""
+
+for result in "${RESULTS[@]}"; do
+    echo "$result"
+done
+
+echo ""
+TOTAL=$((CHECK_PASS + CHECK_FAIL))
+echo "---"
+echo ""
+
+if [[ $CHECK_FAIL -eq 0 ]]; then
+    echo "**Result: PASS** ($CHECK_PASS/$TOTAL checks passed)"
+    exit 0
+else
+    echo "**Result: FAIL** ($CHECK_FAIL/$TOTAL checks failed)"
+    exit 1
+fi

package/scripts/validate-installation.sh

@@ -0,0 +1,101 @@
+#!/usr/bin/env bash
+# validate-installation.sh — Post-install verification for skills
+#
+# Usage: validate-installation.sh [target-skills-dir]
+# Default target: ~/.claude/skills
+#
+# Verifies:
+#   1. Each skill subdirectory has a SKILL.md file
+#   2. Each SKILL.md passes frontmatter validation
+#   3. references/ directories have matching file counts vs repo source
+#
+# Exit 0 if all pass, exit 1 with error list otherwise.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+VALIDATOR="${REPO_ROOT}/skills/validate-frontmatter.sh"
+TARGET_DIR="${1:-${HOME}/.claude/skills}"
+
+if [[ ! -d "$TARGET_DIR" ]]; then
+  echo "ERROR: Target directory not found: $TARGET_DIR"
+  exit 2
+fi
+
+if [[ ! -x "$VALIDATOR" ]]; then
+  echo "ERROR: Validator script not found or not executable: $VALIDATOR"
+  exit 2
+fi
+
+ERRORS=()
+PASS_COUNT=0
+TOTAL=0
+
+for skill_dir in "$TARGET_DIR"/*/; do
+  [[ -d "$skill_dir" ]] || continue
+
+  # Skip test-fixtures and trigger-tests directories
+  local_name=$(basename "$skill_dir")
+  if [[ "$local_name" == "test-fixtures" || "$local_name" == "trigger-tests" ]]; then
+    continue
+  fi
+
+  TOTAL=$((TOTAL + 1))
+  skill_file="${skill_dir}SKILL.md"
+
+  # Check 1: SKILL.md exists
+  if [[ ! -f "$skill_file" ]]; then
+    ERRORS+=("${local_name}: Missing SKILL.md")
+    continue
+  fi
+
+  # Check 2: Frontmatter validation
+  result=""
+  rc=0
+  result=$("$VALIDATOR" "$skill_file" "$local_name" 2>&1) || rc=$?
+
+  if [[ $rc -ne 0 ]]; then
+    ERRORS+=("${local_name}: Frontmatter validation failed — ${result}")
+    continue
+  fi
+
+  PASS_COUNT=$((PASS_COUNT + 1))
+
+  # Check 3: references/ directory file count matches repo source (if applicable)
+  repo_refs="${REPO_ROOT}/skills/${local_name}/references"
+  target_refs="${skill_dir}references"
+
+  if [[ -d "$repo_refs" ]]; then
+    if [[ ! -d "$target_refs" ]]; then
+      ERRORS+=("${local_name}: Missing references/ directory (repo has one)")
+      PASS_COUNT=$((PASS_COUNT - 1))
+    else
+      repo_count=$(find "$repo_refs" -type f | wc -l | tr -d ' ')
+      target_count=$(find "$target_refs" -type f | wc -l | tr -d ' ')
+
+      if [[ "$repo_count" != "$target_count" ]]; then
+        ERRORS+=("${local_name}: references/ file count mismatch (repo: ${repo_count}, installed: ${target_count})")
+        PASS_COUNT=$((PASS_COUNT - 1))
+      fi
+    fi
+  fi
+done
+
+if [[ $TOTAL -eq 0 ]]; then
+  echo "ERROR: No skills found in $TARGET_DIR"
+  exit 1
+fi
+
+echo "=== Installation Validation: ${PASS_COUNT}/${TOTAL} skills passed ==="
+
+if [[ ${#ERRORS[@]} -gt 0 ]]; then
+  echo ""
+  echo "Errors:"
+  for err in "${ERRORS[@]}"; do
+    echo "  - $err"
+  done
+  exit 1
+fi
+
+exit 0

package/scripts/validate-plugin.sh

@@ -0,0 +1,223 @@
+#!/usr/bin/env bash
+# validate-plugin.sh — Validate core plugin directory structure
+#
+# Checks:
+#   1. .claude-plugin/plugin.json exists and valid JSON with required fields
+#   2. Referenced directories exist: commands/, skills/
+#   3. Referenced files exist: hooks/hooks.json, .mcp.json
+#   4. .mcp.json is valid JSON containing exarchos and graphite server entries
+#   5. hooks/hooks.json contains all 6 hook types
+#   6. No {{CLI_PATH}} references in hooks (should use ${CLAUDE_PLUGIN_ROOT})
+#
+# Usage: validate-plugin.sh --repo-root <path>
+#
+# Exit codes:
+#   0 = all checks pass
+#   1 = one or more checks fail
+#   2 = usage error
+
+set -euo pipefail
+
+# ============================================================
+# ARGUMENT PARSING
+# ============================================================
+
+REPO_ROOT="."
+
+usage() {
+  cat << 'USAGE'
+Usage: validate-plugin.sh --repo-root <path>
+
+Validates the core Exarchos plugin directory structure.
+
+Options:
+  --repo-root <path>   Path to the plugin repository root (default: .)
+  --help               Show this help message
+
+Exit codes:
+  0  All checks pass
+  1  One or more checks fail
+  2  Usage error
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo-root)
+      if [[ -z "${2:-}" ]]; then
+        echo "Error: --repo-root requires a path argument" >&2
+        exit 2
+      fi
+      REPO_ROOT="$2"
+      shift 2
+      ;;
+    --help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Error: Unknown argument '$1'" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+done
+
+if [[ ! -d "$REPO_ROOT" ]]; then
+  echo "Error: Repository root not found: $REPO_ROOT" >&2
+  exit 2
+fi
+
+# ============================================================
+# DEPENDENCY CHECK
+# ============================================================
+
+if ! command -v jq &>/dev/null; then
+  echo "Error: jq is required but not installed" >&2
+  exit 2
+fi
+
+# ============================================================
+# VALIDATION
+# ============================================================
+
+CHECK_PASS=0
+CHECK_FAIL=0
+TOTAL=0
+RESULTS=()
+
+check() {
+  local description="$1"
+  local passed="$2"
+  TOTAL=$((TOTAL + 1))
+  if [[ "$passed" == "true" ]]; then
+    RESULTS+=("- **PASS**: $description")
+    CHECK_PASS=$((CHECK_PASS + 1))
+  else
+    RESULTS+=("- **FAIL**: $description")
+    CHECK_FAIL=$((CHECK_FAIL + 1))
+  fi
+}
+
+# --- Check 1: .claude-plugin/plugin.json exists and valid JSON with required fields ---
+PLUGIN_JSON="$REPO_ROOT/.claude-plugin/plugin.json"
+if [[ -f "$PLUGIN_JSON" ]] && jq empty "$PLUGIN_JSON" 2>/dev/null; then
+  # Verify required fields
+  REQUIRED_FIELDS=("name" "version" "commands" "skills" "hooks" "mcpServers")
+  ALL_FIELDS_PRESENT=true
+  MISSING_FIELDS=()
+  for field in "${REQUIRED_FIELDS[@]}"; do
+    if ! jq -e ".$field" "$PLUGIN_JSON" >/dev/null 2>&1; then
+      ALL_FIELDS_PRESENT=false
+      MISSING_FIELDS+=("$field")
+    fi
+  done
+  if [[ "$ALL_FIELDS_PRESENT" == "true" ]]; then
+    check ".claude-plugin/plugin.json exists and valid" "true"
+  else
+    check ".claude-plugin/plugin.json missing fields: ${MISSING_FIELDS[*]}" "false"
+  fi
+else
+  check ".claude-plugin/plugin.json exists and valid" "false"
+fi
+
+# --- Check 2: Referenced directories exist ---
+COMMANDS_DIR="$REPO_ROOT/commands"
+SKILLS_DIR="$REPO_ROOT/skills"
+if [[ -d "$COMMANDS_DIR" ]]; then
+  check "commands/ directory exists" "true"
+else
+  check "commands/ directory exists" "false"
+fi
+
+if [[ -d "$SKILLS_DIR" ]]; then
+  check "skills/ directory exists" "true"
+else
+  check "skills/ directory exists" "false"
+fi
+
+# --- Check 3: Referenced files exist ---
+HOOKS_FILE="$REPO_ROOT/hooks/hooks.json"
+MCP_FILE="$REPO_ROOT/.mcp.json"
+
+if [[ -f "$HOOKS_FILE" ]]; then
+  check "hooks/hooks.json exists" "true"
+else
+  check "hooks/hooks.json exists" "false"
+fi
+
+if [[ -f "$MCP_FILE" ]]; then
+  check ".mcp.json exists" "true"
+else
+  check ".mcp.json exists" "false"
+fi
+
+# --- Check 4: .mcp.json is valid JSON with exarchos and graphite entries ---
+if [[ -f "$MCP_FILE" ]] && jq empty "$MCP_FILE" 2>/dev/null; then
+  HAS_EXARCHOS=$(jq -e '.mcpServers.exarchos' "$MCP_FILE" >/dev/null 2>&1 && echo "true" || echo "false")
+  HAS_GRAPHITE=$(jq -e '.mcpServers.graphite' "$MCP_FILE" >/dev/null 2>&1 && echo "true" || echo "false")
+  if [[ "$HAS_EXARCHOS" == "true" && "$HAS_GRAPHITE" == "true" ]]; then
+    check ".mcp.json contains exarchos and graphite entries" "true"
+  else
+    MISSING_SERVERS=()
+    [[ "$HAS_EXARCHOS" == "false" ]] && MISSING_SERVERS+=("exarchos")
+    [[ "$HAS_GRAPHITE" == "false" ]] && MISSING_SERVERS+=("graphite")
+    check ".mcp.json missing server entries: ${MISSING_SERVERS[*]}" "false"
+  fi
+else
+  check ".mcp.json valid JSON with required entries" "false"
+fi
+
+# --- Check 5: hooks/hooks.json contains all 6 hook types ---
+REQUIRED_HOOKS=("PreCompact" "SessionStart" "PreToolUse" "TaskCompleted" "TeammateIdle" "SubagentStart")
+if [[ -f "$HOOKS_FILE" ]] && jq empty "$HOOKS_FILE" 2>/dev/null; then
+  ALL_HOOKS_PRESENT=true
+  MISSING_HOOKS=()
+  for hook in "${REQUIRED_HOOKS[@]}"; do
+    if ! jq -e ".hooks.$hook" "$HOOKS_FILE" >/dev/null 2>&1; then
+      ALL_HOOKS_PRESENT=false
+      MISSING_HOOKS+=("$hook")
+    fi
+  done
+  if [[ "$ALL_HOOKS_PRESENT" == "true" ]]; then
+    check "hooks/hooks.json contains all 6 hook types" "true"
+  else
+    check "hooks/hooks.json missing hook types: ${MISSING_HOOKS[*]}" "false"
+  fi
+else
+  check "hooks/hooks.json valid JSON with all hook types" "false"
+fi
+
+# --- Check 6: No {{CLI_PATH}} references in hooks ---
+if [[ -f "$HOOKS_FILE" ]]; then
+  if grep -q '{{CLI_PATH}}' "$HOOKS_FILE" 2>/dev/null; then
+    check "No {{CLI_PATH}} references in hooks (should use \${CLAUDE_PLUGIN_ROOT})" "false"
+  else
+    check "No {{CLI_PATH}} references in hooks" "true"
+  fi
+else
+  check "No {{CLI_PATH}} references in hooks (hooks file missing)" "false"
+fi
+
+# ============================================================
+# STRUCTURED OUTPUT
+# ============================================================
+
+echo "## Plugin Validation Report"
+echo ""
+
+for result in "${RESULTS[@]}"; do
+  echo "$result"
+done
+
+echo ""
+echo "---"
+echo ""
+
+if [[ $CHECK_FAIL -eq 0 ]]; then
+  echo "**Result: PASS** ($CHECK_PASS/$TOTAL checks passed)"
+  exit 0
+else
+  echo "**Result: FAIL** ($CHECK_PASS/$TOTAL checks passed)"
+  exit 1
+fi