holocron/plugins/kyberforge/skills/agent-audit/tests/validate.bats

#!/usr/bin/env bats

setup() {
    REPO_ROOT="$(cd "$BATS_TEST_DIRNAME/../../../../../" && pwd)"
    load "$REPO_ROOT/tests/test_helper/bats-support/load"
    load "$REPO_ROOT/tests/test_helper/bats-assert/load"

    SCRIPT="$(cd "$BATS_TEST_DIRNAME/../scripts" && pwd)/validate.sh"
    TMPDIR="$(mktemp -d)"

    # Helper: create a plugin-scope pair in <dir> with given <name>
    make_plugin_pair() {
        local dir="$1"
        local name="$2"
        mkdir -p "$dir"
        echo '{}' > "$dir/plugin.json"
        cat > "$dir/${name}.md" <<EOF
---
name: ${name}
description: A valid agent description.
---

You are a test agent. When invoked, do the thing.
EOF
        cat > "$dir/${name}.agent.md" <<EOF
---
name: ${name}
description: A valid agent description.
---

You are a test agent. When invoked, do the thing.
EOF
    }
}

teardown() {
    rm -rf "$TMPDIR"
}

# ---------------------------------------------------------------------------
# Passing cases
# ---------------------------------------------------------------------------

@test "passes on a clean plugin-scope pair (CC file as input)" {
    local dir="$TMPDIR/agents"
    make_plugin_pair "$dir" "my-agent"
    run bash "$SCRIPT" "$dir/my-agent.md"
    assert_success
    refute_output --partial "FAIL"
}

@test "passes on a clean project-scope pair (CC file as input)" {
    local root="$TMPDIR/project"
    mkdir -p "$root/.git" "$root/.claude/agents" "$root/.github/agents"
    cat > "$root/.claude/agents/my-agent.md" <<EOF
---
name: my-agent
description: A valid agent description.
---

You are a test agent. When invoked, do the thing.
EOF
    cat > "$root/.github/agents/my-agent.agent.md" <<EOF
---
name: my-agent
description: A valid agent description.
---

You are a test agent. When invoked, do the thing.
EOF
    run bash "$SCRIPT" "$root/.claude/agents/my-agent.md"
    assert_success
    refute_output --partial "FAIL"
}

@test "--help exits 0 and shows Usage:" {
    run bash "$SCRIPT" --help
    assert_success
    assert_output --partial "Usage:"
}

# ---------------------------------------------------------------------------
# Failing cases
# ---------------------------------------------------------------------------

@test "fails when Copilot counterpart is missing" {
    local dir="$TMPDIR/agents"
    make_plugin_pair "$dir" "my-agent"
    rm "$dir/my-agent.agent.md"
    run bash "$SCRIPT" "$dir/my-agent.md"
    assert_failure
    assert_output --partial "counterpart"
}

@test "fails when CC-only field 'maxTurns' is in Copilot file" {
    local dir="$TMPDIR/agents"
    make_plugin_pair "$dir" "my-agent"
    cat > "$dir/my-agent.agent.md" <<EOF
---
name: my-agent
description: A valid agent description.
maxTurns: 10
---

You are a test agent. When invoked, do the thing.
EOF
    run bash "$SCRIPT" "$dir/my-agent.md"
    assert_failure
    assert_output --partial "maxTurns"
}

@test "fails when plugin-silently-ignored field 'hooks' is in plugin-scope CC file" {
    local dir="$TMPDIR/agents"
    make_plugin_pair "$dir" "my-agent"
    cat > "$dir/my-agent.md" <<EOF
---
name: my-agent
description: A valid agent description.
hooks:
  PostToolUse:
    - match: ".*"
      command: "echo done"
---

You are a test agent. When invoked, do the thing.
EOF
    run bash "$SCRIPT" "$dir/my-agent.md"
    assert_failure
    assert_output --partial "hooks"
}

@test "fails when CC file name is not kebab-case" {
    local dir="$TMPDIR/agents"
    mkdir -p "$dir"
    echo '{}' > "$dir/plugin.json"
    cat > "$dir/my-agent.md" <<EOF
---
name: MyAgent
description: A valid agent description.
---

You are a test agent. When invoked, do the thing.
EOF
    cat > "$dir/my-agent.agent.md" <<EOF
---
name: MyAgent
description: A valid agent description.
---

You are a test agent. When invoked, do the thing.
EOF
    run bash "$SCRIPT" "$dir/my-agent.md"
    assert_failure
    assert_output --partial "kebab"
}

@test "fails when 'name' field is missing from CC file" {
    local dir="$TMPDIR/agents"
    make_plugin_pair "$dir" "my-agent"
    cat > "$dir/my-agent.md" <<EOF
---
description: A valid agent description.
---

You are a test agent. When invoked, do the thing.
EOF
    run bash "$SCRIPT" "$dir/my-agent.md"
    assert_failure
}

@test "fails when 'description' field is missing from CC file" {
    local dir="$TMPDIR/agents"
    make_plugin_pair "$dir" "my-agent"
    cat > "$dir/my-agent.md" <<EOF
---
name: my-agent
---

You are a test agent. When invoked, do the thing.
EOF
    run bash "$SCRIPT" "$dir/my-agent.md"
    assert_failure
}

@test "fails when body contains unfilled FILL IN: placeholder" {
    local dir="$TMPDIR/agents"
    make_plugin_pair "$dir" "my-agent"
    cat > "$dir/my-agent.md" <<EOF
---
name: my-agent
description: A valid agent description.
---

FILL IN: replace this with your system prompt.
EOF
    run bash "$SCRIPT" "$dir/my-agent.md"
    assert_failure
}

@test "fails when frontmatter name does not match filename stem" {
    local dir="$TMPDIR/agents"
    make_plugin_pair "$dir" "my-agent"
    cat > "$dir/my-agent.agent.md" <<EOF
---
name: wrong-name
description: A valid agent description.
---

You are a test agent. When invoked, do the thing.
EOF
    run bash "$SCRIPT" "$dir/my-agent.md"
    assert_failure
}

@test "fails when no arguments are given" {
    run bash "$SCRIPT"
    assert_failure
}