@zenalexa/unicli 0.207.1

package/dist/engine/analysis.js

@@ -0,0 +1,352 @@
+/**
+ * Shared Analysis Module — boolean endpoint filters + transparent sort keys.
+ *
+ * Replaces the numeric scoring approach with composable boolean predicates and
+ * a tuple sort key, making ranking logic explicit and unit-testable.
+ *
+ * Reference: APISensor (NJU 2026), industry best practices.
+ */
+// ---------------------------------------------------------------------------
+// URL helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns the pathname component of a URL, or the full string for invalid URLs.
+ */
+function safePathname(url) {
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        return url;
+    }
+}
+/**
+ * Returns the hostname component of a URL, or the full string for invalid URLs.
+ */
+function safeHostname(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return url;
+    }
+}
+// ---------------------------------------------------------------------------
+// isNoiseUrl
+// ---------------------------------------------------------------------------
+const NOISE_DOMAINS = [
+    "google-analytics.com",
+    "googletagmanager.com",
+    "hotjar.com",
+    "hotjar.io",
+    "doubleclick.net",
+    "connect.facebook.net",
+    "facebook.com",
+    "sentry.io",
+    "cdn.segment.com",
+    "api.segment.io",
+    "mixpanel.com",
+    "amplitude.com",
+    "newrelic.com",
+    "datadoghq.com",
+    "googlesyndication.com",
+    "adservice.google.com",
+    "clarity.ms",
+    "intercom.io",
+    "intercomassets.com",
+    "crisp.chat",
+    "hs-analytics.net",
+    "hubspot.com",
+    "tealiumiq.com",
+    "tiqcdn.com",
+];
+const NOISE_PATH_PATTERNS = [
+    /\/beacon(\/|$)/i,
+    /\/pixel(\/|$)/i,
+    /\/track(\/|$)/i,
+    /\/collect(\/|$)/i,
+    /\/analytics(\/|$)/i,
+    /\/telemetry(\/|$)/i,
+    /\/log(\/|$)/i,
+    /\/event(\/|$)/i,
+    /\/tr(\/|$)/i,
+    /\/_next\/data\//i,
+    /\/sockjs-node(\/|$)/i,
+    /\.hot-update\./i,
+];
+/**
+ * Returns true if the URL belongs to a known noise source: trackers, analytics
+ * beacons, Next.js internals, or hot-reload endpoints.
+ */
+export function isNoiseUrl(url) {
+    // Domain check — match against hostname only to avoid false positives from
+    // noise domain names appearing in query params or redirect paths.
+    const hostname = safeHostname(url).toLowerCase();
+    if (NOISE_DOMAINS.some((domain) => hostname.includes(domain))) {
+        return true;
+    }
+    // Path pattern check — match against pathname only.
+    const pathname = safePathname(url);
+    return NOISE_PATH_PATTERNS.some((re) => re.test(pathname));
+}
+// ---------------------------------------------------------------------------
+// isStaticResource
+// ---------------------------------------------------------------------------
+const STATIC_EXTENSIONS = new Set([
+    ".js",
+    ".css",
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".svg",
+    ".woff",
+    ".woff2",
+    ".ttf",
+    ".eot",
+    ".ico",
+    ".map",
+    ".webp",
+    ".avif",
+]);
+const STATIC_CONTENT_TYPE_PREFIXES = [
+    "image/",
+    "font/",
+    "text/css",
+    "application/javascript",
+    "application/x-javascript",
+    "text/javascript",
+];
+/**
+ * Returns true if the URL or content-type indicates a static resource
+ * (image, font, stylesheet, script, or source map).
+ */
+export function isStaticResource(url, contentType) {
+    // Content-type takes precedence when provided
+    if (contentType) {
+        const ct = contentType.toLowerCase();
+        if (STATIC_CONTENT_TYPE_PREFIXES.some((prefix) => ct.startsWith(prefix))) {
+            return true;
+        }
+    }
+    // Extension check on pathname
+    try {
+        const pathname = new URL(url).pathname;
+        const dot = pathname.lastIndexOf(".");
+        if (dot !== -1) {
+            const ext = pathname.slice(dot).toLowerCase().split("?")[0];
+            if (STATIC_EXTENSIONS.has(ext))
+                return true;
+        }
+    }
+    catch {
+        // malformed URL — try raw string
+        const dot = url.lastIndexOf(".");
+        if (dot !== -1) {
+            const ext = url
+                .slice(dot, dot + 10)
+                .toLowerCase()
+                .split(/[?#]/)[0];
+            if (STATIC_EXTENSIONS.has(ext))
+                return true;
+        }
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// isUsefulEndpoint
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if the endpoint appears to return useful structured data:
+ * JSON content-type, 2xx status (when provided), and non-trivial body.
+ */
+export function isUsefulEndpoint(entry) {
+    const { status, contentType, body } = entry;
+    // Must have JSON content-type
+    if (!contentType)
+        return false;
+    const ct = contentType.toLowerCase();
+    if (!ct.includes("application/json") &&
+        !ct.includes("text/json") &&
+        !ct.includes("+json")) {
+        return false;
+    }
+    // Status must be 2xx if provided
+    if (status !== undefined && (status < 200 || status >= 300)) {
+        return false;
+    }
+    // Body must be non-trivial
+    if (body === null || body === undefined)
+        return false;
+    if (typeof body !== "object")
+        return false;
+    // Reject empty object
+    const keys = Object.keys(body);
+    if (keys.length === 0)
+        return false;
+    // Reject trivial status-only responses: {status: "ok"} or {success: true}
+    if (keys.length === 1 && (keys[0] === "status" || keys[0] === "success")) {
+        return false;
+    }
+    if (keys.length === 2 &&
+        keys.includes("status") &&
+        keys.includes("success")) {
+        return false;
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// endpointSortKey
+// ---------------------------------------------------------------------------
+const TOP_LEVEL_ARRAY_FIELDS = new Set([
+    "data",
+    "items",
+    "results",
+    "list",
+    "records",
+    "entries",
+    "rows",
+    "hits",
+    "posts",
+    "articles",
+    "comments",
+]);
+/**
+ * Returns a 4-tuple sort key for transparent, deterministic endpoint ranking.
+ *
+ * Tuple: [itemCount, fieldCount, isApiPath, hasParams]
+ *
+ * Sort descending on all dimensions (higher = better).
+ */
+export function endpointSortKey(entry) {
+    const { url, body } = entry;
+    let itemCount = 0;
+    let fieldCount = 0;
+    if (body !== null && body !== undefined) {
+        if (Array.isArray(body)) {
+            itemCount = body.length;
+            if (body.length > 0 && typeof body[0] === "object" && body[0] !== null) {
+                fieldCount = Object.keys(body[0]).length;
+            }
+        }
+        else if (typeof body === "object") {
+            const obj = body;
+            const topKeys = Object.keys(obj);
+            fieldCount = topKeys.length;
+            // Check for a top-level array field with a well-known name
+            for (const key of topKeys) {
+                if (TOP_LEVEL_ARRAY_FIELDS.has(key) && Array.isArray(obj[key])) {
+                    const arr = obj[key];
+                    itemCount = arr.length;
+                    // Use the first array item's field count instead of the wrapper's
+                    if (arr.length > 0 && typeof arr[0] === "object" && arr[0] !== null) {
+                        fieldCount = Object.keys(arr[0]).length;
+                    }
+                    break;
+                }
+            }
+        }
+    }
+    // Test API path regex against pathname only to avoid false positives from
+    // query params that happen to contain /api/ or /v1/.
+    const isApiPath = /\/api\/|\/v[1-9]\d*\/|\/graphql\b/i.test(safePathname(url))
+        ? 1
+        : 0;
+    let hasParams = 0;
+    try {
+        hasParams = new URL(url).search.length > 0 ? 1 : 0;
+    }
+    catch {
+        hasParams = url.includes("?") ? 1 : 0;
+    }
+    return [itemCount, fieldCount, isApiPath, hasParams];
+}
+const URL_CAPABILITY_RULES = [
+    { urlPattern: /\/search(\/|$|\?)|\/query(\/|$|\?)/i, label: "search" },
+    {
+        urlPattern: /\/hot(\/|$|\?)|\/trending(\/|$|\?)|\/popular(\/|$|\?)|\/rank(\/|$|\?)|\/top(\/|$|\?)/i,
+        label: "hot",
+    },
+    {
+        urlPattern: /\/feed(\/|$|\?)|\/timeline(\/|$|\?)|\/stream(\/|$|\?)|\/latest(\/|$|\?)|\/new(\/|$|\?)/i,
+        label: "feed",
+    },
+    {
+        urlPattern: /\/profile(\/|$|\?)|\/user(\/|$|\?)|\/account(\/|$|\?)|\/me(\/|$|\?)/i,
+        label: "profile",
+    },
+    {
+        urlPattern: /\/comment(\/|$|\?)|\/reply(\/|$|\?)|\/review(\/|$|\?)/i,
+        label: "comments",
+    },
+    {
+        urlPattern: /\/detail(\/|$|\?)|\/article(\/|$|\?)|\/post(\/|$|\?)|\/item(\/|$|\?)|\/content(\/|$|\?)/i,
+        label: "detail",
+    },
+    {
+        urlPattern: /\/download(\/|$|\?)|\/media(\/|$|\?)|\/video(\/|$|\?)|\/audio(\/|$|\?)/i,
+        label: "download",
+    },
+];
+/**
+ * Detect a capability label from the URL and optionally the body shape.
+ *
+ * URL patterns take priority. If no URL match, falls back to field-name
+ * heuristics on the first item in an array body.
+ */
+export function detectCapability(url, body) {
+    // URL-based detection (highest priority) — test against pathname only to
+    // avoid false positives from capability keywords in query parameters.
+    const pathname = safePathname(url);
+    for (const rule of URL_CAPABILITY_RULES) {
+        if (rule.urlPattern.test(pathname))
+            return rule.label;
+    }
+    // Body field heuristics
+    if (body === null || body === undefined)
+        return null;
+    let firstItem = null;
+    if (Array.isArray(body) && body.length > 0 && typeof body[0] === "object") {
+        firstItem = body[0];
+    }
+    else if (typeof body === "object") {
+        const obj = body;
+        for (const key of Object.keys(obj)) {
+            const val = obj[key];
+            if (Array.isArray(val) && val.length > 0 && typeof val[0] === "object") {
+                firstItem = val[0];
+                break;
+            }
+        }
+    }
+    if (firstItem) {
+        const fields = new Set(Object.keys(firstItem).map((k) => k.toLowerCase()));
+        if (fields.has("title") && fields.has("url"))
+            return "feed";
+        if (fields.has("price") && fields.has("name"))
+            return "product";
+        if (fields.has("author") && fields.has("content"))
+            return "article";
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// formatDuration
+// ---------------------------------------------------------------------------
+/**
+ * Format a duration in milliseconds into a human-readable string.
+ *
+ * - < 1000 ms  → "42ms"
+ * - < 60000 ms → "3.2s"
+ * - else       → "1m 23s"
+ */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    if (ms < 60_000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    const minutes = Math.floor(ms / 60_000);
+    const seconds = Math.round((ms % 60_000) / 1000);
+    return `${minutes}m ${seconds}s`;
+}
+//# sourceMappingURL=analysis.js.map

package/dist/engine/analysis.js.map

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

package/dist/engine/auto-fix.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Auto-Fix Level 1 — detect broken select paths and suggest alternatives.
+ *
+ * When a select step fails with selector_miss, this module analyzes the
+ * actual data structure to find array fields that might be the correct path.
+ */
+/**
+ * Analyze data structure and suggest alternative select paths.
+ * Finds all array-valued paths in the object tree (max depth 5).
+ */
+export declare function suggestSelectFix(data: unknown, failedPath: string): string[];
+/**
+ * Apply a select path fix to a user adapter YAML file.
+ * Writes to ~/.unicli/adapters/<site>/<cmd>.yaml (user override dir).
+ */
+export declare function applySelectFix(site: string, command: string, _stepIndex: number, oldPath: string, newPath: string, adapterPath?: string): string | null;
+//# sourceMappingURL=auto-fix.d.ts.map

package/dist/engine/auto-fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-fix.d.ts","sourceRoot":"","sources":["../../src/engine/auto-fix.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAM5E;AAmBD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,GAAG,IAAI,CAiCf"}

package/dist/engine/auto-fix.js

@@ -0,0 +1,68 @@
+/**
+ * Auto-Fix Level 1 — detect broken select paths and suggest alternatives.
+ *
+ * When a select step fails with selector_miss, this module analyzes the
+ * actual data structure to find array fields that might be the correct path.
+ */
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Analyze data structure and suggest alternative select paths.
+ * Finds all array-valued paths in the object tree (max depth 5).
+ */
+export function suggestSelectFix(data, failedPath) {
+    if (!data || typeof data !== "object")
+        return [];
+    const paths = [];
+    findArrayPaths(data, "", paths, 0);
+    return paths.filter((p) => p !== failedPath);
+}
+function findArrayPaths(obj, prefix, paths, depth) {
+    if (depth > 5)
+        return;
+    for (const [key, value] of Object.entries(obj)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        if (Array.isArray(value)) {
+            paths.push(path);
+        }
+        else if (value && typeof value === "object" && !Array.isArray(value)) {
+            findArrayPaths(value, path, paths, depth + 1);
+        }
+    }
+}
+/**
+ * Apply a select path fix to a user adapter YAML file.
+ * Writes to ~/.unicli/adapters/<site>/<cmd>.yaml (user override dir).
+ */
+export function applySelectFix(site, command, _stepIndex, oldPath, newPath, adapterPath) {
+    try {
+        // Validate site/command names
+        if (!/^[a-zA-Z0-9._-]+$/.test(site))
+            return null;
+        if (!/^[a-zA-Z0-9._-]+$/.test(command))
+            return null;
+        let content;
+        if (adapterPath) {
+            try {
+                content = readFileSync(adapterPath, "utf-8");
+            }
+            catch {
+                // Can't read source adapter
+            }
+        }
+        // Write fix to user adapter dir
+        const userDir = join(process.env.HOME ?? "~", ".unicli", "adapters", site);
+        mkdirSync(userDir, { recursive: true });
+        const userPath = join(userDir, `${command}.yaml`);
+        if (content) {
+            // Simple string replacement of the select path
+            const fixed = content.replace(new RegExp(`(select:\\s*)(['"]?)${oldPath.replace(/\./g, "\\.")}\\2`), `$1$2${newPath}$2`);
+            writeFileSync(userPath, fixed, "utf-8");
+        }
+        return userPath;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=auto-fix.js.map

package/dist/engine/auto-fix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-fix.js","sourceRoot":"","sources":["../../src/engine/auto-fix.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa,EAAE,UAAkB;IAChE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,cAAc,CAAC,IAA+B,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,cAAc,CACrB,GAA4B,EAC5B,MAAc,EACd,KAAe,EACf,KAAa;IAEb,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO;IACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;aAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvE,cAAc,CAAC,KAAgC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAAe,EACf,UAAkB,EAClB,OAAe,EACf,OAAe,EACf,WAAoB;IAEpB,IAAI,CAAC;QACH,8BAA8B;QAC9B,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACjD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpD,IAAI,OAA2B,CAAC;QAChC,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QAC3E,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;QAElD,IAAI,OAAO,EAAE,CAAC;YACZ,+CAA+C;YAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAC3B,IAAI,MAAM,CAAC,uBAAuB,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EACrE,OAAO,OAAO,IAAI,CACnB,CAAC;YACF,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/engine/cascade.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Strategy cascade — auto-probe authentication strategies.
+ *
+ * Tries strategies in order: PUBLIC -> COOKIE -> HEADER
+ * INTERCEPT and UI require explicit site configuration.
+ *
+ * Probe mechanism: make a test fetch with each strategy,
+ * first valid (non-error, non-empty) response wins.
+ */
+/**
+ * Run the cascade probe for a site.
+ *
+ * @param site - Site name (for cookie lookup)
+ * @param probeUrl - URL to test against
+ * @returns The best strategy and confidence, or null if all fail
+ */
+export declare function cascadeProbe(site: string, probeUrl: string): Promise<{
+    strategy: string;
+    confidence: number;
+} | null>;
+/**
+ * Get the resolved strategy for a site (from cache or explicit).
+ * Falls back to the adapter's declared strategy if no probe URL available.
+ */
+export declare function getStrategy(site: string, declared?: string): string;
+/**
+ * Clear the strategy cache (useful for testing).
+ */
+export declare function clearCascadeCache(): void;
+//# sourceMappingURL=cascade.d.ts.map

package/dist/engine/cascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade.d.ts","sourceRoot":"","sources":["../../src/engine/cascade.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmHH;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAkB1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAInE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/engine/cascade.js

@@ -0,0 +1,138 @@
+/**
+ * Strategy cascade — auto-probe authentication strategies.
+ *
+ * Tries strategies in order: PUBLIC -> COOKIE -> HEADER
+ * INTERCEPT and UI require explicit site configuration.
+ *
+ * Probe mechanism: make a test fetch with each strategy,
+ * first valid (non-error, non-empty) response wins.
+ */
+import { loadCookies, formatCookieHeader } from "./cookies.js";
+import { USER_AGENT } from "../constants.js";
+/** Strategy probe order — auto-probeable strategies only */
+const CASCADE_ORDER = ["public", "cookie", "header"];
+/** Cache of resolved strategies per site */
+const strategyCache = new Map();
+/**
+ * Build headers for a given strategy.
+ */
+function buildHeaders(strategy, site) {
+    const headers = {
+        "User-Agent": USER_AGENT,
+        Accept: "application/json",
+    };
+    if (strategy === "public") {
+        return headers;
+    }
+    if (strategy === "cookie" || strategy === "header") {
+        const cookies = loadCookies(site);
+        if (cookies) {
+            headers["Cookie"] = formatCookieHeader(cookies);
+        }
+    }
+    if (strategy === "header") {
+        // Extract CSRF token from cookies — common patterns
+        const cookies = loadCookies(site);
+        if (cookies) {
+            const csrfKeys = [
+                "ct0",
+                "csrf_token",
+                "_csrf",
+                "x-csrf-token",
+                "bili_jct",
+            ];
+            for (const key of csrfKeys) {
+                if (cookies[key]) {
+                    headers["X-Csrf-Token"] = cookies[key];
+                    break;
+                }
+            }
+        }
+    }
+    return headers;
+}
+/**
+ * Probe a single strategy against a URL.
+ */
+async function probeStrategy(url, strategy, site) {
+    const confidence = 1.0 -
+        CASCADE_ORDER.indexOf(strategy) * 0.1;
+    try {
+        const headers = buildHeaders(strategy, site);
+        const resp = await fetch(url, {
+            headers,
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!resp.ok) {
+            return { strategy, confidence, success: false };
+        }
+        const text = await resp.text();
+        if (!text || text.length < 10) {
+            return { strategy, confidence, success: false };
+        }
+        // Try to parse as JSON and check for API error codes
+        try {
+            const json = JSON.parse(text);
+            // Chinese API pattern: code !== 0 means error
+            if (typeof json.code === "number" && json.code !== 0) {
+                return { strategy, confidence, success: false };
+            }
+            // Empty data check
+            if (json.data === null || json.data === undefined) {
+                return { strategy, confidence, success: false };
+            }
+            if (Array.isArray(json.data) && json.data.length === 0) {
+                return { strategy, confidence, success: false };
+            }
+        }
+        catch {
+            // Not JSON — might be HTML or text, still counts as success
+        }
+        return { strategy, confidence, success: true };
+    }
+    catch {
+        return { strategy, confidence, success: false };
+    }
+}
+/**
+ * Run the cascade probe for a site.
+ *
+ * @param site - Site name (for cookie lookup)
+ * @param probeUrl - URL to test against
+ * @returns The best strategy and confidence, or null if all fail
+ */
+export async function cascadeProbe(site, probeUrl) {
+    // Check cache first
+    const cached = strategyCache.get(site);
+    if (cached)
+        return cached;
+    for (const strategy of CASCADE_ORDER) {
+        const result = await probeStrategy(probeUrl, strategy, site);
+        if (result.success) {
+            const resolved = {
+                strategy: result.strategy,
+                confidence: result.confidence,
+            };
+            strategyCache.set(site, resolved);
+            return resolved;
+        }
+    }
+    return null;
+}
+/**
+ * Get the resolved strategy for a site (from cache or explicit).
+ * Falls back to the adapter's declared strategy if no probe URL available.
+ */
+export function getStrategy(site, declared) {
+    const cached = strategyCache.get(site);
+    if (cached)
+        return cached.strategy;
+    return declared ?? "public";
+}
+/**
+ * Clear the strategy cache (useful for testing).
+ */
+export function clearCascadeCache() {
+    strategyCache.clear();
+}
+//# sourceMappingURL=cascade.js.map

package/dist/engine/cascade.js.map

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

package/dist/engine/community-fix.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Community Fix Level 3 — query the adapter registry for updates.
+ *
+ * When an adapter fails and auto-fix can't resolve it, this module
+ * checks if a newer version exists in the community registry.
+ *
+ * Registry: https://registry.unicli.dev/api/adapters/<site>/<cmd>/latest
+ * Status: STUB — returns null until registry is deployed.
+ */
+interface RegistryEntry {
+    site: string;
+    command: string;
+    version: number;
+    hash: string;
+    yaml: string;
+    updated: string;
+}
+/**
+ * Query the community registry for a newer adapter version.
+ * Returns the YAML content if a newer version exists, null otherwise.
+ */
+export declare function fetchCommunityFix(site: string, command: string, _currentHash?: string): Promise<string | null>;
+/**
+ * Check if the community registry is reachable.
+ */
+export declare function isRegistryAvailable(): Promise<boolean>;
+export type { RegistryEntry };
+//# sourceMappingURL=community-fix.d.ts.map