@danceiny/gotry 0.0.1-rc.21 → 0.0.1-rc.24

package/dist/capabilities/session/extension-channel.js

@@ -1,95 +1,76 @@
+/**
+ * 扩展车道客户端(RFC §2.2 通道 C,2026-08-29 PRIMARY;issue #21 传输层方案 B)。
+ *
+ * 三种 job 封装:search(被动嗅探 batchSearch)/ open-login(登录入口置前台)/
+ * cookie-names(票据 cookie **名字**,协议面不存在值字段)。verdict 映射纯函数
+ * `classifyBridgeFailure` 供回归覆盖:
+ *   - extension-not-connected → 'needs-extension'(waiting no-spend,一次性安装指引;
+ *     **不静默回退 CDP**——回退即重新引入逐连接权限框,正是本通道要消灭的摩擦);
+ *   - bridge-unavailable(端口池全占等环境故障)→ 'error'(非用户门)。
+ * 检索页无回包不是车道失败:与 CDP 车道同语义(到点无 hints 命中 ⇒ miss,页标题命挑战 ⇒ challenged)。
+ */
 import { getOrCreateSessionBridge, needsExtensionSummary } from './extension-bridge.js';
+/**
+ * needs-extension 用户门文案(D-24 自适应,issue #117):按本地通道是否落位自动跳过
+ * 开发者模式/本地通道指引——商店版用户只看到商店一键装与「已装即可」提示。
+ * 旧静态常量已退役:静态文案无法感知安装状态,正是 D-24 残量的病灶。
+ */
 export function needsExtensionHint() {
     return needsExtensionSummary();
 }
+/** 桥故障 → 用户门 verdict 纯函数(测试锚点):只有「扩展未连接」是用户门(waiting),其余降级 error */
 export function classifyBridgeFailure(kind) {
     return kind === 'extension-not-connected' ? 'needs-extension' : 'error';
 }
 function bridgeReady(b) {
     return b.ok === true;
 }
-export async function extensionCookieNames(q) {
-    const bridge = await getOrCreateSessionBridge();
-    if (!bridgeReady(bridge)) return {
-        ok: false,
-        kind: 'bridge-unavailable',
-        summary: bridge.summary
-    };
-    const outcome = await bridge.bridge.submit({
-        kind: 'cookie-names',
-        site: q.site,
-        timeoutMs: q.timeoutMs ?? 8_000
-    }, {
-        timeoutMs: q.timeoutMs ?? 8_000
-    });
-    if (!outcome.ok) return {
-        ok: false,
-        kind: outcome.reason,
-        summary: outcome.summary
-    };
-    const names = Array.isArray(outcome.result.names) ? outcome.result.names.filter((n)=>typeof n === 'string') : [];
-    return {
-        ok: true,
-        tickets: names
-    };
+/** 桥解析(2026-09-11):gotry-backend 服务形态注入进程内队列;桌面形态缺省走 loopback 懒单例 */
+async function resolveBridge(injected) {
+    if (injected)
+        return { ok: true, bridge: injected };
+    return getOrCreateSessionBridge();
 }
-export async function extensionOpenLogin(q) {
-    const bridge = await getOrCreateSessionBridge();
-    if (!bridgeReady(bridge)) return {
-        ok: false,
-        kind: 'bridge-unavailable',
-        summary: bridge.summary
-    };
-    const outcome = await bridge.bridge.submit({
-        kind: 'open-login',
-        site: q.site,
-        url: q.url
-    }, {
-        timeoutMs: q.timeoutMs ?? 15_000
-    });
-    if (!outcome.ok) return {
-        ok: false,
-        kind: outcome.reason,
-        summary: outcome.summary
-    };
-    if (!outcome.result.opened) return {
-        ok: false,
-        kind: 'job-error',
-        summary: outcome.result.error ?? '登录入口打开失败'
-    };
-    return {
-        ok: true,
-        opened: true
-    };
+/** cookie-names job:票据 cookie 名存在性(名字级;协议不含值) */
+export async function extensionCookieNames(q, bridgeHandle) {
+    const bridge = await resolveBridge(bridgeHandle);
+    if (!bridgeReady(bridge))
+        return { ok: false, kind: 'bridge-unavailable', summary: bridge.summary };
+    const outcome = await bridge.bridge.submit({ kind: 'cookie-names', site: q.site, timeoutMs: q.timeoutMs ?? 8_000 }, { timeoutMs: q.timeoutMs ?? 8_000 });
+    if (!outcome.ok)
+        return { ok: false, kind: outcome.reason, summary: outcome.summary };
+    const names = Array.isArray(outcome.result.names) ? outcome.result.names.filter((n) => typeof n === 'string') : [];
+    // 红线自证:隧道面只有名字(extension-tests §红线断言协议面无值字段)
+    return { ok: true, tickets: names };
 }
-export async function extensionSearchJob(q) {
-    const bridge = await getOrCreateSessionBridge();
-    if (!bridgeReady(bridge)) return {
-        ok: false,
-        kind: 'bridge-unavailable',
-        summary: bridge.summary
-    };
+/** 登录入口置前台打开(#34 纪律:标签留给用户,扩展侧不 close) */
+export async function extensionOpenLogin(q, bridgeHandle) {
+    const bridge = await resolveBridge(bridgeHandle);
+    if (!bridgeReady(bridge))
+        return { ok: false, kind: 'bridge-unavailable', summary: bridge.summary };
+    const outcome = await bridge.bridge.submit({ kind: 'open-login', site: q.site, url: q.url }, { timeoutMs: q.timeoutMs ?? 15_000 });
+    if (!outcome.ok)
+        return { ok: false, kind: outcome.reason, summary: outcome.summary };
+    if (!outcome.result.opened)
+        return { ok: false, kind: 'job-error', summary: outcome.result.error ?? '登录入口打开失败' };
+    return { ok: true, opened: true };
+}
+/** 检索 job:后台标签打开 entry,等 content hook 的嗅探回包;页无响应=timedOut(非车道失败) */
+export async function extensionSearchJob(q, bridgeHandle) {
+    const bridge = await resolveBridge(bridgeHandle);
+    if (!bridgeReady(bridge))
+        return { ok: false, kind: 'bridge-unavailable', summary: bridge.summary };
     const timeoutMs = q.timeoutMs ?? 30_000;
-    const outcome = await bridge.bridge.submit({
-        kind: 'search',
-        site: q.site,
-        url: q.url,
-        timeoutMs
-    }, {
-        timeoutMs: timeoutMs + 10_000
-    });
-    if (!outcome.ok) return {
-        ok: false,
-        kind: outcome.reason,
-        summary: outcome.summary
-    };
+    const outcome = await bridge.bridge.submit({ kind: 'search', site: q.site, url: q.url, timeoutMs, ...(q.multiCollect ? { multiCollect: true } : {}) }, { timeoutMs: timeoutMs + 10_000 });
+    if (!outcome.ok)
+        return { ok: false, kind: outcome.reason, summary: outcome.summary };
+    const bodies = outcome.result.bodies;
     return {
         ok: true,
         body: typeof outcome.result.body === 'string' ? outcome.result.body : '',
+        url: typeof outcome.result.url === 'string' ? outcome.result.url : '',
         title: typeof outcome.result.title === 'string' ? outcome.result.title : '',
-        timedOut: outcome.result.timeout === true
+        timedOut: outcome.result.timeout === true,
+        ...(bodies && typeof bodies === 'object' ? { bodies } : {}),
     };
 }
-
-
-//# sourceURL=ts/capabilities/session/extension-channel.ts

package/dist/capabilities/session/extension-distribution.js

@@ -1,35 +1,65 @@
+/**
+ * 扩展产物分发(issue #21 分发通道,ADR-21;founder 2026-08-30「产物下载和安装也得做成更好的
+ * 用户体验,可以用 github 作为分发渠道」)。
+ *
+ * 平台硬约束(诚实前置):Chrome 禁止普通用户从任意 URL 安装打包 CRX——GitHub 只能改善
+ * 「下载」(版本化/回滚/与 npm 发版节奏解耦),改善不了「安装」;「开发者模式加载已解压」
+ * 那 3 次点击只有上架 Chrome Web Store 才能消掉(商店版自动更新,见 extension-webstore-submission.md)。
+ * manifest 固定 key ⇒ 双通道是同一个扩展 ID(olpgkofjhhiiiahdkkbcninhjmegghfe),端口池/
+ * host_permissions 不随通道漂移——本模块用 key 钉住这一不变量。
+ *
+ * 单一职责:① 产物源解析(bundled 默认离线确定性 | github 显式 opt-in);
+ * ② GitHub Releases 下载链:dist-manifest → tar.gz → SHA256 校验 → tar 解压 → key 钉扎校验
+ *    → 版本比较 → 原子交换 ~/.gotry/extension;
+ * ③ 失败语义:github 源任何失败(无网/404/校验不过/key 漂移)→ 结构化 fallback bundled,
+ *    绝不挡 setup(安装外部产物永远不挡 gotry 本体——bootstrap 契约)。
+ *
+ * 信任边界(诚实声明):TLS 传输 + 同源 dist-manifest 哈希完整性——防截断/损坏/误传资产,
+ * 不防仓库本身被攻陷(无独立 pinning;独立 pin 需把哈希烘进 npm 包,与「扩展更新与 npm
+ * 发版解耦」目标冲突,明确不做)。
+ *
+ * 零新 npm 依赖:fetch 走 Node ≥22 全局;解压走平台原生 `tar -xzf`(macOS/Linux/Windows10+
+ * 自带);SHA256 走 node:crypto。spawn/fetch 可注入(离线测试)。
+ */
 import { spawn } from 'node:child_process';
 import { createHash } from 'node:crypto';
 import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
+/** Releases 稳定资产名(每版覆盖同名上传;latest/download 永久链只认稳定名)。
+ *  与 scripts/package-extension.mjs 的资产名必须逐字一致——extension-distribution-tests 防漂移。 */
 export const DIST_ASSET_TARBALL = 'gotry-session-bridge.tar.gz';
 export const DIST_ASSET_STORE_ZIP = 'gotry-session-bridge-store.zip';
 export const DIST_ASSET_MANIFEST = 'extension-dist-manifest.json';
 export const DEFAULT_RELEASE_BASE = 'https://github.com/Danceiny/gotry/releases';
+/** 纯函数:三段数字版本比较(a<b 负 / 相等 0 / a>b 正;非数字段按 0 处理,长度差补 0) */
 export function compareVersions(a, b) {
-    const pa = String(a).split('.').map((s)=>Number.parseInt(s, 10) || 0);
-    const pb = String(b).split('.').map((s)=>Number.parseInt(s, 10) || 0);
+    const pa = String(a).split('.').map((s) => Number.parseInt(s, 10) || 0);
+    const pb = String(b).split('.').map((s) => Number.parseInt(s, 10) || 0);
     const n = Math.max(pa.length, pb.length);
-    for(let i = 0; i < n; i += 1){
+    for (let i = 0; i < n; i += 1) {
         const d = (pa[i] ?? 0) - (pb[i] ?? 0);
-        if (d !== 0) return d;
+        if (d !== 0)
+            return d;
     }
     return 0;
 }
+/** 纯函数:Releases latest/download 永久链(稳定资产名) */
 export function distAssetUrls(releaseBase = DEFAULT_RELEASE_BASE) {
     const base = releaseBase.replace(/\/+$/, '');
     return {
         tarball: `${base}/latest/download/${DIST_ASSET_TARBALL}`,
         storeZip: `${base}/latest/download/${DIST_ASSET_STORE_ZIP}`,
-        manifest: `${base}/latest/download/${DIST_ASSET_MANIFEST}`
+        manifest: `${base}/latest/download/${DIST_ASSET_MANIFEST}`,
     };
 }
 const SHA256_RE = /^[0-9a-f]{64}$/;
+/** 纯函数:dist-manifest 解析,fail-closed(坏 JSON/缺字段/资产名漂移/哈希非 64-hex 一律拒绝) */
 export function parseDistManifest(raw) {
     let obj;
     try {
         obj = JSON.parse(raw);
-    } catch  {
+    }
+    catch {
         throw new Error('dist-manifest 不是合法 JSON');
     }
     const version = obj.version;
@@ -37,198 +67,164 @@ export function parseDistManifest(raw) {
     const tarballSha256 = obj.tarballSha256;
     const zip = obj.zip;
     const zipSha256 = obj.zipSha256;
-    if (typeof version !== 'string' || !/^\d+(\.\d+){1,3}$/.test(version)) throw new Error('dist-manifest.version 缺失或非 1-4 段点分整数');
-    if (tarball !== DIST_ASSET_TARBALL) throw new Error(`dist-manifest.tarball 资产名漂移(期望 ${DIST_ASSET_TARBALL})`);
-    if (zip !== DIST_ASSET_STORE_ZIP) throw new Error(`dist-manifest.zip 资产名漂移(期望 ${DIST_ASSET_STORE_ZIP})`);
-    if (typeof tarballSha256 !== 'string' || !SHA256_RE.test(tarballSha256)) throw new Error('dist-manifest.tarballSha256 非 64-hex');
-    if (typeof zipSha256 !== 'string' || !SHA256_RE.test(zipSha256)) throw new Error('dist-manifest.zipSha256 非 64-hex');
+    // Chrome manifest version 形态:1-4 段点分整数(扩展版本跟随 gotry 主版本
+    // 0.0.1-rc.N → 四段投影 0.0.1.N,展示名走 version_name 原样)
+    if (typeof version !== 'string' || !/^\d+(\.\d+){1,3}$/.test(version))
+        throw new Error('dist-manifest.version 缺失或非 1-4 段点分整数');
+    if (tarball !== DIST_ASSET_TARBALL)
+        throw new Error(`dist-manifest.tarball 资产名漂移(期望 ${DIST_ASSET_TARBALL})`);
+    if (zip !== DIST_ASSET_STORE_ZIP)
+        throw new Error(`dist-manifest.zip 资产名漂移(期望 ${DIST_ASSET_STORE_ZIP})`);
+    if (typeof tarballSha256 !== 'string' || !SHA256_RE.test(tarballSha256))
+        throw new Error('dist-manifest.tarballSha256 非 64-hex');
+    if (typeof zipSha256 !== 'string' || !SHA256_RE.test(zipSha256))
+        throw new Error('dist-manifest.zipSha256 非 64-hex');
     return {
         version,
         tarball,
         tarballSha256,
         zip,
         zipSha256,
-        builtFromCommit: typeof obj.builtFromCommit === 'string' ? obj.builtFromCommit : undefined
+        builtFromCommit: typeof obj.builtFromCommit === 'string' ? obj.builtFromCommit : undefined,
     };
 }
 export function sha256Hex(bytes) {
     return createHash('sha256').update(bytes).digest('hex');
 }
+/** 读取扩展 manifest 的 key(固定 key ⇒ 固定扩展 ID;分发通道 ID 不变量的锚点) */
 export function readExtensionKey(extensionDir) {
     const p = join(extensionDir, 'manifest.json');
-    if (!existsSync(p)) return undefined;
+    if (!existsSync(p))
+        return undefined;
     try {
         const m = JSON.parse(readFileSync(p, 'utf8'));
         return typeof m.key === 'string' ? m.key : undefined;
-    } catch  {
+    }
+    catch {
         return undefined;
     }
 }
 export function readExtensionVersion(extensionDir) {
     const p = join(extensionDir, 'manifest.json');
-    if (!existsSync(p)) return undefined;
+    if (!existsSync(p))
+        return undefined;
     try {
         const m = JSON.parse(readFileSync(p, 'utf8'));
         return typeof m.version === 'string' ? m.version : undefined;
-    } catch  {
+    }
+    catch {
         return undefined;
     }
 }
 function runTar(args, spawnFn, timeoutMs) {
-    return new Promise((resolve)=>{
-        const child = spawnFn('tar', args, {
-            stdio: 'ignore'
-        });
+    return new Promise((resolve) => {
+        const child = spawnFn('tar', args, { stdio: 'ignore' });
         let done = false;
-        const timer = setTimeout(()=>{
+        const timer = setTimeout(() => {
             if (!done) {
                 done = true;
                 try {
                     child.kill('SIGKILL');
-                } catch  {}
-                resolve({
-                    ok: false,
-                    error: `tar 超时(>${timeoutMs}ms)`
-                });
+                }
+                catch {
+                    /* ignore */
+                }
+                resolve({ ok: false, error: `tar 超时(>${timeoutMs}ms)` });
             }
         }, timeoutMs);
-        child.on('error', (e)=>{
+        child.on('error', (e) => {
             if (!done) {
                 done = true;
                 clearTimeout(timer);
-                resolve({
-                    ok: false,
-                    error: `tar 不可用:${e.message}`
-                });
+                resolve({ ok: false, error: `tar 不可用:${e.message}` });
             }
         });
-        child.on('close', (code)=>{
+        child.on('close', (code) => {
             if (!done) {
                 done = true;
                 clearTimeout(timer);
-                resolve(code === 0 ? {
-                    ok: true
-                } : {
-                    ok: false,
-                    error: `tar exit ${code}`
-                });
+                resolve(code === 0 ? { ok: true } : { ok: false, error: `tar exit ${code}` });
             }
         });
     });
 }
 async function fetchBytes(url, fetchFn, timeoutMs) {
     try {
-        const res = await fetchFn(url, {
-            signal: AbortSignal.timeout(timeoutMs)
-        });
-        if (!res.ok) return {
-            ok: false,
-            error: `HTTP ${res.status} ${url}`
-        };
+        const res = await fetchFn(url, { signal: AbortSignal.timeout(timeoutMs) });
+        if (!res.ok)
+            return { ok: false, error: `HTTP ${res.status} ${url}` };
         const buf = new Uint8Array(await res.arrayBuffer());
-        return {
-            ok: true,
-            bytes: buf
-        };
-    } catch (e) {
-        return {
-            ok: false,
-            error: `下载失败 ${e.message}`
-        };
+        return { ok: true, bytes: buf };
+    }
+    catch (e) {
+        return { ok: false, error: `下载失败 ${e.message}` };
     }
 }
+/**
+ * GitHub Releases → ~/.gotry/extension 安装链。
+ * 任何失败都返回 { ok:false, action:'fallback-bundled' }——调用方显式降级 bundled,
+ * 本函数不抛出(bootstrap 契约:安装外部产物永远不挡 gotry 本体)。
+ */
 export async function installExtensionFromGithub(opts) {
     const timeoutMs = opts.timeoutMs ?? 60_000;
     const fetchFn = opts.fetch ?? fetch;
     const spawnFn = opts.spawnFn ?? spawn;
     const urls = distAssetUrls(opts.releaseBase);
-    const fail = (error)=>({
-            ok: false,
-            action: 'fallback-bundled',
-            error
-        });
+    const fail = (error) => ({ ok: false, action: 'fallback-bundled', error });
     const mRes = await fetchBytes(urls.manifest, fetchFn, timeoutMs);
-    if (!mRes.ok) return fail(mRes.error);
+    if (!mRes.ok)
+        return fail(mRes.error);
     let manifest;
     try {
         manifest = parseDistManifest(new TextDecoder().decode(mRes.bytes));
-    } catch (e) {
+    }
+    catch (e) {
         return fail(`dist-manifest 校验失败:${e.message}`);
     }
     const previousVersion = readExtensionVersion(opts.destDir);
     if (previousVersion != null && compareVersions(manifest.version, previousVersion) <= 0) {
-        return {
-            ok: true,
-            action: 'up-to-date',
-            version: manifest.version,
-            previousVersion
-        };
+        return { ok: true, action: 'up-to-date', version: manifest.version, previousVersion };
     }
     if (opts.checkOnly) {
-        return {
-            ok: true,
-            action: 'up-to-date',
-            version: manifest.version,
-            previousVersion
-        };
+        return { ok: true, action: 'up-to-date', version: manifest.version, previousVersion }; // check-only 语义:报告远端版本,不落盘
     }
     const tRes = await fetchBytes(urls.tarball, fetchFn, timeoutMs);
-    if (!tRes.ok) return fail(tRes.error);
+    if (!tRes.ok)
+        return fail(tRes.error);
     const actual = sha256Hex(tRes.bytes);
-    if (actual !== manifest.tarballSha256) return fail(`SHA256 不符(期望 ${manifest.tarballSha256.slice(0, 12)}… 实得 ${actual.slice(0, 12)}…)`);
+    if (actual !== manifest.tarballSha256)
+        return fail(`SHA256 不符(期望 ${manifest.tarballSha256.slice(0, 12)}… 实得 ${actual.slice(0, 12)}…)`);
+    // 落盘 → tar 解压 → key 钉扎 → 原子交换;incoming 目录同盘保证 rename 原子性
     const incoming = `${opts.destDir}.incoming-${process.pid}-${Date.now()}`;
     const tarPath = `${incoming}.tar.gz`;
     try {
-        rmSync(incoming, {
-            recursive: true,
-            force: true
-        });
-        mkdirSync(incoming, {
-            recursive: true
-        });
+        rmSync(incoming, { recursive: true, force: true });
+        mkdirSync(incoming, { recursive: true });
         writeFileSync(tarPath, tRes.bytes);
-        const ext = await runTar([
-            '-xzf',
-            tarPath,
-            '-C',
-            incoming,
-            '--strip-components',
-            '1'
-        ], spawnFn, timeoutMs);
-        if (!ext.ok) return fail(ext.error);
+        // 包内含顶层目录 gotry-session-bridge/;--strip-components 落到 incoming 根
+        const ext = await runTar(['-xzf', tarPath, '-C', incoming, '--strip-components', '1'], spawnFn, timeoutMs);
+        if (!ext.ok)
+            return fail(ext.error);
         const incomingKey = readExtensionKey(incoming);
-        if (incomingKey == null) return fail('解压产物缺 manifest.json/key(非法包)');
+        if (incomingKey == null)
+            return fail('解压产物缺 manifest.json/key(非法包)');
         if (opts.pinnedSourceDir) {
             const pinnedKey = readExtensionKey(opts.pinnedSourceDir);
-            if (pinnedKey != null && incomingKey !== pinnedKey) return fail('扩展 key 漂移(通道产物与 bundled 不同 ID——拒绝安装,防端口池/host 权限漂移)');
+            if (pinnedKey != null && incomingKey !== pinnedKey)
+                return fail('扩展 key 漂移(通道产物与 bundled 不同 ID——拒绝安装,防端口池/host 权限漂移)');
         }
         const incomingVersion = readExtensionVersion(incoming);
-        if (incomingVersion !== manifest.version) return fail(`解压产物版本(${incomingVersion})与 dist-manifest(${manifest.version})不符`);
-        rmSync(opts.destDir, {
-            recursive: true,
-            force: true
-        });
-        cpSync(incoming, opts.destDir, {
-            recursive: true
-        });
-        return {
-            ok: true,
-            action: 'installed',
-            version: manifest.version,
-            previousVersion
-        };
-    } catch (e) {
+        if (incomingVersion !== manifest.version)
+            return fail(`解压产物版本(${incomingVersion})与 dist-manifest(${manifest.version})不符`);
+        rmSync(opts.destDir, { recursive: true, force: true });
+        cpSync(incoming, opts.destDir, { recursive: true });
+        return { ok: true, action: 'installed', version: manifest.version, previousVersion };
+    }
+    catch (e) {
         return fail(`落位失败 ${e.message}`);
-    } finally{
-        rmSync(incoming, {
-            recursive: true,
-            force: true
-        });
-        rmSync(tarPath, {
-            force: true
-        });
+    }
+    finally {
+        rmSync(incoming, { recursive: true, force: true });
+        rmSync(tarPath, { force: true });
     }
 }
-
-
-//# sourceURL=ts/capabilities/session/extension-distribution.ts

package/dist/capabilities/session/extract.js

@@ -1,40 +1,50 @@
+/**
+ * a11y 快照兜底抽取器(RFC §2.3 第②层:站点无干净 XHR JSON 时,从可访问性树快照抽结构化条目)。
+ * 纯函数:输入 Playwright ariaSnapshot/domSnapshot 文本,输出归一化条目(role/name/ref),
+ * 供确定性规则或 LLM 按 schema 消费;不做任何页面交互。
+ *
+ * 辑律(ADR-12 同款边界):抽取只认结构(行首 role 与缩进),不做开放式语义猜测;
+ * 页面文本是不可信输入(RFC §3.5)——本层只归形状,语义判定在上游 schema 处。
+ */
+/**
+ * Playwright aria snapshot 行形如:
+ *   `- button "搜索" [ref=s1e5]`
+ *   `- heading "上海到丽江" [level=1]`
+ * 提取 role/name;无 name 的行(name='')保留占位(计数/结构比对仍可用)。
+ */
 export function extractA11yEntries(snapshotText, opts = {}) {
     const cap = opts.maxEntries ?? 500;
     const out = [];
     const lines = snapshotText.split('\n');
-    for(let i = 0; i < lines.length && out.length < cap; i++){
+    for (let i = 0; i < lines.length && out.length < cap; i++) {
         const m = /^[\s*-]*\s*([a-zA-Z][\w-]*)(?:\s+"((?:[^"\\]|\\.)*)")?/.exec(lines[i] ?? '');
-        if (!m) continue;
+        if (!m)
+            continue;
         const name = (m[2] ?? '').replace(/\\"/g, '"').slice(0, 200);
-        out.push({
-            role: m[1].toLowerCase(),
-            name,
-            line: i
-        });
+        out.push({ role: m[1].toLowerCase(), name, line: i });
     }
     return out;
 }
+/** DOM 提交件过滤入口(RFC §3.3-②):从条目集中剔除命中提交黑名单的可交互件,返回保留集 */
 export function filterSubmitEntries(entries, isSubmit) {
-    const interactive = new Set([
-        'button',
-        'link',
-        'menuitem',
-        'option'
-    ]);
-    return entries.filter((e)=>!(interactive.has(e.role) && isSubmit(e.name)));
+    const interactive = new Set(['button', 'link', 'menuitem', 'option']);
+    return entries.filter((e) => !(interactive.has(e.role) && isSubmit(e.name)));
 }
+/** 名称相似度粗筛(自愈定位的候选排序底座;0=不同串,1=包含) */
 export function nameAffinity(a, b) {
     const x = a.trim();
     const y = b.trim();
-    if (!x || !y) return 0;
-    if (x === y) return 1;
-    if (x.includes(y) || y.includes(x)) return 0.8;
+    if (!x || !y)
+        return 0;
+    if (x === y)
+        return 1;
+    if (x.includes(y) || y.includes(x))
+        return 0.8;
     const sa = new Set(x);
     const sb = new Set(y);
     let common = 0;
-    for (const ch of sa)if (sb.has(ch)) common += 1;
+    for (const ch of sa)
+        if (sb.has(ch))
+            common += 1;
     return common / Math.max(sa.size, sb.size);
 }
-
-
-//# sourceURL=ts/capabilities/session/extract.ts