Closes #114, #115, #116, #117. - Deterministic, offline, dependency-free char-ngram embedding backend + config section (semantic.enabled default false, min_similarity, backend). - Committed embedding index (data/kb_embedding_index.json) mapping vectors to real KB entry ids only; built by scripts/build_embedding_index.py, loaded once/cached. - Resolver falls back to the nearest entry on a deterministic miss when enabled, accepting >= min_similarity and emitting SC0020; NSFW-gated neighbours are skipped. Disabled => byte-identical to before. - Guarantee tests: deterministic lookup always wins (exact hit never queries the index), fallback emits only KB tags (no invention), identical input => identical output. SC0020 registered. Co-authored-by: kunail0804 <kunail0804@gmail.com> Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Documentation
Project documentation is maintained primarily in the
GitHub Wiki, and the
authoritative specification is MASTER_SPEC.md at the
repository root.
This docs/ directory holds documentation that is not part of the wiki —
for example design notes, developer guides, and generated references added in
later phases.
Where to look
- Overview & vision — wiki Overview and Vision
- Requirements — wiki Requirements and Success Criteria
- Architecture & pipeline — wiki Architecture and Pipeline
- Data model & schemas — wiki Data Model, Scene JSON and Schemas
- Knowledge Base — wiki Knowledge Base
- Contributing —
CONTRIBUTING.md