publishport-opencli 1.0.20 → 1.0.21

package/clis/guazi/utils.js

@@ -1 +1 @@
-import{ArgumentError,AuthRequiredError as Q,CommandExecutionError,EmptyResultError}from"@jackwener/opencli/errors";export const GUAZI_M_BASE="https://m.guazi.com";const V="Mozilla/5.0 (iPhone; CPU iPhone OS 16_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.5 Mobile/15E148 Safari/604.1";export const BROWSE_COLUMNS=["rank","clue_id","title","price","down_payment","mileage","year","city","url"],CAR_COLUMNS=["field","value"],CITY_CODE={beijing:"bj","北京":"bj",shanghai:"sh","上海":"sh",guangzhou:"gz","广州":"gz",shenzhen:"sz","深圳":"sz",hangzhou:"hz","杭州":"hz",chengdu:"cd","成都":"cd",chongqing:"cq","重庆":"cq",nanjing:"nj","南京":"nj",wuhan:"wh","武汉":"wh",tianjin:"tj","天津":"tj",xian:"xa","西安":"xa",suzhou:"su","苏州":"su",zhengzhou:"zz","郑州":"zz",changsha:"cs","长沙":"cs",qingdao:"qd","青岛":"qd",shenyang:"sy","沈阳":"sy",dalian:"dl","大连":"dl",jinan:"jn","济南":"jn",hefei:"hf","合肥":"hf",foshan:"fs","佛山":"fs"};export function resolveCityCode(F){if(F==null||F==="")return"bj";const K=String(F).trim().toLowerCase();if(CITY_CODE[K])return CITY_CODE[K];if(CITY_CODE[String(F).trim()])return CITY_CODE[String(F).trim()];if(/^[a-z]{2,3}$/.test(K))return K;const L=Object.keys(CITY_CODE).filter((N)=>/^[a-z]+$/.test(N)).join(", ");throw new ArgumentError("city",`unknown city '${F}'. pass a Guazi city code or one of: ${L}`)}export function normalizeClueId(F){const K=String(F||"").trim();if(!K)throw new ArgumentError("clue_id must be a non-empty value");const L=K.match(/car-detail\/c(\d+)/)||K.match(/^c?(\d+)$/);if(!L)throw new ArgumentError(`'${F}' does not look like a guazi clue id (a number, or a /car-detail/c<id>.html URL)`);return L[1]}export function requireLimit(F,K,L){const N=F==null||F===""?K:F,P=typeof N==="number"?N:Number(String(N).trim());if(!Number.isInteger(P)||P<1||P>L)throw new ArgumentError(`limit must be an integer between 1 and ${L}`);return P}export function clean(F){return String(F==null?"":F).replace(/\s+/g," ").trim()}export function requireText(F,K){const L=clean(F);if(!L)throw new CommandExecutionError(`${K} did not include a stable text value.`);return L}export function requireStableId(F,K){const L=String(F??"").trim();if(!/^\d+$/.test(L))throw new CommandExecutionError(`${K} did not include a stable numeric id.`);return L}export async function guaziFetch(F,K){let L;try{L=await fetch(`${GUAZI_M_BASE}${F}`,{headers:{"User-Agent":V,Referer:`${GUAZI_M_BASE}/`,"Accept-Language":"zh-CN,zh;q=0.9"}})}catch(P){throw new CommandExecutionError(`guazi ${K} network error: ${P?.message||P}`)}if(!L.ok)throw new CommandExecutionError(`guazi ${K} HTTP ${L.status}`);const N=await L.text();if(/瑞数|reese84|captcha|滑动验证|verify\.guazi|安全验证/i.test(N)&&!/car-detail\/c\d+/.test(N))throw new Q("guazi.com",`guazi ${K} hit an anti-bot challenge — Guazi may have started gating the mobile site.`);return N}export{ArgumentError,CommandExecutionError,EmptyResultError};
+import{ArgumentError,AuthRequiredError as o,CommandExecutionError,EmptyResultError}from"@jackwener/opencli/errors";export const GUAZI_M_BASE="https://m.guazi.com";const a="Mozilla/5.0 (iPhone; CPU iPhone OS 16_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.5 Mobile/15E148 Safari/604.1";export const BROWSE_COLUMNS=["rank","clue_id","title","price","down_payment","mileage","year","city","url"],CAR_COLUMNS=["field","value"],CITY_CODE={beijing:"bj","北京":"bj",shanghai:"sh","上海":"sh",guangzhou:"gz","广州":"gz",shenzhen:"sz","深圳":"sz",hangzhou:"hz","杭州":"hz",chengdu:"cd","成都":"cd",chongqing:"cq","重庆":"cq",nanjing:"nj","南京":"nj",wuhan:"wh","武汉":"wh",tianjin:"tj","天津":"tj",xian:"xa","西安":"xa",suzhou:"su","苏州":"su",zhengzhou:"zz","郑州":"zz",changsha:"cs","长沙":"cs",qingdao:"qd","青岛":"qd",shenyang:"sy","沈阳":"sy",dalian:"dl","大连":"dl",jinan:"jn","济南":"jn",hefei:"hf","合肥":"hf",foshan:"fs","佛山":"fs"};export function resolveCityCode(e){if(e==null||e==="")return"bj";const t=String(e).trim().toLowerCase();if(CITY_CODE[t])return CITY_CODE[t];if(CITY_CODE[String(e).trim()])return CITY_CODE[String(e).trim()];if(/^[a-z]{2,3}$/.test(t))return t;const n=Object.keys(CITY_CODE).filter((r)=>/^[a-z]+$/.test(r)).join(", ");throw new ArgumentError("city",`unknown city '${e}'. pass a Guazi city code or one of: ${n}`)}export function normalizeClueId(e){const t=String(e||"").trim();if(!t)throw new ArgumentError("clue_id must be a non-empty value");const n=t.match(/car-detail\/c(\d+)/)||t.match(/^c?(\d+)$/);if(!n)throw new ArgumentError(`'${e}' does not look like a guazi clue id (a number, or a /car-detail/c<id>.html URL)`);return n[1]}export function requireLimit(e,t,n){const r=e==null||e===""?t:e,i=typeof r==="number"?r:Number(String(r).trim());if(!Number.isInteger(i)||i<1||i>n)throw new ArgumentError(`limit must be an integer between 1 and ${n}`);return i}export function clean(e){return String(e==null?"":e).replace(/\s+/g," ").trim()}export function requireText(e,t){const n=clean(e);if(!n)throw new CommandExecutionError(`${t} did not include a stable text value.`);return n}export function requireStableId(e,t){const n=String(e??"").trim();if(!/^\d+$/.test(n))throw new CommandExecutionError(`${t} did not include a stable numeric id.`);return n}export async function guaziFetch(e,t){let n;try{n=await fetch(`${GUAZI_M_BASE}${e}`,{headers:{"User-Agent":a,Referer:`${GUAZI_M_BASE}/`,"Accept-Language":"zh-CN,zh;q=0.9"}})}catch(i){throw new CommandExecutionError(`guazi ${t} network error: ${i?.message||i}`)}if(!n.ok)throw new CommandExecutionError(`guazi ${t} HTTP ${n.status}`);const r=await n.text();if(/瑞数|reese84|captcha|滑动验证|verify\.guazi|安全验证/i.test(r)&&!/car-detail\/c\d+/.test(r))throw new o("guazi.com",`guazi ${t} hit an anti-bot challenge — Guazi may have started gating the mobile site.`);return r}export{ArgumentError,CommandExecutionError,EmptyResultError};

package/clis/hackernews/auth.js

@@ -1,4 +1,4 @@
-import{AuthRequiredError as n,CommandExecutionError as c}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as i}from"../_shared/site-auth.js";const t="https://news.ycombinator.com";async function r(e){return(await e.getCookies({url:t})).some((a)=>a.name==="user"&&a.value)}async function s(e){if(!await r(e))throw new n("news.ycombinator.com","Hacker News `user` cookie missing — not signed in");await e.goto(`${t}/news`);await e.wait(1);const o=await e.evaluate(`(() => {
+import{AuthRequiredError as n,CommandExecutionError as m}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as i}from"../_shared/site-auth.js";const r="https://news.ycombinator.com";async function t(e){return(await e.getCookies({url:r})).some((a)=>a.name==="user"&&a.value)}async function s(e){if(!await t(e))throw new n("news.ycombinator.com","Hacker News `user` cookie missing — not signed in");await e.goto(`${r}/news`);await e.wait(1);const o=await e.evaluate(`(() => {
     // The top-right nav shows "<username> (karma) | logout" only when signed in.
     const userLink = document.querySelector('span.pagetop a[href^="user?id="]');
     const logout = document.querySelector('a[href^="logout"]');
@@ -6,4 +6,4 @@ import{AuthRequiredError as n,CommandExecutionError as c}from"@jackwener/opencli
     const username = (userLink.textContent || '').trim();
     const karmaMatch = (document.querySelector('span.pagetop')?.textContent || '').match(/\\((\\d+)\\)/);
     return { username, karma: karmaMatch ? karmaMatch[1] : '' };
-  })()`);if(o?.anon||!o?.username)throw new n("news.ycombinator.com","Hacker News shows no signed-in user — cookie stale");return{username:o.username,karma:o.karma||""}}i({site:"hackernews",domain:"news.ycombinator.com",loginUrl:`${t}/login`,columns:["username","karma"],quickCheck:r,verify:s,poll:async(e)=>{if(!await r(e))throw new n("news.ycombinator.com","Waiting for Hacker News `user` cookie");return s(e)}});
+  })()`);if(o?.anon||!o?.username)throw new n("news.ycombinator.com","Hacker News shows no signed-in user — cookie stale");return{username:o.username,karma:o.karma||""}}i({site:"hackernews",domain:"news.ycombinator.com",loginUrl:`${r}/login`,columns:["username","karma"],quickCheck:t,verify:s,poll:async(e)=>{if(!await t(e))throw new n("news.ycombinator.com","Waiting for Hacker News `user` cookie");return s(e)}});

package/clis/hackernews/comment.js

@@ -1,22 +1,22 @@
-import{ArgumentError as Q,AuthRequiredError as T,CommandExecutionError as L}from"@jackwener/opencli/errors";import{cli as U,Strategy as V}from"@jackwener/opencli/registry";const M="https://news.ycombinator.com";export function normalizeItemId(F){const J=String(F||"").trim();if(!J)throw new Q("Item id is required.","Pass an HN item id (story or comment), e.g. 48811591.");if(/^\d+$/.test(J))return J;const B=J.match(/[?&]id=(\d+)/);if(B)return B[1];throw new Q(`Invalid HN item reference: ${JSON.stringify(J)}`,"Pass a numeric id or an item?id=… URL.")}U({site:"hackernews",name:"comment",access:"write",description:"Post a comment on a Hacker News item. Pass the parent id (a story to comment on it, or a comment to reply). Contribute a substantive, on-topic comment — HN flags low-effort or off-topic replies.",domain:"news.ycombinator.com",strategy:V.COOKIE,browser:!0,args:[{name:"parent",type:"string",required:!0,positional:!0,help:"Parent item id (story or comment) to reply to"},{name:"text",fromFile:!0,type:"string",required:!0,positional:!0,help:"Comment text (HN markup: blank line = paragraph)"}],columns:["status","id","url","parent","message"],func:async(F,J)=>{if(!F)throw new L("Browser session required");const B=normalizeItemId(J.parent),P=String(J.text??"");if(!P.trim())throw new Q("Comment text cannot be empty.");await F.goto(`${M}/item?id=${B}`);await F.wait(1);const D=await F.evaluate(`(async () => {
+import{ArgumentError as m,AuthRequiredError as c,CommandExecutionError as i}from"@jackwener/opencli/errors";import{cli as u,Strategy as d}from"@jackwener/opencli/registry";const s="https://news.ycombinator.com";export function normalizeItemId(r){const o=String(r||"").trim();if(!o)throw new m("Item id is required.","Pass an HN item id (story or comment), e.g. 48811591.");if(/^\d+$/.test(o))return o;const t=o.match(/[?&]id=(\d+)/);if(t)return t[1];throw new m(`Invalid HN item reference: ${JSON.stringify(o)}`,"Pass a numeric id or an item?id=… URL.")}u({site:"hackernews",name:"comment",access:"write",description:"Post a comment on a Hacker News item. Pass the parent id (a story to comment on it, or a comment to reply). Contribute a substantive, on-topic comment — HN flags low-effort or off-topic replies.",domain:"news.ycombinator.com",strategy:d.COOKIE,browser:!0,args:[{name:"parent",type:"string",required:!0,positional:!0,help:"Parent item id (story or comment) to reply to"},{name:"text",fromFile:!0,type:"string",required:!0,positional:!0,help:"Comment text (HN markup: blank line = paragraph)"}],columns:["status","id","url","parent","message"],func:async(r,o)=>{if(!r)throw new i("Browser session required");const t=normalizeItemId(o.parent),a=String(o.text??"");if(!a.trim())throw new m("Comment text cannot be empty.");await r.goto(`${s}/item?id=${t}`);await r.wait(1);const e=await r.evaluate(`(async () => {
       try {
         if (/\\/login/.test(location.pathname)) return { kind: 'auth', detail: 'redirected to /login' };
         // The reply form posts to "comment" (relative). Match it by the hidden
         // fields it carries rather than the action attribute, which HN writes
         // relative ("comment") so /comment suffix selectors miss it.
         const forms = [...document.querySelectorAll('form')].filter(f => f.querySelector('input[name="hmac"]') && f.querySelector('input[name="parent"]'));
-        const form = forms.find(f => (f.querySelector('input[name="parent"]')?.value) === ${JSON.stringify(B)}) || forms[0];
+        const form = forms.find(f => (f.querySelector('input[name="parent"]')?.value) === ${JSON.stringify(t)}) || forms[0];
         if (!form) return { kind: 'notfound', detail: 'No comment form on this item — it may be closed, deleted, or you are signed out.' };
         const hmac = form.querySelector('input[name="hmac"]')?.value;
-        const goto = form.querySelector('input[name="goto"]')?.value || ('item?id=' + ${JSON.stringify(B)});
-        const parentVal = form.querySelector('input[name="parent"]')?.value || ${JSON.stringify(B)};
+        const goto = form.querySelector('input[name="goto"]')?.value || ('item?id=' + ${JSON.stringify(t)});
+        const parentVal = form.querySelector('input[name="parent"]')?.value || ${JSON.stringify(t)};
         if (!hmac) return { kind: 'auth', detail: 'comment hmac token missing — likely signed out' };
 
         const p = new URLSearchParams();
         p.set('parent', parentVal);
         p.set('goto', goto);
         p.set('hmac', hmac);
-        p.set('text', ${JSON.stringify(P)});
+        p.set('text', ${JSON.stringify(a)});
 
         const res = await fetch('/comment', {
           method: 'POST',
@@ -40,12 +40,12 @@ import{ArgumentError as Q,AuthRequiredError as T,CommandExecutionError as L}from
       } catch (e) {
         return { kind: 'exception', detail: String((e && e.message) || e) };
       }
-    })()`);if(D?.kind==="auth")throw new T("news.ycombinator.com",D.detail);if(D?.kind==="notfound")throw new L(D.detail);if(D?.kind==="exception")throw new L(`HN comment failed: ${D.detail}`);if(D?.kind==="reject")return[{status:"failed",id:"",url:"",parent:B,message:D.detail}];if(!D?.ok)throw new L(`Unexpected HN comment result: ${JSON.stringify(D)}`);await F.goto(`${M}/item?id=${B}`);await F.wait(1);const K=(await F.evaluate(`(() => {
+    })()`);if(e?.kind==="auth")throw new c("news.ycombinator.com",e.detail);if(e?.kind==="notfound")throw new i(e.detail);if(e?.kind==="exception")throw new i(`HN comment failed: ${e.detail}`);if(e?.kind==="reject")return[{status:"failed",id:"",url:"",parent:t,message:e.detail}];if(!e?.ok)throw new i(`Unexpected HN comment result: ${JSON.stringify(e)}`);await r.goto(`${s}/item?id=${t}`);await r.wait(1);const n=(await r.evaluate(`(() => {
       try {
         let username = '';
         const navLink = document.querySelector('span.pagetop a[href^="user?id="]');
         if (navLink) username = (navLink.getAttribute('href') || '').replace('user?id=', '');
-        const want = ${JSON.stringify(P)}.replace(/\\s+/g, ' ').trim();
+        const want = ${JSON.stringify(a)}.replace(/\\s+/g, ' ').trim();
         const rows = [...document.querySelectorAll('tr.athing.comtr')];
         // Newest first: our fresh comment is usually near the top of its thread.
         for (const row of rows) {
@@ -58,4 +58,4 @@ import{ArgumentError as Q,AuthRequiredError as T,CommandExecutionError as L}from
         }
         return null;
       } catch { return null; }
-    })()`))?.id||"";return[{status:"success",id:K,url:K?`${M}/item?id=${K}`:`${M}/item?id=${B}`,parent:B,message:K?"Comment posted":"Comment posted (id not confirmed on reload)"}]}});
+    })()`))?.id||"";return[{status:"success",id:n,url:n?`${s}/item?id=${n}`:`${s}/item?id=${t}`,parent:t,message:n?"Comment posted":"Comment posted (id not confirmed on reload)"}]}});

package/clis/hackernews/read.js

@@ -1,11 +1,11 @@
-import{cli as P,Strategy as w}from"@jackwener/opencli/registry";import{ArgumentError as F,CommandExecutionError as E,EmptyResultError as T}from"@jackwener/opencli/errors";const I="https://hacker-news.firebaseio.com/v0/item";async function K(z){const G=await fetch(`${I}/${z}.json`);if(!G.ok)throw new E(`HN API HTTP ${G.status} for item ${z}`,"Check the item ID");return G.json()}function M(z,G){if(!Number.isInteger(z)||z<=0)throw new F(`${G} must be a positive integer`);return z}function x(z,G,V){if(!Number.isInteger(z)||z<G)throw new F(`${V} must be an integer >= ${G}`);return z}function B(z){if(!z)return"";return String(z).replace(/<p>/gi,`
+import{cli as S,Strategy as H}from"@jackwener/opencli/registry";import{ArgumentError as f,CommandExecutionError as v,EmptyResultError as R}from"@jackwener/opencli/errors";const j="https://hacker-news.firebaseio.com/v0/item";async function y(e){const t=await fetch(`${j}/${e}.json`);if(!t.ok)throw new v(`HN API HTTP ${t.status} for item ${e}`,"Check the item ID");return t.json()}function g(e,t){if(!Number.isInteger(e)||e<=0)throw new f(`${t} must be a positive integer`);return e}function q(e,t,s){if(!Number.isInteger(e)||e<t)throw new f(`${s} must be an integer >= ${t}`);return e}function L(e){if(!e)return"";return String(e).replace(/<p>/gi,`
 
 `).replace(/<\/p>/gi,"").replace(/<br\s*\/?>/gi,`
 `).replace(/<i>(.*?)<\/i>/gi,"$1").replace(/<a[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/gi,"$2 ($1)").replace(/<pre><code>([\s\S]*?)<\/code><\/pre>/gi,`
 $1
-`).replace(/<[^>]+>/g,"").replace(/&#x27;/g,"'").replace(/&quot;/g,'"').replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&amp;/g,"&").replace(/&nbsp;/g," ").replace(/&#x2F;/g,"/").trim()}function v(z,G){if(G===0)return z;const Y=`${"  ".repeat(G)}> `;return z.split(`
-`).map((Z)=>Y+Z).join(`
-`)}function b(z){return"  ".repeat(z+1)}P({site:"hackernews",name:"read",access:"read",description:"Read a Hacker News story and its comment tree",domain:"news.ycombinator.com",strategy:w.PUBLIC,browser:!1,args:[{name:"id",required:!0,positional:!0,help:"HN item ID (e.g. 39847301)"},{name:"limit",type:"int",default:25,help:"Max top-level comments"},{name:"depth",type:"int",default:2,help:"Max reply depth (1=no replies, 2=one level of replies, etc.)"},{name:"replies",type:"int",default:5,help:"Max replies shown per comment at each level"},{name:"max-length",type:"int",default:2000,help:"Max characters per comment body (min 100)"}],columns:["type","author","score","text"],func:async(z)=>{const G=String(z.id||"").trim();if(!/^\d+$/.test(G))throw new F(`Invalid HN item id: ${z.id}`,"Pass a numeric id like 39847301");const V=M(z.limit??25,"hackernews read --limit"),Y=M(z.depth??2,"hackernews read --depth"),Z=M(z.replies??5,"hackernews read --replies"),W=x(z["max-length"]??2000,100,"hackernews read --max-length"),O=await K(G);if(!O||O.deleted||O.dead)throw new T(`hackernews/${G}`,"Story not found, deleted, or dead");const U=[],$=B(O.text||""),N=$.length>W?$.slice(0,W)+`
-... [truncated]`:$,D=[O.title||""];if(N)D.push(`
-`+N);if(O.url)D.push(`
-`+O.url);U.push({type:"POST",author:O.by||"[deleted]",score:O.score??0,text:D.join("").trim()});const S=Array.isArray(O.kids)?O.kids:[],_=S.slice(0,V),k=await Promise.all(_.map((J)=>K(J).catch(()=>null)));async function C(J,Q){if(!J||J.deleted||J.dead||J.type!=="comment")return;const H=B(J.text||""),L=H.length>W?H.slice(0,W)+"...":H;U.push({type:Q===0?"L0":`L${Q}`,author:J.by||"[deleted]",score:"",text:v(L,Q)});const X=Array.isArray(J.kids)?J.kids:[];if(Q+1>=Y){if(X.length>0)U.push({type:`L${Q+1}`,author:"",score:"",text:`${b(Q)}[+${X.length} more replies]`});return}const A=X.slice(0,Z),R=await Promise.all(A.map((j)=>K(j).catch(()=>null)));for(const j of R)await C(j,Q+1);const f=X.length-A.length;if(f>0)U.push({type:`L${Q+1}`,author:"",score:"",text:`${b(Q)}[+${f} more replies]`})}for(const J of k)await C(J,0);const q=Math.max(0,S.length-_.length);if(q>0)U.push({type:"",author:"",score:"",text:`[+${q} more top-level comments]`});return U}});
+`).replace(/<[^>]+>/g,"").replace(/&#x27;/g,"'").replace(/&quot;/g,'"').replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&amp;/g,"&").replace(/&nbsp;/g," ").replace(/&#x2F;/g,"/").trim()}function B(e,t){if(t===0)return e;const l=`${"  ".repeat(t)}> `;return e.split(`
+`).map((p)=>l+p).join(`
+`)}function A(e){return"  ".repeat(e+1)}S({site:"hackernews",name:"read",access:"read",description:"Read a Hacker News story and its comment tree",domain:"news.ycombinator.com",strategy:H.PUBLIC,browser:!1,args:[{name:"id",required:!0,positional:!0,help:"HN item ID (e.g. 39847301)"},{name:"limit",type:"int",default:25,help:"Max top-level comments"},{name:"depth",type:"int",default:2,help:"Max reply depth (1=no replies, 2=one level of replies, etc.)"},{name:"replies",type:"int",default:5,help:"Max replies shown per comment at each level"},{name:"max-length",type:"int",default:2000,help:"Max characters per comment body (min 100)"}],columns:["type","author","score","text"],func:async(e)=>{const t=String(e.id||"").trim();if(!/^\d+$/.test(t))throw new f(`Invalid HN item id: ${e.id}`,"Pass a numeric id like 39847301");const s=g(e.limit??25,"hackernews read --limit"),l=g(e.depth??2,"hackernews read --depth"),p=g(e.replies??5,"hackernews read --replies"),a=q(e["max-length"]??2000,100,"hackernews read --max-length"),n=await y(t);if(!n||n.deleted||n.dead)throw new R(`hackernews/${t}`,"Story not found, deleted, or dead");const o=[],m=L(n.text||""),w=m.length>a?m.slice(0,a)+`
+... [truncated]`:m,u=[n.title||""];if(w)u.push(`
+`+w);if(n.url)u.push(`
+`+n.url);o.push({type:"POST",author:n.by||"[deleted]",score:n.score??0,text:u.join("").trim()});const x=Array.isArray(n.kids)?n.kids:[],k=x.slice(0,s),E=await Promise.all(k.map((r)=>y(r).catch(()=>null)));async function b(r,i){if(!r||r.deleted||r.dead||r.type!=="comment")return;const h=L(r.text||""),M=h.length>a?h.slice(0,a)+"...":h;o.push({type:i===0?"L0":`L${i}`,author:r.by||"[deleted]",score:"",text:B(M,i)});const c=Array.isArray(r.kids)?r.kids:[];if(i+1>=l){if(c.length>0)o.push({type:`L${i+1}`,author:"",score:"",text:`${A(i)}[+${c.length} more replies]`});return}const P=c.slice(0,p),N=await Promise.all(P.map((d)=>y(d).catch(()=>null)));for(const d of N)await b(d,i+1);const T=c.length-P.length;if(T>0)o.push({type:`L${i+1}`,author:"",score:"",text:`${A(i)}[+${T} more replies]`})}for(const r of E)await b(r,0);const I=Math.max(0,x.length-k.length);if(I>0)o.push({type:"",author:"",score:"",text:`[+${I} more top-level comments]`});return o}});

package/clis/hackernews/submit.js

@@ -1,4 +1,4 @@
-import{ArgumentError as F,AuthRequiredError as Q,CommandExecutionError as L}from"@jackwener/opencli/errors";import{cli as T,Strategy as V}from"@jackwener/opencli/registry";const M="https://news.ycombinator.com";T({site:"hackernews",name:"submit",access:"write",description:"Submit a story to Hacker News. Link post by default (--url), or an Ask/text post with --text. HN gates submissions on account age/karma and dedupes URLs — rejections are surfaced verbatim. Post genuinely worthwhile content; low-effort submissions hurt the account.",domain:"news.ycombinator.com",strategy:V.COOKIE,browser:!0,args:[{name:"title",type:"string",required:!0,positional:!0,help:"Story title (max 80 chars)"},{name:"url",type:"string",help:"External URL for a link post (mutually exclusive with --text)"},{name:"text",fromFile:!0,type:"string",help:"Body text for an Ask HN / text post (mutually exclusive with --url)"}],columns:["status","id","url","title","message"],func:async(v,D)=>{if(!v)throw new L("Browser session required");const z=String(D.title??"").trim();if(!z)throw new F("Title is required.");if(z.length>80)throw new F("HN titles must be at most 80 characters.");const B=typeof D.url==="string"?D.url.trim():"",K=typeof D.text==="string"?D.text:"";if(B&&K)throw new F("Pass either --url (link post) or --text (text post), not both.");if(!B&&!K)throw new F("A story needs either --url or --text.","Give a link to submit, or --text for an Ask HN post.");if(B)try{new URL(B)}catch{throw new F(`Invalid --url: ${B}`)}await v.goto(`${M}/submit`);await v.wait(1);const f=await v.evaluate(`(async () => {
+import{ArgumentError as s,AuthRequiredError as d,CommandExecutionError as u}from"@jackwener/opencli/errors";import{cli as m,Strategy as f}from"@jackwener/opencli/registry";const c="https://news.ycombinator.com";m({site:"hackernews",name:"submit",access:"write",description:"Submit a story to Hacker News. Link post by default (--url), or an Ask/text post with --text. HN gates submissions on account age/karma and dedupes URLs — rejections are surfaced verbatim. Post genuinely worthwhile content; low-effort submissions hurt the account.",domain:"news.ycombinator.com",strategy:f.COOKIE,browser:!0,args:[{name:"title",type:"string",required:!0,positional:!0,help:"Story title (max 80 chars)"},{name:"url",type:"string",help:"External URL for a link post (mutually exclusive with --text)"},{name:"text",fromFile:!0,type:"string",help:"Body text for an Ask HN / text post (mutually exclusive with --url)"}],columns:["status","id","url","title","message"],func:async(e,n)=>{if(!e)throw new u("Browser session required");const r=String(n.title??"").trim();if(!r)throw new s("Title is required.");if(r.length>80)throw new s("HN titles must be at most 80 characters.");const i=typeof n.url==="string"?n.url.trim():"",a=typeof n.text==="string"?n.text:"";if(i&&a)throw new s("Pass either --url (link post) or --text (text post), not both.");if(!i&&!a)throw new s("A story needs either --url or --text.","Give a link to submit, or --text for an Ask HN post.");if(i)try{new URL(i)}catch{throw new s(`Invalid --url: ${i}`)}await e.goto(`${c}/submit`);await e.wait(1);const t=await e.evaluate(`(async () => {
       try {
         // The submit form only renders for a signed-in user; if HN bounced us
         // to /login the form (and its fnid) will be absent.
@@ -12,9 +12,9 @@ import{ArgumentError as F,AuthRequiredError as Q,CommandExecutionError as L}from
         const p = new URLSearchParams();
         p.set('fnid', fnid);
         p.set('fnop', 'submit-page');
-        p.set('title', ${JSON.stringify(z)});
-        p.set('url', ${JSON.stringify(B)});
-        p.set('text', ${JSON.stringify(K)});
+        p.set('title', ${JSON.stringify(r)});
+        p.set('url', ${JSON.stringify(i)});
+        p.set('text', ${JSON.stringify(a)});
 
         const res = await fetch('/r', {
           method: 'POST',
@@ -39,7 +39,7 @@ import{ArgumentError as F,AuthRequiredError as Q,CommandExecutionError as L}from
       } catch (e) {
         return { kind: 'exception', detail: String((e && e.message) || e) };
       }
-    })()`);if(f?.kind==="auth")throw new Q("news.ycombinator.com",f.detail);if(f?.kind==="exception")throw new L(`HN submit failed: ${f.detail}`);if(f?.kind==="reject")return[{status:"failed",id:"",url:"",title:z,message:f.detail}];if(!f?.ok)throw new L(`Unexpected HN submit result: ${JSON.stringify(f)}`);await v.wait(1);const J=(await v.evaluate(`(async () => {
+    })()`);if(t?.kind==="auth")throw new d("news.ycombinator.com",t.detail);if(t?.kind==="exception")throw new u(`HN submit failed: ${t.detail}`);if(t?.kind==="reject")return[{status:"failed",id:"",url:"",title:r,message:t.detail}];if(!t?.ok)throw new u(`Unexpected HN submit result: ${JSON.stringify(t)}`);await e.wait(1);const o=(await e.evaluate(`(async () => {
       try {
         const uc = document.cookie.match(/(?:^|; )user=([^;]+)/);
         // Cookie value is "<username>&<hash>"; the nav link is more reliable.
@@ -52,7 +52,7 @@ import{ArgumentError as F,AuthRequiredError as Q,CommandExecutionError as L}from
         const html = await res.text();
         const doc = new DOMParser().parseFromString(html, 'text/html');
         const rows = [...doc.querySelectorAll('tr.athing')];
-        const want = ${JSON.stringify(z)}.replace(/\\s+/g, ' ').trim();
+        const want = ${JSON.stringify(r)}.replace(/\\s+/g, ' ').trim();
         for (const row of rows.slice(0, 5)) {
           const link = row.querySelector('.titleline a, a.storylink, .title a');
           const t = (link?.textContent || '').replace(/\\s+/g, ' ').trim();
@@ -62,4 +62,4 @@ import{ArgumentError as F,AuthRequiredError as Q,CommandExecutionError as L}from
         }
         return { id: rows[0]?.id || '', href: '' };
       } catch { return null; }
-    })()`))?.id||"",P=J?`${M}/item?id=${J}`:"";return[{status:"success",id:J,url:P,title:z,message:J?"Story submitted":"Story submitted (item id not confirmed; check /newest)"}]}});
+    })()`))?.id||"",l=o?`${c}/item?id=${o}`:"";return[{status:"success",id:o,url:l,title:r,message:o?"Story submitted":"Story submitted (item id not confirmed; check /newest)"}]}});

package/clis/hashnode/auth.js

@@ -1,6 +1,6 @@
-import{AuthRequiredError as z}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as G}from"../_shared/site-auth.js";const B="https://hashnode.com",J="https://hashnode.com/api/auth/session";function K(v){return v==="hashnode-session"||/(authjs|next-auth)\.session-token$/.test(v)}async function D(v){return(await v.getCookies({url:B})).some((y)=>K(y.name)&&y.value)}async function F(v){await v.goto(B);const x=await v.evaluate(`(async () => {
+import{AuthRequiredError as o}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as i}from"../_shared/site-auth.js";const a="https://hashnode.com",u="https://hashnode.com/api/auth/session";function h(e){return e==="hashnode-session"||/(authjs|next-auth)\.session-token$/.test(e)}async function t(e){return(await e.getCookies({url:a})).some((n)=>h(n.name)&&n.value)}async function r(e){await e.goto(a);const s=await e.evaluate(`(async () => {
     try {
-      var r = await fetch(${JSON.stringify(J)}, { credentials: 'include', headers: { Accept: 'application/json' } });
+      var r = await fetch(${JSON.stringify(u)}, { credentials: 'include', headers: { Accept: 'application/json' } });
       if (r.status === 401 || r.status === 403) return { ok: false, reason: 'HTTP ' + r.status };
       var text = await r.text();
       var j = null; try { j = JSON.parse(text); } catch (e) { return { ok: false, reason: 'non-JSON session' }; }
@@ -8,4 +8,4 @@ import{AuthRequiredError as z}from"@jackwener/opencli/errors";import{registerSit
       if (!u || !u.username) return { ok: false, reason: 'anonymous' };
       return { ok: true, id: String(u.id || ''), username: String(u.username || ''), name: String(u.name || ''), email: String(u.email || '') };
     } catch (e) { return { ok: false, reason: String(e && e.message || e) }; }
-  })()`);if(!x||!x.ok)throw new z("hashnode.com",`Not logged in (${x?x.reason:"no probe"})`);return{user_id:x.id,username:x.username,name:x.name}}G({site:"hashnode",domain:"hashnode.com",loginUrl:"https://hashnode.com/onboard",columns:["user_id","username","name"],loginDescription:"打开 Hashnode 登录页并等待浏览器完成登录（供桌面客户端引导登录）。",quickCheck:D,verify:F,poll:async(v)=>{if(!await D(v))throw new z("hashnode.com","Waiting for hashnode.com session cookie");return F(v)}});
+  })()`);if(!s||!s.ok)throw new o("hashnode.com",`Not logged in (${s?s.reason:"no probe"})`);return{user_id:s.id,username:s.username,name:s.name}}i({site:"hashnode",domain:"hashnode.com",loginUrl:"https://hashnode.com/onboard",columns:["user_id","username","name"],loginDescription:"打开 Hashnode 登录页并等待浏览器完成登录（供桌面客户端引导登录）。",quickCheck:t,verify:r,poll:async(e)=>{if(!await t(e))throw new o("hashnode.com","Waiting for hashnode.com session cookie");return r(e)}});

package/clis/hashnode/publish.js

@@ -1,4 +1,4 @@
-import*as M from"node:fs";import{cli as I,Strategy as S}from"@jackwener/opencli/registry";import{ArgumentError as _,AuthRequiredError as b,CommandExecutionError as V}from"@jackwener/opencli/errors";import{assertLiteralContent as O}from"../_shared/content-guard.js";const j="https://hashnode.com";export function resolveBody(z){if(z["body-file"]){const D=String(z["body-file"]);if(!M.statSync(D,{throwIfNoEntry:!1})?.isFile())throw new _(`--body-file not found: ${D}`);return M.readFileSync(D,"utf8")}if(z.body!==void 0&&z.body!==null){O(String(z.body),{fileFlag:"--body-file"});return String(z.body)}return}export function resolveTags(z){if(z===void 0||z===null||z==="")return[];return[...new Set(String(z).split(",").map((D)=>D.trim()).filter(Boolean))]}const h=`(async () => {
+import*as k from"node:fs";import{cli as O,Strategy as E}from"@jackwener/opencli/registry";import{ArgumentError as g,AuthRequiredError as q,CommandExecutionError as a}from"@jackwener/opencli/errors";import{assertLiteralContent as T}from"../_shared/content-guard.js";const v="https://hashnode.com";export function resolveBody(e){if(e["body-file"]){const t=String(e["body-file"]);if(!k.statSync(t,{throwIfNoEntry:!1})?.isFile())throw new g(`--body-file not found: ${t}`);return k.readFileSync(t,"utf8")}if(e.body!==void 0&&e.body!==null){T(String(e.body),{fileFlag:"--body-file"});return String(e.body)}return}export function resolveTags(e){if(e===void 0||e===null||e==="")return[];return[...new Set(String(e).split(",").map((t)=>t.trim()).filter(Boolean))]}const P=`(async () => {
   if (location.href.indexOf('hashnode.com') < 0) return { drift: true };
   try {
     var r = await fetch('/api/auth/session', { credentials: 'include', headers: { Accept: 'application/json' } });
@@ -6,7 +6,7 @@ import*as M from"node:fs";import{cli as I,Strategy as S}from"@jackwener/opencli/
     var u = j && j.user;
     return u && u.username ? { ok: true, username: String(u.username) } : { ok: false };
   } catch (e) { return { drift: true, err: String(e && e.message || e) }; }
-})()`;async function W(z,D,{tries:Y=8,label:Z="eval",anchor:$=j}={}){let q;for(let B=0;B<Y;B+=1){let F;try{F=await z.evaluate(D)}catch(G){F={drift:!0,err:String(G&&G.message||G)}}q=F;if(F&&F.drift){await z.goto($);await z.wait(2);continue}return F}throw new V(`Hashnode ${Z}: browser tab kept drifting (last: ${JSON.stringify(q)})`)}I({site:"hashnode",name:"publish",access:"write",description:"Publish a Hashnode post via the web editor (or save a draft with --draft). Markdown body + tags/cover/canonical.",domain:"hashnode.com",strategy:S.COOKIE,browser:!0,defaultWindowMode:"foreground",siteSession:"persistent",args:[{name:"title",type:"string",required:!0,help:"Post title"},{name:"body",type:"string",required:!1,help:"Post body in Markdown (or use --body-file)"},{name:"body-file",type:"string",required:!1,help:"Path to a Markdown file for the body"},{name:"tags",type:"string",required:!1,help:"Comma-separated tag names"},{name:"cover-image",type:"string",required:!1,help:"Cover image URL"},{name:"canonical-url",type:"string",required:!1,help:"Canonical / original article URL"},{name:"draft",type:"boolean",required:!1,default:!1,help:"Save as draft instead of publishing"}],columns:["status","draft_id","url"],func:async(z,D)=>{if(!z)throw new V("Browser session required for hashnode publish");const Y=String(D.title??"").trim();if(!Y)throw new _("hashnode publish: --title is required");const Z=resolveBody(D);if(Z===void 0)throw new _("--body or --body-file is required");const $=resolveTags(D.tags),q=D["canonical-url"]?String(D["canonical-url"]):"",B=D["cover-image"]?String(D["cover-image"]):"";await z.goto(j);const F=await W(z,h,{label:"auth"});if(!F||!F.ok)throw new b("hashnode.com","Not logged in. Run `ppcli hashnode login`.");const G=await W(z,`(async () => {
+})()`;async function l(e,t,{tries:d=8,label:u="eval",anchor:c=v}={}){let f;for(let y=0;y<d;y+=1){let r;try{r=await e.evaluate(t)}catch(i){r={drift:!0,err:String(i&&i.message||i)}}f=r;if(r&&r.drift){await e.goto(c);await e.wait(2);continue}return r}throw new a(`Hashnode ${u}: browser tab kept drifting (last: ${JSON.stringify(f)})`)}O({site:"hashnode",name:"publish",access:"write",description:"Publish a Hashnode post via the web editor (or save a draft with --draft). Markdown body + tags/cover/canonical.",domain:"hashnode.com",strategy:E.COOKIE,browser:!0,defaultWindowMode:"foreground",siteSession:"persistent",args:[{name:"title",type:"string",required:!0,help:"Post title"},{name:"body",type:"string",required:!1,help:"Post body in Markdown (or use --body-file)"},{name:"body-file",type:"string",required:!1,help:"Path to a Markdown file for the body"},{name:"tags",type:"string",required:!1,help:"Comma-separated tag names"},{name:"cover-image",type:"string",required:!1,help:"Cover image URL"},{name:"canonical-url",type:"string",required:!1,help:"Canonical / original article URL"},{name:"draft",type:"boolean",required:!1,default:!1,help:"Save as draft instead of publishing"}],columns:["status","draft_id","url"],func:async(e,t)=>{if(!e)throw new a("Browser session required for hashnode publish");const d=String(t.title??"").trim();if(!d)throw new g("hashnode publish: --title is required");const u=resolveBody(t);if(u===void 0)throw new g("--body or --body-file is required");const c=resolveTags(t.tags),f=t["canonical-url"]?String(t["canonical-url"]):"",y=t["cover-image"]?String(t["cover-image"]):"";await e.goto(v);const r=await l(e,P,{label:"auth"});if(!r||!r.ok)throw new q("hashnode.com","Not logged in. Run `ppcli hashnode login`.");const i=await l(e,`(async () => {
       if (location.href.indexOf('hashnode.com') < 0) return { drift: true };
       const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
       const w = [...document.querySelectorAll('a,button')].find((e) => (e.innerText || '').trim() === 'Write');
@@ -16,7 +16,7 @@ import*as M from"node:fs";import{cli as I,Strategy as S}from"@jackwener/opencli/
       while (t < 18000) { await sleep(500); t += 500; if (location.href.indexOf('/draft/') >= 0) break; }
       const m = location.href.match(/\\/draft\\/([a-z0-9]+)/i);
       return m ? { ok: true, draftId: m[1], href: location.href } : { ok: false, reason: 'editor did not open (no /draft/ url) — does the account have a publication?' };
-    })()`,{label:"new-draft"});if(!G||!G.ok)throw new V(`Hashnode could not open the editor: ${G?G.reason:"unknown"}`);const L=G.draftId,Q=`${j}/draft/${L}`;await z.goto(Q);const J=await W(z,`(async () => {
+    })()`,{label:"new-draft"});if(!i||!i.ok)throw new a(`Hashnode could not open the editor: ${i?i.reason:"unknown"}`);const w=i.draftId,n=`${v}/draft/${w}`;await e.goto(n);const h=await l(e,`(async () => {
       if (location.href.indexOf('/draft/') < 0) return { drift: true };
       const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
       let t = 0, title, body;
@@ -27,16 +27,16 @@ import*as M from"node:fs";import{cli as I,Strategy as S}from"@jackwener/opencli/
       if (!title || !body) return { ok: false, reason: 'editor fields not found' };
       const setter = Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value').set;
       title.focus();
-      setter.call(title, ${JSON.stringify(Y)});
+      setter.call(title, ${JSON.stringify(d)});
       title.dispatchEvent(new Event('input', { bubbles: true }));
       title.dispatchEvent(new Event('change', { bubbles: true }));
       await sleep(500);
       body.focus();
       document.execCommand('selectAll', false, null);
-      document.execCommand('insertText', false, ${JSON.stringify(Z)});
+      document.execCommand('insertText', false, ${JSON.stringify(u)});
       await sleep(1500);
       return { ok: true, titleVal: title.value, bodyLen: (body.innerText || '').length };
-    })()`,{label:"fill",anchor:Q});if(!J||!J.ok)throw new V(`Hashnode fill failed: ${J?J.reason:"unknown"}`);if(D.draft)return[{status:"draft",draft_id:L,url:Q}];const A=JSON.stringify($),H=q;await z.goto(Q);const N=await W(z,`(async () => {
+    })()`,{label:"fill",anchor:n});if(!h||!h.ok)throw new a(`Hashnode fill failed: ${h?h.reason:"unknown"}`);if(t.draft)return[{status:"draft",draft_id:w,url:n}];const x=JSON.stringify(c),S=f;await e.goto(n);const b=await l(e,`(async () => {
       if (location.href.indexOf('/draft/') < 0) return { drift: true };
       const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
       let t = 0, tops;
@@ -47,7 +47,7 @@ import*as M from"node:fs";import{cli as I,Strategy as S}from"@jackwener/opencli/
       tops.forEach((b) => b.removeAttribute('data-pp'));
       tops[0].setAttribute('data-pp', 'top-publish');
       return { ok: true };
-    })()`,{label:"publish-ready",anchor:Q});if(!N||!N.ok)throw new V(`Hashnode publish not ready: ${N?N.reason:"unknown"}`);await z.click('[data-pp="top-publish"]');await z.wait(3);const X=await W(z,`(async () => {
+    })()`,{label:"publish-ready",anchor:n});if(!b||!b.ok)throw new a(`Hashnode publish not ready: ${b?b.reason:"unknown"}`);await e.click('[data-pp="top-publish"]');await e.wait(3);const s=await l(e,`(async () => {
       if (location.href.indexOf('hashnode.com') < 0) return { drift: true };
       const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
       let d = 0, dlg;
@@ -61,13 +61,13 @@ import*as M from"node:fs";import{cli as I,Strategy as S}from"@jackwener/opencli/
       var pub = [...dlg.querySelectorAll('button')].find((b) => (b.innerText || '').trim() === 'Publish');
       if (pub) pub.setAttribute('data-pp', 'dlg-publish');
       return { ok: !!pub, hasDiscovery: !!disc };
-    })()`,{label:"dialog-ready",anchor:Q});if(!X||!X.ok)throw new V(`Hashnode publish dialog failed: ${X?X.reason:"unknown"}`);if($.length&&X.hasDiscovery)try{await z.click('[data-pp="discovery-tab"]');await z.wait(2);await W(z,`(async () => {
+    })()`,{label:"dialog-ready",anchor:n});if(!s||!s.ok)throw new a(`Hashnode publish dialog failed: ${s?s.reason:"unknown"}`);if(c.length&&s.hasDiscovery)try{await e.click('[data-pp="discovery-tab"]');await e.wait(2);await l(e,`(async () => {
           if (location.href.indexOf('hashnode.com') < 0) return { drift: true };
           const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
           var ti = document.querySelector('input#editor-tags');
           if (!ti) return { ok: false };
           var setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set;
-          var tags = ${A};
+          var tags = ${x};
           for (var i = 0; i < tags.length; i++) {
             ti.focus(); setter.call(ti, tags[i]); ti.dispatchEvent(new Event('input', { bubbles: true }));
             await sleep(500);
@@ -75,18 +75,18 @@ import*as M from"node:fs";import{cli as I,Strategy as S}from"@jackwener/opencli/
             await sleep(500);
           }
           return { ok: true };
-        })()`,{label:"tags",anchor:Q})}catch(T){}if(H)try{await W(z,`(async () => {
+        })()`,{label:"tags",anchor:n})}catch(m){}if(S)try{await l(e,`(async () => {
           if (location.href.indexOf('hashnode.com') < 0) return { drift: true };
           const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
           var toggle = [...document.querySelectorAll('label,button')].find((e) => /add a canonical url/i.test(e.innerText || ''));
           if (toggle && !document.querySelector('input[placeholder="https://example.com/original-article"]')) { toggle.setAttribute('data-pp','canon-toggle'); }
           return { ok: true };
-        })()`,{label:"canon-prep",anchor:Q});await z.click('[data-pp="canon-toggle"]').catch(()=>{});await z.wait(1);await z.evaluate(`(() => {
+        })()`,{label:"canon-prep",anchor:n});await e.click('[data-pp="canon-toggle"]').catch(()=>{});await e.wait(1);await e.evaluate(`(() => {
           var ci = document.querySelector('input[placeholder="https://example.com/original-article"]');
-          if (ci) { var s = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype,'value').set; ci.focus(); s.call(ci, ${JSON.stringify(H)}); ci.dispatchEvent(new Event('input',{bubbles:true})); ci.dispatchEvent(new Event('blur',{bubbles:true})); }
+          if (ci) { var s = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype,'value').set; ci.focus(); s.call(ci, ${JSON.stringify(S)}); ci.dispatchEvent(new Event('input',{bubbles:true})); ci.dispatchEvent(new Event('blur',{bubbles:true})); }
           return true;
-        })()`)}catch(T){}await z.evaluate(`(() => {
+        })()`)}catch(m){}await e.evaluate(`(() => {
       var dlg = document.querySelector('[role="dialog"][data-state="open"]') || document.querySelector('[role="dialog"]');
       if (dlg) { var pub = [...dlg.querySelectorAll('button')].find((b) => (b.innerText||'').trim()==='Publish'); if (pub) pub.setAttribute('data-pp','dlg-publish'); }
       return true;
-    })()`);await z.click('[data-pp="dlg-publish"]');let P="";for(let T=0;T<30;T+=1){await z.wait(1);const K=await z.evaluate("(() => location.href)()").catch(()=>"");if(typeof K==="string"&&K.indexOf("/draft/")<0&&K.indexOf("hashnode.com")<0){P=K;break}if(typeof K==="string"&&K.indexOf("/draft/")<0&&K.indexOf("/edit/")<0&&K.indexOf("hashnode.com")>=0){P=K;break}}if(!P)throw new V("Hashnode publish did not navigate to a live article URL (still on /draft or /edit). The post may have been saved but not published.");return[{status:"published",draft_id:L,url:P}]}});
+    })()`);await e.click('[data-pp="dlg-publish"]');let p="";for(let m=0;m<30;m+=1){await e.wait(1);const o=await e.evaluate("(() => location.href)()").catch(()=>"");if(typeof o==="string"&&o.indexOf("/draft/")<0&&o.indexOf("hashnode.com")<0){p=o;break}if(typeof o==="string"&&o.indexOf("/draft/")<0&&o.indexOf("/edit/")<0&&o.indexOf("hashnode.com")>=0){p=o;break}}if(!p)throw new a("Hashnode publish did not navigate to a live article URL (still on /draft or /edit). The post may have been saved but not published.");return[{status:"published",draft_id:w,url:p}]}});

package/clis/hf/auth.js

@@ -1,4 +1,4 @@
-import{AuthRequiredError as G,CommandExecutionError as F}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as K}from"../_shared/site-auth.js";const J=`(async () => {
+import{AuthRequiredError as a,CommandExecutionError as n}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as r}from"../_shared/site-auth.js";const i=`(async () => {
   try {
     const r = await fetch('/api/whoami-v2', { credentials: 'include', headers: { Accept: 'application/json' } });
     if (r.status === 401 || r.status === 403) return { kind: 'auth', detail: 'HF /api/whoami-v2 HTTP ' + r.status };
@@ -9,4 +9,4 @@ import{AuthRequiredError as G,CommandExecutionError as F}from"@jackwener/opencli
   } catch (e) {
     return { kind: 'exception', detail: String(e && e.message || e) };
   }
-})()`;async function L(D){await D.goto("https://huggingface.co/");await D.wait(1);const z=await D.evaluate(J);if(z?.kind==="auth")throw new G("huggingface.co",z.detail);if(z?.kind==="http")throw new F(`HTTP ${z.httpStatus} from HF /api/whoami-v2`);if(z?.kind==="exception")throw new F(`HF whoami failed: ${z.detail}`);if(!z?.ok)throw new F(`Unexpected HF probe: ${JSON.stringify(z)}`);return{username:z.username,fullname:z.fullname,type:z.type}}K({site:"hf",domain:"huggingface.co",loginUrl:"https://huggingface.co/login",columns:["username","fullname","type"],verify:L,poll:async(D)=>{const z=await D.evaluate(J);if(!z?.ok)throw new G("huggingface.co","Waiting for Hugging Face login");return{username:z.username,fullname:z.fullname,type:z.type}}});
+})()`;async function o(e){await e.goto("https://huggingface.co/");await e.wait(1);const t=await e.evaluate(i);if(t?.kind==="auth")throw new a("huggingface.co",t.detail);if(t?.kind==="http")throw new n(`HTTP ${t.httpStatus} from HF /api/whoami-v2`);if(t?.kind==="exception")throw new n(`HF whoami failed: ${t.detail}`);if(!t?.ok)throw new n(`Unexpected HF probe: ${JSON.stringify(t)}`);return{username:t.username,fullname:t.fullname,type:t.type}}r({site:"hf",domain:"huggingface.co",loginUrl:"https://huggingface.co/login",columns:["username","fullname","type"],verify:o,poll:async(e)=>{const t=await e.evaluate(i);if(!t?.ok)throw new a("huggingface.co","Waiting for Hugging Face login");return{username:t.username,fullname:t.fullname,type:t.type}}});

package/clis/hf/models.js

@@ -1 +1 @@
-import{cli as y,Strategy as S}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as l,EmptyResultError as k}from"@jackwener/opencli/errors";const d=["downloads","likes","trending","created_at","last_modified"],b={lastmodified:"last_modified",createdat:"created_at"};y({site:"hf",name:"models",access:"read",description:"Top Hugging Face models (downloads / likes / trending / freshness).",domain:"huggingface.co",strategy:S.PUBLIC,browser:!1,args:[{name:"sort",type:"string",default:"downloads",help:`Sort key: ${d.join(", ")}`},{name:"search",type:"string",required:!1,help:'Optional name/owner substring filter (e.g. "llama", "mistralai/")'},{name:"pipeline",type:"string",required:!1,help:"Filter by pipeline tag (e.g. text-generation, image-classification)"},{name:"limit",type:"int",default:20,help:"Max models (max 100; one API page)."}],columns:["rank","id","author","pipelineTag","downloads","likes","tags","lastModified","url"],func:async(s)=>{const c=String(s.sort??"downloads").toLowerCase(),m=b[c]??c;if(!d.includes(m))throw new n(`hf models sort must be one of ${d.join(", ")}`);const i=Number(s.limit??20);if(!Number.isInteger(i)||i<=0)throw new n("hf models limit must be a positive integer");if(i>100)throw new n("hf models limit must be <= 100");const t=new URL("https://huggingface.co/api/models");t.searchParams.set("sort",m);t.searchParams.set("direction","-1");t.searchParams.set("limit",String(i));t.searchParams.set("full","true");if(s.search)t.searchParams.set("search",String(s.search));if(s.pipeline)t.searchParams.set("pipeline_tag",String(s.pipeline));let r;try{r=await fetch(t,{headers:{Accept:"application/json","User-Agent":"ppcli/1.0 (+https://github.com/jackwener/OpenCLI)"}})}catch(e){throw new l(`hf models request failed: ${e?.message||e}`)}if(!r.ok)throw new l(`hf models failed: HTTP ${r.status}`);let o;try{o=await r.json()}catch(e){throw new l(`hf models returned malformed JSON: ${e?.message||e}`)}const g=Array.isArray(o)?o:[];if(g.length===0)throw new k("hf models","No matching models on huggingface.co.");return g.slice(0,i).map((e,p)=>{const a=e.id||e.modelId||"",h=a.indexOf("/"),f=h>0?a.slice(0,h):"",u=Array.isArray(e.tags)?e.tags.filter((w)=>!w.startsWith("license:")).slice(0,10).join(", "):"";return{rank:p+1,id:a,author:f,pipelineTag:e.pipeline_tag||e.pipelineTag||"",downloads:e.downloads??0,likes:e.likes??0,tags:u,lastModified:e.lastModified?String(e.lastModified).slice(0,10):"",url:a?`https://huggingface.co/${a}`:""}})}});
+import{cli as y,Strategy as S}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as l,EmptyResultError as k}from"@jackwener/opencli/errors";const d=["downloads","likes","trending","created_at","last_modified"],A={lastmodified:"last_modified",createdat:"created_at"};y({site:"hf",name:"models",access:"read",description:"Top Hugging Face models (downloads / likes / trending / freshness).",domain:"huggingface.co",strategy:S.PUBLIC,browser:!1,args:[{name:"sort",type:"string",default:"downloads",help:`Sort key: ${d.join(", ")}`},{name:"search",type:"string",required:!1,help:'Optional name/owner substring filter (e.g. "llama", "mistralai/")'},{name:"pipeline",type:"string",required:!1,help:"Filter by pipeline tag (e.g. text-generation, image-classification)"},{name:"limit",type:"int",default:20,help:"Max models (max 100; one API page)."}],columns:["rank","id","author","pipelineTag","downloads","likes","tags","lastModified","url"],func:async(i)=>{const c=String(i.sort??"downloads").toLowerCase(),m=A[c]??c;if(!d.includes(m))throw new n(`hf models sort must be one of ${d.join(", ")}`);const s=Number(i.limit??20);if(!Number.isInteger(s)||s<=0)throw new n("hf models limit must be a positive integer");if(s>100)throw new n("hf models limit must be <= 100");const t=new URL("https://huggingface.co/api/models");t.searchParams.set("sort",m);t.searchParams.set("direction","-1");t.searchParams.set("limit",String(s));t.searchParams.set("full","true");if(i.search)t.searchParams.set("search",String(i.search));if(i.pipeline)t.searchParams.set("pipeline_tag",String(i.pipeline));let r;try{r=await fetch(t,{headers:{Accept:"application/json","User-Agent":"ppcli/1.0 (+https://github.com/jackwener/OpenCLI)"}})}catch(e){throw new l(`hf models request failed: ${e?.message||e}`)}if(!r.ok)throw new l(`hf models failed: HTTP ${r.status}`);let o;try{o=await r.json()}catch(e){throw new l(`hf models returned malformed JSON: ${e?.message||e}`)}const g=Array.isArray(o)?o:[];if(g.length===0)throw new k("hf models","No matching models on huggingface.co.");return g.slice(0,s).map((e,p)=>{const a=e.id||e.modelId||"",h=a.indexOf("/"),f=h>0?a.slice(0,h):"",u=Array.isArray(e.tags)?e.tags.filter((w)=>!w.startsWith("license:")).slice(0,10).join(", "):"";return{rank:p+1,id:a,author:f,pipelineTag:e.pipeline_tag||e.pipelineTag||"",downloads:e.downloads??0,likes:e.likes??0,tags:u,lastModified:e.lastModified?String(e.lastModified).slice(0,10):"",url:a?`https://huggingface.co/${a}`:""}})}});

package/clis/hf/paper.js

@@ -1 +1 @@
-import{cli as c,Strategy as h}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as i,EmptyResultError as p}from"@jackwener/opencli/errors";const m=/^\d{4}\.\d{4,5}(?:v\d+)?$/;c({site:"hf",name:"paper",access:"read",description:"Hugging Face paper detail by arXiv id (full title / summary / authors / AI keywords)",domain:"huggingface.co",strategy:h.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'arXiv id (e.g. "1706.03762") — same value HF uses to mirror the paper'}],columns:["id","title","authors","publishedAt","upvotes","aiKeywords","summary","aiSummary","url"],func:async(o)=>{const a=String(o.id??"").trim();if(!a)throw new n("hf paper id cannot be empty","Example: ppcli hf paper 1706.03762");if(!m.test(a))throw new n(`hf paper id "${o.id}" is not a valid arXiv id`,"Expected the modern arXiv form `YYMM.NNNNN` (optionally with a version suffix like `v3`).");const s=process.env.HF_ENDPOINT?.replace(/\/+$/,"")||"https://huggingface.co",u=`${s}/api/papers/${encodeURIComponent(a)}`;let t;try{t=await fetch(u,{headers:{accept:"application/json"}})}catch(r){throw new i(`hf paper request failed: ${r?.message??r}`)}if(t.status===404)throw new p("hf paper",`Hugging Face has no paper page for "${a}".`);if(t.status===429)throw new i("hf paper returned HTTP 429 (rate limited)","Hugging Face throttles unauthenticated traffic; wait a few seconds and retry.");if(!t.ok)throw new i(`hf paper returned HTTP ${t.status}`);let e;try{e=await t.json()}catch(r){throw new i(`hf paper returned malformed JSON: ${r?.message??r}`)}if(!e||typeof e!=="object"||!e.id)throw new p("hf paper",`Hugging Face returned no paper data for "${a}".`);const d=Array.isArray(e.authors)?e.authors.map((r)=>typeof r==="object"&&r?r.name||r.fullname||"":String(r)).filter(Boolean):[],l=Array.isArray(e.ai_keywords)?e.ai_keywords.join(", "):"";return[{id:String(e.id),title:String(e.title??""),authors:d.join(", "),publishedAt:String(e.publishedAt??"").slice(0,10),upvotes:e.upvotes!=null?Number(e.upvotes):null,aiKeywords:l,summary:String(e.summary??""),aiSummary:String(e.ai_summary??""),url:`${s}/papers/${e.id}`}]}});
+import{cli as m,Strategy as c}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as i,EmptyResultError as p}from"@jackwener/opencli/errors";const h=/^\d{4}\.\d{4,5}(?:v\d+)?$/;m({site:"hf",name:"paper",access:"read",description:"Hugging Face paper detail by arXiv id (full title / summary / authors / AI keywords)",domain:"huggingface.co",strategy:c.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'arXiv id (e.g. "1706.03762") — same value HF uses to mirror the paper'}],columns:["id","title","authors","publishedAt","upvotes","aiKeywords","summary","aiSummary","url"],func:async(o)=>{const a=String(o.id??"").trim();if(!a)throw new n("hf paper id cannot be empty","Example: ppcli hf paper 1706.03762");if(!h.test(a))throw new n(`hf paper id "${o.id}" is not a valid arXiv id`,"Expected the modern arXiv form `YYMM.NNNNN` (optionally with a version suffix like `v3`).");const s=process.env.HF_ENDPOINT?.replace(/\/+$/,"")||"https://huggingface.co",u=`${s}/api/papers/${encodeURIComponent(a)}`;let t;try{t=await fetch(u,{headers:{accept:"application/json"}})}catch(r){throw new i(`hf paper request failed: ${r?.message??r}`)}if(t.status===404)throw new p("hf paper",`Hugging Face has no paper page for "${a}".`);if(t.status===429)throw new i("hf paper returned HTTP 429 (rate limited)","Hugging Face throttles unauthenticated traffic; wait a few seconds and retry.");if(!t.ok)throw new i(`hf paper returned HTTP ${t.status}`);let e;try{e=await t.json()}catch(r){throw new i(`hf paper returned malformed JSON: ${r?.message??r}`)}if(!e||typeof e!=="object"||!e.id)throw new p("hf paper",`Hugging Face returned no paper data for "${a}".`);const d=Array.isArray(e.authors)?e.authors.map((r)=>typeof r==="object"&&r?r.name||r.fullname||"":String(r)).filter(Boolean):[],l=Array.isArray(e.ai_keywords)?e.ai_keywords.join(", "):"";return[{id:String(e.id),title:String(e.title??""),authors:d.join(", "),publishedAt:String(e.publishedAt??"").slice(0,10),upvotes:e.upvotes!=null?Number(e.upvotes):null,aiKeywords:l,summary:String(e.summary??""),aiSummary:String(e.ai_summary??""),url:`${s}/papers/${e.id}`}]}});

package/clis/hf/spaces.js

@@ -1 +1 @@
-import{cli as S,Strategy as y}from"@jackwener/opencli/registry";import{ArgumentError as o,CommandExecutionError as n,EmptyResultError as b}from"@jackwener/opencli/errors";const d=["likes","created_at","last_modified"],P={lastmodified:"last_modified",createdat:"created_at"};S({site:"hf",name:"spaces",access:"read",description:"Top Hugging Face Spaces (likes / created_at / last_modified).",domain:"huggingface.co",strategy:y.PUBLIC,browser:!1,args:[{name:"sort",type:"string",default:"likes",help:`Sort key: ${d.join(", ")}`},{name:"search",type:"string",required:!1,help:'Optional name/owner substring filter (e.g. "stability", "openai/")'},{name:"sdk",type:"string",required:!1,help:"Filter by Space SDK: gradio / streamlit / docker / static"},{name:"limit",type:"int",default:20,help:"Max spaces (max 100; one API page)."}],columns:["rank","id","author","sdk","likes","tags","lastModified","url"],func:async(s)=>{const h=String(s.sort??"likes").toLowerCase(),f=P[h]??h;if(!d.includes(f))throw new o(`hf spaces sort must be one of ${d.join(", ")}`);const a=Number(s.limit??20);if(!Number.isInteger(a)||a<=0)throw new o("hf spaces limit must be a positive integer");if(a>100)throw new o("hf spaces limit must be <= 100");const c=s.sdk==null?"":String(s.sdk).trim().toLowerCase();if(!new Set(["","gradio","streamlit","docker","static"]).has(c))throw new o("hf spaces sdk must be one of gradio / streamlit / docker / static");const t=new URL("https://huggingface.co/api/spaces");t.searchParams.set("sort",f);t.searchParams.set("direction","-1");t.searchParams.set("limit",String(a));t.searchParams.set("full","true");if(s.search)t.searchParams.set("search",String(s.search));if(c)t.searchParams.set("sdk",c);let r;try{r=await fetch(t,{headers:{Accept:"application/json","User-Agent":"ppcli/1.0 (+https://github.com/jackwener/OpenCLI)"}})}catch(e){throw new n(`hf spaces request failed: ${e?.message??e}`)}if(r.status===429)throw new n("hf spaces returned HTTP 429 (rate limited)","Hugging Face throttles unauthenticated traffic; wait a few seconds and retry.");if(!r.ok)throw new n(`hf spaces failed: HTTP ${r.status}`);let l;try{l=await r.json()}catch(e){throw new n(`hf spaces returned malformed JSON: ${e?.message??e}`)}const m=Array.isArray(l)?l:[];if(!m.length)throw new b("hf spaces","No matching spaces on huggingface.co.");return m.slice(0,a).map((e,p)=>{const i=String(e.id??e._id??""),g=i.indexOf("/"),u=String(e.author??(g>0?i.slice(0,g):"")),w=Array.isArray(e.tags)?e.tags.filter((k)=>!String(k).startsWith("license:")).slice(0,10).join(", "):"";return{rank:p+1,id:i,author:u,sdk:String(e.sdk??""),likes:e.likes!=null?Number(e.likes):null,tags:w,lastModified:String(e.lastModified??"").slice(0,10),url:i?`https://huggingface.co/spaces/${i}`:""}})}});
+import{cli as S,Strategy as y}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as o,EmptyResultError as b}from"@jackwener/opencli/errors";const d=["likes","created_at","last_modified"],P={lastmodified:"last_modified",createdat:"created_at"};S({site:"hf",name:"spaces",access:"read",description:"Top Hugging Face Spaces (likes / created_at / last_modified).",domain:"huggingface.co",strategy:y.PUBLIC,browser:!1,args:[{name:"sort",type:"string",default:"likes",help:`Sort key: ${d.join(", ")}`},{name:"search",type:"string",required:!1,help:'Optional name/owner substring filter (e.g. "stability", "openai/")'},{name:"sdk",type:"string",required:!1,help:"Filter by Space SDK: gradio / streamlit / docker / static"},{name:"limit",type:"int",default:20,help:"Max spaces (max 100; one API page)."}],columns:["rank","id","author","sdk","likes","tags","lastModified","url"],func:async(s)=>{const h=String(s.sort??"likes").toLowerCase(),m=P[h]??h;if(!d.includes(m))throw new n(`hf spaces sort must be one of ${d.join(", ")}`);const a=Number(s.limit??20);if(!Number.isInteger(a)||a<=0)throw new n("hf spaces limit must be a positive integer");if(a>100)throw new n("hf spaces limit must be <= 100");const c=s.sdk==null?"":String(s.sdk).trim().toLowerCase();if(!new Set(["","gradio","streamlit","docker","static"]).has(c))throw new n("hf spaces sdk must be one of gradio / streamlit / docker / static");const t=new URL("https://huggingface.co/api/spaces");t.searchParams.set("sort",m);t.searchParams.set("direction","-1");t.searchParams.set("limit",String(a));t.searchParams.set("full","true");if(s.search)t.searchParams.set("search",String(s.search));if(c)t.searchParams.set("sdk",c);let r;try{r=await fetch(t,{headers:{Accept:"application/json","User-Agent":"ppcli/1.0 (+https://github.com/jackwener/OpenCLI)"}})}catch(e){throw new o(`hf spaces request failed: ${e?.message??e}`)}if(r.status===429)throw new o("hf spaces returned HTTP 429 (rate limited)","Hugging Face throttles unauthenticated traffic; wait a few seconds and retry.");if(!r.ok)throw new o(`hf spaces failed: HTTP ${r.status}`);let l;try{l=await r.json()}catch(e){throw new o(`hf spaces returned malformed JSON: ${e?.message??e}`)}const f=Array.isArray(l)?l:[];if(!f.length)throw new b("hf spaces","No matching spaces on huggingface.co.");return f.slice(0,a).map((e,p)=>{const i=String(e.id??e._id??""),g=i.indexOf("/"),u=String(e.author??(g>0?i.slice(0,g):"")),w=Array.isArray(e.tags)?e.tags.filter((k)=>!String(k).startsWith("license:")).slice(0,10).join(", "):"";return{rank:p+1,id:i,author:u,sdk:String(e.sdk??""),likes:e.likes!=null?Number(e.likes):null,tags:w,lastModified:String(e.lastModified??"").slice(0,10),url:i?`https://huggingface.co/spaces/${i}`:""}})}});

package/clis/hf/top.js

@@ -1 +1 @@
-import{cli as A,Strategy as _}from"@jackwener/opencli/registry";import{CliError as l}from"@jackwener/opencli/errors";function R(t,e=60){return t.length>e?t.slice(0,e-3)+"...":t}function w(t,e=3){const a=t.map((n)=>n.name);if(a.length<=e)return a.join(", ");return a.slice(0,e).join(", ")+" et al."}const c=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"];function F(){const t=new Date;return`${c[t.getUTCMonth()]} ${t.getUTCFullYear()}`}function I(){const t=new Date,e=t.getUTCDay(),a=e===6?0:6-e,n=new Date(t);n.setUTCDate(t.getUTCDate()+a);const d=new Date(n);d.setUTCDate(n.getUTCDate()-6);const r=c[d.getUTCMonth()],u=c[n.getUTCMonth()],m=d.getUTCDate(),h=n.getUTCDate();return r===u?`${r} ${m}-${h}`:`${r} ${m}-${u} ${h}`}A({site:"hf",name:"top",access:"read",description:"Top upvoted Hugging Face papers",domain:"huggingface.co",strategy:_.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of papers"},{name:"all",type:"bool",default:!1,help:"Return all papers (ignore limit)"},{name:"date",type:"str",required:!1,help:"Date (YYYY-MM-DD), defaults to most recent"},{name:"period",type:"str",default:"daily",choices:["daily","weekly","monthly"],help:"Time period: daily, weekly, or monthly"}],columns:["rank","id","title","upvotes","authors"],footerExtra:(t)=>{if(t._footerDate)return t._footerDate;if(t.period==="monthly")return F();if(t.period==="weekly")return I();return t.date??new Date().toISOString().slice(0,10)},func:async(t)=>{const e=String(t.period??"daily"),a=Boolean(t.all),n=process.env.HF_ENDPOINT?.replace(/\/+$/,"")||"https://huggingface.co";if(e==="weekly"||e==="monthly"){if(t.date)throw new l("INVALID_ARG",`--date is not supported for ${e} period`,`Omit --date when using --period ${e}`);const s=`${n}/api/papers?period=${e}`,i=await fetch(s);if(!i.ok)throw new l("FETCH_ERROR",`HF API error: ${i.status} ${i.statusText}`,"Check HF_ENDPOINT or try again later");const D=await i.json();if(!Array.isArray(D))throw new l("FETCH_ERROR","Unexpected HF API response","Check endpoint");const $=D,f=$.map((o)=>o.publishedAt).filter(Boolean).sort();if(f.length>0)if(e==="monthly"){const o=new Date(f[0]);t._footerDate=`${c[o.getUTCMonth()]} ${o.getUTCFullYear()}`}else{const o=new Date(f[0]),p=new Date(f[f.length-1]),y=c[o.getUTCMonth()],g=c[p.getUTCMonth()],C=o.getUTCDate(),U=p.getUTCDate();t._footerDate=y===g?`${y} ${C}-${U}`:`${y} ${C}-${g} ${U}`}const T=[...$].sort((o,p)=>(p.upvotes??0)-(o.upvotes??0));return(a?T:T.slice(0,Number(t.limit))).map((o,p)=>({rank:p+1,id:o.id??"",title:R(o.title??""),upvotes:o.upvotes??0,authors:w(o.authors??[])}))}if(t.date&&!/^\d{4}-\d{2}-\d{2}$/.test(String(t.date)))throw new l("INVALID_ARG",`Invalid date format: ${t.date}`,"Use YYYY-MM-DD");const d=t.date?`${n}/api/daily_papers?date=${t.date}`:`${n}/api/daily_papers`,r=await fetch(d);if(!r.ok)throw new l("FETCH_ERROR",`HF API error: ${r.status} ${r.statusText}`,"Check HF_ENDPOINT or try again later");const u=await r.json();if(!Array.isArray(u))throw new l("FETCH_ERROR","Unexpected HF API response","Check date format or endpoint");const h=[...u].sort((s,i)=>(i.paper?.upvotes??0)-(s.paper?.upvotes??0));return(a?h:h.slice(0,Number(t.limit))).map((s,i)=>({rank:i+1,id:s.paper?.id??"",title:R(s.title??""),upvotes:s.paper?.upvotes??0,authors:w(s.paper?.authors??[])}))}});
+import{cli as _,Strategy as F}from"@jackwener/opencli/registry";import{CliError as l}from"@jackwener/opencli/errors";function w(t,e=60){return t.length>e?t.slice(0,e-3)+"...":t}function A(t,e=3){const a=t.map((n)=>n.name);if(a.length<=e)return a.join(", ");return a.slice(0,e).join(", ")+" et al."}const c=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"];function I(){const t=new Date;return`${c[t.getUTCMonth()]} ${t.getUTCFullYear()}`}function M(){const t=new Date,e=t.getUTCDay(),a=e===6?0:6-e,n=new Date(t);n.setUTCDate(t.getUTCDate()+a);const d=new Date(n);d.setUTCDate(n.getUTCDate()-6);const r=c[d.getUTCMonth()],u=c[n.getUTCMonth()],m=d.getUTCDate(),h=n.getUTCDate();return r===u?`${r} ${m}-${h}`:`${r} ${m}-${u} ${h}`}_({site:"hf",name:"top",access:"read",description:"Top upvoted Hugging Face papers",domain:"huggingface.co",strategy:F.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of papers"},{name:"all",type:"bool",default:!1,help:"Return all papers (ignore limit)"},{name:"date",type:"str",required:!1,help:"Date (YYYY-MM-DD), defaults to most recent"},{name:"period",type:"str",default:"daily",choices:["daily","weekly","monthly"],help:"Time period: daily, weekly, or monthly"}],columns:["rank","id","title","upvotes","authors"],footerExtra:(t)=>{if(t._footerDate)return t._footerDate;if(t.period==="monthly")return I();if(t.period==="weekly")return M();return t.date??new Date().toISOString().slice(0,10)},func:async(t)=>{const e=String(t.period??"daily"),a=Boolean(t.all),n=process.env.HF_ENDPOINT?.replace(/\/+$/,"")||"https://huggingface.co";if(e==="weekly"||e==="monthly"){if(t.date)throw new l("INVALID_ARG",`--date is not supported for ${e} period`,`Omit --date when using --period ${e}`);const s=`${n}/api/papers?period=${e}`,i=await fetch(s);if(!i.ok)throw new l("FETCH_ERROR",`HF API error: ${i.status} ${i.statusText}`,"Check HF_ENDPOINT or try again later");const D=await i.json();if(!Array.isArray(D))throw new l("FETCH_ERROR","Unexpected HF API response","Check endpoint");const T=D,f=T.map((o)=>o.publishedAt).filter(Boolean).sort();if(f.length>0)if(e==="monthly"){const o=new Date(f[0]);t._footerDate=`${c[o.getUTCMonth()]} ${o.getUTCFullYear()}`}else{const o=new Date(f[0]),p=new Date(f[f.length-1]),y=c[o.getUTCMonth()],C=c[p.getUTCMonth()],U=o.getUTCDate(),R=p.getUTCDate();t._footerDate=y===C?`${y} ${U}-${R}`:`${y} ${U}-${C} ${R}`}const g=[...T].sort((o,p)=>(p.upvotes??0)-(o.upvotes??0));return(a?g:g.slice(0,Number(t.limit))).map((o,p)=>({rank:p+1,id:o.id??"",title:w(o.title??""),upvotes:o.upvotes??0,authors:A(o.authors??[])}))}if(t.date&&!/^\d{4}-\d{2}-\d{2}$/.test(String(t.date)))throw new l("INVALID_ARG",`Invalid date format: ${t.date}`,"Use YYYY-MM-DD");const d=t.date?`${n}/api/daily_papers?date=${t.date}`:`${n}/api/daily_papers`,r=await fetch(d);if(!r.ok)throw new l("FETCH_ERROR",`HF API error: ${r.status} ${r.statusText}`,"Check HF_ENDPOINT or try again later");const u=await r.json();if(!Array.isArray(u))throw new l("FETCH_ERROR","Unexpected HF API response","Check date format or endpoint");const h=[...u].sort((s,i)=>(i.paper?.upvotes??0)-(s.paper?.upvotes??0));return(a?h:h.slice(0,Number(t.limit))).map((s,i)=>({rank:i+1,id:s.paper?.id??"",title:w(s.title??""),upvotes:s.paper?.upvotes??0,authors:A(s.paper?.authors??[])}))}});

package/clis/homebrew/cask.js

@@ -1 +1 @@
-import{cli as n,Strategy as s}from"@jackwener/opencli/registry";import{BREW_BASE as i,brewFetch as d,requireToken as m}from"./utils.js";n({site:"homebrew",name:"cask",access:"read",description:"Fetch a Homebrew cask's metadata (version, homepage, deprecation, download URL)",domain:"formulae.brew.sh",strategy:s.PUBLIC,browser:!1,args:[{name:"token",positional:!0,required:!0,help:'Cask token (e.g. "firefox", "visual-studio-code", "google-chrome")'}],columns:["cask","tap","name","version","description","homepage","deprecated","disabled","download","url"],func:async(a)=>{const o=m(a.token,"token"),r=`${i}/cask/${encodeURIComponent(o)}.json`,e=await d(r,"homebrew cask"),t=Array.isArray(e?.name)?e.name.filter(Boolean).join(", "):String(e?.name??"").trim();return[{cask:String(e?.token??o).trim(),tap:String(e?.tap??"").trim(),name:t,version:String(e?.version??"").trim(),description:String(e?.desc??"").trim(),homepage:String(e?.homepage??"").trim(),deprecated:Boolean(e?.deprecated),disabled:Boolean(e?.disabled),download:String(e?.url??"").trim(),url:`https://formulae.brew.sh/cask/${encodeURIComponent(o)}`}]}});
+import{cli as n,Strategy as i}from"@jackwener/opencli/registry";import{BREW_BASE as s,brewFetch as d,requireToken as m}from"./utils.js";n({site:"homebrew",name:"cask",access:"read",description:"Fetch a Homebrew cask's metadata (version, homepage, deprecation, download URL)",domain:"formulae.brew.sh",strategy:i.PUBLIC,browser:!1,args:[{name:"token",positional:!0,required:!0,help:'Cask token (e.g. "firefox", "visual-studio-code", "google-chrome")'}],columns:["cask","tap","name","version","description","homepage","deprecated","disabled","download","url"],func:async(r)=>{const o=m(r.token,"token"),t=`${s}/cask/${encodeURIComponent(o)}.json`,e=await d(t,"homebrew cask"),a=Array.isArray(e?.name)?e.name.filter(Boolean).join(", "):String(e?.name??"").trim();return[{cask:String(e?.token??o).trim(),tap:String(e?.tap??"").trim(),name:a,version:String(e?.version??"").trim(),description:String(e?.desc??"").trim(),homepage:String(e?.homepage??"").trim(),deprecated:Boolean(e?.deprecated),disabled:Boolean(e?.disabled),download:String(e?.url??"").trim(),url:`https://formulae.brew.sh/cask/${encodeURIComponent(o)}`}]}});

package/clis/homebrew/formula.js

@@ -1 +1 @@
-import{cli as s,Strategy as i}from"@jackwener/opencli/registry";import{BREW_BASE as m,brewFetch as l,requireToken as c}from"./utils.js";s({site:"homebrew",name:"formula",access:"read",description:"Fetch a Homebrew formula's metadata (version, license, deps, deprecation, source)",domain:"formulae.brew.sh",strategy:i.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'Formula name (e.g. "wget", "gcc@13", "imagemagick")'}],columns:["formula","tap","version","license","description","homepage","dependencies","deprecated","disabled","source","url"],func:async(a)=>{const r=c(a.name,"formula"),o=`${m}/formula/${encodeURIComponent(r)}.json`,e=await l(o,"homebrew formula"),n=Array.isArray(e?.dependencies)?e.dependencies.filter(Boolean):[],t=String(e?.urls?.stable?.url??"").trim();return[{formula:String(e?.name??r).trim(),tap:String(e?.tap??"").trim(),version:String(e?.versions?.stable??"").trim(),license:String(e?.license??"").trim(),description:String(e?.desc??"").trim(),homepage:String(e?.homepage??"").trim(),dependencies:n.join(", "),deprecated:Boolean(e?.deprecated),disabled:Boolean(e?.disabled),source:t,url:`https://formulae.brew.sh/formula/${encodeURIComponent(r)}`}]}});
+import{cli as i,Strategy as s}from"@jackwener/opencli/registry";import{BREW_BASE as m,brewFetch as c,requireToken as l}from"./utils.js";i({site:"homebrew",name:"formula",access:"read",description:"Fetch a Homebrew formula's metadata (version, license, deps, deprecation, source)",domain:"formulae.brew.sh",strategy:s.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'Formula name (e.g. "wget", "gcc@13", "imagemagick")'}],columns:["formula","tap","version","license","description","homepage","dependencies","deprecated","disabled","source","url"],func:async(o)=>{const r=l(o.name,"formula"),n=`${m}/formula/${encodeURIComponent(r)}.json`,e=await c(n,"homebrew formula"),a=Array.isArray(e?.dependencies)?e.dependencies.filter(Boolean):[],t=String(e?.urls?.stable?.url??"").trim();return[{formula:String(e?.name??r).trim(),tap:String(e?.tap??"").trim(),version:String(e?.versions?.stable??"").trim(),license:String(e?.license??"").trim(),description:String(e?.desc??"").trim(),homepage:String(e?.homepage??"").trim(),dependencies:a.join(", "),deprecated:Boolean(e?.deprecated),disabled:Boolean(e?.disabled),source:t,url:`https://formulae.brew.sh/formula/${encodeURIComponent(r)}`}]}});

package/clis/homebrew/popular.js

@@ -1 +1 @@
-import{cli as w,Strategy as h}from"@jackwener/opencli/registry";import{EmptyResultError as b}from"@jackwener/opencli/errors";import{BREW_BASE as y,brewFetch as f,parseInstallCount as k,requireBoundedInt as g,requireOneOf as l}from"./utils.js";const i=["formula","cask"],m=["30d","90d","365d"];w({site:"homebrew",name:"popular",access:"read",description:"List most-installed Homebrew formulae or casks (Homebrew's analytics ranking)",domain:"formulae.brew.sh",strategy:h.PUBLIC,browser:!1,args:[{name:"type",default:"formula",help:`Package type (${i.join(" / ")})`},{name:"window",default:"30d",help:`Time window (${m.join(" / ")})`},{name:"limit",type:"int",default:30,help:"Max rows (1-500)"}],columns:["rank","token","type","installs","percent","window","url"],func:async(n)=>{const t=l(n.type,i,"type"),s=l(n.window,m,"window"),c=g(n.limit,30,500),u=`${y}/analytics/${t==="cask"?"cask-install":"install"}/${s}.json`,o=await f(u,"homebrew popular"),r=Array.isArray(o?.items)?o.items:[];if(!r.length)throw new b("homebrew popular",`Homebrew analytics returned no items for ${t}/${s}.`);return r.slice(0,c).map((e,p)=>{const a=String(t==="cask"?e.cask:e.formula??"").trim(),d=t==="cask"?"cask":"formula";return{rank:e.number!=null?Number(e.number):p+1,token:a,type:t,installs:k(e.count),percent:e.percent!=null?Number(e.percent):null,window:s,url:a?`https://formulae.brew.sh/${d}/${encodeURIComponent(a)}`:""}})}});
+import{cli as w,Strategy as f}from"@jackwener/opencli/registry";import{EmptyResultError as y}from"@jackwener/opencli/errors";import{BREW_BASE as b,brewFetch as h,parseInstallCount as k,requireBoundedInt as g,requireOneOf as l}from"./utils.js";const i=["formula","cask"],m=["30d","90d","365d"];w({site:"homebrew",name:"popular",access:"read",description:"List most-installed Homebrew formulae or casks (Homebrew's analytics ranking)",domain:"formulae.brew.sh",strategy:f.PUBLIC,browser:!1,args:[{name:"type",default:"formula",help:`Package type (${i.join(" / ")})`},{name:"window",default:"30d",help:`Time window (${m.join(" / ")})`},{name:"limit",type:"int",default:30,help:"Max rows (1-500)"}],columns:["rank","token","type","installs","percent","window","url"],func:async(n)=>{const t=l(n.type,i,"type"),r=l(n.window,m,"window"),c=g(n.limit,30,500),u=`${b}/analytics/${t==="cask"?"cask-install":"install"}/${r}.json`,o=await h(u,"homebrew popular"),s=Array.isArray(o?.items)?o.items:[];if(!s.length)throw new y("homebrew popular",`Homebrew analytics returned no items for ${t}/${r}.`);return s.slice(0,c).map((e,p)=>{const a=String(t==="cask"?e.cask:e.formula??"").trim(),d=t==="cask"?"cask":"formula";return{rank:e.number!=null?Number(e.number):p+1,token:a,type:t,installs:k(e.count),percent:e.percent!=null?Number(e.percent):null,window:r,url:a?`https://formulae.brew.sh/${d}/${encodeURIComponent(a)}`:""}})}});

package/clis/homebrew/utils.js

@@ -1 +1 @@
-import{ArgumentError as G,CommandExecutionError as J,EmptyResultError as L}from"@jackwener/opencli/errors";export const BREW_BASE="https://formulae.brew.sh/api";const M="opencli-homebrew-adapter (+https://github.com/jackwener/OpenCLI)",P=/^[A-Za-z0-9][A-Za-z0-9._+@-]*$/;export function requireString(B,z){const q=String(B??"").trim();if(!q)throw new G(`homebrew ${z} cannot be empty`);return q}export function requireBoundedInt(B,z,q,D="limit"){const F=B??z,I=typeof F==="number"?F:Number(F);if(!Number.isInteger(I)||I<=0)throw new G(`homebrew ${D} must be a positive integer`);if(I>q)throw new G(`homebrew ${D} must be <= ${q}`);return I}export function requireToken(B,z){const q=String(B??"").trim();if(!q)throw new G(`homebrew ${z} is required (e.g. "wget", "gcc@13", "firefox")`);if(q.length>100||!P.test(q))throw new G(`homebrew ${z} "${B}" is not a valid token`,'Use letters / digits / "_-.+@", starting with a letter or digit (max 100 chars).');return q}export function requireOneOf(B,z,q){const D=String(B??"").trim().toLowerCase();if(!D)throw new G(`homebrew ${q} is required`);if(!z.includes(D))throw new G(`homebrew ${q} "${B}" is not supported`,`Allowed: ${z.join(", ")}.`);return D}export async function brewFetch(B,z){let q;try{q=await fetch(B,{headers:{"user-agent":M,accept:"application/json"}})}catch(F){throw new J(`${z} request failed: ${F?.message??F}`,"Check that formulae.brew.sh is reachable from this network.")}if(q.status===404)throw new L(z,`Homebrew API returned 404 for ${B}.`);if(q.status===429)throw new J(`${z} returned HTTP 429 (rate limited)`,"Homebrew throttles bursts; wait a few seconds and retry.");if(!q.ok)throw new J(`${z} returned HTTP ${q.status}`);let D;try{D=await q.json()}catch(F){throw new J(`${z} returned malformed JSON: ${F?.message??F}`)}return D}export function parseInstallCount(B){if(B==null)return null;const z=String(B).replace(/,/g,"").trim();if(!z)return null;const q=Number(z);return Number.isFinite(q)?q:null}
+import{ArgumentError as i,CommandExecutionError as w,EmptyResultError as u}from"@jackwener/opencli/errors";export const BREW_BASE="https://formulae.brew.sh/api";const c="opencli-homebrew-adapter (+https://github.com/jackwener/OpenCLI)",h=/^[A-Za-z0-9][A-Za-z0-9._+@-]*$/;export function requireString(t,r){const e=String(t??"").trim();if(!e)throw new i(`homebrew ${r} cannot be empty`);return e}export function requireBoundedInt(t,r,e,n="limit"){const o=t??r,s=typeof o==="number"?o:Number(o);if(!Number.isInteger(s)||s<=0)throw new i(`homebrew ${n} must be a positive integer`);if(s>e)throw new i(`homebrew ${n} must be <= ${e}`);return s}export function requireToken(t,r){const e=String(t??"").trim();if(!e)throw new i(`homebrew ${r} is required (e.g. "wget", "gcc@13", "firefox")`);if(e.length>100||!h.test(e))throw new i(`homebrew ${r} "${t}" is not a valid token`,'Use letters / digits / "_-.+@", starting with a letter or digit (max 100 chars).');return e}export function requireOneOf(t,r,e){const n=String(t??"").trim().toLowerCase();if(!n)throw new i(`homebrew ${e} is required`);if(!r.includes(n))throw new i(`homebrew ${e} "${t}" is not supported`,`Allowed: ${r.join(", ")}.`);return n}export async function brewFetch(t,r){let e;try{e=await fetch(t,{headers:{"user-agent":c,accept:"application/json"}})}catch(o){throw new w(`${r} request failed: ${o?.message??o}`,"Check that formulae.brew.sh is reachable from this network.")}if(e.status===404)throw new u(r,`Homebrew API returned 404 for ${t}.`);if(e.status===429)throw new w(`${r} returned HTTP 429 (rate limited)`,"Homebrew throttles bursts; wait a few seconds and retry.");if(!e.ok)throw new w(`${r} returned HTTP ${e.status}`);let n;try{n=await e.json()}catch(o){throw new w(`${r} returned malformed JSON: ${o?.message??o}`)}return n}export function parseInstallCount(t){if(t==null)return null;const r=String(t).replace(/,/g,"").trim();if(!r)return null;const e=Number(r);return Number.isFinite(e)?e:null}

package/clis/huodongxing/events.js

@@ -1 +1 @@
-import{cli as Y,Strategy as v}from"@jackwener/opencli/registry";import{ArgumentError as _,CommandExecutionError as L,EmptyResultError as f}from"@jackwener/opencli/errors";const h="https://www.huodongxing.com/events",b=50;export const EVENTS_COLUMNS=["rank","id","title","time","eventType","city","location","organizer","url"];function X(K){return String(K??"").replace(/\s+/g," ").trim()}export function requireLimit(K){const G=K??20,J=typeof G==="number"?G:Number(String(G).trim());if(!Number.isInteger(J)||J<=0)throw new _("huodongxing limit must be a positive integer");if(J>b)throw new _(`huodongxing limit must be <= ${b}`);return J}function P(K,G,J){const W=X(J);if(W)K.set(G,W)}function M(K,G,J){return Math.floor(Date.UTC(K,G-1,J)/86400000)}function C(K){const G=X(K).match(/^(\d{4})-(\d{2})-(\d{2})$/);if(!G)return null;const J=Number(G[1]),W=Number(G[2]),F=Number(G[3]),$=new Date(Date.UTC(J,W-1,F));if($.getUTCFullYear()!==J||$.getUTCMonth()!==W-1||$.getUTCDate()!==F)return null;return M(J,W,F)}function D(K,G){const J=X(K);if(!J)return"";if(C(J)==null)throw new _(`huodongxing ${G} must be a valid YYYY-MM-DD date`);return J}function A(K={}){const G=D(K.date,"date"),J=D(K.dateTo,"dateTo");if(G&&J&&C(G)>C(J))throw new _("huodongxing date must be <= dateTo");return{date:G,dateTo:J}}function w(K){if(K&&!Array.isArray(K)&&typeof K==="object"&&"session"in K&&"data"in K)return K.data;return K}function T(K){return M(K.getFullYear(),K.getMonth()+1,K.getDate())}function q(K,G){const J=X(K).match(/(\d{1,2})\/(\d{1,2})/);if(!J)return null;return{month:Number(J[1]),day:Number(J[2]),ordinal:M(G,Number(J[1]),Number(J[2]))}}function E(K,G={}){const J=X(K);if(!J)return null;const W=C(G.date),F=C(G.dateTo)??W,$=G.referenceDate instanceof Date?G.referenceDate:new Date,B=T($);if(/今天/.test(J))return{start:B,end:B};if(/明天/.test(J))return{start:B+1,end:B+1};if(/后天/.test(J))return{start:B+2,end:B+2};const z=G.year??(X(G.date).match(/^(\d{4})-/)?.[1]?Number(X(G.date).slice(0,4)):$.getFullYear()),Z=Array.from(J.matchAll(/(\d{1,2}\/\d{1,2})/g)).map((Q)=>Q[1]);if(Z.length===0)return null;const V=q(Z[0],z);if(!V)return null;if(Z.length===1)return{start:V.ordinal,end:V.ordinal};const N=q(Z[1],z)?.month<V.month?z+1:z,U=q(Z[1],N);if(!U)return{start:V.ordinal,end:V.ordinal};if(W!=null&&U.ordinal<W&&V.month>=10){const Q=q(Z[0],z+1),j=q(Z[1],z+1)?.month<Q.month?z+2:z+1,H=q(Z[1],j);if(Q&&H)return{start:Q.ordinal,end:H.ordinal}}return{start:V.ordinal,end:U.ordinal}}export function filterRowsByDateRange(K,G={}){A(G);const J=C(G.date),W=C(G.dateTo)??J;if(J==null&&W==null)return K;const F=J??W,$=W??J;return K.filter((z)=>{const Z=E(z.time,G);if(!Z)return!0;return Z.start<=$&&Z.end>=F}).map((z,Z)=>({...z,rank:Z+1}))}export function buildEventsUrl(K={}){const G=A(K),J=new URLSearchParams;J.set("orderby","o");J.set("d","ts");P(J,"date",G.date);P(J,"dateTo",G.dateTo);P(J,"tag",K.tag);P(J,"city",K.city);const W=X(K.eventType);if(W){if(W!=="1"&&W!=="2")throw new _("huodongxing eventType must be 1 (offline) or 2 (online)");J.set("eventType",W)}P(J,"qs",K.qs);return`${h}?${J.toString()}`}export function extractEventRowsPayload(K=20){const G=50,J=K??20,W=typeof J==="number"?J:Number(String(J).trim());if(!Number.isInteger(W)||W<=0||W>G)return{ok:!1,code:"INVALID_LIMIT",message:`huodongxing limit must be a positive integer <= ${G}`};const F=(Q)=>String(Q??"").replace(/\s+/g," ").trim(),$=(Q,j)=>F(Q.querySelector(j)?.textContent??""),B=(Q)=>{const j=String(Q??"").match(/\/event\/(\d+)/);return j?j[1]:""},z=(Q)=>`https://www.huodongxing.com/event/${Q}`,Z=(Q,j)=>{if(Q.querySelector(".item-live-icon"))return"online";if(Q.querySelector(".item-dress-icon"))return"offline";if(/线上|在线|直播/.test(j))return"online";return""},V=Array.from(document.querySelectorAll(".search-tab-content-item-mesh")),N=[],U=new Set;for(const Q of V){if(N.length>=W)break;const j=Q.querySelector('a.item-title[href*="/event/"], a[href*="/event/"]'),H=B(j?.getAttribute("href")??"");if(!H||U.has(H))continue;const O=F($(Q,"a.item-title span")||$(Q,"a.item-title")||Q.querySelector("img.item-logo")?.getAttribute("alt")||"");if(!O)continue;const S=$(Q,".item-dress p"),I=$(Q,".item-dress-pp"),k=F($(Q,".item-bottom-left .user-name")||Q.querySelector(".item-bottom-left img[title]")?.getAttribute("title")||Q.querySelector(".item-bottom-left img[alt]")?.getAttribute("alt")||"");U.add(H);N.push({rank:N.length+1,id:H,title:O,time:S,eventType:Z(Q,I),city:I,location:I,organizer:k,url:z(H)})}if(N.length===0){const Q=F(document.body?.textContent??"");if(/操作过于频繁|too\s+frequent|rate\s*limit/i.test(Q))return{ok:!1,code:"RATE_LIMIT",message:"huodongxing events was rate limited by www.huodongxing.com",hint:"Wait a few minutes and retry from a real browser session."};if(V.length>0)return{ok:!1,code:"MALFORMED_RESULT",message:"huodongxing events cards were found but no stable event rows could be extracted",hint:"Huodongxing card markup changed: expected event links with /event/<id> and non-empty titles."};return{ok:!1,code:"EMPTY_RESULT",message:"huodongxing events returned no data",hint:"No Huodongxing event cards were found. The page may be empty or the DOM structure may have changed."}}return{ok:!0,rows:N}}function R(K){const G=w(K);if(G?.ok===!0&&Array.isArray(G.rows))return G.rows;if(G?.ok===!0)throw new L("huodongxing events returned malformed extraction rows","Expected browser extraction payload rows to be an array.");if(G?.code==="RATE_LIMIT")throw new L(G.message||"huodongxing events was rate limited by www.huodongxing.com",G.hint||"Wait a few minutes and retry from a real browser session.");if(G?.code==="INVALID_LIMIT")throw new _(G.message||"huodongxing limit must be a positive integer <= 50");if(G?.code==="EMPTY_RESULT")throw new f("huodongxing events",G.hint||"No Huodongxing event cards were found. The page may be empty.");throw new L(G?.message||"huodongxing events returned malformed extraction data",G?.hint||"Huodongxing extraction did not return the expected structured payload.")}export function extractEventRows(K=20){return R(extractEventRowsPayload(K))}Y({site:"huodongxing",name:"events",access:"read",description:"活动行活动搜索（按标签、城市、日期、线上/线下、名称过滤）",domain:"www.huodongxing.com",strategy:v.PUBLIC,browser:!0,args:[{name:"tag",type:"string",default:"",help:"活动标签，例如 AI"},{name:"city",type:"string",default:"全部",help:"城市名，例如 北京 / 上海 / 全部"},{name:"date",type:"string",default:"",help:"开始日期，格式 YYYY-MM-DD"},{name:"dateTo",type:"string",default:"",help:"结束日期，格式 YYYY-MM-DD"},{name:"eventType",type:"int",default:void 0,help:"活动类型：1 线下，2 线上"},{name:"qs",type:"string",default:"",help:"按活动名称关键词过滤"},{name:"limit",type:"int",default:20,help:"返回条数（1-50）"}],columns:EVENTS_COLUMNS,func:async(K,G)=>{const J=requireLimit(G.limit),W=buildEventsUrl(G);await K.goto(W);await K.wait(2);const F=await K.evaluate(`(${extractEventRowsPayload.toString()})(${J})`);return filterRowsByDateRange(R(F),G)}});
+import{cli as L,Strategy as N}from"@jackwener/opencli/registry";import{ArgumentError as y,CommandExecutionError as T,EmptyResultError as R}from"@jackwener/opencli/errors";const k="https://www.huodongxing.com/events",S=50;export const EVENTS_COLUMNS=["rank","id","title","time","eventType","city","location","organizer","url"];function f(n){return String(n??"").replace(/\s+/g," ").trim()}export function requireLimit(n){const e=n??20,t=typeof e==="number"?e:Number(String(e).trim());if(!Number.isInteger(t)||t<=0)throw new y("huodongxing limit must be a positive integer");if(t>S)throw new y(`huodongxing limit must be <= ${S}`);return t}function p(n,e,t){const o=f(t);if(o)n.set(e,o)}function v(n,e,t){return Math.floor(Date.UTC(n,e-1,t)/86400000)}function h(n){const e=f(n).match(/^(\d{4})-(\d{2})-(\d{2})$/);if(!e)return null;const t=Number(e[1]),o=Number(e[2]),u=Number(e[3]),a=new Date(Date.UTC(t,o-1,u));if(a.getUTCFullYear()!==t||a.getUTCMonth()!==o-1||a.getUTCDate()!==u)return null;return v(t,o,u)}function D(n,e){const t=f(n);if(!t)return"";if(h(t)==null)throw new y(`huodongxing ${e} must be a valid YYYY-MM-DD date`);return t}function A(n={}){const e=D(n.date,"date"),t=D(n.dateTo,"dateTo");if(e&&t&&h(e)>h(t))throw new y("huodongxing date must be <= dateTo");return{date:e,dateTo:t}}function q(n){if(n&&!Array.isArray(n)&&typeof n==="object"&&"session"in n&&"data"in n)return n.data;return n}function U(n){return v(n.getFullYear(),n.getMonth()+1,n.getDate())}function x(n,e){const t=f(n).match(/(\d{1,2})\/(\d{1,2})/);if(!t)return null;return{month:Number(t[1]),day:Number(t[2]),ordinal:v(e,Number(t[1]),Number(t[2]))}}function C(n,e={}){const t=f(n);if(!t)return null;const o=h(e.date),u=h(e.dateTo)??o,a=e.referenceDate instanceof Date?e.referenceDate:new Date,l=U(a);if(/今天/.test(t))return{start:l,end:l};if(/明天/.test(t))return{start:l+1,end:l+1};if(/后天/.test(t))return{start:l+2,end:l+2};const s=e.year??(f(e.date).match(/^(\d{4})-/)?.[1]?Number(f(e.date).slice(0,4)):a.getFullYear()),i=Array.from(t.matchAll(/(\d{1,2}\/\d{1,2})/g)).map((r)=>r[1]);if(i.length===0)return null;const c=x(i[0],s);if(!c)return null;if(i.length===1)return{start:c.ordinal,end:c.ordinal};const g=x(i[1],s)?.month<c.month?s+1:s,w=x(i[1],g);if(!w)return{start:c.ordinal,end:c.ordinal};if(o!=null&&w.ordinal<o&&c.month>=10){const r=x(i[0],s+1),d=x(i[1],s+1)?.month<r.month?s+2:s+1,m=x(i[1],d);if(r&&m)return{start:r.ordinal,end:m.ordinal}}return{start:c.ordinal,end:w.ordinal}}export function filterRowsByDateRange(n,e={}){A(e);const t=h(e.date),o=h(e.dateTo)??t;if(t==null&&o==null)return n;const u=t??o,a=o??t;return n.filter((s)=>{const i=C(s.time,e);if(!i)return!0;return i.start<=a&&i.end>=u}).map((s,i)=>({...s,rank:i+1}))}export function buildEventsUrl(n={}){const e=A(n),t=new URLSearchParams;t.set("orderby","o");t.set("d","ts");p(t,"date",e.date);p(t,"dateTo",e.dateTo);p(t,"tag",n.tag);p(t,"city",n.city);const o=f(n.eventType);if(o){if(o!=="1"&&o!=="2")throw new y("huodongxing eventType must be 1 (offline) or 2 (online)");t.set("eventType",o)}p(t,"qs",n.qs);return`${k}?${t.toString()}`}export function extractEventRowsPayload(n=20){const e=50,t=n??20,o=typeof t==="number"?t:Number(String(t).trim());if(!Number.isInteger(o)||o<=0||o>e)return{ok:!1,code:"INVALID_LIMIT",message:`huodongxing limit must be a positive integer <= ${e}`};const u=(r)=>String(r??"").replace(/\s+/g," ").trim(),a=(r,d)=>u(r.querySelector(d)?.textContent??""),l=(r)=>{const d=String(r??"").match(/\/event\/(\d+)/);return d?d[1]:""},s=(r)=>`https://www.huodongxing.com/event/${r}`,i=(r,d)=>{if(r.querySelector(".item-live-icon"))return"online";if(r.querySelector(".item-dress-icon"))return"offline";if(/线上|在线|直播/.test(d))return"online";return""},c=Array.from(document.querySelectorAll(".search-tab-content-item-mesh")),g=[],w=new Set;for(const r of c){if(g.length>=o)break;const d=r.querySelector('a.item-title[href*="/event/"], a[href*="/event/"]'),m=l(d?.getAttribute("href")??"");if(!m||w.has(m))continue;const E=u(a(r,"a.item-title span")||a(r,"a.item-title")||r.querySelector("img.item-logo")?.getAttribute("alt")||"");if(!E)continue;const Y=a(r,".item-dress p"),b=a(r,".item-dress-pp"),I=u(a(r,".item-bottom-left .user-name")||r.querySelector(".item-bottom-left img[title]")?.getAttribute("title")||r.querySelector(".item-bottom-left img[alt]")?.getAttribute("alt")||"");w.add(m);g.push({rank:g.length+1,id:m,title:E,time:Y,eventType:i(r,b),city:b,location:b,organizer:I,url:s(m)})}if(g.length===0){const r=u(document.body?.textContent??"");if(/操作过于频繁|too\s+frequent|rate\s*limit/i.test(r))return{ok:!1,code:"RATE_LIMIT",message:"huodongxing events was rate limited by www.huodongxing.com",hint:"Wait a few minutes and retry from a real browser session."};if(c.length>0)return{ok:!1,code:"MALFORMED_RESULT",message:"huodongxing events cards were found but no stable event rows could be extracted",hint:"Huodongxing card markup changed: expected event links with /event/<id> and non-empty titles."};return{ok:!1,code:"EMPTY_RESULT",message:"huodongxing events returned no data",hint:"No Huodongxing event cards were found. The page may be empty or the DOM structure may have changed."}}return{ok:!0,rows:g}}function M(n){const e=q(n);if(e?.ok===!0&&Array.isArray(e.rows))return e.rows;if(e?.ok===!0)throw new T("huodongxing events returned malformed extraction rows","Expected browser extraction payload rows to be an array.");if(e?.code==="RATE_LIMIT")throw new T(e.message||"huodongxing events was rate limited by www.huodongxing.com",e.hint||"Wait a few minutes and retry from a real browser session.");if(e?.code==="INVALID_LIMIT")throw new y(e.message||"huodongxing limit must be a positive integer <= 50");if(e?.code==="EMPTY_RESULT")throw new R("huodongxing events",e.hint||"No Huodongxing event cards were found. The page may be empty.");throw new T(e?.message||"huodongxing events returned malformed extraction data",e?.hint||"Huodongxing extraction did not return the expected structured payload.")}export function extractEventRows(n=20){return M(extractEventRowsPayload(n))}L({site:"huodongxing",name:"events",access:"read",description:"活动行活动搜索（按标签、城市、日期、线上/线下、名称过滤）",domain:"www.huodongxing.com",strategy:N.PUBLIC,browser:!0,args:[{name:"tag",type:"string",default:"",help:"活动标签，例如 AI"},{name:"city",type:"string",default:"全部",help:"城市名，例如 北京 / 上海 / 全部"},{name:"date",type:"string",default:"",help:"开始日期，格式 YYYY-MM-DD"},{name:"dateTo",type:"string",default:"",help:"结束日期，格式 YYYY-MM-DD"},{name:"eventType",type:"int",default:void 0,help:"活动类型：1 线下，2 线上"},{name:"qs",type:"string",default:"",help:"按活动名称关键词过滤"},{name:"limit",type:"int",default:20,help:"返回条数（1-50）"}],columns:EVENTS_COLUMNS,func:async(n,e)=>{const t=requireLimit(e.limit),o=buildEventsUrl(e);await n.goto(o);await n.wait(2);const u=await n.evaluate(`(${extractEventRowsPayload.toString()})(${t})`);return filterRowsByDateRange(M(u),e)}});

package/clis/hupu/detail.js

@@ -1,7 +1,7 @@
-import{cli as D,Strategy as L}from"@jackwener/opencli/registry";import{getHupuThreadUrl as S,readHupuNextData as U,stripHtml as M}from"./utils.js";D({site:"hupu",name:"detail",access:"read",description:"获取虎扑帖子详情 (使用Next.js JSON数据)",domain:"bbs.hupu.com",strategy:L.PUBLIC,browser:!0,args:[{name:"tid",required:!0,positional:!0,help:"帖子ID（9位数字）"},{name:"replies",type:"boolean",default:!1,help:"是否包含热门回复"}],columns:["title","author","content","replies","lights","url"],func:async(O,Q)=>{const{tid:A,replies:V=!1}=Q,W=S(A).replace(/-1\.html$/,".html"),B=await U(O,W,"Read Hupu thread detail",{expectedTid:String(A)}),q=B.props.pageProps.detail_error_info;if(q&&q.code!==200)throw Error(`帖子访问失败: ${q.message} (code: ${q.code})`);const b=B.props.pageProps.detail?.thread;if(!b)throw Error("帖子不存在或已被删除");const X=b.author?.puname||"未知作者",E=M(b.content),F=E.length>300?E.substring(0,300)+"...":E,G={title:b.title,author:X,content:F,replies:b.replies||0,lights:b.lights||0,url:`https://bbs.hupu.com/${A}.html`};if(V){const J=(B.props.pageProps.detail?.lights||[]).slice(0,3);if(J.length>0){let K=`
+import{cli as N,Strategy as P}from"@jackwener/opencli/registry";import{getHupuThreadUrl as x,readHupuNextData as H,stripHtml as c}from"./utils.js";N({site:"hupu",name:"detail",access:"read",description:"获取虎扑帖子详情 (使用Next.js JSON数据)",domain:"bbs.hupu.com",strategy:P.PUBLIC,browser:!0,args:[{name:"tid",required:!0,positional:!0,help:"帖子ID（9位数字）"},{name:"replies",type:"boolean",default:!1,help:"是否包含热门回复"}],columns:["title","author","content","replies","lights","url"],func:async(u,h)=>{const{tid:o,replies:d=!1}=h,m=x(o).replace(/-1\.html$/,".html"),n=await H(u,m,"Read Hupu thread detail",{expectedTid:String(o)}),e=n.props.pageProps.detail_error_info;if(e&&e.code!==200)throw Error(`帖子访问失败: ${e.message} (code: ${e.code})`);const t=n.props.pageProps.detail?.thread;if(!t)throw Error("帖子不存在或已被删除");const g=t.author?.puname||"未知作者",s=c(t.content),a=s.length>300?s.substring(0,300)+"...":s,i={title:t.title,author:g,content:a,replies:t.replies||0,lights:t.lights||0,url:`https://bbs.hupu.com/${o}.html`};if(d){const l=(n.props.pageProps.detail?.lights||[]).slice(0,3);if(l.length>0){let p=`
 
 【热门回复】
-`;J.forEach((z,Y)=>{const Z=z.author?.puname||"未知用户",_=M(z.content).substring(0,100),$=z.allLightCount||0,C=z.created_at_format||"未知时间";K+=`${Y+1}. ${Z} (亮${$} ${C}):
-   ${_}
+`;l.forEach((r,f)=>{const b=r.author?.puname||"未知用户",w=c(r.content).substring(0,100),y=r.allLightCount||0,L=r.created_at_format||"未知时间";p+=`${f+1}. ${b} (亮${y} ${L}):
+   ${w}
 
-`});G.content=F+K}}return[G]}});
+`});i.content=a+p}}return[i]}});