Charon/.github/skills/integration-test-rate-limit.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-rate-limit	1.0.0	Run rate limit integration tests aligned with the CI rate-limit workflow. Use to validate 200/429 behavior and reset windows.	Charon Project	MIT	integration security rate-limit throttling	os shells linux darwin bash	name version optional docker >=24.0 false name version optional curl >=7.0 false	name description default required RATE_LIMIT_REQUESTS Requests allowed per window in the test 3 false	name type description default required verbose boolean Enable verbose output false false	name type description test_results stdout Rate limit integration test results	category subcategory execution_time risk_level ci_cd_safe requires_network idempotent integration-test rate-limit medium low true true true

Integration Test Rate Limit

Overview

Runs the rate limit integration tests. This suite validates request throttling, HTTP 429 responses, Retry-After headers, and rate limit window resets.

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 rate limit integration tests:

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

Verbose Mode

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

CI/CD Integration

- name: Run Rate Limit Integration
  run: .github/skills/scripts/skill-runner.sh integration-test-rate-limit
  timeout-minutes: 7

Parameters

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

Environment Variables

Variable	Required	Default	Description
RATE_LIMIT_REQUESTS	No	3	Allowed requests per window in the test
RATE_LIMIT_WINDOW_SEC	No	10	Window size in seconds
RATE_LIMIT_BURST	No	1	Burst size in tests

Outputs

Success Exit Code

• 0: All rate limit 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-cerberus - Cerberus full stack tests

Notes

• Execution Time: Medium execution (3-5 minutes typical)
• CI Parity: Matches the rate limit integration workflow entrypoint

---

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