@jackwener/opencli 1.5.0 → 1.5.2

package/dist/cli.js

@@ -69,9 +69,10 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         for (const [site, cmds] of sites) {
             console.log(chalk.bold.cyan(`  ${site}`));
             for (const cmd of cmds) {
-                const tag = strategyLabel(cmd) === 'public'
+                const label = strategyLabel(cmd);
+                const tag = label === 'public'
                     ? chalk.green('[public]')
-                    : chalk.yellow(`[${strategyLabel(cmd)}]`);
+                    : chalk.yellow(`[${label}]`);
                 console.log(`    ${cmd.name} ${tag}${cmd.description ? chalk.dim(` — ${cmd.description}`) : ''}`);
             }
             console.log();
@@ -228,7 +229,7 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
     const pluginCmd = program.command('plugin').description('Manage opencli plugins');
     pluginCmd
         .command('install')
-        .description('Install a plugin from GitHub')
+        .description('Install a plugin from a git repository')
         .argument('<source>', 'Plugin source (e.g. github:user/repo)')
         .action(async (source) => {
         const { installPlugin } = await import('./plugin.js');
@@ -380,6 +381,36 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         console.log(chalk.dim(`  ${plugins.length} plugin(s) installed`));
         console.log();
     });
+    pluginCmd
+        .command('create')
+        .description('Create a new plugin scaffold')
+        .argument('<name>', 'Plugin name (lowercase, hyphens allowed)')
+        .option('-d, --dir <path>', 'Output directory (default: ./<name>)')
+        .option('--description <text>', 'Plugin description')
+        .action(async (name, opts) => {
+        const { createPluginScaffold } = await import('./plugin-scaffold.js');
+        try {
+            const result = createPluginScaffold(name, {
+                dir: opts.dir,
+                description: opts.description,
+            });
+            console.log(chalk.green(`✅ Plugin scaffold created at ${result.dir}`));
+            console.log();
+            console.log(chalk.bold('  Files created:'));
+            for (const f of result.files) {
+                console.log(`    ${chalk.cyan(f)}`);
+            }
+            console.log();
+            console.log(chalk.dim('  Next steps:'));
+            console.log(chalk.dim(`    cd ${result.dir}`));
+            console.log(chalk.dim(`    opencli plugin install file://${result.dir}`));
+            console.log(chalk.dim(`    opencli ${name} hello`));
+        }
+        catch (err) {
+            console.error(chalk.red(`Error: ${getErrorMessage(err)}`));
+            process.exitCode = 1;
+        }
+    });
     // ── External CLIs ─────────────────────────────────────────────────────────
     const externalClis = loadExternalClis();
     program

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

@@ -31,13 +31,14 @@ describe('apple-podcasts search command', () => {
         });
         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: 'OpenCLI',
                 episodes: 12,
                 genre: 'Technology',
-            },
+                url: '',
+            }),
         ]);
     });
 });
@@ -45,6 +46,26 @@ 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(null, { 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');
@@ -61,7 +82,9 @@ describe('apple-podcasts top command', () => {
         });
         vi.stubGlobal('fetch', fetchMock);
         const result = await cmd.func(null, { country: 'US', limit: 2 });
-        expect(fetchMock).toHaveBeenCalledWith('https://rss.marketingtools.apple.com/api/v2/us/podcasts/top/2/podcasts.json');
+        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' },

package/dist/clis/apple-podcasts/top.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '../../registry.js';
 import { CliError } from '../../errors.js';
 // Apple Marketing Tools RSS API — public, no key required
 const CHARTS_URL = 'https://rss.marketingtools.apple.com/api/v2';
+const CHARTS_TIMEOUT_MS = 15_000;
 cli({
     site: 'apple-podcasts',
     name: 'top',
@@ -19,7 +20,9 @@ cli({
         const url = `${CHARTS_URL}/${country}/podcasts/top/${limit}/podcasts.json`;
         let resp;
         try {
-            resp = await fetch(url);
+            resp = await fetch(url, {
+                signal: AbortSignal.timeout(CHARTS_TIMEOUT_MS),
+            });
         }
         catch (error) {
             const reason = error?.cause?.code ?? error?.message ?? 'unknown network error';

package/dist/clis/bluesky/feeds.yaml

@@ -0,0 +1,29 @@
+site: bluesky
+name: feeds
+description: Popular Bluesky feed generators
+domain: public.api.bsky.app
+strategy: public
+browser: false
+
+args:
+  limit:
+    type: int
+    default: 20
+    description: Number of feeds
+
+pipeline:
+  - fetch:
+      url: https://public.api.bsky.app/xrpc/app.bsky.unspecced.getPopularFeedGenerators?limit=${{ args.limit }}
+
+  - select: feeds
+
+  - map:
+      rank: ${{ index + 1 }}
+      name: ${{ item.displayName }}
+      likes: ${{ item.likeCount }}
+      creator: ${{ item.creator.handle }}
+      description: ${{ item.description }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, name, likes, creator, description]

package/dist/clis/bluesky/followers.yaml

@@ -0,0 +1,33 @@
+site: bluesky
+name: followers
+description: List followers of a Bluesky user
+domain: public.api.bsky.app
+strategy: public
+browser: false
+
+args:
+  handle:
+    type: str
+    required: true
+    positional: true
+    description: "Bluesky handle"
+  limit:
+    type: int
+    default: 20
+    description: Number of followers
+
+pipeline:
+  - fetch:
+      url: https://public.api.bsky.app/xrpc/app.bsky.graph.getFollowers?actor=${{ args.handle }}&limit=${{ args.limit }}
+
+  - select: followers
+
+  - map:
+      rank: ${{ index + 1 }}
+      handle: ${{ item.handle }}
+      name: ${{ item.displayName }}
+      description: ${{ item.description }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, handle, name, description]

package/dist/clis/bluesky/following.yaml

@@ -0,0 +1,33 @@
+site: bluesky
+name: following
+description: List accounts a Bluesky user is following
+domain: public.api.bsky.app
+strategy: public
+browser: false
+
+args:
+  handle:
+    type: str
+    required: true
+    positional: true
+    description: "Bluesky handle"
+  limit:
+    type: int
+    default: 20
+    description: Number of accounts
+
+pipeline:
+  - fetch:
+      url: https://public.api.bsky.app/xrpc/app.bsky.graph.getFollows?actor=${{ args.handle }}&limit=${{ args.limit }}
+
+  - select: follows
+
+  - map:
+      rank: ${{ index + 1 }}
+      handle: ${{ item.handle }}
+      name: ${{ item.displayName }}
+      description: ${{ item.description }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, handle, name, description]

package/dist/clis/bluesky/profile.yaml

@@ -0,0 +1,27 @@
+site: bluesky
+name: profile
+description: Get Bluesky user profile info
+domain: public.api.bsky.app
+strategy: public
+browser: false
+
+args:
+  handle:
+    type: str
+    required: true
+    positional: true
+    description: "Bluesky handle (e.g. bsky.app, jay.bsky.team)"
+
+pipeline:
+  - fetch:
+      url: https://public.api.bsky.app/xrpc/app.bsky.actor.getProfile?actor=${{ args.handle }}
+
+  - map:
+      handle: ${{ item.handle }}
+      name: ${{ item.displayName }}
+      followers: ${{ item.followersCount }}
+      following: ${{ item.followsCount }}
+      posts: ${{ item.postsCount }}
+      description: ${{ item.description }}
+
+columns: [handle, name, followers, following, posts, description]

package/dist/clis/bluesky/search.yaml

@@ -0,0 +1,34 @@
+site: bluesky
+name: search
+description: Search Bluesky users
+domain: public.api.bsky.app
+strategy: public
+browser: false
+
+args:
+  query:
+    type: str
+    required: true
+    positional: true
+    description: Search query
+  limit:
+    type: int
+    default: 10
+    description: Number of results
+
+pipeline:
+  - fetch:
+      url: https://public.api.bsky.app/xrpc/app.bsky.actor.searchActors?q=${{ args.query }}&limit=${{ args.limit }}
+
+  - select: actors
+
+  - map:
+      rank: ${{ index + 1 }}
+      handle: ${{ item.handle }}
+      name: ${{ item.displayName }}
+      followers: ${{ item.followersCount }}
+      description: ${{ item.description }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, handle, name, followers, description]

package/dist/clis/bluesky/starter-packs.yaml

@@ -0,0 +1,34 @@
+site: bluesky
+name: starter-packs
+description: Get starter packs created by a Bluesky user
+domain: public.api.bsky.app
+strategy: public
+browser: false
+
+args:
+  handle:
+    type: str
+    required: true
+    positional: true
+    description: "Bluesky handle"
+  limit:
+    type: int
+    default: 10
+    description: Number of starter packs
+
+pipeline:
+  - fetch:
+      url: https://public.api.bsky.app/xrpc/app.bsky.graph.getActorStarterPacks?actor=${{ args.handle }}&limit=${{ args.limit }}
+
+  - select: starterPacks
+
+  - map:
+      rank: ${{ index + 1 }}
+      name: ${{ item.record.name }}
+      description: ${{ item.record.description }}
+      members: ${{ item.listItemCount }}
+      joins: ${{ item.joinedAllTimeCount }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, name, description, members, joins]

package/dist/clis/bluesky/thread.yaml

@@ -0,0 +1,32 @@
+site: bluesky
+name: thread
+description: Get a Bluesky post thread with replies
+domain: public.api.bsky.app
+strategy: public
+browser: false
+
+args:
+  uri:
+    type: str
+    required: true
+    positional: true
+    description: "Post AT URI (at://did:.../app.bsky.feed.post/...) or bsky.app URL"
+  limit:
+    type: int
+    default: 20
+    description: Number of replies
+
+pipeline:
+  - fetch:
+      url: https://public.api.bsky.app/xrpc/app.bsky.feed.getPostThread?uri=${{ args.uri }}&depth=2
+
+  - select: thread
+
+  - map:
+      author: ${{ item.post.author.handle }}
+      text: ${{ item.post.record.text }}
+      likes: ${{ item.post.likeCount }}
+      reposts: ${{ item.post.repostCount }}
+      replies_count: ${{ item.post.replyCount }}
+
+columns: [author, text, likes, reposts, replies_count]

package/dist/clis/bluesky/trending.yaml

@@ -0,0 +1,27 @@
+site: bluesky
+name: trending
+description: Trending topics on Bluesky
+domain: public.api.bsky.app
+strategy: public
+browser: false
+
+args:
+  limit:
+    type: int
+    default: 20
+    description: Number of topics
+
+pipeline:
+  - fetch:
+      url: https://public.api.bsky.app/xrpc/app.bsky.unspecced.getTrendingTopics
+
+  - select: topics
+
+  - map:
+      rank: ${{ index + 1 }}
+      topic: ${{ item.topic }}
+      link: ${{ item.link }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, topic, link]

package/dist/clis/bluesky/user.yaml

@@ -0,0 +1,34 @@
+site: bluesky
+name: user
+description: Get recent posts from a Bluesky user
+domain: public.api.bsky.app
+strategy: public
+browser: false
+
+args:
+  handle:
+    type: str
+    required: true
+    positional: true
+    description: "Bluesky handle (e.g. bsky.app)"
+  limit:
+    type: int
+    default: 20
+    description: Number of posts
+
+pipeline:
+  - fetch:
+      url: https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed?actor=${{ args.handle }}&limit=${{ args.limit }}
+
+  - select: feed
+
+  - map:
+      rank: ${{ index + 1 }}
+      text: ${{ item.post.record.text }}
+      likes: ${{ item.post.likeCount }}
+      reposts: ${{ item.post.repostCount }}
+      replies: ${{ item.post.replyCount }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, text, likes, reposts, replies]

package/dist/clis/twitter/trending.js

@@ -1,7 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
 import { AuthRequiredError, EmptyResultError } from '../../errors.js';
-// ── Twitter GraphQL constants ──────────────────────────────────────────
-const BEARER_TOKEN = 'AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA';
 // ── CLI definition ────────────────────────────────────────────────────
 cli({
     site: 'twitter',
@@ -19,73 +17,43 @@ cli({
         // Navigate to trending page
         await page.goto('https://x.com/explore/tabs/trending');
         await page.wait(3);
-        // Extract CSRF token to verify login
+        // Verify login via CSRF cookie
         const ct0 = await page.evaluate(`(() => {
       return document.cookie.split(';').map(c=>c.trim()).find(c=>c.startsWith('ct0='))?.split('=')[1] || null;
     })()`);
         if (!ct0)
             throw new AuthRequiredError('x.com', 'Not logged into x.com (no ct0 cookie)');
-        // Try legacy guide.json API first (faster than DOM scraping)
-        let trends = [];
-        const apiData = await page.evaluate(`(async () => {
-      const ct0 = document.cookie.split(';').map(c=>c.trim()).find(c=>c.startsWith('ct0='))?.split('=')[1] || '';
-      const r = await fetch('/i/api/2/guide.json?include_page_configuration=true', {
-        credentials: 'include',
-        headers: {
-          'x-twitter-active-user': 'yes',
-          'x-csrf-token': ct0,
-          'authorization': 'Bearer AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA'
+        // Scrape trends from DOM (consistent with what the user sees on the page)
+        // DOM children: [0] rank + category, [1] topic, optional post count,
+        // and a caret menu button identified by [data-testid="caret"].
+        await page.wait(2);
+        const trends = await page.evaluate(`(() => {
+      const items = [];
+      const cells = document.querySelectorAll('[data-testid="trend"]');
+      cells.forEach((cell) => {
+        const text = cell.textContent || '';
+        if (text.includes('Promoted')) return;
+        const container = cell.querySelector(':scope > div');
+        if (!container) return;
+        const divs = container.children;
+        if (divs.length < 2) return;
+        const topic = divs[1].textContent.trim();
+        if (!topic) return;
+        const catText = divs[0].textContent.trim();
+        const category = catText.replace(/^\\d+\\s*/, '').replace(/^\\xB7\\s*/, '').trim();
+        // Find post count: skip rank, topic, and the caret menu button
+        let tweets = 'N/A';
+        for (let j = 2; j < divs.length; j++) {
+          if (divs[j].matches('[data-testid="caret"]') || divs[j].querySelector('[data-testid="caret"]')) continue;
+          const t = divs[j].textContent.trim();
+          if (t && /\\d/.test(t)) { tweets = t; break; }
         }
+        items.push({ rank: items.length + 1, topic, tweets, category });
       });
-      return r.ok ? await r.json() : null;
+      return items;
     })()`);
-        if (apiData) {
-            const instructions = apiData?.timeline?.instructions || [];
-            const entries = instructions.flatMap((inst) => inst?.addEntries?.entries || inst?.entries || []);
-            const apiTrends = entries
-                .filter((e) => e.content?.timelineModule)
-                .flatMap((e) => e.content.timelineModule.items || [])
-                .map((t) => t?.item?.content?.trend)
-                .filter(Boolean);
-            trends = apiTrends.map((t, i) => ({
-                rank: i + 1,
-                topic: t.name,
-                tweets: t.tweetCount ? String(t.tweetCount) : 'N/A',
-                category: t.trendMetadata?.domainContext || '',
-            }));
-        }
-        // Fallback: scrape from the loaded DOM
-        if (trends.length === 0) {
-            await page.wait(2);
-            const domTrends = await page.evaluate(`(() => {
-        const items = [];
-        const cells = document.querySelectorAll('[data-testid="trend"]');
-        cells.forEach((cell) => {
-          const text = cell.textContent || '';
-          if (text.includes('Promoted')) return;
-          const container = cell.querySelector(':scope > div');
-          if (!container) return;
-          const divs = container.children;
-          // Structure: divs[0] = rank + category, divs[1] = topic name, divs[2] = extra
-          const topicEl = divs.length >= 2 ? divs[1] : null;
-          const topic = topicEl ? topicEl.textContent.trim() : '';
-          const catEl = divs.length >= 1 ? divs[0] : null;
-          const catText = catEl ? catEl.textContent.trim() : '';
-          const category = catText.replace(/^\\d+\\s*/, '').replace(/^\\xB7\\s*/, '').trim();
-          const extraEl = divs.length >= 3 ? divs[2] : null;
-          const extra = extraEl ? extraEl.textContent.trim() : '';
-          if (topic) {
-            items.push({ rank: items.length + 1, topic, tweets: extra || 'N/A', category });
-          }
-        });
-        return items;
-      })()`);
-            if (Array.isArray(domTrends) && domTrends.length > 0) {
-                trends = domTrends;
-            }
-        }
-        if (trends.length === 0) {
-            throw new EmptyResultError('twitter trending', 'API may have changed or login may be required.');
+        if (!Array.isArray(trends) || trends.length === 0) {
+            throw new EmptyResultError('twitter trending', 'No trends found. The page structure may have changed.');
         }
         return trends.slice(0, limit);
     },