@nextclaw/x-harness 0.1.0 → 0.1.1

package/dist/readers-ax-views.js

@@ -0,0 +1,247 @@
+export function projectAXFilepicker(tree, context) {
+    const { nodes, descendants, evidence, navigation, roots, peopleRoots, peopleTimeline, within, alerts, } = tree;
+    const { mode, page, offset, limit, targetId, targetHandle, unknown, alertLines, } = context;
+    const dialog = nodes.findIndex((n) => /^(?:对话框|sheet|表单|dialog)(?: |$)/.test(n.label));
+    if (dialog < 0)
+        return unknown("filepicker-dialog-not-found");
+    const items = evidence(descendants(dialog)).filter((n) => /^(?:按钮 (?:\(disabled\) )?(?:打开|Open|前往|Go|取消|Cancel)(?:,|$)|文本栏 |组合框 )/.test(n.label) && !/URL:/.test(n.label));
+    const ready = items.some((n) => /^按钮 (?:打开|Open|前往|Go)(?:,|$)/.test(n.label)) || items.some((n) => /^(?:文本栏|组合框) /.test(n.label));
+    return {
+        mode,
+        evidence: items,
+        alerts: alertLines,
+        pageComplete: false,
+        needsStateCheck: !ready,
+        missing: ready ? [] : ["filepicker-controls-not-found"],
+    };
+}
+export function projectAXMedia(tree, context) {
+    const { nodes, descendants, evidence, navigation, roots, peopleRoots, peopleTimeline, within, alerts, } = tree;
+    const { mode, page, offset, limit, targetId, targetHandle, unknown, alertLines, } = context;
+    if (!/x\.com\/compose\/post\/media(?:[?#]|$)/.test(page ?? ""))
+        return unknown("media-route-not-found");
+    const web = nodes.findIndex((n) => /^(?:HTML 内容|AXWebArea) .*URL: (?:https?:\/\/)?x\.com\/compose\/post\/media(?:,|$)/.test(n.label));
+    if (web < 0)
+        return unknown("media-content-not-found");
+    const items = evidence(descendants(web));
+    return {
+        mode,
+        page,
+        evidence: items,
+        alerts: alertLines,
+        pageComplete: false,
+        needsStateCheck: !items.some((n) => /^按钮 保存(?:,|$)/.test(n.label)),
+        missing: [],
+    };
+}
+export function projectAXNavigation(tree, context) {
+    const { nodes, descendants, evidence, navigation, roots, peopleRoots, peopleTimeline, within, alerts, } = tree;
+    const { mode, page, offset, limit, targetId, targetHandle, unknown, alertLines, } = context;
+    return {
+        mode,
+        page,
+        posts: [],
+        evidence: navigation,
+        alerts,
+        pageComplete: false,
+        needsStateCheck: !navigation.length,
+        missing: navigation.length ? [] : ["navigation-not-found"],
+    };
+}
+export function projectAXPeople(tree, context) {
+    const { nodes, descendants, evidence, navigation, roots, peopleRoots, peopleTimeline, within, alerts, } = tree;
+    const { mode, page, offset, limit, targetId, targetHandle, unknown, alertLines, } = context;
+    const all = peopleRoots.map((i) => ({
+        handle: nodes[i].label.match(/@(\w+)/)[1],
+        evidence: evidence(descendants(i)),
+    }));
+    const matches = targetHandle
+        ? all.filter((p) => p.handle.toLowerCase() === targetHandle.toLowerCase())
+        : all;
+    const missing = peopleTimeline < 0
+        ? ["people-timeline-not-found"]
+        : !matches.length
+            ? ["person-not-found"]
+            : targetHandle && matches.length > 1
+                ? ["person-ambiguous"]
+                : [];
+    return {
+        mode,
+        page,
+        posts: [],
+        people: missing.length ? [] : matches.slice(offset, offset + limit),
+        renderedPeople: all.length,
+        matched: matches.length,
+        offset,
+        moreInDOM: matches.length > offset + limit,
+        alerts,
+        navigation: missing.length ? navigation : undefined,
+        missing,
+        needsStateCheck: !!missing.length,
+        pageComplete: false,
+    };
+}
+export function projectAXPosts(tree, context) {
+    const { nodes, descendants, evidence, navigation, roots, peopleRoots, peopleTimeline, within, alerts, } = tree;
+    const { mode, page, offset, limit, targetId, targetHandle, unknown, alertLines, } = context;
+    const all = roots.map((i) => {
+        const postNodes = descendants(i);
+        const items = evidence(postNodes);
+        const authorHandle = nodes[i].label.match(/@(\w+)/)?.[1];
+        const primary = items.find((n) => /^link /.test(n.label) &&
+            n.label
+                .match(/x\.com\/(\w+)\/status\/\d+(?:[?#][^\s,]*)?(?:,|$)/)?.[1]
+                ?.toLowerCase() === authorHandle?.toLowerCase());
+        const edited = postNodes.filter((n) => /^link 这是该帖子的最新版本。/.test(n.label) &&
+            n.label
+                .match(/x\.com\/(\w+)\/status\/\d+\/history(?:,|$)/)?.[1]
+                ?.toLowerCase() === authorHandle?.toLowerCase() &&
+            !postNodes.some((q) => /^(?:container |article )引用(?: |$)/.test(q.label) &&
+                within(n, nodes.indexOf(q))));
+        const source = primary ?? (edited.length === 1 ? edited[0] : null);
+        const match = source?.label.match(/x\.com\/(\w+)\/status\/(\d+)/);
+        const text = postNodes
+            .filter((n) => {
+            if (!/^(?:文本 |text )/.test(n.label))
+                return false;
+            let parent = n.parent;
+            while (parent !== null && parent !== i) {
+                if (/^(?:按钮|button)(?: |$)/.test(nodes[parent].label))
+                    return false;
+                parent = nodes[parent].parent;
+            }
+            return true;
+        })
+            .map((n) => n.label.replace(/^(?:文本 |text )/, ""))
+            .join("\n");
+        const absolute = source?.label.match(/link (上午|下午)?(\d{1,2}):(\d{2}) · (\d{4})年(\d{1,2})月(\d{1,2})日/);
+        let datetime = null;
+        if (absolute) {
+            let hour = Number(absolute[2]);
+            if (absolute[1])
+                hour = (hour % 12) + (absolute[1] === "下午" ? 12 : 0);
+            if (hour < 24 && Number(absolute[3]) < 60)
+                datetime = new Date(Date.UTC(Number(absolute[4]), Number(absolute[5]) - 1, Number(absolute[6]), hour - 8, Number(absolute[3]))).toISOString();
+        }
+        return {
+            id: match?.[2] ?? null,
+            author: match?.[1] ?? null,
+            primary: source?.label ?? null,
+            datetime,
+            ...(datetime ? { datetimePrecision: "minute" } : {}),
+            timeEvidence: source?.label ?? null,
+            text,
+            evidence: items,
+            needsExpansion: /显示更多|Show more/i.test(text) ||
+                items.some((n) => /显示更多|Show more/i.test(n.label)),
+            missing: [
+                !match && "id",
+                !text && "text",
+                !datetime && "datetime",
+            ].filter(Boolean),
+        };
+    });
+    const candidates = targetId ? all.filter((p) => p.id === targetId) : all;
+    return {
+        mode,
+        page,
+        renderedArticles: all.length,
+        matched: candidates.length,
+        offset,
+        moreInDOM: candidates.length > offset + limit,
+        pageComplete: false,
+        needsStateCheck: candidates.length === 0,
+        missing: candidates.length ? [] : ["post-not-found"],
+        posts: candidates.slice(offset, offset + limit),
+        alerts,
+        navigation: candidates.length ? undefined : navigation,
+    };
+}
+export function projectAXProfile(tree, context) {
+    const { nodes, descendants, evidence, navigation, roots, peopleRoots, peopleTimeline, within, alerts, } = tree;
+    const { mode, page, offset, limit, targetId, targetHandle, unknown, alertLines, } = context;
+    const start = nodes.findIndex((n) => n.label === "container 主页时间线");
+    if (start < 0)
+        return { ...unknown("profile-not-found"), page, alerts, navigation };
+    const main = descendants(start), end = main.findIndex((n) => /container 个人资料时间线/.test(n.label));
+    if (end < 0)
+        return {
+            ...unknown("profile-boundary-not-found"),
+            page,
+            alerts,
+            navigation,
+        };
+    return {
+        mode,
+        page,
+        posts: [],
+        evidence: evidence(main.slice(0, end)),
+        alerts,
+        pageComplete: false,
+        needsStateCheck: false,
+    };
+}
+export function projectAXComposer(tree, context) {
+    const { nodes, descendants, evidence, navigation, roots, peopleRoots, peopleTimeline, within, alerts, } = tree;
+    const { mode, page, offset, limit, targetId, targetHandle, unknown, alertLines, } = context;
+    const dialog = nodes.findIndex((n) => /^(?:对话框|dialog)(?: |$)/.test(n.label));
+    if (dialog < 0) {
+        const web = nodes.findIndex((n) => /^(?:HTML 内容|AXWebArea) .*URL: (?:https?:\/\/)?x\.com\/compose\/post(?:,|$)/.test(n.label));
+        if (/x\.com\/compose\/post(?:[?#]|$)/.test(page ?? "") && web >= 0) {
+            const items = evidence(descendants(web));
+            const editors = items.filter((n) => /^(?:文本输入区(?:域)?|文本区域) .*帖子文本/.test(n.label));
+            const submits = items.filter((n) => /^按钮 (?:\(disabled\) )?(?:发帖|Post)(?:,|$)/i.test(n.label));
+            if (editors.length === 1 && submits.length === 1)
+                return {
+                    mode,
+                    page,
+                    posts: [],
+                    evidence: items,
+                    alerts,
+                    pageComplete: false,
+                    needsStateCheck: false,
+                };
+        }
+        const editors = nodes.filter((n) => /^(?:文本输入区(?:域)?|文本区域|文本栏) /.test(n.label));
+        const submits = nodes.filter((n) => /^按钮 (?:回复|Reply)(?:,|$)/i.test(n.label));
+        if (/x\.com\/\w+\/status\/\d+(?:[?#]|$)/.test(page ?? "") &&
+            editors.length === 1 &&
+            submits.length === 1) {
+            return {
+                mode,
+                page,
+                inlineComposer: true,
+                posts: [],
+                evidence: evidence([...editors, ...submits]),
+                alerts,
+                pageComplete: false,
+                needsStateCheck: false,
+            };
+        }
+        return {
+            ...unknown("composer-dialog-not-found"),
+            page,
+            alerts,
+            navigation,
+        };
+    }
+    const items = evidence(descendants(dialog));
+    if (!items.some((n) => /^(?:文本输入区(?:域)?|文本区域|文本栏) /.test(n.label)) ||
+        !items.some((n) => /^按钮 (?:发帖|发布|回复|Post|Reply)(?:,|$)/i.test(n.label))) {
+        return {
+            ...unknown("composer-boundary-unconfirmed"),
+            page,
+            alerts,
+            navigation,
+        };
+    }
+    return {
+        mode,
+        page,
+        posts: [],
+        evidence: items,
+        alerts,
+        pageComplete: false,
+        needsStateCheck: false,
+    };
+}

package/dist/readers-cli.d.ts

@@ -0,0 +1,6 @@
+export declare function setupCode(): any;
+export declare function profileCode({ tab, handle }?: any): any;
+export declare function profilesCode(entries: any): any;
+export declare function browserCode({ handle, offset, limit, targetId, fresh, }?: any): any;
+export declare function axCode({ handle, mode, offset, limit, targetId, targetHandle, fresh, }?: any): any;
+export declare function runReaderCLI(): void;

package/dist/readers-composer.d.ts

@@ -0,0 +1,2 @@
+export declare function readComposer(): any;
+export declare function readMediaEditor(): any;

package/dist/readers-composer.js

@@ -0,0 +1,131 @@
+export function readComposer() {
+    const visible = (el) => el.getClientRects().length > 0 && !el.closest('[aria-hidden="true"]');
+    const dialogs = Array.from(document.querySelectorAll('[role="dialog"]')).filter(visible);
+    const root = dialogs.length === 1
+        ? dialogs[0]
+        : dialogs.length === 0
+            ? document.querySelector("main")
+            : null;
+    if (location.pathname.startsWith("/compose/post/unsent/")) {
+        const text = root?.innerText ?? "";
+        return {
+            page: location.href,
+            unsent: true,
+            text: text.slice(0, 8000),
+            truncated: text.length > 8000,
+            controls: root
+                ? Array.from(root.querySelectorAll('button,a,[role="tab"]'))
+                    .filter(visible)
+                    .slice(0, 30)
+                    .map((el) => ({
+                    label: el.getAttribute("aria-label") || el.innerText,
+                    href: el.getAttribute("href"),
+                }))
+                : [],
+            needsStateCheck: !root || text.length > 8000,
+        };
+    }
+    const navigation = Array.from(document.querySelectorAll('a[href="/compose/post"],button[data-testid="SideNav_AccountSwitcher_Button"]'))
+        .filter(visible)
+        .map((el) => ({
+        role: el.tagName === "A" ? "link" : "button",
+        label: el.getAttribute("aria-label") || el.innerText,
+    }));
+    if (Array.from(document.querySelectorAll('[role="textbox"],textarea,[contenteditable="true"]')).filter(visible).length !== 1)
+        return {
+            page: location.href,
+            navigation,
+            dialog: root &&
+                (dialogs.length === 1 || location.pathname === "/compose/post/media")
+                ? {
+                    buttons: Array.from(root.querySelectorAll('button,[role="tab"]'))
+                        .filter(visible)
+                        .map((el) => ({
+                        role: el.getAttribute("role") || "button",
+                        label: el.getAttribute("aria-label") || el.innerText,
+                    })),
+                    fields: Array.from(root.querySelectorAll("textarea,input"))
+                        .filter(visible)
+                        .map((el) => ({
+                        label: el.getAttribute("aria-label"),
+                        placeholder: el.getAttribute("placeholder"),
+                        value: el.value,
+                    })),
+                }
+                : null,
+            needsStateCheck: true,
+            missing: ["composer-editor-not-found"],
+            editorCandidates: Array.from(document.querySelectorAll('[role="textbox"],textarea,[contenteditable="true"]'))
+                .filter(visible)
+                .map((el) => ({
+                label: el.getAttribute("aria-label"),
+                testId: el.getAttribute("data-testid"),
+                tag: el.tagName,
+            })),
+        };
+    const editors = Array.from(document.querySelectorAll('[role="textbox"],textarea,[contenteditable="true"]')).filter(visible);
+    let scope = editors[0];
+    while (scope.parentElement &&
+        !Array.from(scope.querySelectorAll("button")).some((el) => visible(el) &&
+            /^(发帖|回复|更新)$/.test(el.getAttribute("aria-label") || el.innerText)))
+        scope = scope.parentElement;
+    if (scope === document.body || scope === document.documentElement)
+        return {
+            page: location.href,
+            needsStateCheck: true,
+            missing: ["composer-submit-scope-not-found"],
+        };
+    return {
+        page: location.href,
+        navigation,
+        editors: editors.map((el) => ({
+            label: el.getAttribute("aria-label"),
+            testId: el.getAttribute("data-testid"),
+            text: el.innerText,
+        })),
+        buttons: Array.from(scope.querySelectorAll("button"))
+            .filter(visible)
+            .map((el) => ({
+            label: el.getAttribute("aria-label") || el.innerText,
+            disabled: el.disabled,
+            testId: el.getAttribute("data-testid"),
+            ariaDisabled: el.getAttribute("aria-disabled"),
+            ariaBusy: el.getAttribute("aria-busy"),
+        })),
+        images: Array.from(scope.querySelectorAll("img"))
+            .filter(visible)
+            .map((el) => ({ alt: el.alt })),
+        needsStateCheck: false,
+    };
+}
+export function readMediaEditor() {
+    if (location.pathname !== "/compose/post/media")
+        return { needsStateCheck: true, missing: ["media-route-not-found"] };
+    const visible = (el) => el.getClientRects().length > 0 && !el.closest('[aria-hidden="true"]');
+    const controls = Array.from(document.querySelectorAll('button,[role="tab"]'))
+        .filter(visible)
+        .map((el) => ({
+        role: el.getAttribute("role") || "button",
+        label: el.getAttribute("aria-label") || el.innerText,
+        disabled: el.disabled === true,
+    }));
+    const fields = Array.from(document.querySelectorAll('textarea,input,[role="textbox"]'))
+        .filter(visible)
+        .map((el) => ({
+        label: el.getAttribute("aria-label"),
+        placeholder: el.getAttribute("placeholder"),
+        value: el.value ?? el.innerText,
+    }));
+    const ready = controls.some((c) => c.role === "button" && c.label === "保存") &&
+        controls.some((c) => c.role === "tab" && c.label === "编辑图片描述");
+    return {
+        page: location.href,
+        controls: controls.slice(0, 20),
+        fields: fields.slice(0, 5),
+        needsStateCheck: !ready || controls.length > 20 || fields.length > 5,
+        missing: ready ? [] : ["media-editor-controls-not-ready"],
+        alerts: Array.from(document.querySelectorAll('[role="alert"]'))
+            .filter(visible)
+            .map((el) => el.innerText),
+    };
+}

package/dist/readers-navigation.d.ts

@@ -0,0 +1,2 @@
+export declare function readMenu(): any;
+export declare function readNavigation({ targetLabel }?: any): any;

package/dist/readers-navigation.js

@@ -0,0 +1,66 @@
+export function readMenu() {
+    const visible = (el) => el.getClientRects().length > 0;
+    const roots = Array.from(document.querySelectorAll('[role="menu"],[role="dialog"],[data-testid="Dropdown"]')).filter(visible);
+    const items = [
+        ...new Set(roots.flatMap((root) => Array.from(root.querySelectorAll('a[href],button,[role="menuitem"]')))),
+    ].filter(visible);
+    return {
+        items: items.map((el) => ({
+            role: el.getAttribute("role") || (el.tagName === "A" ? "link" : "button"),
+            label: el.getAttribute("aria-label") || el.innerText,
+            href: el.getAttribute("href"),
+        })),
+        needsStateCheck: !items.length,
+        missing: items.length ? [] : ["menu-not-found"],
+    };
+}
+// Bounded visible navigation only. Never include article links as navigation controls.
+export function readNavigation({ targetLabel } = {}) {
+    const visible = (el) => el.getClientRects().length > 0 && !el.closest('[aria-hidden="true"]');
+    const primary = document.querySelector('[data-testid="primaryColumn"]') ??
+        document.querySelector("main");
+    const nodes = [
+        ...new Set([
+            ...Array.from(document.querySelectorAll("nav a[href],nav button")).filter((el) => !el.closest("main")),
+            ...Array.from(primary?.querySelectorAll('a[href],button,[role="button"],[role="tab"]') ?? []),
+            ...Array.from(document.querySelectorAll('[role="menu"] a[href], [role="menu"] button, [data-testid="Dropdown"] a[href], [data-testid="Dropdown"] button')),
+        ]),
+    ].filter((el) => visible(el) && !el.closest("article"));
+    const controls = nodes.map((el) => ({
+        role: el.getAttribute("role") || (el.tagName === "A" ? "link" : "button"),
+        label: el.getAttribute("aria-label") || el.innerText.trim(),
+        href: el.getAttribute("href"),
+        selected: el.getAttribute("aria-selected") === "true",
+        disabled: el.disabled === true,
+    }));
+    // Some folder cards are plain clickable text, with no ARIA role or href.
+    // Only the explicitly requested, visible exact label can be promoted to a semantic control.
+    if (targetLabel &&
+        !controls.some((c) => c.label.split("\n")[0] === targetLabel)) {
+        const labels = Array.from(document.querySelectorAll("span,div")).filter((el) => visible(el) &&
+            !el.closest("article") &&
+            el.innerText.trim() === targetLabel &&
+            !Array.from(el.children).some((child) => child.innerText?.trim() === targetLabel));
+        controls.push(...labels.map((el) => ({
+            role: "text",
+            label: el.innerText.trim(),
+            href: null,
+            disabled: false,
+            source: "exact-visible-folder-label",
+        })));
+    }
+    return {
+        page: location.href,
+        controls: controls.slice(0, 40),
+        headings: Array.from(primary?.querySelectorAll('h1,h2,[role="heading"]') ?? [])
+            .filter(visible)
+            .map((el) => el.innerText.trim())
+            .slice(0, 10),
+        needsStateCheck: !controls.length || controls.length > 40,
+        missing: controls.length > 40
+            ? ["navigation-window-overflow"]
+            : controls.length
+                ? []
+                : ["navigation-not-found"],
+    };
+}

package/dist/readers-posts.d.ts

@@ -0,0 +1,2 @@
+export declare function readPosts({ offset, limit, targetId, }?: any): any;
+export declare function changes(result: any, cache: any, page: any, fresh?: any): any;

package/dist/readers-posts.js

@@ -0,0 +1,141 @@
+// Self-contained, read-only DOM function for cua_repl's documented evaluate.
+export function readPosts({ offset = 0, limit = 5, targetId = "", } = {}) {
+    if (!Number.isInteger(offset) ||
+        offset < 0 ||
+        !Number.isInteger(limit) ||
+        limit < 1 ||
+        limit > 5)
+        throw new Error("offset>=0；limit为1～5");
+    if (targetId && !/^\d+$/.test(targetId))
+        throw new Error("targetId必须是数字公开ID");
+    const visible = (el) => el.getClientRects().length > 0;
+    const primaryTime = (a) => Array.from(a.querySelectorAll("time")).find((t) => visible(t) &&
+        /\/status\/\d+(?:$|[/?#])/.test(t.closest("a")?.getAttribute("href") ?? "")) ?? null;
+    const all = Array.from(document.querySelectorAll("article")).filter(visible);
+    const candidates = targetId
+        ? all.filter((a) => {
+            const primary = primaryTime(a)?.closest("a")?.getAttribute("href");
+            return (primary && new RegExp(`/status/${targetId}(?:$|[/?#])`).test(primary));
+        })
+        : all;
+    const posts = candidates.slice(offset, offset + limit).map((a) => {
+        const time = primaryTime(a);
+        const primary = time?.closest("a")?.getAttribute("href") ?? null;
+        const links = [
+            ...new Set(Array.from(a.querySelectorAll("a[href]"))
+                .filter(visible)
+                .map((l) => l.getAttribute("href"))),
+        ];
+        const buttons = Array.from(a.querySelectorAll("button"))
+            .filter(visible)
+            .map((b) => ({
+            label: b.getAttribute("aria-label") || b.innerText,
+            disabled: b.hasAttribute("disabled"),
+        }));
+        const text = a.innerText;
+        const datetime = time?.getAttribute("datetime") ?? null;
+        const id = primary?.match(/\/status\/(\d+)/)?.[1] ?? null;
+        const author = primary?.match(/\/([^/]+)\/status\//)?.[1] ?? null;
+        const images = Array.from(a.querySelectorAll('[data-testid="tweetPhoto"] img'))
+            .filter(visible)
+            .map((img) => ({
+            alt: img.getAttribute("alt"),
+            src: img.getAttribute("src"),
+        }));
+        const media = Array.from(a.querySelectorAll('[data-testid="videoPlayer"],video'))
+            .filter(visible)
+            .map((el) => ({
+            kind: "video",
+            label: el.getAttribute("aria-label"),
+            poster: el.getAttribute("poster"),
+            requiresViewing: true,
+        }));
+        return {
+            id,
+            author,
+            datetime,
+            primary,
+            text,
+            links,
+            buttons,
+            // View/quote counts may be visible links rather than buttons; collect in this same read.
+            metrics: [
+                ...buttons,
+                ...Array.from(a.querySelectorAll('a[href$="/analytics"],a[href$="/quotes"]'))
+                    .filter(visible)
+                    .map((link) => ({
+                    label: link.getAttribute("aria-label") ||
+                        `${link.getAttribute("href").endsWith("/analytics") ? "观看" : "引用"} ${link.innerText}`,
+                })),
+            ],
+            images,
+            media,
+            needsExpansion: /显示更多|Show more/i.test(text),
+            missing: [
+                !id && "id",
+                !author && "author",
+                !datetime && "datetime",
+                !text && "text",
+            ].filter(Boolean),
+        };
+    });
+    const versionLinks = Array.from(document.querySelectorAll("a[href]"))
+        .filter(visible)
+        .filter((a) => /最新版本|查看最新帖子|Latest version|View latest/i.test(a.innerText))
+        .slice(0, 5)
+        .map((a) => ({ label: a.innerText, href: a.getAttribute("href") }));
+    const emptyEvidence = all.length === 0
+        ? [
+            ...new Set(Array.from(document.querySelectorAll("main span"))
+                .filter(visible)
+                .map((e) => e.innerText?.trim())
+                .filter((text) => text &&
+                text.length <= 400 &&
+                !text.includes("\n") &&
+                /^(?:没有.*结果|未找到.*结果|No results for)/i.test(text))),
+        ].slice(0, 2)
+        : [];
+    return {
+        renderedArticles: all.length,
+        matched: candidates.length,
+        offset,
+        moreInDOM: candidates.length > offset + posts.length,
+        pageComplete: false,
+        needsStateCheck: all.length === 0 && emptyEvidence.length === 0,
+        posts,
+        versionLinks,
+        emptyEvidence,
+        alerts: Array.from(document.querySelectorAll('[role="alert"]'))
+            .filter(visible)
+            .map((e) => e.innerText),
+    };
+}
+export function changes(result, cache, page, fresh = false) {
+    const unchangedIds = [];
+    const posts = result.posts.filter((post) => {
+        if (!post.id)
+            return true;
+        const key = `${page}|${post.id}`;
+        const value = JSON.stringify(post);
+        const changed = cache[key] !== value;
+        cache[key] = value;
+        if (!fresh && !changed)
+            unchangedIds.push(post.id);
+        return fresh || changed;
+    });
+    const outputChars = JSON.stringify({ ...result, posts, unchangedIds }).length;
+    const optimizationHint = outputChars > 8000
+        ? posts.length > 1
+            ? "缩小读取窗口或按已观察ID定向读取；保留完整正文"
+            : "单篇证据本身长，保留全文，不截断"
+        : null;
+    return {
+        ...result,
+        posts,
+        unchanged: result.posts.length - posts.length,
+        unchangedIds,
+        fresh,
+        outputChars,
+        optimizationHint,
+    };
+}

package/dist/readers-profile.d.ts

@@ -0,0 +1,3 @@
+export declare function readProfile({ handle }?: any): any;
+export declare function readPeople({ offset, limit }?: any): any;
+export declare function screenCandidates(profiles: any, { minRatio }?: any): any;