Bridge

The bridge artifact channel between RL research and the Hyperliquid module — manifest, action space, ANN index, SQL templates.

The bridge at ./bridge/ is the single artifact channel between RL research and the HLQ product. RL writes artifacts; product reads them. No direct imports, no shared code.

Structure

bridge/
├── manifest.json              # Version, checksums, artifact metadata
├── action_space/
│   └── action_space.json      # 12 RouteActions
├── ann_index/
│   ├── hnsw_index.bin         # HNSW nearest-neighbor index
│   ├── tfidf_vectorizer.pkl   # TF-IDF vectorizer
│   ├── svd_model.pkl          # Optional SVD dimensionality reduction
│   ├── embeddings.npy         # Pre-computed embeddings (1806 x 192)
│   ├── meta_rows.pkl          # Address/intent/coin metadata per item
│   └── address_set.pkl        # Fast address lookup set
├── sql_templates/
│   ├── copy_lag_pairwise_corr_daily.sql
│   ├── similarity_profile_scoring_daily.sql
│   ├── risk_regime_stress_scoring_daily.sql
│   ├── anomaly_zscore_detection_daily.sql
│   ├── whale_ranking_by_position_daily.sql
│   ├── composite_trader_screening_daily.sql
│   └── counterfactual_stop_policy_bucket_proxy.sql
├── bq_config/
│   └── config.json            # BigQuery project, dataset, dates, auth
├── intent_priors/
│   ├── intent_template_map.json   # Intent → [template names]
│   └── coin_allowlist.json        # Supported coins
└── model_weights/
    └── base_model_manifest.json   # Model manifest (HF fallback)

Manifest

manifest.json contains:

bridge_version — Timestamp-based version ID (e.g., 20260223T015855Z_hlq_reqs_v2)
bridge_format_version — Schema version (1.0.0)
created_at_utc — When the bridge was built
artifacts — Per-artifact metadata (counts, dimensions) and SHA256 checksums
compatibility — Minimum product version

Action space

12 RouteAction entries mapping intent families to execution parameters:

Action ID	Intent	Leverage Delta	Lag Override
`similarity_default`	similarity	0.0	—
`risk_regime_default`	risk_regime	0.0	—
`copy_lag_d1`	copy_lag	0.0	1
`anomaly_default`	anomaly	0.0	—
`anomaly_strict`	anomaly	0.75	—
`whale_ranking_default`	whale_ranking	0.0	—
`screening_default`	screening	0.0	—
`strategy_comparison_default`	strategy_comparison	0.0	—
`copy_lag_d3`	copy_lag	0.0	3
`risk_regime_strict`	risk_regime	0.75	—
`counterfactual_default`	counterfactual	0.0	—
`counterfactual_strict`	counterfactual	0.75	—

ANN index

HNSW nearest-neighbor index for semantic retrieval:

1,806 items, embedding dimension 192
TF-IDF vectorizer + optional SVD for query embedding
Coin-strict filtering (no cross-coin spillover)
has_address() for validation checks

Health check

hlq bridge status

Checks: artifact counts, checksum integrity, bridge freshness (warns if >30 days old). Returns healthy, warning, or degraded verdict with human-readable narrative.

Versioning

Bridge versions are managed by the RL team. The product consumes whatever is in ./bridge/. Request new artifacts via RL_REQUESTS.md.

Current request channel status:

Request	Status	Delivered
REQ-001	Fulfilled	whale_ranking template
REQ-002	Fulfilled	composite_screening template
REQ-003	Fulfilled	anomaly_zscore template
REQ-004	Fulfilled	Coin-strict ANN filtering
REQ-005	Fulfilled	ANN rebuilt with new intents (529→1806)
REQ-006	Pending	Query quality eval ownership transfer to RL team. RL owns intent routing improvement, per-template parameter metadata, and multi-intent decomposition. HLQ retains integration testing (6 tasks: i001-i006). Current classifier marked `regex_v1` (transitional).