@jackwener/opencli 1.7.12 → 1.7.14

package/clis/goproxy/goproxy.test.js

@@ -0,0 +1,103 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '@jackwener/opencli/registry';
+import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+import './module.js';
+import './versions.js';
+
+afterEach(() => {
+    vi.unstubAllGlobals();
+    vi.restoreAllMocks();
+});
+
+describe('goproxy module adapter', () => {
+    const cmd = getRegistry().get('goproxy/module');
+
+    it('rejects malformed module path before fetching', async () => {
+        const fetchMock = vi.fn();
+        vi.stubGlobal('fetch', fetchMock);
+
+        await expect(cmd.func({ module: '' })).rejects.toThrow(ArgumentError);
+        await expect(cmd.func({ module: 'noslash' })).rejects.toThrow(ArgumentError);
+        await expect(cmd.func({ module: 'has spaces/foo' })).rejects.toThrow(ArgumentError);
+        expect(fetchMock).not.toHaveBeenCalled();
+    });
+
+    it('maps HTTP 410 (gone, e.g. retracted) to EmptyResultError', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response('gone', { status: 410 })));
+        await expect(cmd.func({ module: 'github.com/foo/bar' })).rejects.toThrow(EmptyResultError);
+    });
+
+    it('maps HTTP 429 to CommandExecutionError', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response('rate limited', { status: 429 })));
+        await expect(cmd.func({ module: 'github.com/foo/bar' })).rejects.toThrow(CommandExecutionError);
+    });
+
+    it('returns latest version with origin metadata', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response(JSON.stringify({
+            Version: 'v1.12.0',
+            Time: '2026-02-28T10:10:09Z',
+            Origin: { VCS: 'git', URL: 'https://github.com/gin-gonic/gin', Hash: 'abc123', Ref: 'refs/tags/v1.12.0' },
+        }), { status: 200 })));
+
+        const rows = await cmd.func({ module: 'github.com/gin-gonic/gin' });
+        expect(rows).toEqual([expect.objectContaining({
+            module: 'github.com/gin-gonic/gin',
+            version: 'v1.12.0',
+            publishedAt: '2026-02-28T10:10:09Z',
+            vcs: 'git',
+            commit: 'abc123',
+        })]);
+    });
+});
+
+describe('goproxy versions adapter', () => {
+    const cmd = getRegistry().get('goproxy/versions');
+
+    it('rejects bad limit before fetching', async () => {
+        const fetchMock = vi.fn();
+        vi.stubGlobal('fetch', fetchMock);
+
+        await expect(cmd.func({ module: 'github.com/foo/bar', limit: 0 })).rejects.toThrow(ArgumentError);
+        await expect(cmd.func({ module: 'github.com/foo/bar', limit: 500 })).rejects.toThrow(ArgumentError);
+        expect(fetchMock).not.toHaveBeenCalled();
+    });
+
+    it('throws EmptyResultError when @v/list is empty', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response('', { status: 200 })));
+        await expect(cmd.func({ module: 'github.com/foo/bar', limit: 5 }))
+            .rejects.toThrow(EmptyResultError);
+    });
+
+    it('sorts version tags semver-descending and round-trips module path', async () => {
+        // Note: this list is intentionally unsorted in calendar order.
+        const list = [
+            'v1.9.0', 'v1.10.0', 'v1.2.0', 'v1.10.1', 'v0.0.1', 'v2.0.0',
+            'v2.0.0-rc.2', 'v2.0.0-rc.10',
+        ].join('\n');
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response(list, { status: 200 })));
+
+        const rows = await cmd.func({ module: 'github.com/foo/bar', limit: 10 });
+        expect(rows.map((r) => r.version)).toEqual([
+            'v2.0.0', 'v2.0.0-rc.10', 'v2.0.0-rc.2',
+            'v1.10.1', 'v1.10.0', 'v1.9.0', 'v1.2.0', 'v0.0.1',
+        ]);
+        // module column round-trips to goproxy module <module>
+        expect(rows[0]).toMatchObject({ rank: 1, module: 'github.com/foo/bar', publishedAt: null });
+    });
+
+    it('fetches publish times only when --with-time is set', async () => {
+        const fetchMock = vi.fn()
+            .mockResolvedValueOnce(new Response('v1.0.0\nv0.9.0', { status: 200 }))
+            .mockResolvedValueOnce(new Response(JSON.stringify({ Time: '2024-01-02T03:04:05Z' }), { status: 200 }))
+            .mockResolvedValueOnce(new Response(JSON.stringify({ Time: '2023-12-31T01:02:03Z' }), { status: 200 }));
+        vi.stubGlobal('fetch', fetchMock);
+
+        const rows = await cmd.func({ module: 'github.com/foo/bar', limit: 2, 'with-time': true });
+
+        expect(fetchMock).toHaveBeenCalledTimes(3);
+        expect(rows.map((r) => [r.version, r.publishedAt])).toEqual([
+            ['v1.0.0', '2024-01-02T03:04:05Z'],
+            ['v0.9.0', '2023-12-31T01:02:03Z'],
+        ]);
+    });
+});

package/clis/goproxy/module.js

@@ -0,0 +1,47 @@
+// goproxy module — latest version + origin metadata for one Go module.
+//
+// Hits `https://proxy.golang.org/<module>/@latest`, returning the canonical
+// version, publish time, and the upstream VCS / commit / tag the proxy resolved.
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { EmptyResultError } from '@jackwener/opencli/errors';
+import { GOPROXY_BASE, goproxyJson, requireModulePath, trimDate } from './utils.js';
+
+cli({
+    site: 'goproxy',
+    name: 'module',
+    access: 'read',
+    description: 'Latest version + VCS origin metadata for a Go module on proxy.golang.org',
+    domain: 'proxy.golang.org',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'module', positional: true, type: 'string', required: true, help: 'Go module path (e.g. "github.com/gin-gonic/gin", "golang.org/x/net")' },
+    ],
+    columns: [
+        'module', 'version', 'publishedAt', 'vcs', 'repository',
+        'commit', 'ref', 'pkgGoDevUrl', 'url',
+    ],
+    func: async (args) => {
+        const modulePath = requireModulePath(args.module);
+        // GOPROXY spec requires lowercase percent-encoding for capital letters in the
+        // module path (e.g. github.com/Foo/Bar -> github.com/!foo/!bar). Module paths
+        // we accept here are lowercase-only by convention; we still encode each segment.
+        const encoded = modulePath.split('/').map(encodeURIComponent).join('/');
+        const detail = await goproxyJson(`${GOPROXY_BASE}/${encoded}/@latest`, `goproxy module ${modulePath}`);
+        if (!detail || !detail.Version) {
+            throw new EmptyResultError('goproxy module', `proxy.golang.org returned no @latest entry for "${modulePath}".`);
+        }
+        const origin = detail.Origin && typeof detail.Origin === 'object' ? detail.Origin : {};
+        return [{
+            module: modulePath,
+            version: String(detail.Version),
+            publishedAt: trimDate(detail.Time),
+            vcs: String(origin.VCS ?? '').trim(),
+            repository: String(origin.URL ?? '').trim(),
+            commit: String(origin.Hash ?? '').trim(),
+            ref: String(origin.Ref ?? '').trim(),
+            pkgGoDevUrl: `https://pkg.go.dev/${modulePath}`,
+            url: `${GOPROXY_BASE}/${encoded}/@latest`,
+        }];
+    },
+});

package/clis/goproxy/utils.js

@@ -0,0 +1,165 @@
+// Shared helpers for the Go module proxy adapters.
+//
+// proxy.golang.org is the canonical Go module proxy. It is unauthenticated
+// and serves the GOPROXY protocol (`@latest`, `@v/list`, `@v/<ver>.info|mod|zip`).
+// Spec: https://go.dev/ref/mod#goproxy-protocol
+import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+
+export const GOPROXY_BASE = 'https://proxy.golang.org';
+const UA = 'opencli-goproxy-adapter (+https://github.com/jackwener/opencli)';
+
+// Module paths look like host/path/...; conservative shape: at least one slash,
+// host segment is alnum + dots, path segments are alnum + dashes/dots/underscores/slashes.
+// We enforce at most 200 chars and reject characters that would need URL-escaping.
+const MODULE_PATH = /^[A-Za-z0-9][A-Za-z0-9._\/-]{0,199}$/;
+
+// Go semver tags include "v" prefix; we accept the GOPROXY canonical form.
+const VERSION_TAG = /^v[0-9]+(\.[0-9]+)*([-+][A-Za-z0-9._-]+)?$/;
+
+export function requireModulePath(value) {
+    const s = String(value ?? '').trim();
+    if (!s) {
+        throw new ArgumentError(
+            'goproxy module path is required (e.g. "github.com/gin-gonic/gin", "golang.org/x/net")',
+            'Use the canonical module path that appears in `go.mod`.',
+        );
+    }
+    if (!MODULE_PATH.test(s) || !s.includes('/')) {
+        throw new ArgumentError(
+            `goproxy module path "${value}" is not a recognised Go module path`,
+            'Module paths look like "github.com/<org>/<repo>" or "golang.org/x/<name>".',
+        );
+    }
+    return s;
+}
+
+export function requireVersionTag(value) {
+    const s = String(value ?? '').trim();
+    if (!s) throw new ArgumentError('goproxy --version cannot be empty');
+    if (!VERSION_TAG.test(s)) {
+        throw new ArgumentError(
+            `goproxy --version "${value}" is not a valid Go semver tag`,
+            'Use the GOPROXY canonical form like "v1.2.3" or "v0.0.0-20240101010101-abcdef012345".',
+        );
+    }
+    return s;
+}
+
+export function requireBoundedInt(value, defaultValue, maxValue, label = 'limit') {
+    const raw = value ?? defaultValue;
+    const n = typeof raw === 'number' ? raw : Number(raw);
+    if (!Number.isInteger(n) || n <= 0) {
+        throw new ArgumentError(`goproxy ${label} must be a positive integer`);
+    }
+    if (n > maxValue) {
+        throw new ArgumentError(`goproxy ${label} must be <= ${maxValue}`);
+    }
+    return n;
+}
+
+async function rawFetch(url, label) {
+    let resp;
+    try {
+        resp = await fetch(url, { headers: { 'user-agent': UA } });
+    }
+    catch (err) {
+        throw new CommandExecutionError(
+            `${label} request failed: ${err?.message ?? err}`,
+            'Check that proxy.golang.org is reachable from this network.',
+        );
+    }
+    if (resp.status === 404 || resp.status === 410) {
+        throw new EmptyResultError(label, `proxy.golang.org returned ${resp.status} for ${url}.`);
+    }
+    if (resp.status === 429) {
+        throw new CommandExecutionError(`${label} returned HTTP 429 (rate limited)`);
+    }
+    if (!resp.ok) {
+        throw new CommandExecutionError(`${label} returned HTTP ${resp.status}`);
+    }
+    return resp;
+}
+
+export async function goproxyJson(url, label) {
+    const resp = await rawFetch(url, label);
+    let body;
+    try {
+        body = await resp.json();
+    }
+    catch (err) {
+        throw new CommandExecutionError(`${label} returned malformed JSON: ${err?.message ?? err}`);
+    }
+    return body;
+}
+
+export async function goproxyText(url, label) {
+    const resp = await rawFetch(url, label);
+    return resp.text();
+}
+
+// Sort version tags by their numeric components, newest first. Pre-release tags
+// (anything after "-" that isn't a pure number) sort lower than the matching
+// release. Returns a new sorted array; non-tag inputs are dropped.
+export function sortVersionsDescending(versions) {
+    return versions
+        .filter((v) => typeof v === 'string' && VERSION_TAG.test(v))
+        .map((v) => ({ v, parts: parseSemver(v) }))
+        .sort((a, b) => compareParts(b.parts, a.parts))
+        .map((entry) => entry.v);
+}
+
+function parseSemver(tag) {
+    // Strip leading "v"; split into <numbers>(-<pre>)?(+<build>)?
+    const stripped = tag.replace(/^v/, '');
+    const plusIdx = stripped.indexOf('+');
+    const noBuild = plusIdx >= 0 ? stripped.slice(0, plusIdx) : stripped;
+    const dashIdx = noBuild.indexOf('-');
+    const head = dashIdx >= 0 ? noBuild.slice(0, dashIdx) : noBuild;
+    const pre = dashIdx >= 0 ? noBuild.slice(dashIdx + 1) : '';
+    const numbers = head.split('.').map((s) => Number.parseInt(s, 10)).map((n) => Number.isFinite(n) ? n : 0);
+    return { numbers, pre };
+}
+
+function compareParts(a, b) {
+    const len = Math.max(a.numbers.length, b.numbers.length);
+    for (let i = 0; i < len; i += 1) {
+        const ai = a.numbers[i] ?? 0;
+        const bi = b.numbers[i] ?? 0;
+        if (ai !== bi) return ai - bi;
+    }
+    // No pre-release sorts higher than has pre-release.
+    if (a.pre === '' && b.pre !== '') return 1;
+    if (a.pre !== '' && b.pre === '') return -1;
+    if (a.pre === b.pre) return 0;
+    return comparePrerelease(a.pre, b.pre);
+}
+
+function comparePrerelease(a, b) {
+    const aParts = a.split('.');
+    const bParts = b.split('.');
+    const len = Math.max(aParts.length, bParts.length);
+    for (let i = 0; i < len; i += 1) {
+        const ai = aParts[i];
+        const bi = bParts[i];
+        if (ai == null) return -1;
+        if (bi == null) return 1;
+        const aNum = /^\d+$/.test(ai);
+        const bNum = /^\d+$/.test(bi);
+        if (aNum && bNum) {
+            const diff = Number(ai) - Number(bi);
+            if (diff !== 0) return diff;
+            continue;
+        }
+        if (aNum !== bNum) return aNum ? -1 : 1;
+        if (ai !== bi) return ai < bi ? -1 : 1;
+    }
+    return 0;
+}
+
+// Normalise GOPROXY ISO-Z timestamps to second precision (no fractional ms).
+export function trimDate(value) {
+    const s = String(value ?? '').trim();
+    if (!s) return null;
+    const noFrac = s.replace(/\.\d+/, '');
+    return noFrac.endsWith('Z') ? noFrac : (s.length >= 10 ? s.slice(0, 10) : null);
+}

package/clis/goproxy/versions.js

@@ -0,0 +1,59 @@
+// goproxy versions — published version tags for one Go module, newest first.
+//
+// Hits `https://proxy.golang.org/<module>/@v/list` (plain text, one tag per line).
+// Sort by semver (descending) and return up to `--limit` rows; per-tag publish
+// time comes from `@v/<ver>.info` and is fetched only when `--with-time` is set,
+// since it costs one HTTP request per row.
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { EmptyResultError } from '@jackwener/opencli/errors';
+import {
+    GOPROXY_BASE, goproxyJson, goproxyText, requireBoundedInt, requireModulePath, sortVersionsDescending, trimDate,
+} from './utils.js';
+
+cli({
+    site: 'goproxy',
+    name: 'versions',
+    access: 'read',
+    description: 'Published version tags for a Go module (newest first), optionally with publish times',
+    domain: 'proxy.golang.org',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'module', positional: true, type: 'string', required: true, help: 'Go module path (e.g. "github.com/gin-gonic/gin")' },
+        { name: 'limit', type: 'int', default: 30, help: 'Max rows to return (1-200)' },
+        { name: 'with-time', type: 'boolean', default: false, help: 'Fetch each version\'s publish time (one extra request per row)' },
+    ],
+    columns: [
+        'rank', 'module', 'version', 'publishedAt', 'url',
+    ],
+    func: async (args) => {
+        const modulePath = requireModulePath(args.module);
+        const limit = requireBoundedInt(args.limit, 30, 200, 'limit');
+        const withTime = args['with-time'] === true;
+        const encoded = modulePath.split('/').map(encodeURIComponent).join('/');
+        const text = await goproxyText(`${GOPROXY_BASE}/${encoded}/@v/list`, `goproxy versions ${modulePath}`);
+        const raw = text.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+        if (raw.length === 0) {
+            throw new EmptyResultError('goproxy versions', `proxy.golang.org returned no published versions for "${modulePath}".`);
+        }
+        const sorted = sortVersionsDescending(raw).slice(0, limit);
+        if (sorted.length === 0) {
+            throw new EmptyResultError('goproxy versions', `"${modulePath}" has no semver-shaped tags on proxy.golang.org.`);
+        }
+        const rows = sorted.map((v, i) => ({
+            rank: i + 1,
+            module: modulePath,
+            version: v,
+            publishedAt: null,
+            url: `${GOPROXY_BASE}/${encoded}/@v/${encodeURIComponent(v)}.info`,
+        }));
+        if (withTime) {
+            // Sequential to keep the proxy happy; cap at limit which is already <=200.
+            for (const row of rows) {
+                const info = await goproxyJson(`${GOPROXY_BASE}/${encoded}/@v/${encodeURIComponent(row.version)}.info`, `goproxy versions ${modulePath} ${row.version}`);
+                row.publishedAt = trimDate(info?.Time);
+            }
+        }
+        return rows;
+    },
+});

package/clis/gov-law/recent.js

@@ -14,7 +14,6 @@ cli({
         { name: 'limit', type: 'int', default: 10, help: '返回结果数量 (max 20)' },
     ],
     columns: ['rank', 'title', 'status', 'publish_date', 'type', 'department'],
-    navigateBefore: false,
     func: async (page, kwargs) => {
         const limit = clampInt(kwargs.limit, 10, 1, 20);
         await navigateViaVueRouter(page, {});

package/clis/gov-law/search.js

@@ -15,7 +15,6 @@ cli({
         { name: 'limit', type: 'int', default: 10, help: '返回结果数量 (max 20)' },
     ],
     columns: ['rank', 'title', 'status', 'publish_date', 'type', 'department'],
-    navigateBefore: false,
     func: async (page, kwargs) => {
         const limit = clampInt(kwargs.limit, 10, 1, 20);
         const query = requireNonEmptyQuery(kwargs.query);

package/clis/gov-policy/__fixtures__/recent.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html lang="zh">
+<head>
+<meta charset="UTF-8">
+<title>国务院最新政策文件</title>
+</head>
+<body>
+<div class="news_box">
+<div class="list list_1 list_2">
+<ul id="list-1-ajax-id">
+<li><h4><a href="https://www.gov.cn/zhengce/202604/content_7066998.htm" target="_blank">中共中央办公厅 国务院办公厅关于加强新就业群体服务管理的意见</a><span class="date">2026-04-26</span></h4></li><li><h4><a href="https://www.gov.cn/zhengce/202604/content_7066695.htm" target="_blank">中共中央办公厅 国务院办公厅印发《碳达峰碳中和综合评价考核办法》</a><span class="date">2026-04-23</span></h4></li><li><h4><a href="https://www.gov.cn/zhengce/202604/content_7066623.htm" target="_blank">中办国办关于更高水平更高质量做好节能降碳工作的意见</a><span class="date">2026-04-22</span></h4></li><li><h4><a href="https://www.gov.cn/zhengce/content/202604/content_7066483.htm" target="_blank">国务院关于推进服务业扩能提质的意见</a><span class="date">2026-04-21</span></h4></li><li><h4 class="line"><a href="https://www.gov.cn/zhengce/content/202604/content_7066113.htm" target="_blank">国务院办公厅转发海关总署《关于促进综合保税区扩能提质的若干措施》的通知</a><span class="date">2026-04-17</span></h4></li>
+</ul>
+</div>
+</div>
+</body>
+</html>

package/clis/gov-policy/__fixtures__/search.html

@@ -0,0 +1,41 @@
+<!DOCTYPE html>
+<html lang="zh">
+<head>
+<meta charset="UTF-8">
+<title>中国政府网站内搜索 - 数字经济</title>
+</head>
+<body>
+<div class="basic_result_content js_basic_result_content clearfix">
+<div class="item hasImg is-news" data-documentid="thirdparty_code_107_t_17e00f1efbb_25992758">
+            <div class="partitions"></div>
+            <a class="title log-anchor" title="经济数据速览：10组数字看一季度中国经济" href="https://www.gov.cn/zhengce/jiedu/tujie/202604/content_7065945.htm" target="_blank">
+                <span class="type_title">要闻</span><em>经济</em>数据速览：10组<em>数字</em>看一季度中国<em>经济</em>
+            </a>
+            <div class="description">
+                <img src="placeholder.png" aria-label="经济数据速览：10组数字看一季度中国经济">
+                <span class="sourceTime">发布时间：2026-4-16</span>
+            </div>
+        </div><div class="item hasImg is-news" data-documentid="thirdparty_code_107_t_17e00f1efbb_25839485">
+            <div class="partitions"></div>
+            <a class="title log-anchor" title="何立峰会见法国经济、财政和工业、能源与数字主权部部长莱斯屈尔" href="https://www.gov.cn/yaowen/liebiao/202603/content_7062985.htm" target="_blank">
+                <span class="type_title">要闻</span>何立峰会见法国<em>经济</em>、财政和工业、能源与<em>数字</em>主权部部长莱斯屈尔
+            </a>
+            <div class="description">
+                <div class="detail js_limit_text">
+                    <p class="js_text line_clamp_two">新华社巴黎3月16日电 当地时间3月16日，中法高级别经济财金对话中方牵头人、国务院副总理何立峰在中美经贸巴黎磋商之后应约会见对话法方牵头人，法国经济、财政和工业、能源与数字主权部部长莱斯屈尔，就近期中法经济财金合作和双方共同关心的问题深入交换意见。 何立峰表示，中方愿与法方一道，落实好习近平主席与马克龙总统重要共识，进一步深化中法经济财金各领域交流与合作，推动中法经济关系行稳致远。何立峰还应询介</p>
+                </div>
+                <span class="sourceTime">发布时间：2026-3-17</span>
+            </div>
+        </div><div class="item hasImg is-news" data-documentid="thirdparty_code_107_t_17e00f1efbb_25836739">
+            <div class="partitions"></div>
+            <a class="title log-anchor" title="经济数据速览：7组数字看1—2月份中国经济" href="https://www.gov.cn/zhengce/jiedu/tujie/202603/content_7062831.htm" target="_blank">
+                <span class="type_title">要闻</span><em>经济</em>数据速览：7组<em>数字</em>看1—2月份中国<em>经济</em>
+            </a>
+            <div class="description">
+                <img src="placeholder.png" aria-label="经济数据速览：7组数字看1—2月份中国经济">
+                <span class="sourceTime">发布时间：2026-3-16</span>
+            </div>
+        </div>
+</div>
+</body>
+</html>