Skip to content

Sync specs with contributed functionality - #1452

Merged
potiuk merged 1 commit into
apache:mainfrom
potiuk:sync-specs-20260928
Sep 28, 2026
Merged

potiuk merged 1 commit into
apache:mainfrom
potiuk:sync-specs-20260928

Conversation

@potiuk

@potiuk potiuk commented Sep 28, 2026

Copy link
Copy Markdown
Member

Summary

Type of change

  • Documentation (docs/, README.md, CONTRIBUTING.md)
  • Other: spec-loop specs and sync marker

Test plan

RFC-AI-0004 compliance

Not applicable; this documents shipped behaviour and changes no behaviour.

Notes for reviewers (optional)

The sync surfaced defects in code and docs outside the spec directory.
They are recorded as Known gaps in the relevant specs where they apply, and are left for follow-up PRs:

  • reviewer-routing tells users to run privacy-llm-check --list; the checker has no --list flag.
  • .apache-magpie-overrides/release-management-config.md (from config: publish Magpie's project configuration and AI contribution policy #1412) is the unfilled Apache Foo template.
    Per-file resolution makes it shadow Magpie's real ATR config in projects/magpie/.
  • tools/github/status-rollup.md still shows only the uv run … github-rollup CLI, not vetted-op-tracker.
  • tools/gitlab/tool.md still describes the ceil(limit / 100) paging that fix(tools/gitlab): address review follow-up on pagination docstring, short pages, and issue template #1441 replaced.
  • The isolated-setup-doctor and isolated-setup-verify headings say 8 probes and 12 checks; there are 9 and 15.
  • contributor-identity-map, onboarding-concierge, and sentiment do not declare organization: ASF.
  • docs/contributor-growth/README.md lists committer-onboarding as Triage (its mode is Meta) and gives two different skill counts.
  • tools/cve-tool-vulnogram/oauth-api docstrings still name a real CVE ID and another project's product names.

Suggested labels: family:docs, family:tools.


Generative AI tooling was used to author this PR: Claude Code (Claude Opus 5).

🤖 Generated with Claude Code

Back-fill the functional specs for everything merged to main since the
last sync marker, so the specs again describe what the code does.

Covers the move of skills into per-family plugin directories and of the
project templates into the magpie-setup plugin, the new contributor-growth
skills and tools (calibrate, candidate-screen, identity-map,
contributor-metrics, contract:chat), the adversarial-review rollout, the
GitLab read-only bridge, the github-rollup subcommands, the security-family
split and fixes, the Vulnogram token flow, the setup and sandbox changes
(gh api write-only asks, the shipped read-only allow set, commit attribution
as a project choice, working-directory grants), and the token-count stamps.
Stale paths, counts, statuses, and known gaps are corrected along the way.

Generated-by: Claude Opus 5
@potiuk
potiuk merged commit 894df8a into apache:main Sep 28, 2026
9 checks passed
@potiuk potiuk mentioned this pull request Sep 28, 2026
3 tasks done
@potiuk potiuk added the family:tools tools/* label Oct 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant