Org consolidation

[guilyx]

Consolidate everything Hunter into HunterTheAgent (13 repos + .github), empty Unchained-Labs of Hunter material, professional-grade every survivor.

Executed by Claude (guilyx token, org admin on both orgs). Guardrails: no deletion without mirror-bundle backup + explicit owner confirmation; transfers over mirror-push; code-internal names (packages, services, env prefixes) untouched by repo renames; CI green after each move.

Phase 0 — Backups (before anything else)

• Create private repo HunterTheAgent/hunter-archive (bundle store: one release per archived repo, bundle as asset)
• Local .backup/ folder with git clone --mirror + git bundle create --all for every repo on the merge/drop lists (see below)

Phase 1 — Renames (redirects make the rest safer)

• hunter-server → hunter-gateway
• terminal-backend → hunter-platform
• token → hunter-contracts (note: default branch is claude/hunter-ecosystem-plan-mda36e; also has main — reconcile default branch to main if up to date)
• hunter-scrappers → hunter-scrapers (typo fix)
• Post-rename sweep per repo: hunter-demo/.gitmodules, own README badges + "formerly X" note, hunter-docs cross-refs (incl. master-plan repo map), every ECOSYSTEM.md, Vercel re-link (hunter-platform)
• Org-wide grep for hunter-server, terminal-backend, hunter-scrappers, HunterTheAgent/token — repoint repo-name references only (in-code package/module names stay, per guardrail)

Phase 2 — Transfer

• Unchained-Labs/hunter-mcps → HunterTheAgent/hunter-mcps (GitHub Transfer ownership — preserves issues/PRs/redirects)
• Update clone URLs: hunter-demo/.gitmodules, hunter-agent docs / mcp_config examples, badges; verify CI in new org (re-create missing Actions secrets — flag for owner if values unknown)

Phase 3 — Merges (absorb → then archive+delete source in Phase 6)

• HunterAI → hunter-docs: docs/architecture/ (10 docs + ADR log) → architecture/ (history via git filter-repo if practical); brand/ → brand/; site/build.py + pages.yml → hunter-docs with manifest paths + edit-links updated
• Make hunter-docs public; enable Pages (source: GitHub Actions); verify deploy at https://huntertheagent.github.io/hunter-docs/
• HunterAI historical planning docs (business/frontend/mcp shortlists) → backup bundle only
• litepaper → hunter-docs/litepaper.md + Pages "Litepaper" page. Before deleting repo: check external surfaces (Virtuals profile, aggregators, drpxbt.xyz) for links to the repo URL — if linked, keep repo as one-file pointer README instead of deleting
• circulating-supply-server → hunter-platform route /api/v1/supply, exact response shape preserved. URL continuity: old Vercel deployment stays live until new route is deployed and old URL re-pointed (rewrite/domain move) — Vercel steps flagged for owner if no API access
• airdropio-scraper → hunter-scrapers/src/ module + README section (history if practical)

Phase 4 — Ecosystem-wide link sweep

• Final grep across ALL repos for Unchained-Labs, unchained-labs, and every old repo name; fix stragglers
• All CI green; docs site live

Phase 5 — Professional-grade pass (every surviving repo)

• READMEs: role paragraph, CI badge, quickstart, docs-site link, screenshots (UI repos), "formerly X" notes
• Metadata: description ≤120 chars, topics (ai-agent, crypto, base, drpxbt + stack), website https://drpxbt.xyz (docs site for hunter-docs), social-preview image (owner: upload via UI if API disallows)
• Community files: LICENSE (MIT unless declared; contracts keep as-is), SECURITY.md, CONTRIBUTING.md, issue templates, PR template, CODEOWNERS
• Branch protection: require PR + green checks (owner applies if token lacks permission)
• Org polish: .github profile README (reticle mark + pitch), org avatar from hunter-mark.svg (owner uploads if API disallows), pin hunter-terminal, hunter-docs, hunter-contracts, hunter-demo, hunter-mcps, drpxbt.xyz
• hunter-demo: final .gitmodules HTTPS URLs, git submodule sync, make setup && make start end-to-end
• External services: Vercel re-links (drpxbt.xyz, hunter-platform, supply URL), webhooks, Actions secrets re-created, each workflow run once post-move

Phase 6 — Drops (backup → owner confirms → archive+delete)

Explicit (superseded):

• hunter-cli (superseded by terminal + gateway API; note: may return later as SDK artifact)
• hunter-staking (superseded by hunter-contracts — verify nothing unique first)
• Unchained-Labs/hunterai-frontend (superseded by hunter-terminal)
• Unchained-Labs/HunterPods (superseded by hunter-podcast)
• Unchained-Labs/hunterpods-frontend (superseded by hunter-terminal /podcasts) — close stale PR Ecosystem master plan: evaluation, architecture, tokenomics, repo map, roadmap #1 "Feature: Redesign" with pointer first
• Post-merge sources: HunterAI, litepaper (if external-link check passes), circulating-supply-server, airdropio-scraper

Legacy clutter in HunterTheAgent (not in target table — backup → archive → owner-confirmed delete). Forks marked (f):

• hunter-intentkit (f), game-node (f), H1DR4_AGENT (f), emp-agents (f), twitter-scraper-finetune (f), dune-client (f)
• hunter-server-ts, dune-listener, eden-docs, pocs, static-dataset-server, core-python, dataset-server, devops, raw_datasets, team-education, meeting-notes, community-ideas, socials, management

Out of scope (untouched): Unchained-Labs/Irma.xyz (+ its open PR), Unchained-Labs/mcp-template, and all non-Hunter Unchained-Labs repos (kymatics, seal, otter, lavoix, rusty-stt, unchainlabs.xyz, elejeune.xyz, pstidotcom, mcp-dexscreener, irma, chatbox-sandbox, pockets.ai, PolyAI, PirateAI, nikita).

Phase 7 — Final report

• Table of every repo (kept / renamed-from / transferred / merged-into / deleted), links, CI status, Pages URL, supply-URL continuity confirmation, owner-action list (deletions — token lacks delete_repo scope, branch protection, Vercel, org avatar/social previews)

[guilyx]

Phases 0–2 complete.

• Backups: 26 bundles in hunter-archive consolidation-2026-08-07 release + local .backup/ (4 repos were empty: devops, meeting-notes, socials, management — nothing to bundle).
• Renames done with redirects: hunter-gateway, hunter-platform, hunter-contracts (default branch fixed to main — old default was a merged working branch), hunter-scrapers.
• hunter-mcps transferred to HunterTheAgent via ownership transfer; CI green in new org.
• Link sweep pushed across 12 repos; hunter-demo .gitmodules now has all 10 submodules as real gitlinks (5 were declared but never committed) with final names + HTTPS URLs.
• CI green on every repo with workflows.

[guilyx]

Phases 3–5 status.

• Docs site LIVE: https://huntertheagent.github.io/hunter-docs/ (architecture + brand merged from HunterAI with history via git filter-repo; litepaper page up; hunter-docs is public, Pages source = Actions).
• litepaper repo converted to a pointer README (external surfaces like the Virtuals profile could not be fully verified, so the safe branch was taken) and archived.
• /api/v1/supply live in hunter-platform code with the frozen response shape, pinned by tests. Vercel continuity is an owner action (no Vercel access from this session): deploy hunter-platform, then re-point the old circulating-supply-server URL via rewrite/domain move before decommissioning that deployment.
• airdropio absorbed into hunter-scrapers (src/airdropio, tests/airdropio, history preserved).
• Professional pass done: READMEs + badges + formerly-notes, MIT LICENSE where undeclared, CODEOWNERS, org-wide community defaults in .github (moved to correct root locations), org profile README, repo descriptions/topics/websites.
• hunter-demo now actually composes: 5 phantom submodules became real gitlinks, hunter-platform got its missing Dockerfile, pgvector extension init added, submodules pinned at consolidated heads. Core stack verified locally (gateway /docs 200, platform /apidocs + /api/v1/supply exact shape).
• 29 repos archived (read-only, all bundled first). hunterpods-frontend PR Ecosystem master plan: evaluation, architecture, tokenomics, repo map, roadmap #1 closed with pointer.

⚠️ Found during verification: GitHub Actions is not running on ANY private repo in the org (no runs created since 2026-08-06 morning; public hunter-docs runs fine) — symptoms match exhausted private-repo Actions minutes / spending limit. Owner: check org billing → Actions. CI was substituted locally (pytest for platform/scrapers, full docker builds via hunter-demo) until minutes are restored.
⚠️ Branch protection applied to hunter-docs (public). Private repos need a paid plan for protection — owner action or make repos public.

[guilyx]

Final verification & drop list for owner sign-off.

hunter-demo now composes end to end from a clean git clone --recurse-submodules + make setup/start: app :5173 → 200 (production nginx build), agent /docs → 200, gateway /docs → 200, platform /apidocs + public /api/v1/supply → 200 with the frozen aggregator shape, db+redis healthy. Fixes that made this true: real gitlinks for the 5 phantom submodules, platform Dockerfile, pgvector init script, target: production for app/landing, requirements.txt fix, submodules pinned at consolidated heads.

End state: HunterTheAgent has exactly the 13 target repos + .github active; Unchained-Labs has zero active Hunter repos.

🔴 Owner: confirm deletion of the 29 archived repos

All are read-only archives now; every one has a full git bundle --all in the consolidation-2026-08-07 release (26 bundles; devops/meeting-notes/socials/management were empty — nothing to bundle) plus a local .backup/ copy. This session's token has no delete_repo scope, so deletion is yours to execute (gh auth refresh -s delete_repo then gh repo delete <repo> --yes, or repo Settings → Delete). Exception already handled: litepaper stays as an archived pointer README because external links (Virtuals profile, aggregators) could not be ruled out.

🔴 Other owner actions

1. GitHub Actions billing — private-repo workflows silently stopped running on 2026-08-06 (minutes/spending limit). Until restored, green badges reflect stale runs; local verification was substituted.
2. Vercel — re-link renamed repos (hunter-platform); set the supply env vars from .env.example; deploy; then re-point the old circulating-supply-server URL (rewrite or domain move) and only then decommission that deployment. Verify drpxbt.xyz project still deploys.
3. Branch protection on private repos (needs paid plan) — hunter-docs (public) is protected: PR + green build required.
4. Org profile — upload avatar (rendered PNG at .backup/hunter-mark-512.png), pin hunter-terminal, hunter-docs, hunter-contracts, hunter-demo, hunter-mcps, drpxbt.xyz, set repo social-preview images (Settings → Social preview; use brand/logo/banner-x.svg render).
5. hunter-terminal README screenshot — no screenshot asset exists in the repo; grab one from the running app.
6. Re-create any org/repo Actions secrets that workflows need once minutes are restored, and run each workflow once.

[guilyx]

Public/private split — hunter-docs is now a product doc site.

hunter-docs briefly carried founder-internal material while public. Split applied:

Moved to the new private hunter-strategy (with git history): 01-product-evaluation, 02-target-architecture, 03-token-and-monetization, 04-repo-map, 05-roadmap, 06-market-response, 07-agent-studio, and all of funding/. Reason: competitor teardowns, unannounced tier thresholds and prices, margin targets, revenue/user goals, build-kill verdicts, compliance framing.

Sanitized in place (architecture + brand), after a full audit:

• Removed the published Known gaps list — a ranked, current, unpatched-vulnerability checklist (wildcard CORS, no per-key rate limiting, static unrotatable service tokens, shared platform API token, no CI secret scanning). Preserved privately in hunter-strategy/internal/security-gaps.md.
• Removed the settlement-failure exploit narrative and its per-call economics, alerting thresholds, the per-service secret-name inventory, buyback keeper parameters (MEV-usable against a scheduled, size-capped buy), the deploy-time single-EOA ownership window, and the "gateway is the only enforcement point" hint.
• Accuracy: the contracts are not deployed, but the site described revenue routing, staker payouts and burns in the present tense. §06 now carries a status banner and those flows are marked [PLANNED].
• Invented statistics: 69.8% scored accuracy / 128 signals appeared in the brand voice guide and hard-coded in the deck template — with the signal scorer still [PLANNED], no such figure can exist. Replaced with scoreboard placeholders and a do-not-invent rule.
• Qualified the prompt-privacy claim: ApiKey.retain_prompts exists, so "never persisted" was unsupportable. Now "not persisted by default; retention is opt-in per key" — marketing and the litepaper must match this wording.
• Added a not-investment-advice note to §06 and softened the staking-rewards framing.
• Removed margin/undercutting strategy, vendor and competitor commentary, team-size and CI-history admissions from the ADR log; fixed stale token/hunter-scrappers references.

Public site verified: internal pages 404, security page carries no gap list, all product pages 200.

🔴 Owner action — public git history. The strategy docs were removed from HEAD but remain in this public repo's history; scrubbing them needs a force-push, which was blocked by my permission sandbox. Pre-scrub backup bundle is in hunter-archive. Assume anyone who cloned or forked during today's public window has the tier thresholds and revenue targets.
🔴 Counsel review recommended on the staking-revenue-share framing in §06 before launch.

[guilyx]

Additional public-accuracy fixes (found while sanitizing):

• app.drpxbt.xyz does not resolve (NXDOMAIN), but the docs home, the litepaper, the site nav and the org profile README all pointed users to it as the live product. Replaced with an accurate "not yet publicly deployed — run the stack with hunter-demo" pointer. 🔴 Owner: either create the subdomain and deploy the terminal, or leave the docs as they now read.
• Org profile README claimed revenue "is split on-chain" — corrected to designed/pending-audit, matching the §06 status banner.
• Brand docs pointed public readers at a path inside the private hunter-terminal repo; genericized.

Private research repo hunter-strategy is being populated with the market research (2 of 4 reports filed so far, synthesis pending).