CopyTree is currently in pre-release (0.x versions). Security updates are provided for:
| Version | Supported | Notes |
|---|---|---|
| 0.x | ✅ | Latest 0.x release only (pre-release) |
| < 0.x | ❌ | Upgrade to latest 0.x |
Post-1.0 Support Policy: Once we release 1.0.0, we will adopt an LTS (Long Term Support) approach with:
- Security updates for all 1.x minor versions for 12 months
- Critical security fixes backported to the previous major version for 6 months
- Clear end-of-life dates announced in advance
CopyTree requires Node.js 20.0.0 or higher. We only support security issues on supported Node.js LTS versions.
We take security vulnerabilities seriously. If you discover a security issue in CopyTree, please report it responsibly:
DO NOT create a public GitHub issue for security vulnerabilities.
Instead, please email security reports to: greg@siteorigin.com
Include in your report:
- Description of the vulnerability
- Steps to reproduce the issue
- Potential impact
- Any suggested fixes (optional)
- Acknowledgment: We'll acknowledge receipt within 48 hours
- Initial Assessment: We'll provide an initial assessment within 5 business days
- Updates: We'll keep you informed of progress toward a fix
- Disclosure: Once fixed, we'll coordinate disclosure timing with you
- Credit: We'll credit you in the security advisory (unless you prefer to remain anonymous)
CopyTree can fetch files from external sources (GitHub repositories). Be aware:
- External sources are fetched over HTTPS
- Git commands are executed via
simple-gitlibrary - No arbitrary command execution from external sources
- External sources are triggered by passing a URL as the path argument
CopyTree reads files from your local system:
- Respects
.gitignoreand.copytreeignorepatterns - Follows symbolic links by default (can be disabled)
- Binary files are handled according to configuration
- No files are modified or deleted by CopyTree
User configuration files are stored in:
~/.copytree/(global).copytree/(project-specific)
These files are executed as JavaScript/JSON. Only use configuration files from trusted sources.
When using CopyTree:
- External Sources: Only include external sources from trusted repositories
- Configuration: Review custom profiles and configuration files before use
- Output: Review generated output before sharing, especially with AI tools
- Binary Files: Be cautious with binary file handling in sensitive projects
- Secrets Detection: Use
--secrets-guard(enabled by default) to prevent accidental secret exposure
- CopyTree shells out to
gitfor repository operations - External sources require network access
Security updates will be published via:
- GitHub Security Advisories
- npm package updates
- CHANGELOG.md entries marked with
[SECURITY]
For security-related questions or concerns, contact: greg@siteorigin.com