opencode-feishu-plugin 0.2.4 → 0.2.5

package/README.en.md

@@ -389,6 +389,7 @@ Without this relay, any clarifying question would stall the Feishu session forev
 | `logLevel` | `debug`\|`info`\|`warn`\|`error` | `info` | Log level (secrets are never logged, only their presence) |
 | `logFile` | string \| boolean | — | `true` writes `<configDir>/plugins/feishu.log`. **Plugin stderr is discarded in service mode — enable this when debugging** |
 | `gatewayLocation` | string | — | Only start the gateway in this location **or any of its subdirectories**. `~` is expanded and relative paths / trailing slashes are normalized. **Set this to your usual working directory** to avoid multiple long connections; leave empty to run in every location |
+| `gatewayMatchGraceMs` | number | `3000` | Grace window for **exact-match priority**: a subdirectory candidate waits this long and yields if a location equal to `gatewayLocation` shows up (`0` = no wait, subdirectory takes over immediately) |
 | `approvalTtlMs` | number | `600000` | Approval token / card TTL |
 | `staleExecutionMs` | number | `300000` | Watchdog threshold: an execution with no event for this long is treated as stuck and auto-interrupted; a queue stuck this long without `execution.started` also triggers a notice. Clamped to 1–60 minutes |
 | `maxResourcesShown` | number | `8` | Max resource lines shown on an approval card |

package/README.md

@@ -249,7 +249,8 @@ agent 调 `question` 等 form 类交互时，插件把它转成飞书卡片：
 | `recentDirsLimit` / `recentModelsLimit` | number | `5` | 表单「最近使用」条数（1–20） |
 | `logLevel` | `debug`\|`info`\|`warn`\|`error` | `info` | 日志级别 |
 | `logFile` | string \| boolean | — | `true` = 写 `<configDir>/plugins/feishu.log`；服务模式建议开启 |
-| `gatewayLocation` | string | — | 只在该 location（或其**子目录**）启动网关；`~` 自动展开、相对路径/尾斜杠会归一化。留空 = 任意 location 生效 |
+| `gatewayLocation` | string | — | 只在该 location（或其**子目录**兜底）启动网关；`~` 自动展开、相对路径/尾斜杠会归一化。留空 = 任意 location 生效 |
+| `gatewayMatchGraceMs` | number | `3000` | **精确匹配优先**的宽限窗口：子目录候选先等这么久，出现 `here === gatewayLocation` 就让位（0 = 不等待，子目录立即兜底） |
 | `approvalTtlMs` | number | `600000` | 审批 token / 卡片有效期 |
 | `staleExecutionMs` | number | `300000` | 看门狗阈值（夹取 1–60 分钟） |
 | `maxResourcesShown` | number | `8` | 审批卡最多展示的资源行数 |

package/dist/index.js

@@ -144033,6 +144033,7 @@ function resolveConfig2(raw, env = process.env, deps = {}) {
   const domain = merged.domain === "lark" ? "lark" : "feishu";
   const logFile = resolveLogFile(merged.logFile, env, deps);
   const gatewayLocation = normalizeGatewayLocation(asString(merged.gatewayLocation));
+  const gatewayMatchGraceMs = clamp4(asNumber(merged.gatewayMatchGraceMs, 3e3), 0, 1e4);
   const signSecretRaw = expandEnv(asString(merged.signSecret), env);
   const signSecret = signSecretRaw && signSecretRaw.length > 0 ? signSecretRaw : deriveSignSecret(appSecret);
   let enabled = true;
@@ -144062,6 +144063,7 @@ function resolveConfig2(raw, env = process.env, deps = {}) {
     logLevel,
     logFile,
     gatewayLocation,
+    gatewayMatchGraceMs,
     approvalTtlMs,
     staleExecutionMs,
     signSecret,
@@ -144276,6 +144278,45 @@ function releaseProcessGuard() {
   const g = globalThis;
   const slot = g[GUARD_SLOT];
   if (slot) slot.active = false;
+  resetExactGateway();
+}
+var GATEWAY_EXACT_SLOT = /* @__PURE__ */ Symbol.for("opencode-feishu-v2/gateway-exact");
+function electionSlot() {
+  const g = globalThis;
+  let slot = g[GATEWAY_EXACT_SLOT];
+  if (!slot) {
+    slot = { exact: false, resolvers: [] };
+    g[GATEWAY_EXACT_SLOT] = slot;
+  }
+  return slot;
+}
+function markExactGateway() {
+  const slot = electionSlot();
+  slot.exact = true;
+  if (slot.timer) {
+    clearTimeout(slot.timer);
+    slot.timer = void 0;
+  }
+  for (const resolve4 of slot.resolvers.splice(0)) resolve4(true);
+}
+function resetExactGateway() {
+  const g = globalThis;
+  const slot = g[GATEWAY_EXACT_SLOT];
+  if (slot) slot.exact = false;
+}
+function waitForExactGateway(graceMs) {
+  const slot = electionSlot();
+  if (slot.exact) return Promise.resolve(true);
+  if (!(graceMs > 0)) return Promise.resolve(false);
+  return new Promise((resolve4) => {
+    slot.resolvers.push(resolve4);
+    if (!slot.timer) {
+      slot.timer = setTimeout(() => {
+        slot.timer = void 0;
+        for (const r of slot.resolvers.splice(0)) r(false);
+      }, graceMs);
+    }
+  });
 }
 var GATEWAY_SEEN_SLOT = /* @__PURE__ */ Symbol.for("opencode-feishu-v2/gateway-seen");
 function trackGatewayLocationSeen(input) {
@@ -150996,7 +151037,9 @@ var index_default = plugin_exports.define({
       }
     }
     if (config.gatewayLocation) {
-      const matched = Boolean(here) && isUnder(here, config.gatewayLocation);
+      const exact = Boolean(here) && here === config.gatewayLocation;
+      const sub = Boolean(here) && !exact && isUnder(here, config.gatewayLocation);
+      const matched = exact || sub;
       const keepSink = matched || startedWatchdog;
       try {
         trackGatewayLocationSeen({
@@ -151015,6 +151058,24 @@ var index_default = plugin_exports.define({
         return async () => {
         };
       }
+      if (exact) {
+        markExactGateway();
+      } else {
+        const exactSeen = await waitForExactGateway(config.gatewayMatchGraceMs);
+        if (exactSeen) {
+          log2.debug("\u7CBE\u786E\u5339\u914D location \u5DF2\u5C31\u7EEA\uFF0C\u5B50\u76EE\u5F55\u5019\u9009\u8BA9\u4F4D", {
+            here,
+            expected: config.gatewayLocation
+          });
+          if (!keepSink) logSink?.close();
+          return async () => {
+          };
+        }
+        log2.info("\u7CBE\u786E\u5339\u914D location \u672A\u51FA\u73B0\uFF0C\u5B50\u76EE\u5F55\u5019\u9009\u63A5\u7BA1\u7F51\u5173", {
+          here,
+          expected: config.gatewayLocation
+        });
+      }
     }
     if (!acquireProcessGuard()) {
       log2.debug("\u68C0\u6D4B\u5230\u540C\u8FDB\u7A0B\u91CD\u590D setup\uFF0C\u8DF3\u8FC7\u542F\u52A8\uFF08\u4EC5\u9996\u4E2A\u5B9E\u4F8B\u751F\u6548\uFF09");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-feishu-plugin",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Feishu/Lark plugin for OpenCode V2 — single-user topics as sessions, in-card permission approvals, streaming cards. Minimal permissions, no public endpoint.",
   "type": "module",
   "main": "index.js",