docs: prepare 0.2.0 release notes

Author: firede

CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## [0.2.0] - 2026-02-18
+
+### Added
+- Added `raw` mode for markdown-preferred single-pass output (`--mode raw`), returning the HTTP response body without extraction or fallback conversion.
+- Added metadata front matter injection (`title`, `description`) for non-raw outputs, enabled by default with `--meta` and disabled via `--meta=false`.
+- Added metadata enrichment for direct markdown responses in `auto`/`static` mode by fetching HTML metadata when needed.
+- Added tests for MDX/markdown handling, metadata injection behavior, and front matter preservation.
+
+### Changed
+- Migrated CLI argument parsing to `urfave/cli/v3`.
+- Standardized CLI usage around `--long-flag` style and more flexible flag/argument ordering.
+
+### Fixed
+- Honored `text/markdown` responses directly (including MDX-like content) to avoid dropping sections during fallback conversion.
+- Improved fallback behavior for HTTP status errors in `auto` mode.
+- Tightened markdown detection and related review cleanups.
+

README.md

@@ -8,6 +8,8 @@ A Go CLI that always tries to return Markdown for web pages in AI-agent workflow
 
 Web fetch results are often raw HTML/JS/CSS, which is noisy for LLMs. This tool wraps a fallback pipeline so agents can expect Markdown output.
 
+If you use tools like Codex or Claude Code, note that they may already include built-in HTML simplification/fetching. Whether you still need `agent-fetch` depends on your workflow.
+
 ## Behavior
 
 `agent-fetch` uses four modes:
@@ -33,7 +35,7 @@ go install github.com/firede/agent-fetch/cmd/agent-fetch@latest
 Install a specific version:
 
 ```bash
-go install github.com/firede/agent-fetch/cmd/agent-fetch@v0.1.1
+go install github.com/firede/agent-fetch/cmd/agent-fetch@v0.2.0
 ```
 
 Make sure `$(go env GOPATH)/bin` (usually `~/go/bin`) is in your `PATH`.

README.zh.md

@@ -8,6 +8,8 @@
 
 网页抓取结果通常是原始 HTML/JS/CSS，会给 LLM 带来大量噪音和 token 开销。这个工具封装了分级 fallback 流程，让 Agent 更稳定地拿到 Markdown 内容。
 
+如果你使用 Codex、Claude Code 等工具，需要注意它们可能已内置 HTML 简化/抓取能力。是否仍需要 `agent-fetch`，应根据你的场景判断。
+
 ## 行为说明
 
 `agent-fetch` 提供四种模式：
@@ -33,7 +35,7 @@ go install github.com/firede/agent-fetch/cmd/agent-fetch@latest
 安装指定版本：
 
 ```bash
-go install github.com/firede/agent-fetch/cmd/agent-fetch@v0.1.1
+go install github.com/firede/agent-fetch/cmd/agent-fetch@v0.2.0
 ```
 
 请确保 `$(go env GOPATH)/bin`（通常是 `~/go/bin`）已加入 `PATH`。