feat(cli): embeddable CLI library with CliHost

CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+### Added
+
+- `markkit_cli` library: `run(args, &impl CliHost)` runs the exact `markkit` CLI
+  inside another program (used by bashkit's `markkit` builtin), with stdio, file
+  reads, URL fetching and MCP supplied by the host.
+
+### Changed
+
+- **Breaking:** `markkit-cli` URL sources sit behind the new default
+  `native-http` feature; builds with `default-features = false` must enable it.
+- CLI help and errors are plain text (clap color and suggestions off), and error
+  output no longer appends a backtrace when `RUST_BACKTRACE` is set.
+- A closed stdout pipe now ends `markkit extract` with exit 0 instead of a panic.
+
 ## [0.2.1] - 2026-11-01
 
 ### Fixed

Cargo.toml

@@ -35,7 +35,10 @@ serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 
 # CLI
-clap = { version = "4", features = ["derive"] }
+# Default features off (no color, no did-you-mean suggestions) to match
+# bashkit's clap set: bashkit embeds this CLI as a builtin and clap features
+# unify, so color/suggestions here would change output on both sides.
+clap = { version = "4", default-features = false, features = ["derive", "std", "help", "usage", "error-context"] }
 
 # HTTP
 reqwest = { version = "0.13", default-features = false, features = ["rustls", "json"] }

crates/markkit-cli/Cargo.toml

@@ -13,13 +13,20 @@ categories.workspace = true
 description = "Command line interface for Markkit markdown extraction"
 readme = "../../README.md"
 
+[lib]
+name = "markkit_cli"
+path = "src/lib.rs"
+
 [[bin]]
 name = "markkit"
 path = "src/main.rs"
 doc = false
 
 [features]
-default = ["all_formats", "pdf-ocr"]
+default = ["all_formats", "pdf-ocr", "native-http"]
+# URL sources in `NativeHost` via markkit's own reqwest client. Embedders that
+# fetch through their own egress (bashkit) leave this off: no reqwest, no TLS.
+native-http = ["markkit/http_client"]
 all_formats = ["markkit/all_formats"]
 pdf = ["markkit/pdf"]
 pdf-ocr = ["pdf", "markkit/pdf-ocr"]
@@ -33,8 +40,8 @@ odt = ["markkit/odt"]
 epub = ["markkit/epub"]
 
 [dependencies]
-markkit = { path = "../markkit", version = "0.2.1", features = ["http_client", "tool"] }
-tokio = { workspace = true, features = ["macros", "net", "rt", "rt-multi-thread", "time", "fs", "io-std", "io-util"] }
+markkit = { path = "../markkit", version = "0.2.1", features = ["tool"] }
+tokio = { workspace = true, features = ["macros", "rt", "rt-multi-thread", "io-std", "io-util"] }
 clap.workspace = true
 anyhow.workspace = true
 serde_json.workspace = true