docs: use project contacts in SECURITY.md and the code of conduct (P2.4)

Drop the personal email address. Security reports go through GitHub
private vulnerability reporting, with hello@egzakta.com as the fallback;
the code of conduct points security reports there too. Add a
supported-versions table for the first community release and update
the scope to the desktop app, the server installer and the shipped
packages.
This commit is contained in:
shumeiko.it
2026-11-01 01:54:23 +01:00
parent ea724a6bfd
commit a369fb95f3
2 changed files with 52 additions and 39 deletions

View File

@@ -66,6 +66,10 @@ and fairly.
All community leaders are obligated to respect the privacy and security of the All community leaders are obligated to respect the privacy and security of the
reporter of any incident. reporter of any incident.
Security vulnerabilities are not conduct issues. Report them privately as
described in [SECURITY.md](SECURITY.md): through GitHub private vulnerability
reporting, or to **hello@egzakta.com** if you cannot use GitHub.
## Enforcement Guidelines ## Enforcement Guidelines
Community leaders will follow these Community Impact Guidelines in determining Community leaders will follow these Community Impact Guidelines in determining

View File

@@ -1,63 +1,72 @@
# Security Policy # Security Policy
Waggle OS runs on a user's own machine and touches sensitive material — API Waggle runs on the user's own computer and handles sensitive material: provider API keys,
keys, connector credentials, the local filesystem, and imported conversation connector credentials, the local file system, chats and memories. We take reports seriously
history. We take reports seriously and appreciate responsible disclosure. and appreciate responsible disclosure.
For the trust boundary, the controls that enforce it, and the currently known [`THREAT_MODEL.md`](./THREAT_MODEL.md) describes the trust boundary, the controls that enforce
gaps, read [`THREAT_MODEL.md`](./THREAT_MODEL.md). It is the authoritative it and the known gaps.
description of what Waggle defends against and what it does not.
## Reporting a Vulnerability ## Supported versions
**Please do not open a public GitHub issue for security vulnerabilities.** | Version | Supported |
|---|---|
| The latest community edition release | Yes |
| Earlier community edition releases | No. Update to the latest release. |
| Unreleased code on the default branch | Best effort |
Report privately through either channel: The commercial Waggle OS product is not covered by this policy.
1. **GitHub Security Advisories (preferred).** On the repository, go to the ## Reporting a vulnerability
**Security** tab → **Report a vulnerability**. This opens a private advisory
visible only to the maintainers. **Do not open a public issue for a security vulnerability.**
2. **Email.** Send details to **marko@egzakta.com** with `SECURITY` in the
1. **GitHub private vulnerability reporting (preferred).** On the repository, open the
**Security** tab and choose **Report a vulnerability**. The report is visible only to the
maintainers.
2. **Email, if you cannot use GitHub.** Write to **hello@egzakta.com** with `SECURITY` in the
subject line. subject line.
Please include: Please include:
- A description of the issue and the impact you believe it has. - what the issue is and the impact you expect;
- Step-by-step reproduction instructions (or a proof of concept). - steps to reproduce it, or a proof of concept;
- The affected component/package and version or commit SHA. - the affected component and the version or commit;
- Your environment (OS, Node version, desktop build vs. web). - your environment: operating system, desktop app or server installer, and the model provider
if it matters.
## What to Expect ## What to expect
- **Acknowledgement** within 5 business days. - An acknowledgement within 5 business days.
- An initial assessment and severity classification shortly after. - An assessment and a severity rating after that.
- Coordinated disclosure: we will agree on a timeline with you and credit you in - Coordinated disclosure: we agree on a timeline with you and credit you in the release notes
the release notes unless you prefer to remain anonymous. unless you prefer to stay anonymous.
Please give us a reasonable window to release a fix before any public Please give us reasonable time to release a fix before you disclose the issue publicly.
disclosure.
## Scope ## Scope
In scope: In scope:
- The desktop app (Tauri shell + bundled sidecar), the web app, and the - the desktop app (the Tauri shell and its bundled server);
workspace packages under `packages/` and `apps/`. - the server installer (`packages/launcher`) and the server archives it installs;
- Memory (`packages/memory-contract`, `packages/memory-mem0`). - the web UI (`apps/web`) and the shipped packages under `packages/`;
- Prompt-injection paths, secret handling (the vault), the filesystem boundary, - memory (`packages/memory-contract`, `packages/memory-mem0`);
and the capability/approval gates — see `THREAT_MODEL.md` for the details. - prompt-injection paths, secret handling in the vault, the file-system boundary, the local
API's authentication, and the approval gates.
Out of scope (documented, not vulnerabilities): Out of scope:
- The known gaps enumerated in `THREAT_MODEL.md` (e.g. the pattern-based - the known gaps listed in `THREAT_MODEL.md`, such as the pattern-based injection scanner and
injection scanner and the absence of an OS-level shell sandbox). If you can the absence of an operating-system sandbox for shell commands. If you can show impact beyond
demonstrate impact meaningfully beyond what is already documented there, we what is documented there, we still want to hear about it;
still want to hear about it. - findings that need control of the user's account or physical access to the computer: the user
- Findings that require a compromised operator account or physical access to the is trusted by design;
user's machine — the operator is trusted by design. - team mode packages (`packages/team-server`, `packages/waggle-dance`, `packages/worker`), which
are not built or shipped in this edition;
- third-party services that Waggle connects to.
## Secrets ## Secrets
If a report involves an exposed secret (an API key, token, or credential), note If a report involves an exposed secret (an API key, a token or a credential), say so clearly so
it explicitly so we can rotate it immediately. Never include live secrets in a it can be rotated at once. Never put live secrets in a public issue or pull request.
public issue or PR.