Skip to content

Cache activity before opening retirement PRs - #120

Open
philiptaron wants to merge 1 commit into
NixOS:mainfrom
philiptaron:issue-100
Open

Cache activity before opening retirement PRs#120
philiptaron wants to merge 1 commit into
NixOS:mainfrom
philiptaron:issue-100

Conversation

@philiptaron

@philiptaron philiptaron commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

I hate those "whoops" issues that #100 creates. Here's one kind of dumb take on fixing it. Sorry for the bash overload. I didn't want to rewrite this in github script first.

I rewrote the thing in GitHub script.

What does it do? In short, we persist the latest observed merge activity and the first inactive observation between workflow runs using a GitHub workflow artifact. A missing /commits response now starts a confirmation window instead of immediately opening a retirement PR. The result is that cached positive activity can keep active committers from being retired when GitHub returns an empty result spuriously.


I don't really love the resulting code. I'd sort of like to rewrite the whole thing.

I rewrote the whole thing.


Fixes #100

@philiptaron
philiptaron requested a review from mweinelt July 8, 2026 22:11
@philiptaron
philiptaron requested a review from infinisil as a code owner July 8, 2026 22:11

@MattSturgeon MattSturgeon left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Awesome!

I won't pretend to have fully digested the bash impl, so don't be offended if I spot something worth commenting on later.

SGTM overall, though. Nice idea to mitigate GitHub's flakiness!

Comment thread .github/workflows/retire.yml
Comment thread .github/workflows/retire.yml Outdated
Comment thread .github/workflows/retire.yml Outdated
Comment thread scripts/retire.sh Outdated
@philiptaron

Copy link
Copy Markdown
Contributor Author

Every one of your comments makes me want to rewrite it in github-script, @MattSturgeon :-)

Thanks for taking a look. I'll cogitate on these comments.

What does it do? In short, we persist the latest observed merge activity and the first inactive observation between workflow runs using a GitHub workflow artifact.
A missing `/commits` response now starts a confirmation window instead of immediately opening a retirement PR.
The result is that cached positive activity can keep active committers from being retired when GitHub returns an empty result spuriously.

Fixes NixOS#100
@philiptaron

Copy link
Copy Markdown
Contributor Author

I rewrote it in GitHub script.

@MattSturgeon MattSturgeon left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🚀

Comment thread scripts/README.md
Comment on lines +80 to +81
In CI, `retire.js` runs via [`actions/github-script`](https://github.com/actions/github-script).
Locally it can be run with `scripts/retire-local.js`, which needs Node.js (`pkgs.nodejs`) and uses the `gh` CLI for API access instead.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Could we add a nix-shell shebang to require-local.js, to allow users to run it without nodejs dependency setup? Or a separate shell.nix?

They'd still need to configure gh auth, though.

Comment thread scripts/restore-cache.js
Comment on lines +38 to +47
// The artifact download endpoint always serves a zip archive
const zip = (
await github.request(`GET /repos/${owner}/${repo}/actions/artifacts/${artifact.id}/zip`)
).data;
fs.mkdirSync(dir, { recursive: true });
const zipPath = path.join(dir, `${artifactName}.zip`);
fs.writeFileSync(zipPath, Buffer.from(zip));
execFileSync('unzip', ['-o', zipPath, '-d', dir], { stdio: 'inherit' });
fs.rmSync(zipPath);
core.info(`Restored activity cache from run ${runId}`);

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Uploading with archive: false would significantly simplify this bit.

(I don't have permission to unresolve #120 (comment), but see my reply there)

Comment thread scripts/retire-local.js
@@ -0,0 +1,74 @@
#!/usr/bin/env node
// Local runner for scripts/retire.js, providing an Octokit-compatible shim

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
// Local runner for scripts/retire.js, providing an Octokit-compatible shim
// Local runner for scripts/retire.js, providing an Octokit shim

Let's avoid implying the shim is fully compatible, since it only covers the subset we use.

Comment thread scripts/retire.js
return Math.floor(absolute / 1000);
}

const d = new Date();

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Minor correctness issue: each time we parade a date we'll be doing so relative to a different now epoch.

Since we're dealing with weeks and months, a few milliseconds are unlikely to cause real issues. But ideally, we'd have a way to synchronize now across multiple calls. E.g., with an input parameter:

function parseDate(spec, now = Date.now())

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Unreliable /commits endpoint

2 participants