baxian 1.2.57 → 1.2.59

package/dist/platform/field-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-mapper.d.ts","sourceRoot":"","sources":["../../src/platform/field-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AA0FD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,CAkCvF"}

package/dist/platform/field-mapper.js

@@ -0,0 +1,117 @@
+export class FieldMappingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FieldMappingError';
+    }
+}
+const MISSING = Symbol('missing');
+function getPath(obj, path) {
+    let cur = obj;
+    for (const seg of path.split('.')) {
+        if (cur === null || typeof cur !== 'object' || !Object.hasOwn(cur, seg))
+            return MISSING;
+        cur = cur[seg];
+    }
+    return cur;
+}
+// map 源路径取值器：点路径 + 单层 [] 展平（spec §5.3），供 resolveField 使用；
+// op 级 flatten（上面的 getPath）语义不同（缺失/非数组按形状损坏拒绝），两者不合并。
+function resolveSourceSegments(obj, segments, fullPath, opName, field) {
+    if (segments.length === 0)
+        return obj;
+    if (obj === null || typeof obj !== 'object')
+        return MISSING;
+    const record = obj;
+    const [seg, ...rest] = segments;
+    if (!seg.endsWith('[]')) {
+        if (!Object.hasOwn(record, seg))
+            return MISSING;
+        return resolveSourceSegments(record[seg], rest, fullPath, opName, field);
+    }
+    const key = seg.slice(0, -2);
+    if (!Object.hasOwn(record, key))
+        return MISSING; // 数组键本身不存在 → MISSING，走必需/optional 语义
+    const arr = record[key];
+    // null-as-present（spec §5.3）：键存在值 null 不触发任何缺失语义；集合投影统一空数组，
+    // 与 [] 响应同构、required 不抛。仅键不存在才是 MISSING。
+    if (arr === null)
+        return [];
+    if (!Array.isArray(arr)) {
+        throw new FieldMappingError(`op ${opName}: field '${field}' source path '${fullPath}' expects an array at '${key}' (got ${typeof arr})`);
+    }
+    const results = [];
+    for (const element of arr) {
+        const v = resolveSourceSegments(element, rest, fullPath, opName, field);
+        if (v !== MISSING)
+            results.push(v); // 元素缺剩余路径键则跳过该元素（宽松聚合）
+    }
+    return results;
+}
+function compileMap(opName, map) {
+    return Object.entries(map).map(([field, spec]) => {
+        const rawSources = typeof spec === 'string' ? [spec] : spec.sources;
+        const optional = typeof spec === 'string' ? false : spec.optional === true;
+        const values = typeof spec === 'string' ? undefined : spec.values;
+        const sources = rawSources.map((raw) => {
+            const fromParent = raw.startsWith('_discussion.');
+            const path = fromParent ? raw.slice('_discussion.'.length) : raw;
+            const segments = path.split('.');
+            if (segments.filter(seg => seg.endsWith('[]')).length > 1) {
+                throw new FieldMappingError(`op ${opName}: field '${field}' source path '${path}' has more than one '[]' level, which is unsupported`);
+            }
+            return { fromParent, segments, raw: path };
+        });
+        return { field, sources, sourceKeys: rawSources.join(', '), optional, values };
+    });
+}
+function resolveField(opName, compiled, element, parent) {
+    for (const src of compiled.sources) {
+        const v = resolveSourceSegments(src.fromParent ? parent : element, src.segments, src.raw, opName, compiled.field);
+        if (v !== MISSING) {
+            // values 翻译只作用于字符串命中（spec §5.3 增量③）：null/数字等命中原样透传。
+            if (compiled.values && typeof v === 'string' && Object.hasOwn(compiled.values, v))
+                return compiled.values[v];
+            return v; // null 是合法值，键存在即命中
+        }
+    }
+    if (compiled.optional)
+        return undefined;
+    throw new FieldMappingError(`op ${opName}: required field '${compiled.field}' missing (tried keys: ${compiled.sourceKeys})`);
+}
+export function mapResponse(opName, op, payload) {
+    const compiledFields = compileMap(opName, op.map ?? {});
+    const units = [];
+    // null 或非对象 payload 按零行处理
+    if (payload === null || typeof payload !== 'object') {
+        return [];
+    }
+    const top = Array.isArray(payload) ? payload : [payload];
+    for (const item of top) {
+        if (op.flatten) {
+            const arr = getPath(item, op.flatten);
+            // 键缺失/非数组是响应形状损坏而非空集合：静默跳过会把整页伪装成合法空页，被跳过的
+            // discussion 若含令牌或人类反馈，完整性门照样放行——fail closed；显式 null/[] 才是空集合。
+            if (arr === MISSING) {
+                throw new FieldMappingError(`op ${opName}: flatten path '${op.flatten}' missing on a response item`);
+            }
+            if (arr === null)
+                continue;
+            if (!Array.isArray(arr)) {
+                throw new FieldMappingError(`op ${opName}: flatten path '${op.flatten}' expects an array (got ${typeof arr})`);
+            }
+            for (const child of arr)
+                units.push({ element: child, parent: item });
+        }
+        else {
+            units.push({ element: item, parent: item });
+        }
+    }
+    return units.map(({ element, parent }) => {
+        const row = {};
+        for (const compiled of compiledFields) {
+            row[compiled.field] = resolveField(opName, compiled, element, parent);
+        }
+        return row;
+    });
+}
+//# sourceMappingURL=field-mapper.js.map

package/dist/platform/field-mapper.js.map

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

package/dist/platform/git-driver.d.ts

@@ -0,0 +1,55 @@
+import { type CommentSourceOp, type DriverSpec } from './types.js';
+import { type RenderContext } from './command-renderer.js';
+import { type NormalizedRow } from './row-schema.js';
+export declare const DRIVER_MAX_BUFFER: number;
+export declare const DRIVER_EXEC_TIMEOUT_MS = 60000;
+export declare const LIST_PRS_PAGE_CAP = 10;
+export declare const COMMENT_SOURCE_PAGE_CAP = 100;
+export interface DriverExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export type DriverExec = (command: string, opts: {
+    timeout: number;
+    maxBuffer: number;
+}) => Promise<DriverExecResult>;
+export declare class DriverOpError extends Error {
+    readonly info: {
+        opName: string;
+        errorClass?: string;
+        exitCode?: number;
+        stderrTail?: string;
+    };
+    constructor(message: string, info: {
+        opName: string;
+        errorClass?: string;
+        exitCode?: number;
+        stderrTail?: string;
+    });
+}
+export interface OpVars {
+    prNumber?: number;
+    expectedHeadSha?: string;
+    branch?: string;
+}
+export declare function buildDriverRunContext(repoUrl: string, binary: string): RenderContext;
+export declare class GitDriver {
+    private readonly plugin;
+    private readonly ctx;
+    private readonly exec;
+    private readonly errorMatchers;
+    constructor(plugin: {
+        spec: DriverSpec;
+    }, ctx: RenderContext, exec: DriverExec);
+    get visibilityLagMs(): number;
+    get commentSources(): CommentSourceOp[];
+    classify(text: string): string | undefined;
+    runOp(opName: string, vars?: OpVars): Promise<NormalizedRow[]>;
+    runListPrs(vars: OpVars, shouldStop?: (pageRows: NormalizedRow[], page: number) => boolean): Promise<NormalizedRow[]>;
+    runCommentSource(source: CommentSourceOp, vars: OpVars, projectPage?: (pageRows: NormalizedRow[]) => NormalizedRow[]): Promise<NormalizedRow[]>;
+    private namedOp;
+    private execRendered;
+    private runPaged;
+}
+//# sourceMappingURL=git-driver.d.ts.map

package/dist/platform/git-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-driver.d.ts","sourceRoot":"","sources":["../../src/platform/git-driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,eAAe,EAAiB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG1E,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGnE,eAAO,MAAM,iBAAiB,QAAmB,CAAC;AAClD,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAG7C,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAG3C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEtH,qBAAa,aAAc,SAAQ,KAAK;IAGpC,QAAQ,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;gBAD9F,OAAO,EAAE,MAAM,EACN,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAKjG;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAepF;AAgBD,qBAAa,SAAS;IAIlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8C;gBAGzD,MAAM,EAAE;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,EAC5B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,UAAU;IASnC,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,cAAc,IAAI,eAAe,EAAE,CAEtC;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOpC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA8BlE,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,GAChE,OAAO,CAAC,aAAa,EAAE,CAAC;IAMrB,gBAAgB,CACpB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,GAC3D,OAAO,CAAC,aAAa,EAAE,CAAC;IAM3B,OAAO,CAAC,OAAO;YAMD,YAAY;YAgBZ,QAAQ;CA0DvB"}

package/dist/platform/git-driver.js

@@ -0,0 +1,171 @@
+import { SINGLE_RESOURCE_OPS } from './types.js';
+import { renderCommand } from './command-renderer.js';
+import { parseJsonResponse, parseJsonPagedPage } from './response-parser.js';
+import { mapResponse } from './field-mapper.js';
+import { validateRows } from './row-schema.js';
+import { isGitHubRepo, repoSlug, parseRepoUrlParts } from '../shared/git-url.js';
+export const DRIVER_MAX_BUFFER = 64 * 1024 * 1024;
+export const DRIVER_EXEC_TIMEOUT_MS = 60_000;
+// listPrs 的 10 页封顶是发现窗口（v1 §6，正常终止）；评论源无业务水位上限，
+// 命中 100 页即 fail closed——「最终必有空页」不是声明式输出可验证的契约（spec §5.3 增量⑦）。
+export const LIST_PRS_PAGE_CAP = 10;
+export const COMMENT_SOURCE_PAGE_CAP = 100;
+const STDERR_TAIL_CHARS = 500;
+export class DriverOpError extends Error {
+    info;
+    constructor(message, info) {
+        super(message);
+        this.info = info;
+        this.name = 'DriverOpError';
+    }
+}
+export function buildDriverRunContext(repoUrl, binary) {
+    const t = repoUrl.trim();
+    if (isGitHubRepo(t)) {
+        return { scheme: 'https', hostname: 'github.com', host: 'github.com', repoPath: repoSlug(t), binary };
+    }
+    // 与 repoIdentityKey 同一分解（shared/git-url）：cursor 身份与命令渲染对同一 URL 的解读不分叉。
+    const parts = parseRepoUrlParts(t);
+    if (parts === null)
+        throw new Error(`cannot derive driver context from repo URL: ${t}`);
+    return {
+        scheme: parts.scheme,
+        hostname: parts.hostname,
+        host: parts.port === '' ? parts.hostname : `${parts.hostname}:${parts.port}`,
+        repoPath: parts.path,
+        binary,
+    };
+}
+const tail = (s) => (s.length > STDERR_TAIL_CHARS ? s.slice(-STDERR_TAIL_CHARS) : s);
+export class GitDriver {
+    plugin;
+    ctx;
+    exec;
+    errorMatchers;
+    constructor(plugin, ctx, exec) {
+        this.plugin = plugin;
+        this.ctx = ctx;
+        this.exec = exec;
+        // 声明期常量模式一次编译（无 g 标志，test 无 lastIndex 状态）；失败风暴期每次 exec 免重编译。
+        this.errorMatchers = plugin.spec.errorClasses.map(c => ({
+            class: c.class,
+            regexes: c.regex.map(r => new RegExp(r)),
+        }));
+    }
+    get visibilityLagMs() {
+        return this.plugin.spec.visibilityLagSeconds * 1000;
+    }
+    get commentSources() {
+        return this.plugin.spec.commentSources;
+    }
+    classify(text) {
+        for (const c of this.errorMatchers) {
+            if (c.regexes.some(r => r.test(text)))
+                return c.class;
+        }
+        return undefined;
+    }
+    async runOp(opName, vars = {}) {
+        const op = this.namedOp(opName);
+        if (op.parse === 'json-paged') {
+            throw new DriverOpError(`op ${opName} is paged; use the paged runner`, { opName });
+        }
+        let rows;
+        try {
+            const result = await this.execRendered(opName, op, vars);
+            rows = result === 'treated-success' || op.parse === undefined
+                ? []
+                : validateRows(opName, mapResponse(opName, op, parseJsonResponse(result.stdout)));
+        }
+        catch (e) {
+            // optional op 不可用仅能力降级、不计健康度（spec §5.3/§7 listApprovals 语义）；生命周期
+            // 必需 op 与评论源在加载期即拒绝 optional。降级只吞执行失败（DriverOpError）——命令
+            // 成功后的 parse/schema 错误是插件缺陷，照常 fail loud。
+            if (op.optional === true && e instanceof DriverOpError)
+                return [];
+            throw e;
+        }
+        // 单资源 op 的空/多行响应是 fail-open 洞：null/标量被归一成零行后上层只会静默跳过，
+        // 项目/PR 永久停摆而健康度仍显示成功——按 op 契约恰好一行，违例 fail closed。
+        // 检查对 parse 缺失/treated-success 的零行同样生效（加载期契约之外的运行时纵深）。
+        if (SINGLE_RESOURCE_OPS.has(opName) && rows.length !== 1) {
+            throw new DriverOpError(`op ${opName} must yield exactly one row (got ${rows.length})`, { opName });
+        }
+        return rows;
+    }
+    async runListPrs(vars, shouldStop) {
+        return this.runPaged('listPrs', this.namedOp('listPrs'), vars, {
+            pageCap: LIST_PRS_PAGE_CAP, capBehavior: 'stop', idField: 'prNumber', shouldStop,
+        });
+    }
+    async runCommentSource(source, vars, projectPage) {
+        return this.runPaged('listComments', source, vars, {
+            pageCap: COMMENT_SOURCE_PAGE_CAP, capBehavior: 'fail', idField: 'id', sourceKey: source.key, projectPage,
+        });
+    }
+    namedOp(opName) {
+        const op = this.plugin.spec.ops[opName];
+        if (!op)
+            throw new DriverOpError(`op ${opName} is not declared by the driver`, { opName });
+        return op;
+    }
+    async execRendered(opName, op, vars) {
+        const cmd = renderCommand(op, { ...this.ctx, ...vars });
+        const result = await this.exec(cmd, { timeout: DRIVER_EXEC_TIMEOUT_MS, maxBuffer: DRIVER_MAX_BUFFER });
+        if (result.exitCode === 0)
+            return result;
+        const cls = this.classify(`${result.stderr}\n${result.stdout}`);
+        if (cls !== undefined && op.treatAsSuccess?.includes(cls))
+            return 'treated-success';
+        throw new DriverOpError(`op ${opName} failed (exit ${result.exitCode}${cls ? `, class ${cls}` : ''}): ${tail(result.stderr || result.stdout)}`, { opName, errorClass: cls, exitCode: result.exitCode, stderrTail: tail(result.stderr) });
+    }
+    async runPaged(rowOp, op, vars, opts) {
+        const label = opts.sourceKey === undefined ? rowOp : `${rowOp}[${opts.sourceKey}]`;
+        const { idField } = opts;
+        const all = [];
+        // 页码分页在扫描期间有排序前移时，相邻页可部分重叠（GitHub sort=updated 已知形态）：
+        // 同身份同内容 = 位移重复、静默去重；同身份异内容 = 同扫描内版本冲突，fail closed 下轮重扫。
+        const seen = new Map();
+        let prevIds;
+        for (let page = 1; page <= opts.pageCap; page++) {
+            const result = await this.execRendered(label, op, { ...vars, page });
+            if (result === 'treated-success') {
+                throw new DriverOpError(`op ${label}: treatAsSuccess is not valid on a paged read`, { opName: label });
+            }
+            const rawPage = parseJsonPagedPage(result.stdout);
+            if (rawPage.length === 0)
+                return all;
+            // 投影先于指纹：指纹对原文 stringify 会把整页 body 再序列化一遍并在 seen 里滞留到扫描
+            // 结束，绕开「跨页只聚合投影行」的内存界；bodyDigest 已入投影行，任何正文差异仍必然
+            // 改变指纹，冲突检测语义等价。
+            const rows = validateRows(rowOp, mapResponse(rowOp, op, rawPage), opts.sourceKey === undefined ? undefined : { sourceKey: opts.sourceKey });
+            const projected = opts.projectPage === undefined ? rows : opts.projectPage(rows);
+            const ids = new Set(projected.map(r => String(r[idField])));
+            // flatten 源可能整页映射零行，空集合相等不构成「后端未消费 {page}」的证据。
+            if (prevIds !== undefined && prevIds.size > 0 && ids.size === prevIds.size && [...ids].every(i => prevIds.has(i))) {
+                throw new DriverOpError(`op ${label}: pagination did not advance at page ${page} (backend ignoring {page}?)`, { opName: label });
+            }
+            prevIds = ids;
+            for (const row of projected) {
+                const key = String(row[idField]);
+                const fingerprint = JSON.stringify(row);
+                const prior = seen.get(key);
+                if (prior === undefined) {
+                    seen.set(key, fingerprint);
+                    all.push(row);
+                    continue;
+                }
+                if (prior === fingerprint)
+                    continue;
+                throw new DriverOpError(`op ${label}: conflicting duplicate row for ${idField}=${key} across pages (mid-scan mutation)`, { opName: label });
+            }
+            if (opts.shouldStop?.(projected, page) === true)
+                return all;
+        }
+        if (opts.capBehavior === 'fail') {
+            throw new DriverOpError(`op ${label}: exceeded page cap ${opts.pageCap} (refusing silent truncation)`, { opName: label });
+        }
+        return all;
+    }
+}
+//# sourceMappingURL=git-driver.js.map

package/dist/platform/git-driver.js.map

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

package/dist/platform/manifest.d.ts

@@ -0,0 +1,12 @@
+import { PluginManifest, PluginValidationError } from './types.js';
+export declare function compareSemver(a: string, b: string): number;
+export interface ManifestIdentity {
+    name?: string;
+    tool?: string;
+}
+export declare function parseManifest(raw: string, pluginPath: string): {
+    manifest: PluginManifest;
+} | ({
+    errors: PluginValidationError[];
+} & ManifestIdentity);
+//# sourceMappingURL=manifest.d.ts.map

package/dist/platform/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/platform/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAKnE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAS1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB;IAAE,QAAQ,EAAE,cAAc,CAAA;CAAE,GAAG,CAAC;IAAE,MAAM,EAAE,qBAAqB,EAAE,CAAA;CAAE,GAAG,gBAAgB,CAAC,CAoCzF"}

package/dist/platform/manifest.js

@@ -0,0 +1,57 @@
+import { isRecord, TOOL_PATTERN } from '../shared/index.js';
+const SEMVER = /^(\d{1,10})\.(\d{1,10})\.(\d{1,10})$/;
+export function compareSemver(a, b) {
+    const ma = SEMVER.exec(a);
+    const mb = SEMVER.exec(b);
+    if (!ma || !mb)
+        throw new Error(`invalid semver: ${!ma ? a : b}`);
+    for (let i = 1; i <= 3; i++) {
+        const d = Number(ma[i]) - Number(mb[i]);
+        if (d !== 0)
+            return d > 0 ? 1 : -1;
+    }
+    return 0;
+}
+export function parseManifest(raw, pluginPath) {
+    const errors = [];
+    const err = (message) => errors.push({ pluginPath, message });
+    let obj;
+    try {
+        obj = JSON.parse(raw);
+    }
+    catch (e) {
+        err(`baxian-plugin.json is not valid JSON: ${e instanceof Error ? e.message : String(e)}`);
+        return { errors };
+    }
+    if (!isRecord(obj)) {
+        err('baxian-plugin.json must be a JSON object');
+        return { errors };
+    }
+    const m = obj;
+    if (typeof m.name !== 'string' || m.name === '')
+        err('name must be a non-empty string');
+    // version 是插件元数据：spec §5.2 未声明格式契约、无消费者对其做 semver 比较（仅 minToolVersion 比较）——非空串即可，勿收成 semver。
+    if (typeof m.version !== 'string' || m.version.trim() === '')
+        err(`version must be a non-empty string (got ${JSON.stringify(m.version)})`);
+    if (m.kind !== 'git-driver')
+        err(`kind must be 'git-driver', got ${JSON.stringify(m.kind)}`);
+    if (typeof m.tool !== 'string' || !TOOL_PATTERN.test(m.tool)) {
+        err(`tool must match ${TOOL_PATTERN} (got ${JSON.stringify(m.tool)})`);
+    }
+    if (typeof m.minToolVersion !== 'string' || !SEMVER.test(m.minToolVersion)) {
+        err(`minToolVersion must be x.y.z semver (got ${JSON.stringify(m.minToolVersion)})`);
+    }
+    if (m.driverSchema !== 1)
+        err(`driverSchema must be 1 (got ${JSON.stringify(m.driverSchema)})`);
+    if (errors.length > 0) {
+        // schema 失败仍保留各自通过格式校验的 name/tool 作 best-effort 身份——
+        // startup 的同名覆盖下毒靠它识别「坏损覆盖」，丢弃会静默回退内置（spec §5.4）。
+        return {
+            errors,
+            name: typeof m.name === 'string' && m.name !== '' ? m.name : undefined,
+            tool: typeof m.tool === 'string' && TOOL_PATTERN.test(m.tool) ? m.tool : undefined,
+        };
+    }
+    return { manifest: m };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/platform/manifest.js.map

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

package/dist/platform/markers.d.ts

@@ -0,0 +1,46 @@
+import { type NormalizedRow } from './row-schema.js';
+export interface ReviewTokenMarker {
+    kind: 'pass' | 'fail';
+    anchorSha: string;
+    token: string;
+}
+export interface AckMarker {
+    sourceKey: string;
+    commentId: string;
+    bodyDigest: string;
+}
+export declare function buildReviewTokenLine(m: ReviewTokenMarker): string;
+export declare function extractReviewTokens(body: string): ReviewTokenMarker[];
+export declare function buildAckMarker(m: AckMarker): string;
+export declare function extractAckMarkers(body: string): AckMarker[];
+export declare function stripBaxianMarkerLines(body: string): string;
+export declare function projectCommentRow(row: NormalizedRow): void;
+export declare function rowBodyDigest(row: NormalizedRow): string;
+export declare function rowTokens(row: NormalizedRow): ReviewTokenMarker[];
+export declare function rowAcks(row: NormalizedRow): AckMarker[];
+export declare function rowHasBody(row: NormalizedRow): boolean;
+export type CommentSourceClass = 'reviews' | 'threaded' | 'top-level';
+export declare function classifyCommentSource(source: {
+    map?: Record<string, unknown>;
+}): CommentSourceClass;
+export interface AckActorContext {
+    replyActorId?: string;
+    replyActorStatus?: 'verified' | 'provisional';
+}
+export interface AckCarrierRow {
+    sourceKey: string;
+    sourceClass: CommentSourceClass;
+    id: string;
+    authorId?: string;
+    discussionId?: string | null;
+    acks: AckMarker[];
+    carriesToken: boolean;
+}
+export interface AckCollection {
+    acks: Set<string>;
+    carrierRowKeys: Set<string>;
+}
+export declare const ackRevisionKey: (sourceKey: string, id: string, digest: string) => string;
+export declare const ackCarrierKey: (sourceKey: string, id: string) => string;
+export declare function collectValidAcks(rows: AckCarrierRow[], ctx: AckActorContext): AckCollection;
+//# sourceMappingURL=markers.d.ts.map

package/dist/platform/markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../src/platform/markers.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkC,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAeD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAEjE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAMrE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAEnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAE3D;AAGD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK3D;AAOD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAU1D;AAOD,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAExD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,iBAAiB,EAAE,CAEjE;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS,EAAE,CAEvD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAEtD;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAItE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,kBAAkB,CAKnG;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;CAC/C;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,kBAAkB,CAAC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAGD,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,EAAE,IAAI,MAAM,EAAE,QAAQ,MAAM,WAAmC,CAAC;AAChH,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,EAAE,IAAI,MAAM,WAAyB,CAAC;AAQrF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,eAAe,GAAG,aAAa,CA0B3F"}

package/dist/platform/markers.js

@@ -0,0 +1,121 @@
+// baxian 标记线协议（spec §6/§7/§8）：verdict 令牌行与逐 revision ack 行的唯一定义，
+// verdict engine / 事件过滤 / ack 完成集 / 展示剥离共用，防多处正则漂移。
+import { BODY_DIGEST_SOURCE, bodyDigest } from './body-digest.js';
+import { SHA_HEX_SOURCE, SOURCE_KEY_PATTERN } from './types.js';
+import { LINE_SAFE_ID_RE, versionTimeOf } from './row-schema.js';
+// 段文法取自各自的具名定义：装机校验放行的键/id/digest 形态与线协议能解析回来的
+// 必须是同一形态——各自内联会在任一侧收放后静默失配（ack 永判无效、反馈重派循环）。
+const unanchored = (re) => re.source.replace(/^\^/, '').replace(/\$$/, '');
+const REVIEW_TOKEN_RE = new RegExp(`<!--\\s*baxian:review:(pass|fail):(${SHA_HEX_SOURCE}):([A-Za-z0-9_-]{6,64})\\s*-->`, 'g');
+const ACK_RE = new RegExp(`<!--\\s*baxian:reply:ack:(${unanchored(SOURCE_KEY_PATTERN)}):(${unanchored(LINE_SAFE_ID_RE)}):(${BODY_DIGEST_SOURCE})\\s*-->`, 'g');
+// (?:(?!-->).)* 禁止注释体内提前出现 -->：贪婪 .* 会从行首标记吞到行尾另一条注释，
+// 把夹在中间的可见正文一并剥掉——只有「单条完整注释占满整行」才可剥。
+const MARKER_ONLY_LINE_RE = /^<!--\s*baxian:(?:(?!-->).)*-->$/;
+export function buildReviewTokenLine(m) {
+    return `<!-- baxian:review:${m.kind}:${m.anchorSha}:${m.token} -->`;
+}
+export function extractReviewTokens(body) {
+    return [...body.matchAll(REVIEW_TOKEN_RE)].map(m => ({
+        kind: m[1],
+        anchorSha: m[2].toLowerCase(),
+        token: m[3],
+    }));
+}
+export function buildAckMarker(m) {
+    return `<!-- baxian:reply:ack:${m.sourceKey}:${m.commentId}:${m.bodyDigest} -->`;
+}
+export function extractAckMarkers(body) {
+    return [...body.matchAll(ACK_RE)].map(m => ({ sourceKey: m[1], commentId: m[2], bodyDigest: m[3] }));
+}
+// 仅剥「整行只有 baxian 标记」的行——verdict engine 恒读原文，此函数只服务展示/正文投影（v1 分离原则）。
+export function stripBaxianMarkerLines(body) {
+    return body
+        .split('\n')
+        .filter(line => !MARKER_ONLY_LINE_RE.test(line.trim()))
+        .join('\n');
+}
+// 行投影（spec v1 §6 页内管线，v2 §5.3 继承）：正文一次性折算成 digest/令牌/ack/非空标记后
+// 原文即释放——分页聚合与 scans 跨源滞留的都是投影行，内存不随评论原文总量线性增长。
+// 读取端一律走 rowXxx 助手：投影行取 stash、未投影行（测试直构）现算，单点防两套语义漂移。
+const PROJECTED = Symbol('bodyProjected');
+export function projectCommentRow(row) {
+    const body = typeof row.body === 'string' ? row.body : '';
+    const versionTime = versionTimeOf(row);
+    row.bodyDigest = bodyDigest(body);
+    row.bodyTokens = extractReviewTokens(body);
+    row.bodyAcks = extractAckMarkers(body);
+    row.hasBody = body !== '';
+    if (versionTime !== undefined)
+        row.versionTime = versionTime;
+    row[PROJECTED] = true;
+    delete row.body;
+}
+const isProjected = (row) => row[PROJECTED] === true;
+const rawBody = (row) => (typeof row.body === 'string' ? row.body : '');
+export function rowBodyDigest(row) {
+    return isProjected(row) ? row.bodyDigest : bodyDigest(rawBody(row));
+}
+export function rowTokens(row) {
+    return isProjected(row) ? row.bodyTokens : extractReviewTokens(rawBody(row));
+}
+export function rowAcks(row) {
+    return isProjected(row) ? row.bodyAcks : extractAckMarkers(rawBody(row));
+}
+export function rowHasBody(row) {
+    return isProjected(row) ? row.hasBody === true : rawBody(row) !== '';
+}
+// 载体类按声明结构推导而非 key 字面（用户插件的 key 集合任意，spec §6 矩阵须平台中立）：
+// 声明 reviewState 的源承载 native review（恒非 ack 载体），声明 discussionId 的源有线程结构。
+export function classifyCommentSource(source) {
+    const map = source.map ?? {};
+    if ('reviewState' in map)
+        return 'reviews';
+    if ('discussionId' in map)
+        return 'threaded';
+    return 'top-level';
+}
+// 集合成员键的拼法与产出同居：消费侧手工重拼在键形变更时会静默 miss（已 ack 反馈重发）。
+export const ackRevisionKey = (sourceKey, id, digest) => `${sourceKey}:${id}:${digest}`;
+export const ackCarrierKey = (sourceKey, id) => `${sourceKey}:${id}`;
+// ack 载体矩阵（spec §6 矩阵修订③④）：唯一授权谓词 = verified 且 authorId 相等；
+// reviews 类行与携令牌行恒非载体（同账号 confused-deputy 结构隔离）；threaded 行可 ack
+// **同一线程内任意成员**（根或回复 revision——poller 对 reply 行投递的 revision id 即行自身 id，
+// 只认线程根会让合法 ack 永判无效并把 dev 回复再当新反馈）；隶属以传入行集解析，
+// 目标行不在集合内按 fail-closed 拒绝。行集可跨源（issue 类顶层 ack 可指向任意源），
+// 载体键与隶属表一律 (sourceKey, id)——三源是不同对象表、数值 id 无跨表唯一性契约（spec §5.3 增量①）。
+export function collectValidAcks(rows, ctx) {
+    const acks = new Set();
+    const carrierRowKeys = new Set();
+    if (ctx.replyActorStatus !== 'verified' || ctx.replyActorId === undefined)
+        return { acks, carrierRowKeys };
+    const threadRootById = new Map();
+    for (const row of rows) {
+        threadRootById.set(ackCarrierKey(row.sourceKey, row.id), row.discussionId ?? row.id);
+    }
+    for (const row of rows) {
+        if (row.authorId === undefined || row.authorId !== ctx.replyActorId)
+            continue;
+        if (row.sourceClass === 'reviews')
+            continue;
+        if (row.carriesToken)
+            continue;
+        if (row.sourceClass === 'threaded' && (row.discussionId === null || row.discussionId === undefined))
+            continue;
+        let carried = false;
+        for (const m of row.acks) {
+            if (row.sourceClass === 'threaded') {
+                if (m.sourceKey !== row.sourceKey)
+                    continue;
+                const targetRoot = threadRootById.get(ackCarrierKey(m.sourceKey, m.commentId));
+                if (targetRoot === undefined || targetRoot !== row.discussionId)
+                    continue;
+            }
+            acks.add(ackRevisionKey(m.sourceKey, m.commentId, m.bodyDigest));
+            carried = true;
+        }
+        if (carried)
+            carrierRowKeys.add(ackCarrierKey(row.sourceKey, row.id));
+    }
+    return { acks, carrierRowKeys };
+}
+//# sourceMappingURL=markers.js.map