@hcmai/sdk 0.21.14 → 0.22.0

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.js CHANGED
@@ -4547,6 +4547,12 @@ async function createWorkspaceFile(http, workspaceKey, relativePath, content) {
4547
4547
  });
4548
4548
  return toWorkspaceFileItem(resp.data);
4549
4549
  }
4550
+ async function validateWorkspaceFiles(http, workspaceKey, files, deletedPaths = []) {
4551
+ const resp = await http.post(`/api/models/${MODEL}/action/validate-files`, {
4552
+ form: { workspaceKey, files, deletedPaths }
4553
+ });
4554
+ return toWorkspacePreflightResult(unwrapActionData(resp.data));
4555
+ }
4550
4556
  async function deleteWorkspaceFile(http, fileId) {
4551
4557
  await http.delete(`/api/models/${MODEL}/${encodeURIComponent(fileId)}`);
4552
4558
  }
@@ -4587,6 +4593,36 @@ function toWorkspaceFileContent(value) {
4587
4593
  fileType: stringOrUndefined(obj.fileType)
4588
4594
  };
4589
4595
  }
4596
+ function toWorkspacePreflightResult(value) {
4597
+ const obj = asRecord(value);
4598
+ if (typeof obj.ok !== "boolean" || typeof obj.checked !== "number" || !Array.isArray(obj.issues)) {
4599
+ throw new CliError({
4600
+ code: "NETWORK_ERROR" /* NETWORK_ERROR */,
4601
+ message: "\u5DE5\u4F5C\u533A validate-files \u54CD\u5E94\u7F3A\u5C11 ok / checked / issues\uFF0C\u65E0\u6CD5\u5224\u65AD\u9884\u68C0\u7ED3\u8BBA\u3002",
4602
+ context: {
4603
+ reason: "INVALID_WORKSPACE_PREFLIGHT_RESULT",
4604
+ nextStep: "\u786E\u8BA4\u670D\u52A1\u7AEF\u7248\u672C\u5DF2\u5305\u542B validate-files\uFF08HCMNX-328\uFF09\uFF1B\u4E0D\u80FD\u628A\u7F3A\u5931\u7684\u7ED3\u8BBA\u5F53\u4F5C\u9884\u68C0\u901A\u8FC7\u3002"
4605
+ }
4606
+ });
4607
+ }
4608
+ return {
4609
+ ok: obj.ok,
4610
+ workspaceKey: stringOr(obj.workspaceKey),
4611
+ checked: obj.checked,
4612
+ checkedPaths: Array.isArray(obj.checkedPaths) ? obj.checkedPaths.map((p) => stringOr(p)) : [],
4613
+ issues: obj.issues.map((raw) => {
4614
+ const issue = asRecord(raw);
4615
+ return {
4616
+ path: issue.path == null ? null : stringOr(issue.path),
4617
+ errCode: stringOrUndefined(issue.errCode),
4618
+ message: stringOr(issue.message),
4619
+ description: stringOrUndefined(issue.description),
4620
+ field: stringOrUndefined(issue.field),
4621
+ data: issue.data
4622
+ };
4623
+ })
4624
+ };
4625
+ }
4590
4626
  function asRecord(value) {
4591
4627
  return value && typeof value === "object" ? value : {};
4592
4628
  }
@@ -6142,6 +6178,23 @@ async function pushMiniAppProject(args) {
6142
6178
  await writeMiniState(root, context, localFiles, remoteByLocalPath);
6143
6179
  return result;
6144
6180
  }
6181
+ async function collectMiniPushWrites(rootDir, operations) {
6182
+ const localByPath = new Map(
6183
+ (await readLocalMiniFiles(path6.resolve(rootDir))).map((file) => [file.localPath, file])
6184
+ );
6185
+ const files = [];
6186
+ const deletedPaths = [];
6187
+ for (const operation of operations) {
6188
+ if (operation.operation === "delete") {
6189
+ if (operation.fileId) deletedPaths.push(operation.remotePath);
6190
+ continue;
6191
+ }
6192
+ if (operation.operation !== "create" && !(operation.operation === "update" && operation.fileId)) continue;
6193
+ const localFile = localByPath.get(operation.localPath);
6194
+ if (localFile) files.push({ relativePath: operation.remotePath, content: localFile.content });
6195
+ }
6196
+ return { files, deletedPaths };
6197
+ }
6145
6198
  async function buildMiniPreviewTargets(rootDir, frontendBaseUrl) {
6146
6199
  const context = await readMiniContext(path6.resolve(rootDir));
6147
6200
  const app = encodeURIComponent(context.appCode);
@@ -6267,10 +6320,11 @@ function buildMiniVerifyAgentReport(report) {
6267
6320
  url: target.url
6268
6321
  })
6269
6322
  );
6270
- const safeToPush = report.validate.valid && dryRunOk && previewUrls.length > 0 && smokeOk;
6323
+ const preflightFailed = report.preflight?.status === "failed";
6324
+ const safeToPush = report.validate.valid && dryRunOk && previewUrls.length > 0 && smokeOk && !preflightFailed;
6271
6325
  const nextAction = chooseMiniVerifyNextAction(report, previewUrls, smoke);
6272
6326
  return {
6273
- ok: report.ok && smokeOk,
6327
+ ok: report.ok && smokeOk && !preflightFailed,
6274
6328
  safeToPush,
6275
6329
  nextAction,
6276
6330
  summary: {
@@ -6306,7 +6360,8 @@ function buildMiniVerifyAgentReport(report) {
6306
6360
  ok: previewUrls.length > 0,
6307
6361
  count: previewUrls.length,
6308
6362
  surfaces: previewUrls.map((target) => target.surface)
6309
- }
6363
+ },
6364
+ preflight: report.preflight ? { status: report.preflight.status, sent: report.preflight.sent, issues: report.preflight.issues.length } : null
6310
6365
  },
6311
6366
  changedFiles: report.status.filter((entry) => entry.status !== "unchanged").map(
6312
6367
  (entry) => ({
@@ -6358,6 +6413,9 @@ function chooseMiniVerifyNextAction(report, previewUrls, smoke) {
6358
6413
  if (!report.validate.valid) return "fix-validation";
6359
6414
  if (!report.plan) return "inspect-status";
6360
6415
  if (report.plan.conflicts.length) return "resolve-conflict";
6416
+ if (report.preflight?.status === "failed") {
6417
+ return report.preflight.issues.some((issue) => issue.errCode === "WORKSPACE_FILE_CONFLICT") ? "resolve-conflict" : "fix-validation";
6418
+ }
6361
6419
  if (!previewUrls.length) return "inspect-preview";
6362
6420
  return "push";
6363
6421
  }
@@ -6397,6 +6455,13 @@ function formatMiniVerifyReport(report) {
6397
6455
  } else {
6398
6456
  lines.push(`[3/${totalSteps}] dry-run: - skipped (${report.planSkipped ?? "unknown reason"})`);
6399
6457
  }
6458
+ if (report.preflight) {
6459
+ const preflight2 = report.preflight;
6460
+ lines.push(preflight2.status === "failed" ? ` server preflight: \u2717 ${preflight2.issues.length} issue(s)` : ` server preflight: ${preflight2.status} (${preflight2.sent} file(s) sent)`);
6461
+ for (const issue of preflight2.issues) {
6462
+ lines.push(` ${issue.path ?? "(\u6574\u6279)"}: [${issue.errCode ?? "ERROR"}] ${issue.message}`);
6463
+ }
6464
+ }
6400
6465
  if (report.preview.length) {
6401
6466
  lines.push(`[4/${totalSteps}] preview:`);
6402
6467
  for (const target of report.preview) lines.push(` ${target.key.padEnd(11)} ${target.url}`);
@@ -7231,7 +7296,7 @@ async function deleteTenantMeta(http, path24) {
7231
7296
  import yaml9 from "js-yaml";
7232
7297
 
7233
7298
  // src/meta/generated/meta-schemas.ts
7234
- var META_SCHEMA_SOURCE_COMMIT = "2d4b4a9ee24111c6ff425f88d109b2eddf811b51";
7299
+ var META_SCHEMA_SOURCE_COMMIT = "cfad9ef13881cc799a88cbfcef8229b5cefcdc3f";
7235
7300
  var META_SCHEMAS = {
7236
7301
  list: {
7237
7302
  "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -7374,6 +7439,9 @@ var META_SCHEMAS = {
7374
7439
  },
7375
7440
  "targetModel": {
7376
7441
  "type": "string"
7442
+ },
7443
+ "timeoutMs": {
7444
+ "type": "integer"
7377
7445
  }
7378
7446
  }
7379
7447
  },
@@ -7882,6 +7950,11 @@ var META_SCHEMAS = {
7882
7950
  },
7883
7951
  "targetModel": {
7884
7952
  "type": "string"
7953
+ },
7954
+ "timeoutMs": {
7955
+ "type": "integer",
7956
+ "minimum": 1,
7957
+ "maximum": 3e5
7885
7958
  }
7886
7959
  }
7887
7960
  },
@@ -8902,7 +8975,60 @@ var META_SCHEMAS = {
8902
8975
  "description": "\u5217\u8868\u6811\u5F62\u5C55\u793A;\u6309 parentField \u628A\u5F53\u524D\u9875\u6570\u636E\u6E32\u67D3\u6210\u53EF\u9010\u7EA7\u5C55\u5F00\u7684\u6811\u8868\u3002\u7236\u5B50\u5173\u7CFB\u53EA\u4F5C\u7528\u5728\u6E32\u67D3\u5C42,\u7B5B\u9009/\u6392\u5E8F/\u5206\u9875/\u6743\u9650\u53E3\u5F84\u4E0D\u53D8",
8903
8976
  "additionalProperties": false,
8904
8977
  "required": ["parentField"]
8978
+ },
8979
+ "capabilityVersion": {
8980
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
8981
+ },
8982
+ "columns": {
8983
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
8984
+ },
8985
+ "defaultFilter": {
8986
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
8987
+ },
8988
+ "emptyState": {
8989
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
8990
+ },
8991
+ "filters": {
8992
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
8993
+ },
8994
+ "modelKey": {
8995
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
8996
+ },
8997
+ "orders": {
8998
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
8999
+ },
9000
+ "plugin": {
9001
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9002
+ },
9003
+ "query": {
9004
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9005
+ },
9006
+ "rowActions": {
9007
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9008
+ },
9009
+ "scene": {
9010
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9011
+ },
9012
+ "search": {
9013
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9014
+ },
9015
+ "state": {
9016
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9017
+ },
9018
+ "tip": {
9019
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9020
+ },
9021
+ "title": {
9022
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9023
+ },
9024
+ "toolActions": {
9025
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
8905
9026
  }
9027
+ },
9028
+ "x-hcm-authoring": {
9029
+ "topLevel": "closed",
9030
+ "errCode": "META_UNKNOWN_AUTHORING_KEY",
9031
+ "retiredTopLevelKeys": {}
8906
9032
  }
8907
9033
  },
8908
9034
  info: {
@@ -9157,6 +9283,11 @@ var META_SCHEMAS = {
9157
9283
  },
9158
9284
  "targetModel": {
9159
9285
  "type": "string"
9286
+ },
9287
+ "timeoutMs": {
9288
+ "type": "integer",
9289
+ "minimum": 1,
9290
+ "maximum": 3e5
9160
9291
  }
9161
9292
  }
9162
9293
  },
@@ -9610,6 +9741,55 @@ var META_SCHEMAS = {
9610
9741
  "tip": {
9611
9742
  "type": "string",
9612
9743
  "description": "\u8868\u5355\u9876\u90E8\u63D0\u793A\u6587\u6848(\u652F\u6301\u6362\u884C);\u5E38\u7528\u4E8E\u6DFB\u52A0\u4E1A\u52A1\u8BF4\u660E\u3001\u8B66\u793A\u4FE1\u606F,\u663E\u793A\u5728\u6240\u6709\u5B57\u6BB5\u4E4B\u524D"
9744
+ },
9745
+ "additions": {
9746
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9747
+ },
9748
+ "capabilityVersion": {
9749
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9750
+ },
9751
+ "layout": {
9752
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9753
+ },
9754
+ "modelKey": {
9755
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9756
+ },
9757
+ "plugin": {
9758
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9759
+ },
9760
+ "pluginChildren": {
9761
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9762
+ },
9763
+ "pluginSchemeCardExtFields": {
9764
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9765
+ },
9766
+ "pluginSchemeExtFields": {
9767
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9768
+ },
9769
+ "purpose": {
9770
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9771
+ },
9772
+ "scene": {
9773
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9774
+ },
9775
+ "state": {
9776
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9777
+ },
9778
+ "synonyms": {
9779
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9780
+ },
9781
+ "title": {
9782
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9783
+ },
9784
+ "typicalQueries": {
9785
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
9786
+ }
9787
+ },
9788
+ "x-hcm-authoring": {
9789
+ "topLevel": "closed",
9790
+ "errCode": "META_UNKNOWN_AUTHORING_KEY",
9791
+ "retiredTopLevelKeys": {
9792
+ "sections": "\u6539\u5199\u4E3A\u9876\u5C42 fields[] + groups[]\uFF1Bgroups[].fields \u53EA\u586B\u5199\u5B57\u6BB5 key\uFF08\u5206\u7EC4\u7167\u6837\u6E32\u67D3\uFF09"
9613
9793
  }
9614
9794
  }
9615
9795
  },
@@ -9865,6 +10045,11 @@ var META_SCHEMAS = {
9865
10045
  },
9866
10046
  "targetModel": {
9867
10047
  "type": "string"
10048
+ },
10049
+ "timeoutMs": {
10050
+ "type": "integer",
10051
+ "minimum": 1,
10052
+ "maximum": 3e5
9868
10053
  }
9869
10054
  }
9870
10055
  },
@@ -10274,7 +10459,30 @@ var META_SCHEMAS = {
10274
10459
  "name": {
10275
10460
  "type": "string",
10276
10461
  "description": '\u5143\u6570\u636E\u663E\u793A\u540D\u79F0(\u5982 "\u7EC4\u7EC7\u5355\u5143");\u901A\u5E38\u7528\u4E8E\u9875\u9762\u6807\u9898\u6216\u5143\u6570\u636E\u6D4F\u89C8'
10462
+ },
10463
+ "capabilityVersion": {
10464
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
10465
+ },
10466
+ "children": {
10467
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
10468
+ },
10469
+ "layout": {
10470
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
10471
+ },
10472
+ "modelKey": {
10473
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
10474
+ },
10475
+ "state": {
10476
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
10477
+ },
10478
+ "subLists": {
10479
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
10277
10480
  }
10481
+ },
10482
+ "x-hcm-authoring": {
10483
+ "topLevel": "closed",
10484
+ "errCode": "META_UNKNOWN_AUTHORING_KEY",
10485
+ "retiredTopLevelKeys": {}
10278
10486
  }
10279
10487
  },
10280
10488
  filter: {
@@ -10386,7 +10594,18 @@ var META_SCHEMAS = {
10386
10594
  "name": {
10387
10595
  "type": "string",
10388
10596
  "description": '\u5143\u6570\u636E\u663E\u793A\u540D\u79F0(\u5982 "\u7EC4\u7EC7\u5355\u5143");\u901A\u5E38\u7528\u4E8E\u9875\u9762\u6807\u9898\u6216\u5143\u6570\u636E\u6D4F\u89C8'
10597
+ },
10598
+ "capabilityVersion": {
10599
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
10600
+ },
10601
+ "modelKey": {
10602
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
10389
10603
  }
10604
+ },
10605
+ "x-hcm-authoring": {
10606
+ "topLevel": "closed",
10607
+ "errCode": "META_UNKNOWN_AUTHORING_KEY",
10608
+ "retiredTopLevelKeys": {}
10390
10609
  }
10391
10610
  },
10392
10611
  model: {
@@ -10847,6 +11066,53 @@ var META_SCHEMAS = {
10847
11066
  }
10848
11067
  },
10849
11068
  "required": ["kind"]
11069
+ }, {
11070
+ "type": "object",
11071
+ "description": "\u8BFB\u65F6\u6D3E\u751F\uFF08ADR-442\uFF09\uFF1A\u7531\u5E73\u53F0\u6CE8\u518C\u7684 provider \u5728\u53D6\u6570\u540E\u8BA1\u7B97\uFF0C\u53EA\u80FD\u653E\u5728 fields \u91CC\u5C55\u793A\uFF1B\u4E0D\u53EF\u7B5B\u9009\u3001\u6392\u5E8F\u3001\u5206\u7EC4\u3001\u805A\u5408\uFF0C\u4E0D\u4E0B\u63A8 SQL\u3002security.classification \u5FC5\u586B\u3001security.sources \u7531\u52A0\u8F7D\u5668\u751F\u6210\uFF08\u7981\u6B62\u624B\u5199\uFF09\uFF1B\u79DF\u6237\u5143\u6570\u636E\u4E00\u5F8B\u4E0D\u80FD\u58F0\u660E\u3002",
11072
+ "properties": {
11073
+ "kind": {
11074
+ "const": "provider"
11075
+ },
11076
+ "provider": {
11077
+ "type": "string",
11078
+ "pattern": "^platform:"
11079
+ },
11080
+ "params": {
11081
+ "type": "object"
11082
+ },
11083
+ "dependsOn": {
11084
+ "type": "array",
11085
+ "items": {
11086
+ "type": "string",
11087
+ "pattern": "^[^.]+$"
11088
+ }
11089
+ },
11090
+ "extraSources": {
11091
+ "type": "array",
11092
+ "items": {
11093
+ "type": "string",
11094
+ "pattern": "^[^.]+$"
11095
+ }
11096
+ },
11097
+ "returnType": {
11098
+ "type": "string",
11099
+ "enum": ["STRING", "INTEGER", "LONG", "DECIMAL", "BOOLEAN", "DATE", "DATETIME"]
11100
+ },
11101
+ "computeOnEmptyFields": {
11102
+ "type": "boolean"
11103
+ },
11104
+ "filterable": {
11105
+ "const": false
11106
+ },
11107
+ "sortable": {
11108
+ "const": false
11109
+ },
11110
+ "pushDownable": {
11111
+ "const": false
11112
+ }
11113
+ },
11114
+ "required": ["kind", "provider", "returnType"],
11115
+ "additionalProperties": false
10850
11116
  }]
10851
11117
  },
10852
11118
  "description": {
@@ -11055,7 +11321,36 @@ var META_SCHEMAS = {
11055
11321
  "valueMatch": {
11056
11322
  "type": "boolean"
11057
11323
  }
11058
- }
11324
+ },
11325
+ "allOf": [{
11326
+ "description": "\u8BFB\u65F6\u6D3E\u751F\u5B57\u6BB5\uFF08derived.kind=provider\uFF0CADR-442\uFF09\uFF1Asecurity \u5FC5\u586B\u4E14\u5FC5\u987B\u663E\u5F0F\u5199 classification\uFF1Bsecurity.sources \u7531\u52A0\u8F7D\u5668\u6309 dependsOn \u222A extraSources \u751F\u6210\uFF0C\u7981\u6B62\u624B\u5199\u3002",
11327
+ "if": {
11328
+ "properties": {
11329
+ "derived": {
11330
+ "type": "object",
11331
+ "properties": {
11332
+ "kind": {
11333
+ "const": "provider"
11334
+ }
11335
+ },
11336
+ "required": ["kind"]
11337
+ }
11338
+ },
11339
+ "required": ["derived"]
11340
+ },
11341
+ "then": {
11342
+ "properties": {
11343
+ "security": {
11344
+ "type": "object",
11345
+ "required": ["classification"],
11346
+ "not": {
11347
+ "required": ["sources"]
11348
+ }
11349
+ }
11350
+ },
11351
+ "required": ["security"]
11352
+ }
11353
+ }]
11059
11354
  }
11060
11355
  },
11061
11356
  "immutableWhen": {
@@ -12453,7 +12748,30 @@ var META_SCHEMAS = {
12453
12748
  "name": {
12454
12749
  "type": "string",
12455
12750
  "description": '\u5143\u6570\u636E\u663E\u793A\u540D\u79F0(\u5982 "\u7EC4\u7EC7\u5355\u5143");\u901A\u5E38\u7528\u4E8E\u9875\u9762\u6807\u9898\u6216\u5143\u6570\u636E\u6D4F\u89C8'
12751
+ },
12752
+ "actions": {
12753
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
12754
+ },
12755
+ "capabilityVersion": {
12756
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
12757
+ },
12758
+ "componentKey": {
12759
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
12760
+ },
12761
+ "modelKey": {
12762
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
12763
+ },
12764
+ "scene": {
12765
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
12766
+ },
12767
+ "state": {
12768
+ "description": "\u4F5C\u8005\u6001\u9876\u5C42\u952E\uFF1A\u670D\u52A1\u7AEF\u79DF\u6237\u5199\u5165\u767D\u540D\u5355\u63A5\u53D7\uFF1B\u672C schema \u4E0D\u7EA6\u675F\u5176\u5185\u90E8\u5F62\u72B6\uFF08\u767D\u540D\u5355\u767B\u8BB0\u5728 MetaAuthoringContract\uFF09"
12456
12769
  }
12770
+ },
12771
+ "x-hcm-authoring": {
12772
+ "topLevel": "closed",
12773
+ "errCode": "META_UNKNOWN_AUTHORING_KEY",
12774
+ "retiredTopLevelKeys": {}
12457
12775
  }
12458
12776
  },
12459
12777
  wiz: {
@@ -13530,6 +13848,11 @@ var META_SCHEMAS = {
13530
13848
  "type": {
13531
13849
  "type": "string"
13532
13850
  }
13851
+ },
13852
+ "x-hcm-authoring": {
13853
+ "topLevel": "closed",
13854
+ "errCode": "META_UNKNOWN_AUTHORING_KEY",
13855
+ "retiredTopLevelKeys": {}
13533
13856
  }
13534
13857
  }
13535
13858
  };
@@ -13671,6 +13994,11 @@ function preview(v) {
13671
13994
  function locateLine(rawLines, segs, root) {
13672
13995
  const leaf = segs[segs.length - 1];
13673
13996
  if (typeof leaf !== "string") return void 0;
13997
+ if (segs.length === 1) {
13998
+ const rootRe = new RegExp(`^["']?${leaf.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}["']?\\s*:`);
13999
+ const hits = rawLines.flatMap((l, i) => rootRe.test(l) ? [i] : []);
14000
+ return hits.length === 1 ? hits[0] + 1 : void 0;
14001
+ }
13674
14002
  let anchorKey;
13675
14003
  let node = root;
13676
14004
  for (const s of segs) {
@@ -13742,6 +14070,11 @@ function walk2(root, schema, value, segs, kind, issues, depth) {
13742
14070
  continue;
13743
14071
  }
13744
14072
  if (openMap || isDirectiveKey(k)) continue;
14073
+ const closedRoot = segs.length === 0 ? authoringContract(root) : void 0;
14074
+ if (closedRoot) {
14075
+ issues.push(closedRootIssue(kind, k, props, closedRoot));
14076
+ continue;
14077
+ }
13745
14078
  const inFieldItem = segs.length >= 2 && typeof segs[segs.length - 1] === "number" && segs[segs.length - 2] === "fields";
13746
14079
  const alias = inFieldItem ? ALIAS_HINTS[kind]?.[k] : void 0;
13747
14080
  const twin = alias ? void 0 : isPrefixedTwin(props, k);
@@ -13764,6 +14097,26 @@ function walk2(root, schema, value, segs, kind, issues, depth) {
13764
14097
  }
13765
14098
  }
13766
14099
  }
14100
+ var AUTHORING_EXTENSION_KEY = "x-hcm-authoring";
14101
+ function authoringContract(root) {
14102
+ const ext = root[AUTHORING_EXTENSION_KEY];
14103
+ if (!ext || typeof ext !== "object" || ext.topLevel !== "closed") return void 0;
14104
+ const retired = ext.retiredTopLevelKeys;
14105
+ return {
14106
+ errCode: typeof ext.errCode === "string" ? ext.errCode : "META_UNKNOWN_AUTHORING_KEY",
14107
+ retiredTopLevelKeys: retired && typeof retired === "object" ? retired : {}
14108
+ };
14109
+ }
14110
+ function closedRootIssue(kind, key, props, contract) {
14111
+ const rewrite = contract.retiredTopLevelKeys[key];
14112
+ const allowed = Object.keys(props).sort();
14113
+ return {
14114
+ severity: "error",
14115
+ path: key,
14116
+ message: rewrite ? `${contract.errCode}: \u9876\u5C42\u952E \`${key}\` \u662F\u5DF2\u9000\u5F79\u7684 ${kind} \u4F5C\u8005\u6001\u5F62\u6001\uFF0C\u670D\u52A1\u7AEF\u5199\u5165\u4F1A\u62D2\u7EDD` : `${contract.errCode}: \u9876\u5C42\u952E \`${key}\` \u4E0D\u662F ${kind} \u4F5C\u8005\u6001\u5951\u7EA6\u7684\u4E00\u90E8\u5206\uFF0C\u670D\u52A1\u7AEF\u5199\u5165\u4F1A\u62D2\u7EDD`,
14117
+ hint: (rewrite ?? `\u5141\u8BB8\u7684\u9876\u5C42\u952E\uFF1A${allowed.join(", ")}`) + `\uFF08\u5951\u7EA6\u6765\u6E90 core@${META_SCHEMA_SOURCE_COMMIT.slice(0, 8)}\uFF1B\u670D\u52A1\u7AEF\u82E5\u5DF2\u66F4\u65B0\uFF0C\u4EE5 \`hcm workspace verify\` \u7684\u670D\u52A1\u7AEF\u9884\u68C0\u4E3A\u51C6\uFF09`
14118
+ };
14119
+ }
13767
14120
  function validateScriptActionNames(doc, issues) {
13768
14121
  if (!doc || typeof doc !== "object" || !Array.isArray(doc.actions))
13769
14122
  return;
@@ -26108,6 +26461,7 @@ export {
26108
26461
  clearMetaCache,
26109
26462
  clearModelCache,
26110
26463
  cliAuthorizationExpired,
26464
+ collectMiniPushWrites,
26111
26465
  commandsFor,
26112
26466
  compareFingerprint,
26113
26467
  computeFingerprint,
@@ -26354,6 +26708,7 @@ export {
26354
26708
  validateMetaContent,
26355
26709
  validateMiniProject,
26356
26710
  validateScriptManifest,
26711
+ validateWorkspaceFiles,
26357
26712
  valueState,
26358
26713
  valuesRoundCaveat,
26359
26714
  verifyAttention,