This document explains how to report vulnerabilities and how security is
managed across the Intent-Driven Portal (IDP) repository and its sub-projects.
It complements the contribution rules in AGENTS.md and the operational guide
in docs/content/security.md; keep these sources in sync when updates are
made.
- Report suspected vulnerabilities privately via GitHub Security Advisories
- Do not open public GitHub issues or discussions for security reports.
- Include the affected component (see Components in scope), version or commit, reproduction details, and expected impact. If the report depends on external services or credentials, describe the assumptions instead of including secrets.
- We aim to acknowledge new reports within five business days and will share status updates and coordinated disclosure timelines as fixes are prepared.
IDP is pre-1.0. Security fixes are applied to main and the most recent
pre-release tags for maintained stacks. Older tags and forks are not patched;
upgrade to the latest published artifacts for coverage.
Security reports cover all maintained sub-projects in this repository:
- Reference stacks under
stacks/, includinggo/net-http/restandnodejs/react-fastify/rest. - Documentation site under
docs/(Docusaurus) and any published static assets. - Tooling under
tools/, including the MCP server, mock OAuth server, status publisher, VS Code extension scaffolding, and Backstage tooling. - Contract tests and fixtures under
tests/. - Container images built from any of the above when published from this repo.
- Run the privacy and secret scanning suite locally with
moon run repo:check-privacyormake check-privacy. Seedocs/content/security.mdfor details. - Follow the security requirements in
AGENTS.md(for example, secret handling rules and vulnerability scan expectations). UpdateSECURITY.mdwhenever those guardrails change.
Future security-related capabilities are tracked in
issue #171. They are not yet
available on main; do not assume roadmap items are implemented until the
repository contains the corresponding code and documentation.