publishport-opencli 1.0.0

package/clis/grok/utils.js

@@ -0,0 +1,337 @@
+import{htmlToMarkdown as k}from"@jackwener/opencli/utils";import{ArgumentError as j,AuthRequiredError as z}from"@jackwener/opencli/errors";export const GROK_DOMAIN="grok.com",GROK_URL="https://grok.com/",IS_VISIBLE_JS=`
+  const isVisible = (node) => {
+    if (!(node instanceof Element)) return false;
+    const style = window.getComputedStyle(node);
+    if (style.visibility === 'hidden' || style.display === 'none') return false;
+    const rect = node.getBoundingClientRect();
+    return rect.width > 0 && rect.height > 0;
+  };
+`;export function authRequired(H){return new z(GROK_DOMAIN,H||"Sign in to grok.com in your browser, then retry.")}export function normalizeBooleanFlag(H,Y=!1){if(typeof H==="boolean")return H;if(H==null||H==="")return Y;const X=String(H).trim().toLowerCase();return X==="true"||X==="1"||X==="yes"||X==="on"}const F=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;export function parseGrokSessionId(H){const Y=String(H??"").trim();if(!Y)throw new j("id","must be a non-empty session ID or grok.com chat URL");let X=Y;if(/^[a-z][a-z0-9+.-]*:\/\//i.test(Y)){let q;try{q=new URL(Y)}catch{throw new j("id",`not a valid Grok URL (got "${H}")`)}const Z=q.hostname.toLowerCase(),$=q.pathname.match(/^\/c\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\/?$/i);if(q.protocol!=="https:"||Z!=="grok.com"&&!Z.endsWith(".grok.com")||!$)throw new j("id",`not a valid Grok conversation URL (got "${H}"); expected https://grok.com/c/<id>`);X=$[1]}if(!F.test(X))throw new j("id",`not a valid Grok session ID (got "${H}"); expected a UUID like "7c4197f2-10a1-4ebb-a84a-fea89f4f1d06" or a full https://grok.com/c/<id> URL`);return X.toLowerCase()}export async function isOnGrok(H){const Y=await H.evaluate("window.location.href").catch(()=>"");if(typeof Y!=="string"||!Y)return!1;try{const X=new URL(Y).hostname;return X==="grok.com"||X.endsWith(".grok.com")}catch{return!1}}export async function ensureOnGrok(H){if(await isOnGrok(H))return;await H.goto(GROK_URL);await H.wait(2)}export async function isLoggedIn(H){const Y=await H.evaluate(`(() => {
+    ${IS_VISIBLE_JS}
+    const composer = document.querySelector('.ProseMirror[contenteditable="true"]');
+    if (composer && isVisible(composer)) {
+      const signInCta = Array.from(document.querySelectorAll('button, a'))
+        .some((node) => isVisible(node) && /^(sign in|log in)$/i.test((node.textContent || '').trim()));
+      return !signInCta;
+    }
+    return false;
+  })()`);return Boolean(Y)}export async function getCurrentSessionId(H){const Y=await H.evaluate("window.location.href").catch(()=>"");if(typeof Y!=="string")return"";const X=Y.match(/\/c\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/i);return X?X[1].toLowerCase():""}const B=["#model-select-trigger",'button[aria-label="Model select"]','button[aria-label="模型选择"]','button[aria-label="モデル選択"]'];export async function getModelLabel(H){const Y=JSON.stringify(B),X=await H.evaluate(`(() => {
+    ${IS_VISIBLE_JS}
+    const selectors = ${Y};
+    let trigger = null;
+    for (const sel of selectors) {
+      trigger = Array.from(document.querySelectorAll(sel)).find((node) => isVisible(node));
+      if (trigger) break;
+    }
+    if (!trigger) return '';
+    return (trigger.innerText || trigger.textContent || '').trim().split('\\n')[0].trim();
+  })()`);return typeof X==="string"?X:""}export async function getMessageBubbles(H){const Y=await H.evaluate(`(() => {
+    ${IS_VISIBLE_JS}
+    const findResponseId = (node) => {
+      let parent = node.parentElement;
+      while (parent && parent !== document.body) {
+        const id = parent.getAttribute('id') || '';
+        if (id.startsWith('response-')) return id.slice('response-'.length);
+        parent = parent.parentElement;
+      }
+      return '';
+    };
+    const bubbles = Array.from(document.querySelectorAll('[data-testid="user-message"], [data-testid="assistant-message"]'))
+      .filter((node) => node instanceof HTMLElement && isVisible(node));
+    const out = [];
+    let positional = 0;
+    for (const node of bubbles) {
+      const isAssistant = node.getAttribute('data-testid') === 'assistant-message';
+      const responseId = findResponseId(node);
+      const baseId = responseId || ('pos-' + positional);
+      const id = baseId + (isAssistant ? '-assistant' : '-user');
+      positional += 1;
+      const html = node.innerHTML || '';
+      const text = (node.innerText || node.textContent || '').replace(/\\s+/g, ' ').trim();
+      out.push({ id, role: isAssistant ? 'Assistant' : 'User', text, html });
+    }
+    return out;
+  })()`);if(!Array.isArray(Y))return[];return Y.map((X)=>({id:String(X?.id||""),role:X?.role==="Assistant"?"Assistant":"User",text:String(X?.text||"").trim(),html:String(X?.html||"")})).filter((X)=>X.id&&(X.text||X.html))}export function bubbleHtmlToMarkdown(H){try{return k(H).trim()}catch{return(H||"").replace(/<[^>]+>/g," ").replace(/\s+/g," ").trim()}}export async function getHistoryFromSidebar(H,Y){const X=await H.evaluate(`(() => {
+    ${IS_VISIBLE_JS}
+    const re = /^\\/c\\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i;
+    const seen = new Set();
+    const out = [];
+    const anchors = Array.from(document.querySelectorAll('a[href^="/c/"]'));
+    for (const a of anchors) {
+      if (!(a instanceof HTMLElement) || !isVisible(a)) continue;
+      const href = a.getAttribute('href') || '';
+      const m = href.match(re);
+      if (!m) continue;
+      const id = m[1].toLowerCase();
+      if (seen.has(id)) continue;
+      const title = (a.innerText || a.textContent || '').trim();
+      // Sidebar renders the conversation title in one anchor and a separate
+      // icon-only anchor for hover affordances. Keep the first occurrence with
+      // a non-empty title; if the icon anchor wins the DOM order, fall back to
+      // the second pass below.
+      seen.add(id);
+      out.push({ id, title });
+    }
+    // Second pass: backfill empty titles from later anchors with the same id.
+    const titleById = new Map(out.map((entry) => [entry.id, entry.title]));
+    for (const a of anchors) {
+      if (!(a instanceof HTMLElement) || !isVisible(a)) continue;
+      const href = a.getAttribute('href') || '';
+      const m = href.match(re);
+      if (!m) continue;
+      const id = m[1].toLowerCase();
+      const title = (a.innerText || a.textContent || '').trim();
+      if (title && !titleById.get(id)) {
+        titleById.set(id, title);
+      }
+    }
+    return out.map((entry) => ({ id: entry.id, title: titleById.get(entry.id) || entry.title }));
+  })()`);if(!Array.isArray(X))return[];return X.slice(0,Y).map((Z)=>({id:String(Z?.id||""),title:String(Z?.title||"")}))}export async function startNewChat(H){await H.goto(GROK_URL);await H.wait(2)}export async function clickConversationMenuItem(H,Y,X){const q=String(Y).toLowerCase(),Z=JSON.stringify(q),$=JSON.stringify(X.map((Q)=>Q.toLowerCase()));return await H.evaluate(`(async () => {
+    const waitFor = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    const id = ${Z};
+    const labels = ${$};
+    // Find the sidebar anchor for this conversation.
+    let link = null;
+    for (let attempt = 0; attempt < 10; attempt += 1) {
+      link = Array.from(document.querySelectorAll('a[href^="/c/"]'))
+        .find((a) => a instanceof HTMLElement && a.offsetParent && (a.getAttribute('href') || '').toLowerCase().includes(id));
+      if (link) break;
+      await waitFor(300);
+    }
+    if (!link) {
+      return { ok: false, reason: 'Conversation not found in sidebar.', detail: 'id=' + id };
+    }
+    // Trigger the radix context menu — radix listens to PointerEvent +
+    // contextmenu, so plain MouseEvent('contextmenu') alone is ignored.
+    // Dispatch the full sequence pointerdown/mousedown/contextmenu/pointerup/mouseup
+    // with right-button state to mirror a real right-click.
+    {
+      const rect = link.getBoundingClientRect();
+      const init = {
+        bubbles: true, cancelable: true, button: 2, buttons: 2,
+        clientX: Math.round(rect.left + Math.min(rect.width / 2, 16)),
+        clientY: Math.round(rect.top + Math.min(rect.height / 2, 16)),
+      };
+      link.dispatchEvent(new PointerEvent('pointerdown', { ...init, pointerType: 'mouse' }));
+      link.dispatchEvent(new MouseEvent('mousedown', init));
+      link.dispatchEvent(new MouseEvent('contextmenu', init));
+      link.dispatchEvent(new PointerEvent('pointerup', { ...init, pointerType: 'mouse' }));
+      link.dispatchEvent(new MouseEvent('mouseup', init));
+    }
+    // Wait for menu items to appear.
+    let items = [];
+    for (let attempt = 0; attempt < 10; attempt += 1) {
+      items = Array.from(document.querySelectorAll('[role="menuitem"]'))
+        .filter((it) => it instanceof HTMLElement && it.offsetParent);
+      if (items.length) break;
+      await waitFor(150);
+    }
+    if (!items.length) {
+      return { ok: false, reason: 'Context menu did not open for the conversation.' };
+    }
+    const target = items.find((it) => {
+      const text = (it.textContent || '').trim().toLowerCase();
+      return labels.some((l) => text === l);
+    });
+    if (!target) {
+      return {
+        ok: false,
+        reason: 'No menu item matched the requested label.',
+        detail: 'available=' + JSON.stringify(items.map((it) => (it.textContent || '').trim())),
+      };
+    }
+    target.click();
+    return { ok: true, clicked: (target.textContent || '').trim() };
+  })()`)}export function getPinStateFromMenuLabels(H){const Y=(Array.isArray(H)?H:[]).map((X)=>String(X||"").trim().toLowerCase()).filter(Boolean);if(Y.some((X)=>X==="取消置顶"||X==="unpin"))return"pinned";if(Y.some((X)=>X==="置顶"||X==="pin"))return"unpinned";return""}export async function isConversationVisibleInSidebar(H,Y){const X=String(Y).toLowerCase(),q=JSON.stringify(X),Z=await H.evaluate(`(() => {
+    const id = ${q};
+    return Array.from(document.querySelectorAll('a[href^="/c/"]'))
+      .some((a) => a instanceof HTMLElement && a.offsetParent && (a.getAttribute('href') || '').toLowerCase().includes(id));
+  })()`);return Boolean(Z)}export async function waitForConversationToDisappear(H,Y,X=5000){const q=Date.now();while(Date.now()-q<X){if(!await isConversationVisibleInSidebar(H,Y))return!0;await H.wait(0.25)}return!await isConversationVisibleInSidebar(H,Y)}export async function readConversationMenuLabels(H,Y){const X=String(Y).toLowerCase(),q=JSON.stringify(X),Z=await H.evaluate(`(async () => {
+    const waitFor = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    const id = ${q};
+    let link = null;
+    for (let attempt = 0; attempt < 10; attempt += 1) {
+      link = Array.from(document.querySelectorAll('a[href^="/c/"]'))
+        .find((a) => a instanceof HTMLElement && a.offsetParent && (a.getAttribute('href') || '').toLowerCase().includes(id));
+      if (link) break;
+      await waitFor(300);
+    }
+    if (!link) {
+      return { ok: false, reason: 'Conversation not found in sidebar.', detail: 'id=' + id, labels: [] };
+    }
+    const rect = link.getBoundingClientRect();
+    const init = {
+      bubbles: true, cancelable: true, button: 2, buttons: 2,
+      clientX: Math.round(rect.left + Math.min(rect.width / 2, 16)),
+      clientY: Math.round(rect.top + Math.min(rect.height / 2, 16)),
+    };
+    link.dispatchEvent(new PointerEvent('pointerdown', { ...init, pointerType: 'mouse' }));
+    link.dispatchEvent(new MouseEvent('mousedown', init));
+    link.dispatchEvent(new MouseEvent('contextmenu', init));
+    link.dispatchEvent(new PointerEvent('pointerup', { ...init, pointerType: 'mouse' }));
+    link.dispatchEvent(new MouseEvent('mouseup', init));
+
+    let items = [];
+    for (let attempt = 0; attempt < 10; attempt += 1) {
+      items = Array.from(document.querySelectorAll('[role="menuitem"]'))
+        .filter((it) => it instanceof HTMLElement && it.offsetParent);
+      if (items.length) break;
+      await waitFor(150);
+    }
+    const labels = items.map((it) => (it.textContent || '').trim()).filter(Boolean);
+    document.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true }));
+    return items.length
+      ? { ok: true, labels }
+      : { ok: false, reason: 'Context menu did not open for the conversation.', labels: [] };
+  })()`);try{await H.keys("Escape")}catch{}if(!Z||typeof Z!=="object")return{ok:!1,reason:"Malformed context-menu result.",labels:[]};return{ok:Boolean(Z.ok),reason:String(Z.reason||""),detail:String(Z.detail||""),labels:Array.isArray(Z.labels)?Z.labels.map(($)=>String($||"")):[]}}export async function waitForConversationPinState(H,Y,X,q=5000){const Z=Date.now();let $=null;while(Date.now()-Z<q){$=await readConversationMenuLabels(H,Y);if($.ok&&getPinStateFromMenuLabels($.labels)===X)return{ok:!0,state:X,labels:$.labels};await H.wait(0.25)}$=await readConversationMenuLabels(H,Y);const Q=$.ok?getPinStateFromMenuLabels($.labels):"";return{ok:$.ok&&Q===X,state:Q,labels:$.labels||[],reason:$.reason||`Conversation did not reach ${X} state.`,detail:$.detail||""}}export async function fillRenameInputAndSubmit(H,Y){const X=JSON.stringify(Y);return await H.evaluate(`(async () => {
+    const waitFor = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    let input = null;
+    for (let attempt = 0; attempt < 15; attempt += 1) {
+      // The inline rename UI surfaces as a single visible <input> or a
+      // contenteditable inside the sidebar row.
+      input = Array.from(document.querySelectorAll('input[type="text"], [contenteditable="true"]:not(.ProseMirror)'))
+        .find((el) => el instanceof HTMLElement && el.offsetParent && el.getBoundingClientRect().left < 260);
+      if (input) break;
+      await waitFor(200);
+    }
+    if (!input) {
+      return { ok: false, reason: 'Inline rename input did not appear.' };
+    }
+    input.focus();
+    if (input instanceof HTMLInputElement) {
+      const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set;
+      setter.call(input, ${X});
+      input.dispatchEvent(new Event('input', { bubbles: true }));
+    } else {
+      // contenteditable path
+      input.innerText = '';
+      document.execCommand('insertText', false, ${X});
+    }
+    // Commit by Enter (Grok accepts Enter to confirm, Escape to cancel).
+    input.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }));
+    return { ok: true, value: ${X} };
+  })()`)}export async function sendMessage(H,Y){const X=JSON.stringify(Y);return await H.evaluate(`(async () => {
+    const waitFor = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    const normalize = (value) => String(value || '').replace(/\\s+/g, ' ').trim();
+    const composerSelector = '.ProseMirror[contenteditable="true"]';
+    const isVisible = (node) => {
+      if (!(node instanceof Element)) return false;
+      const style = window.getComputedStyle(node);
+      if (style.visibility === 'hidden' || style.display === 'none') return false;
+      const rect = node.getBoundingClientRect();
+      return rect.width > 0 && rect.height > 0;
+    };
+    const responseIdFor = (node) => {
+      let parent = node.parentElement;
+      while (parent && parent !== document.body) {
+        const id = parent.getAttribute('id') || '';
+        if (id.startsWith('response-')) return id.slice('response-'.length);
+        parent = parent.parentElement;
+      }
+      return '';
+    };
+    const userTurns = () => Array.from(document.querySelectorAll('[data-testid="user-message"]'))
+      .filter((node) => node instanceof HTMLElement && isVisible(node))
+      .map((node, index) => ({
+        id: responseIdFor(node) || ('pos-' + index),
+        text: normalize(node.innerText || node.textContent || ''),
+      }))
+      .filter((turn) => turn.text);
+    const promptText = normalize(${X});
+    const beforeTurns = userTurns();
+    const beforeKeys = new Set(beforeTurns.map((turn) => turn.id + '\\n' + turn.text));
+    const waitForSubmittedUserTurn = async () => {
+      for (let attempt = 0; attempt < 20; attempt += 1) {
+        const turns = userTurns();
+        const latest = turns[turns.length - 1];
+        const hasNewMatchingTurn = turns.some((turn) => turn.text === promptText && !beforeKeys.has(turn.id + '\\n' + turn.text));
+        const appendedMatchingTurn = turns.length > beforeTurns.length && latest?.text === promptText;
+        if (hasNewMatchingTurn || appendedMatchingTurn) return true;
+        await waitFor(250);
+      }
+      return false;
+    };
+    let composer = null;
+    for (let attempt = 0; attempt < 12; attempt += 1) {
+      const candidate = document.querySelector(composerSelector);
+      if (candidate instanceof HTMLElement) { composer = candidate; break; }
+      await waitFor(500);
+    }
+    if (!(composer instanceof HTMLElement)) {
+      return { ok: false, reason: 'Grok composer (.ProseMirror) was not found on grok.com.' };
+    }
+    const editor = composer.editor;
+    if (!editor || !editor.commands || typeof editor.commands.focus !== 'function' || typeof editor.commands.insertContent !== 'function') {
+      return { ok: false, reason: 'Grok composer editor API was unavailable (page may still be loading).' };
+    }
+    try {
+      if (typeof editor.commands.clearContent === 'function') editor.commands.clearContent();
+      editor.commands.focus();
+      editor.commands.insertContent(${X});
+    } catch (error) {
+      return {
+        ok: false,
+        reason: 'Failed to insert the prompt into the Grok composer.',
+        detail: error instanceof Error ? error.message : String(error),
+      };
+    }
+    const isClickableSubmit = (node) => {
+      if (!(node instanceof HTMLButtonElement)) return false;
+      if (node.disabled) return false;
+      return isVisible(node);
+    };
+    // Prefer data-testid (locale-independent); fall back to aria-label per
+    // language. As of 2026-05-31 Grok renders button[data-testid="chat-submit"]
+    // once the composer has content. The aria-label varies: "Submit" (en),
+    // "提交" (zh-CN), and presumably other locales.
+    const submitSelectors = [
+      'button[data-testid="chat-submit"]',
+      'button[aria-label="Submit"]',
+      'button[aria-label="提交"]',
+      'button[aria-label="送信"]',
+    ];
+    let submit = null;
+    for (let attempt = 0; attempt < 12; attempt += 1) {
+      for (const sel of submitSelectors) {
+        const candidate = Array.from(document.querySelectorAll(sel)).find(isClickableSubmit);
+        if (candidate instanceof HTMLButtonElement) { submit = candidate; break; }
+      }
+      if (submit) break;
+      await waitFor(500);
+    }
+    if (submit instanceof HTMLButtonElement) {
+      submit.click();
+      if (!(await waitForSubmittedUserTurn())) {
+        return { ok: false, reason: 'Grok submit button was clicked but no new user turn appeared.' };
+      }
+      return { ok: true, submittedVia: 'submit-button' };
+    }
+    // Fallback: some Grok deployments / locales never surface a
+    // submit-labelled button (see #1782); the composer commits on Enter
+    // when there is no Shift modifier, and Tiptap honours the synthetic
+    // keypress because the editor is focused. Dispatch a full keydown +
+    // keypress + keyup chain so any modifier / IME listener stays
+    // consistent with a real user pressing Enter.
+    const dispatchEnter = (target) => {
+      const opts = { key: 'Enter', code: 'Enter', keyCode: 13, which: 13, bubbles: true, cancelable: true };
+      target.dispatchEvent(new KeyboardEvent('keydown', opts));
+      target.dispatchEvent(new KeyboardEvent('keypress', opts));
+      target.dispatchEvent(new KeyboardEvent('keyup', opts));
+    };
+    try {
+      // Re-focus first; insertContent above may have moved focus elsewhere.
+      editor.commands.focus();
+      const focusTarget = document.activeElement instanceof HTMLElement ? document.activeElement : composer;
+      dispatchEnter(focusTarget);
+      if (!(await waitForSubmittedUserTurn())) {
+        return { ok: false, reason: 'Grok Enter-key fallback fired but no new user turn appeared.' };
+      }
+      return { ok: true, submittedVia: 'enter-key' };
+    } catch (error) {
+      return {
+        ok: false,
+        reason: 'Grok submit button never appeared and Enter-key fallback failed.',
+        detail: error instanceof Error ? error.message : String(error),
+      };
+    }
+  })()`)}const D=2,N=6000,V=2;function G(H){return(H||"").replace(/\u00a0/g," ").trim()}export async function waitForAnswer(H,Y,X,q){const Z=Date.now();let $="",Q=0,y="";while(Date.now()-Z<X*1000){await H.wait(D);const f=[...await getMessageBubbles(H)].reverse().find((P)=>P.role==="Assistant");if(!f)continue;if(q&&f.id===q)continue;const W=G(f.text);if(!W||W===Y.trim())continue;y=W;const K=Date.now()-Z>=N;if(W===$){Q+=1;if(K&&Q>=V)return{status:"ok",assistant:f}}else{$=W;Q=0}}if(y)return{status:"partial",assistant:[...await getMessageBubbles(H)].reverse().find((W)=>W.role==="Assistant")};return{status:"timeout"}}export const __test__={GROK_SESSION_ID_RE:F,getPinStateFromMenuLabels};

package/clis/guazi/__fixtures__/detail.html

@@ -0,0 +1,7 @@
+<!doctype html><html><head>
+<meta property="og:title" content="【准新车】二手奔腾T90 2025款 龙耀版 1.5T 舒享型报价，真实车源图片/视频 - 瓜子二手车"/>
+</head><body><script>
+ess=image/quality,q_88/resize,m_fill,w_750,h_750\"}],\"type\":2}],\"videoList\":[],\"videoAbResult\":true,\"videoFeedsSwitch\":true,\"imageCropRatio1x1\":false},\"carRecordInfo\":{\"simpleSummary\":[{\"label\":\"首次上牌\",\"value\":\"2024-12\",\"fullRow\":false},{\"label\":\"表显里程\",\"value\":\"0.17万公里\",\"fullRow\":false},{\"label\":\"过户次数\",\"value\":\"0次\",\"fullRow\":false,\"bottomBall\":{\"title\":\"关于过户次数\",\"desc\":\"部分商家为周转车辆会临时过户至他人名下，建议通过视频看车功能直接与商家确认最新状态。\"}},{\"label\":\"车源地\",\"value\":\"苏州\",\"fullRow\":false}],\"carParamsSummary\":[{\"label\":\"发动机\",\"value\":\"1.5T\",\"fullRow\":false},{\"label\":\"变速箱\",\"value\":\"自动\",\"fullRow\":false},{\"key\":\"emission\",\"label\":\"排放标准\",\"value\":\"国六b\",\"fullRow\":false},{\"label\":\"驱动方式\",\"value\":\"前置前驱\",\"fullRow\":false}],\"archiveSummary\":[{\"key\":\"emission\",\"label\":\"排放标准\",\"value\":\"国六b\",\"fullRow\":false},{\"label\":\"车源地\",\"value\":\"苏州\",\"fullRow\":false},{\"label\":\"车身颜色\",\"value\":\"白色\",\"fullRow\":false},{\"label\":\"车源编号\",\"value\":\"162563585\",\"fullRow\":false}],\"highlightConfigItem\":[{\"id\":5,\"title\":\"方向盘加热\",\"image\":\"https://image1.guazistatic.com/qn2105181024035ead3ad6da599924f0d05a54e3f30885.png\",\"desc\":\"由方向盘内的加热系统实现，由方向盘或中控台上的按钮开启或关闭。属于较高的舒适型配置。\"},{\"id\":11,\"title\":\"自适应巡航\",\"image\":\"https://image1.guazistatic.com/qn2105181212480a405f49434fc91994a49bed6888e181.png\",\"desc\":\"Adaptive Cruise Control简称ACC，可依所设定速度行驶，还可保持预设跟车距离，随着车距变化自动加速与减速。\"},{\"id\":13,\"title\":\"自适应远近光\",\"image\":\"https://image1.guazistatic.com/qn210518121604812071c5c5251de8b33dcf01a5319478.png\",\"desc\":\"开启大灯时，行驶中传感器判断对向或同向车辆情况，自动切换远近光灯，有效保护其他车辆行车安全。\"},{\"id\":14,\"title\":\"并线辅
+s://m.guazi.com/car-detail/c162563585115789.html","price":73800,"priceCurrency":"CNY","priceValidUnt
+1年6个月，车况S，基础车况极品/理赔0次/过户0次，瓜子二手车，每车必检，超200项官方检测认证，
+</script></body></html>

package/clis/guazi/__fixtures__/list.html

@@ -0,0 +1,5 @@
+<!doctype html><html><body><div class="list">
+<a class="text-gz-black-303740" href="/car-detail/c168029452296957.html"><section class="mb-20 flex justify-between gap-12"><div class="overflow-hidden rounded-md w-114 h-85"><div class="rounded-md object-cover w-114 h-85" style="position:relative;overflow:hidden"><img alt="创维汽车 创维HT-i 2024款 1.5L PHEV 115KM 泰道版" loading="lazy" width="114" height="85" decoding="async" data-nimg="1" class="object-cover" style="color:transparent;position:absolute;width:100%;height:100%;top:0;left:0;opacity:0;transition:opacity 0.3s ease" src="https://image-public.guazistatic.com/qnbdp7206xf2022ab5473b42ad9bced3eb032b23b71780880135.jpg?x-bce-process=image/quality,q_88/resize,m_fill,w_280,h_210"/></div></div><div class="flex-1"><h4 class="line-height-1.5 line-clamp-2"><img alt="icon" loading="lazy" width="41" height="14" decoding="async" data-nimg="1" class="mr-5 inline-block h-14 w-41 -translate-y-1.5" style="color:transparent" src="https://image-public.guazistatic.com/qnbdp1066x2bcdce4af34c493db02eddd6babff42e1754566654.png"/>创维汽车 创维HT-i 2024款 1.5L PHEV 115KM 泰道版</h4><div class="flex h-20 flex-wrap gap-y-10 overflow-hidden whitespace-nowrap w-274 py-4"><span class="text-10 mr-3 flex h-14 items-center justify-center rounded-xs border border-solid px-3" data-text="已检测" style="color:#009B3F;border-color:#99D7B2">已检测</span><span class="text-10 mr-3 flex h-14 items-center justify-center rounded-xs border border-solid px-3" data-text="插电混动" style="color:#009B3F;border-color:#99D7B2">插电混动</span></div><p class="text-11 text-gz-gray-999 leading-11"><span>2025年</span><span>｜</span><span>0.64万公里</span><span>｜</span><span>北京</span></p><div class="flex justify-start pt-4 leading-12"><div class="flex items-end justify-start"><span class="text-gz-red-f22a18 font-din text-18 leading-12 font-bold">6.85</span><span class="text-gz-red-f22a18 text-12 mr-2">万</span></div><div class="flex flex-1 items-end justify-between"><span class="text-gz-glod-997147 text-12 ml-4">首付<!-- -->0.69万</span></div></div></div></section></a>
+<a class="text-gz-black-303740" href="/car-detail/c168569647231900.html"><section class="mb-20 flex justify-between gap-12"><div class="overflow-hidden rounded-md w-114 h-85"><div class="rounded-md object-cover w-114 h-85" style="position:relative;overflow:hidden"><img alt="雪佛兰 科帕奇 2014款 2.4L 四驱旗舰版 7座" loading="lazy" width="114" height="85" decoding="async" data-nimg="1" class="object-cover" style="color:transparent;position:absolute;width:100%;height:100%;top:0;left:0;opacity:0;transition:opacity 0.3s ease" src="https://image-public.guazistatic.com/qnbdp7206x97a811e2903f49e09bb878a57fdcbd0b1781747835.jpg?x-bce-process=image/quality,q_88/resize,m_fill,w_280,h_210"/></div></div><div class="flex-1"><h4 class="line-height-1.5 line-clamp-2"><img alt="icon" loading="lazy" width="41" height="14" decoding="async" data-nimg="1" class="mr-5 inline-block h-14 w-41 -translate-y-1.5" style="color:transparent" src="https://image-public.guazistatic.com/qnbdp1066x1ee05047385e452c90ad8ae7a264a0b51754566654.png"/>雪佛兰 科帕奇 2014款 2.4L 四驱旗舰版 7座</h4><div class="flex h-20 flex-wrap gap-y-10 overflow-hidden whitespace-nowrap w-274 py-4"><span class="text-10 mr-3 flex h-14 items-center justify-center rounded-xs border border-solid px-3" data-text="已检测" style="color:#009B3F;border-color:#99D7B2">已检测</span><span class="text-10 mr-3 flex h-14 items-center justify-center rounded-xs border border-solid px-3" data-text="顶配" style="color:#303741;border-color:#DFE0E2">顶配</span></div><p class="text-11 text-gz-gray-999 leading-11"><span>2015年</span><span>｜</span><span>18.27万公里</span><span>｜</span><span>北京</span></p><div class="flex justify-start pt-4 leading-12"><div class="flex items-end justify-start"><span class="text-gz-red-f22a18 font-din text-18 leading-12 font-bold">1.41</span><span class="text-gz-red-f22a18 text-12 mr-2">万</span></div><div class="flex flex-1 items-end justify-between"><span class="text-gz-glod-997147 text-12 ml-4">首付<!-- -->0.14万</span></div></div></div></section></a>
+<a class="text-gz-black-303740" href="/car-detail/c168109339309545.html"><section class="mb-20 flex justify-between gap-12"><div class="overflow-hidden rounded-md w-114 h-85"><div class="rounded-md object-cover w-114 h-85" style="position:relative;overflow:hidden"><img alt="吉利银河 银河A7 2026款 EV 550km 臻享版" loading="lazy" width="114" height="85" decoding="async" data-nimg="1" class="object-cover" style="color:transparent;position:absolute;width:100%;height:100%;top:0;left:0;opacity:0;transition:opacity 0.3s ease" src="https://image-public.guazistatic.com/qnbdp7206xfeffa252cc524361918effe5eca6e18b1780731400.jpg?x-bce-process=image/quality,q_88/resize,m_fill,w_280,h_210"/></div></div><div class="flex-1"><h4 class="line-height-1.5 line-clamp-2"><img alt="icon" loading="lazy" width="41" height="14" decoding="async" data-nimg="1" class="mr-5 inline-block h-14 w-41 -translate-y-1.5" style="color:transparent" src="https://image-public.guazistatic.com/qnbdp1066x2bcdce4af34c493db02eddd6babff42e1754566654.png"/>吉利银河 银河A7 2026款 EV 550km 臻享版</h4><div class="flex h-20 flex-wrap gap-y-10 overflow-hidden whitespace-nowrap w-274 py-4"><span class="text-10 mr-3 flex h-14 items-center justify-center rounded-xs border border-solid px-3" data-text="已检测" style="color:#009B3F;border-color:#99D7B2">已检测</span><span class="text-10 mr-3 flex h-14 items-center justify-center rounded-xs border border-solid px-3" data-text="纯电动" style="color:#009B3F;border-color:#99D7B2">纯电动</span></div><p class="text-11 text-gz-gray-999 leading-11"><span>2026年</span><span>｜</span><span>300公里</span><span>｜</span><span>北京</span></p><div class="flex justify-start pt-4 leading-12"><div class="flex items-end justify-start"><span class="text-gz-red-f22a18 font-din text-18 leading-12 font-bold">10.08</span><span class="text-gz-red-f22a18 text-12 mr-2">万</span></div><div class="flex flex-1 items-end justify-between"><span class="text-gz-glod-997147 text-12 ml-4">首付<!-- -->1.01万</span></div></div></div></section></a>
+</div></body></html>

package/clis/guazi/browse.js

@@ -0,0 +1 @@
+import{cli as j,Strategy as A}from"@jackwener/opencli/registry";import{BROWSE_COLUMNS as B,CommandExecutionError as G,GUAZI_M_BASE as N,clean as W,guaziFetch as O,requireStableId as R,requireText as U,requireLimit as q,resolveCityCode as L}from"./utils.js";const _=["插电混动","纯电动","油电混动","增程式","汽油","柴油"];export function parseListings(P,H){const Q=String(P||"").match(/<a[^>]+href="\/car-detail\/c\d+\.html"[\s\S]*?<\/a>/g)||[],f=[],J=new Set;for(const V of Q){const X=V.match(/car-detail\/c(\d+)\.html/);if(!X)continue;const K=R(X[1],`guazi listing row ${f.length+1}`);if(J.has(K))continue;J.add(K);const $=V.match(/<img[^>]+alt="([^"]+)"/),Y=U($&&$[1],`guazi listing ${K} title`),D=W(V.replace(/<[^>]+>/g," ")),k=D.match(/(\d+(?:\.\d+)?)\s*万\s*首付/),v=D.match(/首付\s*(\d+(?:\.\d+)?)\s*万/),z=D.match(/(\d+(?:\.\d+)?万公里|\d+公里)/),F=D.match(/(\d{4})年/),T=D.match(/[｜|]\s*([^｜|]{1,8}?)\s+\d+(?:\.\d+)?\s*万\s*首付/),Z=_.find((b)=>D.includes(b))||"";f.push({rank:f.length+1,clue_id:K,title:Y,price:k?`${k[1]}万`:"",down_payment:v?`${v[1]}万`:"",mileage:z?z[1]:"",year:F?F[1]:"",city:T?W(T[1]):Z,url:`${N}/car-detail/c${K}.html`});if(f.length>=H)break}return f}j({site:"guazi",name:"browse",access:"read",aliases:["list"],description:"瓜子二手车在售车源列表（按城市，含售价/首付/里程/年份）",strategy:A.PUBLIC,browser:!1,args:[{name:"city",positional:!0,help:"城市名（北京/上海/...）或瓜子城市码（bj/sh/...）。默认 bj 北京"},{name:"limit",type:"int",default:20,help:"返回的车源数量（最多 40，单页 SSR 上限）"}],columns:B,func:async(P)=>{const H=L(P.city),Q=q(P.limit,20,40),f=await O(`/${H}/buy/`,`browse ${H}`),J=parseListings(f,Q);if(J.length===0)throw new G(`guazi browse ${H}`,"No SSR listing anchors found on a successful Guazi mobile page; the mobile layout may have changed.");return J}});

package/clis/guazi/car.js

@@ -0,0 +1 @@
+import{cli as O,Strategy as W}from"@jackwener/opencli/registry";import{CAR_COLUMNS as Z,EmptyResultError as j,GUAZI_M_BASE as q,clean as Y,guaziFetch as x,normalizeClueId as z,requireText as L}from"./utils.js";const A=["首次上牌","表显里程","过户次数","车源地","车身颜色","发动机","变速箱","驱动方式","排放标准","车源编号"];function D(P){let H=Y(P);H=H.replace(/^【[^】]*】/,"");H=H.replace(/^二手/,"");H=H.replace(/报价[，,].*$/,"");H=H.replace(/\s*-\s*瓜子二手车.*$/,"");return Y(H)}export function parseCarDetail(P,H){const K=String(P||"").replace(/\\"/g,'"'),Q=K.match(/<meta[^>]+property="og:title"[^>]+content="([^"]+)"/)||K.match(/"title":"([^"]{6,80})"/),V=Q?Q[1]:"",X=Y(V).match(/^【([^】]+)】/),F=K.match(/"price":(\d{4,8})/),N=F?`${(Number(F[1])/1e4).toFixed(2)}万`:"",J={};for(const[,$,B]of K.matchAll(/"label":"([^"]{1,12})","value":"([^"]{1,40})"/g))if(!($ in J))J[$]=Y(B);const G=K.match(/基础车况[^,，"<]{0,16}/);return[["clue_id",String(H)],["title",V?D(V):""],["tag",X?X[1]:""],["price",N],["reg_date",J["首次上牌"]||""],["mileage",J["表显里程"]||""],["transfers",J["过户次数"]||""],["source_city",J["车源地"]||""],["color",J["车身颜色"]||""],["engine",J["发动机"]||""],["gearbox",J["变速箱"]||""],["drivetrain",J["驱动方式"]||""],["emission",J["排放标准"]||""],["condition",G?Y(G[0]):""],["listing_no",J["车源编号"]||""],["url",`${q}/car-detail/c${H}.html`]].map(([$,B])=>({field:$,value:B}))}function R(P){const H=Object.fromEntries(P.map((K)=>[K.field,K.value]));return Boolean(H.title||H.price||H.reg_date)}O({site:"guazi",name:"car",access:"read",aliases:["detail"],description:"瓜子二手车车源详情（售价 / 上牌 / 里程 / 过户 / 配置 / 车况）",strategy:W.PUBLIC,browser:!1,args:[{name:"clue_id",required:!0,positional:!0,help:"车源 ID（来自 browse 的 clue_id，或 /car-detail/c<id>.html URL）"}],columns:Z,func:async(P)=>{const H=z(P.clue_id),K=await x(`/car-detail/c${H}.html`,`car ${H}`),Q=parseCarDetail(K,H);if(!R(Q))throw new j(`guazi car ${H}`,"No listing detail found — the car may have been sold/removed, or the id is wrong.");const V=Object.fromEntries(Q.map((X)=>[X.field,X.value]));L(V.title,`guazi car ${H} title`);L(V.price,`guazi car ${H} price`);return Q}});

package/clis/guazi/utils.js

@@ -0,0 +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};

package/clis/hackernews/ask.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"hackernews",name:"ask",access:"read",description:"Hacker News Ask HN posts",domain:"news.ycombinator.com",strategy:t.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of stories"}],columns:["rank","id","title","score","author","comments","url"],pipeline:[{fetch:{url:"https://hacker-news.firebaseio.com/v0/askstories.json"}},{limit:"${{ Math.min((args.limit ? args.limit : 20) + 10, 50) }}"},{map:{id:"${{ item }}"}},{fetch:{url:"https://hacker-news.firebaseio.com/v0/item/${{ item.id }}.json"}},{filter:"item.title && !item.deleted && !item.dead"},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",score:"${{ item.score }}",author:"${{ item.by }}",comments:"${{ item.descendants }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/hackernews/auth.js

@@ -0,0 +1,9 @@
+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(`(() => {
+    // 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"]');
+    if (!userLink || !logout) return { anon: true };
+    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)}});

package/clis/hackernews/best.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"hackernews",name:"best",access:"read",description:"Hacker News best stories",domain:"news.ycombinator.com",strategy:t.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of stories"}],columns:["rank","id","title","score","author","comments","url"],pipeline:[{fetch:{url:"https://hacker-news.firebaseio.com/v0/beststories.json"}},{limit:"${{ Math.min((args.limit ? args.limit : 20) + 10, 50) }}"},{map:{id:"${{ item }}"}},{fetch:{url:"https://hacker-news.firebaseio.com/v0/item/${{ item.id }}.json"}},{filter:"item.title && !item.deleted && !item.dead"},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",score:"${{ item.score }}",author:"${{ item.by }}",comments:"${{ item.descendants }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/hackernews/comment.js

@@ -0,0 +1,61 @@
+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",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 () => {
+      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];
+        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)};
+        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)});
+
+        const res = await fetch('/comment', {
+          method: 'POST',
+          credentials: 'include',
+          headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+          body: p.toString(),
+          redirect: 'manual',
+        });
+        if (res.type === 'opaqueredirect' || res.status === 302 || res.status === 0) {
+          return { ok: true };
+        }
+        const body = await res.text();
+        let msg = '';
+        if (/Please try again/i.test(body)) msg = 'HN asked to try again (possible rate limit or expired token).';
+        else if (/You're posting too fast|too fast/i.test(body)) msg = 'Posting too fast — HN rate limited the comment.';
+        else {
+          const td = body.match(/<td[^>]*>\\s*([^<][^<]{0,200}?)\\s*<\\/td>/i);
+          if (td) msg = td[1].replace(/\\s+/g, ' ').trim();
+        }
+        return { kind: 'reject', detail: msg || ('HTTP ' + res.status + ' without redirect'), status: res.status };
+      } 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(`(() => {
+      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 rows = [...document.querySelectorAll('tr.athing.comtr')];
+        // Newest first: our fresh comment is usually near the top of its thread.
+        for (const row of rows) {
+          const by = (row.querySelector('a.hnuser')?.textContent || '').trim();
+          if (username && by !== username) continue;
+          const commentText = (row.querySelector('.commtext')?.textContent || '').replace(/\\s+/g, ' ').trim();
+          if (commentText.startsWith(want.slice(0, 60))) {
+            return { id: row.id };
+          }
+        }
+        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)"}]}});

package/clis/hackernews/jobs.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as i}from"@jackwener/opencli/registry";e({site:"hackernews",name:"jobs",access:"read",description:"Hacker News job postings",domain:"news.ycombinator.com",strategy:i.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of job postings"}],columns:["rank","id","title","author","url"],pipeline:[{fetch:{url:"https://hacker-news.firebaseio.com/v0/jobstories.json"}},{limit:"${{ Math.min((args.limit ? args.limit : 20) + 10, 50) }}"},{map:{id:"${{ item }}"}},{fetch:{url:"https://hacker-news.firebaseio.com/v0/item/${{ item.id }}.json"}},{filter:"item.title && !item.deleted && !item.dead"},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",author:"${{ item.by }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/hackernews/new.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"hackernews",name:"new",access:"read",description:"Hacker News newest stories",domain:"news.ycombinator.com",strategy:t.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of stories"}],columns:["rank","id","title","score","author","comments","url"],pipeline:[{fetch:{url:"https://hacker-news.firebaseio.com/v0/newstories.json"}},{limit:"${{ Math.min((args.limit ? args.limit : 20) + 10, 50) }}"},{map:{id:"${{ item }}"}},{fetch:{url:"https://hacker-news.firebaseio.com/v0/item/${{ item.id }}.json"}},{filter:"item.title && !item.deleted && !item.dead"},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",score:"${{ item.score }}",author:"${{ item.by }}",comments:"${{ item.descendants }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/hackernews/read.js

@@ -0,0 +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,`
+
+`).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}});

package/clis/hackernews/search.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"hackernews",name:"search",access:"read",description:"Search Hacker News stories",domain:"news.ycombinator.com",strategy:t.PUBLIC,browser:!1,args:[{name:"query",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:20,help:"Number of results"},{name:"sort",default:"relevance",help:"Sort by relevance or date",choices:["relevance","date"]}],columns:["rank","id","title","score","author","comments","url"],pipeline:[{fetch:{url:"https://hn.algolia.com/api/v1/${{ args.sort === 'date' ? 'search_by_date' : 'search' }}",params:{query:"${{ args.query }}",tags:"story",hitsPerPage:"${{ args.limit }}"}}},{select:"hits"},{map:{rank:"${{ index + 1 }}",id:"${{ item.objectID }}",title:"${{ item.title }}",score:"${{ item.points }}",author:"${{ item.author }}",comments:"${{ item.num_comments }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/hackernews/show.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"hackernews",name:"show",access:"read",description:"Hacker News Show HN posts",domain:"news.ycombinator.com",strategy:t.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of stories"}],columns:["rank","id","title","score","author","comments","url"],pipeline:[{fetch:{url:"https://hacker-news.firebaseio.com/v0/showstories.json"}},{limit:"${{ Math.min((args.limit ? args.limit : 20) + 10, 50) }}"},{map:{id:"${{ item }}"}},{fetch:{url:"https://hacker-news.firebaseio.com/v0/item/${{ item.id }}.json"}},{filter:"item.title && !item.deleted && !item.dead"},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",score:"${{ item.score }}",author:"${{ item.by }}",comments:"${{ item.descendants }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/hackernews/submit.js

@@ -0,0 +1,65 @@
+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",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 () => {
+      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.
+        if (/\\/login/.test(location.pathname)) return { kind: 'auth', detail: 'redirected to /login' };
+        const form = document.querySelector('form[action$="/r"], form[action="/r"], form[action="https://news.ycombinator.com/r"]')
+          || [...document.querySelectorAll('form')].find(f => f.querySelector('input[name="fnid"]'));
+        if (!form) return { kind: 'auth', detail: 'submit form not found — not signed in' };
+        const fnid = form.querySelector('input[name="fnid"]')?.value;
+        if (!fnid) return { kind: 'auth', detail: 'fnid token missing' };
+
+        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)});
+
+        const res = await fetch('/r', {
+          method: 'POST',
+          credentials: 'include',
+          headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+          body: p.toString(),
+          redirect: 'manual',
+        });
+        // A same-origin 302 comes back as an opaque redirect (status 0) — that
+        // is the success path. A 200 means HN re-rendered the form with an error.
+        if (res.type === 'opaqueredirect' || res.status === 302 || res.status === 0) {
+          return { ok: true };
+        }
+        const body = await res.text();
+        // Pull the first human-readable error HN prints above the form.
+        let msg = '';
+        const td = body.match(/<td[^>]*>\\s*([^<][^<]{0,200}?)\\s*<\\/td>/i);
+        if (/Please try again/i.test(body)) msg = 'HN asked to try again (possible rate limit or expired token).';
+        else if (/already been submitted/i.test(body)) msg = 'That URL has already been submitted.';
+        else if (td) msg = td[1].replace(/\\s+/g, ' ').trim();
+        return { kind: 'reject', detail: msg || ('HTTP ' + res.status + ' without redirect'), status: res.status };
+      } 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 () => {
+      try {
+        const uc = document.cookie.match(/(?:^|; )user=([^;]+)/);
+        // Cookie value is "<username>&<hash>"; the nav link is more reliable.
+        let username = '';
+        const navLink = document.querySelector('span.pagetop a[href^="user?id="]');
+        if (navLink) username = (navLink.getAttribute('href') || '').replace('user?id=', '');
+        if (!username && uc) username = decodeURIComponent(uc[1]).split('&')[0];
+        if (!username) return null;
+        const res = await fetch('/submitted?id=' + encodeURIComponent(username), { credentials: 'include' });
+        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();
+        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();
+          if (t === want) {
+            return { id: row.id, href: link?.getAttribute('href') || '' };
+          }
+        }
+        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)"}]}});

package/clis/hackernews/top.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"hackernews",name:"top",access:"read",description:"Hacker News top stories",domain:"news.ycombinator.com",strategy:t.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of stories"}],columns:["rank","id","title","score","author","comments","url"],pipeline:[{fetch:{url:"https://hacker-news.firebaseio.com/v0/topstories.json"}},{limit:"${{ Math.min((args.limit ? args.limit : 20) + 10, 50) }}"},{map:{id:"${{ item }}"}},{fetch:{url:"https://hacker-news.firebaseio.com/v0/item/${{ item.id }}.json"}},{filter:"item.title && !item.deleted && !item.dead"},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",score:"${{ item.score }}",author:"${{ item.by }}",comments:"${{ item.descendants }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/hackernews/user.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as r}from"@jackwener/opencli/registry";e({site:"hackernews",name:"user",access:"read",description:"Hacker News user profile",domain:"news.ycombinator.com",strategy:r.PUBLIC,browser:!1,args:[{name:"username",required:!0,positional:!0,help:"HN username"}],columns:["username","karma","created","about"],pipeline:[{fetch:{url:"https://hacker-news.firebaseio.com/v0/user/${{ args.username }}.json"}},{map:{username:"${{ item.id }}",karma:"${{ item.karma }}",created:"${{ item.created ? new Date(item.created * 1000).toISOString().slice(0, 10) : '' }}",about:"${{ item.about }}"}}]});