docs(cli): document view status filtering workflow

Author: WendellXY

CHANGELOG.md

@@ -4,6 +4,14 @@ 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.
 
+## [Unreleased]
+
+### Added
+- CLI `view` status-based filtering with `--status`, `--keys-only`, and `--json` output modes for listing untranslated/review-needed entries.
+
+### Changed
+- `view --status` now supports strict metadata gating: `langcodec --strict view ... --status ...` requires explicit status metadata (v1 support: `.xcstrings`).
+
 ## [0.7.0] - 2026-02-17
 
 ### Added

README.md

@@ -62,6 +62,8 @@ This is a `0.7.0` release available on [crates.io](https://crates.io/crates/lang
 - Normalize and detect drift: `langcodec normalize -i 'locales/**/*.{strings,xml,csv,tsv,xcstrings}' --check`
 - Sync existing keys only: `langcodec sync --source A.xcstrings --target B.xcstrings --match-lang en`
 - View: `langcodec view -i strings.xml --full`
+- View filtered untranslated/review-needed keys: `langcodec view -i Localizable.xcstrings --status new,needs_review --keys-only`
+- View filtered results as JSON: `langcodec view -i Localizable.xcstrings --status new --lang fr --json`
 - Stats (JSON): `langcodec stats -i Localizable.xcstrings --json`
   - See full options: langcodec-cli/README.md#stats
   - Example output:
@@ -99,6 +101,7 @@ This is a `0.7.0` release available on [crates.io](https://crates.io/crates/lang
 - Normalize `--continue-on-error` processes all inputs and returns non-zero if any file fails.
 - Android path inference: `values/strings.xml` (no qualifier) defaults to English (`en`).
 - When converting to `.xcstrings`, if `source_language` or `version` metadata is missing, the CLI defaults them to `en` and `1.0` respectively (overridable via flags).
+- Strict status filtering note: `langcodec --strict view --status ...` requires explicit status metadata (supported in v1: `.xcstrings`).
 
 #### Plurals
 

langcodec-cli/README.md

@@ -63,10 +63,21 @@ CI-oriented options:
 
 ```sh
 langcodec view -i values/strings.xml --full
+langcodec view -i Localizable.xcstrings --status new,needs_review
+langcodec view -i Localizable.xcstrings --status new --lang fr --json
+langcodec view -i Localizable.xcstrings --status new,needs_review --keys-only
 ```
 
 Prints entries. Plurals are labeled with `Type: Plural` and show categories.
 
+View options:
+
+- `--status`: Filter by one or more statuses (`translated|needs_review|new|do_not_translate|stale`), comma-separated.
+- `--keys-only`: Print only keys in text mode (`lang<TAB>key` when `--lang` is not set).
+- `--json`: Output machine-readable JSON (`summary` + `entries` or `keys` payload).
+- `--lang`: Restrict results to a specific language before status filtering.
+- `--strict`: With `--status`, requires explicit status metadata (supported in v1: `.xcstrings`).
+
 ### stats
 
 ```sh

langcodec-cli/src/view.rs

@@ -26,7 +26,11 @@ fn parse_status_filter(status: &Option<String>) -> Result<Option<Vec<EntryStatus
     };
 
     let mut parsed = Vec::new();
-    for token in raw_status.split(',').map(str::trim).filter(|s| !s.is_empty()) {
+    for token in raw_status
+        .split(',')
+        .map(str::trim)
+        .filter(|s| !s.is_empty())
+    {
         let normalized = token.replace(['-', ' '], "_");
         let entry_status = normalized.parse::<EntryStatus>().map_err(|_| {
             format!(

langcodec-cli/tests/view_status_cli_tests.rs

@@ -488,12 +488,20 @@ fn test_view_status_json_outputs_entries_payload() {
     assert_eq!(payload["summary"]["total_matches"], 2);
     assert_eq!(payload["summary"]["statuses"]["needs_review"], 2);
     let languages = payload["summary"]["languages"].as_array().unwrap();
-    assert_eq!(languages.len(), 2, "Expected 2 languages. payload: {payload}");
+    assert_eq!(
+        languages.len(),
+        2,
+        "Expected 2 languages. payload: {payload}"
+    );
     assert!(languages.iter().any(|lang| lang == "en"));
     assert!(languages.iter().any(|lang| lang == "fr"));
 
     let entries = payload["entries"].as_array().unwrap();
-    assert_eq!(entries.len(), 2, "Expected only filtered entries. payload: {payload}");
+    assert_eq!(
+        entries.len(),
+        2,
+        "Expected only filtered entries. payload: {payload}"
+    );
 
     let en_entry = entries
         .iter()
@@ -536,7 +544,10 @@ fn test_view_status_json_keys_only_outputs_keys_payload() {
 
     assert_eq!(payload["summary"]["total_matches"], 2);
     assert_eq!(payload["summary"]["statuses"]["needs_review"], 2);
-    assert!(payload.get("entries").is_none(), "Expected keys-only payload");
+    assert!(
+        payload.get("entries").is_none(),
+        "Expected keys-only payload"
+    );
 
     let keys = payload["keys"].as_array().unwrap();
     assert_eq!(keys.len(), 2);