@alphafox/cli 0.3.3 → 0.3.5

package/dist/install/wizard.js

@@ -11,6 +11,8 @@ exports.resolveLocalSkillsDir = resolveLocalSkillsDir;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const version_1 = require("../version");
+const manager_1 = require("../skills/manager");
+const run_command_1 = require("../skills/run-command");
 const exec_1 = require("./exec");
 const package_root_1 = require("./package-root");
 const types_1 = require("./types");
@@ -49,8 +51,7 @@ function parseNpmListVersion(output) {
     return match?.[1] ?? null;
 }
 function skillsListHasAlphafox(output) {
-    const prefix = types_1.SKILLS_NAME_PREFIX.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    return new RegExp(`(^|\\s)${prefix}[\\w-]+`, "m").test(output);
+    return /(^|\s)alphafox(?:-[\w-]+)?(?=\s|$)/m.test(output);
 }
 function nextSteps(input) {
     const steps = ["请重启 AI 工具，以便加载刚安装的 Skills。"];
@@ -64,7 +65,7 @@ function nextSteps(input) {
     return steps;
 }
 async function runInstallWizard(flags, env = process.env, runner = (0, exec_1.createDefaultInstallRunner)(env, defaultSearchDirs())) {
-    runner.log("正在安装 Alphafox CLI…");
+    runner.log("正在安装 AlphaFox CLI…");
     const installedVer = await readGloballyInstalledVersion(runner);
     const latestVer = await readLatestVersion(runner);
     const needsUpgrade = Boolean(installedVer) &&
@@ -181,72 +182,108 @@ async function stepInstallCli(flags, runner, versions) {
         latestVersion: latestVer ?? undefined,
     };
 }
-async function resolveSkillsSources(runner) {
+async function resolveSkillsSource(runner) {
     const override = runner.env.ALPHAFOX_SKILLS_SOURCE?.trim();
-    if (override)
-        return [override];
-    const sources = [];
+    if (override) {
+        if ((0, package_root_1.packageHasSkills)(override))
+            return override;
+        throw new types_1.InstallError({
+            type: "install",
+            subtype: "skills_source_invalid",
+            message: "ALPHAFOX_SKILLS_SOURCE must point to a local @alphafox/cli package with bundled Skills.",
+            details: override,
+        });
+    }
     const npmRoot = await npmRootGlobal(runner);
     if (npmRoot) {
         const globalRoot = (0, package_root_1.globalPackageRoot)(npmRoot);
         if ((0, package_root_1.packageHasSkills)(globalRoot))
-            sources.push(globalRoot);
+            return globalRoot;
     }
     const localRoot = (0, package_root_1.findAlphafoxPackageRoot)(runner.packageSearchDirs());
-    if (localRoot && !sources.includes(localRoot) && (0, package_root_1.packageHasSkills)(localRoot)) {
-        sources.push(localRoot);
-    }
-    sources.push(types_1.SKILLS_GITHUB_SOURCE);
-    return sources;
-}
-async function skillsAlreadyInstalled(runner) {
-    try {
-        const { stdout, stderr } = await runner.exec("npx", ["-y", "skills", "ls", "-g"], { timeoutMs: SKILLS_TIMEOUT_MS });
-        return skillsListHasAlphafox(`${stdout}\n${stderr}`);
-    }
-    catch {
-        return false;
+    if (localRoot && (0, package_root_1.packageHasSkills)(localRoot)) {
+        return localRoot;
     }
+    throw new types_1.InstallError({
+        type: "install",
+        subtype: "skills_package_missing",
+        message: "Could not locate the verified Skills bundle inside @alphafox/cli.",
+        hint: `npm install -g ${version_1.CLI_PACKAGE}`,
+    });
 }
 async function stepInstallSkills(flags, runner) {
-    const sources = await resolveSkillsSources(runner);
-    const already = flags.dryRun ? false : await skillsAlreadyInstalled(runner);
-    if (already) {
-        runner.log("Skills 已安装，已跳过");
-        return {
-            action: "skipped",
-            source: sources[0],
-            scope: "global",
-            alreadyPresent: true,
-        };
-    }
-    if (flags.dryRun) {
-        runner.log(`将从 ${sources[0] ?? types_1.SKILLS_GITHUB_SOURCE} 安装 Skills`);
+    const source = await resolveSkillsSource(runner);
+    const manifest = (0, manager_1.loadAndVerifySkillsManifest)(source);
+    runner.log(flags.dryRun
+        ? `将同步 Skills ${manifest.packageVersion}（${source}）`
+        : `正在同步 AI Skills ${manifest.packageVersion}…`);
+    try {
+        const result = await (0, manager_1.syncSkills)({
+            manifest,
+            packageRoot: source,
+            installedRoot: (0, run_command_1.installedSkillsRoot)(runner.env),
+            statePath: (0, run_command_1.skillsStatePath)(runner.env),
+            dryRun: flags.dryRun,
+            force: false,
+        }, {
+            install: async (names) => {
+                await runner.exec("npx", [
+                    "-y",
+                    "skills",
+                    "add",
+                    source,
+                    "-y",
+                    "-g",
+                    "--skill",
+                    ...names,
+                ], { timeoutMs: SKILLS_TIMEOUT_MS });
+            },
+            remove: async (names) => {
+                await runner.exec("npx", ["-y", "skills", "remove", ...names, "-y", "-g"], { timeoutMs: SKILLS_TIMEOUT_MS });
+            },
+        });
+        const action = result.blocked.length > 0
+            ? "blocked"
+            : result.action === "planned"
+                ? "planned"
+                : result.action === "skipped"
+                    ? "skipped"
+                    : result.backupDir
+                        ? "updated"
+                        : "installed";
+        runner.log(action === "skipped"
+            ? "Skills 已是当前版本，已跳过"
+            : action === "blocked"
+                ? `检测到本地修改，未覆盖：${result.blocked.join(", ")}`
+                : flags.dryRun
+                    ? `将同步 ${result.updated.length} 个 Skills`
+                    : `Skills 已同步（${source}）`);
         return {
-            action: "planned",
-            source: sources[0] ?? types_1.SKILLS_GITHUB_SOURCE,
+            action,
+            source,
             scope: "global",
+            alreadyPresent: result.status.summary.current > 0,
+            version: manifest.packageVersion,
+            updated: result.updated,
+            removed: result.removed,
+            blocked: result.blocked,
+            backupDir: result.backupDir,
+            restartRequired: result.restartRequired,
         };
     }
-    runner.log("正在安装 AI Skills…");
-    let lastError;
-    for (const source of sources) {
-        try {
-            await runner.exec("npx", ["-y", "skills", "add", source, "-y", "-g"], { timeoutMs: SKILLS_TIMEOUT_MS });
-            runner.log(`Skills 已安装（${source}）`);
-            return { action: "installed", source, scope: "global" };
-        }
-        catch (err) {
-            lastError = err;
-        }
+    catch (err) {
+        if (err instanceof types_1.InstallError)
+            throw err;
+        throw new types_1.InstallError({
+            type: "install",
+            subtype: err && typeof err === "object" && "subtype" in err
+                ? String(err.subtype)
+                : "skills_sync_failed",
+            message: "同步 Agent Skills 失败。",
+            hint: `alphafox skills sync --format json --no-input`,
+            details: err instanceof Error ? err.message : String(err),
+        });
     }
-    throw new types_1.InstallError({
-        type: "install",
-        subtype: "skills_add_failed",
-        message: "安装 Agent Skills 失败。",
-        hint: `npx skills add ${types_1.SKILLS_GITHUB_SOURCE} -y -g`,
-        details: lastError instanceof Error ? lastError.message : String(lastError),
-    });
 }
 async function resolveAlphafoxBin(runner) {
     const prefix = await npmPrefixGlobal(runner);
@@ -317,7 +354,7 @@ function installHelpData() {
             "alphafox install --no-auth",
             "alphafox install --dry-run",
         ],
-        description: "全局安装 @alphafox/cli，并通过 npx skills add 把同版本 Agent Skills 写入本机已检测到的 Agent（Cursor、Claude Code、Codex 等）的用户级目录。",
+        description: "全局安装 @alphafox/cli，校验包内 Skills manifest，并把同版本 Agent Skills 同步到本机已检测到的 Agent（Cursor、Claude Code、Codex 等）的用户级目录。",
         agentGuide: types_1.AGENT_INSTALL_GUIDE_BLOB_URL,
     };
 }

package/dist/keychain/windows-credential.d.ts

@@ -4,7 +4,7 @@
  */
 /** CRED_MAX_CREDENTIAL_BLOB_SIZE is 5*512 = 2560. */
 export declare const WINDOWS_CRED_MAX_BYTES = 2560;
-export declare const WINDOWS_CRED_PS1 = "# Alphafox CLI \u2014 Windows Credential Manager helper (t101360)\nparam(\n  [Parameter(Mandatory = $true)][ValidateSet('write','read','delete')][string]$Action,\n  [Parameter(Mandatory = $true)][string]$Target\n)\n$ErrorActionPreference = 'Stop'\nAdd-Type -TypeDefinition @\"\nusing System;\nusing System.Runtime.InteropServices;\nnamespace AlphafoxCred {\n  [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]\n  public struct CREDENTIAL {\n    public uint Flags;\n    public uint Type;\n    public string TargetName;\n    public string Comment;\n    public System.Runtime.InteropServices.ComTypes.FILETIME LastWritten;\n    public uint CredentialBlobSize;\n    public IntPtr CredentialBlob;\n    public uint Persist;\n    public uint AttributeCount;\n    public IntPtr Attributes;\n    public string TargetAlias;\n    public string UserName;\n  }\n  public static class Native {\n    [DllImport(\"advapi32.dll\", CharSet = CharSet.Unicode, SetLastError = true)]\n    public static extern bool CredWrite(ref CREDENTIAL credential, uint flags);\n    [DllImport(\"advapi32.dll\", CharSet = CharSet.Unicode, SetLastError = true)]\n    public static extern bool CredRead(string target, uint type, uint flags, out IntPtr credentialPtr);\n    [DllImport(\"advapi32.dll\", CharSet = CharSet.Unicode, SetLastError = true)]\n    public static extern bool CredDelete(string target, uint type, uint flags);\n    [DllImport(\"advapi32.dll\", SetLastError = true)]\n    public static extern void CredFree(IntPtr credential);\n  }\n}\n\"@\n$CredTypeGeneric = 1\n$PersistLocalMachine = 2\nswitch ($Action) {\n  'write' {\n    $payload = [Console]::In.ReadToEnd()\n    $bytes = [Text.Encoding]::UTF8.GetBytes($payload)\n    if ($bytes.Length -gt 2560) { throw \"credential blob too large\" }\n    $blob = [Runtime.InteropServices.Marshal]::AllocHGlobal($bytes.Length)\n    try {\n      [Runtime.InteropServices.Marshal]::Copy($bytes, 0, $blob, $bytes.Length)\n      $cred = New-Object AlphafoxCred.CREDENTIAL\n      $cred.Type = $CredTypeGeneric\n      $cred.TargetName = $Target\n      $cred.UserName = \"alphafox-cli\"\n      $cred.CredentialBlobSize = [uint32]$bytes.Length\n      $cred.CredentialBlob = $blob\n      $cred.Persist = $PersistLocalMachine\n      $ok = [AlphafoxCred.Native]::CredWrite([ref]$cred, 0)\n      if (-not $ok) {\n        throw \"CredWrite failed Win32=$([Runtime.InteropServices.Marshal]::GetLastWin32Error())\"\n      }\n    } finally {\n      [Runtime.InteropServices.Marshal]::FreeHGlobal($blob)\n    }\n  }\n  'read' {\n    $ptr = [IntPtr]::Zero\n    $ok = [AlphafoxCred.Native]::CredRead($Target, $CredTypeGeneric, 0, [ref]$ptr)\n    if (-not $ok) { exit 2 }\n    try {\n      $cred = [Runtime.InteropServices.Marshal]::PtrToStructure($ptr, [type][AlphafoxCred.CREDENTIAL])\n      $size = [int]$cred.CredentialBlobSize\n      $bytes = New-Object byte[] $size\n      [Runtime.InteropServices.Marshal]::Copy($cred.CredentialBlob, $bytes, 0, $size)\n      [Console]::Out.Write([Text.Encoding]::UTF8.GetString($bytes))\n    } finally {\n      [AlphafoxCred.Native]::CredFree($ptr)\n    }\n  }\n  'delete' {\n    [void][AlphafoxCred.Native]::CredDelete($Target, $CredTypeGeneric, 0)\n  }\n}\n";
+export declare const WINDOWS_CRED_PS1 = "# AlphaFox CLI \u2014 Windows Credential Manager helper (t101360)\nparam(\n  [Parameter(Mandatory = $true)][ValidateSet('write','read','delete')][string]$Action,\n  [Parameter(Mandatory = $true)][string]$Target\n)\n$ErrorActionPreference = 'Stop'\nAdd-Type -TypeDefinition @\"\nusing System;\nusing System.Runtime.InteropServices;\nnamespace AlphafoxCred {\n  [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]\n  public struct CREDENTIAL {\n    public uint Flags;\n    public uint Type;\n    public string TargetName;\n    public string Comment;\n    public System.Runtime.InteropServices.ComTypes.FILETIME LastWritten;\n    public uint CredentialBlobSize;\n    public IntPtr CredentialBlob;\n    public uint Persist;\n    public uint AttributeCount;\n    public IntPtr Attributes;\n    public string TargetAlias;\n    public string UserName;\n  }\n  public static class Native {\n    [DllImport(\"advapi32.dll\", CharSet = CharSet.Unicode, SetLastError = true)]\n    public static extern bool CredWrite(ref CREDENTIAL credential, uint flags);\n    [DllImport(\"advapi32.dll\", CharSet = CharSet.Unicode, SetLastError = true)]\n    public static extern bool CredRead(string target, uint type, uint flags, out IntPtr credentialPtr);\n    [DllImport(\"advapi32.dll\", CharSet = CharSet.Unicode, SetLastError = true)]\n    public static extern bool CredDelete(string target, uint type, uint flags);\n    [DllImport(\"advapi32.dll\", SetLastError = true)]\n    public static extern void CredFree(IntPtr credential);\n  }\n}\n\"@\n$CredTypeGeneric = 1\n$PersistLocalMachine = 2\nswitch ($Action) {\n  'write' {\n    $payload = [Console]::In.ReadToEnd()\n    $bytes = [Text.Encoding]::UTF8.GetBytes($payload)\n    if ($bytes.Length -gt 2560) { throw \"credential blob too large\" }\n    $blob = [Runtime.InteropServices.Marshal]::AllocHGlobal($bytes.Length)\n    try {\n      [Runtime.InteropServices.Marshal]::Copy($bytes, 0, $blob, $bytes.Length)\n      $cred = New-Object AlphafoxCred.CREDENTIAL\n      $cred.Type = $CredTypeGeneric\n      $cred.TargetName = $Target\n      $cred.UserName = \"alphafox-cli\"\n      $cred.CredentialBlobSize = [uint32]$bytes.Length\n      $cred.CredentialBlob = $blob\n      $cred.Persist = $PersistLocalMachine\n      $ok = [AlphafoxCred.Native]::CredWrite([ref]$cred, 0)\n      if (-not $ok) {\n        throw \"CredWrite failed Win32=$([Runtime.InteropServices.Marshal]::GetLastWin32Error())\"\n      }\n    } finally {\n      [Runtime.InteropServices.Marshal]::FreeHGlobal($blob)\n    }\n  }\n  'read' {\n    $ptr = [IntPtr]::Zero\n    $ok = [AlphafoxCred.Native]::CredRead($Target, $CredTypeGeneric, 0, [ref]$ptr)\n    if (-not $ok) { exit 2 }\n    try {\n      $cred = [Runtime.InteropServices.Marshal]::PtrToStructure($ptr, [type][AlphafoxCred.CREDENTIAL])\n      $size = [int]$cred.CredentialBlobSize\n      $bytes = New-Object byte[] $size\n      [Runtime.InteropServices.Marshal]::Copy($cred.CredentialBlob, $bytes, 0, $size)\n      [Console]::Out.Write([Text.Encoding]::UTF8.GetString($bytes))\n    } finally {\n      [AlphafoxCred.Native]::CredFree($ptr)\n    }\n  }\n  'delete' {\n    [void][AlphafoxCred.Native]::CredDelete($Target, $CredTypeGeneric, 0)\n  }\n}\n";
 export declare function windowsCredentialTarget(profile: string): string;
 export declare function windowsPowershellBin(env?: NodeJS.ProcessEnv): string;
 export declare function windowsCredentialWrite(profile: string, payload: string, env?: NodeJS.ProcessEnv): boolean;

package/dist/keychain/windows-credential.js

@@ -17,7 +17,7 @@ const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
 /** CRED_MAX_CREDENTIAL_BLOB_SIZE is 5*512 = 2560. */
 exports.WINDOWS_CRED_MAX_BYTES = 2560;
-exports.WINDOWS_CRED_PS1 = `# Alphafox CLI — Windows Credential Manager helper (t101360)
+exports.WINDOWS_CRED_PS1 = `# AlphaFox CLI — Windows Credential Manager helper (t101360)
 param(
   [Parameter(Mandatory = $true)][ValidateSet('write','read','delete')][string]$Action,
   [Parameter(Mandatory = $true)][string]$Target

package/dist/resolve-symbols/catalog.d.ts

@@ -0,0 +1,3 @@
+export declare const MARKET_SYMBOLS_PATH = "/api/v1/market/symbols";
+export declare function marketSymbolsPath(exchangeId: string): string;
+export declare function extractCatalogSymbols(json: unknown): string[];

package/dist/resolve-symbols/catalog.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MARKET_SYMBOLS_PATH = void 0;
+exports.marketSymbolsPath = marketSymbolsPath;
+exports.extractCatalogSymbols = extractCatalogSymbols;
+const errors_1 = require("./errors");
+exports.MARKET_SYMBOLS_PATH = "/api/v1/market/symbols";
+function marketSymbolsPath(exchangeId) {
+    const query = new URLSearchParams({ exchange: exchangeId }).toString();
+    return `${exports.MARKET_SYMBOLS_PATH}?${query}`;
+}
+function extractCatalogSymbols(json) {
+    const root = asRecord(json);
+    const payload = asRecord(root?.data) ?? root;
+    const symbols = payload?.symbols;
+    if (!Array.isArray(symbols)) {
+        throw new errors_1.ResolveSymbolsError({
+            type: "runtime",
+            subtype: "catalog_invalid",
+            message: "market.symbols.list response did not include a symbols array",
+            details: json,
+        });
+    }
+    const out = [];
+    const seen = new Set();
+    for (const item of symbols) {
+        if (typeof item !== "string")
+            continue;
+        const trimmed = item.trim();
+        if (!trimmed || seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        out.push(trimmed);
+    }
+    if (out.length === 0) {
+        throw new errors_1.ResolveSymbolsError({
+            type: "runtime",
+            subtype: "catalog_empty",
+            message: "market.symbols.list returned no contract symbols",
+            details: json,
+        });
+    }
+    return out;
+}
+function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    return value;
+}

package/dist/resolve-symbols/errors.d.ts

@@ -0,0 +1,18 @@
+export declare class ResolveSymbolsError extends Error {
+    readonly type: string;
+    readonly subtype?: string;
+    readonly status?: number;
+    readonly code?: string | number;
+    readonly hint?: string;
+    readonly details?: unknown;
+    constructor(input: {
+        readonly message: string;
+        readonly type?: string;
+        readonly subtype?: string;
+        readonly status?: number;
+        readonly code?: string | number;
+        readonly hint?: string;
+        readonly details?: unknown;
+    });
+}
+export declare function isResolveSymbolsError(value: unknown): value is ResolveSymbolsError;

package/dist/resolve-symbols/errors.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResolveSymbolsError = void 0;
+exports.isResolveSymbolsError = isResolveSymbolsError;
+class ResolveSymbolsError extends Error {
+    type;
+    subtype;
+    status;
+    code;
+    hint;
+    details;
+    constructor(input) {
+        super(input.message);
+        this.name = "ResolveSymbolsError";
+        this.type = input.type ?? "runtime";
+        this.subtype = input.subtype;
+        this.status = input.status;
+        this.code = input.code;
+        this.hint = input.hint;
+        this.details = input.details;
+    }
+}
+exports.ResolveSymbolsError = ResolveSymbolsError;
+function isResolveSymbolsError(value) {
+    return value instanceof ResolveSymbolsError;
+}

package/dist/resolve-symbols/exchanges.d.ts

@@ -0,0 +1,8 @@
+export declare const RESOLVE_SYMBOLS_DEFAULT_EXCHANGE = "binance_perp_usdt";
+export interface ResolveSymbolsExchange {
+    readonly id: string;
+    readonly label: string;
+    readonly aliases: readonly string[];
+}
+export declare const RESOLVE_SYMBOLS_EXCHANGES: readonly ResolveSymbolsExchange[];
+export declare function resolveSymbolsExchangeId(raw: string): ResolveSymbolsExchange;

package/dist/resolve-symbols/exchanges.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESOLVE_SYMBOLS_EXCHANGES = exports.RESOLVE_SYMBOLS_DEFAULT_EXCHANGE = void 0;
+exports.resolveSymbolsExchangeId = resolveSymbolsExchangeId;
+exports.RESOLVE_SYMBOLS_DEFAULT_EXCHANGE = "binance_perp_usdt";
+exports.RESOLVE_SYMBOLS_EXCHANGES = [
+    {
+        id: "binance_perp_usdt",
+        label: "Binance",
+        aliases: ["binance", "binanceusdm", "binance_perp_usdt"],
+    },
+    {
+        id: "okx_perp_usdt",
+        label: "OKX",
+        aliases: ["okx", "okx_perp_usdt"],
+    },
+    {
+        id: "bybit_perp_usdt",
+        label: "Bybit",
+        aliases: ["bybit", "bybit_perp_usdt"],
+    },
+    {
+        id: "bitget_perp_usdt",
+        label: "Bitget",
+        aliases: ["bitget", "bitget_perp_usdt"],
+    },
+    {
+        id: "hyperliquid_perp_usdc",
+        label: "HyperLiquid",
+        aliases: ["hyperliquid", "hyperliquid_perp_usdc"],
+    },
+    {
+        id: "aster_perp_usdt",
+        label: "Aster",
+        aliases: ["aster", "aster_perp_usdt"],
+    },
+];
+const EXCHANGE_BY_ALIAS = new Map();
+for (const exchange of exports.RESOLVE_SYMBOLS_EXCHANGES) {
+    EXCHANGE_BY_ALIAS.set(exchange.id, exchange);
+    for (const alias of exchange.aliases) {
+        EXCHANGE_BY_ALIAS.set(alias.toLowerCase(), exchange);
+    }
+}
+function resolveSymbolsExchangeId(raw) {
+    const key = raw.trim().toLowerCase();
+    const exchange = EXCHANGE_BY_ALIAS.get(key);
+    if (!exchange) {
+        const allowed = exports.RESOLVE_SYMBOLS_EXCHANGES.map((item) => item.aliases[0]).join("|");
+        throw new Error(`--exchange must be ${allowed} (got ${raw.trim() || "<empty>"})`);
+    }
+    return exchange;
+}

package/dist/resolve-symbols/match.d.ts

@@ -0,0 +1,6 @@
+import type { CatalogSymbol, ResolveSymbolsQueryResult } from "./types";
+export declare function normalizeSymbolSearchKey(value: string): string;
+export declare function parseCatalogSymbol(symbol: string): CatalogSymbol | null;
+export declare function indexCatalogSymbols(symbols: readonly string[]): readonly CatalogSymbol[];
+export declare function resolveQueryAgainstCatalog(query: string, catalog: readonly CatalogSymbol[], limit?: number): ResolveSymbolsQueryResult;
+export declare function levenshtein(left: string, right: string): number;

package/dist/resolve-symbols/match.js

@@ -0,0 +1,250 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeSymbolSearchKey = normalizeSymbolSearchKey;
+exports.parseCatalogSymbol = parseCatalogSymbol;
+exports.indexCatalogSymbols = indexCatalogSymbols;
+exports.resolveQueryAgainstCatalog = resolveQueryAgainstCatalog;
+exports.levenshtein = levenshtein;
+const LINEAR_PERP_PATTERN = /^([\p{L}\p{N}]+(?:-[\p{L}\p{N}]+)*)\/(USDT|USDC|USD):\2$/u;
+const QUOTE_ASSETS = ["USDT", "USDC", "BUSD", "USD"];
+const EXACT_REASONS = new Set([
+    "exact_canonical",
+    "exact_compact",
+    "exact_pair",
+    "exact_base",
+]);
+function normalizeSymbolSearchKey(value) {
+    return value
+        .trim()
+        .toUpperCase()
+        .replace(/[^\p{L}\p{N}]/gu, "");
+}
+function parseCatalogSymbol(symbol) {
+    const trimmed = symbol.trim();
+    if (!trimmed)
+        return null;
+    const upper = trimmed.toUpperCase();
+    const linear = LINEAR_PERP_PATTERN.exec(upper);
+    if (linear) {
+        const base = linear[1];
+        const quote = linear[2];
+        const canonical = `${base}/${quote}:${quote}`;
+        const compact = `${base}${quote}`;
+        return {
+            symbol: canonical,
+            base,
+            quote,
+            pair: `${base}/${quote}`,
+            compact,
+            searchKey: normalizeSymbolSearchKey(canonical),
+            baseKey: normalizeSymbolSearchKey(base),
+            compactKey: normalizeSymbolSearchKey(compact),
+        };
+    }
+    const slash = upper.indexOf("/");
+    const colon = upper.lastIndexOf(":");
+    if (slash > 0) {
+        const base = upper.slice(0, slash);
+        const quote = colon > slash ? upper.slice(slash + 1, colon) : upper.slice(slash + 1);
+        const compact = `${base}${quote}`;
+        return {
+            symbol: upper,
+            base,
+            quote,
+            pair: `${base}/${quote}`,
+            compact,
+            searchKey: normalizeSymbolSearchKey(upper),
+            baseKey: normalizeSymbolSearchKey(base),
+            compactKey: normalizeSymbolSearchKey(compact),
+        };
+    }
+    return {
+        symbol: upper,
+        base: upper,
+        quote: "",
+        pair: upper,
+        compact: upper,
+        searchKey: normalizeSymbolSearchKey(upper),
+        baseKey: normalizeSymbolSearchKey(upper),
+        compactKey: normalizeSymbolSearchKey(upper),
+    };
+}
+function indexCatalogSymbols(symbols) {
+    const seen = new Set();
+    const indexed = [];
+    for (const raw of symbols) {
+        const parsed = parseCatalogSymbol(raw);
+        if (!parsed)
+            continue;
+        if (seen.has(parsed.symbol))
+            continue;
+        seen.add(parsed.symbol);
+        indexed.push(parsed);
+    }
+    return indexed;
+}
+function resolveQueryAgainstCatalog(query, catalog, limit = 8) {
+    const trimmed = query.trim();
+    const matches = rankMatches(trimmed, catalog);
+    const exact = matches.filter((item) => EXACT_REASONS.has(item.reason));
+    const close = matches.filter((item) => !EXACT_REASONS.has(item.reason));
+    const capped = (items) => items.slice(0, Math.max(1, limit));
+    if (exact.length === 1) {
+        return {
+            query: trimmed,
+            status: "exact",
+            resolved: exact[0].symbol,
+            needsConfirmation: false,
+            matches: exact,
+            matchCount: exact.length,
+        };
+    }
+    if (exact.length > 1) {
+        return {
+            query: trimmed,
+            status: "ambiguous",
+            resolved: null,
+            needsConfirmation: true,
+            matches: capped(exact),
+            matchCount: exact.length,
+        };
+    }
+    if (close.length === 1) {
+        return {
+            query: trimmed,
+            status: "close",
+            resolved: close[0].symbol,
+            needsConfirmation: true,
+            matches: close,
+            matchCount: 1,
+        };
+    }
+    if (close.length > 1) {
+        return {
+            query: trimmed,
+            status: "ambiguous",
+            resolved: null,
+            needsConfirmation: true,
+            matches: capped(close),
+            matchCount: close.length,
+        };
+    }
+    return {
+        query: trimmed,
+        status: "none",
+        resolved: null,
+        needsConfirmation: false,
+        matches: [],
+        matchCount: 0,
+    };
+}
+function rankMatches(query, catalog) {
+    const canonicalQuery = query.trim().toUpperCase();
+    const queryKey = normalizeSymbolSearchKey(query);
+    if (!canonicalQuery || !queryKey)
+        return [];
+    if (isQuoteAssetKey(queryKey))
+        return [];
+    const queryBaseKey = queryBaseSearchKey(canonicalQuery, queryKey);
+    const scored = [];
+    for (const item of catalog) {
+        const ranked = rankCatalogSymbol(item, canonicalQuery, queryKey, queryBaseKey);
+        if (ranked)
+            scored.push(ranked);
+    }
+    scored.sort((left, right) => {
+        if (right.score !== left.score)
+            return right.score - left.score;
+        return left.symbol.localeCompare(right.symbol);
+    });
+    return scored;
+}
+function rankCatalogSymbol(item, canonicalQuery, queryKey, queryBaseKey) {
+    if (item.symbol === canonicalQuery) {
+        return match(item.symbol, "exact_canonical", 100);
+    }
+    if (item.pair === canonicalQuery) {
+        return match(item.symbol, "exact_pair", 96);
+    }
+    if (item.compactKey === queryKey || item.searchKey === queryKey) {
+        return match(item.symbol, "exact_compact", 98);
+    }
+    if (item.baseKey === queryKey || item.baseKey === queryBaseKey) {
+        return match(item.symbol, "exact_base", 95);
+    }
+    let best = null;
+    const consider = (reason, score) => {
+        if (!best || score > best.score) {
+            best = match(item.symbol, reason, score);
+        }
+    };
+    if (queryBaseKey.length >= 2 && item.baseKey.startsWith(queryBaseKey)) {
+        consider("prefix", clampScore(80 - (item.baseKey.length - queryBaseKey.length)));
+    }
+    if (queryBaseKey.length >= 3 && queryBaseKey.startsWith(item.baseKey)) {
+        consider("prefix", clampScore(74 - (queryBaseKey.length - item.baseKey.length)));
+    }
+    if (queryBaseKey.length >= 3 && item.baseKey.includes(queryBaseKey)) {
+        consider("contains", 55);
+    }
+    const distance = levenshtein(queryBaseKey, item.baseKey);
+    if (isCloseDistance(queryBaseKey, item.baseKey, distance)) {
+        consider("close", clampScore(48 - distance * 8));
+    }
+    return best;
+}
+function queryBaseSearchKey(canonicalQuery, queryKey) {
+    const linear = LINEAR_PERP_PATTERN.exec(canonicalQuery);
+    if (linear)
+        return normalizeSymbolSearchKey(linear[1]);
+    const slash = canonicalQuery.indexOf("/");
+    if (slash > 0) {
+        return normalizeSymbolSearchKey(canonicalQuery.slice(0, slash));
+    }
+    for (const quote of QUOTE_ASSETS) {
+        if (queryKey.length > quote.length && queryKey.endsWith(quote)) {
+            return queryKey.slice(0, -quote.length);
+        }
+    }
+    return queryKey;
+}
+function isQuoteAssetKey(queryKey) {
+    return QUOTE_ASSETS.includes(queryKey);
+}
+function isCloseDistance(left, right, distance) {
+    const shortest = Math.min(left.length, right.length);
+    if (shortest < 2 || distance <= 0)
+        return false;
+    if (shortest <= 4)
+        return distance === 1;
+    return distance <= 2;
+}
+function match(symbol, reason, score) {
+    return { symbol, reason, score };
+}
+function clampScore(score) {
+    return Math.max(1, Math.min(94, score));
+}
+function levenshtein(left, right) {
+    if (left === right)
+        return 0;
+    if (left.length === 0)
+        return right.length;
+    if (right.length === 0)
+        return left.length;
+    const prev = new Array(right.length + 1);
+    const next = new Array(right.length + 1);
+    for (let j = 0; j <= right.length; j += 1)
+        prev[j] = j;
+    for (let i = 1; i <= left.length; i += 1) {
+        next[0] = i;
+        const leftCh = left.charCodeAt(i - 1);
+        for (let j = 1; j <= right.length; j += 1) {
+            const cost = leftCh === right.charCodeAt(j - 1) ? 0 : 1;
+            next[j] = Math.min((prev[j] ?? 0) + 1, (next[j - 1] ?? 0) + 1, (prev[j - 1] ?? 0) + cost);
+        }
+        for (let j = 0; j <= right.length; j += 1)
+            prev[j] = next[j] ?? 0;
+    }
+    return prev[right.length] ?? Math.max(left.length, right.length);
+}

package/dist/resolve-symbols/parse-args.d.ts

@@ -0,0 +1,5 @@
+import type { ResolveSymbolsRunArgs } from "./types";
+export declare const RESOLVE_SYMBOLS_DEFAULT_LIMIT = 8;
+export declare const RESOLVE_SYMBOLS_MAX_LIMIT = 25;
+export declare const RESOLVE_SYMBOLS_USAGE: string[];
+export declare function parseResolveSymbolsArgs(args: readonly string[]): ResolveSymbolsRunArgs;