OPTXOPTX DOCS
Reference

Changelog

801010

Version history and release notes for the OPTX ecosystem.

2026-05-17 — v2.0.2: Light-mode burnt orange + sidebar icons + IP scrub + Matrix security scrub + gaze video

Added

  • Sidebar icons rendered for JettChat (MessageCircle) and Token (Coins) categories. Both were declared in meta.json all along but never imported into lib/source.ts, so the resolver silently returned undefined. Now both icons appear next to the section headers.
  • "Open Source" landing callout at the bottom of /docs promoting jettoptx-aaron-router as the public flagship — FastAPI · Proof-of-Insight · AGT pipeline · Solana DePIN attestation.
  • Video embed on /docs/authentication/gaze — AGT Intro Learner mp4 self-hosted under /videos/, full-width 16:9, native HTML5 controls, no autoplay, lazy preload="metadata".

Changed

  • Light-mode burnt orange theme. Refactored 22 hardcoded rgb(255, 105, 0) usages to var(--color-orange-500) across app/globals.css, header (app/docs/layout.tsx), footer (components/footer.tsx), AGENTS banner (components/agent-banner.tsx), DOCS RULES panel (components/docs-rules-panel.tsx), and body links (components/mdx-link.tsx). Added :root:not(.dark) override to a burnt brick (rgb(220, 78, 31)) that matches the JETT OPTICS poster palette. Dark mode keeps the neon #FF6900 via the :root default. --color-orange-400 also overridden in light mode (rgb(232, 105, 60)) for matching link-hover states.
  • Ecosystem repo links updated to jettoptx-* canonical names (org rename from joe-* completed). GitHub still redirects the old slugs but the new links skip the hop. Order in the footer REPOS column: jettoptx-aaron-router, jettoptx-cstb-depin, jettoptx-docs, hermes-xai-oauth-wsl (the non-org-prefixed companion tool at the bottom).
  • Ecosystem swap. jettoptx-hermes-api (degraded) replaced by hermes-xai-oauth-wsl in the footer REPOS column and README ecosystem table.

Security

  • IP scrub for public release. Renamed knot_polynomialastro_knot and polynomial_encodingastro_encoding across /docs/protocol/* (struct fields, TS interfaces, reducer args). Reworded the ecosystem table row for the astroknots repo. Math-revealing vocabulary (Jones / Alexander / braid / knot-theoretic / knot-encoded / knot invariant) no longer appears in any public-facing doc.
  • Matrix operational disclosure scrub. Deleted /docs/astrojoe/matrix and removed every inbound reference across 4 content files and 5 components. Wiped operational Matrix disclosures from topology.mdx and historical changelog entries. Generic "federation transport" terminology retained.

Process

  • Changelog currency rule added to both rule surfaces:
    • The MDX page at /docs/rules — new "9. Changelog Currency (NON-NEGOTIABLE)" section under For Agents & LLMs, "Always Update the Changelog (Same Session)" section under For Human Developers, and a new checklist item at the bottom.
    • The DOCS RULES side panel — components/docs-rules-content.ts AGENT_RULES rule #9 + HUMAN_RULES rule #5.
  • Every shipped change MUST update both the footer changelog block (components/footer.tsx) AND this long-form page in the same session — either in the same commit as the work or as an immediate follow-up. Applies to LLMs, VLMs, and human contributors equally.
  • Also fixed the stale "Last updated: April 30, 2026 — v2.0.0" line in the footer (now correctly reads v2.0.2).
  • Style rule #8 updated to warn against hardcoding rgb(255, 105, 0) — agents should use var(--color-orange-500) so the burnt-brick light-mode override cascades.
  • Brand-block GitHub icon (footer top-left, next to the OPTX wordmark + tagline) repointed from jettoptx/optx-hermes-api (a stale repo path that no longer existed) to the org root https://github.com/jettoptx — visitors land on the public repo list instead of a 404.

2026-05-14 — v2.0.1: Docs typography + TOC + MOA UX refresh

Changed

  • Center docs typography: page titles and section headers (h1h4) now render in Space Grotesk loaded via next/font/google (weights 300/400/500/600/700, exposed as --font-space-grotesk). Letter-spacing tightened at display sizes (-0.022em → -0.008em). Sidebar, brand wordmark, AGT badges, and small UI accents continue to use Orbitron. Body text continues to use Geist Mono. Pairing rationale: Space Grotesk was redrawn from Space Mono with proportional widths, so it carries similar geometric DNA to Geist Mono while giving a clear hierarchy contrast.
  • Heading colors: doc headers are now bright white in dark mode and near-black in light mode (previously orange). Hover state shifts to OPTX orange.
  • Headings are not links: removed the anchor wrapper, click handler, permalink chain icon, scroll-to-self behavior, and cursor: pointer from every doc heading. Headings render as plain text and respond to hover with an orange color shift as the only visual cue. MOA can still be opened from the sidebar /docs links and the Augment Space button.
  • Body links cleaned up: dropped the text-decoration: underline on .prose a:hover (no more underline-on-hover for body links) and the small globe SVG icon that MdxLink injected after every internal /docs/... reference (the icon you saw next to Token, JettChat, etc. in body content). Links still open the MOA overlay when their target maps to a node, but the affordance is now color-only (orange → lighter orange on hover).
  • TOC styling: the right-side "On this page" sidebar uses Fumadocs' default indented hierarchy. The sliding orange clip-path elbow indicator (Fumadocs' built-in animated thumb) shows the active section range, paired with a static orange dot on the active link (5px circle with a 3px soft glow), both sitting on the gray trace line. The previous AGT-dot-per-item markers are removed. Hover stays orange.

Fixed

  • MOA auto-pan on link: clicking a sidebar /docs link no longer pans the MOA camera to the target node. Selection still updates so the matching node card appears, but the camera stays where the user left it. Particularly important on mobile, where the auto-pan was disorienting.
  • MOA selected-node glow: the canvas-side radial gradient on the selected node now uses OPTX orange (rgba(255,105,0,…)) instead of yellow (rgba(234,179,8,…)). The CSS-side card highlight in the index panel was updated in the same pass.
  • Sidebar group title: content/docs/astrojoe/meta.json had a U+FFFD replacement character between "JOE" and "Jett Optics Engine". Restored the proper em-dash so the sidebar no longer shows a diamond-question-mark glyph.
  • Vercel prerender failure on /docs/astrojoe: the D2Diagram import was sitting on the line directly after the intro paragraph with no blank line, so MDX parsed it as prose instead of a top-of-file ESM import. Hoisted the import below the frontmatter so SSG succeeds.

Removed

  • Inter font load — never shipped to production. Headers transitioned to a system-font stack, then to Space Grotesk; the Inter import was removed when it became unused.
  • DocTitleMoaLink component and the MoaHeading anchor wrapper — both made headings clickable to open MOA. With the no-link decision, both are dead weight; deleted.
  • Copy for Agents button (desktop TOC footer + mobile FAB) — removed both, deleted components/copy-for-agents-btn.tsx, components/copy-for-agents.tsx, and components/mobile-copy-btn.tsx. Also dropped the per-page readFileSync of raw MDX in app/docs/[[...slug]]/page.tsx since nothing consumed it.

2026-04-30 — Dual-mode JettChat: xChat Native + Phantom Mode

Added

  • JettChat section — new top-level /docs/jettchat documenting both modes. Pages: overview, xChat Native, Phantom Mode, messaging.
  • Token section — new /docs/token mirroring astroknots.space/stake: overview, tiers, subscriptions. Canonical 3-tier model: MOJO ($8.88/mo or 12 JTX/1y), DOJO ($28.88/mo or 444 JTX/2y), SPACE COWBOY ($88.88/mo or 1,111 JTX/lifetime).
  • JETT Auth page — new /docs/authentication/jett-auth covering both auth surfaces.
  • JETT Hub access flow — Sign in with X → Hold 1 JTX or Pay $8.88 (Stripe) or Pay $8.88 (Tempo CLI).

Changed

  • What is OPTX — reframed around dual-mode JettChat (xChat Native + Phantom Mode).
  • System Architecture — adds mode comparison table; drops LayerZero/EVM from top-level diagram.
  • DOJO/MOJO pricing — fixed: DOJO is $28.88 / mo (not 6 months); top tier is SPACE COWBOY $88.88 / mo (renamed from "UNLIMITED"). Each tier shows JTX-stake and USD-subscription duality.
  • On-Chain Addresses — Solana-only; XRPL JOE wallet row removed; LayerZero/EVM line replaced with bridge cross-link.
  • On-Chain Bridge — EVM (evm-layerzero) and XRPL (xrpl-wormhole) pages retired pending re-implementation.
  • Matrix federation — reframed as optional transport for AstroJOE only; not part of JettChat dual-mode core.
  • ERC-8004 Agent Wallet — labeled Roadmap; design intent retained, no contract is deployed.
  • Hermes versioning — pinned v0.8.0 references unpinned in prose; doc-site convention is now to link to hermes-agent releases rather than embed version numbers. Local canonical Hermes version is v0.12.0 (NousResearch tag 2026.4.30, "The Curator release"). See "Hermes v0.12.0 alignment" sub-entry below.
  • JOE topology — explicitly dual-instance: edge-node primary (runs AARON + HEDGEHOG + SpacetimeDB) + containerized secondary for redundancy.
  • Docs domain — README and intra-doc references updated from optxspace.devjettoptx.dev (canonical, per JETT Hub footer).

Cross-org references

Companion PRs across the jettoptx org

The dual-mode framing landed in coordinated PRs across public repos. All update READMEs / metadata only — no code or contract changes:

RepoPRChange
joe-docs#dual-mode-jettchatThis overhaul (29 files, +518/−272)
joe-jettauth-optxPR #1README dual-mode intro + repo description rewrite
joe-aaron-routerPR #1README sentence: AARON serves both modes
joe-jtx-cstb-depinPR #3Subscription tier table rebuilt against canonical staking model; docs link → jettoptx.dev/docs

Additional private-repo PRs were shipped in the same batch but are not listed here.

Hermes v0.12.0 alignment

The OPTX deployment now tracks Hermes Agent v0.12.0 (NousResearch tag 2026.4.30) — "The Curator release." Released 2026-04-30 (1,096 commits, 550 PRs, 213 contributors since v0.11.0). Full feature breakdown in the new Hermes v0.12.0 Features page. Headline features that affect AstroJOE / JOE deployments on the agent mesh:

  • Autonomous Curator — background process grades, prunes, and consolidates the skill library without operator intervention. Aligns with the existing AstroJOE self-maintenance protocol.
  • Self-improvement loop substantially upgraded; review summaries surface in the TUI transcript and via hermes curator status (most-used + least-used skills).
  • Four new inference providers added — broader fallback options on top of HEDGEHOG's Grok routing.
  • Microsoft Teams + Yuanbao added as the 18th and 19th messaging platforms (joining the existing Matrix/X/etc. set).
  • Spotify + Google Meet native integrations.
  • ComfyUI + TouchDesigner-MCP bundled by default — these MCP servers are now first-class for AstroJOE on the agent mesh without manual installation.
  • Humanizer skill ported from earlier branches.
  • ~57% TUI cold-start reduction — perceptibly faster hermes launch on edge nodes.

Pinned version references in the docs site were unpinned in prose during this overhaul (link to hermes-agent releases instead). Where a version is required for a hard dependency claim, use v0.12.0.


2026-04-11 — Hermes v0.8.0 federation transport

Added

  • Native federation transport — AstroJOE auto-responds in the operator command room via Hermes built-in federation support
  • Self-maintenance protocol — AstroJOE now proactively updates SOUL.md, skills, and dev logs as infrastructure changes
  • Hermes harness documentation — SOUL.md includes full tool inventory, skill system, gateway config, MCP integrations
  • SOL funding scriptsscripts/fund-agents.sh and scripts/check-balances.sh for agent wallet management
  • Dev log automation — AstroJOE writes Obsidian-format session logs to OPTX-Cortex vault

Changed

  • Hermes Agent v0.7.0 → v0.8.0 (NousResearch tag v2026.4.8)
  • Matrix identity: Agent handle reassigned (AstroJOE is the primary agent)
  • HEDGEHOG MCP: Removed from Hermes mcp_servers config (REST-only, no /mcp endpoint). LLM routing continues via OPENAI_BASE_URL. Custom skills (hedgehog-websearch, hedgehog-memory) handle tool access.
  • Docker volume mount: Config files now copied from read-only host mount into writable named volume at boot, enabling runtime config changes (e.g., /sethome)
  • Edge JOE mention filter: Strict @joe: prefix matching instead of broad keyword match

Fixed

  • /sethome failing with [Errno 16] Device or resource busy — bind mount on named volume prevented atomic writes
  • Hermes dashboard showing "unknown" model — config.yaml not propagating into container
  • joe.ps1 launcher syntax errors — Unicode em-dashes replaced with ASCII

Infrastructure

  • AstroJOE: Containerized orchestration host, Hermes (current release)
  • Federation transport: Optional inter-agent communication
  • HEDGEHOG: REST gateway on edge node

Wallets

Agent wallets provisioned on Solana mainnet and devnet. Addresses are visible on-chain via the Token page.


2026-04-10 — AstroJOE Complete Build

Added

  • Metaplex Core Asset identity on mainnet (see on-chain explorer)
  • AccessPass system (JTX gate) — grant/revoke/close with tiers
  • Treasury system — initialize, fund, heartbeat, withdraw, survival modes
  • Survival monitor service — 5min PDA health checks, mode transitions, alerts
  • Welcome bot service — tiered greets, AccessPass PDA checks
  • Docker Compose stack for agent services

Changed

  • Convex schema updated with agent fields for UI sync
  • MyAgents.tsx wired to Convex reactive subscriptions (was hardcoded mock data)
  • Seeded 3 core agents: AstroJOE, Edge JOE, TraderJOE

2026-04-09 — Matrix + X API Integration

Added

  • Tunneled subdomain for self-hosted federation transport (replaced mesh network funnel)
  • X API OAuth 1.0a posting via @jettoptx account
  • Cortex bridge — federation transport listener to SpacetimeDB process_inbound_message reducer
  • Image support in cortex bridge (m.image, m.audio, m.video, m.file events)
  • Element X mobile login via .well-known discovery

Changed

  • Matrix handles assigned for agent personas (orchestration host, edge node, founder)
  • Edge JOE environment updated for new agent identity