@zenalexa/unicli 0.210.0 → 0.212.1

package/dist/transport/capability.js

@@ -0,0 +1,254 @@
+/**
+ * Step → transport capability matrix.
+ *
+ * Single source of truth for which transports can execute each pipeline
+ * step, per `.claude/plans/sessions/2026-04-14-v212-rethink/round4/02-operate-anything-arch.md`
+ * §3 (46 steps × 7 transports).
+ *
+ * Legend from round4/02:
+ *   ●  native
+ *   ○  emulated via delegate (still legal — appears in `transports`)
+ *   –  unsupported (absent from `transports`)
+ *   ◐  OS-gated (appears in `transports` AND `platforms`)
+ *
+ * The YAML runner uses {@link stepSupportedBy} at parse time to route a
+ * step to the right transport; {@link stepPlatform} is consulted when the
+ * step is platform-exclusive.
+ */
+/** Canonical ordering for the 7 transports; stable across releases. */
+export const TRANSPORT_KINDS = [
+    "http",
+    "cdp-browser",
+    "subprocess",
+    "desktop-ax",
+    "desktop-uia",
+    "desktop-atspi",
+    "cua",
+];
+/**
+ * The 46-step matrix. Keep row ordering loose; tests assert membership
+ * semantically.
+ */
+export const CAPABILITY_MATRIX = {
+    // --- API / content steps ---
+    fetch: { transports: ["http"] },
+    fetch_text: { transports: ["http"] },
+    parse_rss: { transports: ["http"] },
+    html_to_md: { transports: ["http", "cdp-browser"] },
+    // --- Transform steps (cross-transport, orchestrator-level) ---
+    select: { transports: [...TRANSPORT_KINDS] },
+    map: { transports: [...TRANSPORT_KINDS] },
+    filter: { transports: [...TRANSPORT_KINDS] },
+    sort: { transports: [...TRANSPORT_KINDS] },
+    limit: { transports: [...TRANSPORT_KINDS] },
+    // --- Subprocess ---
+    exec: { transports: ["subprocess"] },
+    write_temp: { transports: ["subprocess"] },
+    // --- Browser / GUI action steps ---
+    navigate: {
+        transports: ["cdp-browser", "desktop-ax", "desktop-uia", "desktop-atspi"],
+    },
+    evaluate: { transports: ["cdp-browser"] },
+    click: {
+        transports: [
+            "cdp-browser",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+            "cua",
+        ],
+    },
+    type: {
+        transports: [
+            "cdp-browser",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+            "cua",
+        ],
+    },
+    press: {
+        transports: [
+            "cdp-browser",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+            "cua",
+        ],
+    },
+    scroll: {
+        transports: [
+            "cdp-browser",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+            "cua",
+        ],
+    },
+    wait: {
+        transports: [
+            "cdp-browser",
+            "subprocess",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+            "cua",
+        ],
+    },
+    intercept: { transports: ["cdp-browser"] },
+    snapshot: {
+        transports: [
+            "cdp-browser",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+            "cua",
+        ],
+    },
+    screenshot: {
+        transports: [
+            "cdp-browser",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+            "cua",
+        ],
+    },
+    tap: { transports: ["cdp-browser"] },
+    download: { transports: ["http", "cdp-browser", "subprocess"] },
+    websocket: { transports: ["http"] },
+    // --- Control flow (cross-transport) ---
+    set: { transports: [...TRANSPORT_KINDS] },
+    if: { transports: [...TRANSPORT_KINDS] },
+    append: { transports: [...TRANSPORT_KINDS] },
+    each: { transports: [...TRANSPORT_KINDS] },
+    parallel: { transports: [...TRANSPORT_KINDS] },
+    rate_limit: { transports: [...TRANSPORT_KINDS] },
+    assert: { transports: [...TRANSPORT_KINDS] },
+    extract: {
+        transports: [
+            "http",
+            "cdp-browser",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+        ],
+    },
+    retry: { transports: [...TRANSPORT_KINDS] },
+    // --- CUA family (screenshot + VLM coord action) ---
+    cua_snapshot: { transports: ["cua"] },
+    cua_click: {
+        transports: [
+            "cua",
+            "cdp-browser",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+        ],
+    },
+    cua_type: {
+        transports: [
+            "cua",
+            "cdp-browser",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+        ],
+    },
+    cua_key: {
+        transports: [
+            "cua",
+            "cdp-browser",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+        ],
+    },
+    cua_scroll: {
+        transports: [
+            "cua",
+            "cdp-browser",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+        ],
+    },
+    cua_drag: {
+        transports: ["cua", "cdp-browser"],
+    },
+    cua_wait: {
+        transports: [
+            "cua",
+            "cdp-browser",
+            "subprocess",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+        ],
+    },
+    cua_assert: {
+        transports: [
+            "cua",
+            "cdp-browser",
+            "subprocess",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+        ],
+    },
+    cua_ask: { transports: ["cua"] },
+    cua_backend: { transports: ["cua"] },
+    cua_launch: { transports: ["cua", "subprocess", "desktop-ax"] },
+    // --- Platform-exclusive OS steps ---
+    ax_focus: { transports: ["desktop-ax"], platforms: ["darwin"] },
+    ax_menu_select: { transports: ["desktop-ax"], platforms: ["darwin"] },
+    applescript: { transports: ["desktop-ax"], platforms: ["darwin"] },
+    uia_invoke: { transports: ["desktop-uia"], platforms: ["win32"] },
+    uia_get_pattern: { transports: ["desktop-uia"], platforms: ["win32"] },
+    atspi_activate: { transports: ["desktop-atspi"], platforms: ["linux"] },
+    // --- Clipboard / app lifecycle (cross-transport where possible) ---
+    // Naming note: handlers and adapters use `clipboard_read` / `clipboard_write`
+    // throughout (see src/engine/steps/desktop-ax.ts, AX/UIA/AT-SPI adapters,
+    // src/commands/migrate-schema.ts, src/commands/lint.ts). The matrix keys
+    // must match the handler keys verbatim — `bus.require("clipboard_read")`
+    // looks up by name, so a `clipboard_get` alias here would 404 at runtime.
+    clipboard_read: {
+        transports: [
+            "cdp-browser",
+            "subprocess",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+        ],
+    },
+    clipboard_write: {
+        transports: [
+            "cdp-browser",
+            "subprocess",
+            "desktop-ax",
+            "desktop-uia",
+            "desktop-atspi",
+        ],
+    },
+    launch_app: {
+        transports: ["subprocess", "desktop-ax", "desktop-uia", "desktop-atspi"],
+    },
+    focus_window: {
+        transports: ["desktop-ax", "desktop-uia", "desktop-atspi", "cua"],
+    },
+};
+/** Step names this transport can execute on the given host platform. */
+export function stepSupportedBy(step) {
+    const row = CAPABILITY_MATRIX[step];
+    return row ? row.transports : [];
+}
+/** Platform gate for a step; undefined means any OS. */
+export function stepPlatform(step) {
+    const row = CAPABILITY_MATRIX[step];
+    return row?.platforms;
+}
+/** Count of distinct steps in the matrix. */
+export function stepCount() {
+    return Object.keys(CAPABILITY_MATRIX).length;
+}
+//# sourceMappingURL=capability.js.map

package/dist/transport/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../../src/transport/capability.ts"],"names":[],"mappings":"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"}

package/dist/transport/types.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Transport types — the v0.212 "operate anything" contract.
+ *
+ * A `TransportAdapter` is a physical execution channel (HTTP, Chrome CDP,
+ * subprocess, macOS AX, Windows UIA, Linux AT-SPI, screenshot-based CUA)
+ * behind a uniform 5-method interface: open / snapshot / action / stream /
+ * close.
+ *
+ * Design contract:
+ *  - `action()` NEVER throws — all failures become an `ActionResult.error`
+ *    envelope so the YAML runner can sequence fallbacks without try/catch.
+ *  - `Capability.steps` is the single source of truth for pipeline-step
+ *    dispatch; the runner validates at parse time, not at execution time.
+ *  - `minimum_capability` in an error envelope drives the self-repair loop:
+ *    an agent sees "needs `desktop-ax.element_by_role`" and picks the
+ *    matching transport/step to fix.
+ */
+import type { Envelope } from "../core/envelope.js";
+/**
+ * The seven transports that together cover the full "operate anything"
+ * surface. A transport is a physical execution channel; a strategy
+ * (auth path) is orthogonal and lives on the adapter, not here.
+ */
+export type TransportKind = "http" | "cdp-browser" | "subprocess" | "desktop-ax" | "desktop-uia" | "desktop-atspi" | "cua";
+/**
+ * The snapshot encodings a transport may return. A single transport can
+ * support more than one format (e.g. cdp-browser returns `dom-ax` natively
+ * and `screenshot` via CDP Page.captureScreenshot).
+ */
+export type SnapshotFormat = "dom-ax" | "os-ax" | "screenshot" | "text" | "json";
+/** Uniform snapshot shape returned by {@link TransportAdapter.snapshot}. */
+export interface Snapshot {
+    format: SnapshotFormat;
+    data: string | Buffer;
+    width?: number;
+    height?: number;
+    scaleX?: number;
+    scaleY?: number;
+    url?: string;
+    title?: string;
+    refs?: Record<string, unknown>;
+}
+/** Single typed request sent to {@link TransportAdapter.action}. */
+export interface ActionRequest {
+    /** Pipeline step name, e.g. `"click"`, `"fetch"`, `"exec"`. */
+    kind: string;
+    params: Record<string, unknown>;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Uniform action result. Success returns `ok:true` + `data`; failure
+ * returns `ok:false` + `error` envelope. Never throws.
+ *
+ * Aliased to {@link Envelope} so the core envelope helpers (`ok()`, `err()`)
+ * work directly with transport return values.
+ */
+export type ActionResult<T = unknown> = Envelope<T>;
+/**
+ * Declarative capability descriptor for a transport.
+ *
+ * `steps` lists the pipeline step names this transport can execute;
+ * the YAML runner validates against this at parse time, not at
+ * execution time. `platforms` gates OS-specific transports.
+ */
+export interface Capability {
+    readonly steps: readonly string[];
+    readonly snapshotFormats: readonly SnapshotFormat[];
+    readonly platforms?: readonly ("darwin" | "win32" | "linux")[];
+    /**
+     * `true` when calling this transport's `action()` has side-effects on
+     * the user's host (file writes, clicks, keystrokes).
+     */
+    readonly mutatesHost: boolean;
+}
+/**
+ * Observability stream for long-running transports.
+ *
+ *  - subprocess: stdout / stderr chunks
+ *  - cdp-browser: raw CDP events
+ *  - desktop-ax / uia / atspi: platform accessibility events
+ *  - cua: VLM trace (model, tokens, reasoning)
+ */
+export interface TransportEvent {
+    ts: number;
+    kind: "stdout" | "stderr" | "cdp" | "ax-event" | "uia-event" | "cua-trace";
+    payload: unknown;
+}
+/**
+ * Dispatcher surface injected into every transport so transports can
+ * compose (e.g. `cdp-browser` delegates `snapshot(format:"screenshot")`
+ * to `cua` on non-trivial perception tasks).
+ */
+export interface TransportBus {
+    register(adapter: TransportAdapter): void;
+    get(kind: TransportKind): TransportAdapter;
+    /**
+     * Look up the transport that can execute `step` on the given
+     * `platform`. Throws a typed error with the envelope shape when no
+     * transport matches — the self-repair suggestion is embedded so agents
+     * can read `error.minimum_capability` to decide which transport to add
+     * or repair.
+     */
+    require(step: string, platform?: NodeJS.Platform): TransportAdapter;
+    /** Enumerate every registered transport. */
+    list(): TransportAdapter[];
+}
+/**
+ * Shared state handed to each transport at `open()` time. The bus field
+ * allows cross-transport delegation; `vars` is the mutable pipeline
+ * variable table.
+ */
+export interface TransportContext {
+    site?: string;
+    adapterPath?: string;
+    cwd?: string;
+    env?: Record<string, string>;
+    cookieHeader?: string;
+    vars: Record<string, unknown>;
+    signal?: AbortSignal;
+    bus: TransportBus;
+}
+/**
+ * The core interface every transport implements.
+ *
+ *   open()     — acquire resources (Chrome spawn, CDP attach, AX session,
+ *                subprocess shell).
+ *   snapshot() — perception. Always returns a uniform {@link Snapshot}
+ *                even across transports (screenshot vs AX tree vs DOM).
+ *   action()   — execute one pipeline step. NEVER throws.
+ *   stream()   — optional async iterable of {@link TransportEvent}.
+ *   close()    — release resources. Must be idempotent.
+ */
+export interface TransportAdapter {
+    readonly kind: TransportKind;
+    readonly capability: Capability;
+    open(ctx: TransportContext): Promise<void>;
+    snapshot(opts?: {
+        format?: SnapshotFormat;
+        fresh?: boolean;
+    }): Promise<Snapshot>;
+    action<T = unknown>(req: ActionRequest): Promise<ActionResult<T>>;
+    stream?(filter?: {
+        kinds?: string[];
+    }): AsyncIterable<TransportEvent>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"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"}

package/dist/transport/types.js

@@ -0,0 +1,19 @@
+/**
+ * Transport types — the v0.212 "operate anything" contract.
+ *
+ * A `TransportAdapter` is a physical execution channel (HTTP, Chrome CDP,
+ * subprocess, macOS AX, Windows UIA, Linux AT-SPI, screenshot-based CUA)
+ * behind a uniform 5-method interface: open / snapshot / action / stream /
+ * close.
+ *
+ * Design contract:
+ *  - `action()` NEVER throws — all failures become an `ActionResult.error`
+ *    envelope so the YAML runner can sequence fallbacks without try/catch.
+ *  - `Capability.steps` is the single source of truth for pipeline-step
+ *    dispatch; the runner validates at parse time, not at execution time.
+ *  - `minimum_capability` in an error envelope drives the self-repair loop:
+ *    an agent sees "needs `desktop-ax.element_by_role`" and picks the
+ *    matching transport/step to fix.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transport/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/types.d.ts

@@ -44,6 +44,15 @@ export interface PipelineStep {
 export interface AdapterCommand {
     name: string;
     description?: string;
+    /**
+     * When true, the adapter is quarantined: skipped by `unicli test` and the
+     * CI conformance suite, and shown with a `[quarantined]` tag in `unicli list`.
+     * Use this to park adapters whose upstream API changed until an agent repairs
+     * them — keeps CI green without hiding the adapter from discovery.
+     */
+    quarantine?: boolean;
+    /** Human-readable reason for quarantine, surfaced in `unicli list`. */
+    quarantineReason?: string;
     pipeline?: PipelineStep[];
     adapterArgs?: AdapterArg[];
     func?: (page: IPage, kwargs: Record<string, unknown>) => Promise<unknown>;
@@ -164,8 +173,15 @@ export interface ResolvedCommand {
     command: AdapterCommand;
     args: Record<string, unknown>;
 }
-/** Output format options */
-export type OutputFormat = "table" | "json" | "yaml" | "csv" | "md";
+/**
+ * Output format options.
+ *
+ * v0.212: `table` is deprecated — callers passing `-f table` get a
+ * stderr warning and fall back to `md`. The type still lists `table`
+ * during the deprecation window so existing call-sites keep compiling.
+ * `compact` is the new agent-token-optimized format.
+ */
+export type OutputFormat = "table" | "json" | "yaml" | "csv" | "md" | "compact";
 /** Structured error detail for AI agent consumption */
 export interface PipelineErrorDetail {
     step: number;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;AACrB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,mCAAuB,CAAA;IACvB,qBAAS,CAAA;AACX,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB;AAoND,sCAAsC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,EAAE;IACvB,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,EAAE;CACR,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;AACrB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,mCAAuB,CAAA;IACvB,qBAAS,CAAA;AACX,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB;AAqOD,sCAAsC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,EAAE;IACvB,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,EAAE;CACR,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenalexa/unicli",
-  "version": "0.210.0",
+  "version": "0.212.1",
   "description": "The universal interface between AI agents and the world's software",
   "type": "module",
   "main": "dist/main.js",
@@ -22,23 +22,43 @@
   },
   "scripts": {
     "dev": "tsx src/main.ts",
-    "build": "tsc && tsx scripts/build-manifest.js",
+    "build": "tsc && tsx scripts/build-manifest.js && tsx scripts/count-stats.ts && tsx scripts/build-readme.ts && tsx scripts/build-agents.ts && npx prettier --write AGENTS.md",
+    "stats": "tsx scripts/count-stats.ts && tsx scripts/build-readme.ts",
+    "stats:check": "tsx scripts/count-consistency.ts",
+    "build:agents": "tsx scripts/build-agents.ts",
     "test": "vitest run --project unit",
     "test:adapter": "vitest run --project adapter",
+    "adapter:health": "tsx scripts/adapter-health-probe.ts",
     "test:all": "vitest run",
     "typecheck": "tsc --noEmit",
     "lint": "oxlint src/",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "lint:context": "bash scripts/lint-context.sh",
-    "verify": "npm run format:check && npm run typecheck && npm run lint && npm run lint:context && npm run test && npm run build",
+    "build:manifest": "tsx scripts/build-manifest.js",
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
+    "changeset:status": "changeset status --since=origin/main",
+    "verify:changesets": "tsx scripts/verify-changesets.ts",
+    "conformance": "tsx scripts/conformance-report.ts",
+    "lint:adapters": "tsx src/main.ts lint src/adapters",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "validate:agents-size": "tsx scripts/validate-agents-size.ts",
+    "verify": "npm run format:check && npm run typecheck && npm run lint && npm run lint:context && npm run build:manifest && npm run lint:adapters && npm run test && npm run build && npm run validate:agents-size && npm run stats:check && npm run conformance && npm run verify:changesets",
+    "verify:full": "npm run verify && npm run refs:verify && npm run adapter:health",
+    "verify:clean": "npm run clean && npm run verify",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs",
     "doctor": "tsx src/doctor.ts",
     "mcp": "tsx src/mcp/server.ts",
     "release": "npm run build && tsx scripts/release.ts",
-    "bench": "tsx scripts/bench.ts",
+    "release:check": "tsx scripts/release-check.ts",
+    "prepare": "lefthook install 2>/dev/null || true",
+    "preversion": "npm run verify",
+    "postversion": "npm run build && tsx scripts/release.ts",
+    "bench": "tsx bench/report.ts",
+    "refs:verify": "tsx scripts/verify-refs.ts",
     "sync:ref": "bash scripts/sync-ref.sh"
   },
   "keywords": [
@@ -69,23 +89,25 @@
   "dependencies": {
     "chalk": "^5.4.1",
     "cli-table3": "^0.6.5",
-    "commander": "^13.1.0",
+    "commander": "^14.0.3",
     "js-yaml": "^4.1.0",
     "turndown": "^7.2.4",
-    "undici": "^7.5.0",
+    "undici": "^8.0.2",
     "ws": "^8.18.0",
-    "zod": "^3.24.0"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@changesets/cli": "^2.30.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.13.0",
+    "@types/node": "^25.6.0",
     "@types/turndown": "^5.0.6",
     "@types/ws": "^8.5.14",
+    "lefthook": "^2.1.5",
     "oxlint": "^1.0.0",
     "prettier": "^3.5.0",
     "tsx": "^4.19.0",
-    "typescript": "^5.7.0",
+    "typescript": "^6.0.2",
     "vitepress": "^1.6.0",
-    "vitest": "^3.1.0"
+    "vitest": "^3.2.4"
   }
 }

package/src/adapters/1688/_site.json

@@ -0,0 +1,9 @@
+{
+  "site": "1688",
+  "displayName": "1688.com",
+  "type": "web-api",
+  "domain": "1688.com",
+  "description": "1688.com — Alibaba wholesale B2B marketplace",
+  "strategy": "cookie",
+  "category": "shopping"
+}

package/src/adapters/1688/item.yaml

@@ -34,3 +34,10 @@ pipeline:
         })()
 
 columns: [title, price, minOrder, shop, location, sales]
+
+# schema-v2 metadata — injected by `unicli migrate schema-v2`
+capabilities: ["cdp-browser.evaluate", "cdp-browser.navigate"]
+minimum_capability: cdp-browser.evaluate
+trust: public
+confidentiality: public
+quarantine: false

package/src/adapters/1688/search.yaml

@@ -42,3 +42,10 @@ pipeline:
   - limit: ${{ args.limit }}
 
 columns: [rank, title, price, unit, sales, shop, location]
+
+# schema-v2 metadata — injected by `unicli migrate schema-v2`
+capabilities: ["http.fetch"]
+minimum_capability: http.fetch
+trust: public
+confidentiality: public
+quarantine: false

package/src/adapters/1688/store.yaml

@@ -36,3 +36,10 @@ pipeline:
   - limit: ${{ args.limit }}
 
 columns: [rank, title, price, sales, offerId]
+
+# schema-v2 metadata — injected by `unicli migrate schema-v2`
+capabilities: ["http.fetch"]
+minimum_capability: http.fetch
+trust: public
+confidentiality: public
+quarantine: false

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

@@ -28,3 +28,10 @@ pipeline:
       url: ${{ 'https://36kr.com/newsflashes/' + args.id }}
 
 columns: [title, date, content, url]
+
+# schema-v2 metadata — injected by `unicli migrate schema-v2`
+capabilities: ["http.fetch"]
+minimum_capability: http.fetch
+trust: public
+confidentiality: public
+quarantine: false