release: v2.7.0 batch Word triage

Author: iguangfei

CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to DeckProbe are documented here.
 
+## [Unreleased]
+
+## [2.7.0] - 2026-09-22
+
+### Added
+
+- JSONL error envelopes now echo the input record's original `path` and optional
+  caller-provided `id` for reliable batch attribution.
+- Word deep probes can estimate missing word and character statistics from
+  `word/document.xml` when those targets explicitly accept medium confidence.
+
+### Changed
+
+- Keep the npm package lightweight by omitting source maps and TypeScript source
+  files from published tarballs, with a packaging regression check.
+- Report absent optional Word saved statistics as resolved `null` values with a
+  `MISSING_OPTIONAL_STATISTIC` diagnostic; page counts remain unestimated.
+
 ## [2.6.0] - 2026-09-09
 
 ### Added
@@ -13,13 +31,6 @@ All notable changes to DeckProbe are documented here.
 - Exact `powerpoint.smartart_data_part_count` inventory using existing Content Types/ZIP indexes.
 - Native/WASM parity, input cap, cancellation/deadline and semantic SmartArt regression checks.
 
-## [Unreleased]
-
-### Changed
-
-- Keep the npm package lightweight by omitting source maps and TypeScript source
-  files from published tarballs, with a packaging regression check.
-
 ## [2.5.0] - 2026-09-03
 
 ### Added

Cargo.lock

@@ -15,7 +15,7 @@ members = [
 resolver = "2"
 
 [workspace.package]
-version = "2.6.0"
+version = "2.7.0"
 edition = "2024"
 license = "Apache-2.0"
 repository = "https://github.com/deckflow/deckprobe"

Cargo.toml

@@ -190,10 +190,13 @@ compact schema-v2 result for each non-empty input line:
 
 ```sh
 printf '%s\n' \
-  '{"path":"report.pdf"}' \
-  '{"path":"deck.pptx"}' | deckprobe --jsonl -t @summary
+  '{"id":"report","path":"report.pdf"}' \
+  '{"id":"deck","path":"deck.pptx"}' | deckprobe --jsonl -t @summary
 ```
 
+When a valid JSONL record fails, the error envelope echoes its optional `id`
+and original `path` under `input`.
+
 ## Use from a coding agent
 
 DeckProbe ships an [Agent Skill](https://agentskills.io) that teaches an agent the
@@ -462,7 +465,7 @@ path; request those explicitly or through `@structure`.
 | Driver | Profiles | Current inspection depth |
 |---|---|---|
 | PDF | `.pdf` | Header and Info metadata, page/object counts, xref type, signatures, links, attachments, JavaScript, forms, annotations, and XMP presence. |
-| Word | `.docx`, `.docm`, `.dotx`, `.dotm` | OPC metadata, saved statistics, exact paragraph/table structure, security signals, comments, and image assets. |
+| Word | `.docx`, `.docm`, `.dotx`, `.dotm` | OPC metadata, saved statistics, opt-in medium-confidence deep text estimates, exact paragraph/table structure, security signals, comments, and image assets. |
 | Excel | `.xlsx`, `.xlsm`, `.xltx`, `.xltm`, `.xlsb` | OPC metadata, worksheets/names/visibility, shared strings, tables, charts, pivots, security signals, and image assets; XLSB identity only. |
 | PowerPoint | `.pptx`, `.pptm`, `.ppsx`, `.ppsm`, `.potx`, `.potm` | OPC metadata, slides/hidden slides, masters/layouts/notes, slide size, security signals, charts, comments, images, and media. |
 | Legacy Office | `.doc`, `.dot`, `.xls`, `.xlt`, `.ppt`, `.pps`, `.pot` | Validated CFB main streams, SummaryInformation metadata, macros, embedded-object signals, and core Word/Excel/PowerPoint statistics. |

README.md

@@ -57,7 +57,7 @@ struct Cli {
         long,
         conflicts_with_all = ["input", "pretty", "stdin_name"],
         help_heading = "Input interpretation",
-        long_help = "Read JSONL records from stdin. Each non-empty line is either a JSON string containing a local path, an object {\"path\":\"...\"}, or an object {\"name\":\"report.pdf\",\"data_base64\":\"...\"}. Output is always compact JSONL and processing continues after a per-record error."
+        long_help = "Read JSONL records from stdin. Each non-empty line is either a JSON string containing a local path, an object {\"path\":\"...\"}, or an object {\"name\":\"report.pdf\",\"data_base64\":\"...\"}. Object records may include a caller-defined \"id\", which is echoed with the original path on errors. Output is always compact JSONL and processing continues after a per-record error."
     )]
     jsonl: bool,
 
@@ -561,13 +561,39 @@ fn read_stdin_document(options: &ProbeOptions) -> deckprobe_core::Result<Vec<u8>
 enum JsonlInput {
     Path(String),
     Record {
+        id: Option<serde_json::Value>,
         path: Option<PathBuf>,
         name: Option<String>,
         #[serde(alias = "base64")]
         data_base64: Option<String>,
     },
 }
 
+#[derive(Debug, Default, Serialize)]
+struct JsonlInputContext {
+    #[serde(skip_serializing_if = "Option::is_none")]
+    id: Option<serde_json::Value>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    path: Option<String>,
+}
+
+impl JsonlInput {
+    fn context(&self) -> JsonlInputContext {
+        match self {
+            Self::Path(path) => JsonlInputContext {
+                id: None,
+                path: Some(path.clone()),
+            },
+            Self::Record { id, path, .. } => JsonlInputContext {
+                id: id.clone(),
+                path: path
+                    .as_ref()
+                    .map(|value| value.to_string_lossy().into_owned()),
+            },
+        }
+    }
+}
+
 fn run_jsonl(cli: &Cli, options: &ProbeOptions) -> deckprobe_core::Result<u8> {
     let stdin = std::io::stdin();
     let mut exit_code = 0;
@@ -577,12 +603,11 @@ fn run_jsonl(cli: &Cli, options: &ProbeOptions) -> deckprobe_core::Result<u8> {
         if line.trim().is_empty() {
             continue;
         }
-        let outcome = serde_json::from_str::<JsonlInput>(&line)
-            .map_err(|error| {
-                DeckProbeError::InvalidRequest(format!(
-                    "JSONL line {line_number} is invalid: {error}"
-                ))
-            })
+        let parsed = serde_json::from_str::<JsonlInput>(&line).map_err(|error| {
+            DeckProbeError::InvalidRequest(format!("JSONL line {line_number} is invalid: {error}"))
+        });
+        let context = parsed.as_ref().ok().map(JsonlInput::context);
+        let outcome = parsed
             .and_then(|input| jsonl_source(input, options, cli.max_input_bytes))
             .and_then(|source| probe(source, options.clone()));
         match outcome {
@@ -601,7 +626,17 @@ fn run_jsonl(cli: &Cli, options: &ProbeOptions) -> deckprobe_core::Result<u8> {
             }
             Err(error) => {
                 exit_code = exit_code.max(error_exit_code(&error));
-                write_json(&error_report(&error), false)?;
+                let mut report = error_report(&error);
+                if let Some(context) =
+                    context.filter(|value| value.id.is_some() || value.path.is_some())
+                {
+                    report["input"] = serde_json::to_value(context).map_err(|error| {
+                        DeckProbeError::Parser(format!(
+                            "cannot serialize JSONL input context: {error}"
+                        ))
+                    })?;
+                }
+                write_json(&report, false)?;
             }
         }
     }
@@ -620,6 +655,7 @@ fn jsonl_source(
             max_input_bytes,
         )?)),
         JsonlInput::Record {
+            id: _,
             path: Some(path),
             name,
             data_base64: None,
@@ -629,6 +665,7 @@ fn jsonl_source(
             max_input_bytes,
         )?)),
         JsonlInput::Record {
+            id: _,
             path: None,
             name: Some(name),
             data_base64: Some(data),

crates/deckprobe-cli/src/main.rs

@@ -779,6 +779,27 @@ fn merge_results(
             message: format!("no path satisfies {target} at requested level/confidence"),
         })
         .collect::<Vec<_>>();
+    diagnostics.extend(
+        results
+            .iter()
+            .filter(|(_, result)| {
+                result.path == "word.app_statistics"
+                    && result.status == TargetStatus::Resolved
+                    && result.value.as_ref().is_some_and(Value::is_null)
+            })
+            .map(|(target, _)| Diagnostic {
+            level: "info".to_owned(),
+            code: "MISSING_OPTIONAL_STATISTIC".to_owned(),
+            message: if target == "word.page_count" {
+                "word.page_count is not recorded in docProps/app.xml; exact pagination requires a Word-compatible layout engine"
+                    .to_owned()
+            } else {
+                format!(
+                    "{target} is not recorded in docProps/app.xml; the document is still structurally valid"
+                )
+            },
+            }),
+    );
     if !plan_only {
         for (target, result) in results
             .iter()
@@ -803,6 +824,16 @@ fn merge_results(
                         )
                         .to_ascii_lowercase(),
                     });
+                } else if result.status == TargetStatus::Invalid
+                    && result.path == "word.app_statistics"
+                {
+                    diagnostics.push(Diagnostic {
+                        level: "warning".to_owned(),
+                        code: "INVALID_OPTIONAL_STATISTIC".to_owned(),
+                        message: format!(
+                            "{target} is present in docProps/app.xml but is not a valid non-negative integer"
+                        ),
+                    });
                 } else {
                     diagnostics.push(Diagnostic {
                         level: "warning".to_owned(),

crates/deckprobe-engine/src/lib.rs

@@ -9,5 +9,5 @@ rust-version.workspace = true
 [dependencies]
 deckprobe-core = { path = "../deckprobe-core" }
 deckprobe-format-ooxml = { path = "../deckprobe-format-ooxml" }
+quick-xml.workspace = true
 serde_json.workspace = true
-