AI search engine and MCP server for bots and agents. One Rust binary indexes code, docs, logs, JSONL/CSV and PDFs for BM25 full-text, vector and hybrid search, code search without grep, agent memory and RAG. Elasticsearch-compatible API; Corpus Hub serves hundreds of reference memory corpora.
Rust agent-memoryai-agentsbm25claude-codeclicode-searchcursordatabaseelasticsearchfull-text-searchhybrid-searchjsonllocal-firstmcpmcp-servermodel-context-protocolragrustsearch-enginevector-search
fix(landing): close the seven downstream funnel defects the FTX site probes found
xerj-orgb0bfce97a3ed
diff --git a/landing/agent-search/index.html b/landing/agent-search/index.htmlindex 65ae4a6fe..252be3c0e 100644--- a/landing/agent-search/index.html+++ b/landing/agent-search/index.html@@ -220,7 +220,7 @@ curl -X POST localhost:9200/kb/_search -H 'Content-Type: application/json' -d '{</div><footer class="footer">- <span>XERJ.AI · AGENT SEARCH · V1.0.0-RC.1</span>+ <span>XERJ.AI · AGENT SEARCH · V1.0.0-RC.15</span><span>PORTED FROM THE ENGINE · BIT-EXACT</span><span><a href="/index.html">HOME</a> · <a href="/docs/recipes/semantic-search-rag.html">SEMANTIC RECIPE</a> · <a href="/docs/recipes/index.html">RECIPES</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/benchmarks/index.html b/landing/benchmarks/index.htmlindex c6b792337..822777891 100644--- a/landing/benchmarks/index.html+++ b/landing/benchmarks/index.html@@ -291,12 +291,13 @@<div class="cov-row"><span class="cov-label">ES-YAML wire conformance</span><span class="cov-bar" style="width:99.8%"></span>- <span class="cov-meta">1,360 / 1,363 <b>99.8%</b></span>+ <span class="cov-meta">1,366 / 1,369 <b>99.8%</b></span></div><p class="sb-note">- That figure is <em>wire compatibility</em>, not performance, and it is sourced from- <span class="mono"><a href="/llms.txt">/llms.txt</a></span> — <span class="mono">SCORECARD.md</span>- does not record it. Three of 1,363 conformance cases are still unmet and we do not round that+ That figure is <em>wire compatibility</em>, not performance, and it is sourced from the+ ES-YAML conformance job on main's CI (<span class="mono">1366 passed · 0 failed · 3 skipped · 1369 total</span>)+ — <span class="mono">SCORECARD.md</span>+ does not record it. Three of 1,369 conformance cases are still unmet and we do not round thatto 100% or to "full ES compatibility." It is also not the product: XERJ is a from-scratch Rustengine that speaks the ES 8.x wire protocol as an <strong>adoption bridge</strong>, the way moderndatabases speak the Postgres protocol without being Postgres — compatibility is a feature here,@@ -1106,12 +1107,12 @@<div class="kicker"><span class="accent">05</span><span class="dash">·</span><span>KNOWN ISSUES & WHAT'S NEXT</span></div><h2 class="scene">THE RED CELLS<br><span class="accent">ARE THE ROADMAP.</span></h2>- <div class="row"><div class="k">Mixed read-under-write · 4 rows</div><div class="v">The board's only losses, and the one workload where ES is clearly ahead. Under a 40,000 docs/s writer both engines actually sustain (XERJ 39,626/s, ES 39,688/s), XERJ's read p99 is <strong>13.57 ms</strong> on <span class="mono">match_all</span> vs ES's <strong>3.45 ms</strong>, <strong>13.45 vs 6.76</strong> on <span class="mono">bool</span>, <strong>10.27 vs 3.68</strong> on <span class="mono">range</span>, <strong>10.74 vs 3.57</strong> on <span class="mono">terms</span>. Root cause, as recorded in <span class="mono">MIXED_READ_UNDER_WRITE_FINDING_2026-07-08.md</span> and confirmed under gdb that day: reads park on the <span class="mono">FtsMemtable</span> per-shard <span class="mono">parking_lot RwLock</span> behind a waiting writer — the classic writer-preference cascade, where new readers queue behind a queued writer. The stall is <strong>lock-bound, not CPU-bound</strong>: during a captured 20.9 s read, CPU sat at ~306% of 32 cores and 358–362 of 363 threads were sleeping — the read waits, it does not work. <strong>This is a defect we intend to fix, not an immutable property of the architecture.</strong> The finding doc locates the target (<span class="mono">index.rs mem_snapshot</span>: a filtered <span class="mono">size:0</span> aggregation is gated off the columnar path and materialises <em>every</em> memtable doc while holding <span class="mono">s.read()</span>) and lists three candidate fixes — snapshot the memtable behind an Arc/epoch so reads are lock-free, split the read fold so it never holds the shard lock across expensive work, or bias the lock toward readers — each gated on holding <strong>1,360 / 0 / 3</strong> ES-YAML conformance plus a representative auto-id repro showing mixed p99 back to low double-digit ms. ES is structurally advantaged here because it reads immutable segments no writer can contend for, and an ES-style visibility-parity mode is a <em>named, un-shipped option</em> rather than a promise with a date on it — but the visibility difference is why the gap exists, not a reason the cell stays red. The fifth cell in that family, <span class="mono">cardinality</span>, is a WIN at 10.61 vs 20.13 ms; it does not cancel the four.</div></div>+ <div class="row"><div class="k">Mixed read-under-write · 4 rows</div><div class="v">The board's only losses, and the one workload where ES is clearly ahead. Under a 40,000 docs/s writer both engines actually sustain (XERJ 39,626/s, ES 39,688/s), XERJ's read p99 is <strong>13.57 ms</strong> on <span class="mono">match_all</span> vs ES's <strong>3.45 ms</strong>, <strong>13.45 vs 6.76</strong> on <span class="mono">bool</span>, <strong>10.27 vs 3.68</strong> on <span class="mono">range</span>, <strong>10.74 vs 3.57</strong> on <span class="mono">terms</span>. Root cause, as recorded in <span class="mono">MIXED_READ_UNDER_WRITE_FINDING_2026-07-08.md</span> and confirmed under gdb that day: reads park on the <span class="mono">FtsMemtable</span> per-shard <span class="mono">parking_lot RwLock</span> behind a waiting writer — the classic writer-preference cascade, where new readers queue behind a queued writer. The stall is <strong>lock-bound, not CPU-bound</strong>: during a captured 20.9 s read, CPU sat at ~306% of 32 cores and 358–362 of 363 threads were sleeping — the read waits, it does not work. <strong>This is a defect we intend to fix, not an immutable property of the architecture.</strong> The finding doc locates the target (<span class="mono">index.rs mem_snapshot</span>: a filtered <span class="mono">size:0</span> aggregation is gated off the columnar path and materialises <em>every</em> memtable doc while holding <span class="mono">s.read()</span>) and lists three candidate fixes — snapshot the memtable behind an Arc/epoch so reads are lock-free, split the read fold so it never holds the shard lock across expensive work, or bias the lock toward readers — each gated on holding <strong>1,366 / 0 / 3</strong> ES-YAML conformance plus a representative auto-id repro showing mixed p99 back to low double-digit ms. ES is structurally advantaged here because it reads immutable segments no writer can contend for, and an ES-style visibility-parity mode is a <em>named, un-shipped option</em> rather than a promise with a date on it — but the visibility difference is why the gap exists, not a reason the cell stays red. The fifth cell in that family, <span class="mono">cardinality</span>, is a WIN at 10.61 vs 20.13 ms; it does not cancel the four.</div></div><div class="row"><div class="k">Open defect · reads under sustained write</div><div class="v"><strong>Not fixed, not cleanly reproduced, and not something the board scores.</strong> Under the same sustained write load a <span class="mono">range</span> read has returned <span class="mono">store_exception: No such file or directory (os error 2)</span> — a read <em>failing</em>, not merely running slow. Working hypothesis in <span class="mono">MIXED_READ_UNDER_WRITE_FINDING_2026-07-08.md</span>: reader snapshots do not pin segment files for the duration of a read, so a read slow enough to outlive a completed merge's deferred input-file GC grace can lose a segment file mid-flight — which would make it the same root cause as the slow reads above. It has only been seen under a deliberately brutal probe harness, so we are not calling it a shipped bug; we are also not leaving it off a page whose <strong>CORRECTNESS GATE</strong> asserts that an engine returning wrong or empty results cannot win on latency.</div></div><div class="row"><div class="k">The tie band</div><div class="v"><strong>26 of 88 cells</strong> land inside <span class="mono">|Δ| ≤ max(0.30 ms, 20%)</span> and score TIE. Some of them point at ES (<span class="mono">random_sampler</span> 0.82×, <span class="mono">deep from+size</span> 0.85×, <span class="mono">match_all</span> 0.93×, <span class="mono">exists</span> 0.98×, <span class="mono">constant_score</span> 0.99×); most point at XERJ. Both kinds are ties. Earlier boards had no band and forced every one of these into a win or a loss, which is why their totals wandered — the band replaced an argument with a threshold.</div></div><div class="row"><div class="k">Hardening along the way</div><div class="v">Durable mappings across restarts, a merge-race segment lease validated under sustained merge churn with zero result mismatches, WAL and segment garbage collection, a merge data-loss fix, a dedicated deprioritised ingest pool, and cooperative query timeouts. None of these are scored cells; they are the reason the scored cells are trustworthy.</div></div><div class="row"><div class="k">Not measured here</div><div class="v">Skipped, not hidden — each needs a purpose-built index the flat corpus lacks: <span class="mono">geo_*</span> queries and aggregations, <span class="mono">ip_range / ip_prefix</span>, <span class="mono">nested / has_child / has_parent</span>, <span class="mono">span_*</span>, <span class="mono">significant_text</span>, <span class="mono">semantic / hybrid</span> retrieval, top-level <span class="mono">knn</span> (covered separately by the kNN family), and <span class="mono">percolate</span> — a real reverse-search doc-scan in the engine, with no percolator corpus here to run it against. Purpose-built corpora are planned follow-ups.</div></div>- <div class="row"><div class="k">The standing guardrail</div><div class="v">Every performance change must hold ES-YAML REST conformance at <strong>1,360 passed / 0 failed / 3 skipped</strong> (1,360 of 1,363). Speed bought with correctness is not a win, and it does not merge.</div></div>+ <div class="row"><div class="k">The standing guardrail</div><div class="v">Every performance change must hold ES-YAML REST conformance at <strong>1,366 passed / 0 failed / 3 skipped</strong> (1,366 of 1,369) — the pass count grows as cases are added; <strong>0 failed</strong> is the part that never moves. Speed bought with correctness is not a win, and it does not merge.</div></div></section><!-- 06 — CHANGELOG -------------------------------------------->diff --git a/landing/case-studies/reference-coding.html b/landing/case-studies/reference-coding.htmlindex 78237fd14..b2592c22e 100644--- a/landing/case-studies/reference-coding.html+++ b/landing/case-studies/reference-coding.html@@ -74,8 +74,8 @@<button type="button" class="prompt-copy" data-copy="Install XERJ (docs: https://xerj.org/llms.txt), index this project's sources, and set up reference coding: clone and index the open-source repos closest to what we're building, and search how they solved a problem before writing code.">COPY THE PROMPT</button></div></div>- <div class="hint">That is the current one-line setup — <a href="https://xerj.org/llms.txt" rel="external" style="color:var(--accent);">llms.txt</a> walks the agent through the full loop. The measurement below ran the study's original long-form prompt.</div>- <div class="lbl" style="margin-top:18px;">◆ The exact prompt the study measured</div>+ <div class="hint">That is the current one-line setup, and the only one to paste — <a href="https://xerj.org/llms.txt" rel="external" style="color:var(--accent);">llms.txt</a> walks the agent through the whole loop with nothing else to install: start a node, <code class="inline">git clone --depth 1</code> each reference repo, <code class="inline">xerj autoindex</code> it, then query the <code class="inline">ax-*</code> indices before writing code.</div>+ <div class="lbl" style="margin-top:18px;">◆ HISTORICAL · the long-form prompt this study measured — kept verbatim for reproducibility, not current instructions</div><pre>Set me up for reference-coding with XERJ and then use it automatically for therest of our work, so I stop burning output tokens re-deriving APIs I could justlook up.@@ -96,7 +96,7 @@ look up.5. Re-index whenever the references change.Do this proactively for the rest of the session without me asking again.</pre>- <div class="hint">We tested this exact prompt end-to-end — see <a href="#verified" style="color:var(--accent);">Verified: the prompt works</a> below. Full text: <a href="https://github.com/xerj-org/xerj/blob/main/docs/case-studies/reference-coding/OPENER_PROMPT.md" rel="external" style="color:var(--accent);">OPENER_PROMPT.md →</a></div>+ <div class="hint">We tested this exact prompt end-to-end — see <a href="#verified" style="color:var(--accent);">Verified: the prompt works</a> below. Full text: <a href="https://github.com/xerj-org/xerj/blob/main/docs/case-studies/reference-coding/OPENER_PROMPT.md" rel="external" style="color:var(--accent);">OPENER_PROMPT.md →</a>. It drove the loop through <code class="inline">xc-corpus.sh</code> / <code class="inline">xc-index.sh</code> / <code class="inline">xc.py</code> — at the time, internal wrappers from the maintainers' own agent skill. They now ship at <a class="mono" href="https://github.com/xerj-org/xerj/tree/main/tools/xerj-code" rel="external" style="color:var(--accent);">tools/xerj-code/</a>, but nothing requires them: they are thin shells around <code class="inline">git clone --depth 1</code>, <code class="inline">xerj autoindex</code>, and one <code class="inline">multi_match</code> query, and <a href="#reproduce" style="color:var(--accent);">Do it yourself</a> below runs the same method with plain commands.</div></div></section>@@ -131,9 +131,9 @@ Do this proactively for the rest of the session without me asking again.</pre><div class="solve"><h3>THE THREE-STEP LOOP</h3><ul>- <li><strong>Clone</strong> — <code class="inline">xc-corpus.sh</code> shallow-clones the reference repos, grouped by problem domain.</li>- <li><strong>Index</strong> — <code class="inline">xc-index.sh</code> runs <code class="inline">xerj autoindex</code>; retrieval is O(1) regardless of tree size.</li>- <li><strong>Retrieve</strong> — <code class="inline">xc.py <corpus> "…"</code> returns the exact definition with its contract; the model reads a passage instead of re-deriving.</li>+ <li><strong>Clone</strong> — <code class="inline">git clone --depth 1</code> the reference repos into one folder per problem domain.</li>+ <li><strong>Index</strong> — <code class="inline">xerj autoindex <clone></code> against a running node; retrieval is O(1) regardless of tree size.</li>+ <li><strong>Retrieve</strong> — one <code class="inline">multi_match</code> over <code class="inline">defs</code> / <code class="inline">body</code> / <code class="inline">title</code> returns the exact definition with its contract; the model reads a passage instead of re-deriving.</li></ul></div></div>@@ -148,16 +148,16 @@ Do this proactively for the rest of the session without me asking again.</pre>reference-coding rules (retrieve before writing, cite what you use, respect licences).</li><li><strong>2 · The corpus is chosen by problem domain, not language.</strong> The agent reads the project'sdependencies and domains, picks the open-source repos that already solve those problems, and- <code class="inline">xc-corpus.sh</code> shallow-clones them into a named corpus. Each repository's licence- is recorded in <code class="inline">corpus.json</code>; GPL/AGPL entries are approach-only — read the design,+ <code class="inline">git clone --depth 1</code>s them into one folder per domain. Record each repository's+ licence alongside the clone; GPL/AGPL entries are approach-only — read the design,never copy the code.</li>- <li><strong>3 · Indexing is AST-aware.</strong> <code class="inline">xc-index.sh</code> runs- <code class="inline">xerj autoindex</code>: every file is sniffed by content, and source files go through+ <li><strong>3 · Indexing is AST-aware.</strong> <code class="inline">xerj autoindex <clone></code>:+ every file is sniffed by content, and source files go throughtree-sitter grammars (13 languages) that emit the language, every symbol with its kind and line number, asearchable <code class="inline">defs</code> field, and the full body. One index per dataset, incremental onre-runs — re-index when the references change.</li>- <li><strong>4 · Retrieval is hybrid, with a stated fallback.</strong> <code class="inline">xc.py</code> runs- BM25 <code class="inline">multi_match</code> over <code class="inline">body</code>,+ <li><strong>4 · Retrieval is hybrid, with a stated fallback.</strong> The retrieval step is a BM25+ <code class="inline">multi_match</code> over <code class="inline">body</code>,<code class="inline">defs</code> and <code class="inline">title</code> — with a measured (not hand-picked)boost on <code class="inline">defs</code> so exact symbol names outrank prose — RRF-fused with a vector armwhere an index supports it. When no index does, it degrades to BM25-only and says so; a silently@@ -284,15 +284,20 @@ Do this proactively for the rest of the session without me asking again.</pre></section><!-- Reproduce guide -->-<section class="scene-section">+<section class="scene-section" id="reproduce"><h2 class="scene" style="font-size:var(--fs-56);">DO IT <span class="accent">YOURSELF.</span></h2>- <p class="wide">The tooling ships in the repo, at <a class="mono" href="https://github.com/xerj-org/xerj/tree/main/tools/xerj-code" rel="external" style="color:var(--accent);">tools/xerj-code/</a>. The method works on any repository — including your own private code, which is the real use case.</p>+ <p class="wide">Four commands, no tooling beyond the <code class="inline">xerj</code> binary and <code class="inline">git</code>. The method works on any repository — including your own private code, which is the real use case.</p><ol class="steps" style="margin-top:var(--sp-6); max-width:820px;">- <li><strong>Start XERJ.</strong> <code class="inline">xerj -d ./.xerj-data --insecure</code> — the ES-compatible API comes up on <code class="inline">:9200</code>.</li>- <li><strong>Build a corpus.</strong> <code class="inline">xc-corpus.sh async-rust https://github.com/tokio-rs/tokio https://github.com/hyperium/hyper</code> — group by problem domain, not language.</li>- <li><strong>Or rebuild one someone already vetted.</strong> <code class="inline">xc-corpus.sh --from hub/xerj-search.json</code> — a corpus definition is URLs, pinned commit SHAs and licences; no source, so nothing to redistribute, and the same file gives two machines the same bytes.</li>- <li><strong>Index it.</strong> <code class="inline">xc-index.sh async-rust</code> — runs <code class="inline">xerj autoindex</code>; a 100k-record tree indexes in ~10 s.</li>- <li><strong>Retrieve before you write.</strong> <code class="inline">xc.py async-rust "graceful shutdown with a broadcast channel"</code> — returns the matching definition with <code class="inline">file:line</code>.</li>+ <li><strong>Start XERJ.</strong> <code class="inline">xerj -d ./.xerj-data --insecure &</code> — the ES-compatible API comes up on <code class="inline">:9200</code>. <code class="inline">autoindex</code> is a client of a running node; without one it exits 1.</li>+ <li><strong>Build a corpus.</strong> <code class="inline">git clone --depth 1 https://github.com/tokio-rs/tokio ref/tokio</code> (and the same for each peer) — group by problem domain, not language.</li>+ <li><strong>Index it.</strong> <code class="inline">xerj autoindex ref/tokio</code> — a 100k-record tree indexes in ~10 s; re-run when the references change and the journal makes it incremental.</li>+ <li><strong>Retrieve before you write.</strong> One query against the new indices returns the matching definition with <code class="inline">file:line</code>:+<pre style="margin-top:10px;">curl -sXPOST 'localhost:9200/ax-*/_search' -H 'content-type: application/json' \+ -d '{"size":3,"query":{"multi_match":{+ "query":"graceful shutdown with a broadcast channel",+ "fields":["defs^3","body","title"]}}}'</pre>+ <code class="inline">defs</code>, <code class="inline">symbols</code>, <code class="inline">body</code>, <code class="inline">title</code> and <code class="inline">language</code> are the fields <code class="inline">autoindex</code> writes for source files. <code class="inline">ax-*</code> matches every dataset on the node, your own project included — check <code class="inline">GET /_cat/indices</code> after each index run and narrow the pattern to the reference datasets when you want your own code kept out of the results.</li>+ <li><strong>Or let the wrappers do it.</strong> <code class="inline">xc-corpus.sh</code> / <code class="inline">xc-index.sh</code> / <code class="inline">xc.py</code> ship in the repo at <a class="mono" href="https://github.com/xerj-org/xerj/tree/main/tools/xerj-code" rel="external" style="color:var(--accent);">tools/xerj-code/</a> and wrap exactly the four steps above. They add a corpus definition: <code class="inline">xc-corpus.sh --from hub/xerj-search.json</code> rebuilds a corpus someone already vetted — URLs, pinned commit SHAs and licences; no source, so nothing to redistribute, and the same file gives two machines the same bytes.</li><li><strong>Measure it honestly.</strong> Three arms of the same agent — memory only, grep-driven, retrieval-injected — one hidden-test verdict, real tokens from <code class="inline">claude -p --output-format json</code>, no API key. The numbers and every per-run record are in <a href="https://github.com/xerj-org/xerj/blob/main/docs/case-studies/reference-coding/CASE_STUDY.md" rel="external" style="color:var(--accent);">CASE_STUDY.md</a>; the harness itself is not shipped.</li></ol></section>diff --git a/landing/docs/agents/endpoints.html b/landing/docs/agents/endpoints.htmlindex 442355b30..625b9dfea 100644--- a/landing/docs/agents/endpoints.html+++ b/landing/docs/agents/endpoints.html@@ -111,7 +111,7 @@<div class="kicker"><span>FOR AI · 03</span></div><h1>Endpoint contract</h1>- <p>The exact wire contract for the six agent operations plus the data endpoints they build on. Everything is on port <code class="inline">9200</code>, JSON in and JSON out. Optional fields are marked <code class="inline">?</code>. Response shapes are shown as they actually come back from a live XERJ.</p>+ <p>The exact wire contract for the six <em>HTTP</em> agent operations plus the data endpoints they build on. The seventh canonical operation, <code class="inline">xerj_autoindex</code>, is a CLI subcommand with no endpoint — its contract is in the <a href="/docs/recipes/zero-config-autoindex.html">zero-config indexing recipe</a>. Everything is on port <code class="inline">9200</code>, JSON in and JSON out. Optional fields are marked <code class="inline">?</code>. Response shapes are shown as they actually come back from a live XERJ.</p><h2>At a glance</h2><div class="api">@@ -129,7 +129,7 @@<div class="cell m">POST</div><div class="cell p"><a href="#vector">/:index/_search</a></div>- <div class="cell dsc"><code class="inline">xerj_vector_search</code> — top-level <code class="inline">knn</code>, exact nearest-neighbor.</div>+ <div class="cell dsc"><code class="inline">xerj_vector_search</code> — top-level <code class="inline">knn</code>; HNSW-served with exact rescoring when unfiltered, exact scan when filtered.</div><div class="cell m">POST</div><div class="cell p"><a href="#hybrid">/:index/_search</a></div>@@ -320,12 +320,12 @@ POST /logs/_bulk</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>-<script type="application/json" id="docs-index">[{"title":"Overview","slug":"/docs/index.html","kicker":"START","snip":""},{"title":"Quickstart","slug":"/docs/quickstart.html","kicker":"START","snip":""},{"title":"Install","slug":"/docs/install.html","kicker":"START","snip":""},{"title":"Migrate from ES","slug":"/docs/migration-from-es.html","kicker":"START","snip":""},{"title":"CLI","slug":"/docs/cli.html","kicker":"REFERENCE","snip":""},{"title":"Config TOML","slug":"/docs/config.html","kicker":"REFERENCE","snip":""},{"title":"Environment","slug":"/docs/env.html","kicker":"REFERENCE","snip":""},{"title":"Native REST API","slug":"/docs/api-native.html","kicker":"REFERENCE","snip":""},{"title":"ES-compat API","slug":"/docs/api-es-compat.html","kicker":"REFERENCE","snip":""},{"title":"Query types","slug":"/docs/queries.html","kicker":"DATA MODEL","snip":""},{"title":"Aggregations","slug":"/docs/aggregations.html","kicker":"DATA MODEL","snip":""},{"title":"Analyzers","slug":"/docs/analyzers.html","kicker":"DATA MODEL","snip":""},{"title":"Vectors & kNN","slug":"/docs/vectors.html","kicker":"DATA MODEL","snip":""},{"title":"Ingest pipelines","slug":"/docs/ingest.html","kicker":"ENGINE","snip":""},{"title":"Storage & WAL","slug":"/docs/storage.html","kicker":"ENGINE","snip":""},{"title":"Compression","slug":"/docs/compression.html","kicker":"ENGINE","snip":""},{"title":"Clustering","slug":"/docs/clustering.html","kicker":"ENGINE","snip":""},{"title":"Metrics","slug":"/docs/metrics.html","kicker":"ENGINE","snip":""},{"title":"Auth & TLS","slug":"/docs/security.html","kicker":"ENGINE","snip":""},{"title":"Running in production","slug":"/docs/operations.html","kicker":"OPERATIONS","snip":""},{"title":"Backup & restore","slug":"/docs/backup-restore.html","kicker":"OPERATIONS","snip":""},{"title":"Upgrades","slug":"/docs/upgrades.html","kicker":"OPERATIONS","snip":""},{"title":"Troubleshooting","slug":"/docs/troubleshooting.html","kicker":"OPERATIONS","snip":""},{"title":"SIEM","slug":"/docs/playbooks/siem.html","kicker":"PLAYBOOKS","snip":""},{"title":"Log analytics","slug":"/docs/playbooks/log-analytics.html","kicker":"PLAYBOOKS","snip":""},{"title":"Vector · RAG","slug":"/docs/playbooks/vector-search.html","kicker":"PLAYBOOKS","snip":""},{"title":"Full-text search","slug":"/docs/playbooks/full-text.html","kicker":"PLAYBOOKS","snip":""},{"title":"Observability","slug":"/docs/playbooks/observability.html","kicker":"PLAYBOOKS","snip":""},{"title":"CLI · --config","slug":"/docs/cli.html#config-flag","kicker":"CLI","snip":"-c, --config <PATH> Path to the TOML config file."},{"title":"CLI · --data-dir","slug":"/docs/cli.html#data-dir-flag","kicker":"CLI","snip":"-d, --data-dir <PATH> Override [server] data_dir at the command line."},{"title":"CLI · --insecure","slug":"/docs/cli.html#insecure-flag","kicker":"CLI","snip":"-k, --insecure Disable TLS and API-key auth. Dev only."},{"title":"[server] rest_port","slug":"/docs/config.html#server","kicker":"CONFIG","snip":"u16 · default 8080 · Native REST API listener port."},{"title":"[server] es_compat_port","slug":"/docs/config.html#server","kicker":"CONFIG","snip":"u16 · default 9200 · Elasticsearch-wire-format port. 0 to disable."},{"title":"[storage] wal_sync","slug":"/docs/config.html#storage","kicker":"CONFIG","snip":"enum · default batched · sync · batched · async. Durability knob."},{"title":"[vector] hnsw_ef_search","slug":"/docs/config.html#vector","kicker":"CONFIG","snip":"u32 · default 100 · Accepted but not wired — the beam width comes from the request num_candidates."},{"title":"[vector] default_quantization","slug":"/docs/config.html#vector","kicker":"CONFIG","snip":"enum · none (default) · scalar8. binary is refused at startup; scalar4 is not accepted."},{"title":"GET /v1/health","slug":"/docs/api-native.html#health","kicker":"NATIVE API","snip":"Liveness + readiness. {status, uptime_s, version}."},{"title":"GET /v1/metrics","slug":"/docs/api-native.html#metrics","kicker":"NATIVE API","snip":"Prometheus text format. Scrape-friendly."},{"title":"POST /v1/indices/:name/turbo-ingest","slug":"/docs/api-native.html#turbo-ingest","kicker":"NATIVE API","snip":"NDJSON bulk path with parallel tokenization."},{"title":"POST /v1/indices/:name/search","slug":"/docs/api-native.html#search","kicker":"NATIVE API","snip":"Unified query endpoint — full-text, term, range, KNN, hybrid."},{"title":"POST /:index/_bulk","slug":"/docs/api-es-compat.html#bulk","kicker":"ES API","snip":"NDJSON bulk. Actions: index, create, update, delete."},{"title":"POST /:index/_search","slug":"/docs/api-es-compat.html#search","kicker":"ES API","snip":"ES query DSL. Drop-in migration path."},{"title":"match_all","slug":"/docs/queries.html#match-all","kicker":"QUERY","snip":"Everything in the index."},{"title":"bool","slug":"/docs/queries.html#bool","kicker":"QUERY","snip":"must / should / must_not / filter clauses."},{"title":"knn","slug":"/docs/queries.html#knn","kicker":"QUERY","snip":"Vector kNN — HNSW-served when unfiltered (exact-rescored); filtered runs the exact scan."},{"title":"semantic","slug":"/docs/queries.html#semantic","kicker":"QUERY","snip":"Embed the query text at query time and search the vector field."},{"title":"hybrid","slug":"/docs/queries.html#hybrid","kicker":"QUERY","snip":"RRF / linear fusion of sub-queries."},{"title":"terms aggregation","slug":"/docs/aggregations.html#terms","kicker":"AGG","snip":"Exact, pre-computed terms histograms over keyword fields."},{"title":"date_histogram","slug":"/docs/aggregations.html#date-histogram","kicker":"AGG","snip":"Time-bucketed counts."},{"title":"kNN serving","slug":"/docs/vectors.html#knn-query","kicker":"VECTORS","snip":"Unfiltered kNN via persisted HNSW + exact rescore; filtered kNN exact scan."},{"title":"SQ8 quantization","slug":"/docs/vectors.html#quantization","kicker":"VECTORS","snip":"8-bit scalar quantization. 4× memory reduction."},{"title":"turbo-ingest","slug":"/docs/ingest.html#turbo","kicker":"INGEST","snip":"NDJSON bulk path. Parallel tokenization across cores."},{"title":"delta-of-delta","slug":"/docs/compression.html#delta-of-delta","kicker":"COMPRESSION","snip":"Timestamp encoding. Apache/Nginx/ISO auto-detect."},{"title":"dictionary encoding","slug":"/docs/compression.html#dictionary","kicker":"COMPRESSION","snip":"Up to 256 unique strings per column."},{"title":"api_key","slug":"/docs/security.html#api-key","kicker":"SECURITY","snip":"Static admin key. Auto-generated on first run."},{"title":"SIEM playbook","slug":"/docs/playbooks/siem.html","kicker":"PLAYBOOK","snip":"Terms agg over source IPs for SIEM, with detection rules."},{"title":"RAG playbook","slug":"/docs/playbooks/vector-search.html","kicker":"PLAYBOOK","snip":"Embeddings, kNN, hybrid search, BM25 + kNN fusion."},{"title":"[cluster] enabled","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"bool · default false · Enable multi-node Raft cluster mode."},{"title":"[cluster] peers","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"array · \"node_id=host:port\" · At least one peer per node."},{"title":"[cluster] port","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"u16 · default 9300 · Intra-cluster Raft + search port."},{"title":"[embedding] default_endpoint","slug":"/docs/config.html#embedding","kicker":"CONFIG","snip":"string · OpenAI-compatible embeddings URL for auto-embedding on ingest."},{"title":"[embedding] default_model","slug":"/docs/config.html#embedding","kicker":"CONFIG","snip":"string · Model name (e.g. text-embedding-3-small, nomic-embed-text)."},{"title":"Raft","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"Embedded Raft — leader election, log replication, metadata only."},{"title":"Node draining","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"POST /v1/cluster/nodes/:id/drain before maintenance."},{"title":"Region split/merge","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"Range partitions auto-split at byte threshold, merge back when small."},{"title":"Systemd unit","slug":"/docs/operations.html","kicker":"OPS","snip":"Production unit file with hardening directives."},{"title":"Readiness probe","slug":"/docs/operations.html","kicker":"OPS","snip":"GET /v1/health/ready — only 200 once WAL replay is complete."},{"title":"Config reload","slug":"/docs/operations.html","kicker":"OPS","snip":"SIGHUP reloads most keys without restart."},{"title":"Hot backup","slug":"/docs/backup-restore.html","kicker":"OPS","snip":"rsync the data dir after POST /v1/admin/flush."},{"title":"S3 backup","slug":"/docs/backup-restore.html","kicker":"OPS","snip":"POST /v1/admin/backup → any S3-compatible endpoint."},{"title":"Rolling upgrade","slug":"/docs/upgrades.html","kicker":"OPS","snip":"Drain → stop → upgrade → start → activate, per node."},{"title":"Merge pressure","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"Segment count climbing → raise merge.max_concurrent + io_rate."},{"title":"Cluster flapping","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"Leader changes every few seconds → raise cluster.tick_ms."},{"title":"WAL replay failed","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"xerj verify --repair-wal truncates at last valid entry."},{"title":"Recipes","slug":"/docs/recipes/index.html","kicker":"RECIPES","snip":"Task-oriented AI & search recipes, each verified end-to-end against a live XERJ."},{"title":"Semantic search & RAG","slug":"/docs/recipes/semantic-search-rag.html","kicker":"RECIPE","snip":"Retrieval by meaning with semantic_text — auto-embed on ingest, no separate vector DB."},{"title":"Agent memory","slug":"/docs/recipes/agentic-memory.html","kicker":"RECIPE","snip":"Long-term memory for agents via /_memory — store, recall, forget, per-agent isolation."},{"title":"Passage retrieval","slug":"/docs/recipes/passage-retrieval.html","kicker":"RECIPE","snip":"Auto-chunk long docs; best-passage (max-sim) scoring — 98% top-3."},{"title":"Vector search · kNN","slug":"/docs/recipes/vector-search-knn.html","kicker":"RECIPE","snip":"Nearest-neighbor over dense_vector — exact brute-force — with filters."},{"title":"Vector quantization","slug":"/docs/recipes/vector-quantization.html","kicker":"RECIPE","snip":"int8_hnsw scalar8 — 4× smaller vectors, recall@10 ≈ 0.99."},{"title":"Hybrid search","slug":"/docs/recipes/hybrid-search.html","kicker":"RECIPE","snip":"Keyword + vector in one query — RRF fusion."},{"title":"Log analytics","slug":"/docs/recipes/log-analytics.html","kicker":"RECIPE","snip":"Raw logs to dashboards — error rates, p95 latency, top services."},{"title":"Anomaly detection","slug":"/docs/recipes/anomaly-detection.html","kicker":"RECIPE","snip":"Statistical _ml detectors that flag spikes in metrics/logs."},{"title":"Anomaly datafeeds","slug":"/docs/recipes/continuous-anomaly-datafeeds.html","kicker":"RECIPE","snip":"Live _ml datafeed re-scores an index on a timer, stores anomaly records."},{"title":"Migrate from ES","slug":"/docs/recipes/migrate-from-elasticsearch.html","kicker":"RECIPE","snip":"Point your existing ES client at XERJ — same wire, change the URL."},{"title":"For AI · Build with XERJ","slug":"/for-agents.html","kicker":"AI","snip":"The search, data & memory layer for AI agents — one binary on :9200."},{"title":"Agents · Overview","slug":"/docs/agents/index.html","kicker":"AI","snip":"The 6 canonical agent ops: search, semantic, vector, hybrid, memory store/recall."},{"title":"Agent quickstart","slug":"/docs/agents/quickstart.html","kicker":"AI","snip":"Boot XERJ, store a memory, recall by meaning, semantic search — runnable curl on :9200."},{"title":"Agent endpoints","slug":"/docs/agents/endpoints.html","kicker":"AI","snip":"Endpoint contract table: method, path, request body, response shape."},{"title":"xerj_memory_store","slug":"/docs/agents/endpoints.html#memory-store","kicker":"AGENT OP","snip":"POST /_memory/{ns} — store a memory (text auto-embedded, or bring your own vector)."},{"title":"xerj_memory_recall","slug":"/docs/agents/endpoints.html#memory-recall","kicker":"AGENT OP","snip":"POST /_memory/{ns}/_recall — recall top-k by meaning (semantic), keyword (BM25) or vector (kNN)."},{"title":"xerj_semantic_search","slug":"/docs/agents/endpoints.html#semantic","kicker":"AGENT OP","snip":"semantic query over a semantic_text field — the server embeds the query text."},{"title":"xerj_vector_search","slug":"/docs/agents/endpoints.html#vector","kicker":"AGENT OP","snip":"knn over dense_vector — exact nearest-neighbor at query time."},{"title":"xerj_hybrid_search","slug":"/docs/agents/endpoints.html#hybrid","kicker":"AGENT OP","snip":"hybrid query — fuse BM25 + vector with rrf or linear fusion."}]</script>+<script type="application/json" id="docs-index">[{"title":"Overview","slug":"/docs/index.html","kicker":"START","snip":""},{"title":"Quickstart","slug":"/docs/quickstart.html","kicker":"START","snip":""},{"title":"Install","slug":"/docs/install.html","kicker":"START","snip":""},{"title":"Migrate from ES","slug":"/docs/migration-from-es.html","kicker":"START","snip":""},{"title":"CLI","slug":"/docs/cli.html","kicker":"REFERENCE","snip":""},{"title":"Config TOML","slug":"/docs/config.html","kicker":"REFERENCE","snip":""},{"title":"Environment","slug":"/docs/env.html","kicker":"REFERENCE","snip":""},{"title":"Native REST API","slug":"/docs/api-native.html","kicker":"REFERENCE","snip":""},{"title":"ES-compat API","slug":"/docs/api-es-compat.html","kicker":"REFERENCE","snip":""},{"title":"Query types","slug":"/docs/queries.html","kicker":"DATA MODEL","snip":""},{"title":"Aggregations","slug":"/docs/aggregations.html","kicker":"DATA MODEL","snip":""},{"title":"Analyzers","slug":"/docs/analyzers.html","kicker":"DATA MODEL","snip":""},{"title":"Vectors & kNN","slug":"/docs/vectors.html","kicker":"DATA MODEL","snip":""},{"title":"Ingest pipelines","slug":"/docs/ingest.html","kicker":"ENGINE","snip":""},{"title":"Storage & WAL","slug":"/docs/storage.html","kicker":"ENGINE","snip":""},{"title":"Compression","slug":"/docs/compression.html","kicker":"ENGINE","snip":""},{"title":"Clustering","slug":"/docs/clustering.html","kicker":"ENGINE","snip":""},{"title":"Metrics","slug":"/docs/metrics.html","kicker":"ENGINE","snip":""},{"title":"Auth & TLS","slug":"/docs/security.html","kicker":"ENGINE","snip":""},{"title":"Running in production","slug":"/docs/operations.html","kicker":"OPERATIONS","snip":""},{"title":"Backup & restore","slug":"/docs/backup-restore.html","kicker":"OPERATIONS","snip":""},{"title":"Upgrades","slug":"/docs/upgrades.html","kicker":"OPERATIONS","snip":""},{"title":"Troubleshooting","slug":"/docs/troubleshooting.html","kicker":"OPERATIONS","snip":""},{"title":"SIEM","slug":"/docs/playbooks/siem.html","kicker":"PLAYBOOKS","snip":""},{"title":"Log analytics","slug":"/docs/playbooks/log-analytics.html","kicker":"PLAYBOOKS","snip":""},{"title":"Vector · RAG","slug":"/docs/playbooks/vector-search.html","kicker":"PLAYBOOKS","snip":""},{"title":"Full-text search","slug":"/docs/playbooks/full-text.html","kicker":"PLAYBOOKS","snip":""},{"title":"Observability","slug":"/docs/playbooks/observability.html","kicker":"PLAYBOOKS","snip":""},{"title":"CLI · --config","slug":"/docs/cli.html#config-flag","kicker":"CLI","snip":"-c, --config <PATH> Path to the TOML config file."},{"title":"CLI · --data-dir","slug":"/docs/cli.html#data-dir-flag","kicker":"CLI","snip":"-d, --data-dir <PATH> Override [server] data_dir at the command line."},{"title":"CLI · --insecure","slug":"/docs/cli.html#insecure-flag","kicker":"CLI","snip":"-k, --insecure Disable TLS and API-key auth. Dev only."},{"title":"[server] rest_port","slug":"/docs/config.html#server","kicker":"CONFIG","snip":"u16 · default 8080 · Native REST API listener port."},{"title":"[server] es_compat_port","slug":"/docs/config.html#server","kicker":"CONFIG","snip":"u16 · default 9200 · Elasticsearch-wire-format port. 0 to disable."},{"title":"[storage] wal_sync","slug":"/docs/config.html#storage","kicker":"CONFIG","snip":"enum · default batched · sync · batched · async. Durability knob."},{"title":"[vector] hnsw_ef_search","slug":"/docs/config.html#vector","kicker":"CONFIG","snip":"u32 · default 100 · Accepted but not wired — the beam width comes from the request num_candidates."},{"title":"[vector] default_quantization","slug":"/docs/config.html#vector","kicker":"CONFIG","snip":"enum · none (default) · scalar8. binary is refused at startup; scalar4 is not accepted."},{"title":"GET /v1/health","slug":"/docs/api-native.html#health","kicker":"NATIVE API","snip":"Liveness + readiness. {status, uptime_s, version}."},{"title":"GET /v1/metrics","slug":"/docs/api-native.html#metrics","kicker":"NATIVE API","snip":"Prometheus text format. Scrape-friendly."},{"title":"POST /v1/indices/:name/turbo-ingest","slug":"/docs/api-native.html#turbo-ingest","kicker":"NATIVE API","snip":"NDJSON bulk path with parallel tokenization."},{"title":"POST /v1/indices/:name/search","slug":"/docs/api-native.html#search","kicker":"NATIVE API","snip":"Unified query endpoint — full-text, term, range, KNN, hybrid."},{"title":"POST /:index/_bulk","slug":"/docs/api-es-compat.html#bulk","kicker":"ES API","snip":"NDJSON bulk. Actions: index, create, update, delete."},{"title":"POST /:index/_search","slug":"/docs/api-es-compat.html#search","kicker":"ES API","snip":"ES query DSL. Drop-in migration path."},{"title":"match_all","slug":"/docs/queries.html#match-all","kicker":"QUERY","snip":"Everything in the index."},{"title":"bool","slug":"/docs/queries.html#bool","kicker":"QUERY","snip":"must / should / must_not / filter clauses."},{"title":"knn","slug":"/docs/queries.html#knn","kicker":"QUERY","snip":"Vector kNN — HNSW-served when unfiltered (exact-rescored); filtered runs the exact scan."},{"title":"semantic","slug":"/docs/queries.html#semantic","kicker":"QUERY","snip":"Embed the query text at query time and search the vector field."},{"title":"hybrid","slug":"/docs/queries.html#hybrid","kicker":"QUERY","snip":"RRF / linear fusion of sub-queries."},{"title":"terms aggregation","slug":"/docs/aggregations.html#terms","kicker":"AGG","snip":"Exact, pre-computed terms histograms over keyword fields."},{"title":"date_histogram","slug":"/docs/aggregations.html#date-histogram","kicker":"AGG","snip":"Time-bucketed counts."},{"title":"kNN serving","slug":"/docs/vectors.html#knn-query","kicker":"VECTORS","snip":"Unfiltered kNN via persisted HNSW + exact rescore; filtered kNN exact scan."},{"title":"SQ8 quantization","slug":"/docs/vectors.html#quantization","kicker":"VECTORS","snip":"8-bit scalar quantization. 4× memory reduction."},{"title":"turbo-ingest","slug":"/docs/ingest.html#turbo","kicker":"INGEST","snip":"NDJSON bulk path. Parallel tokenization across cores."},{"title":"delta-of-delta","slug":"/docs/compression.html#delta-of-delta","kicker":"COMPRESSION","snip":"Timestamp encoding. Apache/Nginx/ISO auto-detect."},{"title":"dictionary encoding","slug":"/docs/compression.html#dictionary","kicker":"COMPRESSION","snip":"Up to 256 unique strings per column."},{"title":"api_key","slug":"/docs/security.html#api-key","kicker":"SECURITY","snip":"Static admin key. Auto-generated on first run."},{"title":"SIEM playbook","slug":"/docs/playbooks/siem.html","kicker":"PLAYBOOK","snip":"Terms agg over source IPs for SIEM, with detection rules."},{"title":"RAG playbook","slug":"/docs/playbooks/vector-search.html","kicker":"PLAYBOOK","snip":"Embeddings, kNN, hybrid search, BM25 + kNN fusion."},{"title":"[cluster] enabled","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"bool · default false · Enable multi-node Raft cluster mode."},{"title":"[cluster] peers","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"array · \"node_id=host:port\" · At least one peer per node."},{"title":"[cluster] port","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"u16 · default 9300 · Intra-cluster Raft + search port."},{"title":"[embedding] default_endpoint","slug":"/docs/config.html#embedding","kicker":"CONFIG","snip":"string · OpenAI-compatible embeddings URL for auto-embedding on ingest."},{"title":"[embedding] default_model","slug":"/docs/config.html#embedding","kicker":"CONFIG","snip":"string · Model name (e.g. text-embedding-3-small, nomic-embed-text)."},{"title":"Raft","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"Embedded Raft — leader election, log replication, metadata only."},{"title":"Node draining","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"POST /v1/cluster/nodes/:id/drain before maintenance."},{"title":"Region split/merge","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"Range partitions auto-split at byte threshold, merge back when small."},{"title":"Systemd unit","slug":"/docs/operations.html","kicker":"OPS","snip":"Production unit file with hardening directives."},{"title":"Readiness probe","slug":"/docs/operations.html","kicker":"OPS","snip":"GET /v1/health/ready — only 200 once WAL replay is complete."},{"title":"Config reload","slug":"/docs/operations.html","kicker":"OPS","snip":"SIGHUP reloads most keys without restart."},{"title":"Hot backup","slug":"/docs/backup-restore.html","kicker":"OPS","snip":"rsync the data dir after POST /v1/admin/flush."},{"title":"S3 backup","slug":"/docs/backup-restore.html","kicker":"OPS","snip":"POST /v1/admin/backup → any S3-compatible endpoint."},{"title":"Rolling upgrade","slug":"/docs/upgrades.html","kicker":"OPS","snip":"Drain → stop → upgrade → start → activate, per node."},{"title":"Merge pressure","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"Segment count climbing → raise merge.max_concurrent + io_rate."},{"title":"Cluster flapping","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"Leader changes every few seconds → raise cluster.tick_ms."},{"title":"WAL replay failed","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"xerj verify --repair-wal truncates at last valid entry."},{"title":"Recipes","slug":"/docs/recipes/index.html","kicker":"RECIPES","snip":"Task-oriented AI & search recipes, each verified end-to-end against a live XERJ."},{"title":"Semantic search & RAG","slug":"/docs/recipes/semantic-search-rag.html","kicker":"RECIPE","snip":"Retrieval by meaning with semantic_text — auto-embed on ingest, no separate vector DB."},{"title":"Agent memory","slug":"/docs/recipes/agentic-memory.html","kicker":"RECIPE","snip":"Long-term memory for agents via /_memory — store, recall, forget, per-agent isolation."},{"title":"Passage retrieval","slug":"/docs/recipes/passage-retrieval.html","kicker":"RECIPE","snip":"Auto-chunk long docs; best-passage (max-sim) scoring — 98% top-3."},{"title":"Vector search · kNN","slug":"/docs/recipes/vector-search-knn.html","kicker":"RECIPE","snip":"Nearest-neighbor over dense_vector — HNSW-served unfiltered, exact with filters."},{"title":"Vector quantization","slug":"/docs/recipes/vector-quantization.html","kicker":"RECIPE","snip":"scalar8 (accepts ES int8_hnsw; exact code scan) — 4× smaller vectors, recall@10 ≈ 0.99."},{"title":"Hybrid search","slug":"/docs/recipes/hybrid-search.html","kicker":"RECIPE","snip":"Keyword + vector in one query — RRF fusion."},{"title":"Log analytics","slug":"/docs/recipes/log-analytics.html","kicker":"RECIPE","snip":"Raw logs to dashboards — error rates, p95 latency, top services."},{"title":"Anomaly detection","slug":"/docs/recipes/anomaly-detection.html","kicker":"RECIPE","snip":"Statistical _ml detectors that flag spikes in metrics/logs."},{"title":"Anomaly datafeeds","slug":"/docs/recipes/continuous-anomaly-datafeeds.html","kicker":"RECIPE","snip":"Live _ml datafeed re-scores an index on a timer, stores anomaly records."},{"title":"Migrate from ES","slug":"/docs/recipes/migrate-from-elasticsearch.html","kicker":"RECIPE","snip":"Point your existing ES client at XERJ — same wire, change the URL."},{"title":"For AI · Build with XERJ","slug":"/for-agents.html","kicker":"AI","snip":"The search, data & memory layer for AI agents — one binary on :9200."},{"title":"Agents · Overview","slug":"/docs/agents/index.html","kicker":"AI","snip":"The 7 canonical agent ops: autoindex (CLI-only), search, semantic, vector, hybrid, memory store/recall."},{"title":"Agent quickstart","slug":"/docs/agents/quickstart.html","kicker":"AI","snip":"Boot XERJ, store a memory, recall by meaning, semantic search — runnable curl on :9200."},{"title":"Agent endpoints","slug":"/docs/agents/endpoints.html","kicker":"AI","snip":"Endpoint contract table: method, path, request body, response shape."},{"title":"xerj_memory_store","slug":"/docs/agents/endpoints.html#memory-store","kicker":"AGENT OP","snip":"POST /_memory/{ns} — store a memory (text auto-embedded, or bring your own vector)."},{"title":"xerj_memory_recall","slug":"/docs/agents/endpoints.html#memory-recall","kicker":"AGENT OP","snip":"POST /_memory/{ns}/_recall — recall top-k by meaning (semantic), keyword (BM25) or vector (kNN)."},{"title":"xerj_semantic_search","slug":"/docs/agents/endpoints.html#semantic","kicker":"AGENT OP","snip":"semantic query over a semantic_text field — the server embeds the query text."},{"title":"xerj_autoindex","slug":"/docs/recipes/zero-config-autoindex.html","kicker":"AGENT OP","snip":"xerj autoindex <folder> — CLI-only, no HTTP route: content-sniffed formats, inferred mappings, self-describing catalog."},{"title":"xerj_vector_search","slug":"/docs/agents/endpoints.html#vector","kicker":"AGENT OP","snip":"knn over dense_vector — HNSW-served when unfiltered (exact-rescored), exact scan when filtered."},{"title":"xerj_hybrid_search","slug":"/docs/agents/endpoints.html#hybrid","kicker":"AGENT OP","snip":"hybrid query — fuse BM25 + vector with rrf or linear fusion."}]</script><script>// IIFE — js-auth navigates between decrypted pages in the samediff --git a/landing/docs/agents/index.html b/landing/docs/agents/index.htmlindex fb58146c5..63a272991 100644--- a/landing/docs/agents/index.html+++ b/landing/docs/agents/index.html@@ -4,7 +4,7 @@<meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>XERJ · Docs · For AI · Overview</title>-<meta name="description" content="Build with XERJ: the six canonical agent operations — search, semantic search, vector kNN, hybrid, and agent memory store/recall — all on the ES-compatible :9200 API.">+<meta name="description" content="Build with XERJ: the seven canonical agent operations — autoindex a folder (CLI), then search, semantic search, vector kNN, hybrid, and agent memory store/recall on the ES-compatible :9200 API."><link rel="preconnect" href="https://fonts.googleapis.com"><link rel="preconnect" href="https://fonts.gstatic.com" crossorigin><link href="https://fonts.googleapis.com/css2?family=Big+Shoulders+Display:wght@400;700;800;900&family=Inter:wght@400;500;600;700&family=IBM+Plex+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet">@@ -111,28 +111,29 @@<div class="kicker"><span>FOR AI · OVERVIEW</span></div><h1>Build with XERJ</h1>- <p>XERJ is the <strong>search, data, and memory layer for AI agents</strong>. It speaks the Elasticsearch wire protocol on port <code class="inline">9200</code>, so any HTTP client an agent can already make works out of the box — no SDK, no signup, no external embedding key. This page is the map: the six operations an agent needs, what each one really does, and where to go next.</p>+ <p>XERJ is the <strong>search, data, and memory layer for AI agents</strong>. It speaks the Elasticsearch wire protocol on port <code class="inline">9200</code>, so any HTTP client an agent can already make works out of the box — no SDK, no signup, no external embedding key. This page is the map: the seven operations an agent needs, what each one really does, and where to go next.</p><p>Everything below is verified against a running XERJ (<code class="inline">--insecure</code>, single node, empty data dir). Copy any request, paste it into your agent's tool, and it runs.</p>- <h2>The six canonical agent operations</h2>- <p>An agent needs to find things, find things by meaning, remember things, and recall them later. XERJ exposes exactly those as six operations over two families of endpoints — normal ES search on your indices, and a dedicated namespaced <code class="inline">/_memory</code> API.</p>+ <h2>The seven canonical agent operations</h2>+ <p>An agent needs to turn a folder into something queryable, find things, find things by meaning, remember things, and recall them later. XERJ exposes exactly those as seven operations: one CLI subcommand that ingests a folder, and six HTTP operations over two families of endpoints — normal ES search on your indices, and a dedicated namespaced <code class="inline">/_memory</code> API.</p><table><thead><tr><th>Operation</th><th>Endpoint</th><th>What it does</th></tr></thead><tbody>+ <tr><td><code class="inline">xerj_autoindex</code></td><td><code class="inline">xerj autoindex <folder></code> · <strong>CLI only — no HTTP route</strong></td><td>Make a folder searchable with zero config: formats sniffed by content, field types and date encodings inferred, explicit mappings written, everything streamed in with idempotent ids, and a self-describing <code class="inline">autoindex-catalog</code> index left behind. It is a client of a running node — start one first. Full contract: the <a href="/docs/recipes/zero-config-autoindex.html">zero-config indexing recipe</a>.</td></tr><tr><td><code class="inline">xerj_search</code></td><td><code class="inline">POST /{index}/_search</code> · <code class="inline">match</code>/<code class="inline">term</code>/<code class="inline">bool</code></td><td>Full-text and structured search (BM25 + filters). The exact-word path.</td></tr><tr><td><code class="inline">xerj_semantic_search</code></td><td><code class="inline">POST /{index}/_search</code> · <code class="inline">semantic</code> query</td><td>Search by meaning over a <code class="inline">semantic_text</code> field. The server embeds the query text for you.</td></tr>- <tr><td><code class="inline">xerj_vector_search</code></td><td><code class="inline">POST /{index}/_search</code> · <code class="inline">knn</code></td><td>Nearest-neighbor over a <code class="inline">dense_vector</code> field, using vectors you supply.</td></tr>+ <tr><td><code class="inline">xerj_vector_search</code></td><td><code class="inline">POST /{index}/_search</code> · <code class="inline">knn</code></td><td>Nearest-neighbor over a <code class="inline">dense_vector</code> field, using vectors you supply — HNSW-served with exact rescoring when unfiltered, exact scan when filtered.</td></tr><tr><td><code class="inline">xerj_hybrid_search</code></td><td><code class="inline">POST /{index}/_search</code> · <code class="inline">hybrid</code> query</td><td>Fuse keyword + vector results in one query with <code class="inline">rrf</code> or <code class="inline">linear</code> fusion.</td></tr><tr><td><code class="inline">xerj_memory_store</code></td><td><code class="inline">POST /_memory/{namespace}</code></td><td>Remember a fact for later. Text is auto-embedded; metadata optional.</td></tr><tr><td><code class="inline">xerj_memory_recall</code></td><td><code class="inline">POST /_memory/{namespace}/_recall</code></td><td>Recall top-k relevant memories by meaning, keyword, or vector.</td></tr></tbody></table>- <p>The full request/response shape for every one of these is on the <a href="/docs/agents/endpoints.html">endpoint contract</a> page. If you just want to see it run end-to-end, start with the <a href="/docs/agents/quickstart.html">agent quickstart</a>.</p>+ <p>The full request/response shape for every HTTP operation is on the <a href="/docs/agents/endpoints.html">endpoint contract</a> page. If you just want to see it run end-to-end, start with the <a href="/docs/agents/quickstart.html">agent quickstart</a>.</p><h2>Three jobs, one binary</h2><ul>@@ -182,12 +183,12 @@ $ curl -sXPOST localhost:9200/_memory/agent-demo/_recall \</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>-<script type="application/json" id="docs-index">[{"title":"Overview","slug":"/docs/index.html","kicker":"START","snip":""},{"title":"Quickstart","slug":"/docs/quickstart.html","kicker":"START","snip":""},{"title":"Install","slug":"/docs/install.html","kicker":"START","snip":""},{"title":"Migrate from ES","slug":"/docs/migration-from-es.html","kicker":"START","snip":""},{"title":"CLI","slug":"/docs/cli.html","kicker":"REFERENCE","snip":""},{"title":"Config TOML","slug":"/docs/config.html","kicker":"REFERENCE","snip":""},{"title":"Environment","slug":"/docs/env.html","kicker":"REFERENCE","snip":""},{"title":"Native REST API","slug":"/docs/api-native.html","kicker":"REFERENCE","snip":""},{"title":"ES-compat API","slug":"/docs/api-es-compat.html","kicker":"REFERENCE","snip":""},{"title":"Query types","slug":"/docs/queries.html","kicker":"DATA MODEL","snip":""},{"title":"Aggregations","slug":"/docs/aggregations.html","kicker":"DATA MODEL","snip":""},{"title":"Analyzers","slug":"/docs/analyzers.html","kicker":"DATA MODEL","snip":""},{"title":"Vectors & kNN","slug":"/docs/vectors.html","kicker":"DATA MODEL","snip":""},{"title":"Ingest pipelines","slug":"/docs/ingest.html","kicker":"ENGINE","snip":""},{"title":"Storage & WAL","slug":"/docs/storage.html","kicker":"ENGINE","snip":""},{"title":"Compression","slug":"/docs/compression.html","kicker":"ENGINE","snip":""},{"title":"Clustering","slug":"/docs/clustering.html","kicker":"ENGINE","snip":""},{"title":"Metrics","slug":"/docs/metrics.html","kicker":"ENGINE","snip":""},{"title":"Auth & TLS","slug":"/docs/security.html","kicker":"ENGINE","snip":""},{"title":"Running in production","slug":"/docs/operations.html","kicker":"OPERATIONS","snip":""},{"title":"Backup & restore","slug":"/docs/backup-restore.html","kicker":"OPERATIONS","snip":""},{"title":"Upgrades","slug":"/docs/upgrades.html","kicker":"OPERATIONS","snip":""},{"title":"Troubleshooting","slug":"/docs/troubleshooting.html","kicker":"OPERATIONS","snip":""},{"title":"SIEM","slug":"/docs/playbooks/siem.html","kicker":"PLAYBOOKS","snip":""},{"title":"Log analytics","slug":"/docs/playbooks/log-analytics.html","kicker":"PLAYBOOKS","snip":""},{"title":"Vector · RAG","slug":"/docs/playbooks/vector-search.html","kicker":"PLAYBOOKS","snip":""},{"title":"Full-text search","slug":"/docs/playbooks/full-text.html","kicker":"PLAYBOOKS","snip":""},{"title":"Observability","slug":"/docs/playbooks/observability.html","kicker":"PLAYBOOKS","snip":""},{"title":"CLI · --config","slug":"/docs/cli.html#config-flag","kicker":"CLI","snip":"-c, --config <PATH> Path to the TOML config file."},{"title":"CLI · --data-dir","slug":"/docs/cli.html#data-dir-flag","kicker":"CLI","snip":"-d, --data-dir <PATH> Override [server] data_dir at the command line."},{"title":"CLI · --insecure","slug":"/docs/cli.html#insecure-flag","kicker":"CLI","snip":"-k, --insecure Disable TLS and API-key auth. Dev only."},{"title":"[server] rest_port","slug":"/docs/config.html#server","kicker":"CONFIG","snip":"u16 · default 8080 · Native REST API listener port."},{"title":"[server] es_compat_port","slug":"/docs/config.html#server","kicker":"CONFIG","snip":"u16 · default 9200 · Elasticsearch-wire-format port. 0 to disable."},{"title":"[storage] wal_sync","slug":"/docs/config.html#storage","kicker":"CONFIG","snip":"enum · default batched · sync · batched · async. Durability knob."},{"title":"[vector] hnsw_ef_search","slug":"/docs/config.html#vector","kicker":"CONFIG","snip":"u32 · default 100 · Accepted but not wired — the beam width comes from the request num_candidates."},{"title":"[vector] default_quantization","slug":"/docs/config.html#vector","kicker":"CONFIG","snip":"enum · none (default) · scalar8. binary is refused at startup; scalar4 is not accepted."},{"title":"GET /v1/health","slug":"/docs/api-native.html#health","kicker":"NATIVE API","snip":"Liveness + readiness. {status, uptime_s, version}."},{"title":"GET /v1/metrics","slug":"/docs/api-native.html#metrics","kicker":"NATIVE API","snip":"Prometheus text format. Scrape-friendly."},{"title":"POST /v1/indices/:name/turbo-ingest","slug":"/docs/api-native.html#turbo-ingest","kicker":"NATIVE API","snip":"NDJSON bulk path with parallel tokenization."},{"title":"POST /v1/indices/:name/search","slug":"/docs/api-native.html#search","kicker":"NATIVE API","snip":"Unified query endpoint — full-text, term, range, KNN, hybrid."},{"title":"POST /:index/_bulk","slug":"/docs/api-es-compat.html#bulk","kicker":"ES API","snip":"NDJSON bulk. Actions: index, create, update, delete."},{"title":"POST /:index/_search","slug":"/docs/api-es-compat.html#search","kicker":"ES API","snip":"ES query DSL. Drop-in migration path."},{"title":"match_all","slug":"/docs/queries.html#match-all","kicker":"QUERY","snip":"Everything in the index."},{"title":"bool","slug":"/docs/queries.html#bool","kicker":"QUERY","snip":"must / should / must_not / filter clauses."},{"title":"knn","slug":"/docs/queries.html#knn","kicker":"QUERY","snip":"Vector kNN — HNSW-served when unfiltered (exact-rescored); filtered runs the exact scan."},{"title":"semantic","slug":"/docs/queries.html#semantic","kicker":"QUERY","snip":"Embed the query text at query time and search the vector field."},{"title":"hybrid","slug":"/docs/queries.html#hybrid","kicker":"QUERY","snip":"RRF / linear fusion of sub-queries."},{"title":"terms aggregation","slug":"/docs/aggregations.html#terms","kicker":"AGG","snip":"Exact, pre-computed terms histograms over keyword fields."},{"title":"date_histogram","slug":"/docs/aggregations.html#date-histogram","kicker":"AGG","snip":"Time-bucketed counts."},{"title":"kNN serving","slug":"/docs/vectors.html#knn-query","kicker":"VECTORS","snip":"Unfiltered kNN via persisted HNSW + exact rescore; filtered kNN exact scan."},{"title":"SQ8 quantization","slug":"/docs/vectors.html#quantization","kicker":"VECTORS","snip":"8-bit scalar quantization. 4× memory reduction."},{"title":"turbo-ingest","slug":"/docs/ingest.html#turbo","kicker":"INGEST","snip":"NDJSON bulk path. Parallel tokenization across cores."},{"title":"delta-of-delta","slug":"/docs/compression.html#delta-of-delta","kicker":"COMPRESSION","snip":"Timestamp encoding. Apache/Nginx/ISO auto-detect."},{"title":"dictionary encoding","slug":"/docs/compression.html#dictionary","kicker":"COMPRESSION","snip":"Up to 256 unique strings per column."},{"title":"api_key","slug":"/docs/security.html#api-key","kicker":"SECURITY","snip":"Static admin key. Auto-generated on first run."},{"title":"SIEM playbook","slug":"/docs/playbooks/siem.html","kicker":"PLAYBOOK","snip":"Terms agg over source IPs for SIEM, with detection rules."},{"title":"RAG playbook","slug":"/docs/playbooks/vector-search.html","kicker":"PLAYBOOK","snip":"Embeddings, kNN, hybrid search, BM25 + kNN fusion."},{"title":"[cluster] enabled","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"bool · default false · Enable multi-node Raft cluster mode."},{"title":"[cluster] peers","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"array · \"node_id=host:port\" · At least one peer per node."},{"title":"[cluster] port","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"u16 · default 9300 · Intra-cluster Raft + search port."},{"title":"[embedding] default_endpoint","slug":"/docs/config.html#embedding","kicker":"CONFIG","snip":"string · OpenAI-compatible embeddings URL for auto-embedding on ingest."},{"title":"[embedding] default_model","slug":"/docs/config.html#embedding","kicker":"CONFIG","snip":"string · Model name (e.g. text-embedding-3-small, nomic-embed-text)."},{"title":"Raft","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"Embedded Raft — leader election, log replication, metadata only."},{"title":"Node draining","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"POST /v1/cluster/nodes/:id/drain before maintenance."},{"title":"Region split/merge","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"Range partitions auto-split at byte threshold, merge back when small."},{"title":"Systemd unit","slug":"/docs/operations.html","kicker":"OPS","snip":"Production unit file with hardening directives."},{"title":"Readiness probe","slug":"/docs/operations.html","kicker":"OPS","snip":"GET /v1/health/ready — only 200 once WAL replay is complete."},{"title":"Config reload","slug":"/docs/operations.html","kicker":"OPS","snip":"SIGHUP reloads most keys without restart."},{"title":"Hot backup","slug":"/docs/backup-restore.html","kicker":"OPS","snip":"rsync the data dir after POST /v1/admin/flush."},{"title":"S3 backup","slug":"/docs/backup-restore.html","kicker":"OPS","snip":"POST /v1/admin/backup → any S3-compatible endpoint."},{"title":"Rolling upgrade","slug":"/docs/upgrades.html","kicker":"OPS","snip":"Drain → stop → upgrade → start → activate, per node."},{"title":"Merge pressure","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"Segment count climbing → raise merge.max_concurrent + io_rate."},{"title":"Cluster flapping","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"Leader changes every few seconds → raise cluster.tick_ms."},{"title":"WAL replay failed","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"xerj verify --repair-wal truncates at last valid entry."},{"title":"Recipes","slug":"/docs/recipes/index.html","kicker":"RECIPES","snip":"Task-oriented AI & search recipes, each verified end-to-end against a live XERJ."},{"title":"Semantic search & RAG","slug":"/docs/recipes/semantic-search-rag.html","kicker":"RECIPE","snip":"Retrieval by meaning with semantic_text — auto-embed on ingest, no separate vector DB."},{"title":"Agent memory","slug":"/docs/recipes/agentic-memory.html","kicker":"RECIPE","snip":"Long-term memory for agents via /_memory — store, recall, forget, per-agent isolation."},{"title":"Passage retrieval","slug":"/docs/recipes/passage-retrieval.html","kicker":"RECIPE","snip":"Auto-chunk long docs; best-passage (max-sim) scoring — 98% top-3."},{"title":"Vector search · kNN","slug":"/docs/recipes/vector-search-knn.html","kicker":"RECIPE","snip":"Nearest-neighbor over dense_vector — exact brute-force — with filters."},{"title":"Vector quantization","slug":"/docs/recipes/vector-quantization.html","kicker":"RECIPE","snip":"int8_hnsw scalar8 — 4× smaller vectors, recall@10 ≈ 0.99."},{"title":"Hybrid search","slug":"/docs/recipes/hybrid-search.html","kicker":"RECIPE","snip":"Keyword + vector in one query — RRF fusion."},{"title":"Log analytics","slug":"/docs/recipes/log-analytics.html","kicker":"RECIPE","snip":"Raw logs to dashboards — error rates, p95 latency, top services."},{"title":"Anomaly detection","slug":"/docs/recipes/anomaly-detection.html","kicker":"RECIPE","snip":"Statistical _ml detectors that flag spikes in metrics/logs."},{"title":"Anomaly datafeeds","slug":"/docs/recipes/continuous-anomaly-datafeeds.html","kicker":"RECIPE","snip":"Live _ml datafeed re-scores an index on a timer, stores anomaly records."},{"title":"Migrate from ES","slug":"/docs/recipes/migrate-from-elasticsearch.html","kicker":"RECIPE","snip":"Point your existing ES client at XERJ — same wire, change the URL."},{"title":"For AI · Build with XERJ","slug":"/for-agents.html","kicker":"AI","snip":"The search, data & memory layer for AI agents — one binary on :9200."},{"title":"Agents · Overview","slug":"/docs/agents/index.html","kicker":"AI","snip":"The 6 canonical agent ops: search, semantic, vector, hybrid, memory store/recall."},{"title":"Agent quickstart","slug":"/docs/agents/quickstart.html","kicker":"AI","snip":"Boot XERJ, store a memory, recall by meaning, semantic search — runnable curl on :9200."},{"title":"Agent endpoints","slug":"/docs/agents/endpoints.html","kicker":"AI","snip":"Endpoint contract table: method, path, request body, response shape."},{"title":"xerj_memory_store","slug":"/docs/agents/endpoints.html#memory-store","kicker":"AGENT OP","snip":"POST /_memory/{ns} — store a memory (text auto-embedded, or bring your own vector)."},{"title":"xerj_memory_recall","slug":"/docs/agents/endpoints.html#memory-recall","kicker":"AGENT OP","snip":"POST /_memory/{ns}/_recall — recall top-k by meaning (semantic), keyword (BM25) or vector (kNN)."},{"title":"xerj_semantic_search","slug":"/docs/agents/endpoints.html#semantic","kicker":"AGENT OP","snip":"semantic query over a semantic_text field — the server embeds the query text."},{"title":"xerj_vector_search","slug":"/docs/agents/endpoints.html#vector","kicker":"AGENT OP","snip":"knn over dense_vector — exact nearest-neighbor at query time."},{"title":"xerj_hybrid_search","slug":"/docs/agents/endpoints.html#hybrid","kicker":"AGENT OP","snip":"hybrid query — fuse BM25 + vector with rrf or linear fusion."}]</script>+<script type="application/json" id="docs-index">[{"title":"Overview","slug":"/docs/index.html","kicker":"START","snip":""},{"title":"Quickstart","slug":"/docs/quickstart.html","kicker":"START","snip":""},{"title":"Install","slug":"/docs/install.html","kicker":"START","snip":""},{"title":"Migrate from ES","slug":"/docs/migration-from-es.html","kicker":"START","snip":""},{"title":"CLI","slug":"/docs/cli.html","kicker":"REFERENCE","snip":""},{"title":"Config TOML","slug":"/docs/config.html","kicker":"REFERENCE","snip":""},{"title":"Environment","slug":"/docs/env.html","kicker":"REFERENCE","snip":""},{"title":"Native REST API","slug":"/docs/api-native.html","kicker":"REFERENCE","snip":""},{"title":"ES-compat API","slug":"/docs/api-es-compat.html","kicker":"REFERENCE","snip":""},{"title":"Query types","slug":"/docs/queries.html","kicker":"DATA MODEL","snip":""},{"title":"Aggregations","slug":"/docs/aggregations.html","kicker":"DATA MODEL","snip":""},{"title":"Analyzers","slug":"/docs/analyzers.html","kicker":"DATA MODEL","snip":""},{"title":"Vectors & kNN","slug":"/docs/vectors.html","kicker":"DATA MODEL","snip":""},{"title":"Ingest pipelines","slug":"/docs/ingest.html","kicker":"ENGINE","snip":""},{"title":"Storage & WAL","slug":"/docs/storage.html","kicker":"ENGINE","snip":""},{"title":"Compression","slug":"/docs/compression.html","kicker":"ENGINE","snip":""},{"title":"Clustering","slug":"/docs/clustering.html","kicker":"ENGINE","snip":""},{"title":"Metrics","slug":"/docs/metrics.html","kicker":"ENGINE","snip":""},{"title":"Auth & TLS","slug":"/docs/security.html","kicker":"ENGINE","snip":""},{"title":"Running in production","slug":"/docs/operations.html","kicker":"OPERATIONS","snip":""},{"title":"Backup & restore","slug":"/docs/backup-restore.html","kicker":"OPERATIONS","snip":""},{"title":"Upgrades","slug":"/docs/upgrades.html","kicker":"OPERATIONS","snip":""},{"title":"Troubleshooting","slug":"/docs/troubleshooting.html","kicker":"OPERATIONS","snip":""},{"title":"SIEM","slug":"/docs/playbooks/siem.html","kicker":"PLAYBOOKS","snip":""},{"title":"Log analytics","slug":"/docs/playbooks/log-analytics.html","kicker":"PLAYBOOKS","snip":""},{"title":"Vector · RAG","slug":"/docs/playbooks/vector-search.html","kicker":"PLAYBOOKS","snip":""},{"title":"Full-text search","slug":"/docs/playbooks/full-text.html","kicker":"PLAYBOOKS","snip":""},{"title":"Observability","slug":"/docs/playbooks/observability.html","kicker":"PLAYBOOKS","snip":""},{"title":"CLI · --config","slug":"/docs/cli.html#config-flag","kicker":"CLI","snip":"-c, --config <PATH> Path to the TOML config file."},{"title":"CLI · --data-dir","slug":"/docs/cli.html#data-dir-flag","kicker":"CLI","snip":"-d, --data-dir <PATH> Override [server] data_dir at the command line."},{"title":"CLI · --insecure","slug":"/docs/cli.html#insecure-flag","kicker":"CLI","snip":"-k, --insecure Disable TLS and API-key auth. Dev only."},{"title":"[server] rest_port","slug":"/docs/config.html#server","kicker":"CONFIG","snip":"u16 · default 8080 · Native REST API listener port."},{"title":"[server] es_compat_port","slug":"/docs/config.html#server","kicker":"CONFIG","snip":"u16 · default 9200 · Elasticsearch-wire-format port. 0 to disable."},{"title":"[storage] wal_sync","slug":"/docs/config.html#storage","kicker":"CONFIG","snip":"enum · default batched · sync · batched · async. Durability knob."},{"title":"[vector] hnsw_ef_search","slug":"/docs/config.html#vector","kicker":"CONFIG","snip":"u32 · default 100 · Accepted but not wired — the beam width comes from the request num_candidates."},{"title":"[vector] default_quantization","slug":"/docs/config.html#vector","kicker":"CONFIG","snip":"enum · none (default) · scalar8. binary is refused at startup; scalar4 is not accepted."},{"title":"GET /v1/health","slug":"/docs/api-native.html#health","kicker":"NATIVE API","snip":"Liveness + readiness. {status, uptime_s, version}."},{"title":"GET /v1/metrics","slug":"/docs/api-native.html#metrics","kicker":"NATIVE API","snip":"Prometheus text format. Scrape-friendly."},{"title":"POST /v1/indices/:name/turbo-ingest","slug":"/docs/api-native.html#turbo-ingest","kicker":"NATIVE API","snip":"NDJSON bulk path with parallel tokenization."},{"title":"POST /v1/indices/:name/search","slug":"/docs/api-native.html#search","kicker":"NATIVE API","snip":"Unified query endpoint — full-text, term, range, KNN, hybrid."},{"title":"POST /:index/_bulk","slug":"/docs/api-es-compat.html#bulk","kicker":"ES API","snip":"NDJSON bulk. Actions: index, create, update, delete."},{"title":"POST /:index/_search","slug":"/docs/api-es-compat.html#search","kicker":"ES API","snip":"ES query DSL. Drop-in migration path."},{"title":"match_all","slug":"/docs/queries.html#match-all","kicker":"QUERY","snip":"Everything in the index."},{"title":"bool","slug":"/docs/queries.html#bool","kicker":"QUERY","snip":"must / should / must_not / filter clauses."},{"title":"knn","slug":"/docs/queries.html#knn","kicker":"QUERY","snip":"Vector kNN — HNSW-served when unfiltered (exact-rescored); filtered runs the exact scan."},{"title":"semantic","slug":"/docs/queries.html#semantic","kicker":"QUERY","snip":"Embed the query text at query time and search the vector field."},{"title":"hybrid","slug":"/docs/queries.html#hybrid","kicker":"QUERY","snip":"RRF / linear fusion of sub-queries."},{"title":"terms aggregation","slug":"/docs/aggregations.html#terms","kicker":"AGG","snip":"Exact, pre-computed terms histograms over keyword fields."},{"title":"date_histogram","slug":"/docs/aggregations.html#date-histogram","kicker":"AGG","snip":"Time-bucketed counts."},{"title":"kNN serving","slug":"/docs/vectors.html#knn-query","kicker":"VECTORS","snip":"Unfiltered kNN via persisted HNSW + exact rescore; filtered kNN exact scan."},{"title":"SQ8 quantization","slug":"/docs/vectors.html#quantization","kicker":"VECTORS","snip":"8-bit scalar quantization. 4× memory reduction."},{"title":"turbo-ingest","slug":"/docs/ingest.html#turbo","kicker":"INGEST","snip":"NDJSON bulk path. Parallel tokenization across cores."},{"title":"delta-of-delta","slug":"/docs/compression.html#delta-of-delta","kicker":"COMPRESSION","snip":"Timestamp encoding. Apache/Nginx/ISO auto-detect."},{"title":"dictionary encoding","slug":"/docs/compression.html#dictionary","kicker":"COMPRESSION","snip":"Up to 256 unique strings per column."},{"title":"api_key","slug":"/docs/security.html#api-key","kicker":"SECURITY","snip":"Static admin key. Auto-generated on first run."},{"title":"SIEM playbook","slug":"/docs/playbooks/siem.html","kicker":"PLAYBOOK","snip":"Terms agg over source IPs for SIEM, with detection rules."},{"title":"RAG playbook","slug":"/docs/playbooks/vector-search.html","kicker":"PLAYBOOK","snip":"Embeddings, kNN, hybrid search, BM25 + kNN fusion."},{"title":"[cluster] enabled","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"bool · default false · Enable multi-node Raft cluster mode."},{"title":"[cluster] peers","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"array · \"node_id=host:port\" · At least one peer per node."},{"title":"[cluster] port","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"u16 · default 9300 · Intra-cluster Raft + search port."},{"title":"[embedding] default_endpoint","slug":"/docs/config.html#embedding","kicker":"CONFIG","snip":"string · OpenAI-compatible embeddings URL for auto-embedding on ingest."},{"title":"[embedding] default_model","slug":"/docs/config.html#embedding","kicker":"CONFIG","snip":"string · Model name (e.g. text-embedding-3-small, nomic-embed-text)."},{"title":"Raft","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"Embedded Raft — leader election, log replication, metadata only."},{"title":"Node draining","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"POST /v1/cluster/nodes/:id/drain before maintenance."},{"title":"Region split/merge","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"Range partitions auto-split at byte threshold, merge back when small."},{"title":"Systemd unit","slug":"/docs/operations.html","kicker":"OPS","snip":"Production unit file with hardening directives."},{"title":"Readiness probe","slug":"/docs/operations.html","kicker":"OPS","snip":"GET /v1/health/ready — only 200 once WAL replay is complete."},{"title":"Config reload","slug":"/docs/operations.html","kicker":"OPS","snip":"SIGHUP reloads most keys without restart."},{"title":"Hot backup","slug":"/docs/backup-restore.html","kicker":"OPS","snip":"rsync the data dir after POST /v1/admin/flush."},{"title":"S3 backup","slug":"/docs/backup-restore.html","kicker":"OPS","snip":"POST /v1/admin/backup → any S3-compatible endpoint."},{"title":"Rolling upgrade","slug":"/docs/upgrades.html","kicker":"OPS","snip":"Drain → stop → upgrade → start → activate, per node."},{"title":"Merge pressure","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"Segment count climbing → raise merge.max_concurrent + io_rate."},{"title":"Cluster flapping","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"Leader changes every few seconds → raise cluster.tick_ms."},{"title":"WAL replay failed","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"xerj verify --repair-wal truncates at last valid entry."},{"title":"Recipes","slug":"/docs/recipes/index.html","kicker":"RECIPES","snip":"Task-oriented AI & search recipes, each verified end-to-end against a live XERJ."},{"title":"Semantic search & RAG","slug":"/docs/recipes/semantic-search-rag.html","kicker":"RECIPE","snip":"Retrieval by meaning with semantic_text — auto-embed on ingest, no separate vector DB."},{"title":"Agent memory","slug":"/docs/recipes/agentic-memory.html","kicker":"RECIPE","snip":"Long-term memory for agents via /_memory — store, recall, forget, per-agent isolation."},{"title":"Passage retrieval","slug":"/docs/recipes/passage-retrieval.html","kicker":"RECIPE","snip":"Auto-chunk long docs; best-passage (max-sim) scoring — 98% top-3."},{"title":"Vector search · kNN","slug":"/docs/recipes/vector-search-knn.html","kicker":"RECIPE","snip":"Nearest-neighbor over dense_vector — HNSW-served unfiltered, exact with filters."},{"title":"Vector quantization","slug":"/docs/recipes/vector-quantization.html","kicker":"RECIPE","snip":"scalar8 (accepts ES int8_hnsw; exact code scan) — 4× smaller vectors, recall@10 ≈ 0.99."},{"title":"Hybrid search","slug":"/docs/recipes/hybrid-search.html","kicker":"RECIPE","snip":"Keyword + vector in one query — RRF fusion."},{"title":"Log analytics","slug":"/docs/recipes/log-analytics.html","kicker":"RECIPE","snip":"Raw logs to dashboards — error rates, p95 latency, top services."},{"title":"Anomaly detection","slug":"/docs/recipes/anomaly-detection.html","kicker":"RECIPE","snip":"Statistical _ml detectors that flag spikes in metrics/logs."},{"title":"Anomaly datafeeds","slug":"/docs/recipes/continuous-anomaly-datafeeds.html","kicker":"RECIPE","snip":"Live _ml datafeed re-scores an index on a timer, stores anomaly records."},{"title":"Migrate from ES","slug":"/docs/recipes/migrate-from-elasticsearch.html","kicker":"RECIPE","snip":"Point your existing ES client at XERJ — same wire, change the URL."},{"title":"For AI · Build with XERJ","slug":"/for-agents.html","kicker":"AI","snip":"The search, data & memory layer for AI agents — one binary on :9200."},{"title":"Agents · Overview","slug":"/docs/agents/index.html","kicker":"AI","snip":"The 7 canonical agent ops: autoindex (CLI-only), search, semantic, vector, hybrid, memory store/recall."},{"title":"Agent quickstart","slug":"/docs/agents/quickstart.html","kicker":"AI","snip":"Boot XERJ, store a memory, recall by meaning, semantic search — runnable curl on :9200."},{"title":"Agent endpoints","slug":"/docs/agents/endpoints.html","kicker":"AI","snip":"Endpoint contract table: method, path, request body, response shape."},{"title":"xerj_memory_store","slug":"/docs/agents/endpoints.html#memory-store","kicker":"AGENT OP","snip":"POST /_memory/{ns} — store a memory (text auto-embedded, or bring your own vector)."},{"title":"xerj_memory_recall","slug":"/docs/agents/endpoints.html#memory-recall","kicker":"AGENT OP","snip":"POST /_memory/{ns}/_recall — recall top-k by meaning (semantic), keyword (BM25) or vector (kNN)."},{"title":"xerj_semantic_search","slug":"/docs/agents/endpoints.html#semantic","kicker":"AGENT OP","snip":"semantic query over a semantic_text field — the server embeds the query text."},{"title":"xerj_autoindex","slug":"/docs/recipes/zero-config-autoindex.html","kicker":"AGENT OP","snip":"xerj autoindex <folder> — CLI-only, no HTTP route: content-sniffed formats, inferred mappings, self-describing catalog."},{"title":"xerj_vector_search","slug":"/docs/agents/endpoints.html#vector","kicker":"AGENT OP","snip":"knn over dense_vector — HNSW-served when unfiltered (exact-rescored), exact scan when filtered."},{"title":"xerj_hybrid_search","slug":"/docs/agents/endpoints.html#hybrid","kicker":"AGENT OP","snip":"hybrid query — fuse BM25 + vector with rrf or linear fusion."}]</script><script>// IIFE — js-auth navigates between decrypted pages in the samediff --git a/landing/docs/agents/quickstart.html b/landing/docs/agents/quickstart.htmlindex 607851a17..412fade55 100644--- a/landing/docs/agents/quickstart.html+++ b/landing/docs/agents/quickstart.html@@ -114,10 +114,13 @@<p>Five steps, all runnable, all on port <code class="inline">9200</code>: <strong>boot XERJ → check it is up → store a memory → recall it by meaning → run a semantic search.</strong> Every request and every response below is a real run against a freshly booted, empty XERJ — no seeding, no external embedding service, no API key. If you have <code class="inline">curl</code>, you have everything.</p><h2>0 · Boot XERJ</h2>- <p>One binary. <code class="inline">--insecure</code> disables TLS and API-key auth so you can talk to it over plain HTTP on the default ES-compat port <code class="inline">9200</code> — perfect for a local agent loop.</p>-<pre class="code"># from a release build (see /docs/install.html for downloads)-$ ./engine/target/release/xerj --insecure --data-dir /tmp/xerj-agent &</pre>- <p>New to XERJ? The <a href="/docs/install.html">install page</a> has one-line downloads for every platform.</p>+ <p>One binary. <code class="inline">--insecure</code> disables TLS and API-key auth so you can talk to it over plain HTTP on the default ES-compat port <code class="inline">9200</code> — perfect for a local agent loop. Install it first (<code class="inline">curl -fsSL https://xerj.org/get | sh</code>), which puts <code class="inline">xerj</code> in <code class="inline">~/.local/bin</code> by default and prints the exact path if that is not on your <code class="inline">PATH</code>.</p>+<pre class="code"># start it in the background — a foreground boot blocks the rest of this page+$ xerj --insecure --data-dir /tmp/xerj-agent &++# then WAIT for it: an agent that fires the next request immediately gets a connection refused+$ until curl -sf localhost:9200/_cluster/health >/dev/null; do sleep 0.3; done</pre>+ <p>Keep the data dir <strong>outside</strong> any folder you intend to index later — pointing <code class="inline">xerj autoindex</code> at a tree that contains the node's own storage indexes the engine's files. New to XERJ? The <a href="/docs/install.html">install page</a> has one-line downloads for every platform, and the <a href="/docs/recipes/zero-config-autoindex.html">zero-config indexing recipe</a> is the next step after this page.</p><h2>1 · Confirm it is up</h2><p>The root path returns the ES-style info document. Any Elasticsearch client uses this as its handshake — which is exactly why an off-the-shelf ES client library points at XERJ unchanged.</p>@@ -200,7 +203,7 @@ $ curl -sXPOST localhost:9200/notes/_refresh</pre><p>The <code class="inline">"Configuring TLS certificates"</code> note is correctly excluded. Filter <code class="inline">_source</code> to the fields you want — the auto-generated companion embedding lives in a <code class="inline">body_vector</code> field and is otherwise part of <code class="inline">_source</code>, so scoping it keeps responses small.</p><h2>Going further — vector & hybrid</h2>- <p>If you already have embeddings, add a <code class="inline">dense_vector</code> field and run exact <code class="inline">knn</code>; to combine keyword and vector recall in a single call, use a <code class="inline">hybrid</code> query with <code class="inline">rrf</code> fusion. Both are shown, with response shapes, on the <a href="/docs/agents/endpoints.html">endpoint contract</a>. For worked, end-to-end walkthroughs see the recipes: <a href="/docs/recipes/agentic-memory.html">agent memory</a>, <a href="/docs/recipes/semantic-search-rag.html">semantic search & RAG</a>, <a href="/docs/recipes/hybrid-search.html">hybrid search</a>.</p>+ <p>If you already have embeddings, add a <code class="inline">dense_vector</code> field and run <code class="inline">knn</code> — HNSW-served with exact rescoring when unfiltered, an exact scan when filtered or on a small index; to combine keyword and vector recall in a single call, use a <code class="inline">hybrid</code> query with <code class="inline">rrf</code> fusion. Both are shown, with response shapes, on the <a href="/docs/agents/endpoints.html">endpoint contract</a>. For worked, end-to-end walkthroughs see the recipes: <a href="/docs/recipes/agentic-memory.html">agent memory</a>, <a href="/docs/recipes/semantic-search-rag.html">semantic search & RAG</a>, <a href="/docs/recipes/hybrid-search.html">hybrid search</a>.</p><h2>Clean up</h2><p>Drop the memory namespace and the demo index when you are done:</p>@@ -225,12 +228,12 @@ $ curl -sXDELETE localhost:9200/notes</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>-<script type="application/json" id="docs-index">[{"title":"Overview","slug":"/docs/index.html","kicker":"START","snip":""},{"title":"Quickstart","slug":"/docs/quickstart.html","kicker":"START","snip":""},{"title":"Install","slug":"/docs/install.html","kicker":"START","snip":""},{"title":"Migrate from ES","slug":"/docs/migration-from-es.html","kicker":"START","snip":""},{"title":"CLI","slug":"/docs/cli.html","kicker":"REFERENCE","snip":""},{"title":"Config TOML","slug":"/docs/config.html","kicker":"REFERENCE","snip":""},{"title":"Environment","slug":"/docs/env.html","kicker":"REFERENCE","snip":""},{"title":"Native REST API","slug":"/docs/api-native.html","kicker":"REFERENCE","snip":""},{"title":"ES-compat API","slug":"/docs/api-es-compat.html","kicker":"REFERENCE","snip":""},{"title":"Query types","slug":"/docs/queries.html","kicker":"DATA MODEL","snip":""},{"title":"Aggregations","slug":"/docs/aggregations.html","kicker":"DATA MODEL","snip":""},{"title":"Analyzers","slug":"/docs/analyzers.html","kicker":"DATA MODEL","snip":""},{"title":"Vectors & kNN","slug":"/docs/vectors.html","kicker":"DATA MODEL","snip":""},{"title":"Ingest pipelines","slug":"/docs/ingest.html","kicker":"ENGINE","snip":""},{"title":"Storage & WAL","slug":"/docs/storage.html","kicker":"ENGINE","snip":""},{"title":"Compression","slug":"/docs/compression.html","kicker":"ENGINE","snip":""},{"title":"Clustering","slug":"/docs/clustering.html","kicker":"ENGINE","snip":""},{"title":"Metrics","slug":"/docs/metrics.html","kicker":"ENGINE","snip":""},{"title":"Auth & TLS","slug":"/docs/security.html","kicker":"ENGINE","snip":""},{"title":"Running in production","slug":"/docs/operations.html","kicker":"OPERATIONS","snip":""},{"title":"Backup & restore","slug":"/docs/backup-restore.html","kicker":"OPERATIONS","snip":""},{"title":"Upgrades","slug":"/docs/upgrades.html","kicker":"OPERATIONS","snip":""},{"title":"Troubleshooting","slug":"/docs/troubleshooting.html","kicker":"OPERATIONS","snip":""},{"title":"SIEM","slug":"/docs/playbooks/siem.html","kicker":"PLAYBOOKS","snip":""},{"title":"Log analytics","slug":"/docs/playbooks/log-analytics.html","kicker":"PLAYBOOKS","snip":""},{"title":"Vector · RAG","slug":"/docs/playbooks/vector-search.html","kicker":"PLAYBOOKS","snip":""},{"title":"Full-text search","slug":"/docs/playbooks/full-text.html","kicker":"PLAYBOOKS","snip":""},{"title":"Observability","slug":"/docs/playbooks/observability.html","kicker":"PLAYBOOKS","snip":""},{"title":"CLI · --config","slug":"/docs/cli.html#config-flag","kicker":"CLI","snip":"-c, --config <PATH> Path to the TOML config file."},{"title":"CLI · --data-dir","slug":"/docs/cli.html#data-dir-flag","kicker":"CLI","snip":"-d, --data-dir <PATH> Override [server] data_dir at the command line."},{"title":"CLI · --insecure","slug":"/docs/cli.html#insecure-flag","kicker":"CLI","snip":"-k, --insecure Disable TLS and API-key auth. Dev only."},{"title":"[server] rest_port","slug":"/docs/config.html#server","kicker":"CONFIG","snip":"u16 · default 8080 · Native REST API listener port."},{"title":"[server] es_compat_port","slug":"/docs/config.html#server","kicker":"CONFIG","snip":"u16 · default 9200 · Elasticsearch-wire-format port. 0 to disable."},{"title":"[storage] wal_sync","slug":"/docs/config.html#storage","kicker":"CONFIG","snip":"enum · default batched · sync · batched · async. Durability knob."},{"title":"[vector] hnsw_ef_search","slug":"/docs/config.html#vector","kicker":"CONFIG","snip":"u32 · default 100 · Accepted but not wired — the beam width comes from the request num_candidates."},{"title":"[vector] default_quantization","slug":"/docs/config.html#vector","kicker":"CONFIG","snip":"enum · none (default) · scalar8. binary is refused at startup; scalar4 is not accepted."},{"title":"GET /v1/health","slug":"/docs/api-native.html#health","kicker":"NATIVE API","snip":"Liveness + readiness. {status, uptime_s, version}."},{"title":"GET /v1/metrics","slug":"/docs/api-native.html#metrics","kicker":"NATIVE API","snip":"Prometheus text format. Scrape-friendly."},{"title":"POST /v1/indices/:name/turbo-ingest","slug":"/docs/api-native.html#turbo-ingest","kicker":"NATIVE API","snip":"NDJSON bulk path with parallel tokenization."},{"title":"POST /v1/indices/:name/search","slug":"/docs/api-native.html#search","kicker":"NATIVE API","snip":"Unified query endpoint — full-text, term, range, KNN, hybrid."},{"title":"POST /:index/_bulk","slug":"/docs/api-es-compat.html#bulk","kicker":"ES API","snip":"NDJSON bulk. Actions: index, create, update, delete."},{"title":"POST /:index/_search","slug":"/docs/api-es-compat.html#search","kicker":"ES API","snip":"ES query DSL. Drop-in migration path."},{"title":"match_all","slug":"/docs/queries.html#match-all","kicker":"QUERY","snip":"Everything in the index."},{"title":"bool","slug":"/docs/queries.html#bool","kicker":"QUERY","snip":"must / should / must_not / filter clauses."},{"title":"knn","slug":"/docs/queries.html#knn","kicker":"QUERY","snip":"Vector kNN — HNSW-served when unfiltered (exact-rescored); filtered runs the exact scan."},{"title":"semantic","slug":"/docs/queries.html#semantic","kicker":"QUERY","snip":"Embed the query text at query time and search the vector field."},{"title":"hybrid","slug":"/docs/queries.html#hybrid","kicker":"QUERY","snip":"RRF / linear fusion of sub-queries."},{"title":"terms aggregation","slug":"/docs/aggregations.html#terms","kicker":"AGG","snip":"Exact, pre-computed terms histograms over keyword fields."},{"title":"date_histogram","slug":"/docs/aggregations.html#date-histogram","kicker":"AGG","snip":"Time-bucketed counts."},{"title":"kNN serving","slug":"/docs/vectors.html#knn-query","kicker":"VECTORS","snip":"Unfiltered kNN via persisted HNSW + exact rescore; filtered kNN exact scan."},{"title":"SQ8 quantization","slug":"/docs/vectors.html#quantization","kicker":"VECTORS","snip":"8-bit scalar quantization. 4× memory reduction."},{"title":"turbo-ingest","slug":"/docs/ingest.html#turbo","kicker":"INGEST","snip":"NDJSON bulk path. Parallel tokenization across cores."},{"title":"delta-of-delta","slug":"/docs/compression.html#delta-of-delta","kicker":"COMPRESSION","snip":"Timestamp encoding. Apache/Nginx/ISO auto-detect."},{"title":"dictionary encoding","slug":"/docs/compression.html#dictionary","kicker":"COMPRESSION","snip":"Up to 256 unique strings per column."},{"title":"api_key","slug":"/docs/security.html#api-key","kicker":"SECURITY","snip":"Static admin key. Auto-generated on first run."},{"title":"SIEM playbook","slug":"/docs/playbooks/siem.html","kicker":"PLAYBOOK","snip":"Terms agg over source IPs for SIEM, with detection rules."},{"title":"RAG playbook","slug":"/docs/playbooks/vector-search.html","kicker":"PLAYBOOK","snip":"Embeddings, kNN, hybrid search, BM25 + kNN fusion."},{"title":"[cluster] enabled","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"bool · default false · Enable multi-node Raft cluster mode."},{"title":"[cluster] peers","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"array · \"node_id=host:port\" · At least one peer per node."},{"title":"[cluster] port","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"u16 · default 9300 · Intra-cluster Raft + search port."},{"title":"[embedding] default_endpoint","slug":"/docs/config.html#embedding","kicker":"CONFIG","snip":"string · OpenAI-compatible embeddings URL for auto-embedding on ingest."},{"title":"[embedding] default_model","slug":"/docs/config.html#embedding","kicker":"CONFIG","snip":"string · Model name (e.g. text-embedding-3-small, nomic-embed-text)."},{"title":"Raft","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"Embedded Raft — leader election, log replication, metadata only."},{"title":"Node draining","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"POST /v1/cluster/nodes/:id/drain before maintenance."},{"title":"Region split/merge","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"Range partitions auto-split at byte threshold, merge back when small."},{"title":"Systemd unit","slug":"/docs/operations.html","kicker":"OPS","snip":"Production unit file with hardening directives."},{"title":"Readiness probe","slug":"/docs/operations.html","kicker":"OPS","snip":"GET /v1/health/ready — only 200 once WAL replay is complete."},{"title":"Config reload","slug":"/docs/operations.html","kicker":"OPS","snip":"SIGHUP reloads most keys without restart."},{"title":"Hot backup","slug":"/docs/backup-restore.html","kicker":"OPS","snip":"rsync the data dir after POST /v1/admin/flush."},{"title":"S3 backup","slug":"/docs/backup-restore.html","kicker":"OPS","snip":"POST /v1/admin/backup → any S3-compatible endpoint."},{"title":"Rolling upgrade","slug":"/docs/upgrades.html","kicker":"OPS","snip":"Drain → stop → upgrade → start → activate, per node."},{"title":"Merge pressure","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"Segment count climbing → raise merge.max_concurrent + io_rate."},{"title":"Cluster flapping","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"Leader changes every few seconds → raise cluster.tick_ms."},{"title":"WAL replay failed","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"xerj verify --repair-wal truncates at last valid entry."},{"title":"Recipes","slug":"/docs/recipes/index.html","kicker":"RECIPES","snip":"Task-oriented AI & search recipes, each verified end-to-end against a live XERJ."},{"title":"Semantic search & RAG","slug":"/docs/recipes/semantic-search-rag.html","kicker":"RECIPE","snip":"Retrieval by meaning with semantic_text — auto-embed on ingest, no separate vector DB."},{"title":"Agent memory","slug":"/docs/recipes/agentic-memory.html","kicker":"RECIPE","snip":"Long-term memory for agents via /_memory — store, recall, forget, per-agent isolation."},{"title":"Passage retrieval","slug":"/docs/recipes/passage-retrieval.html","kicker":"RECIPE","snip":"Auto-chunk long docs; best-passage (max-sim) scoring — 98% top-3."},{"title":"Vector search · kNN","slug":"/docs/recipes/vector-search-knn.html","kicker":"RECIPE","snip":"Nearest-neighbor over dense_vector — exact brute-force — with filters."},{"title":"Vector quantization","slug":"/docs/recipes/vector-quantization.html","kicker":"RECIPE","snip":"int8_hnsw scalar8 — 4× smaller vectors, recall@10 ≈ 0.99."},{"title":"Hybrid search","slug":"/docs/recipes/hybrid-search.html","kicker":"RECIPE","snip":"Keyword + vector in one query — RRF fusion."},{"title":"Log analytics","slug":"/docs/recipes/log-analytics.html","kicker":"RECIPE","snip":"Raw logs to dashboards — error rates, p95 latency, top services."},{"title":"Anomaly detection","slug":"/docs/recipes/anomaly-detection.html","kicker":"RECIPE","snip":"Statistical _ml detectors that flag spikes in metrics/logs."},{"title":"Anomaly datafeeds","slug":"/docs/recipes/continuous-anomaly-datafeeds.html","kicker":"RECIPE","snip":"Live _ml datafeed re-scores an index on a timer, stores anomaly records."},{"title":"Migrate from ES","slug":"/docs/recipes/migrate-from-elasticsearch.html","kicker":"RECIPE","snip":"Point your existing ES client at XERJ — same wire, change the URL."},{"title":"For AI · Build with XERJ","slug":"/for-agents.html","kicker":"AI","snip":"The search, data & memory layer for AI agents — one binary on :9200."},{"title":"Agents · Overview","slug":"/docs/agents/index.html","kicker":"AI","snip":"The 6 canonical agent ops: search, semantic, vector, hybrid, memory store/recall."},{"title":"Agent quickstart","slug":"/docs/agents/quickstart.html","kicker":"AI","snip":"Boot XERJ, store a memory, recall by meaning, semantic search — runnable curl on :9200."},{"title":"Agent endpoints","slug":"/docs/agents/endpoints.html","kicker":"AI","snip":"Endpoint contract table: method, path, request body, response shape."},{"title":"xerj_memory_store","slug":"/docs/agents/endpoints.html#memory-store","kicker":"AGENT OP","snip":"POST /_memory/{ns} — store a memory (text auto-embedded, or bring your own vector)."},{"title":"xerj_memory_recall","slug":"/docs/agents/endpoints.html#memory-recall","kicker":"AGENT OP","snip":"POST /_memory/{ns}/_recall — recall top-k by meaning (semantic), keyword (BM25) or vector (kNN)."},{"title":"xerj_semantic_search","slug":"/docs/agents/endpoints.html#semantic","kicker":"AGENT OP","snip":"semantic query over a semantic_text field — the server embeds the query text."},{"title":"xerj_vector_search","slug":"/docs/agents/endpoints.html#vector","kicker":"AGENT OP","snip":"knn over dense_vector — exact nearest-neighbor at query time."},{"title":"xerj_hybrid_search","slug":"/docs/agents/endpoints.html#hybrid","kicker":"AGENT OP","snip":"hybrid query — fuse BM25 + vector with rrf or linear fusion."}]</script>+<script type="application/json" id="docs-index">[{"title":"Overview","slug":"/docs/index.html","kicker":"START","snip":""},{"title":"Quickstart","slug":"/docs/quickstart.html","kicker":"START","snip":""},{"title":"Install","slug":"/docs/install.html","kicker":"START","snip":""},{"title":"Migrate from ES","slug":"/docs/migration-from-es.html","kicker":"START","snip":""},{"title":"CLI","slug":"/docs/cli.html","kicker":"REFERENCE","snip":""},{"title":"Config TOML","slug":"/docs/config.html","kicker":"REFERENCE","snip":""},{"title":"Environment","slug":"/docs/env.html","kicker":"REFERENCE","snip":""},{"title":"Native REST API","slug":"/docs/api-native.html","kicker":"REFERENCE","snip":""},{"title":"ES-compat API","slug":"/docs/api-es-compat.html","kicker":"REFERENCE","snip":""},{"title":"Query types","slug":"/docs/queries.html","kicker":"DATA MODEL","snip":""},{"title":"Aggregations","slug":"/docs/aggregations.html","kicker":"DATA MODEL","snip":""},{"title":"Analyzers","slug":"/docs/analyzers.html","kicker":"DATA MODEL","snip":""},{"title":"Vectors & kNN","slug":"/docs/vectors.html","kicker":"DATA MODEL","snip":""},{"title":"Ingest pipelines","slug":"/docs/ingest.html","kicker":"ENGINE","snip":""},{"title":"Storage & WAL","slug":"/docs/storage.html","kicker":"ENGINE","snip":""},{"title":"Compression","slug":"/docs/compression.html","kicker":"ENGINE","snip":""},{"title":"Clustering","slug":"/docs/clustering.html","kicker":"ENGINE","snip":""},{"title":"Metrics","slug":"/docs/metrics.html","kicker":"ENGINE","snip":""},{"title":"Auth & TLS","slug":"/docs/security.html","kicker":"ENGINE","snip":""},{"title":"Running in production","slug":"/docs/operations.html","kicker":"OPERATIONS","snip":""},{"title":"Backup & restore","slug":"/docs/backup-restore.html","kicker":"OPERATIONS","snip":""},{"title":"Upgrades","slug":"/docs/upgrades.html","kicker":"OPERATIONS","snip":""},{"title":"Troubleshooting","slug":"/docs/troubleshooting.html","kicker":"OPERATIONS","snip":""},{"title":"SIEM","slug":"/docs/playbooks/siem.html","kicker":"PLAYBOOKS","snip":""},{"title":"Log analytics","slug":"/docs/playbooks/log-analytics.html","kicker":"PLAYBOOKS","snip":""},{"title":"Vector · RAG","slug":"/docs/playbooks/vector-search.html","kicker":"PLAYBOOKS","snip":""},{"title":"Full-text search","slug":"/docs/playbooks/full-text.html","kicker":"PLAYBOOKS","snip":""},{"title":"Observability","slug":"/docs/playbooks/observability.html","kicker":"PLAYBOOKS","snip":""},{"title":"CLI · --config","slug":"/docs/cli.html#config-flag","kicker":"CLI","snip":"-c, --config <PATH> Path to the TOML config file."},{"title":"CLI · --data-dir","slug":"/docs/cli.html#data-dir-flag","kicker":"CLI","snip":"-d, --data-dir <PATH> Override [server] data_dir at the command line."},{"title":"CLI · --insecure","slug":"/docs/cli.html#insecure-flag","kicker":"CLI","snip":"-k, --insecure Disable TLS and API-key auth. Dev only."},{"title":"[server] rest_port","slug":"/docs/config.html#server","kicker":"CONFIG","snip":"u16 · default 8080 · Native REST API listener port."},{"title":"[server] es_compat_port","slug":"/docs/config.html#server","kicker":"CONFIG","snip":"u16 · default 9200 · Elasticsearch-wire-format port. 0 to disable."},{"title":"[storage] wal_sync","slug":"/docs/config.html#storage","kicker":"CONFIG","snip":"enum · default batched · sync · batched · async. Durability knob."},{"title":"[vector] hnsw_ef_search","slug":"/docs/config.html#vector","kicker":"CONFIG","snip":"u32 · default 100 · Accepted but not wired — the beam width comes from the request num_candidates."},{"title":"[vector] default_quantization","slug":"/docs/config.html#vector","kicker":"CONFIG","snip":"enum · none (default) · scalar8. binary is refused at startup; scalar4 is not accepted."},{"title":"GET /v1/health","slug":"/docs/api-native.html#health","kicker":"NATIVE API","snip":"Liveness + readiness. {status, uptime_s, version}."},{"title":"GET /v1/metrics","slug":"/docs/api-native.html#metrics","kicker":"NATIVE API","snip":"Prometheus text format. Scrape-friendly."},{"title":"POST /v1/indices/:name/turbo-ingest","slug":"/docs/api-native.html#turbo-ingest","kicker":"NATIVE API","snip":"NDJSON bulk path with parallel tokenization."},{"title":"POST /v1/indices/:name/search","slug":"/docs/api-native.html#search","kicker":"NATIVE API","snip":"Unified query endpoint — full-text, term, range, KNN, hybrid."},{"title":"POST /:index/_bulk","slug":"/docs/api-es-compat.html#bulk","kicker":"ES API","snip":"NDJSON bulk. Actions: index, create, update, delete."},{"title":"POST /:index/_search","slug":"/docs/api-es-compat.html#search","kicker":"ES API","snip":"ES query DSL. Drop-in migration path."},{"title":"match_all","slug":"/docs/queries.html#match-all","kicker":"QUERY","snip":"Everything in the index."},{"title":"bool","slug":"/docs/queries.html#bool","kicker":"QUERY","snip":"must / should / must_not / filter clauses."},{"title":"knn","slug":"/docs/queries.html#knn","kicker":"QUERY","snip":"Vector kNN — HNSW-served when unfiltered (exact-rescored); filtered runs the exact scan."},{"title":"semantic","slug":"/docs/queries.html#semantic","kicker":"QUERY","snip":"Embed the query text at query time and search the vector field."},{"title":"hybrid","slug":"/docs/queries.html#hybrid","kicker":"QUERY","snip":"RRF / linear fusion of sub-queries."},{"title":"terms aggregation","slug":"/docs/aggregations.html#terms","kicker":"AGG","snip":"Exact, pre-computed terms histograms over keyword fields."},{"title":"date_histogram","slug":"/docs/aggregations.html#date-histogram","kicker":"AGG","snip":"Time-bucketed counts."},{"title":"kNN serving","slug":"/docs/vectors.html#knn-query","kicker":"VECTORS","snip":"Unfiltered kNN via persisted HNSW + exact rescore; filtered kNN exact scan."},{"title":"SQ8 quantization","slug":"/docs/vectors.html#quantization","kicker":"VECTORS","snip":"8-bit scalar quantization. 4× memory reduction."},{"title":"turbo-ingest","slug":"/docs/ingest.html#turbo","kicker":"INGEST","snip":"NDJSON bulk path. Parallel tokenization across cores."},{"title":"delta-of-delta","slug":"/docs/compression.html#delta-of-delta","kicker":"COMPRESSION","snip":"Timestamp encoding. Apache/Nginx/ISO auto-detect."},{"title":"dictionary encoding","slug":"/docs/compression.html#dictionary","kicker":"COMPRESSION","snip":"Up to 256 unique strings per column."},{"title":"api_key","slug":"/docs/security.html#api-key","kicker":"SECURITY","snip":"Static admin key. Auto-generated on first run."},{"title":"SIEM playbook","slug":"/docs/playbooks/siem.html","kicker":"PLAYBOOK","snip":"Terms agg over source IPs for SIEM, with detection rules."},{"title":"RAG playbook","slug":"/docs/playbooks/vector-search.html","kicker":"PLAYBOOK","snip":"Embeddings, kNN, hybrid search, BM25 + kNN fusion."},{"title":"[cluster] enabled","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"bool · default false · Enable multi-node Raft cluster mode."},{"title":"[cluster] peers","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"array · \"node_id=host:port\" · At least one peer per node."},{"title":"[cluster] port","slug":"/docs/config.html#cluster","kicker":"CONFIG","snip":"u16 · default 9300 · Intra-cluster Raft + search port."},{"title":"[embedding] default_endpoint","slug":"/docs/config.html#embedding","kicker":"CONFIG","snip":"string · OpenAI-compatible embeddings URL for auto-embedding on ingest."},{"title":"[embedding] default_model","slug":"/docs/config.html#embedding","kicker":"CONFIG","snip":"string · Model name (e.g. text-embedding-3-small, nomic-embed-text)."},{"title":"Raft","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"Embedded Raft — leader election, log replication, metadata only."},{"title":"Node draining","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"POST /v1/cluster/nodes/:id/drain before maintenance."},{"title":"Region split/merge","slug":"/docs/clustering.html","kicker":"CLUSTER","snip":"Range partitions auto-split at byte threshold, merge back when small."},{"title":"Systemd unit","slug":"/docs/operations.html","kicker":"OPS","snip":"Production unit file with hardening directives."},{"title":"Readiness probe","slug":"/docs/operations.html","kicker":"OPS","snip":"GET /v1/health/ready — only 200 once WAL replay is complete."},{"title":"Config reload","slug":"/docs/operations.html","kicker":"OPS","snip":"SIGHUP reloads most keys without restart."},{"title":"Hot backup","slug":"/docs/backup-restore.html","kicker":"OPS","snip":"rsync the data dir after POST /v1/admin/flush."},{"title":"S3 backup","slug":"/docs/backup-restore.html","kicker":"OPS","snip":"POST /v1/admin/backup → any S3-compatible endpoint."},{"title":"Rolling upgrade","slug":"/docs/upgrades.html","kicker":"OPS","snip":"Drain → stop → upgrade → start → activate, per node."},{"title":"Merge pressure","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"Segment count climbing → raise merge.max_concurrent + io_rate."},{"title":"Cluster flapping","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"Leader changes every few seconds → raise cluster.tick_ms."},{"title":"WAL replay failed","slug":"/docs/troubleshooting.html","kicker":"OPS","snip":"xerj verify --repair-wal truncates at last valid entry."},{"title":"Recipes","slug":"/docs/recipes/index.html","kicker":"RECIPES","snip":"Task-oriented AI & search recipes, each verified end-to-end against a live XERJ."},{"title":"Semantic search & RAG","slug":"/docs/recipes/semantic-search-rag.html","kicker":"RECIPE","snip":"Retrieval by meaning with semantic_text — auto-embed on ingest, no separate vector DB."},{"title":"Agent memory","slug":"/docs/recipes/agentic-memory.html","kicker":"RECIPE","snip":"Long-term memory for agents via /_memory — store, recall, forget, per-agent isolation."},{"title":"Passage retrieval","slug":"/docs/recipes/passage-retrieval.html","kicker":"RECIPE","snip":"Auto-chunk long docs; best-passage (max-sim) scoring — 98% top-3."},{"title":"Vector search · kNN","slug":"/docs/recipes/vector-search-knn.html","kicker":"RECIPE","snip":"Nearest-neighbor over dense_vector — HNSW-served unfiltered, exact with filters."},{"title":"Vector quantization","slug":"/docs/recipes/vector-quantization.html","kicker":"RECIPE","snip":"scalar8 (accepts ES int8_hnsw; exact code scan) — 4× smaller vectors, recall@10 ≈ 0.99."},{"title":"Hybrid search","slug":"/docs/recipes/hybrid-search.html","kicker":"RECIPE","snip":"Keyword + vector in one query — RRF fusion."},{"title":"Log analytics","slug":"/docs/recipes/log-analytics.html","kicker":"RECIPE","snip":"Raw logs to dashboards — error rates, p95 latency, top services."},{"title":"Anomaly detection","slug":"/docs/recipes/anomaly-detection.html","kicker":"RECIPE","snip":"Statistical _ml detectors that flag spikes in metrics/logs."},{"title":"Anomaly datafeeds","slug":"/docs/recipes/continuous-anomaly-datafeeds.html","kicker":"RECIPE","snip":"Live _ml datafeed re-scores an index on a timer, stores anomaly records."},{"title":"Migrate from ES","slug":"/docs/recipes/migrate-from-elasticsearch.html","kicker":"RECIPE","snip":"Point your existing ES client at XERJ — same wire, change the URL."},{"title":"For AI · Build with XERJ","slug":"/for-agents.html","kicker":"AI","snip":"The search, data & memory layer for AI agents — one binary on :9200."},{"title":"Agents · Overview","slug":"/docs/agents/index.html","kicker":"AI","snip":"The 7 canonical agent ops: autoindex (CLI-only), search, semantic, vector, hybrid, memory store/recall."},{"title":"Agent quickstart","slug":"/docs/agents/quickstart.html","kicker":"AI","snip":"Boot XERJ, store a memory, recall by meaning, semantic search — runnable curl on :9200."},{"title":"Agent endpoints","slug":"/docs/agents/endpoints.html","kicker":"AI","snip":"Endpoint contract table: method, path, request body, response shape."},{"title":"xerj_memory_store","slug":"/docs/agents/endpoints.html#memory-store","kicker":"AGENT OP","snip":"POST /_memory/{ns} — store a memory (text auto-embedded, or bring your own vector)."},{"title":"xerj_memory_recall","slug":"/docs/agents/endpoints.html#memory-recall","kicker":"AGENT OP","snip":"POST /_memory/{ns}/_recall — recall top-k by meaning (semantic), keyword (BM25) or vector (kNN)."},{"title":"xerj_semantic_search","slug":"/docs/agents/endpoints.html#semantic","kicker":"AGENT OP","snip":"semantic query over a semantic_text field — the server embeds the query text."},{"title":"xerj_autoindex","slug":"/docs/recipes/zero-config-autoindex.html","kicker":"AGENT OP","snip":"xerj autoindex <folder> — CLI-only, no HTTP route: content-sniffed formats, inferred mappings, self-describing catalog."},{"title":"xerj_vector_search","slug":"/docs/agents/endpoints.html#vector","kicker":"AGENT OP","snip":"knn over dense_vector — HNSW-served when unfiltered (exact-rescored), exact scan when filtered."},{"title":"xerj_hybrid_search","slug":"/docs/agents/endpoints.html#hybrid","kicker":"AGENT OP","snip":"hybrid query — fuse BM25 + vector with rrf or linear fusion."}]</script><script>// IIFE — js-auth navigates between decrypted pages in the samediff --git a/landing/docs/aggregations.html b/landing/docs/aggregations.htmlindex 527b9ad2f..15929dc30 100644--- a/landing/docs/aggregations.html+++ b/landing/docs/aggregations.html@@ -226,7 +226,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Aggregations</span></div>@@ -234,7 +234,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/analyzers.html b/landing/docs/analyzers.htmlindex 7c94ffa37..4d9c4f702 100644--- a/landing/docs/analyzers.html+++ b/landing/docs/analyzers.html@@ -152,7 +152,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Analyzers</span></div>@@ -160,7 +160,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/api-es-compat.html b/landing/docs/api-es-compat.htmlindex 3a4ab2f4a..76da6275c 100644--- a/landing/docs/api-es-compat.html+++ b/landing/docs/api-es-compat.html@@ -195,7 +195,7 @@ JSON</pre><!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>ES-compatible API</span></div>@@ -203,7 +203,7 @@ JSON</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/api-native.html b/landing/docs/api-native.htmlindex c8ba0cd9f..79df23459 100644--- a/landing/docs/api-native.html+++ b/landing/docs/api-native.html@@ -207,7 +207,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Native REST API</span></div>@@ -215,7 +215,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/backup-restore.html b/landing/docs/backup-restore.htmlindex 64f3ea370..ec3dfd652 100644--- a/landing/docs/backup-restore.html+++ b/landing/docs/backup-restore.html@@ -192,7 +192,7 @@ $ curl -sXPOST .../v1/cluster/nodes/b/activate</pre><!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Backup & restore</span></div>@@ -200,7 +200,7 @@ $ curl -sXPOST .../v1/cluster/nodes/b/activate</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/cli.html b/landing/docs/cli.htmlindex 8179f8b70..40ee3f91e 100644--- a/landing/docs/cli.html+++ b/landing/docs/cli.html@@ -231,7 +231,7 @@ OPTIONS:<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>CLI reference</span></div>@@ -239,7 +239,7 @@ OPTIONS:</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/clustering.html b/landing/docs/clustering.htmlindex b7ccccd36..38ad496e1 100644--- a/landing/docs/clustering.html+++ b/landing/docs/clustering.html@@ -247,7 +247,7 @@ $ curl -sXPOST -H "Authorization: ApiKey $XERJ_API_KEY" \<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Clustering</span></div>@@ -255,7 +255,7 @@ $ curl -sXPOST -H "Authorization: ApiKey $XERJ_API_KEY" \</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/compression.html b/landing/docs/compression.htmlindex a0f8dcbf0..7b5896141 100644--- a/landing/docs/compression.html+++ b/landing/docs/compression.html@@ -156,7 +156,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Compression & encodings</span></div>@@ -164,7 +164,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/config.html b/landing/docs/config.htmlindex ef4a7e18a..0eeea0bd8 100644--- a/landing/docs/config.html+++ b/landing/docs/config.html@@ -253,7 +253,7 @@ tick_ms = 50</pre><!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Config TOML</span></div>@@ -261,7 +261,7 @@ tick_ms = 50</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/env.html b/landing/docs/env.htmlindex 0115417a9..ae56e021e 100644--- a/landing/docs/env.html+++ b/landing/docs/env.html@@ -151,7 +151,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Environment variables</span></div>@@ -159,7 +159,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/index.html b/landing/docs/index.htmlindex ecbb4e4fc..bd377207b 100644--- a/landing/docs/index.html+++ b/landing/docs/index.html@@ -273,7 +273,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Read the source.</span></div>@@ -281,7 +281,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/ingest.html b/landing/docs/ingest.htmlindex b2da7ba11..32139edd7 100644--- a/landing/docs/ingest.html+++ b/landing/docs/ingest.html@@ -158,7 +158,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Ingest pipelines</span></div>@@ -166,7 +166,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/install.html b/landing/docs/install.htmlindex b48369218..5901be83b 100644--- a/landing/docs/install.html+++ b/landing/docs/install.html@@ -220,7 +220,7 @@ $ docker run -d --name xerj \<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V1.0.0-RC.1 · 2026-07-07</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Install</span></div>@@ -228,7 +228,7 @@ $ docker run -d --name xerj \</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/metrics.html b/landing/docs/metrics.htmlindex 459634876..1f770bc66 100644--- a/landing/docs/metrics.html+++ b/landing/docs/metrics.html@@ -168,7 +168,7 @@ scrape_configs:<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Metrics</span></div>@@ -176,7 +176,7 @@ scrape_configs:</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/migration-from-es.html b/landing/docs/migration-from-es.htmlindex 6dbeff4fd..793e4c743 100644--- a/landing/docs/migration-from-es.html+++ b/landing/docs/migration-from-es.html@@ -175,7 +175,7 @@ $ diff <(curl -s http://es:9200/logs-2026-04/_search -d @q.json) \<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Migrate from Elasticsearch</span></div>@@ -183,7 +183,7 @@ $ diff <(curl -s http://es:9200/logs-2026-04/_search -d @q.json) \</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/operations.html b/landing/docs/operations.htmlindex 472b93b7c..9012950de 100644--- a/landing/docs/operations.html+++ b/landing/docs/operations.html@@ -232,7 +232,7 @@ scrape_configs:<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Running in production</span></div>@@ -240,7 +240,7 @@ scrape_configs:</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/playbooks/full-text.html b/landing/docs/playbooks/full-text.htmlindex 593f242ce..15e816a9a 100644--- a/landing/docs/playbooks/full-text.html+++ b/landing/docs/playbooks/full-text.html@@ -187,7 +187,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Playbook · Full-text search</span></div>@@ -195,7 +195,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/playbooks/log-analytics.html b/landing/docs/playbooks/log-analytics.htmlindex 8349ad9dc..d2d10e146 100644--- a/landing/docs/playbooks/log-analytics.html+++ b/landing/docs/playbooks/log-analytics.html@@ -195,7 +195,7 @@ time_partition = "1h"</pre><!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Playbook · Log analytics</span></div>@@ -203,7 +203,7 @@ time_partition = "1h"</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/playbooks/observability.html b/landing/docs/playbooks/observability.htmlindex 46f665b13..035fe827c 100644--- a/landing/docs/playbooks/observability.html+++ b/landing/docs/playbooks/observability.html@@ -193,7 +193,7 @@ $ OTEL_EXPORTER_OTLP_ENDPOINT=http://xerj:8080/v1/indices/traces/otlp \<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Playbook · Observability</span></div>@@ -201,7 +201,7 @@ $ OTEL_EXPORTER_OTLP_ENDPOINT=http://xerj:8080/v1/indices/traces/otlp \</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/playbooks/siem.html b/landing/docs/playbooks/siem.htmlindex 9c08f0d8a..53cd20f6e 100644--- a/landing/docs/playbooks/siem.html+++ b/landing/docs/playbooks/siem.html@@ -245,7 +245,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Playbook · SIEM</span></div>@@ -253,7 +253,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/playbooks/vector-search.html b/landing/docs/playbooks/vector-search.htmlindex d042bbd4c..c069bfd29 100644--- a/landing/docs/playbooks/vector-search.html+++ b/landing/docs/playbooks/vector-search.html@@ -203,7 +203,7 @@ timeout_ms = 5000</pre><!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Playbook · Vector & RAG</span></div>@@ -211,7 +211,7 @@ timeout_ms = 5000</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/queries.html b/landing/docs/queries.htmlindex 15608c250..ecc61ecd3 100644--- a/landing/docs/queries.html+++ b/landing/docs/queries.html@@ -226,7 +226,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Query types</span></div>@@ -234,7 +234,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/quickstart.html b/landing/docs/quickstart.htmlindex f08adf6ab..f77dbbcca 100644--- a/landing/docs/quickstart.html+++ b/landing/docs/quickstart.html@@ -118,6 +118,11 @@<div class="kicker"><span>01 · START</span></div><h1>Quickstart</h1>+ <p><strong>Audience: operators driving XERJ's native REST API on port <code class="inline">8080</code>.</strong> This page creates indices with explicit field mappings and ingests through <code class="inline">turbo-ingest</code> — the low-level path. It is <em>not</em> the agent onramp, and it deliberately does not cover <code class="inline">xerj autoindex</code>.</p>+ <ul>+ <li><strong>AI agents start here instead:</strong> <a href="/llms.txt"><code class="inline">/llms.txt</code></a> (install → run → index → query, written for a machine) or the <a href="/docs/agents/quickstart.html">agent quickstart</a> — both use the Elasticsearch-compatible surface on <code class="inline">9200</code>.</li>+ <li><strong>Just want a folder to become searchable?</strong> <code class="inline">xerj autoindex <folder></code> writes the mappings for you — the <a href="/docs/recipes/zero-config-autoindex.html">zero-config indexing recipe</a>.</li>+ </ul><p>Start the server, create an index, ingest some data, run a query. Sixty seconds if you already have a binary.</p>@@ -182,7 +187,7 @@ $ xerj autoindex ~/my-project # picks up XERJ_API_KEY, or take --api-key<<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Quickstart</span></div>@@ -190,7 +195,7 @@ $ xerj autoindex ~/my-project # picks up XERJ_API_KEY, or take --api-key<</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/agentic-memory.html b/landing/docs/recipes/agentic-memory.htmlindex 6c47ca8b1..326e41d78 100644--- a/landing/docs/recipes/agentic-memory.html+++ b/landing/docs/recipes/agentic-memory.html@@ -272,7 +272,7 @@ All assertions passed.</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/anomaly-detection.html b/landing/docs/recipes/anomaly-detection.htmlindex 9bab958dd..9228ebbcf 100644--- a/landing/docs/recipes/anomaly-detection.html+++ b/landing/docs/recipes/anomaly-detection.html@@ -291,7 +291,7 @@ OK: spike at 00:12 flagged (score 100.0); 11 normal buckets, none flagged (top n</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/continuous-anomaly-datafeeds.html b/landing/docs/recipes/continuous-anomaly-datafeeds.htmlindex 4c60dd18c..9bbe878f6 100644--- a/landing/docs/recipes/continuous-anomaly-datafeeds.html+++ b/landing/docs/recipes/continuous-anomaly-datafeeds.html@@ -305,7 +305,7 @@ OK: 2 anomalies detected continuously; datafeed stopped cleanly.</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/document-folder-index.html b/landing/docs/recipes/document-folder-index.htmlindex e509fd823..829ec7453 100644--- a/landing/docs/recipes/document-folder-index.html+++ b/landing/docs/recipes/document-folder-index.html@@ -355,7 +355,7 @@ node compare.mjs</pre><!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Recipe · Index a folder of docs</span></div>@@ -363,7 +363,7 @@ node compare.mjs</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/hybrid-search.html b/landing/docs/recipes/hybrid-search.htmlindex 76efc7b80..080566d28 100644--- a/landing/docs/recipes/hybrid-search.html+++ b/landing/docs/recipes/hybrid-search.html@@ -254,7 +254,7 @@ OK</pre><!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Recipe · Hybrid search</span></div>@@ -262,7 +262,7 @@ OK</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/index.html b/landing/docs/recipes/index.htmlindex 06085c68a..e01c95535 100644--- a/landing/docs/recipes/index.html+++ b/landing/docs/recipes/index.html@@ -188,7 +188,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Recipes</span></div>@@ -196,7 +196,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/log-analytics.html b/landing/docs/recipes/log-analytics.htmlindex 6f68f2af5..8bd2bf09e 100644--- a/landing/docs/recipes/log-analytics.html+++ b/landing/docs/recipes/log-analytics.html@@ -260,7 +260,7 @@ Q3 top services: catalog 190 · search 187 · checkout 150 · payments 73<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Recipe · Log analytics</span></div>@@ -268,7 +268,7 @@ Q3 top services: catalog 190 · search 187 · checkout 150 · payments 73</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/migrate-from-elasticsearch.html b/landing/docs/recipes/migrate-from-elasticsearch.htmlindex 0a9b4a006..65687f1a3 100644--- a/landing/docs/recipes/migrate-from-elasticsearch.html+++ b/landing/docs/recipes/migrate-from-elasticsearch.html@@ -132,7 +132,7 @@<ul><li><strong>Same wire, same client.</strong> The official <code class="inline">elasticsearch-py</code>, <code class="inline">@elastic/elasticsearch</code>, or a raw <code class="inline">curl</code> all work because XERJ implements the ES REST API surface. XERJ even reports itself as version <code class="inline">8.13.0</code> at <code class="inline">GET /</code>, so version-sniffing clients connect cleanly.</li><li><strong>Faster on the same workload.</strong> On an identical corpus and machine, XERJ beats a real Elasticsearch 8.13 on both ingest and reads — e.g. bulk ingest ~1.5–1.7× and <code class="inline">match</code> queries ~2.5× lower p50 latency (see <a href="#benchmarks">Benchmarks</a>).</li>- <li><strong>Honest scope.</strong> XERJ is <em>wire-compatible</em>, not a byte-for-byte fork. As of the last full run it passes <strong>1,325 / 1,326</strong> executed cases of the 1,329-case ES REST conformance suite (3 skipped, 1 known fail). Response <em>shapes</em> match; some internal details (exact BM25 float scores, segment-merge timing) are XERJ's own. See <a href="#limitations-be-honest">Limitations</a>.</li>+ <li><strong>Honest scope.</strong> XERJ is <em>wire-compatible</em>, not a byte-for-byte fork. As of the last full run on main it passes <strong>1,366 / 1,366</strong> executed cases of the 1,369-case ES REST conformance suite (3 skipped, 0 failed). Response <em>shapes</em> match; some internal details (exact BM25 float scores, segment-merge timing) are XERJ's own. See <a href="#limitations-be-honest">Limitations</a>.</li></ul><h2>The working solution</h2>@@ -282,7 +282,7 @@ ES=http://localhost:9200 bash docs/examples/migrate-from-elasticsearch/migrate_d<h2 id="limitations-be-honest">Limitations (be honest)</h2><ul>- <li><strong>Wire-compatible, not byte-identical.</strong> XERJ passes <strong>1,325 / 1,326</strong> executed cases of the 1,329-case ES REST conformance suite (3 skipped, 1 known fail), last full run. Response <em>structure</em> matches ES; validate the specific endpoints and query types your app depends on against your own data before cutting over. Per-suite conformance and caveats are tracked in <code class="inline">demo/playbooks/ES_COMPATIBILITY.md</code>.</li>+ <li><strong>Wire-compatible, not byte-identical.</strong> XERJ passes <strong>1,366 / 1,366</strong> executed cases of the 1,369-case ES REST conformance suite (3 skipped, 0 failed), last full run on main. Response <em>structure</em> matches ES; validate the specific endpoints and query types your app depends on against your own data before cutting over. Per-suite conformance and caveats are tracked in <code class="inline">demo/playbooks/ES_COMPATIBILITY.md</code>.</li><li><strong>Relevance scores are XERJ's own BM25.</strong> Ranking order matches ES intent, but exact <code class="inline">_score</code> float values differ, and can even shift slightly for the <em>same</em> query as background segment merges change collection statistics — the same class of internal difference you'd see comparing two ES minor versions. If you assert on exact scores in tests, relax those assertions.</li><li><strong>A few query/agg types differ or aren't implemented.</strong> XERJ covers the common set (<code class="inline">match</code>, <code class="inline">term</code>, <code class="inline">terms</code>, <code class="inline">range</code>, <code class="inline">bool</code>, <code class="inline">match_phrase</code>, <code class="inline">multi_match</code>, <code class="inline">terms</code>/<code class="inline">stats</code>/<code class="inline">date_histogram</code>/... aggs). Some ES features are partial or unsupported (e.g. vector-suite conformance is low). Check the compatibility report for your specific needs.</li></ul>@@ -311,7 +311,7 @@ ES=http://localhost:9200 bash docs/examples/migrate-from-elasticsearch/migrate_d</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/passage-retrieval.html b/landing/docs/recipes/passage-retrieval.htmlindex cce2606cf..1146d06d4 100644--- a/landing/docs/recipes/passage-retrieval.html+++ b/landing/docs/recipes/passage-retrieval.html@@ -196,7 +196,7 @@ compendium reached the top-3:<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Recipe · Passage retrieval</span></div>@@ -204,7 +204,7 @@ compendium reached the top-3:</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/semantic-search-rag.html b/landing/docs/recipes/semantic-search-rag.htmlindex cda117a99..ee5142ff3 100644--- a/landing/docs/recipes/semantic-search-rag.html+++ b/landing/docs/recipes/semantic-search-rag.html@@ -281,7 +281,7 @@ unknown-metric -> HTTP 400 (fail-loud, not a misleading number)</pre><!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Recipe · Semantic search & RAG</span></div>@@ -289,7 +289,7 @@ unknown-metric -> HTTP 400 (fail-loud, not a misleading number)</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/vector-quantization.html b/landing/docs/recipes/vector-quantization.htmlindex 1c6b50f91..c66e79474 100644--- a/landing/docs/recipes/vector-quantization.html+++ b/landing/docs/recipes/vector-quantization.html@@ -202,7 +202,7 @@ python3 docs/examples/vector-quantization/quant_demo.py</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/vector-search-knn.html b/landing/docs/recipes/vector-search-knn.htmlindex 61712ddbc..0b72c528f 100644--- a/landing/docs/recipes/vector-search-knn.html+++ b/landing/docs/recipes/vector-search-knn.html@@ -260,7 +260,7 @@ ALL ASSERTIONS PASSED</pre><!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Recipe · Vector search · kNN</span></div>@@ -268,7 +268,7 @@ ALL ASSERTIONS PASSED</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/recipes/zero-config-autoindex.html b/landing/docs/recipes/zero-config-autoindex.htmlindex 600a3ebb0..fd2537c6c 100644--- a/landing/docs/recipes/zero-config-autoindex.html+++ b/landing/docs/recipes/zero-config-autoindex.html@@ -287,7 +287,7 @@ curl localhost:9200/ax-*/_search -H 'Content-Type: application/json' \<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Recipe · Zero-config autoindex</span></div>@@ -295,7 +295,7 @@ curl localhost:9200/ax-*/_search -H 'Content-Type: application/json' \</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/security.html b/landing/docs/security.htmlindex 1e8a595bc..c30c554f5 100644--- a/landing/docs/security.html+++ b/landing/docs/security.html@@ -158,7 +158,7 @@ $ sudo journalctl -u xerj | grep -A4 'First-run'</pre><!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Auth & TLS</span></div>@@ -166,7 +166,7 @@ $ sudo journalctl -u xerj | grep -A4 'First-run'</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/storage.html b/landing/docs/storage.htmlindex e10bd9e46..3797ca921 100644--- a/landing/docs/storage.html+++ b/landing/docs/storage.html@@ -176,7 +176,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Storage & WAL</span></div>@@ -184,7 +184,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/troubleshooting.html b/landing/docs/troubleshooting.htmlindex f8794385a..12b5ae601 100644--- a/landing/docs/troubleshooting.html+++ b/landing/docs/troubleshooting.html@@ -185,7 +185,7 @@ contents:<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Troubleshooting</span></div>@@ -193,7 +193,7 @@ contents:</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/upgrades.html b/landing/docs/upgrades.htmlindex 1a94c1c05..e8be51099 100644--- a/landing/docs/upgrades.html+++ b/landing/docs/upgrades.html@@ -182,7 +182,7 @@ $ sudo systemctl start xerj</pre><!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Upgrades</span></div>@@ -190,7 +190,7 @@ $ sudo systemctl start xerj</pre></div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/docs/vectors.html b/landing/docs/vectors.htmlindex ddcf8b73b..7e298f549 100644--- a/landing/docs/vectors.html+++ b/landing/docs/vectors.html@@ -191,7 +191,7 @@<!-- Print-only branded footer (hidden on screen, visible in PDF) --><div class="print-footer" style="display:none;">- <span>XERJ.AI · V0.1 · 2026-04-16</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026-08-11</span><a href="https://xerj.org/docs/">https://xerj.org/docs/</a><span>Vectors & kNN</span></div>@@ -199,7 +199,7 @@</div><footer class="footer">- <span>XERJ.AI · DOCS · V1.0.0-RC.1</span>+ <span>XERJ.AI · DOCS · V1.0.0-RC.15</span><span>READ THE SOURCE</span><span><a href="/index.html">HOME</a> · <a href="/product.html">PRODUCT</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/for-agents.html b/landing/for-agents.htmlindex 7be6caaa3..e2bc2472b 100644--- a/landing/for-agents.html+++ b/landing/for-agents.html@@ -144,7 +144,7 @@ $ curl -sXPOST localhost:9200/_memory/agent-demo/_recall \<a class="recipe" href="/docs/agents/endpoints.html#search"><span class="num">01 · SEARCH</span><span class="title">Find anything, four ways</span>- <p class="lead">Keyword & structured (<code class="inline">match</code>, <code class="inline">term</code>, <code class="inline">bool</code>), <code class="inline">semantic</code> retrieval by meaning, exact <code class="inline">knn</code> vector search, and <code class="inline">hybrid</code> fusion — all on the same ES-compatible <code class="inline">_search</code> endpoint.</p>+ <p class="lead">Keyword & structured (<code class="inline">match</code>, <code class="inline">term</code>, <code class="inline">bool</code>), <code class="inline">semantic</code> retrieval by meaning, <code class="inline">knn</code> vector search (HNSW-served when unfiltered, exact when filtered), and <code class="inline">hybrid</code> fusion — all on the same ES-compatible <code class="inline">_search</code> endpoint.</p><span class="meta">POST /:index/_search</span></a><a class="recipe" href="/docs/agents/endpoints.html#data">@@ -171,7 +171,7 @@ $ curl -sXPOST localhost:9200/_memory/agent-demo/_recall \<div class="head">DOES</div><div class="cell m">xerj_autoindex</div>- <div class="cell p">xerj autoindex <folder></div>+ <div class="cell p">xerj autoindex <folder><br><span class="mono">CLI ONLY · NO HTTP ROUTE</span></div><div class="cell dsc">Make a folder searchable, zero config — sniffed formats, inferred mappings, self-describing catalog.</div><div class="cell m">xerj_search</div>@@ -184,7 +184,7 @@ $ curl -sXPOST localhost:9200/_memory/agent-demo/_recall \<div class="cell m">xerj_vector_search</div><div class="cell p">knn</div>- <div class="cell dsc">Exact nearest-neighbor over <code class="inline">dense_vector</code>.</div>+ <div class="cell dsc">Nearest-neighbor over <code class="inline">dense_vector</code> — HNSW-served with exact rescoring when unfiltered, exact brute-force scan when filtered.</div><div class="cell m">xerj_hybrid_search</div><div class="cell p">hybrid query</div>@@ -287,7 +287,7 @@ $ curl -sXPOST localhost:9200/docfolder/_search \<a class="recipe" href="/docs/agents/endpoints.html"><span class="num">CONTRACT</span><span class="title">Endpoint reference</span>- <p class="lead">Method, path, request body and response shape for all six operations.</p>+ <p class="lead">Method, path, request body and response shape for the six HTTP operations. The seventh, <code class="inline">xerj_autoindex</code>, is a CLI subcommand with no endpoint — its contract is in the <a href="/docs/recipes/zero-config-autoindex.html">flagship recipe</a>.</p></a><a class="recipe" href="/docs/agents/index.html"><span class="num">OVERVIEW</span>@@ -326,12 +326,20 @@ $ curl -sXPOST localhost:9200/docfolder/_search \<section class="scene-section" style="border-top:0;"><div class="kicker"><span>FOR MACHINES · DISCOVER XERJ</span></div><p class="lead" style="max-width:760px;">- Point a crawler or an agent's tool-discovery step at these. Both are served- from the site root and describe the same operations documented above.+ Point a crawler or an agent's tool-discovery step at these. Every one is a+ static file on this site, fetchable without a key, describing the same+ operations documented above.</p><ul class="pitch" style="max-width:760px;"><li><a href="/llms.txt"><code class="inline">/llms.txt</code></a> — a plain-text manifest of the base URL, the seven agent operations (autoindex included), and the honesty caveats, written for an LLM to read directly.</li>- <li><a href="/openapi.json"><code class="inline">/openapi.json</code></a> — an OpenAPI description of the six canonical agent operations (7 routes), for tool/codegen pipelines. It is a deliberately partial spec, not the whole ~210-route REST surface: an endpoint missing from it is "not written up yet", never "not supported".</li>+ <li><a href="/llms-full.txt"><code class="inline">/llms-full.txt</code></a> — the expanded reference: the <code class="inline">autoindex</code> CLI contract, field types, request and response shapes, and the full endpoint catalogue.</li>+ <li><a href="/openapi.json"><code class="inline">/openapi.json</code></a> — an OpenAPI description of the six <em>HTTP</em> agent operations (7 routes), for tool/codegen pipelines — <code class="inline">xerj_autoindex</code>, the seventh, is CLI-only and has no route to describe. It is a deliberately partial spec, not the whole ~210-route REST surface: an endpoint missing from it is "not written up yet", never "not supported".</li>+ <li><strong>Tool schemas — paste straight into a tool definition.</strong> The same six HTTP operations, one file per calling convention:+ <a href="/docs/agents/schemas/anthropic-tools.json"><code class="inline">/docs/agents/schemas/anthropic-tools.json</code></a> (Anthropic <code class="inline">tools</code> array),+ <a href="/docs/agents/schemas/openai-tools.json"><code class="inline">/docs/agents/schemas/openai-tools.json</code></a> (OpenAI function-calling),+ <a href="/docs/agents/schemas/mcp-tools.json"><code class="inline">/docs/agents/schemas/mcp-tools.json</code></a> (MCP <code class="inline">tools</code> list).+ Each carries the full JSON-Schema input shape plus the same caveats as this page. They describe the HTTP surface only — <code class="inline">xerj_autoindex</code> is not in them, and you still need a running node to call.</li>+ <li><a href="/use-cases/second-brain.html">Second brain — the runnable MCP server</a> — <code class="inline">xerj brain</code> over a folder of notes, exposing four verbs (<code class="inline">xerj_brain_ego</code>, <code class="inline">xerj_brain_link</code>, <code class="inline">xerj_brain_unlink</code>, <code class="inline">xerj_brain_overview</code>) under <code class="inline">contract: xerj-second-brain/1</code>, with the verification run that exercised them.</li></ul></section>@@ -342,7 +350,7 @@ $ curl -sXPOST localhost:9200/docfolder/_search \</a><footer class="footer">- <span>XERJ.AI · FOR AI · V1.0.0-RC.1</span>+ <span>XERJ.AI · FOR AI · V1.0.0-RC.15</span><span>ONE BINARY. THREE STORES.</span><span><a href="/index.html">HOME</a> · <a href="/docs/index.html">DOCS</a> · <a href="/docs/recipes/index.html">RECIPES</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/index.html b/landing/index.htmlindex 3a33558af..034cc9c76 100644--- a/landing/index.html+++ b/landing/index.html@@ -55,6 +55,15 @@the open-source repos worth learning from, and looks implementations upinstead of re-deriving them.</p>+ <p class="hero-sub" style="font-size:var(--fs-16); max-width:760px;">+ Two things the agent has to get right, both stated in+ <a href="/llms.txt">llms.txt</a>: <strong>indexing needs a running node</strong>+ — <code class="inline">xerj --insecure --data-dir ./.xerj-data &</code> comes+ first, or <code class="inline">xerj autoindex</code> exits 1 — and+ <strong>cloning reference repos downloads real data onto your machine</strong>,+ so have it name the repos and estimate the job before it starts. XERJ's own+ doctrine is estimate first, ask before long jobs.</p>+</section>@@ -79,20 +88,30 @@solve rate, <strong>26× fewer</strong> than working from memory(260,916 → 9,982), <strong>2.1× cheaper</strong> ($1.58 vs $3.27). In acompanion run on a Rust library the model had never seen:- <strong>9/9 with retrieval vs 0/9 from memory</strong>. The three helper- scripts below ship in the repo, under- <a class="mono" href="https://github.com/xerj-org/xerj/tree/main/tools/xerj-code" rel="external" style="color:var(--z-mute);">tools/xerj-code/</a>.+ <strong>9/9 with retrieval vs 0/9 from memory</strong>. The loop is four+ commands and no extra tooling — it is exactly what+ <a href="/llms.txt">llms.txt</a> walks your agent through when you paste the+ prompt above.</p>-<pre class="code">$ xc-corpus.sh --from hub/xerj-storage.json # or: xc-corpus.sh xerj-storage <git-url>…-$ xc-index.sh xerj-storage # xerj autoindex, once per corpus-$ xc.py xerj-storage "how does sled fsync its WAL segment on rotation?"+<pre class="code">$ xerj --insecure --data-dir ./.xerj-data & <span class="comment"># 1. a node must be running first</span>+$ git clone --depth 1 https://github.com/spacejam/sled ref/sled+$ xerj autoindex ref/sled <span class="comment"># 2. tree-sitter AST fields, once per clone</span>+$ curl -sXPOST 'localhost:9200/ax-*/_search' -H 'content-type: application/json' \+ -d '{"query":{"multi_match":{"query":"fsync the WAL segment on rotation",+ "fields":["defs^3","body","title"]}}}'→ the exact function, file:line, contract included — a passage to read, not a tree to grep</pre><p class="wide" style="margin-top:var(--sp-3);">- A corpus definition is a few hundred bytes of URLs, pinned commit SHAs and- licences — no source, so nothing to redistribute. Share the file, and- <code class="inline">--from</code> rebuilds the same commits on the other machine.+ Optional convenience layer: the same four steps are wrapped by+ <code class="inline">xc-corpus.sh</code> / <code class="inline">xc-index.sh</code> /+ <code class="inline">xc.py</code>, which ship in the repo under+ <a class="mono" href="https://github.com/xerj-org/xerj/tree/main/tools/xerj-code" rel="external" style="color:var(--z-mute);">tools/xerj-code/</a>.+ They add one thing the plain commands don't have — a corpus definition, a+ few hundred bytes of URLs, pinned commit SHAs and licences, no source, so+ nothing to redistribute. Share that file, and+ <code class="inline">xc-corpus.sh --from</code> rebuilds the same commits on+ the other machine.</p><p class="viz-caption"><a class="mono" href="/case-studies/reference-coding.html" style="color:var(--z-mute);">THE FULL CASE STUDY — EVERY NUMBER, EVERY TASK, THE EXACT PROMPT →</a></p>@@ -130,6 +149,8 @@ done in 0.2s — 3 datasets, 5801 records live, 0 junk records, 1 junk/skipped fnext: `xerj autoindex map --url http://localhost:9280` for the data map; search via GET /ax-*/_search</pre>+ <p class="viz-caption">CAPTURE NOTE · THAT RUN'S NODE WAS STARTED ON A NON-DEFAULT PORT, SO THE OUTPUT ECHOES <span class="mono">:9280</span>. THE DEFAULT ES-COMPAT PORT IS <span class="mono">:9200</span> — USE <span class="mono">http://localhost:9200</span> UNLESS YOU CHANGED IT. THE TRANSCRIPT ABOVE IS REPRODUCED UNEDITED.</p>+<div class="ticker" style="margin-top:var(--sp-6);"><div class="tk"><div class="eyebrow">GROUND-TRUTH EXAM · 1,995 FILES / 518 MB</div>@@ -221,7 +242,7 @@ $ curl -sXPOST localhost:9200/_memory/agent-demo/_recall \<strong>15 release candidates in 34 days</strong> — v1.0.0-rc.1 shipped2026-07-07, <strong>v1.0.0-rc.15</strong> on 2026-08-10, and the installersabove always resolve the latest. Every commit re-runs the- <strong>1,365 / 1,368</strong> ES-YAML conformance suite; the changelog+ <strong>1,366 / 1,369</strong> ES-YAML conformance suite; the changelogstates known defects instead of implying their absence. In the currentbuild: code arrives <strong>AST-parsed for 34 languages</strong> (symbols,definitions, line numbers), index lifecycle policies <strong>execute</strong>@@ -320,7 +341,7 @@ $ curl -sXPOST localhost:9200/_memory/agent-demo/_recall \</div><div class="row"><div class="k">Speaks Elasticsearch</div>- <div class="v">1,365 / 1,368 wire-conformance cases green on every commit — existing clients, dashboards and tooling connect unchanged. A migration bridge, not a clone: the engine underneath is designed for agents</div>+ <div class="v">1,366 / 1,369 wire-conformance cases green on every commit — existing clients, dashboards and tooling connect unchanged. A migration bridge, not a clone: the engine underneath is designed for agents</div></div><div class="row"><div class="k">One static binary</div>@@ -334,7 +355,7 @@ $ curl -sXPOST localhost:9200/_memory/agent-demo/_recall \</a><footer class="footer">- <span>XERJ.AI · V1.0.0-RC · 2026</span>+ <span>XERJ.AI · V1.0.0-RC.15 · 2026</span><span>STORAGE FOR THE AGENT ERA</span><span><a href="/product.html">PRODUCT</a> · <a href="/docs/index.html">DOCS</a> · <a href="/brand.html">BRAND</a> · <a href="/playground.html">DASHBOARDS</a> · <a href="/llms.txt">LLMS.TXT</a></span></footer>diff --git a/landing/sitemap.xml b/landing/sitemap.xmlindex 29e55eede..7eed5c250 100644--- a/landing/sitemap.xml+++ b/landing/sitemap.xml@@ -100,4 +100,24 @@<lastmod>2026-07-08</lastmod><priority>0.6</priority></url>+ <url>+ <loc>https://xerj.org/use-cases/second-brain.html</loc>+ <lastmod>2026-08-12</lastmod>+ <priority>0.7</priority>+ </url>+ <url>+ <loc>https://xerj.org/docs/agents/schemas/anthropic-tools.json</loc>+ <lastmod>2026-08-12</lastmod>+ <priority>0.6</priority>+ </url>+ <url>+ <loc>https://xerj.org/docs/agents/schemas/openai-tools.json</loc>+ <lastmod>2026-08-12</lastmod>+ <priority>0.6</priority>+ </url>+ <url>+ <loc>https://xerj.org/docs/agents/schemas/mcp-tools.json</loc>+ <lastmod>2026-08-12</lastmod>+ <priority>0.6</priority>+ </url></urlset>diff --git a/landing/use-cases.html b/landing/use-cases.htmlindex 8437f106e..5c405f554 100644--- a/landing/use-cases.html+++ b/landing/use-cases.html@@ -47,6 +47,7 @@<a href="/use-cases/ai-search-retrieval.html">AI SEARCH</a><a href="/use-cases/elasticsearch-replacement.html">ES REPLACEMENT</a><a href="/use-cases/unified-observability.html">OBSERVABILITY</a>+ <a href="/use-cases/second-brain.html">SECOND BRAIN · MCP</a></nav><section class="scene-section" style="border-top:0; padding-top:0;">