@bilig/headless 0.10.10 → 0.10.12

package/README.md

@@ -99,6 +99,12 @@ Repository:
 - npm: <https://www.npmjs.com/package/@bilig/headless>
 - runnable example:
   [`examples/headless-workpaper`](../../examples/headless-workpaper)
+- Node service recipe:
+  [`docs/node-service-workpaper-recipe.md`](../../docs/node-service-workpaper-recipe.md)
+- CSV-shaped input recipe:
+  [`docs/csv-shaped-workpaper-input-recipe.md`](../../docs/csv-shaped-workpaper-input-recipe.md)
+- unsupported formula troubleshooting:
+  [`docs/unsupported-formula-troubleshooting-recipe.md`](../../docs/unsupported-formula-troubleshooting-recipe.md)
 - agent tool-calling recipe:
   [`docs/agent-workpaper-tool-calling-recipe.md`](../../docs/agent-workpaper-tool-calling-recipe.md)
 - public adoption kit:
@@ -111,6 +117,8 @@ Repository:
   [`docs/xlsx-corpus-verifier-walkthrough.md`](../../docs/xlsx-corpus-verifier-walkthrough.md)
 - HyperFormula comparison:
   [`docs/hyperformula-alternative-headless-workpaper.md`](../../docs/hyperformula-alternative-headless-workpaper.md)
+- local benchmark walkthrough:
+  [`docs/local-workpaper-benchmark-walkthrough.md`](../../docs/local-workpaper-benchmark-walkthrough.md)
 - XLOOKUP exact fixture walkthrough:
   [`docs/formula-edge-xlookup-exact-fixture.md`](../../docs/formula-edge-xlookup-exact-fixture.md)
 - SUMIFS paired criteria fixture walkthrough:
@@ -219,6 +227,22 @@ persistence after a successful edit.
 Repository CI also runs the same example against packed local runtime packages
 through `pnpm workpaper:smoke:external`.
 
+For a minimal service boundary with no framework dependency, see
+[`docs/node-service-workpaper-recipe.md`](../../docs/node-service-workpaper-recipe.md).
+It shows a built-in Node HTTP route that reads a computed summary, applies one
+controlled input edit, and persists the WorkPaper document.
+
+For simple tabular service payloads, see
+[`docs/csv-shaped-workpaper-input-recipe.md`](../../docs/csv-shaped-workpaper-input-recipe.md).
+It normalizes a small CSV-shaped fixture into the `WorkPaper.buildFromSheets()`
+array shape and reads formula-backed summaries.
+
+For formula error handling, see
+[`docs/unsupported-formula-troubleshooting-recipe.md`](../../docs/unsupported-formula-troubleshooting-recipe.md).
+It shows how to pair `getCellDisplayValue()` with
+`getCellFormulaDiagnostics()` so Node services and agent tools can return
+actionable errors instead of silently accepting unsupported formula inputs.
+
 For a concise evaluator-facing summary with copy-paste npm commands, proof
 links, shareable copy, and overclaim guardrails, use the root
 [`Public Adoption Kit`](../../docs/public-adoption-kit.md).
@@ -449,6 +473,11 @@ pnpm workpaper:bench:competitive:check
 pnpm run ci
 ```
 
+For a newcomer-friendly benchmark command walkthrough, see
+[`docs/local-workpaper-benchmark-walkthrough.md`](../../docs/local-workpaper-benchmark-walkthrough.md).
+It explains the committed artifact check, a reduced local smoke run, and the
+scorecard fields to compare in benchmark diffs.
+
 Regenerate the competitive artifact only when intentionally updating benchmark
 evidence:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bilig/headless",
-  "version": "0.10.10",
+  "version": "0.10.12",
   "description": "Headless spreadsheet engine and WorkPaper workbook facade for Node services, coding agents, and HyperFormula-style workflows.",
   "keywords": [
     "agent",
@@ -49,9 +49,9 @@
     "build": "rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@bilig/core": "0.10.10",
-    "@bilig/formula": "0.10.10",
-    "@bilig/protocol": "0.10.10"
+    "@bilig/core": "0.10.12",
+    "@bilig/formula": "0.10.12",
+    "@bilig/protocol": "0.10.12"
   },
   "engines": {
     "node": ">=24.0.0"