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.

fix(robinhood): stop the feed worker running a stale local SDK copy, stage retired-repo pointers

nirholasf72c135c3b07
diff --git a/STRUCTURE.md b/STRUCTURE.md
index f10fcd2c1..226f801f4 100644
--- a/STRUCTURE.md
+++ b/STRUCTURE.md
@@ -646,6 +646,15 @@ drift.
Until a surface has a concrete external consumer, skipping the mirror is
correct: each one adds a repo to keep in sync for zero functional gain.
+The reverse case, retiring a standalone repo that duplicates another repo or
+has been superseded by an in-repo surface, uses the same stage-then-owner-push
+split: [data/retired-repos.json](data/retired-repos.json) lists the repo, the
+reason, and where the capability lives now; `node
+scripts/stage-retired-repo-pointers.mjs` writes a one-commit pointer README
+per entry under `dist/retired-repos/<repo>/` (gitignored) and prints the
+`git push --force` + `gh repo archive` command pair for each, never running
+either.
+
## See also
- [README.md](README.md) — product overview, quickstart, full feature list
diff --git a/data/retired-repos.json b/data/retired-repos.json
new file mode 100644
index 000000000..bda8582f6
--- /dev/null
+++ b/data/retired-repos.json
@@ -0,0 +1,47 @@
+{
+ "generated": "manual, written for prompts/finish/503-integrate-04-robinhood-copies-and-retired-repos.md on 2026-10-14",
+ "repos": [
+ {
+ "repo": "three-ui",
+ "reason": "Old standalone snapshot of the three.ws frontend, still presenting itself as the live source of truth and documenting a Vercel deploy that no longer reflects production.",
+ "replacedByText": "the three.ws monorepo (this repository, `src/`)",
+ "replacedByUrl": "https://three.ws"
+ },
+ {
+ "repo": "crypto-market-data",
+ "reason": "Standalone market-data dashboard superseded by the /markets page on three.ws, which reads from the same live sources natively.",
+ "replacedByText": "the /markets page on three.ws",
+ "replacedByUrl": "https://three.ws/markets"
+ },
+ {
+ "repo": "crypto-market-data-ts",
+ "reason": "TypeScript rewrite of the same market-data service, also superseded by the /markets page on three.ws.",
+ "replacedByText": "the /markets page on three.ws",
+ "replacedByUrl": "https://three.ws/markets"
+ },
+ {
+ "repo": "crypto-data-aggregator",
+ "reason": "A third independent market-data aggregator, also superseded by the /markets page on three.ws.",
+ "replacedByText": "the /markets page on three.ws",
+ "replacedByUrl": "https://three.ws/markets"
+ },
+ {
+ "repo": "memescope-monday-directory",
+ "reason": "Duplicate of memescope-monday (both are the Memescope Monday community directory); keeping two copies of the same product split stars, issues and traffic for no reason.",
+ "replacedByText": "github.com/nirholas/memescope-monday",
+ "replacedByUrl": "https://github.com/nirholas/memescope-monday"
+ },
+ {
+ "repo": "robinhood-chain-alert-bot",
+ "reason": "Duplicate of robinhood-chain-alerts (both titled hood-alerts). robinhood-chain-alerts is the repo three.ws keeps in sync with robinhood/hood-alerts in this monorepo (data/standalone-mirrors.json).",
+ "replacedByText": "github.com/nirholas/robinhood-chain-alerts (synced from robinhood/hood-alerts)",
+ "replacedByUrl": "https://github.com/nirholas/robinhood-chain-alerts"
+ },
+ {
+ "repo": "robinhood-chain-trading-bot",
+ "reason": "Duplicate of robinhood-chain-traders (both titled hood-traders). robinhood-chain-traders is the repo three.ws keeps in sync with robinhood/hood-traders in this monorepo (data/standalone-mirrors.json).",
+ "replacedByText": "github.com/nirholas/robinhood-chain-traders (synced from robinhood/hood-traders)",
+ "replacedByUrl": "https://github.com/nirholas/robinhood-chain-traders"
+ }
+ ]
+}
diff --git a/package.json b/package.json
index ffb9f5ebf..ad1d04df0 100644
--- a/package.json
+++ b/package.json
@@ -379,6 +379,7 @@
"sync:repos": "node scripts/sync-standalone-repos.mjs",
"sync:repos:check": "node scripts/sync-standalone-repos.mjs --check",
"mirrors:drift": "node scripts/mirror-drift-report.mjs",
+ "retire:repos": "node scripts/stage-retired-repo-pointers.mjs",
"build:chat": "cd chat && node scripts/ensure-deps.mjs && npm run build && cd .. && mkdir -p dist/chat && cp -rf public/chat/. dist/chat/",
"deps:chat": "cd chat && node scripts/ensure-deps.mjs",
"build:avatar-studio": "npm run build --prefix character-studio",
diff --git a/robinhood/README.md b/robinhood/README.md
index 96c311a32..571fe1a61 100644
--- a/robinhood/README.md
+++ b/robinhood/README.md
@@ -5,14 +5,32 @@ Orbit L2, chain ID 4663): Robinhood Crypto only. Solana remains the home
chain; these are additional crypto surfaces, and each subproject below has its
own README with install and usage.
-> **npm publishing note (2026-08-02):** the npm releases of these packages
-> (hood-cli 0.2.1, hood-traders 0.2.1, hood-mcp / hoodkit / hood402 / hood-api /
-> hood-js / hood-connect / erc8056 0.1.1) were published from their standalone
-> GitHub repos (`nirholas/robinhood-chain-*`), which are the source of truth.
-> The copies in this directory are older snapshots kept for reference. Do NOT
-> `npm publish` from here: you would ship stale code over a newer release. Sync
-> from the standalone repo (or the published tarball) first if a release must
+> **Reference copies, not the source of truth (updated 2026-10-14):** every
+> package below is also a standalone GitHub repo (`nirholas/robinhood-chain-*`,
+> listed with `direction: "in"` in [`data/standalone-mirrors.json`](../data/standalone-mirrors.json)),
+> and those standalone repos are where each package is developed and
+> published to npm. The copies in this directory are read-only snapshots kept
+> for reference inside the monorepo; they drift from their standalone repos
+> between manual re-syncs, sometimes by hundreds of lines (see
+> [`npm run mirrors:drift`](../scripts/mirror-drift-report.mjs)). Do NOT `npm
+> publish` from here: you would ship stale code over a newer release. Sync from
+> the standalone repo (or the published tarball) first if a release must
> happen from this tree.
+>
+> Two standalone repos duplicate another one under a different name
+> (`robinhood-chain-alert-bot` duplicates `robinhood-chain-alerts`;
+> `robinhood-chain-trading-bot` duplicates `robinhood-chain-traders`, both
+> pairs titled identically on npm, `hood-alerts` and `hood-traders`). The
+> duplicates have pointer READMEs staged under `dist/retired-repos/` for the
+> owner to push and archive; `robinhood-chain-alerts` and
+> `robinhood-chain-traders` stay the ones this directory mirrors.
+>
+> The one package production actually imports,
+> [`robinhood-chain-sdk`](robinhood-chain-sdk/) (npm name `hoodchain`), is
+> consumed by [`workers/robinhood-feed`](../workers/robinhood-feed/) as a
+> normal pinned npm dependency, not a `file:` link into this directory: the
+> worker always runs the published release, never whatever happens to be
+> checked out here.
## Developer tooling
diff --git a/scripts/stage-retired-repo-pointers.mjs b/scripts/stage-retired-repo-pointers.mjs
new file mode 100644
index 000000000..311ab9680
--- /dev/null
+++ b/scripts/stage-retired-repo-pointers.mjs
@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+// Stage a one-file, one-commit pointer README for every repo in
+// data/retired-repos.json under dist/retired-repos/<repo>/, ready for the
+// owner to force-push over the repo's current README and archive it.
+//
+// This script never pushes and never talks to the GitHub API: it only writes
+// under dist/ (gitignored) and prints the exact push + `gh repo archive`
+// commands, same split of responsibility as sync-standalone-repos.mjs.
+//
+// Usage:
+// node scripts/stage-retired-repo-pointers.mjs
+
+import { execFileSync } from 'node:child_process';
+import { readFileSync, rmSync, mkdirSync, writeFileSync } from 'node:fs';
+import { resolve, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const owner = 'nirholas';
+const STAGE_ROOT = join(root, 'dist', 'retired-repos');
+const today = new Date().toISOString().slice(0, 10);
+
+const manifest = JSON.parse(readFileSync(join(root, 'data', 'retired-repos.json'), 'utf8'));
+
+function readme(entry) {
+ return `# ${entry.repo} (archived)
+
+**This repository is archived as of ${today}.** ${entry.reason}
+
+The capability now lives at [${entry.replacedByText}](${entry.replacedByUrl}).
+
+No further commits will land here. Issues and pull requests are closed on
+archive; open them against the link above instead.
+`;
+}
+
+function stage(entry) {
+ const dest = join(STAGE_ROOT, entry.repo);
+ rmSync(dest, { recursive: true, force: true });
+ mkdirSync(dest, { recursive: true });
+ writeFileSync(join(dest, 'README.md'), readme(entry));
+
+ const run = (args) => execFileSync('git', args, { cwd: dest, stdio: 'pipe', encoding: 'utf8' });
+ run(['init', '-q', '-b', 'main']);
+ run(['add', '-A']);
+ run([
+ '-c', 'user.name=three.ws sync',
+ 'commit', '-q', '-m',
+ `Archive: point to ${entry.replacedByText}`,
+ ]);
+ return `${owner}/${entry.repo}`;
+}
+
+console.log(`STAGE: ${manifest.repos.length} retired-repo pointer(s) under dist/retired-repos/*\n`);
+
+const commands = [];
+for (const entry of manifest.repos) {
+ const slug = stage(entry);
+ console.log(`-- ${entry.repo} -> dist/retired-repos/${entry.repo} (github.com/${slug})`);
+ commands.push(`git -C dist/retired-repos/${entry.repo} push --force https://github.com/${slug}.git HEAD:main`);
+ commands.push(`gh repo archive ${slug} --yes`);
+}
+
+console.log(`\nStaged ${manifest.repos.length} pointer README(s). 0 repos pushed, 0 archived (this tool never does either).`);
+console.log('\nTo publish and archive, run (owner-gated, two lines per repo):\n');
+for (const line of commands) console.log(` ${line}`);
diff --git a/workers/robinhood-feed/README.md b/workers/robinhood-feed/README.md
index 9ca77e7aa..feac66990 100644
--- a/workers/robinhood-feed/README.md
+++ b/workers/robinhood-feed/README.md
@@ -106,15 +106,13 @@ Documented per the mission brief — fields map 1:1 where semantics align:
```bash
cd workers/robinhood-feed
-npm install # symlinks hoodchain from ../../robinhood/robinhood-chain-sdk
+npm install # installs hoodchain from npm (published from robinhood-chain-sdk)
npm start # listens on :8788 (mainnet, public RPC + sequencer feed)
```
-`npm install` on a `file:` dependency only symlinks the source directory: npm
-does not build it, and the SDK is TypeScript whose `dist/` is gitignored. So
-`npm start` runs `scripts/ensure-sdk.mjs` first (`prestart`), which builds the
-SDK's `dist/` when it is missing. That takes a few seconds on a fresh clone and
-is a no-op afterwards. To do it by hand: `npm run build:sdk`.
+`hoodchain` is a normal npm dependency pinned to the version published from the
+standalone `robinhood-chain-sdk` repo, the SDK's source of truth (see
+`robinhood/README.md`). No local build step is needed.
Zero-config defaults hit the public Robinhood Chain endpoints. Every knob is an
env var:
diff --git a/workers/robinhood-feed/package-lock.json b/workers/robinhood-feed/package-lock.json
index b543cd455..c460d9ef0 100644
--- a/workers/robinhood-feed/package-lock.json
+++ b/workers/robinhood-feed/package-lock.json
@@ -7,9 +7,9 @@
"": {
"name": "robinhood-feed",
"version": "0.1.0",
- "license": "SEE LICENSE IN LICENSE",
+ "license": "Apache-2.0",
"dependencies": {
- "hoodchain": "file:../../robinhood/robinhood-chain-sdk",
+ "hoodchain": "^0.1.1",
"viem": "^2.55.0",
"ws": "^8.18.0"
}
@@ -17,7 +17,7 @@
"../../robinhood/robinhood-chain-sdk": {
"name": "hoodchain",
"version": "0.1.1",
- "license": "SEE LICENSE IN LICENSE",
+ "license": "Apache-2.0",
"devDependencies": {
"@types/node": "^24.0.0",
"@types/ws": "^8.18.0",
diff --git a/workers/robinhood-feed/package.json b/workers/robinhood-feed/package.json
index ec37efeca..ea1820210 100644
--- a/workers/robinhood-feed/package.json
+++ b/workers/robinhood-feed/package.json
@@ -8,15 +8,12 @@
"license": "Apache-2.0",
"main": "index.js",
"scripts": {
- "prestart": "node scripts/ensure-sdk.mjs",
"start": "node index.js",
"test": "node --test tests/**/*.test.js",
- "presmoke:live": "node scripts/ensure-sdk.mjs",
- "smoke:live": "node scripts/smoke-live.mjs",
- "build:sdk": "node scripts/ensure-sdk.mjs"
+ "smoke:live": "node scripts/smoke-live.mjs"
},
"dependencies": {
- "hoodchain": "file:../../robinhood/robinhood-chain-sdk",
+ "hoodchain": "^0.1.1",
"viem": "^2.55.0",
"ws": "^8.18.0"
}
diff --git a/workers/robinhood-feed/scripts/ensure-sdk.mjs b/workers/robinhood-feed/scripts/ensure-sdk.mjs
deleted file mode 100644
index a938836ba..000000000
--- a/workers/robinhood-feed/scripts/ensure-sdk.mjs
+++ /dev/null
@@ -1,35 +0,0 @@
-// Build the local `hoodchain` SDK if its dist/ is missing.
-//
-// package.json depends on the SDK through `file:../../robinhood/robinhood-chain-sdk`,
-// which npm resolves by symlinking the source directory. npm does NOT run that
-// directory's build for a file: dependency, and the SDK ships TypeScript whose
-// dist/ is gitignored, so a fresh clone gets a symlink to a package with no
-// entry point and `node index.js` dies with ERR_MODULE_NOT_FOUND. This runs as
-// the worker's `prestart`/`presmoke` hook so `npm start` works from a clean
-// checkout with no manual step.
-
-import { execFileSync } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const workerDir = dirname(dirname(fileURLToPath(import.meta.url)));
-const sdkDir = join(workerDir, '..', '..', 'robinhood', 'robinhood-chain-sdk');
-const entry = join(sdkDir, 'dist', 'index.js');
-
-if (existsSync(entry)) {
- process.exit(0);
-}
-
-if (!existsSync(join(sdkDir, 'package.json'))) {
- console.error(`[ensure-sdk] hoodchain source not found at ${sdkDir}`);
- console.error('[ensure-sdk] install the published package instead: npm install hoodchain');
- process.exit(1);
-}
-
-const run = (args) => execFileSync('npm', args, { cwd: sdkDir, stdio: 'inherit' });
-
-console.log('[ensure-sdk] building hoodchain from source (dist/ is gitignored and absent)');
-if (!existsSync(join(sdkDir, 'node_modules'))) run(['install', '--no-audit', '--no-fund']);
-run(['run', 'build']);
-console.log('[ensure-sdk] hoodchain dist/ ready');