@jackwener/opencli 1.5.0 → 1.5.2

package/src/clis/weread/utils.ts

@@ -12,11 +12,16 @@ import type { BrowserCookie, IPage } from '../../types.js';
 const WEB_API = 'https://weread.qq.com/web';
 const API = 'https://i.weread.qq.com';
 const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36';
+const WEREAD_AUTH_ERRCODES = new Set([-2010, -2012]);
 
 function buildCookieHeader(cookies: BrowserCookie[]): string {
   return cookies.map((cookie) => `${cookie.name}=${cookie.value}`).join('; ');
 }
 
+function isAuthErrorResponse(resp: Response, data: any): boolean {
+  return resp.status === 401 || WEREAD_AUTH_ERRCODES.has(Number(data?.errcode));
+}
+
 /**
  * Fetch a public WeRead web endpoint (Node.js direct fetch).
  * Used by search and ranking commands (browser: false).
@@ -78,7 +83,7 @@ export async function fetchPrivateApi(page: IPage, path: string, params?: Record
     throw new CliError('PARSE_ERROR', `Invalid JSON response for ${path}`, 'WeRead may have returned an HTML error page');
   }
 
-  if (resp.status === 401 || data?.errcode === -2010) {
+  if (isAuthErrorResponse(resp, data)) {
     throw new CliError('AUTH_REQUIRED', 'Not logged in to WeRead', 'Please log in to weread.qq.com in Chrome first');
   }
   if (!resp.ok) {

package/src/clis/xiaohongshu/publish.test.ts

@@ -51,9 +51,10 @@ describe('xiaohongshu publish', () => {
     const page = createPageMock([
       'https://creator.xiaohongshu.com/publish/publish?from=menu_left',
       { ok: true, target: '上传图文', text: '上传图文' },
-      { hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+      { state: 'editor_ready', hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
       { ok: true, count: 1 },
       false,
+      true, // waitForEditForm: editor appeared
       { ok: true, sel: 'input[maxlength="20"]' },
       { ok: true, sel: '[contenteditable="true"][class*="content"]' },
       true,
@@ -84,18 +85,23 @@ describe('xiaohongshu publish', () => {
     const cmd = getRegistry().get('xiaohongshu/publish');
     expect(cmd?.func).toBeTypeOf('function');
 
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencli-xhs-publish-'));
+    const imagePath = path.join(tempDir, 'demo.jpg');
+    fs.writeFileSync(imagePath, Buffer.from([0xff, 0xd8, 0xff, 0xd9]));
+
     const page = createPageMock([
       'https://creator.xiaohongshu.com/publish/publish?from=menu_left',
       { ok: false, visibleTexts: ['上传视频', '上传图文'] },
-      { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
-      { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
-      { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
-      { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+      { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+      { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+      { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+      { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
     ]);
 
     await expect(cmd!.func!(page, {
       title: 'DeepSeek别乱问',
       content: '一篇真实一点的小红书正文',
+      images: imagePath,
       topics: '',
       draft: false,
     })).rejects.toThrow('Still on the video publish page after trying to select 图文');
@@ -107,11 +113,18 @@ describe('xiaohongshu publish', () => {
     const cmd = getRegistry().get('xiaohongshu/publish');
     expect(cmd?.func).toBeTypeOf('function');
 
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencli-xhs-publish-'));
+    const imagePath = path.join(tempDir, 'demo.jpg');
+    fs.writeFileSync(imagePath, Buffer.from([0xff, 0xd8, 0xff, 0xd9]));
+
     const page = createPageMock([
       'https://creator.xiaohongshu.com/publish/publish?from=menu_left',
       { ok: true, target: '上传图文', text: '上传图文' },
-      { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
-      { hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+      { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+      { state: 'editor_ready', hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+      { ok: true, count: 1 }, // injectImages
+      false, // waitForUploads: no progress indicator
+      true, // waitForEditForm: editor appeared
       { ok: true, sel: 'input[maxlength="20"]' },
       { ok: true, sel: '[contenteditable="true"][class*="content"]' },
       true,
@@ -122,6 +135,7 @@ describe('xiaohongshu publish', () => {
     const result = await cmd!.func!(page, {
       title: '延迟切换也能过',
       content: '图文页切换慢一点也继续等',
+      images: imagePath,
       topics: '',
       draft: false,
     });
@@ -130,7 +144,7 @@ describe('xiaohongshu publish', () => {
     expect(result).toEqual([
       {
         status: '✅ 发布成功',
-        detail: '"延迟切换也能过" · 无图 · 发布成功',
+        detail: '"延迟切换也能过" · 1张图片 · 发布成功',
       },
     ]);
   });

package/src/clis/xiaohongshu/publish.ts

@@ -27,6 +27,22 @@ const MAX_IMAGES = 9;
 const MAX_TITLE_LEN = 20;
 const UPLOAD_SETTLE_MS = 3000;
 
+/** Selectors for the title field, ordered by priority (new UI first). */
+const TITLE_SELECTORS = [
+  // New creator center (2026-03) uses contenteditable for the title field.
+  // Placeholder observed: "填写标题会有更多赞哦"
+  '[contenteditable="true"][placeholder*="标题"]',
+  '[contenteditable="true"][placeholder*="赞"]',
+  '[contenteditable="true"][class*="title"]',
+  'input[maxlength="20"]',
+  'input[class*="title"]',
+  'input[placeholder*="标题"]',
+  'input[placeholder*="title" i]',
+  '.title-input input',
+  '.note-title input',
+  'input[maxlength]',
+];
+
 type ImagePayload = { name: string; mimeType: string; base64: string };
 
 /**
@@ -205,12 +221,19 @@ async function selectImageTextTab(
   return result;
 }
 
-async function inspectPublishSurface(
-  page: IPage,
-): Promise<{ hasTitleInput: boolean; hasImageInput: boolean; hasVideoSurface: boolean }> {
+type PublishSurfaceState = 'video_surface' | 'image_surface' | 'editor_ready';
+
+type PublishSurfaceInspection = {
+  state: PublishSurfaceState;
+  hasTitleInput: boolean;
+  hasImageInput: boolean;
+  hasVideoSurface: boolean;
+};
+
+async function inspectPublishSurfaceState(page: IPage): Promise<PublishSurfaceInspection> {
   return page.evaluate(`
     () => {
-      const text = (document.body?.innerText || '').replace(/\\s+/g, ' ').trim();
+      const text = (document.body?.innerText || '').replace(/\s+/g, ' ').trim();
       const hasTitleInput = !!Array.from(document.querySelectorAll('input, textarea')).find((el) => {
         if (!el || el.offsetParent === null) return false;
         const placeholder = (el.getAttribute('placeholder') || '').trim();
@@ -234,36 +257,57 @@ async function inspectPublishSurface(
           accept.includes('.webp')
         );
       });
-      return {
-        hasTitleInput,
-        hasImageInput,
-        hasVideoSurface: text.includes('拖拽视频到此处点击上传') || text.includes('上传视频'),
-      };
+      const hasVideoSurface = text.includes('拖拽视频到此处点击上传') || text.includes('上传视频');
+      const state = hasTitleInput ? 'editor_ready' : hasImageInput || !hasVideoSurface ? 'image_surface' : 'video_surface';
+      return { state, hasTitleInput, hasImageInput, hasVideoSurface };
     }
   `);
 }
 
-async function waitForImageTextSurface(
+async function waitForPublishSurfaceState(
   page: IPage,
   maxWaitMs = 5_000,
-): Promise<{ hasTitleInput: boolean; hasImageInput: boolean; hasVideoSurface: boolean }> {
+): Promise<PublishSurfaceInspection> {
   const pollMs = 500;
   const maxAttempts = Math.max(1, Math.ceil(maxWaitMs / pollMs));
-  let surface = await inspectPublishSurface(page);
+  let surface = await inspectPublishSurfaceState(page);
 
   for (let i = 0; i < maxAttempts; i++) {
-    if (surface.hasTitleInput || surface.hasImageInput || !surface.hasVideoSurface) {
+    if (surface.state !== 'video_surface') {
       return surface;
     }
     if (i < maxAttempts - 1) {
       await page.wait({ time: pollMs / 1_000 });
-      surface = await inspectPublishSurface(page);
+      surface = await inspectPublishSurfaceState(page);
     }
   }
 
   return surface;
 }
 
+/**
+ * Poll until the title/content editing form appears on the page.
+ * The new creator center UI only renders the editor after images are uploaded.
+ */
+async function waitForEditForm(page: IPage, maxWaitMs = 10_000): Promise<boolean> {
+  const pollMs = 1_000;
+  const maxAttempts = Math.ceil(maxWaitMs / pollMs);
+  for (let i = 0; i < maxAttempts; i++) {
+    const found: boolean = await page.evaluate(`
+      (() => {
+        const sels = ${JSON.stringify(TITLE_SELECTORS)};
+        for (const sel of sels) {
+          const el = document.querySelector(sel);
+          if (el && el.offsetParent !== null) return true;
+        }
+        return false;
+      })()`);
+    if (found) return true;
+    if (i < maxAttempts - 1) await page.wait({ time: pollMs / 1_000 });
+  }
+  return false;
+}
+
 cli({
   site: 'xiaohongshu',
   name: 'publish',
@@ -274,7 +318,7 @@ cli({
   args: [
     { name: 'title', required: true, help: '笔记标题 (最多20字)' },
     { name: 'content', required: true, positional: true, help: '笔记正文' },
-    { name: 'images', required: false, help: '图片路径，逗号分隔，最多9张 (jpg/png/gif/webp)' },
+    { name: 'images', required: true, help: '图片路径，逗号分隔，最多9张 (jpg/png/gif/webp)' },
     { name: 'topics', required: false, help: '话题标签，逗号分隔，不含 # 号' },
     { name: 'draft', type: 'bool', default: false, help: '保存为草稿，不直接发布' },
   ],
@@ -297,6 +341,8 @@ cli({
     if (title.length > MAX_TITLE_LEN)
       throw new Error(`Title is ${title.length} chars — must be ≤ ${MAX_TITLE_LEN}`);
     if (!content) throw new Error('Positional argument <content> is required');
+    if (imagePaths.length === 0)
+      throw new Error('At least one --images path is required. The creator center now requires images before showing the editor.');
     if (imagePaths.length > MAX_IMAGES)
       throw new Error(`Too many images: ${imagePaths.length} (max ${MAX_IMAGES})`);
 
@@ -318,8 +364,8 @@ cli({
 
     // ── Step 2: Select 图文 (image+text) note type if tabs are present ─────────
     const tabResult = await selectImageTextTab(page);
-    const surface = await waitForImageTextSurface(page, tabResult?.ok ? 5_000 : 2_000);
-    if (!surface.hasTitleInput && !surface.hasImageInput && surface.hasVideoSurface) {
+    const surface = await waitForPublishSurfaceState(page, tabResult?.ok ? 5_000 : 2_000);
+    if (surface.state === 'video_surface') {
       await page.screenshot({ path: '/tmp/xhs_publish_tab_debug.png' });
       const detail = tabResult?.ok
         ? `clicked "${tabResult.text}"`
@@ -331,35 +377,30 @@ cli({
     }
 
     // ── Step 3: Upload images ──────────────────────────────────────────────────
-    if (imageData.length > 0) {
-      const upload = await injectImages(page, imageData);
-      if (!upload.ok) {
-        await page.screenshot({ path: '/tmp/xhs_publish_upload_debug.png' });
-        throw new Error(
-          `Image injection failed: ${upload.error ?? 'unknown'}. ` +
-          'Debug screenshot: /tmp/xhs_publish_upload_debug.png'
-        );
-      }
-      // Allow XHS to process and upload images to its CDN
-      await page.wait({ time: UPLOAD_SETTLE_MS / 1_000 });
-      await waitForUploads(page);
+    const upload = await injectImages(page, imageData);
+    if (!upload.ok) {
+      await page.screenshot({ path: '/tmp/xhs_publish_upload_debug.png' });
+      throw new Error(
+        `Image injection failed: ${upload.error ?? 'unknown'}. ` +
+        'Debug screenshot: /tmp/xhs_publish_upload_debug.png'
+      );
+    }
+    // Allow XHS to process and upload images to its CDN
+    await page.wait({ time: UPLOAD_SETTLE_MS / 1_000 });
+    await waitForUploads(page);
+
+    // ── Step 3b: Wait for editor form to render ───────────────────────────────
+    const formReady = await waitForEditForm(page);
+    if (!formReady) {
+      await page.screenshot({ path: '/tmp/xhs_publish_form_debug.png' });
+      throw new Error(
+        'Editing form did not appear after image upload. The page layout may have changed. ' +
+        'Debug screenshot: /tmp/xhs_publish_form_debug.png'
+      );
     }
 
     // ── Step 4: Fill title ─────────────────────────────────────────────────────
-    await fillField(
-      page,
-      [
-        'input[maxlength="20"]',
-        'input[class*="title"]',
-        'input[placeholder*="标题"]',
-        'input[placeholder*="title" i]',
-        '.title-input input',
-        '.note-title input',
-        'input[maxlength]',
-      ],
-      title,
-      'title'
-    );
+    await fillField(page, TITLE_SELECTORS, title, 'title');
     await page.wait({ time: 0.5 });
 
     // ── Step 5: Fill content / body ────────────────────────────────────────────
@@ -374,7 +415,7 @@ cli({
         '.note-content [contenteditable="true"]',
         '.editor-content [contenteditable="true"]',
         // Broad fallback — last resort; filter out any title contenteditable
-        '[contenteditable="true"]:not([placeholder*="标题"]):not([placeholder*="title" i])',
+        '[contenteditable="true"]:not([placeholder*="标题"]):not([placeholder*="赞"]):not([placeholder*="title" i])',
       ],
       content,
       'content'
@@ -438,14 +479,14 @@ cli({
     }
 
     // ── Step 7: Publish or save draft ─────────────────────────────────────────
-    const actionLabel = isDraft ? '存草稿' : '发布';
+    const actionLabels = isDraft ? ['暂存离开', '存草稿'] : ['发布', '发布笔记'];
     const btnClicked: boolean = await page.evaluate(`
-      (label => {
+      (labels => {
         const buttons = document.querySelectorAll('button, [role="button"]');
         for (const btn of buttons) {
           const text = (btn.innerText || btn.textContent || '').trim();
           if (
-            (text === label || text.includes(label) || text === '发布笔记') &&
+            labels.some(l => text === l || text.includes(l)) &&
             btn.offsetParent !== null &&
             !btn.disabled
           ) {
@@ -454,13 +495,13 @@ cli({
           }
         }
         return false;
-      })(${JSON.stringify(actionLabel)})
+      })(${JSON.stringify(actionLabels)})
     `);
 
     if (!btnClicked) {
       await page.screenshot({ path: '/tmp/xhs_publish_submit_debug.png' });
       throw new Error(
-        `Could not find "${actionLabel}" button. ` +
+        `Could not find "${actionLabels[0]}" button. ` +
         'Debug screenshot: /tmp/xhs_publish_submit_debug.png'
       );
     }
@@ -475,7 +516,7 @@ cli({
           const text = (el.innerText || '').trim();
           if (
             el.children.length === 0 &&
-            (text.includes('发布成功') || text.includes('草稿已保存') || text.includes('上传成功'))
+            (text.includes('发布成功') || text.includes('草稿已保存') || text.includes('暂存成功') || text.includes('上传成功'))
           ) return text;
         }
         return '';
@@ -484,14 +525,14 @@ cli({
 
     const navigatedAway = !finalUrl.includes('/publish/publish');
     const isSuccess = successMsg.length > 0 || navigatedAway;
-    const verb = isDraft ? '草稿已保存' : '发布成功';
+    const verb = isDraft ? '暂存成功' : '发布成功';
 
     return [
       {
         status: isSuccess ? `✅ ${verb}` : '⚠️ 操作完成，请在浏览器中确认',
         detail: [
           `"${title}"`,
-          imageData.length ? `${imageData.length}张图片` : '无图',
+          `${imageData.length}张图片`,
           topics.length ? `话题: ${topics.join(' ')}` : '',
           successMsg || finalUrl || '',
         ]

package/src/clis/xiaohongshu/search.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, it, vi } from 'vitest';
 import type { IPage } from '../../types.js';
 import { getRegistry } from '../../registry.js';
-import './search.js';
+import { noteIdToDate } from './search.js';
 
 function createPageMock(evaluateResults: any[]): IPage {
   const evaluate = vi.fn();
@@ -86,6 +86,7 @@ describe('xiaohongshu search', () => {
         title: '某鱼买FSD被坑了4万',
         author: '随风',
         likes: '261',
+        published_at: '2025-10-10',
         url: detailUrl,
         author_url: authorUrl,
       },
@@ -132,3 +133,40 @@ describe('xiaohongshu search', () => {
     expect(result[0]).toMatchObject({ rank: 1, title: 'Result A' });
   });
 });
+
+describe('noteIdToDate (ObjectID timestamp parsing)', () => {
+  it('parses a known note ID to the correct China-timezone date', () => {
+    // 0x697f6c74 = 1769958516 → 2026-02-01 in UTC+8
+    expect(noteIdToDate('https://www.xiaohongshu.com/search_result/697f6c74000000002103de17')).toBe('2026-02-01');
+    // 0x68e90be8 → 2025-10-10 in UTC+8
+    expect(noteIdToDate('https://www.xiaohongshu.com/explore/68e90be80000000004022e66')).toBe('2025-10-10');
+  });
+
+  it('returns China date when UTC+8 crosses into the next day', () => {
+    // 0x69b739f0 = 2026-03-15 23:00 UTC = 2026-03-16 07:00 CST
+    // Without UTC+8 offset this would incorrectly return 2026-03-15
+    expect(noteIdToDate('https://www.xiaohongshu.com/search_result/69b739f00000000000000000')).toBe('2026-03-16');
+  });
+
+  it('handles /note/ path variant', () => {
+    expect(noteIdToDate('https://www.xiaohongshu.com/note/697f6c74000000002103de17')).toBe('2026-02-01');
+  });
+
+  it('handles URL with query parameters', () => {
+    expect(noteIdToDate('https://www.xiaohongshu.com/search_result/697f6c74000000002103de17?xsec_token=abc')).toBe('2026-02-01');
+  });
+
+  it('returns empty string for non-matching URLs', () => {
+    expect(noteIdToDate('https://www.xiaohongshu.com/user/profile/635a9c720000000018028b40')).toBe('');
+    expect(noteIdToDate('https://www.xiaohongshu.com/')).toBe('');
+  });
+
+  it('returns empty string for IDs shorter than 24 hex chars', () => {
+    expect(noteIdToDate('https://www.xiaohongshu.com/search_result/abcdef')).toBe('');
+  });
+
+  it('returns empty string when timestamp is out of range', () => {
+    // All zeros → ts = 0
+    expect(noteIdToDate('https://www.xiaohongshu.com/search_result/000000000000000000000000')).toBe('');
+  });
+});

package/src/clis/xiaohongshu/search.ts

@@ -9,6 +9,23 @@
 import { cli, Strategy } from '../../registry.js';
 import { AuthRequiredError } from '../../errors.js';
 
+/**
+ * Extract approximate publish date from a Xiaohongshu note URL.
+ * XHS note IDs follow MongoDB ObjectID format where the first 8 hex
+ * characters encode a Unix timestamp (the moment the ID was generated,
+ * which closely matches publish time but is not an official API field).
+ * e.g. "697f6c74..." → 0x697f6c74 = 1769958516 → 2026-02-01
+ */
+export function noteIdToDate(url: string): string {
+  const match = url.match(/\/(?:search_result|explore|note)\/([0-9a-f]{24})(?=[?#/]|$)/i);
+  if (!match) return '';
+  const hex = match[1].substring(0, 8);
+  const ts = parseInt(hex, 16);
+  if (!ts || ts < 1_000_000_000 || ts > 4_000_000_000) return '';
+  // Offset by UTC+8 (China Standard Time) so the date matches what XHS users see
+  return new Date((ts + 8 * 3600) * 1000).toISOString().slice(0, 10);
+}
+
 cli({
   site: 'xiaohongshu',
   name: 'search',
@@ -19,7 +36,7 @@ cli({
     { name: 'query', required: true, positional: true, help: 'Search keyword' },
     { name: 'limit', type: 'int', default: 20, help: 'Number of results' },
   ],
-  columns: ['rank', 'title', 'author', 'likes', 'url'],
+  columns: ['rank', 'title', 'author', 'likes', 'published_at', 'url'],
   func: async (page, kwargs) => {
     const keyword = encodeURIComponent(kwargs.query);
     await page.goto(
@@ -97,6 +114,7 @@ cli({
       .map((item: any, i: number) => ({
         rank: i + 1,
         ...item,
+        published_at: noteIdToDate(item.url),
       }));
   },
 });

package/src/daemon.ts

@@ -198,6 +198,7 @@ const wss = new WebSocketServer({
 wss.on('connection', (ws: WebSocket) => {
   console.error('[daemon] Extension connected');
   extensionWs = ws;
+  extensionVersion = null; // cleared until hello message arrives
 
   // ── Heartbeat: ping every 15s, close if 2 pongs missed ──
   let missedPongs = 0;

package/src/discovery.ts

@@ -127,24 +127,20 @@ async function discoverClisFromFs(dir: string): Promise<void> {
       const site = entry.name;
       const siteDir = path.join(dir, site);
       const files = await fs.promises.readdir(siteDir);
-      const filePromises: Promise<unknown>[] = [];
-      for (const file of files) {
+      await Promise.all(files.map(async (file) => {
         const filePath = path.join(siteDir, file);
         if (file.endsWith('.yaml') || file.endsWith('.yml')) {
-          filePromises.push(registerYamlCli(filePath, site));
+          await registerYamlCli(filePath, site);
         } else if (
           (file.endsWith('.js') && !file.endsWith('.d.js')) ||
           (file.endsWith('.ts') && !file.endsWith('.d.ts') && !file.endsWith('.test.ts'))
         ) {
-          if (!(await isCliModule(filePath))) continue;
-          filePromises.push(
-            import(pathToFileURL(filePath).href).catch((err) => {
-              log.warn(`Failed to load module ${filePath}: ${getErrorMessage(err)}`);
-            })
-          );
+          if (!(await isCliModule(filePath))) return;
+          await import(pathToFileURL(filePath).href).catch((err) => {
+            log.warn(`Failed to load module ${filePath}: ${getErrorMessage(err)}`);
+          });
         }
-      }
-      await Promise.all(filePromises);
+      }));
     });
   await Promise.all(sitePromises);
 }
@@ -195,10 +191,11 @@ async function registerYamlCli(filePath: string, defaultSite: string): Promise<v
 export async function discoverPlugins(): Promise<void> {
   try { await fs.promises.access(PLUGINS_DIR); } catch { return; }
   const entries = await fs.promises.readdir(PLUGINS_DIR, { withFileTypes: true });
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    await discoverPluginDir(path.join(PLUGINS_DIR, entry.name), entry.name);
-  }
+  await Promise.all(entries.map(async (entry) => {
+    const pluginDir = path.join(PLUGINS_DIR, entry.name);
+    if (!(await isDiscoverablePluginDir(entry, pluginDir))) return;
+    await discoverPluginDir(pluginDir, entry.name);
+  }));
 }
 
 /**
@@ -208,33 +205,29 @@ export async function discoverPlugins(): Promise<void> {
 async function discoverPluginDir(dir: string, site: string): Promise<void> {
   const files = await fs.promises.readdir(dir);
   const fileSet = new Set(files);
-  const promises: Promise<unknown>[] = [];
-  for (const file of files) {
+  await Promise.all(files.map(async (file) => {
     const filePath = path.join(dir, file);
     if (file.endsWith('.yaml') || file.endsWith('.yml')) {
-      promises.push(registerYamlCli(filePath, site));
+      await registerYamlCli(filePath, site);
     } else if (file.endsWith('.js') && !file.endsWith('.d.js')) {
-      if (!(await isCliModule(filePath))) continue;
-      promises.push(
-        import(pathToFileURL(filePath).href).catch((err) => {
-          log.warn(`Plugin ${site}/${file}: ${getErrorMessage(err)}`);
-        })
-      );
+      if (!(await isCliModule(filePath))) return;
+      await import(pathToFileURL(filePath).href).catch((err) => {
+        log.warn(`Plugin ${site}/${file}: ${getErrorMessage(err)}`);
+      });
     } else if (
       file.endsWith('.ts') && !file.endsWith('.d.ts') && !file.endsWith('.test.ts')
     ) {
-      // Skip .ts if a compiled .js sibling exists (production mode can't load .ts)
       const jsFile = file.replace(/\.ts$/, '.js');
-      if (fileSet.has(jsFile)) continue;
-      if (!(await isCliModule(filePath))) continue;
-      promises.push(
-        import(pathToFileURL(filePath).href).catch((err) => {
-          log.warn(`Plugin ${site}/${file}: ${getErrorMessage(err)}`);
-        })
+      // Prefer compiled .js — skip the .ts source file
+      if (fileSet.has(jsFile)) return;
+      // No compiled .js found — cannot import raw .ts in production Node.js.
+      // This typically means esbuild transpilation failed during plugin install.
+      log.warn(
+        `Plugin ${site}/${file}: no compiled .js found. ` +
+        `Run "opencli plugin update ${site}" to re-transpile, or install esbuild.`
       );
     }
-  }
-  await Promise.all(promises);
+  }));
 }
 
 async function isCliModule(filePath: string): Promise<boolean> {
@@ -246,3 +239,18 @@ async function isCliModule(filePath: string): Promise<boolean> {
     return false;
   }
 }
+
+async function isDiscoverablePluginDir(entry: fs.Dirent, pluginDir: string): Promise<boolean> {
+  if (entry.isDirectory()) return true;
+  if (!entry.isSymbolicLink()) return false;
+
+  try {
+    return (await fs.promises.stat(pluginDir)).isDirectory();
+  } catch (err) {
+    const code = (err as NodeJS.ErrnoException).code;
+    if (code !== 'ENOENT' && code !== 'ENOTDIR') {
+      log.warn(`Failed to inspect plugin link ${pluginDir}: ${getErrorMessage(err)}`);
+    }
+    return false;
+  }
+}

package/src/doctor.ts

@@ -1,5 +1,5 @@
 /**
- * opencli doctor — diagnose and fix browser connectivity.
+ * opencli doctor — diagnose browser connectivity.
  *
  * Simplified for the daemon-based architecture. No more token management,
  * MCP path discovery, or config file scanning.
@@ -14,7 +14,6 @@ import { getErrorMessage } from './errors.js';
 import { getRuntimeLabel } from './runtime-detect.js';
 
 export type DoctorOptions = {
-  fix?: boolean;
   yes?: boolean;
   live?: boolean;
   sessions?: boolean;
@@ -87,7 +86,7 @@ export async function runBrowserDoctor(opts: DoctorOptions = {}): Promise<Doctor
     issues.push(
       'Daemon is running but the Chrome extension is not connected.\n' +
       'Please install the opencli Browser Bridge extension:\n' +
-      '  1. Download from GitHub Releases\n' +
+      '  1. Download from https://github.com/jackwener/opencli/releases\n' +
       '  2. Open chrome://extensions/ → Enable Developer Mode\n' +
       '  3. Click "Load unpacked" → select the extension folder',
     );
@@ -96,11 +95,15 @@ export async function runBrowserDoctor(opts: DoctorOptions = {}): Promise<Doctor
     issues.push(`Browser connectivity test failed: ${connectivity.error ?? 'unknown'}`);
   }
 
-  if (status.extensionVersion && opts.cliVersion && status.extensionVersion !== opts.cliVersion) {
-    issues.push(
-      `Extension version mismatch: extension v${status.extensionVersion} ≠ CLI v${opts.cliVersion}\n` +
-      '  Download the latest extension from: https://github.com/jackwener/opencli/releases',
-    );
+  if (status.extensionVersion && opts.cliVersion) {
+    const extMajor = status.extensionVersion.split('.')[0];
+    const cliMajor = opts.cliVersion.split('.')[0];
+    if (extMajor !== cliMajor) {
+      issues.push(
+        `Extension major version mismatch: extension v${status.extensionVersion} ≠ CLI v${opts.cliVersion}\n` +
+        '  Download the latest extension from: https://github.com/jackwener/opencli/releases',
+      );
+    }
   }
 
   return {