Improve CLI output for redirection compatibility (v1.0.2)

- Move system messages (progress, status) to stderr for clean markdown output
- Keep only markdown content in stdout for proper file redirection
- Enable usage: npx mapdown ... > output.md to create clean markdown files
- Update version to 1.0.2

Changes:
- Progress tracking now uses process.stderr.write()
- Start/completion messages use console.error()
- Only markdown result goes to stdout via console.log()

Author: riaf

package-lock.json

@@ -1,6 +1,6 @@
 {
 	"name": "mapdown",
-	"version": "1.0.1",
+	"version": "1.0.2",
 	"description": "A CLI tool to crawl sitemap.xml and convert all pages to LLM-friendly Markdown",
 	"type": "module",
 	"main": "dist/cli.js",

package.json

@@ -14,8 +14,8 @@ async function main() {
 	const source = args[0];
 
 	try {
-		console.log("🚀 Starting crawl...");
-		console.log(`📍 Source: ${source}\n`);
+		console.error("🚀 Starting crawl...");
+		console.error(`📍 Source: ${source}\n`);
 
 		// Track progress with terminal updates
 		let lastProgress = -1;
@@ -25,20 +25,20 @@ async function main() {
 				lastProgress = progress.percentage;
 				const processed = progress.completed + progress.failed;
 
-				// Clear line and update progress
-				process.stdout.write("\r\x1b[K"); // Clear current line
-				process.stdout.write(
+				// Clear line and update progress (write to stderr)
+				process.stderr.write("\r\x1b[K"); // Clear current line
+				process.stderr.write(
 					`Progress: ${processed}/${progress.total} (${progress.percentage}%) | ✓ ${progress.completed} | ✗ ${progress.failed}`,
 				);
 			}
 		});
 
 		// Clear progress line and print result
-		process.stdout.write("\r\x1b[K");
-		console.log(result);
-		console.log("\n✅ Crawl completed successfully!");
+		process.stderr.write("\r\x1b[K");
+		console.log(result); // Only the markdown result goes to stdout
+		console.error("\n✅ Crawl completed successfully!");
 	} catch (error) {
-		process.stdout.write("\r\x1b[K"); // Clear progress line
+		process.stderr.write("\r\x1b[K"); // Clear progress line
 		console.error(
 			"❌ Error:",
 			error instanceof Error ? error.message : "Unknown error",