@bilig/workpaper 0.62.0 → 0.66.0

package/AGENTS.md

@@ -38,16 +38,16 @@ Do not claim success from a write call alone. The proof is computed readback plu
 ## Fast Commands
 
 ```sh
-npm exec --package @bilig/workpaper@0.62.0 -- bilig-agent-challenge
-npm exec --package @bilig/workpaper@0.62.0 -- bilig-mcp-challenge
-npm exec --package @bilig/workpaper@0.62.0 -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
-npm exec --package @bilig/workpaper@0.62.0 -- bilig-formula-clinic ./reduced.xlsx --cells "Summary!B7,Inputs!B2"
+npm exec --package @bilig/workpaper@0.66.0 -- bilig-agent-challenge
+npm exec --package @bilig/workpaper@0.66.0 -- bilig-mcp-challenge
+npm exec --package @bilig/workpaper@0.66.0 -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
+npm exec --package @bilig/workpaper@0.66.0 -- bilig-formula-clinic ./reduced.xlsx --cells "Summary!B7,Inputs!B2"
 ```
 
 Claude Desktop users can install the released MCPB bundle from:
 
-- https://github.com/proompteng/bilig/releases/download/libraries-v0.62.0/bilig-workpaper.mcpb
-- https://github.com/proompteng/bilig/releases/download/libraries-v0.62.0/bilig-workpaper.mcpb.sha256
+- https://github.com/proompteng/bilig/releases/download/libraries-v0.66.0/bilig-workpaper.mcpb
+- https://github.com/proompteng/bilig/releases/download/libraries-v0.66.0/bilig-workpaper.mcpb.sha256
 
 ## Direct TypeScript
 

package/README.md

@@ -15,6 +15,17 @@ serverless route, test, or coding-agent tool.
 npm install @bilig/workpaper
 ```
 
+## Start Here
+
+Pick the path that matches the workflow you are trying to unblock:
+
+| You need... | Run this first | Proof you should get |
+| --- | --- | --- |
+| Formula workbook logic inside a Node service, route, queue, or test | `npm create @bilig/workpaper@latest pricing-workpaper` | Inputs are written, formulas recalculate, JSON persists, restore matches readback, and `verified: true` is printed. |
+| A coding agent or MCP client that needs spreadsheet operations | `npm create @bilig/workpaper@latest pricing-agent -- --agent` | The generated project includes an agent contract, MCP config, and `npm run agent:verify`. |
+| n8n, Dify, or Flowise formula readback without spreadsheet UI automation | `npm exec --package @bilig/workpaper@latest -- bilig-n8n-formula-server --port 4321` | The workflow writes one input cell, reads dependent formula output, and returns a compact JSON proof. |
+| An existing `.xlsx` file with stale formula results after Node edits | `npx --package @bilig/xlsx-formula-recalc xlsx-recalc --demo --json` | The file-level path updates inputs and returns fresh formula values without Excel, LibreOffice, or a browser. |
+
 ## Use A WorkPaper In Node
 
 ```ts
@@ -55,12 +66,34 @@ The package ships proof commands for coding agents and service evaluators:
 ```sh
 npm exec --package @bilig/workpaper -- bilig-agent-challenge
 npm exec --package @bilig/workpaper -- bilig-mcp-challenge
+npm exec --package @bilig/workpaper -- bilig-n8n-formula-server --port 4321
 npm exec --package @bilig/workpaper -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable
 ```
 
 The challenge commands edit one input, recalculate dependent formulas, export
 WorkPaper JSON, restore it, and print a `verified: true` proof object.
 
+## Agent Workflow Builders
+
+Use the local formula-readback server when an agent workflow platform should
+orchestrate the task but Bilig should own workbook state:
+
+```sh
+npm exec --package @bilig/workpaper@latest -- bilig-n8n-formula-server --port 4321
+```
+
+Start from the repo examples:
+
+- `examples/n8n-workpaper-formula-readback/bilig-workpaper-formula-readback.n8n.json`
+- `examples/dify-workpaper-formula-readback`
+- `examples/flowise-workpaper-formula-readback/bilig-workpaper-formula-readback.flowise-tool.json`
+
+Docs:
+
+- <https://proompteng.github.io/bilig/n8n-workpaper-formula-readback.html>
+- <https://proompteng.github.io/bilig/dify-workpaper-formula-readback.html>
+- <https://proompteng.github.io/bilig/flowise-workpaper-formula-readback.html>
+
 ## XLSX Import And Export
 
 ```ts

package/SKILL.md

@@ -42,7 +42,7 @@ Before wiring a client, an agent can prove the direct WorkPaper loop with:
 ```json
 {
   "command": "npm",
-  "args": ["exec", "--package", "@bilig/workpaper@0.62.0", "--", "bilig-agent-challenge"]
+  "args": ["exec", "--package", "@bilig/workpaper@0.66.0", "--", "bilig-agent-challenge"]
 }
 ```
 
@@ -51,7 +51,7 @@ For the actual file-backed MCP path, run the package-owned challenge first:
 ```json
 {
   "command": "npm",
-  "args": ["exec", "--package", "@bilig/workpaper@0.62.0", "--", "bilig-mcp-challenge"]
+  "args": ["exec", "--package", "@bilig/workpaper@0.66.0", "--", "bilig-mcp-challenge"]
 }
 ```
 
@@ -61,7 +61,7 @@ For the actual file-backed MCP path, run the package-owned challenge first:
   "args": [
     "exec",
     "--package",
-    "@bilig/workpaper@0.62.0",
+    "@bilig/workpaper@0.66.0",
     "--",
     "bilig-workpaper-mcp",
     "--workpaper",
@@ -138,7 +138,7 @@ When the user has a reduced XLSX formula/import bug, generate a local report thr
   "args": [
     "exec",
     "--package",
-    "@bilig/workpaper@0.62.0",
+    "@bilig/workpaper@0.66.0",
     "--",
     "bilig-formula-clinic",
     "./reduced.xlsx",

package/dist/n8n-forecast-server-bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/n8n-forecast-server-bin.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runN8nForecastServerCli } from '@bilig/headless/cli';
+process.exitCode = runN8nForecastServerCli({
+    argv: process.argv.slice(2),
+    env: process.env,
+});
+//# sourceMappingURL=n8n-forecast-server-bin.js.map

package/dist/n8n-forecast-server-bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-forecast-server-bin.js","sourceRoot":"","sources":["../src/n8n-forecast-server-bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAE7D,OAAO,CAAC,QAAQ,GAAG,uBAAuB,CAAC;IACzC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3B,GAAG,EAAE,OAAO,CAAC,GAAG;CACjB,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bilig/workpaper",
-  "version": "0.62.0",
+  "version": "0.66.0",
   "description": "Scoped Bilig WorkPaper runtime and MCP server for Node.js services, agent tools, and server-side spreadsheet formulas.",
   "keywords": [
     "agent-tools",
@@ -45,6 +45,7 @@
     "bilig-agent-challenge": "./dist/agent-workbook-challenge-bin.js",
     "bilig-formula-clinic": "./dist/formula-clinic-bin.js",
     "bilig-mcp-challenge": "./dist/mcp-challenge-bin.js",
+    "bilig-n8n-formula-server": "./dist/n8n-forecast-server-bin.js",
     "bilig-workpaper-mcp": "./dist/work-paper-mcp-stdio-bin.js"
   },
   "files": [
@@ -83,8 +84,8 @@
     "build": "pnpm --dir ../.. --filter bilig-workpaper build && rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@bilig/headless": "0.62.0",
-    "bilig-workpaper": "0.62.0"
+    "@bilig/headless": "0.66.0",
+    "bilig-workpaper": "0.66.0"
   },
   "engines": {
     "node": ">=22.0.0"

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.proompteng/bilig-workpaper",
   "title": "Bilig WorkPaper",
   "description": "WorkPaper MCP tools, resources, and prompts for readback, edits, and JSON persistence.",
-  "version": "0.62.0",
+  "version": "0.66.0",
   "repository": {
     "url": "https://github.com/proompteng/bilig",
     "source": "github"
@@ -18,7 +18,7 @@
     {
       "registryType": "npm",
       "identifier": "@bilig/workpaper",
-      "version": "0.62.0",
+      "version": "0.66.0",
       "transport": {
         "type": "stdio"
       }