@nextclaw/x-harness 0.2.40 → 0.2.41

package/SOURCE.md

@@ -1,8 +1,8 @@
 # Corresponding source
 
-Version 0.2.40, commit 26581c241d56f52365a0e1e903cb0e0122c6988d.
+Version 0.2.41, commit abb1997d1e0d7208ed22a5b47d36c9b7dc3b6832.
 
-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/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/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.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": "26581c241d56f52365a0e1e903cb0e0122c6988d"
+  "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