@jackwener/opencli 1.7.11 → 1.7.12

package/clis/jike/user.js

@@ -2,6 +2,7 @@ import { cli } from '@jackwener/opencli/registry';
 cli({
     site: 'jike',
     name: 'user',
+    access: 'read',
     description: '即刻用户动态',
     domain: 'm.okjike.com',
     browser: true,
@@ -15,7 +16,7 @@ cli({
         },
         { name: 'limit', type: 'int', default: 20, help: 'Number of posts' },
     ],
-    columns: ['content', 'type', 'likes', 'comments', 'time', 'url'],
+    columns: ['id', 'content', 'type', 'likes', 'comments', 'time', 'url'],
     pipeline: [
         { navigate: 'https://m.okjike.com/users/${{ args.username }}' },
         { evaluate: `(() => {
@@ -38,6 +39,7 @@ cli({
 })()
 ` },
         { map: {
+                id: '${{ item.id }}',
                 content: '${{ item.content }}',
                 type: '${{ item.type }}',
                 likes: '${{ item.likes }}',

package/clis/jimeng/generate.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'jimeng',
     name: 'generate',
+    access: 'write',
     description: '即梦AI 文生图 — 输入 prompt 生成图片',
     domain: 'jimeng.jianying.com',
     strategy: Strategy.COOKIE,

package/clis/jimeng/history.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'jimeng',
     name: 'history',
+    access: 'read',
     description: '即梦AI 查看最近生成的作品',
     domain: 'jimeng.jianying.com',
     strategy: Strategy.COOKIE,

package/clis/jimeng/new.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'jimeng',
     name: 'new',
+    access: 'write',
     description: '即梦AI 新建会话（workspace）',
     domain: 'jimeng.jianying.com',
     strategy: Strategy.COOKIE,

package/clis/jimeng/workspaces.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'jimeng',
     name: 'workspaces',
+    access: 'read',
     description: '即梦AI 查看所有工作区（会话窗口）',
     domain: 'jimeng.jianying.com',
     strategy: Strategy.COOKIE,

package/clis/ke/chengjiao.js

@@ -4,6 +4,7 @@ import { cityUrl, gotoKe } from './utils.js';
 cli({
     site: 'ke',
     name: 'chengjiao',
+    access: 'read',
     description: '贝壳找房成交记录',
     domain: 'ke.com',
     strategy: Strategy.COOKIE,

package/clis/ke/ershoufang.js

@@ -4,6 +4,7 @@ import { cityUrl, gotoKe } from './utils.js';
 cli({
     site: 'ke',
     name: 'ershoufang',
+    access: 'read',
     description: '贝壳找房二手房列表',
     domain: 'ke.com',
     strategy: Strategy.COOKIE,

package/clis/ke/xiaoqu.js

@@ -4,6 +4,7 @@ import { cityUrl, gotoKe } from './utils.js';
 cli({
     site: 'ke',
     name: 'xiaoqu',
+    access: 'read',
     description: '贝壳找房小区列表',
     domain: 'ke.com',
     strategy: Strategy.COOKIE,

package/clis/ke/zufang.js

@@ -4,6 +4,7 @@ import { gotoKe } from './utils.js';
 cli({
     site: 'ke',
     name: 'zufang',
+    access: 'read',
     description: '贝壳找房租房列表',
     domain: 'ke.com',
     strategy: Strategy.COOKIE,

package/clis/lesswrong/comments.js

@@ -4,6 +4,7 @@ import { DOMAIN, SITE, gqlEscape, gqlRequest, parsePostId, stripHtml, } from './
 cli({
     site: SITE,
     name: 'comments',
+    access: 'read',
     description: 'Top comments on a post',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/curated.js

@@ -3,6 +3,7 @@ import { DOMAIN, SITE, gqlRequest } from './_helpers.js';
 cli({
     site: SITE,
     name: 'curated',
+    access: 'read',
     description: "Curated editor's picks",
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/frontpage.js

@@ -3,6 +3,7 @@ import { DOMAIN, SITE, gqlRequest } from './_helpers.js';
 cli({
     site: SITE,
     name: 'frontpage',
+    access: 'read',
     description: 'Algorithmic frontpage',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/new.js

@@ -3,6 +3,7 @@ import { DOMAIN, SITE, gqlRequest } from './_helpers.js';
 cli({
     site: SITE,
     name: 'new',
+    access: 'read',
     description: 'Latest posts',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/read.js

@@ -4,6 +4,7 @@ import { DOMAIN, SITE, gqlEscape, gqlRequest, parsePostId, stripHtml, } from './
 cli({
     site: SITE,
     name: 'read',
+    access: 'read',
     description: 'Read full post by URL or ID',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/sequences.js

@@ -3,6 +3,7 @@ import { DOMAIN, SITE, gqlRequest } from './_helpers.js';
 cli({
     site: SITE,
     name: 'sequences',
+    access: 'read',
     description: 'List post collections',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/shortform.js

@@ -3,6 +3,7 @@ import { DOMAIN, SITE, gqlRequest } from './_helpers.js';
 cli({
     site: SITE,
     name: 'shortform',
+    access: 'read',
     description: 'Quick takes / shortform posts',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/tag.js

@@ -4,6 +4,7 @@ import { DOMAIN, SITE, gqlRequest, resolveTagId } from './_helpers.js';
 cli({
     site: SITE,
     name: 'tag',
+    access: 'read',
     description: 'Posts by tag',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/tags.js

@@ -3,6 +3,7 @@ import { DOMAIN, SITE, gqlRequest } from './_helpers.js';
 cli({
     site: SITE,
     name: 'tags',
+    access: 'read',
     description: 'List popular tags',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/top-month.js

@@ -3,6 +3,7 @@ import { DOMAIN, SITE, daysAgo, gqlRequest } from './_helpers.js';
 cli({
     site: SITE,
     name: 'top-month',
+    access: 'read',
     description: 'Top this month',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/top-week.js

@@ -3,6 +3,7 @@ import { DOMAIN, SITE, daysAgo, gqlRequest } from './_helpers.js';
 cli({
     site: SITE,
     name: 'top-week',
+    access: 'read',
     description: 'Top this week',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/top-year.js

@@ -3,6 +3,7 @@ import { DOMAIN, SITE, daysAgo, gqlRequest } from './_helpers.js';
 cli({
     site: SITE,
     name: 'top-year',
+    access: 'read',
     description: 'Top this year',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/top.js

@@ -3,6 +3,7 @@ import { DOMAIN, SITE, gqlRequest } from './_helpers.js';
 cli({
     site: SITE,
     name: 'top',
+    access: 'read',
     description: 'Top all-time',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/user-posts.js

@@ -3,6 +3,7 @@ import { DOMAIN, SITE, gqlEscape, gqlRequest, resolveUserId } from './_helpers.j
 cli({
     site: SITE,
     name: 'user-posts',
+    access: 'read',
     description: "List a user's posts",
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/lesswrong/user.js

@@ -4,6 +4,7 @@ import { DOMAIN, SITE, gqlEscape, gqlRequest, stripHtml } from './_helpers.js';
 cli({
     site: SITE,
     name: 'user',
+    access: 'read',
     description: 'User profile',
     domain: DOMAIN,
     strategy: Strategy.PUBLIC,

package/clis/linkedin/search.js

@@ -317,6 +317,7 @@ async function enrichJobDetails(page, jobs) {
 cli({
     site: 'linkedin',
     name: 'search',
+    access: 'read',
     description: 'Search LinkedIn jobs',
     domain: 'www.linkedin.com',
     strategy: Strategy.HEADER,

package/clis/linkedin/timeline.js

@@ -460,6 +460,7 @@ async function extractVisiblePosts(page) {
 cli({
     site: 'linkedin',
     name: 'timeline',
+    access: 'read',
     description: 'Read LinkedIn home timeline posts',
     domain: 'www.linkedin.com',
     strategy: Strategy.COOKIE,

package/clis/linux-do/categories.js

@@ -3,6 +3,7 @@ import { fetchLinuxDoJson } from './feed.js';
 cli({
     site: 'linux-do',
     name: 'categories',
+    access: 'read',
     description: 'linux.do 分类列表',
     domain: 'linux.do',
     strategy: Strategy.COOKIE,

package/clis/linux-do/category.js

@@ -3,6 +3,7 @@ import { buildLinuxDoCompatFooter, executeLinuxDoFeed } from './feed.js';
 cli({
     site: 'linux-do',
     name: 'category',
+    access: 'read',
     description: 'linux.do 分类内话题',
     domain: 'linux.do',
     strategy: Strategy.COOKIE,

package/clis/linux-do/feed.js

@@ -368,6 +368,7 @@ export function buildLinuxDoCompatFooter(replacement) {
 cli({
     site: 'linux-do',
     name: 'feed',
+    access: 'read',
     description: 'linux.do 话题列表（需登录；支持全站、标签、分类）',
     domain: 'linux.do',
     strategy: Strategy.COOKIE,

package/clis/linux-do/hot.js

@@ -3,6 +3,7 @@ import { buildLinuxDoCompatFooter, executeLinuxDoFeed } from './feed.js';
 cli({
     site: 'linux-do',
     name: 'hot',
+    access: 'read',
     description: 'linux.do 热门话题',
     domain: 'linux.do',
     strategy: Strategy.COOKIE,

package/clis/linux-do/latest.js

@@ -3,6 +3,7 @@ import { buildLinuxDoCompatFooter, executeLinuxDoFeed } from './feed.js';
 cli({
     site: 'linux-do',
     name: 'latest',
+    access: 'read',
     description: 'linux.do 最新话题',
     domain: 'linux.do',
     strategy: Strategy.COOKIE,

package/clis/linux-do/search.js

@@ -3,6 +3,7 @@ import { fetchLinuxDoJson } from './feed.js';
 cli({
     site: 'linux-do',
     name: 'search',
+    access: 'read',
     description: '搜索 linux.do',
     domain: 'linux.do',
     strategy: Strategy.COOKIE,

package/clis/linux-do/tags.js

@@ -3,6 +3,7 @@ import { fetchLinuxDoJson } from './feed.js';
 cli({
     site: 'linux-do',
     name: 'tags',
+    access: 'read',
     description: 'linux.do 标签列表',
     domain: 'linux.do',
     strategy: Strategy.COOKIE,
@@ -10,7 +11,7 @@ cli({
     args: [
         { name: 'limit', type: 'int', default: 30, help: 'Number of tags' },
     ],
-    columns: ['rank', 'name', 'count', 'url'],
+    columns: ['rank', 'name', 'slug', 'count', 'url'],
     func: async (page, kwargs) => {
         const data = await fetchLinuxDoJson(page, '/tags.json');
         const tags = (data?.tags || []);

package/clis/linux-do/topic-content.js

@@ -128,6 +128,7 @@ async function fetchTopicPayload(page, id) {
 cli({
     site: 'linux-do',
     name: 'topic-content',
+    access: 'read',
     description: 'Get the main topic body as Markdown',
     domain: LINUX_DO_DOMAIN,
     strategy: Strategy.COOKIE,

package/clis/linux-do/topic.js

@@ -30,6 +30,7 @@ function strip(html) {
 cli({
     site: 'linux-do',
     name: 'topic',
+    access: 'read',
     description: 'linux.do 帖子首页摘要和回复（首屏）',
     domain: 'linux.do',
     strategy: Strategy.COOKIE,

package/clis/linux-do/user-posts.js

@@ -30,6 +30,7 @@ function strip(html) {
 cli({
     site: 'linux-do',
     name: 'user-posts',
+    access: 'read',
     description: 'linux.do 用户的帖子',
     domain: 'linux.do',
     strategy: Strategy.COOKIE,

package/clis/linux-do/user-topics.js

@@ -9,6 +9,7 @@ function toLocalTime(utcStr) {
 cli({
     site: 'linux-do',
     name: 'user-topics',
+    access: 'read',
     description: 'linux.do 用户创建的话题',
     domain: 'linux.do',
     strategy: Strategy.COOKIE,

package/clis/lobsters/active.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'lobsters',
     name: 'active',
+    access: 'read',
     description: 'Lobste.rs most active discussions',
     domain: 'lobste.rs',
     strategy: Strategy.PUBLIC,
@@ -9,15 +10,17 @@ cli({
     args: [
         { name: 'limit', type: 'int', default: 20, help: 'Number of stories' },
     ],
-    columns: ['rank', 'title', 'score', 'author', 'comments', 'tags'],
+    columns: ['rank', 'id', 'title', 'score', 'author', 'comments', 'created_at', 'tags', 'url'],
     pipeline: [
         { fetch: { url: 'https://lobste.rs/active.json' } },
         { map: {
                 rank: '${{ index + 1 }}',
+                id: '${{ item.short_id }}',
                 title: '${{ item.title }}',
                 score: '${{ item.score }}',
                 author: '${{ item.submitter_user }}',
                 comments: '${{ item.comment_count }}',
+                created_at: '${{ item.created_at }}',
                 tags: `\${{ item.tags | join(', ') }}`,
                 url: '${{ item.comments_url }}',
             } },

package/clis/lobsters/hot.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'lobsters',
     name: 'hot',
+    access: 'read',
     description: 'Lobste.rs hottest stories',
     domain: 'lobste.rs',
     strategy: Strategy.PUBLIC,
@@ -9,15 +10,17 @@ cli({
     args: [
         { name: 'limit', type: 'int', default: 20, help: 'Number of stories' },
     ],
-    columns: ['rank', 'title', 'score', 'author', 'comments', 'tags'],
+    columns: ['rank', 'id', 'title', 'score', 'author', 'comments', 'created_at', 'tags', 'url'],
     pipeline: [
         { fetch: { url: 'https://lobste.rs/hottest.json' } },
         { map: {
                 rank: '${{ index + 1 }}',
+                id: '${{ item.short_id }}',
                 title: '${{ item.title }}',
                 score: '${{ item.score }}',
                 author: '${{ item.submitter_user }}',
                 comments: '${{ item.comment_count }}',
+                created_at: '${{ item.created_at }}',
                 tags: `\${{ item.tags | join(', ') }}`,
                 url: '${{ item.comments_url }}',
             } },

package/clis/lobsters/lobsters.test.js

@@ -0,0 +1,169 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '@jackwener/opencli/registry';
+import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+import './hot.js';
+import './active.js';
+import './newest.js';
+import './tag.js';
+import './read.js';
+
+afterEach(() => {
+    vi.unstubAllGlobals();
+    vi.restoreAllMocks();
+});
+
+describe('lobsters listing adapters expose short_id and created_at', () => {
+    const listings = ['lobsters/hot', 'lobsters/active', 'lobsters/newest', 'lobsters/tag'];
+
+    listings.forEach((key) => {
+        it(`${key} surfaces id (short_id) and created_at on every row`, () => {
+            const cmd = getRegistry().get(key);
+            expect(cmd?.columns).toEqual(['rank', 'id', 'title', 'score', 'author', 'comments', 'created_at', 'tags', 'url']);
+            const mapStep = cmd?.pipeline?.find((step) => step.map);
+            expect(mapStep?.map).toMatchObject({
+                id: '${{ item.short_id }}',
+                created_at: '${{ item.created_at }}',
+                url: '${{ item.comments_url }}',
+            });
+        });
+    });
+});
+
+describe('lobsters/read adapter', () => {
+    const cmd = getRegistry().get('lobsters/read');
+
+    it('registers the comment-thread shape (type/author/score/text)', () => {
+        expect(cmd?.columns).toEqual(['type', 'author', 'score', 'text']);
+    });
+
+    it('takes a positional short_id plus tunable depth/limit/replies/max-length args', () => {
+        const argNames = (cmd?.args || []).map((a) => a.name);
+        expect(argNames).toEqual(['id', 'limit', 'depth', 'replies', 'max-length']);
+        const idArg = cmd?.args?.find((a) => a.name === 'id');
+        expect(idArg?.required).toBe(true);
+        expect(idArg?.positional).toBe(true);
+    });
+
+    it('uses the public lobste.rs JSON endpoint (no browser, public strategy)', () => {
+        expect(cmd?.browser).toBe(false);
+        expect(cmd?.strategy).toBe('public');
+    });
+
+    it('fails fast with ArgumentError for non-alphanumeric short_id before fetching', async () => {
+        const fetchMock = vi.fn();
+        vi.stubGlobal('fetch', fetchMock);
+
+        await expect(cmd.func({ id: 'BAD!ID', limit: 5, depth: 2, replies: 5, 'max-length': 2000 }))
+            .rejects.toThrow(ArgumentError);
+        expect(fetchMock).not.toHaveBeenCalled();
+    });
+
+    it('fails fast with EmptyResultError on 404', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response('Not found', { status: 404 })));
+
+        await expect(cmd.func({ id: 'missing', limit: 5, depth: 2, replies: 5, 'max-length': 2000 }))
+            .rejects.toThrow(EmptyResultError);
+    });
+
+    it('fails fast with ArgumentError when max-length is below the minimum before fetching', async () => {
+        const fetchMock = vi.fn();
+        vi.stubGlobal('fetch', fetchMock);
+
+        await expect(cmd.func({ id: 'abc123', limit: 5, depth: 2, replies: 5, 'max-length': 99 }))
+            .rejects.toThrow(ArgumentError);
+        expect(fetchMock).not.toHaveBeenCalled();
+    });
+
+    it('fails fast with CommandExecutionError on non-404 HTTP failures', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response('oops', { status: 503 })));
+
+        await expect(cmd.func({ id: 'abc123', limit: 5, depth: 2, replies: 5, 'max-length': 2000 }))
+            .rejects.toThrow(CommandExecutionError);
+    });
+
+    it('builds a threaded tree from the flat comments[] using parent_comment', async () => {
+        const story = {
+            short_id: 'abc123',
+            title: 'Hello world',
+            url: 'https://example.com/post',
+            score: 42,
+            submitter_user: 'pg',
+            description_plain: 'Some intro text.',
+            comments_url: 'https://lobste.rs/s/abc123/hello_world',
+            comments: [
+                {
+                    short_id: 'top1',
+                    parent_comment: null,
+                    score: 5,
+                    commenting_user: 'alice',
+                    comment_plain: 'Top one',
+                    is_deleted: false,
+                },
+                {
+                    short_id: 'reply1',
+                    parent_comment: 'top1',
+                    score: 3,
+                    commenting_user: 'bob',
+                    comment_plain: 'A reply',
+                    is_deleted: false,
+                },
+                {
+                    short_id: 'reply2',
+                    parent_comment: 'top1',
+                    score: 1,
+                    commenting_user: 'carol',
+                    comment_plain: 'Another reply',
+                    is_deleted: false,
+                },
+                {
+                    short_id: 'top2',
+                    parent_comment: null,
+                    score: 4,
+                    commenting_user: 'dave',
+                    comment_plain: 'Top two',
+                    is_deleted: false,
+                },
+            ],
+        };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response(JSON.stringify(story), { status: 200 })));
+
+        const rows = await cmd.func({ id: 'abc123', limit: 5, depth: 2, replies: 5, 'max-length': 2000 });
+
+        expect(rows).toEqual([
+            {
+                type: 'POST',
+                author: 'pg',
+                score: 42,
+                text: 'Hello world\nSome intro text.\nhttps://example.com/post',
+            },
+            { type: 'L0', author: 'alice', score: 5, text: 'Top one' },
+            { type: 'L1', author: 'bob', score: 3, text: '  > A reply' },
+            { type: 'L1', author: 'carol', score: 1, text: '  > Another reply' },
+            { type: 'L0', author: 'dave', score: 4, text: 'Top two' },
+        ]);
+    });
+
+    it('emits a "+N more replies" stub when depth cutoff hides children', async () => {
+        const story = {
+            short_id: 'abc123',
+            title: 'Hi',
+            url: '',
+            score: 1,
+            submitter_user: 'u',
+            description_plain: '',
+            comments: [
+                { short_id: 't1', parent_comment: null, commenting_user: 'a', comment_plain: 'top', is_deleted: false },
+                { short_id: 'r1', parent_comment: 't1', commenting_user: 'b', comment_plain: 'r', is_deleted: false },
+            ],
+        };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response(JSON.stringify(story), { status: 200 })));
+
+        const rows = await cmd.func({ id: 'abc123', limit: 5, depth: 1, replies: 5, 'max-length': 2000 });
+
+        expect(rows).toEqual([
+            { type: 'POST', author: 'u', score: 1, text: 'Hi' },
+            { type: 'L0', author: 'a', score: '', text: 'top' },
+            { type: 'L1', author: '', score: '', text: '  [+1 more replies]' },
+        ]);
+    });
+});

package/clis/lobsters/newest.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'lobsters',
     name: 'newest',
+    access: 'read',
     description: 'Lobste.rs newest stories',
     domain: 'lobste.rs',
     strategy: Strategy.PUBLIC,
@@ -9,15 +10,17 @@ cli({
     args: [
         { name: 'limit', type: 'int', default: 20, help: 'Number of stories' },
     ],
-    columns: ['rank', 'title', 'score', 'author', 'comments', 'tags'],
+    columns: ['rank', 'id', 'title', 'score', 'author', 'comments', 'created_at', 'tags', 'url'],
     pipeline: [
         { fetch: { url: 'https://lobste.rs/newest.json' } },
         { map: {
                 rank: '${{ index + 1 }}',
+                id: '${{ item.short_id }}',
                 title: '${{ item.title }}',
                 score: '${{ item.score }}',
                 author: '${{ item.submitter_user }}',
                 comments: '${{ item.comment_count }}',
+                created_at: '${{ item.created_at }}',
                 tags: `\${{ item.tags | join(', ') }}`,
                 url: '${{ item.comments_url }}',
             } },