We actively support the following versions of this project with security updates:
| Version | Supported |
|---|---|
| 1.0.x | ✅ |
| < 1.0 | ❌ |
We take the security of our software seriously. If you believe you have found a security vulnerability, please report it to us as described below.
Please do not report security vulnerabilities through public GitHub issues.
Instead, please report them via email to: security@example.com
You should receive a response within 48 hours. If for some reason you do not, please follow up via email to ensure we received your original message.
Please include the following information in your report:
- Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
- Full paths of source file(s) related to the manifestation of the issue
- The location of the affected source code (tag/branch/commit or direct URL)
- Any special configuration required to reproduce the issue
- Step-by-step instructions to reproduce the issue
- Proof-of-concept or exploit code (if possible)
- Impact of the issue, including how an attacker might exploit the issue
This information will help us triage your report more quickly.
This CLI tool:
- Reads files from the file system based on user-provided glob patterns
- Writes files to the file system when using
-wor-ooptions - Creates directories when necessary for output
- Glob patterns are validated using the
globlibrary - File paths are sanitized to prevent directory traversal
- Input files are read with UTF-8 encoding
We regularly monitor our dependencies for security vulnerabilities:
commander: CLI argument parsingglob: File pattern matchingstrip-comments: Comment removal engine
When using this tool:
- Always backup your files before using the
-w(write) option - Be cautious with glob patterns that might match unintended files
- Verify the output directory when using the
-ooption - Run the tool in a controlled environment first
Security updates will be:
- Released as patch versions (e.g., 1.0.1, 1.0.2)
- Documented in the CHANGELOG.md
- Announced through GitHub releases
- Tagged with security labels
- Day 0: Vulnerability reported
- Day 1-2: Initial response and acknowledgment
- Day 3-7: Investigation and assessment
- Day 8-14: Fix development and testing
- Day 15-21: Release preparation
- Day 22: Public disclosure and release
This timeline may vary depending on the complexity of the vulnerability.
- All code changes require review
- Security-sensitive changes require additional scrutiny
- Automated security scanning is performed on all commits
- Keep dependencies up to date
- Monitor for security advisories
- Use
npm auditto check for vulnerabilities - Pin dependency versions in package-lock.json
- Include security test cases
- Test with malicious input
- Verify file system access controls
- Test cross-platform compatibility
This security policy applies to:
- The main CLI tool (
bin/document.js) - All supporting scripts and utilities
- Dependencies and their usage
- Documentation and examples
The following are generally not considered security vulnerabilities:
- Issues requiring physical access to the machine
- Social engineering attacks
- Issues in dependencies that don't affect this tool
- Performance issues without security implications
We appreciate the security research community's efforts to improve the security of open source software. Security researchers who responsibly disclose vulnerabilities will be:
- Credited in the security advisory (unless they prefer to remain anonymous)
- Listed in our hall of fame (if they consent)
- Thanked in the release notes
For security-related questions or concerns:
- Email: akshatsinhasramhardy@gmail.com
- For non-security issues: Use GitHub issues
This security policy is based on industry best practices and will be updated as needed to reflect changes in the threat landscape and our security posture.