add

Author: baum777

.cursor/settings.json

@@ -0,0 +1,7 @@
+{
+  "plugins": {
+    "render": {
+      "enabled": true
+    }
+  }
+}

.dockerignore

@@ -0,0 +1,11 @@
+node_modules
+dist
+_tmp
+.git
+.env
+.env.*
+!.env.example
+*.log
+coverage
+.nyc_output
+legacy

.env.example

@@ -0,0 +1,244 @@
+# =============================================================================
+# X / TWITTER API (Required for polling and posting)
+# =============================================================================
+# Required: OAuth 2.0 user refresh flow
+X_CLIENT_ID=your_x_client_id_here
+X_CLIENT_SECRET=your_x_client_secret_here
+X_REFRESH_TOKEN=your_x_refresh_token_here
+# Optional bootstrap token (runtime refresh preferred)
+X_ACCESS_TOKEN=
+X_EXPIRES_IN=7200
+X_TOKEN_CREATED_AT=
+X_REFRESH_BUFFER_SECONDS=300
+X_OAUTH_TOKEN_URL=https://api.x.com/2/oauth2/token
+X_BOT_USER_ID=
+
+# =============================================================================
+# XAI API (LLM Provider)
+# =============================================================================
+XAI_API_KEY=xai-your_api_key_here
+XAI_BASE_URL=https://api.x.ai/v1
+XAI_MODEL_PRIMARY=grok-3
+XAI_MODEL_FALLBACKS=grok-3-mini
+
+# =============================================================================
+# ALTERNATIVE LLM PROVIDERS (Optional)
+# =============================================================================
+OPENAI_API_KEY=sk-your_openai_key_here
+LLM_API_KEY=your_llm_api_key_here
+LLM_PROVIDER=xai
+OPENAI_MODEL=gpt-4o-mini
+OPENAI_BASE_URL=https://api.openai.com/v1
+LLM_TEMPERATURE=0.92
+LLM_MAX_TOKENS=280
+LLM_SYSTEM_PROMPT=
+LLM_CANNED_FALLBACK=Sorry, gerade offline – später mehr Fire! 🔥
+
+# =============================================================================
+# REPLICATE IMAGE GENERATION (Optional)
+# =============================================================================
+REPLICATE_API_KEY=r8_your_replicate_key_here
+REPLICATE_IMAGE_MODEL=black-forest-labs/flux-schnell
+REPLICATE_RUN_TIMEOUT_MS=45000
+REPLICATE_DOWNLOAD_TIMEOUT_MS=20000
+
+# =============================================================================
+# BOT ACTIVATION & WHITELIST (Test Phase Configuration)
+# =============================================================================
+
+# Activation mode: "global" (respond to all) | "whitelist" (only whitelisted users)
+BOT_ACTIVATION_MODE=whitelist
+
+# Comma-separated list of usernames (with or without @)
+# Example: BOT_WHITELIST_USERNAMES=alice,bob,charlie
+BOT_WHITELIST_USERNAMES=
+
+# Comma-separated list of user IDs (numeric)
+# Example: BOT_WHITELIST_USER_IDS=123456789,987654321
+BOT_WHITELIST_USER_IDS=
+
+# How to handle non-whitelisted mentions: "silent" (ignore) | "tease" (reply with teaser)
+BOT_DENY_REPLY_MODE=silent
+
+# Bot's own username/handle (without @)
+BOT_USERNAME=Gnomes_onchain
+
+# =============================================================================
+# LAUNCH MODE (Central control for rollout stages)
+# =============================================================================
+
+# Launch mode: "off" | "dry_run" | "staging" | "prod"
+# - off: Bot is disabled
+# - dry_run: Process mentions but don't post (simulation)
+# - staging: Real posting, but only for ALLOWLIST_HANDLES
+# - prod: Full production mode
+LAUNCH_MODE=staging
+
+# Legacy dry-run flag (mapped to LAUNCH_MODE if LAUNCH_MODE not set)
+DRY_RUN=false
+
+# Comma-separated handles allowed in staging mode
+# Example: ALLOWLIST_HANDLES=alice,bob
+ALLOWLIST_HANDLES=
+
+# =============================================================================
+# CONTEXT ENGINE
+# =============================================================================
+USE_ENHANCED_CONTEXT=true
+CONTEXT_ENGINE_MODE=hybrid
+CONTEXT_MAX_THREAD_DEPTH=3
+
+# =============================================================================
+# SEMANTIC INTELLIGENCE (Phase 3)
+# =============================================================================
+SEMANTIC_ENABLED=true
+SEMANTIC_MODE=shadow
+SEMANTIC_TOPK=20
+SEMANTIC_CLUSTER_SIM=0.82
+SEMANTIC_QUERY_MAX_RESULTS=50
+SEMANTIC_MEMORY_TTL_DAYS=14
+SEMANTIC_INDEX_TTL_DAYS=7
+SEMANTIC_INDEX_MAX_DOCS=2000
+
+# =============================================================================
+# POLLING CONFIGURATION
+# =============================================================================
+POLL_INTERVAL_MS=30000
+ADAPTIVE_POLLING_ENABLED=true
+MENTIONS_SOURCE=mentions
+
+# =============================================================================
+# UPLOAD CONFIGURATION
+# =============================================================================
+X_UPLOAD_TIMEOUT_MS=30000
+X_UPLOAD_MAX_DIM=1024
+
+# =============================================================================
+# RATE LIMITING & BUDGET GATES
+# =============================================================================
+MAX_LLM_CALLS_PER_MINUTE=30
+COST_WEIGHT_THREAD=2
+COST_WEIGHT_REPLY=1
+
+# =============================================================================
+# FETCH & RETRY CONFIGURATION
+# =============================================================================
+FETCH_TIMEOUT_MS=30000
+FETCH_BACKOFF_BASE_MS=5000
+FETCH_BACKOFF_MAX_MS=300000
+FETCH_RETRY_JITTER_MS=500
+RATE_LIMIT_COOLDOWN_MS=60000
+MIN_POLL_INTERVAL_MS=5000
+MAX_POLL_INTERVAL_MS=300000
+
+# =============================================================================
+# PUBLISH RETRY CONFIGURATION
+# =============================================================================
+PUBLISH_RETRY_DELAYS_MS=1000,5000,15000
+MAX_PUBLISH_RETRIES=3
+
+# =============================================================================
+# STATE STORAGE (Redis vs SQLite)
+# =============================================================================
+
+# Set to "true" to use Redis instead of local SQLite
+USE_REDIS=true
+
+# Redis connection URL - must use redis:// or rediss:// protocol (NOT https://)
+# Get this from Upstash Console: Connect > Node.js > ioredis
+# Upstash production commonly requires TLS, so rediss:// is preferred there.
+# Example: rediss://default:PASSWORD@HOST.upstash.io:6379
+KV_URL=rediss://default:********@sharp-wildcat-47616.upstash.io:6379
+
+# Key prefix for Redis keys (prevents collisions if multiple bots share Redis)
+REDIS_KEY_PREFIX=GNOMES_ONCHAIN:
+
+# TTL Configuration
+EVENT_STATE_TTL_DAYS=7
+PUBLISHED_TTL_DAYS=30
+PUBLISH_LOCK_TTL_MS=30000
+
+# Cursor Persistence
+CURSOR_PERSISTENCE_ENABLED=true
+CURSOR_SYNC_INTERVAL_MS=60000
+
+# =============================================================================
+# ON-CHAIN / IDENTITY (Optional)
+# =============================================================================
+BOT_TOKEN_MINT=So11111111111111111111111111111111111111112
+BOT_TREASURY_WALLET=
+BOT_TICKER=Gnomes
+BOT_PROGRAM_ID=
+
+# =============================================================================
+# LLM CIRCUIT BREAKER
+# =============================================================================
+LLM_TIMEOUT_MS=30000
+
+# =============================================================================
+# PROMPT & MODE OVERRIDES (CLI / Test)
+# =============================================================================
+# FULL_SPECTRUM_PROMPT=true  # Use StructuredRoast + self-critique + refine loop
+# AGGRESSIVE_MODE=horny      # analyst | horny
+# TEST_MODE=true            # Bypass relevance checks
+
+# =============================================================================
+# LOGGING & DEBUGGING
+# =============================================================================
+LOG_LEVEL=INFO
+DEBUG_ARTIFACTS=false
+
+# Skip environment validation at boot (use with caution)
+SKIP_ENV_VALIDATION=false
+
+# =============================================================================
+# SERVER CONFIGURATION
+# =============================================================================
+PORT=10000
+
+# =============================================================================
+# ON-CHAIN / SOLANA RPC (Optional - for on-chain verification)
+# =============================================================================
+SOLANA_RPC_PRIMARY_URL=https://api.mainnet-beta.solana.com
+SOLANA_RPC_FALLBACK_URL=https://solana-api.projectserum.com
+
+# =============================================================================
+# DATA DIRECTORY (for filesystem store)
+# =============================================================================
+DATA_DIR=./data
+
+# =============================================================================
+# GNOMES MULTI-PERSONA (Phase 1+)
+# =============================================================================
+# Enable multi-gnome routing and prompt composition (default: false)
+GNOMES_ENABLED=false
+
+# Safe fallback gnome when routing uncertain (default: stillhalter)
+DEFAULT_SAFE_GNOME=stillhalter
+
+# Enable user-gnome affinity and interaction writeback (default: false)
+GNOME_MEMORY_ENABLED=false
+
+# Enable routing debug logs
+GNOME_ROUTING_DEBUG=false
+
+# Preserve gnome continuity within threads (default: true)
+GNOME_CONTINUITY_ENABLED=true
+
+# Phase-4: Ensemble orchestration, narrative arcs, autonomy
+GNOME_ENSEMBLE_ENABLED=false
+GNOME_AUTONOMY_ENABLED=false
+GNOME_ARC_ENGINE_ENABLED=false
+GNOME_MAX_CAMEOS=2
+
+# Phase-3: Trait evolution (default: false)
+GNOME_EVOLUTION_ENABLED=false
+
+# Phase-3: Running jokes (default: false)
+GNOME_RUNNING_JOKES_ENABLED=false
+
+# Phase-3: Swarm/cameo replies (default: false)
+GNOME_SWARM_ENABLED=false
+
+# Phase-3: Max trait drift per 100 interactions (default: 0.25)
+GNOME_TRAIT_DRIFT_LIMIT=0.25

.env.oauth2.example

@@ -0,0 +1,23 @@
+# X OAuth2 confidential client settings
+X_CLIENT_ID=your_client_id
+X_CLIENT_SECRET=your_client_secret
+X_REDIRECT_URI=http://127.0.0.1:8080/callback
+
+# IMPORTANT: offline.access is required to receive refresh_token values.
+X_OAUTH_SCOPES=tweet.read tweet.write users.read offline.access
+
+# Runtime uses refresh grant with an existing valid refresh token.
+# If X_REFRESH_TOKEN becomes invalid/revoked, run scripts/Generate-XOAuthTokens.ps1
+# to perform a full OAuth2 PKCE re-authorization and mint a fresh refresh token.
+X_ACCESS_TOKEN=replace_after_oauth
+X_REFRESH_TOKEN=replace_after_oauth
+X_TOKEN_TYPE=bearer
+X_EXPIRES_IN=7200
+X_TOKEN_CREATED_AT=2026-03-17T22:00:00+01:00
+X_REFRESH_BUFFER_SECONDS=300
+
+# Optional override (defaults to https://api.x.com/2/oauth2/token)
+X_OAUTH_TOKEN_URL=https://api.x.com/2/oauth2/token
+
+X_BOT_USERNAME=Gnomes_onchain
+X_BOT_USER_ID=1234567890

.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "pnpm"
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Typecheck
+        run: pnpm run typecheck
+
+      - name: Lint
+        run: pnpm run lint
+
+      - name: Test
+        run: pnpm run test
+
+      - name: Build
+        run: pnpm run build