context7.json

{
  "$schema": "https://context7.com/schema/context7.json",
  "projectTitle": "Bilig WorkPaper",
  "description": "Formula WorkPaper runtime for Node.js services and agent tools: edit cells, recalculate, verify readback, and persist JSON without spreadsheet UI automation.",
  "branch": "main",
  "folders": [
    "docs",
    "packages/workpaper",
    "packages/create-workpaper",
    "packages/workbook",
    "packages/headless",
    "examples/headless-workpaper",
    "examples/serverless-workpaper-api",
    "examples/workbook-agent-model",
    "examples/xlsx-recalculation-node",
    "skills"
  ],
  "excludeFolders": [
    "apps",
    "artifacts",
    "build",
    "coverage",
    "dist",
    "node_modules",
    "output",
    "test-results",
    ".cache",
    ".git",
    ".github",
    "packages/workpaper/dist",
    "packages/workpaper/node_modules",
    "packages/workpaper/src/__tests__",
    "packages/create-workpaper/node_modules",
    "packages/workbook/dist",
    "packages/workbook/node_modules",
    "packages/workbook/src/__tests__",
    "packages/headless/dist",
    "packages/headless/fixtures",
    "packages/headless/node_modules",
    "packages/headless/src/__tests__"
  ],
  "excludeFiles": ["pnpm-lock.yaml", "tsconfig.tsbuildinfo", "workspace-resolution.generated.json"],
  "rules": [
    "Use @bilig/workpaper for service-side formula workflows that need explicit cell edits, recalculation, readback, and JSON persistence.",
    "Prefer the file-backed bilig-workpaper-mcp server when an agent needs deterministic workbook operations through MCP tools.",
    "Use @bilig/headless only for lower-level runtime subpaths, package-boundary audits, provenance checks, or work that explicitly targets the headless package internals.",
    "Use https://bilig.proompteng.ai/mcp for stateless Streamable HTTP MCP discovery or connector smoke tests; use file-backed stdio when edits must persist to a project WorkPaper JSON file.",
    "Verify WorkPaper edits with read-before-write, set_cell_contents, calculated readback, and export_workpaper_document before claiming success.",
    "Do not use Bilig as a replacement for native Excel macros, desktop Office automation, or rich spreadsheet UI formatting."
  ]
}