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.

build: document how `quick` and `ci-test` divide the verify loop

xerj-org264e99c6daa2
diff --git a/docs/FAST_BUILDS.md b/docs/FAST_BUILDS.md
index 2b2782e60..b08b44279 100644
--- a/docs/FAST_BUILDS.md
+++ b/docs/FAST_BUILDS.md
@@ -24,6 +24,8 @@ cargo build --profile quick -j 12 -p xerj-server
cargo test --profile quick -j 12 -p xerj-autoindex
```
+Its sibling `[profile.ci-test]` serves `cargo test`; use `quick` for `cargo build`.
+
It keeps everything affecting **correctness** identical to release —
`panic = "abort"` (inherited; it changes observable behaviour so it must match),
same features, same `target-cpu` — and relaxes only optimisation.
diff --git a/engine/Cargo.toml b/engine/Cargo.toml
index 1e4992a47..abc17cb1c 100644
--- a/engine/Cargo.toml
+++ b/engine/Cargo.toml
@@ -141,7 +141,21 @@ strip = false
# Fast iteration profile: symbolized with thin LTO and parallel codegen.
# It is intentionally not production-codegen-equivalent.
-# Fast verification profile — for the implement -> build -> verify loop.
+# Fast verification profile — the BUILD half of the implement -> build -> verify
+# loop. Its sibling is [profile.ci-test] above, which serves the TEST half.
+#
+# The division is deliberate and the two are not redundant:
+# quick — `cargo build`. Inherits panic = "abort" from release, matching the
+# shipped binary, so the artifact you smoke-test behaves like the real
+# one (panic strategy is observable).
+# ci-test — `cargo test`. Uses panic = "unwind", because cargo rebuilds the whole
+# dependency graph with unwind for test targets regardless; declaring it
+# makes that split explicit instead of accidental, and lets test builds
+# share artifacts with each other rather than fighting a build profile
+# they can never reuse.
+#
+# Use ci-test for `cargo test`. Use quick for `cargo build`. Neither is ever valid
+# for a released artifact or a published number.
#
# WHY: [profile.release] below is a SHIPPING configuration — `lto = "fat"` plus
# `codegen-units = 1` is the slowest build Rust can produce, deliberately, because