@nextclaw/x-harness 0.2.40 → 0.2.42

package/SOURCE.md

@@ -1,8 +1,8 @@
 # Corresponding source
 
-Version 0.2.40, commit 26581c241d56f52365a0e1e903cb0e0122c6988d.
+Version 0.2.42, commit 56272553b4ce936e466e3139f56f1adbde4a353c.
 
-Complete source, build scripts and dependencies: https://github.com/Peiiii/x-harness/tree/26581c241d56f52365a0e1e903cb0e0122c6988d
+Complete source, build scripts and dependencies: https://github.com/Peiiii/x-harness/tree/56272553b4ce936e466e3139f56f1adbde4a353c
 
 Clone this revision, run npm ci, npm run bootstrap and npm run release:build.
 

package/dist/browser-dom-capabilities.js

@@ -126,6 +126,14 @@ export class DOMCapabilities {
                 "first",
                 "waitFor",
             ]));
+        if (operation === "readBookmarks" &&
+            typeof this.#tab?.playwright?.locator === "function")
+            base.push(...missingMethods(this.#tab.playwright.locator("div"), [
+                "locator",
+                "filter",
+                "first",
+                "waitFor",
+            ]));
         if (operation !== "readFeedback") {
             base.push(...missingMethods(this.#tab?.playwright, [
                 "getByRole",

package/dist/browser-dom-navigation.js

@@ -64,6 +64,22 @@ export class DOMNavigation {
         return;
     }
     async handleWaitForFolder(command) {
+        if (command.folderDiscovery) {
+            // "All bookmarks" renders before the asynchronously loaded named cards.
+            // Wait for any named card inside that specific menu, never an unrelated
+            // dialog or arbitrary first clickable control.
+            const menu = this.#tab.playwright
+                .locator('[role="dialog"],[data-testid="Dropdown"]')
+                .filter({ hasText: command.folder });
+            await menu
+                .locator("span:not(:has(span))", {})
+                .filter({
+                hasText: /^(?!书签$|Bookmarks$|所有书签$|All bookmarks$).+$/i,
+            })
+                .first()
+                .waitFor({ state: "visible", timeoutMs: 2000 });
+            return;
+        }
         await this.#tab.playwright
             .getByText(command.folder, { exact: true })
             .waitFor({ state: "visible", timeoutMs: 2000 });

package/dist/draft-schedule.d.ts

@@ -1,7 +1,9 @@
 export declare class DraftSchedule {
     resolve(action: any): {
         at?: string;
+        until?: string;
         invalid?: boolean;
+        invalidAfter?: boolean;
     };
     reason(action: any, now: number): string | null;
 }

package/dist/draft-schedule.js

@@ -12,20 +12,36 @@ export class DraftSchedule {
             action.notBefore,
             ...Array.from(metadata.matchAll(/^(?:notBefore\s*:\s*|最早发布窗口[：:]\s*)([^\n;；]+)/gm), (m) => m[1].trim().replace(/^['"]|['"]$/g, "")),
         ].filter((v) => v !== undefined && v !== null);
+        const endings = [
+            action.notAfter,
+            ...Array.from(metadata.matchAll(/^(?:notAfter\s*:\s*|最晚发布窗口[：:]\s*)([^\n;；]+)/gm), (m) => m[1].trim().replace(/^['"]|['"]$/g, "")),
+        ].filter((v) => v !== undefined && v !== null);
+        if (endings.some((v) => typeof v !== "string" ||
+            !/(?:Z|[+-]\d{2}:\d{2})$/.test(v) ||
+            !Number.isFinite(Date.parse(v))))
+            return { invalid: true, invalidAfter: true };
+        const until = endings.length
+            ? new Date(Math.min(...endings.map((v) => Date.parse(v)))).toISOString()
+            : undefined;
         if (!declared.length)
-            return {};
+            return until ? { until } : {};
         if (declared.some((v) => typeof v !== "string" ||
             !/(?:Z|[+-]\d{2}:\d{2})$/.test(v) ||
             !Number.isFinite(Date.parse(v))))
             return { invalid: true };
-        return {
-            at: new Date(Math.max(...declared.map((v) => Date.parse(v)))).toISOString(),
-        };
+        const at = new Date(Math.max(...declared.map((v) => Date.parse(v)))).toISOString();
+        if (until && Date.parse(until) <= Date.parse(at))
+            return { invalid: true, invalidAfter: true };
+        return { at, ...(until ? { until } : {}) };
     }
     reason(action, now) {
         const schedule = this.resolve(action);
         if (schedule.invalid)
-            return "draft-not-before-invalid";
+            return schedule.invalidAfter
+                ? "draft-not-after-invalid"
+                : "draft-not-before-invalid";
+        if (schedule.until && now >= Date.parse(schedule.until))
+            return "draft-window-expired";
         return schedule.at && now < Date.parse(schedule.at)
             ? "draft-not-before-not-reached"
             : null;

package/dist/platform-collections.js

@@ -240,7 +240,7 @@ export class PlatformCollections {
         }
         if (discoverOnly) {
             if (!nav.bookmarkFolders?.length) {
-                await this.waitForBookmarkLabel(nav, "所有书签", "All bookmarks");
+                await this.waitForBookmarkLabel(nav, "所有书签", "All bookmarks", true);
                 nav = await this.#ready({
                     view: "navigation",
                     bookmarkNavigation: true,
@@ -250,7 +250,10 @@ export class PlatformCollections {
         }
         if (!(nav.controls ?? []).some((c) => c.label.split("\n")[0] === folder)) {
             try {
-                await this.#browser.act({ operation: "waitForFolder", folder });
+                await this.#browser.act({
+                    operation: "waitForFolder",
+                    folder,
+                });
             }
             catch (error) {
                 if (!/timed out|timeout/i.test(error.message))
@@ -304,12 +307,16 @@ export class PlatformCollections {
             missing: folders.length ? [] : ["bookmark-folder-menu-unconfirmed"],
         };
     }
-    async waitForBookmarkLabel(nav, chinese, english) {
+    async waitForBookmarkLabel(nav, chinese, english, folderDiscovery = false) {
         const folder = (nav.controls ?? []).some((c) => /^(History|Bookmarks)$/i.test(c.label))
             ? english
             : chinese;
         try {
-            await this.#browser.act({ operation: "waitForFolder", folder });
+            await this.#browser.act({
+                operation: "waitForFolder",
+                folder,
+                folderDiscovery,
+            });
         }
         catch (error) {
             if (!/timed out|timeout/i.test(error.message))

package/dist/types.d.ts

@@ -250,6 +250,8 @@ export type PreparedAction = PreparedActionBase & ({
     kind: "original";
     draftPath: string;
     notBefore?: string;
+    /** Exclusive publication deadline; does not block unknown recovery. */
+    notAfter?: string;
     text: string;
     composeURL: string;
     composeEvidenceRef: EvidenceRef;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/x-harness",
-  "version": "0.2.40",
+  "version": "0.2.42",
   "type": "module",
   "description": "Typed X task harness with compact business results and explicit diagnostics.",
   "main": "./dist/index.js",
@@ -42,5 +42,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "26581c241d56f52365a0e1e903cb0e0122c6988d"
+  "gitHead": "56272553b4ce936e466e3139f56f1adbde4a353c"
 }

package/skill/references/writes.md

@@ -14,6 +14,8 @@ Action APIs return status/actionId/publicURL/evidenceRef and reason/missing/resu
 
 Original action optional notBefore is an ISO timestamp with timezone. Explicit draft header notBefore or 最早发布窗口 is also enforced; the later constraint wins. Invalid metadata blocks, and before-window independent publishing returns waiting; scoped rounds report draft-not-before-not-reached. Both preserve no intent or submission. Recovery of an already submitted post is unaffected.
 
+Original actions may pass `notAfter` as the calendar window’s exclusive ISO end. It is rechecked at intent and immediately before activation; expiration submits nothing. Unknown verification remains allowed after expiry.
+
 Additional fields: kind:'original', draftPath (existing .post.md), text (complete approved text), composeURL, composeEvidenceRef; optional assets:[{path,alt}], activation:'click'|'keyboard'. Every media path must exist and be reviewed. The DOM uploader supports one absolute PNG/JPEG/WebP image with required ALT, or one absolute MP4 video. Video uploads wait for a visible preview and public settlement requires a video on the exact fresh post; image ALT controls are not applied to videos.
 
 ```js