Skip to content

Tracker: security and board automation on a GitHub App credential #2543

Open
0 of 6 issues completed
Open

Description

@cliffhall

Goal

Put the repo's security and board automation on one GitHub App credential, so alerts, advisories and new issues reach board #28 without a maintainer running /issue-triage by hand, and so v2 code is scanned before the release PR rather than on it.

Why now

The v2.9.0 release showed every gap at once:

Structure

Everything that writes to the board waits on one prerequisite: the GitHub App. Two items need no credential and can start immediately.

The Sub-issues panel on this issue is the canonical list, in this order:

  1. Create the GitHub App for board writes and security-alert reads, and store its credentials as org secrets #2544, the GitHub App. The long pole and human-gated (org admin), so it goes first and is requested now. Take every other admin decision to the same conversation (see below).
  2. Scan v2/main with CodeQL: switch from default setup to a committed advanced-setup workflow #2545, CodeQL on v2/main. Needs no credential; runs in parallel with Create the GitHub App for board writes and security-alert reads, and store its credentials as org secrets #2544. Disabling default setup is a repo-admin act.
  3. Move the Dependabot alert sweep from the nonexistent PROJECT_TOKEN to the GitHub App token #2547, the Dependabot sweep onto the App. The smallest consumer and the end-to-end proof that the App works; it sets the token-step pattern the rest copy.
  4. GHSA draft cards: place on the board for the affected line, and include affected versions + reporter #2462, GHSA draft cards. Its docs half (skills, AGENTS.md) needs no credential and can start before Create the GitHub App for board writes and security-alert reads, and store its credentials as org secrets #2544 lands.
  5. Board the SDK watch and monthly dependency-refresh issues with the GitHub App token #2548, boarding for the SDK watch and monthly refresh. Reuses Move the Dependabot alert sweep from the nonexistent PROJECT_TOKEN to the GitHub App token #2547's pattern.
  6. Nightly security sweep: turn Dependabot and code-scanning (CodeQL) alerts into board-tracked issues #2542, the code-scanning sweep. Better after Scan v2/main with CodeQL: switch from default setup to a committed advanced-setup workflow #2545, so alerts exist on the v2/main ref instead of a file/line re-check.
  7. Nightly triage: sweep unboarded issues onto the board and run the board audit #2463, nightly triage. The largest, and it needs a second credential decision (federation or a capped model key for third-party input).

#2546 (alerts #74–#76) is done.

Admin decisions to take in one pass

Invariants every sub-issue keeps

These are from AGENTS.md:

  • No model runs in a write-capable job. The deterministic sweeps need no model. Nightly triage (Nightly triage: sweep unboarded issues onto the board and run the board audit #2463) does, and must use the three-job shape sdk-watch.yml established.
  • A marker is trusted only on automation-authored issues, because the repo is public.
  • Every action in a credentialed job is SHA-pinned (verify:action-pins).
  • A sweep that cannot read its listing fails loudly and writes nothing.
  • Accepting and publishing a security advisory stay human-gated; automation only creates tracking cards.

Done when

Every sub-issue is closed, and a nightly run boards what it files with no manual step.

Activity

  1. added this to the v2.10.0 milestone on Sep 30, 2026
  2. added
    v2Issues and PRs for v2
    choreMaintenance: deps, build tooling, CI, cleanup — no user-facing behavior change
    on Sep 30, 2026
  3. cliffhall commented on Sep 30, 2026

    @cliffhall
    MemberAuthor

    Triage: Priority High (total 9)

    • Severity 4 — security findings go untracked and v2 code is unscanned until release (the v2.9.0 ReDoS)
    • Urgency 4 — blocks the planned automation; wanted for v2.10.0
    • Bonuses: +1 milestoned (v2.10.0)

    Board: #28, Status Todo. Part of tracker #2543.

  4. modified the milestones: v2.10.0, v2.11.0 on Oct 5, 2026
  5. modified the milestones: v2.11.0, v2.12.0 on Oct 12, 2026
  6. cliffhall commented on Oct 20, 2026

    @cliffhall
    MemberAuthor

    Admin decisions so far

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    choreMaintenance: deps, build tooling, CI, cleanup — no user-facing behavior changev2Issues and PRs for v2

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions