mirror of https://github.com/ruvnet/ruflo.git synced 2026-09-14 14:01:28 +08:00

Files

T

Reuven 75d57c4ec0 fix(ruflo-market-data): v0.2.0 — fix 3 functional bugs (embeddings_embed + namespace-routing) + adopt plugin contract (ADR-0001)

Three real bugs found in the market-data skills + agent:

1. market-ingest skill referenced mcp__claude-flow__embeddings_embed —
   that tool name does not exist. Real name: embeddings_generate (same
   bug class as ruflo-knowledge-graph ADR-0001).
2. market-ingest skill called agentdb_hierarchical-store with namespace
   arg "market-data" — agentdb_hierarchical-* routes by tier, ignores
   namespace string (per ruflo-agentdb ADR-0001).
3. market-pattern skill had the same hierarchical-recall bug PLUS the
   same agentdb_pattern-store + namespace bug as ruflo-cost-tracker
   ADR-0001 (ReasoningBank ignores namespace).
4. data-engineer agent also referenced embeddings_embed.

All 4 fixed: switch namespaced reads/writes to memory_* (the
namespace-routed family), rename embeddings_embed → embeddings_generate,
and document the dual pattern-store path (typed via ReasoningBank vs
namespace-routable via memory_store).

Contract additions:
- ADR-0001 (Proposed) at docs/adrs/0001-market-data-contract.md
- README adds Compatibility (pin v3.6), Namespace coordination (claims
  market-data + market-patterns; routing-note callout; defers to
  ruflo-agentdb ADR-0001), Verification + Architecture Decisions
- plugin.json bumps 0.1.0 → 0.2.0; keywords add mcp,
  candlestick-patterns, namespace-routing
- scripts/smoke.sh — 11 structural checks: version + keywords, both
  skills + agent + command present, embeddings_embed regression check
  (excludes ADR + README call-outs), skills use memory_* not
  hierarchical-* with namespace, dual pattern-store path doc'd,
  embeddings_generate referenced, v3.6 pin, namespace coordination,
  market-data + market-patterns claimed, ADR Proposed

Verification: bash plugins/ruflo-market-data/scripts/smoke.sh → 11/11

Co-Authored-By: RuFlo <ruv@ruv.net>

2026-05-04 20:18:45 -04:00

3.9 KiB

Raw Permalink Blame History

ruflo-market-data

Market data ingestion -- feed normalization, OHLCV vectorization, and HNSW-indexed pattern matching.

Overview

Ingests market data from REST APIs and WebSocket feeds, normalizes to OHLCV vectors with consistent scaling, and vectorizes candlestick patterns for HNSW similarity search. Detects single-candle (doji, hammer) and multi-candle (engulfing, morning star, head & shoulders) formations with reliability scoring.

Installation

claude --plugin-dir plugins/ruflo-market-data

Agents

Agent	Model	Role
`data-engineer`	sonnet	Ingest market feeds, normalize OHLCV, vectorize candlestick patterns, HNSW-indexed pattern matching

Skills

Skill	Usage	Description
`market-ingest`	`/market-ingest <symbol> [--source api]`	Ingest and normalize market data into OHLCV vectors with HNSW indexing
`market-pattern`	`/market-pattern <symbol> [--period 1D]`	Detect and classify candlestick patterns from ingested data

Commands (5 subcommands)

market ingest <symbol> [--period 1D]    # Ingest and normalize OHLCV data
market patterns <symbol>                 # Detect candlestick patterns
market search <pattern-name>             # Search historical pattern occurrences
market history <symbol>                  # Show ingestion history and data coverage
market compare <sym1> <sym2>             # Compare pattern profiles between symbols

OHLCV Normalization

Field	Normalization
Open	Relative to previous close: `(open - prev_close) / prev_close`
High	Relative to open: `(high - open) / open`
Low	Relative to open: `(low - open) / open`
Close	Relative to open: `(close - open) / open`
Volume	Z-score: `(vol - mean_vol) / std_vol`

Pattern Library

Pattern	Type	Candles	Reliability
Doji	Reversal	1	Medium
Hammer	Reversal	1	Medium-High
Engulfing	Reversal	2	High
Morning/Evening Star	Reversal	3	High
Three White Soldiers	Continuation	3	High
Head & Shoulders	Reversal	5-7	Very High
Double Top/Bottom	Reversal	Variable	High

Each pattern is encoded as a 64-dimension padded vector for HNSW indexing.

Compatibility

CLI: pinned to @claude-flow/cli v3.6 major+minor.
Verification: bash plugins/ruflo-market-data/scripts/smoke.sh is the contract.

Namespace coordination

This plugin owns two AgentDB namespaces (kebab-case, follows the convention from ruflo-agentdb ADR-0001 §"Namespace convention"):

market-data — normalized OHLCV vectors per symbol+date
market-patterns — detected candlestick patterns with reliability scores

Both accessed via memory_* (namespace-routed). Reserved namespaces (pattern, claude-memories, default) MUST NOT be shadowed.

Routing note: Earlier versions of these skills used agentdb_hierarchical-* and agentdb_pattern-* with namespace arguments — those tool families route by tier/ReasoningBank and ignore namespace strings. ADR-0001 fixed the skills to use memory_* for namespaced reads/writes.

Verification

bash plugins/ruflo-market-data/scripts/smoke.sh
# Expected: "11 passed, 0 failed"

Architecture Decisions

ADR-0001 — ruflo-market-data plugin contract (3 functional bug fixes + namespace coordination + smoke as contract)

ruflo-agentdb — namespace convention owner; defines the routing rules ADR-0001 fixes violations of
ruflo-neural-trader -- Consumes market patterns as strategy signals
ruflo-ruvector -- HNSW indexing engine for pattern similarity search
ruflo-observability -- Data feed health and ingestion latency dashboards

License

MIT

3.9 KiB Raw Permalink Blame History