lark-remote 0.4.3 → 0.4.5

package/dist/update/index.js

@@ -5,6 +5,6 @@
  * package installation (detect package manager + global install),
  * and the combined workflow for the /update command and --update CLI flag.
  */
-export { isNewer, checkLatestVersion, formatUpdateHint, } from './version-check.js';
+export { compareVersions, checkLatestVersion, formatUpdateHint, } from './version-check.js';
 export { runInstallLatest } from './install.js';
 //# sourceMappingURL=index.js.map

package/dist/update/version-check.d.ts

@@ -12,10 +12,12 @@ export interface VersionCheckResult {
 }
 /**
  * Compare two semver strings (major.minor.patch).
- * Returns true if latest > current, false if latest <= current,
- * null if either version is not a valid semver string.
+ *
+ * Returns the sign of `latest - current`: `1` if latest is newer, `-1` if it
+ * is older, `0` if equal. Returns `null` if either version is not a valid
+ * semver string (callers should treat `null` as "not newer").
  */
-export declare function isNewer(current: string, latest: string): boolean | null;
+export declare function compareVersions(current: string, latest: string): -1 | 0 | 1 | null;
 /**
  * Check the latest available version of lark-remote.
  * Uses a local cache file with 1-hour TTL to avoid frequent network requests.

package/dist/update/version-check.js

@@ -10,10 +10,12 @@ export const CACHE_TTL_MS = 60 * 60 * 1000;
 const DEFAULT_REGISTRY_URL = 'https://registry.npmjs.org/lark-remote/latest';
 /**
  * Compare two semver strings (major.minor.patch).
- * Returns true if latest > current, false if latest <= current,
- * null if either version is not a valid semver string.
+ *
+ * Returns the sign of `latest - current`: `1` if latest is newer, `-1` if it
+ * is older, `0` if equal. Returns `null` if either version is not a valid
+ * semver string (callers should treat `null` as "not newer").
  */
-export function isNewer(current, latest) {
+export function compareVersions(current, latest) {
     const parse = (v) => {
         // Split core and pre-release suffix; compare the core numerically and treat
         // a release as newer than any pre-release of the same core version.
@@ -32,14 +34,14 @@ export function isNewer(current, latest) {
         return null;
     for (let i = 0; i < 3; i++) {
         if (l.nums[i] > c.nums[i])
-            return true;
+            return 1;
         if (l.nums[i] < c.nums[i])
-            return false;
+            return -1;
     }
     // Equal core version: a release beats a pre-release of the same version.
     if (c.pre !== l.pre)
-        return l.pre === '';
-    return false;
+        return l.pre === '' ? 1 : -1;
+    return 0;
 }
 /**
  * Fetch the latest version from npm registry.
@@ -151,7 +153,7 @@ export async function checkLatestVersion(opts) {
  * Returns null if no newer version is available.
  */
 export function formatUpdateHint(current, latest) {
-    if (!isNewer(current, latest))
+    if (compareVersions(current, latest) !== 1)
         return null;
     return `📦 有新版本 ${latest} 可用（当前 ${current}），发送 /update 升级`;
 }

package/dist/workspace/index.d.ts

@@ -1,11 +1,11 @@
-/** Public view of a workspace entry returned by list(). */
+/** Public view of a cwd entry returned by list(). */
 export interface WorkspaceEntry {
     name: string;
     path: string;
     lastUsedAt: number;
 }
 /**
- * Persistent named-alias store for workspace directories.
+ * Persistent named-alias store for cwd directories.
  *
  * Atomic write (§9.10): writes a temp file then `fs.rename` so a crash
  * mid-write cannot leave a truncated JSON file. On load, a corrupt file
@@ -13,7 +13,7 @@ export interface WorkspaceEntry {
  *
  * lastUsedAt 语义（2026-08-19 语义对齐）：保存（save）与使用（use/touch）
  * 都会把时间戳更新为当前时间。save 内部调用 touch，保证「最近使用」排序
- * 对新保存的 workspace 同样生效（新条目应排在列表最前，而非沉底）。
+ * 对新保存的 cwd 同样生效（新条目应排在列表最前，而非沉底）。
  * 同一毫秒内连续操作时 touch 会用 max+1 保证严格递增，避免 Date.now 相同
  * 导致最近排序退化为字母序。
  *
@@ -42,7 +42,7 @@ export declare class WorkspaceStore {
      */
     touch(name: string): void;
     /**
-     * List all workspace entries in insertion order.
+     * List all cwd entries in insertion order.
      * Sorting is the caller's responsibility (view concern).
      */
     list(): WorkspaceEntry[];

package/dist/workspace/index.js

@@ -4,7 +4,7 @@ import { atomicWriteJson } from '../persistence/atomic-write.js';
 import { loadJsonFile } from '../persistence/load-json-file.js';
 import { getLogger } from '../logger/index.js';
 /**
- * Persistent named-alias store for workspace directories.
+ * Persistent named-alias store for cwd directories.
  *
  * Atomic write (§9.10): writes a temp file then `fs.rename` so a crash
  * mid-write cannot leave a truncated JSON file. On load, a corrupt file
@@ -12,7 +12,7 @@ import { getLogger } from '../logger/index.js';
  *
  * lastUsedAt 语义（2026-08-19 语义对齐）：保存（save）与使用（use/touch）
  * 都会把时间戳更新为当前时间。save 内部调用 touch，保证「最近使用」排序
- * 对新保存的 workspace 同样生效（新条目应排在列表最前，而非沉底）。
+ * 对新保存的 cwd 同样生效（新条目应排在列表最前，而非沉底）。
  * 同一毫秒内连续操作时 touch 会用 max+1 保证严格递增，避免 Date.now 相同
  * 导致最近排序退化为字母序。
  *
@@ -46,7 +46,7 @@ export class WorkspaceStore {
                 const lastUsedAt = typeof obj.lastUsedAt === 'number' ? obj.lastUsedAt : 0;
                 if (typeof obj.lastUsedAt !== 'number') {
                     if (obj.lastUsedAt !== undefined) {
-                        getLogger().warn(`[workspace] "${k}" has invalid lastUsedAt (${JSON.stringify(obj.lastUsedAt)}), resetting to 0`);
+                        getLogger().warn(`[cwd] "${k}" has invalid lastUsedAt (${JSON.stringify(obj.lastUsedAt)}), resetting to 0`);
                     }
                     needsMigration = true;
                 }
@@ -66,7 +66,7 @@ export class WorkspaceStore {
         atomicWriteJson(this.filePath, obj);
     }
     save(name, dirPath) {
-        // 保存即视为使用（语义对齐）：新建/覆盖的 workspace 都应拿到当前
+        // 保存即视为使用（语义对齐）：新建/覆盖的 cwd 都应拿到当前
         // lastUsedAt，而不是 0，否则「最近使用」排序下新条目会沉底。
         // touch() 负责统一写入时间戳并 persist，消除 save 写 0 / use 写 now 的不对称。
         this.data.set(name, { path: dirPath, lastUsedAt: 0 });
@@ -111,7 +111,7 @@ export class WorkspaceStore {
         this.persist();
     }
     /**
-     * List all workspace entries in insertion order.
+     * List all cwd entries in insertion order.
      * Sorting is the caller's responsibility (view concern).
      */
     list() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lark-remote",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Feishu (Lark) private-chat bridge to local coding agents — Claude Code / Codex / opencode / pi / kimi, with live-streaming CardKit 2.0 cards",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",