Charon/.github/skills/integration-test-cerberus.SKILL.md

name, version, description, author, license, tags, compatibility, requirements, environment_variables, parameters, outputs, metadata

name	version	description	author	license	tags	compatibility	requirements	environment_variables	parameters	outputs	metadata
integration-test-cerberus	1.0.0	Run Cerberus full-stack integration tests (WAF + rate limit + handler order). Use for local parity with CI Cerberus workflow.	Charon Project	MIT	integration security cerberus waf rate-limit	os shells linux darwin bash	name version optional docker >=24.0 false name version optional curl >=7.0 false	name description default required CHARON_EMERGENCY_TOKEN Emergency token required for some Cerberus teardown flows false	name type description default required verbose boolean Enable verbose output false false	name type description test_results stdout Cerberus integration test results	category subcategory execution_time risk_level ci_cd_safe requires_network idempotent integration-test cerberus medium medium true true true

Integration Test Cerberus

Overview

Runs the Cerberus full-stack integration tests. This suite validates handler order, WAF enforcement, rate limiting behavior, and end-to-end request flow in a containerized environment.

Prerequisites

• Docker 24.0 or higher installed and running
• curl 7.0 or higher for HTTP testing
• Network access for pulling container images

Usage

Basic Usage

Run Cerberus integration tests:

cd /path/to/charon
.github/skills/scripts/skill-runner.sh integration-test-cerberus

Verbose Mode

VERBOSE=1 .github/skills/scripts/skill-runner.sh integration-test-cerberus

CI/CD Integration

- name: Run Cerberus Integration
  run: .github/skills/scripts/skill-runner.sh integration-test-cerberus
  timeout-minutes: 10

Parameters

Parameter	Type	Required	Default	Description
verbose	boolean	No	false	Enable verbose output

Environment Variables

Variable	Required	Default	Description
CHARON_EMERGENCY_TOKEN	No	(empty)	Emergency token for Cerberus teardown flows
SKIP_CLEANUP	No	false	Skip container cleanup after tests
TEST_TIMEOUT	No	600	Timeout in seconds for the test

Outputs

Success Exit Code

• 0: All Cerberus integration tests passed

Error Exit Codes

• 1: One or more tests failed
• 2: Docker environment setup failed
• 3: Container startup timeout

Related Skills

• integration-test-all - Full integration suite
• integration-test-coraza - Coraza WAF tests
• integration-test-rate-limit - Rate limit tests

Notes

• Execution Time: Medium execution (5-10 minutes typical)
• CI Parity: Matches the Cerberus integration workflow entrypoint

---

Last Updated: 2026-02-07 Maintained by: Charon Project Team Source: scripts/cerberus_integration.sh