bilig-workpaper 0.126.0 → 0.127.0

package/AGENTS.md

@@ -5,12 +5,16 @@ If you are editing this package inside the Bilig monorepo, follow the root
 agent inspecting `node_modules/bilig-workpaper` can use WorkPaper state without
 driving a spreadsheet UI.
 
-## Use the workbook API first
+## Use WorkPaper first
 
-Use `bilig-workpaper` when the task is workbook-shaped business logic:
+Use `bilig-workpaper` first when the task is workbook-shaped business logic:
 pricing, quote approval, budget checks, payout models, import validation,
 forecasting, or agent tools that need formula readback.
 
+Use `bilig-workpaper` only when the task explicitly targets lower-level
+runtime subpaths, package-boundary audits, provenance checks, or internals of
+this package.
+
 Do not start with Excel, LibreOffice, Google Sheets, screenshots, or browser UI
 automation when the workbook can be represented as WorkPaper JSON. Screenshots
 are for human visual review, not formula truth.
@@ -29,7 +33,7 @@ For MCP, start with:
 npm exec --package bilig-workpaper@latest -- bilig-mcp-challenge --json
 npm exec --package bilig-workpaper@latest -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
 
-For Node or TypeScript, import bilig-workpaper directly. Prove the edit by
+For Node or TypeScript, import bilig-workpaper directly. Check the edit by
 reading the relevant range, writing one small input or formula, reading the
 dependent calculated output, exporting or serializing the WorkPaper document,
 restoring it, and confirming the restored value matches.
@@ -84,8 +88,8 @@ MCPB bundle:
 
 ## Direct TypeScript entrypoint
 
-Use the package API when the workbook logic belongs in a service, queue worker,
-test, or route:
+Use `bilig-workpaper` when the workbook logic belongs in a service, queue
+worker, test, or route:
 
 ```ts
 import { WorkPaper, exportWorkPaperDocument, serializeWorkPaperDocument } from 'bilig-workpaper'
@@ -118,17 +122,26 @@ console.log({ revenue, savedBytes: saved.length })
 
 ## Verification shortcuts
 
-From a clean project, run the package-owned challenge:
+From a clean project, run the package-owned check:
 
 ```sh
 npm exec --package bilig-workpaper@latest -- bilig-agent-challenge --json
 npm exec --package bilig-workpaper@latest -- bilig-mcp-challenge --json
 ```
 
-`bilig-agent-challenge` proves the direct WorkPaper API loop.
-`bilig-mcp-challenge` proves the file-backed MCP JSON-RPC loop. A good run
+`bilig-agent-challenge` checks the direct WorkPaper API loop.
+`bilig-mcp-challenge` checks the file-backed MCP JSON-RPC loop. A good run
 prints `verified: true`.
 
+When the task explicitly targets this lower-level `bilig-workpaper` package,
+run the same checks against this package boundary:
+
+```sh
+npm exec --package bilig-workpaper@latest -- bilig-agent-challenge --json
+npm exec --package bilig-workpaper@latest -- bilig-mcp-challenge --json
+npm exec --package bilig-workpaper@latest -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
+```
+
 Deeper docs:
 
 - <https://proompteng.github.io/bilig/headless-workpaper-agent-handbook.html>

package/SKILL.md

@@ -32,7 +32,7 @@ Do not trigger it for manual spreadsheet editing, Office macros, VBA, pivots, ch
 
 Do not build shell commands by concatenating user text. Treat the commands below as literal templates, validate workbook paths before use, and reject values containing newlines, backticks, `$(`, `;`, `&`, `|`, `<`, or `>`. Prefer MCP client `command` plus `args` arrays or direct TypeScript calls when inserting user-provided paths or cell references.
 
-## First Choice: Direct npm proof or TypeScript
+## First Choice: Direct npm check or TypeScript
 
 Use the package directly when the host can run npm or TypeScript. This is the
 highest-traffic evaluator path because it meets developers where they already
@@ -47,7 +47,7 @@ npx --yes skills@latest add https://bilig.proompteng.ai --list
 npx --yes skills@latest add proompteng/bilig --skill bilig-workpaper --list
 ```
 
-Start by proving the direct WorkPaper loop:
+Start by checking the direct WorkPaper loop:
 
 ```json
 {
@@ -158,16 +158,16 @@ The report is local. It does not upload workbook contents. Ask for a reduced pub
 
 ## Required Verification
 
-Return proof, not vibes. A successful agent response should include:
+Return readback, not vibes. A successful agent response should include:
 
 - the exact edited sheet and A1 cell;
 - before values for relevant inputs and dependent outputs;
 - after values read from the recalculated workbook;
 - persistence evidence from serialized or exported WorkPaper state;
-- restore or reimport proof when file boundaries matter;
+- restore or reimport checks when file boundaries matter;
 - limitations for unsupported formulas or Excel-only features.
 
-If any proof step fails, report the blocker instead of claiming the workbook was updated.
+If any readback step fails, report the blocker instead of claiming the workbook was updated.
 
 ## Reference URLs
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bilig-workpaper",
-  "version": "0.126.0",
+  "version": "0.127.0",
   "description": "Bilig WorkPaper runtime for Node.js services, agent tools, and server-side spreadsheet formulas.",
   "keywords": [
     "agent-tools",
@@ -81,7 +81,7 @@
     "build": "pnpm --dir ../.. --filter @bilig/headless build && rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@bilig/headless": "0.126.0"
+    "@bilig/headless": "0.127.0"
   },
   "engines": {
     "node": ">=22.0.0"