@customize-agent/server 4.59.2 → 4.60.0

package/scripts/check-workspace-deps.cjs

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+/**
+ * 工作区依赖产物新鲜度闸（挂在 apps/server 的 `prebuild`）。
+ *
+ * ## 为什么需要
+ * `apps/server` 的 build 只跑 `next build`，**不会**重建 `packages/*`；而 `next.config.ts`
+ * 把 `@customize-agent/{knowledge,llm,runtime}` 列为 `serverExternalPackages` —— 运行时直接
+ * require 各包的 `dist`（各包 package.json 的 main/exports 都指向 dist）。于是「在 apps/server
+ * 里 build」会把旧 dist 静默编进产物：改了 packages 源码却看不到效果，且不报错。
+ * 依赖包先建只由仓库根目录 `pnpm build` 的 turbo `^build` 保证。
+ *
+ * ## 口径
+ * 逐包比较 `src/**` 与 `tsconfig.json` 的最新 mtime 和 `dist/**` 的最新 mtime：
+ * src 侧更新 ⇒ 落后；`dist/` 不存在 ⇒ 未构建。两种情况直接放行：
+ * - turbo 任务内（`TURBO_HASH` / `TURBO_INVOCATION_DIR` 存在）：`^build` 已保证依赖先建；
+ * - 非 monorepo 布局（同级没有 packages/，如已发布的 npm 包）。
+ * mtime 是粗口径：`git checkout` 触碰过源码也会判落后——代价只是提示去根目录 build
+ * （turbo 有缓存，通常几秒），比「静默用旧 dist」安全。
+ *
+ * 用法：node scripts/check-workspace-deps.cjs [packagesDir]
+ * 退出码：0=新鲜/放行；1=落后。
+ */
+const fs = require('fs');
+const path = require('path');
+
+const serverRoot = path.resolve(__dirname, '..');
+const defaultPackagesDir = path.resolve(serverRoot, '..', '..', 'packages');
+
+/** 依赖闭包（含编译期依赖 types）：其中任何一个包改动，server 产物都可能过期 */
+const WORKSPACE_DEPS = [
+  '@customize-agent/types',
+  '@customize-agent/llm',
+  '@customize-agent/runtime',
+  '@customize-agent/knowledge',
+];
+
+function newestFileMtime(dir, found = { mtime: 0, file: '' }) {
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return found;
+  }
+  for (const entry of entries) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) newestFileMtime(full, found);
+    else if (entry.isFile()) {
+      const mtime = fs.statSync(full).mtimeMs;
+      if (mtime > found.mtime) {
+        found.mtime = mtime;
+        found.file = full;
+      }
+    }
+  }
+  return found;
+}
+
+function inspectPackage(packagesDir, name) {
+  const dir = path.join(packagesDir, name.slice('@customize-agent/'.length));
+  if (!fs.existsSync(path.join(dir, 'package.json'))) return null; // 非工作区成员 → 跳过
+
+  const src = newestFileMtime(path.join(dir, 'src'));
+  const tsconfig = path.join(dir, 'tsconfig.json');
+  if (fs.existsSync(tsconfig)) {
+    const mtime = fs.statSync(tsconfig).mtimeMs;
+    if (mtime > src.mtime) {
+      src.mtime = mtime;
+      src.file = tsconfig;
+    }
+  }
+
+  const distDir = path.join(dir, 'dist');
+  if (!fs.existsSync(distDir)) return { name, dir, reason: 'missing-dist', src };
+  const dist = newestFileMtime(distDir);
+  if (src.mtime > dist.mtime) return { name, dir, reason: 'stale', src, dist };
+  return { name, dir, reason: null };
+}
+
+/** 手工格式化本地时间：不依赖 locale/ICU（跨平台口径一致），也不用 shell 的 date */
+function formatTime(ms) {
+  if (!ms) return '(none)';
+  const date = new Date(ms);
+  const pad = value => String(value).padStart(2, '0');
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} `
+    + `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
+}
+
+/** 优先显示仓库根目录相对路径，越界（测试夹具在 tmp 里）则显示绝对路径 */
+function displayPath(file) {
+  const rel = path.relative(path.resolve(serverRoot, '..', '..'), file);
+  return rel.startsWith('..') ? file : rel;
+}
+
+function usage() {
+  console.log(`Usage: node scripts/check-workspace-deps.cjs [packagesDir]
+
+Verifies that the workspace packages consumed by the server (types / llm / runtime /
+knowledge) have dist/ artifacts newer than their src/. Wired as \`prebuild\` so a build
+run inside apps/server cannot silently embed stale package code.
+
+Exit 0 when fresh, when running under turbo (^build already ordered the deps),
+or when packagesDir does not exist (published package layout).
+Exit 1 with a remedy when stale.`);
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  if (args.includes('--help') || args.includes('-h')) {
+    usage();
+    return 0;
+  }
+  // turbo 任务内：依赖已按 ^build 先建（或从缓存恢复）→ 不阻塞根目录构建
+  if (process.env.TURBO_HASH || process.env.TURBO_INVOCATION_DIR) return 0;
+
+  const packagesDir = path.resolve(
+    args[0] || process.env.CUSTOMIZE_WORKSPACE_PACKAGES_DIR || defaultPackagesDir,
+  );
+  if (!fs.existsSync(packagesDir)) return 0; // 发布包布局：没有 packages/ 同级目录
+
+  const problems = [];
+  for (const name of WORKSPACE_DEPS) {
+    const result = inspectPackage(packagesDir, name);
+    if (result && result.reason) problems.push(result);
+  }
+  if (problems.length === 0) return 0;
+
+  console.error('[server] Stale workspace dependency artifacts — the build would embed old dist code:');
+  for (const problem of problems) {
+    if (problem.reason === 'missing-dist') {
+      console.error(`[server]   ${problem.name}: dist/ not built yet`);
+    } else {
+      console.error(
+        `[server]   ${problem.name}: src ${formatTime(problem.src.mtime)} (${displayPath(problem.src.file)}) is newer than dist ${formatTime(problem.dist.mtime)}`,
+      );
+    }
+  }
+  console.error('[server] Run `pnpm build` at the monorepo root first (turbo rebuilds packages/* in dependency order), then build the server again.');
+  return 1;
+}
+
+if (require.main === module) process.exit(main());

package/scripts/half-built-scan.allow.json

@@ -0,0 +1,142 @@
+{
+  "version": 1,
+  "note": "半成品扫描的**登记表**：这些导出在生产里零引用是**设计如此**（测试钩子/观察面/登记自证面/零命中不接入）。新增未登记项会在扫描里单列 ⇒ 由人/智能体当场判，不再堆成待办。 ★ 2026-09-30 追加：不可判（星号再导出）也纳入同一登记表——本文件内自用/测试面的符号不再进待判。",
+  "entries": [
+    {
+      "file": "apps/server/src/lib/api.ts",
+      "symbol": "__resetExportReceiptForTest",
+      "reason": "测试钩子（重置/探针）：只有用例需要，生产不该调用"
+    },
+    {
+      "file": "apps/server/src/lib/i18n.ts",
+      "symbol": "resetMissingTranslationKeys",
+      "reason": "测试钩子（重置/探针）：只有用例需要，生产不该调用"
+    },
+    {
+      "file": "apps/server/src/lib/i18n.ts",
+      "symbol": "catalogKeyParity",
+      "reason": "观察面/查询面（口径可穷举）：供用例与审计读，生产路径不直接调用"
+    },
+    {
+      "file": "apps/server/src/pages/api/documents/canvas/[id].ts",
+      "symbol": "isAggregateFoldSummary",
+      "reason": "观察面/查询面（口径可穷举）：供用例与审计读，生产路径不直接调用"
+    },
+    {
+      "file": "apps/server/src/pages/api/documents/export.ts",
+      "symbol": "__documentExportTest__",
+      "reason": "测试钩子（重置/探针）：只有用例需要，生产不该调用"
+    },
+    {
+      "file": "apps/server/src/services/agent/artifacts.ts",
+      "symbol": "hasArtifact",
+      "reason": "观察面/查询面（口径可穷举）：供用例与审计读，生产路径不直接调用"
+    },
+    {
+      "file": "apps/server/src/services/agent/eventBus.ts",
+      "symbol": "resetEventBusForTest",
+      "reason": "测试钩子（重置/探针）：只有用例需要，生产不该调用"
+    },
+    {
+      "file": "apps/server/src/services/agent/eventBus.ts",
+      "symbol": "flushSubscriptions",
+      "reason": "测试/审计读面：用例据此读工具表/任务表/蓝图/事件总线"
+    },
+    {
+      "file": "apps/server/src/services/agent/eventBus.ts",
+      "symbol": "subscriberCount",
+      "reason": "观察面/查询面（口径可穷举）：供用例与审计读，生产路径不直接调用"
+    },
+    {
+      "file": "apps/server/src/services/agent/loopBudget.ts",
+      "symbol": "resetBudgetMeters",
+      "reason": "测试钩子（重置/探针）：只有用例需要，生产不该调用"
+    },
+    {
+      "file": "apps/server/src/services/agent/toolRegistry.ts",
+      "symbol": "getTool",
+      "reason": "测试/审计读面：用例据此读工具表/任务表/蓝图/事件总线"
+    },
+    {
+      "file": "apps/server/src/services/agent/toolRegistry.ts",
+      "symbol": "TOOL_GROUP_COUNTS",
+      "reason": "登记表/账本的机械自证面：用例据此核对登记与实现一致；生产不需要调用"
+    },
+    {
+      "file": "apps/server/src/services/document-core/documentDomainProfileService.ts",
+      "symbol": "fieldMatchesCategory",
+      "reason": "观察面/查询面（口径可穷举）：供用例与审计读，生产路径不直接调用"
+    },
+    {
+      "file": "apps/server/src/services/document-core/generatedDocumentService.ts",
+      "symbol": "setProcessAliveProbeForTest",
+      "reason": "测试钩子（重置/探针）：只有用例需要，生产不该调用"
+    },
+    {
+      "file": "apps/server/src/services/document-core/generatedDocumentService.ts",
+      "symbol": "getGenerateTask",
+      "reason": "测试/审计读面：用例据此读工具表/任务表/蓝图/事件总线"
+    },
+    {
+      "file": "apps/server/src/services/document-workflow/costModel.ts",
+      "symbol": "resetCostModelCaches",
+      "reason": "测试钩子（重置/探针）：只有用例需要，生产不该调用"
+    },
+    {
+      "file": "apps/server/src/services/document-workflow/envRegistry.ts",
+      "symbol": "unregisteredAppEnvVars",
+      "reason": "登记表/账本的机械自证面：用例据此核对登记与实现一致；生产不需要调用"
+    },
+    {
+      "file": "apps/server/src/services/document-workflow/generationStages/generationSession.ts",
+      "symbol": "createEmptyGenerationSession",
+      "reason": "测试钩子：构造空会话的最小骨架（生产总是由真实输入建会话）"
+    },
+    {
+      "file": "apps/server/src/services/document-workflow/integratedBlueprint.ts",
+      "symbol": "loadBlueprintAsset",
+      "reason": "测试/审计读面：用例据此读工具表/任务表/蓝图/事件总线"
+    },
+    {
+      "file": "apps/server/src/services/document-workflow/llmClient.ts",
+      "symbol": "resetEmptyStormStreak",
+      "reason": "测试钩子（重置/探针）：只有用例需要，生产不该调用"
+    },
+    {
+      "file": "apps/server/src/services/document-workflow/llmClient.ts",
+      "symbol": "activeLlmCallCount",
+      "reason": "观察面/查询面（口径可穷举）：供用例与审计读，生产路径不直接调用"
+    },
+    {
+      "file": "apps/server/src/services/document-workflow/llmClient.ts",
+      "symbol": "resetLlmSlotStateForTest",
+      "reason": "测试钩子（重置/探针）：只有用例需要，生产不该调用"
+    },
+    {
+      "file": "apps/server/src/services/document-workflow/semanticSimilarity.ts",
+      "symbol": "clearEmbedCacheForTest",
+      "reason": "测试钩子（重置/探针）：只有用例需要，生产不该调用"
+    },
+    {
+      "file": "apps/server/src/services/knowledge/kbService.ts",
+      "symbol": "shutdownKbService",
+      "reason": "测试钩子（重置/探针）：只有用例需要，生产不该调用"
+    },
+    {
+      "file": "apps/server/src/services/agent/emitNode.ts",
+      "symbol": "resetEmitNodeState",
+      "reason": "实际节点生产器emitNode的进程状态重置测试面，隔离轮次/幂等状态；非未接入业务函数。"
+    },
+    {
+      "file": "apps/server/src/services/document-workflow/semanticSimilarity.ts",
+      "symbol": "snapshotEmbedCacheStats",
+      "reason": "实际事实检索、agentPlanner/evidence/Native阶段共用的embedding缓存统计只读测试观察面；不承担正文雷同删除或写作评分。"
+    },
+    {
+      "file": "apps/server/src/services/document-workflow/sourceVersionPolicy.ts",
+      "symbol": "isAuthenticatedSourceVersionPolicy",
+      "reason": "实际SourceVersionPolicy WeakSet认证状态只读测试面，验证伪造/恢复前后的真实来源权限；非模型声明或验收通过资格。"
+    }
+  ],
+  "retirementUpdatedAt": "2026-10-10T18:16:44.738Z"
+}

package/scripts/half-built-scan.baseline.json

@@ -0,0 +1,206 @@
+{
+  "note": "半成品扫描门禁基线（棘轮：数不许变多）。重新生成：node apps/server/scripts/half-built-scan.mjs --write-baseline",
+  "generatedAt": "2026-09-29",
+  "scope": [
+    "apps/server/src",
+    "packages"
+  ],
+  "counts": {
+    "谁都不用": 0,
+    "半成品嫌疑": 22,
+    "封装暴露（只导出给测试）": 158,
+    "不可判（星号再导出）": 0
+  },
+  "roster": {
+    "谁都不用": [],
+    "半成品嫌疑": [
+      "apps/server/src/lib/i18n.ts::catalogKeyParity",
+      "apps/server/src/lib/i18n.ts::resetMissingTranslationKeys",
+      "apps/server/src/pages/api/documents/canvas/[id].ts::isAggregateFoldSummary",
+      "apps/server/src/pages/api/documents/export.ts::__documentExportTest__",
+      "apps/server/src/services/agent/eventBus.ts::flushSubscriptions",
+      "apps/server/src/services/agent/eventBus.ts::resetEventBusForTest",
+      "apps/server/src/services/agent/eventBus.ts::subscriberCount",
+      "apps/server/src/services/agent/loopBudget.ts::resetBudgetMeters",
+      "apps/server/src/services/agent/toolRegistry.ts::TOOL_GROUP_COUNTS",
+      "apps/server/src/services/agent/toolRegistry.ts::getTool",
+      "apps/server/src/services/document-core/documentDomainProfileService.ts::fieldMatchesCategory",
+      "apps/server/src/services/document-core/generatedDocumentService.ts::getGenerateTask",
+      "apps/server/src/services/document-core/generatedDocumentService.ts::setProcessAliveProbeForTest",
+      "apps/server/src/services/document-workflow/costModel.ts::resetCostModelCaches",
+      "apps/server/src/services/document-workflow/envRegistry.ts::unregisteredAppEnvVars",
+      "apps/server/src/services/document-workflow/generationStages/generationSession.ts::createEmptyGenerationSession",
+      "apps/server/src/services/document-workflow/integratedBlueprint.ts::loadBlueprintAsset",
+      "apps/server/src/services/document-workflow/llmClient.ts::activeLlmCallCount",
+      "apps/server/src/services/document-workflow/llmClient.ts::resetEmptyStormStreak",
+      "apps/server/src/services/document-workflow/llmClient.ts::resetLlmSlotStateForTest",
+      "apps/server/src/services/document-workflow/semanticSimilarity.ts::clearEmbedCacheForTest",
+      "apps/server/src/services/knowledge/kbService.ts::shutdownKbService"
+    ],
+    "封装暴露（只导出给测试）": [
+      "apps/server/src/components/Canvas/DeliverablePreview.tsx::bodySourceText",
+      "apps/server/src/components/Canvas/activeAgents.ts::ACTIVE_AGENT_LIMIT",
+      "apps/server/src/components/Canvas/activeAgents.ts::RECENT_DONE_MS",
+      "apps/server/src/components/Canvas/activeAgents.ts::agentKindLabel",
+      "apps/server/src/components/Canvas/handoff.ts::HANDOFF_FRESH_MS",
+      "apps/server/src/components/Canvas/handoff.ts::HANDOFF_MAX",
+      "apps/server/src/components/Canvas/handoff.ts::clipLabel",
+      "apps/server/src/components/Canvas/handoff.ts::handoffLabel",
+      "apps/server/src/components/Canvas/handoff.ts::metricsLabel",
+      "apps/server/src/components/Canvas/handoff.ts::reversedEdgePath",
+      "apps/server/src/components/Canvas/nodeView.ts::DOC_STATUS_TEXT",
+      "apps/server/src/components/Canvas/nodeView.ts::NODE_STATUS_TEXT",
+      "apps/server/src/components/Canvas/nodeView.ts::NODE_TYPE_LABELS",
+      "apps/server/src/components/Canvas/useCanvasViewport.ts::FOLLOW_EDGE_RATIO",
+      "apps/server/src/hooks/useGenerationState.ts::buildFlowStepsFromNodes",
+      "apps/server/src/hooks/useGenerationState.ts::stageIconFor",
+      "apps/server/src/lib/i18n.ts::flattenCatalogKeys",
+      "apps/server/src/lib/i18n.ts::getMissingTranslationKeys",
+      "apps/server/src/lib/markdownPreview.ts::createPreviewStats",
+      "apps/server/src/lib/markdownPreview.ts::decodePreviewEntities",
+      "apps/server/src/lib/markdownPreview.ts::escapePreviewText",
+      "apps/server/src/lib/markdownPreview.ts::isSafePreviewUrl",
+      "apps/server/src/lib/markdownPreview.ts::sanitizePreviewHtml",
+      "apps/server/src/pages/api/documents/canvas/[id].ts::FOLD_SUMMARY_MARK",
+      "apps/server/src/pages/api/documents/canvas/[id].ts::foldAggregateStageDetails",
+      "apps/server/src/pages/api/skills/index.ts::skillEditorOptions",
+      "apps/server/src/services/agent/auditCapability.ts::normalizeClarificationQuestion",
+      "apps/server/src/services/agent/capabilityGaps.ts::CAPABILITY_GAPS",
+      "apps/server/src/services/agent/emitNode.ts::PHASE_ROOTS",
+      "apps/server/src/services/agent/emitNode.ts::stageIdentity",
+      "apps/server/src/services/agent/eventBus.ts::BoundedEventBuffer",
+      "apps/server/src/services/agent/eventBus.ts::EVENT_BUS_GLOBAL_KEY",
+      "apps/server/src/services/agent/eventBus.ts::eventBusState",
+      "apps/server/src/services/agent/eventBus.ts::publishGenerationEvent",
+      "apps/server/src/services/agent/loopBudget.ts::cacheShareText",
+      "apps/server/src/services/agent/loopBudget.ts::configureBudgetMeter",
+      "apps/server/src/services/agent/loopBudget.ts::isFallbackMeter",
+      "apps/server/src/services/agent/nodeImpact.ts::IMPACT_ESCALATION_THRESHOLD",
+      "apps/server/src/services/agent/nodeLog.ts::appendNodeEvent",
+      "apps/server/src/services/agent/nodeLog.ts::assertNodeShape",
+      "apps/server/src/services/agent/nodeRollup.ts::NODE_STATUS_PRECEDENCE",
+      "apps/server/src/services/agent/nodeRollup.ts::nodeChildrenIndex",
+      "apps/server/src/services/agent/nodeRollup.ts::nodeDepths",
+      "apps/server/src/services/agent/nodeTypes.ts::AGENT_NODE_TYPES",
+      "apps/server/src/services/agent/nodeTypes.ts::NODE_STATUSES",
+      "apps/server/src/services/agent/repairStore.ts::RepairStoreError",
+      "apps/server/src/services/agent/repairStore.ts::collectRepairFeedback",
+      "apps/server/src/services/agent/repairStore.ts::readRepairHistory",
+      "apps/server/src/services/agent/repairStore.ts::repairLocalizationProbes",
+      "apps/server/src/services/agent/repairStore.ts::repairLogPath",
+      "apps/server/src/services/agent/repairStore.ts::toRepairFeedbackEntry",
+      "apps/server/src/services/agent/repairTransaction.ts::decideRepairOutcome",
+      "apps/server/src/services/agent/toolEnvelope.ts::INJECTION_PATTERNS",
+      "apps/server/src/services/agent/toolEnvelope.ts::detectInjection",
+      "apps/server/src/services/agent/toolRegistry.ts::ALL_TOOLS",
+      "apps/server/src/services/agent/toolRegistry.ts::toolNames",
+      "apps/server/src/services/agent/writerLoopBlock.ts::unfixableDeclarationOf",
+      "apps/server/src/services/common/errorLogService.ts::createProcessErrorHandler",
+      "apps/server/src/services/common/safePath.ts::rejectRelativePath",
+      "apps/server/src/services/common/safePath.ts::resolveInsideOrNull",
+      "apps/server/src/services/common/serviceState.ts::getFirstStartedAt",
+      "apps/server/src/services/common/serviceState.ts::serviceStatePath",
+      "apps/server/src/services/document-core/generatedDocumentService.ts::buildResumeInitialRecord",
+      "apps/server/src/services/document-core/generatedDocumentService.ts::hasActiveTaskForProject",
+      "apps/server/src/services/document-core/generatedDocumentService.ts::upsertGeneratedAssets",
+      "apps/server/src/services/document-core/generatedDocumentService.ts::upsertGeneratedDocumentAsset",
+      "apps/server/src/services/document-workflow/agentWorkflow.ts::scopedMaterialRootsOf",
+      "apps/server/src/services/document-workflow/authoritativeValues.ts::attributeValueShapeMismatch",
+      "apps/server/src/services/document-workflow/authoritativeValues.ts::cleanValueForm",
+      "apps/server/src/services/document-workflow/authoritativeValues.ts::stripTrailingOcrGarbage",
+      "apps/server/src/services/document-workflow/constructionBidStructure.ts::representativeTitleForPattern",
+      "apps/server/src/services/document-workflow/constructionProcessKnowledge.ts::CARD_TYPE_REPLACEMENTS",
+      "apps/server/src/services/document-workflow/constructionProcessKnowledge.ts::PROCESS_CARD_TYPE_BINDING_DEFERRED",
+      "apps/server/src/services/document-workflow/constructionProcessKnowledge.ts::STANDARDS_PENDING_CALIBRATION",
+      "apps/server/src/services/document-workflow/costModel.ts::DEFAULT_PRICE_PROVENANCE",
+      "apps/server/src/services/document-workflow/costModel.ts::DEFAULT_PRICE_TABLE",
+      "apps/server/src/services/document-workflow/costModel.ts::DETERIORATION_THRESHOLDS",
+      "apps/server/src/services/document-workflow/costModel.ts::applyDeteriorationActions",
+      "apps/server/src/services/document-workflow/costModel.ts::parsePriceOverride",
+      "apps/server/src/services/document-workflow/costModel.ts::priceEntryFor",
+      "apps/server/src/services/document-workflow/costModel.ts::priceKeyOf",
+      "apps/server/src/services/document-workflow/costModel.ts::priceTable",
+      "apps/server/src/services/document-workflow/defectHeatmap.ts::REPAIR_ATTRIBUTION_LABELS",
+      "apps/server/src/services/document-workflow/defectHeatmap.ts::REPAIR_FEEDBACK_STUBBORN_THRESHOLD",
+      "apps/server/src/services/document-workflow/documentInstruction.ts::INSTRUCTION_KINDS",
+      "apps/server/src/services/document-workflow/documentInstruction.ts::INSTRUCTION_KIND_LABELS",
+      "apps/server/src/services/document-workflow/documentInstruction.ts::classifyInstructionByRules",
+      "apps/server/src/services/document-workflow/documentInstruction.ts::extractInstructionTarget",
+      "apps/server/src/services/document-workflow/envRegistry.ts::AGENT_ENV_REGISTRY",
+      "apps/server/src/services/document-workflow/envRegistry.ts::APP_ENV_PREFIXES",
+      "apps/server/src/services/document-workflow/envRegistry.ts::APP_ENV_REGISTRY",
+      "apps/server/src/services/document-workflow/envRegistry.ts::CUSTOMIZE_ENV_REGISTRY",
+      "apps/server/src/services/document-workflow/factGovernance.ts::SUPPORT_FORM_LEXICON",
+      "apps/server/src/services/document-workflow/factGovernance.ts::applyScopeOverridesToText",
+      "apps/server/src/services/document-workflow/factGovernance.ts::collectMarkdownTableCandidates",
+      "apps/server/src/services/document-workflow/factGovernance.ts::collectStructuredFactCandidates",
+      "apps/server/src/services/document-workflow/factGovernance.ts::numericScopeResolutions",
+      "apps/server/src/services/document-workflow/factGovernance.ts::resolveCanonicalFacts",
+      "apps/server/src/services/document-workflow/factGovernance.ts::unitReForKind",
+      "apps/server/src/services/document-workflow/factsModel.ts::sanitizeFactPool",
+      "apps/server/src/services/document-workflow/hazardBinding.ts::billOfQuantitiesCorpus",
+      "apps/server/src/services/document-workflow/hazardBinding.ts::extractHazardParameters",
+      "apps/server/src/services/document-workflow/hazardBinding.ts::normalizeParameterValue",
+      "apps/server/src/services/document-workflow/integratedBlueprint/parse.ts::isStructuralOnlyBillFile",
+      "apps/server/src/services/document-workflow/integratedBlueprint/render.ts::AUTHORITY_DOMAIN_REGISTRY",
+      "apps/server/src/services/document-workflow/integratedBlueprint/render.ts::alignmentAnchorsForChapter",
+      "apps/server/src/services/document-workflow/integratedBlueprint/render.ts::assertAuthorityDomainChannels",
+      "apps/server/src/services/document-workflow/integratedBlueprint/render.ts::authorityDomainChannelReport",
+      "apps/server/src/services/document-workflow/llmCassette.ts::CASSETTE_PROMPT_VERSION",
+      "apps/server/src/services/document-workflow/llmCassette.ts::CassetteMissError",
+      "apps/server/src/services/document-workflow/llmCassette.ts::cassetteDir",
+      "apps/server/src/services/document-workflow/llmCassette.ts::cassetteMode",
+      "apps/server/src/services/document-workflow/llmClient.ts::flushScheduledLaunches",
+      "apps/server/src/services/document-workflow/llmClient.ts::judgeThinkingEnabled",
+      "apps/server/src/services/document-workflow/materialResidue.ts::drawingPointerPhraseHits",
+      "apps/server/src/services/document-workflow/planningArtifactCache.ts::PLANNING_ARTIFACT_CACHE_VERSION",
+      "apps/server/src/services/document-workflow/poolNoise.ts::penaltyTableHitCount",
+      "apps/server/src/services/document-workflow/promptRuleExtraction.ts::dedupePlannedSections",
+      "apps/server/src/services/document-workflow/promptRuleExtraction.ts::extractOutlineHeadings",
+      "apps/server/src/services/document-workflow/resumeLedger.ts::isManualIssue",
+      "apps/server/src/services/document-workflow/structureIntegrityRules.ts::tailOrphanBlockIssues",
+      "apps/server/src/services/document-workflow/textMatch.ts::chineseTokenMatchScore",
+      "apps/server/src/services/document-workflow/textMatch.ts::chineseTokens",
+      "apps/server/src/services/knowledge/kbExportService.ts::stripCadMetadataLines",
+      "apps/server/src/services/knowledge/kbExportService.ts::trimChunkOverlap",
+      "apps/server/src/services/knowledge/kbExportService.ts::txtEntryNameFor",
+      "apps/server/src/services/knowledge/kbIndexWorkerService.ts::enqueueKnowledgeIndex",
+      "apps/server/src/services/knowledge/kbService.ts::getKnownProjectRoots",
+      "apps/server/src/services/skills/blockKnowledge.ts::selectBlockCards",
+      "apps/server/src/services/skills/match.ts::assertFocusRuleMapping",
+      "apps/server/src/services/skills/match.ts::chapterDomainPatterns",
+      "apps/server/src/services/skills/schema.ts::MAX_SECTION_REGEX_LENGTH",
+      "apps/server/src/services/skills/store.ts::applySkillOverride",
+      "apps/server/src/services/skills/store.ts::skillFilePath",
+      "apps/server/src/services/skills/store.ts::skillsDir",
+      "packages/knowledge/src/core/knowledge-base-manager.ts::diversifiedRerankCandidates",
+      "packages/knowledge/src/extraction/content-extractor.ts::collapseAdjacentRepeatedLines",
+      "packages/knowledge/src/extraction/content-extractor.ts::extractTopLevelOoxmlElements",
+      "packages/knowledge/src/extraction/content-extractor.ts::isPdfWrappedClauseLike",
+      "packages/knowledge/src/extraction/content-extractor.ts::ocrPageCacheKeyOf",
+      "packages/knowledge/src/extraction/content-extractor.ts::reorderPdfRowsAroundWrappedParagraphs",
+      "packages/knowledge/src/extraction/ocr-providers.ts::OCR_NEIGHBOR_CONFUSION_LOW_CONFIDENCE",
+      "packages/knowledge/src/extraction/ocr-providers.ts::PaddleOcrJsProvider",
+      "packages/knowledge/src/extraction/ocr-providers.ts::TesseractJsProvider",
+      "packages/knowledge/src/extraction/ocr-providers.ts::gateOcrNeighborClassConfusions",
+      "packages/knowledge/src/extraction/ocr-providers.ts::resolveOcrSessionThreads",
+      "packages/knowledge/src/extraction/ocr-providers.ts::withOcrSessionThreads",
+      "packages/knowledge/src/extraction/ocr-tiling.ts::assembleTiledText",
+      "packages/knowledge/src/extraction/ocr-tiling.ts::cropRgbTile",
+      "packages/knowledge/src/extraction/ocr-tiling.ts::filterTiledRegions",
+      "packages/knowledge/src/extraction/ocr-tiling.ts::mergeTileRegions",
+      "packages/knowledge/src/extraction/office-embedded-images.ts::MIN_EMBEDDED_IMAGE_BYTES",
+      "packages/knowledge/src/extraction/office-embedded-images.ts::carveImageCandidates",
+      "packages/knowledge/src/extraction/office-embedded-images.ts::carveJpeg",
+      "packages/knowledge/src/extraction/office-embedded-images.ts::carvePng",
+      "packages/knowledge/src/extraction/paddle-model-select.ts::MIN_ONNX_BYTES",
+      "packages/knowledge/src/extraction/paddle-model-select.ts::PADDLE_MODEL_FILES",
+      "packages/knowledge/src/extraction/paddle-model-select.ts::PADDLE_MODEL_PRESET"
+    ],
+    "不可判（星号再导出）": []
+  },
+  "retirementUpdatedAt": "2026-10-10T18:16:44.719Z",
+  "retirementUpdate": "Only remove actually absent export declarations; reconcile counts to retained roster lengths. No baseline regeneration, added allowances or swallowed new dead declarations.",
+  "retirementCountReconciledAt": "2026-10-10T01:23:32.058Z",
+  "retirementCountReconciliation": "Reconciles 296 count to exact existing 294-row test-only export roster after prior two retirements; no rows/allowances added and zero-dead-symbol hard cap retained."
+}