Skip to content

abom(plans): Plan improvements for production credentials, ownership claims, and QLaaS loop - #66

Merged
data-douser merged 4 commits into
mainfrom
abom/gh-app-perms/1
Nov 18, 2026
Merged

data-douser merged 4 commits into
mainfrom
abom/gh-app-perms/1

Conversation

@data-douser

Copy link
Copy Markdown
Contributor

This pull request updates ABOM documentation and code to reflect new support for published GitHub Release archives, and upgrades all dependencies and references to CodeQL 2.27.3 and the latest query packs. It also introduces a new plan for handling ownership claims, specifying how roles and permissions determine who can declare ownership in the system.

Documentation updates for published releases:

  • Updated README.md, docs/deployment/index.md, and related files to indicate that ABOM is now available as published GitHub Release archives for Linux and macOS, with instructions for verification and usage. Helm deployment is still pending. [1] [2] [3] [4] [5]

Dependency and version upgrades:

  • Bumped CodeQL CLI, ql-mcp, and related tool and query pack versions from 2.27.2 to 2.27.3 across configuration files and code, including .codeql-version, internal/harness/copilot.go, internal/runner/printast.go, internal/customql/customql.go, and documentation. [1] [2] [3] [4] [5]

Ownership claim and role model planning:

  • Added a new plan document (plans/api/ownership-claims.md) detailing how ownership claims are tied to user roles, outlining who can declare ownership (owners, admins, security managers, maintainers), and describing the technical and policy constraints for claim verification and eligibility.

data-douser and others added 2 commits November 19, 2026 09:28
Add three plans and re-rank plans/next.md:

- api/production-credentials.md: mint a per-call GitHub App installation
  token for Copilot and the two existing writes (dependency snapshot,
  default-setup language add), so a production instance needs no person's
  token. `gh auth` stays the path when no App is configured.
- api/ownership-claims.md: who may declare ownership. With `gh auth`,
  org owner/admin or security manager, and repo admin or maintainer as
  an include. In production, an org is eligible only where the App is
  installed. Folds in the deferred "member declares" item from
  db/owned-scope.md. Lands with production-credentials as one change.
- api/qlaas-loop.md: resume a failed session from an authoring icon by
  rewinding to a snapshot, steer a live session, pick any model the
  runtime lists, and offer every ql-mcp tool except the three that
  bypass ABOM's own steps.

In next.md, production credentials and ownership claims are rank 1 as a
single entry, the QLaaS loop is rank 2, and Demo drops to rank 3 with
the reason recorded. The owned-scope plan now points at the ownership
plan.
* Upgrade CodeQL CLI to v2.27.3

* chore(docs): update docs for v2.27.3 release

* chore(docs): update docs for v2.27.3 release

* chore: retrigger automatic dependency submission

GitHub never started an Automatic Dependency Submission run for 21de995, so
the License compliance check on that head waited indefinitely for a snapshot.
This empty commit gives the pull request a new head for both to run against.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: data-douser <70299490+data-douser@users.noreply.github.com>
Co-authored-by: Nathan Randall <data-douser@github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@data-douser data-douser self-assigned this Nov 18, 2026
@data-douser data-douser added documentation Improvements or additions to documentation enhancement New feature or request labels Nov 18, 2026
Copilot AI balanced review requested due to automatic review settings November 18, 2026 22:36

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note

Copilot was unable to run its full agentic suite in this review.

Copilot review overview

2 open issues
What changed in this PR

Updates ABOM’s pinned CodeQL/CodeQL-pack dependencies to the next patch release and refreshes documentation/plans to reflect newly available release archives and upcoming workstreams.

Changes:

  • Bump CodeQL CLI pin to v2.27.3 and update related Go constants/docs references.
  • Update CodeQL query-pack dependencies across Python/JavaScript/Go/C#/Actions packs (including lockfiles).
  • Add/adjust planning docs around production credentials, ownership claims, and the QLaaS authoring loop; update deployment docs to reflect GitHub Release archives.
File Description
ql/​python/​quality/​src/​codeql-suites/​abom-python-quality.qls Bumps imported python query suite version to 1.8.13
ql/​python/​quality/​src/​codeql-pack.yml Bumps pack version and codeql/python-queries dependency
ql/​python/​quality/​src/​codeql-pack.lock.yml Updates resolved CodeQL dependency versions for Python pack
ql/​javascript/​quality/​src/​codeql-suites/​abom-javascript-quality.qls Bumps imported JS query suite version to 2.4.8
ql/​javascript/​quality/​src/​codeql-pack.yml Bumps pack version and codeql/javascript-queries dependency
ql/​javascript/​quality/​src/​codeql-pack.lock.yml Updates resolved CodeQL dependency versions for JS pack
ql/​go/​quality/​src/​codeql-suites/​abom-go-quality.qls Bumps imported Go query suite version to 1.6.13
ql/​go/​quality/​src/​codeql-pack.yml Bumps pack version and codeql/go-queries dependency
ql/​go/​quality/​src/​codeql-pack.lock.yml Updates resolved CodeQL dependency versions for Go pack
ql/​csharp/​quality/​src/​codeql-suites/​abom-csharp-quality.qls Bumps imported C# query suite version to 1.10.2
ql/​csharp/​quality/​src/​codeql-pack.yml Bumps pack version and codeql/csharp-queries dependency
ql/​csharp/​quality/​src/​codeql-pack.lock.yml Updates resolved CodeQL dependency versions for C# pack
ql/​actions/​selfcheck/​src/​codeql-suites/​abom-selfcheck.qls Bumps imported Actions suite version to 0.6.38
ql/​actions/​selfcheck/​src/​codeql-pack.yml Bumps selfcheck pack version and Actions queries dependency
ql/​actions/​selfcheck/​src/​codeql-pack.lock.yml Updates resolved CodeQL dependency versions for selfcheck pack
ql/​actions/​lib/​codeql-pack.yml Bumps Actions lib pack version and codeql/actions-all dependency
ql/​actions/​lib/​codeql-pack.lock.yml Updates resolved CodeQL dependency versions for Actions lib
ql/​actions/​graph-extraction/​test/​codeql-pack.yml Bumps graph-extraction test pack version
ql/​actions/​graph-extraction/​test/​codeql-pack.lock.yml Updates resolved CodeQL dependency versions for graph-extraction tests
ql/​actions/​graph-extraction/​src/​codeql-pack.yml Bumps graph-extraction pack version and codeql/actions-all dependency
ql/​actions/​graph-extraction/​src/​codeql-pack.lock.yml Updates resolved CodeQL dependency versions for graph-extraction pack
ql/​actions/​findings/​test/​codeql-pack.yml Bumps findings test pack version
ql/​actions/​findings/​test/​codeql-pack.lock.yml Updates resolved CodeQL dependency versions for findings tests
ql/​actions/​findings/​src/​codeql-suites/​abom-findings.qls Bumps Actions queries suite pin for findings
ql/​actions/​findings/​src/​codeql-suites/​abom-experimental-findings.qls Bumps Actions queries suite pin for experimental findings
ql/​actions/​findings/​src/​codeql-pack.yml Bumps findings pack version and Actions dependencies
ql/​actions/​findings/​src/​codeql-pack.lock.yml Updates resolved CodeQL dependency versions for findings pack
plans/​next.md Reorders roadmap priorities; adds new plan items and updates rationale
plans/​db/​owned-scope.md Updates plan text to move “who may declare” details into ownership-claims plan
plans/​api/​qlaas-loop.md Adds new plan describing resumable authoring loop and tool/model handling
plans/​api/​production-credentials.md Adds new plan for App-based production credentials and scoped tokens
plans/​api/​ownership-claims.md Adds new plan defining role-based ownership claim eligibility and evidence reads
internal/​runner/​printast.go Updates pinned tools pack version to 2.27.3
internal/​harness/​copilot.go Updates default ql-mcp server version string to 2.27.3
internal/​customql/​customql.go Updates scaffolded Actions library pin to codeql/actions-all 0.7.0
docs/​deployment/​operations.md Updates ops guidance wording now that releases are referenced elsewhere
docs/​deployment/​index.md Updates deployment docs to mention GitHub Release archives
docs/​demo.md Updates demo instructions to CodeQL CLI 2.27.3
README.md Updates top-level installation messaging to reflect GitHub Releases availability
.codeql-version Bumps pinned CodeQL CLI to v2.27.3

Review effort: Lite

Comment thread docs/deployment/operations.md Resolved
Comment thread internal/harness/copilot.go Resolved
Copilot AI balanced review requested due to automatic review settings November 18, 2026 22:38

Copilot AI left a comment

Copy link
Copy Markdown

Comment thread plans/api/qlaas-loop.md Resolved
Comment thread plans/api/qlaas-loop.md Resolved
Comment thread plans/db/owned-scope.md Resolved
Comment thread plans/next.md Resolved
Comment thread plans/next.md Resolved
Copilot AI balanced review requested due to automatic review settings November 18, 2026 22:44

Copilot AI left a comment

Copy link
Copy Markdown

Comment thread plans/api/qlaas-loop.md Resolved
Comment thread plans/next.md Resolved
Comment thread plans/db/owned-scope.md Resolved
@data-douser
data-douser merged commit 485aa39 into main Nov 18, 2026
14 of 15 checks passed
@data-douser
data-douser deleted the abom/gh-app-perms/1 branch November 18, 2026 22:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants