GameCult/Stonks
Watch
9
0
Fork
You've already forked Stonks
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
10 commits 3 branches 0 tags 62 KiB
  • JavaScript 95.5%
  • PowerShell 4.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Meta Vens 981c484d6f Remove pendingCultCacheWrites false-durability bookkeeping 
REC-118: `pendingCultCacheWrites` had no reader, drain, shutdown path,
or metric anywhere in the file — it tracked in-flight CultCache write
promises but nothing ever awaited, sized, or reported on the set,
including no SIGTERM/SIGINT handler. It gave the appearance of
durability tracking while doing nothing but insert-then-delete on
every write. Removed the Set and the add/delete bookkeeping in
`trackCultCacheWrite`; the actual write operation and its
label/error-logging on failure are untouched.

This repo's actual mainline is `codex/stonks-market-daemon`
(confirmed via `git ls-remote --symref origin HEAD`, not the
`branch-graveyard.md`-era "no mainline" read), so this is an ordinary
cut on the repo's real default branch, not a stray-branch edit.

Kill attempts that failed: none.
- `rg -n "pendingCultCacheWrites" .` -> the same three lines the
  census found (declaration, delete, add), now all removed.

Checks run: `npm run check` (== `node --check src/stonks-daemon.cjs`)
-> syntax OK.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-13 14:20:26 +02:00
docs Publish Stonks provider boundary records 2026-06-16 12:04:26 +01:00
scripts Publish Stonks startup respect to Odin 2026-06-23 22:58:13 +01:00
src Remove pendingCultCacheWrites false-durability bookkeeping 2026-09-13 14:20:26 +02:00
.gitignore Use Finnhub with intelligent Stonks sampling 2026-06-04 17:54:08 +01:00
AGENTS.md Update Stonks agent terminology 2026-06-23 22:58:13 +01:00
package-lock.json Publish Stonks startup respect to Odin 2026-06-23 22:58:13 +01:00
package.json Publish Stonks startup respect to Odin 2026-06-23 22:58:13 +01:00
README.md Publish Stonks provider boundary records 2026-06-16 12:04:26 +01:00

README.md

Stonks

Stonks publishes market-data pulse into the GameCult CultMesh Verse.

It polls public equity/ETF and crypto endpoints, normalizes the result into CultCache state, and exposes a provider-owned Eve/CultUI surface for Odin and renderers such as Nightwing.

Current Body

  • Provider id: stonks.market
  • Eve deck: ws://127.0.0.1:8802/eve/deck
  • Provider manifest: http://127.0.0.1:8802/eve/deck/providers
  • Health: http://127.0.0.1:8802/health
  • Idunn daemon health: idunn.daemon_health over cultnet.transport.rudp.v0, defaulting to 127.0.0.1:17870 with daemon id stonks and contract stonks.cultnet-rudp-market-health.
  • Snapshot: http://127.0.0.1:8802/market/state
  • CultCache state: scratch/stonks/stonks-state.cc
  • Provider records: the same CultCache store now contains gamecult.eve.provider_advertisement.v1, stonks.command_boundary.v1, and stonks.transport_profile.v1 beside the market snapshot and Eve surface.
  • Request events: persisted as keyed stonks.request_event.v1 CultCache documents and summarized in the Eve dashboard. Raw request ledgers are not shown as dashboard truth.
  • Default focus: gaming and tech public names such as Ubisoft, EA, Take-Two, Roblox, Nintendo, Sony, Microsoft, NVIDIA, AMD, Google, Meta, Apple, TSMC, Tesla, ASML, Corsair, Logitech, and Sea.
  • Private watch names: Musk Complex is represented explicitly as mixed public/private exposure: TSLA is tracked through the public TSLA.US quote, while SpaceX, xAI/X, Neuralink, and Boring need provider-owned news, disclosure, or secondary-market feeds before Stonks treats their movement as data.

Start

.\scripts\start-stonks.ps1

Data Sources

  • Equities/ETFs: Finnhub quote endpoint. Set FINNHUB_API_KEY or STONKS_FINNHUB_TOKEN; the daemon defaults to 48 quote calls/minute so it stays below the free-plan 60 calls/minute ceiling.
  • Crypto: CoinGecko simple price endpoint.
  • Mention radar: Hacker News Algolia search, IGN RSS, and Eurogamer RSS. These feeds steer which configured symbols Finnhub samples first; they do not own market state.

The daemon is for operator visibility and ambient market context. It is not financial advice and does not place trades.

Configure defaults with:

$env:FINNHUB_API_KEY="..."
$env:STONKS_EQUITY_CALLS_PER_MINUTE="48"
$env:STONKS_MENTION_REFRESH_MS="600000"
$env:STONKS_EQUITIES="ubi.fr,ea.us,ttwo.us,rblx.us,ntdoy.us,nvda.us,amd.us,tsla.us"
$env:STONKS_CRYPTO="bitcoin,ethereum,solana,dogecoin"
$env:STONKS_PRIVATE_WATCH="Musk Complex"

You can also put the Finnhub token in finnhub-oauth.txt at the repo root or pass --finnhubTokenFile/STONKS_FINNHUB_TOKEN_FILE.

At the default 15 second poll interval and 48 calls/minute budget, Stonks pulls up to 12 Finnhub equity quotes per refresh. It prioritizes recently mentioned watch symbols, uncached symbols, and then a round-robin pass across the configured watchlist.

Idunn health publishing is enabled by the launcher with:

--idunn-rudp-health 127.0.0.1:17870
--idunn-daemon stonks
--idunn-health-contract stonks.cultnet-rudp-market-health

The /health, /market/state, and /eve/deck endpoints remain compatibility/status or renderer projections. They are not the owners of Stonks daemon liveness or provider truth once Idunn has fresh RUDP health and Odin can read the typed provider records from scratch/stonks/stonks-state.cc.