Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

chore(pump-watch): retire the GitHub Actions upstream watch and run it as a local script scoped to official packages

nirholasaacd33a4163c
diff --git a/.github/workflows/pump-upstream-watch.yml b/.github/workflows/pump-upstream-watch.yml
deleted file mode 100644
index 055cfe0be..000000000
--- a/.github/workflows/pump-upstream-watch.yml
+++ /dev/null
@@ -1,43 +0,0 @@
-name: Pump.fun upstream watch
-
-on:
- schedule:
- - cron: "37 7 * * *"
- workflow_dispatch:
-
-permissions:
- contents: read
- issues: write
-
-jobs:
- watch:
- runs-on: ubuntu-latest
- steps:
- - uses: actions/checkout@v4
- - uses: actions/setup-node@v4
- with:
- node-version: 22
- cache: npm
- - name: Compare npm and GitHub upstreams
- id: watch
- continue-on-error: true
- env:
- PUMP_WATCH_GITHUB_TOKEN: ${{ github.token }}
- run: |
- set +e
- node scripts/pump-upstream-watch.mjs > pump-upstream-report.md
- status=$?
- cat pump-upstream-report.md >> "$GITHUB_STEP_SUMMARY"
- exit "$status"
- - name: Open or refresh upstream drift issue
- if: steps.watch.outcome == 'failure'
- env:
- GH_TOKEN: ${{ github.token }}
- run: |
- title="Pump.fun upstream release needs review"
- existing=$(gh issue list --state open --search "$title in:title" --json number --jq '.[0].number // empty')
- if [ -n "$existing" ]; then
- gh issue edit "$existing" --body-file pump-upstream-report.md
- else
- gh issue create --title "$title" --body-file pump-upstream-report.md --label dependencies
- fi
diff --git a/docs/ops/pump-upstream-watch.md b/docs/ops/pump-upstream-watch.md
index 068f69bae..850d87c90 100644
--- a/docs/ops/pump-upstream-watch.md
+++ b/docs/ops/pump-upstream-watch.md
@@ -1,11 +1,12 @@
# Pump.fun upstream watch
-This is the operating contract for keeping three.ws and the public `nirholas`
-Pump.fun ecosystem current with official npm packages and public repositories.
+This is the operating contract for keeping three.ws current with the official
+Pump.fun npm packages and public repositories.
-## Automated signal
+## The check
-Run the same check locally that GitHub runs every day:
+Run it locally whenever a Pump.fun dependency is in question, and before any
+wave of SDK work:
```bash
npm run pump:watch
@@ -15,10 +16,10 @@ The command discovers every current `@pump-fun/*` npm package, compares their
`latest` tags and every public repository under `pump-fun` with
`data/pump-upstream-baseline.json`. A new package, package version, removed
package, new repository, removed repository, or repository push exits with
-status 2 and prints a review report. `.github/workflows/pump-upstream-watch.yml`
-runs it daily and opens or refreshes one GitHub issue instead of creating
-duplicate alerts. Dependabot separately opens dependency pull requests for
-`@pump-fun/*`.
+status 2 and prints a review report. Nothing runs it on a schedule: this repo
+uses no GitHub Actions, and the check writes its baseline back into the repo, so
+it belongs in a local run that a human reviews and commits. Dependabot
+separately opens dependency pull requests for `@pump-fun/*`.
After reviewing and integrating an upstream change, acknowledge the exact
state in the same pull request:
@@ -33,41 +34,6 @@ IDL refreshes are deterministic and use the official public docs first:
npm run pump:refresh-idls
```
-## Manual audit - 2026-09-14
-
-The audit queried all 309 public `nirholas` repositories, selected 32 whose
-name, description, or topics mentioned Pump.fun, memecoins, Solana launching,
-or creator rewards, then searched their checked-out public source. Twenty-seven
-contained Pump.fun code or documentation:
-
-- SDK and transaction builders: `pump-fun-sdk`, `pump-swap-sdk`,
- `pumpfun-rust-client`, `agent-payments-sdk`, `atomic`, `pumpvault`,
- `solana-sniper-mcp`.
-- Monitoring, claims, and market intelligence: `pumpkit`,
- `pumpfun-claims-bot`, `pumpfun-github-claims`, `pumpfun-creator-rewards`,
- `alerts-mcp`, `pumpfun-mcp`, `pump-fun-workers`, `oracle-model`, `kol-quest`,
- `visualize-web3-realtime`, `boosty`.
-- Agent, launch, and UI surfaces: `three.ws`, `avatar-agent-mcp`,
- `solana-launchpad-ui`, `launch-relay`, `clash-mcp`, `pump-fun-skills`,
- `memescope-monday-directory`, `analyze-memecoin-socials`,
- `robinhood-chain-alerts`.
-
-The package consumers needing follow-on repository-specific updates were:
-
-| Public repository | Observed dependency before this wave |
-|---|---|
-| `pump-fun-sdk` | `@pump-fun/pump-swap-sdk ^1.19.0` |
-| `pumpvault` | `@pump-fun/pump-sdk ^1.36.0`, swap SDK `^1.16.0` |
-| `solana-sniper-mcp` | Pump SDK `^1.36.0`, swap SDK `^1.19.0` |
-| `agent-payments-sdk` | Pump SDK `^1.35.0` in the standalone public checkout |
-| `atomic` | `@nirholas/pump-sdk ^1.30.0` |
-| `avatar-agent-mcp` | `@nirholas/pump-sdk ^1.30.0` |
-| `pumpkit` | `@nirholas/pump-sdk ^1.30.0` |
-
-Repository names alone are not treated as proof of an integration. The five
-description/topic candidates with no matching public source were excluded from
-the implementation inventory.
-
## Current upstream feature boundary
`@pump-fun/pump-sdk 2.0.0` adds protocol-native holder-reward coins, deprecates
diff --git a/scripts/pump-upstream-watch.mjs b/scripts/pump-upstream-watch.mjs
index b5d409d46..e1f88a2dd 100644
--- a/scripts/pump-upstream-watch.mjs
+++ b/scripts/pump-upstream-watch.mjs
@@ -77,60 +77,6 @@ async function officialRepoState() {
);
}
-async function nirholasCandidates() {
- const repos = [];
- for (let page = 1; page <= 4; page += 1) {
- const batch = await fetchJson(
- `https://api.github.com/users/nirholas/repos?per_page=100&page=${page}&type=public`,
- { github: true },
- );
- repos.push(...batch);
- if (batch.length < 100) break;
- }
- const relevant = /pump|memecoin|solana launch|creator reward/i;
- return repos
- .filter((repo) => repo.name === 'three.ws' || relevant.test(`${repo.name} ${repo.description ?? ''} ${(repo.topics ?? []).join(' ')}`))
- .map((repo) => ({
- name: repo.name,
- url: repo.html_url,
- updatedAt: repo.updated_at,
- archived: repo.archived,
- }))
- .sort((a, b) => a.name.localeCompare(b.name));
-}
-
-async function nirholasCodeConsumers() {
- if (!githubToken) return [];
- const queries = [
- 'user:nirholas "@pump-fun/"',
- 'user:nirholas "@nirholas/pump-sdk"',
- 'user:nirholas "pump.fun"',
- ];
- const found = new Map();
- for (const query of queries) {
- try {
- const result = await fetchJson(
- `https://api.github.com/search/code?per_page=100&q=${encodeURIComponent(query)}`,
- { github: true },
- );
- for (const item of result.items ?? []) {
- const repo = item.repository;
- if (repo?.owner?.login === 'nirholas' && !repo.private) {
- found.set(repo.name, {
- name: repo.name,
- url: repo.html_url,
- updatedAt: repo.updated_at,
- archived: repo.archived,
- });
- }
- }
- } catch (error) {
- process.stderr.write(`pump:watch: GitHub code search skipped (${error.message})\n`);
- }
- }
- return [...found.values()];
-}
-
function readDeclaredVersions() {
const manifests = [
'package.json',
@@ -183,22 +129,12 @@ function markdown(report) {
for (const [name, value] of Object.entries(report.repositories)) {
lines.push(`| [pump-fun/${name}](${value.url}) | ${value.pushedAt} | ${value.archived ? 'archived' : 'active'} |`);
}
- lines.push('', `## nirholas public Pump.fun surface (${report.nirholasCandidates.length} candidates)`, '');
- lines.push(report.nirholasCandidates.map((repo) => `[${repo.name}](${repo.url})`).join(', ') || 'None found.');
lines.push('', '## Drift', '');
lines.push(...(report.changes.length ? report.changes.map((change) => `- ${change}`) : ['No upstream drift detected.']));
return `${lines.join('\n')}\n`;
}
-const [packages, repositories, candidates, codeConsumers] = await Promise.all([
- npmState(),
- officialRepoState(),
- nirholasCandidates(),
- nirholasCodeConsumers(),
-]);
-const candidateMap = new Map(candidates.map((repo) => [repo.name, repo]));
-for (const repo of codeConsumers) candidateMap.set(repo.name, repo);
-const allCandidates = [...candidateMap.values()].sort((a, b) => a.name.localeCompare(b.name));
+const [packages, repositories] = await Promise.all([npmState(), officialRepoState()]);
const current = { packages, repositories };
let baseline = { packages: {}, repositories: {} };
try {
@@ -211,7 +147,6 @@ const report = {
packages,
repositories,
localConsumers: readDeclaredVersions(),
- nirholasCandidates: allCandidates,
changes: diffState(baseline, current),
};