@bilig/create-workpaper
Advanced tools
@bilig/create-workpaper - npm Package Compare versions
+13
-11
| # `__PROJECT_NAME__` | ||
| Agent-ready formula WorkPaper starter built with `@bilig/workpaper`. | ||
| Formula WorkPaper starter for Node services, MCP clients, and host | ||
| integrations, built with `@bilig/workpaper`. | ||
@@ -9,4 +10,4 @@ ```sh | ||
| Generated starters also include `npm run agent:verify`, which runs the service | ||
| smoke, the basic MCP evaluator, and the richer revenue-plan evaluator: | ||
| This starter includes `npm run agent:verify`, which runs the service smoke, the | ||
| basic MCP evaluator, and the richer revenue-plan evaluator: | ||
@@ -57,9 +58,10 @@ - `npm run smoke`: writes quote inputs through a service-style API handler, | ||
| Agent instruction files are included for Claude Code, Codex/AGENTS-aware | ||
| tools, Gemini CLI, GitHub Copilot, VS Code agent mode, Cursor, Kiro, Roo Code, Trae, Qodo IDE, OpenHands, | ||
| OpenCode, Zed, Junie, Aider, Cline, Continue, Cascade/Devin, and Windsurf/Cascade. They all | ||
| point at the same rule: read first, edit one cell or formula, recalculate, read the | ||
| dependent output, persist or export, and report proof. | ||
| Host instruction files are included for Claude Code, Codex/AGENTS-aware tools, | ||
| Gemini CLI, GitHub Copilot, VS Code agent mode, Cursor, Kiro, Roo Code, Trae, | ||
| Qodo IDE, OpenHands, OpenCode, Zed, Junie, Aider, Cline, Continue, | ||
| Cascade/Devin, and Windsurf/Cascade. They all point at the same rule: read | ||
| first, edit one cell or formula, recalculate, read the dependent output, | ||
| persist or export, and report proof. | ||
| Existing projects can add only these agent files without replacing their app | ||
| Existing projects can add only these host files without replacing their app | ||
| template or editing `package.json`: | ||
@@ -75,3 +77,3 @@ | ||
| Agent handoff: | ||
| Host handoff: | ||
@@ -86,4 +88,4 @@ ```text | ||
| Agent handoff checklist: <https://proompteng.github.io/bilig/agent-adoption-kit.html> | ||
| Host handoff checklist: <https://proompteng.github.io/bilig/agent-adoption-kit.html> | ||
| Learn more: <https://github.com/proompteng/bilig> |
@@ -48,3 +48,3 @@ #!/usr/bin/env node | ||
| const targetLabel = relative(process.cwd(), targetDirectory) || '.' | ||
| console.log(`Added Bilig agent files to ${targetLabel}`) | ||
| console.log(`Added Bilig MCP and host integration files to ${targetLabel}`) | ||
| printChangeList('Wrote', overlayResult.written) | ||
@@ -163,4 +163,4 @@ printChangeList('Skipped existing', overlayResult.skipped) | ||
| Options: | ||
| --agent Add AGENTS.md, MCP client configs, and agent smoke scripts. | ||
| --add-agent Add only agent/MCP files to an existing repo. | ||
| --agent Add MCP client configs, host files, and verification scripts. | ||
| --add-agent Add only MCP and host files to an existing repo. | ||
| --template service|agent Choose the starter shape. Defaults to service. | ||
@@ -167,0 +167,0 @@ --force Allow overwriting existing generated/overlay files. |
+7
-4
| { | ||
| "name": "@bilig/create-workpaper", | ||
| "version": "0.164.2", | ||
| "version": "0.164.3", | ||
| "description": "Create a runnable Bilig WorkPaper starter for Node services and tool integrations.", | ||
@@ -8,15 +8,18 @@ "keywords": [ | ||
| "create", | ||
| "excel", | ||
| "formula-engine", | ||
| "formula-recalculation", | ||
| "headless-spreadsheet", | ||
| "formula-workbook", | ||
| "mcp", | ||
| "mcp-server", | ||
| "mcp-tools", | ||
| "model-context-protocol", | ||
| "node-services", | ||
| "nodejs", | ||
| "spreadsheet-formulas", | ||
| "tool-integration", | ||
| "typescript", | ||
| "workbook-api", | ||
| "workbook-runtime", | ||
| "workpaper", | ||
| "xlsx-recalculation" | ||
| "workpaper-json" | ||
| ], | ||
@@ -23,0 +26,0 @@ "homepage": "https://proompteng.github.io/bilig/", |
+21
-19
@@ -28,3 +28,4 @@ # @bilig/create-workpaper | ||
| For agent and MCP evaluation, generate the agent-ready starter: | ||
| For an MCP-enabled starter with host integration files, use the `--agent` | ||
| template: | ||
@@ -39,17 +40,18 @@ ```sh | ||
| The agent template adds `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, a Claude Code | ||
| project skill and proof command, GitHub Copilot / VS Code instructions, Cursor, | ||
| Kiro, Roo Code, Trae, Qodo setup docs, Zed, Junie, Aider conventions, Cline, Continue, Cascade/Devin, Windsurf rules, an OpenHands skill at | ||
| `.agents/skills/bilig-workpaper/SKILL.md`, OpenCode files at `opencode.jsonc` | ||
| and `.opencode/agents/bilig-workpaper.md`, a project-root `.mcp.json` for | ||
| Claude Code, Cursor, Kiro, Roo Code, Trae (`.trae/mcp.json`), Qodo IDE Agentic Tools, Zed (`.zed/settings.json`), Junie, | ||
| Continue, and VS Code MCP configs, a generic MCP config at | ||
| `mcp/bilig-workpaper.mcp.json`, and an `agent:verify` script that runs the | ||
| service smoke plus the package-owned basic and revenue-plan agent evaluator | ||
| proofs. The revenue-plan evaluator checks MCP tool discovery, mutation, | ||
| recalculated `SUM`, `SUMIF`, `XLOOKUP`, `FILTER`, a named expression, | ||
| The integration template keeps the service smoke test and adds project-local | ||
| MCP config, host rule files, and an `agent:verify` script. That verification | ||
| script runs the service smoke plus the package-owned basic and revenue-plan MCP | ||
| evaluator proofs. The revenue-plan evaluator checks MCP tool discovery, | ||
| mutation, recalculated `SUM`, `SUMIF`, `XLOOKUP`, `FILTER`, a named expression, | ||
| persistence, and restart readback. The raw MCP challenge remains available as | ||
| `npm run mcp:challenge` when you need the lower-level JSON-RPC transcript. | ||
| To add the same agent and MCP proof loop to an existing Node repo without | ||
| Included host files cover `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, Claude Code, | ||
| GitHub Copilot / VS Code, Cursor, Kiro, Roo Code, Trae, Qodo, Zed, Junie, | ||
| Aider, Cline, Continue, Cascade/Devin, Windsurf, OpenHands, and OpenCode. The | ||
| shared MCP command is also written to `mcp/bilig-workpaper.mcp.json`. | ||
| Representative host config files include `.kiro/settings/mcp.json`, | ||
| `.trae/mcp.json`, `.zed/settings.json`, and `.junie/mcp/mcp.json`. | ||
| To add the same MCP proof loop and host files to an existing Node repo without | ||
| replacing its app, run: | ||
@@ -63,13 +65,13 @@ | ||
| That writes Bilig-specific agent files, keeps an existing `README.md`, does | ||
| not edit `package.json`, keeps WorkPaper state under | ||
| That writes Bilig-specific host files, keeps an existing `README.md`, does not | ||
| edit `package.json`, keeps WorkPaper state under | ||
| `./.bilig/pricing.workpaper.json`, and skips existing files unless you pass | ||
| `--force`. When existing agent instruction files block part of the install, the | ||
| `--force`. When existing host instruction files block part of the install, the | ||
| CLI writes `BILIG_WORKPAPER_INSTALL.md` with the skipped paths and a short | ||
| handoff snippet you can paste into your current agent policy. The overlay uses | ||
| handoff snippet you can paste into your current policy. The overlay uses | ||
| your existing `package.json` name for `BILIG_WORKPAPER.md` instead of rendering | ||
| the directory argument. | ||
| For an existing agent or MCP client that does not need a generated project yet, | ||
| use the handoff checklist first: | ||
| For an existing MCP client or host integration that does not need a generated | ||
| project yet, use the handoff checklist first: | ||
| <https://proompteng.github.io/bilig/agent-adoption-kit.html>. |
New alerts
AI-detected potential code anomaly
Supply chain riskAI has identified unusual behaviors that may pose a security risk.
Found 3 instances
Fixed alerts
AI-detected potential code anomaly
Supply chain riskAI has identified unusual behaviors that may pose a security risk.
Found 3 instances
Improved metrics
- Total package byte prevSize
84672
0.05%- Number of lines in readme file
75
2.74%No dependency changes