@jackwener/opencli 1.6.8 → 1.6.10

package/dist/src/cli.js

@@ -21,11 +21,11 @@ import { registerAllCommands } from './commanderAdapter.js';
 import { EXIT_CODES, getErrorMessage } from './errors.js';
 import { daemonStatus, daemonStop, daemonRestart } from './commands/daemon.js';
 const CLI_FILE = fileURLToPath(import.meta.url);
-/** Create a browser page for operate commands. Uses 'operate' workspace for session persistence. */
-async function getOperatePage() {
+/** Create a browser page for browser commands. Uses a dedicated browser workspace for session persistence. */
+async function getBrowserPage() {
     const { BrowserBridge } = await import('./browser/index.js');
     const bridge = new BrowserBridge();
-    return bridge.connect({ timeout: 30, workspace: 'operate:default' });
+    return bridge.connect({ timeout: 30, workspace: 'browser:default' });
 }
 function applyVerbose(opts) {
     if (opts.verbose)
@@ -171,24 +171,30 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
     });
     program
         .command('generate')
-        .description('One-shot: explore → synthesize → register')
+        .description('One-shot: explore → synthesize → verify → register')
         .argument('<url>')
         .option('--goal <text>')
         .option('--site <name>')
+        .option('--format <fmt>', 'Output format: table, json', 'table')
+        .option('--no-register', 'Verify the generated adapter without registering it')
         .option('-v, --verbose', 'Debug output')
         .action(async (url, opts) => {
         applyVerbose(opts);
-        const { generateCliFromUrl, renderGenerateSummary } = await import('./generate.js');
+        const { generateVerifiedFromUrl, renderGenerateVerifiedSummary } = await import('./generate-verified.js');
         const workspace = `generate:${inferHost(url, opts.site)}`;
-        const r = await generateCliFromUrl({
+        const r = await generateVerifiedFromUrl({
             url,
             BrowserFactory: getBrowserFactory(),
             goal: opts.goal,
             site: opts.site,
             workspace,
+            noRegister: opts.register === false,
         });
-        console.log(renderGenerateSummary(r));
-        process.exitCode = r.ok ? EXIT_CODES.SUCCESS : EXIT_CODES.GENERIC_ERROR;
+        if (opts.format === 'json')
+            console.log(JSON.stringify(r, null, 2));
+        else
+            console.log(renderGenerateVerifiedSummary(r));
+        process.exitCode = r.status === 'success' ? EXIT_CODES.SUCCESS : EXIT_CODES.GENERIC_ERROR;
     });
     // ── Built-in: record ─────────────────────────────────────────────────────
     program
@@ -235,22 +241,22 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
         }, { workspace });
         console.log(renderCascadeResult(result));
     });
-    // ── Built-in: operate (browser control for Claude Code skill) ───────────────
+    // ── Built-in: browser (browser control for Claude Code skill) ───────────────
     //
     // Make websites accessible for AI agents.
-    // All commands wrapped in operateAction() for consistent error handling.
-    const operate = program
-        .command('operate')
+    // All commands wrapped in browserAction() for consistent error handling.
+    const browser = program
+        .command('browser')
         .description('Browser control — navigate, click, type, extract, wait (no LLM needed)');
-    /** Wrap operate actions with error handling and optional --json output */
-    function operateAction(fn) {
+    /** Wrap browser actions with error handling and optional --json output */
+    function browserAction(fn) {
         return async (...args) => {
             try {
-                const page = await getOperatePage();
+                const page = await getBrowserPage();
                 await fn(page, ...args);
             }
             catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
+                const msg = getErrorMessage(err);
                 if (msg.includes('Extension not connected') || msg.includes('Daemon')) {
                     console.error(`Browser not connected. Run 'opencli doctor' to diagnose.`);
                 }
@@ -267,14 +273,14 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
     // ── Navigation ──
     /** Network interceptor JS — injected on every open/navigate to capture fetch/XHR */
     const NETWORK_INTERCEPTOR_JS = `(function(){if(window.__opencli_net)return;window.__opencli_net=[];var M=200,B=50000,F=window.fetch;window.fetch=async function(){var r=await F.apply(this,arguments);try{var ct=r.headers.get('content-type')||'';if(ct.includes('json')||ct.includes('text')){var c=r.clone(),t=await c.text();if(window.__opencli_net.length<M){var b=null;if(t.length<=B)try{b=JSON.parse(t)}catch(e){b=t}window.__opencli_net.push({url:r.url||(arguments[0]&&arguments[0].url)||String(arguments[0]),method:(arguments[1]&&arguments[1].method)||'GET',status:r.status,size:t.length,ct:ct,body:b})}}}catch(e){}return r};var X=XMLHttpRequest.prototype,O=X.open,S=X.send;X.open=function(m,u){this._om=m;this._ou=u;return O.apply(this,arguments)};X.send=function(){var x=this;x.addEventListener('load',function(){try{var ct=x.getResponseHeader('content-type')||'';if((ct.includes('json')||ct.includes('text'))&&window.__opencli_net.length<M){var t=x.responseText,b=null;if(t&&t.length<=B)try{b=JSON.parse(t)}catch(e){b=t}window.__opencli_net.push({url:x._ou,method:x._om||'GET',status:x.status,size:t?t.length:0,ct:ct,body:b})}}catch(e){}});return S.apply(this,arguments)}})()`;
-    operate.command('open').argument('<url>').description('Open URL in automation window')
-        .action(operateAction(async (page, url) => {
+    browser.command('open').argument('<url>').description('Open URL in automation window')
+        .action(browserAction(async (page, url) => {
         // Start session-level capture before navigation (catches initial requests)
-        await page.startNetworkCapture?.();
+        const hasSessionCapture = await page.startNetworkCapture?.().then(() => true).catch(() => false);
         await page.goto(url);
         await page.wait(2);
-        // Fallback: also inject JS interceptor for pages without session capture
-        if (!page.startNetworkCapture) {
+        // Fallback: inject JS interceptor when session capture is unavailable
+        if (!hasSessionCapture) {
             try {
                 await page.evaluate(NETWORK_INTERCEPTOR_JS);
             }
@@ -282,15 +288,15 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
         }
         console.log(`Navigated to: ${await page.getCurrentUrl?.() ?? url}`);
     }));
-    operate.command('back').description('Go back in browser history')
-        .action(operateAction(async (page) => {
+    browser.command('back').description('Go back in browser history')
+        .action(browserAction(async (page) => {
         await page.evaluate('history.back()');
         await page.wait(2);
         console.log('Navigated back');
     }));
-    operate.command('scroll').argument('<direction>', 'up or down').option('--amount <pixels>', 'Pixels to scroll', '500')
+    browser.command('scroll').argument('<direction>', 'up or down').option('--amount <pixels>', 'Pixels to scroll', '500')
         .description('Scroll page')
-        .action(operateAction(async (page, direction, opts) => {
+        .action(browserAction(async (page, direction, opts) => {
         if (direction !== 'up' && direction !== 'down') {
             console.error(`Invalid direction "${direction}". Use "up" or "down".`);
             process.exitCode = EXIT_CODES.USAGE_ERROR;
@@ -300,16 +306,16 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
         console.log(`Scrolled ${direction}`);
     }));
     // ── Inspect ──
-    operate.command('state').description('Page state: URL, title, interactive elements with [N] indices')
-        .action(operateAction(async (page) => {
+    browser.command('state').description('Page state: URL, title, interactive elements with [N] indices')
+        .action(browserAction(async (page) => {
         const snapshot = await page.snapshot({ viewportExpand: 2000 });
         const url = await page.getCurrentUrl?.() ?? '';
         console.log(`URL: ${url}\n`);
         console.log(typeof snapshot === 'string' ? snapshot : JSON.stringify(snapshot, null, 2));
     }));
-    operate.command('screenshot').argument('[path]', 'Save to file (base64 if omitted)')
+    browser.command('screenshot').argument('[path]', 'Save to file (base64 if omitted)')
         .description('Take screenshot')
-        .action(operateAction(async (page, path) => {
+        .action(browserAction(async (page, path) => {
         if (path) {
             await page.screenshot({ path });
             console.log(`Screenshot saved to: ${path}`);
@@ -319,45 +325,45 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
         }
     }));
     // ── Get commands (structured data extraction) ──
-    const get = operate.command('get').description('Get page properties');
+    const get = browser.command('get').description('Get page properties');
     get.command('title').description('Page title')
-        .action(operateAction(async (page) => {
+        .action(browserAction(async (page) => {
         console.log(await page.evaluate('document.title'));
     }));
     get.command('url').description('Current page URL')
-        .action(operateAction(async (page) => {
+        .action(browserAction(async (page) => {
         console.log(await page.getCurrentUrl?.() ?? await page.evaluate('location.href'));
     }));
     get.command('text').argument('<index>', 'Element index').description('Element text content')
-        .action(operateAction(async (page, index) => {
+        .action(browserAction(async (page, index) => {
         const text = await page.evaluate(`document.querySelector('[data-opencli-ref="${index}"]')?.textContent?.trim()`);
         console.log(text ?? '(empty)');
     }));
     get.command('value').argument('<index>', 'Element index').description('Input/textarea value')
-        .action(operateAction(async (page, index) => {
+        .action(browserAction(async (page, index) => {
         const val = await page.evaluate(`document.querySelector('[data-opencli-ref="${index}"]')?.value`);
         console.log(val ?? '(empty)');
     }));
     get.command('html').option('--selector <css>', 'CSS selector scope').description('Page HTML (or scoped)')
-        .action(operateAction(async (page, opts) => {
+        .action(browserAction(async (page, opts) => {
         const sel = opts.selector ? JSON.stringify(opts.selector) : 'null';
         const html = await page.evaluate(`(${sel} ? document.querySelector(${sel})?.outerHTML : document.documentElement.outerHTML)?.slice(0, 50000)`);
         console.log(html ?? '(empty)');
     }));
     get.command('attributes').argument('<index>', 'Element index').description('Element attributes')
-        .action(operateAction(async (page, index) => {
+        .action(browserAction(async (page, index) => {
         const attrs = await page.evaluate(`JSON.stringify(Object.fromEntries([...document.querySelector('[data-opencli-ref="${index}"]')?.attributes].map(a=>[a.name,a.value])))`);
         console.log(attrs ?? '{}');
     }));
     // ── Interact ──
-    operate.command('click').argument('<index>', 'Element index from state').description('Click element by index')
-        .action(operateAction(async (page, index) => {
+    browser.command('click').argument('<index>', 'Element index from state').description('Click element by index')
+        .action(browserAction(async (page, index) => {
         await page.click(index);
         console.log(`Clicked element [${index}]`);
     }));
-    operate.command('type').argument('<index>', 'Element index').argument('<text>', 'Text to type')
+    browser.command('type').argument('<index>', 'Element index').argument('<text>', 'Text to type')
         .description('Click element, then type text')
-        .action(operateAction(async (page, index, text) => {
+        .action(browserAction(async (page, index, text) => {
         await page.click(index);
         await page.wait(0.3);
         await page.typeText(index, text);
@@ -380,9 +386,9 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
             console.log(`Typed "${text}" into element [${index}]`);
         }
     }));
-    operate.command('select').argument('<index>', 'Element index of <select>').argument('<option>', 'Option text')
+    browser.command('select').argument('<index>', 'Element index of <select>').argument('<option>', 'Option text')
         .description('Select dropdown option')
-        .action(operateAction(async (page, index, option) => {
+        .action(browserAction(async (page, index, option) => {
         const result = await page.evaluate(`
         (function() {
           var sel = document.querySelector('[data-opencli-ref="${index}"]');
@@ -404,19 +410,19 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
             console.log(`Selected "${result?.selected}" in element [${index}]`);
         }
     }));
-    operate.command('keys').argument('<key>', 'Key to press (Enter, Escape, Tab, Control+a)')
+    browser.command('keys').argument('<key>', 'Key to press (Enter, Escape, Tab, Control+a)')
         .description('Press keyboard key')
-        .action(operateAction(async (page, key) => {
+        .action(browserAction(async (page, key) => {
         await page.pressKey(key);
         console.log(`Pressed: ${key}`);
     }));
     // ── Wait commands ──
-    operate.command('wait')
+    browser.command('wait')
         .argument('<type>', 'selector, text, or time')
         .argument('[value]', 'CSS selector, text string, or seconds')
         .option('--timeout <ms>', 'Timeout in milliseconds', '10000')
         .description('Wait for selector, text, or time (e.g. wait selector ".loaded", wait text "Success", wait time 3)')
-        .action(operateAction(async (page, type, value, opts) => {
+        .action(browserAction(async (page, type, value, opts) => {
         const timeout = parseInt(opts.timeout, 10);
         if (type === 'time') {
             const seconds = parseFloat(value ?? '2');
@@ -447,8 +453,8 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
         }
     }));
     // ── Extract ──
-    operate.command('eval').argument('<js>', 'JavaScript code').description('Execute JS in page context, return result')
-        .action(operateAction(async (page, js) => {
+    browser.command('eval').argument('<js>', 'JavaScript code').description('Execute JS in page context, return result')
+        .action(browserAction(async (page, js) => {
         const result = await page.evaluate(js);
         if (typeof result === 'string')
             console.log(result);
@@ -456,11 +462,11 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
             console.log(JSON.stringify(result, null, 2));
     }));
     // ── Network (API discovery) ──
-    operate.command('network')
+    browser.command('network')
         .option('--detail <index>', 'Show full response body of request at index')
         .option('--all', 'Show all requests including static resources')
         .description('Show captured network requests (auto-captured since last open)')
-        .action(operateAction(async (page, opts) => {
+        .action(browserAction(async (page, opts) => {
         let items = [];
         if (page.readNetworkCapture) {
             const raw = await page.readNetworkCapture();
@@ -498,7 +504,7 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
                 items = JSON.parse(requests);
             }
             catch {
-                console.log('No network data captured. Run "operate open <url>" first.');
+                console.log('No network data captured. Run "browser open <url>" first.');
                 return;
             }
         }
@@ -537,7 +543,7 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
         }
     }));
     // ── Init (adapter scaffolding) ──
-    operate.command('init')
+    browser.command('init')
         .argument('<name>', 'Adapter name in site/command format (e.g. hn/top)')
         .description('Generate adapter scaffold in ~/.opencli/clis/')
         .action(async (name) => {
@@ -563,10 +569,10 @@ export function createProgram(BUILTIN_CLIS, USER_CLIS) {
                 console.log(`Adapter already exists: ${filePath}`);
                 return;
             }
-            // Try to detect domain from last operate session
+            // Try to detect domain from the last browser session
             let domain = site;
             try {
-                const page = await getOperatePage();
+                const page = await getBrowserPage();
                 const url = await page.getCurrentUrl?.();
                 if (url) {
                     try {
@@ -600,7 +606,7 @@ cli({
             fs.mkdirSync(dir, { recursive: true });
             fs.writeFileSync(filePath, template, 'utf-8');
             console.log(`Created: ${filePath}`);
-            console.log(`Edit the file to implement your adapter, then run: opencli operate verify ${name}`);
+            console.log(`Edit the file to implement your adapter, then run: opencli browser verify ${name}`);
         }
         catch (err) {
             console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
@@ -608,7 +614,7 @@ cli({
         }
     });
     // ── Verify (test adapter) ──
-    operate.command('verify')
+    browser.command('verify')
         .argument('<name>', 'Adapter name in site/command format (e.g. hn/top)')
         .description('Execute an adapter and show results')
         .action(async (name) => {
@@ -630,7 +636,7 @@ cli({
             const filePath = path.join(os.homedir(), '.opencli', 'clis', site, `${command}.ts`);
             if (!fs.existsSync(filePath)) {
                 console.error(`Adapter not found: ${filePath}`);
-                console.error(`Run "opencli operate init ${name}" to create it.`);
+                console.error(`Run "opencli browser init ${name}" to create it.`);
                 process.exitCode = EXIT_CODES.GENERIC_ERROR;
                 return;
             }
@@ -641,7 +647,7 @@ cli({
             const hasLimitArg = /['"]limit['"]/.test(adapterSrc);
             const limitFlag = hasLimitArg ? ' --limit 3' : '';
             const limitArgs = hasLimitArg ? ['--limit', '3'] : [];
-            const invocation = resolveOperateVerifyInvocation();
+            const invocation = resolveBrowserVerifyInvocation();
             try {
                 const output = execFileSync(invocation.binary, [...invocation.args, site, command, ...limitArgs], {
                     cwd: invocation.cwd,
@@ -657,10 +663,12 @@ cli({
             }
             catch (err) {
                 console.log(`  Executing: opencli ${site} ${command}${limitFlag}\n`);
-                if (err.stdout)
-                    console.log(err.stdout);
-                if (err.stderr)
-                    console.error(err.stderr.slice(0, 500));
+                // execFileSync attaches captured stdout/stderr on its thrown Error.
+                const execErr = err;
+                if (execErr.stdout)
+                    console.log(String(execErr.stdout));
+                if (execErr.stderr)
+                    console.error(String(execErr.stderr).slice(0, 500));
                 console.log(`\n  ✗ Adapter failed. Fix the code and try again.`);
                 process.exitCode = EXIT_CODES.GENERIC_ERROR;
             }
@@ -671,8 +679,8 @@ cli({
         }
     });
     // ── Session ──
-    operate.command('close').description('Close the automation window')
-        .action(operateAction(async (page) => {
+    browser.command('close').description('Close the automation window')
+        .action(browserAction(async (page) => {
         await page.closeWindow?.();
         console.log('Automation window closed');
     }));
@@ -978,7 +986,7 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
     createProgram(BUILTIN_CLIS, USER_CLIS).parse();
 }
 export { findPackageRoot };
-export function resolveOperateVerifyInvocation(opts = {}) {
+export function resolveBrowserVerifyInvocation(opts = {}) {
     const platform = opts.platform ?? process.platform;
     const fileExists = opts.fileExists ?? fs.existsSync;
     const readFile = opts.readFile ?? ((filePath) => fs.readFileSync(filePath, 'utf-8'));

package/dist/src/cli.test.js

@@ -1,10 +1,10 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import * as path from 'node:path';
-const { mockExploreUrl, mockRenderExploreSummary, mockGenerateCliFromUrl, mockRenderGenerateSummary, mockRecordSession, mockRenderRecordSummary, mockCascadeProbe, mockRenderCascadeResult, mockGetBrowserFactory, mockBrowserSession, } = vi.hoisted(() => ({
+const { mockExploreUrl, mockRenderExploreSummary, mockGenerateVerifiedFromUrl, mockRenderGenerateVerifiedSummary, mockRecordSession, mockRenderRecordSummary, mockCascadeProbe, mockRenderCascadeResult, mockGetBrowserFactory, mockBrowserSession, } = vi.hoisted(() => ({
     mockExploreUrl: vi.fn(),
     mockRenderExploreSummary: vi.fn(),
-    mockGenerateCliFromUrl: vi.fn(),
-    mockRenderGenerateSummary: vi.fn(),
+    mockGenerateVerifiedFromUrl: vi.fn(),
+    mockRenderGenerateVerifiedSummary: vi.fn(),
     mockRecordSession: vi.fn(),
     mockRenderRecordSummary: vi.fn(),
     mockCascadeProbe: vi.fn(),
@@ -16,9 +16,9 @@ vi.mock('./explore.js', () => ({
     exploreUrl: mockExploreUrl,
     renderExploreSummary: mockRenderExploreSummary,
 }));
-vi.mock('./generate.js', () => ({
-    generateCliFromUrl: mockGenerateCliFromUrl,
-    renderGenerateSummary: mockRenderGenerateSummary,
+vi.mock('./generate-verified.js', () => ({
+    generateVerifiedFromUrl: mockGenerateVerifiedFromUrl,
+    renderGenerateVerifiedSummary: mockRenderGenerateVerifiedSummary,
 }));
 vi.mock('./record.js', () => ({
     recordSession: mockRecordSession,
@@ -32,7 +32,7 @@ vi.mock('./runtime.js', () => ({
     getBrowserFactory: mockGetBrowserFactory,
     browserSession: mockBrowserSession,
 }));
-import { createProgram, findPackageRoot, resolveOperateVerifyInvocation } from './cli.js';
+import { createProgram, findPackageRoot, resolveBrowserVerifyInvocation } from './cli.js';
 describe('built-in browser commands verbose wiring', () => {
     const consoleLogSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
     beforeEach(() => {
@@ -40,8 +40,8 @@ describe('built-in browser commands verbose wiring', () => {
         process.exitCode = undefined;
         mockExploreUrl.mockReset().mockResolvedValue({ ok: true });
         mockRenderExploreSummary.mockReset().mockReturnValue('explore-summary');
-        mockGenerateCliFromUrl.mockReset().mockResolvedValue({ ok: true });
-        mockRenderGenerateSummary.mockReset().mockReturnValue('generate-summary');
+        mockGenerateVerifiedFromUrl.mockReset().mockResolvedValue({ status: 'success' });
+        mockRenderGenerateVerifiedSummary.mockReset().mockReturnValue('generate-summary');
         mockRecordSession.mockReset().mockResolvedValue({ candidateCount: 1 });
         mockRenderRecordSummary.mockReset().mockReturnValue('record-summary');
         mockCascadeProbe.mockReset().mockResolvedValue({ ok: true });
@@ -65,7 +65,12 @@ describe('built-in browser commands verbose wiring', () => {
         const program = createProgram('', '');
         await program.parseAsync(['node', 'opencli', 'generate', 'https://example.com', '-v']);
         expect(process.env.OPENCLI_VERBOSE).toBe('1');
-        expect(mockGenerateCliFromUrl).toHaveBeenCalledWith(expect.objectContaining({ url: 'https://example.com', workspace: 'generate:example.com' }));
+        expect(mockGenerateVerifiedFromUrl).toHaveBeenCalledWith(expect.objectContaining({ url: 'https://example.com', workspace: 'generate:example.com', noRegister: false }));
+    });
+    it('passes --no-register through the real CLI command', async () => {
+        const program = createProgram('', '');
+        await program.parseAsync(['node', 'opencli', 'generate', 'https://example.com', '--no-register']);
+        expect(mockGenerateVerifiedFromUrl).toHaveBeenCalledWith(expect.objectContaining({ url: 'https://example.com', workspace: 'generate:example.com', noRegister: true }));
     });
     it('enables OPENCLI_VERBOSE for record via the real CLI command', async () => {
         const program = createProgram('', '');
@@ -87,13 +92,13 @@ describe('built-in browser commands verbose wiring', () => {
     });
     consoleLogSpy.mockClear();
 });
-describe('resolveOperateVerifyInvocation', () => {
+describe('resolveBrowserVerifyInvocation', () => {
     it('prefers the built entry declared in package metadata', () => {
         const projectRoot = path.join('repo-root');
         const exists = new Set([
             path.join(projectRoot, 'dist', 'src', 'main.js'),
         ]);
-        expect(resolveOperateVerifyInvocation({
+        expect(resolveBrowserVerifyInvocation({
             projectRoot,
             readFile: () => JSON.stringify({ bin: { opencli: 'dist/src/main.js' } }),
             fileExists: (candidate) => exists.has(candidate),
@@ -108,7 +113,7 @@ describe('resolveOperateVerifyInvocation', () => {
         const exists = new Set([
             path.join(projectRoot, 'dist', 'src', 'main.js'),
         ]);
-        expect(resolveOperateVerifyInvocation({
+        expect(resolveBrowserVerifyInvocation({
             projectRoot,
             readFile: () => { throw new Error('no package json'); },
             fileExists: (candidate) => exists.has(candidate),
@@ -124,7 +129,7 @@ describe('resolveOperateVerifyInvocation', () => {
             path.join(projectRoot, 'src', 'main.ts'),
             path.join(projectRoot, 'node_modules', '.bin', 'tsx.cmd'),
         ]);
-        expect(resolveOperateVerifyInvocation({
+        expect(resolveBrowserVerifyInvocation({
             projectRoot,
             platform: 'win32',
             fileExists: (candidate) => exists.has(candidate),
@@ -140,7 +145,7 @@ describe('resolveOperateVerifyInvocation', () => {
         const exists = new Set([
             path.join(projectRoot, 'src', 'main.ts'),
         ]);
-        expect(resolveOperateVerifyInvocation({
+        expect(resolveBrowserVerifyInvocation({
             projectRoot,
             platform: 'linux',
             fileExists: (candidate) => exists.has(candidate),

package/dist/src/clis/binance/asks.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/clis/binance/asks.js

@@ -0,0 +1,20 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'binance',
+    name: 'asks',
+    description: 'Order book ask prices for a trading pair',
+    domain: 'data-api.binance.vision',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
+        { name: 'limit', type: 'int', default: 10, help: 'Number of price levels (5, 10, 20, 50, 100)' },
+    ],
+    columns: ['rank', 'ask_price', 'ask_qty'],
+    pipeline: [
+        { fetch: { url: 'https://data-api.binance.vision/api/v3/depth?symbol=${{ args.symbol }}&limit=${{ args.limit }}' } },
+        { select: 'asks' },
+        { map: { rank: '${{ index + 1 }}', ask_price: '${{ item.0 }}', ask_qty: '${{ item.1 }}' } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/src/clis/binance/commands.test.d.ts

@@ -0,0 +1,3 @@
+import './top.js';
+import './gainers.js';
+import './pairs.js';

package/dist/src/clis/binance/commands.test.js

@@ -0,0 +1,58 @@
+import { getRegistry } from '@jackwener/opencli/registry';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { executePipeline } from '../../pipeline/index.js';
+// Import all binance adapters to register them
+import './top.js';
+import './gainers.js';
+import './pairs.js';
+function loadPipeline(name) {
+    const cmd = getRegistry().get(`binance/${name}`);
+    if (!cmd?.pipeline)
+        throw new Error(`Command binance/${name} not found or has no pipeline`);
+    return cmd.pipeline;
+}
+function mockJsonOnce(payload) {
+    vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+        ok: true,
+        status: 200,
+        statusText: 'OK',
+        json: vi.fn().mockResolvedValue(payload),
+    }));
+}
+afterEach(() => {
+    vi.unstubAllGlobals();
+    vi.restoreAllMocks();
+});
+describe('binance adapters', () => {
+    it('sorts top pairs by numeric quote volume', async () => {
+        mockJsonOnce([
+            { symbol: 'SMALL', lastPrice: '1', priceChangePercent: '1.2', highPrice: '1', lowPrice: '1', quoteVolume: '9.9' },
+            { symbol: 'LARGE', lastPrice: '2', priceChangePercent: '2.3', highPrice: '2', lowPrice: '2', quoteVolume: '100.0' },
+            { symbol: 'MID', lastPrice: '3', priceChangePercent: '3.4', highPrice: '3', lowPrice: '3', quoteVolume: '11.0' },
+        ]);
+        const result = await executePipeline(null, loadPipeline('top'), { args: { limit: 3 } });
+        expect(result.map((item) => item.symbol)).toEqual(['LARGE', 'MID', 'SMALL']);
+        expect(result.map((item) => item.rank)).toEqual([1, 2, 3]);
+    });
+    it('sorts gainers by numeric percent change', async () => {
+        mockJsonOnce([
+            { symbol: 'TEN', lastPrice: '1', priceChangePercent: '10.0', quoteVolume: '100' },
+            { symbol: 'NINE', lastPrice: '1', priceChangePercent: '9.5', quoteVolume: '100' },
+            { symbol: 'HUNDRED', lastPrice: '1', priceChangePercent: '100.0', quoteVolume: '100' },
+        ]);
+        const result = await executePipeline(null, loadPipeline('gainers'), { args: { limit: 3 } });
+        expect(result.map((item) => item.symbol)).toEqual(['HUNDRED', 'TEN', 'NINE']);
+    });
+    it('keeps only TRADING pairs', async () => {
+        mockJsonOnce({
+            symbols: [
+                { symbol: 'BTCUSDT', baseAsset: 'BTC', quoteAsset: 'USDT', status: 'TRADING' },
+                { symbol: 'OLDPAIR', baseAsset: 'OLD', quoteAsset: 'USDT', status: 'BREAK' },
+            ],
+        });
+        const result = await executePipeline(null, loadPipeline('pairs'), { args: { limit: 10 } });
+        expect(result).toEqual([
+            { symbol: 'BTCUSDT', base: 'BTC', quote: 'USDT', status: 'TRADING' },
+        ]);
+    });
+});

package/dist/src/clis/binance/depth.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/clis/binance/depth.js

@@ -0,0 +1,20 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'binance',
+    name: 'depth',
+    description: 'Order book bid prices for a trading pair',
+    domain: 'data-api.binance.vision',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
+        { name: 'limit', type: 'int', default: 10, help: 'Number of price levels (5, 10, 20, 50, 100)' },
+    ],
+    columns: ['rank', 'bid_price', 'bid_qty'],
+    pipeline: [
+        { fetch: { url: 'https://data-api.binance.vision/api/v3/depth?symbol=${{ args.symbol }}&limit=${{ args.limit }}' } },
+        { select: 'bids' },
+        { map: { rank: '${{ index + 1 }}', bid_price: '${{ item.0 }}', bid_qty: '${{ item.1 }}' } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/src/clis/binance/gainers.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/clis/binance/gainers.js

@@ -0,0 +1,21 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'binance',
+    name: 'gainers',
+    description: 'Top gaining trading pairs by 24h price change',
+    domain: 'data-api.binance.vision',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'limit', type: 'int', default: 10, help: 'Number of trading pairs' },
+    ],
+    columns: ['rank', 'symbol', 'price', 'change_24h', 'volume'],
+    pipeline: [
+        { fetch: { url: 'https://data-api.binance.vision/api/v3/ticker/24hr' } },
+        { filter: 'item.priceChangePercent' },
+        { map: { symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', volume: '${{ item.quoteVolume }}', sort_change: '${{ Number(item.priceChangePercent) }}' } },
+        { sort: { by: 'sort_change', order: 'desc' } },
+        { map: { rank: '${{ index + 1 }}', symbol: '${{ item.symbol }}', price: '${{ item.lastPrice }}', change_24h: '${{ item.priceChangePercent }}', volume: '${{ item.quoteVolume }}' } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/src/clis/binance/klines.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/clis/binance/klines.js

@@ -0,0 +1,20 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'binance',
+    name: 'klines',
+    description: 'Candlestick/kline data for a trading pair',
+    domain: 'data-api.binance.vision',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'symbol', type: 'str', required: true, positional: true, help: 'Trading pair symbol (e.g. BTCUSDT, ETHUSDT)' },
+        { name: 'interval', type: 'str', default: '1d', help: 'Kline interval (1m, 5m, 15m, 1h, 4h, 1d, 1w, 1M)' },
+        { name: 'limit', type: 'int', default: 10, help: 'Number of klines (max 1000)' },
+    ],
+    columns: ['open', 'high', 'low', 'close', 'volume'],
+    pipeline: [
+        { fetch: { url: 'https://data-api.binance.vision/api/v3/klines?symbol=${{ args.symbol }}&interval=${{ args.interval }}&limit=${{ args.limit }}' } },
+        { map: { open: '${{ item.1 }}', high: '${{ item.2 }}', low: '${{ item.3 }}', close: '${{ item.4 }}', volume: '${{ item.5 }}' } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/src/clis/binance/losers.d.ts

@@ -0,0 +1 @@
+export {};