chore: align docs and harden cli test execution

Author: WendellXY

CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog and this project follows Semantic Versioning while APIs remain in 0.x evolution.
+
+## [0.7.0] - 2026-02-17
+
+### Added
+- Global `--strict` mode in CLI workflows and strict-read controls in library input options.
+- CLI `diff` command with human-readable and JSON report output.
+- Plural validation enhancements and richer stats reporting.
+
+### Changed
+- Ongoing improvements to conversion coverage across Apple, Android, CSV, and TSV formats.
+- Documentation and contributor guidance updates.
+
+### Fixed
+- Multiple parser/writer correctness and conversion edge-case fixes covered by expanded tests.

README.md

@@ -9,14 +9,14 @@ Universal localization toolkit: library + CLI for Apple/Android/CSV/TSV.
 
 ## Status
 
-This is a `0.6.4` release available on [crates.io](https://crates.io/crates/langcodec). As a 0.x version, APIs may evolve. Contributions and feedback are very welcome!
+This is a `0.7.0` release available on [crates.io](https://crates.io/crates/langcodec). As a 0.x version, APIs may evolve. Contributions and feedback are very welcome!
 
 ---
 
 ## Installation
 
 - CLI: `cargo install langcodec-cli`
-- Lib: add `langcodec = "0.6.4"` to your `Cargo.toml`
+- Lib: add `langcodec = "0.7.0"` to your `Cargo.toml`
 
 ---
 
@@ -152,7 +152,3 @@ This project is licensed under the MIT License.
 - Built with love in Rust
 
 ---
-
-## Status and Roadmap
-
-`langcodec` is now available on [crates.io](https://crates.io/crates/langcodec). As a 0.x version, the API may evolve as development continues. The current focus is on expanding format support, improving the CLI experience, and building a robust ecosystem for localization tooling. We welcome your issues, feature requests, and discussions at the project's issue tracker.

ROADMAP.md

@@ -26,8 +26,8 @@ Legend: [ ] todo, [x] done, [~] in progress
   - [x] CLDR‑driven required category sets per locale (few/many/etc.)
   - [x] Validation pass: flag missing categories per key+locale
   - [x] CLI: `view --check-plurals` output
-- [ ] Strict vs. permissive parsing
-  - [ ] Global setting in lib; CLI `--strict` flag
+- [~] Strict vs. permissive parsing
+  - [x] Global setting in lib; CLI `--strict` flag
   - [ ] Consistent error surfaces with actionable context
 - [ ] Better error context
   - [ ] Include file path and entry id for parse/convert errors
@@ -57,9 +57,9 @@ For each new format:
 
 ## M4. CLI UX
 
-- [ ] `diff` subcommand
-  - [ ] Compare two files; output added/removed/changed keys by language
-  - [ ] Machine‑readable JSON output and pretty mode
+- [x] `diff` subcommand
+  - [x] Compare two files; output added/removed/changed keys by language
+  - [x] Machine‑readable JSON output and pretty mode
 - [x] `stats` subcommand
   - [x] Per‑language counts by `EntryStatus`
   - [x] Completion percent (excludes DoNotTranslate)
@@ -107,7 +107,7 @@ For each new format:
 ## Release Checklist (per minor)
 
 - [ ] Update README Supported Formats table
-- [ ] Changelog highlights (breaking changes, new formats, CLI flags)
+- [ ] Update CHANGELOG.md highlights (breaking changes, new formats, CLI flags)
 - [ ] Version bumps in workspace `Cargo.toml` and README
 - [ ] Tag + GitHub release notes
 

langcodec-cli/Cargo.toml

@@ -27,6 +27,7 @@ ignore = "0.4"
 globset = "0.4"
 
 [dev-dependencies]
+assert_cmd = "2.0"
 tempfile = "3.8"
 
 [[bin]]

langcodec-cli/src/main.rs

@@ -283,6 +283,44 @@ enum EditCommands {
     },
 }
 
+fn is_custom_input_extension(input: &str) -> bool {
+    input.ends_with(".json")
+        || input.ends_with(".yaml")
+        || input.ends_with(".yml")
+        || input.ends_with(".langcodec")
+}
+
+fn load_codec_for_readonly_command(
+    input: &str,
+    lang: &Option<String>,
+    strict: bool,
+) -> Result<Codec, String> {
+    let mut codec = Codec::new();
+    let is_custom_ext = is_custom_input_extension(input);
+
+    if strict {
+        if is_custom_ext {
+            try_custom_format_view(input, lang.clone(), &mut codec)?;
+        } else {
+            codec
+                .read_file_by_extension(input, lang.clone())
+                .map_err(|e| format!("{}", e))?;
+        }
+        return Ok(codec);
+    }
+
+    if codec.read_file_by_extension(input, lang.clone()).is_ok() {
+        return Ok(codec);
+    }
+
+    if is_custom_ext {
+        try_custom_format_view(input, lang.clone(), &mut codec)?;
+        return Ok(codec);
+    }
+
+    Err("unsupported format".to_string())
+}
+
 fn main() {
     let args = Args::parse();
     let strict = args.strict;
@@ -459,32 +497,13 @@ fn main() {
                 std::process::exit(1);
             }
 
-            let mut codec = Codec::new();
-            let is_custom_ext = input.ends_with(".json")
-                || input.ends_with(".yaml")
-                || input.ends_with(".yml")
-                || input.ends_with(".langcodec");
-            if strict {
-                if is_custom_ext {
-                    if let Err(e) = try_custom_format_view(&input, lang.clone(), &mut codec) {
-                        eprintln!("Failed to read file: {}", e);
-                        std::process::exit(1);
-                    }
-                } else if let Err(e) = codec.read_file_by_extension(&input, lang.clone()) {
-                    eprintln!("Failed to read file: {}", e);
-                    std::process::exit(1);
-                }
-            } else if let Ok(()) = codec.read_file_by_extension(&input, lang.clone()) {
-                // Standard format succeeded
-            } else if is_custom_ext {
-                if let Err(e) = try_custom_format_view(&input, lang.clone(), &mut codec) {
+            let codec = match load_codec_for_readonly_command(&input, &lang, strict) {
+                Ok(codec) => codec,
+                Err(e) => {
                     eprintln!("Failed to read file: {}", e);
                     std::process::exit(1);
                 }
-            } else {
-                eprintln!("Failed to read file: unsupported format");
-                std::process::exit(1);
-            }
+            };
 
             print_view(&codec, &lang, full);
 
@@ -587,34 +606,18 @@ fn main() {
                 std::process::exit(1);
             }
 
-            let mut codec = Codec::new();
-            let is_custom_ext = input.ends_with(".json")
-                || input.ends_with(".yaml")
-                || input.ends_with(".yml")
-                || input.ends_with(".langcodec");
-            if strict {
-                if is_custom_ext {
-                    if let Err(e) = try_custom_format_view(&input, lang.clone(), &mut codec) {
-                        eprintln!("Failed to read file: {}", e);
-                        std::process::exit(1);
-                    }
-                } else if let Err(e) = codec.read_file_by_extension(&input, lang.clone()) {
-                    eprintln!("Failed to read file: {}", e);
-                    std::process::exit(1);
-                }
-            } else if let Ok(()) = codec.read_file_by_extension(&input, lang.clone()) {
-                // ok
-            } else if is_custom_ext {
-                if let Err(e) = try_custom_format_view(&input, lang.clone(), &mut codec) {
+            let codec = match load_codec_for_readonly_command(&input, &lang, strict) {
+                Ok(codec) => codec,
+                Err(e) => {
                     eprintln!("Failed to read file: {}", e);
                     std::process::exit(1);
                 }
-            } else {
-                eprintln!("Failed to read file: unsupported format");
+            };
+
+            if let Err(e) = stats::print_stats(&codec, &lang, json) {
+                eprintln!("❌ Stats failed: {}", e);
                 std::process::exit(1);
             }
-
-            stats::print_stats(&codec, &lang, json);
         }
     }
 }

langcodec-cli/src/stats.rs

@@ -28,7 +28,11 @@ fn accumulate(lang_stats: &mut LangStats, status: &EntryStatus) {
     }
 }
 
-pub fn print_stats(codec: &Codec, lang_filter: &Option<String>, json_output: bool) {
+pub fn print_stats(
+    codec: &Codec,
+    lang_filter: &Option<String>,
+    json_output: bool,
+) -> Result<(), String> {
     let resources: Vec<_> = match lang_filter {
         Some(lang) => codec
             .resources
@@ -72,8 +76,10 @@ pub fn print_stats(codec: &Codec, lang_filter: &Option<String>, json_output: boo
             "summary": summary,
             "languages": per_lang,
         });
-        println!("{}", serde_json::to_string_pretty(&body).unwrap());
-        return;
+        let rendered = serde_json::to_string_pretty(&body)
+            .map_err(|e| format!("Failed to serialize stats JSON: {}", e))?;
+        println!("{}", rendered);
+        return Ok(());
     }
 
     println!("=== Stats ===");
@@ -125,4 +131,5 @@ pub fn print_stats(codec: &Codec, lang_filter: &Option<String>, json_output: boo
             missing_plural_entries, missing_plural_categories_total
         );
     }
+    Ok(())
 }