@hcmai/sdk 0.15.5 → 0.15.7
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 +63 -5
- package/dist/index.js +95 -8
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -222,10 +222,25 @@ interface FieldMeta {
|
|
|
222
222
|
label?: string;
|
|
223
223
|
description?: string;
|
|
224
224
|
enum?: string[];
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
225
|
+
/**
|
|
226
|
+
* 这个字段指向哪个模型(服务端 `ModelFieldMeta.object`,`@Data` 直出)。
|
|
227
|
+
*
|
|
228
|
+
* 🔴 **为什么必须打出来**:服务端 `ModelMeta.relations` 的注释写死了分工 ——
|
|
229
|
+
* 「**正向关系由 `ModelFieldMeta#getObject()` 自动推导**;relations 段承载反向 / 过滤 / 派生
|
|
230
|
+
* 三类声明式定义」。所以 `relations` 里**本来就不会有**正向关系,不打 `object`
|
|
231
|
+
* 就等于告诉调用方「这个模型没有关系」。弹性模型尤其致命:`CM_*_DeviceLedger.departmentId`
|
|
232
|
+
* 在 model.yml 里声明了 `object: OrgUnit`,而 `additions: [{"key":"department","model":"OrgUnit"}]`
|
|
233
|
+
* 实际是通的(hcm_nx_cli#145 实测)。
|
|
234
|
+
*
|
|
235
|
+
* 🔴 **它不是关系名**:查询引擎认的正向关系名由服务端 `RelationKeyUtils.extractRelationKey`
|
|
236
|
+
* 从**字段名**派生(去 `Id` / `_id` 后缀),而且 **SQL 保留字会被加上 `ref_` 前缀**
|
|
237
|
+
* (`userId` → `ref_user`,不是 `user`)。CLI 不在这里复算那条规则——
|
|
238
|
+
* 复制一份跨仓的派生规则必然漂移,而漂移出来的关系名会让调用方拿到一个**查不通**的名字,
|
|
239
|
+
* 比不给更糟。
|
|
240
|
+
*/
|
|
241
|
+
object?: string;
|
|
242
|
+
/** 关联对象的显示字段名(服务端 `ModelFieldMeta.objectLabel`,默认 `name`)。 */
|
|
243
|
+
objectLabel?: string;
|
|
229
244
|
/**
|
|
230
245
|
* 多语言字段(服务端 `ModelFieldMeta.isI18n`)。值形如 `{zh_CN: "…", en: "…"}`。
|
|
231
246
|
*
|
|
@@ -348,6 +363,15 @@ interface ImportResult {
|
|
|
348
363
|
rows: RowResult[];
|
|
349
364
|
/** Model:key → uuid(已解析引用快照) */
|
|
350
365
|
refs: Record<string, string>;
|
|
366
|
+
/**
|
|
367
|
+
* {@link refs} 里**不是本次建出来、而是回查目标环境命中**的那些键(`Model:key` 形态)。
|
|
368
|
+
*
|
|
369
|
+
* 🔴 **为什么必须单列这一份**:两种来源在 {@link refs} 里长得一模一样,而它们的含义差很远 ——
|
|
370
|
+
* 「本次建的」意味着这行归本次导入管;「回查命中的」意味着它是目标环境里**已经存在**的行
|
|
371
|
+
* (租户预置的 ROOT、`__SYSTEM__` 分类、上一次导入建的对象),本次只是引用了它。
|
|
372
|
+
* 不区分就会让调用方以为整份数据都是自己造的,重跑或回滚时按错误的假设动手。
|
|
373
|
+
*/
|
|
374
|
+
refsFromTarget: string[];
|
|
351
375
|
}
|
|
352
376
|
interface ImportOptions {
|
|
353
377
|
dryRun?: boolean;
|
|
@@ -6045,10 +6069,20 @@ interface JiraComment {
|
|
|
6045
6069
|
created?: string;
|
|
6046
6070
|
author?: JiraUser;
|
|
6047
6071
|
}
|
|
6072
|
+
/** 流转界面上的一个字段——只有带 `expand=transitions.fields` 取流转时才有(`transitions()` 恒带)。 */
|
|
6073
|
+
interface JiraTransitionField {
|
|
6074
|
+
name?: string;
|
|
6075
|
+
required?: boolean;
|
|
6076
|
+
schema?: {
|
|
6077
|
+
type?: string;
|
|
6078
|
+
};
|
|
6079
|
+
}
|
|
6048
6080
|
interface JiraTransition {
|
|
6049
6081
|
id: string;
|
|
6050
6082
|
name: string;
|
|
6051
6083
|
to?: JiraNamed;
|
|
6084
|
+
/** 该流转界面上的字段,按 fieldId 索引;服务端没回就是 undefined(判不了必填,不等于没有必填)。 */
|
|
6085
|
+
fields?: Record<string, JiraTransitionField>;
|
|
6052
6086
|
}
|
|
6053
6087
|
interface JiraAllowedValue {
|
|
6054
6088
|
id?: string;
|
|
@@ -6137,6 +6171,15 @@ declare class JiraClient {
|
|
|
6137
6171
|
transitions(key: string): Promise<JiraTransition[]>;
|
|
6138
6172
|
/** 按流转 id / 流转名 / 目标状态名三种写法找;找不到把可用流转列出来,不猜。 */
|
|
6139
6173
|
transition(key: string, nameOrId: string, comment?: string): Promise<JiraTransition>;
|
|
6174
|
+
/**
|
|
6175
|
+
* 按流转 id 直接提交,**不**先重取流转——调用方刚从 `transitions()` 里核过这条流转时用它。
|
|
6176
|
+
* 评论随流转放进同一个请求(`update.comment`):校验不过整单拒、什么都不写。
|
|
6177
|
+
*
|
|
6178
|
+
* 🔴 为什么要有它:`transition()` 提交前那一跳 GET 失败时(令牌刚过期、网关 502),POST 根本没发,
|
|
6179
|
+
* 调用方却会把它当成写失败来判「写没写」(cli#245 复核 F4)。流转若在两跳之间没了,
|
|
6180
|
+
* Jira 会以 400 拒这次 POST——照样判得出「没写」。
|
|
6181
|
+
*/
|
|
6182
|
+
transitionById(key: string, id: string, comment?: string): Promise<void>;
|
|
6140
6183
|
/**
|
|
6141
6184
|
* 建单前先问 Jira:这个项目有哪些 issuetype、每种哪些字段必填、可选值是什么。
|
|
6142
6185
|
*
|
|
@@ -6160,6 +6203,21 @@ declare function fieldByName(typeMeta: JiraIssueTypeMeta, name: string): JiraFie
|
|
|
6160
6203
|
/** 解析令牌并建客户端;拿不到令牌抛带 next_step 的错误。 */
|
|
6161
6204
|
declare function createJiraClient(opts?: Partial<JiraClientOptions>): Promise<JiraClient>;
|
|
6162
6205
|
|
|
6206
|
+
/**
|
|
6207
|
+
* Jira 回了非 2xx 的那一次调用。
|
|
6208
|
+
*
|
|
6209
|
+
* 🔴 带 status 是为了让写操作的调用方判得出「写没写」:4xx = 服务端拒了、什么都没写;
|
|
6210
|
+
* 5xx,以及超时 / 断网(后两者不是本类,是 fetch 自己抛的)= 不确定。此前只有一句文案,
|
|
6211
|
+
* 调用方要么去解析文案、要么一律当「失败」——后者会把「可能已经写进去了」说成「没写」(cli#245)。
|
|
6212
|
+
* message 与此前的普通 Error 逐字相同,只认文案的老调用方不受影响。
|
|
6213
|
+
*/
|
|
6214
|
+
declare class JiraHttpError extends Error {
|
|
6215
|
+
readonly status: number;
|
|
6216
|
+
readonly method: string;
|
|
6217
|
+
readonly path: string;
|
|
6218
|
+
constructor(status: number, method: string, path: string, message: string);
|
|
6219
|
+
}
|
|
6220
|
+
|
|
6163
6221
|
interface RepoRef {
|
|
6164
6222
|
repo: string;
|
|
6165
6223
|
number: string;
|
|
@@ -6177,4 +6235,4 @@ type ParsedRef = {
|
|
|
6177
6235
|
declare function parseRef(raw: string, project: string, casesSlug?: string): ParsedRef | null;
|
|
6178
6236
|
declare const firstLine: (s: string) => string;
|
|
6179
6237
|
|
|
6180
|
-
export { ADVISORY_CODES, AGREEING_VERDICTS, APPLY_CAVEAT, APPLY_PROBLEM_CODES, PROBLEM_CODES as ARTIFACT_PROBLEM_CODES, AUTH_INFO_PATH, AUTH_SESSION_INFO_PATH, 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, type BrowserAuthorization, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CASES_REPO_SLUG, CASES_REPO_URL, CAUSE_INCOMPLETE_CURRENT, CHANGE_NOT_WRITTEN, CHANGE_STATES, CHANGE_UNKNOWN, CHANGE_WRITTEN, CHECK_GROUPS, CLI_AUTHORIZE_PATH, CLI_EXCHANGE_PATH, CLI_VERIFICATION_PATH, CNB_FAVICON_URL, CNB_ORIGIN, 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, CREDENTIAL_STORE_MODES, type CacheClearResult, type CacheStats, type CarrierKey, type CarrierResult, type CarrierVerdict, type CarryOver, type Catalog, type ChangePasswordInput, type ChangeState, type ChironCategory, type ChironManifest, type ChironSkill, type ChironSkillFile, type ChironStage, type ClearMetaCacheOpts, type CliAuthorizationSession, CliError, CliErrorCode, type CliErrorInit, type ClientAuthContext, type ClientCredentialsInput, type ConnectionMessage, type ControlChannelEnvelope, type ConversationListItem, type ConversationListResult, type ConversationState, type CreateResult, type CreatedConversation, type CredentialStoreMode, DATA_PACKAGE_MODELS, 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 DataPackageInstallRunView, type DataPackageInstallView, type Premise$1 as DeliveryPremise, type DeliveryRun, type DescribeOpts, type DeviceAuthorization, type DoctorAnchor, type DoctorCheck, type DoctorReport, DriftDetected, EFFECT_READ_ONLY, EFFECT_UNKNOWN, EFFECT_WRITES, ENUM_SHOW, ENV_FILE, EXEMPTIBLE_CODES, EXEMPTION_CODES, EXEMPTION_REQUIRED_KEYS, EXTENSION_SOURCE_HEADER, type EnvConfig, type EnvSource, type EnvironmentSafety, ExitCode, FIND_LIMIT, MAX_BYTES as FIND_MAX_BYTES, FORCE_STALE_FLAG, FORCE_STALE_FLAG_TEXT, type FieldMeta, type Finding, type Fingerprint, type Fixture, type FormatOptions, GATE_COMPONENTS, type GlobalConfig, HANDSHAKE_AUTH_ERROR_HEADER, HANDSHAKE_TOKEN_QUERY_PARAM, HCM_LANG_ENV, HcmClient, type HcmClientOpts, type HttpClientOptions, IMPERSONATION_ACTIVE_PATH, IMPERSONATION_START_PATH, IMPORT_PLAN_FILE, INIT_EXIT_CODES, type IdentityMeta, type ImportClient, type ImportOptions, type ImportPlan, type ImportResult, type InitExitName, type InstallAcceptedResult, type InstallArtifactResult, type InteractionAnswerPayload, type InteractionRequest, type InteractionResolved, JIRA_BASE, JIRA_KEYCHAIN, JIRA_PROJECT, JIRA_TOKEN_FILE, JOURNAL_FILE, JOURNAL_STOP_KINDS, JOURNAL_STOP_UNKNOWN, type JiraAllowedValue, JiraClient, type JiraClientOptions, type JiraComment, type JiraFieldMeta, type JiraFields, type JiraIssue, type JiraIssueTypeMeta, type JiraNamed, type JiraProject, type JiraRemoteLink, type JiraStatusFlow, type JiraTokenSource, type JiraTransition, type JiraUser, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, LAYER_ACTIVE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, type LastAssistantTarget, LayoutContainmentError, Lease, LeaseViolation, type LifecycleResult, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, 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, MappingError, 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_ROWS_TO_CHECK, PREMISE_UNMET, PREMISE_WORDS, PROACTIVE_REFRESH_MARGIN_SECONDS, PRODUCT_STATE_WORDS, type PackOptions, type PackResult, type PairingLoginInput, type ParsedPlaceholder, type ParsedRef, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type PlanProblem, PlanReadError, type PlannedRow, type Principal, type ProfileConfig, type ProjectEnv, type ProjectEnvFile, type QueryResult, RC_DECIDING_FIELDS, RC_DECIDING_REPORT_FIELDS, REASON_BASELINE_ROUND_NOT_COMPLETE, VERDICTS$1 as RECONCILE_VERDICTS, RECOVERY_WORDS, 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, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type RepoRef, type ResolvedEnvContext, type ResolvedProjectEnvironment, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, RestoreFailed, type ResumeSummary, type ResumeTurn, type Risk, type RiskProblem, type RoundPremise, type RoundResult, type RoundState, type RowResult, type RowStatus, type RunMetaChangeArgs, SDK_VERSION, STATUSES, STEP_NOTHING, STEP_PROBE, STEP_REBIND, STEP_RECORD, STEP_STOP, STEP_UNBIND, SUPERSEDED_STATUS, SYNTH_FOOTNOTE, SYNTH_MARK, type SaveMetaResult, type ScriptDryRunRequest, type ScriptDryRunResult, type ScriptLogPage, type ScriptLogQuery, type ScriptManifestValidationResult, type ScriptTaskView, type SeedPathArgs, type SendMessageOpts, type SessionPrincipal, type SettingItem, type SettingWrite, type StreamCancelPayload, type StreamCommand, type StreamCommandEnvelope, type StreamCommandType, type StreamEventEnvelope, type StreamEventType, TEMP_ENV_NAME, 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, type WaitResult, WorkLayout, type WorkspaceFileContent, type WorkspaceFileItem, type WorkspaceFileListResult, WsClient, type WsClientOpts, absoluteDownloadUrl, acquireLease, adminResetPassword, applyPlan, applyRc, applyReportText, applyReportToJson, archiveDir, askedTheDatabase, assertDangerWrite, assertExpectedTenant, assertNotReservedEnvName, assertSafeReferencePath, assertSafeSkillFilePath, assertSafeSkillId, baselineRoundPremise, bootstrapTenant, buildAnswer, buildCarrierResult, buildConfirm, buildDeliveryRun, buildHandshakeUrl, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReconciliation, buildReject, buildResumeSummary, buildSteer, camelizeKeys, changePassword, checkCoherence, classifyEffect, classifyMessage, classifyStatus, clearMetaCache, clearModelCache, cliAuthorizationExpired, commandsFor, compareFingerprint, computeFingerprint, computeReconSourceKey, contentHash, conversationStateFile, conversationWebSocketEndpoint, create, createConversation, createHttpClient, createJiraClient, createV4Reducer, createWorkspaceFile, credentialsFile, defaultDownloadDir, defaultMiniRequiredScopes, deleteDocument, deleteEnv, deleteIdentity, deleteTenantMeta, deleteWorkspaceFile, deliveryRunFields, deriveNamelessToolLabel, describePrincipal, describeWaiver, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, discardedColumnLines, discoverProjectEnv, displayWidth, downloadDocument, enforceDriftGate, ensureSessionFresh, envDir, envFile, envsDir, exchangeBrowserAuthorization, existingJournalStop, exitCodeFor, explainJacksonError, extractNextSteps, fetchConversationTimeline, fetchConversationTimelineStrict, fetchInstallRun, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, fieldByName, filterByStage, find, findEnvByEndpoint, findLastAssistantSeq, findLastAssistantTarget, firstLine, flattenSkills, formatMetaIssues, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getScriptTask, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, handshakeRejectedError, hasPendingImpersonationSessions, hcmConfigDir, hitRank, httpProbe, identitiesDir, identityDir, identityKnown, identityMetaFile, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, installDataPackageArtifact, installDataPackageArtifactAsync, isDelegationToolName, isLocalName, isReadOnly, isServerSlidingSession, isSupersededItem, isTempEnv, isTerminalRunStatus, isZeroNetwork, jiraTokenHelp, jiraTokenSource, journalNote, judgeDrift, ledgerOnlySignpost, linkedRepoRefs, listEnvs, listIdentities, listModels, listProfiles, listTenantMeta, listWorkspaceFiles, loadCatalog, loadConversationState, loadEnv, loadExemptions, loadGlobalConfig, loadIdentity, loadMapping, loadProfile, loadRecordedFingerprint, loadRows, loadWorkspaceFileContent, loginClientCredentials, loginPairing, loginPassword, loginPat, matchNote, matchSkills, matchedDimensions, metaFileUrl, metaKindFromPath, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, normalizeOrigin, normalizeReferences, notAsked, oneShot, packDataPackage, parseConfirmToolName, parseEnvYaml, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseRef, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, pollDeviceAuthorization, printResolvedEnvironment, probeAll, probeConversationHandshake, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, queryScriptLogs, readImportPlan, readMiniContext, readPullManifest, readSessionPrincipal, rebind, rebindPayload, refreshToken, releasePendingImpersonationSessions, remove, renameIdentity, renderEnvYaml, renderFind, renderRound, renderTriage, renderValues, replHistoryFile, repoIssueUrl, requestCliAuthorization, resetSettingItem, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveCredentialStoreMode, resolveEnvContext, resolveProjectEnvironment, resolveRefs, resolveSkillInstallOrder, riskFromArtifacts, roundAge, roundWarning, runActiveVerify, runDoctor, runImport, runMetaChange, runMiniSmokeChecks, runRecon, runTriageRound, safeCliAuthorizationError, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scriptDryRun, seedBaselines, seedMappingPath, seedWorkDir, sendMessageAndStream, shelfPartition, snakeToCamel, startImpersonation, tenantSegment, toAcceptLanguage, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unbindPayload, update, uploadDocument, validateCliAuthorizationUrl, validateMetaContent, validateMiniProject, validateScriptManifest, valueState, valuesRoundCaveat, verifyAttention, verifyRc, verifyText, waitForInstallRun, workspaceLayer, writeChangeState, writeImportPlan, writeRisk };
|
|
6238
|
+
export { ADVISORY_CODES, AGREEING_VERDICTS, APPLY_CAVEAT, APPLY_PROBLEM_CODES, PROBLEM_CODES as ARTIFACT_PROBLEM_CODES, AUTH_INFO_PATH, AUTH_SESSION_INFO_PATH, 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, type BrowserAuthorization, CARRIER_BLIND, CARRIER_HIT, CARRIER_KEYS, CARRIER_LABELS, CARRIER_MISS, CARRIER_UNAVAILABLE, CARRIER_VERDICTS, CASES_REPO_SLUG, CASES_REPO_URL, CAUSE_INCOMPLETE_CURRENT, CHANGE_NOT_WRITTEN, CHANGE_STATES, CHANGE_UNKNOWN, CHANGE_WRITTEN, CHECK_GROUPS, CLI_AUTHORIZE_PATH, CLI_EXCHANGE_PATH, CLI_VERIFICATION_PATH, CNB_FAVICON_URL, CNB_ORIGIN, 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, CREDENTIAL_STORE_MODES, type CacheClearResult, type CacheStats, type CarrierKey, type CarrierResult, type CarrierVerdict, type CarryOver, type Catalog, type ChangePasswordInput, type ChangeState, type ChironCategory, type ChironManifest, type ChironSkill, type ChironSkillFile, type ChironStage, type ClearMetaCacheOpts, type CliAuthorizationSession, CliError, CliErrorCode, type CliErrorInit, type ClientAuthContext, type ClientCredentialsInput, type ConnectionMessage, type ControlChannelEnvelope, type ConversationListItem, type ConversationListResult, type ConversationState, type CreateResult, type CreatedConversation, type CredentialStoreMode, DATA_PACKAGE_MODELS, 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 DataPackageInstallRunView, type DataPackageInstallView, type Premise$1 as DeliveryPremise, type DeliveryRun, type DescribeOpts, type DeviceAuthorization, type DoctorAnchor, type DoctorCheck, type DoctorReport, DriftDetected, EFFECT_READ_ONLY, EFFECT_UNKNOWN, EFFECT_WRITES, ENUM_SHOW, ENV_FILE, EXEMPTIBLE_CODES, EXEMPTION_CODES, EXEMPTION_REQUIRED_KEYS, EXTENSION_SOURCE_HEADER, type EnvConfig, type EnvSource, type EnvironmentSafety, ExitCode, FIND_LIMIT, MAX_BYTES as FIND_MAX_BYTES, FORCE_STALE_FLAG, FORCE_STALE_FLAG_TEXT, type FieldMeta, type Finding, type Fingerprint, type Fixture, type FormatOptions, GATE_COMPONENTS, type GlobalConfig, HANDSHAKE_AUTH_ERROR_HEADER, HANDSHAKE_TOKEN_QUERY_PARAM, HCM_LANG_ENV, HcmClient, type HcmClientOpts, type HttpClientOptions, IMPERSONATION_ACTIVE_PATH, IMPERSONATION_START_PATH, IMPORT_PLAN_FILE, INIT_EXIT_CODES, type IdentityMeta, type ImportClient, type ImportOptions, type ImportPlan, type ImportResult, type InitExitName, type InstallAcceptedResult, type InstallArtifactResult, type InteractionAnswerPayload, type InteractionRequest, type InteractionResolved, JIRA_BASE, JIRA_KEYCHAIN, JIRA_PROJECT, JIRA_TOKEN_FILE, JOURNAL_FILE, JOURNAL_STOP_KINDS, JOURNAL_STOP_UNKNOWN, type JiraAllowedValue, JiraClient, type JiraClientOptions, type JiraComment, type JiraFieldMeta, type JiraFields, JiraHttpError, type JiraIssue, type JiraIssueTypeMeta, type JiraNamed, type JiraProject, type JiraRemoteLink, type JiraStatusFlow, type JiraTokenSource, type JiraTransition, type JiraTransitionField, type JiraUser, Journal, JournalError, KIT_CARRY_OVER_KEY, KIT_CRAWLED_AT_FILE, KIT_MATCHED_ON, LAYER_ACTIVE, LEASE_FILE, LEDGER_MISSING_WORD, LEDGER_ONLY_FLAG, type LastAssistantTarget, LayoutContainmentError, Lease, LeaseViolation, type LifecycleResult, type ListTenantMetaOpts, type LoginOutcome, MANIFEST_PATH, 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, MappingError, 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_ROWS_TO_CHECK, PREMISE_UNMET, PREMISE_WORDS, PROACTIVE_REFRESH_MARGIN_SECONDS, PRODUCT_STATE_WORDS, type PackOptions, type PackResult, type PairingLoginInput, type ParsedPlaceholder, type ParsedRef, type PasswordChangeChallenge, type PasswordLoginInput, type PatLoginInput, type PlanProblem, PlanReadError, type PlannedRow, type Principal, type ProfileConfig, type ProjectEnv, type ProjectEnvFile, type QueryResult, RC_DECIDING_FIELDS, RC_DECIDING_REPORT_FIELDS, REASON_BASELINE_ROUND_NOT_COMPLETE, VERDICTS$1 as RECONCILE_VERDICTS, RECOVERY_WORDS, 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, RefStore, type RefreshInput, type RelationMeta, type RemoveResult, type RepoRef, type ResolvedEnvContext, type ResolvedProjectEnvironment, type ResponseCompletedPayload, type ResponseFailedPayload, type ResponsePartDeltaPayload, type ResponseStartedPayload, RestoreFailed, type ResumeSummary, type ResumeTurn, type Risk, type RiskProblem, type RoundPremise, type RoundResult, type RoundState, type RowResult, type RowStatus, type RunMetaChangeArgs, SDK_VERSION, STATUSES, STEP_NOTHING, STEP_PROBE, STEP_REBIND, STEP_RECORD, STEP_STOP, STEP_UNBIND, SUPERSEDED_STATUS, SYNTH_FOOTNOTE, SYNTH_MARK, type SaveMetaResult, type ScriptDryRunRequest, type ScriptDryRunResult, type ScriptLogPage, type ScriptLogQuery, type ScriptManifestValidationResult, type ScriptTaskView, type SeedPathArgs, type SendMessageOpts, type SessionPrincipal, type SettingItem, type SettingWrite, type StreamCancelPayload, type StreamCommand, type StreamCommandEnvelope, type StreamCommandType, type StreamEventEnvelope, type StreamEventType, TEMP_ENV_NAME, 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, type WaitResult, WorkLayout, type WorkspaceFileContent, type WorkspaceFileItem, type WorkspaceFileListResult, WsClient, type WsClientOpts, absoluteDownloadUrl, acquireLease, adminResetPassword, applyPlan, applyRc, applyReportText, applyReportToJson, archiveDir, askedTheDatabase, assertDangerWrite, assertExpectedTenant, assertNotReservedEnvName, assertSafeReferencePath, assertSafeSkillFilePath, assertSafeSkillId, baselineRoundPremise, bootstrapTenant, buildAnswer, buildCarrierResult, buildConfirm, buildDeliveryRun, buildHandshakeUrl, buildInterrupt, buildMiniAppTemplateFiles, buildMiniPreviewTargets, buildMiniVerifyAgentReport, buildReconciliation, buildReject, buildResumeSummary, buildSteer, camelizeKeys, changePassword, checkCoherence, classifyEffect, classifyMessage, classifyStatus, clearMetaCache, clearModelCache, cliAuthorizationExpired, commandsFor, compareFingerprint, computeFingerprint, computeReconSourceKey, contentHash, conversationStateFile, conversationWebSocketEndpoint, create, createConversation, createHttpClient, createJiraClient, createV4Reducer, createWorkspaceFile, credentialsFile, defaultDownloadDir, defaultMiniRequiredScopes, deleteDocument, deleteEnv, deleteIdentity, deleteTenantMeta, deleteWorkspaceFile, deliveryRunFields, deriveNamelessToolLabel, describePrincipal, describeWaiver, detectDelegationPause, detectDirectInteractionPending, detectPasswordChangeChallenge, discardedColumnLines, discoverProjectEnv, displayWidth, downloadDocument, enforceDriftGate, ensureSessionFresh, envDir, envFile, envsDir, exchangeBrowserAuthorization, existingJournalStop, exitCodeFor, explainJacksonError, extractNextSteps, fetchConversationTimeline, fetchConversationTimelineStrict, fetchInstallRun, fetchRecentConversations, fetchReconIdentity, fetchSkillCatalog, fetchSkillFile, fetchSkillMarkdown, fetchSkillReference, fieldByName, filterByStage, find, findEnvByEndpoint, findLastAssistantSeq, findLastAssistantTarget, firstLine, flattenSkills, formatMetaIssues, formatMiniVerifyReport, formatObject, formatRows, fromAxiosError, getCacheStats, getMiniStatus, getScriptTask, getSettingDomain, getTenantMeta, globalConfigFile, guessMimeType, handshakeRejectedError, hasPendingImpersonationSessions, hcmConfigDir, hitRank, httpProbe, identitiesDir, identityDir, identityKnown, identityMetaFile, inferMiniWritableTemplateOptionsFromModel, initMiniAppProject, inspectRound, installDataPackageArtifact, installDataPackageArtifactAsync, isDelegationToolName, isLocalName, isReadOnly, isServerSlidingSession, isSupersededItem, isTempEnv, isTerminalRunStatus, isZeroNetwork, jiraTokenHelp, jiraTokenSource, journalNote, judgeDrift, ledgerOnlySignpost, linkedRepoRefs, listEnvs, listIdentities, listModels, listProfiles, listTenantMeta, listWorkspaceFiles, loadCatalog, loadConversationState, loadEnv, loadExemptions, loadGlobalConfig, loadIdentity, loadMapping, loadProfile, loadRecordedFingerprint, loadRows, loadWorkspaceFileContent, loginClientCredentials, loginPairing, loginPassword, loginPat, matchNote, matchSkills, matchedDimensions, metaFileUrl, metaKindFromPath, migrateLegacyProfiles, modelEntries, modelKeys, needsRefresh, newRoundId, normalizeOrigin, normalizeReferences, notAsked, oneShot, packDataPackage, parseConfirmToolName, parseEnvYaml, parseFixture, parseInteractionRequest, parseInteractionResolved, parsePlaceholder, parseRef, parseSettingAssignment, parseSkillFrontmatter, parseSkillRequirements, patchSettingDomain, planFromArtifacts, planProblemLines, planRc, planSummaryLine, planVsBaselinePremise, pollDeviceAuthorization, printResolvedEnvironment, probeAll, probeConversationHandshake, probeExtensionSource, profileDir, profileFile, pullMiniAppProject, pushMiniAppProject, queryScriptLogs, readImportPlan, readMiniContext, readPullManifest, readSessionPrincipal, rebind, rebindPayload, refreshToken, releasePendingImpersonationSessions, remove, renameIdentity, renderEnvYaml, renderFind, renderRound, renderTriage, renderValues, replHistoryFile, repoIssueUrl, requestCliAuthorization, resetSettingItem, resolveActiveEnv, resolveActiveIdentity, resolveActiveProfile, resolveAllSkillsInstallOrder, resolveBaselineDir, resolveChironBase, resolveCredentialStoreMode, resolveEnvContext, resolveProjectEnvironment, resolveRefs, resolveSkillInstallOrder, riskFromArtifacts, roundAge, roundWarning, runActiveVerify, runDoctor, runImport, runMetaChange, runMiniSmokeChecks, runRecon, runTriageRound, safeCliAuthorizationError, safeSegment, saveConversationState, saveEnv, saveGlobalConfig, saveIdentity, saveProfile, saveTenantMeta, saveWorkspaceFileContent, scriptDryRun, seedBaselines, seedMappingPath, seedWorkDir, sendMessageAndStream, shelfPartition, snakeToCamel, startImpersonation, tenantSegment, toAcceptLanguage, toJson, toOrigin, toPrincipal, toTable, toYaml, truncateDisplay, unbindPayload, update, uploadDocument, validateCliAuthorizationUrl, validateMetaContent, validateMiniProject, validateScriptManifest, valueState, valuesRoundCaveat, verifyAttention, verifyRc, verifyText, waitForInstallRun, workspaceLayer, writeChangeState, writeImportPlan, writeRisk };
|
package/dist/index.js
CHANGED
|
@@ -168,6 +168,8 @@ var CliError = class extends Error {
|
|
|
168
168
|
}
|
|
169
169
|
const field = this.context?.field;
|
|
170
170
|
if (typeof field === "string" && field) parts.push(`[\u5B57\u6BB5: ${field}]`);
|
|
171
|
+
const reasonCode = this.context?.reasonCode;
|
|
172
|
+
if (typeof reasonCode === "string" && reasonCode) parts.push(`[reasonCode: ${reasonCode}]`);
|
|
171
173
|
if (this.traceId) parts.push(`[traceId: ${this.traceId}]`);
|
|
172
174
|
if (this.profile) parts.push(`[profile: ${this.profile}]`);
|
|
173
175
|
let out = parts.join(" ");
|
|
@@ -279,7 +281,9 @@ async function describe(http, model, _opts = {}) {
|
|
|
279
281
|
required: f.isRequired,
|
|
280
282
|
description: f.description,
|
|
281
283
|
enum: f.enum,
|
|
282
|
-
|
|
284
|
+
// 只在有值时出这两位:没有关联目标的普通字段不该多两行 `object: undefined` 噪声
|
|
285
|
+
...f.object ? { object: f.object } : {},
|
|
286
|
+
...f.objectLabel ? { objectLabel: f.objectLabel } : {},
|
|
283
287
|
// 只在为真时出这一位:false 与「这个服务端没有 i18n 这个概念」在下游没有区别,
|
|
284
288
|
// 出一个 `i18n: false` 只会让 --output json 的每个字段都多一行噪声。
|
|
285
289
|
...f.isI18n ? { i18n: true } : {}
|
|
@@ -1829,17 +1833,38 @@ function parseFixture(yamlText, sourcePath) {
|
|
|
1829
1833
|
}
|
|
1830
1834
|
|
|
1831
1835
|
// src/import/runner.ts
|
|
1836
|
+
var DEFAULT_KEY_FIELD = "code";
|
|
1832
1837
|
async function runImport(client, fixtures, opts = {}) {
|
|
1833
1838
|
const store = new RefStore();
|
|
1834
1839
|
const rows = [];
|
|
1835
1840
|
const tally = { created: 0, updated: 0, skipped: 0, failed: 0 };
|
|
1836
|
-
const
|
|
1841
|
+
const refsFromTarget = [];
|
|
1842
|
+
const result = () => ({
|
|
1843
|
+
...tally,
|
|
1844
|
+
rows,
|
|
1845
|
+
refs: store.snapshot(),
|
|
1846
|
+
refsFromTarget: [...refsFromTarget]
|
|
1847
|
+
});
|
|
1848
|
+
const keyFieldOf = /* @__PURE__ */ new Map();
|
|
1849
|
+
for (const fx of fixtures) {
|
|
1850
|
+
if (fx?.model && fx.key_field) keyFieldOf.set(fx.model, fx.key_field);
|
|
1851
|
+
}
|
|
1852
|
+
const lookedUp = /* @__PURE__ */ new Map();
|
|
1837
1853
|
for (const fx of fixtures) {
|
|
1838
1854
|
for (const item of fx.items) {
|
|
1839
1855
|
const key = String(item[fx.key_field]);
|
|
1840
|
-
|
|
1856
|
+
let { resolved, unresolved } = resolveRefs(item, store);
|
|
1857
|
+
if (unresolved.length > 0 && !opts.dryRun) {
|
|
1858
|
+
await lookupMissingRefs(item, { client, store, keyFieldOf, lookedUp, refsFromTarget });
|
|
1859
|
+
({ resolved, unresolved } = resolveRefs(item, store));
|
|
1860
|
+
}
|
|
1841
1861
|
if (unresolved.length > 0) {
|
|
1842
|
-
rows.push({
|
|
1862
|
+
rows.push({
|
|
1863
|
+
model: fx.model,
|
|
1864
|
+
key,
|
|
1865
|
+
status: "failed",
|
|
1866
|
+
error: unresolvedError(unresolved, !!opts.dryRun)
|
|
1867
|
+
});
|
|
1843
1868
|
tally.failed++;
|
|
1844
1869
|
if (opts.onError === "stop") return result();
|
|
1845
1870
|
continue;
|
|
@@ -1884,6 +1909,37 @@ async function runImport(client, fixtures, opts = {}) {
|
|
|
1884
1909
|
}
|
|
1885
1910
|
return result();
|
|
1886
1911
|
}
|
|
1912
|
+
async function lookupMissingRefs(item, ctx) {
|
|
1913
|
+
for (const value of Object.values(item)) {
|
|
1914
|
+
const ph = parsePlaceholder(value);
|
|
1915
|
+
if (!ph || ctx.store.get(ph.model, ph.key) !== void 0) continue;
|
|
1916
|
+
const cacheKey = `${ph.model}:${ph.key}`;
|
|
1917
|
+
if (ctx.lookedUp.has(cacheKey)) {
|
|
1918
|
+
const cached = ctx.lookedUp.get(cacheKey);
|
|
1919
|
+
if (cached) ctx.store.register(ph.model, ph.key, cached);
|
|
1920
|
+
continue;
|
|
1921
|
+
}
|
|
1922
|
+
const keyField = ctx.keyFieldOf.get(ph.model) ?? DEFAULT_KEY_FIELD;
|
|
1923
|
+
let found = null;
|
|
1924
|
+
try {
|
|
1925
|
+
found = await ctx.client.findIdByKey(ph.model, keyField, ph.key);
|
|
1926
|
+
} catch {
|
|
1927
|
+
found = null;
|
|
1928
|
+
}
|
|
1929
|
+
ctx.lookedUp.set(cacheKey, found);
|
|
1930
|
+
if (found) {
|
|
1931
|
+
ctx.store.register(ph.model, ph.key, found);
|
|
1932
|
+
ctx.refsFromTarget.push(cacheKey);
|
|
1933
|
+
}
|
|
1934
|
+
}
|
|
1935
|
+
}
|
|
1936
|
+
function unresolvedError(unresolved, dryRun) {
|
|
1937
|
+
const head = `unresolved placeholder(s): ${unresolved.join(", ")}`;
|
|
1938
|
+
if (dryRun) {
|
|
1939
|
+
return `${head}\uFF1Bdry-run \u4E0D\u56DE\u67E5\u76EE\u6807\u73AF\u5883\uFF0C\u771F\u8DD1\u65F6\u53EF\u80FD\u89E3\u6790\u5F97\u5230`;
|
|
1940
|
+
}
|
|
1941
|
+
return `${head}\uFF1B\u5DF2\u6309\u4E1A\u52A1\u952E\u56DE\u67E5\u76EE\u6807\u73AF\u5883\u4ECD\u672A\u547D\u4E2D\u3002\u4E0B\u4E00\u6B65\uFF1A\u786E\u8BA4\u88AB\u5F15\u7528\u7684\u884C\u662F\u5426\u771F\u5728\u76EE\u6807\u73AF\u5883\uFF08\u5148\u5BFC\u5165\u88AB\u5F15\u7528\u7684\u76EE\u5F55\uFF09\uFF0C\u6216\u6574\u5305\u8D70 hcm datapackage install\uFF08\u670D\u52A1\u7AEF FixtureRefResolver \u540C\u6837\u4F1A\u56DE\u67E5\u5DF2\u6709\u884C\uFF09`;
|
|
1942
|
+
}
|
|
1887
1943
|
|
|
1888
1944
|
// src/client.ts
|
|
1889
1945
|
var HcmClient = class _HcmClient {
|
|
@@ -21779,6 +21835,22 @@ import { execFileSync } from "child_process";
|
|
|
21779
21835
|
import { promises as fs12 } from "fs";
|
|
21780
21836
|
import os4 from "os";
|
|
21781
21837
|
import path23 from "path";
|
|
21838
|
+
|
|
21839
|
+
// src/jira/http-error.ts
|
|
21840
|
+
var JiraHttpError = class extends Error {
|
|
21841
|
+
status;
|
|
21842
|
+
method;
|
|
21843
|
+
path;
|
|
21844
|
+
constructor(status, method, path24, message) {
|
|
21845
|
+
super(message);
|
|
21846
|
+
this.name = "JiraHttpError";
|
|
21847
|
+
this.status = status;
|
|
21848
|
+
this.method = method;
|
|
21849
|
+
this.path = path24;
|
|
21850
|
+
}
|
|
21851
|
+
};
|
|
21852
|
+
|
|
21853
|
+
// src/jira/client.ts
|
|
21782
21854
|
var JIRA_TOKEN_FILE = () => process.env.JIRA_TOKEN_FILE || path23.join(os4.homedir(), ".config", "hcm", "jira-token");
|
|
21783
21855
|
async function jiraTokenSource() {
|
|
21784
21856
|
if (process.env.JIRA_TOKEN?.trim()) return { token: process.env.JIRA_TOKEN.trim(), from: "\u73AF\u5883\u53D8\u91CF JIRA_TOKEN" };
|
|
@@ -21844,7 +21916,10 @@ var JiraClient = class {
|
|
|
21844
21916
|
...init.body !== void 0 ? { "Content-Type": "application/json" } : {}
|
|
21845
21917
|
},
|
|
21846
21918
|
body: init.body !== void 0 ? JSON.stringify(init.body) : void 0,
|
|
21847
|
-
signal: AbortSignal.timeout(this.timeoutMs)
|
|
21919
|
+
signal: AbortSignal.timeout(this.timeoutMs),
|
|
21920
|
+
// 🔴 写请求不跟随重定向:fetch 缺省 follow,301 / 302 会把 POST 改成 GET——评论与流转一个字没写,
|
|
21921
|
+
// 调用方却拿到一个 2xx(cli#245 复核 S9)。GET 照旧跟随。
|
|
21922
|
+
redirect: method === "GET" ? "follow" : "error"
|
|
21848
21923
|
});
|
|
21849
21924
|
const text3 = await res.text();
|
|
21850
21925
|
if (!res.ok) {
|
|
@@ -21856,7 +21931,7 @@ var JiraClient = class {
|
|
|
21856
21931
|
} catch {
|
|
21857
21932
|
}
|
|
21858
21933
|
const hint = res.status === 401 ? " next_step=\u4EE4\u724C\u65E0\u6548\u6216\u8FC7\u671F\uFF0C\u91CD\u5EFA PAT \u540E\u91CD\u65B0\u5B58\u4E00\u6B21" : res.status === 403 ? " next_step=\u4EE4\u724C\u6709\u6548\u4F46\u6CA1\u6709\u8FD9\u4E2A\u9879\u76EE\u7684\u6743\u9650\uFF0C\u627E Jira \u7BA1\u7406\u5458\u5F00\u6743\u9650" : "";
|
|
21859
|
-
throw new
|
|
21934
|
+
throw new JiraHttpError(res.status, method, p, `Jira ${method} ${p} \u2192 ${res.status}\uFF1A${detail}${hint}`);
|
|
21860
21935
|
}
|
|
21861
21936
|
return text3 ? JSON.parse(text3) : null;
|
|
21862
21937
|
}
|
|
@@ -21918,14 +21993,25 @@ var JiraClient = class {
|
|
|
21918
21993
|
`${key} \u4E0A\u6CA1\u6709\u5230\u300C${nameOrId}\u300D\u7684\u6D41\u8F6C\u3002\u53EF\u7528\uFF1A${list.map((t) => `${t.name}\u2192${t.to?.name}`).join(" / ") || "\uFF08\u65E0\uFF09"}`
|
|
21919
21994
|
);
|
|
21920
21995
|
}
|
|
21996
|
+
await this.transitionById(key, hit.id, comment);
|
|
21997
|
+
return hit;
|
|
21998
|
+
}
|
|
21999
|
+
/**
|
|
22000
|
+
* 按流转 id 直接提交,**不**先重取流转——调用方刚从 `transitions()` 里核过这条流转时用它。
|
|
22001
|
+
* 评论随流转放进同一个请求(`update.comment`):校验不过整单拒、什么都不写。
|
|
22002
|
+
*
|
|
22003
|
+
* 🔴 为什么要有它:`transition()` 提交前那一跳 GET 失败时(令牌刚过期、网关 502),POST 根本没发,
|
|
22004
|
+
* 调用方却会把它当成写失败来判「写没写」(cli#245 复核 F4)。流转若在两跳之间没了,
|
|
22005
|
+
* Jira 会以 400 拒这次 POST——照样判得出「没写」。
|
|
22006
|
+
*/
|
|
22007
|
+
async transitionById(key, id, comment) {
|
|
21921
22008
|
await this.api(`/rest/api/2/issue/${encodeURIComponent(key)}/transitions`, {
|
|
21922
22009
|
method: "POST",
|
|
21923
22010
|
body: {
|
|
21924
|
-
transition: { id
|
|
22011
|
+
transition: { id },
|
|
21925
22012
|
...comment ? { update: { comment: [{ add: { body: comment } }] } } : {}
|
|
21926
22013
|
}
|
|
21927
22014
|
});
|
|
21928
|
-
return hit;
|
|
21929
22015
|
}
|
|
21930
22016
|
/**
|
|
21931
22017
|
* 建单前先问 Jira:这个项目有哪些 issuetype、每种哪些字段必填、可选值是什么。
|
|
@@ -22113,6 +22199,7 @@ export {
|
|
|
22113
22199
|
JOURNAL_STOP_KINDS,
|
|
22114
22200
|
JOURNAL_STOP_UNKNOWN,
|
|
22115
22201
|
JiraClient,
|
|
22202
|
+
JiraHttpError,
|
|
22116
22203
|
Journal,
|
|
22117
22204
|
JournalError,
|
|
22118
22205
|
KIT_CARRY_OVER_KEY,
|