This document describes how security reports for the wheel repository are
handled. Normative product security requirements live in the canonical
bitty-docs security corpus and take precedence over anything stated here.
| Version | Supported |
|---|---|
| Unreleased | No — no version of this project has been released |
There are currently no supported releases. Do not rely on this repository for production use.
Report security vulnerabilities privately by opening a GitHub Security Advisory.
Do not report security vulnerabilities through public GitHub issues, pull requests, or discussion channels.
When reporting, please include as much of the following as possible:
- A description of the vulnerability and its potential impact.
- Steps to reproduce, or a proof of concept.
- Affected files, Lua modules, manifests, or generated outputs.
- Any known mitigations or workarounds.
Reports are handled through coordinated disclosure:
- The report is acknowledged and triaged privately.
- A fix is developed and validated out of public view.
- Once releases exist, a release containing the fix is published.
- A public advisory is published afterward, crediting the reporter unless anonymity is requested.
The targets below take effect once this repository accepts them:
- Acknowledge a new advisory within 5 business days.
- Provide a status update at least every 14 calendar days while a report is open.
- Publish the advisory after a fixed version is available, or after 90 days if no fix is feasible, whichever comes first.
The plugin requests only ui.rich and ui.overlay: it composes declarative
overlay scenes and holds no filesystem, process, network, clipboard, terminal
input, or persistent-state authority, and it executes no install-time code.
Findings that contradict those boundaries — including a manifest change that
would widen the capability set, unbounded input handling, or an escape from
the declarative UI primitives — are security-relevant defects.