xlsx-formula-recalc 0.131.1 → 0.131.3

package/AGENTS.md

@@ -3,30 +3,34 @@
 Use this package when a Node.js task edits an `.xlsx` workbook and needs fresh
 formula results before returning the file or reading output cells.
 
-Start with the one-command proof:
+The canonical public package is `@bilig/xlsx-formula-recalc`. The unscoped
+`xlsx-formula-recalc` package remains a compatibility and search alias, but new
+agent instructions should use the scoped package first.
+
+Start with the no-project evaluator:
 
 ```sh
-npx --package xlsx-formula-recalc xlsx-recalc --demo --json
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- bilig-evaluate --door xlsx-cache --json
 ```
 
 If the task came from a SheetJS / `xlsx` stale-formula issue, the same package
 also exposes a SheetJS-named command:
 
 ```sh
-npx --package xlsx-formula-recalc sheetjs-recalc --demo --json
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- sheetjs-recalc --demo --json
 ```
 
 If the caller has a real workbook but does not know which formulas to read yet,
 inspect it first without writing an output file:
 
 ```sh
-npx --package xlsx-formula-recalc xlsx-recalc workbook.xlsx --inspect --json
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- xlsx-recalc workbook.xlsx --inspect --json
 ```
 
 Use the memorable cache-diagnosis alias for issue triage or CI:
 
 ```sh
-npx --package xlsx-formula-recalc xlsx-cache-doctor workbook.xlsx --json
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- xlsx-cache-doctor workbook.xlsx --json
 ```
 
 Use the returned `suggestedReads`, stale cached formula counts, and warnings to
@@ -37,7 +41,7 @@ before treating the report as complete coverage.
 For a real workbook, use sheet-qualified A1 targets:
 
 ```sh
-npx --package xlsx-formula-recalc xlsx-recalc quote.xlsx \
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- xlsx-recalc quote.xlsx \
   --set Inputs!B2=48 \
   --read Summary!B7 \
   --out quote.recalculated.xlsx \
@@ -48,7 +52,7 @@ For external workbook links, pass companion files with `--external-workbook`
 or exact link bindings with `--external-workbook-target <path> <target>`:
 
 ```sh
-npx --package xlsx-formula-recalc xlsx-recalc quote.xlsx \
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- xlsx-recalc quote.xlsx \
   --external-workbook-target ./fixtures/rates-current.xlsx file:///tmp/rates.xlsx \
   --read Summary!B7 \
   --json
@@ -57,7 +61,7 @@ npx --package xlsx-formula-recalc xlsx-recalc quote.xlsx \
 Use the API when code already has workbook bytes:
 
 ```ts
-import { recalculateXlsx } from 'xlsx-formula-recalc'
+import { recalculateXlsx } from '@bilig/xlsx-formula-recalc'
 
 const result = recalculateXlsx(xlsxBytes, {
   edits: [{ target: 'Inputs!B2', value: 48 }],

package/README.md

@@ -67,8 +67,8 @@ npm install @bilig/xlsx-formula-recalc
 
 ## CLI
 
-Run the unified evaluator first when you want one `verified: true` proof shape
-for XLSX stale-cache checks, WorkPaper services, and agent/MCP tooling:
+Run the evaluator first when you want one JSON shape for XLSX stale-cache
+checks, WorkPaper services, and agent/MCP tooling:
 
 ```sh
 npx --package @bilig/xlsx-formula-recalc bilig-evaluate --door xlsx-cache --json
@@ -151,10 +151,9 @@ a proof object with explicit recalculation fields and the recalculated value:
 }
 ```
 
-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.
+Keep the JSON first. It contains proof fields only; it does not include star,
+release-watch, or discussion links. Use README or docs links after the
+recalculated value and warnings match the workflow.
 
 If you have a real workbook but do not yet know which formula cells matter,
 diagnose it without writing an output file:

package/SKILL.md

@@ -13,36 +13,40 @@ tags:
 
 # XLSX Formula Recalculation
 
-Use `xlsx-formula-recalc` when an agent or Node.js service has changed XLSX
-inputs and must read recalculated formula outputs without opening Excel,
-LibreOffice, or a browser.
+Use `@bilig/xlsx-formula-recalc` when an agent or Node.js service has changed
+XLSX inputs and must read recalculated formula outputs without opening Excel,
+LibreOffice, or a browser. The unscoped `xlsx-formula-recalc` package remains a
+compatibility/search alias; new agent instructions should use the scoped package
+first.
 
 ## First Check
 
 ```sh
-npx --package xlsx-formula-recalc xlsx-recalc --demo --json
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- bilig-evaluate --door xlsx-cache --json
 ```
 
-The demo should print `recalculationCompleted: true`,
-`expectedValueMatched: true`, and a `Summary!B2` value of `72000`.
+The evaluator should print `schemaVersion: "bilig-evaluator.v1"`,
+`door: "xlsx-cache"`, `verified: true`, and evidence for a stale cached
+formula corrected to a `Summary!B2` value of `72000`.
+
 For SheetJS / `xlsx` stale-formula issues, use the SheetJS-named binary from the
 same package:
 
 ```sh
-npx --package xlsx-formula-recalc sheetjs-recalc --demo --json
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- sheetjs-recalc --demo --json
 ```
 
 If you have a real workbook but do not yet know which formula cells to verify,
 inspect it without writing an output file:
 
 ```sh
-npx --package xlsx-formula-recalc xlsx-recalc workbook.xlsx --inspect --json
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- xlsx-recalc workbook.xlsx --inspect --json
 ```
 
 For CI or issue triage, use the cache-diagnosis alias:
 
 ```sh
-npx --package xlsx-formula-recalc xlsx-cache-doctor workbook.xlsx --json
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- xlsx-cache-doctor workbook.xlsx --json
 ```
 
 The inspection output includes `formulaCellCount`, `staleCachedFormulaCount`,
@@ -54,7 +58,7 @@ coverage.
 ## Real Workbook
 
 ```sh
-npx --package xlsx-formula-recalc xlsx-recalc workbook.xlsx \
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- xlsx-recalc workbook.xlsx \
   --set Inputs!B2=48 \
   --read Summary!B7 \
   --out workbook.recalculated.xlsx \
@@ -64,7 +68,7 @@ npx --package xlsx-formula-recalc xlsx-recalc workbook.xlsx \
 For linked workbooks, pass companion files:
 
 ```sh
-npx --package xlsx-formula-recalc xlsx-recalc workbook.xlsx \
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- xlsx-recalc workbook.xlsx \
   --external-workbook rates.xlsx \
   --read Summary!B7 \
   --json
@@ -74,7 +78,7 @@ Use an exact target binding when the workbook link target differs from the local
 filename:
 
 ```sh
-npx --package xlsx-formula-recalc xlsx-recalc workbook.xlsx \
+npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- xlsx-recalc workbook.xlsx \
   --external-workbook-target ./fixtures/rates-current.xlsx file:///tmp/rates.xlsx \
   --read Summary!B7 \
   --json
@@ -83,7 +87,7 @@ npx --package xlsx-formula-recalc xlsx-recalc workbook.xlsx \
 ## TypeScript
 
 ```ts
-import { recalculateXlsx } from 'xlsx-formula-recalc'
+import { recalculateXlsx } from '@bilig/xlsx-formula-recalc'
 
 const result = recalculateXlsx(inputXlsxBytes, {
   edits: [{ target: 'Inputs!B2', value: 48 }],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xlsx-formula-recalc",
-  "version": "0.131.1",
+  "version": "0.131.3",
   "description": "Diagnose stale cached XLSX formula values and recalculate XLSX formulas in Node.js without Excel, LibreOffice, or browser automation.",
   "keywords": [
     "excel",
@@ -83,8 +83,8 @@
     "smoke": "node ./dist/cli.js --help"
   },
   "dependencies": {
-    "@bilig/headless": "0.131.1",
-    "@bilig/protocol": "0.131.1",
+    "@bilig/headless": "0.131.3",
+    "@bilig/protocol": "0.131.3",
     "fflate": "0.3.11"
   },
   "engines": {