source adapter framework

docs/cli-reference.md

@@ -862,6 +862,57 @@ Parameters:
 - `--policy-mode` - Override policy mode for this search.
 - `--format` -
 
+## `mkt source`
+
+Inspect source-format adapters and normalize sources.
+
+```text
+source [OPTIONS] COMMAND [ARGS]...
+```
+
+## `mkt source adapters`
+
+List discovered read-only source adapters.
+
+```text
+adapters [OPTIONS]
+```
+
+Parameters:
+
+- `--format` -
+
+## `mkt source inspect`
+
+Inspect a local source without full Markdown conversion.
+
+```text
+inspect [OPTIONS] SOURCE_PATH
+```
+
+Parameters:
+
+- `SOURCE_PATH` - Required.
+- `--adapter` - Explicit source adapter id.
+- `--option` - Adapter-specific option. May be repeated.
+- `--format` -
+
+## `mkt source normalize`
+
+Normalize a local source into canonical Markdown.
+
+```text
+normalize [OPTIONS] SOURCE_PATH
+```
+
+Parameters:
+
+- `SOURCE_PATH` - Required.
+- `--adapter` - Explicit source adapter id.
+- `--option` - Adapter-specific option. May be repeated.
+- `--output` - Write normalized output to this file.
+- `--format` -
+
 ## `mkt tangle`
 
 Tangle named Markdown code chunks into target files.