Skip to content

armgit / xerj

Public Imported from GitHub
0

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.

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.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/benchmarks/index.html b/landing/benchmarks/index.html
index 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 &middot; 0 failed &middot; 3 skipped &middot; 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 that
to 100% or to "full ES compatibility." It is also not the product: XERJ is a from-scratch Rust
engine that speaks the ES 8.x wire protocol as an <strong>adoption bridge</strong>, the way modern
databases 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 &amp; 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&nbsp;ms</strong> on <span class="mono">match_all</span> vs ES's <strong>3.45&nbsp;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&nbsp;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&nbsp;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&nbsp;ms</strong> on <span class="mono">match_all</span> vs ES's <strong>3.45&nbsp;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&nbsp;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&nbsp;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&nbsp;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.html
index 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 the
rest of our work, so I stop burning output tokens re-deriving APIs I could just
look 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 &rarr;</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 &rarr;</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 &lt;corpus&gt; "…"</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 &lt;clone&gt;</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's
dependencies 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 &lt;clone&gt;</code>:
+ every file is sniffed by content, and source files go through
tree-sitter grammars (13 languages) that emit the language, every symbol with its kind and line number, a
searchable <code class="inline">defs</code> field, and the full body. One index per dataset, incremental on
re-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 arm
where 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 &amp;</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.html
index 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> &middot; <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 same
diff --git a/landing/docs/agents/index.html b/landing/docs/agents/index.html
index 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 &lt;folder&gt;</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> &middot; <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 same
diff --git a/landing/docs/agents/quickstart.html b/landing/docs/agents/quickstart.html
index 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 &amp;
+
+# then WAIT for it: an agent that fires the next request immediately gets a connection refused
+$ until curl -sf localhost:9200/_cluster/health &gt;/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 &amp; 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 &amp; 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 &amp; 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> &middot; <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 same
diff --git a/landing/docs/aggregations.html b/landing/docs/aggregations.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/analyzers.html b/landing/docs/analyzers.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/api-es-compat.html b/landing/docs/api-es-compat.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/api-native.html b/landing/docs/api-native.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/backup-restore.html b/landing/docs/backup-restore.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/cli.html b/landing/docs/cli.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/clustering.html b/landing/docs/clustering.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/compression.html b/landing/docs/compression.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/config.html b/landing/docs/config.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/env.html b/landing/docs/env.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/index.html b/landing/docs/index.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/ingest.html b/landing/docs/ingest.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/install.html b/landing/docs/install.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/metrics.html b/landing/docs/metrics.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/migration-from-es.html b/landing/docs/migration-from-es.html
index 6dbeff4fd..793e4c743 100644
--- a/landing/docs/migration-from-es.html
+++ b/landing/docs/migration-from-es.html
@@ -175,7 +175,7 @@ $ diff &lt;(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 &lt;(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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/operations.html b/landing/docs/operations.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/playbooks/full-text.html b/landing/docs/playbooks/full-text.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/playbooks/log-analytics.html b/landing/docs/playbooks/log-analytics.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/playbooks/observability.html b/landing/docs/playbooks/observability.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/playbooks/siem.html b/landing/docs/playbooks/siem.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/playbooks/vector-search.html b/landing/docs/playbooks/vector-search.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/queries.html b/landing/docs/queries.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/quickstart.html b/landing/docs/quickstart.html
index 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 &lt;folder&gt;</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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/recipes/agentic-memory.html b/landing/docs/recipes/agentic-memory.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/recipes/anomaly-detection.html b/landing/docs/recipes/anomaly-detection.html
index 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> &middot; <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.html
index 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> &middot; <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.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/recipes/hybrid-search.html b/landing/docs/recipes/hybrid-search.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/recipes/index.html b/landing/docs/recipes/index.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/recipes/log-analytics.html b/landing/docs/recipes/log-analytics.html
index 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> &middot; <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.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/recipes/passage-retrieval.html b/landing/docs/recipes/passage-retrieval.html
index 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> &middot; <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.html
index 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 -&gt; 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 &amp; RAG</span>
</div>
@@ -289,7 +289,7 @@ unknown-metric -&gt; 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/recipes/vector-quantization.html b/landing/docs/recipes/vector-quantization.html
index 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> &middot; <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.html
index 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> &middot; <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.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/security.html b/landing/docs/security.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/storage.html b/landing/docs/storage.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/troubleshooting.html b/landing/docs/troubleshooting.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/upgrades.html b/landing/docs/upgrades.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/docs/vectors.html b/landing/docs/vectors.html
index 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/for-agents.html b/landing/for-agents.html
index 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 &amp; 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 &amp; 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 &lt;folder&gt;</div>
+ <div class="cell p">xerj autoindex &lt;folder&gt;<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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/index.html b/landing/index.html
index 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 up
instead 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 &amp;</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 a
companion 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 &lt;git-url&gt;…
-$ 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 &amp; <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 f
next: `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 shipped
2026-07-07, <strong>v1.0.0-rc.15</strong> on 2026-08-10, and the installers
above 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 changelog
states known defects instead of implying their absence. In the current
build: 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> &middot; <a href="/llms.txt">LLMS.TXT</a></span>
</footer>
diff --git a/landing/sitemap.xml b/landing/sitemap.xml
index 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.html
index 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 &middot; MCP</a>
</nav>
<section class="scene-section" style="border-top:0; padding-top:0;">