@hcmai/sdk 0.4.18 → 0.4.20

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
@@ -183,6 +183,7 @@ declare function listModels(http: AxiosInstance): Promise<ModelEntry[]>;
183
183
  interface ModelQueryDsl {
184
184
  filter?: Record<string, unknown>;
185
185
  sort?: Array<Record<string, unknown>>;
186
+ additions?: Array<Record<string, unknown>>;
186
187
  fields?: string[];
187
188
  keyword?: string;
188
189
  limit?: number;
@@ -230,6 +231,16 @@ interface ActionMeta {
230
231
  }>;
231
232
  scope?: string;
232
233
  httpMethod?: string;
234
+ /**
235
+ * 三态副作用声明(ADR-332 裁定一)的**服务端原值**。判读走 `classifyEffect`。
236
+ *
237
+ * 🔴 类型是 `unknown` 不是 `string`:收窄成 `string` 会让服务端送来的数字 / `null`
238
+ * 在类型层面消失、运行时却照样到达,而「不认识的值」正是必须 fail-closed 的那一档。
239
+ * 🔴 `undefined` 表示**这个服务端还没有三态这个概念**(回落 `readOnly`),
240
+ * 与 `'UNKNOWN'`(有三态、产品侧说没人判过)不是一回事。
241
+ */
242
+ effect?: unknown;
243
+ /** @deprecated 派生位(`effect === 'READ_ONLY'`),不是作者源。要区分「确认会写」与「没人判过」必须读 {@link effect}。 */
233
244
  readOnly?: boolean;
234
245
  paramTypes?: string[];
235
246
  paramNames?: string[];
@@ -1036,6 +1047,51 @@ declare function resolveActiveIdentity(args: {
1036
1047
  asFlag?: string;
1037
1048
  }, env: NodeJS.ProcessEnv, activeEnv: string): Promise<string>;
1038
1049
 
1050
+ /**
1051
+ * 三态副作用声明 `ActionEffect`(产品侧 ADR-332 裁定一)的**词汇表单源**。
1052
+ *
1053
+ * 产品侧把 Action 的副作用从二态布尔 `readOnly` 换成三态
1054
+ * `READ_ONLY` / `WRITES` / `UNKNOWN`,`readOnly` 自此是**派生位**
1055
+ * (`readOnly === (effect === 'READ_ONLY')`)。
1056
+ *
1057
+ * 🔴 **为什么要有这个文件**:判读散成两份,迟早会有一份把 `UNKNOWN` 读成只读。
1058
+ * `readOnly` 是产品里唯一让 AI 免用户确认直接执行的开关,猜错的代价是
1059
+ * AI 静默写客户生产库——所以「哪些字面量算数、不认识的值怎么办」只许有一处定义。
1060
+ *
1061
+ * 🔴 本文件只放**判读**,不放放行/拦截**决策**:两个消费方的 fail-closed 形态不同
1062
+ * (`fde/recon` 要把没进闸的东西留痕进产物,`delivery` 闸要当场拒绝执行并给 next_step),
1063
+ * 硬合成一个函数只会让两边都别扭。判读同源、决策各自做,是这里的分界。
1064
+ */
1065
+ /** 产品侧 `ActionEffect.READ_ONLY`:判过,确认不写库。 */
1066
+ declare const EFFECT_READ_ONLY = "READ_ONLY";
1067
+ /** 产品侧 `ActionEffect.WRITES`:判过,确认会写库。 */
1068
+ declare const EFFECT_WRITES = "WRITES";
1069
+ /** 产品侧 `ActionEffect.UNKNOWN`:**没人判过**。既不是「会写」也不是「安全」。 */
1070
+ declare const EFFECT_UNKNOWN = "UNKNOWN";
1071
+ /**
1072
+ * 「没判定」的两种成因,必须分两档留痕:
1073
+ * 「产品侧自己说没判过」与「这个值我们不认识」通向**完全不同的下一步**
1074
+ * (前者回产品侧补声明,后者多半是 kit 比服务端旧),合成一句话就等于让调用方猜。
1075
+ */
1076
+ type UndeterminedReason = 'declared-unknown' | 'unrecognized-effect';
1077
+ /**
1078
+ * 判读结果五档。
1079
+ *
1080
+ * 🔴 `absent` 与 `declared-unknown` 是两回事,**不许合并**:
1081
+ * 前者是「这个服务端还没有三态这个概念」——该回落旧的 `readOnly` 判定;
1082
+ * 后者才是「有三态、而且产品侧说没人判过」。把前者也当成后者的话,
1083
+ * 每个旧服务端都会产出一份满是「待判定」的假清单。
1084
+ */
1085
+ type ActionEffectClass = 'read-only' | 'writes' | 'absent' | UndeterminedReason;
1086
+ /**
1087
+ * 判读一条 action 的 `effect` 原值。
1088
+ *
1089
+ * 🔴 不认识的取值一律归 `unrecognized-effect` 而不是静默当只读(理由见文件头)。
1090
+ * 入参是 `unknown` 不是 `string`:服务端可能送来数字 / `null` / 对象,
1091
+ * 收窄成 `string` 会让这些值在类型层面消失、运行时却照样到达。
1092
+ */
1093
+ declare function classifyEffect(effect: unknown): ActionEffectClass;
1094
+
1039
1095
  interface StreamCommandEnvelope<P = unknown> {
1040
1096
  protocolVersion: '3.0' | '3.2' | '4.0';
1041
1097
  commandId: string;
@@ -2144,14 +2200,15 @@ declare function createHttpClient(opts: HttpClientOptions): AxiosInstance;
2144
2200
  * 必须先装技能才能建租户。所以本模块只需要 endpoint,不碰 identity/token。
2145
2201
  *
2146
2202
  * 后端契约(ChironController):
2147
- * - `GET {base}/skills.json` 目录 manifest
2148
- * - `GET {base}/skills/{id}.md` 技能原文
2149
- * - `GET {base}/skills/{id}/references/{path}` 技能自带的参考文件
2150
- * - `GET {base}/skills/{id}/files?path=...` 完整 Skill 目录中的原始文件
2203
+ * - `GET {base}.json` 目录 manifest
2204
+ * - `GET {base}/{id}.md` 技能原文
2205
+ * - `GET {base}/{id}/references/{path}` 技能自带的参考文件
2206
+ * - `GET {base}/{id}/files?path=...` 完整 Skill 目录中的原始文件
2151
2207
  *
2152
- * 🔴 `{base}` 是 `'/api'` 或 `''`,由 {@link resolveChironBase} 探出来。真实部署只把
2153
- * `/api/**` 路由给后端,根路径归前端 SPA——`GET /skills.json` 在客户环境上拿回来的是
2154
- * 一段 HTML。而老版本后端只有根路径。两种都要能连上,所以先探再用,不写死。
2208
+ * 🔴 `{base}` 是实际探中的挂载根(优先 `'/api/chiron'`,旧后端可能是
2209
+ * `'/api/skills'` / `'/chiron'` / `'/skills'`)。真实部署只把 `/api/**` 路由给后端,
2210
+ * 根路径归前端 SPA;同时旧后端还没有 `/chiron*` 正名。两类环境都要能连上,
2211
+ * 所以先按优先级探测,再让所有后续请求跟随同一个挂载根。
2155
2212
  */
2156
2213
  interface ChironSkillFile {
2157
2214
  path: string;
@@ -2203,10 +2260,11 @@ interface ChironManifest {
2203
2260
  /**
2204
2261
  * 探出本环境技能库的前缀。
2205
2262
  *
2206
- * 为什么不能写死任何一个:
2263
+ * 为什么不能只写死正名:
2207
2264
  * - 真实部署(反代把 `/api/**` 给后端、其余给前端)下根路径返回的是前端 SPA 的 HTML,
2208
2265
  * HTTP 200 但根本不是 manifest —— 所以判据必须看**内容**,不能看状态码;
2209
- * - 还没升级到带 `/api` 别名那一版的后端,只有根路径可用。
2266
+ * - CLI 可能连接只提供 `/api/skills*` 兼容面的旧后端;
2267
+ * - 更老的本地直连环境只有根路径。
2210
2268
  *
2211
2269
  * 两条都探不到时抛出可执行的错误,而不是把一段 HTML 当目录解析出满屏乱码。
2212
2270
  */
@@ -2502,6 +2560,10 @@ declare const KIT_CARRY_OVER_KEY = "_kitCarryOver";
2502
2560
  * `readOnly` 是产品里**唯一**让 AI 工具 `hcm_invoke_read_action` 免用户确认直接执行的开关。
2503
2561
  * 判错的代价不是「基线不准」,是 **AI 静默写客户生产库**。所以本模块一切从严、一切 fail-closed:
2504
2562
  * 凡是没能确凿看到「显式声明只读 + 全部候选都只读 + 端点自己也不认为有分歧」的条目,一律不进闸表。
2563
+ *
2564
+ * 产品侧(ADR-332)把副作用声明从二态布尔换成三态 `ActionEffect`。**闸的判定没有变松**:
2565
+ * 变的是把「确认会写」与「没人判过(`UNKNOWN`)」分开留痕(`coverage.undetermined`),
2566
+ * 它们原先一起消失在同一个 `continue` 里。没打印出来的,对顾问就等于不存在。
2505
2567
  */
2506
2568
 
2507
2569
  /**
@@ -2509,6 +2571,21 @@ declare const KIT_CARRY_OVER_KEY = "_kitCarryOver";
2509
2571
  * 「我们拒了它」与「压根没这个动作」在产物里同形,下一个人无从复核我们拒得对不对。
2510
2572
  */
2511
2573
  type RejectReason = 'conflict' | 'conflict-undeclared' | 'candidate-not-read-only' | 'no-candidates' | 'malformed-candidate' | 'malformed-key' | 'malformed-action';
2574
+ /**
2575
+ * 第三态的落点。形态与 `RejectedEntry` 一致:**没进闸表的东西 + 为什么**。
2576
+ *
2577
+ * 🔴 `effect` 存的是**服务端原值**(可能不是字符串)。这里恒非 `undefined`:
2578
+ * 「没有 effect 键」走的是旧的 `readOnly` 回落路径、根本不会落到这个清单里
2579
+ * (见 `meta/action-effect` 的 `classifyEffect` 的 `absent` 档)——否则 `JSON.stringify` 会把该键整个删掉,
2580
+ * 与 `Gate.label` 那条陷阱同型。
2581
+ */
2582
+ interface UndeterminedEntry {
2583
+ model: string;
2584
+ key: string | null;
2585
+ effect: unknown;
2586
+ reason: UndeterminedReason;
2587
+ note: string;
2588
+ }
2512
2589
  interface RejectedEntry {
2513
2590
  model: string;
2514
2591
  key: string | null;
@@ -2538,6 +2615,36 @@ interface GateCoverage {
2538
2615
  accountingBalanced: boolean;
2539
2616
  unavailable: GateUnavailable[];
2540
2617
  rejected: RejectedEntry[];
2618
+ /**
2619
+ * 产品侧声明为 `UNKNOWN`(**没人判过**)的动作。与 `unavailable`(没扫成的模型)、
2620
+ * `rejected`(判过、只是没过 fail-closed 关)是同一族清单的第三个:没进闸表的东西 + 为什么。
2621
+ */
2622
+ undetermined: UndeterminedEntry[];
2623
+ /** 本轮遍历到的 action 总数(含畸形条目)。下面那条记账等式的**分母**。 */
2624
+ actionsSeen: number;
2625
+ /**
2626
+ * 本轮**真进闸**的条数。
2627
+ * 🔴 不能拿 `gates.json` 顶层的 `gates.length` 代替:定向重爬(mode=targeted)时那个数组
2628
+ * 含**沿用上一轮**的闸,而本 coverage 只描述本轮(见 runner 的 CARRY_NOTE)。
2629
+ * 少这个字段,记账等式在产物里就核不动了。
2630
+ */
2631
+ actionsGated: number;
2632
+ /** 判过、会写库的动作数:`effect=WRITES`,或旧服务端下 `readOnly` 不是显式 `true` 的那些。 */
2633
+ actionsWriting: number;
2634
+ /**
2635
+ * 带 `effect` 键的 action 数——`undetermined` 的**定义域自证**。
2636
+ * 🔴 `undetermined: []` 有两种成因:「服务端声明了三态、且没有一条是 UNKNOWN」与
2637
+ * 「服务端压根还没有 effect 这个概念」。两者输出同值,只有这个数分得开——
2638
+ * 本仓铁律:先过滤再计数的判据,过滤器吃光候选时那个 0 什么都没测。
2639
+ */
2640
+ actionsWithEffect: number;
2641
+ /**
2642
+ * 前提显式断言:
2643
+ * `actionsSeen === actionsGated + rejected.length + undetermined.length + actionsWriting`。
2644
+ * 不平就说明有 action 既没进闸、也没被拒、也没记成没人判过、还没算进写动作——
2645
+ * 那时上面这几个数一个都不能用。
2646
+ */
2647
+ actionAccountingBalanced: boolean;
2541
2648
  endpointGates: false;
2542
2649
  note: string;
2543
2650
  }
@@ -5811,4 +5918,4 @@ interface ActiveVerifyArgs {
5811
5918
  */
5812
5919
  declare function runActiveVerify(client: MetaClient, args: ActiveVerifyArgs): Promise<VerifyResult>;
5813
5920
 
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 };
5921
+ 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
@@ -954,6 +954,7 @@ async function query(http, model, dsl) {
954
954
  if (filter !== void 0) body.filter = filter;
955
955
  const orders = normalizeOrders(dsl.sort);
956
956
  if (orders !== void 0) body.orders = orders;
957
+ if (dsl.additions !== void 0) body.additions = dsl.additions;
957
958
  if (dsl.fields !== void 0) body.fields = dsl.fields;
958
959
  if (dsl.keyword !== void 0) body.keyword = dsl.keyword;
959
960
  const size = dsl.limit ?? 20;
@@ -1143,6 +1144,7 @@ async function describe(http, model, _opts = {}) {
1143
1144
  params: normalizeActionParams(a),
1144
1145
  scope: a.scope,
1145
1146
  httpMethod: a.httpMethod,
1147
+ effect: a.effect,
1146
1148
  readOnly: a.readOnly,
1147
1149
  paramTypes: a.paramTypes,
1148
1150
  paramNames: a.paramNames,
@@ -1196,6 +1198,7 @@ function mergeEffectiveActions(fromMeta, effective) {
1196
1198
  label: row.label,
1197
1199
  scope: candidate?.scope,
1198
1200
  httpMethod: "POST",
1201
+ effect: row.effect,
1199
1202
  readOnly: row.readOnly,
1200
1203
  source: candidate?.source
1201
1204
  });
@@ -2003,6 +2006,18 @@ async function adminResetPassword(http, input) {
2003
2006
  return payload;
2004
2007
  }
2005
2008
 
2009
+ // src/meta/action-effect.ts
2010
+ var EFFECT_READ_ONLY = "READ_ONLY";
2011
+ var EFFECT_WRITES = "WRITES";
2012
+ var EFFECT_UNKNOWN = "UNKNOWN";
2013
+ function classifyEffect(effect) {
2014
+ if (effect === void 0) return "absent";
2015
+ if (effect === EFFECT_READ_ONLY) return "read-only";
2016
+ if (effect === EFFECT_WRITES) return "writes";
2017
+ if (effect === EFFECT_UNKNOWN) return "declared-unknown";
2018
+ return "unrecognized-effect";
2019
+ }
2020
+
2006
2021
  // src/chat/ws-client.ts
2007
2022
  import WebSocket from "ws";
2008
2023
  function classifyMessage(parsed) {
@@ -8827,6 +8842,14 @@ var ALIAS_HINTS = {
8827
8842
  title: "\u5217\u6807\u9898\u7528 `label`",
8828
8843
  displayName: "\u5217\u6807\u9898\u7528 `label`"
8829
8844
  },
8845
+ model: {
8846
+ // 模型字段层的显示名键是 `name`:`ModelFieldMeta` 上根本没有 `label` 属性、也没有
8847
+ // `@JsonAlias("label")`,写上去 Jackson 静默丢弃(`FAIL_ON_UNKNOWN_PROPERTIES=false`)。
8848
+ // `label` 在 `enums[]` / `relations[]` 这类子对象里是合法的,所以只在字段项这一层提醒。
8849
+ 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",
8850
+ title: "\u6A21\u578B\u5B57\u6BB5\u5C42\u7684\u663E\u793A\u540D\u952E\u662F `name`",
8851
+ displayName: "\u6A21\u578B\u5B57\u6BB5\u5C42\u7684\u663E\u793A\u540D\u952E\u662F `name`"
8852
+ },
8830
8853
  info: {
8831
8854
  hide: "\u8BE6\u60C5/\u8868\u5355\u5C42\u7684\u663E\u9690\u952E\u662F `hidden`",
8832
8855
  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 +8927,15 @@ function withinOneEdit(a, b) {
8904
8927
  }
8905
8928
  return true;
8906
8929
  }
8930
+ function isPrefixedTwin(props, k) {
8931
+ if (!k || k.startsWith("is") || !/^[a-z]/.test(k)) return void 0;
8932
+ const twin = `is${k.charAt(0).toUpperCase()}${k.slice(1)}`;
8933
+ return Object.prototype.hasOwnProperty.call(props, twin) ? twin : void 0;
8934
+ }
8935
+ function registeredKeysHint(props) {
8936
+ const all = Object.keys(props).sort();
8937
+ return `\u672C\u5C42\u767B\u8BB0\u7684\u952E\u5171 ${all.length} \u4E2A\uFF1A${all.map((p) => `\`${p}\``).join(" ")}`;
8938
+ }
8907
8939
  function fmtPath(segs) {
8908
8940
  return segs.reduce(
8909
8941
  (acc, s) => typeof s === "number" ? `${acc}[${s}]` : acc ? `${acc}.${s}` : String(s),
@@ -8929,7 +8961,9 @@ function locateLine(rawLines, segs, root) {
8929
8961
  }
8930
8962
  }
8931
8963
  if (!anchorKey) return void 0;
8932
- const anchorRe = new RegExp(`^\\s*(-\\s*)?key:\\s*["']?${anchorKey.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}["']?\\s*$`);
8964
+ const anchorRe = new RegExp(
8965
+ `^\\s*(-\\s*)?key:\\s*["']?${anchorKey.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}["']?\\s*$`
8966
+ );
8933
8967
  const anchorHits = [];
8934
8968
  rawLines.forEach((l, i) => {
8935
8969
  if (anchorRe.test(l)) anchorHits.push(i);
@@ -8990,13 +9024,22 @@ function walk2(root, schema, value, segs, kind, issues, depth) {
8990
9024
  if (openMap || isDirectiveKey(k)) continue;
8991
9025
  const inFieldItem = segs.length >= 2 && typeof segs[segs.length - 1] === "number" && segs[segs.length - 2] === "fields";
8992
9026
  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;
9027
+ const twin = alias ? void 0 : isPrefixedTwin(props, k);
9028
+ const near = alias || twin ? void 0 : Object.keys(props).find((p) => withinOneEdit(p, k));
9029
+ if (!alias && !twin && !near) continue;
9030
+ let message;
9031
+ if (alias) {
9032
+ message = `\`${k}\` \u4E0D\u662F\u672C\u5C42\u8BA4\u7684\u952E`;
9033
+ } else if (twin) {
9034
+ 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`;
9035
+ } else {
9036
+ 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`;
9037
+ }
8995
9038
  issues.push({
8996
9039
  severity: "warn",
8997
9040
  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`
9041
+ message,
9042
+ hint: `${alias ?? `\u662F\u4E0D\u662F\u60F3\u5199 \`${twin ?? near}\`\uFF1F`} ${registeredKeysHint(props)}`
9000
9043
  });
9001
9044
  }
9002
9045
  }
@@ -9035,7 +9078,11 @@ function validateMetaContent(metaPath2, content) {
9035
9078
  return mk();
9036
9079
  }
9037
9080
  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" });
9081
+ issues.push({
9082
+ severity: "warn",
9083
+ path: "(\u6574\u4EFD\u6587\u4EF6)",
9084
+ message: "\u5185\u5BB9\u4E3A\u7A7A\u2014\u2014\u8FD9\u4F1A\u628A\u8BE5\u5C42\u7684\u8986\u76D6\u6E05\u6210\u7A7A overlay"
9085
+ });
9039
9086
  return mk();
9040
9087
  }
9041
9088
  if (!schema) {
@@ -9085,13 +9132,15 @@ function explainJacksonError(raw) {
9085
9132
  if (leaf) parts.push(`\`${leaf[2]}\` \u8FD9\u4E2A\u952E\uFF08${leaf[1]}\uFF09`);
9086
9133
  if (parts.length > 0) lines.push(`\u4F4D\u7F6E\uFF1A${parts.join(" \u7684 ")}\u3002`);
9087
9134
  }
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");
9135
+ lines.push(
9136
+ "\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"
9137
+ );
9089
9138
  return lines.join("\n");
9090
9139
  }
9091
9140
 
9092
9141
  // src/skills.ts
9093
9142
  import yaml9, { JSON_SCHEMA as JSON_SCHEMA3 } from "js-yaml";
9094
- var CHIRON_BASE_CANDIDATES = ["/api", ""];
9143
+ var CHIRON_BASE_CANDIDATES = ["/api/chiron", "/api/skills", "/chiron", "/skills"];
9095
9144
  function looksLikeManifest(data) {
9096
9145
  if (!data || typeof data !== "object") return false;
9097
9146
  const m = data;
@@ -9100,7 +9149,7 @@ function looksLikeManifest(data) {
9100
9149
  async function resolveChironBase(http) {
9101
9150
  const tried = [];
9102
9151
  for (const base of CHIRON_BASE_CANDIDATES) {
9103
- const url = `${base}/skills.json`;
9152
+ const url = `${base}.json`;
9104
9153
  tried.push(url);
9105
9154
  try {
9106
9155
  const resp = await http.get(url);
@@ -9111,15 +9160,15 @@ async function resolveChironBase(http) {
9111
9160
  }
9112
9161
  throw new CliError({
9113
9162
  code: "INVALID_ARGUMENT" /* INVALID_ARGUMENT */,
9114
- message: `\u8FD9\u4E2A\u73AF\u5883\u4E0A\u627E\u4E0D\u5230\u777F\u620E\u6280\u80FD\u5E93\uFF08\u8BD5\u8FC7 ${tried.join(" \u548C ")}\uFF09\u3002\u5E38\u89C1\u539F\u56E0\uFF1A\u2460 \u540E\u7AEF\u7248\u672C\u8FD8\u6CA1\u6709 /api/skills \u7AEF\u70B9\uFF0C\u5347\u7EA7\u540E\u7AEF\u5373\u53EF\uFF1B\u2461 endpoint \u586B\u7684\u662F\u524D\u7AEF\u5730\u5740\u4E14\u672A\u53CD\u4EE3\u5230\u540E\u7AEF\uFF1B\u2462 \u5730\u5740\u6216\u7F51\u7EDC\u4E0D\u901A\u3002`
9163
+ message: `\u8FD9\u4E2A\u73AF\u5883\u4E0A\u627E\u4E0D\u5230\u777F\u620E\u6280\u80FD\u5E93\uFF08\u8BD5\u8FC7 ${tried.join(" \u548C ")}\uFF09\u3002\u5E38\u89C1\u539F\u56E0\uFF1A\u2460 \u540E\u7AEF\u7248\u672C\u8FD8\u6CA1\u6709 /api/chiron \u6216 /api/skills \u7AEF\u70B9\uFF0C\u5347\u7EA7\u540E\u7AEF\u5373\u53EF\uFF1B\u2461 endpoint \u586B\u7684\u662F\u524D\u7AEF\u5730\u5740\u4E14\u672A\u53CD\u4EE3\u5230\u540E\u7AEF\uFF1B\u2462 \u5730\u5740\u6216\u7F51\u7EDC\u4E0D\u901A\u3002`
9115
9164
  });
9116
9165
  }
9117
9166
  async function fetchSkillCatalog(http, base) {
9118
- const resp = await http.get(`${base}/skills.json`);
9167
+ const resp = await http.get(`${base}.json`);
9119
9168
  return resp.data?.data ?? resp.data;
9120
9169
  }
9121
9170
  async function fetchSkillMarkdown(http, id, base) {
9122
- const resp = await http.get(`${base}/skills/${encodeURIComponent(id)}.md`, {
9171
+ const resp = await http.get(`${base}/${encodeURIComponent(id)}.md`, {
9123
9172
  responseType: "text",
9124
9173
  transformResponse: [(d) => d]
9125
9174
  });
@@ -9128,7 +9177,7 @@ async function fetchSkillMarkdown(http, id, base) {
9128
9177
  async function fetchSkillFile(http, id, relativePath, base) {
9129
9178
  assertSafeSkillId(id);
9130
9179
  assertSafeSkillFilePath(relativePath);
9131
- const resp = await http.get(`${base}/skills/${encodeURIComponent(id)}/files`, {
9180
+ const resp = await http.get(`${base}/${encodeURIComponent(id)}/files`, {
9132
9181
  params: { path: relativePath },
9133
9182
  responseType: "arraybuffer",
9134
9183
  transformResponse: [(data) => data]
@@ -9138,7 +9187,7 @@ async function fetchSkillFile(http, id, relativePath, base) {
9138
9187
  async function fetchSkillReference(http, id, relativePath, base) {
9139
9188
  assertSafeReferencePath(relativePath);
9140
9189
  const encoded = relativePath.split("/").map(encodeURIComponent).join("/");
9141
- const resp = await http.get(`${base}/skills/${encodeURIComponent(id)}/references/${encoded}`, {
9190
+ const resp = await http.get(`${base}/${encodeURIComponent(id)}/references/${encoded}`, {
9142
9191
  responseType: "text",
9143
9192
  transformResponse: [(d) => d]
9144
9193
  });
@@ -10033,6 +10082,14 @@ function writeFieldsIndex(layout, rows) {
10033
10082
 
10034
10083
  // src/fde/recon/gates.ts
10035
10084
  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";
10085
+ var KIT_SCHEMA_VERSION_KEY = "_kitSchemaVersion";
10086
+ var GATES_SCHEMA_CHANGELOG = {
10087
+ 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"
10088
+ };
10089
+ var GATES_SCHEMA_VERSION = 1;
10090
+ function gatesSchemaChangesSince(from) {
10091
+ 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");
10092
+ }
10036
10093
  var GUARD_ARCH = "declared+arch-guard";
10037
10094
  var GUARD_DECLARED_ONLY = "declared-only";
10038
10095
  var ARCH_GUARDED_SOURCE = "java";
@@ -10045,6 +10102,10 @@ var REJECT_NOTES = {
10045
10102
  "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
10103
  "malformed-action": "\u52A8\u4F5C\u6761\u76EE\u4E0D\u662F\u5BF9\u8C61\uFF0C\u65E0\u6CD5\u5224\u8BFB\u5B83\u662F\u4E0D\u662F\u53EA\u8BFB\u95F8"
10047
10104
  };
10105
+ var UNDETERMINED_NOTES = {
10106
+ "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",
10107
+ "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"
10108
+ };
10048
10109
  function actionsPath(modelKey, state = "") {
10049
10110
  const base = `/api/models/${modelKey}/actions`;
10050
10111
  if (!state) return base;
@@ -10053,13 +10114,11 @@ function actionsPath(modelKey, state = "") {
10053
10114
  function isRecord(v) {
10054
10115
  return Boolean(v) && typeof v === "object" && !Array.isArray(v);
10055
10116
  }
10117
+ function keyOrNull(key) {
10118
+ return typeof key === "string" && key ? key : null;
10119
+ }
10056
10120
  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
- });
10121
+ out.push({ model, key: keyOrNull(key), reason, note: REJECT_NOTES[reason] });
10063
10122
  }
10064
10123
  async function collectActionGates(probe, modelKeys2, state = "") {
10065
10124
  const keys = [...new Set(modelKeys2)];
@@ -10068,7 +10127,11 @@ async function collectActionGates(probe, modelKeys2, state = "") {
10068
10127
  const results = probe.getMany ? await probe.getMany([...paths.keys()]) : await sequentialGet(probe, [...paths.keys()]);
10069
10128
  const gates = [];
10070
10129
  const rejected = [];
10130
+ const undetermined = [];
10071
10131
  const unavailable = [];
10132
+ let actionsSeen = 0;
10133
+ let actionsWriting = 0;
10134
+ let actionsWithEffect = 0;
10072
10135
  const sources = /* @__PURE__ */ new Set();
10073
10136
  const statesEchoed = /* @__PURE__ */ new Set();
10074
10137
  let noStateEcho = 0;
@@ -10104,6 +10167,7 @@ async function collectActionGates(probe, modelKeys2, state = "") {
10104
10167
  if (echoed === null) noStateEcho += 1;
10105
10168
  else statesEchoed.add(echoed);
10106
10169
  for (const action3 of body.actions) {
10170
+ actionsSeen += 1;
10107
10171
  if (!isRecord(action3)) {
10108
10172
  reject(rejected, model, null, "malformed-action");
10109
10173
  continue;
@@ -10112,7 +10176,26 @@ async function collectActionGates(probe, modelKeys2, state = "") {
10112
10176
  for (const c of cands) {
10113
10177
  if (isRecord(c) && typeof c.source === "string" && c.source) sources.add(c.source);
10114
10178
  }
10115
- if (action3.readOnly !== true) continue;
10179
+ const effectClass = classifyEffect(action3.effect);
10180
+ if (effectClass !== "absent") actionsWithEffect += 1;
10181
+ if (effectClass === "declared-unknown" || effectClass === "unrecognized-effect") {
10182
+ undetermined.push({
10183
+ model,
10184
+ key: keyOrNull(action3.key),
10185
+ effect: action3.effect,
10186
+ reason: effectClass,
10187
+ note: UNDETERMINED_NOTES[effectClass]
10188
+ });
10189
+ continue;
10190
+ }
10191
+ if (effectClass === "writes") {
10192
+ actionsWriting += 1;
10193
+ continue;
10194
+ }
10195
+ if (action3.readOnly !== true) {
10196
+ actionsWriting += 1;
10197
+ continue;
10198
+ }
10116
10199
  const key = action3.key;
10117
10200
  if (typeof key !== "string" || !key) {
10118
10201
  reject(rejected, model, key, "malformed-key");
@@ -10177,14 +10260,24 @@ async function collectActionGates(probe, modelKeys2, state = "") {
10177
10260
  accountingBalanced: keys.length === answered + unavailable.length,
10178
10261
  unavailable,
10179
10262
  rejected,
10263
+ undetermined,
10264
+ actionsSeen,
10265
+ actionsGated: gates.length,
10266
+ actionsWriting,
10267
+ actionsWithEffect,
10268
+ // 前提显式断言:不平 ⇒ 有 action 落在四个格子之外,这几个数就都不能用。
10269
+ actionAccountingBalanced: actionsSeen === gates.length + rejected.length + undetermined.length + actionsWriting,
10180
10270
  endpointGates: false,
10181
10271
  // 普通 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"
10272
+ 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
10273
  };
10184
10274
  return { gates, coverage };
10185
10275
  }
10186
10276
  function writeGates(layout, gates, coverage) {
10187
10277
  return layout.writeJson("gates.json", {
10278
+ // 🔴 排在**第一个键**:顾问 `head` 一眼、下游 `grep` 一行就能知道手上这份是什么形状的。
10279
+ // 缺了它就得靠「有没有 coverage.undetermined」反推版本,而那正是本键要消灭的那种推断。
10280
+ [KIT_SCHEMA_VERSION_KEY]: GATES_SCHEMA_VERSION,
10188
10281
  wording: WORDING,
10189
10282
  coverage,
10190
10283
  crawled: true,
@@ -11333,6 +11426,27 @@ function renderRound(result) {
11333
11426
  return `${lines.join("\n")}
11334
11427
  `;
11335
11428
  }
11429
+ 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";
11430
+ function carriedGatesSchemaProblem(oldGates) {
11431
+ if (!isRecord5(oldGates)) {
11432
+ const shape = Array.isArray(oldGates) ? "list" : oldGates === null ? "null" : typeof oldGates;
11433
+ 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}`;
11434
+ }
11435
+ const raw = KIT_SCHEMA_VERSION_KEY in oldGates ? oldGates[KIT_SCHEMA_VERSION_KEY] : void 0;
11436
+ 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}`;
11437
+ if (raw === void 0) {
11438
+ 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`);
11439
+ }
11440
+ if (typeof raw !== "number" || !Number.isFinite(raw)) {
11441
+ const preview2 = JSON.stringify(raw);
11442
+ 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}`;
11443
+ }
11444
+ if (raw === GATES_SCHEMA_VERSION) return null;
11445
+ if (raw > GATES_SCHEMA_VERSION) {
11446
+ 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`;
11447
+ }
11448
+ return stale(raw, `\u662F schema ${raw}`);
11449
+ }
11336
11450
  function collectCarryOver(layout, freshMetas) {
11337
11451
  const problems = [];
11338
11452
  const carriedMetas = {};
@@ -11366,6 +11480,9 @@ function collectCarryOver(layout, freshMetas) {
11366
11480
  const oldGates = readJsonSoft(path9.join(layout.dir, "gates.json"));
11367
11481
  if (oldGates === void 0) {
11368
11482
  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");
11483
+ } else {
11484
+ const stale = carriedGatesSchemaProblem(oldGates);
11485
+ if (stale) problems.push(stale);
11369
11486
  }
11370
11487
  const oldList = isRecord5(oldGates) && Array.isArray(oldGates.gates) ? oldGates.gates : [];
11371
11488
  for (const g of oldList) {
@@ -21795,6 +21912,9 @@ export {
21795
21912
  DRY_RUN_NOTE,
21796
21913
  DRY_RUN_TAIL,
21797
21914
  DriftDetected,
21915
+ EFFECT_READ_ONLY,
21916
+ EFFECT_UNKNOWN,
21917
+ EFFECT_WRITES,
21798
21918
  ENDPOINT_PREFIXES,
21799
21919
  ENTRY_SCOPE,
21800
21920
  ENUM_ELEMENT_KEYS,
@@ -21992,6 +22112,7 @@ export {
21992
22112
  checkPremise,
21993
22113
  checkReds,
21994
22114
  cjkRunAt,
22115
+ classifyEffect,
21995
22116
  classifyMessage,
21996
22117
  classifyStatus,
21997
22118
  clearMetaCache,