@zenalexa/unicli 0.218.0 → 0.219.0

package/skills/unicli-smart-search/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: unicli-smart-search
+description: >
+  Route search queries to the best platform via unicli. Use when searching across
+  websites, social media, tech forums, news, finance, shopping, or academic sources.
+version: 1.0.0
+triggers:
+  - "search"
+  - "find information"
+  - "trending"
+  - "hot topics"
+  - "unicli search"
+allowed-tools: [Bash]
+protocol: 2.0
+---
+
+## When to Use
+
+Searching for information, checking trending topics, or gathering data across platforms.
+Commands return a v2 AgentEnvelope; pass `-f json` when you need JSON for parsing.
+
+## Pre-Check
+
+```bash
+unicli <site> --help                  # Verify subcommands exist
+unicli <site> <command> --help        # Check args and output columns
+```
+
+## Search Routing
+
+| Category     | Command                                                                                                                                                                                   |
+| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Web**      | `unicli google search <q>`, `unicli baidu search <q>`                                                                                                                                     |
+| **Tech**     | `unicli hackernews top`, `unicli hackernews search <q>`, `unicli stackoverflow hot`, `unicli lobsters hot`, `unicli v2ex hot`, `unicli linux-do hot`                                      |
+| **Social**   | `unicli twitter search <q>`, `unicli twitter trending`, `unicli reddit search <q>`, `unicli reddit hot`, `unicli weibo hot`, `unicli zhihu hot`, `unicli tieba hot`, `unicli threads hot` |
+| **Finance**  | `unicli xueqiu hot`, `unicli xueqiu hot-stock`, `unicli binance hot`, `unicli eastmoney hot`, `unicli bloomberg markets`, `unicli yahoo-finance search <q>`                               |
+| **Academic** | `unicli arxiv search <q>`, `unicli arxiv paper <id>`                                                                                                                                      |
+| **Shopping** | `unicli amazon search <q>`, `unicli jd search <q>`, `unicli taobao search <q>`, `unicli smzdm hot`, `unicli xianyu search <q>`                                                            |
+| **Video**    | `unicli bilibili hot`, `unicli bilibili search <q>`, `unicli youtube search <q>`, `unicli tiktok search <q>`                                                                              |
+| **News**     | `unicli toutiao hot`, `unicli 36kr hot`, `unicli bbc hot`, `unicli cnn top`, `unicli nytimes top`, `unicli reuters top`                                                                   |
+| **Dev**      | `unicli github-trending`, `unicli producthunt hot`, `unicli docker-hub search <q>`                                                                                                        |
+| **Reading**  | `unicli douban search <q>`, `unicli douban top250`, `unicli weread ranking`, `unicli wikipedia search <q>`                                                                                |
+| **Jobs**     | `unicli boss search <q>`, `unicli linkedin search <q>`, `unicli maimai search <q>`                                                                                                        |
+
+## Multi-Source Pattern
+
+For comprehensive research, query 2-3 complementary sources:
+
+```bash
+# Tech topic
+unicli hackernews search "LLM agents" --limit 10
+unicli reddit search "LLM agents" --limit 10
+unicli arxiv search "LLM agents" --limit 5
+
+# Chinese trending
+unicli weibo hot --limit 20
+unicli zhihu hot --limit 20
+
+# Market research
+unicli producthunt hot --limit 10
+unicli hackernews search "startup" --limit 10
+```
+
+## Output Handling
+
+```bash
+unicli hackernews top --limit 5 | jq '.[].title'
+unicli xueqiu hot | jq '.[] | {name, change}'
+```
+
+## Fallback
+
+- Exit 77 -> `unicli auth setup <site>` then retry
+- Exit 69 -> `unicli browser start` then retry
+- Exit 66 -> try different query terms
+- Site down -> switch to alternative from routing table
+
+## Budget
+
+Per question: 1-2 primary sources + 1 supplementary. Do not query same site twice.

package/skills/unicli-usage/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: unicli-usage
+description: >
+  Command reference and usage guide for unicli — the universal CLI for AI agents.
+  Use when you need to discover, run, or pipe unicli commands.
+---
+
+# unicli Usage Guide
+
+## Quick Reference
+
+```bash
+unicli list                           # List all available commands
+unicli list --type web-api            # Filter by adapter type
+unicli list --site bilibili           # Filter by site name
+
+unicli <site> <command> [options]     # Run any command
+unicli hackernews top --limit 5       # Example: HN top stories
+unicli hackernews search "AI agents"  # Example: search HN
+
+unicli doctor                         # System health check
+```
+
+## Output Formats
+
+All commands support `--format` / `-f`:
+
+| Format    | Use Case                            |
+| --------- | ----------------------------------- |
+| `md`      | Default v2 AgentEnvelope for agents |
+| `json`    | Machine parsing / jq                |
+| `yaml`    | Config-friendly envelope            |
+| `csv`     | Spreadsheet import                  |
+| `compact` | Pipe-friendly row stream            |
+
+```bash
+unicli hackernews top -f json | jq '.data[0].title'
+unicli hackernews top -f csv > stories.csv
+```
+
+## Adapter Types
+
+| Type      | Description              | Example              |
+| --------- | ------------------------ | -------------------- |
+| `web-api` | REST API calls           | hackernews, bilibili |
+| `desktop` | Local desktop software   | blender, gimp        |
+| `browser` | Full browser automation  | xiaohongshu          |
+| `bridge`  | Existing CLI passthrough | gh, docker           |
+| `service` | HTTP services            | ollama, comfyui      |
+
+## Exit Codes
+
+Use exit codes for scripting:
+
+```bash
+unicli hackernews top || echo "exit $?"
+[ $? -eq 77 ] && echo "Login required"
+```
+
+| Code | Meaning             |
+| ---- | ------------------- |
+| 0    | Success             |
+| 66   | Empty result        |
+| 69   | Service unavailable |
+| 77   | Auth required       |

package/src/adapters/36kr/hot.yaml

@@ -4,6 +4,7 @@ description: 36Kr hot/trending articles
 domain: 36kr.com
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   limit:

package/src/adapters/36kr/search.yaml

@@ -4,6 +4,7 @@ description: Search 36Kr articles
 domain: 36kr.com
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   query:

package/src/adapters/_archived/README.md

@@ -0,0 +1,12 @@
+# Archived Adapters
+
+These adapters are preserved for provenance but are outside active discovery.
+The loader, manifest builder, conformance report, and quarantine repair list
+skip underscore-prefixed adapter directories.
+
+| Site        | Commands    | Archived on | Replacement                                                             |
+| ----------- | ----------- | ----------- | ----------------------------------------------------------------------- |
+| apple-music | rate-album  | 2026-05-06  | `unicli macos music-now`; `unicli macos music-control <action>`         |
+| az          | account     | 2026-05-06  | `az account list --output json` through external CLI passthrough        |
+| ctrip       | hot, search | 2026-05-06  | `unicli web read` or browser/CUA against an authenticated Ctrip session |
+| gcloud      | projects    | 2026-05-06  | `gcloud projects list --format=json` through external CLI passthrough   |

package/src/adapters/{apple-music → _archived/apple-music}/rate-album.yaml

@@ -1,14 +1,8 @@
-# AX-first demo with CUA fallback — rate the current Apple Music album.
-#
-# Strategy:
-#   1. desktop-ax   → launch and focus Music
-#   2. desktop-ax   → open the "Album" AppleScript menu (cheap & exact)
-#   3. cua          → take a screenshot so the VLM can verify the stars
-#                     UI is visible before we click it
-#   4. cua          → click the star coordinate (caller-provided)
-#
-# Real UI coordinates vary by screen size — callers either pass x/y or
-# let the pipeline use the VLM snapshot to locate the stars themselves.
+# @owner   src/adapters/_archived/apple-music/rate-album.yaml
+# @does    Preserve the archived Apple Music CUA rating demo outside active discovery.
+# @needs   macOS Music app, desktop AX transport, CUA backend, caller-provided star coordinates
+# @feeds   src/adapters/_archived/archive.json provenance, historical adapter review
+# @breaks  Moving back under an active site would reintroduce an archive-only discovered site.
 site: apple-music
 name: rate-album
 description: Rate the currently-playing Apple Music album via AX menu + CUA click
@@ -56,7 +50,6 @@ pipeline:
 
 columns: [backend, stars]
 
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities:
   [
     "cua.ask",

package/src/adapters/_archived/archive.json

@@ -0,0 +1,44 @@
+{
+  "archived_on": "2026-05-06",
+  "reason": "Feature 3.2 dead-site archive: each listed site had zero active commands and only quarantined adapters.",
+  "sites": [
+    {
+      "site": "apple-music",
+      "commands": ["rate-album"],
+      "original_paths": ["src/adapters/apple-music/rate-album.yaml"],
+      "archived_paths": ["src/adapters/_archived/apple-music/rate-album.yaml"],
+      "reason": "Host-app CUA demo requires the macOS Music app and a CUA backend; active Apple Music controls remain under the macos adapter.",
+      "replacement": "unicli macos music-now; unicli macos music-control <action>"
+    },
+    {
+      "site": "az",
+      "commands": ["account"],
+      "original_paths": ["src/adapters/az/account.yaml"],
+      "archived_paths": ["src/adapters/_archived/az/account.yaml"],
+      "reason": "Dedicated Azure account adapter cannot run in CI without interactive az login; az remains available through external CLI passthrough when installed.",
+      "replacement": "az account list --output json"
+    },
+    {
+      "site": "ctrip",
+      "commands": ["hot", "search"],
+      "original_paths": [
+        "src/adapters/ctrip/hot.yaml",
+        "src/adapters/ctrip/search.yaml"
+      ],
+      "archived_paths": [
+        "src/adapters/_archived/ctrip/hot.yaml",
+        "src/adapters/_archived/ctrip/search.yaml"
+      ],
+      "reason": "Public Ctrip endpoints were verified broken or CAPTCHA-gated on 2026-05-05, with no stable public replacement captured.",
+      "replacement": "Use the web adapter or browser/CUA flow against an authenticated Ctrip session."
+    },
+    {
+      "site": "gcloud",
+      "commands": ["projects"],
+      "original_paths": ["src/adapters/gcloud/projects.yaml"],
+      "archived_paths": ["src/adapters/_archived/gcloud/projects.yaml"],
+      "reason": "Dedicated Google Cloud projects adapter cannot run in CI without interactive gcloud auth; gcloud remains available through external CLI passthrough when installed.",
+      "replacement": "gcloud projects list --format=json"
+    }
+  ]
+}

package/src/adapters/{az → _archived/az}/account.yaml

@@ -1,3 +1,8 @@
+# @owner   src/adapters/_archived/az/account.yaml
+# @does    Preserve the archived Azure account-list adapter outside active discovery.
+# @needs   Azure CLI installed and authenticated with az login
+# @feeds   src/adapters/_archived/archive.json provenance, historical adapter review
+# @breaks  Moving back under an active site would reintroduce an archive-only discovered site.
 site: az
 name: account
 description: List Azure subscriptions
@@ -20,7 +25,6 @@ pipeline:
 
 columns: [name, id, state, isDefault]
 
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities: ["subprocess.exec"]
 minimum_capability: subprocess.exec
 trust: user

package/src/adapters/{ctrip → _archived/ctrip}/hot.yaml

@@ -1,3 +1,8 @@
+# @owner   src/adapters/_archived/ctrip/hot.yaml
+# @does    Preserve the archived Ctrip hot-destination adapter outside active discovery.
+# @needs   Historical m.ctrip.com hotcity endpoint
+# @feeds   src/adapters/_archived/archive.json provenance, historical adapter review
+# @breaks  Moving back under an active site would reintroduce an archive-only discovered site.
 site: ctrip
 name: hot
 description: Ctrip popular travel destinations
@@ -27,7 +32,6 @@ pipeline:
 
 columns: [rank, name, type]
 
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities: ["http.fetch"]
 minimum_capability: http.fetch
 trust: public

package/src/adapters/{ctrip → _archived/ctrip}/search.yaml

@@ -1,3 +1,8 @@
+# @owner   src/adapters/_archived/ctrip/search.yaml
+# @does    Preserve the archived Ctrip flight-search adapter outside active discovery.
+# @needs   Historical flights.ctrip.com batchSearch endpoint without CAPTCHA
+# @feeds   src/adapters/_archived/archive.json provenance, historical adapter review
+# @breaks  Moving back under an active site would reintroduce an archive-only discovered site.
 site: ctrip
 name: search
 description: Search flights on Ctrip
@@ -52,11 +57,10 @@ args:
 
 columns: [airline, flight, depart, arrive, price]
 
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities: ["http.fetch"]
 minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "flights.ctrip.com search endpoint now requires CAPTCHA (showAuthCode=true on every public hit, verified 2026-05-05) — needs cookie/UI strategy with anti-bot solve"
+quarantineReason: "flights.ctrip.com search endpoint now requires CAPTCHA (showAuthCode=true on every public hit, verified 2026-05-05) - needs cookie/UI strategy with anti-bot solve"
 schema_version: v2

package/src/adapters/{gcloud → _archived/gcloud}/projects.yaml

@@ -1,3 +1,8 @@
+# @owner   src/adapters/_archived/gcloud/projects.yaml
+# @does    Preserve the archived Google Cloud projects adapter outside active discovery.
+# @needs   Google Cloud CLI installed and authenticated with gcloud auth login
+# @feeds   src/adapters/_archived/archive.json provenance, historical adapter review
+# @breaks  Moving back under an active site would reintroduce an archive-only discovered site.
 site: gcloud
 name: projects
 description: List Google Cloud projects
@@ -18,7 +23,6 @@ pipeline:
 
 columns: [projectId, name, projectNumber, lifecycleState]
 
-# schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities: ["subprocess.exec"]
 minimum_capability: subprocess.exec
 trust: user

package/src/adapters/amazon/new-releases.yaml

@@ -3,6 +3,7 @@ name: new-releases
 description: Amazon New Releases ranking
 domain: www.amazon.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/amazon/search.yaml

@@ -3,6 +3,7 @@ name: search
 description: Search Amazon products
 domain: www.amazon.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/apple-podcasts/search.yaml

@@ -4,6 +4,7 @@ description: Search Apple Podcasts
 domain: itunes.apple.com
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   query:

package/src/adapters/apple-podcasts/top.yaml

@@ -4,6 +4,7 @@ description: Top podcasts chart on Apple Podcasts
 domain: rss.marketingtools.apple.com
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   limit:

package/src/adapters/arxiv/search.yaml

@@ -4,6 +4,7 @@ description: Search arXiv papers
 domain: export.arxiv.org
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   query:

package/src/adapters/arxiv/trending.yaml

@@ -4,6 +4,7 @@ description: Recent arXiv papers by category (newest submissions)
 domain: export.arxiv.org
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   category:

package/src/adapters/baidu/hot.yaml

@@ -3,6 +3,7 @@ name: hot
 description: Get Baidu hot search trending topics
 domain: top.baidu.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/baidu/search.yaml

@@ -3,6 +3,7 @@ name: search
 description: Search Baidu for web results
 domain: www.baidu.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/bbc/top.yaml

@@ -4,6 +4,7 @@ description: BBC top news headlines
 domain: www.bbc.co.uk
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   limit:

package/src/adapters/bilibili/feed.yaml

@@ -4,6 +4,7 @@ description: Bilibili dynamic feed (following updates)
 domain: api.bilibili.com
 type: web-api
 strategy: cookie
+lint_listing_detail: skip
 auth_cookies: [SESSDATA, bili_jct]
 
 args:

package/src/adapters/bilibili/hot.yaml

@@ -4,6 +4,7 @@ description: Bilibili popular videos
 domain: api.bilibili.com
 type: web-api
 strategy: cookie
+lint_listing_detail: skip
 auth_cookies: [SESSDATA, bili_jct]
 
 args:

package/src/adapters/bilibili/trending.yaml

@@ -4,6 +4,7 @@ description: Bilibili trending searches
 domain: api.bilibili.com
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   limit:

package/src/adapters/binance/hot.yaml

@@ -4,6 +4,7 @@ description: Binance top trending coins by 24h trading volume / 币安热门成
 domain: data-api.binance.vision
 type: web-api
 strategy: public
+lint_listing_detail: skip
 browser: false
 
 args:

package/src/adapters/binance/top.yaml

@@ -4,6 +4,7 @@ description: Binance top trading pairs by 24h quote volume / 币安成交额排
 domain: data-api.binance.vision
 type: web-api
 strategy: public
+lint_listing_detail: skip
 browser: false
 
 args:

package/src/adapters/bluesky/search.yaml

@@ -4,6 +4,7 @@ description: Search Bluesky users
 domain: public.api.bsky.app
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   query:

package/src/adapters/bluesky/trending.yaml

@@ -4,6 +4,7 @@ description: Trending topics on Bluesky
 domain: public.api.bsky.app
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   limit:

package/src/adapters/cnki/search.yaml

@@ -4,6 +4,7 @@ description: Search CNKI academic papers
 domain: scholar.cnki.net
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   query:

package/src/adapters/cnn/top.yaml

@@ -4,6 +4,7 @@ description: CNN top stories via RSS
 type: web-api
 domain: rss.cnn.com
 strategy: public
+lint_listing_detail: skip
 args:
   limit:
     required: false

package/src/adapters/coupang/hot.yaml

@@ -4,6 +4,7 @@ description: Coupang trending/popular products
 domain: www.coupang.com
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   limit:

package/src/adapters/coupang/search.yaml

@@ -3,6 +3,7 @@ name: search
 description: Search Coupang products
 domain: www.coupang.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/dangdang/hot.yaml

@@ -3,6 +3,7 @@ name: hot
 description: Dangdang bestseller book list
 domain: bang.dangdang.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/dangdang/search.yaml

@@ -3,6 +3,7 @@ name: search
 description: Search books on Dangdang
 domain: www.dangdang.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/devto/search.yaml

@@ -4,6 +4,7 @@ description: Search Dev.to articles
 type: web-api
 domain: dev.to
 strategy: public
+lint_listing_detail: skip
 
 args:
   query:

package/src/adapters/devto/top.yaml

@@ -4,6 +4,7 @@ description: Top DEV.to articles of the day
 domain: dev.to
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   limit:

package/src/adapters/dianping/hot.yaml

@@ -3,6 +3,7 @@ name: hot
 description: Dianping trending restaurants
 domain: www.dianping.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/dianping/search.yaml

@@ -3,6 +3,7 @@ name: search
 description: Search restaurants on Dianping
 domain: www.dianping.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/dictionary/search.yaml

@@ -4,6 +4,7 @@ description: Look up word definitions, phonetics, and parts of speech
 domain: api.dictionaryapi.dev
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   word:

package/src/adapters/douban/new-movies.yaml

@@ -4,6 +4,7 @@ description: Douban new movies in theaters
 domain: movie.douban.com
 type: web-api
 strategy: public
+lint_listing_detail: skip
 
 args:
   limit:

package/src/adapters/douban/search.yaml

@@ -4,6 +4,7 @@ description: Search Douban movies and books
 domain: www.douban.com
 type: web-api
 strategy: cookie
+lint_listing_detail: skip
 auth_cookies: [dbcl2]
 
 args:

package/src/adapters/doubao/new.yaml

@@ -3,6 +3,7 @@ name: new
 description: Start a new Doubao chat conversation
 domain: www.doubao.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 columns: [status, url]

package/src/adapters/douyu/hot.yaml

@@ -4,6 +4,7 @@ description: Douyu trending live streams
 domain: www.douyu.com
 type: web-api
 strategy: public
+lint_listing_detail: skip
 browser: false
 
 args:

package/src/adapters/douyu/search.yaml

@@ -3,6 +3,7 @@ name: search
 description: Search Douyu live streams
 domain: www.douyu.com
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/eastmoney/hot.yaml

@@ -4,6 +4,7 @@ description: Eastmoney hot stocks (A-share volume leaders)
 type: web-api
 domain: push2.eastmoney.com
 strategy: public
+lint_listing_detail: skip
 args:
   limit:
     required: false

package/src/adapters/eastmoney/search.yaml

@@ -4,6 +4,7 @@ description: Search stocks on Eastmoney
 type: web-api
 domain: searchapi.eastmoney.com
 strategy: public
+lint_listing_detail: skip
 args:
   query:
     required: true

package/src/adapters/ele/hot.yaml

@@ -3,6 +3,7 @@ name: hot
 description: Ele.me trending restaurants
 domain: www.ele.me
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args:

package/src/adapters/ele/search.yaml

@@ -3,6 +3,7 @@ name: search
 description: Search restaurants and food on Ele.me
 domain: www.ele.me
 strategy: intercept
+lint_listing_detail: skip
 browser: true
 
 args: