@sovovs/bycli 1.8.0 → 2.1.0

package/clis/amazon/offer.test.js

@@ -1,29 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { __test__ } from './offer.js';
-describe('amazon offer normalization', () => {
-    it('extracts sold-by and fulfillment facts from product offer text', () => {
-        const result = __test__.normalizeOfferPayload({
-            href: 'https://www.amazon.com/dp/B0FJS72893',
-            price_text: '$15.99',
-            merchant_info: '',
-            sold_by: 'KUATUDIRECT',
-            ships_from_text: 'Ships from Amazon',
-            offer_link: null,
-            review_url: 'https://www.amazon.com/dp/B0FJS72893#customerReviews',
-            qa_url: null,
-        });
-        expect(result.asin).toBe('B0FJS72893');
-        expect(result.sold_by).toBe('KUATUDIRECT');
-        expect(result.ships_from).toBe('Amazon');
-        expect(result.is_amazon_sold).toBe(false);
-        expect(result.is_amazon_fulfilled).toBe(true);
-    });
-    it('parses merchant info fallback text', () => {
-        expect(__test__.extractSoldBy('Sold by Example Seller and Fulfilled by Amazon.')).toBe('Example Seller');
-        expect(__test__.extractShipsFrom('Ships from Amazon')).toBe('Amazon');
-    });
-    it('detects delivery-location blocking in the buy box text', () => {
-        expect(__test__.isDeliveryLocationBlocked('This item cannot be shipped to your selected delivery location. Similar items shipping to Hong Kong')).toBe(true);
-        expect(__test__.isDeliveryLocationBlocked('Ships from Amazon')).toBe(false);
-    });
-});

package/clis/amazon/product.test.js

@@ -1,24 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { __test__ } from './product.js';
-describe('amazon product normalization', () => {
-    it('normalizes product facts from the product page', () => {
-        const result = __test__.normalizeProductPayload({
-            href: 'https://www.amazon.com/dp/B0FJS72893',
-            title: 'Amazon.com: KVTUKIAIT Desktop Shelf Organizer',
-            product_title: 'White Desktop Shelf Organizer for Top of Desk',
-            byline: 'Visit the KVTUKIAIT Store',
-            price_text: '$15.99',
-            rating_text: '3.9 out of 5 stars',
-            review_count_text: '27 ratings',
-            review_url: 'https://www.amazon.com/dp/B0FJS72893#customerReviews',
-            qa_url: null,
-            bullets: ['SPACE-SAVING DESK SHELF ORGANIZER', 'SMALL AND STYLISH AESTHETIC DECOR'],
-            breadcrumbs: ['Office Products', 'Desktop & Off-Surface Shelves'],
-        });
-        expect(result.asin).toBe('B0FJS72893');
-        expect(result.price_value).toBe(15.99);
-        expect(result.rating_value).toBe(3.9);
-        expect(result.review_count).toBe(27);
-        expect(result.breadcrumbs).toEqual(['Office Products', 'Desktop & Off-Surface Shelves']);
-    });
-});

package/clis/amazon/rankings.test.js

@@ -1,41 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { __test__ } from './rankings.js';
-describe('amazon rankings helpers', () => {
-    it('normalizes ranking candidates with unified schema', () => {
-        const result = __test__.normalizeRankingCandidate({
-            rank_text: '#3',
-            asin: 'B0DR31GC3D',
-            title: 'Desk Shelves Desktop Organizer',
-            href: 'https://www.amazon.com/dp/B0DR31GC3D/ref=zg_bs',
-            price_text: '$25.92',
-            rating_text: '4.3 out of 5 stars',
-            review_count_text: '435',
-        }, {
-            listType: 'new_releases',
-            rankFallback: 3,
-            listTitle: 'Amazon New Releases',
-            sourceUrl: 'https://www.amazon.com/gp/new-releases',
-            categoryTitle: 'Home & Kitchen',
-            categoryUrl: 'https://www.amazon.com/gp/new-releases/home-garden',
-            categoryPath: ['Home & Kitchen'],
-            visibleCategoryLinks: [{ title: 'Storage', url: 'https://www.amazon.com/gp/new-releases/storage', node_id: null }],
-        });
-        expect(result.list_type).toBe('new_releases');
-        expect(result.rank).toBe(3);
-        expect(result.asin).toBe('B0DR31GC3D');
-        expect(result.product_url).toBe('https://www.amazon.com/dp/B0DR31GC3D');
-        expect(result.category_title).toBe('Home & Kitchen');
-        expect(result.visible_category_links).toEqual([
-            { title: 'Storage', url: 'https://www.amazon.com/gp/new-releases/storage', node_id: null },
-        ]);
-    });
-    it('deduplicates category links and parses rank fallback', () => {
-        const links = __test__.normalizeVisibleCategoryLinks([
-            { title: 'Kitchen', url: '/gp/new-releases/home-garden' },
-            { title: 'Kitchen', url: 'https://www.amazon.com/gp/new-releases/home-garden' },
-            { title: 'Storage', url: '/gp/new-releases/storage', node_id: '1064954' },
-        ]);
-        expect(links.length).toBe(2);
-        expect(__test__.parseRank('N/A', 8)).toBe(8);
-    });
-});

package/clis/amazon/search.test.js

@@ -1,22 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { __test__ } from './search.js';
-describe('amazon search normalization', () => {
-    it('normalizes search cards into research-friendly fields', () => {
-        const result = __test__.normalizeSearchCandidate({
-            asin: 'B0FJS72893',
-            title: 'White Desktop Shelf Organizer for Top of Desk',
-            href: 'https://www.amazon.com/KVTUKIAIT-White-Desktop-Shelf-Organizer/dp/B0FJS72893/ref=sr_1_1',
-            price_text: '$15.99',
-            rating_text: '3.9 out of 5 stars, rating details',
-            review_count_text: '(27)',
-            sponsored: false,
-            badge_texts: ['Limited time deal'],
-        }, 1, 'https://www.amazon.com/s?k=desk+shelf+organizer');
-        expect(result.asin).toBe('B0FJS72893');
-        expect(result.product_url).toBe('https://www.amazon.com/dp/B0FJS72893');
-        expect(result.price_value).toBe(15.99);
-        expect(result.rating_value).toBe(3.9);
-        expect(result.review_count).toBe(27);
-        expect(result.badges).toEqual(['Limited time deal']);
-    });
-});

package/clis/amazon/shared.test.js

@@ -1,44 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { __test__ } from './shared.js';
-describe('amazon shared helpers', () => {
-    it('builds canonical product and discussion URLs from ASINs and product URLs', () => {
-        expect(__test__.buildProductUrl('B0FJS72893')).toBe('https://www.amazon.com/dp/B0FJS72893');
-        expect(__test__.buildProductUrl('https://www.amazon.com/dp/B0FJS72893/ref=something')).toBe('https://www.amazon.com/dp/B0FJS72893');
-        expect(__test__.buildDiscussionUrl('https://www.amazon.com/dp/B0FJS72893')).toBe('https://www.amazon.com/product-reviews/B0FJS72893');
-    });
-    it('parses price, rating, and review-count text', () => {
-        expect(__test__.parsePriceText('1 offer from $34.11')).toEqual({
-            price_text: '$34.11',
-            price_value: 34.11,
-            currency: 'USD',
-        });
-        expect(__test__.parseRatingValue('3.9 out of 5 stars, rating details')).toBe(3.9);
-        expect(__test__.parseReviewCount('27 global ratings')).toBe(27);
-        expect(__test__.parseReviewCount('(2.9K)')).toBe(2900);
-        expect(__test__.parseReviewCount('1.2M global ratings')).toBe(1200000);
-        expect(__test__.extractReviewCountFromCardText('Desk Shelf\n4.3 out of 5 stars\n435\n$25.92')).toBe('435');
-    });
-    it('recognizes robot checks and Amazon-owned merchants', () => {
-        expect(__test__.isAmazonEntity('Ships from Amazon')).toBe(true);
-        expect(__test__.trimRatingPrefix('5.0 out of 5 stars Great value and quality')).toBe('Great value and quality');
-        expect(__test__.isRobotState({
-            title: 'Robot Check',
-            body_text: 'Sorry, we just need to make sure you\'re not a robot',
-        })).toBe(true);
-    });
-    it('requires a real best-sellers URL or path', () => {
-        expect(__test__.resolveBestsellersUrl('/Best-Sellers/zgbs')).toBe('https://www.amazon.com/Best-Sellers/zgbs');
-        expect(() => __test__.resolveBestsellersUrl('desk shelf organizer')).toThrow('amazon bestsellers expects a best sellers URL or /zgbs path');
-    });
-    it('resolves and validates all ranking list URLs', () => {
-        expect(__test__.resolveRankingUrl('new_releases')).toBe('https://www.amazon.com/gp/new-releases');
-        expect(__test__.resolveRankingUrl('movers_shakers')).toBe('https://www.amazon.com/gp/movers-and-shakers');
-        expect(__test__.resolveRankingUrl('new_releases', '/gp/new-releases/kitchen')).toBe('https://www.amazon.com/gp/new-releases/kitchen');
-        expect(__test__.resolveRankingUrl('bestsellers', 'https://www.amazon.com/Best-Sellers/zgbs/ref=zg_bsnr_tab_bs')).toBe('https://www.amazon.com/Best-Sellers/zgbs');
-        expect(() => __test__.resolveRankingUrl('movers_shakers', 'https://example.com/gp/movers-and-shakers')).toThrow('Invalid Amazon URL');
-    });
-    it('extracts category node id from URL best effort', () => {
-        expect(__test__.extractCategoryNodeId('https://www.amazon.com/Best-Sellers-Home-Kitchen/zgbs/home-garden/3744371')).toBe('3744371');
-        expect(__test__.extractCategoryNodeId('https://www.amazon.com/s?k=desk+organizer&rh=n%3A1064954')).toBe('1064954');
-    });
-});

package/clis/apple-podcasts/commands.test.js

@@ -1,119 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@sovovs/bycli/registry';
-import './search.js';
-import './top.js';
-describe('apple-podcasts search command', () => {
-    beforeEach(() => {
-        vi.restoreAllMocks();
-    });
-    it('uses the positional query argument for the iTunes search request', async () => {
-        const cmd = getRegistry().get('apple-podcasts/search');
-        expect(cmd?.func).toBeTypeOf('function');
-        const fetchMock = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({
-                results: [
-                    {
-                        collectionId: 42,
-                        collectionName: 'Machine Learning Guide',
-                        artistName: 'byCLI',
-                        trackCount: 12,
-                        primaryGenreName: 'Technology',
-                    },
-                ],
-            }),
-        });
-        vi.stubGlobal('fetch', fetchMock);
-        const result = await cmd.func({
-            query: 'machine learning',
-            keyword: 'sports',
-            limit: 5,
-        });
-        expect(fetchMock).toHaveBeenCalledWith('https://itunes.apple.com/search?term=machine%20learning&media=podcast&limit=5');
-        expect(result).toEqual([
-            expect.objectContaining({
-                id: 42,
-                title: 'Machine Learning Guide',
-                author: 'byCLI',
-                episodes: 12,
-                genre: 'Technology',
-                url: '',
-            }),
-        ]);
-    });
-    it('emits empty-string for missing trackCount and primaryGenreName instead of a sentinel', async () => {
-        const cmd = getRegistry().get('apple-podcasts/search');
-        const fetchMock = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({
-                results: [
-                    {
-                        collectionId: 99,
-                        collectionName: 'No-Meta Show',
-                        artistName: 'Anon Host',
-                        collectionViewUrl: 'https://example.com/p/99',
-                    },
-                ],
-            }),
-        });
-        vi.stubGlobal('fetch', fetchMock);
-        const result = await cmd.func({ query: 'no-meta', limit: 1 });
-        expect(result[0].episodes).toBe('');
-        expect(result[0].genre).toBe('');
-    });
-});
-describe('apple-podcasts top command', () => {
-    beforeEach(() => {
-        vi.restoreAllMocks();
-    });
-    it('adds a timeout signal to chart fetches', async () => {
-        const cmd = getRegistry().get('apple-podcasts/top');
-        expect(cmd?.func).toBeTypeOf('function');
-        const fetchMock = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({
-                feed: {
-                    results: [
-                        { id: '100', name: 'Top Show', artistName: 'Host A' },
-                    ],
-                },
-            }),
-        });
-        vi.stubGlobal('fetch', fetchMock);
-        await cmd.func({ country: 'US', limit: 1 });
-        const [, options] = fetchMock.mock.calls[0] ?? [];
-        expect(options).toBeDefined();
-        expect(options.signal).toBeDefined();
-        expect(options.signal).toHaveProperty('aborted', false);
-    });
-    it('uses the canonical Apple charts host and maps ranked results', async () => {
-        const cmd = getRegistry().get('apple-podcasts/top');
-        expect(cmd?.func).toBeTypeOf('function');
-        const fetchMock = vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({
-                feed: {
-                    results: [
-                        { id: '100', name: 'Top Show', artistName: 'Host A' },
-                        { id: '101', name: 'Second Show', artistName: 'Host B' },
-                    ],
-                },
-            }),
-        });
-        vi.stubGlobal('fetch', fetchMock);
-        const result = await cmd.func({ country: 'US', limit: 2 });
-        expect(fetchMock).toHaveBeenCalledWith('https://rss.marketingtools.apple.com/api/v2/us/podcasts/top/2/podcasts.json', expect.objectContaining({
-            signal: expect.any(Object),
-        }));
-        expect(result).toEqual([
-            { rank: 1, title: 'Top Show', author: 'Host A', id: '100' },
-            { rank: 2, title: 'Second Show', author: 'Host B', id: '101' },
-        ]);
-    });
-    it('normalizes network failures into CliError output', async () => {
-        const cmd = getRegistry().get('apple-podcasts/top');
-        expect(cmd?.func).toBeTypeOf('function');
-        vi.stubGlobal('fetch', vi.fn().mockRejectedValue(new Error('socket hang up')));
-        await expect(cmd.func({ country: 'us', limit: 3 })).rejects.toThrow('Unable to reach Apple Podcasts charts for US');
-    });
-});

package/clis/apple-podcasts/utils.test.js

@@ -1,57 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { formatDuration, formatDate, itunesFetch } from './utils.js';
-describe('formatDuration', () => {
-    it('formats typical duration in ms', () => {
-        expect(formatDuration(3661000)).toBe('61:01');
-    });
-    it('pads single-digit seconds', () => {
-        expect(formatDuration(65000)).toBe('1:05');
-    });
-    it('formats exact minutes', () => {
-        expect(formatDuration(3600000)).toBe('60:00');
-    });
-    it('rounds fractional milliseconds', () => {
-        expect(formatDuration(3600500)).toBe('60:01');
-    });
-    it('returns dash for zero', () => {
-        expect(formatDuration(0)).toBe('-');
-    });
-    it('returns dash for NaN', () => {
-        expect(formatDuration(NaN)).toBe('-');
-    });
-});
-describe('formatDate', () => {
-    it('extracts YYYY-MM-DD from ISO string', () => {
-        expect(formatDate('2026-03-19T12:00:00.000Z')).toBe('2026-03-19');
-    });
-    it('handles date-only string', () => {
-        expect(formatDate('2025-01-01')).toBe('2025-01-01');
-    });
-    it('returns dash for empty string', () => {
-        expect(formatDate('')).toBe('-');
-    });
-    it('returns dash for undefined', () => {
-        expect(formatDate(undefined)).toBe('-');
-    });
-});
-describe('itunesFetch', () => {
-    beforeEach(() => {
-        vi.restoreAllMocks();
-    });
-    it('returns parsed JSON on success', async () => {
-        const mockData = { resultCount: 1, results: [{ collectionId: 123 }] };
-        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve(mockData),
-        }));
-        const result = await itunesFetch('/search?term=test&media=podcast&limit=1');
-        expect(result).toEqual(mockData);
-    });
-    it('throws CliError on HTTP error', async () => {
-        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
-            ok: false,
-            status: 403,
-        }));
-        await expect(itunesFetch('/search?term=test')).rejects.toThrow('iTunes API HTTP 403');
-    });
-});

package/clis/arxiv/arxiv.test.js

@@ -1,112 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { getRegistry } from '@sovovs/bycli/registry';
-import { normalizeArxivCategory, normalizeArxivLimit, parseEntries } from './utils.js';
-import './paper.js';
-import './search.js';
-import './recent.js';
-
-const SAMPLE_ENTRY_XML = `<?xml version='1.0' encoding='UTF-8'?>
-<feed xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
-      xmlns:arxiv="http://arxiv.org/schemas/atom"
-      xmlns="http://www.w3.org/2005/Atom">
-  <entry>
-    <id>http://arxiv.org/abs/1706.03762v7</id>
-    <title>Attention Is All You Need &amp; Friends</title>
-    <updated>2023-08-02T00:41:18Z</updated>
-    <link href="https://arxiv.org/abs/1706.03762v7" rel="alternate" type="text/html"/>
-    <link href="https://arxiv.org/pdf/1706.03762v7" rel="related" type="application/pdf" title="pdf"/>
-    <summary>The dominant sequence transduction models are based on complex recurrent or convolutional neural networks. We propose a new simple network architecture, the Transformer, based solely on attention.</summary>
-    <category term="cs.CL" scheme="http://arxiv.org/schemas/atom"/>
-    <category term="cs.LG" scheme="http://arxiv.org/schemas/atom"/>
-    <published>2017-06-12T17:57:34Z</published>
-    <arxiv:comment>15 pages, 5 figures</arxiv:comment>
-    <arxiv:primary_category term="cs.CL"/>
-    <author><name>Ashish Vaswani</name></author>
-    <author><name>Noam Shazeer</name></author>
-    <author><name>Niki Parmar</name></author>
-    <author><name>Jakob Uszkoreit</name></author>
-    <author><name>Llion Jones</name></author>
-    <author><name>Aidan N. Gomez</name></author>
-    <author><name>Lukasz Kaiser</name></author>
-    <author><name>Illia Polosukhin</name></author>
-  </entry>
-</feed>`;
-
-describe('arxiv adapter', () => {
-  it('registers paper, search and recent commands with the expected columns', () => {
-    const paper = getRegistry().get('arxiv/paper');
-    const search = getRegistry().get('arxiv/search');
-    const recent = getRegistry().get('arxiv/recent');
-
-    expect(paper).toBeDefined();
-    expect(search).toBeDefined();
-    expect(recent).toBeDefined();
-
-    expect(paper.columns).toEqual([
-      'id', 'title', 'authors', 'published', 'updated',
-      'primary_category', 'categories', 'abstract', 'comment', 'pdf', 'url',
-    ]);
-    expect(search.columns).toEqual([
-      'id', 'title', 'authors', 'published', 'primary_category', 'url',
-    ]);
-    expect(recent.columns).toEqual([
-      'id', 'title', 'authors', 'published', 'primary_category', 'url',
-    ]);
-  });
-
-  it('parseEntries returns full abstract, all authors, pdf, primary category and comment', () => {
-    const [entry] = parseEntries(SAMPLE_ENTRY_XML);
-
-    expect(entry.id).toBe('1706.03762');
-    expect(entry.title).toBe('Attention Is All You Need & Friends');
-    // All 8 authors must be present — earlier impl truncated to 3.
-    expect(entry.authors.split(', ')).toHaveLength(8);
-    expect(entry.authors).toContain('Ashish Vaswani');
-    expect(entry.authors).toContain('Illia Polosukhin');
-    // Full abstract — earlier impl truncated at 200 chars.
-    expect(entry.abstract.length).toBeGreaterThan(140);
-    expect(entry.abstract.endsWith('...')).toBe(false);
-    expect(entry.abstract).toContain('attention');
-    expect(entry.published).toBe('2017-06-12');
-    expect(entry.updated).toBe('2023-08-02');
-    expect(entry.primary_category).toBe('cs.CL');
-    expect(entry.categories).toBe('cs.CL, cs.LG');
-    expect(entry.comment).toBe('15 pages, 5 figures');
-    expect(entry.pdf).toBe('https://arxiv.org/pdf/1706.03762v7');
-    expect(entry.url).toBe('https://arxiv.org/abs/1706.03762');
-  });
-
-  it('parseEntries returns an empty list for feeds with no entries', () => {
-    expect(parseEntries('<feed></feed>')).toEqual([]);
-  });
-
-  it('recent rejects malformed category strings', async () => {
-    const recent = getRegistry().get('arxiv/recent');
-    await expect(recent.func({ category: 'not a category', limit: 5 })).rejects.toMatchObject({
-      code: 'ARGUMENT',
-    });
-    await expect(recent.func({ category: '', limit: 5 })).rejects.toMatchObject({
-      code: 'ARGUMENT',
-    });
-  });
-
-  it('category validation accepts real arXiv archive and subcategory forms', () => {
-    expect(normalizeArxivCategory('cs.CL')).toBe('cs.CL');
-    expect(normalizeArxivCategory('math')).toBe('math');
-    expect(normalizeArxivCategory('physics.comp-ph')).toBe('physics.comp-ph');
-    expect(normalizeArxivCategory('physics.data-an')).toBe('physics.data-an');
-    expect(normalizeArxivCategory('cond-mat.soft')).toBe('cond-mat.soft');
-    expect(normalizeArxivCategory('q-bio.NC')).toBe('q-bio.NC');
-    expect(() => normalizeArxivCategory('not a category')).toThrow('Invalid arXiv category');
-    expect(() => normalizeArxivCategory('cs/CL')).toThrow('Invalid arXiv category');
-    expect(() => normalizeArxivCategory('')).toThrow('Invalid arXiv category');
-  });
-
-  it('limit validation rejects non-positive, non-integer and over-cap values', () => {
-    expect(normalizeArxivLimit(10, 5, 25)).toBe(10);
-    expect(normalizeArxivLimit(undefined, 5, 25)).toBe(5);
-    expect(() => normalizeArxivLimit(0, 5, 25)).toThrow('positive integer');
-    expect(() => normalizeArxivLimit(1.5, 5, 25)).toThrow('positive integer');
-    expect(() => normalizeArxivLimit(26, 5, 25)).toThrow('<= 25');
-  });
-});

package/clis/baidu-scholar/search.test.js

@@ -1,23 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@sovovs/bycli/registry';
-import './search.js';
-
-describe('baidu-scholar search command', () => {
-    const command = getRegistry().get('baidu-scholar/search');
-
-    it('registers as a public browser command', () => {
-        expect(command).toBeDefined();
-        expect(command.site).toBe('baidu-scholar');
-        expect(command.strategy).toBe('public');
-        expect(command.browser).toBe(true);
-    });
-
-    it('rejects empty queries before browser navigation', async () => {
-        const page = { goto: vi.fn() };
-        await expect(command.func(page, { query: '   ' })).rejects.toMatchObject({
-            name: 'ArgumentError',
-            code: 'ARGUMENT',
-        });
-        expect(page.goto).not.toHaveBeenCalled();
-    });
-});

package/clis/barchart/greeks.test.js

@@ -1,138 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@sovovs/bycli/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@sovovs/bycli/errors';
-import './greeks.js';
-
-const { normalizeExpiration, normalizeSymbol, parseLimit, unwrapBrowserResult } = await import('./greeks.js').then((m) => m.__test__);
-
-function makePage(evaluateResult) {
-    return {
-        goto: vi.fn().mockResolvedValue(undefined),
-        wait: vi.fn().mockResolvedValue(undefined),
-        evaluate: vi.fn().mockResolvedValue(evaluateResult),
-    };
-}
-
-describe('barchart greeks command', () => {
-    const command = getRegistry().get('barchart/greeks');
-
-    it('registers with the expected shape', () => {
-        expect(command).toBeDefined();
-        expect(command.access).toBe('read');
-        expect(command.browser).toBe(true);
-        expect(command.columns).toEqual([
-            'type', 'strike', 'last', 'iv', 'delta', 'gamma', 'theta', 'vega', 'rho',
-            'volume', 'openInterest', 'expiration',
-        ]);
-    });
-
-    it('maps returned option rows without changing the declared output shape', async () => {
-        const page = makePage({
-            session: 'site:barchart',
-            data: {
-            ok: true,
-            rows: [
-                {
-                    type: 'Call',
-                    strike: 190,
-                    last: 3.456,
-                    iv: 21.234,
-                    delta: 0.56789,
-                    gamma: 0.01234,
-                    theta: -0.12345,
-                    vega: 0.23456,
-                    rho: 0.03456,
-                    volume: 123,
-                    openInterest: 456,
-                    expiration: '2026-06-19',
-                },
-            ],
-            },
-        });
-
-        const rows = await command.func(page, { symbol: 'aapl', limit: 1 });
-
-        expect(page.goto).toHaveBeenCalledWith('https://www.barchart.com/stocks/quotes/AAPL/options');
-        expect(page.wait).toHaveBeenCalledWith(4);
-        expect(rows).toEqual([
-            {
-                type: 'Call',
-                strike: 190,
-                last: 3.46,
-                iv: '21.23%',
-                delta: 0.5679,
-                gamma: 0.0123,
-                theta: -0.1235,
-                vega: 0.2346,
-                rho: 0.0346,
-                volume: 123,
-                openInterest: 456,
-                expiration: '2026-06-19',
-            },
-        ]);
-    });
-
-    it('validates args before browser navigation and unwraps bridge envelopes', async () => {
-        expect(normalizeSymbol(' aapl ')).toBe('AAPL');
-        expect(normalizeExpiration('2026-06-19')).toBe('2026-06-19');
-        expect(parseLimit(undefined)).toBe(10);
-        expect(parseLimit(100)).toBe(100);
-        expect(unwrapBrowserResult({ session: 'site:barchart', data: { ok: true } })).toEqual({ ok: true });
-
-        await expect(command.func(makePage({ ok: true, rows: [] }), { symbol: '', limit: 1 }))
-            .rejects.toBeInstanceOf(ArgumentError);
-        await expect(command.func(makePage({ ok: true, rows: [] }), { symbol: 'AAPL', expiration: '2026-02-30', limit: 1 }))
-            .rejects.toBeInstanceOf(ArgumentError);
-        await expect(command.func(makePage({ ok: true, rows: [] }), { symbol: 'AAPL', limit: 101 }))
-            .rejects.toBeInstanceOf(ArgumentError);
-    });
-
-    it('embeds expiration and limit in the browser-side request script', async () => {
-        const page = makePage({
-            ok: true,
-            rows: [{
-                type: 'Put',
-                strike: 185,
-                last: null,
-                iv: null,
-                delta: null,
-                gamma: null,
-                theta: null,
-                vega: null,
-                rho: null,
-                volume: 0,
-                openInterest: 0,
-                expiration: '2026-07-17',
-            }],
-        });
-
-        await command.func(page, { symbol: 'MSFT', expiration: '2026-07-17', limit: 7 });
-        const script = page.evaluate.mock.calls[0][0];
-
-        expect(script).toContain('const expDate = "2026-07-17"');
-        expect(script).toContain('const limit = 7');
-        expect(script).toContain("url += '&expirationDate=' + encodeURIComponent(expDate)");
-    });
-
-    it('throws CommandExecutionError for HTTP, malformed, exception, and missing payload states', async () => {
-        await expect(command.func(makePage({ ok: false, reason: 'http', status: 403, statusText: 'Forbidden' }), { symbol: 'AAPL' }))
-            .rejects.toBeInstanceOf(CommandExecutionError);
-        await expect(command.func(makePage({ ok: false, reason: 'malformed' }), { symbol: 'AAPL' }))
-            .rejects.toBeInstanceOf(CommandExecutionError);
-        await expect(command.func(makePage({ ok: false, reason: 'exception', message: 'network down' }), { symbol: 'AAPL' }))
-            .rejects.toBeInstanceOf(CommandExecutionError);
-        await expect(command.func(makePage({ ok: false, reason: 'malformed', message: 'options rows did not include call or put identities' }), { symbol: 'AAPL' }))
-            .rejects.toThrow('call or put identities');
-        await expect(command.func(makePage(null), { symbol: 'AAPL' }))
-            .rejects.toBeInstanceOf(CommandExecutionError);
-        await expect(command.func(makePage({ ok: true, rows: 'bad' }), { symbol: 'AAPL' }))
-            .rejects.toBeInstanceOf(CommandExecutionError);
-        await expect(command.func(makePage({ ok: true, rows: [{ type: 'Call', strike: null, expiration: '' }] }), { symbol: 'AAPL' }))
-            .rejects.toThrow('malformed option row identity');
-    });
-
-    it('throws EmptyResultError when Barchart returns no greeks rows', async () => {
-        await expect(command.func(makePage({ ok: true, rows: [] }), { symbol: 'AAPL' }))
-            .rejects.toBeInstanceOf(EmptyResultError);
-    });
-});