@hcmai/sdk 0.4.11 → 0.4.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -247,6 +247,16 @@ interface ModelDescription {
247
247
  fields: FieldMeta[];
248
248
  actions: ActionMeta[];
249
249
  relations: RelationMeta[];
250
+ /**
251
+ * 脚本 / CodeFlow Action 是否已并入 {@link actions}。
252
+ *
253
+ * 🔴 `false` 表示 `actions` **只有注解 action**,YAML 里声明的脚本 Action 一个都不在里面——
254
+ * 此时「列表里没有」不等于「这个 Action 不存在」。不允许静默降级:
255
+ * 降级了就必须把 {@link effectiveActionsNote} 打出来。
256
+ */
257
+ effectiveActionsAvailable: boolean;
258
+ /** 降级原因;`effectiveActionsAvailable === false` 时必有值。 */
259
+ effectiveActionsNote?: string;
250
260
  }
251
261
  interface DescribeOpts {
252
262
  verbose?: boolean;
@@ -5283,17 +5293,17 @@ declare function scan(skillRoot: string, aclass: Partial<Aclass>, facts: readonl
5283
5293
  declare function exitCode(result: Pick<ScanResult, 'premise' | 'red'>): number;
5284
5294
 
5285
5295
  /**
5286
- * 六类承载物的核查结果契约 —— 分诊的**穷举**那一步落在这里。
5296
+ * 七类承载物的核查结果契约 —— 分诊的**穷举**那一步落在这里。
5287
5297
  *
5288
5298
  * 🔴 **本模块判的是「有没有填」,不是「填得对不对」**。顾问看一眼觉得产品做不到就直接
5289
- * 判缺口,是分诊最贵的失误;而「结论对不对」无法机械验证,「六格有没有被填满」可以。
5299
+ * 判缺口,是分诊最贵的失误;而「结论对不对」无法机械验证,「七格有没有被填满」可以。
5290
5300
  * 所以这里只提供一个**填不满就抛**的结构。
5291
5301
  *
5292
5302
  * 🔴 **四档不是三档。** `blind`(盲区)与 `miss`(看了没有)**必须是两个取值**:
5293
5303
  * 前者是「这条路在 HTTP 面上根本看不见」,后者是「看见了、没有」。混成一档,
5294
5304
  * 跳步就能伪装成盲区 —— 那正是本模块要防的东西。
5295
5305
  *
5296
- * ## 六类承载物的可探性
5306
+ * ## 七类承载物的可探性
5297
5307
  *
5298
5308
  * | 承载物 | 判别 | 来源 |
5299
5309
  * |---|---|---|
@@ -5302,6 +5312,7 @@ declare function exitCode(result: Pick<ScanResult, 'premise' | 'red'>): number;
5302
5312
  * | `json-model` | `BaseJsonModel` 派生 —— **只读、不支持增删改** | `mutation-capability`(间接) |
5303
5313
  * | `graaljs-spi` | 开发空间的 `scripts/` | `tenant-extension/workspaces` |
5304
5314
  * | `flex-data` | 字段级 `isFlex` | recon 产物 |
5315
+ * | `indicator-dashboard` | 模型清单里**同时**有指标库与看板定义两个模型 | recon 产物 |
5305
5316
  * | `data-package` | —— | 🔴 **全 `modules/` 无 Controller ⇒ 真盲区** |
5306
5317
  *
5307
5318
  * 🔴 `ModelType` 只有 `DATA` / `MONGO` / `DYNAMIC` / `UNKNOWN` 四个值,**没有独立的
@@ -5311,13 +5322,18 @@ declare function exitCode(result: Pick<ScanResult, 'premise' | 'red'>): number;
5311
5322
  * ⚠️ 上表是**源码推得 · wire 未实测**。它证明的是「本模块怎么判」,不是「产品真的这么答」。
5312
5323
  */
5313
5324
  /**
5314
- * 六格。
5325
+ * 七格。
5315
5326
  *
5316
5327
  * 🔴 顺序固定且**是契约的一部分**:产出的核查表按这个顺序渲染,顾问逐格看下去的路径是
5317
- * 稳定的。加第七类必须同时改 `CARRIER_LABELS` 与渲染层 —— 由类型接住:
5328
+ * 稳定的。加第八类必须同时改 `CARRIER_LABELS` 与渲染层 —— 由类型接住:
5318
5329
  * `CARRIER_LABELS` 声明成 `Record<CarrierKey, string>`,漏一格当场编译不过。
5330
+ *
5331
+ * 🔴 `indicator-dashboard` 是 2026-09-01 加的第七格,排在 `data-package` 之前:
5332
+ * 盲区那一格留在最后,顾问读到表尾时看见的仍是「有一条路我没看见」。
5333
+ * 加它的成因是一次真实交付(队伍建设驾驶舱):产物四层里指标 / 目标 / 看板三层
5334
+ * 都不在原来六格的任何一格里,分诊只会告诉顾问「数据放哪」,不会告诉他交付主体在哪。
5319
5335
  */
5320
- declare const CARRIER_KEYS: readonly ["config-surface", "flex-model", "json-model", "graaljs-spi", "flex-data", "data-package"];
5336
+ declare const CARRIER_KEYS: readonly ["config-surface", "flex-model", "json-model", "graaljs-spi", "flex-data", "indicator-dashboard", "data-package"];
5321
5337
  type CarrierKey = (typeof CARRIER_KEYS)[number];
5322
5338
  /** 🔴 只写**承载物是什么**(协议事实),不写某个环境里有哪些(A 类环境事实)。 */
5323
5339
  declare const CARRIER_LABELS: Record<CarrierKey, string>;
@@ -5367,7 +5383,7 @@ declare const DATA_PACKAGE_BLIND_NOTE: string;
5367
5383
  */
5368
5384
  declare function isReadOnly(mapping: unknown): boolean;
5369
5385
  /**
5370
- * 六格全填 —— 每一格都有 verdict,**没有空格**。
5386
+ * 七格全填 —— 每一格都有 verdict,**没有空格**。
5371
5387
  *
5372
5388
  * 🔴 返回类型是 `Record<CarrierKey, CarrierResult>`:漏填一格当场编译不过,
5373
5389
  * 这比一条运行时断言更早。
@@ -5407,9 +5423,9 @@ declare function checkCoherence(entry: TriageEntry): TriageProblem[];
5407
5423
  * 结论取值域。
5408
5424
  *
5409
5425
  * - `REUSE` = 已有现成的,直接用
5410
- * - `CONFIG` = 配置能做(六格里有命中)
5426
+ * - `CONFIG` = 配置能做(七格里有命中)
5411
5427
  * - `EXTEND` = 要走二开(弹性模型 / 脚本 / 元数据)
5412
- * - `GAP` = 六条路都走不通,回产品立案
5428
+ * - `GAP` = 七条路都走不通,回产品立案
5413
5429
  */
5414
5430
  declare const VERDICTS: readonly ["REUSE", "CONFIG", "EXTEND", "GAP"];
5415
5431
  type TriageVerdict = (typeof VERDICTS)[number];
@@ -5425,7 +5441,7 @@ declare const DEBT_UNKNOWN = "\uFF08\u8FD8\u8BF4\u4E0D\u51FA\u7F3A\u54EA\u4E2A A
5425
5441
  declare function renderTriage(entries: readonly TriageEntry[]): string;
5426
5442
 
5427
5443
  /**
5428
- * 一趟分诊的编排 —— 探六格、判自洽、落盘。
5444
+ * 一趟分诊的编排 —— 探七格、判自洽、落盘。
5429
5445
  *
5430
5446
  * 🔴 **为什么这一层在 core 而不是在命令里**:命令层多一处判断就会与这里的那份漂移,
5431
5447
  * 而顾问看到的是命令层那一份。与 `runRecon(probe, layout, …)` 同一条形状:
package/dist/index.js CHANGED
@@ -1122,7 +1122,10 @@ function normalizeActionParams(action3) {
1122
1122
  }));
1123
1123
  }
1124
1124
  async function describe(http, model, _opts = {}) {
1125
- const metaResp = await http.get(`/api/models/${model}/meta`);
1125
+ const [metaResp, effective] = await Promise.all([
1126
+ http.get(`/api/models/${model}/meta`),
1127
+ fetchEffectiveActions(http, model)
1128
+ ]);
1126
1129
  const meta = metaResp.data;
1127
1130
  const fields = (meta.fields ?? []).map((f) => ({
1128
1131
  name: f.key ?? f.name ?? "",
@@ -1150,10 +1153,55 @@ async function describe(http, model, _opts = {}) {
1150
1153
  model: meta.name ?? model,
1151
1154
  labels: meta.labels ?? {},
1152
1155
  fields,
1153
- actions,
1154
- relations: meta.relations ?? []
1156
+ actions: mergeEffectiveActions(actions, effective),
1157
+ relations: meta.relations ?? [],
1158
+ effectiveActionsAvailable: effective.available,
1159
+ ...effective.available ? {} : { effectiveActionsNote: effective.note }
1155
1160
  };
1156
1161
  }
1162
+ async function fetchEffectiveActions(http, model) {
1163
+ try {
1164
+ const resp = await http.get(`/api/models/${model}/actions`);
1165
+ const rows = resp.data?.actions;
1166
+ if (!Array.isArray(rows)) {
1167
+ return {
1168
+ available: false,
1169
+ rows: [],
1170
+ note: `GET /api/models/${model}/actions \u6CA1\u6709\u8FD4\u56DE actions \u6570\u7EC4\uFF0C\u811A\u672C Action \u672A\u7EB3\u5165`
1171
+ };
1172
+ }
1173
+ return { available: true, rows };
1174
+ } catch (e) {
1175
+ const err = e;
1176
+ const status = err?.response?.status;
1177
+ const detail = status ? `HTTP ${status}` : err?.message ?? String(e);
1178
+ return {
1179
+ available: false,
1180
+ rows: [],
1181
+ note: `GET /api/models/${model}/actions \u4E0D\u53EF\u7528\uFF08${detail}\uFF09\uFF0C\u811A\u672C Action \u672A\u7EB3\u5165`
1182
+ };
1183
+ }
1184
+ }
1185
+ function mergeEffectiveActions(fromMeta, effective) {
1186
+ if (!effective.available) return fromMeta;
1187
+ const known = new Set(fromMeta.map((a) => a.name));
1188
+ const extra = [];
1189
+ for (const row of effective.rows) {
1190
+ const name = row.key ?? "";
1191
+ if (!name || known.has(name)) continue;
1192
+ known.add(name);
1193
+ const candidate = row.candidates?.[0];
1194
+ extra.push({
1195
+ name,
1196
+ label: row.label,
1197
+ scope: candidate?.scope,
1198
+ httpMethod: "POST",
1199
+ readOnly: row.readOnly,
1200
+ source: candidate?.source
1201
+ });
1202
+ }
1203
+ return [...fromMeta, ...extra];
1204
+ }
1157
1205
 
1158
1206
  // src/fde/fingerprint.ts
1159
1207
  import { createHash } from "crypto";
@@ -16168,7 +16216,7 @@ var PROTOCOL_FACTS = [
16168
16216
  {
16169
16217
  token: "/api/tenant-extension/workspaces",
16170
16218
  probe: "packages/core/tests/fde-triage-probe.test.ts::workspaces-path-wire-shape",
16171
- note: "\u5F00\u53D1\u7A7A\u95F4\u6E05\u5355\u8D70\u88F8\u8DEF\u5F84 GET\uFF0C\u662F\u5206\u8BCA\u516D\u683C\u91CC `graaljs-spi` \u90A3\u4E00\u683C\u552F\u4E00\u8981\u8054\u7F51\u7684\u4E00\u53D1\u3002\u63A2\u9488\u65AD\u7684\u662F**\u6574\u8D9F\u5B9E\u9645\u6253\u51FA\u53BB\u7684\u8DEF\u5F84\u5217\u8868\u9010\u5B57\u76F8\u7B49**\uFF08\u4E0D\u662F\u300C\u542B\u67D0\u4E2A\u8BCD\u300D\uFF09\u2014\u2014\u8DEF\u5F84\u6539\u4E86\u3001\u6216\u8005\u522B\u7684\u683C\u5077\u5077\u591A\u6253\u4E86\u4E00\u53D1\uFF0C\u90FD\u4F1A\u7EA2\u3002"
16219
+ note: "\u5F00\u53D1\u7A7A\u95F4\u6E05\u5355\u8D70\u88F8\u8DEF\u5F84 GET\uFF0C\u662F\u5206\u8BCA\u4E03\u683C\u91CC `graaljs-spi` \u90A3\u4E00\u683C\u552F\u4E00\u8981\u8054\u7F51\u7684\u4E00\u53D1\u3002\u63A2\u9488\u65AD\u7684\u662F**\u6574\u8D9F\u5B9E\u9645\u6253\u51FA\u53BB\u7684\u8DEF\u5F84\u5217\u8868\u9010\u5B57\u76F8\u7B49**\uFF08\u4E0D\u662F\u300C\u542B\u67D0\u4E2A\u8BCD\u300D\uFF09\u2014\u2014\u8DEF\u5F84\u6539\u4E86\u3001\u6216\u8005\u522B\u7684\u683C\u5077\u5077\u591A\u6253\u4E86\u4E00\u53D1\uFF0C\u90FD\u4F1A\u7EA2\u3002"
16172
16220
  }
16173
16221
  ];
16174
16222
  function loadProtocolFacts(entries = PROTOCOL_FACTS, options = {}) {
@@ -16912,6 +16960,7 @@ var CARRIER_KEYS = [
16912
16960
  "json-model",
16913
16961
  "graaljs-spi",
16914
16962
  "flex-data",
16963
+ "indicator-dashboard",
16915
16964
  "data-package"
16916
16965
  ];
16917
16966
  var CARRIER_LABELS = {
@@ -16920,6 +16969,7 @@ var CARRIER_LABELS = {
16920
16969
  "json-model": "JSON Model \u2014\u2014 \u968F\u4EA7\u54C1\u8D70\u7684\u9759\u6001\u7801\u8868\uFF0C\u53EA\u8BFB",
16921
16970
  "graaljs-spi": "GraalJS SPI \u2014\u2014 \u5F00\u53D1\u7A7A\u95F4\u91CC\u7684\u79DF\u6237\u6269\u5C55\u811A\u672C",
16922
16971
  "flex-data": "\u5F39\u6027\u5B57\u6BB5 \u2014\u2014 \u6302\u5728\u65E2\u6709\u6A21\u578B\u4E0A\u7684\u79DF\u6237\u81EA\u5B9A\u4E49\u5B57\u6BB5",
16972
+ "indicator-dashboard": "\u6307\u6807/\u770B\u677F \u2014\u2014 \u6307\u6807\u5E93\u3001\u76EE\u6807\u9608\u503C\u4E0E\u770B\u677F\u5B9A\u4E49\uFF0C\u5206\u6790\u5C42\u7684\u627F\u8F7D\u7269",
16923
16973
  "data-package": "DataPackage \u2014\u2014 \u53EF\u590D\u5236\u7684\u573A\u666F\u6570\u636E\u5305"
16924
16974
  };
16925
16975
  var CARRIER_HIT = "hit";
@@ -16977,6 +17027,7 @@ var UNAVAILABLE_HINT = {
16977
17027
  "flex-model": "\u6CA1\u8BFB\u5230\u6A21\u578B\u6E05\u5355\u4EA7\u7269 \u2014\u2014 \u5148\u8DD1\u4E00\u6B21 recon",
16978
17028
  "json-model": "\u6CA1\u8BFB\u5230\u6A21\u578B\u6E05\u5355\u4EA7\u7269 \u2014\u2014 \u5148\u8DD1\u4E00\u6B21 recon",
16979
17029
  "flex-data": "\u6CA1\u8BFB\u5230\u5B57\u6BB5\u7D22\u5F15\u4EA7\u7269 \u2014\u2014 \u5148\u8DD1\u4E00\u6B21 recon",
17030
+ "indicator-dashboard": "\u6CA1\u8BFB\u5230\u6A21\u578B\u6E05\u5355\u4EA7\u7269 \u2014\u2014 \u5148\u8DD1\u4E00\u6B21 recon",
16980
17031
  "graaljs-spi": "\u5F00\u53D1\u7A7A\u95F4\u6E05\u5355\u6CA1\u53D6\u5230"
16981
17032
  };
16982
17033
  function unavailableCell(carrier, err) {
@@ -17116,6 +17167,26 @@ function probeFlexData(dir) {
17116
17167
  }
17117
17168
  return buildCarrierResult("flex-data", CARRIER_HIT, { evidence: hits.slice(0, 20) });
17118
17169
  }
17170
+ var INDICATOR_DASHBOARD_MODELS = ["AnalyticsIndicator", "DashboardDefinitionModel"];
17171
+ function probeIndicatorDashboard(dir) {
17172
+ let keys;
17173
+ try {
17174
+ keys = modelKeys(readArtifactJson(dir, MODELS_REL));
17175
+ } catch (err) {
17176
+ return unavailableCell("indicator-dashboard", err);
17177
+ }
17178
+ const present = new Set(keys);
17179
+ const missing = INDICATOR_DASHBOARD_MODELS.filter((m) => !present.has(m));
17180
+ if (missing.length > 0) {
17181
+ return buildCarrierResult("indicator-dashboard", CARRIER_MISS, {
17182
+ note: `\u6A21\u578B\u6E05\u5355\u91CC\u6CA1\u6709 ${missing.join("\u3001")} \u2014\u2014 \u4EA7\u54C1\u8FD9\u4E00\u7248\u4E0D\u5E26\u8FD9\u6761\u8DEF\uFF0C\u8981\u7B49\u4EA7\u54C1\u5347\u7EA7\uFF0C\u4E0D\u662F\u914D\u51FA\u6765\u7684`
17183
+ });
17184
+ }
17185
+ return buildCarrierResult("indicator-dashboard", CARRIER_HIT, {
17186
+ evidence: [...INDICATOR_DASHBOARD_MODELS],
17187
+ note: "\u6307\u6807 \u2192 \u76EE\u6807 \u2192 \u770B\u677F \u2192 \u4E3B\u9898\u8FD9\u51E0\u5C42\u600E\u4E48\u843D\uFF0C\u88C5\u777F\u620E\u7684 indicator-library \u6280\u80FD"
17188
+ });
17189
+ }
17119
17190
  function probeDataPackage() {
17120
17191
  return buildCarrierResult("data-package", CARRIER_BLIND, { note: DATA_PACKAGE_BLIND_NOTE });
17121
17192
  }
@@ -17126,6 +17197,7 @@ async function probeAll(client, artifactsDir) {
17126
17197
  "json-model": probeJsonModel(artifactsDir),
17127
17198
  "graaljs-spi": await probeGraaljs(client),
17128
17199
  "flex-data": probeFlexData(artifactsDir),
17200
+ "indicator-dashboard": probeIndicatorDashboard(artifactsDir),
17129
17201
  "data-package": probeDataPackage()
17130
17202
  };
17131
17203
  }
@@ -17135,7 +17207,7 @@ var REQUIRED_SECTIONS = ["request", "cells", "verdict", "evidence"];
17135
17207
  var R1_MISSING_SECTION = "\u7F3A\u300C{}\u300D\u8FD9\u4E00\u6BB5 \u2014\u2014 \u56DB\u6BB5\u7F3A\u4E00\u4E0D\u53EF";
17136
17208
  var R1_EMPTY_CELL = "\u627F\u8F7D\u7269 {} \u90A3\u4E00\u683C\u6CA1\u6709\u7ED3\u8BBA \u2014\u2014 \u7559\u7A7A\u5C31\u662F\u8DF3\u6B65\uFF1B\u67E5\u4E0D\u5230\u8981\u586B\u76F2\u533A\u6216\u300C\u8FD9\u6B21\u6CA1\u53D6\u5230\u300D\uFF0C\u4E0D\u662F\u4E0D\u586B";
17137
17209
  var R2_HITS_UNDER_GAP = "\u5224\u4E86\u4EA7\u54C1\u7F3A\u53E3\uFF0C\u4F46\u8FD9\u51E0\u683C\u662F\u547D\u4E2D\u7684\uFF1A{} \u2014\u2014 \u6709\u8DEF\u8D70\u901A\u8FD8\u5224\u7F3A\u53E3\uFF0C\u7ED3\u8BBA\u548C\u8BC1\u636E\u5728\u6253\u67B6";
17138
- var R3_CONFIG_WITHOUT_HIT = "\u5224\u4E86\u300C\u914D\u7F6E\u80FD\u505A\u300D\uFF0C\u4F46\u516D\u683C\u91CC\u6CA1\u6709\u4EFB\u4F55\u4E00\u683C\u547D\u4E2D \u2014\u2014 \u8BF4\u5F97\u51FA\u914D\u5728\u54EA\uFF0C\u8FD9\u4E2A\u7ED3\u8BBA\u624D\u7ACB\u5F97\u4F4F";
17210
+ var R3_CONFIG_WITHOUT_HIT = "\u5224\u4E86\u300C\u914D\u7F6E\u80FD\u505A\u300D\uFF0C\u4F46\u4E03\u683C\u91CC\u6CA1\u6709\u4EFB\u4F55\u4E00\u683C\u547D\u4E2D \u2014\u2014 \u8BF4\u5F97\u51FA\u914D\u5728\u54EA\uFF0C\u8FD9\u4E2A\u7ED3\u8BBA\u624D\u7ACB\u5F97\u4F4F";
17139
17211
  var R4_BLIND_AS_GAP = "\u5224\u4E86\u4EA7\u54C1\u7F3A\u53E3\uFF0C\u4F46\u8FD9\u51E0\u683C\u662F\u76F2\u533A\uFF1A{} \u2014\u2014 \u76F2\u533A\u662F\u300C\u6CA1\u770B\u89C1\u300D\uFF0C\u4E0D\u662F\u300C\u6CA1\u6709\u300D\u3002\u8981\u5224\u7F3A\u53E3\uFF0C\u5F97\u5148\u663E\u5F0F\u627F\u8BA4\u8FD9\u4E00\u683C\u6CA1\u770B\u89C1\uFF08\u7F6E blindAcknowledged\uFF09\uFF0C\u522B\u628A\u65E0\u77E5\u5199\u6210\u7ED3\u8BBA";
17140
17212
  var GAP = "GAP";
17141
17213
  var CONFIG = "CONFIG";
@@ -17255,8 +17327,8 @@ function renderTriage(entries) {
17255
17327
  const out = [
17256
17328
  "# \u9700\u6C42\u5206\u8BCA",
17257
17329
  "",
17258
- "> \u672C\u6587\u4EF6\u5224\u7684\u662F**\u6709\u6CA1\u6709\u628A\u516D\u6761\u627F\u8F7D\u7269\u8DEF\u5F84\u8D70\u5B8C**\uFF0C\u4E0D\u66FF\u4F60\u5224\u7ED3\u8BBA\u5BF9\u4E0D\u5BF9\u3002",
17259
- "> \u516D\u683C\u91CC\u4EFB\u4F55\u4E00\u683C\u7A7A\u7740\u5C31\u662F\u8DF3\u6B65\uFF1B\u76F2\u533A\u662F\u5408\u6CD5\u7ED3\u679C\uFF0C\u7A7A\u767D\u4E0D\u662F\u3002",
17330
+ "> \u672C\u6587\u4EF6\u5224\u7684\u662F**\u6709\u6CA1\u6709\u628A\u4E03\u6761\u627F\u8F7D\u7269\u8DEF\u5F84\u8D70\u5B8C**\uFF0C\u4E0D\u66FF\u4F60\u5224\u7ED3\u8BBA\u5BF9\u4E0D\u5BF9\u3002",
17331
+ "> \u4E03\u683C\u91CC\u4EFB\u4F55\u4E00\u683C\u7A7A\u7740\u5C31\u662F\u8DF3\u6B65\uFF1B\u76F2\u533A\u662F\u5408\u6CD5\u7ED3\u679C\uFF0C\u7A7A\u767D\u4E0D\u662F\u3002",
17260
17332
  ""
17261
17333
  ];
17262
17334
  entries.forEach((entry, i) => {