@zenalexa/unicli 0.217.3 → 0.218.1

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/adguardhome/rules.yaml

@@ -29,5 +29,5 @@ minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "requires local AdGuard Home instance on a private host"
+quarantineReason: "requires local AdGuard Home instance on a private host (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/adguardhome/stats.yaml

@@ -30,5 +30,5 @@ minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "requires local AdGuard Home instance on a private host"
+quarantineReason: "requires local AdGuard Home instance on a private host (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/adguardhome/status.yaml

@@ -30,5 +30,5 @@ minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "requires local AdGuard Home instance on a private host"
+quarantineReason: "requires local AdGuard Home instance on a private host (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/apple-music/rate-album.yaml

@@ -17,8 +17,7 @@ strategy: ui
 domain: music.apple.com
 browser: false
 quarantine: true
-quarantineReason: Requires macOS + Apple Music desktop app + a CUA backend
-
+quarantineReason: Requires macOS + Apple Music desktop app + a CUA backend (quarantined 2026-04-15)
 args:
   stars:
     type: int

package/src/adapters/arxiv/trending.yaml

@@ -42,5 +42,5 @@ minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "HTTP 400 on empty category — probe fires without required `category` arg default"
+quarantineReason: "HTTP 400 on empty category — probe fires without required `category` arg default (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/az/account.yaml

@@ -26,5 +26,5 @@ minimum_capability: subprocess.exec
 trust: user
 confidentiality: public
 quarantine: true
-quarantineReason: "`az account show` times out in CI without interactive login"
+quarantineReason: "`az account show` times out in CI without interactive login (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/coupang/hot.yaml

@@ -33,5 +33,6 @@ capabilities: ["http.fetch"]
 minimum_capability: http.fetch
 trust: public
 confidentiality: public
-quarantine: false
+quarantine: true
+quarantineReason: "www.coupang.com/np/goldbox returns HTTP 403 from public IPs (Cloudflare bot-wall, verified 2026-05-05) — needs cookie strategy with a real browser session"
 schema_version: v2

package/src/adapters/ctrip/hot.yaml

@@ -32,5 +32,6 @@ capabilities: ["http.fetch"]
 minimum_capability: http.fetch
 trust: public
 confidentiality: public
-quarantine: false
+quarantine: true
+quarantineReason: "m.ctrip.com/restapi/h5api/searchapp/search returns HTTP 502 (verified 2026-05-05); upstream re-architected, no obvious public hot-city replacement endpoint"
 schema_version: v2

package/src/adapters/ctrip/search.yaml

@@ -57,5 +57,6 @@ capabilities: ["http.fetch"]
 minimum_capability: http.fetch
 trust: public
 confidentiality: public
-quarantine: false
+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"
 schema_version: v2

package/src/adapters/douban/top250.yaml

@@ -70,5 +70,5 @@ minimum_capability: cdp-browser.evaluate
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "timed out after 8s — upstream slow from hosted runners"
+quarantineReason: "timed out after 8s — upstream slow from hosted runners (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/figma/export-selected.yaml

@@ -15,8 +15,7 @@ strategy: ui
 domain: figma.com
 browser: false
 quarantine: true
-quarantineReason: Requires macOS + Figma desktop app + a CUA backend (ANTHROPIC_API_KEY etc.)
-
+quarantineReason: Requires macOS + Figma desktop app + a CUA backend (ANTHROPIC_API_KEY etc.) (quarantined 2026-04-15)
 args:
   format:
     type: str

package/src/adapters/gcloud/projects.yaml

@@ -24,5 +24,5 @@ minimum_capability: subprocess.exec
 trust: user
 confidentiality: public
 quarantine: true
-quarantineReason: "cloud CLI not authenticated in CI; `gcloud auth login` required on host"
+quarantineReason: "cloud CLI not authenticated in CI; `gcloud auth login` required on host (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/github-trending/developers.yaml

@@ -38,5 +38,5 @@ minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "HTTP 404 — gitterapp mirror retired, needs official GitHub trending scrape"
+quarantineReason: "HTTP 404 — gitterapp mirror retired, needs official GitHub trending scrape (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/github-trending/weekly.yaml

@@ -39,5 +39,5 @@ minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "HTTP 404 — gitterapp mirror retired, needs official GitHub trending scrape"
+quarantineReason: "HTTP 404 — gitterapp mirror retired, needs official GitHub trending scrape (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/homebrew/search.yaml

@@ -15,7 +15,7 @@ pipeline:
   - fetch:
       url: "https://formulae.brew.sh/api/formula.json"
 
-  - filter: "item.name.includes('${{ args.query }}') || (item.desc || '').toLowerCase().includes('${{ args.query }}'.toLowerCase())"
+  - filter: "item.name.toLowerCase().includes(args.query.toLowerCase()) || (item.desc || '').toLowerCase().includes(args.query.toLowerCase())"
 
   - map:
       name: ${{ item.name }}

package/src/adapters/imdb/top.yaml

@@ -36,5 +36,5 @@ minimum_capability: subprocess.exec
 trust: user
 confidentiality: public
 quarantine: true
-quarantineReason: "upstream returns HTML instead of JSON — scraping path needed"
+quarantineReason: "upstream returns HTML instead of JSON — scraping path needed (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/itch-io/popular.yaml

@@ -27,5 +27,5 @@ minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "HTTP 404 — itch.io removed the top-rated JSON feed"
+quarantineReason: "HTTP 404 — itch.io removed the top-rated JSON feed (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/itch-io/top.yaml

@@ -36,5 +36,5 @@ minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "HTTP 404 — itch.io /api/1/x/games endpoint removed"
+quarantineReason: "HTTP 404 — itch.io /api/1/x/games endpoint removed (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/mastodon/timeline.yaml

@@ -38,5 +38,5 @@ minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "mastodon.social blocks CI egress; adapter works against user instance"
+quarantineReason: "mastodon.social blocks CI egress; adapter works against user instance (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/openrouter/search.yaml

@@ -17,7 +17,7 @@ pipeline:
 
   - select: data
 
-  - filter: "!('${{ args.query }}') || item.name.toLowerCase().includes('${{ args.query }}'.toLowerCase()) || item.id.toLowerCase().includes('${{ args.query }}'.toLowerCase())"
+  - filter: "!args.query || item.name.toLowerCase().includes(args.query.toLowerCase()) || item.id.toLowerCase().includes(args.query.toLowerCase())"
 
   - map:
       id: ${{ item.id }}

package/src/adapters/pypi/search.yaml

@@ -41,5 +41,6 @@ capabilities: ["http.fetch"]
 minimum_capability: http.fetch
 trust: public
 confidentiality: public
-quarantine: false
+quarantine: true
+quarantineReason: "pypi.org/search now serves a Fastly bot-wall HTML instead of JSON (verified 2026-05-05); the herokuapp fallback domain is dead — switch to a JSON search backend or render the page through the browser strategy"
 schema_version: v2

package/src/adapters/sspai/hot.yaml

@@ -10,8 +10,11 @@ args:
     default: 20
 pipeline:
   - fetch:
-      url: "https://sspai.com/api/v1/articles?offset=0&limit=${{ args.limit | default(20) }}&sort=hot"
+      url: "https://sspai.com/api/v1/article/index/page/get?offset=0&limit=60"
   - select: data
+  - sort:
+      by: like_count
+      order: desc
   - map:
       title: "${{ item.title }}"
       author: "${{ item.author.nickname }}"

package/src/adapters/sspai/latest.yaml

@@ -10,16 +10,16 @@ args:
     default: 20
 pipeline:
   - fetch:
-      url: "https://sspai.com/api/v1/articles?offset=0&limit=${{ args.limit | default(20) }}&sort=created_at"
+      url: "https://sspai.com/api/v1/article/index/page/get?offset=0&limit=${{ args.limit | default(20) }}"
   - select: data
   - map:
       title: "${{ item.title }}"
       author: "${{ item.author.nickname }}"
       likes: "${{ item.like_count }}"
+      released_at: "${{ item.released_time | date_iso }}"
       url: "${{ 'https://sspai.com/post/' + item.id }}"
-      date: "${{ item.created_at }}"
   - limit: "${{ args.limit | default(20) }}"
-columns: [title, author, likes, url]
+columns: [title, author, likes, released_at, url]
 
 # schema-v2 metadata — injected by `unicli migrate schema-v2`
 capabilities: ["http.fetch"]

package/src/adapters/tieba/hot.yaml

@@ -35,5 +35,5 @@ minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "upstream returns HTML (anti-bot page) instead of JSON from CI egress"
+quarantineReason: "upstream returns HTML (anti-bot page) instead of JSON from CI egress (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/wikipedia/today.yaml

@@ -30,5 +30,5 @@ minimum_capability: http.fetch
 trust: public
 confidentiality: public
 quarantine: true
-quarantineReason: "wikipedia REST blocks CI egress; adapter works from real user hosts"
+quarantineReason: "wikipedia REST blocks CI egress; adapter works from real user hosts (quarantined 2026-04-15)"
 schema_version: v2

package/src/adapters/zoom/toggle-mute.yaml

@@ -10,8 +10,7 @@ binary: osascript
 detect: Darwin
 strategy: public
 quarantine: true
-quarantineReason: Requires macOS + zoom.us running with an active meeting
-
+quarantineReason: Requires macOS + zoom.us running with an active meeting (quarantined 2026-04-15)
 pipeline:
   - ax_focus:
       app: zoom.us

package/dist/engine/yaml-runner.d.ts

@@ -1,11 +0,0 @@
-/**
- * @deprecated since v0.213 — import from ./executor.js (runPipeline,
- * PipelineError, assertSafeRequestUrl), ./step-registry.js (registerStep,
- * StepHandler), ./template.js (evalExpression, PIPE_FILTERS), or the
- * per-step file under ./steps/. This shim is removed in v0.214.
- */
-export { runPipeline, PipelineError, assertSafeRequestUrl, type PipelineContext, type PipelineOptions, _resetTransportBusForTests } from "./executor.js";
-export { registerStep, getStep, listSteps, type StepHandler } from "./step-registry.js";
-export { PIPE_FILTERS, evalExpression, buildScope } from "./template.js";
-export { stepFetch, stepFetchText, stepParseRss, stepHtmlToMd, stepSelect, stepMap, stepFilter, stepSort, stepLimit, stepExec, stepWriteTemp, stepNavigate, stepEvaluate, stepClick, stepType, stepWaitBrowser, stepIntercept, stepPress, stepScroll, stepSnapshot, stepTap, stepExtract, stepSet, stepAppend, stepIf, stepEach, stepParallel, stepAssert, stepDownload, stepWebsocket, type FetchConfig, type RssConfig, type SortConfig, type ExecConfig, type WriteTempConfig, type NavigateConfig, type EvaluateConfig, type ClickConfig, type TypeConfig, type WaitBrowserConfig, type InterceptConfig, type TapConfig, type ExtractConfig, type AssertConfig, type EachConfig, type DownloadStepConfig } from "./steps/index.js";
-//# sourceMappingURL=yaml-runner.d.ts.map

package/dist/engine/yaml-runner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"yaml-runner.d.ts","sourceRoot":"","sources":["../../src/engine/yaml-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAEzJ,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAExF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/engine/yaml-runner.js

@@ -1,18 +0,0 @@
-/**
- * @deprecated since v0.213 — import from ./executor.js (runPipeline,
- * PipelineError, assertSafeRequestUrl), ./step-registry.js (registerStep,
- * StepHandler), ./template.js (evalExpression, PIPE_FILTERS), or the
- * per-step file under ./steps/. This shim is removed in v0.214.
- */
-// prettier-ignore
-export { runPipeline, PipelineError, assertSafeRequestUrl, _resetTransportBusForTests } from "./executor.js";
-// prettier-ignore
-export { registerStep, getStep, listSteps } from "./step-registry.js";
-// prettier-ignore
-export { PIPE_FILTERS, evalExpression, buildScope } from "./template.js";
-// prettier-ignore
-export { stepFetch, stepFetchText, stepParseRss, stepHtmlToMd, stepSelect, stepMap, stepFilter, stepSort, stepLimit, stepExec, stepWriteTemp, stepNavigate, stepEvaluate, stepClick, stepType, stepWaitBrowser, stepIntercept, stepPress, stepScroll, stepSnapshot, stepTap, stepExtract, stepSet, stepAppend, stepIf, stepEach, stepParallel, stepAssert, stepDownload, stepWebsocket } from "./steps/index.js";
-if (process.env.UNICLI_DEBUG === "1") {
-    process.stderr.write("[unicli] yaml-runner.ts is deprecated; import from ./executor.js or ./steps/\n");
-}
-//# sourceMappingURL=yaml-runner.js.map

package/dist/engine/yaml-runner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"yaml-runner.js","sourceRoot":"","sources":["../../src/engine/yaml-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,oBAAoB,EAA8C,0BAA0B,EAAE,MAAM,eAAe,CAAC;AACzJ,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAoB,MAAM,oBAAoB,CAAC;AACxF,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACzE,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAwT,MAAM,kBAAkB,CAAC;AACvsB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG,EAAE,CAAC;IACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gFAAgF,CACjF,CAAC;AACJ,CAAC"}