Only the latest release is actively supported with security fixes.
| Version | Supported |
|---|---|
| Latest | Yes |
| Older | No |
Please do not open a public GitHub Issue for security vulnerabilities.
Report security issues privately via one of the following channels:
- GitHub Private Security Advisory: Use the Security tab → Report a vulnerability form in this repository.
- Email: Send details to
github@mail.hunsakerweb.comwith the subject line[Folge_Accessibility SECURITY] <short description>.
A useful report includes:
- A description of the vulnerability and its potential impact.
- Steps to reproduce or a minimal proof-of-concept.
- The version(s) affected.
- Any suggested mitigations or patches, if known.
| Milestone | Target |
|---|---|
| Acknowledgement of report | 3 days |
| Initial assessment / triage | 7 days |
| Patch / advisory published | 30 days |
If a fix will take longer than 30 days we will notify you and agree on a coordinated disclosure date.
This project is a documentation publishing pipeline that processes guide exports and generates accessible output formats. The security boundary is:
- In scope: vulnerabilities in the Python application code (
src/folge_cli/), dependency chain, configuration handling, and API key management. - Out of scope: vulnerabilities in external tools (Pandoc, Ollama, vision model servers), the host operating system, or user-supplied guide data.
API keys for cloud providers (OpenRouter, OpenAI, Gemini, Anthropic) are stored
in .env which is .gitignored. Never commit API keys to the repository.
Best practices:
- Use
.envfor all secrets — never hardcode keys in source files. - Add
.envto.gitignore(already configured). - Use environment-specific keys for development vs. production.
- Rotate keys regularly.
Dependencies are tracked in pyproject.toml. To audit the installed
environment for known CVEs run:
uv run pip-auditWe follow the GitHub coordinated vulnerability disclosure guidelines.