@finebi/finebi-cli 1.4.0 → 1.5.0

package/skills/finebi-cli-agent/references/widget-dsl-api.md

@@ -145,8 +145,12 @@ windowCalculation(
 
 `windowCalculation(measure, configuration)` 是全局函数；`WindowCalculationModel` 是窗口配置命名空间。
 仅标准分析主题可使用移动计算；自助分析主题会在保存前报错，此限制同样适用于记录数和隐藏通道。
-上述例子计算前一行与当前行的合计。计算作用于组件聚合后的结果行；窗口顺序取决于组件排序，
-按日期移动时应使用日期维度并核对排序与出数。原指标可另放一列，逐行核对窗口计算值。
+组件形态需与设计器可达面一致，否则报错：组件至少要有一个维度；`calculateType` 组内要求
+表格某一轴（行/列）或图表多于一个维度；图表方向只能是 `0`（向下，设计器仅提供「默认」）；
+表格方向按行/列区维度开放——`1` 向右需要列维度，`2`/`3` 组合方向要求行、列维度都有，
+且至少要有一个维度。上述例子计算前一行与当前行的合计。计算作用于组件聚合后的结果行；
+窗口顺序取决于组件排序，按日期移动时应使用日期维度并核对排序与出数。
+原指标可另放一列，逐行核对窗口计算值。
 
 | `WindowCalculationModel.of` 参数 | 可用值 |
 |---|---|
@@ -179,6 +183,7 @@ windowCalculation(
 | `from("来源表").dim("字段名", grouping, "别名")` | 同时指定分组和展示名。 |
 | `measureID("配置 ID").dim()` | 已保存计算字段使用默认分组。 |
 | `measureID("配置 ID").dim(grouping)` | 已保存计算字段使用与字段类型兼容的显式分组；不支持别名。 |
+| `....hidden()` | 关闭展示字段：维度仍绑定进轴、保留槽位，查看态不展示（`used=false`）；可叠加在上述任意维度形态之后，与分组/别名/经纬度组合。 |
 
 分组使用以下稳定语法：
 
@@ -211,6 +216,14 @@ DimensionGrouping.textGroups([
 孤立载荷、默认文本 ID_GROUP / 默认日期 YMD 维度旁的 stray customGroup）会作为 warning 返回；
 `cal[*]` 嵌套 customGroup 始终 warning。
 
+`.hidden()` 对应设计器"展示字段"开关，回读保留（输出为维度表达式末尾的 `.hidden()` 后缀）。
+仅视图轴绑定的维度生效：filter 字段、钻取层级、迷你图依赖、KPI 通道等非展示面引用带
+`.hidden()` 会报错或无效果（KPI 通道维度明确拒绝）。同一字段在同一组件内多处引用须保持
+一致 hidden 状态，否则保存报错——明细表例外：同字段多列按列独立生效，可一列隐藏一列展示；
+分类轴（`categoryAxis`）目标引用须重复携带一致的 `.hidden()` 后缀才能命中轴上维度。
+指标名维度（`metricNameInRow/InCol` 与自动指标名）不支持隐藏，设计器侧关闭时回读会以
+warning 留痕。
+
 ### 2.2 聚合指标
 
 | DSL API                                    | 业务含义                                  |
@@ -739,17 +752,29 @@ WidgetDsl.create("订单明细").chart().detailTable()
 | pageColumns(n) | 交叉表每页 1–1000 列，默认 7 |
 | sequence(boolean) | 显示序号，默认关闭 |
 | rowInfo(boolean) | 明细表显示行数信息，默认开启 |
-| totalRows(boolean) / totalPages(boolean) | 显示总行数/总页数，支持显式关闭；省略则继承平台查看态规则；不是合计行 |
+| totalRows(boolean) / totalPages(boolean) | 显示总行数/总页数，支持显式关闭；省略则继承平台查看态规则；不是合计行；仅标准分析主题可声明，显式 true 时对应行/列展开须为 DISABLED |
 | rowExpansion(TableExpansion.DISABLED / COLLAPSED / EXPANDED) | 分组/交叉表禁止展开收起交互（全部展开）/允许交互且初始收起/允许交互且初始展开 |
 | columnExpansion(TableExpansion.DISABLED / COLLAPSED / EXPANDED) | 交叉表列维度展开规则，同上 |
 | freezeDimensions(boolean) | 分组/交叉表冻结维度，默认开启 |
 | frozenColumns(n) | 明细表冻结前 1–10 列；0 关闭冻结，默认 1 |
 
 未声明展开配置时使用 DSL 默认的可交互、初始收起；迷你图固定禁止行展开交互。
-总行数/总页数配置入口属于 7.0.13+ 标准分析主题，建议同时关闭行/列展开交互；
+总行数/总页数配置入口属于 7.0.13+ 标准分析主题：自助分析主题下显式声明这两个开关中任一
+会报错（设计器不显示该开关组）；标准分析主题下显式 true 要求对应行/列展开为
+`TableExpansion.DISABLED`（交叉表行/列按钮任一开启即报错），显式 false 与省略等价始终放行。
 这两个布尔值省略时保留继承，显式 false 会关闭显示。宽度适应时前端不执行冻结。
 重复 tableFormat 以最后整组为准，空 Builder 恢复默认；不适用的表格专属选项直接报错。
 
+**新建默认与设计器系统参数**：CLI 新建组件固定展开收起可交互、初始收起与总合计开启；标准分析
+主题下设计器**新建**表格会按系统参数 `standardAnalysisSupportExpandCollapse` /
+`standardAnalysisSelectGrandTotal`（默认均为 false）改写为「隐藏展开按钮、关闭总合计」。需要与
+设计器新建同款默认形态时显式声明：`.tableFormat(...rowExpansion(TableExpansion.DISABLED)
+.totalRows(false).totalPages(false)...)`（交叉表另加 `.columnExpansion(TableExpansion.DISABLED)`），
+并加 `.totalRows(TableTotal.rows().grand(false).build())`（交叉表列合计用
+`.totalColumns(TableTotal.columns().grand(false).build())`）；这些值都不是省略默认，回读与重放稳定。
+配方适用于分组表/交叉表；明细表不适用 `rowExpansion` 与合计配置，只需 `.tableFormat(...)`
+声明 `totalRows(false)` 与 `totalPages(false)`。
+
 ```javascript
 WidgetDsl.create("交叉表格式").chart().crossTable()
   .row(from("订单表").dim("地区"))
@@ -1280,6 +1305,13 @@ currentTime 在查询时取当前时钟，time 为固定整秒时刻；`.time(""
 | THIRD | 聚合计算过滤 | 聚合计算过滤 |
 | FOURTH | 快速计算过滤 | 快速计算过滤 |
 
+未声明 `.level(...)` 时按设计器面板的默认落值写入（两主题不同）：
+维度自身过滤与未聚合指标过滤在标准主题恒第二层、自助主题第一层（top/bottom N 时第二层）；
+聚合指标过滤第三层、top/bottom N 时第四层；公式过滤引用指标时第二层、否则第一层。
+**明细表**过滤走独立编辑器，默认标准主题 22（固定明细档）、非标准主题第一层。已知差异
+（前端有、本实现暂未镜像，可用显式 `.level(...)` 覆盖）：自助主题「数值维度/维度依赖聚合指标」
+项前端固定第二层、本实现落第一层。带快速计算的聚合指标过滤前端默认第四层、标准化路径
+不可声明（`.filter()` 的字段不接受携带快速计算）。
 普通维度进入分析区且依赖分组时可调整到四层；不在分析区时仅支持 FIRST/SECOND。
 自助主题的 DEF/WINDOW/FIXED 维度进入分析区后只允许 SECOND，维度依赖指标过滤允许 SECOND/THIRD/FOURTH。
 标准主题的聚合输出维度和分析区内依赖指标过滤仅允许 SECOND；新增列维度仅允许 FIRST/SECOND。
@@ -1314,18 +1346,24 @@ DSL 回读保留分类绑定、色板和映射，自动主题色不输出显式
 
 ```js
 NumberFormatModel.auto()
+NumberFormatModel.auto(2, NumberFormatModelScale.THOUSAND, null, true)
 NumberFormatModel.number(2)
-NumberFormatModel.number(2, NumberFormatModelScale.TEN_THOUSAND, "万元", true)
+NumberFormatModel.number(2, NumberFormatModelScale.TEN_THOUSAND, "元", true)
 NumberFormatModel.percentage(1, true)
 ```
 
 | DSL API                                                             | 业务含义               |
 |---------------------------------------------------------------------|--------------------|
 | `NumberFormatModel.auto()`                                          | 使用平台自动格式。          |
+| `NumberFormatModel.auto(decimalPlaces, scale, unit, useGrouping)` | 自动精度并保留缩放、单位和千分位配置；decimalPlaces 可为 null，保存面板值但不强制固定小数位。 |
 | `NumberFormatModel.number(decimalPlaces)`                           | 普通数值格式。            |
 | `NumberFormatModel.number(decimalPlaces, scale, unit, useGrouping)` | 带缩放、单位和千分位控制的数值格式。 |
 | `NumberFormatModel.percentage(decimalPlaces, useGrouping)`          | 百分比格式。             |
 
+`scale` 同时决定缩放与数量级单位，`unit` 是追加的单位文本。例如 `TEN_THOUSAND` + `"元"`
+显示“万元”；只显示“万”时使用 `null`，不要重复填写 `"万"`。`number(2, ...)` 固定两位小数；
+带参数的 `auto(...)` 保留自动精度。只有完全默认的 `auto()` 在回读时归一为未设置。
+
 ## 9. 可用枚举
 
 | 枚举                       | 可用值                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

package/skills/finebi-cli-agent/scripts/finebi-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finebi/finebi-cli",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "private": true,
   "description": "FineBI dynamic capability command line client.",
   "license": "UNLICENSED",

package/skills/finebi-cli-agent/scripts/finebi-cli/src/config.js

@@ -56,23 +56,23 @@ export function writeConfigAtomically(path, config, options = {}) {
   }
 }
 
-export function resolveConfig(flags = {}, env = process.env, fileConfig = readConfig()) {
-  const baseUrl = firstNonEmpty(flags.baseUrl, env.FINEBI_BASE_URL, fileConfig.baseUrl);
-  const sameServer = sameBaseUrl(baseUrl, fileConfig.baseUrl);
-  const explicitToken = firstNonEmpty(flags.token, env.FINEBI_AUTH_TOKEN);
-  const savedAuth = sameServer ? fileConfig.auth : undefined;
-  const token = firstNonEmpty(explicitToken, savedAuth?.token, sameServer ? fileConfig.token : undefined);
+export function resolveConfig(flags = {}, env = process.env, fileConfig = readConfig()) {
+  const baseUrl = firstNonEmpty(flags.baseUrl, env.FINEBI_BASE_URL, fileConfig.baseUrl);
+  const sameServer = sameBaseUrl(baseUrl, fileConfig.baseUrl);
+  const explicitToken = firstNonEmpty(flags.token, env.FINEBI_AUTH_TOKEN);
+  const savedAuth = sameServer ? fileConfig.auth : undefined;
+  const token = firstNonEmpty(explicitToken, savedAuth?.token, sameServer ? fileConfig.token : undefined);
   return normalizeConfig({
     ...fileConfig,
-    baseUrl,
+    baseUrl,
     timeoutMs: parsePositiveInt(firstNonEmpty(flags.timeoutMs, env.FINEBI_TIMEOUT_MS), fileConfig.timeoutMs),
     capabilityTtlMs: parsePositiveInt(
       firstNonEmpty(flags.capabilityTtlMs, env.FINEBI_CAPABILITY_TTL_MS),
       fileConfig.capabilityTtlMs,
     ),
     auth: {
-      ...(explicitToken ? {} : savedAuth),
-      token,
+      ...(explicitToken ? {} : savedAuth),
+      token,
     },
   });
 }
@@ -81,10 +81,10 @@ export function updateConfigValue(config, key, value, now = () => new Date().toI
   const next = normalizeConfig(config);
   switch (key) {
     case "base-url":
-      if (next.baseUrl !== value) {
-        next.capabilityCacheInvalidatedAt = now();
-        delete next.auth;
-        delete next.token;
+      if (next.baseUrl !== value) {
+        next.capabilityCacheInvalidatedAt = now();
+        delete next.auth;
+        delete next.token;
       }
       next.baseUrl = value;
       return next;
@@ -128,7 +128,7 @@ function defaultConfig() {
   };
 }
 
-export function normalizeConfig(config) {
+export function normalizeConfig(config) {
   return {
     ...config,
     timeoutMs: parsePositiveInt(config.timeoutMs, DEFAULT_TIMEOUT_MS),
@@ -136,14 +136,14 @@ export function normalizeConfig(config) {
   };
 }
 
-function sanitizeConfig(config) {
-  if (config.schemaVersion === 2) {
-    return {
-      schemaVersion: 2,
-      currentProfile: config.currentProfile,
-      profiles: Object.fromEntries(Object.entries(config.profiles).map(([name, profile]) => [name, sanitizeConfig(normalizeConfig(profile))])),
-    };
-  }
+function sanitizeConfig(config) {
+  if (config.schemaVersion === 2) {
+    return {
+      schemaVersion: 2,
+      currentProfile: config.currentProfile,
+      profiles: Object.fromEntries(Object.entries(config.profiles).map(([name, profile]) => [name, sanitizeConfig(normalizeConfig(profile))])),
+    };
+  }
   const { token: _legacyToken, ...rest } = config;
   const auth = config.auth
     ? {
@@ -166,11 +166,11 @@ function sanitizeConfig(config) {
     ...rest,
     auth,
   };
-}
-
-export function sameBaseUrl(left, right) {
-  return (left || "").replace(/\/+$/, "") === (right || "").replace(/\/+$/, "");
-}
+}
+
+export function sameBaseUrl(left, right) {
+  return (left || "").replace(/\/+$/, "") === (right || "").replace(/\/+$/, "");
+}
 
 function firstNonEmpty(...values) {
   return values.find((value) => typeof value === "string" && value.trim().length > 0)?.trim();

package/skills/finebi-cli-agent/scripts/finebi-cli/src/help.js

@@ -1,12 +1,12 @@
 import {brandCommandValue, CLI_COMMAND_NAME, CLI_DISPLAY_NAME, commandLine} from "./branding.js";
 import {cliError} from "./errors.js";
-import {failure, success} from "./output.js";
-
-const GLOBAL_OPTIONS = [
-  {name: "--profile", type: "string", description: "Environment name. Overrides FINEBI_PROFILE and the saved default; ordinary commands do not create environments or switch the default."},
-  {name: "--base-url", type: "string", description: "Connection URL override. A different server never inherits saved credentials or capabilities."},
-  {name: "--token", type: "string", description: "Temporary session token override; not persisted."},
-];
+import {failure, success} from "./output.js";
+
+const GLOBAL_OPTIONS = [
+  {name: "--profile", type: "string", description: "Environment name. Overrides FINEBI_PROFILE and the saved default; ordinary commands do not create environments or switch the default."},
+  {name: "--base-url", type: "string", description: "Connection URL override. A different server never inherits saved credentials or capabilities."},
+  {name: "--token", type: "string", description: "Temporary session token override; not persisted."},
+];
 
 export function renderTopLevelHelp(manifest) {
   return success("help", {
@@ -14,8 +14,8 @@ export function renderTopLevelHelp(manifest) {
       name: resource.name,
       summary: resource.summary,
     })),
-    dynamicCapabilitiesLoaded: Boolean(manifest),
-    globalOptions: GLOBAL_OPTIONS,
+    dynamicCapabilitiesLoaded: Boolean(manifest),
+    globalOptions: GLOBAL_OPTIONS,
   }, { schemaVersion: manifest?.schemaVersion });
 }
 
@@ -24,7 +24,7 @@ export function renderBuiltInHelp(resourceName) {
   if (!resource) {
     return capabilityNotFound(resourceName);
   }
-    return success("help", brandCommandValue({...resource, globalOptions: GLOBAL_OPTIONS}));
+    return success("help", brandCommandValue({...resource, globalOptions: GLOBAL_OPTIONS}));
 }
 
 export function renderBuiltInCommandHelp(resourceName, commandName) {
@@ -38,8 +38,8 @@ export function renderBuiltInCommandHelp(resourceName, commandName) {
     command: command.name,
     summary: command.summary,
     usage: command.usage,
-    options: command.options || [],
-    globalOptions: GLOBAL_OPTIONS,
+    options: command.options || [],
+    globalOptions: GLOBAL_OPTIONS,
     details: command.details || [],
     examples: command.examples || [],
     }));
@@ -52,8 +52,8 @@ export function renderResourceHelp(manifest, resourceName) {
   }
   return success("help", {
     resource: resource.name,
-    summary: resource.summary,
-    globalOptions: GLOBAL_OPTIONS,
+    summary: resource.summary,
+    globalOptions: GLOBAL_OPTIONS,
     commands: (resource.commands || []).map((command) => ({
       name: command.name,
       summary: command.summary,
@@ -72,8 +72,8 @@ export function renderCommandHelp(manifest, resourceName, commandName) {
     command: command.name,
     summary: command.summary,
     usage: usageFor(resource.name, command),
-    options: commandOptionsFor(command),
-    globalOptions: GLOBAL_OPTIONS,
+    options: commandOptionsFor(command),
+    globalOptions: GLOBAL_OPTIONS,
     display: command.display,
     requestSchema: command.requestSchema,
     responseSchema: command.responseSchema,
@@ -152,7 +152,7 @@ const BUILT_IN_RESOURCES = {
       },
       {
         name: "clear",
-        summary: "Remove the selected environment's local configuration, credentials and capability cache; does not revoke server keys.",
+        summary: "Remove the selected environment's local configuration, credentials and capability cache; does not revoke server keys.",
         usage: "finebi-cli config clear",
       },
     ],
@@ -164,18 +164,18 @@ const BUILT_IN_RESOURCES = {
       {
         name: "login",
         summary: "Login with FineBI credentials or browser authorization and persist an Access Key.",
-        usage: "finebi-cli auth login [--profile <name>] [--base-url <url>] [--browser] [--username <username>] [--from-env] [--password-stdin] [--no-use]",
-        options: [
-          { name: "--no-use", type: "boolean", description: "Save successful login without changing the default environment." },
+        usage: "finebi-cli auth login [--profile <name>] [--base-url <url>] [--browser] [--username <username>] [--from-env] [--password-stdin] [--no-use]",
+        options: [
+          { name: "--no-use", type: "boolean", description: "Save successful login without changing the default environment." },
           { name: "--username", type: "string", description: "FineBI username." },
           { name: "--from-env", type: "boolean", description: "Read base URL, username, and password from environment variables." },
           { name: "--password-stdin", type: "boolean", description: "Read password from standard input." },
           { name: "--browser", type: "boolean", description: "Authorize this CLI from a signed-in FineBI browser without sending a password." },
         ],
-        details: [
-          "Login creates the named environment if missing and selects it after successful authentication, unless --no-use is supplied.",
-          "A new environment requires --base-url or FINEBI_BASE_URL; it never inherits another environment's address or identity.",
-          "Failed authentication preserves saved environments and the default selection.",
+        details: [
+          "Login creates the named environment if missing and selects it after successful authentication, unless --no-use is supplied.",
+          "A new environment requires --base-url or FINEBI_BASE_URL; it never inherits another environment's address or identity.",
+          "Failed authentication preserves saved environments and the default selection.",
           "Environment variables for --from-env:",
           "  FINEBI_BASE_URL",
           "  FINEBI_USERNAME",
@@ -187,28 +187,28 @@ const BUILT_IN_RESOURCES = {
           "finebi-cli auth login --username <username>",
           "finebi-cli auth login --from-env",
           "echo <password> | finebi-cli auth login --username <username> --password-stdin",
-          "finebi-cli auth login --browser",
-          "finebi-cli auth login --profile test --base-url https://test.example.com/webroot/decision --browser",
+          "finebi-cli auth login --browser",
+          "finebi-cli auth login --profile test --base-url https://test.example.com/webroot/decision --browser",
         ],
       },
-      {
-        name: "list",
-        summary: "List saved environments and mark the default; local metadata only, no credential validation or secret output.",
-        usage: "finebi-cli auth list",
-      },
-      {
-        name: "use",
-        summary: "Select an existing environment as default without logging in.",
-        usage: "finebi-cli auth use <name>",
-      },
-      {
-        name: "remove",
-        summary: "Delete one local environment and its capability cache; does not revoke server keys.",
-        usage: "finebi-cli auth remove <name>",
-        details: ["Use auth logout --profile <name> first to revoke its Access Key.", "Removing the default environment does not select another environment."],
-      },
-      {
-        name: "info",
+      {
+        name: "list",
+        summary: "List saved environments and mark the default; local metadata only, no credential validation or secret output.",
+        usage: "finebi-cli auth list",
+      },
+      {
+        name: "use",
+        summary: "Select an existing environment as default without logging in.",
+        usage: "finebi-cli auth use <name>",
+      },
+      {
+        name: "remove",
+        summary: "Delete one local environment and its capability cache; does not revoke server keys.",
+        usage: "finebi-cli auth remove <name>",
+        details: ["Use auth logout --profile <name> first to revoke its Access Key.", "Removing the default environment does not select another environment."],
+      },
+      {
+        name: "info",
         summary: "Show stored authentication metadata with secrets masked.",
         usage: "finebi-cli auth info",
       },
@@ -288,7 +288,7 @@ function commandOptionsFor(command) {
 
 function optionsFor(schema) {
   const required = schema.required || [];
-  return Object.keys(schema.properties || {}).filter((fieldName) => schema.properties[fieldName].input !== "argument").map((fieldName) => {
+  return Object.keys(schema.properties || {}).filter((fieldName) => schema.properties[fieldName].input !== "argument").flatMap((fieldName) => {
     const property = schema.properties[fieldName];
     const optionName = optionNameFor(fieldName, property);
     const option = {
@@ -305,7 +305,15 @@ function optionsFor(schema) {
     if (defaultValue !== undefined && defaultValue !== "") {
       option.default = defaultValue;
     }
-    return option;
+    if (property.keyValueOption) {
+      return [option, {
+        name: `--${property.keyValueOption}`,
+        required: false,
+        type: "name=value",
+        description: `Repeatable; maps each name to a one-element string array; mutually exclusive with --${optionName}. Split at the first =; empty names/values and duplicate names are rejected.`,
+      }];
+    }
+    return [option];
   });
 }
 
@@ -368,10 +376,10 @@ function renderTopLevelHelpText(data) {
     "",
     "Use --help or -h for command details.",
     "Use --json with --help for structured output.",
-    "Output options: --select <paths> / --max-chars <n> / --save <path> for large responses.",
-    "Environment: --profile <name> > FINEBI_PROFILE > saved default. Global options may precede or follow the command.",
-  );
-  lines.push("", "Global Options:", ...formatOptionRows(data.globalOptions || []));
+    "Output options: --select <paths> / --max-chars <n> / --save <path> for large responses.",
+    "Environment: --profile <name> > FINEBI_PROFILE > saved default. Global options may precede or follow the command.",
+  );
+  lines.push("", "Global Options:", ...formatOptionRows(data.globalOptions || []));
   return `${lines.join("\n")}\n`;
 }
 
@@ -387,8 +395,8 @@ function renderResourceHelpText(data) {
     "",
     "Commands:",
   ];
-  lines.push(...formatRows(data.commands || [], "name", "summary"));
-  lines.push("", "Global Options:", ...formatOptionRows(data.globalOptions || []));
+  lines.push(...formatRows(data.commands || [], "name", "summary"));
+  lines.push("", "Global Options:", ...formatOptionRows(data.globalOptions || []));
     lines.push("", `Use ${commandLine(data.resource, "<command>", "--help")} for command details.`);
   return `${lines.join("\n")}\n`;
 }
@@ -403,13 +411,13 @@ function renderCommandHelpText(data) {
     "Usage:",
     `  ${data.usage}`,
   ];
-  if ((data.options || []).length > 0) {
+  if ((data.options || []).length > 0) {
     lines.push("", "Options:");
     lines.push(...formatOptionRows(data.options));
-  }
-  if ((data.globalOptions || []).length > 0) {
-    lines.push("", "Global Options:", ...formatOptionRows(data.globalOptions));
-  }
+  }
+  if ((data.globalOptions || []).length > 0) {
+    lines.push("", "Global Options:", ...formatOptionRows(data.globalOptions));
+  }
   if ((data.details || []).length > 0) {
     lines.push("", ...data.details);
   }

package/skills/finebi-cli-agent/scripts/finebi-cli/src/install-skill.js

@@ -1,89 +1,89 @@
-import {mkdir, readFile, writeFile, rename, open, unlink} from "node:fs/promises";
-import {existsSync} from "node:fs";
-import {homedir} from "node:os";
-import {join, resolve} from "node:path";
-import {fileURLToPath} from "node:url";
-import {createInterface} from "node:readline/promises";
-import {agentCatalog, installSkills} from "./skill-files.js";
-import {cliError} from "./errors.js";
-import {failure, success} from "./output.js";
-
-function parseOptions(args) {
-  const options = {};
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === "--json") continue;
-    if (arg === "--list") options.list = true;
-    else if (arg === "--replace") options.replace = true;
-    else if (arg === "--agents") {
-      if (!args[i + 1] || args[i + 1].startsWith("--")) throw new Error("--agents requires comma-separated Agent IDs.");
-      options.agents = [...new Set(args[++i].split(",").map(id => id.trim()).filter(Boolean))];
-      if (!options.agents.length) throw new Error("--agents requires at least one Agent ID.");
-    } else throw new Error(`Unknown install-skill option: ${arg}`);
-  }
-  if (options.list && (options.agents || options.replace)) throw new Error("--list cannot be combined with installation options.");
-  return options;
-}
-
-export async function handleInstallSkill(args, context = {}) {
-  const env = context.env || process.env;
-  const home = resolve(env.USERPROFILE || env.HOME || homedir());
-  const catalog = agentCatalog({home, env});
-  let options;
-  try {
-    options = parseOptions(args);
-    if (options.list) return success("install-skill", {agents: catalog});
-    if (!options.agents) {
-      const interactive = context.isTTY ?? (process.stdin.isTTY && process.stderr.isTTY);
-      if (!interactive) throw new Error("Specify --agents <ids>; use --list to see supported Agents.");
-      const prompt = createInterface({input: process.stdin, output: process.stderr});
-      try {
-        process.stderr.write(catalog.map(a => `${a.id}: ${a.name}${a.detected ? " (detected)" : ""}`).join("\n") + "\n");
-        const answer = await prompt.question("Select Agent IDs (comma-separated): ");
-        options.agents = parseOptions(["--agents", answer]).agents;
-      } finally { prompt.close(); }
-    }
-    for (const id of options.agents) if (!catalog.some(agent => agent.id === id)) throw new Error(`Unknown Agent: ${id}`);
-  } catch (error) {
-    return failure("install-skill", cliError("INVALID_ARGUMENT", {
-      message: error.message, nextActions: ["finebi-cli install-skill --help"],
-    }));
-  }
-
-  const directory = join(home, ".finebi-cli");
-  const statePath = join(directory, "installation.json");
-  const lockPath = join(directory, "skill-install.lock");
-  let lock;
-  try {
-    const source = context.skillSource || [
-      "../skills/finebi-cli-agent/", "../../skills/finebi-cli-agent/", "../../../",
-    ].map(path => fileURLToPath(new URL(path, import.meta.url)))
-      .find(path => existsSync(join(path, "SKILL.md")) && existsSync(join(path, "scripts/finebi-cli/src/index.js")));
-    if (!source) throw new Error("FineBI Skill resources were not found. Reinstall the CLI package or build the Skill in the source checkout.");
-    await readFile(join(source, "SKILL.md"));
-    await readFile(join(source, "scripts/finebi-cli/src/index.js"));
-    await mkdir(directory, {recursive: true});
-    try { lock = await open(lockPath, "wx"); }
-    catch (error) { if (error.code === "EEXIST") throw new Error(`Skill installation lock exists: ${lockPath}`); throw error; }
-    let state = {};
-    try { state = JSON.parse(await readFile(statePath, "utf8")); }
-    catch (error) { if (error.code !== "ENOENT") throw error; }
-    const results = await installSkills({source, home, env, agents: options.agents, replace: options.replace, previous: state.skills || []});
-    const skills = new Map((state.skills || []).map(skill => [skill.agent, skill]));
-    for (const skill of results) skills.set(skill.agent, {...skills.get(skill.agent), ...skill});
-    const stagedState = join(directory, "installation.json.stage");
-    await writeFile(stagedState, `${JSON.stringify({...state, skills: [...skills.values()], updatedAt: new Date().toISOString()}, null, 2)}\n`);
-    await rename(stagedState, statePath);
-    const data = {skills: results.map(({hashes, ...skill}) => skill)};
-    if (results.some(skill => !["installed", "unchanged"].includes(skill.status))) {
-      return failure("install-skill", cliError("SKILL_INSTALL_FAILED", {
-        message: "Some Skills were kept or failed. Review the results; --replace backs up and replaces local changes.", partialResult: data,
-      }));
-    }
-    return success("install-skill", data);
-  } catch (error) {
-    return failure("install-skill", cliError("SKILL_INSTALL_FAILED", {message: error.message}));
-  } finally {
-    if (lock) { await lock.close(); await unlink(lockPath); }
-  }
-}
+import {mkdir, readFile, writeFile, rename, open, unlink} from "node:fs/promises";
+import {existsSync} from "node:fs";
+import {homedir} from "node:os";
+import {join, resolve} from "node:path";
+import {fileURLToPath} from "node:url";
+import {createInterface} from "node:readline/promises";
+import {agentCatalog, installSkills} from "./skill-files.js";
+import {cliError} from "./errors.js";
+import {failure, success} from "./output.js";
+
+function parseOptions(args) {
+  const options = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--json") continue;
+    if (arg === "--list") options.list = true;
+    else if (arg === "--replace") options.replace = true;
+    else if (arg === "--agents") {
+      if (!args[i + 1] || args[i + 1].startsWith("--")) throw new Error("--agents requires comma-separated Agent IDs.");
+      options.agents = [...new Set(args[++i].split(",").map(id => id.trim()).filter(Boolean))];
+      if (!options.agents.length) throw new Error("--agents requires at least one Agent ID.");
+    } else throw new Error(`Unknown install-skill option: ${arg}`);
+  }
+  if (options.list && (options.agents || options.replace)) throw new Error("--list cannot be combined with installation options.");
+  return options;
+}
+
+export async function handleInstallSkill(args, context = {}) {
+  const env = context.env || process.env;
+  const home = resolve(env.USERPROFILE || env.HOME || homedir());
+  const catalog = agentCatalog({home, env});
+  let options;
+  try {
+    options = parseOptions(args);
+    if (options.list) return success("install-skill", {agents: catalog});
+    if (!options.agents) {
+      const interactive = context.isTTY ?? (process.stdin.isTTY && process.stderr.isTTY);
+      if (!interactive) throw new Error("Specify --agents <ids>; use --list to see supported Agents.");
+      const prompt = createInterface({input: process.stdin, output: process.stderr});
+      try {
+        process.stderr.write(catalog.map(a => `${a.id}: ${a.name}${a.detected ? " (detected)" : ""}`).join("\n") + "\n");
+        const answer = await prompt.question("Select Agent IDs (comma-separated): ");
+        options.agents = parseOptions(["--agents", answer]).agents;
+      } finally { prompt.close(); }
+    }
+    for (const id of options.agents) if (!catalog.some(agent => agent.id === id)) throw new Error(`Unknown Agent: ${id}`);
+  } catch (error) {
+    return failure("install-skill", cliError("INVALID_ARGUMENT", {
+      message: error.message, nextActions: ["finebi-cli install-skill --help"],
+    }));
+  }
+
+  const directory = join(home, ".finebi-cli");
+  const statePath = join(directory, "installation.json");
+  const lockPath = join(directory, "skill-install.lock");
+  let lock;
+  try {
+    const source = context.skillSource || [
+      "../skills/finebi-cli-agent/", "../../skills/finebi-cli-agent/", "../../../",
+    ].map(path => fileURLToPath(new URL(path, import.meta.url)))
+      .find(path => existsSync(join(path, "SKILL.md")) && existsSync(join(path, "scripts/finebi-cli/src/index.js")));
+    if (!source) throw new Error("FineBI Skill resources were not found. Reinstall the CLI package or build the Skill in the source checkout.");
+    await readFile(join(source, "SKILL.md"));
+    await readFile(join(source, "scripts/finebi-cli/src/index.js"));
+    await mkdir(directory, {recursive: true});
+    try { lock = await open(lockPath, "wx"); }
+    catch (error) { if (error.code === "EEXIST") throw new Error(`Skill installation lock exists: ${lockPath}`); throw error; }
+    let state = {};
+    try { state = JSON.parse(await readFile(statePath, "utf8")); }
+    catch (error) { if (error.code !== "ENOENT") throw error; }
+    const results = await installSkills({source, home, env, agents: options.agents, replace: options.replace, previous: state.skills || []});
+    const skills = new Map((state.skills || []).map(skill => [skill.agent, skill]));
+    for (const skill of results) skills.set(skill.agent, {...skills.get(skill.agent), ...skill});
+    const stagedState = join(directory, "installation.json.stage");
+    await writeFile(stagedState, `${JSON.stringify({...state, skills: [...skills.values()], updatedAt: new Date().toISOString()}, null, 2)}\n`);
+    await rename(stagedState, statePath);
+    const data = {skills: results.map(({hashes, ...skill}) => skill)};
+    if (results.some(skill => !["installed", "unchanged"].includes(skill.status))) {
+      return failure("install-skill", cliError("SKILL_INSTALL_FAILED", {
+        message: "Some Skills were kept or failed. Review the results; --replace backs up and replaces local changes.", partialResult: data,
+      }));
+    }
+    return success("install-skill", data);
+  } catch (error) {
+    return failure("install-skill", cliError("SKILL_INSTALL_FAILED", {message: error.message}));
+  } finally {
+    if (lock) { await lock.close(); await unlink(lockPath); }
+  }
+}