@cloud411716/fancy-webnovel 1.0.45 → 2.2.0

package/plugins/fancy-story-builder/scripts/label-coverage.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+/**
+ * label-coverage.js —— 模板字段 → 中文标签 的覆盖闸门
+ *
+ * 背景（2026-10 血肉阶段产物复查）：
+ *   产物 md 里每个字段的中文标签来自 graph-utils.js 的 FIELD_CN / CONTEXTUAL_LABEL。
+ *   那两张表是手工维护的，模板加字段时没人同步加标签，结果产物里直接显示
+ *   英文 key（势力.md 的 goal、suppression_method、function_detail 全是英文）。
+ *   实测：283 个模板字段里有 103 个查不到中文标签。
+ *
+ * 本脚本把"漏一个就失败"变成硬约束：
+ *   模板新增字段 → 忘了在 FIELD_CN / CONTEXTUAL_LABEL 里加中文标签 → 本脚本立刻报错。
+ *
+ * 用法：
+ *   node scripts/label-coverage.js --plugin-root=<插件目录>
+ *   （也可被 prompt-drift-check.js 内部调用，作为仓库级一致性闸门的一环）
+ *
+ * 输出：stdout 为 JSON
+ *   { "status": 0, "file": "LABEL_COVERAGE", "errors": [...], "warnings": [...], "report": {...} }
+ *   status: 0=全覆盖 1=有字段缺中文标签
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'url';
+import { FIELD_CN, CONTEXTUAL_LABEL } from './graph-utils.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// 模板目录名（相对插件根）
+const TEMPLATE_DIRS = ['骨架', '血肉', '节奏'];
+
+// ============================================================
+// 模板字段收集
+// ============================================================
+
+/**
+ * 递归收集一个 JSON Schema 的 properties 里的所有字段名。
+ * 数组的 items.properties 也要收（模板里 members / details / relationships 都是这种）。
+ */
+function collectProps(props, acc) {
+  if (!props || typeof props !== 'object') return;
+  for (const [k, v] of Object.entries(props)) {
+    if (!acc.has(k)) acc.set(k, []);
+    acc.set(k, acc.get(k));
+    if (v && typeof v === 'object') {
+      collectProps(v.properties, acc);
+      if (v.items && typeof v.items === 'object') collectProps(v.items.properties, acc);
+    }
+  }
+}
+
+/**
+ * 收集插件模板目录里出现过的全部字段名。
+ * 返回 Map<field, Set<templateFile>>。
+ */
+export function collectTemplateFields(pluginRoot) {
+  const out = new Map();
+  for (const dirName of TEMPLATE_DIRS) {
+    const dir = path.join(pluginRoot, 'templates', dirName);
+    if (!fs.existsSync(dir)) continue;
+    for (const f of fs.readdirSync(dir)) {
+      if (!f.endsWith('.json')) continue;
+      let j;
+      try {
+        j = JSON.parse(fs.readFileSync(path.join(dir, f), 'utf-8'));
+      } catch (e) {
+        continue;
+      }
+      const props = (j.structure || {}).properties || {};
+      const tmp = new Map();
+      collectProps(props, tmp);
+      for (const [k] of tmp) {
+        if (!out.has(k)) out.set(k, new Set());
+        out.get(k).add(dirName + '/' + f);
+      }
+    }
+  }
+  return out;
+}
+
+// ============================================================
+// 覆盖检查
+// ============================================================
+
+/**
+ * 检查模板字段是否都有中文标签。
+ *
+ * 判定"有标签"的两种情况：
+ *   1. FIELD_CN 里有这个 key（全局映射）
+ *   2. CONTEXTUAL_LABEL 的某一层里有这个 key（上下文相关映射）
+ *      —— 例如 conflicts 在冲突档案里是"冲突"，在道具归属里是"涉及冲突"，
+ *         这类同名不同义的字段靠上下文表覆盖。
+ */
+export function runLabelCoverage(pluginRoot) {
+  const errors = [];
+  const warnings = [];
+  const report = {};
+
+  const fields = collectTemplateFields(pluginRoot);
+  const globalKeys = new Set(Object.keys(FIELD_CN));
+  const ctxKeys = new Set();
+  for (const m of Object.values(CONTEXTUAL_LABEL || {})) {
+    if (!m || typeof m !== 'object') continue;
+    for (const k of Object.keys(m)) ctxKeys.add(k);
+  }
+
+  const missing = [];
+  const viaContext = [];
+  for (const [k, sources] of fields) {
+    if (globalKeys.has(k)) continue;
+    if (ctxKeys.has(k)) {
+      viaContext.push(k);
+      continue;
+    }
+    missing.push({ field: k, sources: [...sources] });
+  }
+  missing.sort((a, b) => (a.field < b.field ? -1 : a.field > b.field ? 1 : 0));
+  viaContext.sort();
+
+  report.labelCoverage = {
+    templateFieldCount: fields.size,
+    globalLabelCount: globalKeys.size,
+    contextLabelCount: ctxKeys.size,
+    coveredByContext: viaContext.length,
+    missingCount: missing.length,
+    missingFields: missing.map((m) => m.field)
+  };
+
+  for (const m of missing) {
+    errors.push({
+      code: 'LABEL_FIELD_UNCOVERED',
+      path: 'plugins/fancy-story-builder/scripts/graph-utils.js',
+      message: '模板字段 ' + m.field + ' 没有中文标签（出现在 ' + m.sources.join('、') + '）',
+      hint: '在 FIELD_CN 里加一条 ' + m.field + ' 键值对；若该字段在不同父级下语义不同，改用 CONTEXTUAL_LABEL'
+    });
+  }
+
+  return { errors, warnings, report };
+}
+
+// ============================================================
+// CLI
+// ============================================================
+
+function parseArgs(argv) {
+  const args = {};
+  for (const a of argv.slice(2)) {
+    const m = a.match(/^--([\w-]+)(?:=(.*))?$/);
+    if (m) args[m[1]] = m[2] === undefined ? true : m[2];
+  }
+  return args;
+}
+
+function main() {
+  const args = parseArgs(process.argv);
+  const pluginRoot = args['plugin-root'] || path.resolve(__dirname, '..');
+  const r = runLabelCoverage(pluginRoot);
+  const payload = {
+    status: r.errors.length === 0 ? 0 : 1,
+    file: 'LABEL_COVERAGE',
+    errors: r.errors,
+    warnings: r.warnings,
+    report: r.report
+  };
+  process.stdout.write(JSON.stringify(payload, null, 2) + '\n');
+  return r.errors.length === 0 ? 0 : 1;
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url))) {
+  process.exit(main());
+}

package/plugins/fancy-story-builder/scripts/prompt-drift-check.js

@@ -0,0 +1,441 @@
+#!/usr/bin/env node
+/**
+ * prompt-drift-check.js
+ * 提示词 ↔ 规则文件 / 脚本 漂移检查
+ *
+ * 背景：提示词里把三样东西硬编码了，且各自独立维护，没有任何机制保证一致：
+ *   1. 公式清单与拓扑层级（骨架 30 条 / 节奏 7 条）
+ *   2. 错误代码速查表
+ *   3. 阶段边界的字段清单
+ * 一旦底层文件变化，提示词会静默过期：LLM 按过期清单算数字、
+ * 拿到没在表里解释过的错误码无从下手，产出的 derivations 缺键多键也没有任何报错。
+ *
+ * 本脚本检查：
+ *   A. 公式清单双向比对 + 条数声明核对
+ *   B. 约束清单双向比对 + 条数声明核对
+ *   C. 错误代码双向比对：脚本会发出的码，提示词里必须能查到；
+ *      提示词里提到的码，脚本必须真的会发
+ *
+ * 用法：
+ *   node prompt-drift-check.js
+ *   node prompt-drift-check.js --plugin-root=<插件目录>
+ * 退出码：0=一致  1=存在漂移  2=脚本异常
+ *
+ * 源码中零反引号。
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { runLabelCoverage } from './label-coverage.js';
+import { INFRA_CODES as INFRA_CODE_SET } from './error-classes.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const BT_CHAR = String.fromCharCode(96);
+const BT_RE = new RegExp(BT_CHAR + '([^' + BT_CHAR + ']+)' + BT_CHAR, 'g');
+
+// ============================================================
+// 参数
+// ============================================================
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const result = {};
+  for (const arg of args) {
+    // 参数名允许连字符（--plugin-root），否则该参数会被静默忽略
+    const m = arg.match(/^--([\w-]+)=(.+)$/);
+    if (m) result[m[1]] = m[2];
+  }
+  return result;
+}
+
+// ============================================================
+// 抽取
+// ============================================================
+
+/**
+ * 从 markdown 表格行里抽「序号 + 反引号包裹的名字」。
+ * 形如： | 1 | `structure.volume_count` |
+ *
+ * 返回 { names, firstLine }：firstLine 是第一行命中行在原文中的行号，
+ * 用来往上找「这份清单有 N 条」的引入句。
+ */
+export function extractTableNames(mdText) {
+  const out = [];
+  const lines = mdText.split('\n');
+  const re = new RegExp('^\\s*\\|\\s*\\d+\\s*\\|\\s*' + BT_CHAR + '([^' + BT_CHAR + ']+)' + BT_CHAR + '\\s*\\|');
+  let firstLine = -1;
+  for (let i = 0; i < lines.length; i++) {
+    const m = lines[i].match(re);
+    if (!m) continue;
+    if (firstLine < 0) firstLine = i;
+    out.push(m[1].trim());
+  }
+  return { names: out, firstLine };
+}
+
+/**
+ * 从 markdown 的无序列表里抽反引号包裹的名字。
+ * 形如： - `branch_chapter_feasible`
+ */
+export function extractListNames(mdText) {
+  const out = [];
+  const re = new RegExp('^\\s*[-*]\\s+' + BT_CHAR + '([^' + BT_CHAR + ']+)' + BT_CHAR, 'gm');
+  let m;
+  while ((m = re.exec(mdText)) !== null) {
+    out.push(m[1].trim());
+  }
+  return out;
+}
+
+/**
+ * 从指定的一行文本里抽「N 条公式 / N 条约束」这类条数声明。
+ *
+ * 只看一行，不做全文扫描：全文扫描会命中「核心铁律（本阶段最重要的 6 条约束）」
+ * 这类与公式清单无关的计数，造成误报。
+ */
+export function extractCountInLine(line, keyword) {
+  if (!line) return null;
+  const m = line.match(new RegExp('(\\d+)\\s*条' + keyword));
+  return m ? Number(m[1]) : null;
+}
+
+/**
+ * 从第 startLine 行往上最多 lookback 行，找含「N 条 keyword」的引入句。
+ */
+export function findCountClaimAbove(lines, startLine, keyword, lookback) {
+  const lb = lookback === undefined ? 6 : lookback;
+  for (let i = startLine; i >= 0 && i > startLine - lb; i--) {
+    const c = extractCountInLine(lines[i], keyword);
+    if (c !== null) return { count: c, line: i, text: lines[i].trim() };
+  }
+  return null;
+}
+
+/**
+ * 找到引入清单的那一行，并返回它之后、下一个同级标题之前的内容。
+ * anchor 是一个正则，匹配到的那一行即引入句（条数声明通常就写在这行里）。
+ */
+export function extractSectionAfter(mdText, anchorRe) {
+  const lines = mdText.split('\n');
+  let start = -1;
+  let anchorText = '';
+  for (let i = 0; i < lines.length; i++) {
+    if (anchorRe.test(lines[i])) { start = i + 1; anchorText = lines[i]; break; }
+  }
+  if (start < 0) return { section: '', anchor: '', anchorLine: -1 };
+  const out = [];
+  for (let i = start; i < lines.length; i++) {
+    const line = lines[i];
+    // 遇到新的标题行就停
+    if (/^#{1,6}\s/.test(line)) break;
+    out.push(line);
+  }
+  return { section: out.join('\n'), anchor: anchorText, anchorLine: start - 1 };
+}
+
+// ============================================================
+// 比对
+// ============================================================
+
+function diffSets(declared, actual) {
+  const declaredSet = new Set(declared);
+  const actualSet = new Set(actual);
+  const missing = actual.filter((x) => !declaredSet.has(x));   // 文件里有、提示词没列
+  const extra = declared.filter((x) => !actualSet.has(x));       // 提示词列了、文件里没有
+  return { missing, extra };
+}
+
+function compareList(label, declared, actual, errors) {
+  const d = diffSets(declared, actual);
+  for (const name of d.missing) {
+    errors.push({
+      code: 'FORMULA_LIST_MISSING',
+      path: label,
+      message: label + ' 在提示词里没有列出：' + name,
+      hint: '提示词的公式清单与公式文件脱节，LLM 会按过期清单计算'
+    });
+  }
+  for (const name of d.extra) {
+    errors.push({
+      code: 'FORMULA_LIST_EXTRA',
+      path: label,
+      message: label + ' 在提示词里列了但公式文件里没有：' + name,
+      hint: '提示词里残留了已删除或改名的公式'
+    });
+  }
+  return d;
+}
+
+// ============================================================
+// 错误代码比对
+// ============================================================
+
+// 提示词里可能出现的"大写 token"，但不是错误代码
+const NON_ERROR_CAPS = new Set([
+  'JSON', 'ID', 'TBD', 'TODO', 'PASS', 'BLOCKED', 'OK', 'TRUE', 'FALSE',
+  'CSV', 'YAML', 'MD', 'HTML', 'UTF', 'ASCII', 'URL', 'API', 'LLM', 'N/A'
+]);
+
+// 错误代码的形态：全大写、至少 2 个字符（"ENUM" / "G_ISOLATED" 都覆盖）
+const ERROR_CODE_RE = /^[A-Z][A-Z0-9_]{1,}$/;
+// 反向比对时只看带下划线的码：单字母/数字组合的 token 多半是实体 id 示例（C001 / V002）
+const UNDERSCORE_CODE_RE = /^[A-Z][A-Z0-9]*(_[A-Z0-9]+)+$/;
+
+// 基础设施类错误码：全部对应 status 2（脚本异常），提示词对这类只需说"按 BLOCKED 处理"，
+// 不需要逐条解释，因此不纳入"必须在速查表里查到"的要求。
+//
+// 定义在 error-classes.js —— 插件的驱动层用同一份判定来决定
+// "哪些错误不该甩给模型重投"，两边必须一致，不能各写一份。
+const INFRA_CODES = INFRA_CODE_SET;
+
+/**
+ * 从脚本源码里抽出所有 code: 'XXX' 的错误码。
+ */
+export function extractScriptCodes(scriptPath) {
+  const text = readText(scriptPath);
+  if (text === null) return null;
+  const out = new Set();
+  const re = /code\s*:\s*'([A-Z][A-Z0-9_]*)'/g;
+  let m;
+  while ((m = re.exec(text)) !== null) out.add(m[1]);
+  return out;
+}
+
+/**
+ * 从提示词里抽出所有被反引号包裹的全大写 token（错误代码的候选）。
+ */
+export function extractPromptCodes(mdText) {
+  const out = new Set();
+  const re = new RegExp(BT_CHAR + '([A-Z][A-Z0-9_]*)' + BT_CHAR, 'g');
+  let m;
+  while ((m = re.exec(mdText)) !== null) {
+    const token = m[1];
+    if (NON_ERROR_CAPS.has(token)) continue;
+    if (!ERROR_CODE_RE.test(token)) continue;
+    out.add(token);
+  }
+  return out;
+}
+
+/**
+ * 每个阶段：提示词文件、校验脚本、以及共享的错误码来源。
+ */
+const STAGE_CODE_SOURCES = [
+  {
+    stage: '骨架',
+    prompt: 'prompts/01-skeleton-prompt.md',
+    script: 'scripts/skeleton-validate.js',
+    // 驱动层（插件根目录的 stage-driver.js）的错误码也要扫进来：
+    // 它们全在 INFRA_CODES 里（模型改不了），所以不会要求进提示词速查表 ——
+    // 但必须被扫到，否则新增插件级码时没人知道它没被登记。
+    shared: ['scripts/graph-utils.js', 'scripts/content-quality.js', 'stage-driver.js']
+  },
+  {
+    stage: '血肉',
+    prompt: 'prompts/02-flesh-prompt.md',
+    script: 'scripts/flesh-validate.js',
+    shared: ['scripts/graph-utils.js', 'scripts/content-quality.js']
+  },
+  {
+    stage: '节奏',
+    prompt: 'prompts/03-rhythm-prompt.md',
+    script: 'scripts/rhythm-validate.js',
+    shared: ['scripts/graph-utils.js']
+  },
+  {
+    stage: '写作',
+    prompt: 'prompts/04-writing-prompt.md',
+    script: 'scripts/writing-validate.js',
+    shared: ['scripts/graph-utils.js']
+  },
+  {
+    stage: '去味',
+    prompt: 'prompts/05-deslop-prompt.md',
+    script: 'scripts/deslop-validate.js',
+    shared: ['scripts/ai-patterns.js']
+  }
+];
+
+function checkErrorCodes(pluginRoot, errors, report) {
+  for (const src of STAGE_CODE_SOURCES) {
+    const promptPath = path.join(pluginRoot, src.prompt);
+    const scriptPath = path.join(pluginRoot, src.script);
+    const promptText = readText(promptPath);
+    if (promptText === null) {
+      errors.push({ code: 'PROMPT_LOAD', path: promptPath, message: '读取' + src.stage + '阶段提示词失败', hint: null });
+      continue;
+    }
+    const actual = extractScriptCodes(scriptPath);
+    if (actual === null) {
+      errors.push({ code: 'SCRIPT_LOAD', path: scriptPath, message: '读取' + src.stage + '阶段校验脚本失败', hint: null });
+      continue;
+    }
+    for (const s of src.shared) {
+      const shared = extractScriptCodes(path.join(pluginRoot, s));
+      if (shared) for (const c of shared) actual.add(c);
+    }
+
+    const mentioned = extractPromptCodes(promptText);
+    const undocumented = [...actual].filter((c) => !mentioned.has(c) && !INFRA_CODES.has(c)).sort();
+    const stale = [...mentioned].filter((c) => UNDERSCORE_CODE_RE.test(c) && !actual.has(c)).sort();
+
+    report[src.stage + '错误码'] = {
+      scriptCount: actual.size,
+      documentedCount: [...actual].filter((c) => mentioned.has(c)).length,
+      undocumented: undocumented,
+      stale: stale
+    };
+
+    for (const c of undocumented) {
+      errors.push({
+        code: 'ERROR_CODE_UNDOCUMENTED',
+        path: src.prompt,
+        message: src.stage + '校验脚本会发出错误码 ' + c + '，但提示词里查不到',
+        hint: '在提示词的「常见错误代码速查」里补上这条，否则 LLM 拿到这个码无从下手'
+      });
+    }
+    for (const c of stale) {
+      errors.push({
+        code: 'ERROR_CODE_UNKNOWN',
+        path: src.prompt,
+        message: src.stage + '提示词里提到错误码 ' + c + '，但该阶段脚本不会发出这个码',
+        hint: '提示词残留了过期或写错的错误码（也可能是串到了别的阶段的码）'
+      });
+    }
+  }
+}
+
+// ============================================================
+// 主流程
+// ============================================================
+
+function readText(p) {
+  try {
+    return fs.readFileSync(p, 'utf-8');
+  } catch (e) {
+    return null;
+  }
+}
+
+function readJson(p) {
+  const t = readText(p);
+  if (t === null) return null;
+  try {
+    return JSON.parse(t);
+  } catch (e) {
+    return null;
+  }
+}
+
+export function runDriftCheck(pluginRoot) {
+  const errors = [];
+  const warnings = [];
+  const report = {};
+
+  // ---------- 骨架：公式清单 ----------
+  const skFormulaPath = path.join(pluginRoot, 'references', 'formulas-skeleton.json');
+  const skPromptPath = path.join(pluginRoot, 'prompts', '01-skeleton-prompt.md');
+  const skFormulas = readJson(skFormulaPath);
+  const skPrompt = readText(skPromptPath);
+  if (!skFormulas) {
+    errors.push({ code: 'FORMULAS_LOAD', path: skFormulaPath, message: '读取或解析 formulas-skeleton.json 失败', hint: null });
+  } else if (!skPrompt) {
+    errors.push({ code: 'PROMPT_LOAD', path: skPromptPath, message: '读取骨架提示词失败', hint: null });
+  } else {
+    const actual = Object.keys(skFormulas.formulas || {});
+    const table = extractTableNames(skPrompt);
+    const declared = table.names;
+    report.skeleton = { declaredCount: declared.length, actualCount: actual.length };
+    if (declared.length === 0) {
+      errors.push({
+        code: 'FORMULA_LIST_UNPARSED',
+        path: skPromptPath,
+        message: '没能从骨架提示词里解析出公式清单表格',
+        hint: '提示词的公式清单表格结构可能变了（形如 | 1 | `name` | 的行）'
+      });
+    } else {
+      compareList('骨架公式', declared, actual, errors);
+      // 条数声明：只看清单表格正上方那几行里"N 条公式"的声明
+      const claim = findCountClaimAbove(skPrompt.split('\n'), table.firstLine, '公式');
+      if (claim && claim.count !== actual.length) {
+        errors.push({
+          code: 'FORMULA_COUNT_MISMATCH',
+          path: skPromptPath,
+          message: '提示词声明「' + claim.count + ' 条公式」，但 formulas-skeleton.json 里实际是 ' + actual.length + ' 条',
+          hint: '同步提示词里的条数声明与公式清单'
+        });
+      }
+    }
+  }
+
+  // ---------- 节奏：约束清单 ----------
+  const rhFormulaPath = path.join(pluginRoot, 'references', 'formulas-rhythm.json');
+  const rhPromptPath = path.join(pluginRoot, 'prompts', '03-rhythm-prompt.md');
+  const rhFormulas = readJson(rhFormulaPath);
+  const rhPrompt = readText(rhPromptPath);
+  if (!rhFormulas) {
+    errors.push({ code: 'FORMULAS_LOAD', path: rhFormulaPath, message: '读取或解析 formulas-rhythm.json 失败', hint: null });
+  } else if (!rhPrompt) {
+    errors.push({ code: 'PROMPT_LOAD', path: rhPromptPath, message: '读取节奏提示词失败', hint: null });
+  } else {
+    const actual = Object.keys(rhFormulas.constraints || {});
+    const anchor = extractSectionAfter(rhPrompt, /constraints.*节中的\s*\d+\s*条约束名/);
+    const declared = extractListNames(anchor.section);
+    report.rhythm = { declaredCount: declared.length, actualCount: actual.length };
+    if (declared.length === 0) {
+      errors.push({
+        code: 'CONSTRAINT_LIST_UNPARSED',
+        path: rhPromptPath,
+        message: '没能从节奏提示词里解析出约束名清单',
+        hint: '提示词的约束清单结构可能变了（形如 - `constraint_name` 的行）'
+      });
+    } else {
+      compareList('节奏约束', declared, actual, errors);
+      // 条数声明写在引入句里
+      const claim = extractCountInLine(anchor.anchor, '约束');
+      if (claim !== null && claim !== actual.length) {
+        errors.push({
+          code: 'CONSTRAINT_COUNT_MISMATCH',
+          path: rhPromptPath,
+          message: '提示词声明「' + claim + ' 条约束」，但 formulas-rhythm.json 里实际是 ' + actual.length + ' 条',
+          hint: '同步提示词里的条数声明与约束清单'
+        });
+      }
+    }
+  }
+
+  // ---------- 错误代码 ----------
+  checkErrorCodes(pluginRoot, errors, report);
+
+  // ---------- 模板字段中文标签覆盖 ----------
+  // 模板加了新字段却忘了在 FIELD_CN / CONTEXTUAL_LABEL 里加中文标签，
+  // 产物 md 里就会直接显示英文 key（2026-10 血肉阶段产物复查发现过 103 个这种字段）。
+  {
+    const cov = runLabelCoverage(pluginRoot);
+    for (const e of cov.errors) errors.push(e);
+    for (const w of cov.warnings) warnings.push(w);
+    report.模板字段标签覆盖 = cov.report.labelCoverage;
+  }
+
+  return { errors, warnings, report };
+}
+
+function main() {
+  const args = parseArgs();
+  const pluginRoot = args['plugin-root'] || path.resolve(__dirname, '..');
+  const r = runDriftCheck(pluginRoot);
+  const payload = {
+    status: r.errors.length === 0 ? 0 : 1,
+    file: 'PROMPT_DRIFT',
+    errors: r.errors,
+    warnings: r.warnings,
+    report: r.report
+  };
+  process.stdout.write(JSON.stringify(payload, null, 2) + '\n');
+  return r.errors.length === 0 ? 0 : 1;
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url))) {
+  process.exit(main());
+}