diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 0000000..b57bc00 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,37 @@ +name: Bug Report +description: File a bug report or report unexpected behavior +title: "[BUG]: " +labels: ["bug"] +body: + - type: textarea + id: description + attributes: + label: Bug Description + description: Clear and concise description of the issue. + placeholder: Describe what happened... + validations: + required: true + - type: textarea + id: reproduction + attributes: + label: Steps to Reproduce + description: Exact steps to reproduce the behavior. + placeholder: | + 1. Run command '...' + 2. Provide input '...' + 3. See error + validations: + required: true + - type: textarea + id: environment + attributes: + label: Environment Info + description: OS, runtime, and package versions. + placeholder: OS: Windows/Linux/macOS, Node/Python/Go version + validations: + required: true + - type: textarea + id: logs + attributes: + label: Logs / Stack Traces + description: Paste any error outputs or logs. diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..304a1aa --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: false +contact_links: + - name: Security Vulnerabilities + url: mailto:security@ritualdev.in + about: Report security issues privately via email. + - name: RitualDev-Lab Discussions + url: https://ritualdev.in + about: Ask questions and connect with the community. diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 0000000..66819a5 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,20 @@ +name: Feature Request +description: Propose an idea, feature, or improvement +title: "[FEAT]: " +labels: ["enhancement"] +body: + - type: textarea + id: problem + attributes: + label: Problem Statement + description: What problem would this feature solve? + placeholder: A clear description of the problem... + validations: + required: true + - type: textarea + id: solution + attributes: + label: Proposed Solution + description: Describe your proposed solution or enhancement. + validations: + required: true diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md new file mode 100644 index 0000000..5e12dae --- /dev/null +++ b/.github/pull_request_template.md @@ -0,0 +1,18 @@ +## Description +Please include a summary of the changes and motivation. + +Fixes # (issue) + +## Type of Change +- [ ] Bug fix (non-breaking change fixing an issue) +- [ ] New feature (non-breaking change adding functionality) +- [ ] Breaking change (fix or feature that causes existing functionality to change) +- [ ] Documentation update +- [ ] Refactor or build system improvement + +## Checklist +- [ ] My code follows the style guidelines of this project +- [ ] I have performed a self-review of my code +- [ ] I have added tests that prove my fix is effective or that my feature works +- [ ] All new and existing tests pass locally +- [ ] Documentation has been updated accordingly diff --git a/ACCESSIBILITY.md b/ACCESSIBILITY.md new file mode 100644 index 0000000..c557fe0 --- /dev/null +++ b/ACCESSIBILITY.md @@ -0,0 +1,12 @@ +# Accessibility Statement for agentshield-python + +RitualDev-Lab is committed to ensuring full digital accessibility for all developers and users, adhering to **WCAG 2.1 Level AA** guidelines. + +## Accessibility Features +- **Keyboard Navigation**: Interfaces and CLI workflows are operable via keyboard alone. +- **Color Contrast**: Compliant contrast ratios (>4.5:1 for standard text) across dark and light themes. +- **Screen Reader Support**: Semantic markup and ARIA descriptions for assistive technologies. +- **Clarity**: Descriptive error messages and status feedback. + +## Accessibility Inquiries +If you encounter any accessibility issues, please contact us at **accessibility@ritualdev.in**. We aim to respond within 2 business days. diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..6041052 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,13 @@ +# Code of Conduct + +## Our Pledge +We are dedicated to building a welcoming, inclusive, and harassment-free community across **agentshield-python** for everyone, regardless of background, identity, or experience level. + +## Community Standards +- Treat everyone with respect, kindness, and empathy. +- Gracefully accept constructive feedback and diverse perspectives. +- Focus on what is best for the overall developer community. +- Unacceptable behaviors include harassment, offensive commentary, and sharing private data without explicit consent. + +## Enforcement & Reporting +If you witness or experience unacceptable behavior, please reach out to **community@ritualdev.in** or **security@ritualdev.in**. All reports are reviewed promptly and confidentially. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..c4e3b41 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,29 @@ +# Contributing to agentshield-python + +Thank you for your interest in contributing to **agentshield-python**! + +## Getting Started +1. **Fork the repository** on GitHub. +2. **Clone your fork** locally: + ```bash + git clone https://github.com//agentshield-python.git + cd agentshield-python + ``` +3. **Create a topic branch**: + ```bash + git checkout -b feat/your-feature-name + ``` + +## Commit Conventions +We follow [Conventional Commits](https://www.conventionalcommits.org/): +- `feat:` New features or public APIs +- `fix:` Bug fixes +- `docs:` Documentation improvements +- `test:` Adding or updating tests +- `chore:` Dependency or build system updates + +## Pull Request Checklist +- Code adheres to existing formatting and linting rules. +- All test suites pass locally. +- Keep PRs focused on a single change. +- Link related issues in the description using `Fixes #`. diff --git a/README.md b/README.md index 58dd3a1..7eac5b3 100644 --- a/README.md +++ b/README.md @@ -140,3 +140,12 @@ clean_message = guard.filter_message(incoming_message) ## 📄 License MIT © [RitualDev Studio](https://ritualdev.in) + +--- + +## 🛡️ Community & Governance +- [Code of Conduct](CODE_OF_CONDUCT.md) +- [Contributing Guidelines](CONTRIBUTING.md) +- [Security Policy](SECURITY.md) +- [Accessibility Statement](ACCESSIBILITY.md) +- [License](LICENSE)