@customize-agent/server 4.60.34 → 4.60.36

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

@@ -1,152 +0,0 @@
-{
-  "version": 1,
-  "note": "引用扫描登记：每项须有具体的测试、观察或内部用途；新增零引用或仅测试候选须独立核查，不能用登记掩盖未接入业务。",
-  "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/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": "实际事实检索、evidence/Native阶段共用的embedding缓存统计只读测试观察面；不承担正文雷同删除或写作评分。"
-    },
-    {
-      "file": "apps/server/src/services/document-workflow/sourceVersionPolicy.ts",
-      "symbol": "isAuthenticatedSourceVersionPolicy",
-      "reason": "实际SourceVersionPolicy WeakSet认证状态只读测试面，验证伪造/恢复前后的真实来源权限；非模型声明或验收通过资格。"
-    },
-    {
-      "file": "apps/server/src/lib/i18n.ts",
-      "symbol": "getMissingTranslationKeys",
-      "reason": "读取真实翻译缺失缓存，供测试验证去重与告警；不写配置或授予产品能力。"
-    },
-    {
-      "file": "apps/server/src/services/agent/nodeLog.ts",
-      "symbol": "readNode",
-      "reason": "读取真实追加日志中单个节点，供持久化、更新投影与截断恢复回归核查。"
-    },
-    {
-      "file": "apps/server/src/services/document-workflow/detectorFixerRegistry.ts",
-      "symbol": "manualDispositionIssues",
-      "reason": "只读筛选现有检测器登记的人工核查项，验证危大分级等实际错误的处置属性；不自动授予修复或通过。"
-    }
-  ],
-  "retirementUpdatedAt": "2026-10-10T18:16:44.738Z"
-}

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

@@ -1,190 +0,0 @@
-{
-  "note": "引用扫描基线：已移除不存在的声明，零引用导出不允许新增；实际入口、公开接口及测试观察面分别核查。",
-  "generatedAt": "2026-09-29",
-  "scope": [
-    "apps/server/src",
-    "packages"
-  ],
-  "counts": {
-    "谁都不用": 0,
-    "半成品嫌疑": 22,
-    "封装暴露（只导出给测试）": 142,
-    "不可判（星号再导出）": 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/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::STANDARDS_PENDING_CALIBRATION",
-      "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/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::judgeThinkingEnabled",
-      "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::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::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-13",
-  "retirementUpdate": "Removed only the actually deleted CAD collapseAdjacentRepeatedLines export; removed count matches retained roster. No new allowances, baseline regeneration, or relaxation of zero-dead-symbol cap.",
-  "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."
-}

package/scripts/half-built-scan.mjs

@@ -1,287 +0,0 @@
-#!/usr/bin/env node
-/** 文本引用候选扫描，覆盖源码、测试和脚本，供实际调用闭包审查使用。
- * 新增零引用导出、未处置的仅测试引用与星号转导出候选均阻断；其他增量显式报告。
- * 转导出、动态派发、类型引用与副作用需独立核查，不能据文本数量删除实际入口。
- * 基线只收紧已退休条目；登记仅允许有具体用途的观察/测试面，不能掩盖未接入业务。
- * 用法：node apps/server/scripts/half-built-scan.mjs --full --gate --baseline <file>
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const HERE = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = path.resolve(HERE, '../../..');           // 仓库根
-const DEFAULT_DIRS = ['apps/server/src', 'packages'];
-const ARGS = process.argv.slice(2);
-const FULL = ARGS.includes('--full');
-const VALUE_FLAGS = new Set(['--baseline', '--write-baseline']);
-const POSITIONAL = [];
-for (let i = 0; i < ARGS.length; i++) {
-  if (VALUE_FLAGS.has(ARGS[i])) {
-    if (ARGS[i + 1] !== undefined && !ARGS[i + 1].startsWith('--')) i++;
-    continue;
-  }
-  if (ARGS[i].startsWith('--')) continue;
-  POSITIONAL.push(ARGS[i]);
-}
-const DIRS = POSITIONAL.length > 0 ? POSITIONAL : DEFAULT_DIRS;
-
-const GATE = ARGS.includes('--gate');
-const flagValue = name => {
-  const i = ARGS.indexOf(name);
-  return i >= 0 ? ARGS[i + 1] : undefined;
-};
-const BASELINE_ARG = flagValue('--baseline');
-const WRITE_BASELINE_ARG = flagValue('--write-baseline');
-/** 默认基线路径：与脚本同目录（CI 与本地同一条路径） */
-const DEFAULT_BASELINE = path.join(HERE, 'half-built-scan.baseline.json');
-
-const TEST_HINT = /(^|\/)(test|tests|__tests__|__mocks__)\//;
-/** 报告范围：只报 `.ts`/`.tsx` 的导出符号 */
-const isSource = file => /\.(ts|tsx)$/.test(file) && !/\.d\.ts$/.test(file);
-const isPoolFile = file => /\.(ts|tsx|cjs|mjs|js)$/.test(file) && !/\.d\.ts$/.test(file);
-const SKIP_DIRS = new Set(['node_modules', 'dist', '.next', 'coverage']);
-
-function walk(dir, out = []) {
-  if (!fs.existsSync(dir)) return out;
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      if (SKIP_DIRS.has(entry.name)) continue;
-      walk(full, out);
-    } else if (isPoolFile(full)) out.push(full);
-  }
-  return out;
-}
-
-const REFERENCE_DIRS = ['apps/server/src', 'apps/server/test', 'apps/server/scripts', 'packages', 'scripts'];
-
-function starReExportTargets() {
-  const targets = new Set();
-  for (const file of allFiles) {
-    const text = texts.get(file) ?? '';
-    for (const m of text.matchAll(/^\s*export \*\s*(?:as\s+\w+\s*)?from\s*'(\.[^']+)'/gm)) {
-      const base = path.resolve(path.dirname(file), m[1]);
-      for (const cand of [`${base}.ts`, `${base}.tsx`, path.join(base, 'index.ts')]) {
-        if (fs.existsSync(cand)) { targets.add(cand); break; }
-      }
-    }
-  }
-  return targets;
-}
-/**
- * ⚠️ **不把 `docs/` 放进引用池**：文档是散文，而且本仓的文档里大量是**缺口清单**
- * （"这条写好没接线"）——把清单算成"有引用"，会让真死代码因为它被记过一笔而永远不被清理。
- * 文档命中的符号由**人**处置（要么接上、要么连同条目一起删），不交给扫描器自动判。
- * 另一个已知盲区：`.cjs`/`.mjs`/`.js` 消费者（`isSource` 只认 .ts/.tsx）——
- * 实测 `searchKb` 只被 `scripts/upload-matrix.cjs` 用着，曾因此被误判为死代码。
- */
-const ALL_DIRS = REFERENCE_DIRS;
-const SELF = fileURLToPath(import.meta.url);
-const allFiles = ALL_DIRS.flatMap(dir => walk(path.resolve(ROOT, dir)))
-  .filter(file => path.resolve(file) !== path.resolve(SELF));
-const texts = new Map(allFiles.map(f => [f, fs.readFileSync(f, 'utf8')]));
-const prod = allFiles.filter(f => !TEST_HINT.test(f));
-const tests = allFiles.filter(f => TEST_HINT.test(f));
-const scopeRoots = DIRS.map(dir => path.resolve(ROOT, dir));
-const inScope = file => scopeRoots.some(root => file.startsWith(root + path.sep) || file === root);
-/** 被 `export *` 再导出的文件（其符号名不会被任何地方提到 ⇒ 不可判，见上文说明） */
-const STAR_REEXPORTED = starReExportTargets();
-
-const EXPORT_PATTERNS = [
-  [/^export\s+(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/gm, 'fn'],
-  [/^export\s+class\s+([A-Za-z_$][\w$]*)/gm, 'class'],
-  [/^export\s+(?:const|let|var)\s+([A-Za-z_$][\w$]*)/gm, 'const'],
-];
-
-function countRefs(name, pool, selfFile, subtractDeclaration) {
-  const re = new RegExp(`\\b${name.replace(/\$/g, '\\$')}\\b`, 'g');
-  let total = 0;
-  for (const file of pool) {
-    let hits = (texts.get(file).match(re) || []).length;
-    if (subtractDeclaration && file === selfFile) {
-      const decl = new RegExp(`^export\\s+(async\\s+)?(function|class|const|let|var)\\s+${name.replace(/\$/g, '\\$')}\\b`, 'gm');
-      hits -= (texts.get(file).match(decl) || []).length;
-    }
-    total += Math.max(0, hits);
-  }
-  return total;
-}
-
-const rows = [];
-for (const file of prod) {
-  if (!inScope(file)) continue;                          // 报告范围 = 参数；引用池 = 全仓
-  const rel = path.relative(ROOT, file);
-  const text = texts.get(file);
-  for (const [pattern, kind] of EXPORT_PATTERNS) {
-    for (const match of text.matchAll(pattern)) {
-      const name = match[1];
-      if (name.length < 4) continue;
-      const inFile = countRefs(name, [file], file, true);
-      const otherProd = countRefs(name, prod.filter(f => f !== file), file, false);
-      const testRefs = countRefs(name, tests, file, false);
-      if (otherProd > 0) continue;
-      rows.push({
-        rel, name, kind, inFile, testRefs,
-        verdict: STAR_REEXPORTED.has(file) ? '不可判（星号再导出）'
-          : inFile === 0 && testRefs === 0 ? '谁都不用'
-            : inFile === 0 && testRefs > 0 ? '半成品嫌疑'
-              : '封装暴露（只导出给测试）',
-      });
-    }
-  }
-}
-
-const byVerdict = verdict => rows.filter(r => r.verdict === verdict);
-const suspect = byVerdict('半成品嫌疑');
-const unused = byVerdict('谁都不用');
-const undecidable = byVerdict('不可判（星号再导出）');
-
-const ALLOW_PATH = path.join(HERE, 'half-built-scan.allow.json');
-const allowed = (() => {
-  try {
-    const file = JSON.parse(fs.readFileSync(ALLOW_PATH, 'utf8'));
-    const map = new Map();
-    for (const entry of file.entries || []) map.set(`${entry.file}::${entry.symbol}`, entry.reason);
-    return map;
-  } catch {
-    return new Map();
-  }
-})();
-const registered = suspect.filter(row => allowed.has(`${row.rel}::${row.name}`));
-const unregistered = suspect.filter(row => !allowed.has(`${row.rel}::${row.name}`));
-const undecidableRegistered = undecidable.filter(row => allowed.has(`${row.rel}::${row.name}`));
-const undecidableUnregistered = undecidable.filter(row => !allowed.has(`${row.rel}::${row.name}`));
-
-console.log('════════ 半成品扫描 ════════');
-console.log(`扫描范围：${DIRS.join(', ')}（引用池 = 全仓 ${prod.length} 个生产文件 / ${tests.length} 个测试文件）`);
-console.log(`导出符号在他处生产零引用：${rows.length}`);
-console.log(`  · 半成品嫌疑（仅测试引用）    ${suspect.length}（**未登记 ${unregistered.length}** / 已登记 ${registered.length}）`);
-console.log(`  · 谁都不用（含自身文件）      ${unused.length}`);
-console.log(`  · 封装暴露（本文件内自用）    ${byVerdict('封装暴露（只导出给测试）').length}`);
-console.log(`  · 不可判（星号再导出）        ${undecidable.length}（**未登记 ${undecidableUnregistered.length}** / 已登记 ${undecidableRegistered.length}）`);
-
-if (ARGS.includes('--csv')) {
-  console.log('file,name,kind,inFile,testRefs,verdict');
-  for (const row of rows) {
-    console.log([row.rel, row.name, row.kind, row.inFile, row.testRefs, row.verdict].join(','));
-  }
-  process.exit(0);
-}
-
-const print = (title, list, limit = 40) => {
-  if (list.length === 0) return;
-  console.log(`\n── ${title}（${list.length} 条${FULL ? '' : `，列前 ${Math.min(limit, list.length)}`}）`);
-  for (const row of (FULL ? list : list.slice(0, limit))) {
-    console.log(`   ${row.rel}  ::  ${row.name}${row.testRefs ? `  (测试引用 ${row.testRefs})` : ''}`);
-  }
-};
-print('半成品嫌疑 未登记（**要当场判**：接线 / 删除 / 写进登记表并给理由）', unregistered);
-print('半成品嫌疑 已登记（测试/观察/登记面，理由见 half-built-scan.allow.json）', registered);
-if (registered.length > 0 && FULL) {
-  for (const row of registered) console.log(`   · ${row.rel} :: ${row.name} —— ${allowed.get(`${row.rel}::${row.name}`)}`);
-}
-print('谁都不用', unused, 30);
-print('不可判（星号再导出：符号可达但没有名字被提到，本脚本判不了）', undecidable, 10);
-
-console.log('\n当前方案见 docs/project-improvements/README.md；实际入口、动态注册和公开接口须独立核查。');
-console.log('本扫描仅提供文本引用候选；转导出、动态入口、内部可达依赖和副作用需按实际调用另行核查。');
-
-/**
- * 口径全文在文件头「## 门禁口径（G2）」一节。这里只写实现锚点：
- * - **四类计数 + 四类名录**都进基线（名录让"新增了什么"可以逐条打出来，而不是只给一个差值）；
- * - **只有「谁都不用」红**；其余三类超基线只 `⚠`（理由：366 条"封装暴露"是刻意形态，
- *   判红 = 每加一个测试用导出就挂 CI = 门禁当天就该被绕过）；
- * - 基线文件缺失时「谁都不用」按 **0** 判（零容忍），其余三类不做棘轮比较（没有基线就没有差值）。
- */
-const VERDICT_KEYS = ['谁都不用', '半成品嫌疑', '封装暴露（只导出给测试）', '不可判（星号再导出）'];
-const GATED_KEY = '谁都不用';
-const counts = Object.fromEntries(VERDICT_KEYS.map(key => [key, rows.filter(row => row.verdict === key).length]));
-const roster = Object.fromEntries(VERDICT_KEYS.map(key => [
-  key,
-  rows.filter(row => row.verdict === key).map(row => `${row.rel}::${row.name}`).sort(),
-]));
-
-/** 基线文件路径：`--baseline <file>` 显式给的优先；`--write-baseline [file]` 同理 */
-const writeBaselineTarget = WRITE_BASELINE_ARG !== undefined && !WRITE_BASELINE_ARG.startsWith('--')
-  ? WRITE_BASELINE_ARG
-  : DEFAULT_BASELINE;
-const baselinePath = BASELINE_ARG ? path.resolve(process.cwd(), BASELINE_ARG) : DEFAULT_BASELINE;
-
-if (ARGS.includes('--write-baseline')) {
-  const target = path.resolve(process.cwd(), writeBaselineTarget);
-  fs.writeFileSync(target, `${JSON.stringify({
-    note: '半成品扫描门禁基线（棘轮：数不许变多）。重新生成：node apps/server/scripts/half-built-scan.mjs --write-baseline',
-    generatedAt: new Date().toISOString().slice(0, 10),
-    scope: DIRS,
-    counts,
-    roster,
-  }, null, 2)}\n`, 'utf8');
-  console.log(`\n★ 已写入基线：${path.relative(ROOT, target)}（谁都不用 ${counts[GATED_KEY]} 条）`);
-  process.exit(0);
-}
-
-if (GATE) {
-  let baseline = { counts: {}, roster: {} };
-  let baselineNote = '未提供（「谁都不用」按 0 零容忍判；其余三类不做棘轮比较）';
-  if (fs.existsSync(baselinePath)) {
-    baseline = JSON.parse(fs.readFileSync(baselinePath, 'utf8'));
-    baselineNote = `${path.relative(ROOT, baselinePath)}（生成于 ${baseline.generatedAt ?? '未知'}）`;
-  } else if (BASELINE_ARG) {
-    // 显式给了路径却不存在 = 大概率是路径写错。**不静默降级**：报出来，免得基线悄悄失效。
-    console.log(`\n⚠ 基线文件不存在：${baselinePath}（按「谁都不用 = 0」零容忍口径继续）`);
-  }
-
-  const baselineRoster = key => new Set(Array.isArray(baseline.roster?.[key]) ? baseline.roster[key] : []);
-  const currentRoster = key => new Set(roster[key]);
-  const grew = key => [...currentRoster(key)].filter(id => !baselineRoster(key).has(id));
-  const shrank = key => [...baselineRoster(key)].filter(id => !currentRoster(key).has(id));
-
-  console.log('\n════════ 门禁判定（--gate）════════');
-  console.log(`基线：${baselineNote}`);
-  const gatedBaseline = typeof baseline.counts?.[GATED_KEY] === 'number' ? baseline.counts[GATED_KEY] : 0;
-  console.log(`【硬红】${GATED_KEY}：${counts[GATED_KEY]} 条（基线允许 ≤ ${gatedBaseline}）`);
-  for (const key of VERDICT_KEYS) {
-    if (key === GATED_KEY) continue;
-    const base = baseline.counts?.[key];
-    console.log(`【只报】${key}：${counts[key]} 条${typeof base === 'number' ? `（基线 ${base}）` : ''}`);
-  }
-
-  const newDead = grew(GATED_KEY);
-  const vanishedDead = shrank(GATED_KEY);
-  const baselineScope = Array.isArray(baseline.scope) ? baseline.scope.join(',') : '';
-  const scopeMismatch = baselineScope !== '' && baselineScope !== DIRS.join(',');
-  let failed = scopeMismatch || counts[GATED_KEY] > gatedBaseline || newDead.length > 0 || unregistered.length > 0 || undecidableUnregistered.length > 0;
-  if (scopeMismatch) {
-    console.log(`\n❌ 门禁红：扫描范围与基线不一致，计数不可比`);
-    console.log(`   基线：${baselineScope}`);
-    console.log(`   本次：${DIRS.join(',')}`);
-    console.log('   要门禁局部范围，请先用同一范围重跑 --write-baseline 另存一份基线。');
-  }
-
-  for (const key of VERDICT_KEYS) {
-    if (key === GATED_KEY) continue;
-    const delta = grew(key);
-    if (delta.length > 0) {
-      console.log(`⚠ 棘轮超基线（不红）：${key} 比基线多 ${delta.length} 条 —— 新增项：`);
-      for (const id of delta) console.log(`   ${id}`);
-      console.log('   （这一类**刻意不红**：它含大量"只导出给测试"的合法形态，判红等于焊死门禁。见文件头「门禁口径」）');
-    }
-  }
-
-  if (newDead.length > 0) {
-    console.log(`\n❌ 门禁红：新增 ${newDead.length} 个「谁都不用」的**真死符号**（生产零调用 ∧ 测试零引用 ∧ 本文件零自用）`);
-    for (const id of newDead) console.log(`   ${id}`);
-    console.log('   处置二选一（不许留着）：接到生产调用点，或按 P5 纪律连同它的路径一起删除。');
-  } else if (counts[GATED_KEY] > gatedBaseline) {
-    console.log(`\n❌ 门禁红：${GATED_KEY} ${counts[GATED_KEY]} 条 > 基线允许的 ${gatedBaseline} 条（名单与基线一致，是基线本身过宽）`);
-  }
-  if (vanishedDead.length > 0) {
-    console.log(`\n★ 棘轮可收紧：${GATED_KEY} 比基线少 ${vanishedDead.length} 条 —— 请重跑 --write-baseline 把它固化（棘轮只许往下走）`);
-    for (const id of vanishedDead) console.log(`   ${id}`);
-  }
-  if (!failed && newDead.length === 0) {
-    console.log(`\n✅ 门禁通过：${GATED_KEY} ${counts[GATED_KEY]} 条，无新增真死符号。`);
-  }
-  process.exit(failed ? 1 : 0);
-}