docs-turing Coverage Matrix
Purpose. Every shipped block / feature cluster in the Turing
CHANGELOG.mdmaps here to either a documentation page (with anchor) or an explicit "deliberately internal — no public page" row. A shipped user-facing subsystem with no page is an orphan (🔴) and a bug in the docs. This file is the gate authored by Block AE T538; keep it in sync when a new block ships.Legend: ✅ documented · 🧩 folded into a broader page · 🔒 deliberately internal (engineering / repo / marketing — no end-user page by design) · 🔴 orphan (missing — fix it).
Not rendered in the sidebar; this is a maintenance artifact.
Search it
| Block / feature | Page | Status |
|---|---|---|
| Search engine (Solr / ES / Lucene), cores | search-engine | ✅ |
| Semantic Navigation sites, facets, spotlights, targeting | semantic-navigation | ✅ |
| Block R — field manifest, schema-as-code, derivation, hybrid ranking, field coverage | manifest | ✅ |
| DSL Query API + compatibility matrix | dsl-query · dsl-compatibility | ✅ |
| SPA / search-template pages | spa-pages | ✅ |
| Connectors (AEM, web crawler) | integration · integration-aem | ✅ |
| Import / export | import-export | ✅ |
| Migrating from Algolia / Elasticsearch (guide) | migration | ✅ |
Block AO — migration tooling: ES/Algolia importers + turing migrate CLI + field-mapping overrides + shadow-comparison (parity check) | migration § fast path · cli | 🧩 |
| Block AP — native synonyms (5 types, query-time on Solr/ES/Lucene, no reindex) + admin UI + Import from Algolia + AI-assisted mining | synonyms | ✅ |
Block AQ — Thesaurus: hierarchical controlled-vocabulary microthesauri + index-time expansion (microthesaurus_terms) + concept/hierarchical facets + per-site opt-in + seed library + XML import + AI generation + related-term suggestions | thesaurus | ✅ |
Ask it
| Block / feature | Page | Status |
|---|---|---|
| RAG pipeline | rag | ✅ |
| Block M — verifiable answers, native citations, citation-drift | rag § Provenance & citations | 🧩 |
| Block AD RAG bridges — managed backends, lanes, fallback, guardrail, second-opinion | rag § Advanced RAG | 🧩 |
| Block N + T521 — pluggable & managed rerankers | reranking | ✅ |
| Block AD embeddings — Voyage/Cohere/Mistral, multimodal, contextual, Matryoshka, OCR | embedding-models · embedding-stores | ✅ |
| Chat interface | chat | ✅ |
| E.6 / F.8 — chat memory, compaction, context editing | chat-memory | ✅ |
| Intents / conversation starters | intent | ✅ |
| Block AA — speaker + audience personas, content-fit, persona-from-audio, persona-suggest | personas § Audience Personas & Content-Fit, § Suggest the best-fit persona | ✅ |
| Block AS — pluggable/chunk-capable transcription: config-selectable backends (OpenAI / self-hosted OpenAI-compatible / none), ffmpeg chunking, async jobs, AUDIO-slot transcription, per-backend metrics, confidence fallback | transcription | ✅ |
| Block AI / AG — persona as an actionable surface (persona chat, bento dashboard + launchpad, content-fit launch action, persona dialogue, suggest persona; T619 re-added from-audio + suggest to bento) | personas § Act on a Persona | ✅ |
| Block AT (T696–T703) — Persona Match: N×N persona↔content fit projects (project-scoped contents × personas → live fit heatmap + by-content/by-persona reports + PDF, scheduled re-analysis, validate-route folded into a single-persona project) | personas § Persona Match | 🧩 |
| Block AU (T705–T706) — Persona Dialogue projects: saved multi-project dialogues (topic + ordered speaker roster + live-streamed & persisted transcript), reusing the round-robin engine | personas § Personas in conversation | 🧩 |
Block AW (T717–T734) — Synthetic User Research: OCEAN persona facet + knowledge grounding, study aggregate (dynamic/scripted/concept-test protocols) + N-persona SSE interview runner, insights report (themes + verbatim quotes + saturation + theme graph + drift), interview-your-own-agent, per-stage model lanes, concept-fit + eval-dataset bridges, continuous-insight scheduling, audience cohort synthesis, Research Assistant, multi-study program rollup (PRISMA), turing research CLI | personas § Synthetic User Research · cli § turing research | 🧩 |
Block AY (T739) — Content ingestion: pluggable URL fetch mode (Simple / Auto / Headless) with a browserless headless-browser fallback so JS-rendered SPA pages extract text; Global Settings section + browserless compose service | personas § Content ingestion | 🧩 |
Automate it
| Block / feature | Page | Status |
|---|---|---|
| AI Agents | ai-agents | ✅ |
| Block AK — Live Preview prompt diagnostics (flow-aware persona, token/cost metrics, inert-this-turn, cross-segment lint, node picker, replay a real conversation, verbatim capture of any past turn) | ai-agents § Live Preview & prompt diagnostics | 🧩 |
| Tool calling (native + provider-native) | tool-calling | ✅ |
| Block F.15 — capability registry + two-level gate | capabilities | ✅ |
| Block W (AG-UI) — live tool activity, client tools, generative UI | client-tools | ✅ |
| Block X — answer-as-app, co-browse, glass-box, proactive, handoff, skill UIs, action widget | showcase (opt-in features, demoed) | 🧩 |
| Custom (Groovy) tools | custom-tools | ✅ |
| Block I — MCP client + server | mcp-servers | ✅ |
| E.3 — skills (Anthropic folders, sandbox) | skills | ✅ |
| E.2 — agent workspace | agent-workspace | ✅ |
| D.3 — slots, chat-flow | chat-flow | ✅ |
| E.4 — human-in-the-loop | human-in-the-loop | ✅ |
| Webhooks | webhooks | ✅ |
| Routines (scheduled agents) | routines | ✅ |
| D.4 — A/B experiments | experiments | ✅ |
| Block K — agent eval / golden sets | agent-eval | ✅ |
Block AJ — eval platform: pluggable graders (code/model/human) + datasets + grader stacks + versioning + Eval Studio + calibration/inter-annotator agreement + public eval API/CLI/SDK CI gate (POST /api/eval/run, turing eval --dataset, runEval) | agent-eval, cli | 🧩 |
Run it
| Block / feature | Page | Status |
|---|---|---|
| Installation | installation-guide | ✅ |
Configuration (application.yaml) | configuration-reference | ✅ |
| Block F / F.16 — GenAI overview + Gemini native primitives | genai-llm | ✅ |
| Block AD — 11 vendor types, per-vendor auth | llm-instances | ✅ |
T620 — startup LLM auto-provisioning from OPENAI_API_KEY | llm-instances | 🧩 |
| T622 — local ONNX embeddings + zero-config local RAG at startup; global Default AI Agent fallback for agentless SN sites | embedding-models § Zero-config local RAG · ai-agents § Default AI Agent | 🧩 |
| Block AM (T623–T629) — HuggingFace embedding provider + provider-aware model picker (LLM-embedding / HuggingFace / manual local) + on-select dimension/reindex warning + ONNX variant/quantization picker + HF-repo-id startup seeding | embedding-models § HuggingFace.co · embedding-models § Provider · embedding-models § Zero-config local RAG | 🧩 |
| Knowledge Base / Assets, pluggable storage | assets | ✅ |
| Block J — multi-tenancy | multi-tenancy | ✅ |
| Administration (users, roles, tokens, settings) | administration-guide | ✅ |
| Observability, logging | observability · logging | ✅ |
| D.6 — chat analytics (sentiment, tool latency, SSE) | chat-analytics | ✅ |
| Block L — token usage + cost governance | token-usage · cost-governance | ✅ |
Developers
| Block / feature | Page | Status |
|---|---|---|
| Dev environment, contributing | developer-guide | ✅ |
| Block S — React SDK (hooks + headless UI) | react-sdk | ✅ |
Block S — vanilla @viglet/turing-sdk (zero-dep, EDS) | javascript-sdk | ✅ (T539) |
E.7 — @viglet/turing-cli (turing command) | cli | ✅ (T539, was 🧩 folded into developer-guide) |
@viglet/turing-flow-dsl — flows-as-typed-TS | flow-dsl | ✅ (T539) |
| Block Y — Atlas Store reference showcase | showcase | ✅ |
| Block Z — client-side conversion analytics / GA4 bridge | conversion-analytics | ✅ |
| REST API + GraphQL | rest-api · graphql | ✅ |
Security
| Block / feature | Page | Status |
|---|---|---|
| API key + session auth | security-authentication | ✅ |
| Social login | security-social-login | ✅ |
| Keycloak OAuth2 / OIDC SSO | security-keycloak | ✅ |
Block AN — post-audit security hardening: prod-required crypto key, permissions=true default (authn ≠ admin), chat-analytics auth, dev-token header-only + expiry/revocation, anonymous-chat abuse controls (turing.abuse.*), RAG untrusted-content framing + tool trust boundary, SSRF egress guard, storage traversal/Zip-Slip caps, actuator restriction, MCP client guards (turing.mcp-client.*), MinIO-creds/H2 hardening, frontend XSS sanitisers, dependency-audit CI gate | security-hardening · configuration-reference § Abuse Controls | ✅ |
Deliberately internal — no public page (not orphans)
These shipped blocks are engineering, repository, or marketing concerns with no end-user documentation surface. Listed so they're accounted for, not silently missing.
| Block | Why no page |
|---|---|
| A, B, C — test scaffolding, harness inversion, post-refactor capabilities | Internal engineering (chat-flow engine internals) |
| D.1/D.2/D.5/D.7/D.8/D.11, E.1/E.5/E.8/E.9, H.1/H.2 | Internal engine/DX/SDK-migration work; user-facing slices surface on the pages above |
Block P — open-core source split (turing → turing-ce) | Repository/licensing change; not a product feature |
Block Q — viglet-core shared backend platform | Cross-product internal library (separate repo); no Turing-user surface |
Multi-tenancy parity (viglet-core-tenancy) | Internal shared-library lift; the Turing-facing feature is multi-tenancy |
| Block AC — JPA caching strategy | Internal architecture (documented in agents.md) |
| Block O — GEO / LLM discoverability | Marketing-site + llms.txt concern (turing.viglet.org), not the product docs |
| Block AB — public site & top-of-funnel | Marketing site (turing.viglet.org), separate app |
| Block AE — this documentation round | Meta — produced the pages in this very matrix |
| Block AG — Bento admin UI redesign + console retirement | UI/design change (frosted-glass admin reskin); no new capability, config, or API — the admin surfaces work the same, only re-skinned. Admin URLs moved /admin/* → /bento/* with transparent redirects, so bookmarks/deep-links still resolve. Doc screenshots refreshed opportunistically, not gated here |
Block AL — prompt-assembly pipeline (TurPromptContributor SPI, single-pass assembler, STABLE-first cache ordering) | Internal architecture — the assembled prompt is byte-identical to before; the observable change is a more faithful admin Live Preview (a fix) plus opt-in turing.prompt.assembly.* cache knobs not yet wired to provider caching |
T656 — resilient ONNX embedding-model acquisition (TurOnnxModelDownloader: retry/backoff, persistent cache dir, integrity check, actionable diagnostics) | Internal reliability — hardens the existing local/HuggingFace ONNX embedding warm-up download (persistent cache survives an ephemeral-env reset + retry + clear error); no new capability or admin/API/SDK surface. The only knobs are ops-level (turing.genai.embedding.local.cache-dir, …download.*), covered by the embedding-models provider docs where relevant |
| Block AR — live-demo search & chat quality (Lucene parity: similar-documents/MoreLikeThis, spell-check/"did you mean", RAG source dedup, autocomplete hyphen, demo typing indicator) | Engine-parity bug fixes — "Similar documents" and "did you mean" already work on Solr/Elasticsearch and are covered by the search docs; Block AR makes the embedded Lucene engine behave the same (/similar + /spell-check endpoints, request/response shape and admin config all unchanged), so there's no new user-facing surface to document |
Orphans
None. Every shipped user-facing subsystem resolves to a page above. If a new block ships without a row here, add it — and if it's user-facing without a page, that's a 🔴 to fix before the block is considered done.