@bilig/xlsx-formula-recalc 0.122.0 → 0.124.0

package/README.md

@@ -59,8 +59,7 @@ npx --package @bilig/xlsx-formula-recalc xlsx-recalc --demo --json
 
 That command creates a tiny workbook, changes `Inputs!B2` and `Inputs!B3`,
 recalculates `Summary!B2`, writes `bilig-formula-recalc-demo.xlsx`, and prints
-a proof object with `verified: true`, the recalculated value, and explicit next
-actions:
+a proof object with explicit recalculation fields and the recalculated value:
 
 ```json
 {
@@ -70,28 +69,26 @@ actions:
     }
   },
   "warnings": [],
-  "verified": true,
-  "star": "https://github.com/proompteng/bilig/stargazers",
-  "watchReleases": "https://github.com/proompteng/bilig/subscription",
-  "adoptionBlocker": "https://github.com/proompteng/bilig/discussions/new?category=general",
-  "nextStep": {
-    "ifUseful": "If this proof fixed your stale XLSX formula workflow, star or bookmark Bilig so you can find it again.",
-    "star": "https://github.com/proompteng/bilig/stargazers",
-    "watchReleases": "https://github.com/proompteng/bilig/subscription",
-    "ifBlocked": "If this is close but blocked by a workbook edge case, open an adoption blocker with a reduced fixture.",
-    "adoptionBlocker": "https://github.com/proompteng/bilig/discussions/new?category=general"
-  }
+  "commandSucceeded": true,
+  "recalculationCompleted": true,
+  "excelParity": "not_proven",
+  "expectedReadback": {
+    "Summary!B2": 72000
+  },
+  "expectedValueMatched": true
 }
 ```
 
-Keep the proof first: use the star or release-watch links only after the
-recalculated value and warnings match the workflow you are evaluating.
+Keep the proof first. The JSON is meant for CI and agents, so it does not carry
+star, release-watch, or discussion links. Use the links in the README or docs
+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
@@ -113,13 +110,19 @@ the recalculation command:
       "staleCachedValue": true
     }
   ],
-  "verified": true,
-  "nextStep": {
-    "command": "xlsx-recalc pricing.xlsx --read 'Summary!B7' --json"
-  }
+  "commandSucceeded": true,
+  "inspectionCompleted": true,
+  "recalculationCompleted": true,
+  "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).
+
 For an existing workbook:
 
 ```sh
@@ -224,8 +227,8 @@ from `@bilig/workpaper`.
 
 ## After The Proof
 
-If `verified: true` matches the Node/XLSX workflow you need, star or bookmark
-the repo so you can find it again:
+If the recalculation proof matches the Node/XLSX workflow you need, star or
+bookmark the repo so you can find it again:
 <https://github.com/proompteng/bilig/stargazers>.
 
 Watch releases if the package is close to a production path:

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.122.0",
+  "version": "0.124.0",
   "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.122.0"
+    "xlsx-formula-recalc": "0.124.0"
   },
   "engines": {
     "node": ">=22.0.0"