bitfire-lark-mcp 1.0.0

package/docs/development/mcp-develop-and-publish.md

@@ -0,0 +1,273 @@
+# 如何开发自己的 MCP 并让别人引用
+
+本文说明如何从零开发一个 MCP（Model Context Protocol）服务，并发布到 npm、让 Cursor/Claude 等客户端引用。
+
+## 一、MCP 是什么
+
+MCP 让 AI 助手能调用你提供的**工具（Tools）**、**资源（Resources）**、**提示词（Prompts）**。开发一个 MCP 即开发一个「MCP 服务端」，通过 stdio 或 HTTP 与客户端通信。
+
+## 二、开发自己的 MCP
+
+### 2.1 两种起步方式
+
+**方式 A：用官方脚手架（推荐入门）**
+
+```bash
+npx @modelcontextprotocol/create-server my-mcp-server
+cd my-mcp-server
+npm install
+```
+
+会生成一个带示例 Tool 的 TypeScript 项目。
+
+**方式 B：在现有项目里接 SDK（本仓库做法）**
+
+```bash
+npm install @modelcontextprotocol/sdk
+# 若用 zod 做参数校验
+npm install zod
+```
+
+### 2.2 核心依赖与入口
+
+在 `package.json` 中需要：
+
+- **依赖**：`@modelcontextprotocol/sdk`
+- **入口**：编译后的 JS（如 `dist/index.js`）
+- **CLI 入口**：若通过 npx 启动，需要 `bin` 指向 CLI（如 `dist/cli.js`）
+
+本仓库示例：
+
+```json
+{
+  "main": "dist/index.js",
+  "bin": "dist/cli.js",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  }
+}
+```
+
+### 2.3 创建 MCP 服务并注册工具
+
+1. **创建 Server 实例**
+
+```ts
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+const server = new McpServer({
+  id: 'my-mcp-server',
+  name: 'My MCP Server',
+  version: '1.0.0',
+});
+```
+
+2. **注册工具（Tool）**
+
+工具由「名称、描述、参数 schema、处理函数」组成。参数一般用 Zod 定义，便于校验与类型推导：
+
+```ts
+import { z } from 'zod';
+
+server.tool(
+  'get_weather',                    // 工具名
+  'Get current weather by city',    // 描述（给 AI 看）
+  {
+    city: z.string().describe('City name'),
+    unit: z.enum(['c', 'f']).optional().describe('Temperature unit'),
+  },
+  async ({ city, unit }) => {
+    // 实现逻辑，返回 MCP 约定的格式
+    return {
+      content: [{ type: 'text', text: JSON.stringify({ city, temp: 22, unit: unit ?? 'c' }) }],
+    };
+  }
+);
+```
+
+本仓库中工具定义在 `src/mcp-tool/`，通过 `LarkMcpTool.registerMcpServer(server)` 批量注册，可参考 `src/mcp-tool/tools/en/builtin-tools/docx/builtin.ts` 的 `McpTool` 结构（name、description、schema、customHandler）。
+
+3. **（可选）资源与提示词**
+
+- **Resources**：只读数据源，AI 可按 URI 读取。
+- **Prompts**：可复用提示模板。
+
+按需在 Server 上调用 SDK 提供的 `resource` / `prompt` 等 API 即可。
+
+### 2.4 选择传输方式（如何跑起来）
+
+MCP 常见两种用法：
+
+| 传输方式 | 典型用法       | 适用场景           |
+|----------|----------------|--------------------|
+| **stdio** | `npx your-pkg mcp` | Cursor / Claude 本地进程 |
+| **HTTP (SSE/Streamable)** | 部署到服务器，客户端连 URL | 远程、多用户、需鉴权 |
+
+**stdio（本仓库做法）**
+
+- 使用 `StdioServerTransport`，与客户端通过标准输入/输出通信。
+- 在 CLI 里启动 Server 并 `server.connect(transport)`。可参考本仓库 `src/mcp-server/transport/stdio.ts` 和 `src/mcp-server/shared/init.ts`。
+
+**HTTP**
+
+- 使用 SDK 的 `StreamableHTTPServerTransport` 或 SSE 相关 Transport，在 Express（或其它框架）里挂一条 POST 路由处理 MCP 请求。本仓库 `src/mcp-server/transport/streamable.ts` 即为一例。
+
+### 2.5 CLI 入口（便于别人用 npx 跑）
+
+别人用 `npx your-package mcp` 时，实际执行的是 `package.json` 里 `bin` 指向的文件（如 `dist/cli.js`）。CLI 需要：
+
+1. 解析参数（如 `--app-id`、`--port`）。
+2. 根据参数创建 MCP Server、注册工具、选择 Transport。
+3. 调用 `server.connect(transport)` 启动。
+
+本仓库入口为 `src/cli.ts`，`mcp` 子命令里会调用 `initMcpServerWithTransport('stdio', options)`，可对照阅读。
+
+### 2.6 项目结构建议
+
+可参考本仓库：
+
+- `src/mcp-server/`：Server 初始化、各类 Transport（stdio/sse/streamable）。
+- `src/mcp-tool/`：工具定义（name、description、schema、handler）及注册逻辑。
+- `src/cli.ts`：命令行入口，解析参数并启动对应 Transport。
+- `package.json`：`main`、`bin`、`files`（发布时只带 dist、README 等）。
+
+---
+
+## 三、让别人引用你的 MCP
+
+别人要「引用」你的 MCP，本质是：在他的环境里**能启动你的 MCP 进程**，并把该进程配置到 Cursor/Claude 的 MCP 列表中。常见两种方式：**发布到 npm**、**（可选）登记到 MCP Registry**。
+
+### 3.1 发布到 npm（必须）
+
+MCP Registry 只存元数据，不存包；可执行代码需要发到 npm，别人才能 `npx your-package mcp`。
+
+1. **完善 package.json**
+
+- `name`：建议 scoped，如 `@your-org/your-mcp`，避免重名。
+- `description`、`repository`、`keywords`（如 `mcp`、`ai`）。
+- `files`：只发布必要内容，例如 `["dist", "README.md", "LICENSE"]`。
+- `engines.node`：如 `>=18.0.0`，避免用户 Node 版本过旧。
+
+2. **构建并发布**
+
+```bash
+npm install
+npm run build
+npm publish --access public
+```
+
+若首次发布 scoped 包，需 `--access public`。发布后别人即可：
+
+```bash
+npx -y @your-org/your-mcp mcp --some-arg value
+```
+
+### 3.2 在 Cursor 中引用
+
+用户在 Cursor 的 MCP 配置里增加一项，指向你的包和启动命令。例如本仓库的写法：
+
+```json
+{
+  "mcpServers": {
+    "your-mcp-name": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@your-org/your-mcp",
+        "mcp",
+        "-a", "<app_id>",
+        "-s", "<app_secret>"
+      ]
+    }
+  }
+}
+```
+
+- `command`：一般为 `npx`。
+- `args`：`-y` 避免交互，接着是包名、子命令（如 `mcp`）、你的 CLI 所需参数。
+- 若需要环境变量，可在 Cursor 的 MCP 配置里为该 server 配置 `env`。
+
+这样 Cursor 会启动你的 MCP 进程并与之通信，用户即可使用你注册的 Tools/Resources/Prompts。
+
+### 3.3 发布到 MCP Registry（可选，便于被发现）
+
+MCP Registry 是官方元数据登记处，便于用户在 [registry.modelcontextprotocol.io](https://modelcontextprotocol.io/registry/quickstart) 搜索并安装你的 MCP。
+
+1. **在 package.json 里加验证字段**
+
+```json
+{
+  "name": "@your-org/your-mcp",
+  "mcpName": "io.github.your-username/your-mcp"
+}
+```
+
+- 用 GitHub 认证时，`mcpName` 需为 `io.github.<你的 GitHub 用户名>/<服务名>`。
+- 若用域名认证，可使用 `com.yourcompany/your-mcp` 等形式。
+
+2. **安装 mcp-publisher 并初始化**
+
+```bash
+# 安装（示例：macOS）
+brew install mcp-publisher
+# 或从 GitHub Releases 下载二进制
+
+# 在项目根目录
+mcp-publisher init
+```
+
+会生成 `server.json`，需补全/修改：
+
+- `name`：与 `package.json` 的 `mcpName` 一致。
+- `version`：与 npm 包版本一致。
+- `packages[].identifier`：npm 包名。
+- `packages[].transport`：如 `{ "type": "stdio" }`。
+- 若有环境变量或启动参数，可在 `environmentVariables` 等字段中声明。
+
+3. **登录并发布到 Registry**
+
+```bash
+mcp-publisher login github   # 按提示在浏览器完成 GitHub 授权
+mcp-publisher publish
+```
+
+发布后，别人可以在支持 MCP Registry 的客户端里通过「从 Registry 安装」找到你的 MCP。
+
+---
+
+## 四、与本仓库的对应关系
+
+| 主题         | 本仓库位置 |
+|--------------|------------|
+| Server 创建与工具注册 | `src/mcp-server/shared/init.ts`、`src/mcp-tool/mcp-tool.ts` |
+| 工具定义示例 | `src/mcp-tool/tools/en/builtin-tools/docx/builtin.ts` |
+| stdio 传输   | `src/mcp-server/transport/stdio.ts` |
+| HTTP 传输    | `src/mcp-server/transport/streamable.ts` |
+| CLI 入口     | `src/cli.ts`（`mcp` 子命令） |
+| 发布配置     | `package.json`（bin、files、keywords） |
+| 用户配置示例 | `README.md` 中的 `mcpServers` 配置 |
+
+---
+
+## 五、检查清单
+
+**开发阶段**
+
+- [ ] 使用 `@modelcontextprotocol/sdk` 创建 `McpServer`。
+- [ ] 至少注册一个 Tool（name、description、schema、handler）。
+- [ ] 选择 stdio 或 HTTP，并实现对应 Transport 与 `server.connect()`。
+- [ ] 提供 CLI 入口（如 `mcp` 子命令），便于 `npx your-pkg mcp`。
+
+**发布阶段**
+
+- [ ] `package.json` 含 `main`、`bin`、`files`、`repository`、`keywords`。
+- [ ] `npm run build` 通过，且 `files` 中包含构建产物。
+- [ ] `npm publish --access public` 成功。
+- [ ] 在 README 中写明：如何用 npx 启动、如何在 Cursor 的 `mcpServers` 中配置。
+
+**（可选）MCP Registry**
+
+- [ ] `package.json` 中设置 `mcpName`。
+- [ ] 生成并填写 `server.json`，运行 `mcp-publisher publish`。
+
+按上述步骤即可开发自己的 MCP，并让其他人通过 npm 与 Cursor 配置引用你的 MCP。

package/docs/examples/read-wiki-with-board.md

@@ -0,0 +1,114 @@
+# 读取 Wiki 全文并检查画板输出 - 调用示例
+
+本文档说明如何读取指定 Wiki 页面的全文（含画板节点内容），以及如何检查输出是否包含画板。
+
+## 目标文档
+
+- **Wiki 链接**：https://newhuotech.sg.larksuite.com/wiki/MxtFwpJpWiCzuFkhXIElsMwDg0b  
+- **Wiki 节点 token**：`MxtFwpJpWiCzuFkhXIElsMwDg0b`  
+- **关联云文档 ID**（docx）：`XBsQdga2Fo2chyxQokMlpQG5gae`（由 `wiki_v2_space_getNode` 返回的 `obj_token`）
+
+## 调用步骤
+
+### 方式一：通过 MCP 工具链（推荐）
+
+在 Cursor 等支持 MCP 的客户端中，按顺序调用：
+
+**1. 获取 Wiki 节点信息（可选，若已知 docx ID 可跳过）**
+
+- **Tool**：`wiki_v2_space_getNode`
+- **参数**：
+  ```json
+  {
+    "params": {
+      "token": "MxtFwpJpWiCzuFkhXIElsMwDg0b",
+      "obj_type": "wiki"
+    },
+    "useUAT": true
+  }
+  ```
+- **从响应中取**：`node.obj_token` 作为文档 ID（本例为 `XBsQdga2Fo2chyxQokMlpQG5gae`）。
+
+**2. 读取文档全文（含画板节点）**
+
+- **Tool**：`docx_builtin_readFullContent`
+- **参数**：
+  ```json
+  {
+    "path": {
+      "document_id": "XBsQdga2Fo2chyxQokMlpQG5gae"
+    },
+    "useUAT": true
+  }
+  ```
+
+### 方式二：仅读取全文（已知 document_id）
+
+若已知该 Wiki 对应的 docx 为 `XBsQdga2Fo2chyxQokMlpQG5gae`，可直接调用：
+
+- **Tool**：`docx_builtin_readFullContent`
+- **参数**：
+  ```json
+  {
+    "path": {
+      "document_id": "XBsQdga2Fo2chyxQokMlpQG5gae"
+    },
+    "useUAT": true
+  }
+  ```
+
+## 预期输出示例
+
+### 无画板 token 或未拉取到画板节点时
+
+```text
+# test
+[画板]
+```
+
+### 有画板 token 且拉取成功时
+
+```text
+# test
+[画板]
+- [sticker] 便签内容示例
+- [text] 文本框内容
+（画板无文本节点）
+```
+
+最后一行仅在「有节点但都无文本」时出现；若有文本节点，会列出 `- [类型] 文本` 行。
+
+## 画板内容说明（含状态流转图）
+
+- **读取逻辑**：若画板块带有 `token`（画板 ID），会自动请求「画板节点列表」接口，并尝试从节点中提取文本。
+- **支持的节点内容**：文本框、便签、形状上的文字、`label`/`title`/`name`、以及流程图/状态图中可能存在的 `nodes[]`、`edges[]` 中的标签。
+- **若仍显示「画板无节点」或「无文本」**：
+  1. 飞书目前对画板内**图形、连线、状态图**的节点/文本**未必全部通过 API 暴露**，部分内容可能无法以文本形式读出。
+  2. 建议在画板中为**每个状态/步骤**尽量加上**文字说明**（便签或形状内文字），便于接口能解析到。
+  3. 确认应用已开通并勾选**画板相关权限**（如「查看画板」等），否则节点接口可能返回空。
+- **重建**：修改 `whiteboard.ts` 或 `reader.ts` 后需执行 `yarn build` 并重启 MCP 后再试。
+
+## 检查要点
+
+1. **是否包含标题**：输出应以 `# test`（或当前文档标题）开头。  
+2. **是否出现画板标注**：应包含 `[画板]`。  
+3. **是否包含画板节点**：若文档内画板块带有 token 且应用有画板权限，`[画板]` 下方会出现节点列表或「（画板无文本节点）」。  
+4. **权限或 token 缺失时**：仍会看到 `[画板]`，但不会有多行节点内容。
+
+## 前置条件
+
+- MCP 使用 `preset.doc.default`（或包含 `docx.builtin.readFullContent` 的 preset）。  
+- 已配置 OAuth 且使用 **user_access_token**（`useUAT: true`）。  
+- 若需画板节点内容：应用需具备画板相关权限；且文档块接口返回的画板块带有 `token`。  
+- 修改过 `read-full-content` / `whiteboard` 代码后，需重新 **build** 并**重启 MCP** 再测试。
+
+## 重建与重启
+
+```bash
+# 在项目根目录
+yarn build
+# 或
+npm run build
+```
+
+然后在 Cursor 中重新加载 MCP 配置或重启 Cursor，再按上述参数调用一次，对比输出是否符合预期。

package/docs/examples/wiki-board-architecture-summary.md

@@ -0,0 +1,88 @@
+# 架构图总结文档
+
+> 根据 Wiki 画板内容整理（来源：test）
+
+---
+
+## 一、整体架构概览
+
+文档中的画板描述了一个**分层架构**，自下而上分为四层：基建层、领域层、应用层、接入层。
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                      接入层 (Access)                      │
+├─────────────────────────────────────────────────────────┤
+│                      应用层 (Application)                 │
+├─────────────────────────────────────────────────────────┤
+│                      领域层 (Domain)                      │
+├─────────────────────────────────────────────────────────┤
+│                      基建层 (Infrastructure)              │
+└─────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 二、各层组成说明
+
+### 1. 接入层
+
+- **定位**：对外访问入口与流量治理
+- **主要组件**：
+  - 通用网关
+  - 反向代理
+  - 鉴权插件
+  - 网关插件 2、3、4
+
+---
+
+### 2. 应用层
+
+- **定位**：业务应用与功能模块
+- **主要组件**：
+  - **应用**：Application 1、Application 2、Application 3
+  - **功能模块**：Func 1 ~ Func 6（多个功能单元，分布在不同层级/分组中）
+
+---
+
+### 3. 领域层
+
+- **定位**：领域模型与领域服务
+- **主要组件**：
+  - **领域模型**：Model 1、Model 2、Model 3、Model 4
+  - **领域服务**：Service 1、Service 2、Service 3
+
+---
+
+### 4. 基建层
+
+- **定位**：中台能力与基础设施
+- **主要组件**：
+  - **中台服务**：中台服务 1 ~ 中台服务 6
+  - **公共存储**：Common Storage
+  - **领域服务**：Service 1（与领域层衔接）
+  - **数据与中间件**：
+    - Redis
+    - MySQL
+    - MQ（消息队列）
+
+---
+
+## 三、组件分类汇总
+
+| 类别         | 组件列表 |
+|--------------|----------|
+| 网关与代理   | 通用网关、反向代理、鉴权插件、网关插件 2/3/4 |
+| 应用         | Application 1、Application 2、Application 3 |
+| 功能模块     | Func 1 ~ Func 6 |
+| 领域模型     | Model 1 ~ Model 4 |
+| 领域服务     | Service 1、Service 2、Service 3 |
+| 中台服务     | 中台服务 1 ~ 中台服务 6 |
+| 存储与中间件 | Common Storage、Redis、MySQL、MQ |
+
+---
+
+## 四、说明
+
+- 画板中的节点包含多处**分组（group）**（如 o1:1~o1:7、o1:8~o1:12 等），表示逻辑上的组合关系，上述文档已按「层级 + 组件类型」做了归纳。
+- 同一名称（如 Func 1、Model 1）在图中可能多次出现，表示在不同上下文或分组中的引用。
+- 本文档由画板原始节点数据整理而成，用于阅读与评审；具体架构决策以实际设计与代码为准。

package/docs/recall-mcp/README.md

@@ -0,0 +1,137 @@
+# Feishu/Lark Open Platform Developer Documentation Retrieval MCP
+
+[![npm version](https://img.shields.io/npm/v/@larksuiteoapi/lark-mcp.svg)](https://www.npmjs.com/package/@larksuiteoapi/lark-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/@larksuiteoapi/lark-mcp.svg)](https://www.npmjs.com/package/@larksuiteoapi/lark-mcp)
+[![Node.js Version](https://img.shields.io/node/v/@larksuiteoapi/lark-mcp.svg)](https://nodejs.org/)
+
+English | [中文](./README_ZH.md)
+
+> **⚠️ Beta Version Notice**: This tool is currently in Beta. Features and APIs may change, so please pay close attention to version updates.
+
+This is the Feishu/Lark official Open Platform Developer Documentation Retrieval MCP (Model Context Protocol) tool, designed to help users quickly find the documentation they need after entering their requirements. It can also be used with [Feishu/Lark OpenAPI MCP](../../README.md) to enable AI assistants to run automated scenarios.
+
+> The scope of documentation retrieval covers all developer guides, tutorials, server-side APIs, and client-side APIs under the [Developer Documentation](https://open.feishu.cn/document/home/index) or [Lark Developer Documentation](https://open.larksuite.com/document/home/index), helping users quickly find the corresponding OpenAPI or other developer documentation. It does not search "Lark Docs" documents.
+
+## Getting Started
+
+### Install Node.js
+
+Before using the lark-mcp tool, you need to install the Node.js environment. If you have already installed Node.js, you can skip this step.
+1. **Install with Homebrew (Recommended):**
+
+   ```bash
+   brew install node
+   ```
+
+2. **Use the official installer:**
+   - Visit the [Node.js official website](https://nodejs.org/)
+   - Download and install the LTS version
+   - After installation, open the terminal to verify:
+     ```bash
+     node -v
+     npm -v
+     ```
+
+#### Install Node.js on Windows
+
+1. **Use the official installer:**
+
+   - Visit the [Node.js official website](https://nodejs.org/)
+   - Download and run the Windows installer (.msi file)
+   - Follow the installation wizard to complete the installation
+   - After installation, open the command prompt to verify:
+     ```bash
+     node -v
+     npm -v
+     ```
+
+2. **Use nvm-windows:**
+   - Download [nvm-windows](https://github.com/coreybutler/nvm-windows/releases)
+   - Install nvm-windows
+   - Use nvm to install Node.js:
+     ```bash
+     nvm install latest
+     nvm use <version>
+     ```
+
+## Installation
+
+Install the lark-mcp tool globally:
+
+```bash
+npm install -g @larksuiteoapi/lark-mcp
+```
+
+## User Guide
+
+### Use in Trae/Cursor/Claude
+To integrate Lark features in AI tools such as Trae, Cursor or Claude, you can install using the button below.
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=lark_open_doc_search&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBsYXJrc3VpdGVvYXBpL2xhcmstbWNwIiwicmVjYWxsLWRldmVsb3Blci1kb2N1bWVudHMiXX0=)
+
+[![Install MCP Server](../../assets/trae-cn.svg)](trae-cn://trae.ai-ide/mcp-import?source=lark&type=stdio&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBsYXJrc3VpdGVvYXBpL2xhcmstbWNwIiwicmVjYWxsLWRldmVsb3Blci1kb2N1bWVudHMiXX0=)  [![Install MCP Server](../../assets/trae.svg)](trae://trae.ai-ide/mcp-import?source=lark&type=stdio&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBsYXJrc3VpdGVvYXBpL2xhcmstbWNwIiwicmVjYWxsLWRldmVsb3Blci1kb2N1bWVudHMiXX0=)
+
+or you can add the following to your configuration file:
+
+```json
+{
+  "mcpServers": {
+    "lark-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@larksuiteoapi/lark-mcp",
+        "recall-developer-documents",
+      ]
+    }
+  }
+}
+```
+
+### Advanced Configuration
+
+#### Command Line Arguments
+
+The `lark-mcp recall-developer-documents` tool provides a variety of command line arguments for flexible MCP service configuration:
+
+| Parameter | Short | Description | Example |
+|------|------|------|------|
+| `--mode` | `-m` | Transfer mode, options are stdio or streamable or sse, default is stdio | `-m sse` |
+| `--host` |  | Listening host in SSE\Streamable mode, default is localhost | `--host 0.0.0.0` |
+| `--port` | `-p` | Listening port in SSE\Streamable mode, default is 3000 | `-p 3000` |
+| `--version` | `-V` | Show version number | `-V` |
+| `--help` | `-h` | Show help information | `-h` |
+
+#### Example Usage of Arguments
+
+1. **Transfer Modes**：
+
+    recall-developer-documents supports two transfer modes:
+
+    1. **stdio mode (default/recommended):** Suitable for integration with AI tools such as Cursor or Claude, communicating via standard input and output streams.
+      ```bash
+      lark-mcp recall-developer-documents -m stdio
+      ```
+
+    2. **SSE mode:** Provides an HTTP interface based on Server-Sent Events, suitable for web applications or scenarios requiring a network interface.
+      
+      ```bash
+      # By default, only listens on localhost
+      lark-mcp recall-developer-documents -m sse -p 3000
+      
+      # Listen on all network interfaces (allow remote access)
+      lark-mcp recall-developer-documents -m sse --host 0.0.0.0 -p 3000
+      ```
+      
+      After starting, the SSE endpoint can be accessed at `http://<host>:<port>/sse`.
+
+## Related Links
+
+- [Feishu Open Platform](https://open.feishu.cn/)
+- [Lark International Open Platform](https://open.larksuite.com/)
+- [Node.js Official Website](https://nodejs.org/)
+- [npm Documentation](https://docs.npmjs.com/)
+
+## Feedback
+
+You are welcome to submit Issues to help improve this tool. If you have any questions or suggestions, please raise them in the GitHub repository.