@hcmai/sdk 0.4.12 → 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
@@ -5293,17 +5293,17 @@ declare function scan(skillRoot: string, aclass: Partial<Aclass>, facts: readonl
5293
5293
  declare function exitCode(result: Pick<ScanResult, 'premise' | 'red'>): number;
5294
5294
 
5295
5295
  /**
5296
- * 六类承载物的核查结果契约 —— 分诊的**穷举**那一步落在这里。
5296
+ * 七类承载物的核查结果契约 —— 分诊的**穷举**那一步落在这里。
5297
5297
  *
5298
5298
  * 🔴 **本模块判的是「有没有填」,不是「填得对不对」**。顾问看一眼觉得产品做不到就直接
5299
- * 判缺口,是分诊最贵的失误;而「结论对不对」无法机械验证,「六格有没有被填满」可以。
5299
+ * 判缺口,是分诊最贵的失误;而「结论对不对」无法机械验证,「七格有没有被填满」可以。
5300
5300
  * 所以这里只提供一个**填不满就抛**的结构。
5301
5301
  *
5302
5302
  * 🔴 **四档不是三档。** `blind`(盲区)与 `miss`(看了没有)**必须是两个取值**:
5303
5303
  * 前者是「这条路在 HTTP 面上根本看不见」,后者是「看见了、没有」。混成一档,
5304
5304
  * 跳步就能伪装成盲区 —— 那正是本模块要防的东西。
5305
5305
  *
5306
- * ## 六类承载物的可探性
5306
+ * ## 七类承载物的可探性
5307
5307
  *
5308
5308
  * | 承载物 | 判别 | 来源 |
5309
5309
  * |---|---|---|
@@ -5312,6 +5312,7 @@ declare function exitCode(result: Pick<ScanResult, 'premise' | 'red'>): number;
5312
5312
  * | `json-model` | `BaseJsonModel` 派生 —— **只读、不支持增删改** | `mutation-capability`(间接) |
5313
5313
  * | `graaljs-spi` | 开发空间的 `scripts/` | `tenant-extension/workspaces` |
5314
5314
  * | `flex-data` | 字段级 `isFlex` | recon 产物 |
5315
+ * | `indicator-dashboard` | 模型清单里**同时**有指标库与看板定义两个模型 | recon 产物 |
5315
5316
  * | `data-package` | —— | 🔴 **全 `modules/` 无 Controller ⇒ 真盲区** |
5316
5317
  *
5317
5318
  * 🔴 `ModelType` 只有 `DATA` / `MONGO` / `DYNAMIC` / `UNKNOWN` 四个值,**没有独立的
@@ -5321,13 +5322,18 @@ declare function exitCode(result: Pick<ScanResult, 'premise' | 'red'>): number;
5321
5322
  * ⚠️ 上表是**源码推得 · wire 未实测**。它证明的是「本模块怎么判」,不是「产品真的这么答」。
5322
5323
  */
5323
5324
  /**
5324
- * 六格。
5325
+ * 七格。
5325
5326
  *
5326
5327
  * 🔴 顺序固定且**是契约的一部分**:产出的核查表按这个顺序渲染,顾问逐格看下去的路径是
5327
- * 稳定的。加第七类必须同时改 `CARRIER_LABELS` 与渲染层 —— 由类型接住:
5328
+ * 稳定的。加第八类必须同时改 `CARRIER_LABELS` 与渲染层 —— 由类型接住:
5328
5329
  * `CARRIER_LABELS` 声明成 `Record<CarrierKey, string>`,漏一格当场编译不过。
5330
+ *
5331
+ * 🔴 `indicator-dashboard` 是 2026-09-01 加的第七格,排在 `data-package` 之前:
5332
+ * 盲区那一格留在最后,顾问读到表尾时看见的仍是「有一条路我没看见」。
5333
+ * 加它的成因是一次真实交付(队伍建设驾驶舱):产物四层里指标 / 目标 / 看板三层
5334
+ * 都不在原来六格的任何一格里,分诊只会告诉顾问「数据放哪」,不会告诉他交付主体在哪。
5329
5335
  */
5330
- 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"];
5331
5337
  type CarrierKey = (typeof CARRIER_KEYS)[number];
5332
5338
  /** 🔴 只写**承载物是什么**(协议事实),不写某个环境里有哪些(A 类环境事实)。 */
5333
5339
  declare const CARRIER_LABELS: Record<CarrierKey, string>;
@@ -5377,7 +5383,7 @@ declare const DATA_PACKAGE_BLIND_NOTE: string;
5377
5383
  */
5378
5384
  declare function isReadOnly(mapping: unknown): boolean;
5379
5385
  /**
5380
- * 六格全填 —— 每一格都有 verdict,**没有空格**。
5386
+ * 七格全填 —— 每一格都有 verdict,**没有空格**。
5381
5387
  *
5382
5388
  * 🔴 返回类型是 `Record<CarrierKey, CarrierResult>`:漏填一格当场编译不过,
5383
5389
  * 这比一条运行时断言更早。
@@ -5417,9 +5423,9 @@ declare function checkCoherence(entry: TriageEntry): TriageProblem[];
5417
5423
  * 结论取值域。
5418
5424
  *
5419
5425
  * - `REUSE` = 已有现成的,直接用
5420
- * - `CONFIG` = 配置能做(六格里有命中)
5426
+ * - `CONFIG` = 配置能做(七格里有命中)
5421
5427
  * - `EXTEND` = 要走二开(弹性模型 / 脚本 / 元数据)
5422
- * - `GAP` = 六条路都走不通,回产品立案
5428
+ * - `GAP` = 七条路都走不通,回产品立案
5423
5429
  */
5424
5430
  declare const VERDICTS: readonly ["REUSE", "CONFIG", "EXTEND", "GAP"];
5425
5431
  type TriageVerdict = (typeof VERDICTS)[number];
@@ -5435,7 +5441,7 @@ declare const DEBT_UNKNOWN = "\uFF08\u8FD8\u8BF4\u4E0D\u51FA\u7F3A\u54EA\u4E2A A
5435
5441
  declare function renderTriage(entries: readonly TriageEntry[]): string;
5436
5442
 
5437
5443
  /**
5438
- * 一趟分诊的编排 —— 探六格、判自洽、落盘。
5444
+ * 一趟分诊的编排 —— 探七格、判自洽、落盘。
5439
5445
  *
5440
5446
  * 🔴 **为什么这一层在 core 而不是在命令里**:命令层多一处判断就会与这里的那份漂移,
5441
5447
  * 而顾问看到的是命令层那一份。与 `runRecon(probe, layout, …)` 同一条形状:
package/dist/index.js CHANGED
@@ -16216,7 +16216,7 @@ var PROTOCOL_FACTS = [
16216
16216
  {
16217
16217
  token: "/api/tenant-extension/workspaces",
16218
16218
  probe: "packages/core/tests/fde-triage-probe.test.ts::workspaces-path-wire-shape",
16219
- 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"
16220
16220
  }
16221
16221
  ];
16222
16222
  function loadProtocolFacts(entries = PROTOCOL_FACTS, options = {}) {
@@ -16960,6 +16960,7 @@ var CARRIER_KEYS = [
16960
16960
  "json-model",
16961
16961
  "graaljs-spi",
16962
16962
  "flex-data",
16963
+ "indicator-dashboard",
16963
16964
  "data-package"
16964
16965
  ];
16965
16966
  var CARRIER_LABELS = {
@@ -16968,6 +16969,7 @@ var CARRIER_LABELS = {
16968
16969
  "json-model": "JSON Model \u2014\u2014 \u968F\u4EA7\u54C1\u8D70\u7684\u9759\u6001\u7801\u8868\uFF0C\u53EA\u8BFB",
16969
16970
  "graaljs-spi": "GraalJS SPI \u2014\u2014 \u5F00\u53D1\u7A7A\u95F4\u91CC\u7684\u79DF\u6237\u6269\u5C55\u811A\u672C",
16970
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",
16971
16973
  "data-package": "DataPackage \u2014\u2014 \u53EF\u590D\u5236\u7684\u573A\u666F\u6570\u636E\u5305"
16972
16974
  };
16973
16975
  var CARRIER_HIT = "hit";
@@ -17025,6 +17027,7 @@ var UNAVAILABLE_HINT = {
17025
17027
  "flex-model": "\u6CA1\u8BFB\u5230\u6A21\u578B\u6E05\u5355\u4EA7\u7269 \u2014\u2014 \u5148\u8DD1\u4E00\u6B21 recon",
17026
17028
  "json-model": "\u6CA1\u8BFB\u5230\u6A21\u578B\u6E05\u5355\u4EA7\u7269 \u2014\u2014 \u5148\u8DD1\u4E00\u6B21 recon",
17027
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",
17028
17031
  "graaljs-spi": "\u5F00\u53D1\u7A7A\u95F4\u6E05\u5355\u6CA1\u53D6\u5230"
17029
17032
  };
17030
17033
  function unavailableCell(carrier, err) {
@@ -17164,6 +17167,26 @@ function probeFlexData(dir) {
17164
17167
  }
17165
17168
  return buildCarrierResult("flex-data", CARRIER_HIT, { evidence: hits.slice(0, 20) });
17166
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
+ }
17167
17190
  function probeDataPackage() {
17168
17191
  return buildCarrierResult("data-package", CARRIER_BLIND, { note: DATA_PACKAGE_BLIND_NOTE });
17169
17192
  }
@@ -17174,6 +17197,7 @@ async function probeAll(client, artifactsDir) {
17174
17197
  "json-model": probeJsonModel(artifactsDir),
17175
17198
  "graaljs-spi": await probeGraaljs(client),
17176
17199
  "flex-data": probeFlexData(artifactsDir),
17200
+ "indicator-dashboard": probeIndicatorDashboard(artifactsDir),
17177
17201
  "data-package": probeDataPackage()
17178
17202
  };
17179
17203
  }
@@ -17183,7 +17207,7 @@ var REQUIRED_SECTIONS = ["request", "cells", "verdict", "evidence"];
17183
17207
  var R1_MISSING_SECTION = "\u7F3A\u300C{}\u300D\u8FD9\u4E00\u6BB5 \u2014\u2014 \u56DB\u6BB5\u7F3A\u4E00\u4E0D\u53EF";
17184
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";
17185
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";
17186
- 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";
17187
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";
17188
17212
  var GAP = "GAP";
17189
17213
  var CONFIG = "CONFIG";
@@ -17303,8 +17327,8 @@ function renderTriage(entries) {
17303
17327
  const out = [
17304
17328
  "# \u9700\u6C42\u5206\u8BCA",
17305
17329
  "",
17306
- "> \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",
17307
- "> \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",
17308
17332
  ""
17309
17333
  ];
17310
17334
  entries.forEach((entry, i) => {