Platform · Live · new here
Ask-your-data — generalizable NL→rank→tier→cite spoke (HO-378)
NL question → deterministic lexical intent parse (LLM parsers are consumer-injected, never request-time here) → retrieve over the consumer's store → the canonical 4-layer rankIndex (consumed from src/lib/insight-player, NOT duplicated — the module Performix vendors FROM) → the honesty-tier invariant (measured=point from own data / inferred=RANGE never a point, construction-time TierHonestyViolation guard / gap=EVSI work-plan → intake) → synthesis with per-claim citations (uncited claims dropped, count reported). Configurable per data workflow via SIX injected ports: RetrievalPort, SignalsMapper (the one typed seam), IntentParser, SuppressionPolicy, CitationSource, IntakeSink (+ priors/workPlan extension points). Tier + glue modules vendored from performix @ 10fa0d3/bc09260 with every behavior delta recorded in the README (none silent); bit-parity at default tunables ASSERTED in tests. Empty retrieval = honest gap-tier with retrieval_ran recorded — never 'no answer exists'. First consumer: Performix re-points src/lib/ask/* by supplying its CAMS adapter set (HO-378 reply handoff).
- Cluster
- Platform
- Type
- spoke
- Status
- Live
- Used by
- people-analytics-toolbox, performix
Maturity evidence
- Functioning
- check-spokes ask-your-data GREEN (0 required gaps); 18/18 tests (rank-parity 7 incl. bit-parity at canonical defaults + gate reason strings, tier-invariant 4 incl. construction-time guard, answer e2e 7 incl. empty-retrieval honesty); migration 0183 (schema + heartbeat) with journal chain intact; MCP answer/rank/health registered + discovery-wired.
- Valuable
- Value lands when Performix re-points src/lib/ask/* through the CAMS adapter set (performix-side migration, reply handoff filed) or a second workflow injects its ports.
- Understood
- Six-port table + vendored-SHA provenance + all four behavior deltas recorded in the spoke README; the tier invariant is types + a runtime guard, not prose.
- Integrated
- Registry live entry, health aggregate, MCP gateway + discovery, drizzle wiring — all check-spokes-enforced; consumes the canonical rankIndex rather than forking it.
How to use it
- REST
- /api/spokes/ask-your-data/answer
- MCP
- ask-your-data.answer
- Data
- src/spokes/ask-your-data/
Other Platform capabilities
- Comp audit self-serve — CSV intake, free validate, commerce-gated watermarked run (HO-155)
- Gift pass — gifted ownership on the entitlement store (magic-link claim)
- JobFrame canonical Job Family × Focus × Level taxonomy + classifier
- SMB pay-system wizard — chocolate/vanilla over the pay-system catalog
- Support channel — portfolio-wide /support form → ticket store → operator email
- Diagnostic acquisition — next-best-ask over a live hypothesis set
- Executive-Priorities Elicitation Instruments (static catalog)
- Forecast-strength — the forecast-calibration loop (crown jewel)
Capability detail sourced from the People Analytics Toolbox capability feed (source of truth), snapshot retrieved 2026-07-23.