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.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
fix(robinhood): stop the feed worker running a stale local SDK copy, stage retired-repo pointers
nirholasf72c135c3b07
diff --git a/STRUCTURE.md b/STRUCTURE.mdindex 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 iscorrect: 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 listdiff --git a/data/retired-repos.json b/data/retired-repos.jsonnew file mode 100644index 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.jsonindex 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.mdindex 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 homechain; these are additional crypto surfaces, and each subproject below has itsown 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 toolingdiff --git a/scripts/stage-retired-repo-pointers.mjs b/scripts/stage-retired-repo-pointers.mjsnew file mode 100644index 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',+ '-c', '[email protected]',+ '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.mdindex 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:```bashcd 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 anenv var:diff --git a/workers/robinhood-feed/package-lock.json b/workers/robinhood-feed/package-lock.jsonindex 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.jsonindex 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.mjsdeleted file mode 100644index 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');