@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 +105 -1
- package/dist/index.js +135 -15
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
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(
|
|
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
|
|
8994
|
-
|
|
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
|
|
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({
|
|
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(
|
|
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
|
-
|
|
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,
|