apache / apache/magpie

track project security pages update as a required post-announcement step

Open
#180 0 comments 0 reactions 0 assignees View on GitHub
capability:resolve family:security good first issue kind:policy
Dominant language
Python
Stars
92
Forks
92
Avg merge
1d 12h
Merged PRs (30d)
104

Description

## Summary

The ASF `security_committers` policy
(https://www.apache.org/security/committers.html) requires as a
post-announcement step:

> The project team updates the project's security pages.

Neither `security-issue-sync` nor any other skill, process doc,
or roles doc in this repo mentions updating the project's public
security pages (e.g. `https://airflow.apache.org/security/`) after
an advisory ships. A grep across the entire repo for "security page",
"update page", and "/security" returns no matches in any skill or
process document.

This means the step is silently skipped in every advisory lifecycle
run by the skills.

## Where the gap shows up

`security-issue-sync` tracks the full advisory lifecycle through
to CVE PUBLISHED state and issue close (Steps 13–15), but the
signal table in Step 1d and the proposal items in Step 2b contain
no entry for "update the project security pages". The release
manager hand-off comment (fired at the `fix released` transition)
also does not include this as a checklist item.

## Required changes

1. Add an entry to the Step 1d signal table in
`security-issue-sync`:

> `announced` label set and *Public advisory URL* body field
> populated, but no "security pages updated" marker recorded →
> propose adding a checklist item for the release manager to
> update the project security pages.

2. Add a checklist item to the **release-manager hand-off
comment** (fired at the `pr merged → fix released` transition,
Step 2b) that explicitly lists updating the security pages as
a required post-advisory action.

3. Add the step to `docs/security/process.md` and
`docs/security/roles.md` under the release manager's
post-announcement responsibilities.

4. Optionally: add a project-config key in
`projects/_template/project.md` for the security pages URL
(e.g. `security_pages_url`) so the skill can render a
clickable link in the checklist item rather than a generic
placeholder.

## Policy reference

- https://www.apache.org/security/committers.html — "Complete"
section, first bullet

## Notes

This is a documentation and skill-checklist gap, not a process
logic change. The release manager still performs the update
manually; the skill just needs to prompt them to do it.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.