diff --git a/README.md b/README.md
index 3d945ae..c3f96d7 100644
--- a/README.md
+++ b/README.md
@@ -3,11 +3,11 @@
 Rust SDK core for Korea Investment & Securities Open API.
 
 `kis-sdk` is an early Rust client and local mock contract harness for KIS Open
-API integrations. The current typed SDK surface is intentionally narrow: it
-focuses on OAuth token issuance and a small domestic stock slice. A lower-level
-inventory-backed execution API can address and call the broader bundled
-official endpoint inventory by stable operation id while follow-on work adds
-more ergonomic typed wrappers.
+API integrations. The narrow typed SDK surface focuses on OAuth token issuance
+and a small domestic stock slice, while inventory-backed SDK APIs account for
+all 338 endpoints in the bundled official inventory by stable operation id.
+Follow-on work can add more ergonomic typed wrappers without changing the
+current coverage boundary.
 
 ## Current Status
 
@@ -18,6 +18,8 @@ more ergonomic typed wrappers.
 - Supported runtime: async Rust with `tokio`, `reqwest`, and rustls TLS.
 - Official contract snapshot: `contracts/kis_official_endpoint_inventory.compact.json`,
   captured on 2026-05-29 Asia/Seoul.
+- Inventory reconciliation: 338/338 official endpoints are accounted for by
+  typed methods, scoped inventory APIs, or lower-level `execute_inventory`.
 
 ## Features
 
@@ -112,6 +114,14 @@ async fn main() -> Result<(), kis_sdk::KisError> {
 
 ## Supported API Scope
 
+The current SDK surface has two layers:
+
+- Typed methods for OAuth and selected domestic stock workflows.
+- Inventory-backed methods for the full bundled official endpoint inventory.
+  These methods validate required inventory fields and safety rules before
+  network I/O, but they do not yet provide narrow Rust request/response structs
+  for every endpoint.
+
 The typed SDK currently exposes:
 
 | Method | KIS path | Notes |
@@ -187,6 +197,29 @@ network I/O, standard KIS headers are filled by the client, ambiguous TR IDs
 require an explicit override, real-only endpoints are rejected in mock mode, and
 real trading mutations are locally blocked.
 
+## Endpoint Inventory Coverage
+
+The machine-checkable reconciliation test
+`full_inventory_reconciliation_accounts_for_every_official_endpoint_once`
+proves that every endpoint in the bundled official inventory is assigned to
+exactly one SDK-callable coverage surface:
+
+| Coverage surface | Endpoint count |
+| --- | ---: |
+| OAuth typed methods | 3 |
+| Domestic stock REST inventory API | 158 |
+| Domestic stock realtime tryitout inventory API | 29 |
+| Domestic futures/options inventory API | 44 |
+| Overseas stock inventory API | 51 |
+| Overseas futures/options inventory API | 35 |
+| Listed bond inventory API | 18 |
+| **Total accounted official inventory** | **338/338** |
+
+See [`docs/contract-quality-report.md`](docs/contract-quality-report.md) for
+the collection split, mock-contract evidence, and known limitations. The
+coverage count is based on the captured BOG-221 inventory snapshot, not a live
+portal re-scrape.
+
 The overseas stock SDK surface pins inventory-backed endpoint handles for these
 collections:
 
@@ -242,9 +275,10 @@ Repository checks used for the current SDK and documentation baseline:
 
 ```sh
 cargo fmt --check
-cargo check
-cargo clippy --all-targets -- -D warnings
-cargo test
+cargo test --locked
+cargo test --locked --test mock_server_contract
+cargo doc --locked --no-deps
+git diff --check
 ```
 
 Contract evidence is recorded in
@@ -259,6 +293,7 @@ mock support or explicit `KIS_MOCK_UNSUPPORTED_ENVIRONMENT` rejection.
 ## Usage Guide
 
 - [KIS SDK usage guide](docs/usage.md)
+- [KIS SDK Korean usage guide](docs/usage-ko.md)
 
 ## Release
 
diff --git a/docs/contract-quality-report.md b/docs/contract-quality-report.md
index c981782..e425359 100644
--- a/docs/contract-quality-report.md
+++ b/docs/contract-quality-report.md
@@ -79,9 +79,10 @@ execution methods for these follow-on slices:
 | `execute_bond_quotation` | Listed bond quotations | 8 | Real-only in bundled inventory. |
 | `execute_bond_realtime_tryitout` | Listed bond realtime | 3 | REST-style `/tryitout/*` inventory/mock-contract execution only; not live WebSocket subscription behavior. |
 
-The remaining official endpoints are represented in the bundled contract and
-mock route inventory, but are not yet promoted to typed SDK request/response
-methods or domain-scoped wrappers.
+All remaining official endpoints are represented in the bundled contract and
+mock route inventory, and are SDK-callable through scoped inventory APIs or the
+lower-level `execute_inventory` API. They are not all promoted to narrow typed
+request/response structs.
 
 ## Domestic Stock REST Inventory API
 
@@ -100,6 +101,30 @@ methods or domain-scoped wrappers.
 
 Executable coverage in `tests/sdk_core.rs` verifies the 158-endpoint scoped catalog, rejects domestic stock realtime operation ids, executes all 18 `real+mock` endpoints against the generated mock contract with inventory-derived request data, and confirms all 140 `real_only` endpoints are rejected in mock mode before network I/O.
 
+## Final Inventory Reconciliation
+
+`tests/sdk_core.rs::full_inventory_reconciliation_accounts_for_every_official_endpoint_once`
+is the machine-checkable 338/338 reconciliation gate. It builds the bundled
+`InventoryCatalog`, assigns every official operation id to exactly one SDK
+coverage surface, rejects duplicate assignments, and fails if any inventory
+operation id is missing from the coverage map.
+
+| Coverage surface | Count | SDK-callable status |
+| --- | ---: | --- |
+| OAuth typed methods | 3 | Covered by typed auth methods: token issue, token revoke, realtime approval key. |
+| Domestic stock REST inventory API | 158 | Covered by `execute_domestic_stock_rest`; includes the narrower typed domestic stock methods. |
+| Domestic stock realtime tryout inventory API | 29 | Covered by `execute_domestic_stock_realtime_tryitout`; REST-style tryout/mock-contract calls only. |
+| Domestic futures/options inventory API | 44 | Covered by domestic futures/options scoped inventory wrappers and operation-id constants. |
+| Overseas stock inventory API | 51 | Covered by `OverseasStockEndpoint` plus `execute_overseas_stock`. |
+| Overseas futures/options inventory API | 35 | Covered by `OverseasFuturesOptionsEndpoint` plus `execute_overseas_futures_options`. |
+| Listed bond inventory API | 18 | Covered by bond trading/account, quotation, and realtime tryout scoped inventory wrappers. |
+| **Total accounted official inventory** | **338** | **338/338 accounted; no unassigned official endpoint remains.** |
+
+This reconciliation intentionally distinguishes typed request/response methods
+from inventory-backed SDK-callable APIs. Endpoints without narrow typed Rust
+request/response structs remain callable through their scoped inventory API or
+the lower-level `execute_inventory` path with inventory-derived validation.
+
 ## Mock Contract Evidence
 
 The mock server loads the bundled contract through `ContractInventory::bundled()` and builds its route index from every `(method, path)` pair.
@@ -109,6 +134,8 @@ Executable coverage added in `tests/mock_server_contract.rs` and
 
 - Validates source metadata: official URL, checked date, 338 endpoints, 22 collections.
 - Verifies route index cardinality equals the official endpoint count.
+- Verifies the final 338/338 reconciliation map assigns every official endpoint
+  to exactly one SDK coverage surface.
 - Verifies domestic futures/options, domestic stock realtime, and listed bond
   domain helper constants cover their 91 targeted inventory endpoints exactly.
 - Starts the mock server and requests every bundled endpoint.
@@ -135,6 +162,6 @@ Executable coverage added in `tests/mock_server_contract.rs` and
 ## Known Limitations
 
 - BOG-221 source collection is a captured official inventory. This report does not perform a live re-scrape of the official portal.
-- Request and response schemas are preserved as contract metadata and mock output field names, but broad typed Rust structs have only been implemented for the initial domestic stock slice above.
+- Request and response schemas are preserved as contract metadata and mock output field names, but broad typed Rust structs have only been implemented for the initial domestic stock slice above. Other endpoints are SDK-callable through inventory-backed APIs rather than narrow typed request/response structs.
 - Ambiguous TR ID endpoints remain represented in the contract. Generic mock routing accepts them without forcing one side-specific TR ID unless the contract exposes a single concrete TR ID.
 - No production KIS credentials, account data, live trading, or live API calls were used.
diff --git a/docs/usage-ko.md b/docs/usage-ko.md
new file mode 100644
index 0000000..c5444dc
--- /dev/null
+++ b/docs/usage-ko.md
@@ -0,0 +1,471 @@
+# KIS SDK 한국어 사용 가이드
+
+이 문서는 현재 `kis-sdk` Rust 구현을 사용하는 애플리케이션 개발자를
+위한 한국어 가이드입니다. 먼저 로컬 mock server로 요청 형식과 안전
+경계를 검증한 뒤, 승인된 비밀 관리 경로를 통해 실거래 환경의 읽기
+요청을 연결하는 흐름을 기준으로 설명합니다.
+
+현재 SDK는 OAuth 토큰 발급/폐기, WebSocket approval key 발급, 일부
+국내주식 typed 메서드, 그리고 공식 inventory 기반 실행 API를 제공합니다.
+`contracts/kis_official_endpoint_inventory.compact.json`에 포함된 공식
+endpoint 338개는 typed 메서드, domain-scoped inventory API, 또는
+lower-level `execute_inventory` 경로 중 하나로 SDK에서 호출 가능한 상태로
+account됩니다. 모든 endpoint가 개별 Rust request/response struct로 승격된
+상태는 아닙니다.
+
+## 사전 준비
+
+- Rust 2021 toolchain
+- `tokio` 기반 async runtime
+- 로컬 개발과 테스트용 `kis-mock-server`
+- 실환경 읽기 호출에 사용할 KIS app key/app secret
+
+실제 app key, app secret, access token, approval key, 계좌번호, 고객 데이터는
+소스 코드, 테스트 fixture, 로그, 문서 예제에 넣지 마세요.
+
+## 의존성 추가
+
+현재 crate는 crates.io에 publish되지 않았고 `Cargo.toml`에 `publish = false`가
+유지되어 있습니다. 통합 브랜치를 직접 참조하세요.
+
+```toml
+[dependencies]
+kis-sdk = { git = "https://github.com/bogyie/kis-sdk", branch = "bog-220-kis-sdk" }
+tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
+serde_json = "1"
+```
+
+나중에 별도 승인으로 crates.io publish가 활성화되면 versioned dependency로
+전환할 수 있습니다.
+
+```toml
+[dependencies]
+kis-sdk = "0.1"
+tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
+serde_json = "1"
+```
+
+## 로컬 Mock Server 실행
+
+```sh
+cargo run --bin kis-mock-server -- 127.0.0.1:0
+```
+
+서버는 선택된 로컬 주소를 출력합니다.
+
+```text
+kis mock server listening on http://127.0.0.1:49152
+```
+
+출력된 URL을 client `base_url`로 사용합니다. 포트 `0`은 OS가 빈 포트를
+선택하게 하므로 병렬 테스트에 적합합니다.
+
+## Mock Client 생성
+
+Mock 요청도 KIS 요청과 같은 header 형태를 사용하므로 placeholder app
+credential과 dummy bearer token을 넣습니다.
+
+```rust
+use kis_sdk::{
+    config::Environment,
+    credentials::AppCredentials,
+    KisClient,
+};
+
+fn mock_client(base_url: &str) -> Result<KisClient, kis_sdk::KisError> {
+    KisClient::builder(Environment::Mock)
+        .base_url(base_url)
+        .app_credentials(AppCredentials::new("test_app_key", "test_app_secret"))
+        .static_bearer_token("test_access_token")
+        .build()
+}
+```
+
+위 값은 로컬 개발용 placeholder입니다. 운영 설정이나 공유 테스트 환경에
+실제 credential을 넣지 마세요.
+
+## OAuth와 Approval Key
+
+OAuth bearer token을 직접 발급해야 하면 `issue_access_token`을 사용합니다.
+
+```rust
+async fn issue_token(client: &kis_sdk::KisClient) -> Result<String, kis_sdk::KisError> {
+    let token = client.issue_access_token().await?;
+    Ok(token.access_token)
+}
+```
+
+토큰 폐기는 명시적으로 `revoke_access_token`을 호출해야 합니다. `KisClient`가
+drop될 때 자동 폐기하지 않습니다.
+
+```rust
+async fn revoke_token(
+    client: &kis_sdk::KisClient,
+    token: &str,
+) -> Result<(), kis_sdk::KisError> {
+    let response = client.revoke_access_token(token).await?;
+    assert_eq!(response.code, 200);
+    Ok(())
+}
+```
+
+KIS WebSocket client가 필요한 approval key는 `issue_realtime_approval_key`로
+발급합니다.
+
+```rust
+async fn websocket_approval_key(
+    client: &kis_sdk::KisClient,
+) -> Result<String, kis_sdk::KisError> {
+    let response = client.issue_realtime_approval_key().await?;
+    Ok(response.approval_key)
+}
+```
+
+이 메서드는 approval key 발급까지만 담당합니다. 현재 typed SDK는 live
+WebSocket session, subscription, reconnect, message decoding을 관리하지
+않습니다.
+
+## 국내주식 현재가 조회
+
+```rust
+use kis_sdk::apis::domestic_stock::InquirePriceRequest;
+
+async fn inquire_price(client: &kis_sdk::KisClient) -> Result<(), kis_sdk::KisError> {
+    let response = client
+        .inquire_domestic_stock_price(&InquirePriceRequest::new("005930"))
+        .await?;
+
+    if response.is_success() {
+        println!("quote output: {:?}", response.output);
+    }
+
+    Ok(())
+}
+```
+
+현재 응답 `output`은 provider field를 `serde_json::Value`로 보존합니다. 넓은
+범위의 typed response struct는 후속 작업에서 점진적으로 추가될 수 있습니다.
+
+## Inventory Endpoint 호출
+
+공식 inventory에 포함된 endpoint는 stable operation id와
+`execute_inventory`로 호출할 수 있습니다.
+
+```rust
+use kis_sdk::endpoint::InventoryRequest;
+use serde_json::json;
+
+async fn inventory_quote(client: &kis_sdk::KisClient) -> Result<(), kis_sdk::KisError> {
+    let response = client
+        .execute_inventory::<serde_json::Value>(
+            "domestic_stock_quotation.get_domestic_stock_quotations_inquire_price",
+            InventoryRequest::new().query(json!({
+                "FID_COND_MRKT_DIV_CODE": "J",
+                "FID_INPUT_ISCD": "005930"
+            })),
+        )
+        .await?;
+
+    assert!(response.is_success());
+    Ok(())
+}
+```
+
+국내주식 REST collection으로 scope를 제한하려면
+`execute_domestic_stock_rest`를 사용합니다. 이 helper는 국내주식
+주문/계좌, 기본시세, ELW, 업종/기타, 종목정보, 차트/분석, 순위분석
+collection의 158개 endpoint를 다룹니다.
+
+```rust
+use kis_sdk::endpoint::InventoryRequest;
+use serde_json::json;
+
+async fn domestic_stock_rest_quote(client: &kis_sdk::KisClient) -> Result<(), kis_sdk::KisError> {
+    let response = client
+        .execute_domestic_stock_rest::<serde_json::Value>(
+            "domestic_stock_quotation.get_domestic_stock_quotations_inquire_price",
+            InventoryRequest::new().query(json!({
+                "FID_COND_MRKT_DIV_CODE": "J",
+                "FID_INPUT_ISCD": "005930"
+            })),
+        )
+        .await?;
+
+    assert!(response.is_success());
+    Ok(())
+}
+```
+
+Inventory layer는 network I/O 전에 필수 query/body/non-standard header를
+검증합니다. `appkey`, `appsecret`, `authorization`, `custtype`,
+`content-type`, 명확한 `tr_id` 같은 표준 KIS header는 client가 채웁니다.
+TR ID가 여러 후보로 표현된 endpoint는 `InventoryRequest::tr_id_override(...)`
+를 통해 caller가 명시적으로 선택해야 합니다.
+
+## 해외주식 Endpoint 호출
+
+해외주식 SDK surface는 공식 inventory의 51개 endpoint를 enum handle로
+고정합니다. 원문 operation id 문자열 대신 안정적인 SDK handle을 쓰고 싶을 때
+`OverseasStockEndpoint`를 사용하세요.
+
+```rust
+use kis_sdk::{
+    apis::overseas_stock::OverseasStockEndpoint,
+    endpoint::InventoryRequest,
+};
+use serde_json::json;
+
+async fn overseas_price(client: &kis_sdk::KisClient) -> Result<(), kis_sdk::KisError> {
+    let response = client
+        .execute_overseas_stock::<serde_json::Value>(
+            OverseasStockEndpoint::GetOverseasPriceQuotationsPrice,
+            InventoryRequest::new().query(json!({
+                "AUTH": "",
+                "EXCD": "NAS",
+                "SYMB": "AAPL"
+            })),
+        )
+        .await?;
+
+    assert!(response.is_success());
+    Ok(())
+}
+```
+
+해외주식 주문 endpoint도 국내 주문과 같은 안전 경계를 따릅니다. 실환경의
+trading mutation은 network I/O 전에 `KisError::LiveTradingDisabled`를
+반환합니다.
+
+## 국내선물옵션 Endpoint 호출
+
+국내선물옵션 coverage는 44개 공식 endpoint를 scoped inventory API로
+제공합니다. 주문/계좌 15개, 시세 9개, 실시간시세 20개이며 operation id
+상수는 `kis_sdk::apis::domestic_futures_options`에서 제공합니다.
+
+```rust
+use kis_sdk::{
+    apis::domestic_futures_options::QUOTATION_OPERATION_IDS,
+    endpoint::InventoryRequest,
+};
+use serde_json::json;
+
+async fn domestic_futures_options_quote(
+    client: &kis_sdk::KisClient,
+) -> Result<(), kis_sdk::KisError> {
+    let response = client
+        .execute_domestic_futures_options_quotation::<serde_json::Value>(
+            QUOTATION_OPERATION_IDS[0],
+            InventoryRequest::new().query(json!({
+                "FID_COND_MRKT_DIV_CODE": "F",
+                "FID_INPUT_ISCD": "101W09"
+            })),
+        )
+        .await?;
+
+    assert!(response.is_success());
+    Ok(())
+}
+```
+
+주문 변경 성격의 국내선물옵션 endpoint는 다른 trading mutation과 동일하게
+실환경에서 local block됩니다.
+
+## 실시간 Tryitout Endpoint 호출
+
+국내주식 실시간과 채권 실시간 helper는 공식 inventory와 mock contract에
+보존된 REST-style `/tryitout/*` 형태를 실행합니다. 이는 mock contract와 요청
+검증을 위한 API이며 live WebSocket subscription API가 아닙니다.
+
+```rust
+use kis_sdk::{
+    apis::domestic_stock_realtime,
+    endpoint::InventoryRequest,
+};
+use serde_json::json;
+
+async fn realtime_tryitout(client: &kis_sdk::KisClient) -> Result<(), kis_sdk::KisError> {
+    let response = client
+        .execute_domestic_stock_realtime_tryitout::<serde_json::Value>(
+            domestic_stock_realtime::REALTIME_TRADE_KRX,
+            InventoryRequest::new()
+                .header("approval_key", "test_approval_key")
+                .header("tr_type", "1")
+                .body(json!({
+                    "tr_id": "H0STCNT0",
+                    "tr_key": "005930"
+                })),
+        )
+        .await?;
+
+    assert!(response.is_success());
+    Ok(())
+}
+```
+
+## 채권 Endpoint 호출
+
+채권 helper는 주문/계좌 7개, 시세 8개, realtime tryitout 3개 endpoint로
+scope가 나뉩니다. bundled inventory 기준 대부분은 `real_only`이므로 mock
+mode에서는 `KisError::UnsupportedEnvironment`가 반환될 수 있습니다.
+
+```rust
+use kis_sdk::{
+    apis::bond,
+    endpoint::InventoryRequest,
+};
+use serde_json::json;
+
+async fn bond_price(client: &kis_sdk::KisClient) -> Result<(), kis_sdk::KisError> {
+    let response = client
+        .execute_bond_quotation::<serde_json::Value>(
+            bond::INQUIRE_PRICE,
+            InventoryRequest::new().query(json!({
+                "FID_COND_MRKT_DIV_CODE": "B",
+                "FID_INPUT_ISCD": "KR103502GA34"
+            })),
+        )
+        .await?;
+
+    assert!(response.is_success());
+    Ok(())
+}
+```
+
+## 잔고 조회와 Mock 주문
+
+잔고 조회에는 placeholder 계좌 값을 사용할 수 있습니다. 실제 계좌 식별자는
+민감 정보이며 승인된 secret path에서만 주입해야 합니다.
+
+```rust
+use kis_sdk::{
+    apis::domestic_stock::InquireBalanceRequest,
+    credentials::Account,
+};
+
+async fn inquire_balance(client: &kis_sdk::KisClient) -> Result<(), kis_sdk::KisError> {
+    let account = Account::new("12345678", "01");
+    let response = client
+        .inquire_domestic_stock_balance(&InquireBalanceRequest::new(&account))
+        .await?;
+
+    assert!(response.is_success());
+    Ok(())
+}
+```
+
+Mock cash order는 SDK 요청 구성과 mock contract 처리를 검증하기 위한 예제이며
+실제 주문을 내지 않습니다.
+
+```rust
+use kis_sdk::{
+    apis::domestic_stock::{CashOrderRequest, CashOrderSide},
+    credentials::Account,
+};
+
+async fn submit_mock_order(client: &kis_sdk::KisClient) -> Result<(), kis_sdk::KisError> {
+    let account = Account::new("12345678", "01");
+    let request = CashOrderRequest::limit(&account, "005930", 1, 70_000);
+
+    let response = client
+        .place_domestic_stock_cash_order(CashOrderSide::Buy, &request)
+        .await?;
+
+    assert!(response.is_success());
+    Ok(())
+}
+```
+
+현재 구현은 실환경 cash order를 network I/O 전에
+`KisError::LiveTradingDisabled`로 차단합니다.
+
+## 실환경 읽기 Client 구성
+
+실환경 읽기 호출은 credential을 repository 밖에서 로드하세요.
+
+```rust
+use kis_sdk::{
+    config::Environment,
+    credentials::AppCredentials,
+    KisClient,
+};
+
+fn real_read_client_from_env() -> Result<KisClient, Box<dyn std::error::Error>> {
+    let app_key = std::env::var("KIS_APP_KEY")?;
+    let app_secret = std::env::var("KIS_APP_SECRET")?;
+
+    let client = KisClient::builder(Environment::Real)
+        .app_credentials(AppCredentials::new(app_key, app_secret))
+        .build()?;
+
+    Ok(client)
+}
+```
+
+로드한 값을 출력하거나 저장하지 마세요. 공유 개발 머신 또는 public CI에서
+실제 credential을 사용하는 테스트를 실행하지 마세요.
+
+## Live Trading 안전 경계
+
+- 예제는 placeholder credential과 placeholder 계좌번호만 사용합니다.
+- 테스트와 mock server는 live credential, production account data, live API
+  call, live order execution을 요구하지 않습니다.
+- `Environment::Real`의 trading mutation은 현재 local guard로 차단되며
+  `KisError::LiveTradingDisabled`를 반환합니다.
+- Realtime helper의 `/tryitout/*` 호출은 mock/inventory REST shape 검증용이며
+  live WebSocket subscription이 아닙니다.
+- Retry는 기본적으로 꺼져 있습니다. `RetryPolicy::conservative_reads()`는
+  retry 가능한 GET/read 실패만 재시도하며 trading POST mutation은 재시도하지
+  않습니다.
+- Real-to-mock fallback은 기본적으로 꺼져 있고 opt-in/read-only입니다. 별도
+  fallback credential과 fallback bearer token을 요구하므로 primary real
+  credential이 mock fallback target으로 재사용되지 않습니다.
+
+## Endpoint Coverage 상태
+
+`tests/sdk_core.rs::full_inventory_reconciliation_accounts_for_every_official_endpoint_once`
+는 bundled `InventoryCatalog`의 모든 공식 operation id를 정확히 하나의
+SDK-callable coverage surface에 배정하는 machine-checkable gate입니다.
+
+| Coverage surface | Endpoint count |
+| --- | ---: |
+| OAuth typed methods | 3 |
+| Domestic stock REST inventory API | 158 |
+| Domestic stock realtime tryitout inventory API | 29 |
+| Domestic futures/options inventory API | 44 |
+| Overseas stock inventory API | 51 |
+| Overseas futures/options inventory API | 35 |
+| Listed bond inventory API | 18 |
+| **Total accounted official inventory** | **338/338** |
+
+이 상태는 BOG-221에서 captured된 bundled official inventory 기준입니다. 공식
+포털을 live re-scrape한 결과가 아니며, 모든 endpoint가 narrow typed
+request/response struct로 제공된다는 의미도 아닙니다. 현재 보장되는 것은 각
+endpoint가 typed method, scoped inventory API, 또는 lower-level
+`execute_inventory` 경로로 SDK-callable하게 account된다는 점입니다.
+
+자세한 collection split, mock-contract evidence, known limitation은
+[`contract-quality-report.md`](contract-quality-report.md)를 참고하세요.
+
+## 검증 명령
+
+현재 문서와 SDK baseline에서 사용한 주요 검증 명령은 다음과 같습니다.
+
+```sh
+cargo fmt --check
+cargo test --locked
+cargo test --locked --test mock_server_contract
+cargo doc --locked --no-deps
+git diff --check
+```
+
+문서만 변경한 경우에도 code block과 intra-doc link 확인을 위해
+`cargo doc --locked --no-deps`와 `git diff --check`를 다시 실행하는 것이
+좋습니다.
+
+## 관련 문서
+
+- [Repository README](../README.md)
+- [English usage guide](usage.md)
+- [Mock server guide](mock-server/README.md)
+- [Contract quality report](contract-quality-report.md)
+- [Runtime architecture ADR/RFC](adr/0001-kis-sdk-runtime-architecture.md)
diff --git a/tests/sdk_core.rs b/tests/sdk_core.rs
index 33251ce..29719f0 100644
--- a/tests/sdk_core.rs
+++ b/tests/sdk_core.rs
@@ -95,6 +95,109 @@ fn inventory_catalog_addresses_every_official_endpoint_with_unique_operation_ids
     }
 }
 
+#[test]
+fn full_inventory_reconciliation_accounts_for_every_official_endpoint_once() {
+    let catalog = InventoryCatalog::bundled().expect("inventory catalog builds");
+    let mut coverage = BTreeMap::<&str, HashSet<String>>::new();
+
+    coverage.insert(
+        "oauth_typed_methods",
+        HashSet::from([
+            "oauth_authentication.post_oauth2_tokenp".to_string(),
+            "oauth_authentication.post_oauth2_revokep".to_string(),
+            "oauth_authentication.post_oauth2_approval".to_string(),
+        ]),
+    );
+    coverage.insert(
+        "domestic_stock_rest_inventory_api",
+        domestic_stock_rest_endpoints()
+            .expect("domestic stock REST catalog builds")
+            .iter()
+            .map(|endpoint| endpoint.operation_id.clone())
+            .collect(),
+    );
+    coverage.insert(
+        "domestic_stock_realtime_tryitout_inventory_api",
+        DOMESTIC_STOCK_REALTIME_TRYITOUT_OPERATIONS
+            .iter()
+            .map(|operation_id| (*operation_id).to_string())
+            .collect(),
+    );
+    coverage.insert(
+        "domestic_futures_options_inventory_api",
+        domestic_futures_options_operation_ids()
+            .map(str::to_string)
+            .collect(),
+    );
+    coverage.insert(
+        "overseas_stock_inventory_api",
+        OverseasStockEndpoint::all()
+            .iter()
+            .map(|endpoint| endpoint.operation_id().to_string())
+            .collect(),
+    );
+    coverage.insert(
+        "overseas_futures_options_inventory_api",
+        OverseasFuturesOptionsEndpoint::ALL
+            .iter()
+            .map(|endpoint| endpoint.operation_id().to_string())
+            .collect(),
+    );
+    coverage.insert(
+        "listed_bond_inventory_api",
+        BOND_TRADING_ACCOUNT_OPERATIONS
+            .iter()
+            .chain(BOND_QUOTATION_OPERATIONS.iter())
+            .chain(BOND_REALTIME_TRYITOUT_OPERATIONS.iter())
+            .map(|operation_id| (*operation_id).to_string())
+            .collect(),
+    );
+
+    let official = catalog
+        .endpoints()
+        .iter()
+        .map(|endpoint| endpoint.operation_id.clone())
+        .collect::<HashSet<_>>();
+    let mut accounted = HashSet::new();
+
+    for (surface, operation_ids) in &coverage {
+        assert!(!operation_ids.is_empty(), "{surface} must not be empty");
+        for operation_id in operation_ids {
+            assert!(
+                official.contains(operation_id),
+                "{surface} includes unknown operation id {operation_id}"
+            );
+            assert!(
+                accounted.insert(operation_id.clone()),
+                "{operation_id} is assigned to more than one inventory coverage surface"
+            );
+        }
+    }
+
+    let missing = official.difference(&accounted).cloned().collect::<Vec<_>>();
+    let unexpected = accounted.difference(&official).cloned().collect::<Vec<_>>();
+
+    assert_eq!(accounted.len(), 338);
+    assert!(
+        missing.is_empty(),
+        "unaccounted inventory endpoints: {missing:?}"
+    );
+    assert!(
+        unexpected.is_empty(),
+        "coverage references non-inventory endpoints: {unexpected:?}"
+    );
+    assert_eq!(coverage["oauth_typed_methods"].len(), 3);
+    assert_eq!(coverage["domestic_stock_rest_inventory_api"].len(), 158);
+    assert_eq!(
+        coverage["domestic_stock_realtime_tryitout_inventory_api"].len(),
+        29
+    );
+    assert_eq!(coverage["domestic_futures_options_inventory_api"].len(), 44);
+    assert_eq!(coverage["overseas_stock_inventory_api"].len(), 51);
+    assert_eq!(coverage["overseas_futures_options_inventory_api"].len(), 35);
+    assert_eq!(coverage["listed_bond_inventory_api"].len(), 18);
+}
+
 #[test]
 fn inventory_operation_kind_uses_contract_kind_not_http_method_only() {
     let catalog = InventoryCatalog::bundled().expect("inventory catalog builds");