@agentrhq/webcmd 0.1.1 → 0.2.0

package/clis/xiaohongshu/user-helpers.js

@@ -1,78 +0,0 @@
-function toCleanString(value) {
-    return typeof value === 'string' ? value.trim() : value == null ? '' : String(value).trim();
-}
-export function normalizeXhsUserId(input) {
-    const trimmed = toCleanString(input);
-    const withoutQuery = trimmed.replace(/[?#].*$/, '');
-    const matched = withoutQuery.match(/\/user\/profile\/([a-zA-Z0-9]+)/);
-    if (matched?.[1])
-        return matched[1];
-    return withoutQuery.replace(/\/+$/, '').split('/').pop() ?? withoutQuery;
-}
-export function flattenXhsNoteGroups(noteGroups) {
-    if (!Array.isArray(noteGroups))
-        return [];
-    const notes = [];
-    for (const group of noteGroups) {
-        if (!group)
-            continue;
-        if (Array.isArray(group)) {
-            for (const item of group) {
-                if (item)
-                    notes.push(item);
-            }
-            continue;
-        }
-        notes.push(group);
-    }
-    return notes;
-}
-/**
- * Build a signed user-profile note URL on the given web host (defaults to
- * `www.xiaohongshu.com`). The rednote adapter passes `'www.rednote.com'` so
- * the same builder works for both sites.
- */
-export function buildXhsNoteUrl(userId, noteId, xsecToken, webHost = 'www.xiaohongshu.com') {
-    const cleanUserId = toCleanString(userId);
-    const cleanNoteId = toCleanString(noteId);
-    if (!cleanUserId || !cleanNoteId)
-        return '';
-    const url = new URL(`https://${webHost}/user/profile/${cleanUserId}/${cleanNoteId}`);
-    const cleanToken = toCleanString(xsecToken);
-    if (cleanToken) {
-        url.searchParams.set('xsec_token', cleanToken);
-        url.searchParams.set('xsec_source', 'pc_user');
-    }
-    return url.toString();
-}
-/**
- * Normalise a Pinia user-store snapshot into CLI rows. `webHost` is forwarded
- * to `buildXhsNoteUrl` so the resulting URLs point at the calling site.
- */
-export function extractXhsUserNotes(snapshot, fallbackUserId, webHost = 'www.xiaohongshu.com') {
-    const notes = flattenXhsNoteGroups(snapshot.noteGroups);
-    const rows = [];
-    const seen = new Set();
-    for (const entry of notes) {
-        const noteCard = entry?.noteCard ?? entry?.note_card ?? entry;
-        if (!noteCard || typeof noteCard !== 'object')
-            continue;
-        const noteId = toCleanString(noteCard.noteId ?? noteCard.note_id ?? entry?.noteId ?? entry?.note_id ?? entry?.id);
-        if (!noteId || seen.has(noteId))
-            continue;
-        seen.add(noteId);
-        const userId = toCleanString(noteCard.user?.userId ?? noteCard.user?.user_id ?? fallbackUserId);
-        const xsecToken = toCleanString(entry?.xsecToken ?? entry?.xsec_token ?? noteCard.xsecToken ?? noteCard.xsec_token);
-        const likes = toCleanString(noteCard.interactInfo?.likedCount ?? noteCard.interact_info?.liked_count ?? 0) || '0';
-        const cover = toCleanString(noteCard.cover?.urlDefault ?? noteCard.cover?.urlPre ?? noteCard.cover?.url ?? '');
-        rows.push({
-            id: noteId,
-            title: toCleanString(noteCard.displayTitle ?? noteCard.display_title ?? noteCard.title),
-            type: toCleanString(noteCard.type),
-            likes,
-            cover,
-            url: buildXhsNoteUrl(userId || fallbackUserId, noteId, xsecToken, webHost),
-        });
-    }
-    return rows;
-}

package/clis/xiaohongshu/user-helpers.test.js

@@ -1,160 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { assertReadableUserSnapshot } from './user.js';
-import { buildXhsNoteUrl, extractXhsUserNotes, flattenXhsNoteGroups, normalizeXhsUserId, } from './user-helpers.js';
-describe('normalizeXhsUserId', () => {
-    it('extracts the profile id from a full Xiaohongshu URL', () => {
-        expect(normalizeXhsUserId('https://www.xiaohongshu.com/user/profile/615529370000000002026001?xsec_source=pc_search')).toBe('615529370000000002026001');
-    });
-    it('keeps a bare profile id unchanged', () => {
-        expect(normalizeXhsUserId('615529370000000002026001')).toBe('615529370000000002026001');
-    });
-});
-describe('flattenXhsNoteGroups', () => {
-    it('flattens grouped note arrays and ignores empty groups', () => {
-        expect(flattenXhsNoteGroups([[{ id: 'a' }], [], null, [{ id: 'b' }]])).toEqual([
-            { id: 'a' },
-            { id: 'b' },
-        ]);
-    });
-});
-describe('buildXhsNoteUrl', () => {
-    it('includes xsec token when available', () => {
-        expect(buildXhsNoteUrl('user123', 'note456', 'token789')).toBe('https://www.xiaohongshu.com/user/profile/user123/note456?xsec_token=token789&xsec_source=pc_user');
-    });
-    it('emits a rednote URL when webHost is overridden', () => {
-        expect(buildXhsNoteUrl('user123', 'note456', 'token789', 'www.rednote.com')).toBe('https://www.rednote.com/user/profile/user123/note456?xsec_token=token789&xsec_source=pc_user');
-    });
-});
-describe('extractXhsUserNotes', () => {
-    it('normalizes grouped note cards into CLI rows', () => {
-        const rows = extractXhsUserNotes({
-            noteGroups: [
-                [
-                    {
-                        id: 'note-1',
-                        xsecToken: 'abc',
-                        noteCard: {
-                            noteId: 'note-1',
-                            displayTitle: 'First note',
-                            type: 'video',
-                            interactInfo: { likedCount: '4.6万' },
-                            user: { userId: 'user-1' },
-                        },
-                    },
-                    {
-                        noteCard: {
-                            note_id: 'note-2',
-                            display_title: 'Second note',
-                            type: 'normal',
-                            interact_info: { liked_count: 42 },
-                        },
-                    },
-                ],
-                [],
-            ],
-        }, 'fallback-user');
-        expect(rows).toEqual([
-            {
-                id: 'note-1',
-                title: 'First note',
-                type: 'video',
-                likes: '4.6万',
-                cover: '',
-                url: 'https://www.xiaohongshu.com/user/profile/user-1/note-1?xsec_token=abc&xsec_source=pc_user',
-            },
-            {
-                id: 'note-2',
-                title: 'Second note',
-                type: 'normal',
-                likes: '42',
-                cover: '',
-                url: 'https://www.xiaohongshu.com/user/profile/fallback-user/note-2',
-            },
-        ]);
-    });
-    it('extracts cover urls with fallback priority urlDefault -> urlPre -> url', () => {
-        const rows = extractXhsUserNotes({
-            noteGroups: [
-                [
-                    { noteCard: { noteId: 'cover-1', cover: { urlDefault: 'https://img.example/default.jpg', urlPre: 'https://img.example/pre.jpg', url: 'https://img.example/raw.jpg' } } },
-                    { noteCard: { noteId: 'cover-2', cover: { urlPre: 'https://img.example/pre-only.jpg', url: 'https://img.example/raw-only.jpg' } } },
-                    { noteCard: { noteId: 'cover-3', cover: { url: 'https://img.example/raw-fallback.jpg' } } },
-                ],
-            ],
-        }, 'fallback-user');
-        expect(rows.map(row => row.cover)).toEqual([
-            'https://img.example/default.jpg',
-            'https://img.example/pre-only.jpg',
-            'https://img.example/raw-fallback.jpg',
-        ]);
-    });
-    it('deduplicates repeated notes by note id', () => {
-        const rows = extractXhsUserNotes({
-            noteGroups: [
-                [
-                    { noteCard: { noteId: 'dup-1', displayTitle: 'keep me' } },
-                    { noteCard: { noteId: 'dup-1', displayTitle: 'drop me' } },
-                ],
-            ],
-        }, 'fallback-user');
-        expect(rows).toHaveLength(1);
-        expect(rows[0]?.title).toBe('keep me');
-    });
-    it('emits rednote-hosted URLs when webHost is overridden', () => {
-        const rows = extractXhsUserNotes({
-            noteGroups: [
-                [
-                    {
-                        xsecToken: 'tok',
-                        noteCard: {
-                            noteId: 'note-red',
-                            displayTitle: 'rednote note',
-                            user: { userId: 'user-red' },
-                        },
-                    },
-                ],
-            ],
-        }, 'fallback-user', 'www.rednote.com');
-        expect(rows[0]?.url).toBe('https://www.rednote.com/user/profile/user-red/note-red?xsec_token=tok&xsec_source=pc_user');
-    });
-});
-
-describe('assertReadableUserSnapshot', () => {
-    it('accepts an explicit empty notes array from a readable user store', () => {
-        expect(() => assertReadableUserSnapshot({
-            storePresent: true,
-            notesPresent: true,
-            pageDataPresent: false,
-            noteGroups: [],
-            pageData: {},
-        })).not.toThrow();
-    });
-    it('fails typed when the user store is missing instead of treating parser drift as empty', () => {
-        expect(() => assertReadableUserSnapshot({
-            storePresent: false,
-            notesPresent: false,
-            pageDataPresent: false,
-            noteGroups: [],
-            pageData: {},
-        })).toThrow(CommandExecutionError);
-    });
-    it('fails typed when profile metadata exists but the notes array is missing', () => {
-        expect(() => assertReadableUserSnapshot({
-            storePresent: true,
-            notesPresent: false,
-            pageDataPresent: true,
-            noteGroups: [],
-            pageData: { user: { nickname: 'Alice' } },
-        })).toThrow(CommandExecutionError);
-    });
-    it('fails typed when notesPresent metadata and cloned noteGroups disagree', () => {
-        expect(() => assertReadableUserSnapshot({
-            storePresent: true,
-            notesPresent: true,
-            pageDataPresent: false,
-            noteGroups: null,
-            pageData: {},
-        })).toThrow(CommandExecutionError);
-    });
-});

package/clis/xiaohongshu/user.js

@@ -1,140 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { extractXhsUserNotes, normalizeXhsUserId } from './user-helpers.js';
-/**
- * Host-agnostic IIFE that snapshots the user profile's Pinia store. Exported
- * so the rednote adapter can reuse it without copying the safeClone block.
- */
-export const USER_SNAPSHOT_JS = `
-    (() => {
-      const safeClone = (value) => {
-        try {
-          return JSON.parse(JSON.stringify(value ?? null));
-        } catch {
-          return null;
-        }
-      };
-
-      const userStore = window.__INITIAL_STATE__?.user;
-      const hasUserStore = Boolean(userStore && typeof userStore === 'object');
-      const rawNotes = hasUserStore ? (userStore.notes?._value || userStore.notes) : undefined;
-      const rawPageData = hasUserStore ? (userStore.userPageData?._value || userStore.userPageData) : undefined;
-      // 登录墙检测：小红书 profile 页比 search 更吃登录态，会话失效/被风控降级时访问
-      // /user/profile/<id> 会 302 到 /login（loggedIn=false）。用 indexOf 而非正则——
-      // 本块是嵌在模板字符串里的 JS，正则 \\b 会被模板解析成退格符。
-      const loggedInVal = hasUserStore ? (userStore.loggedIn?._value ?? userStore.loggedIn) : undefined;
-      const pathName = (typeof location !== 'undefined' && location.pathname) ? location.pathname : '';
-      const onLoginPage = pathName.indexOf('/login') === 0;
-      return {
-        noteGroups: safeClone(rawNotes || []),
-        pageData: safeClone(rawPageData || {}),
-        storePresent: hasUserStore,
-        notesPresent: Array.isArray(rawNotes),
-        pageDataPresent: Boolean(rawPageData && typeof rawPageData === 'object' && Object.keys(rawPageData).length > 0),
-        loginWall: Boolean(onLoginPage || loggedInVal === false),
-      };
-    })()
-  `;
-async function readUserSnapshot(page) {
-    return await page.evaluate(USER_SNAPSHOT_JS);
-}
-export function assertReadableUserSnapshot(snapshot) {
-    if (!snapshot || typeof snapshot !== 'object' || Array.isArray(snapshot)) {
-        throw new CommandExecutionError('Malformed Xiaohongshu user snapshot');
-    }
-    if (snapshot.storePresent !== true) {
-        throw new CommandExecutionError('Malformed Xiaohongshu user snapshot: user store was not found');
-    }
-    if (snapshot.notesPresent !== true || !Array.isArray(snapshot.noteGroups)) {
-        throw new CommandExecutionError('Malformed Xiaohongshu user snapshot: notes array was not found');
-    }
-}
-/** 展平 noteGroups 后的真实笔记条数。小红书 user store 的 notes 是 [tab[], tab[], ...]
- *  形态（每个 tab 一个数组），首屏笔记在其中某个 tab 里；这里数所有 tab 里的笔记总数。 */
-export function countFlatNotes(snapshot) {
-    const groups = snapshot?.noteGroups;
-    if (!Array.isArray(groups))
-        return 0;
-    let n = 0;
-    for (const g of groups)
-        n += Array.isArray(g) ? g.length : (g ? 1 : 0);
-    return n;
-}
-/** 页面是否被登录墙挡（302 到 /login，或 user store loggedIn=false）。 */
-export function isLoginWallSnapshot(snapshot) {
-    return Boolean(snapshot && typeof snapshot === 'object' && snapshot.loginWall === true);
-}
-function throwLoginWallAuthRequired() {
-    throw new AuthRequiredError('xiaohongshu.com', 'Xiaohongshu profile requires login (page redirected to /login or session expired); re-login to xiaohongshu.com and retry.');
-}
-/**
- * 读取 user 快照，带 hydration 等待 + 重试。修两个真实坑：
- *  1) 慢加载竞态：`__INITIAL_STATE__.user` 由 SSR/client bootstrap 异步注入，`page.goto` 后
- *     立刻 evaluate 会撞 hydration 窗口 → store/notes 尚未就绪。note.js / download.js 早用
- *     `page.wait` 规避，唯独 user.js 漏了 → 间歇性 "user store was not found"（2026-06-09 整批
- *     seed 全挂、2026-05-20 亦复现）。
- *  2) 笔记懒加载：`notes` 是 [tab[], ...] 形态，首屏笔记可能比 store 更晚填充。
- * 策略：先快读一次（页面已就绪则零额外延迟，保住快加载路径）；未拿到笔记**且非登录墙**就
- * `page.wait` 后重试至多 maxRetries 次。命中登录墙立即停（再等无用，交给 caller 抛 AUTH_REQUIRED）；
- * 真·空号（销号/私密/全删）走满重试后返回空快照，由下游 EmptyResultError 正确收尾。导出供测试。
- */
-export async function readUserSnapshotHydrated(page, maxRetries = 8, waitSeconds = 2) {
-    let snapshot = await readUserSnapshot(page);
-    for (let i = 0; i < maxRetries && !isLoginWallSnapshot(snapshot) && countFlatNotes(snapshot) === 0; i += 1) {
-        await page.wait({ time: waitSeconds });
-        snapshot = await readUserSnapshot(page);
-    }
-    return snapshot;
-}
-export const command = cli({
-    site: 'xiaohongshu',
-    name: 'user',
-    access: 'read',
-    description: 'Get public notes from a Xiaohongshu user profile',
-    domain: 'www.xiaohongshu.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: false,
-    args: [
-        { name: 'id', type: 'string', required: true, positional: true, help: 'User id or profile URL' },
-        { name: 'limit', type: 'int', default: 15, help: 'Number of notes to return' },
-    ],
-    columns: ['id', 'title', 'type', 'likes', 'url'],
-    func: async (page, kwargs) => {
-        const userId = normalizeXhsUserId(String(kwargs.id));
-        const limit = Math.max(1, Number(kwargs.limit ?? 15));
-        await page.goto(`https://www.xiaohongshu.com/user/profile/${userId}`);
-        let snapshot = await readUserSnapshotHydrated(page);
-        if (isLoginWallSnapshot(snapshot)) {
-            // profile 页登录态失效 → 302 到 /login。绝不能误报成 "Malformed user store" /
-            // EMPTY_RESULT —— 那会让下游（ml-scout 等）把登录失效当解析失败 / 空号，白等
-            // rate-limit cooldown（实测 2026-06-09：风控把 profile 浏览态降级 → 整批 seed
-            // 重定向到 /login）。抛 AUTH_REQUIRED，让 caller 提示用户重登 xiaohongshu.com。
-            throwLoginWallAuthRequired();
-        }
-        assertReadableUserSnapshot(snapshot);
-        let results = extractXhsUserNotes(snapshot ?? {}, userId);
-        let previousCount = results.length;
-        for (let i = 0; results.length < limit && i < 4; i += 1) {
-            await page.autoScroll({ times: 1, delayMs: 1500 });
-            await page.wait(1);
-            snapshot = await readUserSnapshot(page);
-            if (isLoginWallSnapshot(snapshot)) {
-                throwLoginWallAuthRequired();
-            }
-            assertReadableUserSnapshot(snapshot);
-            const nextResults = extractXhsUserNotes(snapshot ?? {}, userId);
-            if (nextResults.length <= previousCount)
-                break;
-            results = nextResults;
-            previousCount = nextResults.length;
-        }
-        if (results.length === 0) {
-            // 与 bilibili subtitle 同模式：作者无公开内容是合法 empty 数据条件
-            // （销号 / 私密号 / 全删笔记），不是 fetch 失败。下游应识别 code
-            // EMPTY_RESULT 跳过 rate-limit 启发式、不计入 softFail 阈值。
-            throw new EmptyResultError('xiaohongshu user', '该用户没有公开笔记（可能销号 / 私密 / 全部删除）。');
-        }
-        return results.slice(0, limit);
-    },
-});

package/clis/xiaohongshu/user.test.js

@@ -1,141 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './user.js';
-import { countFlatNotes, isLoginWallSnapshot, readUserSnapshotHydrated, assertReadableUserSnapshot, } from './user.js';
-
-// 构造各类 user 快照（与 USER_SNAPSHOT_JS 返回形状一致）。
-function snap(overrides = {}) {
-    return {
-        noteGroups: [],
-        pageData: {},
-        storePresent: true,
-        notesPresent: true,
-        pageDataPresent: true,
-        loginWall: false,
-        ...overrides,
-    };
-}
-// 一条可被 extractXhsUserNotes 解析的笔记，包在 tab 分组里：notes = [tab[], ...]。
-function noteEntry(id) {
-    return { noteCard: { noteId: id, displayTitle: 't-' + id, type: 'normal', interactInfo: { likedCount: 3 } } };
-}
-const NOTES_SNAP = snap({ noteGroups: [[noteEntry('aaa')], [], []] });
-const EMPTY_GROUPS_SNAP = snap({ noteGroups: [[], [], [], [], []] }); // store 在但笔记未填充
-const LOGIN_WALL_SNAP = snap({ noteGroups: [[], [], [], [], []], loginWall: true });
-const NO_STORE_SNAP = snap({ noteGroups: [], storePresent: false, notesPresent: false });
-
-function createPageMock(evaluateImpl) {
-    return {
-        goto: vi.fn().mockResolvedValue(undefined),
-        evaluate: evaluateImpl,
-        wait: vi.fn().mockResolvedValue(undefined),
-        autoScroll: vi.fn().mockResolvedValue(undefined),
-    };
-}
-
-describe('countFlatNotes', () => {
-    it('5 个空 tab 分组 → 0', () => {
-        expect(countFlatNotes(EMPTY_GROUPS_SNAP)).toBe(0);
-    });
-    it('嵌套数组求和', () => {
-        expect(countFlatNotes(snap({ noteGroups: [[noteEntry('a'), noteEntry('b')], [noteEntry('c')]] }))).toBe(3);
-    });
-    it('非数组 / 缺字段 → 0', () => {
-        expect(countFlatNotes({ noteGroups: null })).toBe(0);
-        expect(countFlatNotes(null)).toBe(0);
-    });
-});
-
-describe('isLoginWallSnapshot', () => {
-    it('loginWall=true → true', () => {
-        expect(isLoginWallSnapshot(LOGIN_WALL_SNAP)).toBe(true);
-    });
-    it('loginWall=false / 缺失 → false', () => {
-        expect(isLoginWallSnapshot(NOTES_SNAP)).toBe(false);
-        expect(isLoginWallSnapshot(snap({ loginWall: undefined }))).toBe(false);
-        expect(isLoginWallSnapshot(null)).toBe(false);
-    });
-});
-
-describe('readUserSnapshotHydrated', () => {
-    it('快路径：首读即有笔记 → 不 wait、不重试', async () => {
-        const page = createPageMock(vi.fn().mockResolvedValue(NOTES_SNAP));
-        const out = await readUserSnapshotHydrated(page);
-        expect(out).toBe(NOTES_SNAP);
-        expect(page.evaluate).toHaveBeenCalledTimes(1);
-        expect(page.wait).not.toHaveBeenCalled();
-    });
-    it('慢加载：store/notes 晚到 → 重试直到笔记出现（回归 2026-06-09 hydration 竞态）', async () => {
-        const page = createPageMock(vi
-            .fn()
-            .mockResolvedValueOnce(NO_STORE_SNAP) // goto 后立刻读：store 还没 hydrate
-            .mockResolvedValueOnce(EMPTY_GROUPS_SNAP) // store 在了但 notes 空
-            .mockResolvedValue(NOTES_SNAP)); // 笔记终于填充
-        const out = await readUserSnapshotHydrated(page);
-        expect(countFlatNotes(out)).toBe(1);
-        expect(page.wait).toHaveBeenCalled(); // 确实等过
-    });
-    it('登录墙：命中即停，不浪费重试预算', async () => {
-        const page = createPageMock(vi.fn().mockResolvedValue(LOGIN_WALL_SNAP));
-        const out = await readUserSnapshotHydrated(page);
-        expect(isLoginWallSnapshot(out)).toBe(true);
-        expect(page.evaluate).toHaveBeenCalledTimes(1); // 没进重试循环
-        expect(page.wait).not.toHaveBeenCalled();
-    });
-    it('真·空号：走满重试后返回空快照（交给下游 EmptyResultError）', async () => {
-        const page = createPageMock(vi.fn().mockResolvedValue(EMPTY_GROUPS_SNAP));
-        const out = await readUserSnapshotHydrated(page, 3, 0.01);
-        expect(countFlatNotes(out)).toBe(0);
-        expect(isLoginWallSnapshot(out)).toBe(false);
-        expect(page.wait).toHaveBeenCalledTimes(3); // maxRetries 次
-    });
-});
-
-describe('xiaohongshu user command', () => {
-    const command = getRegistry().get('xiaohongshu/user');
-
-    it('登录墙 → 抛 AUTH_REQUIRED（不再误报 Malformed/EMPTY）', async () => {
-        const page = createPageMock(vi.fn().mockResolvedValue(LOGIN_WALL_SNAP));
-        await expect(command.func(page, { id: '56d290df84edcd782a3c8748', limit: 5 })).rejects.toMatchObject({
-            code: 'AUTH_REQUIRED',
-        });
-    });
-
-    it('笔记晚到 → 重试后成功返回（端到端回归）', async () => {
-        const page = createPageMock(vi
-            .fn()
-            .mockResolvedValueOnce(NO_STORE_SNAP)
-            .mockResolvedValueOnce(EMPTY_GROUPS_SNAP)
-            .mockResolvedValue(NOTES_SNAP));
-        const rows = await command.func(page, { id: 'someuser', limit: 5 });
-        expect(rows).toHaveLength(1);
-        expect(rows[0].id).toBe('aaa');
-    });
-
-    it('滚动续读时被重定向到登录墙 → 抛 AUTH_REQUIRED', async () => {
-        const page = createPageMock(vi
-            .fn()
-            .mockResolvedValueOnce(snap({ noteGroups: [[noteEntry('aaa')]] }))
-            .mockResolvedValueOnce(LOGIN_WALL_SNAP));
-        await expect(command.func(page, { id: 'someuser', limit: 5 })).rejects.toMatchObject({
-            code: 'AUTH_REQUIRED',
-        });
-        expect(page.autoScroll).toHaveBeenCalledTimes(1);
-    });
-
-    it('真·空号 → 抛 EMPTY_RESULT', async () => {
-        const page = createPageMock(vi.fn().mockResolvedValue(EMPTY_GROUPS_SNAP));
-        await expect(command.func(page, { id: 'emptyuser', limit: 5 })).rejects.toMatchObject({
-            code: 'EMPTY_RESULT',
-        });
-    });
-});
-
-describe('assertReadableUserSnapshot (既有契约保持)', () => {
-    it('storePresent=false → Malformed: user store was not found', () => {
-        expect(() => assertReadableUserSnapshot(NO_STORE_SNAP)).toThrow(/user store was not found/);
-    });
-    it('正常快照不抛', () => {
-        expect(() => assertReadableUserSnapshot(NOTES_SNAP)).not.toThrow();
-    });
-});