import assert from "node:assert/strict"; import test from "node:test"; import fs from "node:fs"; import { spawnSync } from "node:child_process"; import { applyManualReview, diagnoseTemplate } from "../lib/template-doctor.mjs"; test("真实模板自动发现并读取完整声明,生成可追溯区域报告", () => { const root = new URL("../../packages/", import.meta.url); const dirs = fs .readdirSync(root) .filter( (dir) => dir.startsWith("template-") && fs.existsSync(new URL(dir + "/template.json", root)), ); assert.ok(dirs.length > 0); for (const dir of dirs) { const manifest = JSON.parse(fs.readFileSync(new URL(dir + "/template.json", root), "utf8")); const source = fs.readFileSync(new URL(dir + "/taro/index.tsx", root), "utf8"); const report = diagnoseTemplate(manifest, source); assert.equal(report.template, manifest.packageKey); assert.ok(report.regions.length > 0); assert.equal(report.completionStatus, "unverified"); for (const region of report.regions) { for (const binding of region.bindings) { const fields = [ ...manifest.admin.sections.flatMap((s) => s.fields), ...(manifest.templateFields ?? []), ...(manifest.trustContentTypes ?? []).flatMap((t) => (t.configFields ?? []).map((f) => ({ ...f, previewTarget: f.previewTarget ?? "trust:" + t.type, })), ), ...(manifest.trustContentTypes ?? []).flatMap((t) => ["title", "summary", "content"] .filter((name) => !t.hideStandardFields?.includes(name)) .map((name) => ({ binding: "trust." + name, previewTarget: "trust:" + t.type })), ), ]; assert.ok( fields.some( (f) => (f.previewTarget === region.target || (region.page === "detail" && f.binding.startsWith("offering."))) && (f.binding === binding || binding.startsWith(f.binding + ".")), ) || report.issues.some( (i) => i.code === "REGION_FIELD_MISSING" && i.target === region.target && i.binding === binding, ), `${manifest.packageKey}: ${region.target} ${binding}`, ); } } } }); test("CLI 自动发现全部模板,问题退出 1,未知模板退出 2", () => { const cli = new URL("../template-doctor.mjs", import.meta.url); const all = spawnSync(process.execPath, [cli.pathname], { encoding: "utf8" }); const report = JSON.parse(all.stdout); assert.equal(all.status, report.templates.some((t) => t.staticStatus === "fail") ? 1 : 0); assert.ok(report.templates.length > 0); const missing = spawnSync( process.execPath, [cli.pathname, "--template", "missing-template-fixture"], { encoding: "utf8" }, ); assert.equal(missing.status, 2); }); test("人工审阅登记只能匹配真实 review,新问题仍会失败", () => { const report = { template: "fixture", staticStatus: "pass", completionStatus: "unverified", issues: [], }; const reviewed = { file: "taro/index.tsx", page: "home", target: "identity", binding: null, line: 20, message: "条件显示需验证全部分支与空数据入口。", severity: "review", reviewStatus: "source-reviewed", decision: "已核对空数据分支。", }; const clone = (issue) => structuredClone({ ...report, issues: issue ? [issue] : [] }); const issue = { code: "CONDITIONAL_RENDER_REVIEW", file: "taro/index.tsx", page: "home", target: "identity", line: 20, message: "条件显示需验证全部分支与空数据入口。", severity: "review", }; const empty = applyManualReview( [clone()], [], "人工映射审查,保留原诊断,不是自动豁免或全条件组合证明", ); assert.equal(empty[0].staticStatus, "pass"); assert.equal( applyManualReview( [clone(issue)], [reviewed], "人工映射审查,保留原诊断,不是自动豁免或全条件组合证明", )[0].staticStatus, "pass", ); assert.equal( applyManualReview( [clone(issue)], [], "人工映射审查,保留原诊断,不是自动豁免或全条件组合证明", )[0].staticStatus, "fail", ); assert.throws(() => applyManualReview( [clone(issue)], [{ ...reviewed, severity: "blocker" }], "人工映射审查,保留原诊断,不是自动豁免或全条件组合证明", ), ); assert.throws(() => applyManualReview( [clone(issue)], [{ ...reviewed, reviewStatus: "verified" }], "人工映射审查,保留原诊断,不是自动豁免或全条件组合证明", ), ); assert.throws(() => applyManualReview([clone(issue)], [reviewed], "unsupported scope")); }); const manifest = () => ({ packageKey: "independent-template", admin: { sections: [ { page: "home", target: "brand", previewTargets: [{ key: "identity", label: "人物介绍" }], fields: [ { binding: "brand.config.visualPresentation.home.badge", previewTarget: "identity" }, ], }, ], }, }); const renderer = 'function Home({workspace}) { const b = workspace.brand; const p = presentation(workspace, "home"); return {b.founder}{p.badge}; }'; test("整卡仅有标签字段不能通过,报告具体缺失变量", () => { const result = diagnoseTemplate(manifest(), renderer); assert.equal(result.staticStatus, "fail"); assert.ok( result.issues.some( (i) => i.code === "REGION_FIELD_MISSING" && i.binding === "brand.config.founder", ), ); }); test("完整字段通过静态检查但不能被宣称模板完成", () => { const input = manifest(); input.admin.sections[0].fields.push({ binding: "brand.config.founder", previewTarget: "identity", }); const result = diagnoseTemplate(input, renderer); assert.equal(result.staticStatus, "pass"); assert.equal(result.completionStatus, "unverified"); }); test("嵌套子区独立检查,父区字段不能遮蔽子区缺失", () => { const input = manifest(); input.admin.sections[0].previewTargets.push({ key: "child", label: "姓名" }); input.admin.sections[0].fields.push({ binding: "brand.config.founder", previewTarget: "identity", }); const result = diagnoseTemplate( input, renderer.replace( "{b.founder}", '{b.founder}', ), ); assert.ok(result.issues.some((i) => i.code === "REGION_FIELD_MISSING" && i.target === "child")); }); test("组合根上的模板字段同样算误绑", () => { const input = manifest(); input.admin.sections[0].previewTargets[0].composite = true; input.templateFields = [ { page: "home", binding: "brand.config.templateData.method", previewTarget: "identity" }, ]; const result = diagnoseTemplate(input, renderer); assert.ok( result.issues.some((i) => i.code === "COMPOSITE_HAS_FIELDS" && i.binding.endsWith(".method")), ); }); test("跨页目标不能作为合法字段入口", () => { const input = manifest(); input.templateFields = [ { page: "profile", binding: "brand.config.templateData.method", previewTarget: "identity" }, ]; assert.ok( diagnoseTemplate(input, renderer).issues.some((i) => i.code === "FIELD_TARGET_MISSING"), ); }); test("信任子目标必须声明页面,品牌字段不可归给 trust 记录编辑器", () => { const input = manifest(); input.trustContentTypes = [ { type: "credential", pages: ["home", "profile"], previewTargets: [{ key: "stats" }], configFields: [], }, ]; input.admin.sections[0].fields.push({ binding: "brand.description", previewTarget: "stats" }); const result = diagnoseTemplate(input, renderer); assert.ok(result.issues.some((i) => i.code === "TARGET_PAGE_UNSPECIFIED")); assert.ok(result.issues.some((i) => i.code === "TARGET_SOURCE_MISMATCH")); }); test("动态路径保留 review,不能静默绿色", () => { const result = diagnoseTemplate(manifest(), renderer.replace("b.founder", "b[key]")); assert.ok( result.issues.some((i) => i.code === "DYNAMIC_VALUE_REVIEW" && i.severity === "review"), ); }); test("记录区域缺失 recordId 会报告", () => { const input = manifest(); input.admin.sections[0].target = "offering"; input.admin.sections[0].fields = [{ binding: "offering.name", previewTarget: "identity" }]; assert.ok(diagnoseTemplate(input, renderer).issues.some((i) => i.code === "RECORD_ID_MISSING")); }); test("section 为 inquiry 但字段全是品牌时按运行时推导品牌来源", () => { const input = manifest(); input.admin.sections[0].target = "inquiry"; input.admin.sections[0].fields.push({ binding: "brand.config.founder", previewTarget: "identity", }); assert.equal(diagnoseTemplate(input, renderer).staticStatus, "pass"); }); test("同一区域混合记录和品牌字段不能豁免", () => { const input = manifest(); input.admin.sections[0].fields.push({ binding: "offering.name", previewTarget: "identity" }); assert.ok( diagnoseTemplate(input, renderer).issues.some((i) => i.code === "TARGET_SOURCE_MISMATCH"), ); }); test("箭头组件不能被跳过而静默通过", () => { assert.ok( diagnoseTemplate( manifest(), 'const Home = () => {brand.founder}', ).issues.some((i) => i.code === "UNSUPPORTED_COMPONENT_REVIEW"), ); }); test("条件只控制子区显示时不误判成父区展示字段", () => { const input = manifest(); const source = 'function Home({workspace}) { const b=workspace.brand; return {b.avatarUrl && 头像}; }'; const result = diagnoseTemplate(input, source); assert.ok(result.issues.some((i) => i.code === "CONDITIONAL_RENDER_REVIEW")); assert.ok(!result.issues.some((i) => i.code === "REGION_FIELD_MISSING")); }); test("JSON 合法但 TSX 损坏不能通过诊断", () => { assert.ok( diagnoseTemplate(manifest(), "function Home( { return ").issues.some( (i) => i.code === "RENDERER_PARSE_ERROR", ), ); }); test("循环业务卡片追踪实际字段,删除字段会失败", () => { const input = manifest(); input.admin.sections[0].target = "offering"; input.admin.sections[0].fields = [{ binding: "offering.name", previewTarget: "identity" }]; const source = 'function Home({workspace}) { return {workspace.offerings.map(offering).map(item => {item.name}{item.area})}; }'; const result = diagnoseTemplate(input, source); assert.ok( result.issues.some( (i) => i.code === "REGION_FIELD_MISSING" && i.binding === "offering.config.area", ), ); input.admin.sections[0].fields.push({ binding: "offering.config.area", previewTarget: "identity", }); assert.ok(!diagnoseTemplate(input, source).issues.some((i) => i.code === "REGION_FIELD_MISSING")); }); test("结构化信任列表追踪子字段,不跨循环混用别名", () => { const input = manifest(); input.admin.sections[0].target = "trust"; input.admin.sections[0].fields = [{ binding: "trust.config.stats", previewTarget: "identity" }]; const source = 'function Home({workspace}) { const t=workspace.trustPresentation; return {t.stats.map(item => {item.value})}; }'; const result = diagnoseTemplate(input, source); assert.ok(result.regions[0].bindings.includes("trust.config.stats.value")); assert.ok(!result.issues.some((i) => i.code === "REGION_FIELD_MISSING")); }); test("动态索引保留待核查,但不把容器对象误当可编辑字段", () => { const input = manifest(); const source = 'function Home({workspace}) { const b=workspace.brand; return {b.config[key]}; }'; const result = diagnoseTemplate(input, source); assert.ok(result.issues.some((i) => i.code === "DYNAMIC_VALUE_REVIEW")); assert.ok( !result.issues.some((i) => i.code === "REGION_FIELD_MISSING" && i.binding === "brand.config"), ); }); test("列表声明存在仍须检查每个展示子字段", () => { const input = manifest(); input.admin.sections[0].target = "trust"; input.admin.sections[0].fields = [ { binding: "trust.config.stats", previewTarget: "identity", input: "list", itemFields: [{ key: "value" }], }, ]; const source = 'function Home({workspace}) { const t=workspace.trustPresentation; return {t.stats.map(item => {item.value}{item.sub})}; }'; assert.ok( diagnoseTemplate(input, source).issues.some( (i) => i.code === "LIST_FIELD_MISSING" && i.binding === "trust.config.stats.sub", ), ); input.admin.sections[0].fields[0].itemFields.push({ key: "sub" }); assert.ok(!diagnoseTemplate(input, source).issues.some((i) => i.code === "LIST_FIELD_MISSING")); });