schemarouter 0.3.0__tar.gz → 0.4.0__tar.gz

{schemarouter-0.3.0 → schemarouter-0.4.0}/.github/workflows/ci.yml

@@ -52,7 +52,7 @@ jobs:
         with:
           python-version: "3.12"
       - run: python -m pip install --upgrade pip
-      - run: pip install -e ".[dev,mcp,langchain,llamaindex,jev,otel]"
+      - run: pip install -e ".[dev,mcp,langchain,langgraph,llamaindex,jev,otel]"
       - run: pyright
 
   coverage:
@@ -63,7 +63,7 @@ jobs:
         with:
           python-version: "3.12"
       - run: python -m pip install --upgrade pip
-      - run: pip install -e ".[dev,mcp,langchain,llamaindex,jev,otel]"
+      - run: pip install -e ".[dev,mcp,langchain,langgraph,llamaindex,jev,otel]"
       - run: pytest -q --cov=schemarouter --cov-branch --cov-report=term-missing --cov-report=xml:coverage.xml
       - uses: actions/upload-artifact@v7
         with:
@@ -127,9 +127,10 @@ jobs:
         with:
           python-version: "3.12"
       - run: python -m pip install --upgrade pip
-      - run: pip install -e ".[dev,langchain]"
-      - run: pytest -q tests/test_langchain_integration.py
+      - run: pip install -e ".[dev,langchain,langgraph]"
+      - run: pytest -q tests/test_langchain_integration.py tests/test_langgraph_integration.py
       - run: python examples/langchain_quickstart.py
+      - run: python examples/langgraph_quickstart.py
 
   llamaindex-integration:
     runs-on: ubuntu-latest

{schemarouter-0.3.0 → schemarouter-0.4.0}/CHANGELOG.md

@@ -7,6 +7,61 @@ The project is pre-1.0 and follows the compatibility rules in
 
 ## Unreleased
 
+## 0.4.0 - 2026-09-22
+
+### Added
+
+- trusted ordered sync/async before/after execution hooks with detached schema/call/result
+  snapshots, non-transforming None-only return contracts, post-await schema/binding refresh, and
+  fail-closed non-retryable hook errors.
+- explicit opt-in bounded same-origin OpenAPI cross-document `$ref` bundling with schema-header
+  credential confinement, redirect/origin enforcement, depth/document/aggregate-byte budgets,
+  complete-document JSON/YAML parsing, cycle caching, runtime schema preservation, and fail-closed
+  handling for `$id` rebasing and non-JSON-Pointer anchors.
+- exact-recall candidate indexing cached by registry version, with exhaustive-mode parity tests,
+  stable-snapshot rebuilds, synthetic scorer-call benchmarking, and no approximate pruning.
+- conservative bounded `evidence_sufficiency` decision surface with deterministic local
+  provenance/license/unit/source-type prechecks, provider veto-only semantics, sync/async support,
+  abstention/error fallback policy, and no ability to upgrade missing evidence.
+- explicit `FieldSpec.path` nested-object projection with logical field IDs, full raw-output
+  validation before extraction, overlap/collision fail-closed validation, planner path-token
+  matching, local projection enforcement for nested paths, and detached projected values.
+- bounded `field_selection` decision surface that exposes only declared non-identifier output
+  fields, always preserves identifier fields locally, caps selections by the deterministic
+  projection width, recomputes evidence from the final field set, and supports sync/async
+  deterministic fallback.
+- append-only `SQLiteRunTraceStore` with strict sequence/run/timestamp invariants, corruption
+  fail-closed validation, direct `astream_events(..., trace_store=...)` persistence, redaction-
+  preserving storage, and non-executing historical replay.
+- transactional `SQLiteRegistry` persistence with monotonic version retention, deterministic tool
+  ordering, atomic batch writes, JSON-only storage, corruption/key-mismatch fail-closed validation,
+  and no persistence of trusted invokers or credentials.
+- local Ollama bounded-decision backend using structured JSON Schema output, local option-ID
+  revalidation, sync/async HTTP paths, redirect rejection, token metadata capture, adversarial
+  mock-transport tests, and shared benchmark-harness support.
+- provider-neutral `EmbeddingDecisionBackend` with sync/async embedding callables, cosine ranking,
+  bounded top-k selection, similarity/margin abstention, malformed-vector fail-closed validation,
+  and common benchmark-harness support.
+- OpenAPI planner fidelity for chained local references, local Path Item references, safe
+  same-document URI-reference normalization during URL ingestion, and object property/required
+  discovery through `allOf` while preserving runtime schema validation.
+- native LangGraph `StateGraph` integration through `schemarouter[langgraph]`, with sync/async
+  execution, checkpoint-friendly result serialization, custom state-to-request adaptation, contract
+  tests, and a runnable example.
+
+### Changed
+
+- promoted the 0.4 development line to the non-prerelease `0.4.0` release after the persistence,
+  bounded-decision, OpenAPI, LangGraph, and execution-hook surfaces passed the required release gates.
+
+### Compatibility
+
+- no intentional public API removals are introduced relative to `0.3.0`;
+- new operational surfaces remain opt-in where they can affect persistence, model-assisted decisions,
+  cross-document network access, or execution interception;
+- the project remains pre-1.0, so later 0.x minor releases may still include deliberate documented
+  compatibility changes.
+
 ## 0.3.0 - 2026-09-22
 
 ### Changed

{schemarouter-0.3.0 → schemarouter-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: schemarouter
-Version: 0.3.0
+Version: 0.4.0
 Summary: Schema-aware planning and execution layer for LLM tool ecosystems
 Project-URL: Homepage, https://github.com/JDeun/SchemaRouter
 Project-URL: Repository, https://github.com/JDeun/SchemaRouter
@@ -44,6 +44,8 @@ Provides-Extra: jev
 Requires-Dist: typesafe-sdk<1,>=0.7; extra == 'jev'
 Provides-Extra: langchain
 Requires-Dist: langchain-core<2,>=1.6; extra == 'langchain'
+Provides-Extra: langgraph
+Requires-Dist: langgraph<2,>=1.2; extra == 'langgraph'
 Provides-Extra: llamaindex
 Requires-Dist: llama-index-core<1,>=0.14; extra == 'llamaindex'
 Provides-Extra: mcp
@@ -90,7 +92,7 @@ SchemaRouter is intentionally narrower than LangChain or LangGraph. It is design
 **tool-schema boundary** between an agent and structured capability sources such as OpenAPI, MCP,
 OPTIMADE, Python callables, and third-party adapter protocols.
 
-> Status: **0.3.0 is the current public non-prerelease release**. Install it from PyPI with
+> Status: **0.4.0 is the current public non-prerelease release**. Install it from PyPI with
 > `pip install schemarouter`. SchemaRouter remains pre-1.0, so deliberate compatibility changes
 > may still occur in later 0.x minor releases under the documented versioning policy.
 
@@ -164,6 +166,17 @@ router = await SchemaRouter.from_url(
 )
 ```
 
+Cross-document OpenAPI `$ref` fetching stays off by default. Trusted callers can opt into bounded
+same-origin resolution:
+
+```python
+router = await SchemaRouter.from_url(
+    "https://api.example.com/openapi.json",
+    kind="openapi",
+    openapi_external_refs=True,
+)
+```
+
 ### OPTIMADE
 
 ```python
@@ -218,18 +231,28 @@ evidence-grounded proposal and then requires explicit approval.
   executable calls.
 - **Runtime JSON Schema validation** — validate arguments before invocation and raw output before
   projection.
+- **Bounded nested projection** — declared logical fields may map to explicit nested object paths
+  without allowing model-produced JSONPath or undeclared field traversal.
 - **Schema and binding drift detection** — stale plans and stale transports fail closed.
 - **Local execution authority** — remote metadata and model output cannot grant mutation or
   destructive permissions.
 - **Credential separation** — schema-fetch credentials and runtime credentials stay in different
   channels; authenticated MCP keeps secrets in the trusted transport boundary.
+- **Bounded OpenAPI external refs** — cross-document `$ref` loading is explicit opt-in, confined to
+  the entry-document origin, and bounded by redirect/depth/document/byte limits.
 - **Read-only retries by default** — contract violations are never retried.
 - **Per-call approval and execution budgets** — trusted local callbacks and deterministic call,
   attempt, remote, time, quota, and cost-unit limits fail closed.
+- **Trusted execution hooks** — ordered sync/async before/after hooks receive detached snapshots,
+  cannot transform calls/results, and fail closed without turning hook failures into tool retries.
 - **OpenAPI compatibility reporting** — partial/unsupported constructs are machine-readable instead
   of silently reinterpreted.
 - **Redacted runtime events by default** — payload tracing is opt-in.
-- **Pluggable registry** — custom registries can implement the public `ToolRegistry` protocol.
+- **Replayable persistent traces** — `SQLiteRunTraceStore` can persist validated event streams and
+  replay them later without re-running planners, network calls, or tools.
+- **Persistent/pluggable registry** — use the built-in transactional `SQLiteRegistry` or inject a
+  custom implementation of the public `ToolRegistry` protocol. Persistent catalog state never
+  serializes trusted invokers or credentials.
 - **Pluggable source adapters** — `AdapterRegistry` lets structured protocols compile into the same
   `ToolSpec` / `EndpointSpec` execution model; installed entry-point plugins require an explicit
   allowlist before import.
@@ -250,6 +273,21 @@ tools = to_langchain_tools(router)
 
 Execution still flows through SchemaRouter's policy, fingerprint, input, and output validation.
 
+## With LangGraph
+
+```bash
+pip install "schemarouter[langgraph]"
+```
+
+```python
+from schemarouter.integrations import to_langgraph_node
+
+builder.add_node("schema_router", to_langgraph_node(router))
+```
+
+The node supports sync/async `StateGraph` execution and returns checkpoint-friendly partial state
+updates while SchemaRouter retains planning, policy, and validated execution authority.
+
 ## With LlamaIndex
 
 Install the packaged LlamaIndex bridge:
@@ -269,8 +307,8 @@ endpoint execution.
 
 ## Experimental bounded decisions
 
-SchemaRouter includes an optional bounded `DecisionBackend` for tool/endpoint selection. It is
-**off by default** and cannot invent executable schema members.
+SchemaRouter includes an optional bounded `DecisionBackend` for tool/endpoint and output-field
+selection. It is **off by default** and cannot invent executable schema members.
 
 ```python
 from schemarouter import DecisionPolicy, SchemaPlanner
@@ -287,6 +325,23 @@ planner = SchemaPlanner(
 )
 ```
 
+A provider-neutral local embedding backend is also available without adding an embedding library to
+SchemaRouter's dependencies:
+
+```python
+from schemarouter import EmbeddingDecisionBackend
+
+backend = EmbeddingDecisionBackend(
+    embed_batch,
+    min_similarity=0.35,
+    min_margin=0.05,
+)
+```
+
+The callable can wrap a local SentenceTransformers/FastEmbed-style encoder or an application-owned
+embedding service. SchemaRouter computes cosine ranking locally and can abstain on weak or ambiguous
+matches.
+
 Jev / TypeSafe System One is optional:
 
 ```bash
@@ -298,6 +353,44 @@ The provider receives only bounded decision inputs. Unknown option IDs fail clos
 valid choices can abstain, and deterministic fallback remains available. Jev is never enabled just
 because the package or an API key exists.
 
+A local Ollama model can also serve as a bounded decision backend without an additional Python SDK:
+
+```python
+from schemarouter.integrations import OllamaDecisionBackend
+
+backend = OllamaDecisionBackend("your-installed-model")
+```
+
+Ollama structured output constrains the finite option IDs, and SchemaRouter revalidates the result
+locally. No local model is enabled automatically.
+
+Bounded field selection is independently opt-in:
+
+```python
+policy = DecisionPolicy(
+    enabled=True,
+    field_selection=True,
+    fallback="deterministic",
+)
+```
+
+Only declared non-identifier fields are offered to the backend. Identifier fields are always
+preserved locally, and invalid/abstaining provider output falls back to deterministic projection.
+
+Evidence sufficiency is independently opt-in as a conservative gate:
+
+```python
+policy = DecisionPolicy(
+    enabled=True,
+    evidence_sufficiency=True,
+    fallback="deterministic",
+)
+```
+
+Requested provenance/license/unit/source-type requirements must first be satisfied by local schema
+metadata. The backend then receives only `evidence:sufficient` / `evidence:insufficient` and can
+veto a locally sufficient call, but it cannot upgrade missing evidence or grant execution authority.
+
 ## Decision benchmark
 
 Run the deterministic baseline:
@@ -306,16 +399,31 @@ Run the deterministic baseline:
 python scripts/benchmark_decision_routing.py
 ```
 
+Compare an embedding backend through a local callable:
+
+```bash
+python scripts/benchmark_decision_routing.py \
+  --corpus benchmarks/decision-routing-v1.json \
+  --embedding-callable my_embeddings:embed_batch
+```
+
 Compare Jev when credentials are available:
 
 ```bash
 TYPESAFE_API_KEY="..." python scripts/benchmark_decision_routing.py --jev
 ```
 
+Compare an installed local Ollama model:
+
+```bash
+python scripts/benchmark_decision_routing.py --ollama-model your-installed-model
+```
+
 The harness includes a checked-in 144-case multilingual/adversarial corpus and reports routing
 accuracy, invalid-plan rate, abstentions/fallbacks, category accuracy, p50/p95 latency, token usage,
 errors, and optional cost estimates. A provider-neutral `ModelQueryAnalyzer` callable can also be
-supplied with `--model-callable module:function`.
+supplied with `--model-callable module:function`; embedding encoders use
+`--embedding-callable module:function`.
 
 ```bash
 python scripts/benchmark_decision_routing.py \
@@ -337,10 +445,15 @@ Full documentation is organized as a framework manual rather than embedded in th
 - [LangChain integration](https://jdeun.github.io/SchemaRouter/integrations/langchain/)
 - [LlamaIndex integration](https://jdeun.github.io/SchemaRouter/integrations/llamaindex/)
 - [Jev / TypeSafe integration](https://jdeun.github.io/SchemaRouter/integrations/jev/)
+- [Ollama decision backend](https://jdeun.github.io/SchemaRouter/integrations/ollama/)
 - [OpenTelemetry integration](https://jdeun.github.io/SchemaRouter/integrations/opentelemetry/)
 - [Third-party adapter plugins](https://jdeun.github.io/SchemaRouter/guides/adapter-plugins/)
 - [Decision backends](https://jdeun.github.io/SchemaRouter/concepts/decision-backends/)
 - [Decision benchmark](https://jdeun.github.io/SchemaRouter/guides/decision-benchmark/)
+- [Persistent run traces](https://jdeun.github.io/SchemaRouter/guides/run-traces/)
+- [Trusted execution hooks](https://jdeun.github.io/SchemaRouter/guides/execution-hooks/)
+- [Field projection](https://jdeun.github.io/SchemaRouter/guides/field-projection/)
+- [Candidate indexing](https://jdeun.github.io/SchemaRouter/guides/candidate-indexing/)
 - [API reference](https://jdeun.github.io/SchemaRouter/reference/api/)
 - [Architecture](https://jdeun.github.io/SchemaRouter/architecture/)
 - [Security](https://github.com/JDeun/SchemaRouter/blob/main/SECURITY.md)
@@ -365,7 +478,7 @@ python examples/quickstart.py
 python scripts/benchmark_decision_routing.py
 
 # Type-check the complete packaged surface, including optional integrations.
-pip install -e ".[dev,mcp,langchain,llamaindex,jev,otel]"
+pip install -e ".[dev,mcp,langchain,langgraph,llamaindex,jev,otel]"
 pyright
 pytest -q --cov=schemarouter --cov-branch --cov-report=term-missing
 ```

{schemarouter-0.3.0 → schemarouter-0.4.0}/README.ko.md

@@ -35,7 +35,7 @@ SchemaRouter는 LangChain이나 LangGraph를 대체하는 범용 에이전트
 OpenAPI, MCP, OPTIMADE, Python callable 및 제3자 어댑터와 에이전트 사이의
 **tool-schema boundary**를 담당하도록 설계되었습니다.
 
-> 현재 공개 non-prerelease 릴리스는 **0.3.0**입니다. PyPI에서
+> 현재 공개 non-prerelease 릴리스는 **0.4.0**입니다. PyPI에서
 > `pip install schemarouter`로 설치할 수 있습니다. SchemaRouter는 아직 pre-1.0이므로
 > 이후 0.x minor 릴리스에서는 문서화된 버전 정책에 따라 의도적인 호환성 변경이 있을 수 있습니다.
 
@@ -109,6 +109,17 @@ router = await SchemaRouter.from_url(
 )
 ```
 
+OpenAPI cross-document `$ref` fetch는 기본적으로 꺼져 있습니다. 신뢰된 호출자가 명시적으로
+same-origin bounded resolution을 켤 수 있습니다.
+
+```python
+router = await SchemaRouter.from_url(
+    "https://api.example.com/openapi.json",
+    kind="openapi",
+    openapi_external_refs=True,
+)
+```
+
 ### OPTIMADE
 
 ```python
@@ -163,20 +174,27 @@ proposal로 변환한 뒤 명시적인 승인을 받아야 합니다.
   가능한 호출이 될 수 없습니다.
 - **Runtime JSON Schema validation** — 호출 전 argument와 projection 전 raw output을
   검증합니다.
+- **Bounded nested projection** — 선언된 logical field만 명시적 nested object path에
+  매핑할 수 있으며 모델이 임의 JSONPath나 미선언 경로를 만들 수 없습니다.
 - **Schema / binding drift detection** — 오래된 plan이나 transport binding은 fail closed로
   차단합니다.
 - **Local execution authority** — 원격 metadata나 모델 출력이 mutation/destructive 권한을
   부여할 수 없습니다.
 - **Credential separation** — schema fetch credential과 runtime credential을 분리하며,
   인증 MCP secret은 trusted transport 경계 안에만 둡니다.
+- **Bounded OpenAPI external ref** — cross-document `$ref`는 명시적 opt-in일 때만 entry
+  document와 같은 origin에서 fetch되며 redirect/depth/document/byte limit을 적용합니다.
 - **Read-only retry by default** — 계약 위반이나 위험한 호출을 자동 재시도하지 않습니다.
 - **호출별 승인 및 실행 budget** — trusted local callback과 call/attempt/remote/time/quota/
   cost-unit 제한을 fail-closed로 적용합니다.
+- **Trusted execution hook** — 순서가 보장되는 sync/async before/after hook은 detached snapshot만
+  받고 call/result를 변환하지 못하며, hook 실패를 tool retry로 오인하지 않고 fail closed 처리합니다.
 - **OpenAPI compatibility report** — partial/unsupported construct를 숨기지 않고
   machine-readable report로 노출합니다.
 - **Redacted runtime event by default** — payload trace는 명시적으로 opt-in해야 합니다.
-- **Pluggable registry** — 커스텀 registry는 공개 `ToolRegistry` protocol을 구현할 수
-  있습니다.
+- **Persistent/pluggable registry** — built-in transactional `SQLiteRegistry`를 사용하거나
+  공개 `ToolRegistry` protocol 기반 커스텀 구현을 주입할 수 있습니다. persistent catalog에는
+  trusted invoker나 credential을 직렬화하지 않습니다.
 - **Pluggable adapter** — `AdapterRegistry`를 통해 다양한 structured protocol을 동일한
   `ToolSpec` / `EndpointSpec` 실행 모델로 변환할 수 있으며, 설치된 entry-point plugin은
   명시적 allowlist가 있어야 import됩니다.
@@ -198,6 +216,21 @@ tools = to_langchain_tools(router)
 LangChain 도구로 노출해도 실행은 SchemaRouter의 policy, fingerprint, input/output validation
 경계를 그대로 통과합니다.
 
+## LangGraph와 사용
+
+```bash
+pip install "schemarouter[langgraph]"
+```
+
+```python
+from schemarouter.integrations import to_langgraph_node
+
+builder.add_node("schema_router", to_langgraph_node(router))
+```
+
+이 노드는 sync/async `StateGraph` 실행을 지원하고 checkpoint에 적합한 partial state update를
+반환합니다. planning, policy, 검증된 execution authority는 SchemaRouter가 계속 유지합니다.
+
 ## LlamaIndex와 사용
 
 LlamaIndex bridge는 패키지 extra로 설치할 수 있습니다.
@@ -217,8 +250,8 @@ validation 및 endpoint execution 경계를 유지합니다.
 
 ## 실험적 bounded decision
 
-SchemaRouter는 tool/endpoint 선택을 보조하는 opt-in `DecisionBackend`를 제공합니다.
-기본값은 **OFF**이며 모델이 임의의 실행 가능한 스키마 멤버를 만들 수 없습니다.
+SchemaRouter는 tool/endpoint와 output field 선택을 보조하는 opt-in `DecisionBackend`를
+제공합니다. 기본값은 **OFF**이며 모델이 임의의 실행 가능한 스키마 멤버를 만들 수 없습니다.
 
 ```python
 from schemarouter import DecisionPolicy, SchemaPlanner
@@ -235,6 +268,23 @@ planner = SchemaPlanner(
 )
 ```
 
+특정 provider에 종속되지 않는 local embedding backend도 core dependency 추가 없이 사용할 수
+있습니다.
+
+```python
+from schemarouter import EmbeddingDecisionBackend
+
+backend = EmbeddingDecisionBackend(
+    embed_batch,
+    min_similarity=0.35,
+    min_margin=0.05,
+)
+```
+
+callable에는 local SentenceTransformers/FastEmbed 계열 encoder나 애플리케이션 소유 embedding
+service를 연결할 수 있습니다. cosine ranking은 SchemaRouter가 로컬에서 수행하며 약하거나
+모호한 선택은 abstain할 수 있습니다.
+
 Jev / TypeSafe System One은 선택형 기능입니다.
 
 ```bash
@@ -248,6 +298,45 @@ abstain한 뒤 deterministic fallback으로 돌아갈 수 있습니다.
 
 패키지를 설치했거나 API key가 존재한다는 이유만으로 Jev가 자동 활성화되지는 않습니다.
 
+로컬 Ollama 모델도 별도 Python SDK 없이 bounded decision backend로 사용할 수 있습니다.
+
+```python
+from schemarouter.integrations import OllamaDecisionBackend
+
+backend = OllamaDecisionBackend("your-installed-model")
+```
+
+Ollama structured output으로 유한한 option ID를 제한하고, SchemaRouter가 결과를 다시 로컬
+검증합니다. 로컬 모델이 존재한다는 이유만으로 자동 활성화되지는 않습니다.
+
+bounded field selection도 별도로 opt-in할 수 있습니다.
+
+```python
+policy = DecisionPolicy(
+    enabled=True,
+    field_selection=True,
+    fallback="deterministic",
+)
+```
+
+backend에는 선언된 non-identifier field만 제공되고 identifier field는 항상 로컬에서
+보존됩니다. invalid output이나 abstain은 deterministic projection으로 fallback됩니다.
+
+Evidence sufficiency도 별도로 opt-in할 수 있는 보수적 gate입니다.
+
+```python
+policy = DecisionPolicy(
+    enabled=True,
+    evidence_sufficiency=True,
+    fallback="deterministic",
+)
+```
+
+요청된 provenance/license/unit/source-type은 먼저 로컬 schema metadata로 충족되어야 합니다.
+그 뒤 backend는 `evidence:sufficient` / `evidence:insufficient` 두 선택지만 받으며,
+로컬에서 충분한 call을 veto할 수 있을 뿐 없는 evidence를 만들어내거나 실행 권한을 높일 수
+없습니다.
+
 ## Decision benchmark
 
 기본 deterministic routing을 측정합니다.
@@ -256,16 +345,31 @@ abstain한 뒤 deterministic fallback으로 돌아갈 수 있습니다.
 python scripts/benchmark_decision_routing.py
 ```
 
+local embedding callable도 같은 corpus에서 비교할 수 있습니다.
+
+```bash
+python scripts/benchmark_decision_routing.py \
+  --corpus benchmarks/decision-routing-v1.json \
+  --embedding-callable my_embeddings:embed_batch
+```
+
 API key가 있다면 같은 케이스로 Jev도 비교할 수 있습니다.
 
 ```bash
 TYPESAFE_API_KEY="..." python scripts/benchmark_decision_routing.py --jev
 ```
 
+설치된 로컬 Ollama 모델도 같은 corpus로 비교할 수 있습니다.
+
+```bash
+python scripts/benchmark_decision_routing.py --ollama-model your-installed-model
+```
+
 benchmark에는 144개 multilingual/adversarial 고정 corpus가 포함되며 routing accuracy,
 invalid-plan rate, abstention/fallback, category accuracy, p50/p95 latency, token usage, error와
 선택적인 비용 추정치를 기록합니다. `--model-callable module:function`을 이용하면
-provider-neutral `ModelQueryAnalyzer`도 같은 harness에서 비교할 수 있습니다.
+provider-neutral `ModelQueryAnalyzer`도 같은 harness에서 비교할 수 있고, embedding
+encoder는 `--embedding-callable module:function`으로 연결할 수 있습니다.
 
 ```bash
 python scripts/benchmark_decision_routing.py \
@@ -287,10 +391,15 @@ python scripts/benchmark_decision_routing.py \
 - [LangChain integration](https://jdeun.github.io/SchemaRouter/integrations/langchain/)
 - [LlamaIndex integration](https://jdeun.github.io/SchemaRouter/integrations/llamaindex/)
 - [Jev / TypeSafe integration](https://jdeun.github.io/SchemaRouter/integrations/jev/)
+- [Ollama decision backend](https://jdeun.github.io/SchemaRouter/integrations/ollama/)
 - [OpenTelemetry integration](https://jdeun.github.io/SchemaRouter/integrations/opentelemetry/)
 - [Third-party adapter plugins](https://jdeun.github.io/SchemaRouter/guides/adapter-plugins/)
 - [Decision backends](https://jdeun.github.io/SchemaRouter/concepts/decision-backends/)
 - [Decision benchmark](https://jdeun.github.io/SchemaRouter/guides/decision-benchmark/)
+- [Persistent run traces](https://jdeun.github.io/SchemaRouter/guides/run-traces/)
+- [Trusted execution hooks](https://jdeun.github.io/SchemaRouter/guides/execution-hooks/)
+- [Field projection](https://jdeun.github.io/SchemaRouter/guides/field-projection/)
+- [Candidate indexing](https://jdeun.github.io/SchemaRouter/guides/candidate-indexing/)
 - [API reference](https://jdeun.github.io/SchemaRouter/reference/api/)
 - [Architecture](https://jdeun.github.io/SchemaRouter/architecture/)
 - [Security](https://github.com/JDeun/SchemaRouter/blob/main/SECURITY.md)
@@ -315,7 +424,7 @@ python examples/quickstart.py
 python scripts/benchmark_decision_routing.py
 
 # 선택형 통합을 포함한 전체 패키지 surface 타입 검사
-pip install -e ".[dev,mcp,langchain,llamaindex,jev,otel]"
+pip install -e ".[dev,mcp,langchain,langgraph,llamaindex,jev,otel]"
 pyright
 pytest -q --cov=schemarouter --cov-branch --cov-report=term-missing
 ```