/**
 * reverse-qa.ts — 反推需求 QA 环：验证（verify）→ 审查（review）→ 修订（revise）
 *
 * 方法论对齐业内最优 recipe-reverse-engineer（shinpr/claude-code-workflows）五阶段配方：
 *   discover（单元清单）→ generate（生成 PRD）→ verify（code-verifier 对照代码验证）
 *   → review（document-reviewer 语义审查）→ revision（有条件修订 + re-validation）。
 *
 * SpecCore 架构映射（CLI 确定性分层 + 宿主 AI 语义抽象）：
 *   - CLI 确定性：完整性基线统计（counts balance）、剧本与 JSON 模板落盘、裁决门禁判定、修订轮次记录。
 *   - 宿主 AI 语义：code-verifier 逐条 AC 对照代码验证、document-reviewer 语义审查、apply findings 修订。
 *
 * 三个质量门禁（recipe 原样移植）：
 *   1. Quality Gate（Step 3 Verify）：summary.status = blocked / 覆盖缺失 / 计数不平衡 → 重跑或升级；
 *      needs_review / inconsistent → 成为 Step 4 审查的显式证据。
 *   2. Review Resolution Gate（Step 5）：每条 finding 必须裁决 apply / decline；
 *      仅当 ≥1 条 apply 时才修订，decline-only 即闭环完成。
 *   3. Unit Completion Gate：无 apply findings 剩余 + 人工审查通过 → 反推闭环完成。
 *
 * 产物（.speccore/GLOBAL/requirements/{端}/_qa/，v8.3.379 按端组织——每端目录自包含 QA 环）：
 *   INVENTORY.md        完整性基线报告（CLI 生成）
 *   VERIFY_PLAYBOOK.md  验证剧本（code-verifier 角色） + verify.json 模板
 *   REVIEW_PLAYBOOK.md  审查剧本（document-reviewer 角色） + review.json 模板
 *   REVISION_PLAYBOOK.md 修订剧本（prd-creator update 模式，按需生成）
 *   REVISION_LOG.md     修订轮次记录
 *
 * v8.3.367+
 */
export interface InventoryCoverage {
    /** IR 模块总数（discover 单元清单） */
    totalModules: number;
    /** 被 UR 锚点引用的 IR 模块（规范化 id） */
    coveredModules: string[];
    /** 未被任何锚点引用的 IR 模块（unaccounted items → 审查证据） */
    uncoveredModules: string[];
    /** 覆盖率 0~1 */
    coverageRatio: number;
    /** Quality Gate 判定：无法验证（IR 非空但零已填锚点） */
    blocked: boolean;
}
/**
 * 完整性基线：UR 溯源锚点覆盖 vs IR 单元清单。
 * recipe 的 counts balance——清单里没有被任何需求引用的模块，
 * 要么是遗漏（该模块业务未进需求），要么是锚点写错（unaccounted items）。
 */
export declare function checkInventoryCoverage(outputDir: string): Promise<InventoryCoverage | null>;
/** 验证剧本（code-verifier 角色） */
/**
 * verify.json 完成度检查（硬门禁证据）
 * - 完成标准：status=done、items 非空、每条 item 有非空 evidence 且 status 非 unverified
 * - 防假绿：模板默认 evidence 为空、status=unverified，宿主 AI 不填即被拦截
 */
export declare function checkVerifyJsonCompletion(verifyJsonPath: string): Promise<{
    complete: boolean;
    reason: string;
}>;
/**
 * 完整验证环（--verify）：
 * 1. 锚点一致性校验（verifyReverseAnchors，悬空锚点=疑似幻觉）；
 * 2. 完整性基线（counts balance，未覆盖模块=遗漏证据）；
 * 3. 生成 code-verifier 验证剧本 + verify.json 模板。
 */
export declare function runReverseVerify(outputDir: string): Promise<void>;
/**
 * 语义审查（--review）：生成 document-reviewer 审查剧本 + review.json 模板。
 * 若 verify.json 尚未完成（status ≠ done），提示先跑验证环。
 */
export declare function runReverseReview(outputDir: string): Promise<void>;
export interface RevisionResolution {
    total: number;
    apply: number;
    decline: number;
    pending: number;
    /** Unit Completion Gate：无 apply findings 剩余 → 闭环完成 */
    completed: boolean;
    applyFindings: unknown[];
}
/**
 * 有条件修订（--revise）：读 review.json 做 Review Resolution Gate + Unit Completion Gate。
 * - review.json 缺失 / 未裁决（pending > 0）→ 拒绝推进（recipe: Review Resolution Gate MANDATORY）；
 * - apply = 0 → 闭环完成（Unit Completion Gate 通过）；
 * - apply > 0 → 生成修订剧本 + 追加修订轮次。
 */
export declare function runReverseRevision(outputDir: string): Promise<RevisionResolution>;
//# sourceMappingURL=reverse-qa.d.ts.map