From a67c0f35d135653f3fa7e33ee63d4e46885d8fc7 Mon Sep 17 00:00:00 2001 From: divyanshujethi Date: Tue, 17 Nov 2026 12:39:54 +0530 Subject: [PATCH 1/3] chore(governance): add code of conduct, contributing, security, a11y, and issue templates --- .github/ISSUE_TEMPLATE/bug_report.yml | 37 ++++++++++++++++++++++ .github/ISSUE_TEMPLATE/config.yml | 8 +++++ .github/ISSUE_TEMPLATE/feature_request.yml | 20 ++++++++++++ .github/pull_request_template.md | 18 +++++++++++ ACCESSIBILITY.md | 12 +++++++ CODE_OF_CONDUCT.md | 13 ++++++++ CONTRIBUTING.md | 29 +++++++++++++++++ README.md | 9 ++++++ 8 files changed, 146 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yml create mode 100644 .github/pull_request_template.md create mode 100644 ACCESSIBILITY.md create mode 100644 CODE_OF_CONDUCT.md create mode 100644 CONTRIBUTING.md 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) From 56a243f84c8205363928798c1a985d17bf24642e Mon Sep 17 00:00:00 2001 From: divyanshujethi Date: Tue, 17 Nov 2026 12:53:00 +0530 Subject: [PATCH 2/3] chore(funding): add dodo payments and ritualdev sponsor links and FUNDING.yml --- .github/FUNDING.yml | 6 ++++++ README.md | 16 ++++++++++++++++ 2 files changed, 22 insertions(+) create mode 100644 .github/FUNDING.yml diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml new file mode 100644 index 0000000..81a50f0 --- /dev/null +++ b/.github/FUNDING.yml @@ -0,0 +1,6 @@ +# GitHub Sponsors & Dodo Payments Configuration +github: [RitualDev-Lab] +custom: [ + "https://checkout.dodopayments.com/buy/pdt_0NpjONGugY5QkrFDUaPva", + "https://ritualdev.in/donate" +] diff --git a/README.md b/README.md index 7eac5b3..0aaa84f 100644 --- a/README.md +++ b/README.md @@ -143,6 +143,22 @@ MIT © [RitualDev Studio](https://ritualdev.in) --- +--- + +## 💖 Sponsor & Support + +If you find this project valuable, consider supporting our open-source development: + +[![Sponsor on Dodo Payments](https://img.shields.io/badge/Sponsor_via_Dodo-Payments-8b5cf6?style=for-the-badge&logo=shield&logoColor=white)](https://checkout.dodopayments.com/buy/pdt_0NpjONGugY5QkrFDUaPva) +[![Interactive Donation Portal](https://img.shields.io/badge/Donation_Portal-Cards%20%7C%20UPI%20%7C%20Apple%20Pay-ff5964?style=for-the-badge&logo=heart&logoColor=white)](https://ritualdev.in/donate) +[![GitHub Sponsors](https://img.shields.io/badge/GitHub_Sponsors-RitualDev--Lab-ea4aaa?style=for-the-badge&logo=githubsponsors&logoColor=white)](https://github.com/sponsors/RitualDev-Lab) + +- [**⚡ 1-Click Dodo Payments Checkout**](https://checkout.dodopayments.com/buy/pdt_0NpjONGugY5QkrFDUaPva) +- [**🎁 Interactive Donation Portal**](https://ritualdev.in/donate) +- [**❤️ GitHub Sponsors**](https://github.com/sponsors/RitualDev-Lab) + +--- + ## 🛡️ Community & Governance - [Code of Conduct](CODE_OF_CONDUCT.md) - [Contributing Guidelines](CONTRIBUTING.md) From 42125f21245f20a584fcbe83162abcd281cf9027 Mon Sep 17 00:00:00 2001 From: divyanshujethi Date: Wed, 18 Nov 2026 09:06:16 +0530 Subject: [PATCH 3/3] fix(phase6): Phase 6 (SEC-05/10): Remove Fail-Open PyPI continue-on-error & Fix SECURITY.md --- .github/workflows/publish-pypi.yml | 1 - SECURITY.md | 67 ++++++------------------------ 2 files changed, 13 insertions(+), 55 deletions(-) diff --git a/.github/workflows/publish-pypi.yml b/.github/workflows/publish-pypi.yml index 84764f1..9351f59 100644 --- a/.github/workflows/publish-pypi.yml +++ b/.github/workflows/publish-pypi.yml @@ -72,7 +72,6 @@ jobs: path: dist/ - name: Publish distribution 📦 to PyPI - continue-on-error: true uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.12.4 with: password: ${{ secrets.PYPI_API_TOKEN }} diff --git a/SECURITY.md b/SECURITY.md index 5d267c7..79360e1 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -1,63 +1,22 @@ # Security Policy & Vulnerability Disclosure -RitualDev Studio takes the security of autonomous AI infrastructure, secret defense runtimes, and developer tooling with utmost seriousness. +RitualDev Lab takes the security of **agentshield-python** (`agentshield-defense` PyPI SDK) seriously. ---- +## Supported Versions -## 🛡️ Supported Versions +| Version | Supported | Minimum Runtime | Response Target | +| :--- | :---: | :---: | :---: | +| **>= 0.2.2** | Active | Python >= 3.9 | Critical & High: < 24 Hours | +| < 0.2.2 | End-of-Life | — | Upgrade to >= 0.2.2 immediately | -We actively provide security updates, regression patches, and zero-day mitigations for the following versions: +## Reporting a Vulnerability -| Version | Supported | Minimum Engine | SLA Coverage | -| :--- | :---: | :---: | :--- | -| **0.2.x** | ✅ **Active** | Node.js >= 20.0.0 | **Critical & High: < 24 Hours** | -| 0.1.x | ⚠️ End-of-Life | Node.js >= 18.0.0 | Upgrade to v0.2.x recommended | +Please **do not** open public GitHub issues for undisclosed security vulnerabilities. ---- +- **GitHub Private Security Advisory (Preferred)**: [Report a Security Advisory](https://github.com/RitualDev-Lab/agentshield-python/security/advisories/new) +- **Email**: `security@ritualdev.in` with subject `[SECURITY VULNERABILITY] agentshield-defense (agentshield-python)` -## ⏱️ Guaranteed 24-Hour Response SLA +## Compliance & Control Alignment -We commit to the following response timeline for all reported vulnerabilities: -- **Initial Triage & Acknowledgment**: **< 24 Hours** (guaranteed). -- **Vulnerability Reproduction & Severity Assessment**: **< 48 Hours**. -- **Security Advisory Drafting & Patch Release**: **< 72 Hours** for Critical/High CVEs. - ---- - -## 🚨 Reporting a Vulnerability - -Please **DO NOT** create public GitHub issues or discussions for undisclosed security vulnerabilities. - -### Option 1: GitHub Private Security Advisory (Preferred) -Submit a report privately via GitHub's Coordinated Vulnerability Disclosure: -👉 **[Report a Security Advisory on GitHub](https://github.com/RitualDev-Lab/AgentShield/security/advisories/new)** - -### Option 2: Direct Security Team Dispatch -Email our engineering response team: -- **Email**: [`security@ritualdev.in`](mailto:security@ritualdev.in) -- **Subject**: `[SECURITY VULNERABILITY] @ritualdev-lab/agentshield` -- **PGP Encryption**: Available upon request. - -Please include: -1. Proof-of-Concept (PoC) code or reproduction script. -2. Attack vector taxonomy (e.g. CWE-77, ReDoS, Sandbox Bypass, Proc Environ Exfiltration). -3. Impact assessment on host environment or client agent runtime. - ---- - -## 🏛️ Safe Harbor Commitment - -RitualDev Studio will **never** pursue legal action against security researchers, ethical hackers, or academic teams who: -- Act in good faith to identify vulnerabilities. -- Provide us reasonable time to release a patch before public disclosure. -- Avoid accessing, destroying, or exfiltrating user data or production environments. - -Researchers reporting verified vulnerabilities will be credited on our **[Security Hall of Fame](https://ritualdev.in/trust)**. - ---- - -## 📜 Compliance & Audit Attestations - -For SOC 2 Type II, ISO 27001, and India DPDP Act 2023 compliance verification: -- **Trust Portal**: [https://ritualdev.in/trust](https://ritualdev.in/trust) -- **Interactive Playground**: [https://ritualdev.in/playground](https://ritualdev.in/playground) +- **Status**: SOC 2 Type II & ISO 27001 Control-Mapped Architecture (**Self-Attested Readiness; Formal Independent Audit Planned**). +- **Trust & Control Mapping Portal**: [https://ritualdev.in/trust](https://ritualdev.in/trust)