@hcmai/sdk 0.4.18 → 0.4.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -230,6 +230,16 @@ interface ActionMeta {
230
230
  }>;
231
231
  scope?: string;
232
232
  httpMethod?: string;
233
+ /**
234
+ * 三态副作用声明(ADR-332 裁定一)的**服务端原值**。判读走 `classifyEffect`。
235
+ *
236
+ * 🔴 类型是 `unknown` 不是 `string`:收窄成 `string` 会让服务端送来的数字 / `null`
237
+ * 在类型层面消失、运行时却照样到达,而「不认识的值」正是必须 fail-closed 的那一档。
238
+ * 🔴 `undefined` 表示**这个服务端还没有三态这个概念**(回落 `readOnly`),
239
+ * 与 `'UNKNOWN'`(有三态、产品侧说没人判过)不是一回事。
240
+ */
241
+ effect?: unknown;
242
+ /** @deprecated 派生位(`effect === 'READ_ONLY'`),不是作者源。要区分「确认会写」与「没人判过」必须读 {@link effect}。 */
233
243
  readOnly?: boolean;
234
244
  paramTypes?: string[];
235
245
  paramNames?: string[];
@@ -1036,6 +1046,51 @@ declare function resolveActiveIdentity(args: {
1036
1046
  asFlag?: string;
1037
1047
  }, env: NodeJS.ProcessEnv, activeEnv: string): Promise<string>;
1038
1048
 
1049
+ /**
1050
+ * 三态副作用声明 `ActionEffect`(产品侧 ADR-332 裁定一)的**词汇表单源**。
1051
+ *
1052
+ * 产品侧把 Action 的副作用从二态布尔 `readOnly` 换成三态
1053
+ * `READ_ONLY` / `WRITES` / `UNKNOWN`,`readOnly` 自此是**派生位**
1054
+ * (`readOnly === (effect === 'READ_ONLY')`)。
1055
+ *
1056
+ * 🔴 **为什么要有这个文件**:判读散成两份,迟早会有一份把 `UNKNOWN` 读成只读。
1057
+ * `readOnly` 是产品里唯一让 AI 免用户确认直接执行的开关,猜错的代价是
1058
+ * AI 静默写客户生产库——所以「哪些字面量算数、不认识的值怎么办」只许有一处定义。
1059
+ *
1060
+ * 🔴 本文件只放**判读**,不放放行/拦截**决策**:两个消费方的 fail-closed 形态不同
1061
+ * (`fde/recon` 要把没进闸的东西留痕进产物,`delivery` 闸要当场拒绝执行并给 next_step),
1062
+ * 硬合成一个函数只会让两边都别扭。判读同源、决策各自做,是这里的分界。
1063
+ */
1064
+ /** 产品侧 `ActionEffect.READ_ONLY`:判过,确认不写库。 */
1065
+ declare const EFFECT_READ_ONLY = "READ_ONLY";
1066
+ /** 产品侧 `ActionEffect.WRITES`:判过,确认会写库。 */
1067
+ declare const EFFECT_WRITES = "WRITES";
1068
+ /** 产品侧 `ActionEffect.UNKNOWN`:**没人判过**。既不是「会写」也不是「安全」。 */
1069
+ declare const EFFECT_UNKNOWN = "UNKNOWN";
1070
+ /**
1071
+ * 「没判定」的两种成因,必须分两档留痕:
1072
+ * 「产品侧自己说没判过」与「这个值我们不认识」通向**完全不同的下一步**
1073
+ * (前者回产品侧补声明,后者多半是 kit 比服务端旧),合成一句话就等于让调用方猜。
1074
+ */
1075
+ type UndeterminedReason = 'declared-unknown' | 'unrecognized-effect';
1076
+ /**
1077
+ * 判读结果五档。
1078
+ *
1079
+ * 🔴 `absent` 与 `declared-unknown` 是两回事,**不许合并**:
1080
+ * 前者是「这个服务端还没有三态这个概念」——该回落旧的 `readOnly` 判定;
1081
+ * 后者才是「有三态、而且产品侧说没人判过」。把前者也当成后者的话,
1082
+ * 每个旧服务端都会产出一份满是「待判定」的假清单。
1083
+ */
1084
+ type ActionEffectClass = 'read-only' | 'writes' | 'absent' | UndeterminedReason;
1085
+ /**
1086
+ * 判读一条 action 的 `effect` 原值。
1087
+ *
1088
+ * 🔴 不认识的取值一律归 `unrecognized-effect` 而不是静默当只读(理由见文件头)。
1089
+ * 入参是 `unknown` 不是 `string`:服务端可能送来数字 / `null` / 对象,
1090
+ * 收窄成 `string` 会让这些值在类型层面消失、运行时却照样到达。
1091
+ */
1092
+ declare function classifyEffect(effect: unknown): ActionEffectClass;
1093
+
1039
1094
  interface StreamCommandEnvelope<P = unknown> {
1040
1095
  protocolVersion: '3.0' | '3.2' | '4.0';
1041
1096
  commandId: string;
@@ -2502,6 +2557,10 @@ declare const KIT_CARRY_OVER_KEY = "_kitCarryOver";
2502
2557
  * `readOnly` 是产品里**唯一**让 AI 工具 `hcm_invoke_read_action` 免用户确认直接执行的开关。
2503
2558
  * 判错的代价不是「基线不准」,是 **AI 静默写客户生产库**。所以本模块一切从严、一切 fail-closed:
2504
2559
  * 凡是没能确凿看到「显式声明只读 + 全部候选都只读 + 端点自己也不认为有分歧」的条目,一律不进闸表。
2560
+ *
2561
+ * 产品侧(ADR-332)把副作用声明从二态布尔换成三态 `ActionEffect`。**闸的判定没有变松**:
2562
+ * 变的是把「确认会写」与「没人判过(`UNKNOWN`)」分开留痕(`coverage.undetermined`),
2563
+ * 它们原先一起消失在同一个 `continue` 里。没打印出来的,对顾问就等于不存在。
2505
2564
  */
2506
2565
 
2507
2566
  /**
@@ -2509,6 +2568,21 @@ declare const KIT_CARRY_OVER_KEY = "_kitCarryOver";
2509
2568
  * 「我们拒了它」与「压根没这个动作」在产物里同形,下一个人无从复核我们拒得对不对。
2510
2569
  */
2511
2570
  type RejectReason = 'conflict' | 'conflict-undeclared' | 'candidate-not-read-only' | 'no-candidates' | 'malformed-candidate' | 'malformed-key' | 'malformed-action';
2571
+ /**
2572
+ * 第三态的落点。形态与 `RejectedEntry` 一致:**没进闸表的东西 + 为什么**。
2573
+ *
2574
+ * 🔴 `effect` 存的是**服务端原值**(可能不是字符串)。这里恒非 `undefined`:
2575
+ * 「没有 effect 键」走的是旧的 `readOnly` 回落路径、根本不会落到这个清单里
2576
+ * (见 `meta/action-effect` 的 `classifyEffect` 的 `absent` 档)——否则 `JSON.stringify` 会把该键整个删掉,
2577
+ * 与 `Gate.label` 那条陷阱同型。
2578
+ */
2579
+ interface UndeterminedEntry {
2580
+ model: string;
2581
+ key: string | null;
2582
+ effect: unknown;
2583
+ reason: UndeterminedReason;
2584
+ note: string;
2585
+ }
2512
2586
  interface RejectedEntry {
2513
2587
  model: string;
2514
2588
  key: string | null;
@@ -2538,6 +2612,36 @@ interface GateCoverage {
2538
2612
  accountingBalanced: boolean;
2539
2613
  unavailable: GateUnavailable[];
2540
2614
  rejected: RejectedEntry[];
2615
+ /**
2616
+ * 产品侧声明为 `UNKNOWN`(**没人判过**)的动作。与 `unavailable`(没扫成的模型)、
2617
+ * `rejected`(判过、只是没过 fail-closed 关)是同一族清单的第三个:没进闸表的东西 + 为什么。
2618
+ */
2619
+ undetermined: UndeterminedEntry[];
2620
+ /** 本轮遍历到的 action 总数(含畸形条目)。下面那条记账等式的**分母**。 */
2621
+ actionsSeen: number;
2622
+ /**
2623
+ * 本轮**真进闸**的条数。
2624
+ * 🔴 不能拿 `gates.json` 顶层的 `gates.length` 代替:定向重爬(mode=targeted)时那个数组
2625
+ * 含**沿用上一轮**的闸,而本 coverage 只描述本轮(见 runner 的 CARRY_NOTE)。
2626
+ * 少这个字段,记账等式在产物里就核不动了。
2627
+ */
2628
+ actionsGated: number;
2629
+ /** 判过、会写库的动作数:`effect=WRITES`,或旧服务端下 `readOnly` 不是显式 `true` 的那些。 */
2630
+ actionsWriting: number;
2631
+ /**
2632
+ * 带 `effect` 键的 action 数——`undetermined` 的**定义域自证**。
2633
+ * 🔴 `undetermined: []` 有两种成因:「服务端声明了三态、且没有一条是 UNKNOWN」与
2634
+ * 「服务端压根还没有 effect 这个概念」。两者输出同值,只有这个数分得开——
2635
+ * 本仓铁律:先过滤再计数的判据,过滤器吃光候选时那个 0 什么都没测。
2636
+ */
2637
+ actionsWithEffect: number;
2638
+ /**
2639
+ * 前提显式断言:
2640
+ * `actionsSeen === actionsGated + rejected.length + undetermined.length + actionsWriting`。
2641
+ * 不平就说明有 action 既没进闸、也没被拒、也没记成没人判过、还没算进写动作——
2642
+ * 那时上面这几个数一个都不能用。
2643
+ */
2644
+ actionAccountingBalanced: boolean;
2541
2645
  endpointGates: false;
2542
2646
  note: string;
2543
2647
  }
@@ -5811,4 +5915,4 @@ interface ActiveVerifyArgs {
5811
5915
  */
5812
5916
  declare function runActiveVerify(client: MetaClient, args: ActiveVerifyArgs): Promise<VerifyResult>;
5813
5917
 
5814
- export { ACLASS_EMPTY_WHY, ACLASS_KINDS, ADVISORY_CODES, AGREEING_VERDICTS, APPLY_CAVEAT, APPLY_PROBLEM_CODES, PROBLEM_CODES as ARTIFACT_PROBLEM_CODES, ARTIFACT_ROOT, ARTIFACT_SUFFIXES, ARTIFACT_WORDING, AUTH_INFO_PATH, type Aclass, type AclassKind, type AclassProblem, type ActionHttpMethod, type ActionInput, type ActionMeta, type ActionResult, type ActionScope, type AdminResetPasswordRequest, type AdminResetPasswordResult, type AnyStreamEvent, ApplyInvariantError, ApplyPremiseError, type ApplyReport, type ApprovalConfirmPayload, type ApprovalRejectPayload, type ArtifactInstallClient, type AttachmentMeta, type AuthScheme, BINDING_RESTORED, BINDING_STATES, BINDING_STILL_UNBOUND, BINDING_UNKNOWN, BINDING_UNTOUCHED, BINDING_WORDS, BLIND_SPOTS, BLOCKING_CODES, BUCKETS, type BaselineCandidate, type BindingState, type BootstrapReconcileResult, type BootstrapTenantRequest, type BootstrapTenantResult, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CAUSE_INCOMPLETE_CURRENT, CHANGE_NOT_WRITTEN, CHANGE_STATES, CHANGE_UNKNOWN, CHANGE_WRITTEN, CHANNELS, CHANNEL_ARTIFACT, CHANNEL_NO_PROBE, CHANNEL_REGISTERED_IS_ACLASS, CHANNEL_UNREGISTERED, CHECK_GROUPS, CLASS_REASONS, CLASS_SCOPE, CODE_BINDING_ELSEWHERE, CODE_BINDING_OFF, CODE_BINDING_UNREADABLE, CODE_COMMANDS, CODE_FIELDS_MISSING, CODE_FIELDS_UNREADABLE, CODE_NOT_ON_ACTIVE, CODE_NO_FIELDS_NAMED, CODE_PROBE_UNAUTHENTICATED, CODE_PROBE_UNREADABLE, CODE_RESTORE_NOT_EFFECTIVE, CODE_RESTORE_READBACK_UNREADABLE, CODE_RESTORE_REFUSED, CODE_STEP, CODE_UNBIND_NOT_EFFECTIVE, CODE_UNBIND_READBACK_UNREADABLE, CODE_UNBIND_REFUSED, CODE_WORDS, type CacheClearResult, type CacheStats, type CarrierKey, type CarrierResult, type CarrierVerdict, type CarryOver, type ChangePasswordInput, type ChangeState, type Channel, type ChironCategory, type ChironManifest, type ChironSkill, type ChironSkillFile, type ChironStage, type ClearMetaCacheOpts, CliError, CliErrorCode, type CliErrorInit, type ClientAuthContext, type ClientCredentialsInput, type ConnectionMessage, type ControlChannelEnvelope, type ConversationListItem, type ConversationListResult, type ConversationState, type CreateResult, type CreatedConversation, DATA_PACKAGE_BLIND_NOTE, DEBT_PREFIX, DEBT_UNKNOWN, DEFAULT_AGENT_ID, DEFAULT_ARTIFACT_CATEGORY, DEFAULT_SESSION_TTL_SECONDS, PREMISE_CODES as DELIVERY_PREMISE_CODES, DEV_MODE_PATH, DIMENSION_LABELS, DOCTOR_ANCHORS, DRY_RUN_NOTE, DRY_RUN_TAIL, type DataPackageInstallView, type Premise$2 as DeliveryPremise, type DeliveryRun, type DescribeOpts, type DoctorAnchor, type DoctorCheck, type DoctorReport, DriftDetected, ENDPOINT_PREFIXES, ENTRY_SCOPE, ENUM_ELEMENT_KEYS, ENUM_SHOW, EXEMPTIBLE_CODES, EXEMPTION_CODES, EXEMPTION_REQUIRED_KEYS, EXTENSION_SOURCE_HEADER, type EnvConfig, ExitCode, FACTS_REASONS, FIND_LIMIT, MAX_BYTES as FIND_MAX_BYTES, FOLDED_NOTE, FORCE_STALE_FLAG, FORCE_STALE_FLAG_TEXT, FULLWIDTH_ALNUM_RANGES, type FactsProblem, type FieldMeta, type Finding, type Fingerprint, type Fixture, type FormatOptions, GAP_ACLASS_NOT_DISCRIMINATIVE, GAP_CJK_INSIDE_LONGER_RUN, GAP_NOISE_TOKEN, GAP_REASONS, GATE_COMPONENTS, type Gap, type GlobalConfig, HcmClient, type HcmClientOpts, type HttpClientOptions, IMPORT_PLAN_FILE, INIT_EXIT_CODES, type IdentityMeta, type ImportClient, type ImportOptions, type ImportPlan, type ImportResult, type InitExitName, type InstallArtifactResult, type InteractionAnswerPayload, type InteractionRequest, type InteractionResolved, JOURNAL_FILE, JOURNAL_STOP_KINDS, JOURNAL_STOP_UNKNOWN, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, LAYER_ACTIVE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, LayoutContainmentError, Lease, LeaseViolation, type LifecycleResult, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_ARTIFACT_VERSION, MAPPING_FILE, MAX_MANIFEST_PAGES, MAX_SOURCE_PROBES, META_CACHE_PATH, META_JOURNAL_FILE, META_PATH, META_SCHEMA_SOURCE_COMMIT, STEPS as META_VERIFY_STEPS, STEP_DIFF as META_VERIFY_STEP_DIFF, STEPS$1 as META_WRITE_STEPS, MINI_CONTEXT_FILE, MINI_CONTEXT_KIND, MINI_CONTEXT_VERSION, MINI_PULL_MANIFEST_FILE, MINI_REMOTE_ROOT, MINI_STATE_DIR, MODELS_PATH, MODEL_META_PATH, MappingArtifactError, MappingError, Matcher, type MessageClass, type MessageCreatePayload, type MessageStreamHandle, type MetaClient, type MetaIssue, type MetaIssueSeverity, type StepResult as MetaStepResult, type MetaValidationResult, type MigrationSummary, type MiniFileSnapshot, type MiniInitArgs, type MiniLocalFile, type MiniLocalStatus, type MiniPreviewTarget, type MiniProjectContext, type MiniPullArgs, type MiniPullManifest, type MiniPullResult, type MiniPushArgs, type MiniPushConflict, type MiniPushOperation, type MiniPushPlanItem, type MiniPushResult, type MiniSmokeCheckArgs, type MiniSmokeFetch, type MiniSmokeFetchResponse, type MiniSmokeResult, type MiniSmokeTargetKind, type MiniSmokeTargetResult, type MiniStatusEntry, type MiniSurface, type MiniTemplateArgs, type MiniTemplateKind, type MiniValidationResult, type MiniVerifyAgentReport, type MiniVerifyBrowserAcceptance, type MiniVerifyChangedFile, type MiniVerifyNextAction, type MiniVerifyPlan, type MiniVerifyPreviewUrl, type MiniVerifyReport, type MiniVerifySummary, type MiniWritableTemplateConfig, type ModelDescription, type ModelEntry, type ModelQueryDsl, NETWORK_GATES, NEXT_STEP, NOT_COVERED_LAYER1, NOT_COVERED_LAYER2, NOT_COVERED_SELF, OFFLINE_COMMANDS, ON_EXISTING, type OneShotOpts, type OneShotResult, type OneShotToolCall, type Outcome, type OutputFormat, PASSWORD_CHANGE_REQUIRED, PLAN_JSON_KEYS, PLAN_PROBLEM_CODES, PREMISES, PREMISE_CLIENT, PREMISE_IDENTITY, PREMISE_JOURNAL_HAS_ENTRIES, PREMISE_JOURNAL_ON_DISK, PREMISE_KEY_FIELDS, PREMISE_PLAN_READABLE, PREMISE_REASONS, PREMISE_REGISTRY_REASONS, PREMISE_ROWS_TO_CHECK, PREMISE_UNMET, PREMISE_WORDS, PROACTIVE_REFRESH_MARGIN_SECONDS, PROBE_MARK_PREFIX, PRODUCT_RELATIVE_SHAPES, PRODUCT_STATE_WORDS, PROTOCOL_FACTS, type PackResult, type PairingLoginInput, type ParsedPlaceholder, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type PlanProblem, PlanReadError, type PlannedRow, type Premise$1 as Premise, type Principal, type ProfileConfig, type ProtocolFact, type QueryResult, RC_DECIDING_FIELDS, RC_DECIDING_REPORT_FIELDS, REASON_DUPLICATE_TOKEN, REASON_EMPTY, REASON_NO_ENTRIES, REASON_PROBE_ABSENT, REASON_PROBE_SHAPE, REASON_PROBE_UNVERIFIED, REASON_UNREAD, VERDICTS$1 as RECONCILE_VERDICTS, RECON_DIRNAME, RECON_SEGMENTS_BELOW_ROOT, RECOVERY_WORDS, RED_REASONS, REGISTRY_REASONS, REGISTRY_SCOPE, REQUIRED_SECTIONS, RESTORE_CODES, RISK_CODES, RISK_FILE, ROUND_ANCHORS, ROUND_EXIT_CODES, ROUND_STAMPED_PRODUCTS, ROUND_STATES, ROUND_SUBCOMMAND, ROUND_WARNINGS, ROUND_WARNING_FALLBACK, type ReconIdentity, ReconLayout, type ReconProbe, type ReconSummary, type Reconciliation, type Red, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, RestoreFailed, type ResumeSummary, type ResumeTurn, type Risk, type RiskProblem, type RoundResult, type RoundState, type RowResult, type RowStatus, type RunMetaChangeArgs, SCOPES, SDK_VERSION, SEGMENT_SEPARATOR, STATUSES, STEP_NOTHING, STEP_PROBE, STEP_REBIND, STEP_RECORD, STEP_STOP, STEP_UNBIND, SYNTH_FOOTNOTE, SYNTH_MARK, type SaveMetaResult, type ScanOptions, type ScanResult, type ScriptDryRunRequest, type ScriptDryRunResult, type ScriptLogPage, type ScriptLogQuery, type ScriptManifestValidationResult, type ScriptTaskView, type SeedPathArgs, type SendMessageOpts, type SettingItem, type SettingWrite, type StreamCancelPayload, type StreamCommand, type StreamCommandEnvelope, type StreamCommandType, type StreamEventEnvelope, type StreamEventType, TENANT_META_FILE_PATH, CONFIG as TRIAGE_CONFIG, GAP as TRIAGE_GAP, VERDICTS as TRIAGE_VERDICTS, TargetModelNotFound, type TaskProgressPayload, type TenantMetaEntry, type TimelineItemLite, type TokenRecord, TokenStore, type ToolCallFailedPayload, type ToolCallResultPayload, type ToolCallStartedPayload, type TriageEntry, type TriageProblem, type TriageProblemRow, type TriageRoundResult, type TriageVerdict, type V4RenderSink, type V4StreamEventType, VALUE_CELL_MISSING, VALUE_FOOTNOTE, VALUE_STATE_DISABLED, VALUE_STATE_FOOTNOTE, VALUE_STATE_UNKNOWN, VERDICTS$2 as VERDICTS, VERDICT_DIVERGED, VERDICT_INCOMPARABLE, VERDICT_SAME, VERDICT_WORDS, CODES as VERIFY_ACTIVE_CODES, VERIFY_CODES, VERIFY_CRASHED, VERIFY_OK, VERIFY_WORDS, VERSION_PATH, ValueHints, type ValuesResult, type VerifyResult, WAIVER_REPLAY, WARNED_ROUND_STATES, WORKSPACES_PATH, WORK_DIRNAME, WRITE_RECOVERY_WORDS, WorkLayout, type WorkspaceFileContent, type WorkspaceFileItem, type WorkspaceFileListResult, WsClient, type WsClientOpts, absoluteDownloadUrl, acquireLease, adminResetPassword, applyPlan, applyRc, applyReportText, applyReportToJson, archiveDir, artifactReason, askedTheDatabase, assertSafeReferencePath, assertSafeSkillFilePath, assertSafeSkillId, baselineRoundPremise, bootstrapTenant, boundedFind, buildAnswer, buildCarrierResult, buildConfirm, buildDeliveryRun, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReconciliation, buildReject, buildResumeSummary, buildSteer, camelizeKeys, changePassword, checkCoherence, checkGaps, checkPremise, checkReds, cjkRunAt, classifyMessage, classifyStatus, clearMetaCache, clearModelCache, commandsFor, compareFingerprint, computeFingerprint, computeReconSourceKey, contentHash, conversationStateFile, covered, create, createConversation, createHttpClient, createV4Reducer, createWorkspaceFile, credentialsFile, defaultDownloadDir, defaultMiniRequiredScopes, deleteEnv, deleteIdentity, deleteTenantMeta, deleteWorkspaceFile, deliveryRunFields, deriveAclass, deriveNamelessToolLabel, describePrincipal, describeWaiver, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, discardedColumnLines, displayWidth, downloadDocument, endpointsIn, enforceDriftGate, ensureSessionFresh, envDir, envFile, envsDir, existingJournalStop, exitCode, exitCodeFor, explainJacksonError, extractNextSteps, factsIndex, fetchConversationTimeline, fetchConversationTimelineStrict, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, filterByStage, find, findLastAssistantSeq, flattenSkills, foldConfusables, foldedNoteFor, formatMetaIssues, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getScriptTask, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, hcmConfigDir, hitRank, httpProbe, identitiesDir, identityDir, identityKnown, identityMetaFile, inGap, inferEnvName, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, installDataPackageArtifact, isCjk, isDelegationToolName, isLocalName, isReadOnly, isServerSlidingSession, isZeroNetwork, journalNote, judgeDrift, ledgerOnlySignpost, listEnvs, listIdentities, listModels, listProfiles, listTenantMeta, listWorkspaceFiles, loadConversationState, loadEnv, loadExemptions, loadGlobalConfig, loadIdentity, loadMapping, loadProfile, loadProtocolFacts, loadRecordedFingerprint, loadRows, loadWorkspaceFileContent, loginClientCredentials, loginPairing, loginPassword, loginPat, matchNote, matchSkills, matchedDimensions, metaFileUrl, metaKindFromPath, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, normalize, normalizeReferences, notAsked, oneShot, packDataPackage, parseConfirmToolName, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, probeAll, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, queryScriptLogs, readBusinessKeyFields, readImportPlan, readMiniContext, readPullManifest, rebind, rebindPayload, refreshToken, remove, renderFind, renderRound, renderTriage, renderValues, replHistoryFile, resetSettingItem, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveRefs, resolveSkillInstallOrder, riskFromArtifacts, roundAge, roundWarning, runActiveVerify, runDoctor, runImport, runMetaChange, runMiniSmokeChecks, runRecon, runTriageRound, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scan, scriptDryRun, seedBaselines, seedMappingPath, seedWorkDir, segmentsOf, sendMessageAndStream, shelfPartition, snakeToCamel, tenantSegment, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unbindPayload, unguardedKinds, update, uploadDocument, validateMetaContent, validateMiniProject, validateScriptManifest, valueState, valuesRoundCaveat, verifyAttention, verifyRc, verifyText, workspaceLayer, writeChangeState, writeImportPlan, writeRisk };
5918
+ export { ACLASS_EMPTY_WHY, ACLASS_KINDS, ADVISORY_CODES, AGREEING_VERDICTS, APPLY_CAVEAT, APPLY_PROBLEM_CODES, PROBLEM_CODES as ARTIFACT_PROBLEM_CODES, ARTIFACT_ROOT, ARTIFACT_SUFFIXES, ARTIFACT_WORDING, AUTH_INFO_PATH, type Aclass, type AclassKind, type AclassProblem, type ActionEffectClass, type ActionHttpMethod, type ActionInput, type ActionMeta, type ActionResult, type ActionScope, type AdminResetPasswordRequest, type AdminResetPasswordResult, type AnyStreamEvent, ApplyInvariantError, ApplyPremiseError, type ApplyReport, type ApprovalConfirmPayload, type ApprovalRejectPayload, type ArtifactInstallClient, type AttachmentMeta, type AuthScheme, BINDING_RESTORED, BINDING_STATES, BINDING_STILL_UNBOUND, BINDING_UNKNOWN, BINDING_UNTOUCHED, BINDING_WORDS, BLIND_SPOTS, BLOCKING_CODES, BUCKETS, type BaselineCandidate, type BindingState, type BootstrapReconcileResult, type BootstrapTenantRequest, type BootstrapTenantResult, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CAUSE_INCOMPLETE_CURRENT, CHANGE_NOT_WRITTEN, CHANGE_STATES, CHANGE_UNKNOWN, CHANGE_WRITTEN, CHANNELS, CHANNEL_ARTIFACT, CHANNEL_NO_PROBE, CHANNEL_REGISTERED_IS_ACLASS, CHANNEL_UNREGISTERED, CHECK_GROUPS, CLASS_REASONS, CLASS_SCOPE, CODE_BINDING_ELSEWHERE, CODE_BINDING_OFF, CODE_BINDING_UNREADABLE, CODE_COMMANDS, CODE_FIELDS_MISSING, CODE_FIELDS_UNREADABLE, CODE_NOT_ON_ACTIVE, CODE_NO_FIELDS_NAMED, CODE_PROBE_UNAUTHENTICATED, CODE_PROBE_UNREADABLE, CODE_RESTORE_NOT_EFFECTIVE, CODE_RESTORE_READBACK_UNREADABLE, CODE_RESTORE_REFUSED, CODE_STEP, CODE_UNBIND_NOT_EFFECTIVE, CODE_UNBIND_READBACK_UNREADABLE, CODE_UNBIND_REFUSED, CODE_WORDS, type CacheClearResult, type CacheStats, type CarrierKey, type CarrierResult, type CarrierVerdict, type CarryOver, type ChangePasswordInput, type ChangeState, type Channel, type ChironCategory, type ChironManifest, type ChironSkill, type ChironSkillFile, type ChironStage, type ClearMetaCacheOpts, CliError, CliErrorCode, type CliErrorInit, type ClientAuthContext, type ClientCredentialsInput, type ConnectionMessage, type ControlChannelEnvelope, type ConversationListItem, type ConversationListResult, type ConversationState, type CreateResult, type CreatedConversation, DATA_PACKAGE_BLIND_NOTE, DEBT_PREFIX, DEBT_UNKNOWN, DEFAULT_AGENT_ID, DEFAULT_ARTIFACT_CATEGORY, DEFAULT_SESSION_TTL_SECONDS, PREMISE_CODES as DELIVERY_PREMISE_CODES, DEV_MODE_PATH, DIMENSION_LABELS, DOCTOR_ANCHORS, DRY_RUN_NOTE, DRY_RUN_TAIL, type DataPackageInstallView, type Premise$2 as DeliveryPremise, type DeliveryRun, type DescribeOpts, type DoctorAnchor, type DoctorCheck, type DoctorReport, DriftDetected, EFFECT_READ_ONLY, EFFECT_UNKNOWN, EFFECT_WRITES, ENDPOINT_PREFIXES, ENTRY_SCOPE, ENUM_ELEMENT_KEYS, ENUM_SHOW, EXEMPTIBLE_CODES, EXEMPTION_CODES, EXEMPTION_REQUIRED_KEYS, EXTENSION_SOURCE_HEADER, type EnvConfig, ExitCode, FACTS_REASONS, FIND_LIMIT, MAX_BYTES as FIND_MAX_BYTES, FOLDED_NOTE, FORCE_STALE_FLAG, FORCE_STALE_FLAG_TEXT, FULLWIDTH_ALNUM_RANGES, type FactsProblem, type FieldMeta, type Finding, type Fingerprint, type Fixture, type FormatOptions, GAP_ACLASS_NOT_DISCRIMINATIVE, GAP_CJK_INSIDE_LONGER_RUN, GAP_NOISE_TOKEN, GAP_REASONS, GATE_COMPONENTS, type Gap, type GlobalConfig, HcmClient, type HcmClientOpts, type HttpClientOptions, IMPORT_PLAN_FILE, INIT_EXIT_CODES, type IdentityMeta, type ImportClient, type ImportOptions, type ImportPlan, type ImportResult, type InitExitName, type InstallArtifactResult, type InteractionAnswerPayload, type InteractionRequest, type InteractionResolved, JOURNAL_FILE, JOURNAL_STOP_KINDS, JOURNAL_STOP_UNKNOWN, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, LAYER_ACTIVE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, LayoutContainmentError, Lease, LeaseViolation, type LifecycleResult, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, MAPPING_ARTIFACT_VERSION, MAPPING_FILE, MAX_MANIFEST_PAGES, MAX_SOURCE_PROBES, META_CACHE_PATH, META_JOURNAL_FILE, META_PATH, META_SCHEMA_SOURCE_COMMIT, STEPS as META_VERIFY_STEPS, STEP_DIFF as META_VERIFY_STEP_DIFF, STEPS$1 as META_WRITE_STEPS, MINI_CONTEXT_FILE, MINI_CONTEXT_KIND, MINI_CONTEXT_VERSION, MINI_PULL_MANIFEST_FILE, MINI_REMOTE_ROOT, MINI_STATE_DIR, MODELS_PATH, MODEL_META_PATH, MappingArtifactError, MappingError, Matcher, type MessageClass, type MessageCreatePayload, type MessageStreamHandle, type MetaClient, type MetaIssue, type MetaIssueSeverity, type StepResult as MetaStepResult, type MetaValidationResult, type MigrationSummary, type MiniFileSnapshot, type MiniInitArgs, type MiniLocalFile, type MiniLocalStatus, type MiniPreviewTarget, type MiniProjectContext, type MiniPullArgs, type MiniPullManifest, type MiniPullResult, type MiniPushArgs, type MiniPushConflict, type MiniPushOperation, type MiniPushPlanItem, type MiniPushResult, type MiniSmokeCheckArgs, type MiniSmokeFetch, type MiniSmokeFetchResponse, type MiniSmokeResult, type MiniSmokeTargetKind, type MiniSmokeTargetResult, type MiniStatusEntry, type MiniSurface, type MiniTemplateArgs, type MiniTemplateKind, type MiniValidationResult, type MiniVerifyAgentReport, type MiniVerifyBrowserAcceptance, type MiniVerifyChangedFile, type MiniVerifyNextAction, type MiniVerifyPlan, type MiniVerifyPreviewUrl, type MiniVerifyReport, type MiniVerifySummary, type MiniWritableTemplateConfig, type ModelDescription, type ModelEntry, type ModelQueryDsl, NETWORK_GATES, NEXT_STEP, NOT_COVERED_LAYER1, NOT_COVERED_LAYER2, NOT_COVERED_SELF, OFFLINE_COMMANDS, ON_EXISTING, type OneShotOpts, type OneShotResult, type OneShotToolCall, type Outcome, type OutputFormat, PASSWORD_CHANGE_REQUIRED, PLAN_JSON_KEYS, PLAN_PROBLEM_CODES, PREMISES, PREMISE_CLIENT, PREMISE_IDENTITY, PREMISE_JOURNAL_HAS_ENTRIES, PREMISE_JOURNAL_ON_DISK, PREMISE_KEY_FIELDS, PREMISE_PLAN_READABLE, PREMISE_REASONS, PREMISE_REGISTRY_REASONS, PREMISE_ROWS_TO_CHECK, PREMISE_UNMET, PREMISE_WORDS, PROACTIVE_REFRESH_MARGIN_SECONDS, PROBE_MARK_PREFIX, PRODUCT_RELATIVE_SHAPES, PRODUCT_STATE_WORDS, PROTOCOL_FACTS, type PackResult, type PairingLoginInput, type ParsedPlaceholder, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type PlanProblem, PlanReadError, type PlannedRow, type Premise$1 as Premise, type Principal, type ProfileConfig, type ProtocolFact, type QueryResult, RC_DECIDING_FIELDS, RC_DECIDING_REPORT_FIELDS, REASON_DUPLICATE_TOKEN, REASON_EMPTY, REASON_NO_ENTRIES, REASON_PROBE_ABSENT, REASON_PROBE_SHAPE, REASON_PROBE_UNVERIFIED, REASON_UNREAD, VERDICTS$1 as RECONCILE_VERDICTS, RECON_DIRNAME, RECON_SEGMENTS_BELOW_ROOT, RECOVERY_WORDS, RED_REASONS, REGISTRY_REASONS, REGISTRY_SCOPE, REQUIRED_SECTIONS, RESTORE_CODES, RISK_CODES, RISK_FILE, ROUND_ANCHORS, ROUND_EXIT_CODES, ROUND_STAMPED_PRODUCTS, ROUND_STATES, ROUND_SUBCOMMAND, ROUND_WARNINGS, ROUND_WARNING_FALLBACK, type ReconIdentity, ReconLayout, type ReconProbe, type ReconSummary, type Reconciliation, type Red, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, RestoreFailed, type ResumeSummary, type ResumeTurn, type Risk, type RiskProblem, type RoundResult, type RoundState, type RowResult, type RowStatus, type RunMetaChangeArgs, SCOPES, SDK_VERSION, SEGMENT_SEPARATOR, STATUSES, STEP_NOTHING, STEP_PROBE, STEP_REBIND, STEP_RECORD, STEP_STOP, STEP_UNBIND, SYNTH_FOOTNOTE, SYNTH_MARK, type SaveMetaResult, type ScanOptions, type ScanResult, type ScriptDryRunRequest, type ScriptDryRunResult, type ScriptLogPage, type ScriptLogQuery, type ScriptManifestValidationResult, type ScriptTaskView, type SeedPathArgs, type SendMessageOpts, type SettingItem, type SettingWrite, type StreamCancelPayload, type StreamCommand, type StreamCommandEnvelope, type StreamCommandType, type StreamEventEnvelope, type StreamEventType, TENANT_META_FILE_PATH, CONFIG as TRIAGE_CONFIG, GAP as TRIAGE_GAP, VERDICTS as TRIAGE_VERDICTS, TargetModelNotFound, type TaskProgressPayload, type TenantMetaEntry, type TimelineItemLite, type TokenRecord, TokenStore, type ToolCallFailedPayload, type ToolCallResultPayload, type ToolCallStartedPayload, type TriageEntry, type TriageProblem, type TriageProblemRow, type TriageRoundResult, type TriageVerdict, type UndeterminedReason, type V4RenderSink, type V4StreamEventType, VALUE_CELL_MISSING, VALUE_FOOTNOTE, VALUE_STATE_DISABLED, VALUE_STATE_FOOTNOTE, VALUE_STATE_UNKNOWN, VERDICTS$2 as VERDICTS, VERDICT_DIVERGED, VERDICT_INCOMPARABLE, VERDICT_SAME, VERDICT_WORDS, CODES as VERIFY_ACTIVE_CODES, VERIFY_CODES, VERIFY_CRASHED, VERIFY_OK, VERIFY_WORDS, VERSION_PATH, ValueHints, type ValuesResult, type VerifyResult, WAIVER_REPLAY, WARNED_ROUND_STATES, WORKSPACES_PATH, WORK_DIRNAME, WRITE_RECOVERY_WORDS, WorkLayout, type WorkspaceFileContent, type WorkspaceFileItem, type WorkspaceFileListResult, WsClient, type WsClientOpts, absoluteDownloadUrl, acquireLease, adminResetPassword, applyPlan, applyRc, applyReportText, applyReportToJson, archiveDir, artifactReason, askedTheDatabase, assertSafeReferencePath, assertSafeSkillFilePath, assertSafeSkillId, baselineRoundPremise, bootstrapTenant, boundedFind, buildAnswer, buildCarrierResult, buildConfirm, buildDeliveryRun, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReconciliation, buildReject, buildResumeSummary, buildSteer, camelizeKeys, changePassword, checkCoherence, checkGaps, checkPremise, checkReds, cjkRunAt, classifyEffect, classifyMessage, classifyStatus, clearMetaCache, clearModelCache, commandsFor, compareFingerprint, computeFingerprint, computeReconSourceKey, contentHash, conversationStateFile, covered, create, createConversation, createHttpClient, createV4Reducer, createWorkspaceFile, credentialsFile, defaultDownloadDir, defaultMiniRequiredScopes, deleteEnv, deleteIdentity, deleteTenantMeta, deleteWorkspaceFile, deliveryRunFields, deriveAclass, deriveNamelessToolLabel, describePrincipal, describeWaiver, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, discardedColumnLines, displayWidth, downloadDocument, endpointsIn, enforceDriftGate, ensureSessionFresh, envDir, envFile, envsDir, existingJournalStop, exitCode, exitCodeFor, explainJacksonError, extractNextSteps, factsIndex, fetchConversationTimeline, fetchConversationTimelineStrict, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, filterByStage, find, findLastAssistantSeq, flattenSkills, foldConfusables, foldedNoteFor, formatMetaIssues, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getScriptTask, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, hcmConfigDir, hitRank, httpProbe, identitiesDir, identityDir, identityKnown, identityMetaFile, inGap, inferEnvName, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, installDataPackageArtifact, isCjk, isDelegationToolName, isLocalName, isReadOnly, isServerSlidingSession, isZeroNetwork, journalNote, judgeDrift, ledgerOnlySignpost, listEnvs, listIdentities, listModels, listProfiles, listTenantMeta, listWorkspaceFiles, loadConversationState, loadEnv, loadExemptions, loadGlobalConfig, loadIdentity, loadMapping, loadProfile, loadProtocolFacts, loadRecordedFingerprint, loadRows, loadWorkspaceFileContent, loginClientCredentials, loginPairing, loginPassword, loginPat, matchNote, matchSkills, matchedDimensions, metaFileUrl, metaKindFromPath, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, normalize, normalizeReferences, notAsked, oneShot, packDataPackage, parseConfirmToolName, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, probeAll, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, queryScriptLogs, readBusinessKeyFields, readImportPlan, readMiniContext, readPullManifest, rebind, rebindPayload, refreshToken, remove, renderFind, renderRound, renderTriage, renderValues, replHistoryFile, resetSettingItem, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveRefs, resolveSkillInstallOrder, riskFromArtifacts, roundAge, roundWarning, runActiveVerify, runDoctor, runImport, runMetaChange, runMiniSmokeChecks, runRecon, runTriageRound, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scan, scriptDryRun, seedBaselines, seedMappingPath, seedWorkDir, segmentsOf, sendMessageAndStream, shelfPartition, snakeToCamel, tenantSegment, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unbindPayload, unguardedKinds, update, uploadDocument, validateMetaContent, validateMiniProject, validateScriptManifest, valueState, valuesRoundCaveat, verifyAttention, verifyRc, verifyText, workspaceLayer, writeChangeState, writeImportPlan, writeRisk };
package/dist/index.js CHANGED
@@ -1143,6 +1143,7 @@ async function describe(http, model, _opts = {}) {
1143
1143
  params: normalizeActionParams(a),
1144
1144
  scope: a.scope,
1145
1145
  httpMethod: a.httpMethod,
1146
+ effect: a.effect,
1146
1147
  readOnly: a.readOnly,
1147
1148
  paramTypes: a.paramTypes,
1148
1149
  paramNames: a.paramNames,
@@ -1196,6 +1197,7 @@ function mergeEffectiveActions(fromMeta, effective) {
1196
1197
  label: row.label,
1197
1198
  scope: candidate?.scope,
1198
1199
  httpMethod: "POST",
1200
+ effect: row.effect,
1199
1201
  readOnly: row.readOnly,
1200
1202
  source: candidate?.source
1201
1203
  });
@@ -2003,6 +2005,18 @@ async function adminResetPassword(http, input) {
2003
2005
  return payload;
2004
2006
  }
2005
2007
 
2008
+ // src/meta/action-effect.ts
2009
+ var EFFECT_READ_ONLY = "READ_ONLY";
2010
+ var EFFECT_WRITES = "WRITES";
2011
+ var EFFECT_UNKNOWN = "UNKNOWN";
2012
+ function classifyEffect(effect) {
2013
+ if (effect === void 0) return "absent";
2014
+ if (effect === EFFECT_READ_ONLY) return "read-only";
2015
+ if (effect === EFFECT_WRITES) return "writes";
2016
+ if (effect === EFFECT_UNKNOWN) return "declared-unknown";
2017
+ return "unrecognized-effect";
2018
+ }
2019
+
2006
2020
  // src/chat/ws-client.ts
2007
2021
  import WebSocket from "ws";
2008
2022
  function classifyMessage(parsed) {
@@ -8827,6 +8841,14 @@ var ALIAS_HINTS = {
8827
8841
  title: "\u5217\u6807\u9898\u7528 `label`",
8828
8842
  displayName: "\u5217\u6807\u9898\u7528 `label`"
8829
8843
  },
8844
+ model: {
8845
+ // 模型字段层的显示名键是 `name`:`ModelFieldMeta` 上根本没有 `label` 属性、也没有
8846
+ // `@JsonAlias("label")`,写上去 Jackson 静默丢弃(`FAIL_ON_UNKNOWN_PROPERTIES=false`)。
8847
+ // `label` 在 `enums[]` / `relations[]` 这类子对象里是合法的,所以只在字段项这一层提醒。
8848
+ label: "\u6A21\u578B\u5B57\u6BB5\u5C42\u7684\u663E\u793A\u540D\u952E\u662F `name`\uFF08`label` \u53EA\u5728 `enums[]` / `relations[]` \u7B49\u5B50\u5BF9\u8C61\u91CC\u5408\u6CD5\uFF0C\u5199\u5728\u5B57\u6BB5\u9879\u4E0A\u4F1A\u88AB\u9759\u9ED8\u4E22\u5F03\uFF09",
8849
+ title: "\u6A21\u578B\u5B57\u6BB5\u5C42\u7684\u663E\u793A\u540D\u952E\u662F `name`",
8850
+ displayName: "\u6A21\u578B\u5B57\u6BB5\u5C42\u7684\u663E\u793A\u540D\u952E\u662F `name`"
8851
+ },
8830
8852
  info: {
8831
8853
  hide: "\u8BE6\u60C5/\u8868\u5355\u5C42\u7684\u663E\u9690\u952E\u662F `hidden`",
8832
8854
  visible: "\u8BE6\u60C5/\u8868\u5355\u5C42\u7684\u663E\u9690\u952E\u662F `hidden`\uFF08\u8BED\u4E49\u76F8\u53CD\uFF1A`visible: false` \u21D2 `hidden: true`\uFF09",
@@ -8904,6 +8926,15 @@ function withinOneEdit(a, b) {
8904
8926
  }
8905
8927
  return true;
8906
8928
  }
8929
+ function isPrefixedTwin(props, k) {
8930
+ if (!k || k.startsWith("is") || !/^[a-z]/.test(k)) return void 0;
8931
+ const twin = `is${k.charAt(0).toUpperCase()}${k.slice(1)}`;
8932
+ return Object.prototype.hasOwnProperty.call(props, twin) ? twin : void 0;
8933
+ }
8934
+ function registeredKeysHint(props) {
8935
+ const all = Object.keys(props).sort();
8936
+ return `\u672C\u5C42\u767B\u8BB0\u7684\u952E\u5171 ${all.length} \u4E2A\uFF1A${all.map((p) => `\`${p}\``).join(" ")}`;
8937
+ }
8907
8938
  function fmtPath(segs) {
8908
8939
  return segs.reduce(
8909
8940
  (acc, s) => typeof s === "number" ? `${acc}[${s}]` : acc ? `${acc}.${s}` : String(s),
@@ -8929,7 +8960,9 @@ function locateLine(rawLines, segs, root) {
8929
8960
  }
8930
8961
  }
8931
8962
  if (!anchorKey) return void 0;
8932
- const anchorRe = new RegExp(`^\\s*(-\\s*)?key:\\s*["']?${anchorKey.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}["']?\\s*$`);
8963
+ const anchorRe = new RegExp(
8964
+ `^\\s*(-\\s*)?key:\\s*["']?${anchorKey.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}["']?\\s*$`
8965
+ );
8933
8966
  const anchorHits = [];
8934
8967
  rawLines.forEach((l, i) => {
8935
8968
  if (anchorRe.test(l)) anchorHits.push(i);
@@ -8990,13 +9023,22 @@ function walk2(root, schema, value, segs, kind, issues, depth) {
8990
9023
  if (openMap || isDirectiveKey(k)) continue;
8991
9024
  const inFieldItem = segs.length >= 2 && typeof segs[segs.length - 1] === "number" && segs[segs.length - 2] === "fields";
8992
9025
  const alias = inFieldItem ? ALIAS_HINTS[kind]?.[k] : void 0;
8993
- const near = alias ? void 0 : Object.keys(props).find((p) => withinOneEdit(p, k));
8994
- if (!alias && !near) continue;
9026
+ const twin = alias ? void 0 : isPrefixedTwin(props, k);
9027
+ const near = alias || twin ? void 0 : Object.keys(props).find((p) => withinOneEdit(p, k));
9028
+ if (!alias && !twin && !near) continue;
9029
+ let message;
9030
+ if (alias) {
9031
+ message = `\`${k}\` \u4E0D\u662F\u672C\u5C42\u8BA4\u7684\u952E`;
9032
+ } else if (twin) {
9033
+ message = `\u672A\u767B\u8BB0\u7684\u952E \`${k}\`\uFF0C\u672C\u5C42\u767B\u8BB0\u7684\u662F \`${twin}\`\uFF08\u672C\u4ED3\u5B57\u6BB5\u5F00\u5173\u4E00\u5F8B\u5E26 \`is\` \u524D\u7F00\uFF09\uFF1B\u7167\u73B0\u5728\u8FD9\u6837\u5199\u4E0B\u53BB\uFF0C\u8FD9\u4E2A\u952E\u4E0D\u4F1A\u751F\u6548`;
9034
+ } else {
9035
+ message = `\u672A\u767B\u8BB0\u7684\u952E \`${k}\`\uFF0C\u548C\u672C\u5C42\u7684 \`${near}\` \u53EA\u5DEE\u4E00\u4E2A\u5B57\u7B26\u2014\u2014\u50CF\u662F\u624B\u8BEF\uFF1B\u670D\u52A1\u7AEF\u9047\u5230\u4E0D\u8BA4\u8BC6\u7684\u952E\u4F1A\u76F4\u63A5\u4E22\u5F03\u3001\u4E0D\u62A5\u9519`;
9036
+ }
8995
9037
  issues.push({
8996
9038
  severity: "warn",
8997
9039
  path: fmtPath([...segs, k]),
8998
- message: alias ? `\`${k}\` \u4E0D\u662F\u672C\u5C42\u8BA4\u7684\u952E` : `\u672A\u767B\u8BB0\u7684\u952E \`${k}\`\uFF0C\u548C\u672C\u5C42\u7684 \`${near}\` \u53EA\u5DEE\u4E00\u4E2A\u5B57\u7B26\u2014\u2014\u50CF\u662F\u624B\u8BEF\uFF1B\u670D\u52A1\u7AEF\u9047\u5230\u4E0D\u8BA4\u8BC6\u7684\u952E\u4F1A\u76F4\u63A5\u4E22\u5F03\u3001\u4E0D\u62A5\u9519`,
8999
- hint: alias ?? `\u662F\u4E0D\u662F\u60F3\u5199 \`${near}\`\uFF1F`
9040
+ message,
9041
+ hint: `${alias ?? `\u662F\u4E0D\u662F\u60F3\u5199 \`${twin ?? near}\`\uFF1F`} ${registeredKeysHint(props)}`
9000
9042
  });
9001
9043
  }
9002
9044
  }
@@ -9035,7 +9077,11 @@ function validateMetaContent(metaPath2, content) {
9035
9077
  return mk();
9036
9078
  }
9037
9079
  if (doc === null || doc === void 0) {
9038
- issues.push({ severity: "warn", path: "(\u6574\u4EFD\u6587\u4EF6)", message: "\u5185\u5BB9\u4E3A\u7A7A\u2014\u2014\u8FD9\u4F1A\u628A\u8BE5\u5C42\u7684\u8986\u76D6\u6E05\u6210\u7A7A overlay" });
9080
+ issues.push({
9081
+ severity: "warn",
9082
+ path: "(\u6574\u4EFD\u6587\u4EF6)",
9083
+ message: "\u5185\u5BB9\u4E3A\u7A7A\u2014\u2014\u8FD9\u4F1A\u628A\u8BE5\u5C42\u7684\u8986\u76D6\u6E05\u6210\u7A7A overlay"
9084
+ });
9039
9085
  return mk();
9040
9086
  }
9041
9087
  if (!schema) {
@@ -9085,7 +9131,9 @@ function explainJacksonError(raw) {
9085
9131
  if (leaf) parts.push(`\`${leaf[2]}\` \u8FD9\u4E2A\u952E\uFF08${leaf[1]}\uFF09`);
9086
9132
  if (parts.length > 0) lines.push(`\u4F4D\u7F6E\uFF1A${parts.join(" \u7684 ")}\u3002`);
9087
9133
  }
9088
- lines.push("\u26A0\uFE0F \u62A5\u9519\u91CC\u7684\u300Cnot found\u300D\u662F**\u8BFB\u4E0D\u52A8\u4E4B\u540E\u7684\u4E0B\u6E38\u8868\u73B0**\uFF0C\u4E0D\u662F\u300C\u6587\u4EF6\u4E0D\u5B58\u5728\u300D\u2014\u2014\u522B\u53BB\u627E\u6587\u4EF6\u3002");
9134
+ lines.push(
9135
+ "\u26A0\uFE0F \u62A5\u9519\u91CC\u7684\u300Cnot found\u300D\u662F**\u8BFB\u4E0D\u52A8\u4E4B\u540E\u7684\u4E0B\u6E38\u8868\u73B0**\uFF0C\u4E0D\u662F\u300C\u6587\u4EF6\u4E0D\u5B58\u5728\u300D\u2014\u2014\u522B\u53BB\u627E\u6587\u4EF6\u3002"
9136
+ );
9089
9137
  return lines.join("\n");
9090
9138
  }
9091
9139
 
@@ -10033,6 +10081,14 @@ function writeFieldsIndex(layout, rows) {
10033
10081
 
10034
10082
  // src/fde/recon/gates.ts
10035
10083
  var WORDING = "\u672C\u6587\u4EF6\u767B\u8BB0\u7684\u662F**\u663E\u5F0F\u58F0\u660E**\u4E3A\u53EA\u8BFB\u7684\u52A8\u4F5C\u3002kit \u53EA\u80FD\u8D70 RBAC \u88C1\u526A\u540E\u7684 REST\u3001\u89C2\u6D4B\u7A97\u53E3\u6709\u9650\uFF0C\u56E0\u6B64\u4EFB\u4F55\u7ED3\u8BBA\u7684\u53E3\u5F84\u90FD\u662F\u300C\u5728\u58F0\u660E\u5F71\u54CD\u9762\u5185\u672A\u89C2\u6D4B\u5230\u53D8\u5316\u300D\uFF0C\u800C**\u4E0D\u662F**\u300C\u65E0\u526F\u4F5C\u7528\u300D\u3002guard=declared-only \u7684\u6761\u76EE\u8FDE\u670D\u52A1\u7AEF\u9759\u6001\u5B88\u536B\u90FD\u6CA1\u6709\uFF0C\u53EA\u6709\u4E00\u53E5\u58F0\u660E\u3002";
10084
+ var KIT_SCHEMA_VERSION_KEY = "_kitSchemaVersion";
10085
+ var GATES_SCHEMA_CHANGELOG = {
10086
+ 1: "coverage \u65B0\u589E undetermined\uFF08\u4EA7\u54C1\u4FA7\u58F0\u660E effect=UNKNOWN\u3001**\u6CA1\u4EBA\u5224\u8FC7**\u5199\u4E0D\u5199\u5E93\u7684\u52A8\u4F5C\uFF0CADR-332 \u4E09\u6001\uFF09\u4EE5\u53CA\u5B83\u7684\u8BB0\u8D26/\u5B9A\u4E49\u57DF\u5B57\u6BB5 actionsSeen / actionsGated / actionsWriting / actionsWithEffect / actionAccountingBalanced"
10087
+ };
10088
+ var GATES_SCHEMA_VERSION = 1;
10089
+ function gatesSchemaChangesSince(from) {
10090
+ return Object.entries(GATES_SCHEMA_CHANGELOG).filter(([v]) => Number(v) > from && Number(v) <= GATES_SCHEMA_VERSION).map(([v, what]) => `schema ${v}\uFF1A${what}`).join("\uFF1B");
10091
+ }
10036
10092
  var GUARD_ARCH = "declared+arch-guard";
10037
10093
  var GUARD_DECLARED_ONLY = "declared-only";
10038
10094
  var ARCH_GUARDED_SOURCE = "java";
@@ -10045,6 +10101,10 @@ var REJECT_NOTES = {
10045
10101
  "malformed-key": "\u52A8\u4F5C\u6CA1\u6709\u53EF\u7528\u7684 key \u2014\u2014 \u6CA1\u6709 key \u5C31\u65E0\u6CD5\u8C03\u7528\uFF0C\u4E5F\u65E0\u6CD5\u4E0E\u4EA7\u54C1\u4FA7\u5BF9\u8D26",
10046
10102
  "malformed-action": "\u52A8\u4F5C\u6761\u76EE\u4E0D\u662F\u5BF9\u8C61\uFF0C\u65E0\u6CD5\u5224\u8BFB\u5B83\u662F\u4E0D\u662F\u53EA\u8BFB\u95F8"
10047
10103
  };
10104
+ var UNDETERMINED_NOTES = {
10105
+ "declared-unknown": "\u4EA7\u54C1\u4FA7\u628A\u8FD9\u4E2A\u52A8\u4F5C\u58F0\u660E\u6210 effect=UNKNOWN\uFF1A**\u6CA1\u4EBA\u5224\u8FC7**\u5B83\u5199\u4E0D\u5199\u5E93\u3002\u5B83\u65E2\u4E0D\u662F\u95F8\uFF08\u4E0D\u80FD\u514D\u786E\u8BA4\u6267\u884C\uFF09\uFF0C\u4E5F\u4E0D\u662F rejected\uFF08\u90A3\u662F**\u5224\u8FC7**\u3001\u53EA\u662F\u6CA1\u901A\u8FC7 fail-closed \u5173\uFF09\u3002\u4E0B\u4E00\u6B65\u5728\u4EA7\u54C1\u4FA7\u2014\u2014\u7ED9\u8FD9\u4E2A @ClassAction \u628A effect \u5224\u6389\uFF0C\u800C\u4E0D\u662F\u5728 kit \u8FD9\u8FB9\u653E\u5BBD",
10106
+ "unrecognized-effect": "effect \u7684\u53D6\u503C\u4E0D\u5728 READ_ONLY / WRITES / UNKNOWN \u4E09\u6001\u5185\uFF08\u62FC\u5199\u6F02\u79FB\uFF1F\u670D\u52A1\u7AEF\u6BD4\u672C kit \u65B0\u3001\u591A\u4E86\u4E00\u6001\uFF1F\uFF09\u3002fail-closed\uFF1A\u4E00\u5F8B**\u6309 UNKNOWN \u5904\u7F6E**\u5E76\u539F\u6837\u7559\u4E0B\u8FD9\u4E2A\u503C\uFF0C\u4E0D\u731C\u6210\u53EA\u8BFB\u3001\u4E5F\u4E0D\u9759\u9ED8\u4E22\u6389\u3002\u4E0B\u4E00\u6B65\u662F\u62FF\u672C\u6761\u7684 effect \u539F\u503C\u53BB\u5BF9\u4EA7\u54C1\u4FA7\u7684 ActionEffect \u5B9A\u4E49\uFF0C\u5FC5\u8981\u65F6\u5347\u7EA7 kit"
10107
+ };
10048
10108
  function actionsPath(modelKey, state = "") {
10049
10109
  const base = `/api/models/${modelKey}/actions`;
10050
10110
  if (!state) return base;
@@ -10053,13 +10113,11 @@ function actionsPath(modelKey, state = "") {
10053
10113
  function isRecord(v) {
10054
10114
  return Boolean(v) && typeof v === "object" && !Array.isArray(v);
10055
10115
  }
10116
+ function keyOrNull(key) {
10117
+ return typeof key === "string" && key ? key : null;
10118
+ }
10056
10119
  function reject(out, model, key, reason) {
10057
- out.push({
10058
- model,
10059
- key: typeof key === "string" && key ? key : null,
10060
- reason,
10061
- note: REJECT_NOTES[reason]
10062
- });
10120
+ out.push({ model, key: keyOrNull(key), reason, note: REJECT_NOTES[reason] });
10063
10121
  }
10064
10122
  async function collectActionGates(probe, modelKeys2, state = "") {
10065
10123
  const keys = [...new Set(modelKeys2)];
@@ -10068,7 +10126,11 @@ async function collectActionGates(probe, modelKeys2, state = "") {
10068
10126
  const results = probe.getMany ? await probe.getMany([...paths.keys()]) : await sequentialGet(probe, [...paths.keys()]);
10069
10127
  const gates = [];
10070
10128
  const rejected = [];
10129
+ const undetermined = [];
10071
10130
  const unavailable = [];
10131
+ let actionsSeen = 0;
10132
+ let actionsWriting = 0;
10133
+ let actionsWithEffect = 0;
10072
10134
  const sources = /* @__PURE__ */ new Set();
10073
10135
  const statesEchoed = /* @__PURE__ */ new Set();
10074
10136
  let noStateEcho = 0;
@@ -10104,6 +10166,7 @@ async function collectActionGates(probe, modelKeys2, state = "") {
10104
10166
  if (echoed === null) noStateEcho += 1;
10105
10167
  else statesEchoed.add(echoed);
10106
10168
  for (const action3 of body.actions) {
10169
+ actionsSeen += 1;
10107
10170
  if (!isRecord(action3)) {
10108
10171
  reject(rejected, model, null, "malformed-action");
10109
10172
  continue;
@@ -10112,7 +10175,26 @@ async function collectActionGates(probe, modelKeys2, state = "") {
10112
10175
  for (const c of cands) {
10113
10176
  if (isRecord(c) && typeof c.source === "string" && c.source) sources.add(c.source);
10114
10177
  }
10115
- if (action3.readOnly !== true) continue;
10178
+ const effectClass = classifyEffect(action3.effect);
10179
+ if (effectClass !== "absent") actionsWithEffect += 1;
10180
+ if (effectClass === "declared-unknown" || effectClass === "unrecognized-effect") {
10181
+ undetermined.push({
10182
+ model,
10183
+ key: keyOrNull(action3.key),
10184
+ effect: action3.effect,
10185
+ reason: effectClass,
10186
+ note: UNDETERMINED_NOTES[effectClass]
10187
+ });
10188
+ continue;
10189
+ }
10190
+ if (effectClass === "writes") {
10191
+ actionsWriting += 1;
10192
+ continue;
10193
+ }
10194
+ if (action3.readOnly !== true) {
10195
+ actionsWriting += 1;
10196
+ continue;
10197
+ }
10116
10198
  const key = action3.key;
10117
10199
  if (typeof key !== "string" || !key) {
10118
10200
  reject(rejected, model, key, "malformed-key");
@@ -10177,14 +10259,24 @@ async function collectActionGates(probe, modelKeys2, state = "") {
10177
10259
  accountingBalanced: keys.length === answered + unavailable.length,
10178
10260
  unavailable,
10179
10261
  rejected,
10262
+ undetermined,
10263
+ actionsSeen,
10264
+ actionsGated: gates.length,
10265
+ actionsWriting,
10266
+ actionsWithEffect,
10267
+ // 前提显式断言:不平 ⇒ 有 action 落在四个格子之外,这几个数就都不能用。
10268
+ actionAccountingBalanced: actionsSeen === gates.length + rejected.length + undetermined.length + actionsWriting,
10180
10269
  endpointGates: false,
10181
10270
  // 普通 Controller 端点闸不在本产物内
10182
- note: "scope \u6052\u4E3A state-scoped\uFF1Astate \u4E0D\u53EF\u679A\u4E3E\uFF0C\u672C\u4EA7\u7269\u53EA\u8986\u76D6 stateRequested \u8BF7\u6C42\u5230\u7684\u90A3\u4E00\u4E2A\uFF1Bunavailable = \u6CA1\u626B\u6210\u7684\u6A21\u578B\uFF08\u4E0E\u300C\u8FD9\u4E2A\u6A21\u578B\u6CA1\u6709\u53EA\u8BFB\u95F8\u300D\u662F\u4E24\u56DE\u4E8B\uFF09\uFF1Brejected = \u58F0\u660E\u4E86\u53EA\u8BFB\u5374\u88AB fail-closed \u89C4\u5219\u62D2\u6389\u7684\u52A8\u4F5C\uFF0C\u5B83\u4EEC\u4E0D\u662F\u95F8\uFF1Bsources = \u672C\u8F6E\u89C1\u5230\u7684**\u5168\u90E8** action\uFF08\u542B\u5199\u52A8\u4F5C\u3001\u542B\u88AB rejected \u7684\u6761\u76EE\uFF09\u7684\u5019\u9009 source \u53BB\u91CD\uFF0C**\u4E0D\u662F**\u95F8\u7684\u6765\u6E90\uFF1B\u95F8\u81EA\u5DF1\u7684\u6765\u6E90\u770B\u6BCF\u6761 gate \u7684 source \u5B57\u6BB5"
10271
+ note: "scope \u6052\u4E3A state-scoped\uFF1Astate \u4E0D\u53EF\u679A\u4E3E\uFF0C\u672C\u4EA7\u7269\u53EA\u8986\u76D6 stateRequested \u8BF7\u6C42\u5230\u7684\u90A3\u4E00\u4E2A\uFF1Bunavailable = \u6CA1\u626B\u6210\u7684\u6A21\u578B\uFF08\u4E0E\u300C\u8FD9\u4E2A\u6A21\u578B\u6CA1\u6709\u53EA\u8BFB\u95F8\u300D\u662F\u4E24\u56DE\u4E8B\uFF09\uFF1Brejected = \u58F0\u660E\u4E86\u53EA\u8BFB\u5374\u88AB fail-closed \u89C4\u5219\u62D2\u6389\u7684\u52A8\u4F5C\uFF0C\u5B83\u4EEC\u4E0D\u662F\u95F8\uFF1Bsources = \u672C\u8F6E\u89C1\u5230\u7684**\u5168\u90E8** action\uFF08\u542B\u5199\u52A8\u4F5C\u3001\u542B\u88AB rejected \u7684\u6761\u76EE\uFF09\u7684\u5019\u9009 source \u53BB\u91CD\uFF0C**\u4E0D\u662F**\u95F8\u7684\u6765\u6E90\uFF1B\u95F8\u81EA\u5DF1\u7684\u6765\u6E90\u770B\u6BCF\u6761 gate \u7684 source \u5B57\u6BB5\uFF1Bundetermined = \u4EA7\u54C1\u4FA7\u58F0\u660E\u4E3A UNKNOWN\uFF08**\u6CA1\u4EBA\u5224\u8FC7**\uFF09\u7684\u52A8\u4F5C\uFF0C\u4E0E rejected\uFF08**\u5224\u8FC7**\u3001\u53EA\u662F\u6CA1\u901A\u8FC7 fail-closed \u5173\uFF09\u548C\u5199\u52A8\u4F5C\u90FD\u4E0D\u662F\u4E00\u56DE\u4E8B\uFF1Beffect \u952E\u7F3A\u5931\uFF08\u670D\u52A1\u7AEF\u8FD8\u6CA1\u6709\u4E09\u6001\u8FD9\u4E2A\u6982\u5FF5\uFF09\u65F6\u56DE\u843D readOnly \u65E7\u5224\u5B9A\u3001**\u4E0D**\u8BB0\u8FDB undetermined\uFF0C\u6240\u4EE5 actionsWithEffect=0 \u65F6 undetermined \u6052\u4E3A\u7A7A\u2014\u2014\u90A3\u662F\u300C\u8FD9\u4E2A\u670D\u52A1\u7AEF\u6CA1\u6709\u8FD9\u4E2A\u6982\u5FF5\u300D\uFF0C\u4E0D\u662F\u300C\u5168\u90FD\u5224\u8FC7\u4E86\u300D\uFF1BactionAccountingBalanced \u65AD\u7684\u662F actionsSeen == actionsGated + rejected \u6761\u6570 + undetermined \u6761\u6570 + actionsWriting"
10183
10272
  };
10184
10273
  return { gates, coverage };
10185
10274
  }
10186
10275
  function writeGates(layout, gates, coverage) {
10187
10276
  return layout.writeJson("gates.json", {
10277
+ // 🔴 排在**第一个键**:顾问 `head` 一眼、下游 `grep` 一行就能知道手上这份是什么形状的。
10278
+ // 缺了它就得靠「有没有 coverage.undetermined」反推版本,而那正是本键要消灭的那种推断。
10279
+ [KIT_SCHEMA_VERSION_KEY]: GATES_SCHEMA_VERSION,
10188
10280
  wording: WORDING,
10189
10281
  coverage,
10190
10282
  crawled: true,
@@ -11333,6 +11425,27 @@ function renderRound(result) {
11333
11425
  return `${lines.join("\n")}
11334
11426
  `;
11335
11427
  }
11428
+ var SCHEMA_RECRAWL_NEXT = "\u4E0B\u4E00\u6B65\uFF1A\u8DD1\u4E00\u6B21**\u5168\u91CF** `hcm delivery recon`\uFF08\u628A `--model` \u53BB\u6389\uFF09\uFF0C\u6574\u4EFD\u57FA\u7EBF\u624D\u90FD\u51FA\u81EA\u672C\u7248 kit\u3002";
11429
+ function carriedGatesSchemaProblem(oldGates) {
11430
+ if (!isRecord5(oldGates)) {
11431
+ const shape = Array.isArray(oldGates) ? "list" : oldGates === null ? "null" : typeof oldGates;
11432
+ return `gates.json: \u4E0A\u4E00\u8F6E\u7684\u95F8\u8868\u8F7D\u8377\u662F ${shape} \u4E0D\u662F\u5BF9\u8C61\uFF0C\u65E2\u8BFB\u4E0D\u51FA schema \u7248\u672C\u3001\u4E5F\u4E00\u6761\u95F8\u90FD\u6CBF\u7528\u4E0D\u4E86\uFF08\u672C\u8F6E\u7684 gates \u6570\u7EC4\u91CC\u53EA\u6709\u8FD9\u4E00\u8F6E\u771F\u722C\u5230\u7684\uFF09\u3002${SCHEMA_RECRAWL_NEXT}`;
11433
+ }
11434
+ const raw = KIT_SCHEMA_VERSION_KEY in oldGates ? oldGates[KIT_SCHEMA_VERSION_KEY] : void 0;
11435
+ const stale = (from, seenAs) => `gates.json: \u6CBF\u7528\u7684\u4E0A\u4E00\u8F6E\u95F8\u8868${seenAs}\uFF0C\u6BD4\u672C kit \u5199\u7684 schema ${GATES_SCHEMA_VERSION} \u65E7\u3002\u4E2D\u95F4\u52A0\u4E86 \u2014\u2014 ${gatesSchemaChangesSince(from)}\u3002\u{1F534} \u90A3\u4EFD\u65E7\u4EA7\u7269\u91CC**\u6839\u672C\u6CA1\u6709**\u8FD9\u4E00\u8282\uFF0C\u800C\u300C\u6CA1\u6709\u8FD9\u4E00\u8282\u300D\u4E0E\u300C\u8FD9\u4E00\u8F6E\u4E00\u6761\u90FD\u6CA1\u6709\u300D\u5728\u4EA7\u7269\u91CC\u540C\u503C\uFF0C\u5B9E\u60C5\u662F**\u6CA1\u7B97\u8FC7**\uFF1A\u522B\u628A\u5B83\u8BFB\u6210\u300C\u6CA1\u95EE\u9898\u300D\u3002\u800C\u672C\u8F6E\u7684 coverage \u53EA\u63CF\u8FF0**\u672C\u8F6E\u771F\u722C\u7684**\u90A3\u4E9B\u6A21\u578B\uFF08\u89C1 coverage.${KIT_CARRY_OVER_KEY}.note\uFF09\uFF0C\u6CBF\u7528\u8FDB\u6765\u7684\u6A21\u578B\u8FD9\u4E00\u8F6E\u538B\u6839\u6CA1\u91CD\u626B action \u21D2 \u5B83\u4EEC\u6709\u6CA1\u6709\u300C\u6CA1\u4EBA\u5224\u8FC7\u300D\u7684\u52A8\u4F5C\uFF0C\u4E24\u8F6E\u52A0\u8D77\u6765\u4ECD\u7136\u7B54\u4E0D\u51FA\u3002${SCHEMA_RECRAWL_NEXT}`;
11436
+ if (raw === void 0) {
11437
+ return stale(0, `**\u6CA1\u6709 \`${KIT_SCHEMA_VERSION_KEY}\` \u8FD9\u4E2A\u952E**\uFF08\u8BB0\u4F5C 0\uFF1A\u672C\u952E\u51FA\u73B0\u4E4B\u524D\u7684 kit \u722C\u7684\uFF09`);
11438
+ }
11439
+ if (typeof raw !== "number" || !Number.isFinite(raw)) {
11440
+ const preview2 = JSON.stringify(raw);
11441
+ return `gates.json: \u6CBF\u7528\u7684\u4E0A\u4E00\u8F6E\u95F8\u8868\u5E26\u7740 \`${KIT_SCHEMA_VERSION_KEY}\`\uFF0C\u4F46\u5B83\u7684\u503C\u662F ${preview2.length > 60 ? `${preview2.slice(0, 60)}\u2026` : preview2}\uFF0C\u4E0D\u662F\u6570\u5B57 \u2014\u2014 **\u5224\u4E0D\u4E86**\u5B83\u662F\u54EA\u4E00\u7248\uFF0C\u56E0\u6B64\u4E5F\u8BF4\u4E0D\u51FA\u5B83\u7F3A\u54EA\u4E9B\u5B57\u6BB5\u3002\uFF08\u8FD9\u4E00\u6863\u5FC5\u987B\u5355\u5217\uFF1A\u628A\u5B83\u5F53\u6210\u300C\u7248\u672C\u4E00\u81F4\u300D\u653E\u8FC7\u53BB\uFF0C\u4E0E\u771F\u7684\u4E00\u81F4\u8F93\u51FA\u540C\u503C\u3002\uFF09${SCHEMA_RECRAWL_NEXT}`;
11442
+ }
11443
+ if (raw === GATES_SCHEMA_VERSION) return null;
11444
+ if (raw > GATES_SCHEMA_VERSION) {
11445
+ return `gates.json: \u6CBF\u7528\u7684\u4E0A\u4E00\u8F6E\u95F8\u8868\u662F schema ${raw}\uFF0C**\u6BD4\u672C kit \u7684 ${GATES_SCHEMA_VERSION} \u65B0** \u2014\u2014 \u8FD9\u4EFD\u57FA\u7EBF\u662F\u66F4\u65B0\u7248\u672C\u7684 kit \u722C\u7684\uFF0C\u672C kit \u8BFB\u4E0D\u61C2\u5B83\u591A\u51FA\u6765\u7684\u90E8\u5206\u3002\u26A0\uFE0F \u800C\u672C\u8F6E**\u5DF2\u7ECF**\u6309\u672C\u7248 schema \u628A gates.json \u6574\u4EFD\u91CD\u5199\u4E86\uFF1A\u65B0\u7248\u591A\u51FA\u6765\u7684\u9876\u5C42\u4FE1\u606F\u4E0D\u4F1A\u88AB\u4FDD\u7559\u3002\u4E0B\u4E00\u6B65\uFF1A\u628A kit \u5347\u5230\u4E0D\u4F4E\u4E8E\u90A3\u4E00\u7248\uFF08\`npm i -g @hcmai/cli@latest\`\uFF09\u518D\u91CD\u8DD1\uFF0C\u522B\u518D\u62FF\u65E7 kit \u5F80\u8FD9\u4EFD\u57FA\u7EBF\u4E0A\u5199\u3002`;
11446
+ }
11447
+ return stale(raw, `\u662F schema ${raw}`);
11448
+ }
11336
11449
  function collectCarryOver(layout, freshMetas) {
11337
11450
  const problems = [];
11338
11451
  const carriedMetas = {};
@@ -11366,6 +11479,9 @@ function collectCarryOver(layout, freshMetas) {
11366
11479
  const oldGates = readJsonSoft(path9.join(layout.dir, "gates.json"));
11367
11480
  if (oldGates === void 0) {
11368
11481
  problems.push("gates.json: \u6CA1\u6709\u53EF\u6CBF\u7528\u7684\u4E0A\u4E00\u8F6E\u95F8\u8868\uFF08\u4E0D\u5B58\u5728\u6216\u8BFB\u4E0D\u51FA JSON\uFF09");
11482
+ } else {
11483
+ const stale = carriedGatesSchemaProblem(oldGates);
11484
+ if (stale) problems.push(stale);
11369
11485
  }
11370
11486
  const oldList = isRecord5(oldGates) && Array.isArray(oldGates.gates) ? oldGates.gates : [];
11371
11487
  for (const g of oldList) {
@@ -21795,6 +21911,9 @@ export {
21795
21911
  DRY_RUN_NOTE,
21796
21912
  DRY_RUN_TAIL,
21797
21913
  DriftDetected,
21914
+ EFFECT_READ_ONLY,
21915
+ EFFECT_UNKNOWN,
21916
+ EFFECT_WRITES,
21798
21917
  ENDPOINT_PREFIXES,
21799
21918
  ENTRY_SCOPE,
21800
21919
  ENUM_ELEMENT_KEYS,
@@ -21992,6 +22111,7 @@ export {
21992
22111
  checkPremise,
21993
22112
  checkReds,
21994
22113
  cjkRunAt,
22114
+ classifyEffect,
21995
22115
  classifyMessage,
21996
22116
  classifyStatus,
21997
22117
  clearMetaCache,