yams/docs
Trevon 3f37e8f564
Sync experimental into main: Search retrieval improvements (#60)
* fix(graph): handle qualified C++ symbols

Signed-off-by: trvon <me@trevon.dev>

* refactor(vector)!: remove dead transition APIs

Split Simeon vector and retrieval linkage so consumers inherit only the runtime surface they use.

BREAKING CHANGE: remove unused async/model/config helpers and the undefined vector-backend factory from public headers.

Signed-off-by: trvon <me@trevon.dev>

* fix(vector): harden PQ snapshot lifecycle

Validate and atomically install persisted generations, revalidate after races, and fall back to exact search when a snapshot is stale. Add the exact-scan reference lane and distinguish observed work counters from unavailable backend metrics.

Signed-off-by: trvon <me@trevon.dev>

* feat(topology): expose route coordinates

Persist chart distortion and local-dimension evidence, retain pre-scalarization route axes, and emit detailed trace rows without treating unavailable vector work as zero.

Signed-off-by: trvon <me@trevon.dev>

* feat(xplan): add vector decision gates

Track binary and corpus identity, preserve missing-work semantics, and add repeated PQ routing, crossover, and rerank plans with quality and cost summaries.

Signed-off-by: trvon <me@trevon.dev>

* feat(topology): formalize coordinate routing

Separate chart geometry from route-risk admission and prove candidate-stage recall and strict-focus boundaries. Record the measured atlas limitations and literature basis for the next construction experiment.

Signed-off-by: trvon <me@trevon.dev>

* fix(search): serialize SymSpell readers

SQLite-backed lookups reuse mutable prepared statements, so shared-reader locking is unsafe. Advance the owned SymSpell revision for batched delete insertion and cover concurrent root lookups under TSAN.

Signed-off-by: trvon <me@trevon.dev>

* fix(vector): make mutations atomic

Preserve stored vectors on replacement and commit failures, reject cross-thread writes during explicit transactions, and restore exact reranking for quantized-primary PQ rows.

* fix(search)!: surface SymSpell write errors

Propagate persistent dictionary failures through metadata ingestion, roll back failed batches, and make clear remove stored terms.

BREAKING CHANGE: SymSpellSearch mutations now return Result values.

* feat(topology): formalize candidate expansion

* feat(vector): add coordinate-aware embeddings

* feat(topology): preserve protected relation cover

* feat(search): add graph candidate rescue

* feat(daemon): expose retrieval hydration telemetry

* feat(xplan): add rescue and hydration gates

* refactor(content): dedupe media handlers

Reuse shared graph presenter helpers and centralize repeated audio/video/archive buffer processing, validation, lifecycle, and stats helper logic.

* feat(lifecycle): prune stale corpus data

Keep cleanup preview-first while retention stays opt-in and long prune work no longer holds IPC responses open.

* feat(search): add topology candidate rescue

Preserve high-value routed candidates across vector backends while keeping exact rerank diagnostics explicit.

* feat(search): expose evidence paths

* docs: define mobile host contract

* formal: model bounded candidate rescue

* fix(prune): inspect extensionless signatures

* fix(prune): tolerate stale extensions

---------

Signed-off-by: trvon <me@trevon.dev>
2026-07-24 19:00:22 -04:00
..
admin fix(audit): remove no-op storage and metadata paths found in audit, use file-type detection for buffer handlers without, breaking generic multimedia fallback, and sync plugin and operator docs with shipped behavior 2026-06-27 10:50:59 -04:00
adrs feat(search): make topology-assisted retrieval the default (#57) 2026-07-13 20:26:43 -04:00
api fix(audit): remove no-op storage and metadata paths found in audit, use file-type detection for buffer handlers without, breaking generic multimedia fallback, and sync plugin and operator docs with shipped behavior 2026-06-27 10:50:59 -04:00
architecture Sync experimental into main: Search retrieval improvements (#60) 2026-07-24 19:00:22 -04:00
assets feat: daemon stability fixes, vector search optimizations, and docs refresh (#46) 2026-06-10 10:30:38 -04:00
benchmarks feat(search): make topology-assisted retrieval the default (#57) 2026-07-13 20:26:43 -04:00
changelogs Assertion hardening, metadata correctness, & daemon lifecycle fixes (#41) 2026-06-04 12:53:42 -04:00
ci fix: ci stabilizations for release 2026-07-04 09:28:59 -04:00
design perf: improve ingestion optimization and profiling infrastructure (#52) 2026-06-19 17:32:19 -04:00
developer feat(search): make topology-assisted retrieval the default (#57) 2026-07-13 20:26:43 -04:00
ecosystem v0.7.5 staging and license updates 2025-10-13 17:07:31 -04:00
hosting feat: daemon stability fixes, vector search optimizations, and docs refresh (#46) 2026-06-10 10:30:38 -04:00
prompts Sync experimental into main: Search retrieval improvements (#60) 2026-07-24 19:00:22 -04:00
rfcs chore: stabilize CI, faiss, metadata, docker, and simeon (#25) 2026-05-07 21:07:59 -04:00
skills/yams perf(search): bound topology routing and harden runtime paths (#59) 2026-07-19 14:53:10 -04:00
spec fix(audit): remove no-op storage and metadata paths found in audit, use file-type detection for buffer handlers without, breaking generic multimedia fallback, and sync plugin and operator docs with shipped behavior 2026-06-27 10:50:59 -04:00
user_guide Sync experimental into main: Search retrieval improvements (#60) 2026-07-24 19:00:22 -04:00
BUILD.md fix(docs): Replace 2026-06-27 16:28:08 -04:00
index.md feat: daemon stability fixes, vector search optimizations, and docs refresh (#46) 2026-06-10 10:30:38 -04:00
newsletter.md security: dev scripts and hooks update, perf update, security fixes for quality issues 2026-05-02 21:40:47 -04:00
PLUGINS.md fix(audit): remove no-op storage and metadata paths found in audit, use file-type detection for buffer handlers without, breaking generic multimedia fallback, and sync plugin and operator docs with shipped behavior 2026-06-27 10:50:59 -04:00
PROMPT-eng.md perf(search): bound topology routing and harden runtime paths (#59) 2026-07-19 14:53:10 -04:00
PROMPT.md improvements for daemon lifecycle, tree repair, and mcp regression 2025-11-26 14:22:35 -05:00
README.md fix(testing): stabilize TSAN coverage, harden daemon shutdown, and speed up KG/storage paths (#53) 2026-06-26 17:57:02 -04:00
release-policy.md ci: improve release please configuration and CHANGELOG 2026-05-04 11:11:45 -04:00
roadmap.md fix(testing): stabilize TSAN coverage, harden daemon shutdown, and speed up KG/storage paths (#53) 2026-06-26 17:57:02 -04:00

YAMS Documentation

Content-addressed storage with deduplication and semantic search.

Site landing: index.md • Project README: ../README.md

User guide

Topic Link
Install user_guide/installation.md
CLI reference user_guide/cli.md
MCP server user_guide/mcp.md
Embeddings user_guide/embeddings.md
Tuning / diagnostics user_guide/cli.md
Plugins PLUGINS.md
Build from source BUILD.md
Admin / ops admin/operations.md
Self-hosting hosting/self_hosting.md
Changelog changelogs/
Roadmap roadmap.md
Release policy release-policy.md

Developer / reference

Topic Link
System Architecture architecture/system_architecture.md
API (MCP, plugins) api/
Plugin spec (WIT, schemas) spec/
Contributing developer/contributing.md
Build system internals developer/build_system.md
Profiling developer/profiling.md
Benchmarks benchmarks/README.md
Design docs design/
ADRs adrs/
RFCs rfcs/

External