larkway 0.3.62 → 0.3.63

package/README.md

@@ -8,7 +8,7 @@
 
 You @ the bot in a Feishu thread. It runs on your machine — reading your real codebase, executing commands, opening MRs — and posts the result back. You define what the agent knows and what it can do. Larkway just carries the messages.
 
-**Current release: v0.3.62**
+**Current release: v0.3.63**
 
 ---
 
@@ -195,7 +195,7 @@ platform-fact writeups: [docs/task-handle.md](docs/task-handle.md).
 
 ## Requirements
 
-- **macOS or Linux** — native Windows is not supported yet (the runtime depends on POSIX tooling such as `bash` and `pgrep`); on Windows, install and run everything (Node.js, larkway, Claude Code / Codex, `lark-cli`) inside [WSL](https://learn.microsoft.com/windows/wsl/install)
+- **macOS, Linux, or Windows** — native Windows support is in beta (service registration via Task Scheduler; the full test suite runs on Windows CI); [WSL](https://learn.microsoft.com/windows/wsl/install) remains a fully-supported alternative if you prefer a Linux environment
 - **Node.js 20+ LTS**
 - **A Claude Code or Codex subscription** with local CLI installed and logged in
 - **`lark-cli`** — Feishu long-connection client and message utilities: `npm i -g @larksuite/cli`, then `lark-cli auth login` (the agent uses it to read thread history and attachments; `larkway doctor` checks it's present)

package/README.zh.md

@@ -8,7 +8,7 @@
 
 你在飞书话题里 @ bot，它在你的机器上运行——读真实代码库、执行命令、开 MR——把结果贴回飞书。你定义 agent 知道什么、能做什么。Larkway 只负责传递消息。
 
-**当前版本：v0.3.62**
+**当前版本：v0.3.63**
 
 ---
 
@@ -152,10 +152,11 @@ scope 是否健康）。完整设计、配置项、平台事实排查记录见
 
 ## 前置要求
 
+- **macOS / Linux / Windows** —— 原生 Windows 支持处于 beta(服务注册走任务计划程序;全量测试已在 Windows CI 上运行);偏好 Linux 环境也可继续用 [WSL](https://learn.microsoft.com/windows/wsl/install)
 - **Node.js 20+ LTS**
 - **Claude Code 或 Codex 订阅**，本地 CLI 已安装并登录
 - **`lark-cli`** —— 飞书长连接客户端和消息工具
-- **`glab` + `git`** —— 需要开 MR 的 bot 必须；只读 bot 可省
+- **`git` + `gh`** —— 需要开 PR 的 bot 必须(GitHub 为默认;GitLab 仓库用 `glab`);只读 bot 可省
 - **一台常开的机器** —— bridge 必须持续运行才能接收飞书事件；经常休眠的笔记本会漏消息，小服务器或台式机更合适
 
 ---

package/bin/larkway.mjs

@@ -15,33 +15,11 @@ import { spawnSync } from "node:child_process";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
-if (process.platform === "win32") {
-  // Native Windows support is implemented (cross-spawn layer + schtasks
-  // service adapter) but not yet validated on real hardware, so it stays
-  // behind an explicit opt-in until then. Default: fail fast with WSL
-  // guidance instead of letting users hit rough edges unwarned.
-  if (process.env.LARKWAY_EXPERIMENTAL_WINDOWS === "1") {
-    console.error(
-      "[larkway] native Windows support is EXPERIMENTAL (LARKWAY_EXPERIMENTAL_WINDOWS=1) — please report issues.",
-    );
-  } else {
-    console.error(
-      [
-        "larkway 的原生 Windows 支持仍在验证中,默认未开放。",
-        "推荐在 WSL(Windows Subsystem for Linux)中安装使用:",
-        "  1. 安装 WSL: https://learn.microsoft.com/windows/wsl/install",
-        "  2. 在 WSL 终端内安装 Node.js 20+,然后 `npm i -g larkway`",
-        "  3. Claude Code / Codex 也需安装在 WSL 内",
-        "",
-        "想帮忙试用原生 Windows(实验性):设置环境变量 LARKWAY_EXPERIMENTAL_WINDOWS=1 后重试,并欢迎反馈问题。",
-        "",
-        "Native Windows support is implemented but still being validated.",
-        "Use WSL for now, or set LARKWAY_EXPERIMENTAL_WINDOWS=1 to try the experimental native mode.",
-      ].join("\n"),
-    );
-    process.exit(1);
-  }
-}
+// Native Windows is supported (beta) since v0.3.63: cross-spawn layer for npm
+// .cmd shims, schtasks service adapter, PowerShell process discovery. The
+// 3-OS CI matrix runs the full suite on windows-latest. WSL remains a
+// fully-supported alternative. LARKWAY_EXPERIMENTAL_WINDOWS is no longer
+// required and is ignored.
 
 const selfPath = fileURLToPath(import.meta.url);
 const repoRoot = path.resolve(path.dirname(selfPath), "..");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "larkway",
-  "version": "0.3.62",
+  "version": "0.3.63",
   "description": "Thin bridge: Feishu thread to local Claude Code CLI",
   "license": "MIT",
   "author": "Chuck Wu (chuckwu0)",