docs(docs-site): normalize CLI references for agents

docs-site/content/docs/cli-reference/ktx-wiki.mdx

@@ -5,7 +5,7 @@ description: "List, read, search, or write knowledge pages."
 
 Manage knowledge pages in your KTX project. Knowledge pages are Markdown documents that capture business definitions, rules, and gotchas. Agents search them for context when answering questions about your data.
 
-## Usage
+## Command signature
 
 ```bash
 ktx wiki <subcommand> [options]
@@ -90,3 +90,28 @@ ktx wiki write data-freshness \
   --content "The orders table refreshes every 15 minutes..." \
   --ref "https://wiki.example.com/data-pipelines"
 ```
+
+## Output
+
+Wiki commands print local knowledge pages and search results. Agents should search first, then read the most relevant page by key.
+
+```json
+{
+  "results": [
+    {
+      "key": "revenue-definitions",
+      "summary": "Canonical revenue metric definitions",
+      "score": 0.92
+    }
+  ]
+}
+```
+
+## Common errors
+
+| Error | Cause | Recovery |
+|-------|-------|----------|
+| Search returns no results | The query terms do not match summaries, tags, or content | Retry with business synonyms, then create a page if the knowledge is missing |
+| Read fails for a key | The page key is wrong or scoped to a different user | Run `ktx wiki list` or search again to get the exact key |
+| Write fails due to missing fields | `--summary` or `--content` was omitted | Pass both fields, and keep the summary short enough for search results |
+| Agent writes duplicate pages | It did not search existing pages first | Always run `ktx wiki search` before `ktx wiki write` |