larkway 0.3.58 → 0.3.59

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.58**
+**Current release: v0.3.59**
 
 ---
 
@@ -61,7 +61,7 @@ Feishu thread
 
 **What Larkway does NOT do** — the agent decides everything else:
 
-- No GitLab/GitHub API calls (the agent runs `glab`/`gh` itself)
+- No GitHub/GitLab API calls (the agent runs `gh`/`glab` itself)
 - No worktree creation (the agent runs `git worktree add`)
 - No dev server management (the agent starts it)
 - No orchestration logic — the agent reads your `AGENTS.md` / `CLAUDE.md` / skills and plans its own steps
@@ -194,10 +194,11 @@ 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)
 - **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)
-- **`glab` + `git`** — for bots that open MRs (optional for read-only bots)
+- **`git` + `gh`** — for bots that open PRs (GitHub is the default forge; use `glab` instead for GitLab repos; both optional for read-only bots)
 - **An always-on host machine** — the bridge must stay running to receive Feishu events; a laptop that sleeps will miss messages; a small server or desktop works well
 
 ---

package/README.zh.md

@@ -8,7 +8,7 @@
 
 你在飞书话题里 @ bot，它在你的机器上运行——读真实代码库、执行命令、开 MR——把结果贴回飞书。你定义 agent 知道什么、能做什么。Larkway 只负责传递消息。
 
-**当前版本：v0.3.58**
+**当前版本：v0.3.59**
 
 ---
 

package/bin/larkway.mjs

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+// larkway CLI shim — resolves the package root from this script's own location
+// so it works whether invoked via `bin/larkway`, an absolute path, or a symlink
+// on PATH (e.g. after `npm i -g`).
+//
+// Written in Node (not bash) so npm's cross-platform bin shims work everywhere:
+// a bash shebang made Windows installs fail at startup with
+// `/bin/bash: C:Users...: No such file or directory` before any of our code ran.
+//
+// Startup priority:
+//   1. dist/cli/index.js exists  → import it in-process (installed package / post-build)
+//   2. otherwise                 → `npx tsx src/cli/index.ts` (fresh clone dev mode, no build)
+import { existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+if (process.platform === "win32") {
+  // The bridge runtime depends on POSIX tooling (bash supervisor, pgrep, lsof),
+  // so native Windows is not supported yet — fail fast with guidance instead of
+  // crashing later with an obscure error.
+  console.error(
+    [
+      "larkway 暂不支持原生 Windows 运行(依赖 bash / pgrep 等 POSIX 工具)。",
+      "推荐在 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 内",
+      "",
+      "larkway does not yet support native Windows (it depends on POSIX tooling",
+      "such as bash and pgrep). Please install and run it inside WSL instead.",
+    ].join("\n"),
+  );
+  process.exit(1);
+}
+
+const selfPath = fileURLToPath(import.meta.url);
+const repoRoot = path.resolve(path.dirname(selfPath), "..");
+const distEntry = path.join(repoRoot, "dist", "cli", "index.js");
+
+if (existsSync(distEntry)) {
+  await import(pathToFileURL(distEntry).href);
+} else {
+  // Dev fallback: run TypeScript source directly via tsx.
+  const result = spawnSync(
+    "npx",
+    ["tsx", path.join(repoRoot, "src", "cli", "index.ts"), ...process.argv.slice(2)],
+    { stdio: "inherit" },
+  );
+  process.exit(result.status ?? 1);
+}

package/dist/cli/index.js

@@ -127480,6 +127480,9 @@ function repoLooksGitLab(urlOrSlug) {
 function botUsesGitLab(bot) {
   return bot.repos.some((repo) => repoLooksGitLab(repo.url ?? repo.slug));
 }
+function botUsesGitHub(bot) {
+  return bot.repos.some((repo) => !repoLooksGitLab(repo.url ?? repo.slug));
+}
 function addCliRequirement(requirements, input) {
   const existing = requirements.get(`cli:${input.command}`);
   if (existing) {
@@ -127563,6 +127566,16 @@ function runtimeRequirementsForBots(bots) {
         });
       }
     }
+    if (botUsesGitHub(bot)) {
+      addCliRequirement(requirements, {
+        command: "gh",
+        label: "GitHub CLI",
+        severity: "optional",
+        botIds: [bot.id],
+        reason: "Only needed when an agent uses GitHub-specific actions such as PRs, issues, or releases.",
+        installHint: "Install gh only for bots that need GitHub-specific workflow commands."
+      });
+    }
     if (botUsesGitLab(bot)) {
       addCliRequirement(requirements, {
         command: "glab",

package/dist/main.js

@@ -115431,7 +115431,7 @@ async function renderPrompt(input) {
       `    lark-cli docs +get <doc-url>${profileFlag}`,
       "- \u53D6\u672C\u6761\u6D88\u606F\u7684\u9644\u4EF6/\u5185\u8054\u56FE(post \u5185\u8054\u56FE\u4E0D\u5728\u4E0A\u9762 attachments/images \u91CC)\u3001\u62C9\u8BDD\u9898\u5386\u53F2:",
       attachmentHelpLine,
-      "- glab / gh / git API",
+      "- gh / glab / git API",
       "- pnpm / npm",
       "",
       chatHistoryFirst ? "**\u91CD\u8981**:\u8FD9\u662F\u5355\u804A/\u7C98\u8FDE session \u573A\u666F,\u4E0A\u4E0B\u6587\u5386\u53F2\u7528\u4E0A\u9762\u7684 chat-messages-list \u62C9\u53D6;\u4E0D\u8981\u628A `thread_id` \u5F53\u4F5C\u53EF\u62C9\u53D6\u7684\u6D88\u606F id \u4F7F\u7528\u3002" : "**\u91CD\u8981**:`thread_id` \u5C31\u662F\u8BDD\u9898\u9996\u697C\u7684 message_id\u3002\u5982\u679C\u5F53\u524D\u6D88\u606F attachments/feishu_doc_links \u4E3A\u7A7A,\u8BF4\u660E\u8FD0\u8425\u628A\u7D20\u6750\u653E\u5728\u9996\u697C,**\u5148\u62C9\u9996\u697C\u770B\u8FD0\u8425\u539F\u59CB\u9700\u6C42**,\u518D\u51B3\u5B9A\u4E0B\u4E00\u6B65\u3002",
@@ -118792,6 +118792,7 @@ stderr: ${stderr}`));
 var CORE_ALLOW_RULES = [
   "Bash(lark-cli *)",
   "Bash(git *)",
+  "Bash(gh *)",
   "Bash(glab *)",
   "Bash(lsof *)",
   "Bash(curl *)",
@@ -127694,6 +127695,9 @@ function repoLooksGitLab(urlOrSlug) {
 function botUsesGitLab(bot) {
   return bot.repos.some((repo) => repoLooksGitLab(repo.url ?? repo.slug));
 }
+function botUsesGitHub(bot) {
+  return bot.repos.some((repo) => !repoLooksGitLab(repo.url ?? repo.slug));
+}
 function addCliRequirement(requirements, input) {
   const existing = requirements.get(`cli:${input.command}`);
   if (existing) {
@@ -127777,6 +127781,16 @@ function runtimeRequirementsForBots(bots) {
         });
       }
     }
+    if (botUsesGitHub(bot)) {
+      addCliRequirement(requirements, {
+        command: "gh",
+        label: "GitHub CLI",
+        severity: "optional",
+        botIds: [bot.id],
+        reason: "Only needed when an agent uses GitHub-specific actions such as PRs, issues, or releases.",
+        installHint: "Install gh only for bots that need GitHub-specific workflow commands."
+      });
+    }
     if (botUsesGitLab(bot)) {
       addCliRequirement(requirements, {
         command: "glab",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "larkway",
-  "version": "0.3.58",
+  "version": "0.3.59",
   "description": "Thin bridge: Feishu thread to local Claude Code CLI",
   "license": "MIT",
   "author": "Chuck Wu (chuckwu0)",
@@ -17,7 +17,7 @@
   },
   "type": "module",
   "bin": {
-    "larkway": "bin/larkway"
+    "larkway": "bin/larkway.mjs"
   },
   "scripts": {
     "start": "tsx src/main.ts",
@@ -54,7 +54,7 @@
   },
   "files": [
     "dist/",
-    "bin/larkway",
+    "bin/larkway.mjs",
     "README.md"
   ]
 }

package/bin/larkway

@@ -1,25 +0,0 @@
-#!/usr/bin/env bash
-# larkway CLI shim — resolves the package root from this script's own location
-# so it works whether invoked via `bin/larkway`, an absolute path, or a symlink
-# on PATH (e.g. after `npm i -g`).
-#
-# Startup priority:
-#   1. dist/cli/index.js exists  → `node dist/cli/index.js` (installed package / post-build)
-#   2. otherwise                 → `npx tsx src/cli/index.ts` (fresh clone dev mode, no build)
-set -euo pipefail
-SOURCE="${BASH_SOURCE[0]}"
-while [ -h "$SOURCE" ]; do
-  DIR="$(cd -P "$(dirname "$SOURCE")" >/dev/null 2>&1 && pwd)"
-  SOURCE="$(readlink "$SOURCE")"
-  [[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE"
-done
-REPO_ROOT="$(cd -P "$(dirname "$SOURCE")/.." >/dev/null 2>&1 && pwd)"
-
-DIST_ENTRY="$REPO_ROOT/dist/cli/index.js"
-
-if [ -f "$DIST_ENTRY" ]; then
-  exec node "$DIST_ENTRY" "$@"
-else
-  # Dev fallback: run TypeScript source directly via tsx.
-  exec npx tsx "$REPO_ROOT/src/cli/index.ts" "$@"
-fi