@bilig/xlsx-formula-recalc 0.123.0 → 0.124.1

package/README.md

@@ -85,20 +85,23 @@ only after the recalculated value and warnings match the workflow you are
 evaluating.
 
 If you have a real workbook but do not yet know which formula cells matter,
-inspect it without writing an output file:
+diagnose it without writing an output file:
 
 ```sh
-npx --package @bilig/xlsx-formula-recalc xlsx-recalc pricing.xlsx --inspect --json
+npx --package @bilig/xlsx-formula-recalc xlsx-cache-doctor pricing.xlsx --json
 ```
 
-Inspection imports the workbook, lists formula cells, recomputes a bounded
-sample, reports stale cached values, and returns suggested `--read` targets for
-the recalculation command:
+Inspection imports the workbook, lists formula cells, recomputes every formula
+by default, reports stale cached values, and returns suggested `--read` targets
+for the recalculation command. If you intentionally pass `--inspect-limit 50`,
+the JSON includes the skipped count as `uninspectedFormulaCellCount`.
 
 ```json
 {
   "formulaCellCount": 12,
   "inspectedFormulaCellCount": 12,
+  "uninspectedFormulaCellCount": 0,
+  "inspectionLimit": "all",
   "staleCachedFormulaCount": 3,
   "suggestedReads": ["Summary!B7"],
   "formulas": [
@@ -113,13 +116,18 @@ the recalculation command:
   "commandSucceeded": true,
   "inspectionCompleted": true,
   "recalculationCompleted": true,
-  "excelParity": "not_proven",
-  "nextStep": {
-    "command": "xlsx-recalc pricing.xlsx --read 'Summary!B7' --json"
-  }
+  "excelParity": "not_proven"
 }
 ```
 
+`xlsx-cache-doctor` is a readable alias for
+`xlsx-recalc pricing.xlsx --inspect --json`. Use it for issue triage, CI, and
+pull-request checks when the only question is whether committed XLSX files have
+stale cached formula values. The GitHub Action wrapper lives at
+[`actions/xlsx-cache-doctor`](../../actions/xlsx-cache-doctor), and the runnable
+fixture/workflow example lives at
+[`examples/xlsx-cache-doctor-ci`](../../examples/xlsx-cache-doctor-ci).
+
 For an existing workbook:
 
 ```sh

package/dist/cache-doctor-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cache-doctor-cli.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { runXlsxFormulaRecalcCli } from './cli-api.js';
+process.exitCode = runXlsxFormulaRecalcCli(process.argv.slice(2), {
+    commandName: 'xlsx-cache-doctor',
+});
+//# sourceMappingURL=cache-doctor-cli.js.map

package/dist/cache-doctor-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-doctor-cli.js","sourceRoot":"","sources":["../src/cache-doctor-cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAEtD,OAAO,CAAC,QAAQ,GAAG,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IAChE,WAAW,EAAE,mBAAmB;CACjC,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bilig/xlsx-formula-recalc",
-  "version": "0.123.0",
+  "version": "0.124.1",
   "description": "Recalculate XLSX formula values in Node.js after SheetJS, ExcelJS, or xlsx-populate edits without Excel, LibreOffice, or browser automation.",
   "keywords": [
     "bilig",
@@ -19,6 +19,7 @@
     "stale-xlsx-cache",
     "workbook",
     "xlsx",
+    "xlsx-cache-doctor",
     "xlsx-calc",
     "xlsx-formula",
     "xlsx-formula-recalculation",
@@ -38,6 +39,7 @@
   },
   "bin": {
     "sheetjs-recalc": "./dist/sheetjs-cli.js",
+    "xlsx-cache-doctor": "./dist/cache-doctor-cli.js",
     "xlsx-recalc": "./dist/cli.js"
   },
   "files": [
@@ -69,7 +71,7 @@
     "smoke": "node ./dist/cli.js --help"
   },
   "dependencies": {
-    "xlsx-formula-recalc": "0.123.0"
+    "xlsx-formula-recalc": "0.124.1"
   },
   "engines": {
     "node": ">=22.0.0"