@zenalexa/unicli 0.218.1 → 0.220.0

package/dist/transport/refs.d.ts

@@ -1,7 +1,9 @@
 /**
- * Element-ref allocator. Each snapshot gets short monotonic aliases (`@e1`)
- * backed by stable transport tokens so later actions can dereference either
- * form without reparsing encoded text.
+ * @owner   src/transport/refs.ts
+ * @does    Allocate, persist, and reload stable desktop element references across CLI processes.
+ * @needs   filesystem, process env, home directory
+ * @feeds   desktop transports and compute commands
+ * @breaks  Lost or invalid refs prevent follow-up desktop actions from targeting prior snapshots.
  */
 export interface ElementRef {
     alias: string;

package/dist/transport/refs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/transport/refs.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAYD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAE1D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,UAAU;IAUnD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;CASpD;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IAEvD,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAI5B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQ9C,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQrD,IAAI,IAAI,UAAU,EAAE;IAMpB,OAAO,IAAI,SAAS,EAAE;IAUtB,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,GAAG;CAGZ;AAED,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,SAAoB,GAAG,IAAI,CAY5E;AAED,wBAAgB,YAAY,CAAC,IAAI,SAAoB,GAAG,QAAQ,CAyB/D"}
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/transport/refs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAYD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAE1D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,UAAU;IAUnD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;CASpD;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IAEvD,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAI5B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQ9C,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAQrD,IAAI,IAAI,UAAU,EAAE;IAMpB,OAAO,IAAI,SAAS,EAAE;IAUtB,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,GAAG;CAGZ;AAED,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,SAAoB,GAAG,IAAI,CAY5E;AAED,wBAAgB,YAAY,CAAC,IAAI,SAAoB,GAAG,QAAQ,CAyB/D"}

package/dist/transport/refs.js

@@ -1,3 +1,10 @@
+/**
+ * @owner   src/transport/refs.ts
+ * @does    Allocate, persist, and reload stable desktop element references across CLI processes.
+ * @needs   filesystem, process env, home directory
+ * @feeds   desktop transports and compute commands
+ * @breaks  Lost or invalid refs prevent follow-up desktop actions from targeting prior snapshots.
+ */
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { homedir } from "node:os";
@@ -69,7 +76,7 @@ export class RefStore {
 }
 export function computeRefsPath() {
     return (process.env.UNICLI_COMPUTE_REFS_PATH ??
-        join(homedir(), ".unicli", "compute", "refs.json"));
+        join(homedir(), ".unicli", "compute", "refs.json").replaceAll("\\", "/"));
 }
 export function saveRefStore(store, file = computeRefsPath()) {
     const payload = {

package/dist/transport/refs.js.map

@@ -1 +1 @@
-{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../src/transport/refs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../src/transport/refs.ts"],"names":[],"mappings":"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"}

package/dist/transport/sidecar-binary.d.ts

@@ -1,3 +1,10 @@
+/**
+ * @owner   src/transport/sidecar-binary.ts
+ * @does    Resolve native desktop sidecar executables from env, optional packages, user installs, or PATH.
+ * @needs   host platform, arch, env, package resolver, filesystem probe
+ * @feeds   desktop UIA and AT-SPI transports, compute doctor
+ * @breaks  Wrong platform path resolution prevents native desktop automation startup.
+ */
 export type SidecarName = "unicli-uia" | "unicli-atspi";
 export interface ResolvedSidecarBinary {
     command: string;

package/dist/transport/sidecar-binary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidecar-binary.d.ts","sourceRoot":"","sources":["../../src/transport/sidecar-binary.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,cAAc,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE,qBAA0B,GAC/B,qBAAqB,CAsCvB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAUpB"}
+{"version":3,"file":"sidecar-binary.d.ts","sourceRoot":"","sources":["../../src/transport/sidecar-binary.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,cAAc,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE,qBAA0B,GAC/B,qBAAqB,CAyCvB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAUpB"}

package/dist/transport/sidecar-binary.js

@@ -1,6 +1,13 @@
+/**
+ * @owner   src/transport/sidecar-binary.ts
+ * @does    Resolve native desktop sidecar executables from env, optional packages, user installs, or PATH.
+ * @needs   host platform, arch, env, package resolver, filesystem probe
+ * @feeds   desktop UIA and AT-SPI transports, compute doctor
+ * @breaks  Wrong platform path resolution prevents native desktop automation startup.
+ */
 import { existsSync } from "node:fs";
 import { homedir } from "node:os";
-import { dirname, join } from "node:path";
+import { posix, win32 } from "node:path";
 import { createRequire } from "node:module";
 const require = createRequire(import.meta.url);
 export function resolveSidecarBinary(name, opts = {}) {
@@ -15,16 +22,12 @@ export function resolveSidecarBinary(name, opts = {}) {
         return { command: override, source: "env", packageName };
     }
     if (packageName) {
-        try {
-            const pkgJson = requireResolve(`${packageName}/package.json`);
-            const command = join(dirname(pkgJson), executableName(name, platform));
+        const command = resolvePackageCommand(name, platform, packageName, requireResolve);
+        if (command) {
             return { command, source: "package", packageName };
         }
-        catch {
-            // Optional platform packages are absent on non-matching hosts.
-        }
     }
-    const userCommand = join(opts.homeDir ?? homedir(), ".unicli", "sidecars", executableName(name, platform));
+    const userCommand = joinPathForPlatform(platform, opts.homeDir ?? homedir(), ".unicli", "sidecars", executableName(name, platform));
     if (exists(userCommand)) {
         return { command: userCommand, source: "user", packageName };
     }
@@ -52,4 +55,21 @@ function envVarForSidecar(name) {
 function executableName(name, platform) {
     return platform === "win32" ? `${name}.exe` : name;
 }
+function resolvePackageCommand(name, platform, packageName, requireResolve) {
+    try {
+        const pkgJson = requireResolve(`${packageName}/package.json`);
+        return joinPathForPlatform(platform, dirnameForPlatform(platform, pkgJson), executableName(name, platform));
+    }
+    catch {
+        return undefined;
+    }
+}
+function dirnameForPlatform(platform, value) {
+    return platform === "win32" ? win32.dirname(value) : posix.dirname(value);
+}
+function joinPathForPlatform(platform, ...segments) {
+    return platform === "win32"
+        ? win32.join(...segments)
+        : posix.join(...segments);
+}
 //# sourceMappingURL=sidecar-binary.js.map

package/dist/transport/sidecar-binary.js.map

@@ -1 +1 @@
-{"version":3,"file":"sidecar-binary.js","sourceRoot":"","sources":["../../src/transport/sidecar-binary.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sidecar-binary.js","sourceRoot":"","sources":["../../src/transport/sidecar-binary.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@zenalexa/unicli",
-  "version": "0.218.1",
-  "description": "Agent execution substrate for web, apps, local tools, and system capabilities. Self-repairing CLI catalog for 237+ websites and apps. Stdio + Streamable HTTP MCP server.",
+  "version": "0.220.0",
+  "description": "Agent execution substrate for web, apps, local tools, and system capabilities. Self-repairing CLI catalog for 268 websites and apps. Stdio + Streamable HTTP MCP server.",
+  "packageManager": "npm@11.14.0",
   "type": "module",
   "main": "dist/main.js",
   "bin": {
     "unicli": "dist/main.js",
-    "unicli-mcp": "dist/bin/unicli-mcp.js"
+    "unicli-mcp": "bin/unicli-mcp"
   },
   "files": [
+    "bin/",
     "dist/",
     "crates/",
     "docs/operate/",
@@ -137,8 +139,8 @@
   },
   "scripts": {
     "dev": "tsx src/main.ts",
-    "build": "tsc && tsx scripts/build-manifest.js && tsx scripts/count-stats.ts && tsx scripts/build-readme.ts && tsx scripts/build-agents.ts && prettier --write AGENTS.md",
-    "postbuild": "node -e \"const fs=require('fs'); fs.chmodSync('dist/main.js', 0o755); fs.chmodSync('dist/bin/unicli-mcp.js', 0o755);\"",
+    "build": "npm run clean && tsc && tsx scripts/build-manifest.js && tsx scripts/count-stats.ts && tsx scripts/build-readme.ts && tsx scripts/build-agents.ts && prettier --write AGENTS.md",
+    "postbuild": "node -e \"const fs=require('fs'); fs.chmodSync('dist/main.js', 0o755); fs.chmodSync('dist/bin/unicli-mcp.js', 0o755); fs.chmodSync('bin/unicli-mcp', 0o755);\"",
     "stats": "tsx scripts/build-manifest.js && tsx scripts/count-stats.ts && tsx scripts/build-readme.ts && tsx scripts/build-agents.ts",
     "stats:check": "tsx scripts/count-consistency.ts",
     "build:agents": "tsx scripts/build-agents.ts",
@@ -187,7 +189,7 @@
     "postversion": "npm run build && tsx scripts/release.ts",
     "bench": "tsx bench/report.ts",
     "bench:self-discovery": "tsx bench/self-discovery.ts",
-    "bench:opencli-parity": "tsx bench/opencli-parity.ts",
+    "bench:surface-coverage": "tsx bench/surface-coverage.ts",
     "bench:quick": "tsx bench/agent/report.ts",
     "bench:agent": "tsx bench/agent/sdk-runner.ts",
     "bench:gate": "node scripts/bench/check-ship-gate.js",

package/server.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "io.github.olo-dot-io/Uni-CLI",
-  "description": "Self-repairing CLI catalog that exposes 237+ websites, desktop apps, and external CLIs as one MCP server. 920 declarative YAML adapters; structured error envelopes let agents fix failing adapters at runtime and retry.",
-  "version": "0.218.1",
+  "description": "Self-repairing CLI catalog that exposes 268 websites, desktop apps, and external CLIs as one MCP server. 925 declarative YAML adapters; structured error envelopes let agents fix failing adapters at runtime and retry.",
+  "version": "0.220.0",
   "repository": {
     "url": "https://github.com/olo-dot-io/Uni-CLI",
     "source": "github"
@@ -13,7 +13,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@zenalexa/unicli",
-      "version": "0.218.1",
+      "version": "0.220.0",
       "transport": {
         "type": "stdio"
       },

package/skills/unicli/SKILL.md

@@ -11,7 +11,7 @@ description: >
   major platform; run desktop workflows or system tasks; or when the user says
   "unicli", "scrape", "fetch from", "get trending", "check [site]", "find on
   [platform]", "获取", "查询", "抓取".
-version: 0.218.0
+version: 0.220.0
 category: core
 depends-on:
   - talk-normal

package/skills/unicli-claude-code/SKILL.md

@@ -6,7 +6,7 @@ description: >
   newlines, or inline JSON — shell-quoted invocations hit TC0 circuit
   limits and drop to <50% success above ICS=4. Also covers --describe
   introspection and next_actions-driven navigation.
-version: 0.218.0
+version: 0.220.0
 depends-on:
   - talk-normal
 triggers:

package/skills/unicli-hermes/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Use Uni-CLI to interact with 237 websites, desktop apps, and system tools.
   Trigger when: user asks to check a website, fetch data, control a desktop app,
   or interact with social media, news, finance, or AI platforms.
-version: 0.218.1
+version: 0.220.0
 depends-on:
   - talk-normal
 triggers:

package/src/adapters/1point3acres/forum.test.ts

@@ -0,0 +1,300 @@
+import { describe, expect, it, vi } from "vitest";
+import { resolveCommand } from "../../registry.js";
+import {
+  ONEPOINT_BASE,
+  ONEPOINT_FORUMS_COLUMNS,
+  ONEPOINT_FORUM_COLUMNS,
+  ONEPOINT_LATEST_COLUMNS,
+  ONEPOINT_NOTIFICATION_COLUMNS,
+  ONEPOINT_SEARCH_COLUMNS,
+  ONEPOINT_THREAD_COLUMNS,
+  ONEPOINT_THREAD_LIST_COLUMNS,
+  ONEPOINT_USER_COLUMNS,
+  decodeOnePointEntities,
+  normalizeOnePointLimit,
+  normalizeOnePointPositiveInteger,
+  parseOnePointSearchList,
+  parseOnePointThreadList,
+} from "./forum.js";
+
+function htmlResponse(html: string): Response {
+  return new Response(html, {
+    status: 200,
+    headers: { "content-type": "text/html; charset=utf-8" },
+  });
+}
+
+function stubFetch(html: string) {
+  const fetchMock = vi
+    .fn()
+    .mockImplementation(() => Promise.resolve(htmlResponse(html)));
+  vi.stubGlobal("fetch", fetchMock);
+  return fetchMock;
+}
+
+function pageMock() {
+  return {
+    cookies: vi.fn().mockResolvedValue({ sid: "secret" }),
+  };
+}
+
+function threadListHtml() {
+  return `
+    <tbody id="normalthread_100">
+      <tr>
+        <th><a href="forum-145-1.html" target="_blank">Interview</a><a class="xst">Senior Engineer OA</a></th>
+        <td class="by"><cite><a class="xi2">Ada</a></cite><em><span title="2026-05-12 10:00"></span></em></td>
+        <td class="num"><a class="xi2">3</a><em>99</em></td>
+        <td class="by"><cite><a>Ben</a></cite><em><span title="2026-05-12 11:00"></span></em></td>
+      </tr>
+    </tbody>
+  `;
+}
+
+describe("1point3acres agent-facing commands", () => {
+  it("registers all surface 1point3acres commands with expected columns", () => {
+    const expected = [
+      ["digest", ONEPOINT_THREAD_LIST_COLUMNS, false],
+      ["forum", ONEPOINT_FORUM_COLUMNS, false],
+      ["forums", ONEPOINT_FORUMS_COLUMNS, false],
+      ["hot", ONEPOINT_THREAD_LIST_COLUMNS, false],
+      ["latest", ONEPOINT_LATEST_COLUMNS, false],
+      ["notifications", ONEPOINT_NOTIFICATION_COLUMNS, true],
+      ["search", ONEPOINT_SEARCH_COLUMNS, true],
+      ["thread", ONEPOINT_THREAD_COLUMNS, false],
+      ["user", ONEPOINT_USER_COLUMNS, false],
+    ];
+    for (const [name, columns, browser] of expected) {
+      const command = resolveCommand("1point3acres", String(name))?.command;
+      expect(command?.columns).toEqual(columns);
+      expect(command?.browser).toBe(browser);
+    }
+  });
+
+  it("validates integers and decodes common entities without silent clamps", () => {
+    expect(normalizeOnePointPositiveInteger("2", 1, "page")).toBe(2);
+    expect(normalizeOnePointLimit(undefined, 20, 50)).toBe(20);
+    expect(decodeOnePointEntities("A&amp;B&#33;")).toBe("A&B!");
+    expect(() => normalizeOnePointPositiveInteger(0, 1, "page")).toThrow(
+      "positive integer",
+    );
+    expect(() => normalizeOnePointLimit(51, 20, 50)).toThrow("<= 50");
+  });
+
+  it("parses thread-list HTML and runs hot/latest/digest/forum commands", async () => {
+    expect(parseOnePointThreadList(threadListHtml())).toEqual([
+      expect.objectContaining({
+        tid: "100",
+        title: "Senior Engineer OA",
+        forum: "Interview",
+        author: "Ada",
+        replies: 3,
+        views: 99,
+        lastReplyTime: "2026-05-12 11:00",
+      }),
+    ]);
+    const fetchMock = stubFetch(threadListHtml());
+    try {
+      const hot = resolveCommand("1point3acres", "hot")?.command;
+      const latest = resolveCommand("1point3acres", "latest")?.command;
+      const digest = resolveCommand("1point3acres", "digest")?.command;
+      const forum = resolveCommand("1point3acres", "forum")?.command;
+      await expect(hot!.func!({} as never, { limit: 1 })).resolves.toEqual([
+        expect.objectContaining({ rank: 1, tid: "100" }),
+      ]);
+      await expect(latest!.func!({} as never, { limit: 1 })).resolves.toEqual([
+        expect.objectContaining({ rank: 1, postTime: "2026-05-12 10:00" }),
+      ]);
+      await expect(digest!.func!({} as never, { limit: 1 })).resolves.toEqual([
+        expect.objectContaining({ rank: 1, tid: "100" }),
+      ]);
+      await expect(
+        forum!.func!({} as never, { fid: "145", page: 2, limit: 1 }),
+      ).resolves.toEqual([
+        expect.objectContaining({ rank: 1, kind: "normal", tid: "100" }),
+      ]);
+      expect(fetchMock.mock.calls[3][0]).toBe(
+        `${ONEPOINT_BASE}/forum-145-2.html`,
+      );
+      await expect(forum!.func!({} as never, { fid: "abc" })).rejects.toThrow(
+        "numeric forum id",
+      );
+    } finally {
+      vi.unstubAllGlobals();
+    }
+  });
+
+  it("lists forum ids and filters names", async () => {
+    const fetchMock = stubFetch(`
+      <a href="forum-145-1.html" class="foo overflow-hidden bar">Interview</a>
+      <a href="forum-198-1.html" class="foo overflow-hidden bar">Jobs</a>
+      <a href="forum-145-1.html" class="foo overflow-hidden bar">Interview</a>
+    `);
+    try {
+      const forums = resolveCommand("1point3acres", "forums")?.command;
+      await expect(
+        forums!.func!({} as never, { filter: "job" }),
+      ).resolves.toEqual([
+        {
+          fid: "198",
+          name: "Jobs",
+          url: `${ONEPOINT_BASE}/forum-198-1.html`,
+        },
+      ]);
+      expect(fetchMock).toHaveBeenCalledTimes(1);
+      const [url, options] = fetchMock.mock.calls[0];
+      expect(url).toBe(`${ONEPOINT_BASE}/forum.php`);
+      expect(options).toEqual({
+        headers: {
+          Accept: "text/html,application/xhtml+xml",
+          "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
+          "User-Agent":
+            "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0 Safari/537.36",
+        },
+        redirect: "follow",
+      });
+    } finally {
+      vi.unstubAllGlobals();
+    }
+  });
+
+  it("searches with browser cookies and parses Discuz search results", async () => {
+    const searchHtml = `
+      <li class="pbw" id="200">
+        <h3><a href="forum.php?mod=viewthread&tid=200">Search Hit</a></h3>
+        <p class="xg1">5 个回复 - 1,234 次查看</p>
+        <p><span>2026-05-12</span><a href="space-uid-42.html">Ada</a><a href="forum-145-1.html">Interview</a></p>
+      </li>
+    `;
+    expect(parseOnePointSearchList(searchHtml)).toEqual([
+      expect.objectContaining({
+        tid: "200",
+        title: "Search Hit",
+        replies: 5,
+        views: 1234,
+      }),
+    ]);
+    const fetchMock = stubFetch(searchHtml);
+    try {
+      const search = resolveCommand("1point3acres", "search")?.command;
+      await expect(
+        search!.func!(pageMock() as never, {
+          query: "visa",
+          fid: "145",
+          limit: 1,
+        }),
+      ).resolves.toEqual([
+        {
+          rank: 1,
+          tid: "200",
+          title: "Search Hit",
+          forum: "Interview",
+          author: "Ada",
+          replies: 5,
+          views: 1234,
+          postTime: "2026-05-12",
+          url: `${ONEPOINT_BASE}/thread-200-1-1.html`,
+        },
+      ]);
+      expect(fetchMock.mock.calls[0][0]).toContain("srchtxt=visa");
+      expect(fetchMock.mock.calls[0][1].headers.Cookie).toBe("sid=secret");
+      await expect(
+        search!.func!(pageMock() as never, { query: " " }),
+      ).rejects.toThrow("query cannot be empty");
+    } finally {
+      vi.unstubAllGlobals();
+    }
+  });
+
+  it("reads thread floors and prefixes the main post with the thread title", async () => {
+    stubFetch(`
+      <div id="postlist">
+        <span id="thread_subject">Thread Title</span>
+        <div id="post_300">
+          <div class="authi"><a class="xi2">Ada</a><span title="2026-05-12 12:00"></span></div>
+          <td id="postmessage_300">Hello<br>World</td>
+        </div>
+      </div>
+    `);
+    try {
+      const thread = resolveCommand("1point3acres", "thread")?.command;
+      await expect(
+        thread!.func!({} as never, {
+          tid: "200",
+          page: 1,
+          limit: 1,
+          contentLimit: 50,
+        }),
+      ).resolves.toEqual([
+        {
+          floor: 1,
+          pid: "300",
+          author: "Ada",
+          postTime: "2026-05-12 12:00",
+          content: "[Thread Title]\nHello\nWorld",
+          url: `${ONEPOINT_BASE}/forum.php?mod=redirect&goto=findpost&ptid=200&pid=300`,
+        },
+      ]);
+    } finally {
+      vi.unstubAllGlobals();
+    }
+  });
+
+  it("reads user profiles and notifications", async () => {
+    const user = resolveCommand("1point3acres", "user")?.command;
+    stubFetch(`
+      <title>Ada的个人资料</title>
+      <p class="mtm"><a href="space-uid-42.html">Ada</a></p>
+      <a href="home.php?mod=space&uid=42">uid</a>
+      <li>用户组: Member</li><li>积分: 100</li><li>大米: 88</li>
+      <li>帖子数: 12</li><li>主题数: 3</li><li>精华数: 1</li>
+      <li>注册时间: 2024-01-01</li><li>最后访问: 2026-05-12</li>
+    `);
+    try {
+      await expect(user!.func!({} as never, { who: "42" })).resolves.toEqual([
+        {
+          uid: "42",
+          username: "Ada",
+          group: "Member",
+          credits: "100",
+          rice: "88",
+          posts: "12",
+          threads: "3",
+          digests: "1",
+          registerTime: "2024-01-01",
+          lastAccess: "2026-05-12",
+          profileUrl: `${ONEPOINT_BASE}/space-uid-42.html`,
+        },
+      ]);
+    } finally {
+      vi.unstubAllGlobals();
+    }
+
+    const notifications = resolveCommand(
+      "1point3acres",
+      "notifications",
+    )?.command;
+    stubFetch(`
+      <dl class="cl">
+        <dt><a>Ben</a></dt>
+        <dd class="ntc_body">Replied to <a href="thread-200-1-1.html">your post</a></dd>
+        <dd class="xg1">now</dd>
+      </dl>
+    `);
+    try {
+      await expect(
+        notifications!.func!(pageMock() as never, { kind: "mypost", limit: 1 }),
+      ).resolves.toEqual([
+        {
+          index: 1,
+          from: "Ben",
+          summary: "Replied to your post",
+          time: "now",
+          threadUrl: `${ONEPOINT_BASE}/thread-200-1-1.html`,
+        },
+      ]);
+    } finally {
+      vi.unstubAllGlobals();
+    }
+  });
+});