@bilig/headless 0.8.2 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +23 -1
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -25,9 +25,12 @@ Current release posture:
25
25
  - Full local CI passed after the latest headless hardening work, including unit,
26
26
  contract, fuzz, browser, clean-diff, release-budget, runtime-publish, and
27
27
  WorkPaper competitive benchmark gates.
28
- - The checked-in competitive artifact generated on `2026-05-05T19:00:09.455Z`
28
+ - The checked-in competitive artifact generated on `2026-05-06T14:54:57.091Z`
29
29
  shows `46/46` comparable WorkPaper mean wins against HyperFormula-style
30
30
  workloads: `38/38` public and `8/8` holdout.
31
+ - The public benchmark evidence note explains the measured workload families,
32
+ engine metadata, exclusions, and the current p95 nuance:
33
+ [`docs/headless-workpaper-benchmark-evidence.md`](../../docs/headless-workpaper-benchmark-evidence.md).
31
34
  - Recently fixed and hardened P1 risks are covered by regression tests:
32
35
  - `updateConfig()` now applies `useColumnIndex` correctly when a rebuild-only
33
36
  config key changes in the same update.
@@ -278,6 +281,21 @@ pnpm workpaper:bench:competitive:check
278
281
  Do not change benchmark definitions, scoring, sampling, or workload sizes to hide
279
282
  losses.
280
283
 
284
+ For XLSX compatibility investigations with cached formula results, run the
285
+ corpus verifier against real workbook files:
286
+
287
+ ```sh
288
+ pnpm workpaper:xlsx-corpus:check -- /path/to/xlsx-corpus
289
+ ```
290
+
291
+ The verifier reads `.xlsx`, `.xlsm`, and `.xls` files, builds a WorkPaper model
292
+ with `useColumnIndex: true`, and compares formula cells against cached workbook
293
+ results. It reports `totalFiles`, `failedTimeouts`, `comparableFormulaCells`,
294
+ `matchingFormulaCells`, `mismatchedFormulaCells`, `matchRate`, skipped formulas,
295
+ and actionable mismatch samples. Missing cached results and volatile or
296
+ environment-dependent formulas such as `NOW()` and `CELL()` are counted as
297
+ skipped instead of silently treated as parity evidence.
298
+
281
299
  ## Compatibility Notes
282
300
 
283
301
  - The facade follows HyperFormula-style public workbook workflows, but it is not
@@ -290,6 +308,10 @@ losses.
290
308
  - Stable compatibility adapters are available through `graph`, `rangeMapping`,
291
309
  `arrayMapping`, `sheetMapping`, `addressMapping`, `dependencyGraph`,
292
310
  `evaluator`, `columnSearch`, and `lazilyTransformingAstService`.
311
+ - Cached XLSX result parity is a testable corpus property, not a blanket
312
+ package guarantee. Use `pnpm workpaper:xlsx-corpus:check -- <corpus>` for
313
+ supplied workbook corpora, and keep unsupported or volatile workbook functions
314
+ documented in the resulting report.
293
315
 
294
316
  ## For Coding Agents
295
317
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bilig/headless",
3
- "version": "0.8.2",
3
+ "version": "0.9.0",
4
4
  "description": "Headless spreadsheet engine and WorkPaper workbook facade for Node services, coding agents, and HyperFormula-style workflows.",
5
5
  "keywords": [
6
6
  "agent",
@@ -49,9 +49,9 @@
49
49
  "build": "rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
50
50
  },
51
51
  "dependencies": {
52
- "@bilig/core": "0.8.2",
53
- "@bilig/formula": "0.8.2",
54
- "@bilig/protocol": "0.8.2"
52
+ "@bilig/core": "0.9.0",
53
+ "@bilig/formula": "0.9.0",
54
+ "@bilig/protocol": "0.9.0"
55
55
  },
56
56
  "engines": {
57
57
  "node": ">=24.0.0"