@nextclaw/x-harness 0.2.39 → 0.2.41

package/SOURCE.md

@@ -1,8 +1,8 @@
 # Corresponding source
 
-Version 0.2.39, commit e3d0f784983fbdef6162a4e92d9921fe15ce3237.
+Version 0.2.41, commit abb1997d1e0d7208ed22a5b47d36c9b7dc3b6832.
 
-Complete source, build scripts and dependencies: https://github.com/Peiiii/x-harness/tree/e3d0f784983fbdef6162a4e92d9921fe15ce3237
+Complete source, build scripts and dependencies: https://github.com/Peiiii/x-harness/tree/abb1997d1e0d7208ed22a5b47d36c9b7dc3b6832
 
 Clone this revision, run npm ci, npm run bootstrap and npm run release:build.
 

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.d.ts

@@ -9,6 +9,8 @@ export declare class PlatformCollections {
     private handleCollectSources;
     private handleReadCreator;
     private handleReadBookmarks;
+    private bookmarkDiscovery;
+    private waitForBookmarkLabel;
     private handleSearchSources;
 }
 export declare function createPlatformCollections(...args: ConstructorParameters<typeof PlatformCollections>): PlatformCollections;

package/dist/platform-collections.js

@@ -174,8 +174,15 @@ export class PlatformCollections {
             targetLabel: folder,
             bookmarkNavigation: true,
         });
+        if (discoverOnly && nav.bookmarkFolders?.length)
+            return this.bookmarkDiscovery(nav);
         const bookmark = (c) => /^(书签|收藏|Bookmarks)$/i.test(c.label);
-        if (!(await this.#choose(nav, bookmark, { activateSelected: true })) &&
+        const matching = (nav.controls ?? []).filter(bookmark);
+        const entered = await this.#choose(nav, bookmark, {
+            activateSelected: true,
+        });
+        const openedTab = entered && matching.length === 1 && matching[0].role === "tab";
+        if (!entered &&
             !(await this.#choose(nav, (c) => /^(历史|History)$/i.test(c.label)))) {
             if (await this.#choose(nav, (c) => /^(更多菜单项|More menu items)$/i.test(c.label))) {
                 nav = await this.#ready({ view: "menu" });
@@ -207,13 +214,19 @@ export class PlatformCollections {
             targetLabel: folder,
             bookmarkNavigation: true,
         });
+        if (discoverOnly &&
+            !(nav.controls ?? []).some((c) => c.role === "tab")) {
+            await this.waitForBookmarkLabel(nav, "书签", "Bookmarks");
+            nav = await this.#ready({ view: "navigation", bookmarkNavigation: true });
+        }
         const tabs = (nav.controls ?? []).filter((c) => c.role === "tab" &&
             (bookmark(c) ||
                 (discoverOnly &&
                     /\/i\/(?:history|bookmarks)(?:\/|$)/.test(nav.page ?? "") &&
                     c.selected &&
                     !/^(喜欢|Likes)$/i.test(c.label))));
-        if (tabs.length === 1 &&
+        if (!openedTab &&
+            tabs.length === 1 &&
             (!tabs[0].selected ||
                 !(nav.controls ?? []).some((c) => c.label.split("\n")[0] === folder))) {
             await this.#choose(nav, (c) => c === tabs[0], {
@@ -226,17 +239,14 @@ export class PlatformCollections {
             });
         }
         if (discoverOnly) {
-            const folders = nav.bookmarkFolders ?? [];
-            return {
-                page: nav.page,
-                accountHandle: nav.accountHandle,
-                observedAt: nav.observedAt,
-                fresh: true,
-                complete: folders.length > 0 && !nav.alerts?.length,
-                pageComplete: false,
-                folders,
-                missing: folders.length ? [] : ["bookmark-folder-menu-unconfirmed"],
-            };
+            if (!nav.bookmarkFolders?.length) {
+                await this.waitForBookmarkLabel(nav, "所有书签", "All bookmarks");
+                nav = await this.#ready({
+                    view: "navigation",
+                    bookmarkNavigation: true,
+                });
+            }
+            return this.bookmarkDiscovery(nav);
         }
         if (!(nav.controls ?? []).some((c) => c.label.split("\n")[0] === folder)) {
             try {
@@ -281,6 +291,31 @@ export class PlatformCollections {
             },
         };
     }
+    bookmarkDiscovery(nav) {
+        const folders = nav.bookmarkFolders ?? [];
+        return {
+            page: nav.page,
+            accountHandle: nav.accountHandle,
+            observedAt: nav.observedAt,
+            fresh: true,
+            complete: folders.length > 0 && !nav.alerts?.length,
+            pageComplete: false,
+            folders,
+            missing: folders.length ? [] : ["bookmark-folder-menu-unconfirmed"],
+        };
+    }
+    async waitForBookmarkLabel(nav, chinese, english) {
+        const folder = (nav.controls ?? []).some((c) => /^(History|Bookmarks)$/i.test(c.label))
+            ? english
+            : chinese;
+        try {
+            await this.#browser.act({ operation: "waitForFolder", folder });
+        }
+        catch (error) {
+            if (!/timed out|timeout/i.test(error.message))
+                throw error;
+        }
+    }
     async handleSearchSources({ query, limit = 3, maxPages = 1, processedIds = [], } = {}) {
         await this.#browser.act({ operation: "searchSources", query });
         const value = await this.handleCollectSources({

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.39",
+  "version": "0.2.41",
   "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": "e3d0f784983fbdef6162a4e92d9921fe15ce3237"
+  "gitHead": "abb1997d1e0d7208ed22a5b47d36c9b7dc3b6832"
 }

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